The method / System One Search

A route back
to source.

A repository contains the pieces of its explanation. The harness finds them, judges their relevance and connects them.

The division of work

Code computes.
TypeSafe judges.

Code retrieves, ranks and builds the graph. Jev answers small typed questions about the evidence. No LLM writes the explanation.

Inspect the questions

The construction of an answer

Four parts.
One source of truth.

01

Read the territory

src/index/build.ts

Tracked files become a repository tree. A content pass extracts declarations, imports, calls, comments and other language-specific facts. Compact descriptions put distinctive facts first.

Files become searchable evidence.

02

Find the possible paths

src/index/lex.ts

A lexical index scores paths, facts and source text. A static reference graph connects files. These propose candidates before a model judgment is needed.

Recall starts with ordinary code.

03

Ask precise questions

src/questions.ts

For Find, TypeSafe shortlists files and verifies them against relevant source lines. For Map, it judges membership in a subject. Question text stays constant; repository data lives in the request state.

Typed judgments refine the candidates.

04

Connect the evidence

src/flow/explain.ts

Explain gathers members, expands through references, and judges evidence blocks and edges. Code builds the final chart. Titles are identifiers, summaries are selected comments and arrows come from real references.

An inspectable route through the code.

Reading the atlas

Evidence has edges.
So does coverage.

A judgment is a probability, not proof. A flow shows what was found within its search depth and caps. It is a static reference view, not an execution trace.

Dynamic loading, dependency injection and client–server boundaries can leave gaps. Extractors are approximate. The trace, omitted units and source references help you assess the result.

Coverage checks report which paths a harness says it examined and which recorded neighbors remain. They do not establish semantic completeness.

Read the limitations

Now follow a real question

Open the source.
Find your way through.

Explore the atlas

Questions about public repositories are logged to improve the demo. Don’t include secrets.