; vault-readiness.spl — Cross-cutting theory for vault completeness ; Combines facts from across the vault to derive vault-ready-to-publish. ; Run: zetl reason explain “vault-ready-to-publish” –format natural

; — Strict rules: documentation completeness —

; Getting started section must cover install, quick start, and compatibility (always r-getting-started-complete (and single-binary spl-documented local-first-documented) getting-started-complete)

; Reference section must document all major commands (always r-reference-complete (and reason-status-done reason-explain-done fulltext-search-done dead-link-detection tui-complete content-addressed-hashing) reference-complete)

; Architecture section must document core components (always r-architecture-complete (and wikilink-extraction spl-extraction directed-graph mtime-based-cache content-addressed-hashing spindle-core-integrated drift-detection) architecture-complete)

; Concepts must be documented (always r-concepts-complete (and wikilink-syntax-documented defeasible-reasoning-documented spl-documented provenance-documented local-first-documented) concepts-complete)

; Specs must be documented (always r-specs-complete (and spec-001-documented spec-002-documented spec-003-documented spec-005-documented spec-006-documented spec-007-documented spec-008-documented spec-009-documented all-specs-documented) specs-complete)

; — Defeasible rules: quality and readiness —

; Scanner must handle both wikilinks and SPL (always r-scanner-complete (and wikilink-extraction spl-extraction) scanner-complete)

; All eight reason commands must be implemented (always r-reason-commands-complete (and reason-status-done reason-explain-done reason-why-not-done reason-require-done reason-what-if-done reason-conflicts-done reason-export-done reason-provenance-done) reason-commands-complete)

; Diagnostics cover both links and logic (always r-diagnostics-complete (and dead-link-detection orphan-detection spl-diagnostics) diagnostics-complete)

; Agent-friendly when JSON + structured errors + exit codes (normally r-agent-friendly (and json-default-output structured-errors nonzero-exit-codes) agent-friendly)

; Safe to use when read-only + disposable cache (normally r-safe-to-use (and read-only-vault-access disposable-cache) safe-to-use)

; Core features ready (normally r-core-ready (and scanner-complete diagnostics-complete fulltext-search-done directed-graph) core-features-ready)

; Reasoning layer ready (normally r-reasoning-ready (and reason-commands-complete spindle-core-integrated four-conclusion-types) reasoning-ready)

; Vault is self-documenting when all sections are complete (normally r-vault-self-doc (and getting-started-complete reference-complete architecture-complete concepts-complete specs-complete vault-self-documenting) vault-self-documented)

; Ready to publish when features, safety, and docs are all in place (normally r-vault-ready (and vault-self-documented core-features-ready reasoning-ready agent-friendly safe-to-use tui-complete vault-is-self-referential) vault-ready-to-publish)