@iowarp/clio-coder 0.3.3 → 0.3.4

package/dist/verify-X5HDROLA.js

@@ -0,0 +1,25 @@
+import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
+import {
+  verifyTool
+} from "./chunk-PCZJO5TI.js";
+import "./chunk-NILBFAPG.js";
+import "./chunk-FYYLNIL5.js";
+import "./chunk-UL3WSD3F.js";
+import "./chunk-VG7TBQIY.js";
+import "./chunk-OQE5J4C6.js";
+import "./chunk-ECH6PKUQ.js";
+import "./chunk-6XLNIQDB.js";
+import "./chunk-5B2AEOW5.js";
+import "./chunk-CGKSTWHD.js";
+import "./chunk-VEZEGCGW.js";
+import "./chunk-FQ4SKYE4.js";
+import "./chunk-FCSXB6T2.js";
+import "./chunk-APJ265NV.js";
+import "./chunk-YXLYO42X.js";
+import "./chunk-BNAZZHFG.js";
+import "./chunk-6EJMN2Y3.js";
+import "./chunk-3R73A4XB.js";
+export {
+  verifyTool
+};
+//# sourceMappingURL=verify-X5HDROLA.js.map

package/dist/{wiki-generate-UEXP2ARI.js → wiki-generate-7STOCIFZ.js}

@@ -5,36 +5,37 @@ import {
 import {
   SchedulingDomainModule,
   createPromptsDomainModule
-} from "./chunk-LM5TQCJZ.js";
+} from "./chunk-3HZ5RWN2.js";
 import {
   AgentsDomainModule,
   SafetyDomainModule
-} from "./chunk-PAJK6MAQ.js";
+} from "./chunk-X6COSD2O.js";
 import {
   ConfigDomainModule,
   loadDomains
-} from "./chunk-OC7FIQPC.js";
+} from "./chunk-KRPY7NTG.js";
 import {
   createObservabilityDomainModule
-} from "./chunk-4XUGQOHA.js";
+} from "./chunk-35MKKU5R.js";
 import "./chunk-HC4CLZ2Y.js";
 import "./chunk-HFSBBKSQ.js";
-import "./chunk-CBCAPZAA.js";
+import "./chunk-E25LMLRW.js";
 import {
   ContextDomainModule,
   buildWikiPagePrompt,
   buildWikiPlanPrompt
-} from "./chunk-PIWWS5BL.js";
+} from "./chunk-UZHIZC5S.js";
 import "./chunk-5WIGXA4T.js";
-import "./chunk-V6RTAOC2.js";
+import "./chunk-BRXQQJFP.js";
+import {
+  DispatchDomainModule
+} from "./chunk-QQL5RT5M.js";
 import {
-  DispatchDomainModule,
   SessionDomainModule
-} from "./chunk-SRDMMSEP.js";
-import "./chunk-4BJ5BYCE.js";
+} from "./chunk-QQK64KLB.js";
 import "./chunk-QKMUKYO7.js";
-import "./chunk-AGYYIBLL.js";
-import "./chunk-OOJYHWRB.js";
+import "./chunk-3JLKSKD7.js";
+import "./chunk-34475P3I.js";
 import "./chunk-TXOTCRLG.js";
 import "./chunk-G4BMMOKF.js";
 import {
@@ -50,24 +51,30 @@ import {
 import "./chunk-4BPJXDWC.js";
 import "./chunk-2SFS6XQE.js";
 import "./chunk-ZWLZP4ZT.js";
+import "./chunk-W6GROXXM.js";
 import {
   MiddlewareDomainModule
-} from "./chunk-2DJ2KNFG.js";
+} from "./chunk-2LZI5CAG.js";
 import "./chunk-IR4CFBFN.js";
 import "./chunk-UOV2BYIW.js";
-import "./chunk-OAO4GE4M.js";
-import "./chunk-LWLEKMDQ.js";
-import "./chunk-STBPMHSX.js";
-import "./chunk-GGXXDWE4.js";
-import "./chunk-5UUP6MWO.js";
+import "./chunk-2TZWSW76.js";
+import "./chunk-ZYKPLLNQ.js";
+import "./chunk-WPQLXFOZ.js";
+import "./chunk-7RXG6QRZ.js";
+import "./chunk-22NAGB7X.js";
+import "./chunk-AOCYTWAV.js";
+import "./chunk-MV3K5QF2.js";
 import "./chunk-CMZWFGD2.js";
 import "./chunk-I4HZDVNP.js";
-import "./chunk-7MNJORFF.js";
+import "./chunk-FYYLNIL5.js";
+import "./chunk-UL3WSD3F.js";
 import "./chunk-VG7TBQIY.js";
 import "./chunk-OQE5J4C6.js";
 import "./chunk-ECH6PKUQ.js";
-import "./chunk-T6YILFSB.js";
-import "./chunk-VAKQQHWR.js";
+import "./chunk-BEY543CS.js";
+import "./chunk-5M54SPOL.js";
+import "./chunk-OZNBF4L3.js";
+import "./chunk-4BJ5BYCE.js";
 import "./chunk-6XLNIQDB.js";
 import "./chunk-5B2AEOW5.js";
 import {
@@ -81,27 +88,31 @@ import "./chunk-EKMEHE4H.js";
 import {
   ProvidersDomainModule,
   canonicalizeWireModelId
-} from "./chunk-LZSJBIVT.js";
-import "./chunk-A3CYT5EX.js";
-import "./chunk-ZDOOVTXZ.js";
+} from "./chunk-QWU7ZBO7.js";
+import "./chunk-CFGTUFWB.js";
+import "./chunk-AD2SYQYC.js";
+import "./chunk-4OC57DA6.js";
+import "./chunk-LL4KHSZI.js";
 import "./chunk-4VP4KH3K.js";
-import "./chunk-M6SHUN7Q.js";
-import "./chunk-R346GLFC.js";
-import "./chunk-COU2UHX6.js";
+import "./chunk-VEZEGCGW.js";
 import "./chunk-FQ4SKYE4.js";
 import "./chunk-IKCO5N3L.js";
 import "./chunk-3I7MS7N2.js";
 import "./chunk-IHXBNWMM.js";
+import "./chunk-BPGS2WCQ.js";
 import "./chunk-SST6Z5JA.js";
+import "./chunk-FO5ZOVUY.js";
+import "./chunk-R346GLFC.js";
 import "./chunk-4ZG3XFUR.js";
-import "./chunk-APJ265NV.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-TZTZS7QK.js";
-import "./chunk-OQ33BKR3.js";
+import "./chunk-HXG4IURW.js";
+import "./chunk-ZGVHUX3M.js";
+import "./chunk-TTNYS3EA.js";
 import "./chunk-JVCV3ICN.js";
 import "./chunk-7CR24IG7.js";
 import "./chunk-IWHMRKLL.js";
@@ -424,4 +435,4 @@ export {
   resolveDocumenterModelId,
   runWikiDispatch
 };
-//# sourceMappingURL=wiki-generate-UEXP2ARI.js.map
+//# sourceMappingURL=wiki-generate-7STOCIFZ.js.map

package/dist/worker/entry.js

@@ -17,13 +17,13 @@ import {
   resolveDeliveryTools,
   sanitizeLockedSynthesisMessage,
   workerLoopBlockBudget
-} from "../chunk-LW6DSM3M.js";
-import "../chunk-J7CWMCQD.js";
+} from "../chunk-VMNQ6OZA.js";
+import "../chunk-K7VKOLQQ.js";
 import {
   createMiddlewareContractFromSnapshot,
   createMiddlewareToolChoiceControl,
   shouldRequestStalledTurnContinuation
-} from "../chunk-2DJ2KNFG.js";
+} from "../chunk-2LZI5CAG.js";
 import {
   CONFIRMED_SCOPE,
   READONLY_SCOPE,
@@ -34,8 +34,8 @@ import {
   createLoopState,
   observe
 } from "../chunk-UOV2BYIW.js";
-import "../chunk-DUYJ5IO6.js";
-import "../chunk-OAO4GE4M.js";
+import "../chunk-EDRHSCIE.js";
+import "../chunk-2TZWSW76.js";
 import {
   DEFAULT_ESCALATION_FALLBACK,
   DEFAULT_ESCALATION_TIMEOUT_MS,
@@ -50,7 +50,8 @@ import {
   startAntigravityWorkerRun,
   startClaudeCodeWorkerRun,
   validateRehydratedWorkerRuntime
-} from "../chunk-LWLEKMDQ.js";
+} from "../chunk-ZYKPLLNQ.js";
+import "../chunk-WPQLXFOZ.js";
 import {
   DEFAULT_AUTONOMY_LEVEL,
   RESULT_CONTRACT_REPAIR_LIMIT,
@@ -58,12 +59,14 @@ import {
   parseResultContract,
   resultContractRepairMessages,
   validateResultContract
-} from "../chunk-STBPMHSX.js";
-import "../chunk-GGXXDWE4.js";
+} from "../chunk-7RXG6QRZ.js";
+import "../chunk-22NAGB7X.js";
+import {
+  classify
+} from "../chunk-AOCYTWAV.js";
 import {
-  classify,
   protectedArtifactMutationBlockReason
-} from "../chunk-5UUP6MWO.js";
+} from "../chunk-MV3K5QF2.js";
 import {
   UNKNOWN_RESOURCE,
   WORKER_PROTOCOL_VERSION,
@@ -83,17 +86,20 @@ import {
   deleteInjectedCompileCacheFrom
 } from "../chunk-I4HZDVNP.js";
 import "../chunk-ZI647VB5.js";
-import "../chunk-TZK7PACC.js";
-import "../chunk-7MNJORFF.js";
+import "../chunk-NILBFAPG.js";
+import "../chunk-FYYLNIL5.js";
+import "../chunk-UL3WSD3F.js";
 import "../chunk-XN3L4EYL.js";
 import "../chunk-VG7TBQIY.js";
 import "../chunk-OQE5J4C6.js";
 import "../chunk-ECH6PKUQ.js";
-import "../chunk-OKGUZO2U.js";
+import "../chunk-SPULKLCF.js";
 import {
   agentSkillToolPolicy
-} from "../chunk-T6YILFSB.js";
-import "../chunk-VAKQQHWR.js";
+} from "../chunk-BEY543CS.js";
+import "../chunk-5M54SPOL.js";
+import "../chunk-OZNBF4L3.js";
+import "../chunk-4BJ5BYCE.js";
 import "../chunk-6XLNIQDB.js";
 import "../chunk-5B2AEOW5.js";
 import {
@@ -112,41 +118,44 @@ import {
   setGlobalDefaultMaxOutputTokens,
   setProtectedModelsProvider,
   setResidencyNoticeSink
-} from "../chunk-LZSJBIVT.js";
+} from "../chunk-QWU7ZBO7.js";
+import "../chunk-CFGTUFWB.js";
 import {
   readSettings,
   validateSettingsFile
-} from "../chunk-A3CYT5EX.js";
-import "../chunk-ZDOOVTXZ.js";
+} from "../chunk-AD2SYQYC.js";
+import "../chunk-4OC57DA6.js";
+import "../chunk-LL4KHSZI.js";
 import "../chunk-4VP4KH3K.js";
-import "../chunk-M6SHUN7Q.js";
-import "../chunk-R346GLFC.js";
-import "../chunk-VPAYEGVX.js";
 import {
   setGitCommitAttributionEnabled,
   withManagedGitCommitAttributionEnvironment
-} from "../chunk-COU2UHX6.js";
+} from "../chunk-VEZEGCGW.js";
 import "../chunk-FQ4SKYE4.js";
 import "../chunk-IKCO5N3L.js";
 import "../chunk-3I7MS7N2.js";
 import "../chunk-IHXBNWMM.js";
+import "../chunk-BPGS2WCQ.js";
 import "../chunk-SST6Z5JA.js";
+import "../chunk-FO5ZOVUY.js";
+import "../chunk-R346GLFC.js";
 import {
   configureGuardrails,
   isWorkerToolCallCapExceededReason,
   isWorkerToolCallCapSynthesisReason
 } from "../chunk-4ZG3XFUR.js";
-import "../chunk-APJ265NV.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-OQ33BKR3.js";
+import "../chunk-ZGVHUX3M.js";
+import "../chunk-TTNYS3EA.js";
 import {
   readClioVersion
 } from "../chunk-IWHMRKLL.js";

package/docs/README.md

@@ -4,7 +4,7 @@
 
 # Clio Coder Documentation
 
-These pages document `v0.3.3` of Clio Coder, an open-source coding orchestrator within the [IOWarp](https://iowarp.ai) scientific computing platform, created by the [Gnosis Research Center](https://grc.iit.edu) at the [Illinois Institute of Technology](https://www.iit.edu).
+These pages document `v0.3.4` of Clio Coder, an open-source coding orchestrator within the [IOWarp](https://iowarp.ai) scientific computing platform, created by the [Gnosis Research Center](https://grc.iit.edu) at the [Illinois Institute of Technology](https://www.iit.edu).
 
 They are source-aligned guides: when prose and source disagree, prefer the
 current source, tests, and `CHANGELOG.md`.
@@ -15,6 +15,7 @@ current source, tests, and `CHANGELOG.md`.
 | --- | --- |
 | Commands, slash commands, operating posture, keybindings, dispatch, verification, and troubleshooting | [commands-and-modes.md](commands-and-modes.md) ([Interactive Blueprint](html/commands_blueprint.html)) |
 | Context window resolution, per-model probe capabilities, token accounting, per-turn snapshots, compaction, and context priming | [context-engine.md](context-engine.md) ([Interactive Blueprint](html/context_blueprint.html)) |
+| Non-destructive working-set eviction, markers, eviction policies, recall by ref, and the `contextEviction` / `contextRecall` records | [context-working-set.md](context-working-set.md) |
 | Runtime targets, local model configuration, fleet profiles, and auth | [configuration-and-targets.md](configuration-and-targets.md) ([Interactive Blueprint](html/configuration_blueprint.html)) |
 | Every environment variable the runtime reads: guardrail overrides, directory layout, debug toggles, and internal plumbing | [environment-variables.md](environment-variables.md) ([Interactive Blueprint](html/environment_blueprint.html)) |
 | Argonne ALCF Sophia/Metis inference targets over Globus OAuth | [alcf-provider.md](alcf-provider.md) ([Interactive Blueprint](html/alcf_blueprint.html)) |
@@ -43,12 +44,12 @@ current source, tests, and `CHANGELOG.md`.
 | Multi-node fleet dispatch: process-safe admission, attested workers, measured routing, activation, agent automation, topologies, and receipts | [fleet-dispatch.md](fleet-dispatch.md) ([Interactive Blueprint](html/fleet_dispatch_blueprint.html)) |
 | Multi-process capacity leases, heartbeat TTLs, cross-process locks, and cluster drain controls | [capacity-and-scheduling.md](capacity-and-scheduling.md) ([Interactive Blueprint](html/capacity_scheduling_blueprint.html)) |
 | Executable multi-node demo with reviewer gate and receipt provenance walkthrough | [fleet-demo-runbook.md](fleet-demo-runbook.md) |
-| Session lifecycle, on-disk ledger format v3, `/tree` active-path lineage, `/fork`, `/resume`, checkpoints, and recovery | [session-lifecycle.md](session-lifecycle.md) ([Interactive Blueprint](html/session_lifecycle_blueprint.html)) |
+| Session lifecycle, on-disk ledger format v4, `/tree` active-path lineage, `/fork`, `/resume`, checkpoints, and recovery | [session-lifecycle.md](session-lifecycle.md) ([Interactive Blueprint](html/session_lifecycle_blueprint.html)) |
 | Agent Client Protocol (ACP) server over stdio, tool mediation, non-stall permissions, and error taxonomy | [acp.md](acp.md) ([Interactive Blueprint](html/acp_blueprint.html)) |
 | Version registry and migration policies for all 9 serialized artifact schemas | [artifact-versions.md](artifact-versions.md) ([Interactive Blueprint](html/artifact_versions_blueprint.html)) |
 | Process exit code taxonomy, `--help` standard, machine-readable JSON streaming, and headless output contracts | [exit-codes-and-output.md](exit-codes-and-output.md) ([Interactive Blueprint](html/exit_codes_blueprint.html)) |
 | Actionable error remediation and diagnostics keyed by exact user-facing messages | [troubleshooting.md](troubleshooting.md) ([Interactive Blueprint](html/troubleshooting_blueprint.html)) |
-| Canonical definitions of 40 core architectural concepts mapped to `src/` types | [glossary.md](glossary.md) ([Interactive Blueprint](html/glossary_blueprint.html)) |
+| Canonical definitions of 45 core architectural concepts mapped to `src/` types | [glossary.md](glossary.md) ([Interactive Blueprint](html/glossary_blueprint.html)) |
 | Complete source-to-documentation mapping matrix and subsystem coverage status | [documentation-coverage.md](documentation-coverage.md) |
 | Issue-driven development lifecycle: file-ticket through release, label taxonomy, and dogfooding setup | [development-pipeline.md](development-pipeline.md) |
 | Proactive task memory architecture, session task bank, intervention rules, and handoff carrying | [proactive-memory.md](proactive-memory.md) ([Interactive Blueprint](html/memory_blueprint.html)) |
@@ -82,12 +83,12 @@ under `src/`, run `npm run build` again or keep `npm run dev` running.
 ## Release Notes
 
 The release entry point is [../README.md](../README.md); detailed release
-history lives in [../CHANGELOG.md](../CHANGELOG.md). For v0.3.3 the supported
+history lives in [../CHANGELOG.md](../CHANGELOG.md). For v0.3.4 the supported
 install paths are `npm install -g @iowarp/clio-coder` and a source checkout
 through `npm run install:local`, the deterministic release gate is
 `npm run ci:release`, and live model smoke validation is local/manual and
-opt-in through `npm run test:live` (add `-- --delegation` for
-opencode/copilot checks).
+opt-in through `npm run live:smoke -- --target <id>` (add `--delegation`
+for opencode/copilot checks).
 
 ## Writing Documentation
 

package/docs/acp.md

@@ -1,6 +1,6 @@
 # Agent Client Protocol (ACP) Server
 
-This document defines the architecture, transport protocols, tool mediation layers, permission handling, and error taxonomy for Clio Coder's Agent Client Protocol (ACP) server implementation in `v0.3.3`.
+This document defines the architecture, transport protocols, tool mediation layers, permission handling, and error taxonomy for Clio Coder's Agent Client Protocol (ACP) server implementation in `v0.3.4`.
 
 Source implementations: `src/engine/acp/` and `src/cli/acp.ts`.
 

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.3).
+> **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.4).
 
 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,11 +1,11 @@
 # 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.3).
+> **Interactive Spec Available:** An interactive dashboard is located at [docs/html/architecture_blueprint.html](html/architecture_blueprint.html) (Version: 0.3.4).
 
 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.
 
-This page is source-code aligned for the current `v0.3.3` development line.
+This page is source-code aligned for the current `v0.3.4` development line.
 
 ---
 

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.3`.
+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.4`.
 
 ---
 

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.3).
+> **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.4).
 
 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/capacity-and-scheduling.md

@@ -1,6 +1,6 @@
 # Capacity Leases & Fleet Scheduling
 
-This document specifies the multi-process capacity leasing protocols, node scheduling models, cross-process transaction locks, and failure recovery mechanics implemented in Clio Coder `v0.3.3`.
+This document specifies the multi-process capacity leasing protocols, node scheduling models, cross-process transaction locks, and failure recovery mechanics implemented in Clio Coder `v0.3.4`.
 
 Source implementations: `src/domains/scheduling/` and `src/domains/dispatch/capacity-lease.ts`.
 

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.3).
+> **Interactive Spec Available:** An interactive dashboard is located at [docs/html/commands_blueprint.html](html/commands_blueprint.html) (Version: 0.3.4).
 
 
 Clio Coder is a terminal-first alpha harness. This page keeps the command
@@ -78,6 +78,8 @@ For process exit codes, stdout deliverable guarantees, and machine-readable JSON
 | `clio-coder context wiki [--update] [--status] [--depth auto\|simple\|medium\|detailed] [--target <id>] [--model <id>] [--thinking off\|low\|medium\|high]` | Generate, update, or inspect the agent-authored Markdown wiki under `.clio-coder/wiki/`. |
 | `clio-coder context reset [--all] [--yes]` | Clear accumulated project context artifacts; `--all` also removes `CLIO-CODER.md`. `--yes` (or `-y`) answers every confirmation and is required when stdin is not a terminal. |
 | `clio-coder context index [--json]` | Build the structural codewiki index without model calls; writes `.clio-coder/codewiki.json` and `.clio-coder/state.json` and prints coverage plus a structural hash. |
+| `clio-coder context replay (--sessions <path>... \| --synthetic <ids>) [--policies <ids>] [--budgets <tokens>] [--threshold <ratio>] [--target <ratio>] [--protect-last-turns <n>] [--min-evictable-tokens <n>] [--seed <n>] [--no-filter] [--json <out>] [--md <out>]` | Replay working-set policies over Clio session ledgers or the seeded procedural corpora and report retention, precision, token savings, recall cost, cold-prefix cost, saturation, and summary headroom. |
+| `clio-coder context working-set --session <id\|path>` | Inspect one session's durable working-set fold and path-index summary without modifying the ledger. |
 
 ## Headless Run Flags
 
@@ -152,7 +154,7 @@ The registry table below lists the available interactive slash commands. On a ba
 | `/agents` | `/agents` | List Clio agents and ACP delegation agents |
 | `/targets` | `/targets` | Open Settings → Targets: health, use, connect, probe, remove |
 | `/cost` | `/cost` | Show session token and cost totals |
-| `/context` | `/context compact [instructions] \| /context init \| /context refresh \| /context reset` | Context hub: window overlay plus compact, init, refresh, and reset |
+| `/context` | `/context compact [instructions] \| /context recall <ref> \| /context init \| /context refresh \| /context reset` | Context hub: window overlay plus compact, recall, init, refresh, and reset |
 | `/fleet` | `/fleet` | Open Settings → Fleet: defaults, profiles, agent bindings, nodes |
 | `/decisions` | `/decisions` | Show settled interview decisions and operator revisions |
 | `/tasks` | `/tasks add <text> \| /tasks hand <id> \| /tasks done <id> \| /tasks drop <id>` | Show the session board or manage project operator tasks |
@@ -169,9 +171,13 @@ The registry table below lists the available interactive slash commands. On a ba
 | `/fork` | `/fork` | Fork from an assistant turn |
 | `/export` | `/export [path]` | Export a self-contained HTML transcript by default; a `.md` path writes Markdown |
 
-`/context` with no arguments opens the context-window ledger overlay. The
-subcommands own the durable project-context noun: `compact` summarizes older
-turns in the session window, `init` bootstraps or updates `CLIO-CODER.md` and the
+`/context` with no arguments opens the context-window ledger overlay, including
+the working-set section (policy, evicted items and tokens, events, recalls, churn).
+The subcommands own the durable project-context noun: `compact` summarizes older
+turns in the session window, `recall <ref>` prints an evicted tool-result body
+back into the transcript by the ref its `[evicted ...]` marker names (it never
+enters model context; the model recalls with `context(scope="recall", ref=...)`),
+`init` bootstraps or updates `CLIO-CODER.md` and the
 codewiki, `refresh` re-indexes the codewiki and refreshes `.clio-coder/state.json`
 without touching `CLIO-CODER.md`, and `reset` deletes accumulated
 context artifacts (`.clio-coder/codewiki.json`, `.clio-coder/state.json`,
@@ -459,7 +465,7 @@ to execute through the existing engine worker path, the sanctioned Claude Code w
 | --- | --- |
 | `npm run ci` | Local and GitHub PR gate: typecheck, lint, skills pin check, build, the deterministic test suite, and the trace-viewer suite. |
 | `npm run ci:release` | Maintainer release gate: `npm run ci`, then the `check-release` dist and packaging audit. |
-| `npm run test:live` | Local manual live-model smoke. Requires `CLIO_CODER_LIVE_SMOKE=1` and a configured real model target. Add `-- --delegation` for `opencode` and `copilot` ACP delegation checks. |
+| `npm run live:smoke -- --target <id>` | One real headless turn against a configured target. Add `--delegation` for the `opencode` and `copilot` ACP agents. The other operator-run drivers (`live:recon`, `live:fleet-dispatch`, `live:tui`) are listed in `benchmarks/internal/README.md`. |
 | `npm run typecheck` | Strict TypeScript pass. |
 | `npm run lint` | Biome checks plus `scripts/check-hygiene.ts`, which runs the boundary invariants, the skills pin check, and the README and docs drift rules. |
 | `npm run test` | Contract and smoke tests through the sharded runner. |
@@ -467,28 +473,21 @@ to execute through the existing engine worker path, the sanctioned Claude Code w
 | `npm run dev` | `tsup --watch`. |
 | `npm run clean` | Remove `dist/`. |
 
-Live smoke example:
+Live drivers pick their model with `--target <id>`, naming one of the targets
+`clio-coder targets` lists; `--model <wireId>` and `--thinking <level>`
+override that target's defaults for the run. The run happens in a scratch Clio
+home holding only that target, so nothing touches the operator's real state:
 
 ```bash
-CLIO_CODER_LIVE_SMOKE=1 \
-CLIO_CODER_LIVE_TARGET=openai-compat \
-CLIO_CODER_LIVE_RUNTIME=openai-compat \
-CLIO_CODER_LIVE_MODEL=your-model \
-CLIO_CODER_LIVE_BASE_URL=http://localhost:8080/v1 \
-npm run test:live
-```
-
-Delegation validation is a separate opt-in flag because it depends on local
-`opencode` and `copilot` commands:
-
-```bash
-CLIO_CODER_LIVE_SMOKE=1 npm run test:live -- --delegation
+npm run build
+npm run live:smoke -- --target local-lmstudio --model qwen3.8-27b
+npm run live:smoke -- --target anthropic --delegation
 ```
 
 Live checks cost tokens or local GPU time and are not deterministic CI. They
 are useful for OpenAI-compatible local gateways such as llama.cpp, LM Studio
 with Dynamo-backed workers, vLLM, and SGLang, plus cloud targets when
-credentials are available.
+credentials are configured.
 
 ## Environment Variables
 
@@ -519,6 +518,39 @@ structural hash. The same builder is used by `clio-coder context init`, `clio-co
 refresh`, session freshness checks, tool-demand backfill, and in-session
 incremental updates.
 
+### Working-set replay
+
+`clio-coder context replay --sessions <path>...` accepts individual session directories,
+Clio sessions roots, and ledger JSONL files; `--synthetic <ids>` adds one or more procedural
+corpora (`science-long`, `refactor`, `exploration`) generated in memory from a fixed seed, so
+the committed tables can be rebuilt byte for byte on any checkout without private transcripts.
+Clio traces remove prior eviction/recall sidecars and select the active branch. Both sources
+drive the live fold, projection, policy, and eviction planner at deterministic turn
+boundaries. The default inclusion cascade for ledgers requires at least eight turns, eight
+tool results, and one file re-read; `--no-filter` retains every otherwise-readable trace.
+Markdown goes to stdout unless `--md` names a file, while `--json` writes a stable report
+including the configuration, the corpus, git revision when available, and exact command line.
+`--protect-last-turns` and `--min-evictable-tokens` override those two working-set settings
+for the replay only; they never update saved settings. Saturated events is pooled over
+applied eviction events and reports how often a policy exhausted its usable candidates,
+which distinguishes a budget that measures policy choice from one that simply runs out of
+evictable material. Recall tokens is the token-weighted complement of precision: what a
+perfect recall would read back for evicted items the session referenced again. Cold prefix
+tokens is the projected working set after the earliest evicted position of each event, which
+is what an exact-prefix cache re-prefills on the next request. The replay also models the
+summary stage: when the projection is still over the threshold after an eviction, it applies
+the same `findCutPoint(keepRecentTokens)` cut the live path uses, appends a stand-in
+`compactionSummary`, counts it, and treats what the cut removed as lost for retention.
+Summaries (mean) is therefore the number of lossy, token-spending compactions a policy forced
+per trace. The summary-headroom mean always carries its contributing trace count because
+traces that never require summary compaction do not enter that nullable mean.
+
+`clio-coder context working-set --session <id|path>` is a read-only inspection command for
+one ledger. It prints evicted refs with reason, superseding ref, and token count; aggregate
+event, recall, and churn facts; path-observation counts by operation; and paths whose earlier
+reads were followed by writes or edits. A persisted `/tree` pin is honored when the session
+metadata is available, so the report does not resurrect an abandoned branch.
+
 The current artifact is schema v5. It records files with path, language, line
 count, role, content hash, imports, and optional summary; declaration-only
 symbols with name, kind, file id, line, and optional signature; and import edges

package/docs/config-knobs-audit.md

@@ -96,8 +96,7 @@ All default off; all enabled with `1`.
 
 | Env var(s) | Used by |
 |---|---|
-| `CLIO_CODER_LIVE_SMOKE`, `CLIO_CODER_LIVE_TARGET`, `CLIO_CODER_LIVE_RUNTIME`, `CLIO_CODER_LIVE_BASE_URL`, `CLIO_CODER_LIVE_MODEL`, `CLIO_CODER_LIVE_API_KEY`, `CLIO_CODER_LIVE_KEEP` | `scripts/live-smoke.mjs` |
-| `CLIO_CODER_MAIN_TARGET/_MODEL/_URL/_THINKING`, `CLIO_CODER_WORKER_TARGET/_MODEL/_URL/_THINKING`, `CLIO_CODER_FLEET`, `CLIO_CODER_FLEET_PROFILE`, `CLIO_CODER_PRED_MODEL`, `CLIO_CODER_LLAMACPP_KEY`, `CLIO_CODER_LMSTUDIO_KEY` | benchmark fleet config (`benchmarks/community/`) |
+| `CLIO_CODER_MAIN_TARGET/_MODEL/_URL/_RUNTIME/_THINKING`, `CLIO_CODER_WORKER_TARGET/_MODEL/_URL/_RUNTIME/_THINKING`, `CLIO_CODER_LLAMACPP_KEY`, `CLIO_CODER_LMSTUDIO_KEY` | Terminal-Bench installed agent (`benchmarks/community/terminal-bench/`), which renders its own settings.yaml inside the task container |
 | `CLIO_CODER_AUTONOMY`, `CLIO_CODER_TASK_TIMEOUT` | terminal-bench agent wrapper (writes settings.yaml / its own timeout; not a Clio knob) |
 | `CLIO_CODER_BIN`, `CLIO_CODER_ENTRY`, `CLIO_CODER_TARBALL_URL` | install/dev scripts |
 | `CLIO_CODER_NO_UPDATE_NOTIFIER` | **Dead.** Set by four benchmark harnesses, read by nothing in `src/`. Either an update notifier was removed and the setters were left behind, or the feature was never built. |

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.3).
+> **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.4).
 
 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.
 
@@ -224,6 +224,15 @@ compaction:
   excludeLastTurns: 6
   # model: provider/summary-model-id
   # systemPrompt: ~/.config/clio-coder/prompts/compaction.md
+
+context:
+  workingSet:
+    enabled: true
+    policy: structural-v1
+    target: 0.6
+    protectLastTurns: 6
+    minEvictableTokens: 200
+
 retry:
   enabled: true
   maxRetries: 3
@@ -575,6 +584,11 @@ Every one of these has an environment override for a single process; see [enviro
 | `compaction.auto` | `true` | boolean | next turn |
 | `compaction.threshold` | `0.8` | number in 0 to 1 | next turn |
 | `compaction.excludeLastTurns` | `6` | integer ≥ 1 | next turn |
+| `context.workingSet.enabled` | `true` | boolean | next turn |
+| `context.workingSet.policy` | `structural-v1` | `age-horizon` or `structural-v1` | next turn |
+| `context.workingSet.target` | `0.6` | number greater than 0 and less than 1 | next turn |
+| `context.workingSet.protectLastTurns` | `6` | integer ≥ 1 | next turn |
+| `context.workingSet.minEvictableTokens` | `200` | integer ≥ 0 | next turn |
 | `defaults.maxTokens` | `32768` | integer ≥ 0 | next turn |
 | `budget.sessionCeilingUsd` | `5` | number ≥ 0 | immediately |
 | `budget.concurrency` | `auto` | `auto` or integer ≥ 1 | next dispatch |