kenaz 0.3.18 → 0.3.20

package/core/.claude/hooks/context-check.js

@@ -1,51 +0,0 @@
-#!/usr/bin/env node
-/**
- * Context Check Hook — UserPromptSubmit (TASK_943 + TASK_947)
- * Two checks in one hook:
- *   1. (removed, TASK_1987) Fatigue Warning.
- *   2. Task Completed Signal: injects task chain notifications from ansuz_inbox.json.
- * Cross-platform. Silent no-op on any missing file or parse error.
- */
-'use strict';
-const kenazProjectRoot = require('./_project-guard').guard();
-const fs = require('fs');
-const path = require('path');
-const { fenceSignal } = require('./_signal-fence');
-const projectDir = kenazProjectRoot;
-
-// ── 1. Fatigue Warning (TASK_943) — REMOVED by TASK_1987 (2026-09-21).
-// The watcher that fed it is retired (TASK_2345) and the user had rejected the
-// fatigue footer (memory: feedback_no_fatigue_footer).
-
-// ── 2. Task Completed Signal (TASK_947) ────────────────────────────────────
-try {
-  const inboxFile = path.join(projectDir, '.kenaz', 'specialist', 'ansuz_inbox.json');
-  if (!fs.existsSync(inboxFile)) process.exit(0);
-
-  const inbox = JSON.parse(fs.readFileSync(inboxFile, 'utf8'));
-  if (!inbox || !Array.isArray(inbox.messages)) process.exit(0);
-
-  const processedIds = Array.isArray(inbox.processed_ids) ? inbox.processed_ids : [];
-
-  // Filter: type=task_completed, not yet processed, oldest first, max 3
-  const pending = inbox.messages
-    .filter(m => m && m.type === 'task_completed' && m.id && !processedIds.includes(m.id))
-    .sort((a, b) => (a.completed_at || '').localeCompare(b.completed_at || ''))
-    .slice(0, 3);
-
-  if (pending.length === 0) process.exit(0);
-
-  // Output one line per completed task
-  let rawTaskOutput = '';
-  for (const msg of pending) {
-    rawTaskOutput += '\n\u26a1 Task completed: ' + msg.task_id + ' \u2014 ' + msg.task_title + '. Chain follow-up may be needed.';
-  }
-  process.stdout.write(fenceSignal('task', rawTaskOutput.trimStart()) + '\n');
-
-  // Mark as processed (update processed_ids)
-  const newIds = pending.map(m => m.id);
-  inbox.processed_ids = [...processedIds, ...newIds];
-  try {
-    fs.writeFileSync(inboxFile, JSON.stringify(inbox, null, 2), 'utf8');
-  } catch { /* best-effort write — silent on error */ }
-} catch { /* graceful no-op */ }

package/core/.claude/hooks/fatigue-check.js

@@ -1,52 +0,0 @@
-#!/usr/bin/env node
-/**
- * Context Check Hook — UserPromptSubmit (TASK_943 + TASK_947)
- * Two checks in one hook:
- *   1. (removed, TASK_1987) Fatigue Warning.
- *   2. Task Completed Signal: injects task chain notifications from ansuz_inbox.json.
- * Cross-platform. Silent no-op on any missing file or parse error.
- */
-'use strict';
-try { require('./_dedupe-guard').guard(typeof __filename === 'string' ? __filename : null); } catch (_) { /* never block a hook on guard load failure (e.g. vm sandbox without __filename) */ }
-const kenazProjectRoot = require('./_project-guard').guard();
-const fs = require('fs');
-const path = require('path');
-const { fenceSignal } = require('./_signal-fence');
-const projectDir = kenazProjectRoot;
-
-// ── 1. Fatigue Warning (TASK_943) — REMOVED by TASK_1987 (2026-09-21).
-// The watcher that fed it is retired (TASK_2345) and the user had rejected the
-// fatigue footer (memory: feedback_no_fatigue_footer).
-
-// ── 2. Task Completed Signal (TASK_947) ────────────────────────────────────
-try {
-  const inboxFile = path.join(projectDir, '.kenaz', 'specialist', 'ansuz_inbox.json');
-  if (!fs.existsSync(inboxFile)) process.exit(0);
-
-  const inbox = JSON.parse(fs.readFileSync(inboxFile, 'utf8'));
-  if (!inbox || !Array.isArray(inbox.messages)) process.exit(0);
-
-  const processedIds = Array.isArray(inbox.processed_ids) ? inbox.processed_ids : [];
-
-  // Filter: type=task_completed, not yet processed, oldest first, max 3
-  const pending = inbox.messages
-    .filter(m => m && m.type === 'task_completed' && m.id && !processedIds.includes(m.id))
-    .sort((a, b) => (a.completed_at || '').localeCompare(b.completed_at || ''))
-    .slice(0, 3);
-
-  if (pending.length === 0) process.exit(0);
-
-  // Output one line per completed task
-  let rawTaskOutput = '';
-  for (const msg of pending) {
-    rawTaskOutput += '\n\u26a1 Task completed: ' + msg.task_id + ' \u2014 ' + msg.task_title + '. Chain follow-up may be needed.';
-  }
-  process.stdout.write(fenceSignal('task', rawTaskOutput.trimStart()) + '\n');
-
-  // Mark as processed (update processed_ids)
-  const newIds = pending.map(m => m.id);
-  inbox.processed_ids = [...processedIds, ...newIds];
-  try {
-    fs.writeFileSync(inboxFile, JSON.stringify(inbox, null, 2), 'utf8');
-  } catch { /* best-effort write — silent on error */ }
-} catch { /* graceful no-op */ }

package/core/.claude/hooks/handoff-snapshot-on-commit.js

@@ -1,154 +0,0 @@
-#!/usr/bin/env node
-/**
- * handoff-snapshot-on-commit.js — PostToolUse hook for Bash (TASK_1400)
- *
- * Fires after any Bash tool call that looks like a git commit.
- * Emits a one-line nudge to run ansuz_handoff_snapshot with the commit hash.
- * 5-minute dedup prevents nudge fatigue under rapid commit sequences.
- *
- * Matcher: Bash (all Bash calls — filtered internally by command pattern)
- */
-'use strict';
-try { require('./_dedupe-guard').guard(typeof __filename === 'string' ? __filename : null); } catch (_) { /* never block a hook on guard load failure (e.g. vm sandbox without __filename) */ }
-const kenazProjectRoot = require('./_project-guard').guard();
-
-const fs = require('fs');
-const path = require('path');
-const { fenceSignal } = require('./_signal-fence');
-
-const PROJECT_DIR = kenazProjectRoot;
-const TELEMETRY_PATH = path.join(
-  PROJECT_DIR,
-  '.kenaz', 'specialist', 'handoff_nudges.jsonl'
-);
-const DEDUP_WINDOW_MS = 5 * 60 * 1000;
-const DEDUP_KEY_PREFIX = 'commit:';
-
-function readStdin() {
-  try {
-    return JSON.parse(fs.readFileSync(0, 'utf8').trim() || '{}');
-  } catch {
-    return {};
-  }
-}
-
-function extractCommand(payload) {
-  return (
-    payload?.tool_input?.command ||
-    payload?.toolInput?.command ||
-    payload?.command ||
-    ''
-  );
-}
-
-function extractShortHash(payload) {
-  // Try to extract hash from tool_response output
-  try {
-    const resp =
-      payload?.tool_response?.content?.[0]?.text ||
-      payload?.tool_result?.content?.[0]?.text ||
-      '';
-    const m = resp.match(/\b([a-f0-9]{7,12})\b/);
-    return m ? m[1] : null;
-  } catch {
-    return null;
-  }
-}
-
-function normalizeKey(cmd) {
-  // Normalize to prevent minor variation from defeating dedup
-  return cmd.replace(/\s+/g, ' ').trim().substring(0, 80);
-}
-
-function isDeduped(key) {
-  try {
-    if (!fs.existsSync(TELEMETRY_PATH)) return false;
-    const lines = fs.readFileSync(TELEMETRY_PATH, 'utf8').split(/\r?\n/).filter(Boolean);
-    const cutoff = Date.now() - DEDUP_WINDOW_MS;
-    for (let i = lines.length - 1; i >= 0; i--) {
-      let entry;
-      try { entry = JSON.parse(lines[i]); } catch { continue; }
-      const ts = Number(entry.timestamp_ms || 0);
-      if (ts && ts < cutoff) break;
-      if (entry.dedup_key === key && !entry.suppressed) return true;
-    }
-    return false;
-  } catch {
-    return false;
-  }
-}
-
-function appendTelemetry(record) {
-  try {
-    fs.mkdirSync(path.dirname(TELEMETRY_PATH), { recursive: true });
-    fs.appendFileSync(TELEMETRY_PATH, JSON.stringify(record) + '\n', 'utf8');
-  } catch { /* best-effort */ }
-}
-
-// Auto-invoke the snapshot CLI as a detached process so the hook returns fast
-// and the snapshot write does not depend on the agent remembering. Errors are
-// swallowed — never block the user turn. Mirrors the discipline applied across
-// all 4 handoff hooks (commit, decision, question, post-dispatch).
-function invokeHandoffSnapshot(trigger, milestone, sessionId, transcriptPath) {
-  try {
-    const { spawn } = require('child_process');
-    const cli = path.join(PROJECT_DIR, '.specialist', 'Ansuz', 'tools', 'ansuz-handoff-snapshot.js');
-    if (!fs.existsSync(cli)) return;
-    const args = [cli, `--trigger=${trigger}`];
-    if (milestone) args.push(`--last-milestone=${milestone}`);
-    if (sessionId) args.push(`--session-id=${sessionId}`);
-    // Scopes pending/unfinished to tasks this conversation touched.
-    if (transcriptPath) args.push(`--transcript-path=${transcriptPath}`);
-    const child = spawn('node', args, {
-      detached: true,
-      stdio: 'ignore',
-      cwd: PROJECT_DIR,
-      windowsHide: true,
-    });
-    child.unref();
-  } catch { /* best-effort */ }
-}
-
-function main() {
-  const payload = readStdin();
-  const cmd = extractCommand(payload);
-
-  // Only fire on git commit commands
-  if (!/\bgit\s+commit\b/.test(cmd)) {
-    process.exit(0);
-  }
-
-  // Ansuz-only: a plain session's commit must not write an Ansuz handoff slot
-  // (it did, filling the slot with other sessions' backlog as "pending").
-  if (!require('./_ansuz-conversation').isAnsuzConversation(payload.transcript_path, PROJECT_DIR)) {
-    process.exit(0);
-  }
-
-  const dedupKey = DEDUP_KEY_PREFIX + normalizeKey(cmd);
-  const suppressed = isDeduped(dedupKey);
-
-  appendTelemetry({
-    timestamp: new Date().toISOString(),
-    timestamp_ms: Date.now(),
-    hook: 'handoff-snapshot-on-commit',
-    dedup_key: dedupKey,
-    suppressed,
-  });
-
-  if (suppressed) {
-    process.exit(0);
-  }
-
-  const shortHash = extractShortHash(payload);
-  const hashPart = shortHash ? ` (${shortHash})` : '';
-  const milestone = `Commit landed${hashPart}`;
-
-  // Auto-write the handoff (system-level enforcement, instance-independent)
-  invokeHandoffSnapshot('live_decision_point', milestone, payload.session_id, payload.transcript_path);
-
-  process.stdout.write(
-    '\n' + fenceSignal('handoff', `🔁 Commit landed${hashPart}. Handoff auto-snapshot dispatched (live_decision_point).`) + '\n'
-  );
-}
-
-main();

package/core/.claude/hooks/handoff-snapshot-on-question.js

@@ -1,158 +0,0 @@
-#!/usr/bin/env node
-/**
- * handoff-snapshot-on-question.js — PostToolUse hook for AskUserQuestion (TASK_1400)
- *
- * Fires after AskUserQuestion resolves (tool_response present with user's answer).
- * Emits a nudge to run ansuz_handoff_snapshot — question resolution is a natural
- * decision point that should be captured in the live handoff.
- * 5-minute dedup keyed on normalized question text.
- *
- * Matcher: AskUserQuestion
- */
-'use strict';
-try { require('./_dedupe-guard').guard(typeof __filename === 'string' ? __filename : null); } catch (_) { /* never block a hook on guard load failure (e.g. vm sandbox without __filename) */ }
-const kenazProjectRoot = require('./_project-guard').guard();
-
-const fs = require('fs');
-const path = require('path');
-const { fenceSignal } = require('./_signal-fence');
-
-const PROJECT_DIR = kenazProjectRoot;
-const TELEMETRY_PATH = path.join(
-  PROJECT_DIR,
-  '.kenaz', 'specialist', 'handoff_nudges.jsonl'
-);
-const DEDUP_WINDOW_MS = 5 * 60 * 1000;
-const DEDUP_KEY_PREFIX = 'question:';
-
-function readStdin() {
-  try {
-    return JSON.parse(fs.readFileSync(0, 'utf8').trim() || '{}');
-  } catch {
-    return {};
-  }
-}
-
-function extractQuestion(payload) {
-  // AskUserQuestion schema: tool_input.questions = [{question, ...}];
-  // legacy single-question payloads carried tool_input.question.
-  const input = payload?.tool_input || payload?.toolInput || {};
-  if (typeof input.question === 'string' && input.question.trim()) {
-    return input.question;
-  }
-  const questions = Array.isArray(input.questions) ? input.questions : [];
-  return questions.map((q) => q?.question).filter(Boolean).join(' | ');
-}
-
-function hasResponse(payload) {
-  // Check if the user has responded (tool_response present)
-  const resp = payload?.tool_response || payload?.tool_result;
-  if (!resp) return false;
-  // Verify it's not empty
-  if (typeof resp === 'string') return resp.trim().length > 0;
-  if (typeof resp === 'object') {
-    if (resp.content && Array.isArray(resp.content)) {
-      return resp.content.some(c => c?.text && c.text.trim().length > 0);
-    }
-    return true;
-  }
-  return false;
-}
-
-function normalizeQuestion(q) {
-  return q.replace(/\s+/g, ' ').trim().substring(0, 80);
-}
-
-function isDeduped(key) {
-  try {
-    if (!fs.existsSync(TELEMETRY_PATH)) return false;
-    const lines = fs.readFileSync(TELEMETRY_PATH, 'utf8').split(/\r?\n/).filter(Boolean);
-    const cutoff = Date.now() - DEDUP_WINDOW_MS;
-    for (let i = lines.length - 1; i >= 0; i--) {
-      let entry;
-      try { entry = JSON.parse(lines[i]); } catch { continue; }
-      const ts = Number(entry.timestamp_ms || 0);
-      if (ts && ts < cutoff) break;
-      if (entry.dedup_key === key && !entry.suppressed) return true;
-    }
-    return false;
-  } catch {
-    return false;
-  }
-}
-
-function appendTelemetry(record) {
-  try {
-    fs.mkdirSync(path.dirname(TELEMETRY_PATH), { recursive: true });
-    fs.appendFileSync(TELEMETRY_PATH, JSON.stringify(record) + '\n', 'utf8');
-  } catch { /* best-effort */ }
-}
-
-// Auto-invoke the snapshot CLI as a detached process so the hook returns fast
-// and the snapshot write does not depend on the agent remembering. Errors are
-// swallowed — never block the user turn.
-function invokeHandoffSnapshot(trigger, milestone, sessionId, transcriptPath) {
-  try {
-    const { spawn } = require('child_process');
-    const cli = path.join(PROJECT_DIR, '.specialist', 'Ansuz', 'tools', 'ansuz-handoff-snapshot.js');
-    if (!fs.existsSync(cli)) return;
-    const args = [cli, `--trigger=${trigger}`];
-    if (milestone) args.push(`--last-milestone=${milestone}`);
-    if (sessionId) args.push(`--session-id=${sessionId}`);
-    // Scopes pending/unfinished to tasks this conversation touched.
-    if (transcriptPath) args.push(`--transcript-path=${transcriptPath}`);
-    const child = spawn('node', args, {
-      detached: true,
-      stdio: 'ignore',
-      cwd: PROJECT_DIR,
-      windowsHide: true,
-    });
-    child.unref();
-  } catch { /* best-effort */ }
-}
-
-function main() {
-  const payload = readStdin();
-
-  // Only fire if there is an actual response
-  if (!hasResponse(payload)) {
-    process.exit(0);
-  }
-
-  // Ansuz-only: see handoff-snapshot-on-commit.js.
-  if (!require('./_ansuz-conversation').isAnsuzConversation(payload.transcript_path, PROJECT_DIR)) {
-    process.exit(0);
-  }
-
-  const question = extractQuestion(payload);
-  const normalizedQ = normalizeQuestion(question);
-  const dedupKey = DEDUP_KEY_PREFIX + normalizedQ;
-  const suppressed = isDeduped(dedupKey);
-
-  appendTelemetry({
-    timestamp: new Date().toISOString(),
-    timestamp_ms: Date.now(),
-    hook: 'handoff-snapshot-on-question',
-    dedup_key: dedupKey,
-    question: normalizedQ,
-    suppressed,
-  });
-
-  if (suppressed) {
-    process.exit(0);
-  }
-
-  const questionSummary = normalizedQ.substring(0, 50) + (normalizedQ.length > 50 ? '…' : '');
-  const milestone = questionSummary
-    ? `AskUserQuestion resolved: ${questionSummary}`
-    : 'AskUserQuestion resolved';
-
-  // Auto-write the handoff (system-level enforcement, instance-independent)
-  invokeHandoffSnapshot('live_decision_point', milestone, payload.session_id, payload.transcript_path);
-
-  process.stdout.write(
-    '\n' + fenceSignal('handoff', `🔁 AskUserQuestion resolved ("${questionSummary}"). Handoff auto-snapshot dispatched (live_decision_point).`) + '\n'
-  );
-}
-
-main();

package/core/.claude/hooks/handoff-staleness.js

@@ -1,197 +0,0 @@
-#!/usr/bin/env node
-/**
- * Handoff Staleness Hook — UserPromptSubmit (TASK_1390, reworked TASK_1830)
- * Nudges Ansuz to refresh THIS session's per-session ISBAR handoff slot
- * (.kenaz/specialist/handoffs/<sessionId>.json) when it drifts stale.
- *
- * Fires if THIS CONVERSATION has dispatched work AND:
- *   (a) no per-session handoff slot exists for this session ('missing'), or
- *   (b) the slot's generated_at is older than HANDOFF_STALE_AFTER_MS ('stale').
- * Silent when the slot is fresh, when it is the Phase 11 cleared sentinel,
- * or when the session has not dispatched anything (idle sessions are never
- * nagged). Graceful no-op on any read error.
- *
- * Anchor contract (TASK_1837): the conversation start anchor is the transcript
- * file's birthtime ONLY. If the harness provides no readable transcript_path,
- * the anchor is UNKNOWN and the hook stays silent — it must never fall back to
- * ansuz_session.json started_at (a long-lived SDK-daemon timestamp that
- * attributes days of historical dispatch briefs to this conversation).
- * Staleness threshold: single-sourced from ansuz-handoff-snapshot.js
- * (HANDOFF_STALE_AFTER_MS) — see TASK_1837/TASK_1838.
- *
- * Dispatch detection (TASK_1830 measurement — two routes, two trace families):
- *   1. Formation dispatch route → .formation/.active-dispatches.json
- *      (written by Rust, kenaz.rs). Kept for that route.
- *   2. sub-agent route (Agent tool — the DEFAULT since 2026-06-09) never touches
- *      that file. Its in-project trace is the dispatch brief
- *      .kenaz/specialist/dispatch_prompt_<task>.(md|txt) written at dispatch
- *      time. Gating only on route 1 made this hook permanently silent.
- *
- * Session identity (TASK_1829/TASK_1830): slots are read via handoff-resolver
- * readOwnHandoff — NEVER readLatestHandoff (another session's fresh slot would
- * false-pass our staleness check). Candidate order: hook stdin session_id
- * (snapshot hooks name slots with it) → transcript basename (stable across
- * compact/resume) → resolver ambient candidates (ansuz_session.json / env).
- *
- * Entry contract: settings.json invokes this via
- *   node -e "...require(d+'/.claude/hooks/handoff-staleness.js')"
- * so the body MUST run at module top level. Do NOT add a
- * `require.main === module` guard — under node -e require.main is undefined
- * and such a guard silently disables the hook (TASK_1827/TASK_1829 regressions).
- */
-'use strict';
-const kenazProjectRoot = require('./_project-guard').guard();
-const fs = require('fs');
-const path = require('path');
-const { fenceSignal } = require('./_signal-fence');
-
-// Staleness threshold single source (TASK_1837, pattern from TASK_1838's
-// dispatchLockStaleness): the snapshot WRITER owns HANDOFF_STALE_AFTER_MS and
-// derives its own freshness window from it, so "hook says stale" always implies
-// "writer will rewrite". Holding a local copy here is what produced the
-// 5min-vs-30min dead zone. Required lazily below (stale branch only).
-
-const projectDir = kenazProjectRoot;
-const sessionFile = path.join(projectDir, '.kenaz', 'specialist', 'ansuz_session.json');
-const specialistDir = path.join(projectDir, '.kenaz', 'specialist');
-const dispatchFile = path.join(projectDir, '.formation', '.active-dispatches.json');
-
-try {
-  // Read current session
-  if (!fs.existsSync(sessionFile)) process.exit(0);
-  const session = JSON.parse(fs.readFileSync(sessionFile, 'utf8'));
-  const currentSessionId = session && session.session_id;
-  if (!currentSessionId) process.exit(0);
-  // Hook stdin payload — Claude Code injects { session_id, transcript_path, ... }.
-  let payload = {};
-  try {
-    const raw = fs.readFileSync(0, 'utf8').trim();
-    if (raw) payload = JSON.parse(raw) || {};
-  } catch { /* stdin optional — probes and degraded harnesses */ }
-
-  // Anchor "this conversation started". The ONLY valid anchor is the transcript
-  // file's birthtime — it is per-conversation. ansuz_session.json started_at
-  // belongs to the long-lived boot-registered session (the SDK daemon can live
-  // for days); using it as a fallback attributed every historical dispatch brief
-  // to the current conversation (TASK_1837 measurement: 11 stale briefs matched
-  // the 6-day-old daemon anchor vs 0 with the transcript anchor), so every first
-  // prompt false-alarmed 'missing'. Unknown-is-null (same family as TASK_1832/
-  // TASK_1833): when the anchor cannot be established, convStartedAt stays null
-  // and hasDispatched stays false — never guess from an optimistic default.
-  let convStartedAt = null;
-  if (payload.transcript_path) {
-    try {
-      const birth = fs.statSync(String(payload.transcript_path)).birthtimeMs;
-      if (Number.isFinite(birth) && birth > 0) convStartedAt = birth;
-    } catch { /* transcript unreadable — anchor stays unknown */ }
-  }
-  // Anchor unknown → cannot attribute any dispatch to this conversation → silent.
-  if (!convStartedAt) process.exit(0);
-
-  // Ansuz-only nudge: a plain Claude Code session sharing this project must not
-  // be told to refresh an Ansuz handoff just because some other session
-  // dispatched. Decided from this conversation's own user messages.
-  const { isAnsuzConversation } = require('./_ansuz-conversation');
-  if (!isAnsuzConversation(payload.transcript_path, projectDir)) process.exit(0);
-
-  // Determine if any dispatch occurred during this session.
-  // Note: dispatch.originSessionId is the MCP server's session ID (auto-injected
-  // at mcp.rs:get_session_id), NOT Claude's session_id. The two identity spaces
-  // never match. Use time-based comparison instead.
-  // A dispatch counts only if it started after this conversation did AND this
-  // conversation's own tool calls name its task id. Timestamps alone let a
-  // parallel session's dispatch nag every other open conversation.
-  const { toolUseMentionsAny, taskIdNeedles } = require('./_ansuz-conversation');
-  const candidateNeedles = [];
-  try {
-    // Route 1: Formation registry (entries carry taskId).
-    if (fs.existsSync(dispatchFile)) {
-      const dispatches = JSON.parse(fs.readFileSync(dispatchFile, 'utf8'));
-      if (Array.isArray(dispatches)) {
-        for (const d of dispatches) {
-          if (!d || !d.startedAt || !d.taskId) continue; // unattributable → ignore
-          const dispatchStartedAt = new Date(d.startedAt).getTime();
-          if (Number.isFinite(dispatchStartedAt) && dispatchStartedAt >= convStartedAt) {
-            candidateNeedles.push(...taskIdNeedles(d.taskId));
-          }
-        }
-      }
-    }
-    // Route 2: sub-agent dispatch briefs dispatch_prompt_<task>.(md|txt); mtime is
-    // the dispatch time. dispatch_prompt_stats.jsonl shares the prefix and is
-    // appended by every dispatch in every session — never a brief.
-    for (const name of fs.readdirSync(specialistDir)) {
-      const m = /^dispatch_prompt_(.+)\.(md|txt)$/.exec(name);
-      if (!m) continue;
-      try {
-        if (fs.statSync(path.join(specialistDir, name)).mtimeMs >= convStartedAt) {
-          candidateNeedles.push(...taskIdNeedles(m[1]));
-        }
-      } catch { /* file raced away — skip */ }
-    }
-  } catch { /* graceful — dispatch traces optional */ }
-  const hasDispatched = candidateNeedles.length > 0 &&
-    toolUseMentionsAny(payload.transcript_path, [...new Set(candidateNeedles)]);
-
-  // No dispatches this session → nothing to nudge about (idle sessions stay quiet).
-  if (!hasDispatched) process.exit(0);
-
-  // Read THIS session's per-session handoff slot via the resolver (TASK_1829:
-  // readOwnHandoff only — readLatestHandoff would let another session's fresh
-  // slot masquerade as ours and turn a true warning into a false pass).
-  let handoff = null;
-  let slotSessionId = null;
-  try {
-    const resolver = require(path.join(projectDir, '.specialist', 'Ansuz', 'tools', 'handoff-resolver.js'));
-    const candidates = [];
-    if (payload.session_id) candidates.push(String(payload.session_id));
-    if (payload.transcript_path) {
-      candidates.push(path.basename(String(payload.transcript_path), '.jsonl'));
-    }
-    candidates.push(String(currentSessionId));
-    for (const cand of resolver.resolveOwnSessionCandidates(projectDir)) {
-      if (cand && cand.id) candidates.push(String(cand.id));
-    }
-    for (const id of [...new Set(candidates)]) {
-      handoff = resolver.readOwnHandoff(projectDir, id);
-      if (handoff) { slotSessionId = id; break; }
-    }
-  } catch { /* resolver unavailable — treat as no slot */ }
-
-  // Skip if handoff is already the cleared sentinel (Phase 11 done)
-  if (handoff && handoff.cleared === true) process.exit(0);
-
-  const now = Date.now();
-  let staleReason = null;
-  let lastUpdateAgo = null;
-
-  if (!handoff) {
-    // (a) Dispatched this session but no per-session slot yet
-    staleReason = 'missing';
-  } else {
-    // (b) Slot exists but generated_at is too old (writeHandoff/snapshot CLI
-    // always stamp generated_at; a missing stamp reads as stale).
-    // Threshold comes from the writer module — if it cannot be loaded the outer
-    // catch silences the hook, which is correct: the nudge would point at a
-    // snapshot CLI that cannot run anyway.
-    const { HANDOFF_STALE_AFTER_MS } = require(
-      path.join(projectDir, '.specialist', 'Ansuz', 'tools', 'ansuz-handoff-snapshot.js')
-    );
-    const generatedAt = handoff.generated_at ? new Date(handoff.generated_at).getTime() : null;
-    const ageMs = Number.isFinite(generatedAt) && generatedAt ? now - generatedAt : Infinity;
-    if (ageMs > HANDOFF_STALE_AFTER_MS) {
-      staleReason = 'stale';
-      lastUpdateAgo = Number.isFinite(ageMs) ? Math.round(ageMs / 60000) : null;
-    }
-  }
-
-  if (!staleReason) process.exit(0);
-
-  // Emit one-line nudge
-  const nudgeSessionId = slotSessionId || (payload.session_id ? String(payload.session_id) : String(currentSessionId));
-  const sessionShort = nudgeSessionId.slice(0, 8);
-  const agoStr = lastUpdateAgo != null ? `, last_update: ${lastUpdateAgo}min` : '';
-  process.stdout.write(
-    '\n' + fenceSignal('handoff', `⚠️ ISBAR handoff ${staleReason} (session: ${sessionShort}${agoStr}). Refresh this session's per-session slot .kenaz/specialist/handoffs/${nudgeSessionId}.json — call the ansuz_handoff_snapshot MCP tool, or run: node .specialist/Ansuz/tools/ansuz-handoff-snapshot.js --trigger=manual --session-id=${nudgeSessionId}. Never hand-write the retired singular slot.`) + '\n'
-  );
-} catch { /* graceful no-op — never block user turn */ }

package/core/.claude/hooks/jev-thalamus-context.js

@@ -1,17 +0,0 @@
-'use strict';
-// TASK_2341: the thalamus ranking endpoint (POST /api/synapse/jev-thalamus-rank) was removed with the
-// graph/thalamus subsystem, so postRank no longer makes any HTTP call. It resolves null, which
-// .specialist/tools/jev-optional-context.js already treats as "rank unavailable" -> baseline (no optional
-// context). The file name and `enabled`/`postRank` exports stay because jev-optional-context.js requires them.
-const fs = require('fs');
-const path = require('path');
-const MAX_INPUT = 32768;
-function enabled(projectDir) {
-  try {
-    if (!path.isAbsolute(projectDir)) return false;
-    const file = path.join(projectDir, '.kenaz', 'dashboard-models.json');
-    return fs.statSync(file).size <= MAX_INPUT && JSON.parse(fs.readFileSync(file, 'utf8')).jevThalamusEnabled === true;
-  } catch { return false; }
-}
-async function postRank() { return null; }
-module.exports = { enabled, postRank };

package/core/.claude/hooks/jev-thalamus-context.test.js

@@ -1,41 +0,0 @@
-'use strict';
-const { test } = require('node:test');
-const assert = require('node:assert/strict');
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-const helper = require('./jev-thalamus-context');
-const { loadOptionalContext } = require('../../.specialist/tools/jev-optional-context');
-function project(t, flag = true) {
-  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'jev-thalamus-hook-'));
-  t.after(() => fs.rmSync(dir, { recursive: true, force: true }));
-  fs.mkdirSync(path.join(dir, '.kenaz'));
-  const toggle = value => fs.writeFileSync(path.join(dir, '.kenaz/dashboard-models.json'), JSON.stringify({ jevThalamusEnabled: value }));
-  toggle(flag); return { dir, toggle };
-}
-test('enabled is true only for exact boolean true in an absolute project dir', t => {
-  const ctx = project(t);
-  assert.equal(helper.enabled(ctx.dir), true);
-  for (const flag of [false, 'true', 1, null]) { ctx.toggle(flag); assert.equal(helper.enabled(ctx.dir), false); }
-  assert.equal(helper.enabled('relative/dir'), false);
-  assert.equal(helper.enabled(path.join(ctx.dir, 'missing')), false);
-});
-test('postRank makes no HTTP call (endpoint removed) and resolves null', async () => {
-  const http = require('http');
-  const original = http.request; let calls = 0;
-  http.request = () => { calls++; throw new Error('must not be called'); };
-  try { assert.equal(await helper.postRank({ projectPath: 'x', taskContext: 't', candidates: [] }), null); }
-  finally { http.request = original; }
-  assert.equal(calls, 0);
-  assert.equal(helper.ENDPOINT, undefined);
-});
-test('jev-optional-context stays on baseline (rank_unavailable) with the real postRank', async t => {
-  const ctx = project(t);
-  const out = await loadOptionalContext({ projectPath: ctx.dir, prompt: 'task', specialist: 'ansuz' });
-  assert.equal(out.status, 'baseline');
-  assert.equal(out.context, '');
-});
-test('hook source has no calls to removed /api/synapse routes', () => {
-  const src = fs.readFileSync(path.join(__dirname, 'jev-thalamus-context.js'), 'utf8').replace(/^\s*\/\/.*$/gm, '');
-  assert.doesNotMatch(src, /http\.request|\/api\/synapse\/jev/);
-});