@iowarp/clio-coder 0.3.3 → 0.3.6

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-GUSOQ6ZP.js}

@@ -5,44 +5,46 @@ import {
 import {
   SchedulingDomainModule,
   createPromptsDomainModule
-} from "./chunk-LM5TQCJZ.js";
+} from "./chunk-XF5N4U5A.js";
 import {
   AgentsDomainModule,
   SafetyDomainModule
-} from "./chunk-PAJK6MAQ.js";
+} from "./chunk-LYF7OHWH.js";
 import {
   ConfigDomainModule,
   loadDomains
-} from "./chunk-OC7FIQPC.js";
+} from "./chunk-R46L2BIR.js";
 import {
   createObservabilityDomainModule
-} from "./chunk-4XUGQOHA.js";
+} from "./chunk-K7T3E2SR.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-CYQKWTG3.js";
+import "./chunk-LCGCVYZ4.js";
 import "./chunk-5WIGXA4T.js";
-import "./chunk-V6RTAOC2.js";
+import "./chunk-6US73PDB.js";
+import {
+  DispatchDomainModule
+} from "./chunk-QM3F2GKX.js";
 import {
-  DispatchDomainModule,
   SessionDomainModule
-} from "./chunk-SRDMMSEP.js";
-import "./chunk-4BJ5BYCE.js";
+} from "./chunk-CJUB2JJ2.js";
 import "./chunk-QKMUKYO7.js";
-import "./chunk-AGYYIBLL.js";
-import "./chunk-OOJYHWRB.js";
+import "./chunk-OH3TOQTB.js";
+import "./chunk-TSHXZTOQ.js";
 import "./chunk-TXOTCRLG.js";
-import "./chunk-G4BMMOKF.js";
+import "./chunk-HVDIIIQW.js";
 import {
   MAX_PAGE_ATTEMPTS,
   pendingPages,
   readAuthoredWikiPlan,
   writeWikiPlanFile
-} from "./chunk-X4RCMKVQ.js";
+} from "./chunk-NDINPTJ4.js";
 import "./chunk-MVVUPGPW.js";
 import {
   ResourcesDomainModule
@@ -50,58 +52,69 @@ 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-ZXF4XRKW.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-WHGPSPT5.js";
+import "./chunk-XXQNGV4M.js";
+import "./chunk-43AOLP7E.js";
+import "./chunk-EKY57CSP.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-GOXNB3AO.js";
+import "./chunk-HWUFFB6L.js";
+import "./chunk-ODFEOB4F.js";
+import "./chunk-OZNBF4L3.js";
+import "./chunk-4BJ5BYCE.js";
 import "./chunk-6XLNIQDB.js";
 import "./chunk-5B2AEOW5.js";
 import {
   ToolNames
 } from "./chunk-CGKSTWHD.js";
-import "./chunk-POHLU5DW.js";
-import "./chunk-YHZX5GEU.js";
-import "./chunk-VJWL6YS5.js";
+import "./chunk-M6L6IDJG.js";
+import "./chunk-XAKHZX5N.js";
+import "./chunk-UUVG37B4.js";
 import "./chunk-LBMZMYH2.js";
-import "./chunk-EKMEHE4H.js";
+import "./chunk-33YXPOE3.js";
 import {
   ProvidersDomainModule,
   canonicalizeWireModelId
-} from "./chunk-LZSJBIVT.js";
-import "./chunk-A3CYT5EX.js";
-import "./chunk-ZDOOVTXZ.js";
+} from "./chunk-DJVECN66.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-GEYXPTRF.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-XE2VEJHX.js";
+import "./chunk-ZGVHUX3M.js";
+import "./chunk-G7MUEIGA.js";
 import "./chunk-JVCV3ICN.js";
 import "./chunk-7CR24IG7.js";
 import "./chunk-IWHMRKLL.js";
@@ -424,4 +437,4 @@ export {
   resolveDocumenterModelId,
   runWikiDispatch
 };
-//# sourceMappingURL=wiki-generate-UEXP2ARI.js.map
+//# sourceMappingURL=wiki-generate-GUSOQ6ZP.js.map

package/dist/worker/entry.js

@@ -6,7 +6,6 @@ import {
   createLoopGuardRegistration,
   createProtectedArtifactsRegistration,
   createRegistry,
-  describeCallTarget,
   effectiveToolNames,
   isLoopGuardSynthesisBackstopReason,
   isReserveAdmittedTool,
@@ -17,13 +16,13 @@ import {
   resolveDeliveryTools,
   sanitizeLockedSynthesisMessage,
   workerLoopBlockBudget
-} from "../chunk-LW6DSM3M.js";
-import "../chunk-J7CWMCQD.js";
+} from "../chunk-ZRGEBJ4T.js";
+import "../chunk-K7VKOLQQ.js";
 import {
   createMiddlewareContractFromSnapshot,
   createMiddlewareToolChoiceControl,
   shouldRequestStalledTurnContinuation
-} from "../chunk-2DJ2KNFG.js";
+} from "../chunk-ZXF4XRKW.js";
 import {
   CONFIRMED_SCOPE,
   READONLY_SCOPE,
@@ -34,8 +33,8 @@ import {
   createLoopState,
   observe
 } from "../chunk-UOV2BYIW.js";
-import "../chunk-DUYJ5IO6.js";
-import "../chunk-OAO4GE4M.js";
+import "../chunk-EYPA3EGJ.js";
+import "../chunk-WHGPSPT5.js";
 import {
   DEFAULT_ESCALATION_FALLBACK,
   DEFAULT_ESCALATION_TIMEOUT_MS,
@@ -43,6 +42,7 @@ import {
   claudeToolsOutsideProfile,
   coerceToolInput,
   createRunEffectsRecorder,
+  describeCallTarget,
   emitClaudeToolPermissionDecision,
   isClaudeCodeSessionId,
   parseWorkerSpec,
@@ -50,20 +50,22 @@ import {
   startAntigravityWorkerRun,
   startClaudeCodeWorkerRun,
   validateRehydratedWorkerRuntime
-} from "../chunk-LWLEKMDQ.js";
+} from "../chunk-XXQNGV4M.js";
+import "../chunk-43AOLP7E.js";
 import {
-  DEFAULT_AUTONOMY_LEVEL,
   RESULT_CONTRACT_REPAIR_LIMIT,
   createSafetyPolicyEngine,
   parseResultContract,
   resultContractRepairMessages,
   validateResultContract
-} from "../chunk-STBPMHSX.js";
-import "../chunk-GGXXDWE4.js";
+} from "../chunk-EKY57CSP.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 +85,23 @@ 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-GOXNB3AO.js";
+import {
+  DEFAULT_AUTONOMY_LEVEL
+} from "../chunk-HWUFFB6L.js";
+import "../chunk-ODFEOB4F.js";
+import "../chunk-OZNBF4L3.js";
+import "../chunk-4BJ5BYCE.js";
 import "../chunk-6XLNIQDB.js";
 import "../chunk-5B2AEOW5.js";
 import {
@@ -112,41 +120,44 @@ import {
   setGlobalDefaultMaxOutputTokens,
   setProtectedModelsProvider,
   setResidencyNoticeSink
-} from "../chunk-LZSJBIVT.js";
+} from "../chunk-DJVECN66.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-GEYXPTRF.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-G7MUEIGA.js";
 import {
   readClioVersion
 } from "../chunk-IWHMRKLL.js";
@@ -565,9 +576,10 @@ function permissionResultForDecision(decision, toolUseID, input) {
   if (toolUseID !== void 0) result.toolUseID = toolUseID;
   return result;
 }
-function decideToolUse(input, toolName, toolInput) {
+function decideToolUse(input, toolCallId, toolName, toolInput) {
   return emitClaudeToolPermissionDecision({
     toolName,
+    ...toolCallId !== void 0 ? { toolCallId } : {},
     input: coerceToolInput(toolInput),
     safety: input.safety,
     cwd: input.cwd,
@@ -589,7 +601,7 @@ function decideToolUseOnce(input, toolUseID, toolName, toolInput) {
   return decideClaudeSdkToolUseOnce(
     input.handledToolDecisions,
     toolUseID,
-    () => decideToolUse(input, toolName, toolInput)
+    () => decideToolUse(input, toolUseID, toolName, toolInput)
   );
 }
 function buildCanUseTool(input) {
@@ -968,6 +980,36 @@ function startWorkerRun(input, emit) {
   const deliveryTools = resolveDeliveryTools(input.allowedTools, input.product);
   const middlewareToolChoice = createMiddlewareToolChoiceControl();
   let workerModelRound = 0;
+  const loopGuardRegistration = createLoopGuardRegistration({
+    safety,
+    toolCallCap: workerBudget.hardCap,
+    toolCallSoftLimit: workerBudget.toolCalls,
+    // A worker's blocks all land in one run-long bucket, so the bound on
+    // them is a statement about this run's length, not about a turn.
+    turnBlockBudget: workerLoopBlockBudget(workerBudget.revision?.toolCalls ?? workerBudget.toolCalls),
+    toolCallSoftReadReserve: readReserve,
+    ...deliveryTools.length > 0 ? { deliveryTools } : {},
+    turnSynthesisLockout: workerBudget.synthesis,
+    // Once locked, the next model round is forced text-only at the
+    // request level. The lockout directive alone relies on model compliance.
+    onSynthesisLockout: () => {
+      if (workerBudget.synthesis) synthesisToolLock = true;
+    },
+    ...!workerBudget.synthesis ? {
+      onSoftLimitFinalCallAdmitted: (toolCallId) => {
+        if (workerBoundFailure === null) {
+          workerBoundFailure = `worker agent budget reached (${workerBudget.toolCalls}); synthesis is disabled`;
+        }
+        stopAfterToolResultCallId = toolCallId ?? STOP_AFTER_ANY_TOOL_RESULT;
+      }
+    } : {},
+    // Requiring read is correct only when reading is the whole reserve.
+    ...readReserve > 0 && deliveryTools.length === 0 ? {
+      onSoftReadReserve: () => {
+        middlewareToolChoice.apply([{ kind: "require_tool", toolName: ToolNames.Read }]);
+      }
+    } : {}
+  });
   const registry = createWorkerToolRegistry(
     input.middlewareSnapshot,
     safety,
@@ -986,45 +1028,7 @@ function startWorkerRun(input, emit) {
     // and has no persistence sink. It can still absorb worker-local
     // protect_path effects from snapshot rules for the rest of this run.
     [
-      createLoopGuardRegistration({
-        safety,
-        toolCallCap: workerBudget.hardCap,
-        toolCallSoftLimit: workerBudget.toolCalls,
-        // A worker's blocks all land in one run-long bucket, so the bound on
-        // them is a statement about this run's length, not about a turn.
-        turnBlockBudget: workerLoopBlockBudget(workerBudget.toolCalls),
-        toolCallSoftReadReserve: readReserve,
-        ...deliveryTools.length > 0 ? { deliveryTools } : {},
-        turnSynthesisLockout: workerBudget.synthesis,
-        // Once locked, the next model round is forced text-only at the
-        // request level (the tool surface is removed in onPayload below):
-        // the lockout directive alone relies on model compliance, and
-        // measured local models kept calling tools until the backstop
-        // aborted the run, or answered the forced round with tool-call
-        // markup that the loop guard then removed.
-        onSynthesisLockout: () => {
-          if (workerBudget.synthesis) {
-            synthesisToolLock = true;
-          }
-        },
-        ...!workerBudget.synthesis ? {
-          onSoftLimitFinalCallAdmitted: (toolCallId) => {
-            if (workerBoundFailure === null) {
-              workerBoundFailure = `worker agent budget reached (${workerBudget.toolCalls}); synthesis is disabled`;
-            }
-            stopAfterToolResultCallId = toolCallId ?? STOP_AFTER_ANY_TOOL_RESULT;
-          }
-        } : {},
-        // Forcing the next round to `read` is only correct when reading is
-        // the whole reserve. An agent with delivery tools must be able to
-        // write in its own reserve window, so it gets the steering directive
-        // without the request-level lock.
-        ...readReserve > 0 && deliveryTools.length === 0 ? {
-          onSoftReadReserve: () => {
-            middlewareToolChoice.apply([{ kind: "require_tool", toolName: ToolNames.Read }]);
-          }
-        } : {}
-      }),
+      loopGuardRegistration,
       createProtectedArtifactsRegistration({
         ...input.protectedArtifactState !== void 0 ? { initialState: { artifacts: [...input.protectedArtifactState.artifacts] } } : {}
       })
@@ -1035,6 +1039,7 @@ function startWorkerRun(input, emit) {
   );
   const contractCwd = input.cwd ?? process.cwd();
   let resultContractRepairsQueued = 0;
+  let resultContractRevisionActive = false;
   const pendingReadCitations = /* @__PURE__ */ new Map();
   const observedReadRanges = /* @__PURE__ */ new Map();
   const runEffects = createRunEffectsRecorder(contractCwd);
@@ -1173,9 +1178,24 @@ function startWorkerRun(input, emit) {
       if (violation !== null) {
         if (resultContractRepairsQueued < RESULT_CONTRACT_REPAIR_LIMIT) {
           resultContractRepairsQueued += 1;
-          synthesisToolLock = true;
+          if (!resultContractRevisionActive && workerBudget.revision !== void 0) {
+            resultContractRevisionActive = loopGuardRegistration.extendWorkerToolCallPhase(workerBudget.revision);
+            if (resultContractRevisionActive) {
+              synthesisToolLock = false;
+              middlewareToolChoice.reset();
+              stopAfterToolResultCallId = null;
+            }
+          }
+          const revisionToolsAvailable = resultContractRevisionActive && !synthesisToolLock;
+          if (!revisionToolsAvailable) synthesisToolLock = true;
           const repair = resultContractRepairMessages(
-            { contract, reason: violation, attempt: resultContractRepairsQueued, anchors: observedReadAnchors() },
+            {
+              contract,
+              reason: violation,
+              attempt: resultContractRepairsQueued,
+              anchors: observedReadAnchors(),
+              ...revisionToolsAvailable ? { toolsAvailable: true } : {}
+            },
             { provider: model.provider, api: model.api, model: model.id }
           );
           for (const message of repair) agent.followUp(message);
@@ -1314,7 +1334,7 @@ function startWorkerRun(input, emit) {
       const requestId = meta.requestId;
       const timer = setTimeout(() => resolveEscalation(requestId, "deny", "timeout"), escalationConfig.timeoutMs);
       activeEscalation = { requestId, tool: call.tool, actionClass, callKey, timer };
-      const target = describeCallTarget(call.args).slice(0, 200);
+      const target = describeCallTarget(call.tool, call.args);
       emit({
         type: "clio_permission_escalated",
         payload: {

package/dist/{workspace-G4ZWUIPR.js → workspace-ZJ6BFM3Q.js}

@@ -6,9 +6,9 @@ import {
   probeGitStatusAsync,
   probeWorkspace,
   probeWorkspaceAsync
-} from "./chunk-G4BMMOKF.js";
-import "./chunk-YHZX5GEU.js";
-import "./chunk-EKMEHE4H.js";
+} from "./chunk-HVDIIIQW.js";
+import "./chunk-XAKHZX5N.js";
+import "./chunk-33YXPOE3.js";
 import "./chunk-7CR24IG7.js";
 import "./chunk-3R73A4XB.js";
 export {
@@ -19,4 +19,4 @@ export {
   probeWorkspace,
   probeWorkspaceAsync
 };
-//# sourceMappingURL=workspace-G4ZWUIPR.js.map
+//# sourceMappingURL=workspace-ZJ6BFM3Q.js.map

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.6` 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,17 +44,17 @@ 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)) |
 | WAL SQLite trace mirror database schema, rowid cursor queries, rebuildability, and CLI trace subcommands | [trace-store.md](trace-store.md) ([Interactive Blueprint](html/trace_blueprint.html)) |
-| Private context index determinism, target smoke matrices, and Clio machinery soak benchmark suite | [evals-internal.md](evals-internal.md) ([Blueprints: evals_internal](html/evals_internal_blueprint.html), [soak](html/soak_blueprint.html)) |
+| Private context index determinism and target smoke matrices | [evals-internal.md](evals-internal.md) ([Blueprint](html/evals_internal_blueprint.html)) |
 | Point-in-time inventory of legacy environment variables (Historical Appendix) | [config-knobs-audit.md](config-knobs-audit.md) ([Interactive Blueprint](html/config_knobs_audit_blueprint.html)) |
 | Clock and timestamp conventions: durations, instants, ordering, and formatting | [time-conventions.md](time-conventions.md) ([Interactive Blueprint](html/time_conventions_blueprint.html)) |
 | Correct render, PTY, startup, compile-cache, and import-graph measurement endpoints and the 0.3.3 baseline | [performance-methodology.md](performance-methodology.md) |
@@ -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.6 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.6`.
 
 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.6).
 
 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.6).
 
 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.6` development line.
 
 ---
 

package/docs/artifact-placement.md

@@ -83,8 +83,7 @@ next to the ignore:
 ```
 
 This repository commits none of those, so its `.clio-coder/` stays fully
-ignored except the seeded soak fixtures under `benchmarks/soak/fixtures/`,
-which are test inputs rather than session output.
+ignored. Benchmark workspaces are temporary external repositories.
 
 ## Finding what was hidden
 

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.6`.
 
 ---
 

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.6).
 
 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.6`.
 
 Source implementations: `src/domains/scheduling/` and `src/domains/dispatch/capacity-lease.ts`.