Purpose
PAPER is the research publishing lane.
Every research paper, clinical study, and technical manuscript is a PROOF artifact — authored in markdown, compiled through the MAGIC pipeline, and surfaced on the governed frontend. PAPER shares the publishing contract with BLOG, BOOK, and DECK but enforces peer-review gates and citation governance.
Structure
Leaf SERVICE scope. No governed child scopes.
Paper content lives in {USER}/PAPERS/ (instance scope, SHOP.md projection).
Instance follows the Instance Pattern at {USER}/PAPERS/.
Required closure artifacts per scope:
CANON.md, README.md, PAPER.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/PAPER/
web_app: https://hadleylab-canonic.github.io/PAPERS/
magic: magic://hadleylab-canonic.github.io/PAPERS/
Publishing Contract
1. Author writes {PAPER}.md in {USER}/PAPERS/{TITLE}/
2. Front matter declares: title, authors, date, scope, tags, doi (if published)
3. Build pipeline compiles to governed HTML with citation formatting
4. SHOP.md projection emits public-safe metadata (title, authors, abstract, date)
5. Full paper available at PAPERS/ surface (auth-gated if pre-publication)
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
Peer Review Gates
MUST: Declare co-authors in front matter (mapped to USER principals)
MUST: Evidence every claim with citation or data reference
MUST: Pre-publication drafts are VAULT-gated (PRIVATE until published)
MUST NOT: Publish without all co-author acknowledgements
Ecosystem Connectivity
- Upstream:
SERVICESgovernance contracts andDEXTERscope inheritance. - Runtime: Jekyll compilation via
remote_theme— governed markdown to formatted research HTML. - Frontend: PAPERS/ surface compiled to governed SPA route. SHOP-safe abstracts in catalog.
- Ledger plane: publish events ledgered (authors, title, submission date, commit hash).
Pages
| Page | Sections |
|---|---|
| Overview | Purpose, Structure |
| Publishing | Routes, Publishing Contract, Peer Review Gates |
| Ecosystem | Ecosystem Connectivity |
Default: Overview.
Instance Pattern
{USER}/PAPERS/
PAPERS.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
| *PAPER | SPEC | SERVICES* |