Artifact Reference

SwarmVault is save-first. The files on disk are the product.

Canonical Inputs

swarmvault.schema.md - vault instructions, naming rules, exclusions, freshness rules
raw/sources/ - immutable canonical sources
raw/assets/ - localized remote or imported assets
state/sources.json - managed-source registry for recurring directories, public repos, and docs hubs
state/sources/<id>/ - managed-source working state such as shallow checkouts and crawl metadata

wiki/sources/ - source pages
wiki/concepts/ and wiki/entities/ - promoted canonical pages
wiki/code/ - parser-backed module pages
wiki/projects/ - project rollups
wiki/outputs/ - saved query and explore outputs
wiki/outputs/source-briefs/ - source-scoped onboarding briefs for managed sources
wiki/outputs/source-reviews/ - source-scoped review pages staged through approvals
wiki/outputs/source-guides/ - guided source-integration pages that stage broader wiki updates for review
wiki/outputs/source-sessions/ - resumable guided-session anchors plus question and answer state
wiki/dashboards/ - recent sources, timeline, contradiction, and open-question dashboards
wiki/candidates/ - staged concept/entity pages
wiki/graph/report.md - trust and orientation report

state/graph.json - compiled graph artifact
state/search.sqlite - local full-text index
state/code-index.json - repo-aware symbol/import index
state/extracts/ - extraction markdown and JSON sidecars for PDF, the full Word family, RTF, OpenDocument, EPUB, CSV/TSV, the full Excel family, the full PowerPoint family, Jupyter notebooks, BibTeX, Org-mode, AsciiDoc, transcript, Slack export, email, calendar, audio transcripts, YouTube transcript captures, structured config/data previews, and image sources
state/approvals/ - review bundles from compile --approve
state/benchmark.json - latest benchmark/trust artifact
state/watch/ - pending semantic refresh and watch status artifacts
state/sessions/ - saved compile/query/explore/lint/watch history
state/jobs.ndjson - watch run log