continuous-improvement 3.9.2 → 3.12.3

package/hooks/route-prompt.mjs

@@ -0,0 +1,180 @@
+#!/usr/bin/env node
+/**
+ * Runtime UserPromptSubmit prompt-router hook.
+ *
+ * Reads the user prompt, matches it against patterns in
+ * hooks/route-table.json, and emits a single `<system-reminder>` recommending
+ * the matched skill. When no row matches, the hook emits nothing — the prompt
+ * passes through untouched.
+ *
+ * Stdin  : JSON { prompt, session_id?, transcript_path?, cwd? }
+ * Stdout : JSON { hookSpecificOutput: { hookEventName: "UserPromptSubmit",
+ *                                       additionalContext: string } }
+ *          OR empty when there is no match.
+ * Exit   : 0 always — routing decisions live in stdout, never in exit code.
+ *
+ * Fail-open: any unexpected error reading stdin / parsing the route table /
+ * compiling a pattern → emit nothing and exit 0. The hook never blocks a
+ * prompt on its own bugs.
+ *
+ * Telemetry: each match appends one JSONL line to
+ * ~/.claude/instincts/<project-hash>/route-prompt.jsonl with the row index,
+ * skill, and pattern. Telemetry failures never change the decision.
+ *
+ * Route table schema (hooks/route-table.json):
+ *   {
+ *     "rows": [
+ *       { "pattern": "regex source", "flags": "i", "skill": "skill-name",
+ *         "reason": "one-line description" }
+ *     ]
+ *   }
+ * Rows are evaluated in order; first match wins.
+ */
+import { createHash } from "node:crypto";
+import { appendFileSync, existsSync, mkdirSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { execFileSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+function readStdin() {
+    try {
+        return readFileSync(0, "utf8");
+    }
+    catch {
+        return "";
+    }
+}
+function resolveHome() {
+    return process.env.HOME ?? process.env.USERPROFILE ?? homedir();
+}
+function resolveProjectRoot() {
+    const fromEnv = process.env.CLAUDE_PROJECT_DIR;
+    if (fromEnv)
+        return fromEnv;
+    try {
+        const root = execFileSync("git", ["rev-parse", "--show-toplevel"], {
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+        if (root)
+            return root;
+    }
+    catch {
+        // not in a git repo
+    }
+    return "global";
+}
+function telemetryPath(home) {
+    const hash = createHash("sha256")
+        .update(resolveProjectRoot())
+        .digest("hex")
+        .slice(0, 12);
+    return join(home, ".claude", "instincts", hash, "route-prompt.jsonl");
+}
+function writeTelemetry(home, event) {
+    try {
+        const path = telemetryPath(home);
+        const dir = dirname(path);
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        appendFileSync(path, `${JSON.stringify(event)}\n`);
+    }
+    catch {
+        // fail-open
+    }
+}
+function loadRouteTable() {
+    // Hook lives at <plugin-root>/hooks/route-prompt.mjs at runtime; the table
+    // sits next to it. import.meta.url gives the file:// URL of the compiled
+    // .mjs.
+    try {
+        const here = fileURLToPath(new URL(".", import.meta.url));
+        const tablePath = join(here, "route-table.json");
+        const raw = readFileSync(tablePath, "utf8");
+        const parsed = JSON.parse(raw);
+        if (!parsed || !Array.isArray(parsed.rows))
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+function findMatch(prompt, table) {
+    for (let i = 0; i < table.rows.length; i++) {
+        const row = table.rows[i];
+        if (!row || typeof row.pattern !== "string" || typeof row.skill !== "string") {
+            continue;
+        }
+        let rx;
+        try {
+            rx = new RegExp(row.pattern, row.flags ?? "");
+        }
+        catch {
+            continue;
+        }
+        if (rx.test(prompt)) {
+            return { row, index: i };
+        }
+    }
+    return null;
+}
+function buildContext(row) {
+    const reason = row.reason
+        ? `${row.reason}\nConsider invoking \`/${row.skill}\` now.`
+        : `Consider invoking \`/${row.skill}\` now.`;
+    return `<system-reminder>\nPrompt-router suggestion: ${reason}\n</system-reminder>`;
+}
+function emit(output) {
+    if (output !== null) {
+        process.stdout.write(`${JSON.stringify(output)}\n`);
+    }
+    process.exit(0);
+}
+function main() {
+    const raw = readStdin();
+    let payload;
+    try {
+        payload = JSON.parse(raw);
+    }
+    catch {
+        emit(null);
+        return;
+    }
+    const prompt = payload.prompt;
+    if (typeof prompt !== "string" || prompt.length === 0) {
+        emit(null);
+        return;
+    }
+    const table = loadRouteTable();
+    if (!table) {
+        emit(null);
+        return;
+    }
+    const match = findMatch(prompt, table);
+    const home = resolveHome();
+    if (!match) {
+        writeTelemetry(home, {
+            ts: new Date().toISOString(),
+            hook: "route-prompt",
+            matched: false,
+        });
+        emit(null);
+        return;
+    }
+    writeTelemetry(home, {
+        ts: new Date().toISOString(),
+        hook: "route-prompt",
+        matched: true,
+        row_index: match.index,
+        skill: match.row.skill,
+        pattern: match.row.pattern,
+    });
+    emit({
+        hookSpecificOutput: {
+            hookEventName: "UserPromptSubmit",
+            additionalContext: buildContext(match.row),
+        },
+    });
+}
+main();

package/hooks/route-table.json

@@ -0,0 +1,35 @@
+{
+  "description": "Declarative prompt-router for the continuous-improvement UserPromptSubmit hook. Each row maps a regex (prompt-side trigger) to a skill the agent should consider invoking. First match wins; rows are evaluated in order. Edit this file to grow the routing table — no code change required.",
+  "rows": [
+    {
+      "pattern": "\\b(write|add|new)\\s+(a\\s+)?(failing\\s+)?test\\b|\\btdd\\b|\\bred[- ]green[- ]refactor\\b",
+      "flags": "i",
+      "skill": "tdd-workflow",
+      "reason": "Prompt mentions writing tests, TDD, or RED-GREEN-REFACTOR."
+    },
+    {
+      "pattern": "\\b(verify|verification|prove\\s+it\\s+works|smallest\\s+check|check\\s+it\\s+passes)\\b",
+      "flags": "i",
+      "skill": "verification-loop",
+      "reason": "Prompt asks for verification before declaring done."
+    },
+    {
+      "pattern": "\\b(plan|blueprint|design\\s+(the\\s+)?approach|step[- ]by[- ]step\\s+plan|roadmap)\\b",
+      "flags": "i",
+      "skill": "planning-with-files",
+      "reason": "Prompt asks for a plan, blueprint, or design before implementation."
+    },
+    {
+      "pattern": "\\b(security\\s+review|threat\\s+model|owasp|vulnerab|auth(entication|orization)\\s+check)\\b",
+      "flags": "i",
+      "skill": "security-review",
+      "reason": "Prompt touches security review, threat modeling, or auth surface."
+    },
+    {
+      "pattern": "\\b(code\\s+review|review\\s+(my|the|this)\\s+(code|pr|diff|patch)|critique\\s+(the|this)\\s+code)\\b",
+      "flags": "i",
+      "skill": "code-review",
+      "reason": "Prompt asks for a code review on existing changes."
+    }
+  ]
+}

package/hooks/session.sh

@@ -1,106 +1,106 @@
-#!/usr/bin/env bash
-# session.sh — SessionStart/SessionEnd hook for continuous-improvement
-# SessionStart: loads instincts and prints status
-# SessionEnd: prompts reflection
-# Always exits 0 — never blocks the session
-trap 'exit 0' EXIT ERR INT TERM
-
-INSTINCTS_DIR="${HOME}/.claude/instincts"
-
-# Read stdin
-INPUT="$(cat)"
-[[ -z "$INPUT" ]] && exit 0
-
-# ---------------------------------------------------------------------------
-# Detect event type from hook context
-# ---------------------------------------------------------------------------
-# SessionStart hooks receive no tool_name, SessionEnd hooks may vary.
-# We detect based on the hook_type field or the calling context.
-EVENT_TYPE=""
-if command -v jq &>/dev/null; then
-  EVENT_TYPE="$(printf '%s' "$INPUT" | jq -r '.hook_type // .event_type // "unknown"' 2>/dev/null)"
-else
-  if printf '%s' "$INPUT" | grep -q '"SessionStart"'; then
-    EVENT_TYPE="SessionStart"
-  elif printf '%s' "$INPUT" | grep -q '"SessionEnd"'; then
-    EVENT_TYPE="SessionEnd"
-  fi
-fi
-
-# ---------------------------------------------------------------------------
-# Project detection (same as observe.sh)
-# ---------------------------------------------------------------------------
-PROJECT_ROOT=""
-if [[ -n "${CLAUDE_PROJECT_DIR:-}" && -d "${CLAUDE_PROJECT_DIR}" ]]; then
-  PROJECT_ROOT="${CLAUDE_PROJECT_DIR}"
-fi
-if [[ -z "$PROJECT_ROOT" ]]; then
-  PROJECT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || true)"
-fi
-if [[ -z "$PROJECT_ROOT" ]]; then
-  PROJECT_ROOT="global"
-fi
-
-PROJECT_HASH="$(printf '%s' "$PROJECT_ROOT" | sha256sum | cut -c1-12)"
-PROJECT_DIR="${INSTINCTS_DIR}/${PROJECT_HASH}"
-
-# ---------------------------------------------------------------------------
-# SessionStart: count observations and instincts, print brief status
-# ---------------------------------------------------------------------------
-if [[ "$EVENT_TYPE" == "SessionStart" || "$EVENT_TYPE" == "unknown" ]]; then
-  OBS_COUNT=0
-  INSTINCT_COUNT=0
-
-  OBS_FILE="${PROJECT_DIR}/observations.jsonl"
-  if [[ -f "$OBS_FILE" ]]; then
-    OBS_COUNT="$(wc -l < "$OBS_FILE" 2>/dev/null || echo 0)"
-  fi
-
-  # Count yaml files in project + global
-  for dir in "$PROJECT_DIR" "${INSTINCTS_DIR}/global"; do
-    if [[ -d "$dir" ]]; then
-      count="$(find "$dir" -maxdepth 1 -name '*.yaml' 2>/dev/null | wc -l)"
-      INSTINCT_COUNT=$((INSTINCT_COUNT + count))
-    fi
-  done
-
-  # Determine level
-  LEVEL="CAPTURE"
-  if (( OBS_COUNT >= 20 )) || (( INSTINCT_COUNT > 0 )); then
-    LEVEL="ANALYZE"
-  fi
-
-  # Check for high-confidence instincts
-  if (( INSTINCT_COUNT > 0 )); then
-    for dir in "$PROJECT_DIR" "${INSTINCTS_DIR}/global"; do
-      if [[ -d "$dir" ]]; then
-        for f in "$dir"/*.yaml; do
-          [[ -f "$f" ]] || continue
-          conf="$(grep '^confidence:' "$f" 2>/dev/null | head -1 | sed 's/confidence: *//')"
-          if [[ -n "$conf" ]]; then
-            # Compare as integer (multiply by 100) using awk for portability
-            int_conf="$(printf '%s' "$conf" | awk '{printf "%.0f", $1 * 100}')"
-            if [[ -n "$int_conf" ]] && (( int_conf >= 70 )); then
-              LEVEL="AUTO-APPLY"
-              break 2
-            elif (( int_conf >= 50 )); then
-              LEVEL="SUGGEST"
-            fi
-          fi
-        done
-      fi
-    done
-  fi
-
-  # Write status to stderr (visible in hook output, not blocking)
-  echo "[continuous-improvement] Level: ${LEVEL} | Observations: ${OBS_COUNT} | Instincts: ${INSTINCT_COUNT}" >&2
-fi
-
-# ---------------------------------------------------------------------------
-# SessionEnd: remind to reflect
-# ---------------------------------------------------------------------------
-if [[ "$EVENT_TYPE" == "SessionEnd" ]]; then
-  echo "[continuous-improvement] Session ending. Run /continuous-improvement to reflect and capture learnings." >&2
-fi
-
-exit 0
+#!/usr/bin/env bash
+# session.sh — SessionStart/SessionEnd hook for continuous-improvement
+# SessionStart: loads instincts and prints status
+# SessionEnd: prompts reflection
+# Always exits 0 — never blocks the session
+trap 'exit 0' EXIT ERR INT TERM
+
+INSTINCTS_DIR="${HOME}/.claude/instincts"
+
+# Read stdin
+INPUT="$(cat)"
+[[ -z "$INPUT" ]] && exit 0
+
+# ---------------------------------------------------------------------------
+# Detect event type from hook context
+# ---------------------------------------------------------------------------
+# SessionStart hooks receive no tool_name, SessionEnd hooks may vary.
+# We detect based on the hook_type field or the calling context.
+EVENT_TYPE=""
+if command -v jq &>/dev/null; then
+  EVENT_TYPE="$(printf '%s' "$INPUT" | jq -r '.hook_type // .event_type // "unknown"' 2>/dev/null)"
+else
+  if printf '%s' "$INPUT" | grep -q '"SessionStart"'; then
+    EVENT_TYPE="SessionStart"
+  elif printf '%s' "$INPUT" | grep -q '"SessionEnd"'; then
+    EVENT_TYPE="SessionEnd"
+  fi
+fi
+
+# ---------------------------------------------------------------------------
+# Project detection (same as observe.sh)
+# ---------------------------------------------------------------------------
+PROJECT_ROOT=""
+if [[ -n "${CLAUDE_PROJECT_DIR:-}" && -d "${CLAUDE_PROJECT_DIR}" ]]; then
+  PROJECT_ROOT="${CLAUDE_PROJECT_DIR}"
+fi
+if [[ -z "$PROJECT_ROOT" ]]; then
+  PROJECT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || true)"
+fi
+if [[ -z "$PROJECT_ROOT" ]]; then
+  PROJECT_ROOT="global"
+fi
+
+PROJECT_HASH="$(printf '%s' "$PROJECT_ROOT" | sha256sum | cut -c1-12)"
+PROJECT_DIR="${INSTINCTS_DIR}/${PROJECT_HASH}"
+
+# ---------------------------------------------------------------------------
+# SessionStart: count observations and instincts, print brief status
+# ---------------------------------------------------------------------------
+if [[ "$EVENT_TYPE" == "SessionStart" || "$EVENT_TYPE" == "unknown" ]]; then
+  OBS_COUNT=0
+  INSTINCT_COUNT=0
+
+  OBS_FILE="${PROJECT_DIR}/observations.jsonl"
+  if [[ -f "$OBS_FILE" ]]; then
+    OBS_COUNT="$(wc -l < "$OBS_FILE" 2>/dev/null || echo 0)"
+  fi
+
+  # Count yaml files in project + global
+  for dir in "$PROJECT_DIR" "${INSTINCTS_DIR}/global"; do
+    if [[ -d "$dir" ]]; then
+      count="$(find "$dir" -maxdepth 1 -name '*.yaml' 2>/dev/null | wc -l)"
+      INSTINCT_COUNT=$((INSTINCT_COUNT + count))
+    fi
+  done
+
+  # Determine level
+  LEVEL="CAPTURE"
+  if (( OBS_COUNT >= 20 )) || (( INSTINCT_COUNT > 0 )); then
+    LEVEL="ANALYZE"
+  fi
+
+  # Check for high-confidence instincts
+  if (( INSTINCT_COUNT > 0 )); then
+    for dir in "$PROJECT_DIR" "${INSTINCTS_DIR}/global"; do
+      if [[ -d "$dir" ]]; then
+        for f in "$dir"/*.yaml; do
+          [[ -f "$f" ]] || continue
+          conf="$(grep '^confidence:' "$f" 2>/dev/null | head -1 | sed 's/confidence: *//')"
+          if [[ -n "$conf" ]]; then
+            # Compare as integer (multiply by 100) using awk for portability
+            int_conf="$(printf '%s' "$conf" | awk '{printf "%.0f", $1 * 100}')"
+            if [[ -n "$int_conf" ]] && (( int_conf >= 70 )); then
+              LEVEL="AUTO-APPLY"
+              break 2
+            elif (( int_conf >= 50 )); then
+              LEVEL="SUGGEST"
+            fi
+          fi
+        done
+      fi
+    done
+  fi
+
+  # Write status to stderr (visible in hook output, not blocking)
+  echo "[continuous-improvement] Level: ${LEVEL} | Observations: ${OBS_COUNT} | Instincts: ${INSTINCT_COUNT}" >&2
+fi
+
+# ---------------------------------------------------------------------------
+# SessionEnd: remind to reflect
+# ---------------------------------------------------------------------------
+if [[ "$EVENT_TYPE" == "SessionEnd" ]]; then
+  echo "[continuous-improvement] Session ending. Run /continuous-improvement to reflect and capture learnings." >&2
+fi
+
+exit 0