BOOK

BOOK

BOOK publishes governed content. Deterministic. Drift-gated.

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

Leaf SERVICE scope. No governed child scopes. Book content lives in {USER}/BOOKS/ (instance scope, SHOP.md projection). Instance follows the Instance Pattern at {USER}/BOOKS/.

Required closure artifacts per scope: CANON.md, README.md, BOOK.md, VOCAB.md, ROADMAP.md, COVERAGE.md, LEARNING.md.

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

Routes

web_docs:    https://hadleylab-canonic.github.io/
web_surface: https://hadleylab-canonic.github.io/SERVICES/BOOK/
web_app:     https://hadleylab-canonic.github.io/BOOKS/
magic:       magic://hadleylab-canonic.github.io/BOOKS/

Publishing Contract

1. Author writes chapters as {CHAPTER}.md in {USER}/BOOKS/{TITLE}/
2. Front matter declares: title, chapter, order, scope, tags
3. Build pipeline compiles to Jekyll-compatible HTML with TOC navigation
4. SHOP.md projection emits public-safe metadata (title, synopsis, chapter list)
5. Full manuscript available at BOOKS/ surface (auth-gated if PRIVATE)
6. Published artifacts are deterministic — same source = same output
7. LATEX backend compiles same .md source to PDF (inherits SERVICES/LATEX)
8. PDF artifact available via pdf: front matter field and download dropdown

Ecosystem Connectivity

  1. Upstream: SERVICES governance contracts and DEXTER 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

Page Sections
Overview Purpose, Structure
Publishing Routes, Publishing Contract
Ecosystem Ecosystem Connectivity

Default: Overview.

Instance Pattern

{USER}/BOOKS/
  BOOKS.md       <- instance spec
  CANON.md       <- scope governance
  SHOP.md        <- public projection
  COVERAGE.md    <- compliance
  LEARNING.md    <- learning trail
  README.md      <- scope readme
  ROADMAP.md     <- scope roadmap
  VOCAB.md       <- scope vocabulary
*BOOK SPEC SERVICES*
TALK AUTO