comisai 1.0.44 → 1.0.46

package/node_modules/@comis/agent/dist/memory/emit-generation-quality.d.ts

@@ -1,19 +1,19 @@
 /**
- * GENQ-01: the shared, guarded emit helper for `memory:generation_quality`.
+ * The shared, guarded emit helper for `memory:generation_quality`.
  *
  * The single call site every memory-generation pass (consolidation, reasoning,
  * user-representation) routes through, mirroring the context-engine's
- * `emitSummaryLanguageMismatch` (OBS-01). It runs the pure single-source
- * `classifyGenerationQuality` (I7) over the pass's (source → output) text pair
+ * `emitSummaryLanguageMismatch`. It runs the pure single-source
+ * `classifyGenerationQuality` over the pass's (source → output) text pair
  * and, ONLY when a quality issue is present, emits a content-free event so the
- * F-ML1 regression class (a weak local model translating non-Latin source
- * memories into a Latin output) becomes a counted `comis fleet` finding instead
- * of an offline-probe finding.
+ * language-mismatch regression class (a weak local model translating non-Latin
+ * source memories into a Latin output) becomes a counted `comis fleet` finding
+ * instead of an offline-probe finding.
  *
  * VISIBILITY ONLY — never gates the generation. The emit is strictly additive and
  * GUARDED: a throwing subscriber NEVER fails the (cron) generation pass. The
  * payload carries the closed `GenerationPass` + `ScriptClass` enums + booleans +
- * the agentId ONLY — NEVER the source or generated body (§2.7).
+ * the agentId ONLY — NEVER the source or generated body (AGENTS.md §2.7).
  * @module
  */
 import { type GenerationPass } from "@comis/core";

package/node_modules/@comis/agent/dist/memory/emit-generation-quality.js

@@ -1,20 +1,20 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
- * GENQ-01: the shared, guarded emit helper for `memory:generation_quality`.
+ * The shared, guarded emit helper for `memory:generation_quality`.
  *
  * The single call site every memory-generation pass (consolidation, reasoning,
  * user-representation) routes through, mirroring the context-engine's
- * `emitSummaryLanguageMismatch` (OBS-01). It runs the pure single-source
- * `classifyGenerationQuality` (I7) over the pass's (source → output) text pair
+ * `emitSummaryLanguageMismatch`. It runs the pure single-source
+ * `classifyGenerationQuality` over the pass's (source → output) text pair
  * and, ONLY when a quality issue is present, emits a content-free event so the
- * F-ML1 regression class (a weak local model translating non-Latin source
- * memories into a Latin output) becomes a counted `comis fleet` finding instead
- * of an offline-probe finding.
+ * language-mismatch regression class (a weak local model translating non-Latin
+ * source memories into a Latin output) becomes a counted `comis fleet` finding
+ * instead of an offline-probe finding.
  *
  * VISIBILITY ONLY — never gates the generation. The emit is strictly additive and
  * GUARDED: a throwing subscriber NEVER fails the (cron) generation pass. The
  * payload carries the closed `GenerationPass` + `ScriptClass` enums + booleans +
- * the agentId ONLY — NEVER the source or generated body (§2.7).
+ * the agentId ONLY — NEVER the source or generated body (AGENTS.md §2.7).
  * @module
  */
 import { classifyGenerationQuality } from "@comis/core";
@@ -57,7 +57,7 @@ export function emitGenerationQuality(eventBus, logger, args) {
     }
     catch (err) {
         // Guarded-emit (the emitSummaryLanguageMismatch isolation pattern):
-        // observability NEVER fails the generation pass. Content-free WARN (§2.7).
+        // observability NEVER fails the generation pass. Content-free WARN (AGENTS.md §2.7).
         logger.warn({
             err: err instanceof Error ? err.message : String(err),
             agentId: args.agentId,

package/node_modules/@comis/agent/dist/memory/index.d.ts

@@ -1,12 +1,12 @@
 /**
- * Memory sub-barrel for the v2.26 Verified Learning seams.
+ * Memory sub-barrel for the verified-learning seams.
  *
  * DORMANT surface: this sub-barrel is deliberately NOT re-exported through the
  * package barrel (`packages/agent/src/index.ts`) yet — the optional cost-gated
- * outcome-judge seam (OUTCOME-04) and the correction-detector seam (CORRECT-01)
+ * outcome-judge seam and the correction-detector seam
  * ship built-but-not-wired and are constructed/invoked by the daemon
  * `setup-learning` wiring ONLY when the per-agent `learningOutcome.judge` /
- * `learningOutcome.correction` is enabled (both default OFF, Plan 04). Keeping
+ * `learningOutcome.correction` is enabled (both default OFF). Keeping
  * them off the package barrel keeps them out of the `public-export-consumers`
  * architecture gate until the real cross-package consumer lands, exactly as the
  * analog usefulness-judge seam does.
@@ -16,11 +16,13 @@
 export { createOutcomeJudgeSeam, JUDGE_REWARD_CAP } from "./outcome-judge-seam.js";
 export type { OutcomeJudgeSeamDeps, OutcomeVerdict } from "./outcome-judge-seam.js";
 export type { CustomCompletionsModelSpec } from "./judge-model-resolver.js";
+export { createOrchestrateRepairSeam } from "./orchestrate-repair-seam.js";
+export type { OrchestrateRepairSeam, OrchestrateRepairSeamDeps, OrchestrateRepairInput, } from "./orchestrate-repair-seam.js";
 export { createCorrectionDetectorSeam, CORRECTION_REWARD_CAP } from "./correction-detector-seam.js";
 export type { CorrectionDetectorSeamDeps, CorrectionVerdict } from "./correction-detector-seam.js";
 export { createLlmReflectionAdapter } from "./llm-reflection-adapter.js";
 export type { LlmReflectionAdapterDeps, ReflectionAdapter, ReflectionAdapterLogger, ReflectInput, } from "./llm-reflection-adapter.js";
-export { REFLECT_PROMPT, PROFILE_REFLECT_PROMPT, TOPIC_REFLECT_PROMPT, parseReflectionResult } from "./reflection-prompt.js";
+export { REFLECT_PROMPT, PROFILE_REFLECT_PROMPT, TOPIC_REFLECT_PROMPT, PROCEDURE_REFLECT_PROMPT, parseReflectionResult } from "./reflection-prompt.js";
 export type { ReflectionResult } from "./reflection-prompt.js";
 export { runReflection, classifyReflectOutcome } from "./reflection-job.js";
 export type { RunReflectionDeps, RunReflectionResult, RunReflectionConfig, RunReflectionJobLogger, ReflectionSourceTrajectory, ReflectAdmissionOutcome, } from "./reflection-job.js";

package/node_modules/@comis/agent/dist/memory/index.js

@@ -1,13 +1,13 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
- * Memory sub-barrel for the v2.26 Verified Learning seams.
+ * Memory sub-barrel for the verified-learning seams.
  *
  * DORMANT surface: this sub-barrel is deliberately NOT re-exported through the
  * package barrel (`packages/agent/src/index.ts`) yet — the optional cost-gated
- * outcome-judge seam (OUTCOME-04) and the correction-detector seam (CORRECT-01)
+ * outcome-judge seam and the correction-detector seam
  * ship built-but-not-wired and are constructed/invoked by the daemon
  * `setup-learning` wiring ONLY when the per-agent `learningOutcome.judge` /
- * `learningOutcome.correction` is enabled (both default OFF, Plan 04). Keeping
+ * `learningOutcome.correction` is enabled (both default OFF). Keeping
  * them off the package barrel keeps them out of the `public-export-consumers`
  * architecture gate until the real cross-package consumer lands, exactly as the
  * analog usefulness-judge seam does.
@@ -15,20 +15,26 @@
  * @module
  */
 export { createOutcomeJudgeSeam, JUDGE_REWARD_CAP } from "./outcome-judge-seam.js";
+// The one-shot orchestrate repair seam. The daemon constructs it (in
+// buildAutonomyToolWiring) on a repair-eligible capability class and injects the
+// resulting closure into the orchestrate runner, which calls it AT MOST once on a
+// recoverable non-zero exit. Built on the SAME resolveJudgeModel+completeSimple
+// machinery as the outcome-judge seam so @comis/skills never imports the model
+// layer — only the FACTORY + its types cross the boundary (resolveJudgeModel
+// stays package-internal).
+export { createOrchestrateRepairSeam } from "./orchestrate-repair-seam.js";
 export { createCorrectionDetectorSeam, CORRECTION_REWARD_CAP } from "./correction-detector-seam.js";
-// v2.31 Reflection engine (Phase 223 Plan 04, REFLECT-01/03/04/05/06). The
-// outcome-gated reflection JOB (runReflection) that REPLACED the dead
-// embedding-clustering synthesis pipeline (deleted Plan 06) + the cheap-model
-// reflect adapter (createLlmReflectionAdapter) + the prompt/parser
-// (REFLECT_PROMPT/parseReflectionResult). The daemon `__REFLECT__` cron (Plan 05)
+// The reflection engine: the outcome-gated reflection JOB (runReflection)
+// + the cheap-model reflect adapter (createLlmReflectionAdapter) + the
+// prompt/parser (REFLECT_PROMPT/parseReflectionResult). The daemon `__REFLECT__` cron
 // invokes runReflection when the per-agent `learningSkills.enabled` is turned on
 // (default OFF). The job consumes @comis/core PORT TYPES + the static
 // validateLearnedDocBody + the pure applyDeltaOps/renderStructuredBody only — the
-// daemon injects the @comis/memory store + the reflect adapter (Plan 05).
+// daemon injects the @comis/memory store + the reflect adapter.
 export { createLlmReflectionAdapter } from "./llm-reflection-adapter.js";
-// REFLECT_PROMPT is the skill default the adapter falls back to; PROFILE_REFLECT_PROMPT
-// (Plan 02) + TOPIC_REFLECT_PROMPT (Plan 03) are the per-kind variants the daemon
-// `__REFLECT__` cron injects (Plan 04) as the adapter `systemPrompt` for the profile/
-// topic kinds — exported here so the daemon composition root can pass them per kind.
-export { REFLECT_PROMPT, PROFILE_REFLECT_PROMPT, TOPIC_REFLECT_PROMPT, parseReflectionResult } from "./reflection-prompt.js";
+// REFLECT_PROMPT is the skill default the adapter falls back to; PROFILE_REFLECT_PROMPT,
+// TOPIC_REFLECT_PROMPT, and PROCEDURE_REFLECT_PROMPT are the per-kind variants the daemon
+// `__REFLECT__` cron injects as the adapter `systemPrompt` for the profile/topic/procedure
+// passes — exported here so the daemon composition root can pass them per kind.
+export { REFLECT_PROMPT, PROFILE_REFLECT_PROMPT, TOPIC_REFLECT_PROMPT, PROCEDURE_REFLECT_PROMPT, parseReflectionResult } from "./reflection-prompt.js";
 export { runReflection, classifyReflectOutcome } from "./reflection-job.js";

package/node_modules/@comis/agent/dist/memory/judge-model-resolver.js

@@ -22,7 +22,7 @@
  *
  * @module
  */
-import { getModel } from "@earendil-works/pi-ai";
+import { getModel } from "@earendil-works/pi-ai/compat";
 /**
  * Resolve a Model for a judge seam: pi-ai catalog first, else construct an
  * openai-completions Model from `customSpec`. Returns `undefined` only when the

package/node_modules/@comis/agent/dist/memory/llm-json.d.ts

@@ -3,7 +3,7 @@
  * (extraction, consolidation, dialectic, reasoning, relationship,
  * usefulness-judge, user-representation).
  *
- * Live finding 2026-06-11 (LIVEMEM run): despite every prompt ending with
+ * Live finding 2026-06-11: despite every prompt ending with
  * "Return ONLY valid JSON … no commentary", claude-sonnet-4-6 at
  * temperature 0 regularly narrates BEFORE the payload ("The memories
  * conflict on this date. … \n\n{ … }"). A whole-string `JSON.parse` then

package/node_modules/@comis/agent/dist/memory/llm-json.js

@@ -4,7 +4,7 @@
  * (extraction, consolidation, dialectic, reasoning, relationship,
  * usefulness-judge, user-representation).
  *
- * Live finding 2026-06-11 (LIVEMEM run): despite every prompt ending with
+ * Live finding 2026-06-11: despite every prompt ending with
  * "Return ONLY valid JSON … no commentary", claude-sonnet-4-6 at
  * temperature 0 regularly narrates BEFORE the payload ("The memories
  * conflict on this date. … \n\n{ … }"). A whole-string `JSON.parse` then

package/node_modules/@comis/agent/dist/memory/llm-reflection-adapter.d.ts

@@ -1,13 +1,11 @@
 /**
- * The LLM-backed reflection adapter (v2.31 Reflection engine, Phase 223 Plan 04,
- * INV-5) — the cheap-model call seam the reflection job uses to distil a doc.
- * The reflect-engine replacement for the deleted `llm-skill-synthesis-adapter.ts`
- * (the cron deletes follow in Plans 05/06); it mirrors that adapter's two
- * load-bearing security properties:
+ * The LLM-backed reflection adapter — the cheap-model call seam the reflection
+ * job uses to distil a doc.
+ * It carries two load-bearing security properties:
  *
  *  1. The UNTRUSTED `trajectoryText` is `wrapExternalContent`-wrapped (the
  *     `learned_skill_reflection` source) BEFORE it reaches the LLM — the
- *     injection-defense keystone (INV-5). An injection embedded in the trajectory
+ *     injection-defense keystone. An injection embedded in the trajectory
  *     is delimited + labeled, never bare in the prompt. The doc's CURRENT
  *     sections (system-derived, trusted) are passed as a trusted preamble OUTSIDE
  *     the wrapped block so the model can emit a minimal delta against them.
@@ -15,15 +13,15 @@
  *     malformed / adversarial payload yields `ok({})` (never a throw, never a
  *     half-formed op/section). Any LLM transport fault surfaces as `err(...)`,
  *     and a pi-ai `{stopReason:"error"}` ALSO surfaces as `err(...)` with a WARN
- *     naming the model (NOT a silent empty parse — the live-2026-06-18 judge
- *     precedent).
+ *     naming the model (NOT a silent empty parse — the same diagnosability rule
+ *     the outcome judge follows).
  *
  * Closed graph: this adapter consumes the `@comis/core` security keystone
  * (`wrapExternalContent`) + the `@comis/core` reflection types (`DocSection`) +
  * the `@earendil-works/pi-ai` model SDK — it imports NO `@comis/memory` /
  * `@comis/skills` value (the agent↛memory / agent↛skills closed-graph cut). The
- * cheap model is resolved via {@link resolveJudgeModel} (the keyless/custom seam
- * that survives the synthesis delete — 11 other consumers).
+ * cheap model is resolved via {@link resolveJudgeModel} (the shared keyless/custom
+ * resolution seam).
  *
  * @module
  */
@@ -54,15 +52,17 @@ export interface LlmReflectionAdapterDeps {
         now: () => number;
     };
     /**
-     * The per-kind reflect system prompt (Phase 225 FOLD). Omitted ⇒ the skill
-     * `REFLECT_PROMPT` (a skill adapter stays byte-identical). Plans 02/03 pass
-     * `PROFILE_REFLECT_PROMPT` / `TOPIC_REFLECT_PROMPT`.
+     * The per-kind reflect system prompt. Omitted ⇒ the skill
+     * `REFLECT_PROMPT` (a skill adapter stays byte-identical). Profile/topic
+     * adapters pass `PROFILE_REFLECT_PROMPT` / `TOPIC_REFLECT_PROMPT`.
      */
     systemPrompt?: string;
     /**
-     * The per-kind `wrapExternalContent` source label (Phase 225 FOLD) — the
+     * The per-kind `wrapExternalContent` source label — the
      * UNTRUSTED-input boundary the LLM sees. Omitted ⇒ `"learned_skill_reflection"`.
-     * Plans 02/03 pass `"learned_profile_reflection"` / `"learned_topic_reflection"`.
+     * Profile/topic adapters pass `"learned_profile_reflection"` / `"learned_topic_reflection"`;
+     * the procedure pass passes `"learned_procedure_reflection"` (a distinct label so the
+     * procedure transcript is wrapped under its own boundary).
      */
     source?: ExternalContentSource;
     /** Structural logger (counts/ids/step only — never doc bodies). */

package/node_modules/@comis/agent/dist/memory/llm-reflection-adapter.js

@@ -1,14 +1,12 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
- * The LLM-backed reflection adapter (v2.31 Reflection engine, Phase 223 Plan 04,
- * INV-5) — the cheap-model call seam the reflection job uses to distil a doc.
- * The reflect-engine replacement for the deleted `llm-skill-synthesis-adapter.ts`
- * (the cron deletes follow in Plans 05/06); it mirrors that adapter's two
- * load-bearing security properties:
+ * The LLM-backed reflection adapter — the cheap-model call seam the reflection
+ * job uses to distil a doc.
+ * It carries two load-bearing security properties:
  *
  *  1. The UNTRUSTED `trajectoryText` is `wrapExternalContent`-wrapped (the
  *     `learned_skill_reflection` source) BEFORE it reaches the LLM — the
- *     injection-defense keystone (INV-5). An injection embedded in the trajectory
+ *     injection-defense keystone. An injection embedded in the trajectory
  *     is delimited + labeled, never bare in the prompt. The doc's CURRENT
  *     sections (system-derived, trusted) are passed as a trusted preamble OUTSIDE
  *     the wrapped block so the model can emit a minimal delta against them.
@@ -16,21 +14,21 @@
  *     malformed / adversarial payload yields `ok({})` (never a throw, never a
  *     half-formed op/section). Any LLM transport fault surfaces as `err(...)`,
  *     and a pi-ai `{stopReason:"error"}` ALSO surfaces as `err(...)` with a WARN
- *     naming the model (NOT a silent empty parse — the live-2026-06-18 judge
- *     precedent).
+ *     naming the model (NOT a silent empty parse — the same diagnosability rule
+ *     the outcome judge follows).
  *
  * Closed graph: this adapter consumes the `@comis/core` security keystone
  * (`wrapExternalContent`) + the `@comis/core` reflection types (`DocSection`) +
  * the `@earendil-works/pi-ai` model SDK — it imports NO `@comis/memory` /
  * `@comis/skills` value (the agent↛memory / agent↛skills closed-graph cut). The
- * cheap model is resolved via {@link resolveJudgeModel} (the keyless/custom seam
- * that survives the synthesis delete — 11 other consumers).
+ * cheap model is resolved via {@link resolveJudgeModel} (the shared keyless/custom
+ * resolution seam).
  *
  * @module
  */
 import { ok, err, fromPromise } from "@comis/shared";
 import { systemSetTimeout, systemClearTimeout, wrapExternalContent } from "@comis/core";
-import { completeSimple } from "@earendil-works/pi-ai";
+import { completeSimple } from "@earendil-works/pi-ai/compat";
 import { resolveJudgeModel, temperatureOption } from "./judge-model-resolver.js";
 import { REFLECT_PROMPT, parseReflectionResult } from "./reflection-prompt.js";
 // ---------------------------------------------------------------------------
@@ -80,17 +78,17 @@ function renderCurrentDoc(sections) {
  */
 export function createLlmReflectionAdapter(deps) {
     const { provider, modelId, apiKey, customModel, clock, logger } = deps;
-    // Per-kind prompt + source label (Phase 225 FOLD) — default to the skill values
+    // Per-kind prompt + source label — default to the skill values
     // so an existing skill adapter construction is byte-identical.
     const systemPrompt = deps.systemPrompt ?? REFLECT_PROMPT;
     const source = deps.source ?? "learned_skill_reflection";
     async function reflect(input) {
         const { trajectoryText, currentSections } = input;
         // SECURITY: wrap the UNTRUSTED trajectory BEFORE the LLM — the
-        // injection-defense keystone (INV-5). The delimited + labeled block is the
+        // injection-defense keystone. The delimited + labeled block is the
         // boundary an embedded injection cannot cross. The doc's CURRENT sections are
         // a TRUSTED preamble OUTSIDE the wrapped block. The per-kind source label only
-        // varies the boundary's label (the 223 `learned_skill_reflection` precedent).
+        // varies the boundary's LABEL, never the boundary itself.
         const wrapped = wrapExternalContent(trajectoryText, { source });
         const userContent = `${renderCurrentDoc(currentSections)}\n\nSUCCESSFUL trajectories to distil:\n${wrapped}`;
         let model;
@@ -129,8 +127,8 @@ export function createLlmReflectionAdapter(deps) {
         // A pi-ai API error does NOT throw — it RETURNS `{stopReason:"error", content:[],
         // errorMessage}` (e.g. a retired/invalid model id 404). Treat it like the thrown
         // branch above: WARN naming the model + skip the topic (err), NOT a silent empty
-        // parse (the live-2026-06-18 judge precedent). The deterministic !ok branch only
-        // catches a THROWN/transport fault.
+        // parse (the same diagnosability rule the outcome judge follows). The
+        // deterministic !ok branch only catches a THROWN/transport fault.
         const resp = responseResult.value;
         if (resp.stopReason === "error" || (Array.isArray(resp.content) && resp.content.length === 0)) {
             logger.warn({
@@ -143,7 +141,7 @@ export function createLlmReflectionAdapter(deps) {
             return err(new Error(`Reflection model error/empty: ${resp.errorMessage ?? "no content"}`));
         }
         // TOTAL parse — never throws; a malformed payload yields {} (the job's
-        // empty-content guard then skips admit, REFLECT-05).
+        // empty-content guard then skips the admit).
         const result = parseReflectionResult(extractResponseText(responseResult.value));
         logger.debug({
             submodule: "llm-reflection-adapter",

package/node_modules/@comis/agent/dist/memory/memory-capability-router.d.ts

@@ -1,16 +1,15 @@
 /**
  * Capability-routed memory operations strategy resolver.
  *
- * R6: for low-capabilityClass models (small/nano), routes to "abstain" rather
+ * For low-capabilityClass models (small/nano), routes to "abstain" rather
  * than allowing potentially-fabricated LLM memory operations (dialectic
- * synthesis, extraction, consolidation). frontier/mid: returns "capable"
- * (unchanged behavior, byte-identical to today).
+ * synthesis, extraction, consolidation). frontier/mid: returns "capable".
  *
  * Fail-closed: small/nano without an explicit capableModelOverride → "abstain"
  * (the safe floor). The override exists so operators can inject a stronger cheap
  * model for the memory pipeline independently of the main agent model.
  *
- * T-153-fabricate mitigation: a weak model passed a synthesis/extraction task
+ * Fabrication mitigation: a weak model passed a synthesis/extraction task
  * will fabricate citations. Routing to "abstain" prevents fabricated triples/
  * citations from entering trusted storage.
  *
@@ -29,7 +28,7 @@ export type MemoryOpsStrategy = "capable" | "abstain";
  * produce grounded, citation-accurate synthesis/extraction output).
  *
  * Returns "abstain" for small/nano without a capable-model override
- * (T-153-fabricate mitigation: prevent fabricated citations/triples from
+ * (fabrication mitigation: prevent fabricated citations/triples from
  * entering trusted storage). An operator can configure a stronger cheap model
  * for the memory pipeline via the `hasCapableModelOverride` flag.
  *

package/node_modules/@comis/agent/dist/memory/memory-capability-router.js

@@ -5,7 +5,7 @@
  * produce grounded, citation-accurate synthesis/extraction output).
  *
  * Returns "abstain" for small/nano without a capable-model override
- * (T-153-fabricate mitigation: prevent fabricated citations/triples from
+ * (fabrication mitigation: prevent fabricated citations/triples from
  * entering trusted storage). An operator can configure a stronger cheap model
  * for the memory pipeline via the `hasCapableModelOverride` flag.
  *
@@ -23,6 +23,6 @@ export function resolveMemoryOpsStrategy(capabilityClass, hasCapableModelOverrid
         return "capable";
     }
     // small or nano without a capable-model override: abstain hard.
-    // Prevents T-153-fabricate: weak model fabricates citations/triples.
+    // Prevents fabrication: a weak model fabricates citations/triples.
     return "abstain";
 }

package/node_modules/@comis/agent/dist/memory/memory-dialectic-prompt.d.ts

@@ -18,7 +18,7 @@
  * (`orderByTrust`, `memory-dialectic-synthesis.ts`), NEVER from the LLM. Any
  * `trust`/`trustLevel` the model emits anyway is STRIPPED by the lenient `z.object` (unknown
  * keys dropped, NOT rejected). The parser is TOTAL — a malformed/adversarial payload
- * degrades to `{ abstain: true }` (the Pitfall-5 default; never throws into recall).
+ * degrades to `{ abstain: true }` (the mandatory-abstention default; never throws into recall).
  *
  * @module
  */
@@ -45,7 +45,7 @@ export declare function buildDialecticPrompt(): string;
  *
  * TOTAL function — NEVER throws (the non-fatal contract at the parse boundary): a
  * malformed/adversarial payload returns `{ abstain: true }` so the synthesis degrades to
- * abstention (Pitfall 5), never a fabricated answer. Steps:
+ * abstention, never a fabricated answer. Steps:
  *   1. strip markdown code fences,
  *   2. `JSON.parse` inside try/catch (parse error ⇒ `{ abstain: true }`),
  *   3. `safeParse` against the lenient schema (unknown keys — incl. any `trust`/`trustLevel`

package/node_modules/@comis/agent/dist/memory/memory-dialectic-prompt.js

@@ -19,7 +19,7 @@
  * (`orderByTrust`, `memory-dialectic-synthesis.ts`), NEVER from the LLM. Any
  * `trust`/`trustLevel` the model emits anyway is STRIPPED by the lenient `z.object` (unknown
  * keys dropped, NOT rejected). The parser is TOTAL — a malformed/adversarial payload
- * degrades to `{ abstain: true }` (the Pitfall-5 default; never throws into recall).
+ * degrades to `{ abstain: true }` (the mandatory-abstention default; never throws into recall).
  *
  * @module
  */
@@ -85,7 +85,7 @@ const DialecticOutputSchema = z.object({
  *
  * TOTAL function — NEVER throws (the non-fatal contract at the parse boundary): a
  * malformed/adversarial payload returns `{ abstain: true }` so the synthesis degrades to
- * abstention (Pitfall 5), never a fabricated answer. Steps:
+ * abstention, never a fabricated answer. Steps:
  *   1. strip markdown code fences,
  *   2. `JSON.parse` inside try/catch (parse error ⇒ `{ abstain: true }`),
  *   3. `safeParse` against the lenient schema (unknown keys — incl. any `trust`/`trustLevel`
@@ -117,7 +117,7 @@ export function parseDialecticOutput(raw) {
     if (!parsed.success)
         return { abstain: true };
     const { answer, abstain, citedIds } = parsed.data;
-    // Explicit abstention, or no usable answer ⇒ abstain (the Pitfall-5 default).
+    // Explicit abstention, or no usable answer ⇒ abstain (the mandatory-abstention default).
     if (abstain === true)
         return { abstain: true };
     if (typeof answer !== "string" || answer.length === 0)

package/node_modules/@comis/agent/dist/memory/memory-dialectic-seam.d.ts

@@ -43,7 +43,7 @@ export interface DialecticSeamDeps {
     modelId: string;
     /** The API key VALUE (resolved by NAME at the daemon; never logged here). */
     apiKey: string;
-    /** FLAG-3 fix: optional async credential resolver. When set, `callModel` awaits it before
+    /** Optional async credential resolver. When set, `callModel` awaits it before
      *  `completeSimple` and uses its return as the key. This routes OAuth providers (openai-codex)
      *  through `resolveProviderApiKey` (which sets pi's runtime-override token) instead of the static
      *  empty `apiKey` that made `memory.ask` abstain for OAuth deployments. Absent ⇒ the static `apiKey`
@@ -58,14 +58,14 @@ export interface DialecticSeamDeps {
     /** Scope tag for the failure logs. */
     agentId: string;
     /**
-     * R6: the capability class of the agent's model (from ModelProfile.capabilityClass).
+     * The capability class of the agent's model (from ModelProfile.capabilityClass).
      * When small/nano without a capable override, synthesize() returns { abstain: true }
-     * immediately — no LLM call is made (T-153-fabricate mitigation).
+     * immediately — no LLM call is made (fabrication mitigation).
      * Optional: callers that don't pass it default to "frontier" behavior (capable).
      */
     capabilityClass?: CapabilityClass;
     /**
-     * R6: operator override — a stronger cheap model is configured for the memory
+     * Operator override — a stronger cheap model is configured for the memory
      * pipeline. When true, small/nano are treated as "capable" for dialectic synthesis.
      * Optional; defaults to false.
      */

package/node_modules/@comis/agent/dist/memory/memory-dialectic-seam.js

@@ -33,7 +33,7 @@
  * @module
  */
 import { systemSetTimeout, systemClearTimeout } from "@comis/core";
-import { completeSimple } from "@earendil-works/pi-ai";
+import { completeSimple } from "@earendil-works/pi-ai/compat";
 import { resolveJudgeModel, temperatureOption } from "./judge-model-resolver.js";
 import { buildDialecticPrompt, parseDialecticOutput } from "./memory-dialectic-prompt.js";
 import { resolveMemoryOpsStrategy } from "./memory-capability-router.js";
@@ -70,7 +70,7 @@ function extractResponseText(response) {
  */
 export function createDialecticSeam(deps) {
     const { provider, modelId, apiKey, maxOutputTokens, clock, logger, agentId, customModel } = deps;
-    // R6: pre-resolve the capability routing (once per seam instance, not per call).
+    // Pre-resolve the capability routing (once per seam instance, not per call).
     // Defaults to "frontier" behavior when capabilityClass is absent (capable path).
     const capabilityClass = deps.capabilityClass ?? "frontier";
     const hasCapableModelOverride = deps.hasCapableModelOverride ?? false;
@@ -106,11 +106,11 @@ export function createDialecticSeam(deps) {
         const controller = new AbortController();
         const timer = systemSetTimeout(() => controller.abort(), LLM_TIMEOUT_MS);
         try {
-            // FLAG-3: resolve the credential per-call so OAuth providers (openai-codex) get their bearer
+            // Resolve the credential per-call so OAuth providers (openai-codex) get their bearer
             // (via resolveProviderApiKey's runtime-override) instead of the static empty apiKey that made
             // memory.ask abstain. Falls back to the static apiKey (keyless / built-in / test).
             const resolvedApiKey = deps.resolveCredential ? await deps.resolveCredential() : apiKey;
-            // FLAG-3 (verified live 2026-06-22): `temperatureOption` gates the deterministic temperature:0 on
+            // Verified live: `temperatureOption` gates the deterministic temperature:0 on
             // `model.reasoning` — reasoning models (gpt-5.x, o-series, Claude Opus 4.7+) reject `temperature`
             // (HTTP 400 "Unsupported parameter: temperature" → empty response → abstain). Paired with
             // resolveCredential (the OAuth bearer); BOTH are required — the temperature 400 fired before auth.
@@ -140,7 +140,7 @@ export function createDialecticSeam(deps) {
         }
     }
     return async function synthesize(question, groundingText) {
-        // R6 pre-call check (T-153-fabricate mitigation): if the capability class
+        // Pre-call capability check (fabrication mitigation): if the capability class
         // routes to "abstain", return immediately — NO LLM call is made. A small/nano
         // model receiving a dialectic synthesis task will fabricate citations; this
         // gate prevents fabricated citations from entering trusted storage.

package/node_modules/@comis/agent/dist/memory/memory-dialectic-synthesis.d.ts

@@ -1,7 +1,7 @@
 /**
  * The PURE dialectic synthesis helpers.
  *
- * The genuinely-new logic of the phase, isolated as side-effect-free functions so the
+ * The genuinely-new synthesis logic, isolated as side-effect-free functions so the
  * trust-first contradiction ordering, the mandatory abstention, and the
  * citation→recalled-id→sourceId mapping are RED-provable at $0 (no daemon, no DB, no
  * model). The query-time LLM lives ONLY in `memory-dialectic-seam.ts`; these helpers
@@ -13,11 +13,11 @@
  *   / `triple-store.ts:55-61`) orders the recall survivors; the higher-trust claim is
  *   presented first and a lower-trust contradiction never blends into the answer. Trust is
  *   read from `entry.trustLevel` in CODE — NEVER from anything the model emitted.
- * - ABSTENTION is decided in CODE ({@link abstainIfInsufficient}, Pitfall 5), not left to
+ * - ABSTENTION is decided in CODE ({@link abstainIfInsufficient}), not left to
  *   the prompt: an empty recall set, a parser that abstained, or a parsed result whose
  *   citations do not intersect the recalled ids ⇒ abstain. The function is a pure predicate
  *   over the recall set + the parsed result — it does NOT call the seam.
- * - CITATIONS are validated ⊆ recalled ids ({@link mapCitationsToSourceIds}, Pitfall 4): a
+ * - CITATIONS are validated ⊆ recalled ids ({@link mapCitationsToSourceIds}): a
  *   hallucinated/forged id the model emits is DROPPED; each surviving citation is traversed
  *   to its `sourceIds` (the reasoning-tree provenance chain).
  *
@@ -67,7 +67,7 @@ export interface AssembledSynthesis {
  */
 export declare function orderByTrust(items: MemorySearchResult[]): MemorySearchResult[];
 /**
- * Decide abstention in CODE (Pitfall 5 — never left to the prompt). Returns `{ abstain: true }`
+ * Decide abstention in CODE (never left to the prompt). Returns `{ abstain: true }`
  * when ANY of:
  * - the recall set is empty (no grounding at all), OR
  * - the parser itself abstained, OR
@@ -82,7 +82,7 @@ export declare function abstainIfInsufficient(recalled: MemorySearchResult[], pa
 /**
  * Validate citations ⊆ recalled ids, then traverse each survivor to its `sourceIds` (the
  * reasoning-tree chain). A model-emitted id that is NOT in the recalled set is
- * DROPPED (Pitfall 4 — a hallucinated/forged citation can never enter the answer). An entry
+ * DROPPED (a hallucinated/forged citation can never enter the answer). An entry
  * with no `sourceIds` yields an empty chain.
  */
 export declare function mapCitationsToSourceIds(recalled: MemorySearchResult[], citedIds: string[]): CitationChain[];

package/node_modules/@comis/agent/dist/memory/memory-dialectic-synthesis.js

@@ -2,7 +2,7 @@
 /**
  * The PURE dialectic synthesis helpers.
  *
- * The genuinely-new logic of the phase, isolated as side-effect-free functions so the
+ * The genuinely-new synthesis logic, isolated as side-effect-free functions so the
  * trust-first contradiction ordering, the mandatory abstention, and the
  * citation→recalled-id→sourceId mapping are RED-provable at $0 (no daemon, no DB, no
  * model). The query-time LLM lives ONLY in `memory-dialectic-seam.ts`; these helpers
@@ -14,11 +14,11 @@
  *   / `triple-store.ts:55-61`) orders the recall survivors; the higher-trust claim is
  *   presented first and a lower-trust contradiction never blends into the answer. Trust is
  *   read from `entry.trustLevel` in CODE — NEVER from anything the model emitted.
- * - ABSTENTION is decided in CODE ({@link abstainIfInsufficient}, Pitfall 5), not left to
+ * - ABSTENTION is decided in CODE ({@link abstainIfInsufficient}), not left to
  *   the prompt: an empty recall set, a parser that abstained, or a parsed result whose
  *   citations do not intersect the recalled ids ⇒ abstain. The function is a pure predicate
  *   over the recall set + the parsed result — it does NOT call the seam.
- * - CITATIONS are validated ⊆ recalled ids ({@link mapCitationsToSourceIds}, Pitfall 4): a
+ * - CITATIONS are validated ⊆ recalled ids ({@link mapCitationsToSourceIds}): a
  *   hallucinated/forged id the model emits is DROPPED; each surviving citation is traversed
  *   to its `sourceIds` (the reasoning-tree provenance chain).
  *
@@ -62,14 +62,14 @@ export function orderByTrust(items) {
         .map(({ item }) => item);
 }
 // ---------------------------------------------------------------------------
-// 2. Mandatory abstention, decided in CODE (Pitfall 5)
+// 2. Mandatory abstention, decided in CODE (never left to the prompt)
 // ---------------------------------------------------------------------------
 /** The set of recalled ids — the citation-validation domain. */
 function recalledIdSet(recalled) {
     return new Set(recalled.map((r) => r.entry.id));
 }
 /**
- * Decide abstention in CODE (Pitfall 5 — never left to the prompt). Returns `{ abstain: true }`
+ * Decide abstention in CODE (never left to the prompt). Returns `{ abstain: true }`
  * when ANY of:
  * - the recall set is empty (no grounding at all), OR
  * - the parser itself abstained, OR
@@ -93,7 +93,7 @@ export function abstainIfInsufficient(recalled, parsed) {
 /**
  * Validate citations ⊆ recalled ids, then traverse each survivor to its `sourceIds` (the
  * reasoning-tree chain). A model-emitted id that is NOT in the recalled set is
- * DROPPED (Pitfall 4 — a hallucinated/forged citation can never enter the answer). An entry
+ * DROPPED (a hallucinated/forged citation can never enter the answer). An entry
  * with no `sourceIds` yields an empty chain.
  */
 export function mapCitationsToSourceIds(recalled, citedIds) {
@@ -102,7 +102,7 @@ export function mapCitationsToSourceIds(recalled, citedIds) {
     for (const citationId of citedIds) {
         const entry = byId.get(citationId);
         if (entry === undefined)
-            continue; // bogus id — drop (Pitfall 4)
+            continue; // bogus id — drop (never enters the answer)
         chains.push({ citationId, sourceIds: entry.sourceIds ?? [] });
     }
     return chains;