@kontextmind/kxm 0.7.95 → 0.7.96

package/docs/templates/bug-fix.md

@@ -2,7 +2,7 @@
 schema: "kxm.doc.v1"
 id: "BUG-0001"
 type: "bug"
-title: "Observable Failure / Defect Summary"
+title: "Bug: <observable failure>"
 project: "kxm"
 status: "draft" # draft | in_review | approved | superseded | archived
 owner: "@owner"
@@ -19,9 +19,9 @@ details:
   reproducibility: "always" # always | intermittent | environment_specific
 ---
 
-# Bug: <Observable Failure / Defect Summary>
+# Bug: <Observable failure / defect summary>
 
-## Impact & Affected Scope
+## Impact and affected scope
 
 - **User / Operator Impact:** <What fails, crashes, or produces incorrect outputs?>
 
@@ -29,35 +29,35 @@ details:
 
 - **Workaround:** <Temporary safe mitigation if available>
 
-## Expected vs. Actual Behavior
+## Expected and actual behavior
 
 - **Expected:** <Precise, observable contract expectation>
 
 - **Actual:** <Exact error message, stack trace, or wrong output>
 
-## Environment & Baseline State
+## Environment and baseline state
 
 - **Baseline Commit:** `<git-sha-before-fix>`
 
-- **Node / Runtime Version:** `Node 22.19.0 / Node 24.15.0`
+- **Node version:** `<for example 22.19.0 or 24>`
 
 - **Active Harness / Model:** `<Harness and model if relevant>`
 
 - **OS:** `macOS / Linux`
 
-## Mandatory Repro Before Fix (Oracle Invariant)
+## Mandatory reproduction before the fix
 
 To prevent phantom fixes, a failing reproduction test MUST be established before modifying production code:
 
 - **Failing Test File:** `test/core/<bug-name>.test.ts`
 
-- **Reproduction Command:** `node --test test/core/<bug-name>.test.ts`
+- **Reproduction Command:** `node --disable-warning=ExperimentalWarning --experimental-strip-types --test test/core/<bug-name>.test.ts`
 
 - **Baseline Observed Result:** `FAIL` (exit code 1)
 
 - **Repro Failure Receipt:** `artifact:.kxm/assets/repro-fail.log@sha256:...`
 
-## Failure Path Sequence
+## Failure path sequence
 
 ```mermaid
 sequenceDiagram
@@ -74,7 +74,7 @@ sequenceDiagram
 
 *Failure sequence: Unhandled contention leads to ungraceful crash instead of deterministic retry or clean fail-closed error.*
 
-## Root Cause Analysis
+## Root cause analysis
 
 - **Immediate Cause:** <What line or condition directly triggered the symptom?>
 
@@ -82,7 +82,7 @@ sequenceDiagram
 
 - **Rejected Hypotheses:** <What initial assumptions were investigated and ruled out?>
 
-## Proposed Fix & Contract Changes
+## Proposed fix and contract changes
 
 - **Code Changes:** <Summary of modifications to code or schemas>
 
@@ -90,19 +90,16 @@ sequenceDiagram
 
 - **Security / Isolation:** <Does the fix maintain fail-closed invariants?>
 
-## Verification Witness Matrix
+## Verification witness matrix
 
 | Verification Check | Target Commit / Tree | Expected Result | Actual Result | Witness Artifact |
-
 |---|---|---|---|---|
 | Repro Test (Before Fix) | `<baseline-commit>` | FAIL | FAIL | `artifact:...@sha256` |
-
 | Repro Test (After Fix) | `<candidate-commit>` | PASS | PASS | `artifact:...@sha256` |
 | Full Core Test Suite | `<candidate-commit>` | 100% PASS | 100% PASS | `npm run test:core` |
-
 | Full Verify Gate | `<candidate-commit>` | PASS | PASS | `npm run verify` |
 
-## Regression Prevention
+## Regression prevention
 
 - **Automated Gate Added:** <New unit test or lint check preventing recurrence>
 

package/docs/templates/feature.md

@@ -2,7 +2,7 @@
 schema: "kxm.doc.v1"
 id: "FEAT-0001"
 type: "feature"
-title: "Feature Name"
+title: "Feature: <feature name>"
 project: "kxm"
 status: "draft" # draft | in_review | approved | superseded | archived
 owner: "@owner"
@@ -15,12 +15,12 @@ tags: []
 related: []
 details:
   delivery_status: "proposed"
-  target_workflow: "feature-delivery"
+  target_workflow: "build-feature" # a workflow slug from docs/reference/workflow-catalog.md
 ---
 
-# Feature: <Feature Name>
+# Feature: <Feature name>
 
-## Problem & Users
+## Problem and users
 
 - **Who needs this:** <Describe primary user persona or operator role>
 
@@ -28,7 +28,7 @@ details:
 
 - **Evidence / Driver:** <User friction, issue link, or performance data demonstrating the need>
 
-## Goals & Non-Goals
+## Goals and non-goals
 
 - **Goals:**
   - <Measurable outcome 1>
@@ -37,16 +37,14 @@ details:
 - **Non-Goals:**
   - <Explicitly excluded behavior or deferred capability>
 
-## Requirements & Acceptance Criteria
+## Requirements and acceptance criteria
 
 | ID | Requirement | Acceptance Criterion (Given / When / Then) | Verification Kind |
-
 |---|---|---|---|
 | REQ-01 | <Observable behavior> | Given ..., when ..., then ... | gate / witness |
-
 | REQ-02 | <Error or permission boundary> | Given invalid input, when submitted, then fail closed with ... | gate / witness |
 
-## User & Execution Flow
+## User and execution flow
 
 ```mermaid
 flowchart LR
@@ -60,7 +58,7 @@ flowchart LR
 
 *Flow description: The request is validated against permissions and schema before execution. Invalid calls fail closed with actionable errors.*
 
-## Behavior & Interface Contracts
+## Behavior and interface contracts
 
 - **Inputs & CLI Flags:** <Specify syntax and types>
 
@@ -70,24 +68,21 @@ flowchart LR
 
 - **Concurrency & Idempotency:** <Timeout limits, lock keys, and duplicate dispatch protection>
 
-## Quality & Resource Budgets
+## Quality and resource budgets
 
 | Dimension | Target Budget | Measurement Condition | Verification Method |
-
 |---|---|---|---|
 | Latency P50 | < e.g., 200ms | Local CLI dispatch | Benchmark test |
-
 | Token Budget | < e.g., 8,000 tokens | Context packet compilation | Context Arbiter log |
-| Test Coverage | >= 92% lines, >= 80% branches | `npm run test:core` | Vitest / Node test runner |
+| Test Coverage | >= 91% lines, >= 80% branches, >= 92% functions | `npm run test:coverage` | Node test runner (`node:test`) |
 
-## Dependencies & Risks
+## Dependencies and risks
 
 | Dependency / Risk | Potential Impact | Mitigation Strategy | Owner |
-
 |---|---|---|---|
 | <Dependency> | <Failure mode> | <Fallback or isolation> | <Role> |
 
-## Validation & Verification Gates
+## Validation and verification gates
 
 - **Unit / Core Suite:** `npm run test:core`
 
@@ -95,7 +90,7 @@ flowchart LR
 
 - **Combined Commit Gate:** `npm run verify`
 
-## Rollout & Rollback
+## Rollout and rollback
 
 - **Rollout Strategy:** <Staged feature flag, CLI release, or workflow gate>
 
@@ -103,6 +98,6 @@ flowchart LR
 
 - **Rollback Action:** <Git revert or toggle flag>
 
-## Open Questions
+## Open questions
 
 1. <Unresolved design question, assigned owner, and target decision milestone>

package/docs/templates/handoff.md

@@ -2,71 +2,69 @@
 schema: "kxm.doc.v1"
 id: "HND-0001"
 type: "handoff"
-title: "Structured Agent / Stage Handoff Manifest"
+title: "Structured handoff manifest"
 project: "kxm"
-status: "approved"
-owner: "@source_role"
+status: "draft" # draft | in_review | approved | superseded | archived
+owner: "@source-role"
 created: "2026-09-08"
 updated: "2026-09-08"
 authority: "evidence"
 confidence: "verified"
-summary: "Formal handoff from <source_role> to <target_role> for workflow <workflow_id>."
+summary: "Handoff from <source-role> to <target-role> for workflow run <run-id>."
 tags: ["handoff", "workflow", "stage-transition"]
 related: []
 details:
-  workflow_run_id: "run-01928abc"
-  handoff_manifest_id: "hnd_01928abcde12"
-  intent: "request_review" # continue | request_review | reject_rework_required | complete
+  manifest_schema: "kxm.handoff-manifest.v1"
+  workflow_run_id: "<run-id>"
+  handoff_id: "<handoff-id>"
+  intent: "request_review" # request_review | dispatch_fix | request_approval | complete_workflow
+  handoff_status: "pending" # pending | accepted | rejected | superseded
+  rework_of: null
 ---
 
-# Structured Handoff Manifest
+# Handoff: <source-role> to <target-role>
 
-## Stage Transition Provenance
+> [!IMPORTANT]
+> Planned: the `kxm.handoff-manifest.v1` schema exists, but no KXM command or Runtime step writes handoff manifests yet, so record each handoff by hand.
 
-- **Workflow Run ID:** `run-01928abc`
+This page is the readable view of one `kxm.handoff-manifest.v1` record, defined
+in `schemas/handoff-manifest.schema.json`. Keep its field names so the two stay
+aligned.
 
-- **Task ID:** `task-127`
+## Stage transition
 
-- **Source Role:** `writer` (Harness: `grok`, Model: `grok-4.6`)
+- **Workflow run ID:** `<run-id>`
+- **Task ID:** `<task-id>`
+- **Source:** role `writer`, agent `<agent-id>`, harness `grok`, model
+  `grok-4.6`, step `<step-id>`, attempt `<attempt-id>`
+- **Target:** role `reviewer-arch`, permission `read-only`
+- **Intent:** `request_review` (one of `request_review`, `dispatch_fix`,
+  `request_approval`, `complete_workflow`)
+- **Rework of:** `<handoff-id>`, or none
 
-- **Target Role:** `reviewer-arch` (Harness: `claude`, Model: `claude-fable-5-1`)
+## Repository anchors
 
-- **Intent:** `request_review`
+- **Base commit:** `<base-commit-sha>`
+- **Candidate tree hash:** `<candidate-tree-sha>`
+- **Branch:** `kxm/run-<run-id>-<description>`
 
-## Repository & Branch Anchors
+## Deliverables
 
-- **Base Commit:** `44a7b50f9a2b6e14d3c2a1e09876543210abcdef`
+- **Patches:** `artifact:.kxm/assets/<run-id>/changes.patch@sha256:<digest>`
+- **Reports:** `artifact:.kxm/assets/<run-id>/test-report.md@sha256:<digest>`
+- **Artifacts:** `<name>`: `artifact:<path>@sha256:<digest>`
 
-- **Candidate Commit:** `88b6c40a12e34f56789abcdef0123456789abcde`
+## Verification evidence
 
-- **Candidate Tree Hash:** `789abcdef0123456789abcdef0123456789abcde`
+- **Witness command:** `npm run verify`
+- **Witness exit code:** `0`
+- **Witness passed:** `true`
+- **Critic verdicts:** `<critic>`: `PASS`, with a one-line summary. The
+  manifest accepts `PASS`, `FAIL`, `WARN` or `UNKNOWN`.
 
-- **Deterministic Branch:** `kxm/run-01928abc-fix-issue-127-memory-arbiter`
+## Transferred context
 
-## Deliverables & Evidence
-
-### 1. Artifacts Created
-
-- `artifact:.kxm/assets/changes.patch@sha256:abc...`
-
-- `artifact:.kxm/assets/witness.log@sha256:def...`
-
-### 2. Witness Receipt
-
-- **Command:** `npm run verify`
-
-- **Exit Code:** `0`
-
-- **Receipt Hash:** `sha256:fedcba0987654321...`
-
-## Transferred Context & Decisions
-
-- **Settled Decisions:**
-  - Used SQLite `external_effects` table for CAS leasing.
-  - Implemented descriptive branch slugification with de-duplication.
-
-- **Assumptions:**
-  - Remote repository branch protection requires PR merge.
-
-- **Open Questions / Notes for Target Role:**
-  - Please verify memory revision hash changes deterministically when files in `.kxm/memory/` are touched.
+- **Settled decisions:** <decisions the target role must not reopen>
+- **Assumptions:** <assumptions the target role should verify>
+- **Open questions:** <questions for the target role>
+- **Suggested next step:** step `<step-id>`, action `<action>`

package/docs/templates/postmortem.md

@@ -2,9 +2,9 @@
 schema: "kxm.doc.v1"
 id: "PM-0001"
 type: "postmortem"
-title: "Incident Postmortem: <Incident Title>"
+title: "Incident postmortem: <incident title>"
 project: "kxm"
-status: "approved"
+status: "draft" # draft | in_review | approved | superseded | archived
 owner: "@incident-lead"
 created: "2026-09-08"
 updated: "2026-09-08"
@@ -20,58 +20,45 @@ details:
   time_to_mitigate_minutes: 20
 ---
 
-# Incident Postmortem: <Incident Title>
+# Incident postmortem: <incident title>
 
-## Executive Summary
+## Summary
 
-- **Incident Period:** `2026-09-08 14:10 UTC` to `2026-09-08 14:35 UTC` (25 minutes)
+- **Incident period:** `<start UTC>` to `<end UTC>` (<duration>)
+- **User impact:** <number of workflow runs blocked or delayed, and for whom>
+- **Root cause:** <one sentence on the failure mechanism>
 
-- **User Impact:** <Number of workflow runs blocked or delayed>
-
-- **Root Cause:** <One-sentence summary of failure mechanism>
-
-## Incident Timeline (UTC)
-
-| Time | Event Description | Detected By |
+## Timeline (UTC)
 
+| Time | Event | Detected by |
 |---|---|---|
-| 14:10 | AI worker crashed during git push; CAS effect left in `dispatched` state | Log watcher |
-
-| 14:15 | Subsequent retry attempts blocked due to unexpired CAS lease | `kxm dash` operator |
-| 14:22 | Operator pressed `d` (degrade) to inspect worktree manually | Interactive TUI |
-
-| 14:30 | Fix committed; lease expiration policy patched | Operator |
-| 14:35 | Hub restarted; all queued workflow runs completed | Verifier |
-
-## Root Cause Analysis (5 Whys)
-
-1. **Why did the retry fail?** Because the CAS effect lease was locked in `dispatched` state.
-
-2. **Why was it still locked?** Because the previous worker process exited abnormally without calling abort.
-
-3. **Why did the lease not expire?** Because the lease had no automated heartbeat timeout.
-
-4. **Why was there no timeout?** Because CAS leasing was assumed to be synchronous.
-
-5. **Systemic Root Cause:** Missing failure recovery watchdog for unconfirmed external side-effect leases.
-
-## What Went Well / What Went Wrong
+| <hh:mm> | <first symptom, for example a worker exits during `git push`> | <log watcher, `kxm dash`, a user> |
+| <hh:mm> | <what the operator saw next, for example retries refused on a held lease> | <source> |
+| <hh:mm> | <mitigation, for example the operator degrades the run from `kxm dash` with `d`> | <source> |
+| <hh:mm> | <fix committed or configuration changed> | <source> |
+| <hh:mm> | <service restored and verified, for example queued runs complete> | <source> |
 
-### What Went Well
+## Root cause analysis (five whys)
 
-- The database remained consistent; zero duplicate PRs were created on GitHub.
+1. **Why did <symptom> happen?** <Because …>
+2. **Why did <cause 1> happen?** <Because …>
+3. **Why did <cause 2> happen?** <Because …>
+4. **Why did <cause 3> happen?** <Because …>
+5. **Systemic root cause:** <the missing control, test, or gate>
 
-- Degrade-to-human hotkey (`d`) allowed the operator to take over immediately.
+## What went well and what went wrong
 
-### What Went Wrong
+### What went well
 
-- The error message in `kxm dash` did not explicitly indicate how to force-release an abandoned lease.
+- <For example: state stayed consistent and no duplicate pull request was created>
 
-## Corrective & Preventive Action Items
+### What went wrong
 
-| Action Item | Type | Owner | Target Date | Issue Reference |
+- <For example: the error message did not say how to recover>
 
-|---|---|---|---|---|
-| Add 300s automated lease timeout to `ExternalEffectsLedger` | Prevent | Platform Lead | 2026-09-10 | #165 |
+## Corrective and preventive actions
 
-| Add `kxm routing unquarantine` CLI command | Mitigate | CLI Lead | 2026-09-12 | #166 |
+| Action | Type | Owner | Tracking |
+|---|---|---|---|
+| <Add a failing test that reproduces the incident> | Prevent | <role> | <issue link> |
+| <Improve the error message to name the recovery command> | Mitigate | <role> | <issue link> |

package/docs/templates/research.md

@@ -2,7 +2,7 @@
 schema: "kxm.doc.v1"
 id: "RES-0001"
 type: "research"
-title: "Research Topic / Spike Question"
+title: "Research: <topic or spike question>"
 project: "kxm"
 status: "draft" # draft | in_review | approved | superseded | archived
 owner: "@owner"
@@ -18,9 +18,9 @@ details:
   target_decision_date: "2026-09-15"
 ---
 
-# Research: <Research Topic / Spike Question>
+# Research: <Research topic / spike question>
 
-## Decision to Enable
+## Decision to enable
 
 - **Pending Decision:** <What exact architectural, model routing, or product decision depends on this investigation?>
 
@@ -28,7 +28,7 @@ details:
 
 - **Constraints & Guardrails:** <Budget limits, latency thresholds, security boundaries>
 
-## Questions & Falsifiable Hypotheses
+## Questions and falsifiable hypotheses
 
 - **Primary Question:** <What are we trying to discover or prove?>
 
@@ -36,7 +36,7 @@ details:
 
 - **Falsification Condition:** <What exact result or metric will prove this hypothesis wrong?>
 
-## Methodology & Verification Setup
+## Methodology and verification setup
 
 ```mermaid
 flowchart LR
@@ -50,48 +50,43 @@ flowchart LR
 
 *Methodology flow: Establish bounds, execute reproducible trials, analyze telemetry metrics, and recommend concrete next actions.*
 
-- **Harness & Model Arms:** <List evaluated routes, e.g. Grok native vs Pi wrapper vs Claude Fable>
+- **Harness & Model Arms:** <List evaluated routes, for example native `grok` versus `pi` with an OpenRouter model>
 
 - **Test Fixture / Workload:** <Exact repository task or test suite executed>
 
 - **Budget Ceiling:** <Maximum dollar or token limit for this spike>
 
-## Evidence Register
+## Evidence register
 
 | Evidence ID | Claim / Finding | Source Artifact / Telemetry Run | Version / Date | Confidence |
-
 |---|---|---|---|---|
 | EV-01 | <Empirical claim> | `artifact:.kxm/logs/telemetry.jsonl@sha256:...` | 2026-09-08 | verified |
+| EV-02 | <Model behavior observation> | `<run-id>` transcript | 2026-09-08 | probable |
 
-| EV-02 | <Model behavior observation> | `run-01928abc` transcript | 2026-09-08 | probable |
-
-## Option Comparison Matrix
-
-| Evaluation Criterion | Weight | Option A (e.g., Native) | Option B (e.g., Wrapper) | Measured Evidence |
+## Option comparison matrix
 
+| Evaluation Criterion (example values) | Weight | Option A (e.g., Native) | Option B (e.g., Wrapper) | Measured Evidence |
 |---|---|---|---|---|
 | Verification Pass Rate | High | 84.0% | 40.0% | EV-01 |
-
 | Latency P50 | Medium | 187s | 284s | EV-01 |
 | Cost per Successful Run | High | $0.20 | $1.03 | EV-01 |
-
 | Rework Rate | High | 68% | 100% | EV-01 |
 
-## Findings & Distinctions
+## Findings and distinctions
 
-### Verified Observations (Backed by Evidence IDs)
+### Verified observations (backed by evidence IDs)
 
 - <Direct observation referencing EV-xx>
 
-### Inferences & Working Hypotheses
+### Inferences and working hypotheses
 
 - <Reasoning or extrapolation; clearly separated from hard evidence>
 
-### Unresolved Unknowns
+### Unresolved unknowns
 
 - <Gaps that remain uncertain or could not be measured>
 
-## Recommendation & Revisit Conditions
+## Recommendation and revisit conditions
 
 - **Recommended Course of Action:** <Specific choice or architectural pattern>
 

package/docs/templates/review.md

@@ -2,84 +2,83 @@
 schema: "kxm.doc.v1"
 id: "REV-0001"
 type: "review"
-title: "Dual-Critic Review Report"
+title: "Dual-critic review report"
 project: "kxm"
-status: "approved" # draft | in_review | approved | rejected
+status: "draft" # draft | in_review | approved | superseded | archived
 owner: "@critics"
 created: "2026-09-08"
 updated: "2026-09-08"
 authority: "evidence"
 confidence: "verified"
-summary: "Independent dual-critic evaluation for candidate commit <git-sha>."
+summary: "Independent dual-critic review of candidate tree <tree-sha>."
 tags: ["review", "critics", "quorum"]
 related: []
 details:
-  quorum_verdict: "passed" # passed | rework_required | blocked
-  target_commit: "<git-sha>"
+  outcome: "accepted" # accepted | repair_required
+  target_commit: "<commit-sha>"
+  judged_tree: "<tree-sha>"
   critics:
-    - role: "reviewer-arch"
+    - kind: "review-arch"
+      role: "reviewer-arch"
       harness: "claude"
-      model: "claude-fable-5-1"
-      verdict: "pass_with_stipulations"
-    - role: "reviewer-cli"
+      model: "fable"
+      verdict: "PASS" # PASS | BLOCK
+    - kind: "review-cli"
+      role: "reviewer-cli"
       harness: "codex"
       model: "gpt-5.6-sol"
-      verdict: "pass"
+      verdict: "PASS" # PASS | BLOCK
 ---
 
-# Dual-Critic Review Report
+# Dual-critic review report
 
-## Review Scope & Provenance
+## Review scope and provenance
 
-- **Candidate Commit:** `<git-sha>`
+- **Candidate commit:** `<commit-sha>`
+- **Judged tree:** `<tree-sha>`. Each critic records the exact tree it
+  reviewed; a verdict on any other tree does not count.
+- **Branch:** `kxm/run-<run-id>-<description>`
+- **Independence rule:** each critic comes from a different vendor than the
+  writer and than each other. For example, a Grok (xAI) writer with Claude
+  (Anthropic) and Codex (OpenAI) critics.
 
-- **Candidate Tree Hash:** `<tree-sha>`
+## Critic 1: architecture (`review-arch`)
 
-- **Deterministic Branch:** `kxm/run-<id>-<description>`
-
-- **Independent Provider Rule:** Reviewers MUST originate from different providers than the implementer (Grok/xAI implementer $\rightarrow$ Claude/Anthropic + Codex/OpenAI critics).
-
-## Critic 1: Claude Fable 5.1 (Planning & Architecture Critic)
-
-- **Role:** `reviewer-arch`
-
-- **Focus Areas:** Fail-closed security boundaries, memory isolation, permission ceilings, state consistency.
-
-- **Verdict:** **PASS WITH STIPULATIONS**
+- **Role:** `reviewer-arch`, read-only
+- **Focus:** fail-closed security boundaries, permission ceilings, state
+  consistency, memory isolation.
+- **Verdict:** `PASS` or `BLOCK`
 
 ### Findings
 
-| ID | Severity | Category | Path | Line | Description |
-
-|---|---|---|---|---|---|
-| F-01 | warning | concurrency | `plugins/kxm/src/external-effects.ts` | 68 | Uncommitted CAS lease must enforce a 5-minute timeout on worker crash. |
+| ID | Severity | Location | Finding |
+|---|---|---|---|
+| A-01 | warning | `<path>:<symbol>` | <What is wrong and why it matters> |
+| A-02 | info | `<path>:<symbol>` | <Observation that needs no change> |
 
-| F-02 | info | architecture | `plugins/kxm/src/arbiter.ts` | 240 | Project knowledge correctly prioritized ahead of `_shared` defaults. |
+## Critic 2: CLI and docs (`review-cli`)
 
-## Critic 2: GPT Astra / Codex (CLI, Ergonomics & Failure Modes)
-
-- **Role:** `reviewer-cli`
-
-- **Focus Areas:** CLI flags, error messages, terminal output, performance, failure resilience.
-
-- **Verdict:** **PASS**
+- **Role:** `reviewer-cli`, read-only
+- **Focus:** CLI flags, error messages, terminal output, documentation,
+  failure modes.
+- **Verdict:** `PASS` or `BLOCK`
 
 ### Findings
 
-| ID | Severity | Category | Path | Line | Description |
-
-|---|---|---|---|---|---|
-| A-01 | info | ergonomics | `plugins/kxm/src/external-effects.ts` | 80 | Descriptive branch slugging provides clean readability in `git branch`. |
-
-## Quorum & Dissent Reconciliation
-
-| Finding ID | Raised By | Severity | Author Response / Resolution | Status |
+| ID | Severity | Location | Finding |
+|---|---|---|---|
+| C-01 | info | `<path>:<symbol>` | <Observation> |
 
-|---|---|---|---|---|
-| F-01 | Claude Fable | warning | Implemented 300s expiration check in `claimEffect()`. | Resolved |
+## Resolution of findings
 
-## Final Quorum Signoff
+| Finding | Raised by | Resolution | Status |
+|---|---|---|---|
+| A-01 | `review-arch` | <Change made, or why none is needed> | Resolved |
 
-- **Quorum Status:** **RECONCILED PASS**
+## Outcome
 
-- **Action:** Ready for acceptance binding via `just accept` or workflow stage transition.
+- **Both critics `PASS` on the judged tree:** ready for acceptance, through
+  the workflow's next step or, in the KXM repository, `just accept`.
+- **Either critic `BLOCK`:** send the work back for repair, re-run the witness,
+  and review the new tree. In the KXM repository that is a `repair` assignment
+  with `rework_of`; see [Assignment runner](../contributing/assignment-runner.md).