kenaz 0.3.10 → 0.3.12

package/core/.claude/skills/synapse_maintain/SKILL.md

@@ -1,84 +0,0 @@
-# synapse_maintain
-
-Unified Synapse maintenance checkpoint for agent-facing health reviews.
-
-## when_to_call
-
-- Phase 2 research: run before planning when the task depends on current codebase health, stale cognition, or cleanup priority.
-- Cognitive checkpoint: run after a risky implementation burst to see whether new gaps, conflicts, or stale runes appeared.
-- Session end: run before handoff so the next agent receives a single dashboard instead of seven separate tool calls.
-
-## tool
-
-Call `synapse_maintain` with:
-
-```json
-{
-  "projectPath": "<worktree-or-project-path>",
-  "top_n": 5
-}
-```
-
-## sections
-
-### orphans
-
-- Meaning: code symbols that look unreachable and may be removable.
-- Read it as: high count + high removal impact means cleanup can simplify the graph quickly.
-- Follow-up: inspect candidates before deletion; route handlers and command entry points can still be legitimate.
-- Rune guidance: inscribe `fix` after a confirmed deletion or `risk` when a false-positive pattern is discovered.
-
-### stale_runes
-
-- Meaning: runes whose attached symbols drifted heavily or disappeared from the graph.
-- Read it as: `auto_rejected` is urgent because memory was already invalidated; `needs_review` means knowledge may be stale.
-- Follow-up: refresh or supersede outdated runes before using them in planning.
-- Rune guidance: inscribe `decision` when you intentionally keep a flagged rune valid, or `fix` when you replace stale guidance.
-
-### conflicts
-
-- Meaning: contradictory runes on the same symbol or within the same sigil.
-- Read it as: any `high` conflict blocks blind trust in recall results.
-- Follow-up: verify, reject, or supersede conflicting runes before further automation.
-- Rune guidance: inscribe `decision` with the resolved interpretation after adjudicating the conflict.
-
-### gaps
-
-- Meaning: heavily used symbols with no cognitive memory.
-- Read it as: these are high-leverage documentation targets, especially when danger score is high.
-- Follow-up: inspect the top hotspots and inscribe only non-obvious behavior, risks, or design choices.
-- Rune guidance: inscribe `insight`, `risk`, or `summary` depending on the symbol and what was learned.
-
-### pain_paths
-
-- Meaning: long call chains crossing too many community boundaries.
-- Read it as: repeated community crossings usually signal architecture drag rather than a single bug.
-- Follow-up: use the chain preview to decide where a facade, shortcut, or boundary cleanup would reduce coupling.
-- Rune guidance: inscribe `risk` when a path is fragile, or `decision` when you adopt a refactoring boundary.
-
-### overdue_episodes
-
-- Meaning: closed episodes with high consolidation scores that still need memory compression or review.
-- Read it as: these sessions contain learnings that are likely to be lost unless consolidated.
-- Follow-up: consolidate, summarize key facts, or extract repeatable lessons.
-- Rune guidance: inscribe `ash` only after a stable cross-session lesson is clear.
-
-### audit_summary
-
-- Meaning: anomaly rule findings from the structural audit engine.
-- Read it as: `high` findings are active breakage or architectural risk; `medium` usually deserves planned follow-up.
-- Follow-up: treat the file paths as the first investigation slice, not as automatic proof.
-- Rune guidance: inscribe `fix` after resolving a confirmed audit issue, or `risk` if a known anomaly must remain temporarily.
-
-## interpretation
-
-- `severity=high` means act before more feature work if the section affects active scope.
-- `severity=medium` means plan remediation or inscribe context before handing off.
-- `severity=low` means no urgent action, but keep the diagnosis in the task summary if it influenced decisions.
-- If a section is `degraded`, treat the diagnosis as tool coverage failure, not proof that the codebase is healthy.
-
-## output_discipline
-
-- Do not summarize the dashboard as "all green" unless every section is both `status=ok` and `severity=low`.
-- If `items` is empty but `status=degraded`, report the error explicitly; degraded sections are not passes.
-- Prefer one follow-up rune with high confidence over bulk inscription from raw dashboard findings.

package/core/.collaboration/core/task-2264-single-after-capture.test.js

@@ -1,61 +0,0 @@
-// TASK_2264 — completeTask must schedule exactly ONE 'after' health capture.
-// moveTask used to schedule a detached 'after' capture on every ->done move even when
-// completeTask's own postComplete was about to measure the same snapshot.
-// Counting seam: child_process.spawn is patched (task-api requires it at call time) and
-// calls whose inline script carries phase "after" are counted. Isolated temp project.
-// Usage: node .collaboration/core/task-2264-single-after-capture.test.js
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-const cp = require('child_process');
-const { TaskAPI, toYAML } = require('./task-api.js');
-
-const SB = fs.mkdtempSync(path.join(os.tmpdir(), 't2264_'));
-const tasksDir = path.join(SB, '.kenaz', 'tasks');
-for (const d of ['backlog', 'active', 'done', 'blocked', 'cancel', 'archived']) fs.mkdirSync(path.join(tasksDir, d), { recursive: true });
-delete process.env.FORMATION_SCHEDULER; delete process.env.FORMATION_HEADLESS;
-
-let pass = 0, fail = 0;
-const check = (n, c, d) => { console.log((c ? 'PASS' : 'FAIL') + ' | ' + n + (c ? '' : ' | ' + d)); c ? pass++ : fail++; };
-
-let phases = [];
-const realSpawn = cp.spawn;
-cp.spawn = function (cmd, argv, opts) {
-  const script = Array.isArray(argv) ? argv.find(a => typeof a === 'string' && a.includes('const CFG')) : null;
-  if (script) {
-    const m = script.match(/"phase":"(before|after)"/);
-    phases.push(m ? m[1] : '?');
-    return { unref() {}, on() {} };
-  }
-  return realSpawn.apply(this, arguments);
-};
-
-const mkActive = (id) => fs.writeFileSync(path.join(tasksDir, 'active', id + '_t.yaml'),
-  toYAML({ id, title: 't2264 ' + id, priority: 'P2', status: 'in_progress' }));
-
-(async () => {
-  const api = new TaskAPI({ tasksDir, projectPath: SB });
-  try {
-    // A: complete with post-complete running in-process (dry run, no git/archive) -> post-complete owns 'after'
-    mkActive('TASK_9001'); phases = [];
-    await api.completeTask('TASK_9001', { dryRun: true, skipGit: true, skipArchive: true });
-    check('A complete w/ post-complete: moveTask schedules NO after capture', phases.filter(p => p === 'after').length === 0, JSON.stringify(phases));
-
-    // B control: post-complete skipped -> nobody else measures, moveTask must still capture exactly once
-    mkActive('TASK_9002'); phases = [];
-    await api.completeTask('TASK_9002', { skipPostComplete: true });
-    check('B control: complete w/ skipPostComplete schedules exactly 1 after capture', phases.filter(p => p === 'after').length === 1, JSON.stringify(phases));
-
-    // C control: bare move done (no post-complete) keeps its single capture
-    mkActive('TASK_9003'); phases = [];
-    await api.moveTask('TASK_9003', 'done');
-    check('C control: bare move done schedules exactly 1 after capture', phases.filter(p => p === 'after').length === 1, JSON.stringify(phases));
-  } catch (e) {
-    check('no exception', false, e && e.stack);
-  } finally {
-    cp.spawn = realSpawn;
-    try { fs.rmSync(SB, { recursive: true, force: true }); } catch { /* best effort */ }
-  }
-  console.log(`\n${pass} passed, ${fail} failed`);
-  process.exit(fail ? 1 : 0);
-})();

package/core/.formation/tools/alaya-gate.js

@@ -1,198 +0,0 @@
-// TASK_2104: shared, dependency-free Alaya relevance gate — extracted out
-// of prompt.js so task-api.js's echoAlayaLessons (TASK_1992) applies the
-// same TASK_2101 cosine-floor + stack-match gate instead of a hand-copied
-// near-duplicate that had neither. Zero deps (no memory-loader/core-resolve)
-// so it still require()s from a sub-project with no .formation/ checkout —
-// callers must treat a require() failure as "gate unavailable" and degrade
-// gracefully (see task-api.js echoAlayaLessons).
-// Shared by: prompt.js appendAlayaLessons(), task-api.js echoAlayaLessons().
-
-'use strict';
-
-/**
- * Build the cross-project context query shared by Cortex and Alaya lookups:
- * scope_paths basenames (extension stripped) + up to 4 non-stop-word
- * keywords from the task title.
- *
- * @param {string|object} taskData - task JSON string or parsed object
- * @returns {string|null} the query string, or null when nothing to query
- */
-function buildTaskContextQuery(taskData) {
-  let scopePaths = [];
-  let taskTitle = '';
-  try {
-    const parsed = typeof taskData === 'string' ? JSON.parse(taskData) : taskData;
-    if (parsed) {
-      scopePaths = parsed.scope_paths || [];
-      taskTitle = parsed.title || '';
-    }
-  } catch { /* taskData not JSON, skip */ }
-
-  if (scopePaths.length === 0 && !taskTitle) return null;
-
-  // Build query from scope_paths file names + task title keywords
-  const queryParts = [];
-  for (const sp of scopePaths) {
-    const parts = String(sp).replace(/\\/g, '/').split('/');
-    const last = parts[parts.length - 1].replace(/\.[^.]+$/, '');
-    if (last && last.length > 2) queryParts.push(last);
-  }
-  if (taskTitle) {
-    const stopWords = new Set(['the','a','an','is','are','to','of','and','in','for','on','at','by','with','fix','task','add','update']);
-    const words = taskTitle.replace(/[^a-zA-Z0-9_\s]/g, ' ').split(/\s+/).filter(w => w.length > 2 && !stopWords.has(w.toLowerCase()));
-    queryParts.push(...words.slice(0, 4));
-  }
-  if (queryParts.length === 0) return null;
-
-  return [...new Set(queryParts)].join(' ');
-}
-
-// TASK_2101: absolute relevance gate for Alaya lesson injection.
-//
-// Why: alaya_recall's only pre-2101 score is RRF rank fusion (~0.016-0.032),
-// which carries no absolute relevance — lexical overlap on a single common
-// word ("checkpoint", "gate") was enough to rank a bija first regardless of
-// domain. Every bija also had source_count=1 (hub distiller not implemented),
-// so nothing self-corrects via aggregation either. The fix is two gates that
-// must BOTH pass before a bija is even a candidate for injection:
-//   1. cosine floor — the RAW semantic cosine (never the RRF score) must
-//      clear ALAYA_MIN_COSINE_DEFAULT. A bija the semantic arm never scored
-//      (cosine=null: fts-only hit, or bija has no embedding yet) fails the
-//      floor by construction — an unverifiable relevance is not a floor pass.
-//   2. stack match — the bija's coarse tech stack (source_symbol's file
-//      extension/dir, plus tags) must overlap the task's (scope_paths'
-//      extensions/dirs), UNLESS the cosine is very high
-//      (>= ALAYA_STACK_OVERRIDE_COSINE) — a strong enough semantic match can
-//      override a stack that a coarse heuristic failed to resolve.
-//
-// Calibration (R4, measured 2026-09-28 against the live backend, 5 real
-// dispatch queries x top-10 semantic hits = 50 bijas, hand-labelled):
-//   - ArcticEmbedXs cosines are compressed high: clearly irrelevant noise
-//     (payment/CRM/UI-colour/backtest seeds on Rust and JS infra cards)
-//     scored 0.656-0.697; on-topic bijas scored 0.709-0.810. 0.45 (the
-//     earlier placeholder) passed all 50, i.e. it was not a filter at all.
-//   - Confusion at 0.45: 20 on-topic kept, 30 noise kept. At 0.70: 20 kept,
-//     0 noise. The margin is only ~0.012, so treat 0.70 as fitted to a small
-//     sample and re-measure when the bija population changes.
-//   - The stack half of the gate currently has no real signal: every live
-//     bija has source_symbol='' (hub predates the pass-through) and `tags`
-//     are content word-bags, not stack labels. In practice a bija on a task
-//     with scope_paths passes only at >= ALAYA_STACK_OVERRIDE_COSINE (0.8),
-//     so today's effective floor for scoped tasks is 0.8 and 0.70 applies to
-//     unscoped tasks. A3 check (dispatch --dry-run on TASK_2096/2097/2100):
-//     10/10 candidates dropped on each; no noise injected.
-//   - Also seen: the on-topic hits were near-duplicates (8-9 copies of one
-//     "community detection void" / "KuzuDB graph broken" observation) and
-//     months stale (the conditions they describe are fixed). Relevance is
-//     not the only gap: dedup (distiller) and retraction are next.
-const ALAYA_MIN_COSINE_DEFAULT = 0.70;
-const ALAYA_STACK_OVERRIDE_COSINE = 0.8;
-// Candidate pool requested from alaya_recall — wider than the render cap (3)
-// so post-filtering by the two gates still has real candidates to keep.
-const ALAYA_CANDIDATE_POOL = 10;
-
-/**
- * Coarse stack tokens (lowercase file extensions + 1-2 top path segments)
- * from a list of paths. Shared by the task side (scope_paths) and the bija
- * side (source_symbol's `{file_path}:{symbol}:{kind}` shape, split on ':').
- *
- * @param {string} normPath - a single '/'-normalised path
- * @param {Set<string>} tokens - mutated in place
- */
-function addStackTokens(normPath, tokens) {
-  if (!normPath) return;
-  const extMatch = normPath.match(/\.([a-zA-Z0-9]+)$/);
-  if (extMatch) tokens.add(extMatch[1].toLowerCase());
-  const parts = normPath.split('/').filter(Boolean);
-  if (parts.length > 0) tokens.add(parts[0].toLowerCase());
-  if (parts.length > 1) tokens.add(`${parts[0]}/${parts[1]}`.toLowerCase());
-}
-
-/**
- * Derive the task's coarse stack from its scope_paths (file extensions +
- * top-level dirs, e.g. {'rs', 'js', 'dashboard', '.formation/tools'}).
- * @param {string[]} scopePaths
- * @returns {Set<string>}
- */
-function deriveTaskStack(scopePaths) {
-  const tokens = new Set();
-  for (const sp of scopePaths || []) {
-    addStackTokens(String(sp).replace(/\\/g, '/'), tokens);
-  }
-  return tokens;
-}
-
-/**
- * Derive a bija's coarse stack from its tags (comma-separated string, as
- * returned by alaya_recall) and its source_symbol (TASK_2101 — hub
- * pass-through of the originating rune's symbol_stable_id; empty for hubs
- * that predate the field, or project-level seeds with no single symbol).
- * @param {object} bija
- * @returns {Set<string>}
- */
-function deriveBijaStack(bija) {
-  const tokens = new Set();
-  for (const t of String(bija.tags || '').split(',')) {
-    const tag = t.trim().toLowerCase();
-    if (tag) tokens.add(tag);
-  }
-  const sourceSymbol = String(bija.source_symbol || '');
-  if (sourceSymbol) {
-    const filePath = sourceSymbol.split(':')[0].replace(/\\/g, '/');
-    addStackTokens(filePath, tokens);
-  }
-  return tokens;
-}
-
-/**
- * Whether a bija passes the TASK_2101 relevance gate: cosine floor AND
- * (stack overlap OR a cosine high enough to override a stack miss).
- * A task with no derivable stack (empty scope_paths) cannot be judged on
- * stack at all, so the stack half of the gate is skipped — the floor alone
- * still applies.
- *
- * @param {object} bija - one alaya_recall result (cosine, tags, source_symbol, ...)
- * @param {Set<string>} taskStack - from deriveTaskStack
- * @param {number} floor - ALAYA_MIN_COSINE_DEFAULT (or an override)
- * @returns {boolean}
- */
-function passesAlayaRelevanceGate(bija, taskStack, floor) {
-  const cosine = typeof bija.cosine === 'number' ? bija.cosine : null;
-  if (cosine === null || cosine < floor) return false;
-  if (taskStack.size === 0) return true; // no task-side stack signal to judge against
-  if (cosine >= ALAYA_STACK_OVERRIDE_COSINE) return true;
-  const bijaStack = deriveBijaStack(bija);
-  for (const tok of bijaStack) {
-    if (taskStack.has(tok)) return true;
-  }
-  return false;
-}
-
-/**
- * Dedup a list of alaya_recall bijas: key = id, else first 100 chars of
- * content. Shared by prompt.js's appendAlayaLessons and task-api.js's
- * echoAlayaLessons — both queried the same hub, so the same duplicate hubs
- * (near-identical seeds re-inscribed by different sources) can show up.
- *
- * @param {object[]} bijas
- * @returns {object[]}
- */
-function dedupBijas(bijas) {
-  const seen = new Set();
-  return (bijas || []).filter(b => {
-    const key = b.id || (b.content || '').slice(0, 100);
-    if (!key || seen.has(key)) return false;
-    seen.add(key); return true;
-  });
-}
-
-module.exports = {
-  buildTaskContextQuery,
-  deriveTaskStack,
-  deriveBijaStack,
-  passesAlayaRelevanceGate,
-  dedupBijas,
-  ALAYA_MIN_COSINE_DEFAULT,
-  ALAYA_STACK_OVERRIDE_COSINE,
-  ALAYA_CANDIDATE_POOL,
-};