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.
| Component | Layer | Evidence | Hands off to |
|---|---|---|---|
| Ingestion jobsA durable queue in the database. Workers claim jobs atomically. | Index | Source audited | Indexer (runs) |
| IndexerBrings the index in line with one commit, by blob SHA. | Index | Source audited | Parsers (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 audited | PostgreSQL store (chunks) |
| EmbeddingsPluggable backends. Vectors from different models are never compared. | Index | Source audited | PostgreSQL store (vectors) |
| Call graphResolves a call only when one target is defensible. | Index | Recorded run | PostgreSQL store (edges) |
| PostgreSQL storeChunk pointers, pgvector embeddings, edges and jobs. Source stays in Git. | Store | Source audited | Retriever (searched by) |
| RetrieverKeyword, dense, hybrid and graph modes, with the mode used always reported. | Serve | Recorded run | Context 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 run | Context assembly (verified code) |
| Context assemblyRanked code, neighbours and rules, rendered with citations inside a budget. | Serve | Recorded run | MCP server (retrieve_context)REST API (/context/retrieve) |
| Repository memoryLearned conventions and history. It failed its primary evaluation. | Serve | Failed its gate | Context assembly (memory block) |
| MCP serverEight read-only tools over streamable HTTP. | Interface | Recorded run | The caller |
| REST APIThe same operations under /api/v1, with admin and read scopes. | Interface | Recorded run | The caller |
Go deeper
Recorded runs
- 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.
- 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.
- What the blob check does with a mismatchThe same pointer through the same call, three times. Only the expected SHA changes.
- 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.
- 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.
