Repository Map

Overview

Own two read-only capabilities, repository.asset.query and repository.map.render, plus the artifact-writing repository.asset.scan capability. The scan never changes repository source, documentation, or Git, but its host adapter must own an isolated run-local SQLite/cache path and declare that write explicitly. The authoritative result is a versioned Repository Asset Graph snapshot with stable asset and edge references, explicit basis, scope, exclusions, coverage, conflicts, and unresolved records. A Markdown or HTML map is an optional derived view over that snapshot; it is never the gate, completeness proof, or source of truth.

Project source, contracts, configuration, Product Markdown, DESIGN.md, and local UI contracts retain their native authority. The graph indexes identity and relationships without copying their bodies. Runtime claims and delivery status belong to typed delivery observations, not the asset graph.