@rely-ai/caliber 1.19.7 → 1.20.0-dev.1773685636

package/dist/bin.js

@@ -225,7 +225,7 @@ import { fileURLToPath } from "url";
 
 // src/commands/init.ts
 import path19 from "path";
-import chalk9 from "chalk";
+import chalk10 from "chalk";
 import ora2 from "ora";
 import select5 from "@inquirer/select";
 import checkbox from "@inquirer/checkbox";
@@ -2062,7 +2062,7 @@ Return a JSON object with this exact shape:
 Respond with ONLY the JSON object, no markdown fences or extra text.`;
 var LEARN_SYSTEM_PROMPT = `You are an expert developer experience engineer. You analyze raw tool call events from AI coding sessions to extract reusable operational lessons that will help future LLM sessions work more effectively in this project.
 
-You receive a chronological sequence of tool events from a Claude Code session. Each event includes the tool name, its input, its response, and whether it was a success or failure.
+You receive a chronological sequence of events from a Claude Code session. Most events are tool calls (with tool name, input, response, and success/failure status). Some events are USER_PROMPT events that capture what the user typed \u2014 these are critical for detecting corrections and redirections.
 
 Your job is to find OPERATIONAL patterns \u2014 things that went wrong and how they were fixed, commands that required specific flags or configuration, APIs that needed a particular approach to work. Focus on the WORKFLOW, not the code logic.
 
@@ -2074,6 +2074,7 @@ Look for:
 4. **Project-specific commands**: The correct way to build, test, lint, deploy \u2014 especially if it differs from defaults.
 5. **File/path traps**: Paths that are misleading, files that shouldn't be edited, directories with unexpected structure.
 6. **Configuration quirks**: Settings, flags, or arguments that are required but non-obvious.
+7. **User corrections**: The user explicitly told the AI what's wrong, what to use instead, or what to avoid. Look for phrases like "no, use X instead of Y", "don't touch/edit/modify X", "that's wrong, you need to...", "always/never do X in this project", "stop, that file is...". These are the HIGHEST VALUE signals \u2014 they represent direct human feedback about project-specific requirements. If a user correction contradicts a pattern you'd otherwise extract, the correction wins.
 
 DO NOT extract:
 - Descriptions of what the code does or how features work (e.g. "compression removes comments" or "skeleton extraction creates outlines")
@@ -2084,21 +2085,30 @@ DO NOT extract:
 From these observations, produce:
 
 ### claudeMdLearnedSection
-A markdown section with concise, actionable bullet points. Your output will be written to CALIBER_LEARNINGS.md \u2014 a standalone file that all AI coding agents (Claude Code, Cursor, Codex) reference for project-specific operational patterns. Each bullet should be a concrete instruction that prevents a future mistake or encodes a discovered workaround. Format: what to do (or avoid), and why.
+A markdown section with concise, actionable bullet points. Your output will be written to CALIBER_LEARNINGS.md \u2014 a standalone file that all AI coding agents (Claude Code, Cursor, Codex) reference for project-specific operational patterns.
+
+Each bullet MUST be prefixed with an observation type in bold brackets. Valid types:
+- **[correction]** \u2014 user explicitly told the AI what's wrong or what to do differently (HIGHEST PRIORITY \u2014 always include these)
+- **[gotcha]** \u2014 a trap or edge case that wastes time if you don't know about it
+- **[fix]** \u2014 a specific failure-to-recovery sequence
+- **[pattern]** \u2014 a reusable approach that works in this project
+- **[env]** \u2014 an environment or configuration requirement
+- **[convention]** \u2014 a project-specific rule or naming convention
 
 Good examples:
-- "Run \`npm install\` before \`npm run build\` \u2014 the build assumes deps are installed and gives a misleading error otherwise"
-- "The test database requires \`DATABASE_URL\` to be set \u2014 use \`source .env.test\` first"
-- "Use \`pnpm\` not \`npm\` \u2014 the lockfile is pnpm-lock.yaml and npm creates conflicts"
-- "Do NOT run \`jest\` directly \u2014 always use \`npm run test\` which sets the correct NODE_ENV"
-- "API calls to \`/v2/users\` require the \`X-Api-Version\` header \u2014 without it you get a 404 that looks like the endpoint doesn't exist"
-- "When \`tsup\` build fails with a type error, run \`npx tsc --noEmit\` first to get the real error \u2014 tsup swallows the details"
-- "Files in \`src/generated/\` are auto-generated \u2014 editing them directly will be overwritten on next build"
+- "**[correction]** Files in \`src/generated/\` are auto-generated \u2014 never edit them directly"
+- "**[correction]** Use \`pnpm\` not \`npm\` \u2014 the lockfile is pnpm-lock.yaml and npm creates conflicts"
+- "**[gotcha]** When \`tsup\` build fails with a type error, run \`npx tsc --noEmit\` first to get the real error \u2014 tsup swallows the details"
+- "**[fix]** If \`npm install\` fails with ERESOLVE, use \`--legacy-peer-deps\`"
+- "**[env]** The test database requires \`DATABASE_URL\` to be set \u2014 use \`source .env.test\` first"
+- "**[pattern]** Do NOT run \`jest\` directly \u2014 always use \`npm run test\` which sets the correct NODE_ENV"
+- "**[convention]** API calls to \`/v2/users\` require the \`X-Api-Version\` header \u2014 without it you get a 404 that looks like the endpoint doesn't exist"
 
 Bad examples (do NOT produce these):
 - "The codebase uses TypeScript with strict mode" (describes code, not actionable)
 - "Components follow a pattern of X" (describes architecture, not operational)
 - "The project has a scoring module" (summarizes code structure)
+- Any bullet without a **[type]** prefix
 
 Rules for the learned section:
 - Be additive: keep all existing learned items, add new ones, remove duplicates
@@ -2676,6 +2686,37 @@ async function generateMonolithic(fingerprint, targetAgent, prompt, callbacks, f
   };
   return attemptGeneration();
 }
+async function generateSkillsForSetup(setup, fingerprint, targetAgent, onStatus) {
+  const skillTopics = collectSkillTopics(setup, targetAgent, fingerprint);
+  if (skillTopics.length === 0) return 0;
+  onStatus?.(`Generating ${skillTopics.length} skills...`);
+  const allDeps = extractAllDeps(process.cwd());
+  const skillContext = buildSkillContext(fingerprint, setup, allDeps);
+  const fastModel = getFastModel();
+  const skillResults = await Promise.allSettled(
+    skillTopics.map(
+      ({ platform, topic }) => generateSkill(skillContext, topic, fastModel).then((skill) => ({ platform, skill }))
+    )
+  );
+  for (const result of skillResults) {
+    if (result.status === "fulfilled") {
+      const { platform, skill } = result.value;
+      const platformObj = setup[platform] ?? {};
+      const skills = platformObj.skills ?? [];
+      skills.push(skill);
+      platformObj.skills = skills;
+      setup[platform] = platformObj;
+      const skillPath = platform === "codex" ? `.agents/skills/${skill.name}/SKILL.md` : `.${platform}/skills/${skill.name}/SKILL.md`;
+      const descriptions = setup.fileDescriptions ?? {};
+      descriptions[skillPath] = skill.description.slice(0, 80);
+      setup.fileDescriptions = descriptions;
+    }
+  }
+  const succeeded = skillResults.filter((r) => r.status === "fulfilled").length;
+  const failed = skillResults.filter((r) => r.status === "rejected").length;
+  if (failed > 0) onStatus?.(`${succeeded} generated, ${failed} failed`);
+  return succeeded;
+}
 var LIMITS = {
   FILE_TREE_ENTRIES: 500,
   EXISTING_CONFIG_CHARS: 8e3,
@@ -3669,8 +3710,8 @@ function removePreCommitHook() {
   if (!content.includes(PRECOMMIT_START)) {
     return { removed: false, notFound: true };
   }
-  const regex = new RegExp(`\\n?${PRECOMMIT_START}[\\s\\S]*?${PRECOMMIT_END}\\n?`);
-  content = content.replace(regex, "\n");
+  const regex2 = new RegExp(`\\n?${PRECOMMIT_START}[\\s\\S]*?${PRECOMMIT_END}\\n?`);
+  content = content.replace(regex2, "\n");
   if (content.trim() === "#!/bin/sh" || content.trim() === "") {
     fs17.unlinkSync(hookPath);
   } else {
@@ -3686,6 +3727,7 @@ var SETTINGS_PATH2 = path13.join(".claude", "settings.json");
 var HOOK_TAILS = [
   { event: "PostToolUse", tail: "learn observe", description: "Caliber: recording tool usage for session learning" },
   { event: "PostToolUseFailure", tail: "learn observe --failure", description: "Caliber: recording tool failure for session learning" },
+  { event: "UserPromptSubmit", tail: "learn observe --prompt", description: "Caliber: recording user prompt for correction detection" },
   { event: "SessionEnd", tail: "learn finalize", description: "Caliber: finalizing session learnings" }
 ];
 function getHookConfigs() {
@@ -3746,6 +3788,7 @@ var CURSOR_HOOKS_PATH = path13.join(".cursor", "hooks.json");
 var CURSOR_HOOK_EVENTS = [
   { event: "postToolUse", tail: "learn observe" },
   { event: "postToolUseFailure", tail: "learn observe --failure" },
+  { event: "userPromptSubmit", tail: "learn observe --prompt" },
   { event: "sessionEnd", tail: "learn finalize" }
 ];
 function readCursorHooks() {
@@ -5995,6 +6038,51 @@ function extractTopDeps() {
     return [];
   }
 }
+async function searchSkills(fingerprint, targetPlatforms, onStatus) {
+  const installedSkills = getInstalledSkills(targetPlatforms);
+  const technologies = [...new Set([
+    ...fingerprint.languages,
+    ...fingerprint.frameworks,
+    ...extractTopDeps()
+  ].filter(Boolean))];
+  if (technologies.length === 0) {
+    return { results: [], contentMap: /* @__PURE__ */ new Map() };
+  }
+  const primaryPlatform = targetPlatforms.includes("claude") ? "claude" : targetPlatforms[0];
+  onStatus?.("Searching skill registries...");
+  const allCandidates = await searchAllProviders(technologies, primaryPlatform);
+  if (!allCandidates.length) {
+    return { results: [], contentMap: /* @__PURE__ */ new Map() };
+  }
+  const newCandidates = allCandidates.filter((c) => !installedSkills.has(c.slug.toLowerCase()));
+  if (!newCandidates.length) {
+    return { results: [], contentMap: /* @__PURE__ */ new Map() };
+  }
+  onStatus?.(`Scoring ${newCandidates.length} candidates...`);
+  let results;
+  const config = loadConfig();
+  if (config) {
+    try {
+      const projectContext = buildProjectContext(fingerprint, targetPlatforms);
+      results = await scoreWithLLM(newCandidates, projectContext, technologies);
+    } catch {
+      results = newCandidates.slice(0, 20);
+    }
+  } else {
+    results = newCandidates.slice(0, 20);
+  }
+  if (results.length === 0) {
+    return { results: [], contentMap: /* @__PURE__ */ new Map() };
+  }
+  onStatus?.("Fetching skill content...");
+  const contentMap = /* @__PURE__ */ new Map();
+  await Promise.all(results.map(async (rec) => {
+    const content = await fetchSkillContent(rec);
+    if (content) contentMap.set(rec.slug, content);
+  }));
+  const available = results.filter((r) => contentMap.has(r.slug));
+  return { results: available, contentMap };
+}
 async function recommendCommand() {
   const proceed = await select4({
     message: "Search public repos for relevant skills to add to this project?",
@@ -6359,13 +6447,144 @@ function formatMs(ms) {
   return `${secs}s`;
 }
 
+// src/utils/parallel-tasks.ts
+import chalk9 from "chalk";
+
+// node_modules/ansi-regex/index.js
+function ansiRegex({ onlyFirst = false } = {}) {
+  const ST = "(?:\\u0007|\\u001B\\u005C|\\u009C)";
+  const osc = `(?:\\u001B\\][\\s\\S]*?${ST})`;
+  const csi = "[\\u001B\\u009B][[\\]()#;?]*(?:\\d{1,4}(?:[;:]\\d{0,4})*)?[\\dA-PR-TZcf-nq-uy=><~]";
+  const pattern = `${osc}|${csi}`;
+  return new RegExp(pattern, onlyFirst ? void 0 : "g");
+}
+
+// node_modules/strip-ansi/index.js
+var regex = ansiRegex();
+function stripAnsi(string) {
+  if (typeof string !== "string") {
+    throw new TypeError(`Expected a \`string\`, got \`${typeof string}\``);
+  }
+  if (!string.includes("\x1B") && !string.includes("\x9B")) {
+    return string;
+  }
+  return string.replace(regex, "");
+}
+
+// src/utils/parallel-tasks.ts
+var SPINNER_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+var SPINNER_INTERVAL_MS = 80;
+var ParallelTaskDisplay = class {
+  tasks = [];
+  lineCount = 0;
+  spinnerFrame = 0;
+  timer = null;
+  startTime = 0;
+  rendered = false;
+  add(name) {
+    const index = this.tasks.length;
+    this.tasks.push({ name, status: "pending", message: "" });
+    return index;
+  }
+  start() {
+    this.startTime = Date.now();
+    this.draw(true);
+    this.timer = setInterval(() => {
+      this.spinnerFrame = (this.spinnerFrame + 1) % SPINNER_FRAMES.length;
+      this.draw(false);
+    }, SPINNER_INTERVAL_MS);
+  }
+  update(index, status, message) {
+    const task = this.tasks[index];
+    if (!task) return;
+    if (status === "running" && task.status === "pending") {
+      task.startTime = Date.now();
+    }
+    if ((status === "done" || status === "failed") && !task.endTime) {
+      task.endTime = Date.now();
+    }
+    task.status = status;
+    if (message !== void 0) task.message = message;
+  }
+  stop() {
+    if (this.timer) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+    this.draw(false);
+  }
+  formatTime(ms) {
+    const secs = Math.floor(ms / 1e3);
+    if (secs < 60) return `${secs}s`;
+    return `${Math.floor(secs / 60)}m ${secs % 60}s`;
+  }
+  truncate(text, maxVisible) {
+    const plain = stripAnsi(text);
+    if (plain.length <= maxVisible) return text;
+    let visible = 0;
+    let i = 0;
+    while (i < text.length && visible < maxVisible - 3) {
+      if (text[i] === "\x1B") {
+        const end = text.indexOf("m", i);
+        if (end !== -1) {
+          i = end + 1;
+          continue;
+        }
+      }
+      visible++;
+      i++;
+    }
+    return text.slice(0, i) + "...";
+  }
+  renderLine(task) {
+    const maxWidth = process.stdout.columns || 80;
+    const elapsed = task.startTime ? this.formatTime((task.endTime ?? Date.now()) - task.startTime) : "";
+    let line;
+    switch (task.status) {
+      case "pending":
+        line = `  ${chalk9.dim("\u25CB")} ${chalk9.dim(task.name)}${task.message ? chalk9.dim(` \u2014 ${task.message}`) : ""}`;
+        break;
+      case "running": {
+        const spinner = chalk9.cyan(SPINNER_FRAMES[this.spinnerFrame]);
+        const time = elapsed ? chalk9.dim(` (${elapsed})`) : "";
+        line = `  ${spinner} ${task.name}${task.message ? chalk9.dim(` \u2014 ${task.message}`) : ""}${time}`;
+        break;
+      }
+      case "done": {
+        const time = elapsed ? chalk9.dim(` (${elapsed})`) : "";
+        line = `  ${chalk9.green("\u2713")} ${task.name}${task.message ? chalk9.dim(` \u2014 ${task.message}`) : ""}${time}`;
+        break;
+      }
+      case "failed":
+        line = `  ${chalk9.red("\u2717")} ${task.name}${task.message ? chalk9.red(` \u2014 ${task.message}`) : ""}`;
+        break;
+    }
+    return this.truncate(line, maxWidth - 1);
+  }
+  draw(initial) {
+    const { stdout } = process;
+    if (!initial && this.rendered && this.lineCount > 0) {
+      stdout.write(`\x1B[${this.lineCount}A`);
+    }
+    stdout.write("\x1B[0J");
+    const lines = this.tasks.map((t) => this.renderLine(t));
+    const totalElapsed = this.formatTime(Date.now() - this.startTime);
+    lines.push(chalk9.dim(`
+  Total: ${totalElapsed}`));
+    const output = lines.join("\n");
+    stdout.write(output + "\n");
+    this.lineCount = output.split("\n").length;
+    this.rendered = true;
+  }
+};
+
 // src/commands/init.ts
 function log(verbose, ...args) {
-  if (verbose) console.log(chalk9.dim(`  [verbose] ${args.map(String).join(" ")}`));
+  if (verbose) console.log(chalk10.dim(`  [verbose] ${args.map(String).join(" ")}`));
 }
 async function initCommand(options) {
-  const brand = chalk9.hex("#EB9D83");
-  const title = chalk9.hex("#83D1EB");
+  const brand = chalk10.hex("#EB9D83");
+  const title = chalk10.hex("#83D1EB");
   console.log(brand.bold(`
    \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557     \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557
   \u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551     \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557
@@ -6374,34 +6593,33 @@ async function initCommand(options) {
   \u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551  \u2588\u2588\u2551
    \u255A\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D
   `));
-  console.log(chalk9.dim("  Scan your project and generate tailored config files for"));
-  console.log(chalk9.dim("  Claude Code, Cursor, and Codex.\n"));
+  console.log(chalk10.dim("  Scan your project and generate tailored config files for"));
+  console.log(chalk10.dim("  Claude Code, Cursor, and Codex.\n"));
   const report = options.debugReport ? new DebugReport() : null;
   console.log(title.bold("  How it works:\n"));
-  console.log(chalk9.dim("  1. Connect    Choose your LLM provider"));
-  console.log(chalk9.dim("  2. Discover   Scan code, dependencies, and existing configs"));
-  console.log(chalk9.dim("  3. Generate   Build CLAUDE.md, rules, and skills for your codebase"));
-  console.log(chalk9.dim("  4. Review     See a diff \u2014 accept, refine via chat, or decline"));
-  console.log(chalk9.dim("  5. Skills     Search community registries and install skills\n"));
-  console.log(title.bold("  Step 1/5 \u2014 Connect\n"));
+  console.log(chalk10.dim("  1. Setup      Connect your LLM provider and select your agents"));
+  console.log(chalk10.dim("  2. Engine     Detect stack, generate configs & skills in parallel"));
+  console.log(chalk10.dim("  3. Review     See all changes \u2014 accept, refine, or decline"));
+  console.log(chalk10.dim("  4. Finalize   Score check and auto-sync hooks\n"));
+  console.log(title.bold("  Step 1/4 \u2014 Setup\n"));
   let config = loadConfig();
   if (!config) {
-    console.log(chalk9.dim("  No LLM provider set yet. Choose how to run Caliber:\n"));
+    console.log(chalk10.dim("  No LLM provider configured yet.\n"));
     await runInteractiveProviderSetup({
       selectMessage: "How do you want to use Caliber? (choose LLM provider)"
     });
     config = loadConfig();
     if (!config) {
-      console.log(chalk9.red("  Setup was cancelled or failed.\n"));
+      console.log(chalk10.red("  Setup was cancelled or failed.\n"));
       throw new Error("__exit__");
     }
-    console.log(chalk9.green("  \u2713 Provider saved. Let's continue.\n"));
+    console.log(chalk10.green("  \u2713 Provider saved\n"));
   }
   trackInitProviderSelected(config.provider, config.model);
   const displayModel = getDisplayModel(config);
   const fastModel = getFastModel();
   const modelLine = fastModel ? `  Provider: ${config.provider} | Model: ${displayModel} | Scan: ${fastModel}` : `  Provider: ${config.provider} | Model: ${displayModel}`;
-  console.log(chalk9.dim(modelLine + "\n"));
+  console.log(chalk10.dim(modelLine + "\n"));
   if (report) {
     report.markStep("Provider setup");
     report.addSection("LLM Provider", `- **Provider**: ${config.provider}
@@ -6409,30 +6627,6 @@ async function initCommand(options) {
 - **Fast model**: ${fastModel || "none"}`);
   }
   await validateModel({ fast: true });
-  console.log(title.bold("  Step 2/5 \u2014 Discover\n"));
-  const spinner = ora2("Scanning code, dependencies, and existing configs...").start();
-  const fingerprint = await collectFingerprint(process.cwd());
-  spinner.succeed("Project scanned");
-  log(options.verbose, `Fingerprint: ${fingerprint.languages.length} languages, ${fingerprint.frameworks.length} frameworks, ${fingerprint.fileTree.length} files`);
-  if (options.verbose && fingerprint.codeAnalysis) {
-    log(options.verbose, `Code analysis: ${fingerprint.codeAnalysis.filesIncluded}/${fingerprint.codeAnalysis.filesAnalyzed} files, ~${fingerprint.codeAnalysis.includedTokens.toLocaleString()} tokens, ${fingerprint.codeAnalysis.duplicateGroups} dedup groups`);
-  }
-  trackInitProjectDiscovered(fingerprint.languages.length, fingerprint.frameworks.length, fingerprint.fileTree.length);
-  const langDisplay = fingerprint.languages.join(", ") || "none detected";
-  const frameworkDisplay = fingerprint.frameworks.length > 0 ? ` (${fingerprint.frameworks.join(", ")})` : "";
-  console.log(chalk9.dim(`  Languages: ${langDisplay}${frameworkDisplay}`));
-  console.log(chalk9.dim(`  Files: ${fingerprint.fileTree.length} found
-`));
-  if (report) {
-    report.markStep("Fingerprint");
-    report.addJson("Fingerprint: Git", { remote: fingerprint.gitRemoteUrl, packageName: fingerprint.packageName });
-    report.addCodeBlock("Fingerprint: File Tree", fingerprint.fileTree.join("\n"));
-    report.addJson("Fingerprint: Detected Stack", { languages: fingerprint.languages, frameworks: fingerprint.frameworks, tools: fingerprint.tools });
-    report.addJson("Fingerprint: Existing Configs", fingerprint.existingConfigs);
-    if (fingerprint.codeAnalysis) {
-      report.addJson("Fingerprint: Code Analysis", fingerprint.codeAnalysis);
-    }
-  }
   let targetAgent;
   if (options.agent) {
     targetAgent = options.agent;
@@ -6442,30 +6636,27 @@ async function initCommand(options) {
   } else {
     targetAgent = await promptAgent();
   }
-  console.log(chalk9.dim(`  Target: ${targetAgent.join(", ")}
+  console.log(chalk10.dim(`  Target: ${targetAgent.join(", ")}
 `));
   trackInitAgentSelected(targetAgent);
-  const preScore = computeLocalScore(process.cwd(), targetAgent);
-  const failingForDismissal = preScore.checks.filter((c) => !c.passed && c.maxPoints > 0);
-  if (failingForDismissal.length > 0) {
-    const newDismissals = await evaluateDismissals(failingForDismissal, fingerprint);
-    if (newDismissals.length > 0) {
-      const existing = readDismissedChecks();
-      const existingIds = new Set(existing.map((d) => d.id));
-      const merged = [...existing, ...newDismissals.filter((d) => !existingIds.has(d.id))];
-      writeDismissedChecks(merged);
-    }
+  let wantsSkills = false;
+  if (!options.autoApprove) {
+    wantsSkills = await select5({
+      message: "Discover community-maintained skills that match your stack?",
+      choices: [
+        { name: "Yes, find skills for my project", value: true },
+        { name: "Skip for now", value: false }
+      ]
+    });
   }
-  const baselineScore = computeLocalScore(process.cwd(), targetAgent);
-  console.log(chalk9.dim("  Current setup score:"));
+  let baselineScore = computeLocalScore(process.cwd(), targetAgent);
+  console.log(chalk10.dim("\n  Current setup score:"));
   displayScoreSummary(baselineScore);
   if (options.verbose) {
     for (const c of baselineScore.checks) {
       log(options.verbose, `  ${c.passed ? "\u2713" : "\u2717"} ${c.name}: ${c.earnedPoints}/${c.maxPoints}${c.suggestion ? ` \u2014 ${c.suggestion}` : ""}`);
     }
   }
-  const passingCount = baselineScore.checks.filter((c) => c.passed).length;
-  const failingCount = baselineScore.checks.filter((c) => !c.passed).length;
   if (report) {
     report.markStep("Baseline scoring");
     report.addSection("Scoring: Baseline", `**Score**: ${baselineScore.score}/100
@@ -6475,7 +6666,7 @@ async function initCommand(options) {
 ` + baselineScore.checks.map((c) => `| ${c.name} | ${c.passed ? "Yes" : "No"} | ${c.earnedPoints} | ${c.maxPoints} |`).join("\n"));
     report.addSection("Generation: Target Agents", targetAgent.join(", "));
   }
-  const hasExistingConfig = !!(fingerprint.existingConfigs.claudeMd || fingerprint.existingConfigs.claudeSettings || fingerprint.existingConfigs.claudeSkills?.length || fingerprint.existingConfigs.cursorrules || fingerprint.existingConfigs.cursorRules?.length || fingerprint.existingConfigs.agentsMd);
+  const hasExistingConfig = !!(baselineScore.checks.some((c) => c.id === "claude_md_exists" && c.passed) || baselineScore.checks.some((c) => c.id === "cursorrules_exists" && c.passed));
   const NON_LLM_CHECKS = /* @__PURE__ */ new Set([
     "hooks_configured",
     "agents_md_exists",
@@ -6484,111 +6675,175 @@ async function initCommand(options) {
     "service_coverage",
     "mcp_completeness"
   ]);
+  const passingCount = baselineScore.checks.filter((c) => c.passed).length;
+  const failingCount = baselineScore.checks.filter((c) => !c.passed).length;
   if (hasExistingConfig && baselineScore.score === 100) {
     trackInitScoreComputed(baselineScore.score, passingCount, failingCount, true);
-    console.log(chalk9.bold.green("  Your setup is already optimal \u2014 nothing to change.\n"));
-    console.log(chalk9.dim("  Run ") + chalk9.hex("#83D1EB")("caliber init --force") + chalk9.dim(" to regenerate anyway.\n"));
+    console.log(chalk10.bold.green("  Your setup is already optimal \u2014 nothing to change.\n"));
+    console.log(chalk10.dim("  Run ") + chalk10.hex("#83D1EB")("caliber init --force") + chalk10.dim(" to regenerate anyway.\n"));
     if (!options.force) return;
   }
   const allFailingChecks = baselineScore.checks.filter((c) => !c.passed && c.maxPoints > 0);
   const llmFixableChecks = allFailingChecks.filter((c) => !NON_LLM_CHECKS.has(c.id));
   trackInitScoreComputed(baselineScore.score, passingCount, failingCount, false);
   if (hasExistingConfig && llmFixableChecks.length === 0 && allFailingChecks.length > 0 && !options.force) {
-    console.log(chalk9.bold.green("\n  Your config is fully optimized for LLM generation.\n"));
-    console.log(chalk9.dim("  Remaining items need CLI actions:\n"));
+    console.log(chalk10.bold.green("\n  Your config is fully optimized for LLM generation.\n"));
+    console.log(chalk10.dim("  Remaining items need CLI actions:\n"));
     for (const check of allFailingChecks) {
-      console.log(chalk9.dim(`    \u2022 ${check.name}`));
+      console.log(chalk10.dim(`    \u2022 ${check.name}`));
       if (check.suggestion) {
-        console.log(`      ${chalk9.hex("#83D1EB")(check.suggestion)}`);
+        console.log(`      ${chalk10.hex("#83D1EB")(check.suggestion)}`);
       }
     }
     console.log("");
-    console.log(chalk9.dim("  Run ") + chalk9.hex("#83D1EB")("caliber init --force") + chalk9.dim(" to regenerate anyway.\n"));
+    console.log(chalk10.dim("  Run ") + chalk10.hex("#83D1EB")("caliber init --force") + chalk10.dim(" to regenerate anyway.\n"));
     return;
   }
+  console.log(title.bold("  Step 2/4 \u2014 Engine\n"));
+  const genModelInfo = fastModel ? `  Using ${displayModel} for docs, ${fastModel} for skills` : `  Using ${displayModel}`;
+  console.log(chalk10.dim(genModelInfo + "\n"));
+  if (report) report.markStep("Generation");
+  trackInitGenerationStarted(false);
+  const genStartTime = Date.now();
+  let generatedSetup = null;
+  let rawOutput;
+  let genStopReason;
+  let skillSearchResult = { results: [], contentMap: /* @__PURE__ */ new Map() };
+  let fingerprint;
+  const fpSpinner = ora2("Scanning project...").start();
+  try {
+    fingerprint = await collectFingerprint(process.cwd());
+    fpSpinner.succeed(`Stack detected \u2014 ${fingerprint.languages.join(", ") || "no languages"}${fingerprint.frameworks.length > 0 ? `, ${fingerprint.frameworks.join(", ")}` : ""}`);
+  } catch (err) {
+    fpSpinner.fail("Failed to scan project");
+    throw new Error("__exit__");
+  }
+  trackInitProjectDiscovered(fingerprint.languages.length, fingerprint.frameworks.length, fingerprint.fileTree.length);
+  log(options.verbose, `Fingerprint: ${fingerprint.languages.length} languages, ${fingerprint.frameworks.length} frameworks, ${fingerprint.fileTree.length} files`);
+  if (report) {
+    report.addJson("Fingerprint: Git", { remote: fingerprint.gitRemoteUrl, packageName: fingerprint.packageName });
+    report.addCodeBlock("Fingerprint: File Tree", fingerprint.fileTree.join("\n"));
+    report.addJson("Fingerprint: Detected Stack", { languages: fingerprint.languages, frameworks: fingerprint.frameworks, tools: fingerprint.tools });
+    report.addJson("Fingerprint: Existing Configs", fingerprint.existingConfigs);
+    if (fingerprint.codeAnalysis) report.addJson("Fingerprint: Code Analysis", fingerprint.codeAnalysis);
+  }
   const isEmpty = fingerprint.fileTree.length < 3;
   if (isEmpty) {
     fingerprint.description = await promptInput("What will you build in this project?");
   }
+  const failingForDismissal = baselineScore.checks.filter((c) => !c.passed && c.maxPoints > 0);
+  if (failingForDismissal.length > 0) {
+    const newDismissals = await evaluateDismissals(failingForDismissal, fingerprint);
+    if (newDismissals.length > 0) {
+      const existing = readDismissedChecks();
+      const existingIds = new Set(existing.map((d) => d.id));
+      const merged = [...existing, ...newDismissals.filter((d) => !existingIds.has(d.id))];
+      writeDismissedChecks(merged);
+      baselineScore = computeLocalScore(process.cwd(), targetAgent);
+    }
+  }
   let failingChecks;
   let passingChecks;
   let currentScore;
   if (hasExistingConfig && baselineScore.score >= 95 && !options.force) {
-    failingChecks = llmFixableChecks.map((c) => ({ name: c.name, suggestion: c.suggestion, fix: c.fix }));
+    const currentLlmFixable = baselineScore.checks.filter((c) => !c.passed && c.maxPoints > 0 && !NON_LLM_CHECKS.has(c.id));
+    failingChecks = currentLlmFixable.map((c) => ({ name: c.name, suggestion: c.suggestion, fix: c.fix }));
     passingChecks = baselineScore.checks.filter((c) => c.passed).map((c) => ({ name: c.name }));
     currentScore = baselineScore.score;
-    if (failingChecks.length > 0) {
-      console.log(title.bold("  Step 3/5 \u2014 Generate\n"));
-      console.log(chalk9.dim(`  Score is ${baselineScore.score}/100 \u2014 fine-tuning ${failingChecks.length} remaining issue${failingChecks.length === 1 ? "" : "s"}:
-`));
-      for (const check of failingChecks) {
-        console.log(chalk9.dim(`    \u2022 ${check.name}`));
-      }
-      console.log("");
-    }
-  } else if (hasExistingConfig) {
-    console.log(title.bold("  Step 3/5 \u2014 Generate\n"));
-    console.log(chalk9.dim("  Auditing your existing configs against your codebase and improving them.\n"));
-  } else {
-    console.log(title.bold("  Step 3/5 \u2014 Generate\n"));
-    console.log(chalk9.dim("  Building CLAUDE.md, rules, and skills tailored to your project.\n"));
   }
-  const genModelInfo = fastModel ? `  Using ${displayModel} for docs, ${fastModel} for skills` : `  Using ${displayModel}`;
-  console.log(chalk9.dim(genModelInfo));
-  console.log(chalk9.dim("  This can take a couple of minutes depending on your model and provider.\n"));
   if (report) {
-    report.markStep("Generation");
     const fullPrompt = buildGeneratePrompt(fingerprint, targetAgent, fingerprint.description, failingChecks, currentScore, passingChecks);
     report.addCodeBlock("Generation: Full LLM Prompt", fullPrompt);
   }
-  trackInitGenerationStarted(!!failingChecks);
-  const genStartTime = Date.now();
-  const genSpinner = ora2("Generating setup...").start();
-  const genMessages = new SpinnerMessages(genSpinner, GENERATION_MESSAGES, { showElapsedTime: true });
-  genMessages.start();
-  let generatedSetup = null;
-  let rawOutput;
-  let genStopReason;
+  const display = new ParallelTaskDisplay();
+  const TASK_CONFIG = display.add("Generating configs");
+  const TASK_SKILLS_GEN = display.add("Generating skills");
+  const TASK_SKILLS_SEARCH = wantsSkills ? display.add("Searching community skills") : -1;
+  display.start();
   try {
-    const result = await generateSetup(
-      fingerprint,
-      targetAgent,
-      fingerprint.description,
-      {
-        onStatus: (status) => {
-          genMessages.handleServerStatus(status);
-        },
-        onComplete: (setup) => {
-          generatedSetup = setup;
+    display.update(TASK_CONFIG, "running");
+    const generatePromise = (async () => {
+      const result = await generateSetup(
+        fingerprint,
+        targetAgent,
+        fingerprint.description,
+        {
+          onStatus: (status) => display.update(TASK_CONFIG, "running", status),
+          onComplete: (setup) => {
+            generatedSetup = setup;
+          },
+          onError: (error) => display.update(TASK_CONFIG, "failed", error)
         },
-        onError: (error) => {
-          genMessages.stop();
-          genSpinner.fail(`Generation error: ${error}`);
-        }
-      },
-      failingChecks,
-      currentScore,
-      passingChecks
-    );
-    if (!generatedSetup) {
-      generatedSetup = result.setup;
+        failingChecks,
+        currentScore,
+        passingChecks,
+        { skipSkills: true }
+      );
+      if (!generatedSetup) generatedSetup = result.setup;
       rawOutput = result.raw;
-    }
-    genStopReason = result.stopReason;
+      genStopReason = result.stopReason;
+      if (!generatedSetup) {
+        display.update(TASK_CONFIG, "failed", "Could not parse LLM response");
+        display.update(TASK_SKILLS_GEN, "failed", "Skipped");
+        return;
+      }
+      display.update(TASK_CONFIG, "done");
+      display.update(TASK_SKILLS_GEN, "running");
+      const skillCount = await generateSkillsForSetup(
+        generatedSetup,
+        fingerprint,
+        targetAgent,
+        (status) => display.update(TASK_SKILLS_GEN, "running", status)
+      );
+      display.update(TASK_SKILLS_GEN, "done", `${skillCount} skills`);
+    })();
+    const SEARCH_TIMEOUT_MS = 6e4;
+    const searchPromise = wantsSkills ? (async () => {
+      display.update(TASK_SKILLS_SEARCH, "running");
+      try {
+        const searchWithTimeout = Promise.race([
+          searchSkills(
+            fingerprint,
+            targetAgent,
+            (status) => display.update(TASK_SKILLS_SEARCH, "running", status)
+          ),
+          new Promise(
+            (_, reject) => setTimeout(() => reject(new Error("timeout")), SEARCH_TIMEOUT_MS)
+          )
+        ]);
+        skillSearchResult = await searchWithTimeout;
+        const count = skillSearchResult.results.length;
+        display.update(TASK_SKILLS_SEARCH, "done", count > 0 ? `${count} skills found` : "No matches");
+      } catch (err) {
+        const reason = err instanceof Error && err.message === "timeout" ? "Timed out" : "Search failed";
+        display.update(TASK_SKILLS_SEARCH, "failed", reason);
+      }
+    })() : Promise.resolve();
+    await Promise.all([generatePromise, searchPromise]);
   } catch (err) {
-    genMessages.stop();
+    display.stop();
     const msg = err instanceof Error ? err.message : "Unknown error";
-    genSpinner.fail(`Generation failed: ${msg}`);
+    console.log(chalk10.red(`
+  Engine failed: ${msg}
+`));
     writeErrorLog(config, void 0, msg, "exception");
     throw new Error("__exit__");
   }
-  genMessages.stop();
+  display.stop();
+  const elapsedMs = Date.now() - genStartTime;
+  trackInitGenerationCompleted(elapsedMs, 0);
+  const mins = Math.floor(elapsedMs / 6e4);
+  const secs = Math.floor(elapsedMs % 6e4 / 1e3);
+  const timeStr = mins > 0 ? `${mins}m ${secs}s` : `${secs}s`;
+  console.log(chalk10.dim(`
+  Completed in ${timeStr}
+`));
   if (!generatedSetup) {
-    genSpinner.fail("Failed to generate setup.");
+    console.log(chalk10.red("  Failed to generate setup."));
     writeErrorLog(config, rawOutput, void 0, genStopReason);
     if (rawOutput) {
-      console.log(chalk9.dim("\nRaw LLM output (JSON parse failed):"));
-      console.log(chalk9.dim(rawOutput.slice(0, 500)));
+      console.log(chalk10.dim("\nRaw LLM output (JSON parse failed):"));
+      console.log(chalk10.dim(rawOutput.slice(0, 500)));
     }
     throw new Error("__exit__");
   }
@@ -6596,12 +6851,6 @@ async function initCommand(options) {
     if (rawOutput) report.addCodeBlock("Generation: Raw LLM Response", rawOutput);
     report.addJson("Generation: Parsed Setup", generatedSetup);
   }
-  const elapsedMs = Date.now() - genStartTime;
-  trackInitGenerationCompleted(elapsedMs, 0);
-  const mins = Math.floor(elapsedMs / 6e4);
-  const secs = Math.floor(elapsedMs % 6e4 / 1e3);
-  const timeStr = mins > 0 ? `${mins}m ${secs}s` : `${secs}s`;
-  genSpinner.succeed(`Setup generated ${chalk9.dim(`in ${timeStr}`)}`);
   log(options.verbose, `Generation completed: ${elapsedMs}ms, stopReason: ${genStopReason || "end_turn"}`);
   printSetupSummary(generatedSetup);
   const sessionHistory = [];
@@ -6609,15 +6858,20 @@ async function initCommand(options) {
     role: "assistant",
     content: summarizeSetup("Initial generation", generatedSetup)
   });
-  console.log(title.bold("  Step 4/5 \u2014 Review\n"));
+  console.log(title.bold("  Step 3/4 \u2014 Review\n"));
   const setupFiles = collectSetupFiles(generatedSetup, targetAgent);
   const staged = stageFiles(setupFiles, process.cwd());
   const totalChanges = staged.newFiles + staged.modifiedFiles;
-  console.log(chalk9.dim(`  ${chalk9.green(`${staged.newFiles} new`)} / ${chalk9.yellow(`${staged.modifiedFiles} modified`)} file${totalChanges !== 1 ? "s" : ""}
+  console.log(chalk10.dim(`  ${chalk10.green(`${staged.newFiles} new`)} / ${chalk10.yellow(`${staged.modifiedFiles} modified`)} file${totalChanges !== 1 ? "s" : ""}`));
+  if (skillSearchResult.results.length > 0) {
+    console.log(chalk10.dim(`  ${chalk10.cyan(`${skillSearchResult.results.length}`)} community skills available to install
 `));
+  } else {
+    console.log("");
+  }
   let action;
-  if (totalChanges === 0) {
-    console.log(chalk9.dim("  No changes needed \u2014 your configs are already up to date.\n"));
+  if (totalChanges === 0 && skillSearchResult.results.length === 0) {
+    console.log(chalk10.dim("  No changes needed \u2014 your configs are already up to date.\n"));
     cleanupStaging();
     action = "accept";
   } else if (options.autoApprove) {
@@ -6625,13 +6879,15 @@ async function initCommand(options) {
     action = "accept";
     trackInitReviewAction(action, "auto-approved");
   } else {
-    const wantsReview = await promptWantsReview();
-    if (wantsReview) {
-      const reviewMethod = await promptReviewMethod();
-      await openReview(reviewMethod, staged.stagedFiles);
+    if (totalChanges > 0) {
+      const wantsReview = await promptWantsReview();
+      if (wantsReview) {
+        const reviewMethod = await promptReviewMethod();
+        await openReview(reviewMethod, staged.stagedFiles);
+      }
     }
     action = await promptReviewAction();
-    trackInitReviewAction(action, wantsReview ? "reviewed" : "skipped");
+    trackInitReviewAction(action, totalChanges > 0 ? "reviewed" : "skipped");
   }
   let refinementRound = 0;
   while (action === "refine") {
@@ -6640,12 +6896,12 @@ async function initCommand(options) {
     trackInitRefinementRound(refinementRound, !!generatedSetup);
     if (!generatedSetup) {
       cleanupStaging();
-      console.log(chalk9.dim("Refinement cancelled. No files were modified."));
+      console.log(chalk10.dim("Refinement cancelled. No files were modified."));
       return;
     }
     const updatedFiles = collectSetupFiles(generatedSetup, targetAgent);
     const restaged = stageFiles(updatedFiles, process.cwd());
-    console.log(chalk9.dim(`  ${chalk9.green(`${restaged.newFiles} new`)} / ${chalk9.yellow(`${restaged.modifiedFiles} modified`)} file${restaged.newFiles + restaged.modifiedFiles !== 1 ? "s" : ""}
+    console.log(chalk10.dim(`  ${chalk10.green(`${restaged.newFiles} new`)} / ${chalk10.yellow(`${restaged.modifiedFiles} modified`)} file${restaged.newFiles + restaged.modifiedFiles !== 1 ? "s" : ""}
 `));
     printSetupSummary(generatedSetup);
     await openReview("terminal", restaged.stagedFiles);
@@ -6654,11 +6910,12 @@ async function initCommand(options) {
   }
   cleanupStaging();
   if (action === "decline") {
-    console.log(chalk9.dim("Setup declined. No files were modified."));
+    console.log(chalk10.dim("Setup declined. No files were modified."));
     return;
   }
+  console.log(title.bold("\n  Step 4/4 \u2014 Finalize\n"));
   if (options.dryRun) {
-    console.log(chalk9.yellow("\n[Dry run] Would write the following files:"));
+    console.log(chalk10.yellow("\n[Dry run] Would write the following files:"));
     console.log(JSON.stringify(generatedSetup, null, 2));
     return;
   }
@@ -6687,85 +6944,45 @@ ${agentRefs.join(" ")}
       0,
       result.deleted.length
     );
-    console.log(chalk9.bold("\nFiles created/updated:"));
+    console.log(chalk10.bold("\nFiles created/updated:"));
     for (const file of result.written) {
-      console.log(`  ${chalk9.green("\u2713")} ${file}`);
+      console.log(`  ${chalk10.green("\u2713")} ${file}`);
     }
     if (result.deleted.length > 0) {
-      console.log(chalk9.bold("\nFiles removed:"));
+      console.log(chalk10.bold("\nFiles removed:"));
       for (const file of result.deleted) {
-        console.log(`  ${chalk9.red("\u2717")} ${file}`);
+        console.log(`  ${chalk10.red("\u2717")} ${file}`);
       }
     }
     if (result.backupDir) {
-      console.log(chalk9.dim(`
+      console.log(chalk10.dim(`
   Backups saved to ${result.backupDir}`));
     }
   } catch (err) {
     writeSpinner.fail("Failed to write files");
-    console.error(chalk9.red(err instanceof Error ? err.message : "Unknown error"));
+    console.error(chalk10.red(err instanceof Error ? err.message : "Unknown error"));
     throw new Error("__exit__");
   }
-  ensurePermissions(fingerprint);
+  if (fingerprint) ensurePermissions(fingerprint);
   const sha = getCurrentHeadSha();
   writeState({
     lastRefreshSha: sha ?? "",
     lastRefreshTimestamp: (/* @__PURE__ */ new Date()).toISOString(),
     targetAgent
   });
-  console.log("");
-  console.log(chalk9.dim("  Auto-refresh: keep your configs in sync as your code changes.\n"));
-  let hookChoice;
-  if (options.autoApprove) {
-    hookChoice = "skip";
-    log(options.verbose, "Auto-approve: skipping hook installation");
-  } else {
-    hookChoice = await promptHookType(targetAgent);
-  }
-  trackInitHookSelected(hookChoice);
-  if (hookChoice === "claude" || hookChoice === "both") {
-    const hookResult = installHook();
-    if (hookResult.installed) {
-      console.log(`  ${chalk9.green("\u2713")} Claude Code hook installed \u2014 docs update on session end`);
-      console.log(chalk9.dim("    Run ") + chalk9.hex("#83D1EB")("caliber hooks --remove") + chalk9.dim(" to disable"));
-    } else if (hookResult.alreadyInstalled) {
-      console.log(chalk9.dim("  Claude Code hook already installed"));
-    }
-    const learnResult = installLearningHooks();
-    if (learnResult.installed) {
-      console.log(`  ${chalk9.green("\u2713")} Learning hooks installed \u2014 session insights captured automatically`);
-      console.log(chalk9.dim("    Run ") + chalk9.hex("#83D1EB")("caliber learn remove") + chalk9.dim(" to disable"));
-    } else if (learnResult.alreadyInstalled) {
-      console.log(chalk9.dim("  Learning hooks already installed"));
-    }
-  }
-  if (hookChoice === "precommit" || hookChoice === "both") {
-    const precommitResult = installPreCommitHook();
-    if (precommitResult.installed) {
-      console.log(`  ${chalk9.green("\u2713")} Pre-commit hook installed \u2014 docs refresh before each commit`);
-      console.log(chalk9.dim("    Run ") + chalk9.hex("#83D1EB")("caliber hooks --remove") + chalk9.dim(" to disable"));
-    } else if (precommitResult.alreadyInstalled) {
-      console.log(chalk9.dim("  Pre-commit hook already installed"));
-    } else {
-      console.log(chalk9.yellow("  Could not install pre-commit hook (not a git repository?)"));
-    }
-  }
-  if (hookChoice === "skip") {
-    console.log(chalk9.dim("  Skipped auto-refresh hooks. Run ") + chalk9.hex("#83D1EB")("caliber hooks --install") + chalk9.dim(" later to enable."));
-  }
   const afterScore = computeLocalScore(process.cwd(), targetAgent);
   if (afterScore.score < baselineScore.score) {
     trackInitScoreRegression(baselineScore.score, afterScore.score);
     console.log("");
-    console.log(chalk9.yellow(`  Score would drop from ${baselineScore.score} to ${afterScore.score} \u2014 reverting changes.`));
+    console.log(chalk10.yellow(`  Score would drop from ${baselineScore.score} to ${afterScore.score} \u2014 reverting changes.`));
     try {
       const { restored, removed } = undoSetup();
       if (restored.length > 0 || removed.length > 0) {
-        console.log(chalk9.dim(`  Reverted ${restored.length + removed.length} file${restored.length + removed.length === 1 ? "" : "s"} from backup.`));
+        console.log(chalk10.dim(`  Reverted ${restored.length + removed.length} file${restored.length + removed.length === 1 ? "" : "s"} from backup.`));
       }
     } catch {
     }
-    console.log(chalk9.dim("  Run ") + chalk9.hex("#83D1EB")("caliber init --force") + chalk9.dim(" to override.\n"));
+    console.log(chalk10.dim("  Run ") + chalk10.hex("#83D1EB")("caliber init --force") + chalk10.dim(" to override.\n"));
     return;
   }
   if (report) {
@@ -6783,39 +7000,57 @@ ${agentRefs.join(" ")}
       log(options.verbose, `  Still failing: ${c.name} (${c.earnedPoints}/${c.maxPoints})${c.suggestion ? ` \u2014 ${c.suggestion}` : ""}`);
     }
   }
-  console.log(title.bold("\n  Step 5/5 \u2014 Skills\n"));
-  console.log(chalk9.dim("  Search community registries for skills that match your tech stack.\n"));
-  let wantsSkills;
+  if (skillSearchResult.results.length > 0 && !options.autoApprove) {
+    console.log(chalk10.dim("  Community skills matched to your project:\n"));
+    const selected = await interactiveSelect(skillSearchResult.results);
+    if (selected?.length) {
+      await installSkills(selected, targetAgent, skillSearchResult.contentMap);
+      trackInitSkillsSearch(true, selected.length);
+    }
+  }
+  console.log("");
+  let hookChoice;
   if (options.autoApprove) {
-    wantsSkills = false;
-    log(options.verbose, "Auto-approve: skipping skills search");
+    hookChoice = "skip";
+    log(options.verbose, "Auto-approve: skipping hook installation");
   } else {
-    wantsSkills = await select5({
-      message: "Search public repos for relevant skills to add to this project?",
-      choices: [
-        { name: "Yes, find skills for my project", value: true },
-        { name: "Skip for now", value: false }
-      ]
-    });
+    hookChoice = await promptHookType(targetAgent);
   }
-  if (wantsSkills) {
-    trackInitSkillsSearch(true, 0);
-    try {
-      await searchAndInstallSkills(targetAgent);
-    } catch (err) {
-      if (err.message !== "__exit__") {
-        console.log(chalk9.dim("  Skills search failed: " + (err.message || "unknown error")));
-      }
-      console.log(chalk9.dim("  Run ") + chalk9.hex("#83D1EB")("caliber skills") + chalk9.dim(" later to try again.\n"));
+  trackInitHookSelected(hookChoice);
+  if (hookChoice === "claude" || hookChoice === "both") {
+    const hookResult = installHook();
+    if (hookResult.installed) {
+      console.log(`  ${chalk10.green("\u2713")} Claude Code hook installed \u2014 docs update on session end`);
+      console.log(chalk10.dim("    Run ") + chalk10.hex("#83D1EB")("caliber hooks --remove") + chalk10.dim(" to disable"));
+    } else if (hookResult.alreadyInstalled) {
+      console.log(chalk10.dim("  Claude Code hook already installed"));
+    }
+    const learnResult = installLearningHooks();
+    if (learnResult.installed) {
+      console.log(`  ${chalk10.green("\u2713")} Learning hooks installed \u2014 session insights captured automatically`);
+      console.log(chalk10.dim("    Run ") + chalk10.hex("#83D1EB")("caliber learn remove") + chalk10.dim(" to disable"));
+    } else if (learnResult.alreadyInstalled) {
+      console.log(chalk10.dim("  Learning hooks already installed"));
     }
-  } else {
-    trackInitSkillsSearch(false, 0);
-    console.log(chalk9.dim("  Skipped. Run ") + chalk9.hex("#83D1EB")("caliber skills") + chalk9.dim(" later to browse.\n"));
   }
-  console.log(chalk9.bold.green("  Setup complete!"));
-  console.log(chalk9.dim("  Your AI agents now understand your project's architecture, build commands,"));
-  console.log(chalk9.dim("  testing patterns, and conventions. All changes are backed up automatically.\n"));
-  console.log(chalk9.bold("  Next steps:\n"));
+  if (hookChoice === "precommit" || hookChoice === "both") {
+    const precommitResult = installPreCommitHook();
+    if (precommitResult.installed) {
+      console.log(`  ${chalk10.green("\u2713")} Pre-commit hook installed \u2014 docs refresh before each commit`);
+      console.log(chalk10.dim("    Run ") + chalk10.hex("#83D1EB")("caliber hooks --remove") + chalk10.dim(" to disable"));
+    } else if (precommitResult.alreadyInstalled) {
+      console.log(chalk10.dim("  Pre-commit hook already installed"));
+    } else {
+      console.log(chalk10.yellow("  Could not install pre-commit hook (not a git repository?)"));
+    }
+  }
+  if (hookChoice === "skip") {
+    console.log(chalk10.dim("  Skipped auto-sync hooks. Run ") + chalk10.hex("#83D1EB")("caliber hooks --install") + chalk10.dim(" later to enable."));
+  }
+  console.log(chalk10.bold.green("\n  Setup complete!"));
+  console.log(chalk10.dim("  Your AI agents now understand your project's architecture, build commands,"));
+  console.log(chalk10.dim("  testing patterns, and conventions. All changes are backed up automatically.\n"));
+  console.log(chalk10.bold("  Next steps:\n"));
   console.log(`    ${title("caliber score")}        See your full config breakdown`);
   console.log(`    ${title("caliber refresh")}      Update docs after code changes`);
   console.log(`    ${title("caliber hooks")}        Toggle auto-refresh hooks`);
@@ -6829,7 +7064,7 @@ ${agentRefs.join(" ")}
     report.markStep("Finished");
     const reportPath = path19.join(process.cwd(), ".caliber", "debug-report.md");
     report.write(reportPath);
-    console.log(chalk9.dim(`  Debug report written to ${path19.relative(process.cwd(), reportPath)}
+    console.log(chalk10.dim(`  Debug report written to ${path19.relative(process.cwd(), reportPath)}
 `));
   }
 }
@@ -6844,9 +7079,9 @@ async function refineLoop(currentSetup, _targetAgent, sessionHistory) {
     }
     const isValid = await classifyRefineIntent(message);
     if (!isValid) {
-      console.log(chalk9.dim("  This doesn't look like a config change request."));
-      console.log(chalk9.dim("  Describe what to add, remove, or modify in your configs."));
-      console.log(chalk9.dim('  Type "done" to accept the current setup.\n'));
+      console.log(chalk10.dim("  This doesn't look like a config change request."));
+      console.log(chalk10.dim("  Describe what to add, remove, or modify in your configs."));
+      console.log(chalk10.dim('  Type "done" to accept the current setup.\n'));
       continue;
     }
     const refineSpinner = ora2("Refining setup...").start();
@@ -6867,10 +7102,10 @@ async function refineLoop(currentSetup, _targetAgent, sessionHistory) {
       });
       refineSpinner.succeed("Setup updated");
       printSetupSummary(refined);
-      console.log(chalk9.dim('Type "done" to accept, or describe more changes.'));
+      console.log(chalk10.dim('Type "done" to accept, or describe more changes.'));
     } else {
       refineSpinner.fail("Refinement failed \u2014 could not parse AI response.");
-      console.log(chalk9.dim('Try rephrasing your request, or type "done" to keep the current setup.'));
+      console.log(chalk10.dim('Try rephrasing your request, or type "done" to keep the current setup.'));
     }
   }
 }
@@ -6898,6 +7133,7 @@ Return {"valid": true} or {"valid": false}. Nothing else.`,
   }
 }
 async function evaluateDismissals(failingChecks, fingerprint) {
+  if (failingChecks.length === 0) return [];
   const fastModel = getFastModel();
   const checkList = failingChecks.map((c) => ({
     id: c.id,
@@ -6965,7 +7201,7 @@ async function promptHookType(targetAgent) {
   }
   choices.push({ name: "Skip for now", value: "skip" });
   return select5({
-    message: "How would you like to auto-refresh your setup?",
+    message: "Keep your AI docs & skills in sync as your code evolves?",
     choices
   });
 }
@@ -6985,26 +7221,26 @@ function printSetupSummary(setup) {
   const fileDescriptions = setup.fileDescriptions;
   const deletions = setup.deletions;
   console.log("");
-  console.log(chalk9.bold("  Proposed changes:\n"));
+  console.log(chalk10.bold("  Proposed changes:\n"));
   const getDescription = (filePath) => {
     return fileDescriptions?.[filePath];
   };
   if (claude) {
     if (claude.claudeMd) {
-      const icon = fs24.existsSync("CLAUDE.md") ? chalk9.yellow("~") : chalk9.green("+");
+      const icon = fs24.existsSync("CLAUDE.md") ? chalk10.yellow("~") : chalk10.green("+");
       const desc = getDescription("CLAUDE.md");
-      console.log(`  ${icon} ${chalk9.bold("CLAUDE.md")}`);
-      if (desc) console.log(chalk9.dim(`    ${desc}`));
+      console.log(`  ${icon} ${chalk10.bold("CLAUDE.md")}`);
+      if (desc) console.log(chalk10.dim(`    ${desc}`));
       console.log("");
     }
     const skills = claude.skills;
     if (Array.isArray(skills) && skills.length > 0) {
       for (const skill of skills) {
         const skillPath = `.claude/skills/${skill.name}/SKILL.md`;
-        const icon = fs24.existsSync(skillPath) ? chalk9.yellow("~") : chalk9.green("+");
+        const icon = fs24.existsSync(skillPath) ? chalk10.yellow("~") : chalk10.green("+");
         const desc = getDescription(skillPath);
-        console.log(`  ${icon} ${chalk9.bold(skillPath)}`);
-        console.log(chalk9.dim(`    ${desc || skill.description || skill.name}`));
+        console.log(`  ${icon} ${chalk10.bold(skillPath)}`);
+        console.log(chalk10.dim(`    ${desc || skill.description || skill.name}`));
         console.log("");
       }
     }
@@ -7012,40 +7248,40 @@ function printSetupSummary(setup) {
   const codex = setup.codex;
   if (codex) {
     if (codex.agentsMd) {
-      const icon = fs24.existsSync("AGENTS.md") ? chalk9.yellow("~") : chalk9.green("+");
+      const icon = fs24.existsSync("AGENTS.md") ? chalk10.yellow("~") : chalk10.green("+");
       const desc = getDescription("AGENTS.md");
-      console.log(`  ${icon} ${chalk9.bold("AGENTS.md")}`);
-      if (desc) console.log(chalk9.dim(`    ${desc}`));
+      console.log(`  ${icon} ${chalk10.bold("AGENTS.md")}`);
+      if (desc) console.log(chalk10.dim(`    ${desc}`));
       console.log("");
     }
     const codexSkills = codex.skills;
     if (Array.isArray(codexSkills) && codexSkills.length > 0) {
       for (const skill of codexSkills) {
         const skillPath = `.agents/skills/${skill.name}/SKILL.md`;
-        const icon = fs24.existsSync(skillPath) ? chalk9.yellow("~") : chalk9.green("+");
+        const icon = fs24.existsSync(skillPath) ? chalk10.yellow("~") : chalk10.green("+");
         const desc = getDescription(skillPath);
-        console.log(`  ${icon} ${chalk9.bold(skillPath)}`);
-        console.log(chalk9.dim(`    ${desc || skill.description || skill.name}`));
+        console.log(`  ${icon} ${chalk10.bold(skillPath)}`);
+        console.log(chalk10.dim(`    ${desc || skill.description || skill.name}`));
         console.log("");
       }
     }
   }
   if (cursor) {
     if (cursor.cursorrules) {
-      const icon = fs24.existsSync(".cursorrules") ? chalk9.yellow("~") : chalk9.green("+");
+      const icon = fs24.existsSync(".cursorrules") ? chalk10.yellow("~") : chalk10.green("+");
       const desc = getDescription(".cursorrules");
-      console.log(`  ${icon} ${chalk9.bold(".cursorrules")}`);
-      if (desc) console.log(chalk9.dim(`    ${desc}`));
+      console.log(`  ${icon} ${chalk10.bold(".cursorrules")}`);
+      if (desc) console.log(chalk10.dim(`    ${desc}`));
       console.log("");
     }
     const cursorSkills = cursor.skills;
     if (Array.isArray(cursorSkills) && cursorSkills.length > 0) {
       for (const skill of cursorSkills) {
         const skillPath = `.cursor/skills/${skill.name}/SKILL.md`;
-        const icon = fs24.existsSync(skillPath) ? chalk9.yellow("~") : chalk9.green("+");
+        const icon = fs24.existsSync(skillPath) ? chalk10.yellow("~") : chalk10.green("+");
         const desc = getDescription(skillPath);
-        console.log(`  ${icon} ${chalk9.bold(skillPath)}`);
-        console.log(chalk9.dim(`    ${desc || skill.description || skill.name}`));
+        console.log(`  ${icon} ${chalk10.bold(skillPath)}`);
+        console.log(chalk10.dim(`    ${desc || skill.description || skill.name}`));
         console.log("");
       }
     }
@@ -7053,14 +7289,14 @@ function printSetupSummary(setup) {
     if (Array.isArray(rules) && rules.length > 0) {
       for (const rule of rules) {
         const rulePath = `.cursor/rules/${rule.filename}`;
-        const icon = fs24.existsSync(rulePath) ? chalk9.yellow("~") : chalk9.green("+");
+        const icon = fs24.existsSync(rulePath) ? chalk10.yellow("~") : chalk10.green("+");
         const desc = getDescription(rulePath);
-        console.log(`  ${icon} ${chalk9.bold(rulePath)}`);
+        console.log(`  ${icon} ${chalk10.bold(rulePath)}`);
         if (desc) {
-          console.log(chalk9.dim(`    ${desc}`));
+          console.log(chalk10.dim(`    ${desc}`));
         } else {
           const firstLine = rule.content.split("\n").filter((l) => l.trim() && !l.trim().startsWith("#"))[0];
-          if (firstLine) console.log(chalk9.dim(`    ${firstLine.trim().slice(0, 80)}`));
+          if (firstLine) console.log(chalk10.dim(`    ${firstLine.trim().slice(0, 80)}`));
         }
         console.log("");
       }
@@ -7068,12 +7304,12 @@ function printSetupSummary(setup) {
   }
   if (Array.isArray(deletions) && deletions.length > 0) {
     for (const del of deletions) {
-      console.log(`  ${chalk9.red("-")} ${chalk9.bold(del.filePath)}`);
-      console.log(chalk9.dim(`    ${del.reason}`));
+      console.log(`  ${chalk10.red("-")} ${chalk10.bold(del.filePath)}`);
+      console.log(chalk10.dim(`    ${del.reason}`));
       console.log("");
     }
   }
-  console.log(`  ${chalk9.green("+")} ${chalk9.dim("new")}  ${chalk9.yellow("~")} ${chalk9.dim("modified")}  ${chalk9.red("-")} ${chalk9.dim("removed")}`);
+  console.log(`  ${chalk10.green("+")} ${chalk10.dim("new")}  ${chalk10.yellow("~")} ${chalk10.dim("modified")}  ${chalk10.red("-")} ${chalk10.dim("removed")}`);
   console.log("");
 }
 function derivePermissions(fingerprint) {
@@ -7133,20 +7369,20 @@ function ensurePermissions(fingerprint) {
 function displayTokenUsage() {
   const summary = getUsageSummary();
   if (summary.length === 0) {
-    console.log(chalk9.dim("  Token tracking not available for this provider.\n"));
+    console.log(chalk10.dim("  Token tracking not available for this provider.\n"));
     return;
   }
-  console.log(chalk9.bold("  Token usage:\n"));
+  console.log(chalk10.bold("  Token usage:\n"));
   let totalIn = 0;
   let totalOut = 0;
   for (const m of summary) {
     totalIn += m.inputTokens;
     totalOut += m.outputTokens;
-    const cacheInfo = m.cacheReadTokens > 0 || m.cacheWriteTokens > 0 ? chalk9.dim(` (cache: ${m.cacheReadTokens.toLocaleString()} read, ${m.cacheWriteTokens.toLocaleString()} write)`) : "";
-    console.log(`    ${chalk9.dim(m.model)}: ${m.inputTokens.toLocaleString()} in / ${m.outputTokens.toLocaleString()} out  (${m.calls} call${m.calls === 1 ? "" : "s"})${cacheInfo}`);
+    const cacheInfo = m.cacheReadTokens > 0 || m.cacheWriteTokens > 0 ? chalk10.dim(` (cache: ${m.cacheReadTokens.toLocaleString()} read, ${m.cacheWriteTokens.toLocaleString()} write)`) : "";
+    console.log(`    ${chalk10.dim(m.model)}: ${m.inputTokens.toLocaleString()} in / ${m.outputTokens.toLocaleString()} out  (${m.calls} call${m.calls === 1 ? "" : "s"})${cacheInfo}`);
   }
   if (summary.length > 1) {
-    console.log(`    ${chalk9.dim("Total")}: ${totalIn.toLocaleString()} in / ${totalOut.toLocaleString()} out`);
+    console.log(`    ${chalk10.dim("Total")}: ${totalIn.toLocaleString()} in / ${totalOut.toLocaleString()} out`);
   }
   console.log("");
 }
@@ -7167,14 +7403,14 @@ function writeErrorLog(config, rawOutput, error, stopReason) {
     lines.push("## Raw LLM Output", "```", rawOutput || "(empty)", "```");
     fs24.mkdirSync(path19.join(process.cwd(), ".caliber"), { recursive: true });
     fs24.writeFileSync(logPath, lines.join("\n"));
-    console.log(chalk9.dim(`
+    console.log(chalk10.dim(`
   Error log written to .caliber/error-log.md`));
   } catch {
   }
 }
 
 // src/commands/undo.ts
-import chalk10 from "chalk";
+import chalk11 from "chalk";
 import ora3 from "ora";
 function undoCommand() {
   const spinner = ora3("Reverting setup...").start();
@@ -7187,26 +7423,26 @@ function undoCommand() {
     trackUndoExecuted();
     spinner.succeed("Setup reverted successfully.\n");
     if (restored.length > 0) {
-      console.log(chalk10.cyan("  Restored from backup:"));
+      console.log(chalk11.cyan("  Restored from backup:"));
       for (const file of restored) {
-        console.log(`    ${chalk10.green("\u21A9")} ${file}`);
+        console.log(`    ${chalk11.green("\u21A9")} ${file}`);
       }
     }
     if (removed.length > 0) {
-      console.log(chalk10.cyan("  Removed:"));
+      console.log(chalk11.cyan("  Removed:"));
       for (const file of removed) {
-        console.log(`    ${chalk10.red("\u2717")} ${file}`);
+        console.log(`    ${chalk11.red("\u2717")} ${file}`);
       }
     }
     console.log("");
   } catch (err) {
-    spinner.fail(chalk10.red(err instanceof Error ? err.message : "Undo failed"));
+    spinner.fail(chalk11.red(err instanceof Error ? err.message : "Undo failed"));
     throw new Error("__exit__");
   }
 }
 
 // src/commands/status.ts
-import chalk11 from "chalk";
+import chalk12 from "chalk";
 import fs25 from "fs";
 init_config();
 async function statusCommand(options) {
@@ -7221,40 +7457,40 @@ async function statusCommand(options) {
     }, null, 2));
     return;
   }
-  console.log(chalk11.bold("\nCaliber Status\n"));
+  console.log(chalk12.bold("\nCaliber Status\n"));
   if (config) {
-    console.log(`  LLM: ${chalk11.green(config.provider)} (${config.model})`);
+    console.log(`  LLM: ${chalk12.green(config.provider)} (${config.model})`);
   } else {
-    console.log(`  LLM: ${chalk11.yellow("Not configured")} \u2014 run ${chalk11.hex("#83D1EB")("caliber config")}`);
+    console.log(`  LLM: ${chalk12.yellow("Not configured")} \u2014 run ${chalk12.hex("#83D1EB")("caliber config")}`);
   }
   if (!manifest) {
-    console.log(`  Setup: ${chalk11.dim("No setup applied")}`);
-    console.log(chalk11.dim("\n  Run ") + chalk11.hex("#83D1EB")("caliber init") + chalk11.dim(" to get started.\n"));
+    console.log(`  Setup: ${chalk12.dim("No setup applied")}`);
+    console.log(chalk12.dim("\n  Run ") + chalk12.hex("#83D1EB")("caliber init") + chalk12.dim(" to get started.\n"));
     return;
   }
-  console.log(`  Files managed: ${chalk11.cyan(manifest.entries.length.toString())}`);
+  console.log(`  Files managed: ${chalk12.cyan(manifest.entries.length.toString())}`);
   for (const entry of manifest.entries) {
     const exists = fs25.existsSync(entry.path);
-    const icon = exists ? chalk11.green("\u2713") : chalk11.red("\u2717");
+    const icon = exists ? chalk12.green("\u2713") : chalk12.red("\u2717");
     console.log(`    ${icon} ${entry.path} (${entry.action})`);
   }
   console.log("");
 }
 
 // src/commands/regenerate.ts
-import chalk12 from "chalk";
+import chalk13 from "chalk";
 import ora4 from "ora";
 import select6 from "@inquirer/select";
 init_config();
 async function regenerateCommand(options) {
   const config = loadConfig();
   if (!config) {
-    console.log(chalk12.red("No LLM provider configured. Run ") + chalk12.hex("#83D1EB")("caliber config") + chalk12.red(" first."));
+    console.log(chalk13.red("No LLM provider configured. Run ") + chalk13.hex("#83D1EB")("caliber config") + chalk13.red(" first."));
     throw new Error("__exit__");
   }
   const manifest = readManifest();
   if (!manifest) {
-    console.log(chalk12.yellow("No existing setup found. Run ") + chalk12.hex("#83D1EB")("caliber init") + chalk12.yellow(" first."));
+    console.log(chalk13.yellow("No existing setup found. Run ") + chalk13.hex("#83D1EB")("caliber init") + chalk13.yellow(" first."));
     throw new Error("__exit__");
   }
   const targetAgent = readState()?.targetAgent ?? ["claude", "cursor"];
@@ -7265,7 +7501,7 @@ async function regenerateCommand(options) {
   const baselineScore = computeLocalScore(process.cwd(), targetAgent);
   displayScoreSummary(baselineScore);
   if (baselineScore.score === 100) {
-    console.log(chalk12.green("  Your setup is already at 100/100 \u2014 nothing to regenerate.\n"));
+    console.log(chalk13.green("  Your setup is already at 100/100 \u2014 nothing to regenerate.\n"));
     return;
   }
   const genSpinner = ora4("Regenerating setup...").start();
@@ -7306,18 +7542,18 @@ async function regenerateCommand(options) {
   const setupFiles = collectSetupFiles(generatedSetup, targetAgent);
   const staged = stageFiles(setupFiles, process.cwd());
   const totalChanges = staged.newFiles + staged.modifiedFiles;
-  console.log(chalk12.dim(`
-  ${chalk12.green(`${staged.newFiles} new`)} / ${chalk12.yellow(`${staged.modifiedFiles} modified`)} file${totalChanges !== 1 ? "s" : ""}
+  console.log(chalk13.dim(`
+  ${chalk13.green(`${staged.newFiles} new`)} / ${chalk13.yellow(`${staged.modifiedFiles} modified`)} file${totalChanges !== 1 ? "s" : ""}
 `));
   if (totalChanges === 0) {
-    console.log(chalk12.dim("  No changes needed \u2014 your configs are already up to date.\n"));
+    console.log(chalk13.dim("  No changes needed \u2014 your configs are already up to date.\n"));
     cleanupStaging();
     return;
   }
   if (options.dryRun) {
-    console.log(chalk12.yellow("[Dry run] Would write:"));
+    console.log(chalk13.yellow("[Dry run] Would write:"));
     for (const f of staged.stagedFiles) {
-      console.log(`  ${f.isNew ? chalk12.green("+") : chalk12.yellow("~")} ${f.relativePath}`);
+      console.log(`  ${f.isNew ? chalk13.green("+") : chalk13.yellow("~")} ${f.relativePath}`);
     }
     cleanupStaging();
     return;
@@ -7336,7 +7572,7 @@ async function regenerateCommand(options) {
   });
   cleanupStaging();
   if (action === "decline") {
-    console.log(chalk12.dim("Regeneration cancelled. No files were modified."));
+    console.log(chalk13.dim("Regeneration cancelled. No files were modified."));
     return;
   }
   const writeSpinner = ora4("Writing config files...").start();
@@ -7344,20 +7580,20 @@ async function regenerateCommand(options) {
     const result = writeSetup(generatedSetup);
     writeSpinner.succeed("Config files written");
     for (const file of result.written) {
-      console.log(`  ${chalk12.green("\u2713")} ${file}`);
+      console.log(`  ${chalk13.green("\u2713")} ${file}`);
     }
     if (result.deleted.length > 0) {
       for (const file of result.deleted) {
-        console.log(`  ${chalk12.red("\u2717")} ${file}`);
+        console.log(`  ${chalk13.red("\u2717")} ${file}`);
       }
     }
     if (result.backupDir) {
-      console.log(chalk12.dim(`
+      console.log(chalk13.dim(`
   Backups saved to ${result.backupDir}`));
     }
   } catch (err) {
     writeSpinner.fail("Failed to write files");
-    console.error(chalk12.red(err instanceof Error ? err.message : "Unknown error"));
+    console.error(chalk13.red(err instanceof Error ? err.message : "Unknown error"));
     throw new Error("__exit__");
   }
   const sha = getCurrentHeadSha();
@@ -7369,25 +7605,25 @@ async function regenerateCommand(options) {
   const afterScore = computeLocalScore(process.cwd(), targetAgent);
   if (afterScore.score < baselineScore.score) {
     console.log("");
-    console.log(chalk12.yellow(`  Score would drop from ${baselineScore.score} to ${afterScore.score} \u2014 reverting changes.`));
+    console.log(chalk13.yellow(`  Score would drop from ${baselineScore.score} to ${afterScore.score} \u2014 reverting changes.`));
     try {
       const { restored, removed } = undoSetup();
       if (restored.length > 0 || removed.length > 0) {
-        console.log(chalk12.dim(`  Reverted ${restored.length + removed.length} file${restored.length + removed.length === 1 ? "" : "s"} from backup.`));
+        console.log(chalk13.dim(`  Reverted ${restored.length + removed.length} file${restored.length + removed.length === 1 ? "" : "s"} from backup.`));
       }
     } catch {
     }
-    console.log(chalk12.dim("  Run ") + chalk12.hex("#83D1EB")("caliber init --force") + chalk12.dim(" to override.\n"));
+    console.log(chalk13.dim("  Run ") + chalk13.hex("#83D1EB")("caliber init --force") + chalk13.dim(" to override.\n"));
     return;
   }
   displayScoreDelta(baselineScore, afterScore);
   trackRegenerateCompleted(action, Date.now());
-  console.log(chalk12.bold.green("  Regeneration complete!"));
-  console.log(chalk12.dim("  Run ") + chalk12.hex("#83D1EB")("caliber undo") + chalk12.dim(" to revert changes.\n"));
+  console.log(chalk13.bold.green("  Regeneration complete!"));
+  console.log(chalk13.dim("  Run ") + chalk13.hex("#83D1EB")("caliber undo") + chalk13.dim(" to revert changes.\n"));
 }
 
 // src/commands/score.ts
-import chalk13 from "chalk";
+import chalk14 from "chalk";
 async function scoreCommand(options) {
   const dir = process.cwd();
   const target = options.agent ?? readState()?.targetAgent;
@@ -7402,14 +7638,14 @@ async function scoreCommand(options) {
     return;
   }
   displayScore(result);
-  const separator = chalk13.gray("  " + "\u2500".repeat(53));
+  const separator = chalk14.gray("  " + "\u2500".repeat(53));
   console.log(separator);
   if (result.score < 40) {
-    console.log(chalk13.gray("  Run ") + chalk13.hex("#83D1EB")("caliber init") + chalk13.gray(" to generate a complete, optimized setup."));
+    console.log(chalk14.gray("  Run ") + chalk14.hex("#83D1EB")("caliber init") + chalk14.gray(" to generate a complete, optimized setup."));
   } else if (result.score < 70) {
-    console.log(chalk13.gray("  Run ") + chalk13.hex("#83D1EB")("caliber init") + chalk13.gray(" to improve your setup."));
+    console.log(chalk14.gray("  Run ") + chalk14.hex("#83D1EB")("caliber init") + chalk14.gray(" to improve your setup."));
   } else {
-    console.log(chalk13.green("  Looking good!") + chalk13.gray(" Run ") + chalk13.hex("#83D1EB")("caliber regenerate") + chalk13.gray(" to rebuild from scratch."));
+    console.log(chalk14.green("  Looking good!") + chalk14.gray(" Run ") + chalk14.hex("#83D1EB")("caliber regenerate") + chalk14.gray(" to rebuild from scratch."));
   }
   console.log("");
 }
@@ -7417,7 +7653,7 @@ async function scoreCommand(options) {
 // src/commands/refresh.ts
 import fs29 from "fs";
 import path23 from "path";
-import chalk14 from "chalk";
+import chalk15 from "chalk";
 import ora5 from "ora";
 
 // src/lib/git-diff.ts
@@ -7649,8 +7885,12 @@ function parseBullets(content) {
   if (current) bullets.push(current);
   return bullets;
 }
+var TYPE_PREFIX_RE = /^\*\*\[[^\]]+\]\*\*\s*/;
 function normalizeBullet(bullet) {
-  return bullet.replace(/^- /, "").replace(/`[^`]*`/g, "").replace(/\s+/g, " ").toLowerCase().trim();
+  return bullet.replace(/^- /, "").replace(TYPE_PREFIX_RE, "").replace(/`[^`]*`/g, "").replace(/\s+/g, " ").toLowerCase().trim();
+}
+function hasTypePrefix(bullet) {
+  return TYPE_PREFIX_RE.test(bullet.replace(/^- /, ""));
 }
 function deduplicateLearnedItems(existing, incoming) {
   const existingBullets = existing ? parseBullets(existing) : [];
@@ -7660,14 +7900,18 @@ function deduplicateLearnedItems(existing, incoming) {
   for (const bullet of incomingBullets) {
     const norm = normalizeBullet(bullet);
     if (!norm) continue;
-    const isDup = merged.some((e) => {
+    const dupIdx = merged.findIndex((e) => {
       const eNorm = normalizeBullet(e);
       const shorter = Math.min(norm.length, eNorm.length);
       const longer = Math.max(norm.length, eNorm.length);
       if (!(eNorm.includes(norm) || norm.includes(eNorm))) return false;
       return shorter / longer > 0.7;
     });
-    if (!isDup) {
+    if (dupIdx !== -1) {
+      if (hasTypePrefix(bullet) && !hasTypePrefix(merged[dupIdx])) {
+        merged[dupIdx] = bullet;
+      }
+    } else {
       merged.push(bullet);
       newItems.push(bullet);
     }
@@ -7752,7 +7996,7 @@ function discoverGitRepos(parentDir) {
 }
 async function refreshSingleRepo(repoDir, options) {
   const quiet = !!options.quiet;
-  const prefix = options.label ? `${chalk14.bold(options.label)} ` : "";
+  const prefix = options.label ? `${chalk15.bold(options.label)} ` : "";
   const state = readState();
   const lastSha = state?.lastRefreshSha ?? null;
   const diff = collectDiff(lastSha);
@@ -7761,7 +8005,7 @@ async function refreshSingleRepo(repoDir, options) {
     if (currentSha) {
       writeState({ lastRefreshSha: currentSha, lastRefreshTimestamp: (/* @__PURE__ */ new Date()).toISOString() });
     }
-    log2(quiet, chalk14.dim(`${prefix}No changes since last refresh.`));
+    log2(quiet, chalk15.dim(`${prefix}No changes since last refresh.`));
     return;
   }
   const spinner = quiet ? null : ora5(`${prefix}Analyzing changes...`).start();
@@ -7795,10 +8039,10 @@ async function refreshSingleRepo(repoDir, options) {
   if (options.dryRun) {
     spinner?.info(`${prefix}Dry run \u2014 would update:`);
     for (const doc of response.docsUpdated) {
-      console.log(`  ${chalk14.yellow("~")} ${doc}`);
+      console.log(`  ${chalk15.yellow("~")} ${doc}`);
     }
     if (response.changesSummary) {
-      console.log(chalk14.dim(`
+      console.log(chalk15.dim(`
   ${response.changesSummary}`));
     }
     return;
@@ -7807,10 +8051,10 @@ async function refreshSingleRepo(repoDir, options) {
   trackRefreshCompleted(written.length, Date.now());
   spinner?.succeed(`${prefix}Updated ${written.length} doc${written.length === 1 ? "" : "s"}`);
   for (const file of written) {
-    log2(quiet, `  ${chalk14.green("\u2713")} ${file}`);
+    log2(quiet, `  ${chalk15.green("\u2713")} ${file}`);
   }
   if (response.changesSummary) {
-    log2(quiet, chalk14.dim(`
+    log2(quiet, chalk15.dim(`
   ${response.changesSummary}`));
   }
   if (currentSha) {
@@ -7827,7 +8071,7 @@ async function refreshCommand(options) {
     const config = loadConfig();
     if (!config) {
       if (quiet) return;
-      console.log(chalk14.red("No LLM provider configured. Run ") + chalk14.hex("#83D1EB")("caliber config") + chalk14.red(" (e.g. choose Cursor) or set an API key."));
+      console.log(chalk15.red("No LLM provider configured. Run ") + chalk15.hex("#83D1EB")("caliber config") + chalk15.red(" (e.g. choose Cursor) or set an API key."));
       throw new Error("__exit__");
     }
     await validateModel({ fast: true });
@@ -7838,10 +8082,10 @@ async function refreshCommand(options) {
     const repos = discoverGitRepos(process.cwd());
     if (repos.length === 0) {
       if (quiet) return;
-      console.log(chalk14.red("Not inside a git repository and no git repos found in child directories."));
+      console.log(chalk15.red("Not inside a git repository and no git repos found in child directories."));
       throw new Error("__exit__");
     }
-    log2(quiet, chalk14.dim(`Found ${repos.length} git repo${repos.length === 1 ? "" : "s"}
+    log2(quiet, chalk15.dim(`Found ${repos.length} git repo${repos.length === 1 ? "" : "s"}
 `));
     const originalDir = process.cwd();
     for (const repo of repos) {
@@ -7851,7 +8095,7 @@ async function refreshCommand(options) {
         await refreshSingleRepo(repo, { ...options, label: repoName });
       } catch (err) {
         if (err instanceof Error && err.message === "__exit__") continue;
-        log2(quiet, chalk14.yellow(`${repoName}: refresh failed \u2014 ${err instanceof Error ? err.message : "unknown error"}`));
+        log2(quiet, chalk15.yellow(`${repoName}: refresh failed \u2014 ${err instanceof Error ? err.message : "unknown error"}`));
       }
     }
     process.chdir(originalDir);
@@ -7859,13 +8103,13 @@ async function refreshCommand(options) {
     if (err instanceof Error && err.message === "__exit__") throw err;
     if (quiet) return;
     const msg = err instanceof Error ? err.message : "Unknown error";
-    console.log(chalk14.red(`Refresh failed: ${msg}`));
+    console.log(chalk15.red(`Refresh failed: ${msg}`));
     throw new Error("__exit__");
   }
 }
 
 // src/commands/hooks.ts
-import chalk15 from "chalk";
+import chalk16 from "chalk";
 var HOOKS = [
   {
     id: "session-end",
@@ -7885,13 +8129,13 @@ var HOOKS = [
   }
 ];
 function printStatus() {
-  console.log(chalk15.bold("\n  Hooks\n"));
+  console.log(chalk16.bold("\n  Hooks\n"));
   for (const hook of HOOKS) {
     const installed = hook.isInstalled();
-    const icon = installed ? chalk15.green("\u2713") : chalk15.dim("\u2717");
-    const state = installed ? chalk15.green("enabled") : chalk15.dim("disabled");
+    const icon = installed ? chalk16.green("\u2713") : chalk16.dim("\u2717");
+    const state = installed ? chalk16.green("enabled") : chalk16.dim("disabled");
     console.log(`  ${icon} ${hook.label.padEnd(26)} ${state}`);
-    console.log(chalk15.dim(`    ${hook.description}`));
+    console.log(chalk16.dim(`    ${hook.description}`));
   }
   console.log("");
 }
@@ -7900,9 +8144,9 @@ async function hooksCommand(options) {
     for (const hook of HOOKS) {
       const result = hook.install();
       if (result.alreadyInstalled) {
-        console.log(chalk15.dim(`  ${hook.label} already enabled.`));
+        console.log(chalk16.dim(`  ${hook.label} already enabled.`));
       } else {
-        console.log(chalk15.green("  \u2713") + ` ${hook.label} enabled`);
+        console.log(chalk16.green("  \u2713") + ` ${hook.label} enabled`);
       }
     }
     return;
@@ -7911,9 +8155,9 @@ async function hooksCommand(options) {
     for (const hook of HOOKS) {
       const result = hook.remove();
       if (result.notFound) {
-        console.log(chalk15.dim(`  ${hook.label} already disabled.`));
+        console.log(chalk16.dim(`  ${hook.label} already disabled.`));
       } else {
-        console.log(chalk15.green("  \u2713") + ` ${hook.label} removed`);
+        console.log(chalk16.green("  \u2713") + ` ${hook.label} removed`);
       }
     }
     return;
@@ -7928,18 +8172,18 @@ async function hooksCommand(options) {
   const states = HOOKS.map((h) => h.isInstalled());
   function render() {
     const lines = [];
-    lines.push(chalk15.bold("  Hooks"));
+    lines.push(chalk16.bold("  Hooks"));
     lines.push("");
     for (let i = 0; i < HOOKS.length; i++) {
       const hook = HOOKS[i];
       const enabled = states[i];
-      const toggle = enabled ? chalk15.green("[on] ") : chalk15.dim("[off]");
-      const ptr = i === cursor ? chalk15.cyan(">") : " ";
+      const toggle = enabled ? chalk16.green("[on] ") : chalk16.dim("[off]");
+      const ptr = i === cursor ? chalk16.cyan(">") : " ";
       lines.push(`  ${ptr} ${toggle} ${hook.label}`);
-      lines.push(chalk15.dim(`        ${hook.description}`));
+      lines.push(chalk16.dim(`        ${hook.description}`));
     }
     lines.push("");
-    lines.push(chalk15.dim("  \u2191\u2193 navigate  \u23B5 toggle  a all on  n all off  \u23CE apply  q cancel"));
+    lines.push(chalk16.dim("  \u2191\u2193 navigate  \u23B5 toggle  a all on  n all off  \u23CE apply  q cancel"));
     return lines.join("\n");
   }
   function draw(initial) {
@@ -7970,16 +8214,16 @@ async function hooksCommand(options) {
         const wantEnabled = states[i];
         if (wantEnabled && !wasInstalled) {
           hook.install();
-          console.log(chalk15.green("  \u2713") + ` ${hook.label} enabled`);
+          console.log(chalk16.green("  \u2713") + ` ${hook.label} enabled`);
           changed++;
         } else if (!wantEnabled && wasInstalled) {
           hook.remove();
-          console.log(chalk15.green("  \u2713") + ` ${hook.label} disabled`);
+          console.log(chalk16.green("  \u2713") + ` ${hook.label} disabled`);
           changed++;
         }
       }
       if (changed === 0) {
-        console.log(chalk15.dim("  No changes."));
+        console.log(chalk16.dim("  No changes."));
       }
       console.log("");
     }
@@ -8015,7 +8259,7 @@ async function hooksCommand(options) {
         case "\x1B":
         case "":
           cleanup();
-          console.log(chalk15.dim("\n  Cancelled.\n"));
+          console.log(chalk16.dim("\n  Cancelled.\n"));
           resolve2();
           break;
       }
@@ -8026,51 +8270,51 @@ async function hooksCommand(options) {
 
 // src/commands/config.ts
 init_config();
-import chalk16 from "chalk";
+import chalk17 from "chalk";
 async function configCommand() {
   const existing = loadConfig();
   if (existing) {
     const displayModel = getDisplayModel(existing);
     const fastModel = getFastModel();
-    console.log(chalk16.bold("\nCurrent Configuration\n"));
-    console.log(`  Provider: ${chalk16.cyan(existing.provider)}`);
-    console.log(`  Model:    ${chalk16.cyan(displayModel)}`);
+    console.log(chalk17.bold("\nCurrent Configuration\n"));
+    console.log(`  Provider: ${chalk17.cyan(existing.provider)}`);
+    console.log(`  Model:    ${chalk17.cyan(displayModel)}`);
     if (fastModel) {
-      console.log(`  Scan:     ${chalk16.cyan(fastModel)}`);
+      console.log(`  Scan:     ${chalk17.cyan(fastModel)}`);
     }
     if (existing.apiKey) {
       const masked = existing.apiKey.slice(0, 8) + "..." + existing.apiKey.slice(-4);
-      console.log(`  API Key:  ${chalk16.dim(masked)}`);
+      console.log(`  API Key:  ${chalk17.dim(masked)}`);
     }
     if (existing.provider === "cursor") {
-      console.log(`  Seat:     ${chalk16.dim("Cursor (agent acp)")}`);
+      console.log(`  Seat:     ${chalk17.dim("Cursor (agent acp)")}`);
     }
     if (existing.provider === "claude-cli") {
-      console.log(`  Seat:     ${chalk16.dim("Claude Code (claude -p)")}`);
+      console.log(`  Seat:     ${chalk17.dim("Claude Code (claude -p)")}`);
     }
     if (existing.baseUrl) {
-      console.log(`  Base URL: ${chalk16.dim(existing.baseUrl)}`);
+      console.log(`  Base URL: ${chalk17.dim(existing.baseUrl)}`);
     }
     if (existing.vertexProjectId) {
-      console.log(`  Vertex Project: ${chalk16.dim(existing.vertexProjectId)}`);
-      console.log(`  Vertex Region:  ${chalk16.dim(existing.vertexRegion || "us-east5")}`);
+      console.log(`  Vertex Project: ${chalk17.dim(existing.vertexProjectId)}`);
+      console.log(`  Vertex Region:  ${chalk17.dim(existing.vertexRegion || "us-east5")}`);
     }
-    console.log(`  Source:   ${chalk16.dim(process.env.ANTHROPIC_API_KEY || process.env.OPENAI_API_KEY || process.env.VERTEX_PROJECT_ID || process.env.CALIBER_USE_CURSOR_SEAT || process.env.CALIBER_USE_CLAUDE_CLI ? "environment variables" : getConfigFilePath())}`);
+    console.log(`  Source:   ${chalk17.dim(process.env.ANTHROPIC_API_KEY || process.env.OPENAI_API_KEY || process.env.VERTEX_PROJECT_ID || process.env.CALIBER_USE_CURSOR_SEAT || process.env.CALIBER_USE_CLAUDE_CLI ? "environment variables" : getConfigFilePath())}`);
     console.log("");
   }
   await runInteractiveProviderSetup();
   const updated = loadConfig();
   if (updated) trackConfigProviderSet(updated.provider);
-  console.log(chalk16.green("\n\u2713 Configuration saved"));
-  console.log(chalk16.dim(`  ${getConfigFilePath()}
+  console.log(chalk17.green("\n\u2713 Configuration saved"));
+  console.log(chalk17.dim(`  ${getConfigFilePath()}
 `));
-  console.log(chalk16.dim("  You can also set environment variables instead:"));
-  console.log(chalk16.dim("  ANTHROPIC_API_KEY, OPENAI_API_KEY, VERTEX_PROJECT_ID, CALIBER_USE_CURSOR_SEAT=1, or CALIBER_USE_CLAUDE_CLI=1\n"));
+  console.log(chalk17.dim("  You can also set environment variables instead:"));
+  console.log(chalk17.dim("  ANTHROPIC_API_KEY, OPENAI_API_KEY, VERTEX_PROJECT_ID, CALIBER_USE_CURSOR_SEAT=1, or CALIBER_USE_CLAUDE_CLI=1\n"));
 }
 
 // src/commands/learn.ts
 import fs31 from "fs";
-import chalk17 from "chalk";
+import chalk18 from "chalk";
 
 // src/learner/stdin.ts
 var STDIN_TIMEOUT_MS = 5e3;
@@ -8137,6 +8381,17 @@ function appendEvent(event) {
     fs30.writeFileSync(filePath, kept.join("\n") + "\n");
   }
 }
+function appendPromptEvent(event) {
+  ensureLearningDir();
+  const filePath = sessionFilePath();
+  fs30.appendFileSync(filePath, JSON.stringify(event) + "\n");
+  const count = getEventCount();
+  if (count > LEARNING_MAX_EVENTS) {
+    const lines = fs30.readFileSync(filePath, "utf-8").split("\n").filter(Boolean);
+    const kept = lines.slice(lines.length - LEARNING_MAX_EVENTS);
+    fs30.writeFileSync(filePath, kept.join("\n") + "\n");
+  }
+}
 function readAllEvents() {
   const filePath = sessionFilePath();
   if (!fs30.existsSync(filePath)) return [];
@@ -8197,14 +8452,6 @@ function acquireFinalizeLock() {
     fs30.writeFileSync(lockPath, String(process.pid), { flag: "wx" });
     return true;
   } catch {
-    try {
-      const stat = fs30.statSync(lockPath);
-      if (Date.now() - stat.mtimeMs >= LOCK_STALE_MS) {
-        fs30.writeFileSync(lockPath, String(process.pid));
-        return true;
-      }
-    } catch {
-    }
     return false;
   }
 }
@@ -8216,17 +8463,64 @@ function releaseFinalizeLock() {
   }
 }
 
+// src/lib/sanitize.ts
+var KNOWN_PREFIX_PATTERNS = [
+  // Anthropic (before generic sk- pattern)
+  [/sk-ant-[A-Za-z0-9_-]{20,}/g, "[REDACTED]"],
+  // AWS access key IDs
+  [/AKIA[0-9A-Z]{16}/g, "[REDACTED]"],
+  // AWS secret keys in assignments
+  [/(?:aws)?_?secret_?(?:access)?_?key\s*[:=]\s*['"]?[A-Za-z0-9/+=]{40}['"]?/gi, "[REDACTED]"],
+  // GitHub tokens (PAT, OAuth, server, app install, fine-grained)
+  [/gh[pousr]_[A-Za-z0-9_]{36,}/g, "[REDACTED]"],
+  [/github_pat_[A-Za-z0-9_]{22,}/g, "[REDACTED]"],
+  // Stripe keys
+  [/[sr]k_(live|test)_[A-Za-z0-9]{20,}/g, "[REDACTED]"],
+  // Slack tokens
+  [/xox[bpsar]-[A-Za-z0-9-]{10,}/g, "[REDACTED]"],
+  // JWTs (3-segment base64url)
+  [/eyJ[A-Za-z0-9_-]{20,}\.eyJ[A-Za-z0-9_-]{20,}\.[A-Za-z0-9_-]{20,}/g, "[REDACTED]"],
+  // OpenAI keys (after sk-ant- to avoid false match)
+  [/sk-[A-Za-z0-9-]{20,}/g, "[REDACTED]"],
+  // Google API keys
+  [/AIza[A-Za-z0-9_-]{35}/g, "[REDACTED]"],
+  // Bearer tokens
+  [/[Bb]earer\s+[A-Za-z0-9_\-.]{20,}/g, "[REDACTED]"],
+  // PEM private keys
+  [/-----BEGIN[A-Z ]+KEY-----[\s\S]+?-----END[A-Z ]+KEY-----/g, "[REDACTED]"]
+];
+var SENSITIVE_ASSIGNMENT = /(?:api[_-]?key|secret[_-]?key|password|token|credential|auth[_-]?token|private[_-]?key)\s*[:=]\s*['"]?([^\s'"]{8,500})['"]?/gi;
+function sanitizeSecrets(text) {
+  let result = text;
+  for (const [pattern, replacement] of KNOWN_PREFIX_PATTERNS) {
+    result = result.replace(pattern, replacement);
+  }
+  result = result.replace(
+    SENSITIVE_ASSIGNMENT,
+    (match, value) => match.replace(value, "[REDACTED]")
+  );
+  return result;
+}
+
 // src/ai/learn.ts
 init_config();
 var MAX_PROMPT_TOKENS = 1e5;
 function formatEventsForPrompt(events) {
   return events.map((e, i) => {
-    const status = e.hook_event_name === "PostToolUseFailure" ? "FAILURE" : "SUCCESS";
-    const inputStr = JSON.stringify(e.tool_input, null, 2);
-    const responseStr = typeof e.tool_response === "object" && "_truncated" in e.tool_response ? String(e.tool_response._truncated) : JSON.stringify(e.tool_response, null, 2);
+    if (e.hook_event_name === "UserPromptSubmit") {
+      const pe = e;
+      return `--- Event ${i + 1} [USER_PROMPT] ---
+Time: ${pe.timestamp}
+User said:
+${pe.prompt_content}`;
+    }
+    const te = e;
+    const status = te.hook_event_name === "PostToolUseFailure" ? "FAILURE" : "SUCCESS";
+    const inputStr = JSON.stringify(te.tool_input, null, 2);
+    const responseStr = typeof te.tool_response === "object" && "_truncated" in te.tool_response ? String(te.tool_response._truncated) : JSON.stringify(te.tool_response, null, 2);
     return `--- Event ${i + 1} [${status}] ---
-Tool: ${e.tool_name}
-Time: ${e.timestamp}
+Tool: ${te.tool_name}
+Time: ${te.timestamp}
 Input:
 ${inputStr}
 Response:
@@ -8298,9 +8592,25 @@ async function learnObserveCommand(options) {
     const raw = await readStdin();
     if (!raw.trim()) return;
     const hookData = JSON.parse(raw);
+    const sessionId = hookData.session_id || hookData.conversation_id || "unknown";
+    if (options.prompt) {
+      const event2 = {
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        session_id: sessionId,
+        hook_event_name: "UserPromptSubmit",
+        prompt_content: sanitizeSecrets(String(hookData.prompt_content || hookData.content || hookData.prompt || "")),
+        cwd: hookData.cwd || process.cwd()
+      };
+      appendPromptEvent(event2);
+      const state2 = readState2();
+      state2.eventCount++;
+      if (!state2.sessionId) state2.sessionId = sessionId;
+      writeState2(state2);
+      return;
+    }
     const event = {
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-      session_id: hookData.session_id || hookData.conversation_id || "unknown",
+      session_id: sessionId,
       hook_event_name: options.failure ? "PostToolUseFailure" : "PostToolUse",
       tool_name: hookData.tool_name || "unknown",
       tool_input: hookData.tool_input || {},
@@ -8311,7 +8621,7 @@ async function learnObserveCommand(options) {
     appendEvent(event);
     const state = readState2();
     state.eventCount++;
-    if (!state.sessionId) state.sessionId = event.session_id;
+    if (!state.sessionId) state.sessionId = sessionId;
     writeState2(state);
   } catch {
   }
@@ -8320,26 +8630,26 @@ async function learnFinalizeCommand(options) {
   if (!options?.force) {
     const { isCaliberRunning: isCaliberRunning2 } = await Promise.resolve().then(() => (init_lock(), lock_exports));
     if (isCaliberRunning2()) {
-      console.log(chalk17.dim("caliber: skipping finalize \u2014 another caliber process is running"));
+      console.log(chalk18.dim("caliber: skipping finalize \u2014 another caliber process is running"));
       return;
     }
   }
   if (!acquireFinalizeLock()) {
-    console.log(chalk17.dim("caliber: skipping finalize \u2014 another finalize is in progress"));
+    console.log(chalk18.dim("caliber: skipping finalize \u2014 another finalize is in progress"));
     return;
   }
   let analyzed = false;
   try {
     const config = loadConfig();
     if (!config) {
-      console.log(chalk17.yellow("caliber: no LLM provider configured \u2014 run `caliber config` first"));
+      console.log(chalk18.yellow("caliber: no LLM provider configured \u2014 run `caliber config` first"));
       clearSession();
       resetState();
       return;
     }
     const events = readAllEvents();
     if (events.length < MIN_EVENTS_FOR_ANALYSIS) {
-      console.log(chalk17.dim(`caliber: ${events.length}/${MIN_EVENTS_FOR_ANALYSIS} events recorded \u2014 need more before analysis`));
+      console.log(chalk18.dim(`caliber: ${events.length}/${MIN_EVENTS_FOR_ANALYSIS} events recorded \u2014 need more before analysis`));
       return;
     }
     await validateModel({ fast: true });
@@ -8360,15 +8670,15 @@ async function learnFinalizeCommand(options) {
         skills: response.skills
       });
       if (result.newItemCount > 0) {
-        console.log(chalk17.dim(`caliber: learned ${result.newItemCount} new pattern${result.newItemCount === 1 ? "" : "s"}`));
+        console.log(chalk18.dim(`caliber: learned ${result.newItemCount} new pattern${result.newItemCount === 1 ? "" : "s"}`));
         for (const item of result.newItems) {
-          console.log(chalk17.dim(`  + ${item.replace(/^- /, "").slice(0, 80)}`));
+          console.log(chalk18.dim(`  + ${item.replace(/^- /, "").slice(0, 80)}`));
         }
       }
     }
   } catch (err) {
     if (options?.force) {
-      console.error(chalk17.red("caliber: finalize failed \u2014"), err instanceof Error ? err.message : err);
+      console.error(chalk18.red("caliber: finalize failed \u2014"), err instanceof Error ? err.message : err);
     }
   } finally {
     if (analyzed) {
@@ -8383,45 +8693,45 @@ async function learnInstallCommand() {
   if (fs31.existsSync(".claude")) {
     const r = installLearningHooks();
     if (r.installed) {
-      console.log(chalk17.green("\u2713") + " Claude Code learning hooks installed");
+      console.log(chalk18.green("\u2713") + " Claude Code learning hooks installed");
       anyInstalled = true;
     } else if (r.alreadyInstalled) {
-      console.log(chalk17.dim("  Claude Code hooks already installed"));
+      console.log(chalk18.dim("  Claude Code hooks already installed"));
     }
   }
   if (fs31.existsSync(".cursor")) {
     const r = installCursorLearningHooks();
     if (r.installed) {
-      console.log(chalk17.green("\u2713") + " Cursor learning hooks installed");
+      console.log(chalk18.green("\u2713") + " Cursor learning hooks installed");
       anyInstalled = true;
     } else if (r.alreadyInstalled) {
-      console.log(chalk17.dim("  Cursor hooks already installed"));
+      console.log(chalk18.dim("  Cursor hooks already installed"));
     }
   }
   if (!fs31.existsSync(".claude") && !fs31.existsSync(".cursor")) {
-    console.log(chalk17.yellow("No .claude/ or .cursor/ directory found."));
-    console.log(chalk17.dim("  Run `caliber init` first, or create the directory manually."));
+    console.log(chalk18.yellow("No .claude/ or .cursor/ directory found."));
+    console.log(chalk18.dim("  Run `caliber init` first, or create the directory manually."));
     return;
   }
   if (anyInstalled) {
-    console.log(chalk17.dim(`  Tool usage will be recorded and learnings extracted after \u2265${MIN_EVENTS_FOR_ANALYSIS} events.`));
-    console.log(chalk17.dim("  Learnings written to CALIBER_LEARNINGS.md."));
+    console.log(chalk18.dim(`  Tool usage will be recorded and learnings extracted after \u2265${MIN_EVENTS_FOR_ANALYSIS} events.`));
+    console.log(chalk18.dim("  Learnings written to CALIBER_LEARNINGS.md."));
   }
 }
 async function learnRemoveCommand() {
   let anyRemoved = false;
   const r1 = removeLearningHooks();
   if (r1.removed) {
-    console.log(chalk17.green("\u2713") + " Claude Code learning hooks removed");
+    console.log(chalk18.green("\u2713") + " Claude Code learning hooks removed");
     anyRemoved = true;
   }
   const r2 = removeCursorLearningHooks();
   if (r2.removed) {
-    console.log(chalk17.green("\u2713") + " Cursor learning hooks removed");
+    console.log(chalk18.green("\u2713") + " Cursor learning hooks removed");
     anyRemoved = true;
   }
   if (!anyRemoved) {
-    console.log(chalk17.dim("No learning hooks found."));
+    console.log(chalk18.dim("No learning hooks found."));
   }
 }
 async function learnStatusCommand() {
@@ -8429,34 +8739,34 @@ async function learnStatusCommand() {
   const cursorInstalled = areCursorLearningHooksInstalled();
   const state = readState2();
   const eventCount = getEventCount();
-  console.log(chalk17.bold("Session Learning Status"));
+  console.log(chalk18.bold("Session Learning Status"));
   console.log();
   if (claudeInstalled) {
-    console.log(chalk17.green("\u2713") + " Claude Code hooks " + chalk17.green("installed"));
+    console.log(chalk18.green("\u2713") + " Claude Code hooks " + chalk18.green("installed"));
   } else {
-    console.log(chalk17.dim("\u2717") + " Claude Code hooks " + chalk17.dim("not installed"));
+    console.log(chalk18.dim("\u2717") + " Claude Code hooks " + chalk18.dim("not installed"));
   }
   if (cursorInstalled) {
-    console.log(chalk17.green("\u2713") + " Cursor hooks " + chalk17.green("installed"));
+    console.log(chalk18.green("\u2713") + " Cursor hooks " + chalk18.green("installed"));
   } else {
-    console.log(chalk17.dim("\u2717") + " Cursor hooks " + chalk17.dim("not installed"));
+    console.log(chalk18.dim("\u2717") + " Cursor hooks " + chalk18.dim("not installed"));
   }
   if (!claudeInstalled && !cursorInstalled) {
-    console.log(chalk17.dim("  Run `caliber learn install` to enable session learning."));
+    console.log(chalk18.dim("  Run `caliber learn install` to enable session learning."));
   }
   console.log();
-  console.log(`Events recorded: ${chalk17.cyan(String(eventCount))}`);
-  console.log(`Threshold for analysis: ${chalk17.cyan(String(MIN_EVENTS_FOR_ANALYSIS))}`);
+  console.log(`Events recorded: ${chalk18.cyan(String(eventCount))}`);
+  console.log(`Threshold for analysis: ${chalk18.cyan(String(MIN_EVENTS_FOR_ANALYSIS))}`);
   if (state.lastAnalysisTimestamp) {
-    console.log(`Last analysis: ${chalk17.cyan(state.lastAnalysisTimestamp)}`);
+    console.log(`Last analysis: ${chalk18.cyan(state.lastAnalysisTimestamp)}`);
   } else {
-    console.log(`Last analysis: ${chalk17.dim("none")}`);
+    console.log(`Last analysis: ${chalk18.dim("none")}`);
   }
   const learnedSection = readLearnedSection();
   if (learnedSection) {
     const lineCount = learnedSection.split("\n").filter(Boolean).length;
     console.log(`
-Learned items in CALIBER_LEARNINGS.md: ${chalk17.cyan(String(lineCount))}`);
+Learned items in CALIBER_LEARNINGS.md: ${chalk18.cyan(String(lineCount))}`);
   }
 }
 
@@ -8530,7 +8840,7 @@ program.command("score").description("Score your current agent config setup (det
 program.command("refresh").description("Update docs based on recent code changes").option("--quiet", "Suppress output (for use in hooks)").option("--dry-run", "Preview changes without writing files").action(tracked("refresh", refreshCommand));
 program.command("hooks").description("Manage auto-refresh hooks (toggle interactively)").option("--install", "Enable all hooks non-interactively").option("--remove", "Disable all hooks non-interactively").action(tracked("hooks", hooksCommand));
 var learn = program.command("learn", { hidden: true }).description("[dev] Session learning \u2014 observe tool usage and extract reusable instructions");
-learn.command("observe").description("Record a tool event from stdin (called by hooks)").option("--failure", "Mark event as a tool failure").action(tracked("learn:observe", learnObserveCommand));
+learn.command("observe").description("Record a tool event from stdin (called by hooks)").option("--failure", "Mark event as a tool failure").option("--prompt", "Record a user prompt event").action(tracked("learn:observe", learnObserveCommand));
 learn.command("finalize").description("Analyze session events and update CALIBER_LEARNINGS.md (called on SessionEnd)").option("--force", "Skip the running-process check (for manual invocation)").action(tracked("learn:finalize", (opts) => learnFinalizeCommand(opts)));
 learn.command("install").description("Install learning hooks into .claude/settings.json").action(tracked("learn:install", learnInstallCommand));
 learn.command("remove").description("Remove learning hooks from .claude/settings.json").action(tracked("learn:remove", learnRemoveCommand));
@@ -8541,7 +8851,7 @@ import fs33 from "fs";
 import path26 from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import { execSync as execSync14 } from "child_process";
-import chalk18 from "chalk";
+import chalk19 from "chalk";
 import ora6 from "ora";
 import confirm2 from "@inquirer/confirm";
 var __dirname_vc = path26.dirname(fileURLToPath2(import.meta.url));
@@ -8575,17 +8885,17 @@ async function checkForUpdates() {
     const isInteractive = process.stdin.isTTY === true;
     if (!isInteractive) {
       console.log(
-        chalk18.yellow(
+        chalk19.yellow(
           `
 Update available: ${current} -> ${latest}
-Run ${chalk18.bold("npm install -g @rely-ai/caliber")} to upgrade.
+Run ${chalk19.bold("npm install -g @rely-ai/caliber")} to upgrade.
 `
         )
       );
       return;
     }
     console.log(
-      chalk18.yellow(`
+      chalk19.yellow(`
 Update available: ${current} -> ${latest}`)
     );
     const shouldUpdate = await confirm2({ message: "Would you like to update now? (Y/n)", default: true });
@@ -8603,13 +8913,13 @@ Update available: ${current} -> ${latest}`)
       const installed = getInstalledVersion();
       if (installed !== latest) {
         spinner.fail(`Update incomplete \u2014 got ${installed ?? "unknown"}, expected ${latest}`);
-        console.log(chalk18.yellow(`Run ${chalk18.bold(`npm install -g @rely-ai/caliber@${latest}`)} manually.
+        console.log(chalk19.yellow(`Run ${chalk19.bold(`npm install -g @rely-ai/caliber@${latest}`)} manually.
 `));
         return;
       }
-      spinner.succeed(chalk18.green(`Updated to ${latest}`));
+      spinner.succeed(chalk19.green(`Updated to ${latest}`));
       const args = process.argv.slice(2);
-      console.log(chalk18.dim(`
+      console.log(chalk19.dim(`
 Restarting: caliber ${args.join(" ")}
 `));
       execSync14(`caliber ${args.map((a) => JSON.stringify(a)).join(" ")}`, {
@@ -8622,11 +8932,11 @@ Restarting: caliber ${args.join(" ")}
       if (err instanceof Error) {
         const stderr = err.stderr;
         const errMsg = stderr ? String(stderr).trim().split("\n").pop() : err.message.split("\n")[0];
-        if (errMsg && !errMsg.includes("SIGTERM")) console.log(chalk18.dim(`  ${errMsg}`));
+        if (errMsg && !errMsg.includes("SIGTERM")) console.log(chalk19.dim(`  ${errMsg}`));
       }
       console.log(
-        chalk18.yellow(
-          `Run ${chalk18.bold(`npm install -g @rely-ai/caliber@${latest}`)} manually to upgrade.
+        chalk19.yellow(
+          `Run ${chalk19.bold(`npm install -g @rely-ai/caliber@${latest}`)} manually to upgrade.
 `
         )
       );