Polylogue Docs Map

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.

Guides

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.
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.

Reference

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.
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.

Architecture and Internals

Document	Description
Architecture	System rings, ownership boundaries, and data flow.
Architecture Spine	Target shape, guardrails, and major decisions with rejected alternatives.
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.

Operations and Contributor Workflow

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.

Demos, Evidence, and Product

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.
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.
Example and Proof Index	Index of recorded proof artifacts and worked examples.

Design Notes

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.
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.
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.
Second Brain	Vision note for remembered work.
Time Machine	Vision note for reconstructing work over time.
Whole Product	Product vision and system relationships.

Historical Records and Generated Artifacts

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.
Topology Status	Generated module-topology status dashboard.

Contributor Workflow

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.