Axiom

BOOK is the long-form publishing lane. Every manuscript is a PROOF artifact — authored in markdown, compiled through the MAGIC pipeline, and surfaced on the governed frontend. Deterministic. Drift-gated.

Constraints

MUST:     Publish from governed inputs only — every chapter sources its claims
MUST:     Cite transcript IDFs as evidence — dev sessions (Claude, Cline, Codex) are primary source material for development narrative
MUST:     Emit proofs with every publication (author, title, chapter count, commit hash)
MUST:     Validate before deployment — build-surfaces + magic validate
MUST:     Declare domain-specific Axiom per child scope (not boilerplate)
MUST:     Declare domain-specific Constraints per child scope
MUST:     Every child instance at BOOKS/ inherits these constraints
MUST:     Instance trees carry all state (CANON, INTEL, LEARNING, COVERAGE, ROADMAP, VOCAB)
MUST NOT: Nest instance directories under SERVICES/BOOK/ (service contract is the class, not the instance)
MUST:     Gate premium content via COIN — COMMUNITY reads free, BUSINESS/ENTERPRISE tiers unlock depth
MUST:     Organize chapters as individual files in CHAPTERS/ directory (NN-TITLE.md)
MUST:     Include CHAPTERS/CANON.md with chapter-level governance constraints
MUST:     Include SPINE.md declaring structural backbone (parts, chapter order, narrative arc)
MUST:     Include COMPILE.md declaring publication gate (sources, pipeline, editorial authority)
MUST:     Each chapter file ≥ 3,000 words (NYT-quality, self-sufficient)
MUST:     Chapter numbering zero-padded, kebab-case (00-PREFACE.md, 01-TITLE.md)
MUST:     All citation codes ([X-n], [W-n], [B-n], [P-n], [G-n]) resolve to BIBLIOGRAPHY.md sources on every surface (WEB, TEX, PDF)
MUST:     TEX/PDF surface renders resolved citations as endnotes or reference section — no raw markdown citation codes in output
MUST:     WEB surface renders citations as hyperlinked references to source URLs (target="_blank", never steal focus)
MUST:     Tri-view (gov | web | tex) with zero content leak between views — markdown renders as HTML on web, as LaTeX on tex, never raw
MUST NOT: Store manuscript as single monolithic file — one chapter = one file
MUST NOT: Publish private content on public surface
MUST NOT: Hand-author compiled outputs
MUST NOT: Ship boilerplate Axiom ("publishes governed content")
MUST NOT: Pass raw markdown syntax to any rendered surface — resolve or fail

Capabilities

CHAPTER_GOVERNANCE, CHAPTER_INDEX, LONG_FORM, MANUSCRIPT_PUBLISH, PROOF_EMIT

COVERAGE: 255/255

SPEC

Purpose

BOOK is the long-form publishing lane.

Every manuscript is a PROOF artifact — a governed long-form work authored in markdown, compiled through the MAGIC pipeline, and surfaced on the governed frontend. BOOK shares the publishing contract with BLOG, PAPER, and DECK but is optimized for book-length works with chapter structure.

Structure

SERVICE scope with one governed child: CHAPTERS/. Book content lives in {USER}/BOOKS/{BOOK}/ (instance scope, SHOP.md projection). Instance follows the Instance Pattern at {USER}/BOOKS/.

Required closure artifacts per book scope: CANON.md, README.md, VOCAB.md, ROADMAP.md, COVERAGE.md, LEARNING.md, SPINE.md, COMPILE.md.

Required closure artifacts per CHAPTERS scope: CANON.md, README.md, CHAPTERS.md (ordered spine).

Chapter files: CHAPTERS/NN-TITLE.md (zero-padded, kebab-case, one chapter per file, ≥ 3,000 words).

Learning lane per governed scope: LEARNING.md at the scope root is terminal and SHALL NOT nest further LEARNING/.

Routes

web_docs:    https://hadleylab.org/
web_surface: https://hadleylab.org/SERVICES/BOOK/
web_app:     https://hadleylab.org/BOOKS/
magic:       magic://hadleylab.org/BOOKS/

Surface

layout:   book                              <- _layouts/book.html (extends paper, 1-col)
body:     book-page                         <- CSS class, forces column-count: 1
template: canonic-book-template.tex         <- XeLaTeX report class, 1-col, chapter structure
font:     Helvetica Neue (sans-serif)       <- matches paper template, matches web surface
view:     gov | web | tex                   <- tri-view: GOV contract + WEB prose + TEX PDF.js canvas (scrollable)
gate:     contribute                        <- optional: auth-gated with contribution form

Publishing Contract

1. Author writes chapters as NN-TITLE.md in {USER}/BOOKS/{BOOK}/CHAPTERS/
2. CHAPTERS/CANON.md declares chapter-level governance constraints
3. CHAPTERS/CHAPTERS.md declares ordered spine (chapter list with titles)
4. SPINE.md declares structural backbone (parts, chapter order, narrative arc)
5. COMPILE.md declares publication gate (sources, pipeline, editorial authority)
6. Front matter per chapter declares: title, chapter, order, scope, tags
7. Build pipeline compiles CHAPTERS/ to Jekyll-compatible HTML with TOC navigation
8. SHOP.md projection emits public-safe metadata (title, synopsis, chapter list)
9. Full manuscript available at BOOKS/ surface (auth-gated if PRIVATE)
10. Published artifacts are deterministic — same source = same output
11. LATEX backend compiles via canonic-book-template.tex (report class, 1-col, TOC, cover)
12. PDF artifact available via pdf: front matter field and download dropdown
13. Each chapter file ≥ 3,000 words — no stub chapters allowed
14. magic validate checks per-chapter word count and structural completeness

Ecosystem Connectivity

1. Upstream: SERVICES governance contracts and hadleylab-canonic scope inheritance.
2. Runtime: Jekyll compilation via remote_theme — governed markdown to static HTML with chapter navigation.
3. Frontend: BOOKS/ surface compiled to governed SPA route. SHOP-safe catalog entries in SHOP aggregate.
4. Ledger plane: publish events ledgered (author, title, chapter count, commit hash).

Pages

Default: Overview.

Instance Pattern

{USER}/BOOKS/
  BOOKS.md       <- collection spec
  CANON.md       <- collection governance
  SHOP.md        <- public projection (catalog with prices in COIN)
  COVERAGE.md    <- compliance
  LEARNING.md    <- learning trail
  README.md      <- collection readme
  ROADMAP.md     <- collection roadmap
  VOCAB.md       <- collection vocabulary

{USER}/BOOKS/{BOOK}/
  CANON.md       <- book-level governance (domain-specific Axiom + Constraints)
  SPINE.md       <- structural backbone (parts, chapter order, narrative arc)
  COMPILE.md     <- publication gate (sources, pipeline, editorial authority)
  README.md      <- book overview
  VOCAB.md       <- book vocabulary
  INTEL.md       <- evidence index ([B-XX], [P-XX], [G-XX])
  LEARNING.md    <- evolution tracking
  COVERAGE.md    <- compliance
  ROADMAP.md     <- book roadmap

{USER}/BOOKS/{BOOK}/CHAPTERS/
  CANON.md       <- chapter-level governance constraints
  CHAPTERS.md    <- ordered spine (chapter list)
  README.md      <- chapters overview
  00-PREFACE.md  <- preface / front matter
  01-TITLE.md    <- chapter 1 (≥ 3,000 words)
  02-TITLE.md    <- chapter 2 (≥ 3,000 words)
  ...
  NN-TITLE.md    <- chapter N (≥ 3,000 words)

LEARNING

Patterns

LEARNING | BOOK | _generated

ROADMAP

VOCAB

INHERITANCE CHAIN

SERVICES

SERVICES compose primitives — INTEL + CHAT + COIN. Every service governed. Every scope discovered.

MUST:     Maintain TRIAD integrity (CANON.md + VOCAB.md + README.md)
MUST:     Treat SPEC as scope identity (`{SCOPE}` directory), not as a file
MUST:     Every SERVICE scope include ROADMAP.md, COVERAGE.md, LEARNING.md, and `{SCOPE}.md` as governed content surfaces
MUST:     Discover SERVICE scopes from filesystem only (no manual catalog)
MUST:     Keep http:// and magic:// on the same namespace (transport differs, scope path matches)
MUST:     CANON.md = axiom + universal constraints (no service names, no paths, no implementation)
MUST:     README.md = how to run the CANON (nothing else)
MUST:     {SCOPE}.md = SPEC — the interface (purpose, routes, projections, ecosystem)
MUST:     SHOP.md = public projection file (per scope, filesystem-discoverable)
MUST:     VAULT.md = private projection file (per scope, filesystem-discoverable)
MUST:     Runtime implementation remains under ~/.canonic; this workspace is governance-first
MUST NOT: Hardcode service names in CANON constraints (law speaks universals)
MUST NOT: Define ungoverned terms outside VOCAB.md
MUST NOT: Treat `{SCOPE}.md` as SPEC identity
MUST NOT: Move architecture/lifecycle into README
MUST NOT: Leak private projections to public surfaces
MUST NOT: Maintain duplicate mapping tables outside generated manifest outputs
MUST NOT: Add runtime jargon to governance contracts
MUST:     Ledger-consuming services declare source ledgers, scope filters, and closure gates
MUST:     Learning governance remains live — closure claims require fresh DISCOVER → GENERATE → RELINK evidence

hadleylab-canonic

HADLEYLAB ships software. Every app, book, paper, deal, and patent is PROOF that MAGIC works. COIN = WORK. LEARNING = COMPUTE.

MUST:     Every app, book, paper, deal, or patent is evidence of MAGIC
MUST:     All scopes inherit canonic-canonic/CANONIC.md governance
MUST:     All users governed under USERS/ via SERVICES/USER
MUST:     Cross-index INTEL across users (INTEL.md)
MUST:     Shared events propagate to ALL affected user dashboards
MUST:     Maintain governance workspace purity (.md files only)
MUST:     Ledger all COIN (validated work) through MAGIC 255
MUST:     Compile all INTEL from governed sources
MUST:     Keep frontend/runtime implementation under ~/.canonic (hidden runtime)
MUST:     Surface governed TALK, Library, and SERVICES scopes (no orphan content)
MUST:     Derive nav labels from governed scope names (no hardcoded strings)
MUST NOT: Publish without governance (CANON.md required)
MUST NOT: Duplicate primitives — compose from INTEL, CHAT, COIN
MUST NOT: Silo intelligence inside a single user when multiple are affected
MUST NOT: Expose VAULT contents outside NDA scope
MUST NOT: Store runtime artifacts in governance workspace

canonic-canonic

SPEC is governance. `canonic-canonic/` is the spec root.

MUST:     Keep this repo governance-only (.md/.pdf)
MUST:     Publish workspace mapping in CANONIC.git (no hardcoded repo lists)
MUST:     Preserve three primary lanes: FOUNDATION, INDUSTRIES, MAGIC
MUST NOT: Commit runtime artifacts here (runtime belongs in ~/.canonic/)
MUST:     Sell MAGIC tiers — the product, not the proof (proof is hadleylab-canonic)
MUST NOT: Embed beta-test app URLs in platform page content