comisai 1.0.45 → 1.0.46

package/node_modules/@comis/agent/dist/executor/executor-session-state.d.ts

@@ -100,7 +100,8 @@ export declare function getBreakpointIndexMapSize(): number;
 export declare function clearSessionBreakpointIndex(sessionKey: string): void;
 /** True when the session already consumed its one reactive strip-retry. */
 export declare function isReactiveSchemaStripArmed(sessionKey: string): boolean;
-/** Arm the per-session strip (set BEFORE the retry fires — T-175-14). */
+/** Arm the per-session strip (set BEFORE the retry fires, so a crash mid-retry
+ *  still counts as the one consumed attempt). */
 export declare function armReactiveSchemaStrip(sessionKey: string): void;
 /** Clear the per-session reactive strip state. Exported for session cleanup
  *  (wired into clearSessionState alongside clearSessionDeliveredGuides /

package/node_modules/@comis/agent/dist/executor/executor-session-state.js

@@ -125,9 +125,9 @@ export function clearSessionDeliveredGuides(sessionKey) {
     sessionDeliveredGuides.delete(sessionKey);
 }
 // ---------------------------------------------------------------------------
-// Session-scoped context-window-reconcile INFO latch (KNOB-02 / Phase 176)
+// Session-scoped context-window-reconcile INFO latch
 // ---------------------------------------------------------------------------
-/** KNOB-02: once-per-session latch for the context-window-reconcile INFO line.
+/** Once-per-session latch for the context-window-reconcile INFO line.
  *  The reconcile runs every execute(), but load-bearing evidence must not be
  *  DEBUG-only (troubleshooting doctrine) — pi-executor promotes the first
  *  reconcile of a session to INFO and latches here so subsequent turns stay
@@ -226,7 +226,7 @@ export function clearSessionBreakpointIndex(sessionKey) {
     sessionBreakpointIndex.delete(sessionKey);
 }
 // ---------------------------------------------------------------------------
-// Session-scoped reactive tool-schema strip state (GBNF-02 / 175-REVIEW CR-02)
+// Session-scoped reactive tool-schema strip state
 // ---------------------------------------------------------------------------
 /**
  * Per-session flag: a grammar-400 triggered the reactive pattern/format
@@ -234,7 +234,7 @@ export function clearSessionBreakpointIndex(sessionKey) {
  * roles:
  *
  *   - once-gate: a second grammar-400 in the same session is terminal — the
- *     single repair attempt already ran (T-175-14);
+ *     single repair attempt already ran;
  *   - next-turn constraint memory: per-turn assembly re-applies the strip
  *     AFTER provider normalization (`applyPersistedReactiveStrip` in
  *     executor-tool-pipeline.ts), so a heal survives the snapshot→normalize
@@ -252,7 +252,8 @@ const sessionReactiveSchemaStrip = createBoundedSessionMap();
 export function isReactiveSchemaStripArmed(sessionKey) {
     return sessionReactiveSchemaStrip.get(sessionKey) === true;
 }
-/** Arm the per-session strip (set BEFORE the retry fires — T-175-14). */
+/** Arm the per-session strip (set BEFORE the retry fires, so a crash mid-retry
+ *  still counts as the one consumed attempt). */
 export function armReactiveSchemaStrip(sessionKey) {
     sessionReactiveSchemaStrip.set(sessionKey, true);
 }

package/node_modules/@comis/agent/dist/executor/executor-stream-setup.d.ts

@@ -85,7 +85,7 @@ export interface StreamSetupParams {
     /**
      * ModelProfile resolved once per execution in pi-executor.ts.
      * Threaded into RequestBodyInjectorConfig so the factory and
-     * tool-deferral-injection use capability flags (L1/L2 — Phase 155-01)
+     * tool-deferral-injection use capability flags
      * instead of provider-string predicates.
      */
     modelProfile?: ModelProfile;
@@ -140,17 +140,17 @@ export interface StreamSetupResult {
     /** Shared mutable TTL split estimate, populated by requestBodyInjector,
      *  consumed by pi-event-bridge on turn_end for per-TTL cost calculation. */
     ttlSplit: TtlSplitEstimate;
-    /** Phase 166: mutable ref for assembled input tokens (set by lcd-assembler via onAssembledInputTokens).
+    /** Mutable ref for assembled input tokens (set by lcd-assembler via onAssembledInputTokens).
      *  Exposed so pi-executor.ts can wire the callback into setupContextEngine. */
     assembledInputTokensRef: {
         current: number;
     };
-    /** Phase 166: mutable ref for effective window (set by lcd-assembler via onEffectiveWindow).
+    /** Mutable ref for effective window (set by lcd-assembler via onEffectiveWindow).
      *  Exposed so pi-executor.ts can wire the callback into setupContextEngine. */
     effectiveWindowRef: {
         current: number;
     };
-    /** Phase 166 CR-02: mutable ref for reasoning-aware output headroom.
+    /** Mutable ref for reasoning-aware output headroom.
      *  Initialised to MIN_VISIBLE_OUTPUT_TOKENS (768). pi-executor.ts updates it via
      *  computeOutputHeadroom(reasoningStyle, thinkingLevel) in the onEffectiveWindow
      *  and onThinkingDownshifted callbacks so config-resolver always uses the REAL
@@ -162,7 +162,7 @@ export interface StreamSetupResult {
 /** Minimal deps for the microcompaction offload callback. */
 export interface OffloadCallbackDeps {
     eventBus: import("@comis/core").TypedEventBus;
-    /** Injected wall-clock read — the callback timestamps via `clock.now()`, never the global clock (Pitfall 6). */
+    /** Injected wall-clock read — the callback timestamps via `clock.now()`, never the global clock. */
     clock: import("@comis/core").ClockPort;
     /** Existing cache-break side-effect (cacheBreakDetector.notifyContentModification). */
     onCacheBreak: () => void;
@@ -170,11 +170,11 @@ export interface OffloadCallbackDeps {
 /**
  * Build the 4-arg callback the microcompaction guard invokes on each offload.
  *
- * The guard holds no eventBus/clock (T-151-07) — it computes the payload
- * (already with a WORKSPACE-RELATIVE pointer, T-151-05) and passes it here.
+ * The guard holds no eventBus/clock — it computes the payload
+ * (already with a WORKSPACE-RELATIVE pointer) and passes it here.
  * This callback performs the two observable effects: it preserves the
  * existing cache-break notification and emits `tool:result_offloaded` so the
- * offload lands in the trajectory (Phase 153 `IncidentReport.offloads[]`
+ * offload lands in the trajectory (the `IncidentReport.offloads[]`
  * drill-down). Extracted as a pure factory so the emit shape is unit-testable
  * without standing up the full `setupStreamWrappers` dependency graph.
  */

package/node_modules/@comis/agent/dist/executor/executor-stream-setup.js

@@ -48,11 +48,11 @@ import path from "node:path";
 /**
  * Build the 4-arg callback the microcompaction guard invokes on each offload.
  *
- * The guard holds no eventBus/clock (T-151-07) — it computes the payload
- * (already with a WORKSPACE-RELATIVE pointer, T-151-05) and passes it here.
+ * The guard holds no eventBus/clock — it computes the payload
+ * (already with a WORKSPACE-RELATIVE pointer) and passes it here.
  * This callback performs the two observable effects: it preserves the
  * existing cache-break notification and emits `tool:result_offloaded` so the
- * offload lands in the trajectory (Phase 153 `IncidentReport.offloads[]`
+ * offload lands in the trajectory (the `IncidentReport.offloads[]`
  * drill-down). Extracted as a pure factory so the emit shape is unit-testable
  * without standing up the full `setupStreamWrappers` dependency graph.
  */
@@ -64,7 +64,7 @@ export function buildOffloadCallback(deps) {
             toolCallId,
             originalChars,
             diskPathRel,
-            timestamp: deps.clock.now(), // injected clock, not the global one (Pitfall 6)
+            timestamp: deps.clock.now(), // injected clock, not the global one
         });
     };
 }
@@ -120,7 +120,7 @@ export function setupStreamWrappers(params) {
         ["file_ops", "Read specific line ranges instead of entire files"],
         ["memory_search", "Reduce limit parameter or narrow search query"],
     ]);
-    // v2.19: small/nano cap a single tool result far below the 50_000-char schema default
+    // small/nano cap a single tool result far below the 50_000-char schema default
     // so one oversized web_search/read result cannot blow the window (the live NVDA analysts
     // exhausted at assembled ~33-35K from 20-35K-char results). The scaffold returns a number
     // only when it wants to override; otherwise fall back to the operator/schema config value.
@@ -133,7 +133,7 @@ export function setupStreamWrappers(params) {
     deps.logger, registerTruncation);
     // Shared TTL split estimate, populated by requestBodyInjector, consumed by bridge
     const ttlSplit = { cacheWrite5mTokens: 0, cacheWrite1hTokens: 0 };
-    // Phase 166 Fix 3: assembled input tokens + effective window set by lcd-assembler via callbacks,
+    // Assembled input tokens + effective window set by lcd-assembler via callbacks,
     // read lazily by configResolver at dispatch time (lazy evaluation — assembler runs AFTER wrapper chain is built).
     const assembledInputTokensRef = { current: 0 };
     const effectiveWindowRef = { current: Infinity };
@@ -142,7 +142,7 @@ export function setupStreamWrappers(params) {
     const capturedRetention = getAdaptiveRetention();
     const capturedCacheRetention = getExecutionCacheRetention();
     // Wrapper chain order (outermost first):
-    // ttlGuard -> [L3] toolCallRepairWrapper -> validationErrorFormatter -> toolResultSizeBouncer ->
+    // ttlGuard -> toolCallRepairWrapper -> validationErrorFormatter -> toolResultSizeBouncer ->
     //   turnResultBudget -> configResolver -> requestBodyInjector (Anthropic) ->
     //   geminiCacheInjector (Google) -> [traceWriters]
     // TTL guard is outermost wrapper
@@ -167,28 +167,28 @@ export function setupStreamWrappers(params) {
         logger: deps.logger,
         clock: deps.clock,
     }), 
-    // L3/S3 (Phase 155-02): shape-only tool-call JSON repair inserted BEFORE
+    // Shape-only tool-call JSON repair inserted BEFORE
     // validationErrorFormatter so near-miss args are repaired then re-validated
     // by the existing downstream gates (validateExecCommand for exec tools).
     // Irreparable args produce "Validation failed" prefix → PARAMETER_VALIDATION_TAGS
     // carve-out → no breaker trip. Uses modelProfile for supportsStructuredOutput gate.
     createToolCallRepairWrapper(modelProfile ?? FAIL_CLOSED_PROFILE, deps.logger), validationErrorFormatter, bouncerWrapper, turnBudgetWrapper, createConfigResolver({
-        // L5/CR-01: when the operator has not set an explicit maxTokens override,
+        // When the operator has not set an explicit maxTokens override,
         // size the MAIN-path budget from the model profile's REAL maxOutputTokens.
         // resolveMainPathMaxOutputTokens returns the full profile budget for
         // non-reasoning models (NEVER the 512-token verdict reserve, which would
-        // truncate every visible answer — CR-01) and sizes UP for native-reasoning
+        // truncate every visible answer) and sizes UP for native-reasoning
         // profiles so reasoning_content cannot starve the answer. The critic path
         // keeps its own resolveMaxOutputTokens(verdict reserve) — do not reuse it
         // here. The operator's explicit config.maxTokens always takes precedence.
         maxTokens: config.maxTokens ?? (modelProfile
             ? resolveMainPathMaxOutputTokens(modelProfile)
             : undefined),
-        // Phase 166 Fix 3: dynamic max_tokens clamp via closure-ref getters.
+        // Dynamic max_tokens clamp via closure-ref getters.
         // The assembler sets these refs during transformContext (AFTER wrapper chain is built).
         // When the guard fires (assembled > 0 AND effectiveWindow < Infinity), config-resolver
         // clamps max_tokens per-dispatch. Frontier/mid: refs stay at defaults (0/Infinity) →
-        // guard never fires → static maxTokens path is byte-identical (CWF-02-H).
+        // guard never fires → static maxTokens path is byte-identical.
         getAssembledInputTokens: () => assembledInputTokensRef.current > 0
             ? assembledInputTokensRef.current
             : undefined,
@@ -233,7 +233,7 @@ export function setupStreamWrappers(params) {
             ? (highestIdx) => onBreakpointsPlaced(highestIdx)
             : undefined,
         onPayloadForCacheDetection: (apiParams, model, headers) => {
-            // L1/L2: read supportsPromptCache flag from ModelProfile when present.
+            // Read the supportsPromptCache flag from ModelProfile when present.
             // Falls back to isAnthropicFamily for callers that do not yet thread modelProfile.
             if (modelProfile?.supportsPromptCache ?? isAnthropicFamily(model.provider)) {
                 const stateInput = extractAnthropicPromptState(apiParams, model.id, capturedRetention?.getRetention(), formattedKey, agentId ?? "unknown", headers);
@@ -274,7 +274,7 @@ export function setupStreamWrappers(params) {
         // The getter runs AFTER `onPayloadForCacheDetection` increments
         // the counter for this turn, so the gate sees the correct value.
         getCallCount: () => cacheBreakDetector.getCallCount(formattedKey),
-        // L1/L2 (Phase 155-01): thread ModelProfile flags so factory.ts and
+        // Thread ModelProfile flags so factory.ts and
         // tool-deferral-injection.ts use capability flags instead of
         // provider-string predicates. Optional so callers without a resolved
         // modelProfile (tests, secondary injectors) keep the existing fallback.
@@ -325,10 +325,10 @@ export function setupStreamWrappers(params) {
             // Rotation defaults from daemon.logging.tracing
             const traceMaxSize = deps.tracingDefaults?.maxSize ?? "5m";
             const traceMaxFiles = deps.tracingDefaults?.maxFiles ?? 3;
-            // api-payload-trace remains under the legacy
-            // `agents.<name>.tracing.enabled` flag. The
-            // cache-trace artifact moved to `diagnostics.cacheTrace.enabled`
-            // and is gated by the sibling `if (cacheTrace)` block below.
+            // api-payload-trace is gated by the per-agent
+            // `agents.<name>.tracing.enabled` flag. The cache-trace artifact has
+            // its own gate — `diagnostics.cacheTrace.enabled` — handled by the
+            // sibling `if (cacheTrace)` block below.
             wrappers.push(createApiPayloadTraceWriter({ filePath: apiPayloadPath, agentId, sessionId: formattedKey, maxSize: traceMaxSize, maxFiles: traceMaxFiles, clock: deps.clock }, deps.logger));
             deps.logger.info({ outputDir, apiPayloadPath }, "JSONL api-payload tracing enabled");
         }

package/node_modules/@comis/agent/dist/executor/executor-tool-assembly-types.d.ts

@@ -52,15 +52,14 @@ export interface ToolAssemblyDeps {
      *  Step-0 pinned-first lane (the `deps.pinnedStore !== undefined` half of the gate).
      *  A missing forward here is a silent no-op: pinned memories never appear in
      *  agent recall even when the store is wired in the daemon and `rag.pinned.enabled`
-     *  is true (the R6 blocker). TYPE-only from @comis/core (the agent↛memory build cut). */
+     *  is true. TYPE-only from @comis/core (the agent↛memory build cut). */
     pinnedStore?: import("@comis/core").MemoryPinnedStore;
-    /** Optional mental-model store (the v2.31 Reflection doc store), forwarded into
-     *  prompt-assembly's LLM-free `<user_profile>` standing-block injection (FOLD-01, Phase 225
-     *  Plan 02 — the rewired source replacing `userRepresentationStore`; a deterministic
+    /** Optional mental-model store (the Reflection doc store), forwarded into
+     *  prompt-assembly's LLM-free `<user_profile>` standing-block injection (a deterministic
      *  `list(scope,"profile")` + the pure `buildProfileBlock` formatter, NO model call). Absent ->
      *  no list, no push, byte-identical prompt. TYPE-only from @comis/core (the agent↛memory build
      *  cut). A missing forward here leaves the profile injection a silent no-op even when the store
-     *  is wired in the daemon (the documented latent field-plumbing drop — Pitfall 1). */
+     *  is wired in the daemon. */
     mentalModelStore?: import("@comis/core").MentalModelStorePort;
     /** Timer port for the rerank wall-clock deadline (createMemoryRecall). */
     timers?: import("@comis/core").TimerPort;
@@ -104,7 +103,7 @@ export interface ToolAssemblyDeps {
     /** Wall-clock + monotonic time reads. */
     clock: import("@comis/core").ClockPort;
     /**
-     * AUTHOR-03 (174-05 / CR-01): live read of
+     * Live read of
      * `config.orchestration.authoring.gbnfConstrain`. Resolver form (not a
      * static boolean) because the gate is runtime-mutable via config.write
      * (`orchestration` is NOT in IMMUTABLE_CONFIG_PREFIXES), so a boot-time
@@ -169,11 +168,11 @@ export interface ToolAssemblyResult {
     deliveredGuides: Set<string>;
     /** Capability class from ModelProfile (resolved once per execution in pi-executor). */
     capabilityClass: CapabilityClass;
-    /** SUMW-02: the turn's budget window — computeTokenBudgetForProfile().windowTokens
+    /** The turn's budget window — computeTokenBudgetForProfile().windowTokens
      *  = min(reconciled contextWindow, capability class cap). The ONE utilization
-     *  denominator shared with assembly + CWF-02 preflight; threaded through
-     *  postExecution to the LCD after-turn triggers (REQUIRED — a fallback would
-     *  silently restore the configured-window denominator, the DIST-01 bug class). */
+     *  denominator shared with assembly + the context-window-fit preflight; threaded
+     *  through postExecution to the LCD after-turn triggers (REQUIRED — a fallback
+     *  would silently restore the configured-window denominator). */
     budgetWindowTokens: number;
     /** Discovery tracker for deferred tool discovery state. */
     discoveryTracker: DiscoveryTracker;
@@ -191,13 +190,13 @@ export interface ToolAssemblyResult {
     promptResult: ExecutionPromptResult;
     /** Estimated system token count (system prompt + tool definition overhead). */
     cachedSystemTokensEstimate: number;
-    /** I1 / WR-01: estimated WHOLE fresh-tail preamble token count (the entire
+    /** Estimated WHOLE fresh-tail preamble token count (the entire
      *  `dynamicPreamble` + `inlineMemory` blob envelope-wrapper prepends into the
      *  latest user message — skills XML, MCP instructions, deferred-tools context,
      *  date/channel lines, recalled memory, …, NOT just recall) — a SEPARATE budget
      *  subtrahend, never folded into the system estimate above. The whole preamble is
      *  counted on purpose (it rides the unconditionally-shipped fresh tail and is
-     *  reserved nowhere else); see token-budget.ts WR-01. */
+     *  reserved nowhere else); see token-budget.ts. */
     cachedFreshTailPreambleTokens: number;
 }
 /** Parameters for the assembleTools function. */
@@ -232,8 +231,8 @@ export interface ToolAssemblyParams {
     };
     /** ModelProfile resolved once per execution in pi-executor. Used to thread capabilityClass to consumers. */
     modelProfile?: ModelProfile;
-    /** KNOB-02: served/capability window provenance built at the pi-executor reconcile.
-     *  Absent ⇒ budget reports profile.contextWindow as raw (pre-KNOB-02). */
+    /** Served/capability window provenance built at the pi-executor reconcile.
+     *  Absent ⇒ budget reports profile.contextWindow as raw (no provenance). */
     windowProvenance?: WindowProvenance;
     agentId?: string;
     safetyReinforcement?: string;

package/node_modules/@comis/agent/dist/executor/executor-tool-assembly.d.ts

@@ -13,12 +13,12 @@
 import type { CapabilityClass } from "./model-profile.js";
 import type { ToolAssemblyParams, ToolAssemblyResult } from "./executor-tool-assembly-types.js";
 /**
- * C3: Preamble WARN threshold (tokens) per capability class.
+ * Preamble WARN threshold (tokens) per capability class.
  * Warn when cachedFreshTailPreambleTokens exceeds this fraction of the
  * effective context window. frontier: Infinity (never warn). small/nano:
  * tight budget (~10% of effective window is a notable preamble spend).
  *
- * Exported (A1, Phase 176 FLOOR-01): context-engine/viable-floor.ts consumes
+ * Exported: context-engine/viable-floor.ts consumes
  * this table as the freshTailReserve term of the boot minViable equation —
  * the codebase's single per-class number for expected preamble size.
  */

package/node_modules/@comis/agent/dist/executor/executor-tool-assembly.js

@@ -27,15 +27,15 @@ import { toolDefOverheadChars } from "./tool-overhead.js";
 import { CHARS_PER_TOKEN_RATIO } from "../context-engine/constants.js";
 import { computeTokenBudgetForProfile } from "../context-engine/budget-capacity-cap.js";
 // ---------------------------------------------------------------------------
-// C3 (Plan 152-04): per-capability-class preamble WARN thresholds + deferred-tools caps
+// Per-capability-class preamble WARN thresholds + deferred-tools caps
 // ---------------------------------------------------------------------------
 /**
- * C3: Preamble WARN threshold (tokens) per capability class.
+ * Preamble WARN threshold (tokens) per capability class.
  * Warn when cachedFreshTailPreambleTokens exceeds this fraction of the
  * effective context window. frontier: Infinity (never warn). small/nano:
  * tight budget (~10% of effective window is a notable preamble spend).
  *
- * Exported (A1, Phase 176 FLOOR-01): context-engine/viable-floor.ts consumes
+ * Exported: context-engine/viable-floor.ts consumes
  * this table as the freshTailReserve term of the boot minViable equation —
  * the codebase's single per-class number for expected preamble size.
  */
@@ -46,7 +46,7 @@ export const PREAMBLE_WARN_THRESHOLD_BY_CLASS = {
     nano: 1_600, // ~10% of 16K effective window
 };
 /**
- * C3: Max deferred-tools entries emitted in the preamble per capability class.
+ * Max deferred-tools entries emitted in the preamble per capability class.
  * frontier: unlimited (Infinity). small/nano: cap to avoid bloating preamble.
  */
 const DEFERRED_TOOLS_MAX_BY_CLASS = {
@@ -56,13 +56,13 @@ const DEFERRED_TOOLS_MAX_BY_CLASS = {
     nano: 10,
 };
 // ---------------------------------------------------------------------------
-// TOK-01 (Phase 179): script-aware system-tokens estimate
+// Script-aware system-tokens estimate
 // ---------------------------------------------------------------------------
-/** System-tokens estimate with script-aware effective chars (TOK-01).
+/** System-tokens estimate with script-aware effective chars.
  *  systemPrompt text gets its own factor (recalled content can be non-Latin);
  *  the tool-def overhead is an aggregate char count (machine-Latin JSON) and
  *  rides flat. ONE ceil over the summed effective chars — per-term ceils would
- *  inflate ASCII results and break the I1 byte-identity pin. Shared by the
+ *  inflate ASCII results and break byte-identity with a flat sum. Shared by the
  *  pre-deferral AND post-deferral (#190) sites so the two estimates cannot
  *  drift — the same anti-drift rule as the tool-overhead.ts extraction. */
 function estimateSystemTokensFactored(systemPrompt, toolOverheadChars) {
@@ -86,7 +86,7 @@ function estimateSystemTokensFactored(systemPrompt, toolOverheadChars) {
  */
 export async function assembleTools(params) {
     const { config, deps, sessionKey, msg, tools, executionOverrides, isFirstMessageInSession, sm, deliveredGuides, resolvedModel, modelCompat, modelProfile: modelProfileParam, windowProvenance, agentId, safetyReinforcement, _directives, } = params;
-    const effectiveWorkspaceDir = executionOverrides?.workspaceDir ?? deps.workspaceDir; // WT-01: worktree jail when present.
+    const effectiveWorkspaceDir = executionOverrides?.workspaceDir ?? deps.workspaceDir; // Worktree jail when present.
     // -------------------------------------------------------------------
     // 1. Merge per-request tools (AgentTool[]) with deps.customTools
     // -------------------------------------------------------------------
@@ -180,7 +180,7 @@ export async function assembleTools(params) {
         }, "Thinking level exceeds model capability");
     }
     deps.logger.info({ persistent: persistentSettings }, "Settings manager initialized");
-    // 3b. Degenerate-window compact-prompt budget (2026-06-22 root-cause fix). The
+    // 3b. Degenerate-window compact-prompt budget. The
     // system prompt is NON-EVICTABLE; on a window smaller than the full prompt (an
     // ~8K mid-class model whose ~10K prompt overflows even after every tool defers —
     // compact-secure never fires for mid/frontier), the pre-flight would throw
@@ -204,7 +204,7 @@ export async function assembleTools(params) {
     const promptResult = await assembleExecutionPrompt({
         config,
         deps: {
-            workspaceDir: effectiveWorkspaceDir, // WT-01: AGENTS.md/BOOT.md from the run's working tree.
+            workspaceDir: effectiveWorkspaceDir, // AGENTS.md/BOOT.md from the run's working tree.
             // Forward the data dir so the recall-trace recorder's base resolves
             // from the same source as the memory.recall_trace reader.
             dataDir: deps.dataDir,
@@ -223,20 +223,17 @@ export async function assembleTools(params) {
             tripleStore: deps.tripleStore,
             embeddingStore: deps.embeddingStore,
             usefulnessStore: deps.usefulnessStore,
-            // R6: forward the pinned-memory store so the recall pipeline's Step-0 pinned-first
+            // Forward the pinned-memory store so the recall pipeline's Step-0 pinned-first
             // lane can fire. A missing forward here is a silent no-op: the gate
             // `cfg_pinned?.enabled === true && deps.pinnedStore !== undefined` never passes
             // and pinned entries are never prepended to recall results even when the operator
             // has set `rag.pinned.enabled: true` and pinned memories in the DB.
             pinnedStore: deps.pinnedStore,
-            // FOLD-01 (Phase 225): forward the mental-model store — the kind:"profile" source for the
-            // rewired <user_profile> block (prompt-assembly's deps.mentalModelStore.list(scope,"profile")
-            // → buildProfileBlock; the standalone userRepresentationStore was deleted in Plan 05). A
-            // missing forward here is a silent no-op (the profile block never renders even with the store
-            // wired daemon-side — the documented field-plumbing drop, Pitfall 1).
+            // Forward the mental-model store — the kind:"profile" source for the
+            // <user_profile> block (prompt-assembly's deps.mentalModelStore.list(scope,"profile")
+            // → buildProfileBlock). A missing forward here is a silent no-op (the profile
+            // block never renders even with the store wired daemon-side).
             mentalModelStore: deps.mentalModelStore,
-            // (The directional relationshipStore forward was DELETED in Phase 226-04 with the rest of
-            //  the social-modeling subsystem — the <channel_relationships> injection it fed is gone.)
             timers: deps.timers,
             hookRunner: deps.hookRunner,
             secretManager: deps.secretManager,
@@ -281,11 +278,11 @@ export async function assembleTools(params) {
         resolvedModelReasoning: resolvedModel?.reasoning,
         // "interactive" default guards the optional overrides; mirrors pi-executor.ts:1077.
         operationType: executionOverrides?.operationType ?? "interactive",
-        // C2/S1: Forward ModelProfile to prompt-assembly.ts for compact-secure mode selection.
+        // Forward ModelProfile to prompt-assembly.ts for compact-secure mode selection.
         // modelProfileParam is the validated ModelProfile resolved at pi-executor.ts:323;
-        // it is undefined when the executor has no profile resolution (rare legacy path).
+        // it is undefined when the executor has no profile resolution (rare path).
         modelProfile: modelProfileParam,
-        // Degenerate-window compact-prompt fallback budget (2026-06-22): when the full
+        // Degenerate-window compact-prompt fallback budget: when the full
         // prompt can't fit this window, assembleExecutionPrompt falls back to
         // compact-secure so the agent still runs instead of context-exhausting on its
         // fixed overhead. Only engages in the genuinely-degenerate case (normal windows
@@ -295,19 +292,19 @@ export async function assembleTools(params) {
     // -------------------------------------------------------------------
     // 5. System token estimate
     // -------------------------------------------------------------------
-    // I8 (Phase 176 FLOOR-01): the char-overhead reduce lives in tool-overhead.ts —
+    // The char-overhead reduce lives in tool-overhead.ts —
     // shared with the boot viable-floor so the two estimates cannot drift.
     const toolDefOverheadCharsValue = toolDefOverheadChars(mergedCustomTools);
     // Computed over the PRE-deferral set here so the input-independent windowTokens
     // (computeTokenBudgetForProfile below) has a value; RECOMPUTED over the
     // post-deferral active set after applyToolDeferral so the history-budget
     // partition + pre-flight fit check reserve for the tools that actually ship,
-    // not the ~58 deferred ones the stub filter strips from the wire (live UC-2
-    // finding, 2026-06-12: the pre-deferral 82-tool estimate over-reserved ~16K and
+    // not the ~58 deferred ones the stub filter strips from the wire (live
+    // finding: the pre-deferral 82-tool estimate over-reserved ~16K and
     // falsely context-exhausted multi-turn local-model sessions).
-    // TOK-01 (Phase 179): script-aware effective chars — see estimateSystemTokensFactored.
+    // Script-aware effective chars — see estimateSystemTokensFactored.
     let cachedSystemTokensEstimate = estimateSystemTokensFactored(promptResult.systemPrompt, toolDefOverheadCharsValue);
-    // I1 / WR-01: the WHOLE fresh-tail preamble token estimate — the entire
+    // The WHOLE fresh-tail preamble token estimate — the entire
     // dynamicPreamble + inlineMemory blob envelope-wrapper prepends into the latest
     // user message (skills XML, MCP instructions, deferred-tools context, date/channel
     // lines, recalled memory, …, NOT just recall), measured as a SEPARATE budget
@@ -315,11 +312,11 @@ export async function assembleTools(params) {
     // The whole preamble is counted deliberately: it rides the unconditionally-shipped
     // fresh tail and is reserved nowhere else, so this is the only window-headroom
     // reservation for it (recall is a strict subset → a heavier recall block still
-    // grows this and compacts harder, preserving I1's intent). See token-budget.ts WR-01.
-    // TOK-01 (Phase 179): both terms are TEXT (the preamble carries recalled
+    // grows this and compacts harder). See token-budget.ts.
+    // Both terms are TEXT (the preamble carries recalled
     // memories/skills which can be non-Latin) — each term's chars divided by its
-    // own script factor, ONE ceil over the summed effective chars (I1: ASCII
-    // factors are 1.0 → byte-identical to the previous flat sum).
+    // own script factor, ONE ceil over the summed effective chars (ASCII
+    // factors are 1.0 → byte-identical to a flat sum).
     const inlineMemoryText = promptResult.inlineMemory ?? "";
     const cachedFreshTailPreambleTokens = Math.ceil((promptResult.dynamicPreamble.length / scriptTokenFactor(promptResult.dynamicPreamble) +
         inlineMemoryText.length / scriptTokenFactor(inlineMemoryText)) / CHARS_PER_TOKEN_RATIO);
@@ -361,9 +358,9 @@ export async function assembleTools(params) {
     const recentlyUsedTools = extractRecentlyUsedToolNames(sessionMessages);
     const modelProfile = modelProfileParam ?? FAIL_CLOSED_PROFILE;
     const capabilityClass = modelProfile.capabilityClass;
-    // SD7 (Phase 159): resolve capacity defaults (bootstrapMaxChars + activeToolCeiling).
+    // Resolve capacity defaults (bootstrapMaxChars + activeToolCeiling).
     const capacityDefaults = resolveScaffoldDefaults(modelProfile, config);
-    // C3: preamble size guard — warn when preamble tokens exceed the profile cap.
+    // Preamble size guard — warn when preamble tokens exceed the profile cap.
     // This is a soft operator signal: the preamble is already assembled, but the
     // warn lets operators know they may want to reduce MCP tools or deferred-tools
     // list size for this capability class.
@@ -377,8 +374,8 @@ export async function assembleTools(params) {
             capabilityClass,
         }, "C3: preamble size exceeds profile cap");
     }
-    // C1 (Phase 152): profile-aware budget — 8K-starvation fix + 256K-overfill cap +
-    // KNOB-02 provenance. windowTokens is input-independent of the systemTokens args.
+    // Profile-aware budget — 8K-starvation fix + 256K-overfill cap + window
+    // provenance. windowTokens is input-independent of the systemTokens args.
     const profileBudget = computeTokenBudgetForProfile(modelProfile, cachedSystemTokensEstimate, cachedFreshTailPreambleTokens, -1, config.contextEngine?.budget?.effectiveContextCapSmall, config.contextEngine?.budget?.effectiveContextCapNano, windowProvenance);
     // contextWindow: the per-turn effective window the tool-budget fit pass uses.
     // profileBudget.windowTokens === fitWindowBudget.effectiveWindow (step 3b) by
@@ -441,14 +438,14 @@ export async function assembleTools(params) {
         }, "Discovery state restored from parent SpawnPacket");
     }
     const deferralCtx = {
-        // 260521-0bn: per-message trust resolution. Previously the deferral
-        // context used the GLOBAL `defaultTrustLevel` only, which meant
-        // `senderTrustMap` entries (e.g. {"678314278": "admin"}) never
-        // reached this code path — privileged tools like `mcp_manage`,
-        // `agents_manage`, `obs_query` (all 14 in `PRIVILEGED_TOOL_NAMES`)
-        // stayed in the deferred set even for explicitly-mapped admin users,
-        // forcing them through indirection tools. This now mirrors the
-        // resolution at packages/orchestrator/src/execution/execution-policy.ts:82:
+        // Per-message trust resolution. The deferral context must consult
+        // `senderTrustMap` entries (e.g. {"678314278": "admin"}), not just the
+        // GLOBAL `defaultTrustLevel` — otherwise privileged tools like
+        // `mcp_manage`, `agents_manage`, `obs_query` (all 14 in
+        // `PRIVILEGED_TOOL_NAMES`) stay in the deferred set even for
+        // explicitly-mapped admin users, forcing them through indirection
+        // tools. Mirrors the resolution at
+        // packages/orchestrator/src/execution/execution-policy.ts:82:
         //   elevCfg.senderTrustMap[senderId] ?? elevCfg.defaultTrustLevel
         trustLevel: config.elevatedReply?.senderTrustMap?.[msg.senderId]
             ?? config.elevatedReply?.defaultTrustLevel
@@ -465,7 +462,7 @@ export async function assembleTools(params) {
         providerFamily: resolvedModel?.provider
             ? resolveProviderCapabilities(resolvedModel.provider).providerFamily
             : "default",
-        // SD7 (Phase 159): capability-class active-tool ceiling.
+        // Capability-class active-tool ceiling.
         activeToolCeiling: capacityDefaults.activeToolCeiling,
     };
     const deferralResult = applyToolDeferral(mergedCustomTools, contextWindow, deferralCtx, deps.logger, deps.embeddingPort, config.skills?.toolDiscovery);
@@ -482,7 +479,7 @@ export async function assembleTools(params) {
         ]);
         deferralResult.discoverTool = createDiscoverTool(deferralResult.deferredEntries, deps.logger, deps.embeddingPort, config.skills?.toolDiscovery, activeAfterDeferral);
     }
-    // ROOT-CAUSE context-exhaustion guard (2026-06-22): applyToolDeferral defers
+    // Context-exhaustion guard: applyToolDeferral defers
     // by COUNT (activeToolCeiling / CORE_TOOLS heuristic) and never against a token
     // budget — its `_contextWindow` arg is ignored. So on a small window a large
     // system prompt + even a CORE_TOOLS-only active set can exceed effectiveWindow −
@@ -495,8 +492,8 @@ export async function assembleTools(params) {
     // budget, refining deferralResult in place (incl. rebuilding discover_tools over
     // the new deferred set). Dropped tools stay reachable via discover_tools (no
     // capability loss for adequate windows). The fixed S term is non-evictable, so
-    // the degenerate window<S case still throws — but Part 2/3 make THAT honest
-    // (cause: fixed_overhead_exceeds_window), never "your message is too big". The
+    // the degenerate window<S case still throws — but with the honest cause
+    // (fixed_overhead_exceeds_window), never "your message is too big". The
     // headroom mirrors lcd-preflight.ts exactly (same reasoningStyle / thinkingLevel
     // / minVisibleFloor) so the two passes agree. The headroom + floor + window are
     // the SAME values computed once in step 3b (fitWindowBudget) — reused here so the
@@ -521,13 +518,13 @@ export async function assembleTools(params) {
     // the auto-discovery stubs added below, which the stub filter strips from the
     // wire). The pre-deferral estimate above counted every registered tool, so a
     // small-class agent that defers most of its surface over-reserved budget and
-    // falsely context-exhausted multi-turn sessions (live UC-2 finding, 2026-06-12).
+    // falsely context-exhausted multi-turn sessions (observed in a live session).
     // windowTokens is input-independent of this value, so the earlier budget call's
     // window is unaffected; only the downstream history partition + fit check use
     // this corrected, smaller reservation.
-    // TOK-01 (#190 third site): the recompute MUST use the same factored helper as
-    // the pre-deferral estimate — a flat recompute here would silently UNDO the
-    // script factor right before the history partition + fit check consume it.
+    // The recompute (the third char→token site, #190) MUST use the same factored
+    // helper as the pre-deferral estimate — a flat recompute here would silently
+    // UNDO the script factor right before the history partition + fit check consume it.
     cachedSystemTokensEstimate = estimateSystemTokensFactored(promptResult.systemPrompt, toolDefOverheadChars(mergedCustomTools));
     // 7b. Auto-discovery stubs for deferred tools.
     // Lightweight stubs so the SDK's agent-loop finds deferred tools during
@@ -548,7 +545,7 @@ export async function assembleTools(params) {
     // gated there by a model-id capability check. See tool-deferral.ts JSDoc
     // on `buildDeferredToolsContext` for the rationale.
     //
-    // C3: cap deferred-tools list for small/nano to bound preamble size.
+    // Cap the deferred-tools list for small/nano to bound preamble size.
     // frontier/mid: DEFERRED_TOOLS_MAX_BY_CLASS[class] = Infinity → pass undefined (no cap).
     const deferredToolsMax = DEFERRED_TOOLS_MAX_BY_CLASS[capabilityClass];
     let deferredContext = "";
@@ -582,7 +579,7 @@ export async function assembleTools(params) {
             provider: resolvedModel.provider,
             modelId: resolvedModel.id,
             compat: modelCompat,
-            // AUTHOR-03 (CR-01): thread the gbnfConstrain authoring gate end-to-end.
+            // Thread the gbnfConstrain authoring gate end-to-end.
             // The flag lives on the top-level AppConfig (config.orchestration.authoring),
             // NOT PerAgentConfig — so it arrives via a deps resolver that reads
             // container.config live (runtime-mutable; see getGbnfConstrain JSDoc).
@@ -590,7 +587,7 @@ export async function assembleTools(params) {
             gbnfConstrain: deps.getGbnfConstrain?.() ?? false,
         });
     }
-    // GBNF-02 / CR-02: re-apply the session's reactive pattern/format strip
+    // Re-apply the session's reactive pattern/format strip
     // AFTER normalization — the per-turn snapshot→normalize rebuild constructs
     // fresh parameter objects, so a strip that healed turn N must be re-applied
     // here or turn N+1 re-sends the rejected keywords and (with the once-gate
@@ -608,7 +605,7 @@ export async function assembleTools(params) {
         capabilityIndexResult,
         deliveredGuides,
         capabilityClass,
-        // SUMW-02: the per-turn budget window (min(reconciled contextWindow, class
+        // The per-turn budget window (min(reconciled contextWindow, class
         // cap)) — the single-sourced contextWindow (== fitWindowBudget.effectiveWindow),
         // the same value the pre-flight throws on and every budget computation reports.
         budgetWindowTokens: contextWindow,

package/node_modules/@comis/agent/dist/executor/executor-tool-pipeline.d.ts

@@ -33,7 +33,7 @@ export interface SchemaPruneParams {
     capabilityClass: import("./model-profile.js").CapabilityClass;
     logger: ComisLogger;
 }
-/** Apply schema pruning for nano-class models (behavior-neutral: old small=<=32K → new nano). */
+/** Apply schema pruning for nano-class models (only the "nano" capability class is pruned). */
 export declare function applySchemasPruning(params: SchemaPruneParams): ToolDefinition[];
 /** Parameters for applying tool schema snapshot. */
 export interface SchemaSnapshotParams {
@@ -60,7 +60,7 @@ export interface ProviderNormalizeParams {
         nativeWebSearchTool?: boolean;
     };
     /**
-     * AUTHOR-03 (174-05 / CR-01): the value of
+     * The value of
      * `config.orchestration.authoring.gbnfConstrain`, threaded from the
      * assembly call site. When true, the Layer 3.5 GBNF transform engages for
      * gbnf-ELIGIBLE (local/default-family) providers even when they are not
@@ -84,7 +84,7 @@ export interface PersistedReactiveStripParams {
 }
 /**
  * Re-apply the session's reactive pattern/format strip AFTER provider
- * normalization (CR-02). The strip-retry handler
+ * normalization. The strip-retry handler
  * (tool-schema-unsupported-handler.ts) mutates THIS turn's wire objects for
  * the in-flight retry, but every subsequent turn rebuilds `parameters` from
  * the pre-strip schema snapshot — and gbnf normalization constructs