PetFolio
A living knowledge graph of an engineering portfolio, queried with citations that resolve to real source lines.
Turns GitHub repositories into a queryable graph of files, symbols, call edges, and docs, then answers questions about them with citations validated against the graph before they ever reach the user. Deterministic retrieval runs first; the language model only ever synthesizes evidence retrieval already selected—and when there's no evidence, it says so instead of guessing.
Highlights
- Retrieval-first architecture: the model never has raw repository access
- Every citation is validated against real file paths and line ranges before returning
- Neo4j graph + Postgres hybrid vector/full-text search over parsed source
- Mock LLM mode by default—every layer is exercisable at zero API cost
- Custom tree-sitter and hand-written adapters across seven languages, including 6502 assembly
Technology
Go, Neo4j, PostgreSQL, React, Tree-sitter, Claude API