continuous-improvement 3.11.0 → 3.12.3

package/plugins/continuous-improvement/commands/workspace-surface-audit.md

@@ -1,77 +1,77 @@
----
-name: workspace-surface-audit
-description: "Audit workspace capabilities and recommend continuous-improvement-native skills, hooks, and workflows"
----
-
-# /workspace-surface-audit
-
-Audit the active repo, MCP servers, plugins, connectors, env surfaces, and harness setup. Returns a 5-section report with specific next moves.
-
-## Usage
-
-```
-/workspace-surface-audit
-```
-
-## What It Checks
-
-1. **Repo surface** — `package.json`, lockfiles, framework config, `.mcp.json`, `.claude/settings*.json`, `AGENTS.md`
-2. **Environment surface** — `.env*` files (key names only, no secrets)
-3. **Connected tools** — installed plugins, MCP servers, LSPs, app integrations
-4. **continuous-improvement surface** — existing skills, commands, hooks, agents
-
-## Output Format
-
-```
-=== Workspace Surface Audit ===
-
-## Current Surface
-- [What is usable right now]
-
-## Parity
-- [Where continuous-improvement matches or exceeds benchmarks]
-
-## Primitive-Only Gaps
-- [Tools exist, but continuous-improvement lacks clean operator skills]
-
-## Missing Integrations
-- [Capabilities not available yet]
-
-## Top 3-5 Next Moves
-1. [Concrete continuous-improvement-native addition]
-2. [Ordered by impact]
-```
-
-## Rules
-
-- **Never print secrets** — only provider names, capability names, file paths
-- **Prefer continuous-improvement** over generic "install another plugin" advice
-- **Organize by workflows**, not API brands
-- **Specific recommendations** — concrete enough to implement without another discovery pass
-
-## Example Output
-
-```
-## Current Surface
-- MCP: filesystem, github, playwright
-- Plugins: beginner, expert (continuous-improvement)
-- Env: STRIPE_API_KEY, FAL_KEY configured
-- Framework: Next.js 15, React 19, TypeScript
-
-## Parity
-- Continuous improvement: covered (native)
-- Testing discipline: covered (TDD workflows)
-
-## Primitive-Only Gaps
-- Stripe connected but no billing-operator skill
-- GitHub MCP available but no issue-triage workflow
-
-## Missing Integrations
-- No Linear connector detected
-- No Slack webhook configured
-
-## Top 3-5 Next Moves
-1. Create billing-operator skill (Stripe integration)
-2. Create github-ops workflow for issue triage
-3. Add Linear connector skill for project management
-```
+---
+name: workspace-surface-audit
+description: "Audit workspace capabilities and recommend continuous-improvement-native skills, hooks, and workflows"
+---
+
+# /workspace-surface-audit
+
+Audit the active repo, MCP servers, plugins, connectors, env surfaces, and harness setup. Returns a 5-section report with specific next moves.
+
+## Usage
+
+```
+/workspace-surface-audit
+```
+
+## What It Checks
+
+1. **Repo surface** — `package.json`, lockfiles, framework config, `.mcp.json`, `.claude/settings*.json`, `AGENTS.md`
+2. **Environment surface** — `.env*` files (key names only, no secrets)
+3. **Connected tools** — installed plugins, MCP servers, LSPs, app integrations
+4. **continuous-improvement surface** — existing skills, commands, hooks, agents
+
+## Output Format
+
+```
+=== Workspace Surface Audit ===
+
+## Current Surface
+- [What is usable right now]
+
+## Parity
+- [Where continuous-improvement matches or exceeds benchmarks]
+
+## Primitive-Only Gaps
+- [Tools exist, but continuous-improvement lacks clean operator skills]
+
+## Missing Integrations
+- [Capabilities not available yet]
+
+## Top 3-5 Next Moves
+1. [Concrete continuous-improvement-native addition]
+2. [Ordered by impact]
+```
+
+## Rules
+
+- **Never print secrets** — only provider names, capability names, file paths
+- **Prefer continuous-improvement** over generic "install another plugin" advice
+- **Organize by workflows**, not API brands
+- **Specific recommendations** — concrete enough to implement without another discovery pass
+
+## Example Output
+
+```
+## Current Surface
+- MCP: filesystem, github, playwright
+- Plugins: beginner, expert (continuous-improvement)
+- Env: STRIPE_API_KEY, FAL_KEY configured
+- Framework: Next.js 15, React 19, TypeScript
+
+## Parity
+- Continuous improvement: covered (native)
+- Testing discipline: covered (TDD workflows)
+
+## Primitive-Only Gaps
+- Stripe connected but no billing-operator skill
+- GitHub MCP available but no issue-triage workflow
+
+## Missing Integrations
+- No Linear connector detected
+- No Slack webhook configured
+
+## Top 3-5 Next Moves
+1. Create billing-operator skill (Stripe integration)
+2. Create github-ops workflow for issue triage
+3. Add Linear connector skill for project management
+```

package/plugins/continuous-improvement/hooks/gateguard.mjs

@@ -27,7 +27,8 @@
  * path.
  */
 import { readFileSync } from "node:fs";
-import { join } from "node:path";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
 import { MAX_CLEARED_FILES, canonicalizeFileKey, isCapReached, isFileCleared, loadState, markFileCleared, resolveSessionDir, saveState, } from "../lib/gateguard-state.mjs";
 const TOOL_ROUTE = {
     Read: "allow",
@@ -104,11 +105,23 @@ function formatFileTarget(filePaths) {
         return nonEmpty[0];
     return `${nonEmpty.length} files (${nonEmpty.join(", ")})`;
 }
+// Resolved from the hook's own location at load time. The block reason must
+// print a command the agent can run in its OWN shell, where ${CLAUDE_PLUGIN_ROOT}
+// is empty — that variable is only populated while this hook itself executes.
+// bin/ is a sibling of hooks/ in both the repo layout and the plugin-bundle
+// mirror, so this resolves correctly from either.
+const CLEAR_CLI_PATH = join(dirname(fileURLToPath(import.meta.url)), "..", "bin", "gateguard-clear.mjs");
+// Quote a path for the printed clearance command. Forward slashes (node accepts
+// them on every platform and they survive a Bash double-quote without escaping)
+// inside JSON quotes — JSON.stringify still escapes any embedded quote, so a
+// path like a"b.ts stays safe rather than collapsing into a bare-quoted token.
+function quotePath(p) {
+    return JSON.stringify(p.replace(/\\/g, "/"));
+}
 function buildMutatingFileReason(toolName, filePaths, stateFilePath) {
     const target = formatFileTarget(filePaths);
     const pathList = filePaths.filter((p) => p !== "");
-    const jsonArray = (pathList.length > 0 ? pathList : [target]).map((p) => JSON.stringify(p)).join(", ");
-    const cliArgs = (pathList.length > 0 ? pathList : [target]).map((p) => JSON.stringify(p)).join(" ");
+    const quoted = (pathList.length > 0 ? pathList : [target]).map((p) => quotePath(p));
     return [
         `Before ${toolName === "Write" ? "creating" : "editing"} ${target}, present these facts:`,
         "",
@@ -117,13 +130,12 @@ function buildMutatingFileReason(toolName, filePaths, stateFilePath) {
         "  3. If this file reads/writes data files, show field names, structure, and date format",
         "  4. Quote the user's current instruction verbatim",
         "",
-        "Then clear the gate and retry the same call. Any one of:",
-        `  A. MCP tool:  ci_gateguard_clear  {file_paths: [${jsonArray}]}`,
-        `  B. CLI (Bash, never gated): node "\${CLAUDE_PLUGIN_ROOT}/bin/gateguard-clear.mjs" ${cliArgs}`,
-        `  C. Manual: append each path to "cleared_files" in ${stateFilePath} via a non-destructive Bash write.`,
-        "  Clearance matches regardless of drive-letter case or path separator.",
-        "  (On harnesses that forward unknown tool params you may instead retry with",
-        "  `_gateguard_facts_presented: true`; Claude Code's strict schema rejects that, so use A/B/C.)",
+        "Then clear the gate and retry the same call. Either route works:",
+        `  A. Bash (always works — run verbatim): node ${quotePath(CLEAR_CLI_PATH)} --state ${quotePath(stateFilePath)} ${quoted.join(" ")}`,
+        `  B. MCP tool (when the continuous-improvement server is connected): ci_gateguard_clear  {file_paths: [${quoted.join(", ")}]}`,
+        "  Both canonicalize paths — drive-letter case and separators don't matter.",
+        "  (Harnesses that forward unknown tool params may instead retry the call with",
+        "  `_gateguard_facts_presented: true`; Claude Code's strict schema rejects that, so use A or B.)",
     ].join("\n");
 }
 function buildDestructiveBashReason(command) {

package/plugins/continuous-improvement/hooks/hooks.json

@@ -1,5 +1,5 @@
 {
-  "description": "Gateguard fact-forcing PreToolUse, companion-preference enforcement, observation, session lifecycle, 3-section-close discipline, goal-drift Stop gate, and UserPromptSubmit lazy-routing hooks for continuous-improvement.",
+  "description": "Gateguard fact-forcing PreToolUse, companion-preference enforcement, observation, session lifecycle, 3-section-close discipline, goal-drift Stop gate, and UserPromptSubmit lazy-routing plus opt-in proactive recall-briefing hooks for continuous-improvement.",
   "hooks": {
     "PreToolUse": [
       {
@@ -35,6 +35,11 @@
             "type": "command",
             "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/route-prompt.mjs\"",
             "timeout": 5
+          },
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/recall-briefing.mjs\"",
+            "timeout": 5
           }
         ]
       }

package/plugins/continuous-improvement/hooks/recall-briefing.mjs

@@ -0,0 +1,167 @@
+#!/usr/bin/env node
+/**
+ * Runtime UserPromptSubmit recall-briefing hook (opt-in amplifier).
+ *
+ * On the first substantive prompt of a session, searches this project's past
+ * observations (BM25, via recall-index.mts) and injects a one-time
+ * `<system-reminder>` listing the most relevant prior activity — so the agent
+ * reuses a past fix instead of re-deriving it. This makes episodic memory
+ * proactive instead of opt-in-per-query (the ci_recall MCP tool stays available
+ * for explicit, deeper searches).
+ *
+ * Opt-in: runs only when CLAUDE_RECALL_BRIEFING is 1/on/true. Default off, so it
+ * never changes the prompt path for users who have not enabled it.
+ *
+ * Stdin  : JSON { prompt, session_id?, cwd? }
+ * Stdout : JSON { hookSpecificOutput: { hookEventName: "UserPromptSubmit",
+ *                                       additionalContext: string } }
+ *          OR empty when it should not brief.
+ * Exit   : 0 always — this is an amplifier, never a gate; it cannot block a prompt.
+ *
+ * Fail-open: any error (no env flag, bad stdin, missing/short observations log,
+ * unreadable state) emits nothing and exits 0. State at
+ * ~/.claude/instincts/<project-hash>/recall-briefing-session.json records which
+ * session_ids have been briefed so each session is briefed at most once.
+ */
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { execFileSync } from "node:child_process";
+import { buildIndex, query } from "../lib/recall-index.mjs";
+import { DEFAULT_MAX_HITS, decideBriefing } from "../lib/recall-briefing.mjs";
+const ENABLED_VALUES = new Set(["1", "on", "true", "yes"]);
+const MAX_BRIEFED_KEYS = 1000;
+function isEnabled() {
+    const flag = (process.env.CLAUDE_RECALL_BRIEFING ?? "").trim().toLowerCase();
+    return ENABLED_VALUES.has(flag);
+}
+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 instinctsDir(home) {
+    const hash = createHash("sha256").update(resolveProjectRoot()).digest("hex").slice(0, 12);
+    return join(home, ".claude", "instincts", hash);
+}
+function readObservations(dir) {
+    const path = join(dir, "observations.jsonl");
+    let raw;
+    try {
+        raw = readFileSync(path, "utf8");
+    }
+    catch {
+        return [];
+    }
+    const rows = [];
+    for (const line of raw.split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            rows.push(JSON.parse(trimmed));
+        }
+        catch {
+            // skip a malformed line; never let one bad row sink the briefing
+        }
+    }
+    return rows;
+}
+function readState(dir) {
+    try {
+        const parsed = JSON.parse(readFileSync(join(dir, "recall-briefing-session.json"), "utf8"));
+        if (parsed && typeof parsed.briefed === "object" && parsed.briefed !== null)
+            return parsed;
+    }
+    catch {
+        // missing or malformed → fresh state
+    }
+    return { briefed: {} };
+}
+function writeState(dir, state, sessionKey) {
+    try {
+        const keys = Object.keys(state.briefed);
+        // Bound growth: if the map is huge, keep only the most recent run plus this one.
+        const briefed = keys.length >= MAX_BRIEFED_KEYS ? {} : state.briefed;
+        briefed[sessionKey] = new Date().toISOString();
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        writeFileSync(join(dir, "recall-briefing-session.json"), `${JSON.stringify({ briefed }, null, 2)}\n`);
+    }
+    catch {
+        // fail-open: a missed state write at worst briefs twice; it never blocks
+    }
+}
+function emit(additionalContext) {
+    if (additionalContext !== null) {
+        process.stdout.write(`${JSON.stringify({
+            hookSpecificOutput: { hookEventName: "UserPromptSubmit", additionalContext },
+        })}\n`);
+    }
+    process.exit(0);
+}
+function main() {
+    if (!isEnabled()) {
+        emit(null);
+        return;
+    }
+    let payload;
+    try {
+        payload = JSON.parse(readStdin());
+    }
+    catch {
+        emit(null);
+        return;
+    }
+    const prompt = typeof payload.prompt === "string" ? payload.prompt : "";
+    if (prompt.length === 0) {
+        emit(null);
+        return;
+    }
+    const sessionKey = typeof payload.session_id === "string" && payload.session_id ? payload.session_id : "no-session";
+    const home = resolveHome();
+    const dir = instinctsDir(home);
+    const state = readState(dir);
+    const alreadyBriefed = Object.prototype.hasOwnProperty.call(state.briefed, sessionKey);
+    const observations = readObservations(dir);
+    const index = buildIndex(observations);
+    const hits = query(index, prompt, { k: DEFAULT_MAX_HITS });
+    const decision = decideBriefing({ enabled: true, alreadyBriefed, prompt, hits });
+    if (!decision.shouldBrief || decision.reminder === null) {
+        emit(null);
+        return;
+    }
+    writeState(dir, state, sessionKey);
+    emit(decision.reminder);
+}
+try {
+    main();
+}
+catch {
+    // Absolute fail-open backstop: never let a hook bug block a prompt.
+    process.exit(0);
+}

package/plugins/continuous-improvement/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