kenaz 0.3.9 → 0.3.11

package/core/.collaboration/core/task-api.test.js

@@ -17,11 +17,10 @@ const assert = require('assert');
 const fs = require('fs').promises;
 const path = require('path');
 const os = require('os');
-const { TaskAPI, CONFIG, parseYAML, toYAML, loadAlayaGate, echoAlayaLessons } = require('./task-api.js');
+const { TaskAPI, CONFIG, parseYAML, toYAML } = require('./task-api.js');
 // TASK_2104: same shared gate task-api.js loads at runtime — used here only
 // to read its constants for assertions (query building + gate behavior
 // itself is covered by prompt.test.js against the one implementation).
-const alayaGate = require('../../.formation/tools/alaya-gate.js');
 
 // ============================================================================
 // 測試工具
@@ -1129,140 +1128,4 @@ runner.test('shared-mode: id_alloc stamp on task when local_fallback', async ()
 });
 
 
-// ============================================================================
-// 測試案例: TASK_1992 — Alaya process-lessons echo (create command)
-// ============================================================================
-
-/**
- * Captures console.log calls made during fn() and returns them as an array
- * of joined-argument strings, restoring console.log afterward.
- */
-async function captureLogs(fn) {
-  const original = console.log;
-  const logs = [];
-  console.log = (...a) => logs.push(a.join(' '));
-  try {
-    await fn();
-  } finally {
-    console.log = original;
-  }
-  return logs;
-}
-
-function mcpTextResponse(bodyObj) {
-  return {
-    ok: true,
-    json: async () => ({
-      jsonrpc: '2.0', id: 1,
-      result: { content: [{ type: 'text', text: JSON.stringify(bodyObj) }] },
-    }),
-  };
-}
-
-const ALAYA_TASK_DATA = { title: 'Fix appendCortexContext dedup bug', scope_paths: ['.formation/tools/prompt.js'] };
-
-runner.test('alaya-gate buildTaskContextQuery (shared with prompt.js): builds a query from title + scope_paths, null when empty', () => {
-  const q = alayaGate.buildTaskContextQuery(ALAYA_TASK_DATA);
-  assert.ok(q && q.includes('prompt'));
-  assert.strictEqual(alayaGate.buildTaskContextQuery({}), null);
-});
-
-runner.test('echoAlayaLessons: requests the candidate pool with min_cosine, prints up to 3 gated seeds from a mocked fetch', async () => {
-  let calledUrl = null;
-  let calledOpts = null;
-  const fetchMock = async (url, opts) => {
-    calledUrl = url;
-    calledOpts = opts;
-    return mcpTextResponse({
-      // js/.formation stack overlap with ALAYA_TASK_DATA's scope_paths, and
-      // cosine clears ALAYA_MIN_COSINE_DEFAULT — both must pass the gate.
-      bijas: [
-        { id: 'a1', seed_type: 'failure_seed', origin: 'local', content: 'Root cause one.', cosine: 0.75, tags: 'js' },
-        { id: 'a2', seed_type: 'lesson_seed', origin: 'remote', content: 'Lesson two.', cosine: 0.72, tags: 'js' },
-      ],
-      mode_effective: 'hybrid',
-    });
-  };
-
-  const logs = await captureLogs(() => echoAlayaLessons(ALAYA_TASK_DATA, fetchMock));
-
-  assert.strictEqual(calledUrl, 'http://127.0.0.1:18080/api/mcp');
-  const body = JSON.parse(calledOpts.body);
-  assert.strictEqual(body.params.name, 'alaya_recall');
-  assert.strictEqual(body.params.arguments.mode, 'hybrid');
-  assert.deepStrictEqual(body.params.arguments.seed_types, ['failure_seed', 'lesson_seed']);
-  assert.strictEqual(body.params.arguments.limit, alayaGate.ALAYA_CANDIDATE_POOL);
-  assert.strictEqual(body.params.arguments.min_cosine, alayaGate.ALAYA_MIN_COSINE_DEFAULT);
-
-  assert.ok(logs.some(l => l.includes('Alaya lessons for this card:')));
-  assert.ok(logs.some(l => l.includes('[failure_seed/local] Root cause one.')));
-  assert.ok(logs.some(l => l.includes('[lesson_seed/remote] Lesson two.')));
-});
-
-runner.test('echoAlayaLessons: TASK_2104 gate drops a below-floor bija and never prints it', async () => {
-  const fetchMock = async () => mcpTextResponse({
-    bijas: [
-      // Below ALAYA_MIN_COSINE_DEFAULT (0.70) — must be dropped even though
-      // it stack-matches (tags: 'js') and would render fine otherwise.
-      { id: 'b1', seed_type: 'failure_seed', origin: 'local', content: 'Stale noise seed.', cosine: 0.5, tags: 'js' },
-    ],
-    mode_effective: 'hybrid',
-  });
-  const logs = await captureLogs(() => echoAlayaLessons(ALAYA_TASK_DATA, fetchMock));
-  assert.strictEqual(logs.length, 0, 'a below-floor bija must print nothing, not fall back to ungated output');
-});
-
-runner.test('echoAlayaLessons: TASK_2104 gate keeps an above-floor stack-matching bija', async () => {
-  const fetchMock = async () => mcpTextResponse({
-    bijas: [
-      { id: 'c1', seed_type: 'lesson_seed', origin: 'local', content: 'On-topic lesson.', cosine: 0.8, tags: 'js' },
-    ],
-    mode_effective: 'hybrid',
-  });
-  const logs = await captureLogs(() => echoAlayaLessons(ALAYA_TASK_DATA, fetchMock));
-  assert.ok(logs.some(l => l.includes('[lesson_seed/local] On-topic lesson.')));
-});
-
-runner.test('echoAlayaLessons: gate module unavailable (e.g. sub-project with no .formation/) silently skips, never falls back to ungated output', async () => {
-  let fetchCalled = false;
-  const fetchMock = async () => { fetchCalled = true; return mcpTextResponse({ bijas: [{ id: 'd1', seed_type: 'failure_seed', origin: 'local', content: 'never printed' }] }); };
-  const logs = await captureLogs(() => echoAlayaLessons(ALAYA_TASK_DATA, fetchMock, null));
-  assert.strictEqual(logs.length, 0);
-  assert.strictEqual(fetchCalled, false, 'must return before ever calling fetch when the gate cannot be loaded');
-});
-
-runner.test('echoAlayaLessons: silent when fetch rejects (network error / timeout)', async () => {
-  const fetchMock = async () => { throw new Error('AbortError: The operation was aborted'); };
-  const logs = await captureLogs(() => echoAlayaLessons(ALAYA_TASK_DATA, fetchMock));
-  assert.strictEqual(logs.length, 0);
-});
-
-runner.test('echoAlayaLessons: silent when fetch resolves non-ok', async () => {
-  const fetchMock = async () => ({ ok: false, status: 500 });
-  const logs = await captureLogs(() => echoAlayaLessons(ALAYA_TASK_DATA, fetchMock));
-  assert.strictEqual(logs.length, 0);
-});
-
-runner.test('echoAlayaLessons: silent when the MCP result has zero bijas', async () => {
-  const fetchMock = async () => mcpTextResponse({ bijas: [], mode_effective: 'hybrid' });
-  const logs = await captureLogs(() => echoAlayaLessons(ALAYA_TASK_DATA, fetchMock));
-  assert.strictEqual(logs.length, 0);
-});
-
-runner.test('echoAlayaLessons: KENAZ_NO_ALAYA_ECHO=1 suppresses the echo entirely (fetch never called)', async () => {
-  let fetchCalled = false;
-  const fetchMock = async () => { fetchCalled = true; return mcpTextResponse({ bijas: [{ id: 'x', seed_type: 'failure_seed', origin: 'local', content: 'never printed' }] }); };
-
-  const prev = process.env.KENAZ_NO_ALAYA_ECHO;
-  process.env.KENAZ_NO_ALAYA_ECHO = '1';
-  try {
-    const logs = await captureLogs(() => echoAlayaLessons(ALAYA_TASK_DATA, fetchMock));
-    assert.strictEqual(logs.length, 0);
-    assert.strictEqual(fetchCalled, false);
-  } finally {
-    if (prev === undefined) delete process.env.KENAZ_NO_ALAYA_ECHO;
-    else process.env.KENAZ_NO_ALAYA_ECHO = prev;
-  }
-});
-
 runner.run();

package/core/.formation/bifrost/launch.js

@@ -276,7 +276,7 @@ function renderMemoryStartupDoc() {
 
 function renderOverride(prompt, bootContext, { policy = BOOT_POLICY, projectPath = PROJECT_PATH, memoryStartupDoc = '' } = {}) {
   const projectInstruction = projectPath
-    ? `You are working on sub-project: ${projectPath}\nAll task-api.js commands must include --project-path="${projectPath}".\nAll MCP tool calls (synapse_*, hippocampus_*, etc.) must include projectPath="${projectPath}".\n\n`
+    ? `You are working on sub-project: ${projectPath}\nAll task-api.js commands must include --project-path="${projectPath}".\nAll MCP tool calls (kenaz_*) must include projectPath="${projectPath}".\n\n`
     : '';
   const codexDdxInjection = renderCodexAntiDrift();
 
@@ -491,7 +491,7 @@ async function main() {
     ? runFastBoot()
     : await fetchBootContext({ specialist: SPECIALIST, projectRoot: ROOT, projectPath: PROJECT_PATH || ROOT, includeCanary: false });
   const offlineNote = probe.reachable ? ''
-    : '# Boot context availability\nInitial Kenaz MCP probe failed; live recall availability is not established. Local fast boot context is not proof of a successful synapse_status check.\n\n';
+    : '# Boot context availability\nInitial Kenaz MCP probe failed; server availability is not established. Local fast boot context is not proof of a successful kenaz_ping check.\n\n';
   writeOverride(prompt, offlineNote + bootCtx);
   // ── SessionStart hook (TASK_1230) ─────────────────────────────────────────
   // Fires after prompt is written (AGENTS.override.md exists) but before Codex

package/core/.formation/bifrost/launch.test.js

@@ -23,7 +23,7 @@ function mockRequest(scenario = 'offline') {
       if (scenario === 'incomplete') { res.complete = false; res.emit('close'); return; }
       if (scenario === 'oversized') { res.emit('data', 'x'.repeat(1024 * 1024 + 1)); return; }
       const body = {
-        ok: JSON.stringify({ jsonrpc: '2.0', id: 1, result: { tools: [{ name: 'synapse_status' }] } }),
+        ok: JSON.stringify({ jsonrpc: '2.0', id: 1, result: { tools: [{ name: 'kenaz_ping' }] } }),
         malformed: '{', empty: '{"result":{"tools":[]}}',
         'rpc-error': '{"error":{"code":-1}}', null: 'null',
       }[scenario] || '{}';
@@ -135,7 +135,7 @@ test('offline default Ansuz continues once with elixir, truthful status and pinn
   assert.deepEqual(Array.from(effects.promptCalls[0].args.slice(-2)), ['--project-path', project]);
   assert.ok(effects.promptCalls[0].args.includes('--external-boot-context'));
   const override = effects.writes.find(write => write.name.endsWith('AGENTS.override.md'));
-  assert.match(override.content, /live recall availability is not established/);
+  assert.match(override.content, /server availability is not established/);
   assert.match(override.content, /Fixture fast context banner/);
   assert.equal((override.content.match(/## Codex Bootstrap Policy \(fast\)/g) || []).length, 1);
   assert.ok(override.content.includes(`projectPath="${project}"`));

package/core/.formation/bifrost/shared/ansuz-boot-policy.js

@@ -18,13 +18,13 @@ function resolveBootPolicy({ specialist = 'Ansuz', depth, bootMode, full = false
 function renderBootstrap({ policy, projectPath, port = '18080', contextual = false } = {}) {
   const fast = [
     'Ansuz fast boot (elixir) is the default. This bootstrap policy supersedes any older instruction to run Phase 0, including the Phase 0 sentence inside elixir.',
-    'Check synapse_status with the active projectPath when available. If unavailable, report that memory is unavailable and continue only read-only inspection and analysis using local evidence; do not claim recall succeeded.',
+    'Check kenaz_ping with the active projectPath when available. If unavailable, report that the Kenaz server is unavailable and continue only read-only inspection and analysis using local evidence.',
     'Lightweight Phase 0 uses the supplied boot context and local project evidence; do not run phase-gate Phase 0 or its boot rituals in fast mode. This also supersedes legacy handoff instructions that promise Phase 0 archival. When offline, defer state-changing execution and memory-dependent work until the required service is restored.',
     'Existing authorization, scope, verification, task tracking, and merge restrictions remain in force.',
   ].join('\n');
   const command = `node .specialist/tools/phase-gate.js enter --phase=0 --specialist=${(policy?.specialist || 'Ansuz').toLowerCase()}${projectPath ? ` --project-path="${projectPath}"` : ''}`;
-  const full = `Before running phase-gate enter, call synapse_status with the active projectPath. If it errors or times out, HALT and emit recovery: confirm Kenaz Dashboard on port ${port}, re-run setup-codex, and restart the Codex session.\nExecute Phase 0 initialization now: run \`${command}\` and follow its checklist.`;
-  if (contextual) return `## Codex Bootstrap Policy\n\nFor Ansuz without an explicit full boot or legacy depth:\n${fast}\n\nFor explicit --full / --boot-mode full or kernel depth, and for other specialists: retain the full bootstrap guard; call synapse_status before Phase 0 and HALT with recovery instructions if it is unavailable. Use the active specialist and project-path for Phase 0.\n`;
+  const full = `Before running phase-gate enter, call kenaz_ping with the active projectPath. If it errors or times out, HALT and emit recovery: confirm Kenaz Dashboard on port ${port}, re-run setup-codex, and restart the Codex session.\nExecute Phase 0 initialization now: run \`${command}\` and follow its checklist.`;
+  if (contextual) return `## Codex Bootstrap Policy\n\nFor Ansuz without an explicit full boot or legacy depth:\n${fast}\n\nFor explicit --full / --boot-mode full or kernel depth, and for other specialists: retain the full bootstrap guard; call kenaz_ping before Phase 0 and HALT with recovery instructions if it is unavailable. Use the active specialist and project-path for Phase 0.\n`;
   return `## Codex Bootstrap Policy (${policy.mode})\n\n${policy.mode === 'fast' ? fast : full}\n`;
 }
 

package/core/.formation/bifrost/shared/codex-injection.js

@@ -31,7 +31,7 @@ Guards against failure modes seen in long Codex Ansuz runs (2026-04-09 audit). R
 ## Anti-Drift 1: DDx First (mechanism before action)
 Non-trivial problem on first contact:
 - You MUST enumerate 3 or more competing hypotheses before the first domain-specific tool call.
-- You MUST perform recall (synapse_recall / cortex_recall) before acting when memory tools are available.
+- You MUST check the code first (kenaz_lsp_* / Grep) before acting.
 - You MUST NOT treat the first plausible idea as the plan.
 
 Direct attempt is only allowed when one of these is true:
@@ -100,22 +100,8 @@ Never accept an agent's self-report as verification. Phase 9 is NOT optional. Fo
 
 Only mark a task complete when EVERY requirement passes its grep/run check. If even one fails, create a FIX task and dispatch it. Half-done is not done.
 
-## Anti-Drift 8: PROACTIVE LESSON CAPTURE (R-301 alignment)
-Proactive lesson capture is mandatory (R-301), so the next session does not rediscover every gotcha.
-
-When you observe a non-obvious technical fact during a session — bug root cause, surprising tool behavior, infrastructure quirk, workflow trap, performance gotcha — inscribe it as an ash rune IMMEDIATELY without waiting for user prompt.
-
-Inscription protocol:
-1. Identify the closest STABLE existing code symbol as the rune anchor (file:function:kind format). Bare file paths are weak anchors and may fail FTS5 indexing silently.
-2. \`synapse_inscribe\` with type=ash, confidence>=0.85, content in ENGLISH (MEM-LANG-001 — FTS5 cannot tokenize CJK reliably).
-3. ALWAYS include trigger_phrases (3-5 natural language phrases) for semantic recall.
-4. WRITE-VERIFY: after inscribe, run \`synapse_recall\` with a unique substring from the rune content. If result_count=0, re-inscribe with a different verified symbol_id, OR fall back to writing to .kenaz/specialist/lessons_pending_index.jsonl.
-
-Anti-patterns to avoid:
-- Inscribing on a non-existent symbol_id (silent index failure).
-- Skipping write-verify ("trust the success message" — discovered 2026-04-09 that inscribe API can return success while FTS5 indexing does not happen).
-- Chinese/CJK content in rune body (FTS5 returns 0 results for CJK queries).
-- Generic content ("we hit a bug, fixed it") — provides no recall value.
+## Anti-Drift 8: PROACTIVE LESSON CAPTURE
+When you observe a non-obvious technical fact (bug root cause, surprising tool behavior, infrastructure quirk, workflow trap), record it immediately with \`kenaz learn add\` — do not wait for the user to ask. Keep it specific; a generic note ("we hit a bug, fixed it") has no recall value.
 
 ## Closing Note
 If a kernel/elixir rule and an Anti-Drift protocol conflict: kernel/elixir wins on identity and safety, Anti-Drift wins on execution and verification.

package/core/.formation/bifrost/shared/consolidate.js

@@ -131,51 +131,6 @@ function extractEpisodeFromTranscript(filePath){
   }
 }
 
-// archiveEpisodeToHippocampus: create+append+close hippocampus episode via MCP HTTP.
-// fail-open: any failure returns false without throwing.
-// hippocampus_episode_append REQUIRES phase (entry_type is not a valid param — server
-// rejects with isError and the episode closes empty). projectPath must be explicit:
-// the MCP HTTP layer is stateless and defaults to the dashboard's current project.
-async function archiveEpisodeToHippocampus(port,opts,extracted){
-  try{
-    var root=resolveRoot(opts);
-    var scope='Bifrost Codex session'+(opts.sessionId?' '+opts.sessionId:'');
-    var tags=['bifrost','codex','session_memory'];
-    var startRes=await mcpCall(port,'hippocampus_episode_start',{
-      scope:scope,
-      tags:tags,
-      source:'bifrost_codex',
-      projectPath:root
-    });
-    var startParsed=mcpToolJson(startRes);
-    if(!startParsed)return false;
-    var epId=startParsed.episode_id||startParsed.id;
-    if(!epId)return false;
-    var content=extracted?extracted.summary:'Codex session ended (no transcript).';
-    var ap1=await mcpCall(port,'hippocampus_episode_append',{
-      episode_id:epId,
-      content:content,
-      phase:'summary',
-      projectPath:root
-    });
-    if(!mcpToolJson(ap1))process.stderr.write('[bifrost:consolidate] episode append (summary) failed\n');
-    if(extracted&&extracted.runeHints&&extracted.runeHints.length){
-      var ap2=await mcpCall(port,'hippocampus_episode_append',{
-        episode_id:epId,
-        content:'Rune candidates: '+extracted.runeHints.join('; '),
-        phase:'observation',
-        projectPath:root
-      });
-      if(!mcpToolJson(ap2))process.stderr.write('[bifrost:consolidate] episode append (observation) failed\n');
-    }
-    await mcpCall(port,'hippocampus_episode_close',{episode_id:epId,projectPath:root});
-    return true;
-  }catch(e){
-    process.stderr.write('[bifrost:consolidate] hippocampus archive error: '+e.message+'\n');
-    return false;
-  }
-}
-
 // writeHandoff: write ISBAR handoff JSON to the per-session slot (TASK_1829).
 // Last-writer-wins within a session's own slot only; other sessions' slots are
 // untouched (per-session isolation replaced the old shared singular slot).
@@ -205,7 +160,7 @@ function writeHandoff(root,opts,extracted){
           status:'session_ended'
         },
         background:{
-          context:'Codex session ended via Stop hook. Transcript tee and episode archived.',
+          context:'Codex session ended via Stop hook. Transcript tee archived.',
           turn_count:extracted?extracted.turnCount:0
         },
         assessment:{
@@ -259,10 +214,6 @@ async function runStopConsolidation(opts){
     else if(tee&&typeof tee.close==='function')tee.close();
     var extracted=null;
     try{extracted=extractEpisodeFromTranscript(transcriptPath);}catch(ee){}
-    // Episode archive (fail-open)
-    var epOk=false;
-    try{epOk=await archiveEpisodeToHippocampus(port,opts||{},extracted);}catch(ae){}
-    if(!epOk){process.stderr.write('[bifrost:consolidate] hippocampus unavailable or error -- skipping episode.\n');}
     // Handoff (fail-open)
     try{writeHandoff(root,opts||{},extracted);}catch(he){}
     // Heartbeat (fail-open)
@@ -279,7 +230,6 @@ module.exports={
   mcpCall:mcpCall,
   mcpToolJson:mcpToolJson,
   extractEpisodeFromTranscript:extractEpisodeFromTranscript,
-  archiveEpisodeToHippocampus:archiveEpisodeToHippocampus,
   writeHandoff:writeHandoff,
   appendHeartbeat:appendHeartbeat,
   runStopConsolidation:runStopConsolidation

package/core/.formation/bifrost/sync.js

@@ -57,15 +57,15 @@ function translate(content) {
   // 4. Replace ToolSearch references (Codex doesn't have this)
   result = result.replace(
     /用 `ToolSearch "synapse"` 偵測/g,
-    '嘗試呼叫 synapse_status 偵測'
+    '嘗試呼叫 kenaz_ping 偵測'
   );
   result = result.replace(
     /ToolSearch 未找到 → 該 session 全程降級用 Grep\/Glob/g,
-    'synapse_status 失敗 → 該 session 全程降級用 shell 命令搜尋'
+    'kenaz_ping 失敗 → 該 session 全程降級用 shell 命令搜尋'
   );
 
   // 5. Replace Claude Code MCP tool name prefix
-  //    mcp__kenaz-dashboard__synapse_recall → synapse_recall (Codex uses short names)
+  //    mcp__kenaz-dashboard__kenaz_task_list → kenaz_task_list (Codex uses short names)
   result = result.replace(/mcp__kenaz-dashboard__/g, '');
 
   // 6. Replace /Ansuz, /Amelia etc. slash command references
@@ -85,7 +85,6 @@ ${renderBootstrap({ contextual: true })}
 ## Project-Path 自動解析
 
 當前工作目錄（cwd）即為專案根目錄。所有 MCP 工具呼叫的 \`projectPath\` 參數使用 cwd：
-- \`synapse_recall({ query: "...", projectPath: "<cwd>" })\`
 - \`kenaz_task_list({ projectPath: "<cwd>" })\`
 - phase-gate.js 指令加上 \`--project-path=<cwd>\`
 
@@ -97,7 +96,7 @@ ${renderBootstrap({ contextual: true })}
 
 本檔案由 Bifröst 從 CLAUDE.md 自動翻譯。以下是 Codex 特有的差異：
 
-1. **MCP 工具**：透過 \`codex mcp add kenaz-dashboard\` 連接 Dashboard（由 setup-codex.js 自動完成）。所有 Synapse/Hippocampus/Thalamus 工具可直接使用，不需要 \`mcp__kenaz-dashboard__\` 前綴。
+1. **MCP 工具**：透過 \`codex mcp add kenaz-dashboard\` 連接 Dashboard（由 setup-codex.js 自動完成）。所有 kenaz_* 工具可直接使用，不需要 \`mcp__kenaz-dashboard__\` 前綴。
 2. **檔案操作**：Codex 使用 shell 命令進行檔案操作，而非 Claude Code 的 Read/Edit/Write 工具。
 3. **互動式問題**：Codex 沒有 AskUserQuestion 工具，直接用文字詢問用戶即可。
 4. **Specialist 系統**：若需啟動 Ansuz 等 Specialist，使用 \`node .formation/bifrost/launch.js --specialist Ansuz\`（自動注入 MCP + AGENTS.override.md）。

package/core/.formation/tools/__tests__/subagent-bifrost-guard.test.js

@@ -139,7 +139,7 @@ setModels({ dispatchModel: 'claude-fable-5', dispatchFamily: 'claude', dispatchM
 }
 
 // ── [7] TASK_1815 model mapping: every emitted model is an enum member ──────
-// Covers the NATIVE ids from dashboard/src/lib/models.ts plus the missing-field
+// Covers the NATIVE ids from the retired Dashboard model list (models.ts) plus the missing-field
 // fallback ('claude-sonnet-4-6', mirrors DEFAULT_DISPATCH_MODEL) and a haiku id
 // (enum member with no dashboard source entry today — must still map).
 const MAP_CASES = [

package/core/.formation/tools/dispatch.js

@@ -49,7 +49,7 @@ const DEFAULT_DISPATCH_MODEL = 'claude-sonnet-5-5';
  * cannot express — the enum has FAMILY names only. So this translation is
  * structurally LOSSY: claude-opus-5[1m] and claude-opus-4-8[1m] both become
  * 'opus'. Callers must surface that loss, never treat it as equivalence.
- * NOTE: dashboard/src/lib/models.ts `family` ('claude'|'bifrost') is the
+ * NOTE: the retired Dashboard model list (models.ts) `family` ('claude'|'bifrost') is the
  * ADAPTER family and is unrelated to this Claude sub-family mapping.
  * @param {string} rawModel - dashboard model id, possibly with [1m]-style suffix
  * @returns {{ model: string|null, lossless: boolean }} model=null → unmappable
@@ -62,7 +62,7 @@ function translateModelForAgentTool(rawModel) {
     return { model: stripped, lossless: stripped === String(rawModel).trim() };
   }
   // claude-<family>[-version...] → <family>. Covers every NATIVE id in
-  // dashboard/src/lib/models.ts (claude-fable-5-1[1m], claude-opus-5-5[1m],
+  // the retired Dashboard model list (models.ts) (claude-fable-5-1[1m], claude-opus-5-5[1m],
   // claude-fable-5[1m], claude-opus-4-8[1m], claude-sonnet-5,
   // claude-sonnet-4-6) plus future versions of the same families. 'haiku' has
   // no dashboard source entry today but maps fine if one appears.