Skip to content

Add spec/ + source/ + explanatory docs from canon migration#1

Merged
danvoulez merged 1 commit into
mainfrom
add-spec-from-canon-migration
May 17, 2026
Merged

Add spec/ + source/ + explanatory docs from canon migration#1
danvoulez merged 1 commit into
mainfrom
add-spec-from-canon-migration

Conversation

@danvoulez
Copy link
Copy Markdown
Contributor

Summary

Imports adapter protocol, if-doubt simulation, and supporting docs from the legacy LogLine-Foundation/engine (pre-migration) repo. Canon stays single-file (logline.receipt.v0); these artifacts live in spec/ here as proposed-behavior the engine implements, pending promotion to canon per LIP.

Files added

path from role
spec/logline.adapter.v0 legacy spec/adapter-protocol.md LIP-0004 adapter protocol
spec/logline.adapter-declaration.v0 + .schema.json legacy spec/adapter-declaration-* LIP-0005 declaration profile
spec/logline.adapter-conformance.v0 legacy spec/adapter-conformance.md LIP-0006 adapter conformance
spec/logline.if-doubt.v0 legacy spec/if-doubt-canon-addendum.md LIP-0002 if-doubt
spec/logline.if-doubt-simulation.v0 legacy spec/if-doubt-simulation.md LIP-0002
spec/logline.if-doubt-grammar.v0 legacy spec/if-doubt-grammar.ebnf LIP-0002
source/*.logline legacy source/ canon-in-its-own-language dogfooding
docs/canon-vs-runtime.md legacy docs/ explanatory
docs/evidence-model.md legacy docs/ explanatory
docs/if-doubt-package-notes.md legacy docs/ explanatory
spec/README.md, source/README.md new explain boundaries

What is intentionally NOT here

  • logline.grammar.v0 (EBNF for the LogLine language proper) — held back to live with the constitutional-runtime crate in the Minilab workspace, where it is consumed by the IR layer.
  • logline.canon.v0 + .schema.json (language canon, 9-slot lifecycle, route_kinds, status_lifecycle, law, prohibition) — same hold reasoning.

Doctrine

canon defines (only what is frozen and citable)
conformance proves (current frozen canon)
engine implements (canon + proposed spec/)
governance evolves (LIPs propose; some get promoted to canon)

Test plan

  • Spot-check spec/ files render correctly on GitHub
  • Confirm source/ .logline files render as plain text
  • Confirm spec/README and source/README explain the boundary clearly

🤖 Generated with Claude Code

Imports adapter protocol, if-doubt simulation, and dogfooding source files
from the legacy engine repo. Canon kept single-file (logline.receipt.v0
only); these artifacts are proposed-behavior the engine implements,
pending promotion to canon per LIP.

Added:
- spec/logline.adapter.v0 + adapter-declaration.v0 + adapter-conformance.v0
  + adapter-declaration.v0.schema.json (LIP-0004/0005/0006)
- spec/logline.if-doubt.v0 + if-doubt-simulation.v0 + if-doubt-grammar.v0
  (LIP-0002)
- source/*.logline (canon described in its own language; dogfooding)
- docs/canon-vs-runtime.md, evidence-model.md, if-doubt-package-notes.md
  (explanatory, non-normative)
- spec/README.md and source/README.md explaining boundaries

Grammar (logline.grammar.v0 EBNF) is held back: planned to live with the
constitutional-runtime crate in the Minilab workspace.

canon defines | conformance proves | engine implements | governance evolves.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@danvoulez danvoulez merged commit 9b78bdd into main May 17, 2026
@danvoulez danvoulez deleted the add-spec-from-canon-migration branch May 17, 2026 15:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant