kenaz 0.3.10 → 0.3.11

package/core/plugins/kenaz/skills/code_reviewer/patterns.yaml

@@ -17,14 +17,6 @@ mutation_counterpart:
   #   orphan = logical state / lifecycle not terminated
 
   pairs:
-    - pair: hippocampus_episode
-      mutation: 'hippocampus_episode_start'
-      counterpart: 'hippocampus_episode_close'
-      severity: leak
-      rationale: 'episode never closed -> consolidation never fires, unarchived memory accumulates'
-      grep_mutation: 'hippocampus_episode_start'
-      grep_counterpart: 'hippocampus_episode_close'
-
     - pair: task_lifecycle
       mutation: 'task-api.js claim'
       counterpart: 'task-api.js complete | task-api.js move'

package/core/plugins/kenaz/skills/dev_agent/SKILL.md

@@ -256,8 +256,6 @@ description: 開發協調、Pipeline管理、任務執行、進度追蹤、Agent
 | `kenaz_lsp_references` | 所有引用 / 修改影響範圍 | 修改前評估 blast radius |
 | `kenaz_lsp_definition` | 定義位置 | 跳到宣告處 |
 | `kenaz_lsp_symbols` | 檔案內 symbol 列表 | 了解檔案結構 |
-| `synapse_recall` | 歷史 rune / 已知風險 | 修改前召回 |
-| `synapse_status` | 記憶系統狀態 | 任務開始前檢查 |
 
 文字與概念搜尋用 Grep / Glob。
 
@@ -281,8 +279,7 @@ description: 開發協調、Pipeline管理、任務執行、進度追蹤、Agent
 **在開始任何開發任務前，建議執行：**
 
 1. **獲取專案 Context**：
-   - 使用 `synapse_status` 了解記憶系統狀態
-   - 使用 `synapse_recall` 召回相關已知風險與決策
+   - 讀取任務卡與 `kenaz learn list` 的相關教訓
 
 2. **搜索相關代碼**：
    - 使用 Grep / Glob 找到相關實現
@@ -335,10 +332,10 @@ description: 開發協調、Pipeline管理、任務執行、進度追蹤、Agent
 2. 重新讀取 Skill 文件
 3. 如果問題持續，直接應用該 Agent 的核心職責邏輯
 
-### LSP / Synapse 查詢失敗時
+### LSP 查詢失敗時
 1. 繼續執行任務（降級為 Grep/Glob）
 2. 確認 Dashboard 已啟動（依賴 Rust HTTP server on port 18080）
-3. 使用 `synapse_status` 檢查記憶系統狀態
+3. 使用 `kenaz_ping` 檢查服務狀態
 
 ---
 

package/lib/cli.js

@@ -234,8 +234,6 @@ async function doctor(p, flags, out, deps = {}) {
   const r = await probe(process.env.KENAZ_HTTP_PORT || '18080');
   let ver = ''; try { ver = JSON.parse(r.body).version; } catch (_) { /* health body is optional */ }
   add('server reachable', r.ok ? 'ok' : 'FAIL', r.detail + (ver ? `, version ${ver}` : ''));
-  // TASK_2390: memory is frozen in the CLI build; 'disabled' is the expected state, never a failure.
-  if (r.ok) { let emb = ''; try { emb = JSON.parse(r.body).embedding || ''; } catch (_) { /* optional */ } add('memory', 'ok', emb === 'disabled' || !emb ? 'disabled (set KENAZ_MEMORY=on to enable)' : `on, embedding ${emb}`); }
 
   const d = dash.detect(p.home, deps.dashboard);
   if (!d.installed) add('dashboard', 'skip', 'no Kenaz Dashboard on this machine');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kenaz",
-  "version": "0.3.10",
+  "version": "0.3.11",
   "description": "Install Kenaz (plugin, hooks, kenaz-server) for Claude Code and Codex: npx kenaz install",
   "bin": {
     "kenaz": "bin/kenaz.js"
@@ -20,11 +20,11 @@
     "test": "node --test lib/cli.test.js"
   },
   "optionalDependencies": {
-    "@kenazai/server-darwin-arm64": "0.3.10",
-    "@kenazai/server-darwin-x64": "0.3.10",
-    "@kenazai/server-linux-arm64": "0.3.10",
-    "@kenazai/server-linux-x64": "0.3.10",
-    "@kenazai/server-win32-x64": "0.3.10"
+    "@kenazai/server-darwin-arm64": "0.3.11",
+    "@kenazai/server-darwin-x64": "0.3.11",
+    "@kenazai/server-linux-arm64": "0.3.11",
+    "@kenazai/server-linux-x64": "0.3.11",
+    "@kenazai/server-win32-x64": "0.3.11"
   },
   "license": "UNLICENSED",
   "repository": {

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

@@ -1,188 +0,0 @@
-#!/usr/bin/env node
-/**
- * handoff-snapshot-on-decision.js — PostToolUse hook for synapse_inscribe (TASK_1400)
- *
- * Fires after mcp__kenaz-dashboard__synapse_inscribe when the inscribed rune type
- * is one of: decision, risk, ash. Insight/pattern/fix/summary inscribes do NOT
- * fire (too noisy). Includes rune_id in the nudge.
- * 5-minute dedup keyed on rune_id (or normalized content hash if rune_id absent).
- *
- * Matcher: mcp__kenaz-dashboard__synapse_inscribe
- */
-'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 = 'inscribe:';
-
-// Only these rune types trigger the nudge
-const TRIGGER_TYPES = new Set(['decision', 'risk', 'ash']);
-
-function readStdin() {
-  try {
-    return JSON.parse(fs.readFileSync(0, 'utf8').trim() || '{}');
-  } catch {
-    return {};
-  }
-}
-
-function extractInscribeType(payload) {
-  // Type can be in tool_input or inferred from response
-  return (
-    payload?.tool_input?.type ||
-    payload?.toolInput?.type ||
-    null
-  );
-}
-
-function extractRuneId(payload) {
-  // rune_id appears in the tool_response from synapse_inscribe
-  try {
-    const resp =
-      payload?.tool_response ||
-      payload?.tool_result;
-    if (!resp) return null;
-
-    // Attempt to parse text content as JSON
-    let text = '';
-    if (typeof resp === 'string') {
-      text = resp;
-    } else if (resp?.content && Array.isArray(resp.content)) {
-      text = resp.content.map(c => c?.text || '').join('');
-    } else if (typeof resp === 'object') {
-      text = JSON.stringify(resp);
-    }
-
-    // Try JSON parse first
-    try {
-      const parsed = JSON.parse(text);
-      if (parsed?.rune_id) return parsed.rune_id;
-      if (parsed?.id) return parsed.id;
-    } catch { /* not JSON */ }
-
-    // Fallback: regex extract
-    const m = text.match(/"rune_id"\s*:\s*"([^"]+)"/);
-    if (m) return m[1];
-    const m2 = text.match(/"id"\s*:\s*"([^"]+)"/);
-    if (m2) return m2[1];
-    return null;
-  } catch {
-    return null;
-  }
-}
-
-function normalizeKey(runeId, type, content) {
-  if (runeId) return runeId;
-  // Fallback: hash of type+content snippet
-  const snippet = `${type}:${(content || '').substring(0, 40)}`;
-  return snippet.replace(/\s+/g, '_');
-}
-
-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();
-  const inscribeType = extractInscribeType(payload);
-
-  // Only fire for decision/risk/ash types
-  if (!inscribeType || !TRIGGER_TYPES.has(inscribeType)) {
-    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 runeId = extractRuneId(payload);
-  const content = payload?.tool_input?.content || payload?.toolInput?.content || '';
-  const dedupKey = DEDUP_KEY_PREFIX + normalizeKey(runeId, inscribeType, content);
-  const suppressed = isDeduped(dedupKey);
-
-  appendTelemetry({
-    timestamp: new Date().toISOString(),
-    timestamp_ms: Date.now(),
-    hook: 'handoff-snapshot-on-decision',
-    dedup_key: dedupKey,
-    inscribe_type: inscribeType,
-    rune_id: runeId,
-    suppressed,
-  });
-
-  if (suppressed) {
-    process.exit(0);
-  }
-
-  const runeRef = runeId ? ` (rune_id: ${runeId})` : '';
-
-  // Auto-write the handoff (system-level enforcement, instance-independent).
-  // TASK_1837: pass NO --last-milestone. The old value ('<type> rune inscribed')
-  // carried zero information and became the slot's current_topic, clobbering the
-  // real work topic (measured 2026-07-31: 5 of 8 orphan slots had it as topic —
-  // garbage inherited by the next session). With no milestone the snapshot CLI
-  // derives the topic from the latest commit subject: actual work content. The
-  // rune reference stays in the stdout nudge below, where it is useful.
-  invokeHandoffSnapshot('live_decision_point', null, payload.session_id, payload.transcript_path);
-
-  process.stdout.write(
-    '\n' + fenceSignal('handoff', `🔁 ${inscribeType} rune inscribed${runeRef}. Handoff auto-snapshot dispatched (live_decision_point).`) + '\n'
-  );
-}
-
-main();

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/.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,
-};