@vpxa/aikit 0.1.376 → 0.1.378

package/scaffold/general/hooks/scripts/session-reminder.mjs

@@ -1,15 +1,19 @@
 #!/usr/bin/env node
 /**
- * session-reminder — SessionStart hook that injects the orchestrator
- * skill protocol at every session start.
+ * session-reminder — SessionStart hook that injects tool routing rules,
+ * mandatory first actions, and skill protocols at every session start.
  *
- * Reads ~/.claude/skills/orchestrator/SKILL.md, strips YAML frontmatter,
- * and injects the "Delegate, never implement" protocol as additionalContext.
- * Falls back to inline essentials if skill file is unavailable.
+ * All agents now include mcp__aikit__* tools in their tools: frontmatter
+ * alongside native tools (Bash, Edit, Read, Task, etc.).
  *
- * The orchestrator agent file already references the aikit skill — this
- * hook reinforces the orchestrator-specific delegation protocol that the
- * model is most likely to skip.
+ * Reads ~/.claude/skills/orchestrator/SKILL.md and ~/.claude/skills/aikit/SKILL.md,
+ * strips YAML frontmatter, and injects:
+ *   - FORBIDDEN TOOL SUBSTITUTIONS (grep/find/ls → MCP tools)
+ *   - MANDATORY FIRST ACTIONS (flow status, status with prelude, onboard)
+ *   - Orchestrator delegation protocol (from skill file or inline fallback)
+ *   - AI Kit tool routing essentials (from aikit skill file)
+ *
+ * Falls back to inline essentials if skill files are unavailable.
  *
  * @category signal
  * @event SessionStart
@@ -20,25 +24,59 @@ import { homedir } from 'node:os';
 import { resolve } from 'node:path';
 import { createHook } from './_runtime.mjs';
 
+/**
+ * Read a skill SKILL.md file and return its body (YAML frontmatter stripped).
+ * Returns null if the file is missing or unreadable.
+ */
+function readSkillBody(skillName) {
+  const skillPath = resolve(homedir(), '.claude', 'skills', skillName, 'SKILL.md');
+  try {
+    const raw = readFileSync(skillPath, 'utf-8');
+    const body = raw.replace(/^---[\s\S]*?---\n*/, '').trim();
+    return body || null;
+  } catch {
+    return null;
+  }
+}
+
 createHook(
   () => {
-    const skillPath = resolve(homedir(), '.claude', 'skills', 'orchestrator', 'SKILL.md');
-    let extracted = '';
-
-    try {
-      const raw = readFileSync(skillPath, 'utf-8');
-      // Strip YAML frontmatter (everything between first two ---)
-      const body = raw.replace(/^---[\s\S]*?---\n*/, '').trim();
-      if (body) extracted = body;
-    } catch {
-      // fallback inline instructions below
-    }
+    const orchestratorBody = readSkillBody('orchestrator');
+    const aikitBody = readSkillBody('aikit');
 
-    const content =
-      extracted ||
-      [
-        '# Orchestrator Protocol — MANDATORY',
-        '',
+    const parts = [];
+
+    // ── FORBIDDEN TOOL SUBSTITUTIONS ──
+    parts.push(
+      '── FORBIDDEN TOOL SUBSTITUTIONS (enforced) ──',
+      'These shell commands waste context on codebase exploration. Use MCP tools instead:',
+      '',
+      '| Shell pattern | Use MCP tool instead |',
+      '|---|---|',
+      '| grep, find, rg | mcp__aikit__search or mcp__aikit__find |',
+      '| cat (large files) | mcp__aikit__file_summary |',
+      '| ls (code exploration) | mcp__aikit__find({ glob }) or mcp__aikit__search |',
+      '| tsc, biome CLI | mcp__aikit__check |',
+      '| npx vitest | mcp__aikit__test_run |',
+      '| read_file (understanding) | mcp__aikit__file_summary({ tier: T2, query }) |',
+      '',
+      'read_file is ONLY for exact edit lines after compressed tools identify the target.',
+      '',
+      '── MANDATORY FIRST ACTIONS (session start) ──',
+      'Execute these MCP calls before ANY other work:',
+      "1. mcp__aikit__flow({ action: 'status' }) — check active flow state",
+      '2. mcp__aikit__status({ includePrelude: true }) — load L0 workspace context',
+      '3. If workspaceCore is null → mcp__aikit__onboard({ path: "." }) first, then status again',
+      '',
+    );
+
+    // ── Delegation Protocol ──
+    if (orchestratorBody) {
+      parts.push('── Delegation Protocol ──');
+      parts.push(orchestratorBody);
+    } else {
+      parts.push(
+        '── Delegation Protocol (fallback) ──',
         'YOU MUST FOLLOW THIS PROTOCOL ON EVERY TASK. You are an orchestrator, not an implementer.',
         '',
         '**RULE 1 — Decompose everything.** Every task gets a TODO list in your first response. Break it into independent, parallelizable subtasks.',
@@ -55,9 +93,53 @@ createHook(
         '',
         '**Exceptions (ONLY these):** ≤5 lines trivial, fixing sub-agent output, no sub-agent available.',
         'When in doubt, delegate. When unsure, spawn an extra sub-agent.',
-      ].join('\n');
+      );
+    }
+
+    // ── AI Kit Tool Routing ──
+    if (aikitBody) {
+      // Extract key sections: Session Loop, Retrieval Ladder, Context Reuse
+      const sections = aikitBody.split('\n## ');
+      const keySections = [
+        'Session Loop',
+        'Retrieval Ladder',
+        'Context Reuse',
+        'Patterns',
+        'Memory Discipline',
+      ];
+      const extracted = sections.filter((s) => {
+        const header = s
+          .split('\n')[0]
+          .trim()
+          .replace(/^#+\s*/, '');
+        return keySections.some((k) => header.startsWith(k));
+      });
+      if (extracted.length > 0) {
+        parts.push('── AI Kit Tool Routing ──');
+        parts.push(extracted.join('\n\n'));
+      }
+    } else {
+      parts.push(
+        '── AI Kit Tool Routing (fallback) ──',
+        '',
+        '| Need | Use |',
+        '|---|---|',
+        '| L0 workspace context | status({ includePrelude: true }) |',
+        '| Search code | search({ query }) |',
+        '| Find files | find({ glob }) |',
+        '| File summary / exploration | file_summary({ files, tier: T2 }) |',
+        '| Symbol definition | symbol({ name }) |',
+        '| Type/lint check | check({}) |',
+        '| Run tests | test_run({}) |',
+        '| Call/data flow | trace({ start, direction }) |',
+        '| Impact analysis | blast_radius({ files }) |',
+        '| Module graph | graph({ action: neighbors, node_id }) |',
+        '',
+        'Prefer compressed MCP tools over raw read_file. read_file is only for editing.',
+      );
+    }
 
-    return { additionalContext: `── Orchestrator Protocol ──\n${content}` };
+    return { additionalContext: parts.join('\n') };
   },
   { event: 'SessionStart' },
 );

package/packages/server/dist/prelude-BuHOjkbS.js

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-import{n as e,t}from"./server-DXaS0WHj.js";export{t as buildPreludeInjection,e as generatePrelude};

package/packages/server/dist/prelude-C2-WkGrE.js

@@ -1 +0,0 @@
-import{n as e,t}from"./server-C9E6Pzil.js";export{t as buildPreludeInjection,e as generatePrelude};

package/packages/server/dist/sampling-CGl_ysKF.js

@@ -1 +0,0 @@
-import{r as e}from"./server-C9E6Pzil.js";export{e as createSamplingClient};

package/packages/server/dist/sampling-DZSZqYyG.js

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-import{r as e}from"./server-DXaS0WHj.js";export{e as createSamplingClient};