Back to the room

Pass 3 of 3 · Deep dive of PHAROSPass 1 · OverviewPass 2 · How it works

Code Observatory / Explorer

Follow one answer down to the bytes.

This is PHAROS at one commit. Pick a part of the system, watch a recorded run pass through it, then read the source that ran.

PHAROS at 975a38dMIT license

What is real here

LIVE
Verified execution against a running service. None on this site. Your browser calls no PHAROS service.
RECORDED
Output captured from a real execution. All 5 runs here. Each is labeled with its commit, environment and limits.
SIMULATED
Educational behaviour that does not run the project. None on these pages.

The system

Zoom in and nodes say more. Every node opens its component.

ComponentLayerEvidenceHands off to
Ingestion jobsA durable queue in the database. Workers claim jobs atomically.Index Source auditedIndexer (runs)
IndexerBrings the index in line with one commit, by blob SHA.Index Source auditedParsers (parses with)Embeddings (embeds with)Call graph (rebuilds)
ParsersPython's ast module, tree-sitter for seven more languages, line windows for the rest.Index Source auditedPostgreSQL store (chunks)
EmbeddingsPluggable backends. Vectors from different models are never compared.Index Source auditedPostgreSQL store (vectors)
Call graphResolves a call only when one target is defensible.Index Recorded runPostgreSQL store (edges)
PostgreSQL storeChunk pointers, pgvector embeddings, edges and jobs. Source stays in Git.Store Source auditedRetriever (searched by)
RetrieverKeyword, dense, hybrid and graph modes, with the mode used always reported.Serve Recorded runContext assembly (ranked hits)MCP server (search_code)REST API (/search/code)
Source verificationCode is read at the indexed commit and compared with its Git blob SHA before it is returned.Serve Recorded runContext assembly (verified code)
Context assemblyRanked code, neighbours and rules, rendered with citations inside a budget.Serve Recorded runMCP server (retrieve_context)REST API (/context/retrieve)
Repository memoryLearned conventions and history. It failed its primary evaluation.Serve Failed its gateContext assembly (memory block)
MCP serverEight read-only tools over streamable HTTP.Interface Recorded runThe caller
REST APIThe same operations under /api/v1, with admin and read scopes.Interface Recorded runThe caller

Go deeper

Recorded runs

  1. A question reaches verified sourceOne question, asked the way an assistant asks it: a real MCP call, a real dense search, and five files fetched from GitHub and checked against their Git blobs.
  2. Hints turn auto into hybridThe same question with two guessed identifiers. Auto becomes hybrid, and the function that actually does the check moves from fifth to first.
  3. What the blob check does with a mismatchThe same pointer through the same call, three times. Only the expected SHA changes.
  4. A missing embedder: degrade with a warning, or refuseNo embedder at all. Auto degrades and says so. Asking for a mode that cannot run is refused.
  5. Who calls this, and what does it call?An assistant asks where one function lives and what touches it. A real MCP call finds the definition, then reads the resolved call graph around it.