scrimshawlife-ctrl · scrimshawlife-ctrl · Sep 13, 2026 · Sep 13, 2026 · Sep 13, 2026 · Sep 13, 2026
diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md
@@ -11,3 +11,22 @@ source packet → adapt() → atom → classify() → semion.frame.v0
 Router home: `yggdrasil.belief`. Mixed slang+sign hits Hyperlex first. Mixed tradition+sign hits Athanor first.
 
 No circular import of Abraxas. No `source_space` invention in this package.
+
+## Workflow-derived architecture — advisory target
+
+Read [workflows](specs/workflows.md) before implementing these boundaries. Current code is the small pipeline above, not a completed service or encoder. Proposed validation and evidence components are not shipped.
+
+| Component | Workflow responsibility | Contract / boundary |
+|---|---|---|
+| Shared input/denial validation | WF-001, WF-002; applied at every public entry, including CLI direct classify | CON-001; no adapter-only bypass |
+| T0 classifier | WF-003; deterministic relation and evidence classification | CON-002; never executes interpretants |
+| Export bridge | WF-004; validate then emit one inert dictionary | CON-003; external consumer owns runtime chain |
+| Operator-side label/snapshot tools | WF-005, WF-006, WF-010 | CON-004/CON-005; private data, immutable revisions; not imported by T0 |
+| Offline evaluation/review | WF-007, WF-008 | CON-005/CON-006; pinned features and evidence, no activation |
+| Authorized handoff preparation | WF-009 | CON-006; recipient scope and bytes validated independently |
+
+Keep T0 dependency-light and network-free. Do not add required torch/transformers, a database service, queues or cloud infrastructure to satisfy documentation structure. CLI and library must share validated behavior. Raw source/label evidence stays outside the unchanged v0 output as sidecar references pending a separately reviewed contract change.
+
+Validate packaging in an isolated installed wheel: current __main__.py reads a repository-relative VERSION that may not ship. Performance SLO, external consumer compatibility, real router deployment and T1 architecture are NOT_COMPUTABLE. No model/backbone choice is made until DEC-001/DEC-006 and a separate encoder cycle.
+
+Provenance: Notion Sprint 001 Hub [not inspected; Semion handoff read 2026-09-13 UTC] + Loop 805 Slice N/A (Semion advisory) + Hash: e5ed91bd90afb0429cf816504c7d5e622bbbc153 (base)
diff --git a/README.md b/README.md
@@ -1,5 +1,7 @@
 # Semion
 
+Specification review: start at [docs/START_HERE.md](docs/START_HERE.md). The complete advisory methodology is separate from runtime conformance; see [assessment](specs/assessment.md) and [open decisions](specs/decisions.md). This does not govern or activate.
+
 <p align="center">
   <img src="assets/hero.png" alt="Semion hero — bronze triad of icon, index, symbol" width="100%" />
 </p>
@@ -27,21 +29,23 @@ The Validate badge may stay red when Actions billing blocks the workflow even if
 |-----------|-------------------|
 | T0 `classify` / `adapt` / chain export (`compat`) | Trained encoder weights / Hub upload |
 | Spec 004 encoder **gate** (name_gate **false**) | `ALLOW_TRAIN` / `ALLOW_HUB` from Boof |
-| M2 rebalance gold floors **PASS** (local SoT + Aaron pack) | Full labeled SoT in git |
+| Historical M2 floor **PASS report** (not independently verified here) | Full labeled SoT in git |
 | Hero + OG rasters | Auto Settings social-preview write |
 
-## Current state (OBSERVED 2026-09-11 PT)
+## Latest reported state (2026-09-11 PT; qualified 2026-09-13 UTC)
+
+Counts below are reports from the later HQ dataset note and Notion handoff, not independently inspected corpus bytes. Floors, pack integrity, source rights and E-S3 readiness are NOT_COMPUTABLE in this review. Earlier 482-row/150-weak counts are superseded reports, not the current selected subset. A 242-row preferred HQ pool cannot alone satisfy the 300-row training floor; selection and train permission remain unresolved.
 
 | Area | State |
 |------|-------|
 | Spec 000–003 | Specified + code |
 | Spec 004 encoder gate | Specified · `name_gate` **false** · dataset note landed |
-| Local gold SoT | `~/.semion/corpus/dataset.jsonl` — **482** gold (**not in git**) |
-| OBSERVED share | **14 / 482** (~3%) — wrap/seed lawful INFERRED; AMC/Foundations preferred |
+| Local gold SoT | `~/.semion/corpus/dataset.jsonl` — **452 reported** gold (**not in git; not independently verified**) |
+| OBSERVED share | **14 / 452 reported** (~3%) — wrap/seed lawful INFERRED; AMC/Foundations preferred |
 | Hunt plan | [`docs/amc-foundations-hunt-plan.md`](docs/amc-foundations-hunt-plan.md) |
-| Splits | train **330** · val **50** · test **102** |
-| keep_weak | **150** (demoted wrap-symbol; **not** gold) |
-| Spec 004 class floors | **PASS** (icon/index/symbol ≥15%; mixed/NC ≥8%) |
+| Splits | reported train **300** · val **50** · test **102** |
+| keep_weak | **180 reported** (demoted wrap-symbol; **not** gold) |
+| Spec 004 class floors | Historical **PASS report**; current independent verification **NOT_COMPUTABLE** |
 | Hub / HF | **Skipped** (Danny) |
 | Boof `ALLOW_TRAIN` | **false** — Aaron trains on Spark |
 | Aaron Notion pack | https://app.notion.com/p/3d83e8ba2f5c81608499deffc060160d |
@@ -130,3 +134,5 @@ Hyperlex (form / lexical) · Athanor (tradition structure) · **Semion (sign rel
 ## License
 
 Code: MIT. Corpus atoms carry their own licenses — see [`LICENSE_POLICY.md`](LICENSE_POLICY.md).
+
+Provenance: Notion Sprint 001 Hub [not inspected; Semion handoff read 2026-09-13 UTC] + Loop 805 Slice N/A (Semion advisory) + Hash: e5ed91bd90afb0429cf816504c7d5e622bbbc153 (base)
diff --git a/STATUS.md b/STATUS.md
@@ -1,5 +1,13 @@
 # STATUS
 
+## Current review qualification — 2026-09-13 UTC
+
+OBSERVED base: e5ed91bd90afb0429cf816504c7d5e622bbbc153. Nine existing local tests pass; reproduced gaps remain in direct route denial, epistemic attribution and NC consistency. [Advisory specification](docs/START_HERE.md) now covers the full methodology; target runtime acceptance is NOT_COMPUTABLE, not complete.
+
+Latest reported HQ pool is 452 (300/50/102), keep_weak 180, OBSERVED labels 14, preferred gold_hq 242. The private pack has not been independently validated. Its quality/floor PASS entries below are historical reports. Training subset, permission semantics and label-hidden evaluation remain [open decisions](specs/decisions.md). name_gate remains false; no training, Hub, router, canon or Notion mutation occurs in this patch.
+
+## Historical status ledger — preserved, not refreshed proof
+
 **Lane**: SHADOW
 **Date**: 2026-09-11
 **Version**: 0.1.0
@@ -29,3 +37,5 @@
 | Pre-rebalance zip | quarantined under `/workspace/semion-gold/quarantine/` (404-row pack) |
 | OBSERVED share | **14 / 452** (~3%) — hunt plan: `docs/amc-foundations-hunt-plan.md` |
 | Main tip | `e69e5bf` — M2 HQ pack handoff #6; AMC high7 docs PR advances tip |
+
+Provenance: Notion Sprint 001 Hub [not inspected; Semion handoff read 2026-09-13 UTC] + Loop 805 Slice N/A (Semion advisory) + Hash: e5ed91bd90afb0429cf816504c7d5e622bbbc153 (base)
diff --git a/docs/START_HERE.md b/docs/START_HERE.md
@@ -0,0 +1,30 @@
+# Semion specification entry point
+
+Status: ADVISORY_REVIEW. This does not govern or activate.
+
+Semion classifies signs in circulation, adapts existing source packets, and exports one frame. It remains a BELIEF submodule. It does not own minds, Hyperlex form, Athanor tradition gold, Brier calibration, or Abraxas runtime chains.
+
+## Read in this order
+
+| Stage | Artifact |
+|---|---|
+| 1 Constitution/doctrine | [Unchanged root constitution](../constitution.md); [authority and decisions](../specs/decisions.md) |
+| 2 Domain model | [Domain](../specs/domain-model.md) |
+| 3 Requirements | [Requirements](../specs/requirements.md) |
+| 4 Journeys | [Journeys](../specs/journeys.md) |
+| 5 Workflows | [Workflow registry and specifications](../specs/workflows.md) |
+| 6 State machines | [Transitions](../specs/state-machines.md) |
+| 7 Contracts | [Contract catalog](../specs/contracts.md) |
+| 8 Data model | [Data and provenance](../specs/data-model.md) |
+| 9 Security/privacy/governance | [Boundaries](../specs/security-privacy-governance.md) |
+| 10 Architecture | [Architecture](../ARCHITECTURE.md) |
+| 11 Acceptance criteria | [Acceptance](../specs/acceptance.md) |
+| 12 Traceability | [Traceability](../specs/traceability.json) |
+| 13 Tasks | [Ordered implementation tasks](../specs/completion-tasks.md) |
+| 14 Verification | [Verification and limitations](../specs/verification.md) |
+
+These documents complete the advisory specification structure, not runtime conformance, dataset certification, or E-S3. Existing numbered specifications retain their identity and historical cycle notes. New REQ/WF/SM/CON/AC/TASK IDs are repository-local, stable, and never renumbered; retire with a replacement reference.
+
+Start with [current evidence and conflicts](../specs/assessment.md). Proposed behavioral tightening is explicitly not shipped. The eight open decisions prevent an unconditional implementation-ready claim. No new operator role or authority layer is created.
+
+Provenance: Notion Sprint 001 Hub [not inspected; Semion handoff read 2026-09-13 UTC] + Loop 805 Slice N/A (Semion advisory) + Hash: e5ed91bd90afb0429cf816504c7d5e622bbbc153 (base)
diff --git a/docs/aaron-train-handoff.md b/docs/aaron-train-handoff.md
@@ -1,5 +1,7 @@
 # Aaron train handoff — Semion M2 HQ pack
 
+Current advisory qualification (2026-09-13 UTC): the instructions below are preserved historical source text, not a new train/transfer authorization. The full 452-row pool and preferred 242-row HQ subset are different datasets; do not train heldout rows or claim the subset satisfies full-pool floors. Resolve [DEC-001, DEC-002 and DEC-006](../specs/decisions.md) before use. Pack contents, hash, rights and actual authorization remain NOT_COMPUTABLE in this review. No Notion page or private pack was changed.
+
 **Audience:** Aaron Godbout (Spark)  
 **Date:** 2026-09-11 PT  
 **Repo pin:** `scrimshawlife-ctrl/Semion@e69e5bf` (main tip before this docs PR; docs tip advances on merge)
@@ -64,3 +66,5 @@ Gold pool **452**: OBSERVED **14** · inferred wrap **~210** · inferred seed **
 - Train from the quarantined pre-rebalance (404-row) zip
 - Train from the refuse-reshuffle pack (superseded; pre-HQ leakfix)
 - Grow page-dump wrap mass or pad to 600
+
+Provenance: Notion Sprint 001 Hub [not inspected; Semion handoff read 2026-09-13 UTC] + Loop 805 Slice N/A (Semion advisory) + Hash: e5ed91bd90afb0429cf816504c7d5e622bbbc153 (base)
diff --git a/docs/index.md b/docs/index.md
@@ -1,6 +1,11 @@
 # Semion docs
 
+- [Start here: complete advisory specification](START_HERE.md)
+- [Evidence, gaps and implementation readiness](../specs/assessment.md)
+
 - [Quickstart](quickstart.md)
 - [Dual-use](dual-use.md)
 - Constitution: `../.specify/memory/constitution.md`
 - Specs: `../specs/`
+
+Provenance: Notion Sprint 001 Hub [not inspected; Semion handoff read 2026-09-13 UTC] + Loop 805 Slice N/A (Semion advisory) + Hash: e5ed91bd90afb0429cf816504c7d5e622bbbc153 (base)
diff --git a/out/audit/spec-completion.latest.json b/out/audit/spec-completion.latest.json
@@ -0,0 +1,41 @@
+{
+  "schema_version": "semion.advisory.spec_completion_receipt.v1",
+  "boundary": "Advisory specification reconciliation only. This does not govern or activate. No runtime, constitution, runtime schema, corpus, training, Hub, Notion or merge mutation.",
+  "evidence_packet": {
+    "base_commit": "e5ed91bd90afb0429cf816504c7d5e622bbbc153",
+    "repo": "https://github.com/scrimshawlife-ctrl/Semion",
+    "graph_project": "Semion",
+    "base_graph_nodes": 620,
+    "base_graph_edges": 801,
+    "latest_corpus_counts_reported_not_verified": {"gold": 452, "train": 300, "val": 50, "test": 102, "keep_weak": 180, "observed_labels": 14, "preferred_hq_pool": 242},
+    "independent_corpus_quality": "NOT_COMPUTABLE",
+    "independent_pack_integrity": "NOT_COMPUTABLE",
+    "e_s3": "NOT_COMPUTABLE",
+    "notion_source": "https://app.notion.com/p/3d83e8ba2f5c81608499deffc060160d",
+    "notion_source_last_edited_at": "2026-09-12T00:58:21.253Z",
+    "notion_native_verification": "unverified",
+    "notion_writeback": "NOT_PERFORMED"
+  },
+  "task": "Complete a repository-relevant advisory specification across all 14 methodology stages, with stable workflows and explicit unresolved decisions.",
+  "output_expected": "Reviewable documentation, verification script, sanitized receipt and PR; proposed behavior is not marked shipped.",
+  "validation": {
+    "status": "PASSED_LOCAL",
+    "methodology_stages": 14,
+    "requirements": 20,
+    "workflows": 10,
+    "workflow_fields_each": 16,
+    "state_machines": 6,
+    "contracts": 6,
+    "acceptance_bundles": 10,
+    "implementation_tasks": 10,
+    "open_decisions": 8,
+    "documentation_negative_controls": 11,
+    "existing_pytest_passed": 9,
+    "runtime_target_conformance": "NOT_COMPUTABLE"
+  },
+  "residual_risks": ["Eight decisions remain open", "Runtime gaps remain unfixed", "Private data and external consumer are unverified", "No train/name/Hub authority inferred"],
+  "recommended_next_advisory_action": "Operator reviews DEC-001 through DEC-008; then bounded T0 validation and refusal tasks before a separate encoder cycle.",
+  "authorization": "Operator approved local specification reconciliation, then requested handling PRs from this chat. No merge or runtime authority inferred.",
+  "governance_route": "N/A: no Abraxas Loop 805 orchestration surface exists in Semion. No substitute governance created; Sprint 001 linkage NOT_COMPUTABLE.",
+  "provenance": "Provenance: Notion Sprint 001 Hub [not inspected; Semion handoff read 2026-09-13 UTC] + Loop 805 Slice N/A (Semion advisory) + Hash: e5ed91bd90afb0429cf816504c7d5e622bbbc153 (base)"
+}
diff --git a/specs/000-semion-spine/spec.md b/specs/000-semion-spine/spec.md
@@ -1,5 +1,9 @@
 # Spec 000 — Semion spine
 
+Advisory completion: [methodology index](../../docs/START_HERE.md), [requirements](../requirements.md), [workflows](../workflows.md), [contracts](../contracts.md), [acceptance](../acceptance.md), [traceability](../traceability.json), and [tasks](../completion-tasks.md). Original cycle text below is historical; proposed target behavior and unresolved decisions are separate from current runtime proof. This does not govern or activate.
+
+Provenance: Notion Sprint 001 Hub [not inspected; Semion handoff read 2026-09-13 UTC] + Loop 805 Slice N/A (Semion advisory) + Hash: e5ed91bd90afb0429cf816504c7d5e622bbbc153 (base)
+
 **Feature**: Specialist home for sign-relation work in the Abraxas stack
 **Date**: 2026-09-11
 **Status**: SHADOW specify

diff --git a/specs/001-semion-triad/spec.md b/specs/001-semion-triad/spec.md
@@ -1,5 +1,9 @@
 # Spec 001 — Semion triad T0
 
+Advisory completion: [methodology index](../../docs/START_HERE.md), [requirements](../requirements.md), [workflows](../workflows.md), [contracts](../contracts.md), [acceptance](../acceptance.md), [traceability](../traceability.json), and [tasks](../completion-tasks.md). Original cycle text below is historical; proposed target behavior and unresolved decisions are separate from current runtime proof. This does not govern or activate.
+
+Provenance: Notion Sprint 001 Hub [not inspected; Semion handoff read 2026-09-13 UTC] + Loop 805 Slice N/A (Semion advisory) + Hash: e5ed91bd90afb0429cf816504c7d5e622bbbc153 (base)
+
 **Feature**: Map symbolic-corpus atoms to `semion.frame.v0`
 **Date**: 2026-09-11
 **Status**: SHADOW specify + T0 code in-repo

diff --git a/specs/002-corpus-adapt/spec.md b/specs/002-corpus-adapt/spec.md
@@ -1,5 +1,9 @@
 # Spec 002 — Corpus adapt
 
+Advisory completion: [methodology index](../../docs/START_HERE.md), [requirements](../requirements.md), [workflows](../workflows.md), [contracts](../contracts.md), [acceptance](../acceptance.md), [traceability](../traceability.json), and [tasks](../completion-tasks.md). Original cycle text below is historical; proposed target behavior and unresolved decisions are separate from current runtime proof. This does not govern or activate.
+
+Provenance: Notion Sprint 001 Hub [not inspected; Semion handoff read 2026-09-13 UTC] + Loop 805 Slice N/A (Semion advisory) + Hash: e5ed91bd90afb0429cf816504c7d5e622bbbc153 (base)
+
 **Feature**: Field map from AMC / Foundations / TEACH atoms onto Semion input
 **Date**: 2026-09-11
 **Status**: SHADOW specify + T0 adapter in-repo

diff --git a/specs/003-semiosis-chain/spec.md b/specs/003-semiosis-chain/spec.md
@@ -1,5 +1,9 @@
 # Spec 003 — Semiosis chain
 
+Advisory completion: [methodology index](../../docs/START_HERE.md), [requirements](../requirements.md), [workflows](../workflows.md), [contracts](../contracts.md), [acceptance](../acceptance.md), [traceability](../traceability.json), and [tasks](../completion-tasks.md). Original cycle text below is historical; proposed target behavior and unresolved decisions are separate from current runtime proof. This does not govern or activate.
+
+Provenance: Notion Sprint 001 Hub [not inspected; Semion handoff read 2026-09-13 UTC] + Loop 805 Slice N/A (Semion advisory) + Hash: e5ed91bd90afb0429cf816504c7d5e622bbbc153 (base)
+
 **Feature**: Export `semion.frame.v0` as a SemiosisFrame-shaped dict without owning YGGDRASIL
 **Date**: 2026-09-11
 **Status**: SHADOW specify + export compat in-repo. Rune mint closed.

diff --git a/specs/004-encoder-gate/dataset.md b/specs/004-encoder-gate/dataset.md
@@ -1,5 +1,7 @@
 # Dataset — Semion encoder (gated)
 
+Review qualification (2026-09-13 UTC): this dated dataset note is retained as source evidence, not independent validation of the private corpus. The latest 452-row report is consistent with the linked Notion handoff; 242 preferred HQ rows alone cannot meet the 300-row training floor. Effective subset, permission timing and fair T0 comparison are unresolved in [DEC-001/002/006](../decisions.md). No floor is waived and no training is authorized by this patch. See [WF-005 through WF-009](../workflows.md) and [CON-004 through CON-006](../contracts.md).
+
 **Status**: SHADOW note. Not a harvest. name_gate still false.
 **Date**: 2026-09-11
 **Amend**: M2 rebalance doctrine (2026-09-11 PT) — wrap/seed as lawful INFERRED gold; OBSERVED AMC/Foundations still preferred.
@@ -121,3 +123,5 @@ N in the gate is the **floor** table above until an operator raises it in this f
 ## Hunt plan pointer
 
 See [`docs/amc-foundations-hunt-plan.md`](../../docs/amc-foundations-hunt-plan.md).
+
+Provenance: Notion Sprint 001 Hub [not inspected; Semion handoff read 2026-09-13 UTC] + Loop 805 Slice N/A (Semion advisory) + Hash: e5ed91bd90afb0429cf816504c7d5e622bbbc153 (base)
diff --git a/specs/004-encoder-gate/spec.md b/specs/004-encoder-gate/spec.md
@@ -1,5 +1,9 @@
 # Spec 004 — Encoder gate (closed)
 
+Advisory completion: [methodology index](../../docs/START_HERE.md), [requirements](../requirements.md), [workflows](../workflows.md), [contracts](../contracts.md), [acceptance](../acceptance.md), [traceability](../traceability.json), and [tasks](../completion-tasks.md). Original cycle text below is historical; proposed target behavior and unresolved decisions are separate from current runtime proof. This does not govern or activate.
+
+Provenance: Notion Sprint 001 Hub [not inspected; Semion handoff read 2026-09-13 UTC] + Loop 805 Slice N/A (Semion advisory) + Hash: e5ed91bd90afb0429cf816504c7d5e622bbbc153 (base)
+
 **Feature**: Conditions under which `semion-encoder-*` may exist as weights
 **Date**: 2026-09-11
 **Status**: SHADOW specify. Train closed. name_gate false.