@mindrian_os/install 1.13.0-beta.16 → 1.13.0-beta.19

package/hooks/hooks.json

@@ -18,88 +18,10 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/operator-update.cjs\"",
-            "timeout": 3000
-          }
-        ]
-      },
-      {
-        "matcher": "startup|clear|compact",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/memory-resume-nudge.cjs\"",
-            "timeout": 3000
-          }
-        ]
-      },
-      {
-        "matcher": "startup|clear|compact",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/migrate-stale-user-settings.cjs\" --auto --quiet",
-            "timeout": 2000
-          }
-        ]
-      },
-      {
-        "matcher": "startup|clear|compact",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/statusline-fallback-echo.cjs\"",
-            "timeout": 2000
-          }
-        ]
-      },
-      {
-        "matcher": "startup|clear|compact",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/check-onboard-statusline.cjs\"",
-            "timeout": 2000
-          }
-        ]
-      },
-      {
-        "matcher": "startup|clear|compact",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/preflight-tension-surface.cjs\"",
-            "timeout": 3000
-          }
-        ]
-      },
-      {
-        "matcher": "startup|clear|compact",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/preflight-doctor.cjs\"",
-            "timeout": 2000
-          }
-        ]
-      },
-      {
-        "matcher": "startup|clear|compact",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/preflight-release-drift.cjs\"",
-            "timeout": 2000
-          }
-        ]
-      },
-      {
-        "matcher": "startup|clear|compact",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/preflight-auto-explore.cjs\"",
-            "timeout": 3000
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/sessionstart-coordinator.cjs\"",
+            "timeout": 10000,
+            "async": false,
+            "statusMessage": "Loading room context..."
           }
         ]
       },
@@ -108,8 +30,10 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/restore-post-compact-context.cjs\"",
-            "timeout": 3000
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/sessionstart-npm-reconcile.cjs\"",
+            "timeout": 60000,
+            "async": true,
+            "statusMessage": "Reconciling dependencies..."
           }
         ]
       },
@@ -118,10 +42,10 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/sessionstart-npm-reconcile.cjs\"",
-            "timeout": 60000,
-            "async": true,
-            "statusMessage": "Reconciling dependencies..."
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/check-pending-breakthrough.cjs\"",
+            "timeout": 2000,
+            "async": false,
+            "statusMessage": "Scanning for breakthroughs..."
           }
         ]
       }
@@ -280,6 +204,16 @@
             "timeout": 3000
           }
         ]
+      },
+      {
+        "matcher": "SlashCommand",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/telemetry-command-invocation.cjs\"",
+            "timeout": 5000
+          }
+        ]
       }
     ],
     "UserPromptSubmit": [
@@ -292,6 +226,15 @@
           }
         ]
       },
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/mva-detect.cjs\"",
+            "timeout": 1500
+          }
+        ]
+      },
       {
         "hooks": [
           {

package/lib/agents/auto-explore-agent.cjs

@@ -46,6 +46,26 @@ const path = require('node:path');
 const crypto = require('node:crypto');
 const store = require('../memory/explored-materials-store.cjs');
 
+// Phase 121-02 D-06: vocabulary maps for unified auto_explore_decision emit.
+// Phase 117 source_pipeline {domain, reverse-salients, cross-domain}
+//   -> unified finding_type {whitespace, reverse_salient, cross_domain}.
+// Phase 117 F.1 verbs {EXPLORE, LATER, SKIP}
+//   -> unified user_response {kept, redid, ignored}.
+// FREE_TEXT is intentionally EXCLUDED -- it is a system fallback when the
+// navigator types prose; it is not a clean engagement signal.
+// auto_explore_skipped (system-driven suppress paths) is also EXCLUDED --
+// those fire from emitSkipped, never from handleUserResponse.
+const D06_FINDING_TYPE_MAP = Object.freeze({
+  'domain':           'whitespace',
+  'reverse-salients': 'reverse_salient',
+  'cross-domain':     'cross_domain',
+});
+const D06_USER_RESPONSE_MAP = Object.freeze({
+  EXPLORE: 'kept',
+  LATER:   'redid',
+  SKIP:    'ignored',
+});
+
 // ---------- Constants ----------
 
 const MATERIAL_ID_LEN = 32;
@@ -773,6 +793,36 @@ function handleUserResponse(args) {
       });
     } catch (_e) { /* never throw on telemetry */ }
 
+    // Phase 121-02 D-06: capture user F.1 decision into the unified
+    // ~/.mindrian/telemetry/v1.13/events-YYYY-WNN.jsonl stream (Plan 121-00
+    // writer chokepoint). Emit ONLY for the 3 engagement verbs
+    // (EXPLORE -> kept, LATER -> redid, SKIP -> ignored). FREE_TEXT is a
+    // system fallback and is intentionally excluded. auto_explore_skipped
+    // (fingerprint/fire suppress paths) is NEVER routed through this
+    // function and therefore cannot emit auto_explore_decision either.
+    // Non-blocking: try/catch swallows any writer breach so the handler
+    // still returns ok:true to its caller (the F.1 surface).
+    try {
+      if (D06_USER_RESPONSE_MAP[userResponse]) {
+        let writer = null;
+        try { writer = require('../core/telemetry/writer.cjs'); } catch (_e) { writer = null; }
+        if (writer && typeof writer.emit === 'function') {
+          const findingType = D06_FINDING_TYPE_MAP[String(finding.source_pipeline || '')] || 'whitespace';
+          const score = (typeof finding.score === 'number' && Number.isFinite(finding.score))
+            ? finding.score
+            : 0;
+          const slugSrc = String(roomSlug || (roomDir ? path.basename(roomDir) : '')).slice(0, 256);
+          const slugHash = crypto.createHash('sha256').update(slugSrc).digest('hex');
+          writer.emit('auto_explore_decision', {
+            finding_type: String(findingType).slice(0, 64),
+            user_response: D06_USER_RESPONSE_MAP[userResponse],
+            domain_match_score: score,
+            room_slug_sha256: slugHash,
+          });
+        }
+      }
+    } catch (_e) { /* never throw on telemetry */ }
+
     return {
       ok: true,
       response: userResponse,
@@ -1014,6 +1064,36 @@ function _resetDriftCacheForTests() {
   _driftEmittedThisSession = false;
 }
 
+/**
+ * Phase 119-00 helper: read $ROOMS_HOME/.rooms/registry.json and return true
+ * iff there is no active room (registry missing OR registry.active is empty
+ * string).
+ *
+ * Used by scripts/auto-explore-fingerprint.cjs to decide whether to call
+ * lib/core/room-auto-create.cjs::autoCreatePlaceholderRoom as a sibling action.
+ *
+ * Per CONTEXT.md D-01: only the "first material lands AND no active room"
+ * configuration triggers auto-create. An active room means the user already
+ * chose a room; never overwrite.
+ *
+ * Pure file-read; no network, no Brain MCP. Canon Part 8 boundary preserved.
+ *
+ * @param {string} roomsHome  absolute path to $ROOMS_HOME (or $MINDRIAN_ROOMS_HOME)
+ * @returns {boolean}
+ */
+function detectNoActiveRoom(roomsHome) {
+  if (!roomsHome || typeof roomsHome !== 'string') return true;
+  const registryPath = path.join(roomsHome, '.rooms', 'registry.json');
+  try {
+    if (!fs.existsSync(registryPath)) return true;
+    const raw = fs.readFileSync(registryPath, 'utf8');
+    const reg = JSON.parse(raw);
+    return !(reg && typeof reg.active === 'string' && reg.active.length > 0);
+  } catch (_e) {
+    return true; // unreadable registry -> treat as no-active-room (fail-open to auto-create)
+  }
+}
+
 // ---------- Module exports ----------
 
 module.exports = {
@@ -1033,6 +1113,8 @@ module.exports = {
   emitSkipped,
   emitSanitizerHit,
   emitBrainCanonDrift,
+  // Phase 119-00 sibling helper (D-01 invariant check for the auto-create hook):
+  detectNoActiveRoom,
   // Constants:
   BQ_TEMPLATE_REGISTRY,
   CANONICAL_CHAIN_ORDER,

package/lib/agents/mva/brain-classic-traps.cjs

@@ -0,0 +1,77 @@
+/*
+ * Copyright (c) 2026 Mindrian. BSL 1.1.
+ *
+ * Phase 118-02 Plan 02 Task 1 -- brain-classic-traps agent (Agent 3 of 6 in
+ * B1; agent_id 'brain_classic_traps' in lib/agents/mva/index.cjs).
+ *
+ * Calls Brain via lib/core/brain-client.cjs::query() with a GENERIC Cypher
+ * template from data/mva-agent-prompts.json. Returns top-1 FailureMode pattern
+ * with a "Classic trap:" summary line.
+ *
+ * Graph-native HARD RULES (memory feedback_reverse_salient_agent_graph_native.md):
+ *   1. NEVER require room-db.cjs directly (Phase 109 D-06 chokepoint).
+ *   2. NEVER require any Brain-MCP client module DIRECTLY for raw queries;
+ *      use lib/core/brain-client.cjs which enforces the wire-schema sanitization
+ *      AND only with framework-name/phase-id/enum args, never user content.
+ *   3. NEVER write to stdout / stderr (telemetry side-channel rule).
+ *
+ * Canon Part 8 hard invariant (MVA-118-10):
+ *   The Cypher carries ONLY $-bound parameters with hardcoded stage labels.
+ *   NEVER the user's raw sentence. NEVER the sentence_sha256 as a Cypher
+ *   string interpolation. NEVER any user-content env var (token name elided
+ *   per the Test 6 grep regression).
+ *
+ * Pure CJS, node built-ins only, zero new runtime dependencies.
+ */
+'use strict';
+
+const path = require('node:path');
+const brainClient = require('../../core/brain-client.cjs');
+
+const PROMPTS_PATH = path.resolve(__dirname, '..', '..', '..', 'data', 'mva-agent-prompts.json');
+
+/**
+ * @param {{ sentence_sha256: string, remaining_budget_ms: number }} _context
+ * @param {AbortSignal} signal
+ * @returns {Promise<{ status:'ok'|'empty', payload:any } | null>}
+ */
+async function run(_context, signal) {
+  if (!brainClient.isAvailable()) {
+    return { status: 'empty', payload: { reason: 'brain_unavailable' } };
+  }
+  if (signal && signal.aborted) return null;
+
+  let prompts;
+  try {
+    prompts = require(PROMPTS_PATH).brain_classic_traps;
+  } catch (_e) {
+    return { status: 'empty', payload: { reason: 'prompts_unavailable' } };
+  }
+
+  let result;
+  try {
+    result = await brainClient.query(prompts.cypher, prompts.params);
+  } catch (_e) {
+    return { status: 'empty', payload: { reason: 'brain_error' } };
+  }
+
+  if (signal && signal.aborted) return null;
+
+  const records = (result && Array.isArray(result.records)) ? result.records : [];
+  if (records.length === 0) {
+    return { status: 'empty', payload: { reason: 'no_trap' } };
+  }
+  const trap = records[0];
+  const tail = trap.signature || 'classic failure pattern';
+  const summary = 'Classic trap: ' + (trap.name || 'unnamed') + ' -- ' + tail;
+
+  return {
+    status: 'ok',
+    payload: {
+      summary_line: summary,
+      deck_data: { trap: trap },
+    },
+  };
+}
+
+module.exports = { run };

package/lib/agents/mva/brain-cross-domain.cjs

@@ -0,0 +1,79 @@
+/*
+ * Copyright (c) 2026 Mindrian. BSL 1.1.
+ *
+ * Phase 118-02 Plan 02 Task 1 -- brain-cross-domain agent (Agent 2 of 6 in
+ * B1; agent_id 'brain_cross_domain' in lib/agents/mva/index.cjs).
+ *
+ * Calls Brain via lib/core/brain-client.cjs::search() in cross-domain mode
+ * (GENERIC handle from data/mva-agent-prompts.json) and returns top-1
+ * analogous framework with a one-line "Cross-domain analogy:" summary.
+ *
+ * Graph-native HARD RULES (memory feedback_reverse_salient_agent_graph_native.md):
+ *   1. NEVER require room-db.cjs directly (Phase 109 D-06 chokepoint).
+ *   2. NEVER require any Brain-MCP client module DIRECTLY for raw queries;
+ *      use lib/core/brain-client.cjs which enforces the wire-schema sanitization
+ *      AND only with framework-name/phase-id/enum args, never user content.
+ *   3. NEVER write to stdout / stderr (telemetry side-channel rule).
+ *
+ * Canon Part 8 hard invariant (MVA-118-09):
+ *   The Brain query carries ONLY a hardcoded generic handle. NEVER the user's
+ *   raw sentence. NEVER the sentence_sha256 as a free-text query body. NEVER
+ *   any user-content env var (token name elided per the Test 6 grep regression).
+ *
+ * Pure CJS, node built-ins only, zero new runtime dependencies.
+ */
+'use strict';
+
+const path = require('node:path');
+const brainClient = require('../../core/brain-client.cjs');
+
+const PROMPTS_PATH = path.resolve(__dirname, '..', '..', '..', 'data', 'mva-agent-prompts.json');
+
+/**
+ * @param {{ sentence_sha256: string, remaining_budget_ms: number }} _context
+ * @param {AbortSignal} signal
+ * @returns {Promise<{ status:'ok'|'empty', payload:any } | null>}
+ */
+async function run(_context, signal) {
+  if (!brainClient.isAvailable()) {
+    return { status: 'empty', payload: { reason: 'brain_unavailable' } };
+  }
+  if (signal && signal.aborted) return null;
+
+  let prompts;
+  try {
+    prompts = require(PROMPTS_PATH).brain_cross_domain;
+  } catch (_e) {
+    return { status: 'empty', payload: { reason: 'prompts_unavailable' } };
+  }
+
+  let result;
+  try {
+    result = await brainClient.search(prompts.query, {
+      filters: prompts.filters,
+      limit: prompts.limit,
+    });
+  } catch (_e) {
+    return { status: 'empty', payload: { reason: 'brain_error' } };
+  }
+
+  if (signal && signal.aborted) return null;
+
+  const analogies = (result && Array.isArray(result.results)) ? result.results : [];
+  if (analogies.length === 0) {
+    return { status: 'empty', payload: { reason: 'no_analogy' } };
+  }
+  const analogy = analogies[0];
+  const tail = analogy.signature || 'pattern transfer applicable';
+  const summary = 'Cross-domain analogy: ' + (analogy.name || 'unnamed') + ' -- ' + tail;
+
+  return {
+    status: 'ok',
+    payload: {
+      summary_line: summary,
+      deck_data: { analogy: analogy },
+    },
+  };
+}
+
+module.exports = { run };

package/lib/agents/mva/brain-similar-ventures.cjs

@@ -0,0 +1,93 @@
+/*
+ * Copyright (c) 2026 Mindrian. BSL 1.1.
+ *
+ * Phase 118-02 Plan 02 Task 1 -- brain-similar-ventures agent (Agent 1 of 6
+ * in B1; agent_id 'brain_similar' in lib/agents/mva/index.cjs).
+ *
+ * Calls Brain via lib/core/brain-client.cjs::search() with a GENERIC handle
+ * from data/mva-agent-prompts.json. Returns the top-3 venture matches with a
+ * one-line human-readable summary + structured deck_data.
+ *
+ * Mirrors lib/agents/auto-explore-agent.cjs structure verbatim per the plan.
+ *
+ * Graph-native HARD RULES (memory feedback_reverse_salient_agent_graph_native.md):
+ *   1. NEVER require room-db.cjs directly (Phase 109 D-06 chokepoint).
+ *   2. NEVER require any Brain-MCP client module DIRECTLY for raw queries;
+ *      use lib/core/brain-client.cjs which enforces the wire-schema sanitization
+ *      AND only with framework-name/phase-id/enum args, never user content.
+ *   3. NEVER write to stdout / stderr (telemetry side-channel rule).
+ *
+ * Canon Part 8 hard invariant (MVA-118-08):
+ *   The Brain query carries ONLY generic handles loaded from
+ *   data/mva-agent-prompts.json. NEVER the user's raw sentence. NEVER the
+ *   sentence_sha256 as a free-text query body. NEVER any user-content env
+ *   var (which is never set; see Plan 118-01's AgentContext invariant -- the
+ *   sentence-bearing env var name is elided here so the grep regression in
+ *   test-all-six-agents.cjs Test 6 returns zero matches on this file).
+ *
+ * Pure CJS, node built-ins only, zero new runtime dependencies.
+ */
+'use strict';
+
+const path = require('node:path');
+const brainClient = require('../../core/brain-client.cjs');
+
+const PROMPTS_PATH = path.resolve(__dirname, '..', '..', '..', 'data', 'mva-agent-prompts.json');
+
+/**
+ * Agent run function. Conforms to the Plan 118-01 Agent contract:
+ *   async function agent(context, signal) -> { status:'ok'|'empty', payload } | null
+ *
+ * @param {{ sentence_sha256: string, remaining_budget_ms: number }} _context
+ * @param {AbortSignal} signal
+ * @returns {Promise<{ status:'ok'|'empty', payload:any } | null>}
+ */
+async function run(_context, signal) {
+  // Fast-fail when Brain is unreachable (no key configured). Per the plan's
+  // done-criteria: this must return status='empty' in <100ms.
+  if (!brainClient.isAvailable()) {
+    return { status: 'empty', payload: { reason: 'brain_unavailable' } };
+  }
+  if (signal && signal.aborted) return null;
+
+  // Load the generic prompt template. Per Canon Part 8 this file is the SOLE
+  // source of Brain query bodies for this agent -- audited in one place.
+  let prompts;
+  try {
+    // require() caches; that is desirable here (the JSON is static config).
+    prompts = require(PROMPTS_PATH).brain_similar_ventures;
+  } catch (_e) {
+    return { status: 'empty', payload: { reason: 'prompts_unavailable' } };
+  }
+
+  let result;
+  try {
+    result = await brainClient.search(prompts.query, {
+      filters: prompts.filters,
+      limit: prompts.limit,
+    });
+  } catch (_e) {
+    return { status: 'empty', payload: { reason: 'brain_error' } };
+  }
+
+  if (signal && signal.aborted) return null;
+
+  // brain-client may return { results: [...] } or null on quota-exhaustion + fallback.
+  const ventures = (result && Array.isArray(result.results)) ? result.results.slice(0, 3) : [];
+  if (ventures.length === 0) {
+    return { status: 'empty', payload: { reason: 'no_matches' } };
+  }
+
+  const summary = 'Found ' + ventures.length + ' ventures in this space: ' +
+    ventures.map((v) => (v.name || 'unnamed') + ' (' + (v.status || 'active') + ')').join(', ');
+
+  return {
+    status: 'ok',
+    payload: {
+      summary_line: summary,
+      deck_data: { ventures: ventures },
+    },
+  };
+}
+
+module.exports = { run };

package/lib/agents/mva/dashboard-graph-neighborhood.cjs

@@ -0,0 +1,72 @@
+/*
+ * Copyright (c) 2026 Mindrian. BSL 1.1.
+ *
+ * Phase 118-02 Plan 02 Task 3 -- dashboard-graph-neighborhood agent (Agent 6
+ * of 6 in B1; agent_id 'dashboard_graph' in lib/agents/mva/index.cjs).
+ *
+ * Reads the active room's graph via lib/core/navigation.cjs (the Phase 109
+ * single chokepoint; Canon Part 9 D-06 invariant) and returns a 1-2 hop
+ * neighborhood snapshot of recent decision nodes.
+ *
+ * Graph-native HARD RULES (memory feedback_reverse_salient_agent_graph_native.md):
+ *   1. NEVER require lib/core/room-db.cjs directly (the Phase 109 D-06
+ *      chokepoint allow-list does NOT include MVA agents).
+ *   2. NEVER require better-sqlite3 / node:sqlite directly.
+ *   3. NEVER write to stdout / stderr (telemetry side-channel rule).
+ *   4. NEVER call out over the network (the dashboard is purely LOCAL graph).
+ *
+ * Canon Part 8 hard invariant (MVA-118-12):
+ *   The room graph read is LOCAL only. Zero outbound. The summary line + deck
+ *   data carry only structural identifiers + counts, never raw artifact text.
+ *
+ * Pure CJS, node built-ins only, zero new runtime dependencies.
+ */
+'use strict';
+
+const nav = require('../../core/navigation.cjs');
+
+/**
+ * @param {{ sentence_sha256: string, remaining_budget_ms: number }} _context
+ * @param {AbortSignal} signal
+ * @returns {Promise<{ status:'ok'|'empty', payload:any } | null>}
+ */
+async function run(_context, signal) {
+  if (signal && signal.aborted) return null;
+
+  let active;
+  try {
+    active = nav.detectActiveRoom();
+  } catch (_e) {
+    return { status: 'empty', payload: { reason: 'no_active_room' } };
+  }
+  if (!active || !active.hasRoomDb) {
+    return { status: 'empty', payload: { reason: 'no_active_room' } };
+  }
+  if (signal && signal.aborted) return null;
+
+  let neighborhood;
+  try {
+    neighborhood = nav.getRecentDecisionNeighborhood(active.roomDir, { hops: 1, limit: 5 });
+  } catch (_e) {
+    return { status: 'empty', payload: { reason: 'graph_error' } };
+  }
+  if (signal && signal.aborted) return null;
+
+  const nodes = (neighborhood && Array.isArray(neighborhood.nodes)) ? neighborhood.nodes : [];
+  const edges = (neighborhood && Array.isArray(neighborhood.edges)) ? neighborhood.edges : [];
+  if (nodes.length === 0) {
+    return { status: 'empty', payload: { reason: 'empty_room' } };
+  }
+  const count = nodes.length;
+  const suffix = count === 1 ? '' : 's';
+  const summary = 'Your room already has ' + count + ' related decision node' + suffix + '. Quick preview:';
+  return {
+    status: 'ok',
+    payload: {
+      summary_line: summary,
+      deck_data: { nodes: nodes, edges: edges },
+    },
+  };
+}
+
+module.exports = { run };

package/lib/agents/mva/index.cjs

@@ -0,0 +1,42 @@
+/*
+ * Copyright (c) 2026 Mindrian. BSL 1.1.
+ *
+ * Phase 118-02 Plan 02 -- ALL_AGENTS aggregator for the 6 MVA agents (Binding
+ * Decision B1). Consumed by lib/core/mva-dispatcher.cjs which knows nothing
+ * about which agents are which -- it accepts any { id, fn } tuple conforming
+ * to the Agent contract in lib/core/mva-agent-contract.cjs.
+ *
+ * Agent ID -> source-file mapping (short forms per B1; long forms here):
+ *
+ *   brain_similar        <- brain-similar-ventures.cjs           (Agent 1)
+ *   brain_cross_domain   <- brain-cross-domain.cjs               (Agent 2)
+ *   brain_classic_traps  <- brain-classic-traps.cjs              (Agent 3)
+ *   tavily_funding       <- tavily-funding-scan.cjs              (Agent 4)
+ *   six_hats_red_black   <- six-hats-red-black.cjs               (Agent 5)
+ *   dashboard_graph      <- dashboard-graph-neighborhood.cjs     (Agent 6)
+ *
+ * NOTE on filename drift (NIT-2 invariant from plan-checker iteration 2):
+ *   The canonical filenames in this plan's files_modified (e.g.
+ *   brain-cross-domain.cjs, dashboard-graph-neighborhood.cjs) are the
+ *   implementation-time source files. The JSDoc above documents the agent-id
+ *   -> source-file mapping using the B1 short forms so Plan 118-03's renderer
+ *   prefixes ([brain] / [analogy] / [traps] / [funding] / [worth chewing on]
+ *   / [your room]) deterministically resolve from agent_id alone. If an
+ *   executor renames a source file, update both this comment block AND the
+ *   require() path immediately below in the same commit.
+ *
+ * Canon Part 8: this module is a pure aggregator. Zero I/O. Each agent owns
+ * its own boundary; the array shape preserves the dispatcher contract.
+ */
+'use strict';
+
+const ALL_AGENTS = Object.freeze([
+  { id: 'brain_similar',       fn: require('./brain-similar-ventures.cjs').run },
+  { id: 'brain_cross_domain',  fn: require('./brain-cross-domain.cjs').run },
+  { id: 'brain_classic_traps', fn: require('./brain-classic-traps.cjs').run },
+  { id: 'tavily_funding',      fn: require('./tavily-funding-scan.cjs').run },
+  { id: 'six_hats_red_black',  fn: require('./six-hats-red-black.cjs').run },
+  { id: 'dashboard_graph',     fn: require('./dashboard-graph-neighborhood.cjs').run },
+]);
+
+module.exports = { ALL_AGENTS };