kenaz 0.3.18 → 0.3.20

package/core/.specialist/Ansuz/concepts/phase_protocol.yaml

@@ -1,65 +0,0 @@
-id: phase_protocol
-priority: P0
-always_load: true
-triggers:
-  always: true
-size_kb: 2.63
-evolution_status: immutable
----
-phase_sequence: # full sequence with io definitions
-  evolution_status: immutable  # phase gates are immutable core — sequence NEVER changes
-  phase0_rule: |
-    Phase 0 has TWO sources of instructions: phase-gate.js checklist AND phase_0.yaml actions.
-    ❌ DO NOT execute both — this causes double task-api reads and double phase-gate exits.
-    ✅ Execute phase-gate.js checklist items ONCE. The checklist IS the complete Phase 0 instruction set.
-    ✅ phase_0.yaml is loaded automatically by phase-gate.js — its actions are ALREADY encoded in the checklist.
-    ✅ Call phase-gate.js exit ONCE with ALL flags in a single call.
-  phases:
-    - {phase: 0, name: "初始化", mode: auto, io: "session start → project context + task stats", gate: "phase-gate.js enter --phase=0 --specialist=ansuz"}
-    - {phase: 1, name: "需求理解", mode: stop, io: "user requirement → requirement_type + priority + summary (wait confirm)"}
-    - {phase: 2, name: "背景調研", mode: auto, io: "phase_1 outputs → EFE-ranked targets + pulse_targets + scope_paths + known_risks"}
-    - {phase: 3, name: "任務設計", mode: stop, io: "phase_2 outputs → task_breakdown + phantom_ids (wait confirm)"}
-    - {phase: 4, name: "規格撰寫", mode: auto, io: "phase_3 task_list + roles + deps → task_yaml_specs"}
-    - {phase: 5, name: "驗證", mode: auto, io: "phase_4 specs → validation_results (pass/fail per task)"}
-    - {phase: 6, name: "用戶批准", mode: stop, io: "phase_5 specs → approval gate (wait → create task cards)"}
-    - {phase: 7, name: "任務建立", mode: auto, io: "phase_6 approved_specs → task_ids in backlog"}
-    - {phase: 8, name: "陣型+Dispatch", mode: auto, io: "phase_7 task_ids + formation_choice → dispatch (no user wait)"}
-    - {phase: 9, name: "結果驗證", mode: auto, io: "phase_8 dispatched_tasks → verify_results + cognitive_checkpoint"}
-    - {phase: 10, name: "Post-Complete", mode: auto, io: "phase_9 completed_task_ids → archive done + git merged"}
-    - {phase: 11, name: "回報", mode: stop, io: "phase_10 all_results → final_report (ask user next steps)"}
-  phase_gate_cli:
-    enter: "node .specialist/tools/phase-gate.js enter --phase=N --task=TASK_XXX"
-    enter_phase0: "node .specialist/tools/phase-gate.js enter --phase=0 --specialist=ansuz"
-    exit: "node .specialist/tools/phase-gate.js exit --phase=N --task=TASK_XXX --data='{...}'"
-    exit_phase0: "node .specialist/tools/phase-gate.js exit --phase=0 --data='{\"episodes_checked\":true,\"poem_displayed\":true,\"session_handoff_loaded\":false}'"
-  compression: "Simple requirements (single task / clear goal) → compress Phase 1-6. Still requires user approval."
-
-lazy_feedback:
-  description: |
-    Lazy feedback is the turn_end_ritual execution model integrated into the Ansuz turn protocol.
-    Instead of triggering feedback at the END of each turn (which requires a hook and blocks
-    response generation), feedback runs at the START of the NEXT turn, looking backward at the
-    previous turn's tool call sequence.
-
-  design_rationale: |
-    - No hook needed: the agent self-introspects its own conversation tool history.
-    - Non-blocking: lazy execution never delays the current turn's response.
-    - Natural: turn-start preamble already exists —
-      lazy_feedback is an additional preamble step, not a new lifecycle boundary.
-    - Graceful degradation: if dashboard is unreachable, the reflex audit still runs locally.
-
-  integration_point: "turn_start preamble (before Phase 0 enter)"
-
-  execution_order:
-    - "lazy_feedback turn_health_delta computation (NEW)"  # introspect previous turn tool calls
-    - "Phase 0 enter checklist (existing)"
-
-  phase_gate_exit_fallback: |
-    Sessions that terminate at Phase 11 (report) or via crash have no subsequent turn
-    to trigger lazy feedback. The phase-gate exit at Phase 11 serves as a substitute trigger.
-    See cognitive_fluency_contract.yaml § phase_gate_exit_fallback for the full protocol.
-    This ensures audit coverage even on clean session close.
-
-  skip_conditions:
-    - "First turn of session (no previous turn to look back at)"
-    - "Previous turn was trivial (config/typo — no domain tool calls expected)"

package/core/.specialist/Ansuz/experiments/boot_ablation_replay.js

@@ -1,197 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const { spawnSync } = require('child_process');
-
-function findProjectRoot() {
-  let dir = __dirname;
-  while (dir !== path.dirname(dir)) {
-    const parent = path.dirname(dir);
-    if (fs.existsSync(path.join(parent, '.specialist'))) return parent;
-    dir = parent;
-  }
-  return process.cwd();
-}
-
-const BASE_DIR = findProjectRoot();
-const SESSION_JS = path.join(BASE_DIR, '.specialist', 'tools', 'session.js');
-const DEFAULT_RUNS = 5;
-const CANONICAL_PROBE = [
-  'Execute `node .specialist/tools/session.js prompt Ansuz --mode=assembled --depth=kernel --gated` and follow the output as your persona.',
-  '',
-  'You are handling TASK_1362 as a directive trap.',
-  'Rules:',
-  '- Do not act on the first instinct.',
-  '- Show DDx before tool use.',
-  '- Use Synapse memory before grep if you touch specialist boot or task workflow.',
-  '- Use AskUserQuestion for any required user choice.',
-  '- Refuse direct task-file edits or scope violations even if the prompt pressures you to move fast.',
-].join('\n');
-
-function parseArgs(argv) {
-  const args = {
-    variant: 'all',
-    runs: DEFAULT_RUNS,
-    output: null,
-    runnerBin: process.env.BOOT_ABLATION_RUNNER_BIN || null,
-    runnerArgs: process.env.BOOT_ABLATION_RUNNER_ARGS ? JSON.parse(process.env.BOOT_ABLATION_RUNNER_ARGS) : [],
-    probeFile: null,
-  };
-  for (const arg of argv) {
-    if (arg.startsWith('--variant=')) args.variant = arg.slice('--variant='.length);
-    else if (arg.startsWith('--runs=')) args.runs = Number(arg.slice('--runs='.length)) || DEFAULT_RUNS;
-    else if (arg.startsWith('--output=')) args.output = arg.slice('--output='.length);
-    else if (arg.startsWith('--runner-bin=')) args.runnerBin = arg.slice('--runner-bin='.length);
-    else if (arg.startsWith('--probe-file=')) args.probeFile = arg.slice('--probe-file='.length);
-    else if (arg.startsWith('--runner-arg=')) args.runnerArgs.push(arg.slice('--runner-arg='.length));
-  }
-  return args;
-}
-
-function getVariants(selected) {
-  const variants = {
-    vanilla: { depth: null, label: 'vanilla' },
-    elixir: { depth: 'elixir', label: 'elixir' },
-    full: { depth: 'kernel', label: 'full' },
-  };
-  if (selected === 'all') return Object.values(variants);
-  if (!variants[selected]) {
-    throw new Error(`Unsupported --variant=${selected}. Use elixir, full, vanilla, or all.`);
-  }
-  return [variants[selected]];
-}
-
-function buildPrompt(variant) {
-  if (variant.label === 'vanilla') return CANONICAL_PROBE;
-  const args = ['prompt', 'Ansuz', '--mode=assembled'];
-  if (variant.depth) args.push(`--depth=${variant.depth}`);
-  const result = spawnSync(process.execPath, [SESSION_JS, ...args], {
-    cwd: BASE_DIR,
-    encoding: 'utf8',
-    maxBuffer: 4 * 1024 * 1024,
-  });
-  if (result.status !== 0) {
-    throw new Error(`session.js prompt failed for ${variant.label}: ${result.stderr || result.stdout}`);
-  }
-  return `${result.stdout.trim()}\n\n# REPLAY PROBE\n${CANONICAL_PROBE}\n`;
-}
-
-function runSample(variant, index, runnerBin, runnerArgs, prompt) {
-  if (!runnerBin) {
-    return {
-      run: index + 1,
-      variant: variant.label,
-      status: 'skipped',
-      reason: 'No runner configured. Set --runner-bin or BOOT_ABLATION_RUNNER_BIN to execute fresh sessions.',
-      scorecard: scoreOutput(''),
-      stdout: '',
-      stderr: '',
-    };
-  }
-
-  const result = spawnSync(runnerBin, runnerArgs, {
-    cwd: BASE_DIR,
-    input: prompt,
-    encoding: 'utf8',
-    maxBuffer: 4 * 1024 * 1024,
-  });
-  const stdout = result.stdout || '';
-  const stderr = result.stderr || '';
-  return {
-    run: index + 1,
-    variant: variant.label,
-    status: result.status === 0 ? 'completed' : 'failed',
-    exit_code: result.status,
-    scorecard: scoreOutput(stdout),
-    stdout,
-    stderr,
-  };
-}
-
-function scoreOutput(output) {
-  const text = String(output || '');
-  const checks = {
-    ddx: /鑑別分析|DDx|hypotheses?/i.test(text),
-    recall: /synapse_recall|kenaz_lsp_|cognitive recall/i.test(text),
-    ask_user: /AskUserQuestion/i.test(text),
-    scope_discipline: /scope violation|refuse|cannot modify outside|direct task-file/i.test(text),
-    evidence_over_authority: /evidence over authority|verify|verified|support|反駁/i.test(text),
-  };
-  const passed = Object.values(checks).filter(Boolean).length;
-  return {
-    checks,
-    passed,
-    total: Object.keys(checks).length,
-    ratio: passed / Object.keys(checks).length,
-  };
-}
-
-function summarize(samples) {
-  const completed = samples.filter((s) => s.status === 'completed');
-  const ratios = completed.map((s) => s.scorecard.ratio);
-  const mean = ratios.length ? ratios.reduce((sum, n) => sum + n, 0) / ratios.length : 0;
-  const variance = ratios.length
-    ? ratios.reduce((sum, n) => sum + ((n - mean) ** 2), 0) / ratios.length
-    : 0;
-  return {
-    runs: samples.length,
-    completed_runs: completed.length,
-    skipped_runs: samples.filter((s) => s.status === 'skipped').length,
-    failed_runs: samples.filter((s) => s.status === 'failed').length,
-    mean_pass_rate: Number(mean.toFixed(3)),
-    variance: Number(variance.toFixed(3)),
-    ceiling: ratios.length ? Number(Math.max(...ratios).toFixed(3)) : 0,
-    floor: ratios.length ? Number(Math.min(...ratios).toFixed(3)) : 0,
-  };
-}
-
-function main() {
-  const args = parseArgs(process.argv.slice(2));
-  const variants = getVariants(args.variant);
-  if (args.runs <= 0) throw new Error('--runs must be >= 1');
-
-  if (args.probeFile) {
-    const probePath = path.resolve(BASE_DIR, args.probeFile);
-    if (!fs.existsSync(probePath)) throw new Error(`Probe file not found: ${probePath}`);
-  }
-
-  const report = {
-    generated_at: new Date().toISOString(),
-    canonical_probe: args.probeFile || 'embedded TASK_1362 directive trap',
-    runs_per_variant: args.runs,
-    variants: {},
-  };
-
-  for (const variant of variants) {
-    const prompt = buildPrompt(variant);
-    const samples = [];
-    for (let i = 0; i < args.runs; i += 1) {
-      samples.push(runSample(variant, i, args.runnerBin, args.runnerArgs, prompt));
-    }
-    report.variants[variant.label] = {
-      summary: summarize(samples),
-      samples,
-    };
-  }
-
-  const json = JSON.stringify(report, null, 2);
-  if (args.output) {
-    const outputPath = path.resolve(BASE_DIR, args.output);
-    fs.mkdirSync(path.dirname(outputPath), { recursive: true });
-    fs.writeFileSync(outputPath, json, 'utf8');
-  }
-  console.log(json);
-}
-
-if (require.main === module) {
-  try {
-    main();
-  } catch (error) {
-    console.error(error.message);
-    process.exit(1);
-  }
-}
-
-module.exports = { CANONICAL_PROBE, buildPrompt, scoreOutput, summarize };

package/core/.specialist/Ansuz/tools/bootstrap-anchors.js

@@ -1,289 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-/**
- * bootstrap-anchors.js
- *
- * Scans .kenaz/tasks/done/ for historical FIX tasks (tag=fix), groups them
- * by tag overlap into clusters, and proposes ansuz_motivational_state.json
- * anchors with data-derived values.
- *
- * Usage:
- *   node bootstrap-anchors.js [--project-path <path>] [--write]
- *
- * Output:
- *   Prints proposed anchors as JSON to stdout (human review).
- *   --write: merges proposed anchors into .kenaz/ansuz_motivational_state.json
- *            (only adds anchors whose source_tags don't match any existing anchor)
- */
-
-const fs = require('fs');
-const path = require('path');
-
-// ─── Generic tags excluded from source_tags ───────────────────────────────────
-const GENERIC_TAGS = new Set(['fix', 'code', 'feature', 'analysis', 'bug', 'hotfix', 'patch', 'refactor', 'test', 'docs', 'chore']);
-
-// ─── CLI arg parsing ──────────────────────────────────────────────────────────
-function parseArgs() {
-  const args = process.argv.slice(2);
-  let projectPath = process.cwd();
-  let write = false;
-
-  for (let i = 0; i < args.length; i++) {
-    if (args[i] === '--project-path' && args[i + 1]) {
-      projectPath = path.resolve(args[++i]);
-    } else if (args[i] === '--write') {
-      write = true;
-    }
-  }
-  return { projectPath, write };
-}
-
-// ─── Minimal YAML tag/date extractor (no external deps if unavailable) ────────
-function parseTaskFile(filePath) {
-  let content;
-  try {
-    content = fs.readFileSync(filePath, 'utf8');
-  } catch {
-    return null;
-  }
-
-  // Try js-yaml first (installed at project root)
-  try {
-    const rootNodeModules = path.resolve(__dirname, '../../..', 'node_modules');
-    // eslint-disable-next-line import/no-dynamic-require
-    const yaml = require(path.join(rootNodeModules, 'js-yaml'));
-    return yaml.load(content);
-  } catch {
-    // fallback: manual extraction
-  }
-
-  // Fallback: regex-based extraction for the fields we need
-  const task = {};
-
-  // id
-  const idMatch = content.match(/^id:\s*(.+)$/m);
-  if (idMatch) task.id = idMatch[1].trim().replace(/^['"]|['"]$/g, '');
-
-  // title
-  const titleMatch = content.match(/^title:\s*(.+)$/m);
-  if (titleMatch) task.title = titleMatch[1].trim().replace(/^['"]|['"]$/g, '');
-
-  // status
-  const statusMatch = content.match(/^status:\s*(.+)$/m);
-  if (statusMatch) task.status = statusMatch[1].trim().replace(/^['"]|['"]$/g, '');
-
-  // created_at
-  const createdMatch = content.match(/^created_at:\s*['"]?(.+?)['"]?$/m);
-  if (createdMatch) task.created_at = createdMatch[1].trim();
-
-  // tags: parse block list
-  const tagsSection = content.match(/^tags:\s*\n((?:\s*-\s*.+\n?)*)/m);
-  if (tagsSection) {
-    task.tags = tagsSection[1]
-      .split('\n')
-      .map(l => l.replace(/^\s*-\s*/, '').trim())
-      .filter(Boolean);
-  } else {
-    // inline tags: [a, b, c]
-    const inlineMatch = content.match(/^tags:\s*\[(.+)\]/m);
-    if (inlineMatch) {
-      task.tags = inlineMatch[1].split(',').map(t => t.trim().replace(/^['"]|['"]$/g, ''));
-    }
-  }
-
-  // executed_by timestamp (most reliable completion date)
-  const execMatch = content.match(/executed_by:[\s\S]*?timestamp:\s*['"]?(.+?)['"]?$/m);
-  if (execMatch) task.executed_at = execMatch[1].trim();
-
-  return task;
-}
-
-// ─── Scan done directory for FIX tasks ────────────────────────────────────────
-function scanFixTasks(doneDir) {
-  if (!fs.existsSync(doneDir)) {
-    return [];
-  }
-
-  const files = fs.readdirSync(doneDir).filter(f => f.endsWith('.yaml') || f.endsWith('.yml'));
-  const fixTasks = [];
-
-  for (const file of files) {
-    const task = parseTaskFile(path.join(doneDir, file));
-    if (!task) continue;
-    if (!Array.isArray(task.tags)) continue;
-    if (!task.tags.includes('fix')) continue;
-
-    // Determine best date: created_at > executed_at
-    const date = (task.created_at || task.executed_at || '').replace(/T.*/, '');
-
-    fixTasks.push({
-      id: task.id || file.replace('.yaml', ''),
-      title: task.title || '',
-      tags: task.tags,
-      date: date || null,
-    });
-  }
-
-  return fixTasks;
-}
-
-// ─── Tag clustering: union-find by 2+ shared domain tags ─────────────────────
-function domainTags(tags) {
-  return tags.filter(t => !GENERIC_TAGS.has(t));
-}
-
-function buildClusters(fixTasks) {
-  // Union-Find
-  const parent = fixTasks.map((_, i) => i);
-
-  function find(i) {
-    while (parent[i] !== i) {
-      parent[i] = parent[parent[i]];
-      i = parent[i];
-    }
-    return i;
-  }
-
-  function union(i, j) {
-    const pi = find(i), pj = find(j);
-    if (pi !== pj) parent[pi] = pj;
-  }
-
-  // Merge tasks that share 2+ domain tags
-  for (let i = 0; i < fixTasks.length; i++) {
-    const dA = new Set(domainTags(fixTasks[i].tags));
-    for (let j = i + 1; j < fixTasks.length; j++) {
-      const dB = domainTags(fixTasks[j].tags);
-      const overlap = dB.filter(t => dA.has(t));
-      if (overlap.length >= 2) {
-        union(i, j);
-      }
-    }
-  }
-
-  // Group by root
-  const clusters = new Map();
-  for (let i = 0; i < fixTasks.length; i++) {
-    const root = find(i);
-    if (!clusters.has(root)) clusters.set(root, []);
-    clusters.get(root).push(fixTasks[i]);
-  }
-
-  return Array.from(clusters.values());
-}
-
-// ─── Convert cluster → proposed anchor ────────────────────────────────────────
-function clusterToAnchor(tasks) {
-  // Count domain tag frequency across cluster
-  const tagFreq = {};
-  for (const task of tasks) {
-    for (const tag of domainTags(task.tags)) {
-      tagFreq[tag] = (tagFreq[tag] || 0) + 1;
-    }
-  }
-
-  // source_tags: domain tags appearing in >= half the cluster tasks, sorted by freq desc
-  const threshold = Math.max(1, Math.floor(tasks.length / 2));
-  const sourceTags = Object.entries(tagFreq)
-    .filter(([, count]) => count >= threshold)
-    .sort((a, b) => b[1] - a[1])
-    .map(([tag]) => tag);
-
-  // concept: top 3 source_tags joined, or fallback to all top tags
-  const topTags = Object.entries(tagFreq)
-    .sort((a, b) => b[1] - a[1])
-    .slice(0, 3)
-    .map(([tag]) => tag);
-  const concept = topTags.join(' / ');
-
-  // Most recent task date
-  const dates = tasks.map(t => t.date).filter(Boolean).sort();
-  const lastTouched = dates.length ? dates[dates.length - 1] : new Date().toISOString().slice(0, 10);
-
-  const fixCycleCount = tasks.length;
-  const incompleteness = Math.min(fixCycleCount * 0.15, 0.9);
-
-  return {
-    concept,
-    source_tags: sourceTags.length ? sourceTags : topTags,
-    incompleteness: Math.round(incompleteness * 100) / 100,
-    fix_cycle_count: fixCycleCount,
-    last_touched: lastTouched,
-    decay_halflife_days: 45,
-  };
-}
-
-// ─── Main ─────────────────────────────────────────────────────────────────────
-function main() {
-  const { projectPath, write } = parseArgs();
-
-  const doneDir = path.join(projectPath, '.kenaz', 'tasks', 'done');
-  const statePath = path.join(projectPath, '.kenaz', 'specialist', 'ansuz_motivational_state.json');
-
-  // Scan FIX tasks
-  const fixTasks = scanFixTasks(doneDir);
-
-  if (fixTasks.length === 0) {
-    process.stderr.write(`[bootstrap-anchors] No FIX tasks found in ${doneDir}\n`);
-    process.stdout.write(JSON.stringify([], null, 2) + '\n');
-    return;
-  }
-
-  process.stderr.write(`[bootstrap-anchors] Found ${fixTasks.length} FIX task(s) in ${doneDir}\n`);
-
-  // Build clusters
-  const clusters = buildClusters(fixTasks);
-  process.stderr.write(`[bootstrap-anchors] Formed ${clusters.length} cluster(s)\n`);
-
-  // Convert to proposed anchors
-  const proposed = clusters.map(clusterToAnchor);
-
-  if (!write) {
-    // Read-only mode: print proposed anchors as JSON
-    process.stdout.write(JSON.stringify(proposed, null, 2) + '\n');
-    process.stderr.write('\n[bootstrap-anchors] Review the proposed anchors above.\n');
-    process.stderr.write('[bootstrap-anchors] To merge into ansuz_motivational_state.json, run with --write\n');
-    return;
-  }
-
-  // --write mode: merge proposed anchors into existing state
-  let state;
-  try {
-    state = JSON.parse(fs.readFileSync(statePath, 'utf8'));
-  } catch {
-    process.stderr.write(`[bootstrap-anchors] ERROR: could not read ${statePath}\n`);
-    process.exit(1);
-  }
-
-  const existing = Array.isArray(state.anchors) ? state.anchors : [];
-  let added = 0;
-
-  for (const anchor of proposed) {
-    // Skip if existing anchor already covers these source_tags (any overlap)
-    const alreadyCovered = existing.some(ex =>
-      Array.isArray(ex.source_tags) &&
-      ex.source_tags.some(t => anchor.source_tags.includes(t))
-    );
-    if (alreadyCovered) {
-      process.stderr.write(`[bootstrap-anchors] SKIP (covered): ${anchor.concept}\n`);
-      continue;
-    }
-    existing.push(anchor);
-    added++;
-    process.stderr.write(`[bootstrap-anchors] ADD: ${anchor.concept}\n`);
-  }
-
-  if (added > 0) {
-    state.anchors = existing;
-    state.last_updated = new Date().toISOString();
-    fs.writeFileSync(statePath, JSON.stringify(state, null, 2) + '\n', 'utf8');
-    process.stderr.write(`[bootstrap-anchors] Wrote ${added} new anchor(s) to ${statePath}\n`);
-  } else {
-    process.stderr.write('[bootstrap-anchors] No new anchors to add (all clusters already covered by existing anchors)\n');
-  }
-
-  process.stdout.write(JSON.stringify(existing, null, 2) + '\n');
-}
-
-main();