@iowarp/clio-coder 0.3.7 → 0.3.8

package/dist/{wiki-generate-ASIFASCN.js → wiki-generate-6M7GHTBJ.js}

@@ -5,41 +5,38 @@ import {
 import {
   SchedulingDomainModule,
   createPromptsDomainModule
-} from "./chunk-EBEFWSGL.js";
+} from "./chunk-5DHKRSMQ.js";
 import {
   SafetyDomainModule
-} from "./chunk-J7PIKKWC.js";
+} from "./chunk-EMYUUSFG.js";
 import {
   ConfigDomainModule,
   loadDomains
-} from "./chunk-BMWK7ZIZ.js";
+} from "./chunk-FHJEP5SW.js";
+import {
+  ResourcesDomainModule
+} from "./chunk-U6MBIEMB.js";
+import {
+  AgentsDomainModule
+} from "./chunk-FBVTI2TJ.js";
+import "./chunk-DR52UMZW.js";
+import "./chunk-TANS5ZJS.js";
+import "./chunk-DGSYXYMX.js";
 import {
   createObservabilityDomainModule
-} from "./chunk-5UJ6ECTS.js";
+} from "./chunk-WNIJTQQK.js";
 import "./chunk-GWS3VEIW.js";
 import "./chunk-HFSBBKSQ.js";
-import "./chunk-YD734TPH.js";
+import "./chunk-26LEYJZH.js";
+import "./chunk-WXY7KU3G.js";
 import {
   ContextDomainModule,
   buildWikiPagePrompt,
   buildWikiPlanPrompt
-} from "./chunk-4DWFMQDR.js";
+} from "./chunk-WSB3FPX7.js";
 import "./chunk-LCGCVYZ4.js";
 import "./chunk-5WIGXA4T.js";
-import "./chunk-6M7VS3J3.js";
-import {
-  DispatchDomainModule
-} from "./chunk-UUANF5CR.js";
-import {
-  SessionDomainModule
-} from "./chunk-6TUKSZVF.js";
-import "./chunk-KZ2H5X4G.js";
-import "./chunk-M4AKACEO.js";
-import "./chunk-RVG5JXAL.js";
-import "./chunk-ZGH7FGS5.js";
-import "./chunk-TSHXZTOQ.js";
-import "./chunk-TXOTCRLG.js";
-import "./chunk-HVDIIIQW.js";
+import "./chunk-TYPGUK6W.js";
 import {
   MAX_PAGE_ATTEMPTS,
   pendingPages,
@@ -48,36 +45,39 @@ import {
 } from "./chunk-NDINPTJ4.js";
 import "./chunk-MVVUPGPW.js";
 import {
-  ResourcesDomainModule
-} from "./chunk-THKY7CD7.js";
+  DispatchDomainModule
+} from "./chunk-TLQJPP24.js";
 import {
-  AgentsDomainModule
-} from "./chunk-UVDSQ6LW.js";
-import "./chunk-DR52UMZW.js";
-import "./chunk-C4JBQ5SR.js";
-import "./chunk-2SFS6XQE.js";
-import "./chunk-ZWLZP4ZT.js";
+  SessionDomainModule
+} from "./chunk-YS5VLNH5.js";
+import "./chunk-K4XHGFR5.js";
+import "./chunk-MXKJU4JB.js";
+import "./chunk-J3YUBZWY.js";
+import "./chunk-RVG5JXAL.js";
 import "./chunk-W6GROXXM.js";
-import "./chunk-KCMKRQX4.js";
+import "./chunk-E77JEWSD.js";
+import "./chunk-DYIM5TJT.js";
+import "./chunk-JVCV3ICN.js";
+import "./chunk-2HEJ2F35.js";
+import "./chunk-TXOTCRLG.js";
+import "./chunk-HVDIIIQW.js";
 import {
   MiddlewareDomainModule
-} from "./chunk-XEGB6BCN.js";
-import "./chunk-IR4CFBFN.js";
+} from "./chunk-7RGZWPB6.js";
+import "./chunk-VCBR6CU7.js";
 import "./chunk-UOV2BYIW.js";
-import "./chunk-WHGPSPT5.js";
-import "./chunk-CEYBNUGC.js";
-import "./chunk-5FR74PWO.js";
-import "./chunk-OBMAI2DP.js";
-import "./chunk-5C77SEEY.js";
-import "./chunk-UND3GU2L.js";
-import "./chunk-CMZWFGD2.js";
-import "./chunk-I4HZDVNP.js";
-import "./chunk-GH5622CP.js";
+import "./chunk-ZVJ5BLO2.js";
 import "./chunk-VG7TBQIY.js";
+import "./chunk-A3WNZD3P.js";
+import "./chunk-5FR74PWO.js";
+import "./chunk-P43ETTHK.js";
+import "./chunk-H7IXIC72.js";
+import "./chunk-5H3GB5BO.js";
+import "./chunk-A2NJGIB3.js";
 import "./chunk-OQE5J4C6.js";
 import "./chunk-GOXNB3AO.js";
 import "./chunk-HWUFFB6L.js";
-import "./chunk-DJNLUABN.js";
+import "./chunk-TTHACPOM.js";
 import "./chunk-AOCYTWAV.js";
 import "./chunk-MV3K5QF2.js";
 import "./chunk-UL3WSD3F.js";
@@ -85,47 +85,52 @@ import "./chunk-ODFEOB4F.js";
 import "./chunk-OZNBF4L3.js";
 import "./chunk-4BJ5BYCE.js";
 import "./chunk-ECH6PKUQ.js";
+import "./chunk-CMZWFGD2.js";
+import "./chunk-I4HZDVNP.js";
 import "./chunk-6XLNIQDB.js";
 import "./chunk-5B2AEOW5.js";
 import {
   ToolNames
 } from "./chunk-CGKSTWHD.js";
 import "./chunk-M6L6IDJG.js";
-import "./chunk-XAKHZX5N.js";
 import "./chunk-UUVG37B4.js";
 import "./chunk-LBMZMYH2.js";
+import "./chunk-XAKHZX5N.js";
 import "./chunk-33YXPOE3.js";
+import "./chunk-7CR24IG7.js";
 import {
   ProvidersDomainModule,
   canonicalizeWireModelId
-} from "./chunk-VQNODYQ4.js";
+} from "./chunk-7RFXX52T.js";
 import "./chunk-CFGTUFWB.js";
-import "./chunk-JRIO5UD2.js";
+import "./chunk-LU7P4LHA.js";
+import "./chunk-RWSI4YD7.js";
 import "./chunk-IHXBNWMM.js";
-import "./chunk-GEYXPTRF.js";
-import "./chunk-UHXRNZ2J.js";
+import "./chunk-B5CSFE7B.js";
+import "./chunk-IJ7RPIYJ.js";
+import "./chunk-FQ4SKYE4.js";
+import "./chunk-ZGVHUX3M.js";
+import "./chunk-TT36MB5S.js";
+import "./chunk-3BINW3FP.js";
+import "./chunk-R346GLFC.js";
+import "./chunk-6EJMN2Y3.js";
+import "./chunk-IWHMRKLL.js";
+import "./chunk-NMPKI6XL.js";
 import "./chunk-4DGYLA73.js";
 import "./chunk-LL4KHSZI.js";
-import "./chunk-SST6Z5JA.js";
-import "./chunk-FO5ZOVUY.js";
-import "./chunk-R346GLFC.js";
-import "./chunk-D4MDIG46.js";
-import "./chunk-FQ4SKYE4.js";
 import "./chunk-4ZG3XFUR.js";
+import "./chunk-IIZWH4XA.js";
+import "./chunk-EQ63NRB7.js";
+import "./chunk-SST6Z5JA.js";
 import "./chunk-IKCO5N3L.js";
 import "./chunk-3I7MS7N2.js";
-import "./chunk-FCSXB6T2.js";
 import "./chunk-APJ265NV.js";
-import "./chunk-YXLYO42X.js";
 import "./chunk-BNAZZHFG.js";
-import "./chunk-6EJMN2Y3.js";
 import "./chunk-WEPFGWHJ.js";
-import "./chunk-X2KV5FXT.js";
-import "./chunk-ZGVHUX3M.js";
-import "./chunk-OB5HIGJY.js";
-import "./chunk-JVCV3ICN.js";
-import "./chunk-7CR24IG7.js";
-import "./chunk-IWHMRKLL.js";
+import "./chunk-NUGM5KR6.js";
+import "./chunk-PT7HYKEM.js";
+import "./chunk-FCSXB6T2.js";
+import "./chunk-YXLYO42X.js";
 import {
   init_esm_shims
 } from "./chunk-3R73A4XB.js";
@@ -445,4 +450,4 @@ export {
   resolveDocumenterModelId,
   runWikiDispatch
 };
-//# sourceMappingURL=wiki-generate-ASIFASCN.js.map
+//# sourceMappingURL=wiki-generate-6M7GHTBJ.js.map

package/dist/worker/entry.js

@@ -16,25 +16,29 @@ import {
   resolveDeliveryTools,
   sanitizeLockedSynthesisMessage,
   workerLoopBlockBudget
-} from "../chunk-QCTRSGHQ.js";
+} from "../chunk-WLFILSD5.js";
 import "../chunk-K7VKOLQQ.js";
 import {
   createMiddlewareContractFromSnapshot,
   createMiddlewareToolChoiceControl,
   shouldRequestStalledTurnContinuation
-} from "../chunk-XEGB6BCN.js";
+} from "../chunk-7RGZWPB6.js";
 import {
   CONFIRMED_SCOPE,
   READONLY_SCOPE,
   WORKSPACE_SCOPE,
   isSubset
-} from "../chunk-IR4CFBFN.js";
+} from "../chunk-VCBR6CU7.js";
 import {
   createLoopState,
   observe
 } from "../chunk-UOV2BYIW.js";
-import "../chunk-EELBMBT6.js";
-import "../chunk-WHGPSPT5.js";
+import "../chunk-PMDBGQSJ.js";
+import "../chunk-XN3L4EYL.js";
+import "../chunk-SPULKLCF.js";
+import "../chunk-KTYTFRMB.js";
+import "../chunk-ZVJ5BLO2.js";
+import "../chunk-VG7TBQIY.js";
 import {
   DEFAULT_ESCALATION_FALLBACK,
   DEFAULT_ESCALATION_TIMEOUT_MS,
@@ -50,38 +54,15 @@ import {
   startAntigravityWorkerRun,
   startClaudeCodeWorkerRun,
   validateRehydratedWorkerRuntime
-} from "../chunk-CEYBNUGC.js";
+} from "../chunk-A3WNZD3P.js";
 import "../chunk-5FR74PWO.js";
+import "../chunk-P43ETTHK.js";
+import "../chunk-H7IXIC72.js";
 import {
   createSafetyPolicyEngine
-} from "../chunk-OBMAI2DP.js";
-import "../chunk-5C77SEEY.js";
-import "../chunk-UND3GU2L.js";
-import {
-  UNKNOWN_RESOURCE,
-  WORKER_PROTOCOL_VERSION,
-  WORKER_RESOURCE_LABEL_MAX,
-  WORKER_STDIN_FRAME_MAX_BYTES,
-  canonicalJson,
-  encodeControlFrame,
-  endpointIdentityHash,
-  knownResource,
-  parseAgentLedgerBody,
-  parseAgentLedgerEntry,
-  toolSignatureOf,
-  withinFrameBudget,
-  workerSpecDigest
-} from "../chunk-CMZWFGD2.js";
-import {
-  deleteInjectedCompileCacheFrom
-} from "../chunk-I4HZDVNP.js";
-import "../chunk-ZI647VB5.js";
-import "../chunk-JNXPYBB4.js";
-import "../chunk-GH5622CP.js";
-import "../chunk-XN3L4EYL.js";
-import "../chunk-VG7TBQIY.js";
+} from "../chunk-5H3GB5BO.js";
+import "../chunk-A2NJGIB3.js";
 import "../chunk-OQE5J4C6.js";
-import "../chunk-SPULKLCF.js";
 import {
   agentSkillToolPolicy
 } from "../chunk-GOXNB3AO.js";
@@ -90,10 +71,10 @@ import {
 } from "../chunk-HWUFFB6L.js";
 import {
   RESULT_CONTRACT_REPAIR_LIMIT,
-  parseResultContract,
+  parseWorkerResultContract,
   resultContractRepairMessages,
   validateResultContract
-} from "../chunk-DJNLUABN.js";
+} from "../chunk-TTHACPOM.js";
 import {
   classify
 } from "../chunk-AOCYTWAV.js";
@@ -105,6 +86,25 @@ import "../chunk-ODFEOB4F.js";
 import "../chunk-OZNBF4L3.js";
 import "../chunk-4BJ5BYCE.js";
 import "../chunk-ECH6PKUQ.js";
+import {
+  UNKNOWN_RESOURCE,
+  WORKER_PROTOCOL_VERSION,
+  WORKER_RESOURCE_LABEL_MAX,
+  WORKER_STDIN_FRAME_MAX_BYTES,
+  canonicalJson,
+  encodeControlFrame,
+  endpointIdentityHash,
+  knownResource,
+  parseAgentLedgerBody,
+  parseAgentLedgerEntry,
+  toolSignatureOf,
+  withinFrameBudget,
+  workerSpecDigest
+} from "../chunk-CMZWFGD2.js";
+import {
+  deleteInjectedCompileCacheFrom
+} from "../chunk-I4HZDVNP.js";
+import "../chunk-ZI647VB5.js";
 import "../chunk-6XLNIQDB.js";
 import "../chunk-5B2AEOW5.js";
 import {
@@ -114,56 +114,63 @@ import "../chunk-65DEGPJ6.js";
 import {
   FileKnowledgeBase,
   applyModelCapabilityPatch,
-  getRuntimeRegistry,
   loadPluginRuntimes,
-  registerBuiltinRuntimes,
   registerClioApiProviders,
   resolveModelRuntimeCapabilitiesForModel,
   resolveProviderKnowledgeBaseRoots,
   setGlobalDefaultMaxOutputTokens,
   setProtectedModelsProvider,
   setResidencyNoticeSink
-} from "../chunk-VQNODYQ4.js";
+} from "../chunk-7RFXX52T.js";
 import "../chunk-CFGTUFWB.js";
-import "../chunk-JRIO5UD2.js";
+import "../chunk-LU7P4LHA.js";
+import "../chunk-RWSI4YD7.js";
 import "../chunk-IHXBNWMM.js";
-import "../chunk-GEYXPTRF.js";
+import {
+  setGitCommitAttributionEnabled,
+  withManagedGitCommitAttributionEnvironment
+} from "../chunk-B5CSFE7B.js";
 import {
   readSettings,
   validateSettingsFile
-} from "../chunk-UHXRNZ2J.js";
-import "../chunk-4DGYLA73.js";
-import "../chunk-LL4KHSZI.js";
-import "../chunk-SST6Z5JA.js";
-import "../chunk-FO5ZOVUY.js";
+} from "../chunk-IJ7RPIYJ.js";
+import "../chunk-FQ4SKYE4.js";
+import "../chunk-ZGVHUX3M.js";
+import "../chunk-TT36MB5S.js";
+import "../chunk-3BINW3FP.js";
 import "../chunk-R346GLFC.js";
 import {
-  setGitCommitAttributionEnabled,
-  withManagedGitCommitAttributionEnvironment
-} from "../chunk-D4MDIG46.js";
-import "../chunk-FQ4SKYE4.js";
+  AI_AGENT_NAME
+} from "../chunk-6EJMN2Y3.js";
+import {
+  readClioVersion
+} from "../chunk-IWHMRKLL.js";
+import {
+  registerBuiltinRuntimes
+} from "../chunk-NMPKI6XL.js";
+import "../chunk-4DGYLA73.js";
+import "../chunk-LL4KHSZI.js";
 import {
   configureGuardrails,
   isWorkerToolCallCapExceededReason,
   isWorkerToolCallCapSynthesisReason
 } from "../chunk-4ZG3XFUR.js";
+import "../chunk-IIZWH4XA.js";
+import "../chunk-EQ63NRB7.js";
+import "../chunk-SST6Z5JA.js";
 import "../chunk-IKCO5N3L.js";
 import "../chunk-3I7MS7N2.js";
-import {
-  registerFauxFromEnv
-} from "../chunk-FCSXB6T2.js";
 import "../chunk-APJ265NV.js";
-import "../chunk-YXLYO42X.js";
 import "../chunk-BNAZZHFG.js";
-import {
-  AI_AGENT_NAME
-} from "../chunk-6EJMN2Y3.js";
 import "../chunk-WEPFGWHJ.js";
-import "../chunk-ZGVHUX3M.js";
-import "../chunk-OB5HIGJY.js";
 import {
-  readClioVersion
-} from "../chunk-IWHMRKLL.js";
+  getRuntimeRegistry
+} from "../chunk-NUGM5KR6.js";
+import "../chunk-PT7HYKEM.js";
+import {
+  registerFauxFromEnv
+} from "../chunk-FCSXB6T2.js";
+import "../chunk-YXLYO42X.js";
 import {
   init_esm_shims
 } from "../chunk-3R73A4XB.js";
@@ -943,7 +950,7 @@ function resolveWorkerRuntimeBudget(input) {
 }
 function startWorkerRun(input, emit) {
   assertResponseSchemaRuntime(input);
-  if (input.resultContract !== void 0) parseResultContract(input.resultContract, "WorkerSpec.resultContract");
+  if (input.resultContract !== void 0) parseWorkerResultContract(input.resultContract, "WorkerSpec.resultContract");
   if (input.runtime.id === "claude-sdk") {
     return startClaudeSdkWorkerRun(input, emit);
   }

package/docs/alcf-provider.md

@@ -1,7 +1,7 @@
 # ALCF Inference Provider
 
 > [!TIP]
-> **Interactive Spec Available:** An interactive target configurator and Globus OAuth flow diagram is located at [docs/html/alcf_blueprint.html](html/alcf_blueprint.html) (Version: 0.3.7).
+> **Interactive Spec Available:** An interactive target configurator and Globus OAuth flow diagram is located at [docs/html/alcf_blueprint.html](html/alcf_blueprint.html) (Version: 0.3.8).
 
 Clio can use Argonne's ALCF inference gateway as an OpenAI-compatible target
 backed by Globus OAuth. The runtime id is `alcf`; each configured target points

package/docs/architecture.md

@@ -1,7 +1,7 @@
 # Clio Coder Architecture and Boundaries
 
 > [!TIP]
-> **Interactive Spec Available:** An interactive dashboard is located at [docs/html/architecture_blueprint.html](html/architecture_blueprint.html) (Version: 0.3.7).
+> **Interactive Spec Available:** An interactive dashboard is located at [docs/html/architecture_blueprint.html](html/architecture_blueprint.html) (Version: 0.3.8).
 
 Clio Coder is an experimental, terminal-first coding harness for the CLIO ecosystem. CLIO stands for Context Layer for Input/Output; the project is named for the Greek muse of history and developed by the Gnosis Research Center at Illinois Tech. Its architecture favors small, auditable subsystems over a single monolithic agent loop: CLI entry points, the interactive TUI, provider/runtime code, worker subprocesses, tools, and feature domains are kept separate so local-model support and scientific-software workflows can evolve without collapsing safety boundaries.
 

package/docs/artifact-versions.md

@@ -1,6 +1,6 @@
 # Artifact Versions & Serialization Contracts
 
-This document is the canonical registry of all versioned file formats, serialized data structures, integrity digests, and migration rules across Clio Coder in `v0.3.7`.
+This document is the canonical registry of all versioned file formats, serialized data structures, integrity digests, and migration rules across Clio Coder in `v0.3.8`.
 
 ---
 
@@ -10,7 +10,7 @@ Clio Coder strictly versions every persistent or network-transported data struct
 
 | Artifact / Subsystem | Current Version | Symbol / Type & Source Location | Persisted Path / Wire Location | Schema Semantics & Version Differences | Mismatch Handling |
 | :--- | :--- | :--- | :--- | :--- | :--- |
-| **Run Receipt** | `19` | `RUN_RECEIPT_INTEGRITY_VERSION = 19`<br>`src/domains/dispatch/receipt-integrity.ts:13` | `<stateDir>/receipts/<runId>.json` | Cryptographically sealed run record. Version 19 covers all base provenance fields, routing intent, quality labels, `validationGrounding`, `capabilityMismatch`, council provenance, and fleet gate provenance. | Fail-closed. Incompatible receipts fail verification and are never read as evidence. |
+| **Run Receipt** | `20` | `RUN_RECEIPT_INTEGRITY_VERSION = 20`<br>`src/domains/dispatch/receipt-integrity.ts:13` | `<stateDir>/receipts/<runId>.json` | Cryptographically sealed run record. Version 20 adds `pathProvenance` on dispatch intent and the resolved `pathScope`, over the v19 base of provenance fields, routing intent, quality labels, `validationGrounding`, `capabilityMismatch`, council provenance, and fleet gate provenance. | Fail-closed. A receipt below v20 is reported as retired rather than invalid, is never read as evidence, and is never migrated; a malformed or tampered v20 receipt fails verification. |
 | **Session Ledger** | `3` | `CURRENT_SESSION_FORMAT_VERSION = 3`<br>`src/engine/session.ts:66` | `<stateDir>/sessions/<cwdHash>/<sessionId>/` (`meta.json`, `current.jsonl`, `tree.json`) | Append-only ledger format with UUIDv7 turn IDs, session header line, and tree graph linkage. | Automated migration via `src/domains/session/migrations/` on `/resume`. Earlier unmigratable versions rejected. |
 | **Worker Spec** | `3` | `WORKER_SPEC_VERSION = 3`<br>`src/worker/spec-contract.ts:22` | Subprocess `stdin` control plane JSON payload | Worker invocation parameters, tool surface profile, and execution bounds. | Fail-closed preflight rejection before worker activation. |
 | **Worker Runtime Descriptor** | `2` | `WORKER_RUNTIME_DESCRIPTOR_VERSION = 2`<br>`src/worker/spec-contract.ts:23` | Worker attestation descriptor payload | Attestation descriptor for worker runtime environment and hardware facts. | Attestation mismatch causes immediate process termination. |
@@ -22,6 +22,7 @@ Clio Coder strictly versions every persistent or network-transported data struct
 | **Capacity State File** | `2` | `version: 2` in `interface CapacityStateFile`<br>`src/domains/dispatch/capacity-lease.ts:40` | `<stateDir>/dispatch-admission.json` | Active capacity leases, drain status, and cross-process lock state. | Corrupted or unparseable state file causes admission to fail closed. |
 | **Protected Artifact Journal** | `1` | `version: 1` in `interface PendingProtectedArtifactRecord`<br>`src/domains/session/protected-artifact-journal.ts:22` | `<stateDir>/protected-artifact-pending/<key>/<id>.json` | Write-ahead durability records for pending protected artifacts. | Leftover records reconciled during session initialization. |
 | **Fleet Run Record** | `1` | `version: 1` in `interface FleetRunRecord`<br>`src/domains/dispatch/fleet-run.ts` | `<stateDir>/fleet-runs/<runId>.json` | Durable record of one fleet run: contract name, plan hash, static step ids and steps, `--var` values, replayed and settled step results, and the delegation plan hash a `kind: plan` step produced. Read by `fleet run --resume`. | Resume refuses a changed plan hash with a per-step diff and refuses differing `--var` values. |
+| **Durable Assignment Store** | `1` | `version: 1` in `interface AssignmentStoreFile`<br>`DurableAssignmentRecord`<br>`src/domains/dispatch/assignment-store.ts` | `<stateDir>/assignments.json` | Machine-wide logical-dispatch records: assignment id, attempt ids, terminal run id, status, optional fleet verdict owner, and—while running—`processOwner {pid, processBirthToken, acquiredAt}`. The owner is cleared on a true terminal transition. | A live sibling owner keeps the row running; a genuinely dead or legacy ownerless row is reconciled. An unsupported or unreadable store is treated as empty, and malformed records are ignored. |
 | **Checkout Writer Lease** | `1` | `version: 1` in `interface CheckoutWriterLeaseRecord`<br>`src/domains/dispatch/checkout-writer-lease.ts` | `<stateDir>/checkout-writer-leases/<key>.json` (key derived from the canonical checkout path) | Cross-process single-writer lease: checkout path, pid, process birth token, acquisition time. | A live sibling holder is refused with `checkout_writer_lease_held`; a dead owner is reclaimed; a malformed record is treated as absent. |
 | **Out-of-turn Usage Ledger** | unversioned JSONL | `OutOfTurnUsageRow`<br>`src/domains/observability/out-of-turn-usage.ts` | `<stateDir>/usage/out-of-turn.jsonl` | One row per priced `/btw` or `/handoff` call: label, session id, repo identity, timestamp, target, attributed model, provider usage. Bounded ring of `MAX_OUT_OF_TURN_USAGE_ROWS = 1000`, rewritten atomically under the state-file lock. | Unparseable rows are skipped and counted by `usage report`; the session ledger is never affected. |
 | **Library Pins** | unversioned YAML map | `readLibraryPins`<br>`src/domains/resources/library.ts` | `<configDir>/library-pins.yaml` | Typed ref (`skill:x`, `agent:y`, `prompt:p`, `fleet:z`) to `{sha256, sourceUrl}` for every resource `library add` or the Skills Hub installed. | A non-map document reads as empty; an entry whose installed file is missing is reported as available, not installed. |
@@ -30,7 +31,7 @@ Clio Coder strictly versions every persistent or network-transported data struct
 
 ## 2. Integrity Verification Contracts
 
-### Receipt Integrity (Version 19)
+### Receipt Integrity (Version 20)
 
 Receipt integrity authenticates that a sealed receipt matches its ledger envelope without modification. Verification reproduces the canonical JSON serialization and computes the SHA-256 digest:
 
@@ -42,9 +43,9 @@ export function computeReceiptDigest(receipt: RunReceiptV15): string {
 ```
 
 Receipt verification checks:
-1. `integrity.version === 19`.
+1. `integrity.version === 20`. A receipt sealed at a lower version is reported as retired rather than invalid: it is intact, but is not read as evidence and is never migrated.
 2. Calculated SHA-256 matches `integrity.digest`.
-3. All optional fields present in the schema (`validationGrounding`, `capabilityMismatch`, `steering`, `gate`, `fleetGate`, `council`, `plan`, `briefing`) conform to the strict v19 specification.
+3. All optional fields present in the schema (`validationGrounding`, `capabilityMismatch`, `steering`, `gate`, `fleetGate`, `council`, `plan`, `briefing`) conform to the strict v20 specification.
 
 ---
 

package/docs/built-in-agents.md

@@ -3,7 +3,7 @@
 Clio Coder dispatches focused fleet agents from Markdown recipes. Recipes are data files, not hidden code plugins: YAML frontmatter declares identity, mode, tools, optional target/model hints, and thinking level; the Markdown body is the agent instruction text.
 
 > [!TIP]
-> **Interactive Spec Available:** An interactive dashboard for the agent registry and dispatch admission check gates is located at [docs/html/agents_blueprint.html](html/agents_blueprint.html) (Version: 0.3.7).
+> **Interactive Spec Available:** An interactive dashboard for the agent registry and dispatch admission check gates is located at [docs/html/agents_blueprint.html](html/agents_blueprint.html) (Version: 0.3.8).
 
 The source of truth is `src/domains/agents/**`. Clio's agent dispatch engine and execution boundaries are built upon the [@earendil-works/pi-agent-core](https://www.npmjs.com/package/@earendil-works/pi-agent-core) library.
 

package/docs/commands-and-modes.md

@@ -1,7 +1,7 @@
 # Commands and Modes
 
 > [!TIP]
-> **Interactive Spec Available:** An interactive dashboard is located at [docs/html/commands_blueprint.html](html/commands_blueprint.html) (Version: 0.3.7).
+> **Interactive Spec Available:** An interactive dashboard is located at [docs/html/commands_blueprint.html](html/commands_blueprint.html) (Version: 0.3.8).
 
 
 Clio Coder is a terminal-first alpha harness. This page keeps the command
@@ -131,7 +131,7 @@ Example:
 clio-coder run \
   "Find the test command and summarize the project structure." \
   --target local-lmstudio \
-  --model your-model-id
+  --model qwen3.8-27b
 ```
 
 ## Interactive Slash Commands

package/docs/configuration-and-targets.md

@@ -1,7 +1,7 @@
 # Configuration, Targets, Runtimes, and Auth
 
 > [!TIP]
-> **Interactive Spec Available:** An interactive configuration validator, target resolver, and CLI command generator is located at [docs/html/configuration_blueprint.html](html/configuration_blueprint.html) (Version: 0.3.7).
+> **Interactive Spec Available:** An interactive configuration validator, target resolver, and CLI command generator is located at [docs/html/configuration_blueprint.html](html/configuration_blueprint.html) (Version: 0.3.8).
 
 Clio Coder is target-first: chat and fleet dispatch resolve through configured targets in `settings.yaml`, not through provider-specific ad hoc flags. Chat and print targets are HTTP and native engine-backed runtimes. Fleet dispatch can also target the sanctioned Claude Code subscription runtimes described below.
 
@@ -82,11 +82,16 @@ clio-coder configure \
   --id local-lmstudio \
   --runtime lmstudio \
   --url http://127.0.0.1:1234 \
-  --model your-model-id \
+  --model qwen3.8-27b \
   --set-orchestrator \
   --set-fleet-default
 ```
 
+`--model` must be an id the server advertises. `configure` fetches the
+server's model list and refuses an id that is not on it, printing the ids it
+found and which of them are loaded; `--force` saves the target anyway. Replace
+`qwen3.8-27b` with an id from `lms ls` (LM Studio) or your server's model list.
+
 Use the id you chose, probe it, then launch the TUI:
 
 ```bash
@@ -768,7 +773,7 @@ clio-coder configure \
   --id local-llamacpp \
   --runtime llamacpp \
   --url http://127.0.0.1:8080 \
-  --model your-model-id \
+  --model qwen3.8-27b \
   --set-orchestrator \
   --set-fleet-default
 ```

package/docs/context-engine.md

@@ -1,7 +1,7 @@
 # Context Engine
 
 > [!TIP]
-> **Interactive Spec Available:** An interactive dashboard is located at [docs/html/context_blueprint.html](html/context_blueprint.html) (Version: 0.3.7).
+> **Interactive Spec Available:** An interactive dashboard is located at [docs/html/context_blueprint.html](html/context_blueprint.html) (Version: 0.3.8).
 
 Clio Coder tracks context pressure, records per-turn snapshots, and protects the provider context with bounded tool results plus single-threshold compaction.
 

package/docs/documentation-guide.md

@@ -1,7 +1,7 @@
 # Documentation Standards and Codebase Alignment
 
 > [!TIP]
-> **Interactive Spec Available:** An interactive documentation link linter, phrasing/claim evaluator, and alignment portal is located at [docs/html/documentation_blueprint.html](html/documentation_blueprint.html) (Version: 0.3.7).
+> **Interactive Spec Available:** An interactive documentation link linter, phrasing/claim evaluator, and alignment portal is located at [docs/html/documentation_blueprint.html](html/documentation_blueprint.html) (Version: 0.3.8).
 
 Clio Coder is an experimental community alpha. Documentation should help contributors and early users work from the source of truth without overstating maturity. When docs drift, prefer the current source and tests over older prose or aspirational roadmap notes.
 

package/docs/eval-runner.md

@@ -1,7 +1,7 @@
 # Clio Coder Local Evaluation Runner
 
 > [!TIP]
-> **Interactive Spec Available:** An interactive task suite validator, subprocess execution simulator, and compare calculator is located at [docs/html/eval_blueprint.html](html/eval_blueprint.html) (Version: 0.3.7).
+> **Interactive Spec Available:** An interactive task suite validator, subprocess execution simulator, and compare calculator is located at [docs/html/eval_blueprint.html](html/eval_blueprint.html) (Version: 0.3.8).
 
 The local evaluation runner executes repository-local YAML task suites as deterministic subprocess checks. It is useful for comparing harness changes, prompts, tools, or local workflows.
 

package/docs/evals-internal.md

@@ -1,7 +1,7 @@
 # Internal Eval Suites
 
 > [!TIP]
-> **Interactive Spec Available:** An interactive blueprint is available at [docs/html/evals_internal_blueprint.html](html/evals_internal_blueprint.html) (Version: 0.3.7).
+> **Interactive Spec Available:** An interactive blueprint is available at [docs/html/evals_internal_blueprint.html](html/evals_internal_blueprint.html) (Version: 0.3.8).
 
 Private suites should live outside this repository. Keep datasets, prompts,
 live fleet coordinates, calibration outputs, and raw run artifacts in a private