Start with Guides for a task, Reference for a surface contract, and Architecture and Internals for the substrate. The remaining tiers preserve operational, evidence, design, and historical material without presenting it as a first-read path.
| Document | Description |
|---|---|
| Getting Started | First archive, first query, and the next documentation steps. |
| Installation | Source checkout, Nix flake, and managed NixOS/Home Manager install paths. |
| Onboarding | First-run source detection, configuration, daemon startup, and recovery. |
| Search & Query | Query grammar, retrieval lanes, ranking policy, and the typed SearchEnvelope contract. |
| Insights | Available derived views and their evidence boundaries. |
| Export | Query-set reads and renderer formats for local export packages. |
| Browser Capture | Local browser extension capture for ChatGPT and Claude.ai sessions. |
| Hooks | Hook-event capture, configuration, and event catalog. |
| Cloud Agents | Privacy and setup boundaries for cloud-agent work. |
| Hermes Operator Guide | What Polylogue watches, imports, and cannot claim from a Hermes runtime, with fidelity and privacy evidence. |
| Standing Agent Manual | Generated six-tool invocation, continuity, query-language, and role guidance for MCP agents. |
| Generate | Synthetic archive generation, seed mode, and demo workflows. |
| Maintenance | Operator guide for preview, plan, run, resume, and incident recovery. |
| Providers | Provider-specific parsing and export-format notes. |
| Provider Index | Concise provider guide entrypoint. |
| ChatGPT Provider | ChatGPT export detection and parser notes. |
| Claude.ai Provider | Claude web export detection and parser notes. |
| Claude Code Provider | Claude Code session detection and parser notes. |
| Gemini Provider | Gemini/Drive acquisition and parser notes. |
| Codex Provider | Codex session detection and parser notes. |
| Document | Description |
|---|---|
| CLI Reference | Generated command reference from live help output. |
| MCP Reference | Generated MCP tool and contract reference. |
| Library API | Async archive API, filters, and query patterns. |
| MCP Integration | Model Context Protocol server setup and usage. |
| Agent Integration Reference | Generated typed contract, recipes, client delivery, and cutover reconciliation reference. |
| Configuration | XDG paths, environment variables, and runtime configuration. |
| Glossary | Plain-language translation of the internal taxonomy. |
| Provider, Origin, and Source Identity | Vocabulary map for provider-wire family, public origin, material source, and parser binding. |
| Provider Package Completeness | Readiness report for provider/importer package modes by origin and capture mode. |
| Material Protocol v1 | Normalized-session interchange wire format. |
| Schema Annotations | Versioned annotation schemas and batch provenance. |
| Query Identity | Canonical query, query-run, and result-set reference identities. |
| CLI Output Schemas | Machine-readable CLI output schema catalog. |
| Projection Render Specification | Projection and renderer contract for archive reads. |
| Web Route Readiness States | Readiness-state semantics for web routes. |
| Document | Description |
|---|---|
| Architecture | System rings, ownership boundaries, and data flow. |
| Architecture Spine | Target shape, guardrails, and major decisions with rejected alternatives. |
| Architecture Hotspots | Execution control center hotspot map and decomposition sequence (polylogue-1r9c). |
| Data Model | Archive entities, storage shape, and metadata rules. |
| Schema | Index and durable tier schema, FTS, vectors, and versioning. |
| Internals | Working implementation reference and debugging landmarks. |
| Daemon | Daemon ownership, convergence, HTTP serving, and service operation. |
| Daemon Threat Model | Local API assets, threats, mitigations, and roles. |
| Security | Security boundaries for local archives and readers. |
| Archive Backup | Archive-tier backup profiles, restore boundaries, and blob-GC safety rules. |
| Cost Model | Cost, usage, cache, and subscription-credit accounting semantics. |
| Agent Forensics | Forensic investigation methods over agent work. |
| Repository Layout | Every top-level entry and its purpose. |
| Document | Description |
|---|---|
| Developer Tools | Generated surfaces, validation, and repo hygiene. |
| Branch-Local Development Loop | Daemon, web-shell, browser-capture, and extension debugging workflow. |
| Test Economics | Test-selection and verification cost model. |
| Test Quality Workflows | Executable mutation-campaign and benchmark registries. |
| Visual Evidence | Synthetic reader DOM/media evidence lanes and local screenshot boundaries. |
| Release Checklist | Cut-time packaging, installed-artifact, and publish checks. |
| Tracker Authority | GitHub and Beads authority split, and the reconciliation script that checks it. |
| Document | Description |
|---|---|
| Demos and Proofs | Reproducible proofs, construct-valid demo doctrine, and flagship demonstrations. |
| Proof Artifacts | Claim-to-proof map for public-facing demo and evidence claims. |
| README Public-Claims View | Generated compact status view for claims used in README-facing copy. |
| Launch Public-Claims View | Generated launch-copy claim status with evidence blockers and remediation refs. |
| Findings-Page Public-Claims View | Generated finding status with judgment, privacy, evidence, epoch, and frame qualifiers. |
| Verified Public-Claims Export | Generated full public-claim projection corresponding to the machine-readable export. |
| Structured Failure Follow-Up | Bounded field finding with oracle, sample frame, calibration, and caveats. |
| Polylogue on Sinex | Current bridge, target authority split, and rebuild proof. |
| Insights Rigor Matrix | Evidence strengths and limitations for insight families. |
| Query-Action Workflows | Executable product contract for workflows, affordances, completions, and golden paths. |
| Demo Corpus Construct Audit | Generated construct-coverage audit for the demo fixture world. |
| Release Readiness Gate | Externally presentable release gate and required proof contract. |
| Demo Packet v2 | Worked private-data-free evidence packet. |
| Demo Tour Report | Recorded output and receipts from the demo tour. |
| UVX Installation Proof | Recorded installation proof for the uvx distribution path. |
| Visual Tape Examples | Reader-evidence and visual-tape artifact catalog. |
| Reader-Comprehension Test Harness | Single-blind N-arm cold-reader test harness for README/positioning candidates. |
| Example and Proof Index | Index of recorded proof artifacts and worked examples. |
| Document | Description |
|---|---|
| Design Direction | Beads-first design doctrine and standing domain-model references. |
| Agent-First MCP | Agent-facing MCP surface doctrine. |
| Archive Storytelling | Narrative and artifact design for archives. |
| Hermes Archival Export Contract | Versioned Hermes session export schema, durable lifecycle-event spool, and snapshot reconciliation. |
| Browser Capture Redesign | Browser-capture redesign rationale and verification artifacts. |
| Incident 14:32 Proof World | Deterministic demo corpus and anti-circularity rules. |
| Project Memory | Long-term memory model and product intent. |
| Storage Twins Divergences | Documented sync/async storage backend divergences, tracked for the twins regression test. |
| Query-Action Workflows Design | Historical design pointer for the workflow contract. |
| Query Set Algebra | Set-composition semantics over query results. |
| Session Lineage Model | Fork, resume, compaction, and composition semantics. |
| Analysis Rigor | Rigor mechanisms for agent claims: population validity and comparative judgment. |
| Prefix-Blob Reclamation | Reference-blob representation for byte-proven superseded revision prefixes. |
| Convergence Simplification Inventory | Deletion/collapse inventory for the daemon convergence redesign (polylogue-m6tp). |
| Second Brain | Vision note for remembered work. |
| Time Machine | Vision note for reconstructing work over time. |
| Whole Product | Product vision and system relationships. |
| Document | Description |
|---|---|
| Closed-Issue Workload Audit | Historical audit of closed-issue workload. |
| Cross-Surface Coherence Audit | Historical cross-surface coherence audit. |
| API Bypass Audit | Historical audit of API bypasses. |
| Daemon Loop Lock-Starvation Map | Lock-starvation investigation record. |
| Hash Boundary Census | Hash-boundary investigation record. |
| Race Window Audit | Race-window investigation record. |
| Audit Record Index | Index of dated investigation records. |
| 1498 Cascade Retrospective | Historical cascade incident retrospective. |
| Retrospective Index | Index of historical incident retrospectives. |
| Query Pipeline Substrate Plan | Historical/active query pipeline design plan. |
| Semantic Card Tool Map | Generated map from semantic cards to tools. |
| Document | Description |
|---|---|
| Contributing | Branching, issues, PRs, squash-merge history, and repo policy. |
| Testing | Baseline test matrix, protected surfaces, and verification entrypoints. |
| Agent Guide | Agent memory and working rules. |
| Security Policy | Trust-boundary summary, supported versions, and vulnerability reporting contact. |