@remnic/core 10.0.25 → 10.0.27

package/dist/{auto-sync-7WWAKW6F.js → auto-sync-UQESPLCB.js}

@@ -1,8 +1,8 @@
 import {
   dateInTimezone,
   defaultTimezone
-} from "./chunk-CJRENHVZ.js";
-import "./chunk-YUZRI3QU.js";
+} from "./chunk-XNAOCY67.js";
+import "./chunk-AN3G5DZH.js";
 import "./chunk-UOBPK2OS.js";
 import "./chunk-CIO7GCWE.js";
 import "./chunk-YN2DQ2D6.js";
@@ -13,11 +13,11 @@ import {
 } from "./chunk-V7IZKJI3.js";
 import "./chunk-QDW3E4RD.js";
 import "./chunk-UHVXE24Y.js";
-import "./chunk-TKC5LZ43.js";
+import "./chunk-UIDWASOS.js";
 import "./chunk-I55KAVET.js";
 import "./chunk-L2EXJQJP.js";
 import "./chunk-45GF7Y3V.js";
-import "./chunk-EP6BA7VV.js";
+import "./chunk-CU5TILGD.js";
 import "./chunk-E2AWJ7KQ.js";
 import "./chunk-YCVB7X56.js";
 import "./chunk-YBA52OKG.js";
@@ -98,4 +98,4 @@ function startWearablesAutoSync(settings, deps) {
 export {
   startWearablesAutoSync
 };
-//# sourceMappingURL=auto-sync-7WWAKW6F.js.map
+//# sourceMappingURL=auto-sync-UQESPLCB.js.map

package/dist/briefing.js

@@ -18,10 +18,10 @@ import {
   renderBriefingMarkdown,
   resolveBriefingSaveDir,
   validateBriefingFormat
-} from "./chunk-LT4SMGE4.js";
+} from "./chunk-4WT6I4VG.js";
 import "./chunk-GZFKCLRC.js";
 import "./chunk-6JMQR72P.js";
-import "./chunk-D42L5SQF.js";
+import "./chunk-IHS2UGYM.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-TRMJ6BYC.js";
 import "./chunk-V4JZCTMK.js";
@@ -42,11 +42,11 @@ import "./chunk-A7Q43EUZ.js";
 import "./chunk-S2V7RUCL.js";
 import "./chunk-PPUNC7UX.js";
 import "./chunk-X3724WL4.js";
-import "./chunk-MRPOZBJC.js";
 import "./chunk-S2HLHAZ4.js";
+import "./chunk-MRPOZBJC.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
-import "./chunk-2DT7PIDZ.js";
+import "./chunk-EPOYPPOW.js";
 import "./chunk-AAD2ZS6P.js";
 import "./chunk-FF6N7BXC.js";
 import "./chunk-JNIVZNIB.js";
@@ -75,11 +75,11 @@ import "./chunk-IUM3VSHI.js";
 import "./chunk-C64XATK7.js";
 import "./chunk-42JKGUFJ.js";
 import "./chunk-23G5P7TA.js";
-import "./chunk-TKC5LZ43.js";
+import "./chunk-UIDWASOS.js";
 import "./chunk-I55KAVET.js";
 import "./chunk-L2EXJQJP.js";
 import "./chunk-45GF7Y3V.js";
-import "./chunk-EP6BA7VV.js";
+import "./chunk-CU5TILGD.js";
 import "./chunk-E2AWJ7KQ.js";
 import "./chunk-Z7L72ZHL.js";
 import "./chunk-4O4TKIXQ.js";
@@ -87,7 +87,7 @@ import "./chunk-YCVB7X56.js";
 import "./chunk-PQVCH2AE.js";
 import "./chunk-PJKTFXE2.js";
 import "./chunk-W5BIQOAJ.js";
-import "./chunk-466EGMFQ.js";
+import "./chunk-42KSEX6C.js";
 import "./chunk-YBA52OKG.js";
 import "./chunk-5LRV557D.js";
 import "./chunk-BT7NVCML.js";

package/dist/buffer.js

@@ -1,10 +1,10 @@
 import {
   SmartBuffer
-} from "./chunk-DUPHIZBY.js";
+} from "./chunk-PUDYANAX.js";
 import "./chunk-T5IF2ZCE.js";
 import "./chunk-H3FZVNRN.js";
-import "./chunk-LO76EF3Y.js";
-import "./chunk-PIN5OPBA.js";
+import "./chunk-7EJCAFMS.js";
+import "./chunk-LVU7FP27.js";
 import "./chunk-CSAKJVXW.js";
 import "./chunk-K2XUWZBM.js";
 import "./chunk-OD4FM2U7.js";

package/dist/calibration.js

@@ -4,18 +4,19 @@ import {
 import "./chunk-QW27DOHG.js";
 import {
   LocalLlmClient
-} from "./chunk-DYJHGJZ4.js";
-import "./chunk-QM2SPLKQ.js";
+} from "./chunk-FJJWA7NL.js";
+import "./chunk-MLED254J.js";
+import "./chunk-3VRMUNWL.js";
 import "./chunk-U4LUIE6Y.js";
 import "./chunk-JUXOTY6J.js";
 import "./chunk-TOTT6S2V.js";
 import {
   FallbackLlmClient
-} from "./chunk-TKC5LZ43.js";
+} from "./chunk-UIDWASOS.js";
 import "./chunk-I55KAVET.js";
 import "./chunk-L2EXJQJP.js";
 import "./chunk-45GF7Y3V.js";
-import "./chunk-EP6BA7VV.js";
+import "./chunk-CU5TILGD.js";
 import "./chunk-E2AWJ7KQ.js";
 import "./chunk-YBA52OKG.js";
 import {

package/dist/calibration.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/calibration.ts"],"sourcesContent":["/**\n * calibration.ts — Prediction-Error-Driven Model-User Calibration\n *\n * Analyzes patterns in user corrections to identify systematic miscalibration\n * between the model's predictions and the user's actual expectations.\n * During consolidation, replays chains of similar corrections through an LLM\n * to synthesize CalibrationRules that adjust model behavior for this specific user.\n *\n * Inspired by:\n * - Cerebellar motor calibration (prediction errors drive lasting adjustments)\n * - Temporal difference learning (dopamine signals prediction error)\n * - Tesla FSD shadow mode (divergence between prediction and reality = training signal)\n */\n\nimport { createHash } from \"node:crypto\";\nimport { mkdir, readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { resolveLocalLlmCapabilities } from \"./capabilities.js\";\nimport { OUTPUT_LANGUAGE_POLICY } from \"./extraction-prompt.js\";\nimport { FallbackLlmClient } from \"./fallback-llm.js\";\nimport { listJsonFiles } from \"./json-store.js\";\nimport { isMacOsReplicationJunkBasename } from \"./utils/macos-replication-junk.js\";\nimport { LocalLlmClient } from \"./local-llm.js\";\nimport { log } from \"./logger.js\";\nimport { writeFileAtomically } from \"./maintenance/atomic-file.js\";\nimport type { AgentPersonaModelConfig, GatewayConfig, PluginConfig } from \"./types.js\";\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\nexport interface CalibrationRule {\n  id: string;\n  ruleType: \"model_tendency\" | \"user_expectation\" | \"scope_boundary\" | \"verification_required\";\n  condition: string;\n  modelTendency: string;\n  userExpectation: string;\n  calibration: string;\n  confidence: number;\n  evidenceCount: number;\n  evidenceCorrectionIds: string[];\n  createdAt: string;\n  lastReinforcedAt: string;\n}\n\nexport interface CalibrationIndex {\n  rules: CalibrationRule[];\n  updatedAt: string;\n  totalCorrectionsAnalyzed: number;\n  /**\n   * Weeks whose rule reinforcement is already committed. A retry of any of\n   * these weeks must not increment `evidenceCount` again. Older indexes\n   * persisted a single `appliedWeekId`; reads fold it into this list.\n   */\n  appliedWeekIds?: string[];\n}\n\n// ─── Storage ─────────────────────────────────────────────────────────────────\n\nfunction calibrationDir(memoryDir: string): string {\n  return path.join(memoryDir, \"state\", \"calibration\");\n}\n\nfunction calibrationIndexPath(memoryDir: string): string {\n  return path.join(calibrationDir(memoryDir), \"calibration-index.json\");\n}\n\n/** Week ids are short (`YYYY-Www`). Longer values are not used as stamps. */\nconst MAX_APPLIED_WEEK_ID_LENGTH = 32;\n\nexport function appliedCalibrationWeekId(value: unknown): string | undefined {\n  if (typeof value !== \"string\") return undefined;\n  const trimmed = value.trim();\n  if (trimmed.length === 0 || trimmed.length > MAX_APPLIED_WEEK_ID_LENGTH) return undefined;\n  return trimmed;\n}\n\nexport async function readCalibrationIndex(memoryDir: string): Promise<CalibrationIndex> {\n  try {\n    const raw = JSON.parse(await readFile(calibrationIndexPath(memoryDir), \"utf8\"));\n    const appliedWeekIds = normalizeAppliedWeekIds(raw.appliedWeekIds, raw.appliedWeekId);\n    return {\n      rules: Array.isArray(raw.rules) ? raw.rules : [],\n      updatedAt: typeof raw.updatedAt === \"string\" ? raw.updatedAt : new Date().toISOString(),\n      totalCorrectionsAnalyzed: typeof raw.totalCorrectionsAnalyzed === \"number\" ? raw.totalCorrectionsAnalyzed : 0,\n      ...(appliedWeekIds.length > 0 ? { appliedWeekIds } : {}),\n    };\n  } catch {\n    return { rules: [], updatedAt: new Date().toISOString(), totalCorrectionsAnalyzed: 0 };\n  }\n}\n\nfunction normalizeAppliedWeekIds(list: unknown, additional: unknown): string[] {\n  const weeks: string[] = [];\n  if (Array.isArray(list)) {\n    for (const entry of list) {\n      const week = appliedCalibrationWeekId(entry);\n      if (week && !weeks.includes(week)) weeks.push(week);\n    }\n  }\n  const extra = appliedCalibrationWeekId(additional);\n  if (extra && !weeks.includes(extra)) weeks.push(extra);\n  return weeks;\n}\n\n/**\n * Attach the week stamp to the index that will be written with the reinforced\n * rules. The stamp and the evidence increment commit together. Every\n * previously applied week stays in the list so an out-of-order retry of an\n * older week is still recognized as already applied.\n */\nexport function withAppliedCalibrationWeek(\n  index: CalibrationIndex,\n  idempotencyKey: string | undefined,\n): CalibrationIndex {\n  const appliedWeekIds = normalizeAppliedWeekIds(index.appliedWeekIds, idempotencyKey);\n  return {\n    rules: index.rules,\n    updatedAt: index.updatedAt,\n    totalCorrectionsAnalyzed: index.totalCorrectionsAnalyzed,\n    ...(appliedWeekIds.length > 0 ? { appliedWeekIds } : {}),\n  };\n}\n\nasync function writeCalibrationIndex(memoryDir: string, index: CalibrationIndex): Promise<void> {\n  const dir = calibrationDir(memoryDir);\n  await mkdir(dir, { recursive: true });\n  const appliedWeekIds = normalizeAppliedWeekIds(index.appliedWeekIds, undefined);\n  const stamped: CalibrationIndex = {\n    rules: index.rules,\n    updatedAt: new Date().toISOString(),\n    totalCorrectionsAnalyzed: index.totalCorrectionsAnalyzed,\n    ...(appliedWeekIds.length > 0 ? { appliedWeekIds } : {}),\n  };\n  await writeFileAtomically(calibrationIndexPath(memoryDir), JSON.stringify(stamped, null, 2));\n}\n\n// ─── Correction Reading ──────────────────────────────────────────────────────\n\nexport interface CorrectionMemory {\n  id: string;\n  content: string;\n  created: string;\n  confidence: number;\n  entityRefs: string[];\n  tags: string[];\n}\n\nconst CALIBRATION_RULE_TYPES = new Set([\n  \"model_tendency\",\n  \"user_expectation\",\n  \"scope_boundary\",\n  \"verification_required\",\n]);\n\nfunction parseConfidence(value: unknown): number | undefined {\n  if (typeof value !== \"number\" || !Number.isFinite(value)) return undefined;\n  return Math.max(0, Math.min(1, value));\n}\n\nfunction parseEvidenceIds(value: unknown): string[] {\n  if (!Array.isArray(value)) return [];\n  return value.filter((item): item is string => typeof item === \"string\" && item.trim().length > 0);\n}\n\nfunction nonEmptyString(value: unknown): string | undefined {\n  if (typeof value !== \"string\") return undefined;\n  const trimmed = value.trim();\n  return trimmed.length > 0 ? trimmed : undefined;\n}\n\n/**\n * Exported for entity-contamination R-11 regression coverage (#682\n * PR 2/3 — codex review).  Tests can drive the real correction-reading\n * path instead of duplicating the regex inline, so calibration parser\n * regressions surface via the contamination suite.\n */\nexport async function readCalibrationCorrections(memoryDir: string): Promise<CorrectionMemory[]> {\n  return readCorrectionsImpl(memoryDir);\n}\n\nasync function readCorrections(memoryDir: string): Promise<CorrectionMemory[]> {\n  return readCorrectionsImpl(memoryDir);\n}\n\nasync function readCorrectionsImpl(memoryDir: string): Promise<CorrectionMemory[]> {\n  const correctionsDir = path.join(memoryDir, \"corrections\");\n  const files = await listJsonFiles(correctionsDir).catch(() => {\n    // Corrections might be in facts/ directories too\n    return [] as string[];\n  });\n\n  // Also scan facts directories for correction-category files\n  const factsDir = path.join(memoryDir, \"facts\");\n  try {\n    const { readdir } = await import(\"node:fs/promises\");\n    const dayDirs = (await readdir(factsDir)).filter((d: string) => /^\\d{4}-\\d{2}-\\d{2}$/.test(d));\n    for (const day of dayDirs) {\n      const dayPath = path.join(factsDir, day);\n      const dayFiles = (await readdir(dayPath))\n        .filter((f: string) => !isMacOsReplicationJunkBasename(f) && f.startsWith(\"correction-\") && f.endsWith(\".md\"))\n        .map((f: string) => path.join(dayPath, f));\n      files.push(...dayFiles);\n    }\n  } catch {\n    // facts dir might not exist\n  }\n\n  // Also check the dedicated corrections directory\n  try {\n    const { readdir } = await import(\"node:fs/promises\");\n    const corrFiles = (await readdir(correctionsDir))\n      .filter((f: string) => !isMacOsReplicationJunkBasename(f) && f.endsWith(\".md\"))\n      .map((f: string) => path.join(correctionsDir, f));\n    files.push(...corrFiles);\n  } catch {\n    // corrections dir might not exist\n  }\n\n  const corrections: CorrectionMemory[] = [];\n  const seen = new Set<string>();\n\n  for (const filePath of files) {\n    try {\n      const raw = await readFile(filePath, \"utf8\");\n\n      // Parse frontmatter\n      const fmMatch = raw.match(/^---\\n([\\s\\S]*?)\\n---\\n([\\s\\S]*)$/);\n      if (!fmMatch) continue;\n\n      const content = fmMatch[2].trim();\n      if (!content || content.length < 10) continue;\n\n      // Extract id from frontmatter\n      const idMatch = fmMatch[1].match(/^id:\\s*(.+)$/m);\n      const id = idMatch?.[1]?.trim() ?? path.basename(filePath, \".md\");\n\n      if (seen.has(id)) continue;\n      seen.add(id);\n\n      const confMatch = fmMatch[1].match(/^confidence:\\s*(.+)$/m);\n      const confidence = confMatch ? parseFloat(confMatch[1]) : 0.9;\n\n      const entityMatch = fmMatch[1].match(/^entityRef:\\s*(.+)$/m);\n      const entityRefs = entityMatch ? [entityMatch[1].trim()] : [];\n\n      corrections.push({ id, content, created: \"\", confidence, entityRefs, tags: [] });\n    } catch {\n      // skip unparseable files\n    }\n  }\n\n  return corrections;\n}\n\n// ─── LLM-Assisted Clustering and Replay ──────────────────────────────────────\n\nexport const CLUSTER_PROMPT = `You are analyzing user corrections to an AI assistant. Each correction represents a moment where the assistant's prediction of what the user wanted was WRONG.\n\nYour job: Group these corrections into clusters where the SAME TYPE of misunderstanding is happening. Then for each cluster, synthesize a CalibrationRule.\n\nA CalibrationRule describes:\n- condition: When does this type of mistake happen?\n- modelTendency: What does the model tend to assume or do wrong?\n- userExpectation: What does the user actually want instead?\n- calibration: How should the model adjust its behavior?\n- ruleType: One of \"model_tendency\", \"user_expectation\", \"scope_boundary\", \"verification_required\"\n\nFocus on PATTERNS, not individual corrections. A cluster needs at least 2 corrections to be worth a rule.\n${OUTPUT_LANGUAGE_POLICY}\n\nOutput valid JSON only:\n{\n  \"rules\": [\n    {\n      \"ruleType\": \"model_tendency\",\n      \"condition\": \"When discussing project scope or task boundaries\",\n      \"modelTendency\": \"The model tends to assume broader scope than the user intends\",\n      \"userExpectation\": \"The user prefers narrow, specific task definitions and wants to be asked before scope expansion\",\n      \"calibration\": \"When uncertain about scope, ask for clarification rather than assuming. Default to the narrower interpretation.\",\n      \"confidence\": 0.85,\n      \"evidenceIds\": [\"correction-id-1\", \"correction-id-2\"]\n    }\n  ]\n}`;\n\ninterface CalibrationChatClient {\n  chatCompletion(\n    messages: Array<{ role: \"system\" | \"user\" | \"assistant\"; content: string }>,\n    options?: {\n      temperature?: number;\n      maxTokens?: number;\n      agentId?: string;\n      modelChain?: AgentPersonaModelConfig;\n    }\n  ): Promise<{ content?: string | null } | null>;\n}\n\ninterface CalibrationLlmOptions {\n  gatewayConfig?: GatewayConfig;\n  gatewayAgentId?: string;\n  modelChain?: AgentPersonaModelConfig;\n  workspaceDir?: string;\n  /** Plugin config. Supplies `localLlm*` settings when the gateway chain is empty. */\n  pluginConfig?: PluginConfig;\n}\n\nfunction resolveCalibrationChatClient(options: CalibrationLlmOptions): CalibrationChatClient | null {\n  const gateway = new FallbackLlmClient(options.gatewayConfig, {\n    workspaceDir: options.workspaceDir,\n  });\n  if (gateway.isAvailable({ agentId: options.gatewayAgentId, modelChain: options.modelChain })) {\n    return gateway;\n  }\n  const pluginConfig = options.pluginConfig;\n  if (pluginConfig && resolveLocalLlmCapabilities(pluginConfig).localLlm) {\n    log.info(`[calibration] using configured local LLM (model=${pluginConfig.localLlmModel})`);\n    const local = new LocalLlmClient(pluginConfig);\n    return {\n      chatCompletion(messages, chatOptions) {\n        return local.chatCompletion(messages, {\n          temperature: chatOptions?.temperature,\n          maxTokens: chatOptions?.maxTokens,\n        });\n      },\n    };\n  }\n  log.warn(\"[calibration] no LLM available — skipping consolidation\");\n  return null;\n}\n\nexport async function synthesizeCalibrationRules(\n  corrections: CorrectionMemory[],\n  llm: CalibrationChatClient,\n  existingRules: CalibrationRule[],\n  agentId?: string,\n  modelChain?: AgentPersonaModelConfig\n): Promise<CalibrationRule[]> {\n  if (corrections.length < 2) return [];\n\n  // Format corrections for the LLM\n  const correctionText = corrections\n    .slice(0, 50) // limit to avoid huge prompts\n    .map((c, i) => `[${c.id}] ${c.content}`)\n    .join(\"\\n\\n\");\n\n  const existingRulesText =\n    existingRules.length > 0\n      ? `\\n\\nExisting calibration rules (avoid duplicating these):\\n${existingRules.map((r) => `- ${r.condition}: ${r.calibration}`).join(\"\\n\")}`\n      : \"\";\n\n  const response = await llm.chatCompletion(\n    [\n      { role: \"system\", content: CLUSTER_PROMPT },\n      {\n        role: \"user\",\n        content: `Here are ${corrections.length} corrections from this user:\\n\\n${correctionText}${existingRulesText}`,\n      },\n    ],\n    { temperature: 0.3, maxTokens: 3000, agentId, modelChain }\n  );\n\n  if (!response?.content) return [];\n\n  try {\n    let jsonStr = response.content.trim();\n    const fenceMatch = jsonStr.match(/```(?:json)?\\s*\\n?([\\s\\S]*?)\\n?\\s*```/);\n    if (fenceMatch) jsonStr = fenceMatch[1];\n\n    const parsed = JSON.parse(jsonStr);\n    if (!Array.isArray(parsed.rules)) return [];\n\n    const now = new Date().toISOString();\n    const rawRules: unknown[] = Array.isArray(parsed.rules) ? parsed.rules : [];\n    return rawRules\n      .map((r: unknown): CalibrationRule | undefined => {\n        if (!r || typeof r !== \"object\" || Array.isArray(r)) return undefined;\n        const raw = r as Record<string, unknown>;\n        const ruleType = nonEmptyString(raw.ruleType);\n        const condition = nonEmptyString(raw.condition);\n        const modelTendency = nonEmptyString(raw.modelTendency);\n        const calibration = nonEmptyString(raw.calibration);\n        const confidence = parseConfidence(raw.confidence);\n        if (\n          !ruleType ||\n          !CALIBRATION_RULE_TYPES.has(ruleType) ||\n          !condition ||\n          !modelTendency ||\n          !calibration ||\n          confidence === undefined\n        ) {\n          return undefined;\n        }\n        const evidenceCorrectionIds = parseEvidenceIds(raw.evidenceIds);\n        return {\n          id: `cal-${createHash(\"sha256\")\n            .update(condition + calibration)\n            .digest(\"hex\")\n            .slice(0, 12)}`,\n          ruleType: ruleType as CalibrationRule[\"ruleType\"],\n          condition,\n          modelTendency,\n          userExpectation: nonEmptyString(raw.userExpectation) ?? \"\",\n          calibration,\n          confidence,\n          evidenceCount: evidenceCorrectionIds.length,\n          evidenceCorrectionIds,\n          createdAt: now,\n          lastReinforcedAt: now,\n        };\n      })\n      .filter((rule): rule is CalibrationRule => !!rule);\n  } catch {\n    log.warn(\"[calibration] failed to parse LLM response\");\n    return [];\n  }\n}\n\n// ─── Recall Section ──────────────────────────────────────────────────────────\n\n/**\n * Build a recall section from calibration rules relevant to the current query.\n * Uses the LLM to select which rules apply to the current context.\n */\nexport function buildCalibrationRecallSection(\n  rules: CalibrationRule[],\n  query: string,\n  maxChars: number = 1200,\n): string | null {\n  if (rules.length === 0) return null;\n\n  // Simple relevance: include all rules (they're already filtered to this user)\n  // In production, could use embedding similarity to filter\n  const lines: string[] = [\n    \"## Model Calibration (learned from past corrections)\",\n    \"\",\n    \"Adjustments for this specific user, learned from patterns in their corrections:\",\n    \"\",\n  ];\n\n  let totalChars = lines.join(\"\\n\").length;\n\n  for (const rule of rules) {\n    const line = `- **${rule.condition}**: ${rule.modelTendency} → Instead: ${rule.calibration}`;\n    if (totalChars + line.length + 1 > maxChars) break;\n    lines.push(line);\n    totalChars += line.length + 1;\n  }\n\n  if (lines.length <= 4) return null;\n  lines.push(\"\");\n  return lines.join(\"\\n\");\n}\n\n// ─── Public API ──────────────────────────────────────────────────────────────\n\n/**\n * Options weekly compounding passes into calibration. Gateway agent and task\n * chain fields stay limited to `modelSource: \"gateway\"`. `pluginConfig` carries\n * the `localLlm*` settings used when that chain is empty.\n */\nexport function calibrationConsolidationInput(config: PluginConfig): {\n  memoryDir: string;\n  gatewayConfig?: GatewayConfig;\n  gatewayAgentId?: string;\n  modelChain?: AgentPersonaModelConfig;\n  workspaceDir?: string;\n  pluginConfig: PluginConfig;\n} {\n  const gateway = config.modelSource === \"gateway\";\n  return {\n    memoryDir: config.memoryDir,\n    gatewayConfig: config.gatewayConfig,\n    gatewayAgentId: gateway ? (config.gatewayAgentId || undefined) : undefined,\n    modelChain: gateway ? config.taskModelChain : undefined,\n    workspaceDir: config.workspaceDir,\n    pluginConfig: config,\n  };\n}\n\n/**\n * Run the full calibration pipeline:\n * 1. Read all corrections\n * 2. Send to LLM for clustering and rule synthesis\n * 3. Merge with existing rules\n * 4. Write updated index\n */\nexport async function runCalibrationConsolidation(options: {\n  memoryDir: string;\n  gatewayConfig?: GatewayConfig;\n  gatewayAgentId?: string;\n  modelChain?: AgentPersonaModelConfig;\n  workspaceDir?: string;\n  pluginConfig?: PluginConfig;\n  /**\n   * When set, a week whose reinforcement is already in the index is returned\n   * as-is. Weekly synthesis passes the ISO week id so a retry after a later\n   * artifact failure does not count the same corrections twice.\n   */\n  idempotencyKey?: string;\n}): Promise<CalibrationRule[]> {\n  try {\n    const idempotencyKey = appliedCalibrationWeekId(options.idempotencyKey);\n    const existingIndex = await readCalibrationIndex(options.memoryDir);\n    if (idempotencyKey && (existingIndex.appliedWeekIds ?? []).includes(idempotencyKey)) {\n      log.debug(`[calibration] week ${idempotencyKey} already applied — skipping`);\n      return existingIndex.rules;\n    }\n\n    const llm = resolveCalibrationChatClient(options);\n    if (!llm) return [];\n\n    const corrections = await readCorrections(options.memoryDir);\n    if (corrections.length < 3) {\n      log.info(`[calibration] only ${corrections.length} corrections — need at least 3`);\n      return [];\n    }\n\n    const newRules = await synthesizeCalibrationRules(\n      corrections,\n      llm,\n      existingIndex.rules,\n      options.gatewayAgentId,\n      options.modelChain\n    );\n    if (newRules.length === 0) {\n      log.info(\"[calibration] no new calibration rules synthesized\");\n      return existingIndex.rules;\n    }\n\n    // Merge: keep existing rules, add new ones (deduplicate by id)\n    const ruleMap = new Map(existingIndex.rules.map((r) => [r.id, r]));\n    for (const rule of newRules) {\n      if (ruleMap.has(rule.id)) {\n        // Reinforce existing rule\n        const existing = ruleMap.get(rule.id)!;\n        existing.lastReinforcedAt = new Date().toISOString();\n        existing.evidenceCount += rule.evidenceCount;\n        existing.confidence = Math.min(1, existing.confidence + 0.05);\n      } else {\n        ruleMap.set(rule.id, rule);\n      }\n    }\n\n    const allRules = [...ruleMap.values()];\n    await writeCalibrationIndex(options.memoryDir, withAppliedCalibrationWeek({\n      rules: allRules,\n      updatedAt: existingIndex.updatedAt,\n      totalCorrectionsAnalyzed: corrections.length,\n      appliedWeekIds: existingIndex.appliedWeekIds,\n    }, idempotencyKey));\n\n    log.debug(`[calibration] synthesized ${newRules.length} new rule(s), ${allRules.length} total`);\n    return allRules;\n  } catch (error) {\n    log.warn(\n      `[calibration] consolidation failed (non-fatal): ${error instanceof Error ? error.message : String(error)}`\n    );\n    return [];\n  }\n}\n\n/**\n * Standalone entry point for calibration consolidation that can be called\n * independently of weekly compounding. The compounding engine's\n * `synthesizeWeekly()` is one trigger, but orchestrators or periodic\n * maintenance jobs should call this directly so calibration is not gated\n * on weekly compounding being enabled.\n */\nexport async function runCalibrationIfEnabled(options: {\n  memoryDir: string;\n  calibrationEnabled: boolean;\n  gatewayConfig?: GatewayConfig;\n  gatewayAgentId?: string;\n  modelChain?: AgentPersonaModelConfig;\n  workspaceDir?: string;\n  pluginConfig?: PluginConfig;\n}): Promise<CalibrationRule[]> {\n  if (!options.calibrationEnabled) {\n    return [];\n  }\n  return runCalibrationConsolidation({\n    memoryDir: options.memoryDir,\n    gatewayConfig: options.gatewayConfig,\n    gatewayAgentId: options.gatewayAgentId,\n    modelChain: options.modelChain,\n    workspaceDir: options.workspaceDir,\n    pluginConfig: options.pluginConfig,\n  });\n}\n\n/**\n * Get calibration rules for recall injection.\n * Reads the pre-computed calibration index.\n */\nexport async function getCalibrationRulesForRecall(\n  memoryDir: string,\n): Promise<CalibrationRule[]> {\n  const index = await readCalibrationIndex(memoryDir);\n  return index.rules;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/calibration.ts"],"sourcesContent":["/**\n * calibration.ts — Prediction-Error-Driven Model-User Calibration\n *\n * Analyzes patterns in user corrections to identify systematic miscalibration\n * between the model's predictions and the user's actual expectations.\n * During consolidation, replays chains of similar corrections through an LLM\n * to synthesize CalibrationRules that adjust model behavior for this specific user.\n *\n * Inspired by:\n * - Cerebellar motor calibration (prediction errors drive lasting adjustments)\n * - Temporal difference learning (dopamine signals prediction error)\n * - Tesla FSD shadow mode (divergence between prediction and reality = training signal)\n */\n\nimport { createHash } from \"node:crypto\";\nimport { mkdir, readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { resolveLocalLlmCapabilities } from \"./capabilities.js\";\nimport { OUTPUT_LANGUAGE_POLICY } from \"./extraction-prompt.js\";\nimport { FallbackLlmClient } from \"./fallback-llm.js\";\nimport { listJsonFiles } from \"./json-store.js\";\nimport { isMacOsReplicationJunkBasename } from \"./utils/macos-replication-junk.js\";\nimport { LocalLlmClient } from \"./local-llm.js\";\nimport { log } from \"./logger.js\";\nimport { writeFileAtomically } from \"./maintenance/atomic-file.js\";\nimport type { AgentPersonaModelConfig, GatewayConfig, PluginConfig } from \"./types.js\";\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\nexport interface CalibrationRule {\n  id: string;\n  ruleType: \"model_tendency\" | \"user_expectation\" | \"scope_boundary\" | \"verification_required\";\n  condition: string;\n  modelTendency: string;\n  userExpectation: string;\n  calibration: string;\n  confidence: number;\n  evidenceCount: number;\n  evidenceCorrectionIds: string[];\n  createdAt: string;\n  lastReinforcedAt: string;\n}\n\nexport interface CalibrationIndex {\n  rules: CalibrationRule[];\n  updatedAt: string;\n  totalCorrectionsAnalyzed: number;\n  /**\n   * Weeks whose rule reinforcement is already committed. A retry of any of\n   * these weeks must not increment `evidenceCount` again. Older indexes\n   * persisted a single `appliedWeekId`; reads fold it into this list.\n   */\n  appliedWeekIds?: string[];\n}\n\n// ─── Storage ─────────────────────────────────────────────────────────────────\n\nfunction calibrationDir(memoryDir: string): string {\n  return path.join(memoryDir, \"state\", \"calibration\");\n}\n\nfunction calibrationIndexPath(memoryDir: string): string {\n  return path.join(calibrationDir(memoryDir), \"calibration-index.json\");\n}\n\n/** Week ids are short (`YYYY-Www`). Longer values are not used as stamps. */\nconst MAX_APPLIED_WEEK_ID_LENGTH = 32;\n\nexport function appliedCalibrationWeekId(value: unknown): string | undefined {\n  if (typeof value !== \"string\") return undefined;\n  const trimmed = value.trim();\n  if (trimmed.length === 0 || trimmed.length > MAX_APPLIED_WEEK_ID_LENGTH) return undefined;\n  return trimmed;\n}\n\nexport async function readCalibrationIndex(memoryDir: string): Promise<CalibrationIndex> {\n  try {\n    const raw = JSON.parse(await readFile(calibrationIndexPath(memoryDir), \"utf8\"));\n    const appliedWeekIds = normalizeAppliedWeekIds(raw.appliedWeekIds, raw.appliedWeekId);\n    return {\n      rules: Array.isArray(raw.rules) ? raw.rules : [],\n      updatedAt: typeof raw.updatedAt === \"string\" ? raw.updatedAt : new Date().toISOString(),\n      totalCorrectionsAnalyzed: typeof raw.totalCorrectionsAnalyzed === \"number\" ? raw.totalCorrectionsAnalyzed : 0,\n      ...(appliedWeekIds.length > 0 ? { appliedWeekIds } : {}),\n    };\n  } catch {\n    return { rules: [], updatedAt: new Date().toISOString(), totalCorrectionsAnalyzed: 0 };\n  }\n}\n\nfunction normalizeAppliedWeekIds(list: unknown, additional: unknown): string[] {\n  const weeks: string[] = [];\n  if (Array.isArray(list)) {\n    for (const entry of list) {\n      const week = appliedCalibrationWeekId(entry);\n      if (week && !weeks.includes(week)) weeks.push(week);\n    }\n  }\n  const extra = appliedCalibrationWeekId(additional);\n  if (extra && !weeks.includes(extra)) weeks.push(extra);\n  return weeks;\n}\n\n/**\n * Attach the week stamp to the index that will be written with the reinforced\n * rules. The stamp and the evidence increment commit together. Every\n * previously applied week stays in the list so an out-of-order retry of an\n * older week is still recognized as already applied.\n */\nexport function withAppliedCalibrationWeek(\n  index: CalibrationIndex,\n  idempotencyKey: string | undefined,\n): CalibrationIndex {\n  const appliedWeekIds = normalizeAppliedWeekIds(index.appliedWeekIds, idempotencyKey);\n  return {\n    rules: index.rules,\n    updatedAt: index.updatedAt,\n    totalCorrectionsAnalyzed: index.totalCorrectionsAnalyzed,\n    ...(appliedWeekIds.length > 0 ? { appliedWeekIds } : {}),\n  };\n}\n\nasync function writeCalibrationIndex(memoryDir: string, index: CalibrationIndex): Promise<void> {\n  const dir = calibrationDir(memoryDir);\n  await mkdir(dir, { recursive: true });\n  const appliedWeekIds = normalizeAppliedWeekIds(index.appliedWeekIds, undefined);\n  const stamped: CalibrationIndex = {\n    rules: index.rules,\n    updatedAt: new Date().toISOString(),\n    totalCorrectionsAnalyzed: index.totalCorrectionsAnalyzed,\n    ...(appliedWeekIds.length > 0 ? { appliedWeekIds } : {}),\n  };\n  await writeFileAtomically(calibrationIndexPath(memoryDir), JSON.stringify(stamped, null, 2));\n}\n\n// ─── Correction Reading ──────────────────────────────────────────────────────\n\nexport interface CorrectionMemory {\n  id: string;\n  content: string;\n  created: string;\n  confidence: number;\n  entityRefs: string[];\n  tags: string[];\n}\n\nconst CALIBRATION_RULE_TYPES = new Set([\n  \"model_tendency\",\n  \"user_expectation\",\n  \"scope_boundary\",\n  \"verification_required\",\n]);\n\nfunction parseConfidence(value: unknown): number | undefined {\n  if (typeof value !== \"number\" || !Number.isFinite(value)) return undefined;\n  return Math.max(0, Math.min(1, value));\n}\n\nfunction parseEvidenceIds(value: unknown): string[] {\n  if (!Array.isArray(value)) return [];\n  return value.filter((item): item is string => typeof item === \"string\" && item.trim().length > 0);\n}\n\nfunction nonEmptyString(value: unknown): string | undefined {\n  if (typeof value !== \"string\") return undefined;\n  const trimmed = value.trim();\n  return trimmed.length > 0 ? trimmed : undefined;\n}\n\n/**\n * Exported for entity-contamination R-11 regression coverage (#682\n * PR 2/3 — codex review).  Tests can drive the real correction-reading\n * path instead of duplicating the regex inline, so calibration parser\n * regressions surface via the contamination suite.\n */\nexport async function readCalibrationCorrections(memoryDir: string): Promise<CorrectionMemory[]> {\n  return readCorrectionsImpl(memoryDir);\n}\n\nasync function readCorrections(memoryDir: string): Promise<CorrectionMemory[]> {\n  return readCorrectionsImpl(memoryDir);\n}\n\nasync function readCorrectionsImpl(memoryDir: string): Promise<CorrectionMemory[]> {\n  const correctionsDir = path.join(memoryDir, \"corrections\");\n  const files = await listJsonFiles(correctionsDir).catch(() => {\n    // Corrections might be in facts/ directories too\n    return [] as string[];\n  });\n\n  // Also scan facts directories for correction-category files\n  const factsDir = path.join(memoryDir, \"facts\");\n  try {\n    const { readdir } = await import(\"node:fs/promises\");\n    const dayDirs = (await readdir(factsDir)).filter((d: string) => /^\\d{4}-\\d{2}-\\d{2}$/.test(d));\n    for (const day of dayDirs) {\n      const dayPath = path.join(factsDir, day);\n      const dayFiles = (await readdir(dayPath))\n        .filter((f: string) => !isMacOsReplicationJunkBasename(f) && f.startsWith(\"correction-\") && f.endsWith(\".md\"))\n        .map((f: string) => path.join(dayPath, f));\n      files.push(...dayFiles);\n    }\n  } catch {\n    // facts dir might not exist\n  }\n\n  // Also check the dedicated corrections directory\n  try {\n    const { readdir } = await import(\"node:fs/promises\");\n    const corrFiles = (await readdir(correctionsDir))\n      .filter((f: string) => !isMacOsReplicationJunkBasename(f) && f.endsWith(\".md\"))\n      .map((f: string) => path.join(correctionsDir, f));\n    files.push(...corrFiles);\n  } catch {\n    // corrections dir might not exist\n  }\n\n  const corrections: CorrectionMemory[] = [];\n  const seen = new Set<string>();\n\n  for (const filePath of files) {\n    try {\n      const raw = await readFile(filePath, \"utf8\");\n\n      // Parse frontmatter\n      const fmMatch = raw.match(/^---\\n([\\s\\S]*?)\\n---\\n([\\s\\S]*)$/);\n      if (!fmMatch) continue;\n\n      const content = fmMatch[2].trim();\n      if (!content || content.length < 10) continue;\n\n      // Extract id from frontmatter\n      const idMatch = fmMatch[1].match(/^id:\\s*(.+)$/m);\n      const id = idMatch?.[1]?.trim() ?? path.basename(filePath, \".md\");\n\n      if (seen.has(id)) continue;\n      seen.add(id);\n\n      const confMatch = fmMatch[1].match(/^confidence:\\s*(.+)$/m);\n      const confidence = confMatch ? parseFloat(confMatch[1]) : 0.9;\n\n      const entityMatch = fmMatch[1].match(/^entityRef:\\s*(.+)$/m);\n      const entityRefs = entityMatch ? [entityMatch[1].trim()] : [];\n\n      corrections.push({ id, content, created: \"\", confidence, entityRefs, tags: [] });\n    } catch {\n      // skip unparseable files\n    }\n  }\n\n  return corrections;\n}\n\n// ─── LLM-Assisted Clustering and Replay ──────────────────────────────────────\n\nexport const CLUSTER_PROMPT = `You are analyzing user corrections to an AI assistant. Each correction represents a moment where the assistant's prediction of what the user wanted was WRONG.\n\nYour job: Group these corrections into clusters where the SAME TYPE of misunderstanding is happening. Then for each cluster, synthesize a CalibrationRule.\n\nA CalibrationRule describes:\n- condition: When does this type of mistake happen?\n- modelTendency: What does the model tend to assume or do wrong?\n- userExpectation: What does the user actually want instead?\n- calibration: How should the model adjust its behavior?\n- ruleType: One of \"model_tendency\", \"user_expectation\", \"scope_boundary\", \"verification_required\"\n\nFocus on PATTERNS, not individual corrections. A cluster needs at least 2 corrections to be worth a rule.\n${OUTPUT_LANGUAGE_POLICY}\n\nOutput valid JSON only:\n{\n  \"rules\": [\n    {\n      \"ruleType\": \"model_tendency\",\n      \"condition\": \"When discussing project scope or task boundaries\",\n      \"modelTendency\": \"The model tends to assume broader scope than the user intends\",\n      \"userExpectation\": \"The user prefers narrow, specific task definitions and wants to be asked before scope expansion\",\n      \"calibration\": \"When uncertain about scope, ask for clarification rather than assuming. Default to the narrower interpretation.\",\n      \"confidence\": 0.85,\n      \"evidenceIds\": [\"correction-id-1\", \"correction-id-2\"]\n    }\n  ]\n}`;\n\ninterface CalibrationChatClient {\n  chatCompletion(\n    messages: Array<{ role: \"system\" | \"user\" | \"assistant\"; content: string }>,\n    options?: {\n      temperature?: number;\n      maxTokens?: number;\n      agentId?: string;\n      modelChain?: AgentPersonaModelConfig;\n    }\n  ): Promise<{ content?: string | null } | null>;\n}\n\ninterface CalibrationLlmOptions {\n  gatewayConfig?: GatewayConfig;\n  gatewayAgentId?: string;\n  modelChain?: AgentPersonaModelConfig;\n  workspaceDir?: string;\n  /** Plugin config. Supplies `localLlm*` settings when the gateway chain is empty. */\n  pluginConfig?: PluginConfig;\n}\n\nfunction resolveCalibrationChatClient(options: CalibrationLlmOptions): CalibrationChatClient | null {\n  const gateway = new FallbackLlmClient(options.gatewayConfig, {\n    workspaceDir: options.workspaceDir,\n  });\n  if (gateway.isAvailable({ agentId: options.gatewayAgentId, modelChain: options.modelChain })) {\n    return gateway;\n  }\n  const pluginConfig = options.pluginConfig;\n  if (pluginConfig && resolveLocalLlmCapabilities(pluginConfig).localLlm) {\n    log.info(`[calibration] using configured local LLM (model=${pluginConfig.localLlmModel})`);\n    const local = new LocalLlmClient(pluginConfig);\n    return {\n      chatCompletion(messages, chatOptions) {\n        return local.chatCompletion(messages, {\n          temperature: chatOptions?.temperature,\n          maxTokens: chatOptions?.maxTokens,\n        });\n      },\n    };\n  }\n  log.warn(\"[calibration] no LLM available — skipping consolidation\");\n  return null;\n}\n\nexport async function synthesizeCalibrationRules(\n  corrections: CorrectionMemory[],\n  llm: CalibrationChatClient,\n  existingRules: CalibrationRule[],\n  agentId?: string,\n  modelChain?: AgentPersonaModelConfig\n): Promise<CalibrationRule[]> {\n  if (corrections.length < 2) return [];\n\n  // Format corrections for the LLM\n  const correctionText = corrections\n    .slice(0, 50) // limit to avoid huge prompts\n    .map((c, i) => `[${c.id}] ${c.content}`)\n    .join(\"\\n\\n\");\n\n  const existingRulesText =\n    existingRules.length > 0\n      ? `\\n\\nExisting calibration rules (avoid duplicating these):\\n${existingRules.map((r) => `- ${r.condition}: ${r.calibration}`).join(\"\\n\")}`\n      : \"\";\n\n  const response = await llm.chatCompletion(\n    [\n      { role: \"system\", content: CLUSTER_PROMPT },\n      {\n        role: \"user\",\n        content: `Here are ${corrections.length} corrections from this user:\\n\\n${correctionText}${existingRulesText}`,\n      },\n    ],\n    { temperature: 0.3, maxTokens: 3000, agentId, modelChain }\n  );\n\n  if (!response?.content) return [];\n\n  try {\n    let jsonStr = response.content.trim();\n    const fenceMatch = jsonStr.match(/```(?:json)?\\s*\\n?([\\s\\S]*?)\\n?\\s*```/);\n    if (fenceMatch) jsonStr = fenceMatch[1];\n\n    const parsed = JSON.parse(jsonStr);\n    if (!Array.isArray(parsed.rules)) return [];\n\n    const now = new Date().toISOString();\n    const rawRules: unknown[] = Array.isArray(parsed.rules) ? parsed.rules : [];\n    return rawRules\n      .map((r: unknown): CalibrationRule | undefined => {\n        if (!r || typeof r !== \"object\" || Array.isArray(r)) return undefined;\n        const raw = r as Record<string, unknown>;\n        const ruleType = nonEmptyString(raw.ruleType);\n        const condition = nonEmptyString(raw.condition);\n        const modelTendency = nonEmptyString(raw.modelTendency);\n        const calibration = nonEmptyString(raw.calibration);\n        const confidence = parseConfidence(raw.confidence);\n        if (\n          !ruleType ||\n          !CALIBRATION_RULE_TYPES.has(ruleType) ||\n          !condition ||\n          !modelTendency ||\n          !calibration ||\n          confidence === undefined\n        ) {\n          return undefined;\n        }\n        const evidenceCorrectionIds = parseEvidenceIds(raw.evidenceIds);\n        return {\n          id: `cal-${createHash(\"sha256\")\n            .update(condition + calibration)\n            .digest(\"hex\")\n            .slice(0, 12)}`,\n          ruleType: ruleType as CalibrationRule[\"ruleType\"],\n          condition,\n          modelTendency,\n          userExpectation: nonEmptyString(raw.userExpectation) ?? \"\",\n          calibration,\n          confidence,\n          evidenceCount: evidenceCorrectionIds.length,\n          evidenceCorrectionIds,\n          createdAt: now,\n          lastReinforcedAt: now,\n        };\n      })\n      .filter((rule): rule is CalibrationRule => !!rule);\n  } catch {\n    log.warn(\"[calibration] failed to parse LLM response\");\n    return [];\n  }\n}\n\n// ─── Recall Section ──────────────────────────────────────────────────────────\n\n/**\n * Build a recall section from calibration rules relevant to the current query.\n * Uses the LLM to select which rules apply to the current context.\n */\nexport function buildCalibrationRecallSection(\n  rules: CalibrationRule[],\n  query: string,\n  maxChars: number = 1200,\n): string | null {\n  if (rules.length === 0) return null;\n\n  // Simple relevance: include all rules (they're already filtered to this user)\n  // In production, could use embedding similarity to filter\n  const lines: string[] = [\n    \"## Model Calibration (learned from past corrections)\",\n    \"\",\n    \"Adjustments for this specific user, learned from patterns in their corrections:\",\n    \"\",\n  ];\n\n  let totalChars = lines.join(\"\\n\").length;\n\n  for (const rule of rules) {\n    const line = `- **${rule.condition}**: ${rule.modelTendency} → Instead: ${rule.calibration}`;\n    if (totalChars + line.length + 1 > maxChars) break;\n    lines.push(line);\n    totalChars += line.length + 1;\n  }\n\n  if (lines.length <= 4) return null;\n  lines.push(\"\");\n  return lines.join(\"\\n\");\n}\n\n// ─── Public API ──────────────────────────────────────────────────────────────\n\n/**\n * Options weekly compounding passes into calibration. Gateway agent and task\n * chain fields stay limited to `modelSource: \"gateway\"`. `pluginConfig` carries\n * the `localLlm*` settings used when that chain is empty.\n */\nexport function calibrationConsolidationInput(config: PluginConfig): {\n  memoryDir: string;\n  gatewayConfig?: GatewayConfig;\n  gatewayAgentId?: string;\n  modelChain?: AgentPersonaModelConfig;\n  workspaceDir?: string;\n  pluginConfig: PluginConfig;\n} {\n  const gateway = config.modelSource === \"gateway\";\n  return {\n    memoryDir: config.memoryDir,\n    gatewayConfig: config.gatewayConfig,\n    gatewayAgentId: gateway ? (config.gatewayAgentId || undefined) : undefined,\n    modelChain: gateway ? config.taskModelChain : undefined,\n    workspaceDir: config.workspaceDir,\n    pluginConfig: config,\n  };\n}\n\n/**\n * Run the full calibration pipeline:\n * 1. Read all corrections\n * 2. Send to LLM for clustering and rule synthesis\n * 3. Merge with existing rules\n * 4. Write updated index\n */\nexport async function runCalibrationConsolidation(options: {\n  memoryDir: string;\n  gatewayConfig?: GatewayConfig;\n  gatewayAgentId?: string;\n  modelChain?: AgentPersonaModelConfig;\n  workspaceDir?: string;\n  pluginConfig?: PluginConfig;\n  /**\n   * When set, a week whose reinforcement is already in the index is returned\n   * as-is. Weekly synthesis passes the ISO week id so a retry after a later\n   * artifact failure does not count the same corrections twice.\n   */\n  idempotencyKey?: string;\n}): Promise<CalibrationRule[]> {\n  try {\n    const idempotencyKey = appliedCalibrationWeekId(options.idempotencyKey);\n    const existingIndex = await readCalibrationIndex(options.memoryDir);\n    if (idempotencyKey && (existingIndex.appliedWeekIds ?? []).includes(idempotencyKey)) {\n      log.debug(`[calibration] week ${idempotencyKey} already applied — skipping`);\n      return existingIndex.rules;\n    }\n\n    const llm = resolveCalibrationChatClient(options);\n    if (!llm) return [];\n\n    const corrections = await readCorrections(options.memoryDir);\n    if (corrections.length < 3) {\n      log.info(`[calibration] only ${corrections.length} corrections — need at least 3`);\n      return [];\n    }\n\n    const newRules = await synthesizeCalibrationRules(\n      corrections,\n      llm,\n      existingIndex.rules,\n      options.gatewayAgentId,\n      options.modelChain\n    );\n    if (newRules.length === 0) {\n      log.info(\"[calibration] no new calibration rules synthesized\");\n      return existingIndex.rules;\n    }\n\n    // Merge: keep existing rules, add new ones (deduplicate by id)\n    const ruleMap = new Map(existingIndex.rules.map((r) => [r.id, r]));\n    for (const rule of newRules) {\n      if (ruleMap.has(rule.id)) {\n        // Reinforce existing rule\n        const existing = ruleMap.get(rule.id)!;\n        existing.lastReinforcedAt = new Date().toISOString();\n        existing.evidenceCount += rule.evidenceCount;\n        existing.confidence = Math.min(1, existing.confidence + 0.05);\n      } else {\n        ruleMap.set(rule.id, rule);\n      }\n    }\n\n    const allRules = [...ruleMap.values()];\n    await writeCalibrationIndex(options.memoryDir, withAppliedCalibrationWeek({\n      rules: allRules,\n      updatedAt: existingIndex.updatedAt,\n      totalCorrectionsAnalyzed: corrections.length,\n      appliedWeekIds: existingIndex.appliedWeekIds,\n    }, idempotencyKey));\n\n    log.debug(`[calibration] synthesized ${newRules.length} new rule(s), ${allRules.length} total`);\n    return allRules;\n  } catch (error) {\n    log.warn(\n      `[calibration] consolidation failed (non-fatal): ${error instanceof Error ? error.message : String(error)}`\n    );\n    return [];\n  }\n}\n\n/**\n * Standalone entry point for calibration consolidation that can be called\n * independently of weekly compounding. The compounding engine's\n * `synthesizeWeekly()` is one trigger, but orchestrators or periodic\n * maintenance jobs should call this directly so calibration is not gated\n * on weekly compounding being enabled.\n */\nexport async function runCalibrationIfEnabled(options: {\n  memoryDir: string;\n  calibrationEnabled: boolean;\n  gatewayConfig?: GatewayConfig;\n  gatewayAgentId?: string;\n  modelChain?: AgentPersonaModelConfig;\n  workspaceDir?: string;\n  pluginConfig?: PluginConfig;\n}): Promise<CalibrationRule[]> {\n  if (!options.calibrationEnabled) {\n    return [];\n  }\n  return runCalibrationConsolidation({\n    memoryDir: options.memoryDir,\n    gatewayConfig: options.gatewayConfig,\n    gatewayAgentId: options.gatewayAgentId,\n    modelChain: options.modelChain,\n    workspaceDir: options.workspaceDir,\n    pluginConfig: options.pluginConfig,\n  });\n}\n\n/**\n * Get calibration rules for recall injection.\n * Reads the pre-computed calibration index.\n */\nexport async function getCalibrationRulesForRecall(\n  memoryDir: string,\n): Promise<CalibrationRule[]> {\n  const index = await readCalibrationIndex(memoryDir);\n  return index.rules;\n}\n"],"mappings":"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","names":[]}

package/dist/causal-consolidation.js

@@ -4,12 +4,12 @@ import {
 } from "./chunk-GZXXPCWJ.js";
 import {
   buildExtensionsBlockForConsolidation
-} from "./chunk-NFB5QTOH.js";
+} from "./chunk-GCZHKBY2.js";
 import "./chunk-5JMAGU26.js";
 import "./chunk-B7RWBZXW.js";
 import {
   runPostConsolidationMaterialize
-} from "./chunk-2C5YAVHA.js";
+} from "./chunk-JZIZBJCW.js";
 import "./chunk-3UXOZBHV.js";
 import "./chunk-PIWFNPQT.js";
 import "./chunk-TOTT6S2V.js";
@@ -19,7 +19,7 @@ import "./chunk-QDW3E4RD.js";
 import {
   resolveCausalTrajectoryStoreDir
 } from "./chunk-C2RW36YR.js";
-import "./chunk-D42L5SQF.js";
+import "./chunk-IHS2UGYM.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-TRMJ6BYC.js";
 import "./chunk-V4JZCTMK.js";
@@ -40,11 +40,11 @@ import "./chunk-A7Q43EUZ.js";
 import "./chunk-S2V7RUCL.js";
 import "./chunk-PPUNC7UX.js";
 import "./chunk-X3724WL4.js";
-import "./chunk-MRPOZBJC.js";
 import "./chunk-S2HLHAZ4.js";
+import "./chunk-MRPOZBJC.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
-import "./chunk-2DT7PIDZ.js";
+import "./chunk-EPOYPPOW.js";
 import "./chunk-AAD2ZS6P.js";
 import "./chunk-FF6N7BXC.js";
 import "./chunk-JNIVZNIB.js";
@@ -75,13 +75,13 @@ import "./chunk-42JKGUFJ.js";
 import "./chunk-23G5P7TA.js";
 import {
   FallbackLlmClient
-} from "./chunk-TKC5LZ43.js";
+} from "./chunk-UIDWASOS.js";
 import "./chunk-I55KAVET.js";
 import "./chunk-L2EXJQJP.js";
 import "./chunk-45GF7Y3V.js";
 import {
   fallbackLlmRuntimeContextFromConfig
-} from "./chunk-EP6BA7VV.js";
+} from "./chunk-CU5TILGD.js";
 import "./chunk-E2AWJ7KQ.js";
 import "./chunk-Z7L72ZHL.js";
 import "./chunk-4O4TKIXQ.js";
@@ -89,7 +89,7 @@ import "./chunk-YCVB7X56.js";
 import "./chunk-PQVCH2AE.js";
 import "./chunk-PJKTFXE2.js";
 import "./chunk-W5BIQOAJ.js";
-import "./chunk-466EGMFQ.js";
+import "./chunk-42KSEX6C.js";
 import "./chunk-YBA52OKG.js";
 import "./chunk-5LRV557D.js";
 import "./chunk-BT7NVCML.js";

package/dist/{chunk-AAQA6ZUP.js → chunk-23ZLN5X6.js}

@@ -33,9 +33,20 @@ var EXTRACTION_PROVIDER_JSON_SCHEMA_WITHOUT_SPAN = omitFactSpan(
 function extractionProviderJsonSchema(spanMode = "off") {
   return spanMode === "off" ? EXTRACTION_PROVIDER_JSON_SCHEMA_WITHOUT_SPAN : EXTRACTION_PROVIDER_JSON_SCHEMA_WITH_SPAN;
 }
+function extractionProviderResponseFormat(spanMode = "off") {
+  return {
+    type: "json_schema",
+    json_schema: {
+      name: "extraction_result",
+      schema: extractionProviderJsonSchema(spanMode),
+      strict: false
+    }
+  };
+}
 
 export {
   applySpanMode,
-  extractionProviderJsonSchema
+  extractionProviderJsonSchema,
+  extractionProviderResponseFormat
 };
-//# sourceMappingURL=chunk-AAQA6ZUP.js.map
+//# sourceMappingURL=chunk-23ZLN5X6.js.map

package/dist/{chunk-AAQA6ZUP.js.map → chunk-23ZLN5X6.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/extraction-span-wire.ts"],"sourcesContent":["/**\n * Extraction seam for span mode (issue #2333 leftover slice + #2952).\n *\n * Default off. Callers pass `enabled` to `applySpanMode`. The provider JSON\n * schema is mode-aware so off-mode structured output cannot advertise `span`.\n */\n\nimport { zodToJsonSchema } from \"zod-to-json-schema\";\nimport type { ExtractionSpanConfig } from \"./extraction-span-config.js\";\nimport { parseSpanOffsets, type ParsedSpan } from \"./extraction-span.js\";\nimport { ExtractionProviderOutputSchema } from \"./schemas.js\";\n\nexport function applySpanMode(opts: {\n  enabled?: boolean | 0 | 1;\n  text: string;\n  start: number;\n  end: number;\n}): ParsedSpan {\n  return parseSpanOffsets(opts.text, { start: opts.start, end: opts.end }, opts.enabled);\n}\n\nconst JSON_SCHEMA_OPTS = { $refStrategy: \"none\" as const, effectStrategy: \"input\" as const };\n\nconst EXTRACTION_PROVIDER_JSON_SCHEMA_WITH_SPAN = zodToJsonSchema(\n  ExtractionProviderOutputSchema,\n  JSON_SCHEMA_OPTS,\n) as Record<string, unknown>;\n\ntype FactItems = {\n  properties?: Record<string, unknown>;\n  required?: string[];\n};\n\nfunction omitFactSpan(schema: Record<string, unknown>): Record<string, unknown> {\n  const clone = structuredClone(schema) as {\n    properties?: { facts?: { items?: FactItems } };\n  };\n  const items = clone.properties?.facts?.items;\n  if (!items?.properties || !(\"span\" in items.properties)) {\n    throw new Error(\"extraction provider schema is missing facts.items.properties.span\");\n  }\n  delete items.properties.span;\n  if (Array.isArray(items.required)) {\n    items.required = items.required.filter((key) => key !== \"span\");\n  }\n  return clone as Record<string, unknown>;\n}\n\nconst EXTRACTION_PROVIDER_JSON_SCHEMA_WITHOUT_SPAN = omitFactSpan(\n  EXTRACTION_PROVIDER_JSON_SCHEMA_WITH_SPAN,\n);\n\n/** Provider JSON schema: `span` is present in on/shadow, absent in off. */\nexport function extractionProviderJsonSchema(\n  spanMode: ExtractionSpanConfig[\"spanMode\"] = \"off\",\n): Record<string, unknown> {\n  return spanMode === \"off\"\n    ? EXTRACTION_PROVIDER_JSON_SCHEMA_WITHOUT_SPAN\n    : EXTRACTION_PROVIDER_JSON_SCHEMA_WITH_SPAN;\n}\n"],"mappings":";;;;;;;;AAOA,SAAS,uBAAuB;AAKzB,SAAS,cAAc,MAKf;AACb,SAAO,iBAAiB,KAAK,MAAM,EAAE,OAAO,KAAK,OAAO,KAAK,KAAK,IAAI,GAAG,KAAK,OAAO;AACvF;AAEA,IAAM,mBAAmB,EAAE,cAAc,QAAiB,gBAAgB,QAAiB;AAE3F,IAAM,4CAA4C;AAAA,EAChD;AAAA,EACA;AACF;AAOA,SAAS,aAAa,QAA0D;AAC9E,QAAM,QAAQ,gBAAgB,MAAM;AAGpC,QAAM,QAAQ,MAAM,YAAY,OAAO;AACvC,MAAI,CAAC,OAAO,cAAc,EAAE,UAAU,MAAM,aAAa;AACvD,UAAM,IAAI,MAAM,mEAAmE;AAAA,EACrF;AACA,SAAO,MAAM,WAAW;AACxB,MAAI,MAAM,QAAQ,MAAM,QAAQ,GAAG;AACjC,UAAM,WAAW,MAAM,SAAS,OAAO,CAAC,QAAQ,QAAQ,MAAM;AAAA,EAChE;AACA,SAAO;AACT;AAEA,IAAM,+CAA+C;AAAA,EACnD;AACF;AAGO,SAAS,6BACd,WAA6C,OACpB;AACzB,SAAO,aAAa,QAChB,+CACA;AACN;","names":[]}
+{"version":3,"sources":["../src/extraction-span-wire.ts"],"sourcesContent":["/**\n * Extraction seam for span mode (issue #2333 leftover slice + #2952).\n *\n * Default off. Callers pass `enabled` to `applySpanMode`. The provider JSON\n * schema is mode-aware so off-mode structured output cannot advertise `span`.\n */\n\nimport { zodToJsonSchema } from \"zod-to-json-schema\";\nimport type { ExtractionSpanConfig } from \"./extraction-span-config.js\";\nimport { parseSpanOffsets, type ParsedSpan } from \"./extraction-span.js\";\nimport { ExtractionProviderOutputSchema } from \"./schemas.js\";\n\nexport function applySpanMode(opts: {\n  enabled?: boolean | 0 | 1;\n  text: string;\n  start: number;\n  end: number;\n}): ParsedSpan {\n  return parseSpanOffsets(opts.text, { start: opts.start, end: opts.end }, opts.enabled);\n}\n\nconst JSON_SCHEMA_OPTS = { $refStrategy: \"none\" as const, effectStrategy: \"input\" as const };\n\nconst EXTRACTION_PROVIDER_JSON_SCHEMA_WITH_SPAN = zodToJsonSchema(\n  ExtractionProviderOutputSchema,\n  JSON_SCHEMA_OPTS,\n) as Record<string, unknown>;\n\ntype FactItems = {\n  properties?: Record<string, unknown>;\n  required?: string[];\n};\n\nfunction omitFactSpan(schema: Record<string, unknown>): Record<string, unknown> {\n  const clone = structuredClone(schema) as {\n    properties?: { facts?: { items?: FactItems } };\n  };\n  const items = clone.properties?.facts?.items;\n  if (!items?.properties || !(\"span\" in items.properties)) {\n    throw new Error(\"extraction provider schema is missing facts.items.properties.span\");\n  }\n  delete items.properties.span;\n  if (Array.isArray(items.required)) {\n    items.required = items.required.filter((key) => key !== \"span\");\n  }\n  return clone as Record<string, unknown>;\n}\n\nconst EXTRACTION_PROVIDER_JSON_SCHEMA_WITHOUT_SPAN = omitFactSpan(\n  EXTRACTION_PROVIDER_JSON_SCHEMA_WITH_SPAN,\n);\n\n/** Provider JSON schema: `span` is present in on/shadow, absent in off. */\nexport function extractionProviderJsonSchema(\n  spanMode: ExtractionSpanConfig[\"spanMode\"] = \"off\",\n): Record<string, unknown> {\n  return spanMode === \"off\"\n    ? EXTRACTION_PROVIDER_JSON_SCHEMA_WITHOUT_SPAN\n    : EXTRACTION_PROVIDER_JSON_SCHEMA_WITH_SPAN;\n}\n\nexport function extractionProviderResponseFormat(spanMode: ExtractionSpanConfig[\"spanMode\"] = \"off\") {\n  return {\n    type: \"json_schema\" as const,\n    json_schema: {\n      name: \"extraction_result\",\n      schema: extractionProviderJsonSchema(spanMode),\n      strict: false,\n    },\n  };\n}\n"],"mappings":";;;;;;;;AAOA,SAAS,uBAAuB;AAKzB,SAAS,cAAc,MAKf;AACb,SAAO,iBAAiB,KAAK,MAAM,EAAE,OAAO,KAAK,OAAO,KAAK,KAAK,IAAI,GAAG,KAAK,OAAO;AACvF;AAEA,IAAM,mBAAmB,EAAE,cAAc,QAAiB,gBAAgB,QAAiB;AAE3F,IAAM,4CAA4C;AAAA,EAChD;AAAA,EACA;AACF;AAOA,SAAS,aAAa,QAA0D;AAC9E,QAAM,QAAQ,gBAAgB,MAAM;AAGpC,QAAM,QAAQ,MAAM,YAAY,OAAO;AACvC,MAAI,CAAC,OAAO,cAAc,EAAE,UAAU,MAAM,aAAa;AACvD,UAAM,IAAI,MAAM,mEAAmE;AAAA,EACrF;AACA,SAAO,MAAM,WAAW;AACxB,MAAI,MAAM,QAAQ,MAAM,QAAQ,GAAG;AACjC,UAAM,WAAW,MAAM,SAAS,OAAO,CAAC,QAAQ,QAAQ,MAAM;AAAA,EAChE;AACA,SAAO;AACT;AAEA,IAAM,+CAA+C;AAAA,EACnD;AACF;AAGO,SAAS,6BACd,WAA6C,OACpB;AACzB,SAAO,aAAa,QAChB,+CACA;AACN;AAEO,SAAS,iCAAiC,WAA6C,OAAO;AACnG,SAAO;AAAA,IACL,MAAM;AAAA,IACN,aAAa;AAAA,MACX,MAAM;AAAA,MACN,QAAQ,6BAA6B,QAAQ;AAAA,MAC7C,QAAQ;AAAA,IACV;AAAA,EACF;AACF;","names":[]}

package/dist/{chunk-OFQOOLQQ.js → chunk-27LPB4NS.js}

@@ -1,7 +1,7 @@
 import {
   SupportPassportError,
   getOperation
-} from "./chunk-CA2R2AD4.js";
+} from "./chunk-L3IP56F4.js";
 import {
   abortError,
   isAbortError
@@ -499,4 +499,4 @@ export {
   buildSupportPassportPublicRequestHandler,
   composeSupportPassportExternalRequestHandlers
 };
-//# sourceMappingURL=chunk-OFQOOLQQ.js.map
+//# sourceMappingURL=chunk-27LPB4NS.js.map

package/dist/{chunk-YW4ZYASS.js → chunk-27SAUQ5R.js}

@@ -1,6 +1,6 @@
 import {
   resolveCorpusNamespaceRoots
-} from "./chunk-VVSPHTSU.js";
+} from "./chunk-JHQAXATW.js";
 import {
   capabilityAllowsNamespace
 } from "./chunk-IG747LRN.js";
@@ -200,4 +200,4 @@ async function readAggregateExtractionWatermark(options) {
 export {
   readAggregateExtractionWatermark
 };
-//# sourceMappingURL=chunk-YW4ZYASS.js.map
+//# sourceMappingURL=chunk-27SAUQ5R.js.map

package/dist/{chunk-2JGBX5XY.js → chunk-2HLMFRZ7.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-KJTKLXTH.js";
 import {
   StorageManager
-} from "./chunk-D42L5SQF.js";
+} from "./chunk-IHS2UGYM.js";
 import {
   assertInjectedStorageRooted
 } from "./chunk-P55FACBG.js";
@@ -260,4 +260,4 @@ export {
   backupExistingLedger,
   rebuildMemoryLifecycleLedger
 };
-//# sourceMappingURL=chunk-2JGBX5XY.js.map
+//# sourceMappingURL=chunk-2HLMFRZ7.js.map

package/dist/{chunk-DJMGVSST.js → chunk-33UAWCBN.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-TBBDFYXW.js";
 import {
   StorageManager
-} from "./chunk-D42L5SQF.js";
+} from "./chunk-IHS2UGYM.js";
 import {
   bumpMemoryCorpusVersionForDir
 } from "./chunk-M5GVCJSJ.js";
@@ -769,4 +769,4 @@ export {
   listMemoryGovernanceRuns,
   readMemoryGovernanceRunArtifact
 };
-//# sourceMappingURL=chunk-DJMGVSST.js.map
+//# sourceMappingURL=chunk-33UAWCBN.js.map

package/dist/{chunk-UHBZK3CK.js → chunk-36DZ242S.js}

@@ -1,6 +1,6 @@
 import {
   rebuildMemoryProjection
-} from "./chunk-6VWCL2IZ.js";
+} from "./chunk-JX32ROLZ.js";
 
 // src/convergence-refresh.ts
 async function refreshConvergedNamespaces(namespaces, namespaceSearchRouter, getStorage, searchEnabled) {
@@ -32,4 +32,4 @@ async function refreshConvergedNamespaces(namespaces, namespaceSearchRouter, get
 export {
   refreshConvergedNamespaces
 };
-//# sourceMappingURL=chunk-UHBZK3CK.js.map
+//# sourceMappingURL=chunk-36DZ242S.js.map