Myco v0.5.6 — Doctrine realignment + MP1 mechanical LLM-boundary + bitter-lesson appendix

TL;DR: v0.5.5's panoramic review found 39 drift items between doctrine and code. v0.5.6 closes all 39 and promotes the "Agent calls LLM, substrate does not" invariant from doctrine-by-convention to mechanical enforcement via a new lint dimension + new canon contract field. L0 also gains a bitter-lesson appendix holding the whole coordination surface accountable to a review cadence.

Governing craft: docs/primordia/v0_5_6_doctrine_realignment_craft_2026-04-17.md.

What shipped

Mechanical LLM-boundary (new)

• MP1 dimension (mechanical / HIGH / fixable=False). AST-scans src/myco/**/*.py against a 14-entry provider-SDK blacklist: openai / anthropic / mistralai / cohere / voyageai / google.generativeai / google.genai / langchain / langchain_core / langchain_openai / langchain_anthropic / llama_index / llama_cpp / ollama. Cross-checks canon.system.no_llm_in_substrate:
  • declared true + violation → HIGH (CI gates)
  • declared false + violation → LOW (opt-out declared)
  • clean → no finding
• canon.system.no_llm_in_substrate: bool — new canon field; default true; optional-with-default so v0.5.5 canons parse unchanged
• src/myco/providers/ — reserved escape hatch package (empty at v0.5.6). MP1 whitelists this path. Populating requires flipping the canon field to false + contract-bumping molt.

34 doctrine-alignment edits across L0-L3

Every S1 contradiction (verb count 17→18, dimension enumeration, package_map staleness, brief absent from doctrine, fixable dimensions undocumented, safe-fix discipline unlanded), every S2 stale cross-reference (local_plugins payload shape, DIMENSION_CATEGORY table name, L4_SUBSTRATE/export_plan.md dangling ref, genesis:→germination:, clean reflect→assimilate), and every S3 missing anchor (sporulate output shape, graph API, count_by_kind in hunger, symbiont cross-references) landed as concrete corrections.

Two new L0 additions

• L0 principle 1 addendum — carves the two declared exceptions (brief human window + Agent-calls-LLM boundary) inline so every downstream reader sees them from the top
• L0 bitter-lesson appendix — explicit acknowledgment that Myco's 18-verb + canon-schema + 11-dimension coordination surface is a live bet against Sutton's bitter lesson. Names the review cadence (every MAJOR release re-audits) and the redesign trigger (if Agents can maintain 1M-file substrates without structured verbs, Myco must re-justify)

New L2 doctrine

• L2_DOCTRINE/extensibility.md — cross-cutting page for the two orthogonal extension axes: per-substrate (.myco/plugins/) and per-host (src/myco/symbionts/). Single source for scope boundaries, authoring verbs (ramify for per-substrate), audit verbs (graft for per-substrate), and enforcement dimensions (MF2 for per-substrate). Cross-linked from L0 principle 5, L2 homeostasis, L3 symbiont_protocol.

Verification

• myco --version → myco 0.5.6
• myco immune --list → 11 dimensions (M1/M2✓/M3/MF1/MF2/MP1/SH1/MB1✓/MB2/SE1/SE2)
• myco immune --dimensions MP1 → clean on myco-self (kernel imports no provider SDK)
• myco winnow docs/primordia/v0_5_6_doctrine_realignment_craft_2026-04-17.md → verdict: pass (5 rounds, 21725 chars, 0 violations)
• 580 tests passing (was 564; +16 net for MP1 + canon-field)

Upgrade

No migration action required. Every v0.5.5 CLI invocation still works. Every v0.5.x alias resolves. v0.5.5 canons parse under v0.5.6 unchanged (new field is optional-with-default-true).

cd ~/myco && git pull && myco immune

If MP1 fires on a downstream substrate: review the flagged import. Either (a) remove it, (b) move it to src/myco/providers/ + toggle canon.system.no_llm_in_substrate: false + myco molt, or (c) accept the LOW opt-out finding as advisory.

Records

• Governing craft: docs/primordia/v0_5_6_doctrine_realignment_craft_2026-04-17.md
• Contract changelog: docs/contract_changelog.md v0.5.6 section
• Full CHANGELOG: CHANGELOG.md
• New doctrine page: docs/architecture/L2_DOCTRINE/extensibility.md
• MP1 escape hatch contract: src/myco/providers/README.md