# trueref

Self-hosted [Context7](https://github.com/upstash/context7) clone in Java 21 + Spring Boot 3.5: indexes git repositories per tag, exposes a Streamable-HTTP MCP server, REST + Swagger, and a SvelteKit dashboard for ingestion observability and querying.

See:
- [ARCHITECTURE.md](ARCHITECTURE.md) — design, hexagonal layout, pipelines, MCP/REST surfaces.
- [CODE_STYLE.md](CODE_STYLE.md) — conventions.
- [FINDINGS.md](FINDINGS.md) — research notes backing every choice.

## Quickstart

```bash
./mvnw -DskipTests package
java -jar trueref-bootstrap/target/trueref.jar
```

Browse:
- UI:           http://localhost:8080/
- Swagger:      http://localhost:8080/swagger-ui.html
- MCP endpoint: http://localhost:8080/mcp
- Actuator:     http://localhost:8080/actuator