@rely-ai/caliber 1.35.1 → 1.37.0-dev.1774891449

package/dist/bin.js

@@ -389,7 +389,10 @@ function getCursorSetupRule() {
 function stripManagedBlocks(content) {
   let result = content;
   for (const [start, end] of MANAGED_BLOCK_PAIRS) {
-    const regex = new RegExp(`\\n?${start.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}[\\s\\S]*?${end.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\n?`, "g");
+    const regex = new RegExp(
+      `\\n?${start.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}[\\s\\S]*?${end.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\n?`,
+      "g"
+    );
     result = result.replace(regex, "\n");
   }
   return result.replace(/\n{3,}/g, "\n\n").trim() + "\n";
@@ -401,7 +404,7 @@ var init_pre_commit_block = __esm({
     init_resolve_caliber();
     BLOCK_START = "<!-- caliber:managed:pre-commit -->";
     BLOCK_END = "<!-- /caliber:managed:pre-commit -->";
-    MANAGED_DOC_PATHS = "CLAUDE.md .claude/ .cursor/ .cursorrules .github/copilot-instructions.md .github/instructions/ AGENTS.md CALIBER_LEARNINGS.md";
+    MANAGED_DOC_PATHS = "CLAUDE.md .claude/ .cursor/ .cursorrules .github/copilot-instructions.md .github/instructions/ AGENTS.md CALIBER_LEARNINGS.md .agents/ .opencode/";
     CURSOR_RULE_FILENAME = "caliber-pre-commit.mdc";
     LEARNINGS_BLOCK_START = "<!-- caliber:managed:learnings -->";
     LEARNINGS_BLOCK_END = "<!-- /caliber:managed:learnings -->";
@@ -1100,10 +1103,21 @@ __export(lock_exports, {
 import fs39 from "fs";
 import path32 from "path";
 import os8 from "os";
+import crypto5 from "crypto";
+function buildLockPath() {
+  const cwd = process.cwd();
+  const hash = crypto5.createHash("md5").update(cwd).digest("hex").slice(0, 8);
+  return path32.join(os8.tmpdir(), `.caliber-${hash}.lock`);
+}
+function getLockFile() {
+  if (!_lockPath) _lockPath = buildLockPath();
+  return _lockPath;
+}
 function isCaliberRunning() {
   try {
-    if (!fs39.existsSync(LOCK_FILE)) return false;
-    const raw = fs39.readFileSync(LOCK_FILE, "utf-8").trim();
+    const lockFile = buildLockPath();
+    if (!fs39.existsSync(lockFile)) return false;
+    const raw = fs39.readFileSync(lockFile, "utf-8").trim();
     const { pid, ts } = JSON.parse(raw);
     if (Date.now() - ts > STALE_MS) return false;
     try {
@@ -1118,22 +1132,23 @@ function isCaliberRunning() {
 }
 function acquireLock() {
   try {
-    fs39.writeFileSync(LOCK_FILE, JSON.stringify({ pid: process.pid, ts: Date.now() }));
+    fs39.writeFileSync(getLockFile(), JSON.stringify({ pid: process.pid, ts: Date.now() }));
   } catch {
   }
 }
 function releaseLock() {
   try {
-    if (fs39.existsSync(LOCK_FILE)) fs39.unlinkSync(LOCK_FILE);
+    const lockFile = getLockFile();
+    if (fs39.existsSync(lockFile)) fs39.unlinkSync(lockFile);
   } catch {
   }
 }
-var LOCK_FILE, STALE_MS;
+var STALE_MS, _lockPath;
 var init_lock = __esm({
   "src/lib/lock.ts"() {
     "use strict";
-    LOCK_FILE = path32.join(os8.tmpdir(), ".caliber.lock");
     STALE_MS = 10 * 60 * 1e3;
+    _lockPath = null;
   }
 });
 
@@ -1291,9 +1306,30 @@ var LEARNING_ROI_FILE = "roi-stats.json";
 var PERSONAL_LEARNINGS_FILE = path2.join(AUTH_DIR, "personal-learnings.md");
 var LEARNING_FINALIZE_LOG = "finalize.log";
 var LEARNING_LAST_ERROR_FILE = "last-error.json";
+var REFRESH_LAST_ERROR_FILE = path2.join(CALIBER_DIR, "last-refresh-error.json");
 var MIN_SESSIONS_FOR_COMPARISON = 3;
 
 // src/fingerprint/existing-config.ts
+function readSkillsFromDir(skillsDir) {
+  if (!fs2.existsSync(skillsDir)) return void 0;
+  try {
+    const skills = fs2.readdirSync(skillsDir, { withFileTypes: true }).filter((e) => e.isDirectory()).reduce((acc, entry) => {
+      const skillPath = path3.join(skillsDir, entry.name, "SKILL.md");
+      try {
+        acc.push({
+          name: entry.name,
+          filename: "SKILL.md",
+          content: fs2.readFileSync(skillPath, "utf-8")
+        });
+      } catch {
+      }
+      return acc;
+    }, []);
+    return skills.length > 0 ? skills : void 0;
+  } catch {
+    return void 0;
+  }
+}
 function readExistingConfigs(dir) {
   const configs = {};
   const readmeMdPath = path3.join(dir, "README.md");
@@ -1324,7 +1360,10 @@ function readExistingConfigs(dir) {
         const entryPath = path3.join(skillsDir, entry);
         const skillMdPath = path3.join(entryPath, "SKILL.md");
         if (fs2.statSync(entryPath).isDirectory() && fs2.existsSync(skillMdPath)) {
-          skills.push({ filename: `${entry}/SKILL.md`, content: fs2.readFileSync(skillMdPath, "utf-8") });
+          skills.push({
+            filename: `${entry}/SKILL.md`,
+            content: fs2.readFileSync(skillMdPath, "utf-8")
+          });
         } else if (entry.endsWith(".md")) {
           skills.push({ filename: entry, content: fs2.readFileSync(entryPath, "utf-8") });
         }
@@ -1348,20 +1387,26 @@ function readExistingConfigs(dir) {
     } catch {
     }
   }
-  const cursorSkillsDir = path3.join(dir, ".cursor", "skills");
-  if (fs2.existsSync(cursorSkillsDir)) {
+  configs.cursorSkills = readSkillsFromDir(path3.join(dir, ".cursor", "skills"));
+  const copilotPath = path3.join(dir, ".github", "copilot-instructions.md");
+  if (fs2.existsSync(copilotPath)) {
+    configs.copilotInstructions = fs2.readFileSync(copilotPath, "utf-8");
+  }
+  const copilotInstructionsDir = path3.join(dir, ".github", "instructions");
+  if (fs2.existsSync(copilotInstructionsDir)) {
     try {
-      const slugs = fs2.readdirSync(cursorSkillsDir).filter((f) => {
-        return fs2.statSync(path3.join(cursorSkillsDir, f)).isDirectory();
-      });
-      configs.cursorSkills = slugs.filter((slug) => fs2.existsSync(path3.join(cursorSkillsDir, slug, "SKILL.md"))).map((name) => ({
-        name,
-        filename: "SKILL.md",
-        content: fs2.readFileSync(path3.join(cursorSkillsDir, name, "SKILL.md"), "utf-8")
-      }));
+      const files = fs2.readdirSync(copilotInstructionsDir).filter((f) => f.endsWith(".instructions.md"));
+      if (files.length > 0) {
+        configs.copilotInstructionFiles = files.map((f) => ({
+          filename: f,
+          content: fs2.readFileSync(path3.join(copilotInstructionsDir, f), "utf-8")
+        }));
+      }
     } catch {
     }
   }
+  configs.codexSkills = readSkillsFromDir(path3.join(dir, ".agents", "skills"));
+  configs.opencodeSkills = readSkillsFromDir(path3.join(dir, ".opencode", "skills"));
   const mcpJsonPath = path3.join(dir, ".mcp.json");
   if (fs2.existsSync(mcpJsonPath)) {
     try {
@@ -3056,6 +3101,7 @@ var SKILL_FORMAT_RULES = `All skills follow the OpenSkills standard (agentskills
 
 Skill field requirements:
 - "name": kebab-case (lowercase letters, numbers, hyphens only). Becomes the directory name.
+- "name" MUST NOT be any of these reserved names (they are managed by Caliber automatically): "setup-caliber", "find-skills", "save-learning". Do NOT generate skills with these names.
 - "description": MUST include WHAT it does + WHEN to use it with specific trigger phrases. Example: "Manages database migrations. Use when user says 'run migration', 'create migration', 'db schema change', or modifies files in db/migrations/."
 - "content": markdown body only \u2014 do NOT include YAML frontmatter, it is generated from name+description.
 
@@ -3099,7 +3145,7 @@ PRIORITY WHEN CONSTRAINTS CONFLICT: Grounding and reference density matter more
 Note: Permissions, hooks, freshness tracking, and OpenSkills frontmatter are scored automatically by caliber \u2014 do not optimize for them.
 README.md is provided for context only \u2014 do NOT include a readmeMd field in your output.`;
 var OUTPUT_SIZE_CONSTRAINTS = `OUTPUT SIZE CONSTRAINTS \u2014 these are critical:
-- CLAUDE.md / AGENTS.md: MUST be under 150 lines for maximum score. Aim for 100-140 lines. Be concise \u2014 commands, architecture overview, and key conventions. Use bullet points and tables, not prose.
+- CLAUDE.md / AGENTS.md: MUST be under 400 lines for maximum score. Aim for 200-350 lines. Be thorough \u2014 commands, architecture overview, key conventions, data flow, and important patterns. Use bullet points and tables, not prose.
 
 Pack project references densely in architecture sections \u2014 use inline paths, not prose paragraphs:
 GOOD: **Entry**: \`src/bin.ts\` \u2192 \`src/cli.ts\` \xB7 **LLM** (\`src/llm/\`): \`anthropic.ts\` \xB7 \`vertex.ts\` \xB7 \`openai-compat.ts\`
@@ -3237,7 +3283,7 @@ Structure:
 5. "## Common Issues" (required) \u2014 specific error messages and their fixes. Not "check your config" but "If you see 'Connection refused on port 5432': 1. Verify postgres is running: docker ps | grep postgres 2. Check .env has correct DATABASE_URL"
 
 Rules:
-- Max 150 lines. Focus on actionable instructions, not documentation prose.
+- Max 400 lines. Focus on actionable instructions, not documentation prose.
 - Study existing code in the project context to extract the real patterns being used. A skill for "create API route" should show the exact file structure, imports, error handling, and naming that existing routes use.
 - Be specific and actionable. GOOD: "Run \`pnpm test -- --filter=api\` to verify". BAD: "Validate the data before proceeding."
 - Never use ambiguous language. Instead of "handle errors properly", write "Wrap the DB call in try/catch. On failure, return { error: string, code: number } matching the ErrorResponse type in \`src/types.ts\`."
@@ -3295,7 +3341,7 @@ Rules:
 - Update the "fileDescriptions" to reflect any changes you make.
 
 Quality constraints \u2014 your changes are scored, so do not break these:
-- CLAUDE.md / AGENTS.md: MUST stay under 150 lines. If adding content, remove less important lines to stay within budget. Do not refuse the user's request \u2014 make the change and trim elsewhere.
+- CLAUDE.md / AGENTS.md: MUST stay under 400 lines. If adding content, remove less important lines to stay within budget. Do not refuse the user's request \u2014 make the change and trim elsewhere.
 - Avoid vague instructions ("follow best practices", "write clean code", "ensure quality").
 - Do NOT add directory tree listings in code blocks.
 - Do NOT remove existing code blocks \u2014 they contribute to the executable content score.
@@ -3319,14 +3365,20 @@ CONSERVATIVE UPDATE means:
 - NEVER replace specific paths/commands with generic prose
 
 Quality constraints (the output is scored deterministically):
-- CLAUDE.md / AGENTS.md: MUST stay under 150 lines. If the diff adds content, trim the least important lines elsewhere.
+- CLAUDE.md / AGENTS.md: MUST stay under 400 lines. If the diff adds content, trim the least important lines elsewhere.
 - Keep 3+ code blocks with executable commands \u2014 do not remove code blocks
 - Every file path, command, and identifier must be in backticks
 - ONLY reference file paths that exist in the provided file tree \u2014 do NOT invent paths
 - Preserve the existing structure (headings, bullet style, formatting)
 
+Cross-agent sync:
+- When a code change affects documentation, update ALL provided platform configs together.
+- A renamed command, moved file, or changed convention must be reflected in every config (CLAUDE.md, AGENTS.md, copilot instructions, skills across all platforms).
+- Cross-agent consistency is critical \u2014 all agents working on this repo must have the same, accurate context.
+
 Managed content:
 - Keep managed blocks (<!-- caliber:managed --> ... <!-- /caliber:managed -->) intact
+- Keep context sync blocks (<!-- caliber:managed:sync --> ... <!-- /caliber:managed:sync -->) intact
 - Do NOT modify CALIBER_LEARNINGS.md \u2014 it is managed separately
 - Preserve any references to CALIBER_LEARNINGS.md in CLAUDE.md
 
@@ -3338,14 +3390,16 @@ Return a JSON object with this exact shape:
     "readmeMd": "<updated content or null>",
     "cursorrules": "<updated content or null>",
     "cursorRules": [{"filename": "name.mdc", "content": "..."}] or null,
-    "claudeSkills": [{"filename": "name.md", "content": "..."}] or null,
     "copilotInstructions": "<updated content or null>",
     "copilotInstructionFiles": [{"filename": "name.instructions.md", "content": "..."}] or null
   },
   "changesSummary": "<1-2 sentence summary of what was updated and why>",
+  "fileChanges": [{"file": "CLAUDE.md", "description": "added new API routes, updated build commands"}],
   "docsUpdated": ["CLAUDE.md", "README.md"]
 }
 
+The "fileChanges" array MUST include one entry per file that was updated (non-null in updatedDocs). Each entry describes what specifically changed in that file \u2014 be concrete (e.g. "added auth middleware section" not "updated docs").
+
 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.
 
@@ -3930,7 +3984,7 @@ var STOP_HOOK_SCRIPT_CONTENT = `#!/bin/sh
 if grep -q "caliber" .git/hooks/pre-commit 2>/dev/null; then
   exit 0
 fi
-FLAG="/tmp/caliber-nudge-$(echo "$PWD" | shasum | cut -c1-8)"
+FLAG="/tmp/caliber-nudge-$(echo "$PWD" | (shasum 2>/dev/null || sha1sum 2>/dev/null || md5sum 2>/dev/null || cksum) | cut -c1-8)"
 find /tmp -maxdepth 1 -name "caliber-nudge-*" -mmin +120 -delete 2>/dev/null
 if [ -f "$FLAG" ]; then
   exit 0
@@ -3961,11 +4015,13 @@ function installStopHook() {
   }
   settings.hooks.Stop.push({
     matcher: "",
-    hooks: [{
-      type: "command",
-      command: STOP_HOOK_SCRIPT_PATH,
-      description: STOP_HOOK_DESCRIPTION
-    }]
+    hooks: [
+      {
+        type: "command",
+        command: STOP_HOOK_SCRIPT_PATH,
+        description: STOP_HOOK_DESCRIPTION
+      }
+    ]
   });
   writeSettings(settings);
   return { installed: true, alreadyInstalled: false };
@@ -3997,16 +4053,20 @@ function getPrecommitBlock() {
   const invoke = npx ? bin : `"${bin}"`;
   return `${PRECOMMIT_START}
 if ${guard}; then
+  mkdir -p .caliber
   echo "\\033[2mcaliber: refreshing docs...\\033[0m"
-  ${invoke} refresh 2>/dev/null || true
-  ${invoke} learn finalize 2>/dev/null || true
-  git diff --name-only -- CLAUDE.md .claude/ .cursor/ AGENTS.md CALIBER_LEARNINGS.md 2>/dev/null | xargs git add 2>/dev/null || true
+  ${invoke} refresh --quiet 2>.caliber/refresh-hook.log || true
+  ${invoke} learn finalize 2>>.caliber/refresh-hook.log || true
+  git diff --name-only -- CLAUDE.md .claude/ .cursor/ AGENTS.md CALIBER_LEARNINGS.md .github/ .agents/ .opencode/ 2>/dev/null | xargs git add 2>/dev/null || true
 fi
 ${PRECOMMIT_END}`;
 }
 function getGitHooksDir() {
   try {
-    const gitDir = execSync8("git rev-parse --git-dir", { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] }).trim();
+    const gitDir = execSync8("git rev-parse --git-dir", {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"]
+    }).trim();
     return path10.join(gitDir, "hooks");
   } catch {
     return null;
@@ -5199,7 +5259,7 @@ import fs12 from "fs";
 import path12 from "path";
 function writeClaudeConfig(config) {
   const written = [];
-  fs12.writeFileSync("CLAUDE.md", appendLearningsBlock(appendPreCommitBlock(config.claudeMd)));
+  fs12.writeFileSync("CLAUDE.md", appendSyncBlock(appendLearningsBlock(appendPreCommitBlock(config.claudeMd))));
   written.push("CLAUDE.md");
   if (config.skills?.length) {
     for (const skill of config.skills) {
@@ -5245,7 +5305,8 @@ function writeCursorConfig(config) {
   }
   const preCommitRule = getCursorPreCommitRule();
   const learningsRule = getCursorLearningsRule();
-  const allRules = [...config.rules || [], preCommitRule, learningsRule];
+  const syncRule = getCursorSyncRule();
+  const allRules = [...config.rules || [], preCommitRule, learningsRule, syncRule];
   const rulesDir = path13.join(".cursor", "rules");
   if (!fs13.existsSync(rulesDir)) fs13.mkdirSync(rulesDir, { recursive: true });
   for (const rule of allRules) {
@@ -5294,7 +5355,10 @@ import fs14 from "fs";
 import path14 from "path";
 function writeCodexConfig(config) {
   const written = [];
-  fs14.writeFileSync("AGENTS.md", appendLearningsBlock(appendPreCommitBlock(config.agentsMd)));
+  fs14.writeFileSync(
+    "AGENTS.md",
+    appendLearningsBlock(appendPreCommitBlock(config.agentsMd, "codex"))
+  );
   written.push("AGENTS.md");
   if (config.skills?.length) {
     for (const skill of config.skills) {
@@ -5323,7 +5387,10 @@ function writeGithubCopilotConfig(config) {
   const written = [];
   if (config.instructions) {
     fs15.mkdirSync(".github", { recursive: true });
-    fs15.writeFileSync(path15.join(".github", "copilot-instructions.md"), appendLearningsBlock(appendPreCommitBlock(config.instructions)));
+    fs15.writeFileSync(
+      path15.join(".github", "copilot-instructions.md"),
+      appendSyncBlock(appendLearningsBlock(appendPreCommitBlock(config.instructions, "copilot")))
+    );
     written.push(".github/copilot-instructions.md");
   }
   if (config.instructionFiles?.length) {
@@ -5345,7 +5412,10 @@ import path17 from "path";
 function writeOpencodeConfig(config, agentsMdAlreadyWritten = false) {
   const written = [];
   if (!agentsMdAlreadyWritten) {
-    fs17.writeFileSync("AGENTS.md", appendLearningsBlock(appendPreCommitBlock(config.agentsMd)));
+    fs17.writeFileSync(
+      "AGENTS.md",
+      appendLearningsBlock(appendPreCommitBlock(config.agentsMd, "codex"))
+    );
     written.push("AGENTS.md");
   }
   if (config.skills?.length) {
@@ -6052,11 +6122,11 @@ var POINTS_LEARNED_CONTENT = 2;
 var POINTS_SOURCES_CONFIGURED = 3;
 var POINTS_SOURCES_REFERENCED = 3;
 var TOKEN_BUDGET_THRESHOLDS = [
-  { maxTokens: 2e3, points: 6 },
-  { maxTokens: 3500, points: 5 },
-  { maxTokens: 5e3, points: 4 },
-  { maxTokens: 8e3, points: 2 },
-  { maxTokens: 12e3, points: 1 }
+  { maxTokens: 5e3, points: 6 },
+  { maxTokens: 8e3, points: 5 },
+  { maxTokens: 12e3, points: 4 },
+  { maxTokens: 16e3, points: 2 },
+  { maxTokens: 24e3, points: 1 }
 ];
 var CODE_BLOCK_THRESHOLDS = [
   { minBlocks: 3, points: 8 },
@@ -9686,27 +9756,36 @@ async function initCommand(options) {
   const bin = resolveCaliber();
   const firstRun = isFirstRun(process.cwd());
   if (firstRun) {
-    console.log(brand.bold(`
+    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
   \u2588\u2588\u2551     \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D
   \u2588\u2588\u2551     \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u255D  \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557
   \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(chalk14.dim("  Keep your AI agent configs in sync \u2014 automatically."));
     console.log(chalk14.dim("  Works across Claude Code, Cursor, Codex, and GitHub Copilot.\n"));
     console.log(title.bold("  How it works:\n"));
-    console.log(chalk14.dim("  1. Connect    Auto-detect your LLM provider and agents"));
-    console.log(chalk14.dim("  2. Build      Install sync, scan your project, generate configs"));
-    console.log(chalk14.dim("  3. Done       Review score and start syncing\n"));
+    console.log(chalk14.dim("  1. Connect    Link your LLM provider and select your agents"));
+    console.log(chalk14.dim("  2. Setup      Detect stack, install sync hooks & skills"));
+    console.log(chalk14.dim("  3. Generate   Audit existing config or generate from scratch"));
+    console.log(chalk14.dim("  4. Finalize   Review changes and score your setup\n"));
   } else {
     console.log(brand.bold("\n  CALIBER") + chalk14.dim("  \u2014 setting up continuous sync\n"));
   }
   const platforms = detectPlatforms();
   if (!platforms.claude && !platforms.cursor && !platforms.codex && !platforms.opencode) {
-    console.log(chalk14.yellow("  \u26A0 No supported AI platforms detected (Claude, Cursor, Codex, OpenCode)."));
-    console.log(chalk14.yellow("    Caliber will still generate config files, but they won't be auto-installed.\n"));
+    console.log(
+      chalk14.yellow("  \u26A0 No supported AI platforms detected (Claude, Cursor, Codex, OpenCode).")
+    );
+    console.log(
+      chalk14.yellow(
+        "    Caliber will still generate config files, but they won't be auto-installed.\n"
+      )
+    );
   }
   const report = options.debugReport ? new DebugReport() : null;
   console.log(title.bold("  Step 1/3 \u2014 Connect\n"));
@@ -9761,9 +9840,12 @@ async function initCommand(options) {
   console.log(chalk14.dim(modelLine + "\n"));
   if (report) {
     report.markStep("Provider connection");
-    report.addSection("LLM Provider", `- **Provider**: ${config.provider}
+    report.addSection(
+      "LLM Provider",
+      `- **Provider**: ${config.provider}
 - **Model**: ${displayModel}
-- **Fast model**: ${fastModel || "none"}`);
+- **Fast model**: ${fastModel || "none"}`
+    );
   }
   await validateModel({ fast: true });
   let targetAgent;
@@ -9788,10 +9870,11 @@ async function initCommand(options) {
   console.log(chalk14.dim(`  Target: ${targetAgent.join(", ")}
 `));
   trackInitAgentSelected(targetAgent, agentAutoDetected);
-  console.log(title.bold("  Step 2/3 \u2014 Build\n"));
+  console.log(title.bold("  Step 2/4 \u2014 Setup\n"));
+  console.log(chalk14.dim("  Installing sync infrastructure...\n"));
   const hookResult = installPreCommitHook();
   if (hookResult.installed) {
-    console.log(`  ${chalk14.green("\u2713")} Pre-commit hook installed`);
+    console.log(`  ${chalk14.green("\u2713")} Pre-commit hook installed \u2014 configs sync on every commit`);
   } else if (hookResult.alreadyInstalled) {
     console.log(`  ${chalk14.green("\u2713")} Pre-commit hook \u2014 active`);
   }
@@ -9799,13 +9882,20 @@ async function initCommand(options) {
   console.log(`  ${chalk14.green("\u2713")} Onboarding hook \u2014 nudges new team members to set up`);
   const { ensureBuiltinSkills: ensureBuiltinSkills2 } = await Promise.resolve().then(() => (init_builtin_skills(), builtin_skills_exports));
   for (const agent of targetAgent) {
-    if (agent === "claude" && !fs34.existsSync(".claude")) fs34.mkdirSync(".claude", { recursive: true });
-    if (agent === "cursor" && !fs34.existsSync(".cursor")) fs34.mkdirSync(".cursor", { recursive: true });
-    if (agent === "codex" && !fs34.existsSync(".agents")) fs34.mkdirSync(".agents", { recursive: true });
+    if (agent === "claude" && !fs34.existsSync(".claude"))
+      fs34.mkdirSync(".claude", { recursive: true });
+    if (agent === "cursor" && !fs34.existsSync(".cursor"))
+      fs34.mkdirSync(".cursor", { recursive: true });
+    if (agent === "codex" && !fs34.existsSync(".agents"))
+      fs34.mkdirSync(".agents", { recursive: true });
   }
   const skillsWritten = ensureBuiltinSkills2();
   if (skillsWritten.length > 0) {
-    console.log(`  ${chalk14.green("\u2713")} Agent skills installed`);
+    console.log(
+      `  ${chalk14.green("\u2713")} Agent skills installed \u2014 /setup-caliber, /find-skills, /save-learning`
+    );
+  } else {
+    console.log(`  ${chalk14.green("\u2713")} Agent skills \u2014 already installed`);
   }
   const hasLearnableAgent = targetAgent.includes("claude") || targetAgent.includes("cursor");
   if (hasLearnableAgent) {
@@ -9815,15 +9905,31 @@ async function initCommand(options) {
     trackInitLearnEnabled(true);
   }
   console.log("");
+  console.log(chalk14.dim("  New team members can run /setup-caliber inside their coding agent"));
+  console.log(chalk14.dim("  (Claude Code or Cursor) to get set up automatically.\n"));
   const baselineScore = computeLocalScore(process.cwd(), targetAgent);
-  log(options.verbose, `Baseline score: ${baselineScore.score}/100`);
+  console.log(chalk14.dim("  Current config 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}` : ""}`
+      );
+    }
+  }
   if (report) {
     report.markStep("Baseline scoring");
-    report.addSection("Scoring: Baseline", `**Score**: ${baselineScore.score}/100
+    report.addSection(
+      "Scoring: Baseline",
+      `**Score**: ${baselineScore.score}/100
 
 | Check | Passed | Points | Max |
 |-------|--------|--------|-----|
-` + baselineScore.checks.map((c) => `| ${c.name} | ${c.passed ? "Yes" : "No"} | ${c.earnedPoints} | ${c.maxPoints} |`).join("\n"));
+` + 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 = !!(baselineScore.checks.some((c) => c.id === "claude_md_exists" && c.passed) || baselineScore.checks.some((c) => c.id === "cursorrules_exists" && c.passed));
@@ -9837,15 +9943,27 @@ async function initCommand(options) {
   ]);
   const passingCount = baselineScore.checks.filter((c) => c.passed).length;
   const failingCount = baselineScore.checks.filter((c) => !c.passed).length;
-  trackInitScoreComputed(baselineScore.score, passingCount, failingCount, false);
   let skipGeneration = false;
-  if (hasExistingConfig && baselineScore.score === 100 && !options.force) {
-    skipGeneration = true;
+  if (hasExistingConfig && baselineScore.score === 100) {
+    trackInitScoreComputed(baselineScore.score, passingCount, failingCount, true);
+    console.log(chalk14.bold.green("\n  Your config is already optimal.\n"));
+    skipGeneration = !options.force;
   } else if (hasExistingConfig && !options.force && !options.autoApprove) {
-    console.log(chalk14.dim(`  Config score: ${baselineScore.score}/100 \u2014 Caliber can improve this.
-`));
-    const improveAnswer = await confirm2({ message: "Improve your existing configs?" });
-    skipGeneration = !improveAnswer;
+    trackInitScoreComputed(baselineScore.score, passingCount, failingCount, false);
+    console.log(
+      chalk14.dim("\n  Sync infrastructure is ready. Caliber can also audit your existing")
+    );
+    console.log(chalk14.dim("  configs and improve them using AI.\n"));
+    const auditAnswer = await promptInput("  Audit and improve your existing config? (Y/n) ");
+    skipGeneration = auditAnswer.toLowerCase() === "n";
+  } else if (!hasExistingConfig && !options.force && !options.autoApprove) {
+    trackInitScoreComputed(baselineScore.score, passingCount, failingCount, false);
+    console.log(chalk14.dim("\n  Sync infrastructure is ready. Caliber can also generate tailored"));
+    console.log(chalk14.dim("  CLAUDE.md, Cursor rules, and Codex configs for your project.\n"));
+    const generateAnswer = await promptInput("  Generate agent configs? (Y/n) ");
+    skipGeneration = generateAnswer.toLowerCase() === "n";
+  } else {
+    trackInitScoreComputed(baselineScore.score, passingCount, failingCount, false);
   }
   if (skipGeneration) {
     const {
@@ -9873,7 +9991,12 @@ async function initCommand(options) {
     if (targetAgent.includes("cursor")) {
       const rulesDir = path28.join(".cursor", "rules");
       if (!fs34.existsSync(rulesDir)) fs34.mkdirSync(rulesDir, { recursive: true });
-      for (const rule of [getCursorPreCommitRule2(), getCursorLearningsRule2(), getCursorSyncRule2(), getCursorSetupRule2()]) {
+      for (const rule of [
+        getCursorPreCommitRule2(),
+        getCursorLearningsRule2(),
+        getCursorSyncRule2(),
+        getCursorSetupRule2()
+      ]) {
         fs34.writeFileSync(path28.join(rulesDir, rule.filename), rule.content);
       }
       console.log(`  ${chalk14.green("\u2713")} Cursor rules \u2014 added Caliber sync rules`);
@@ -9905,9 +10028,12 @@ async function initCommand(options) {
     trackInitCompleted("sync-only", baselineScore.score);
     console.log(chalk14.bold.green("\n  Caliber sync is set up!\n"));
     console.log(chalk14.dim("  Your agent configs will sync automatically on every commit."));
-    console.log(chalk14.dim("  Run ") + title(`${bin} init --force`) + chalk14.dim(" anytime to generate or improve configs.\n"));
+    console.log(
+      chalk14.dim("  Run ") + title(`${bin} init --force`) + chalk14.dim(" anytime to generate or improve configs.\n")
+    );
     return;
   }
+  console.log(title.bold("\n  Step 3/4 \u2014 Generate\n"));
   const genModelInfo = fastModel ? `  Using ${displayModel} for docs, ${fastModel} for skills` : `  Using ${displayModel}`;
   console.log(chalk14.dim(genModelInfo + "\n"));
   if (report) report.markStep("Generation");
@@ -9923,8 +10049,14 @@ async function initCommand(options) {
   const TASK_STACK = display.add("Detecting project stack", { pipelineLabel: "Scan" });
   const TASK_CONFIG = display.add("Generating configs", { depth: 1, pipelineLabel: "Generate" });
   const TASK_SKILLS_GEN = display.add("Generating skills", { depth: 2, pipelineLabel: "Skills" });
-  const TASK_SKILLS_SEARCH = display.add("Searching community skills", { depth: 1, pipelineLabel: "Search", pipelineRow: 1 });
-  const TASK_SCORE_REFINE = display.add("Validating & refining config", { pipelineLabel: "Validate" });
+  const TASK_SKILLS_SEARCH = display.add("Searching community skills", {
+    depth: 1,
+    pipelineLabel: "Search",
+    pipelineRow: 1
+  });
+  const TASK_SCORE_REFINE = display.add("Validating & refining config", {
+    pipelineLabel: "Validate"
+  });
   display.start();
   display.enableWaitingContent();
   try {
@@ -9934,21 +10066,39 @@ async function initCommand(options) {
     const stackSummary = stackParts.join(", ") || "no languages";
     const largeRepoNote = fingerprint.fileTree.length > 5e3 ? ` (${fingerprint.fileTree.length.toLocaleString()} files, smart sampling active)` : "";
     display.update(TASK_STACK, "done", stackSummary + largeRepoNote);
-    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`);
+    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`
+    );
     const cliSources = options.source || [];
     const workspaces = getDetectedWorkspaces(process.cwd());
     const sources2 = resolveAllSources(process.cwd(), cliSources, workspaces);
     if (sources2.length > 0) {
       fingerprint.sources = sources2;
-      log(options.verbose, `Sources: ${sources2.length} resolved (${sources2.map((s) => s.name).join(", ")})`);
+      log(
+        options.verbose,
+        `Sources: ${sources2.length} resolved (${sources2.map((s) => s.name).join(", ")})`
+      );
     }
     if (report) {
-      report.addJson("Fingerprint: Git", { remote: fingerprint.gitRemoteUrl, packageName: fingerprint.packageName });
+      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: 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);
+      if (fingerprint.codeAnalysis)
+        report.addJson("Fingerprint: Code Analysis", fingerprint.codeAnalysis);
     }
     const isEmpty = fingerprint.fileTree.length < 3;
     if (isEmpty) {
@@ -9979,13 +10129,26 @@ async function initCommand(options) {
       let passingChecks;
       let currentScore;
       if (hasExistingConfig && localBaseline.score >= 95 && !options.force) {
-        const currentLlmFixable = localBaseline.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 }));
+        const currentLlmFixable = localBaseline.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 = localBaseline.checks.filter((c) => c.passed).map((c) => ({ name: c.name }));
         currentScore = localBaseline.score;
       }
       if (report) {
-        const fullPrompt = buildGeneratePrompt(fingerprint, targetAgent, fingerprint.description, failingChecks, currentScore, passingChecks);
+        const fullPrompt = buildGeneratePrompt(
+          fingerprint,
+          targetAgent,
+          fingerprint.description,
+          failingChecks,
+          currentScore,
+          passingChecks
+        );
         report.addCodeBlock("Generation: Full LLM Prompt", fullPrompt);
       }
       const result = await generateSetup(
@@ -10105,8 +10268,11 @@ async function initCommand(options) {
     if (rawOutput) report.addCodeBlock("Generation: Raw LLM Response", rawOutput);
     report.addJson("Generation: Parsed Config", generatedSetup);
   }
-  log(options.verbose, `Generation completed: ${elapsedMs}ms, stopReason: ${genStopReason || "end_turn"}`);
-  console.log(title.bold("  Step 3/3 \u2014 Done\n"));
+  log(
+    options.verbose,
+    `Generation completed: ${elapsedMs}ms, stopReason: ${genStopReason || "end_turn"}`
+  );
+  console.log(title.bold("  Step 4/4 \u2014 Finalize\n"));
   const setupFiles = collectSetupFiles(generatedSetup, targetAgent);
   const staged = stageFiles(setupFiles, process.cwd());
   const totalChanges = staged.newFiles + staged.modifiedFiles;
@@ -10117,10 +10283,18 @@ async function initCommand(options) {
     }
     console.log("");
   }
-  console.log(chalk14.dim(`  ${chalk14.green(`${staged.newFiles} new`)} / ${chalk14.yellow(`${staged.modifiedFiles} modified`)} file${totalChanges !== 1 ? "s" : ""}`));
+  console.log(
+    chalk14.dim(
+      `  ${chalk14.green(`${staged.newFiles} new`)} / ${chalk14.yellow(`${staged.modifiedFiles} modified`)} file${totalChanges !== 1 ? "s" : ""}`
+    )
+  );
   if (skillSearchResult.results.length > 0) {
-    console.log(chalk14.dim(`  ${chalk14.cyan(`${skillSearchResult.results.length}`)} community skills available to install
-`));
+    console.log(
+      chalk14.dim(
+        `  ${chalk14.cyan(`${skillSearchResult.results.length}`)} community skills available to install
+`
+      )
+    );
   } else {
     console.log("");
   }
@@ -10156,8 +10330,12 @@ async function initCommand(options) {
     }
     const updatedFiles = collectSetupFiles(generatedSetup, targetAgent);
     const restaged = stageFiles(updatedFiles, process.cwd());
-    console.log(chalk14.dim(`  ${chalk14.green(`${restaged.newFiles} new`)} / ${chalk14.yellow(`${restaged.modifiedFiles} modified`)} file${restaged.newFiles + restaged.modifiedFiles !== 1 ? "s" : ""}
-`));
+    console.log(
+      chalk14.dim(
+        `  ${chalk14.green(`${restaged.newFiles} new`)} / ${chalk14.yellow(`${restaged.modifiedFiles} modified`)} file${restaged.newFiles + restaged.modifiedFiles !== 1 ? "s" : ""}
+`
+      )
+    );
     printSetupSummary(generatedSetup);
     const { openReview: openRev } = await Promise.resolve().then(() => (init_review(), review_exports));
     await openRev("terminal", restaged.stagedFiles);
@@ -10183,7 +10361,8 @@ async function initCommand(options) {
       const agentRefs = [];
       if (claude) agentRefs.push("See `CLAUDE.md` for Claude Code configuration.");
       if (cursor) agentRefs.push("See `.cursor/rules/` for Cursor rules.");
-      if (agentRefs.length === 0) agentRefs.push("See CLAUDE.md and .cursor/rules/ for agent configurations.");
+      if (agentRefs.length === 0)
+        agentRefs.push("See CLAUDE.md and .cursor/rules/ for agent configurations.");
       const stubContent = `# AGENTS.md
 
 This project uses AI coding agents configured by [Caliber](https://github.com/caliber-ai-org/ai-setup).
@@ -10230,24 +10409,39 @@ ${agentRefs.join(" ")}
   if (afterScore.score < baselineScore.score) {
     trackInitScoreRegression(baselineScore.score, afterScore.score);
     console.log("");
-    console.log(chalk14.yellow(`  Score would drop from ${baselineScore.score} to ${afterScore.score} \u2014 reverting changes.`));
+    console.log(
+      chalk14.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(chalk14.dim(`  Reverted ${restored.length + removed.length} file${restored.length + removed.length === 1 ? "" : "s"} from backup.`));
+        console.log(
+          chalk14.dim(
+            `  Reverted ${restored.length + removed.length} file${restored.length + removed.length === 1 ? "" : "s"} from backup.`
+          )
+        );
       }
     } catch {
     }
-    console.log(chalk14.dim("  Run ") + chalk14.hex("#83D1EB")(`${bin} init --force`) + chalk14.dim(" to override.\n"));
+    console.log(
+      chalk14.dim("  Run ") + chalk14.hex("#83D1EB")(`${bin} init --force`) + chalk14.dim(" to override.\n")
+    );
     return;
   }
   if (report) {
     report.markStep("Post-write scoring");
-    report.addSection("Scoring: Post-Write", `**Score**: ${afterScore.score}/100 (delta: ${afterScore.score - baselineScore.score >= 0 ? "+" : ""}${afterScore.score - baselineScore.score})
+    report.addSection(
+      "Scoring: Post-Write",
+      `**Score**: ${afterScore.score}/100 (delta: ${afterScore.score - baselineScore.score >= 0 ? "+" : ""}${afterScore.score - baselineScore.score})
 
 | Check | Passed | Points | Max |
 |-------|--------|--------|-----|
-` + afterScore.checks.map((c) => `| ${c.name} | ${c.passed ? "Yes" : "No"} | ${c.earnedPoints} | ${c.maxPoints} |`).join("\n"));
+` + afterScore.checks.map(
+        (c) => `| ${c.name} | ${c.passed ? "Yes" : "No"} | ${c.earnedPoints} | ${c.maxPoints} |`
+      ).join("\n")
+    );
   }
   recordScore(afterScore, "init");
   trackInitCompleted("full-generation", afterScore.score);
@@ -10255,7 +10449,10 @@ ${agentRefs.join(" ")}
   if (options.verbose) {
     log(options.verbose, `Final score: ${afterScore.score}/100`);
     for (const c of afterScore.checks.filter((ch) => !ch.passed)) {
-      log(options.verbose, `  Still failing: ${c.name} (${c.earnedPoints}/${c.maxPoints})${c.suggestion ? ` \u2014 ${c.suggestion}` : ""}`);
+      log(
+        options.verbose,
+        `  Still failing: ${c.name} (${c.earnedPoints}/${c.maxPoints})${c.suggestion ? ` \u2014 ${c.suggestion}` : ""}`
+      );
     }
   }
   let communitySkillsInstalled = 0;
@@ -10272,21 +10469,32 @@ ${agentRefs.join(" ")}
   const done = chalk14.green("\u2713");
   console.log(chalk14.bold.green("\n  Caliber is set up!\n"));
   console.log(chalk14.bold("  What's configured:\n"));
-  console.log(`    ${done}  Continuous sync     ${chalk14.dim("pre-commit hook keeps all agent configs in sync")}`);
-  console.log(`    ${done}  Config generated    ${chalk14.dim(`score: ${afterScore.score}/100`)}`);
-  console.log(`    ${done}  Agent skills        ${chalk14.dim("/setup-caliber for new team members")}`);
+  console.log(
+    `    ${done}  Continuous sync          ${chalk14.dim("pre-commit hook keeps all agent configs in sync")}`
+  );
+  console.log(
+    `    ${done}  Config generated         ${title(`${bin} score`)} ${chalk14.dim("for full breakdown")}`
+  );
+  console.log(
+    `    ${done}  Agent skills             ${chalk14.dim("/setup-caliber for new team members")}`
+  );
   if (hasLearnableAgent) {
-    console.log(`    ${done}  Session learning    ${chalk14.dim("learns from your corrections")}`);
+    console.log(
+      `    ${done}  Session learning         ${chalk14.dim("agent learns from your feedback")}`
+    );
   }
   if (communitySkillsInstalled > 0) {
-    console.log(`    ${done}  Community skills    ${chalk14.dim(`${communitySkillsInstalled} installed for your stack`)}`);
+    console.log(
+      `    ${done}  Community skills         ${chalk14.dim(`${communitySkillsInstalled} skill${communitySkillsInstalled > 1 ? "s" : ""} installed for your stack`)}`
+    );
   }
   console.log(chalk14.bold("\n  What happens next:\n"));
-  console.log(chalk14.dim("    Every commit syncs your agent configs automatically."));
-  console.log(chalk14.dim("    New team members run /setup-caliber to get set up instantly.\n"));
-  console.log(`    ${title(`${bin} score`)}        Full scoring breakdown`);
-  console.log(`    ${title(`${bin} skills`)}       Find community skills`);
-  console.log(`    ${title(`${bin} undo`)}         Revert changes`);
+  console.log(chalk14.dim("    Every commit will automatically sync your agent configs."));
+  console.log(chalk14.dim("    New team members can run /setup-caliber to get set up instantly.\n"));
+  console.log(chalk14.bold("  Explore:\n"));
+  console.log(`    ${title(`${bin} score`)}        Full scoring breakdown with improvement tips`);
+  console.log(`    ${title(`${bin} skills`)}       Find community skills for your stack`);
+  console.log(`    ${title(`${bin} undo`)}         Revert all changes from this run`);
   console.log(`    ${title(`${bin} uninstall`)}    Remove Caliber completely`);
   console.log("");
   if (options.showTokens) {
@@ -10296,8 +10504,10 @@ ${agentRefs.join(" ")}
     report.markStep("Finished");
     const reportPath = path28.join(process.cwd(), ".caliber", "debug-report.md");
     report.write(reportPath);
-    console.log(chalk14.dim(`  Debug report written to ${path28.relative(process.cwd(), reportPath)}
-`));
+    console.log(
+      chalk14.dim(`  Debug report written to ${path28.relative(process.cwd(), reportPath)}
+`)
+    );
   }
 }
 
@@ -10660,12 +10870,23 @@ import { execSync as execSync15 } from "child_process";
 var MAX_DIFF_BYTES = 1e5;
 var DOC_PATTERNS = [
   "CLAUDE.md",
+  "AGENTS.md",
   "README.md",
   ".cursorrules",
   ".cursor/rules/",
+  ".cursor/skills/",
   ".claude/skills/",
+  ".agents/skills/",
+  ".opencode/skills/",
+  ".github/copilot-instructions.md",
+  ".github/instructions/",
   "CALIBER_LEARNINGS.md"
 ];
+function truncateAtLineEnd(text, maxBytes) {
+  if (text.length <= maxBytes) return text;
+  const lastNewline = text.lastIndexOf("\n", maxBytes);
+  return lastNewline === -1 ? text.slice(0, maxBytes) : text.slice(0, lastNewline);
+}
 function excludeArgs() {
   return DOC_PATTERNS.flatMap((p) => ["--", `:!${p}`]);
 }
@@ -10714,9 +10935,9 @@ function collectDiff(lastSha) {
   const totalSize = committedDiff.length + stagedDiff.length + unstagedDiff.length;
   if (totalSize > MAX_DIFF_BYTES) {
     const ratio = MAX_DIFF_BYTES / totalSize;
-    committedDiff = committedDiff.slice(0, Math.floor(committedDiff.length * ratio));
-    stagedDiff = stagedDiff.slice(0, Math.floor(stagedDiff.length * ratio));
-    unstagedDiff = unstagedDiff.slice(0, Math.floor(unstagedDiff.length * ratio));
+    committedDiff = truncateAtLineEnd(committedDiff, Math.floor(committedDiff.length * ratio));
+    stagedDiff = truncateAtLineEnd(stagedDiff, Math.floor(stagedDiff.length * ratio));
+    unstagedDiff = truncateAtLineEnd(unstagedDiff, Math.floor(unstagedDiff.length * ratio));
   }
   const hasChanges = !!(committedDiff || stagedDiff || unstagedDiff || changedFiles.length);
   const parts = [];
@@ -10735,11 +10956,11 @@ import path30 from "path";
 function writeRefreshDocs(docs) {
   const written = [];
   if (docs.agentsMd) {
-    fs37.writeFileSync("AGENTS.md", appendLearningsBlock(appendPreCommitBlock(docs.agentsMd)));
+    fs37.writeFileSync("AGENTS.md", appendManagedBlocks(docs.agentsMd, "codex"));
     written.push("AGENTS.md");
   }
   if (docs.claudeMd) {
-    fs37.writeFileSync("CLAUDE.md", appendLearningsBlock(appendPreCommitBlock(docs.claudeMd)));
+    fs37.writeFileSync("CLAUDE.md", appendManagedBlocks(docs.claudeMd));
     written.push("CLAUDE.md");
   }
   if (docs.readmeMd) {
@@ -10758,17 +10979,12 @@ function writeRefreshDocs(docs) {
       written.push(`.cursor/rules/${rule.filename}`);
     }
   }
-  if (docs.claudeSkills) {
-    const skillsDir = path30.join(".claude", "skills");
-    if (!fs37.existsSync(skillsDir)) fs37.mkdirSync(skillsDir, { recursive: true });
-    for (const skill of docs.claudeSkills) {
-      fs37.writeFileSync(path30.join(skillsDir, skill.filename), skill.content);
-      written.push(`.claude/skills/${skill.filename}`);
-    }
-  }
   if (docs.copilotInstructions) {
     fs37.mkdirSync(".github", { recursive: true });
-    fs37.writeFileSync(path30.join(".github", "copilot-instructions.md"), appendLearningsBlock(appendPreCommitBlock(docs.copilotInstructions)));
+    fs37.writeFileSync(
+      path30.join(".github", "copilot-instructions.md"),
+      appendManagedBlocks(docs.copilotInstructions, "copilot")
+    );
     written.push(".github/copilot-instructions.md");
   }
   if (docs.copilotInstructionFiles) {
@@ -10784,6 +11000,7 @@ function writeRefreshDocs(docs) {
 
 // src/ai/refresh.ts
 init_config();
+init_pre_commit_block();
 async function refreshDocs(diff, existingDocs, projectContext, learnedSection, sources2) {
   const prompt = buildRefreshPrompt(diff, existingDocs, projectContext, learnedSection, sources2);
   const fastModel = getFastModel();
@@ -10799,13 +11016,17 @@ function buildRefreshPrompt(diff, existingDocs, projectContext, learnedSection,
   const parts = [];
   parts.push("Update documentation based on the following code changes.\n");
   if (projectContext.packageName) parts.push(`Project: ${projectContext.packageName}`);
-  if (projectContext.languages?.length) parts.push(`Languages: ${projectContext.languages.join(", ")}`);
-  if (projectContext.frameworks?.length) parts.push(`Frameworks: ${projectContext.frameworks.join(", ")}`);
+  if (projectContext.languages?.length)
+    parts.push(`Languages: ${projectContext.languages.join(", ")}`);
+  if (projectContext.frameworks?.length)
+    parts.push(`Frameworks: ${projectContext.frameworks.join(", ")}`);
   if (projectContext.fileTree?.length) {
     const tree = projectContext.fileTree.slice(0, 200);
-    parts.push(`
+    parts.push(
+      `
 File tree (${tree.length}/${projectContext.fileTree.length} \u2014 only reference paths from this list):
-${tree.join("\n")}`);
+${tree.join("\n")}`
+    );
   }
   parts.push(`
 Changed files: ${diff.changedFiles.join(", ")}`);
@@ -10825,11 +11046,11 @@ Changed files: ${diff.changedFiles.join(", ")}`);
   parts.push("\n--- Current Documentation ---");
   if (existingDocs.agentsMd) {
     parts.push("\n[AGENTS.md]");
-    parts.push(existingDocs.agentsMd);
+    parts.push(stripManagedBlocks(existingDocs.agentsMd));
   }
   if (existingDocs.claudeMd) {
     parts.push("\n[CLAUDE.md]");
-    parts.push(existingDocs.claudeMd);
+    parts.push(stripManagedBlocks(existingDocs.claudeMd));
   }
   if (existingDocs.readmeMd) {
     parts.push("\n[README.md]");
@@ -10848,11 +11069,23 @@ Changed files: ${diff.changedFiles.join(", ")}`);
   }
   if (existingDocs.cursorRules?.length) {
     for (const rule of existingDocs.cursorRules) {
+      if (rule.filename.startsWith("caliber-")) continue;
       parts.push(`
 [.cursor/rules/${rule.filename}]`);
       parts.push(rule.content);
     }
   }
+  if (existingDocs.copilotInstructions) {
+    parts.push("\n[.github/copilot-instructions.md]");
+    parts.push(stripManagedBlocks(existingDocs.copilotInstructions));
+  }
+  if (existingDocs.copilotInstructionFiles?.length) {
+    for (const file of existingDocs.copilotInstructionFiles) {
+      parts.push(`
+[.github/instructions/${file.filename}]`);
+      parts.push(file.content);
+    }
+  }
   if (learnedSection) {
     parts.push("\n--- Learned Patterns (from session learning) ---");
     parts.push("Consider these accumulated learnings when deciding what to update:");
@@ -11062,6 +11295,49 @@ function migrateInlineLearnings() {
 init_config();
 init_resolve_caliber();
 init_builtin_skills();
+function writeRefreshError(error) {
+  try {
+    if (!fs40.existsSync(CALIBER_DIR)) fs40.mkdirSync(CALIBER_DIR, { recursive: true });
+    fs40.writeFileSync(
+      REFRESH_LAST_ERROR_FILE,
+      JSON.stringify(
+        {
+          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+          error: error instanceof Error ? error.message : String(error),
+          stack: error instanceof Error ? error.stack : void 0,
+          cwd: process.cwd(),
+          nodeVersion: process.version
+        },
+        null,
+        2
+      )
+    );
+  } catch {
+  }
+}
+function readRefreshError() {
+  try {
+    if (!fs40.existsSync(REFRESH_LAST_ERROR_FILE)) return null;
+    return JSON.parse(fs40.readFileSync(REFRESH_LAST_ERROR_FILE, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+function clearRefreshError() {
+  try {
+    if (fs40.existsSync(REFRESH_LAST_ERROR_FILE)) fs40.unlinkSync(REFRESH_LAST_ERROR_FILE);
+  } catch {
+  }
+}
+function detectSyncedAgents(writtenFiles) {
+  const agents = [];
+  const joined = writtenFiles.join(" ");
+  if (joined.includes("CLAUDE.md") || joined.includes(".claude/")) agents.push("Claude Code");
+  if (joined.includes(".cursor/") || joined.includes(".cursorrules")) agents.push("Cursor");
+  if (joined.includes("copilot-instructions") || joined.includes(".github/instructions/")) agents.push("Copilot");
+  if (joined.includes("AGENTS.md") || joined.includes(".agents/")) agents.push("Codex");
+  return agents;
+}
 function log2(quiet, ...args) {
   if (!quiet) console.log(...args);
 }
@@ -11080,21 +11356,41 @@ function discoverGitRepos(parentDir) {
   }
   return repos.sort();
 }
+function collectFilesToWrite(updatedDocs) {
+  const files = [];
+  if (updatedDocs.agentsMd) files.push("AGENTS.md");
+  if (updatedDocs.claudeMd) files.push("CLAUDE.md");
+  if (updatedDocs.readmeMd) files.push("README.md");
+  if (updatedDocs.cursorrules) files.push(".cursorrules");
+  if (Array.isArray(updatedDocs.cursorRules)) {
+    for (const r of updatedDocs.cursorRules)
+      files.push(`.cursor/rules/${r.filename}`);
+  }
+  if (updatedDocs.copilotInstructions) files.push(".github/copilot-instructions.md");
+  if (Array.isArray(updatedDocs.copilotInstructionFiles)) {
+    for (const f of updatedDocs.copilotInstructionFiles)
+      files.push(`.github/instructions/${f.filename}`);
+  }
+  return files;
+}
 var REFRESH_COOLDOWN_MS = 3e4;
 async function refreshSingleRepo(repoDir, options) {
   const quiet = !!options.quiet;
   const prefix = options.label ? `${chalk19.bold(options.label)} ` : "";
   const state = readState();
   const lastSha = state?.lastRefreshSha ?? null;
-  if (state?.lastRefreshTimestamp) {
+  const currentSha = getCurrentHeadSha();
+  if (state?.lastRefreshTimestamp && lastSha && currentSha === lastSha) {
     const elapsed = Date.now() - new Date(state.lastRefreshTimestamp).getTime();
     if (elapsed < REFRESH_COOLDOWN_MS && elapsed > 0) {
-      log2(quiet, chalk19.dim(`${prefix}Skipped \u2014 last refresh was ${Math.round(elapsed / 1e3)}s ago.`));
+      log2(
+        quiet,
+        chalk19.dim(`${prefix}Skipped \u2014 last refresh was ${Math.round(elapsed / 1e3)}s ago.`)
+      );
       return;
     }
   }
   const diff = collectDiff(lastSha);
-  const currentSha = getCurrentHeadSha();
   if (!diff.hasChanges) {
     if (currentSha) {
       writeState({ lastRefreshSha: currentSha, lastRefreshTimestamp: (/* @__PURE__ */ new Date()).toISOString() });
@@ -11103,9 +11399,9 @@ async function refreshSingleRepo(repoDir, options) {
     return;
   }
   const spinner = quiet ? null : ora6(`${prefix}Analyzing changes...`).start();
-  const existingDocs = readExistingConfigs(repoDir);
   const learnedSection = readLearnedSection();
   const fingerprint = await collectFingerprint(repoDir);
+  const existingDocs = fingerprint.existingConfigs;
   const projectContext = {
     languages: fingerprint.languages,
     frameworks: fingerprint.frameworks,
@@ -11124,12 +11420,24 @@ async function refreshSingleRepo(repoDir, options) {
   const sourcesPayload = sources2.length > 0 ? sources2 : void 0;
   let response;
   try {
-    response = await refreshDocs(diffPayload, existingDocs, projectContext, learnedSection, sourcesPayload);
+    response = await refreshDocs(
+      diffPayload,
+      existingDocs,
+      projectContext,
+      learnedSection,
+      sourcesPayload
+    );
   } catch (firstErr) {
     const isTransient = firstErr instanceof Error && TRANSIENT_ERRORS.some((e) => firstErr.message.toLowerCase().includes(e.toLowerCase()));
     if (!isTransient) throw firstErr;
     try {
-      response = await refreshDocs(diffPayload, existingDocs, projectContext, learnedSection, sourcesPayload);
+      response = await refreshDocs(
+        diffPayload,
+        existingDocs,
+        projectContext,
+        learnedSection,
+        sourcesPayload
+      );
     } catch {
       spinner?.fail(`${prefix}Refresh failed after retry`);
       throw firstErr;
@@ -11155,9 +11463,9 @@ async function refreshSingleRepo(repoDir, options) {
   }
   const targetAgent = state?.targetAgent ?? detectTargetAgent(repoDir);
   const preScore = computeLocalScore(repoDir, targetAgent);
-  const filesToWrite = response.docsUpdated || [];
+  const allFilesToWrite = collectFilesToWrite(response.updatedDocs);
   const preRefreshContents = /* @__PURE__ */ new Map();
-  for (const filePath of filesToWrite) {
+  for (const filePath of allFilesToWrite) {
     const fullPath = path33.resolve(repoDir, filePath);
     try {
       preRefreshContents.set(filePath, fs40.readFileSync(fullPath, "utf-8"));
@@ -11181,7 +11489,9 @@ async function refreshSingleRepo(repoDir, options) {
         fs40.writeFileSync(fullPath, content);
       }
     }
-    spinner?.warn(`${prefix}Refresh reverted \u2014 score would drop from ${preScore.score} to ${postScore.score}`);
+    spinner?.warn(
+      `${prefix}Refresh reverted \u2014 score would drop from ${preScore.score} to ${postScore.score}`
+    );
     log2(quiet, chalk19.dim(`  Config quality gate prevented a regression. No files were changed.`));
     if (currentSha) {
       writeState({ lastRefreshSha: currentSha, lastRefreshTimestamp: (/* @__PURE__ */ new Date()).toISOString() });
@@ -11190,8 +11500,18 @@ async function refreshSingleRepo(repoDir, options) {
   }
   recordScore(postScore, "refresh");
   spinner?.succeed(`${prefix}Updated ${written.length} doc${written.length === 1 ? "" : "s"}`);
+  const fileChangesMap = new Map(
+    (response.fileChanges || []).map((fc) => [fc.file, fc.description])
+  );
   for (const file of written) {
-    log2(quiet, `  ${chalk19.green("\u2713")} ${file}`);
+    const desc = fileChangesMap.get(file);
+    const suffix = desc ? chalk19.dim(` \u2014 ${desc}`) : "";
+    log2(quiet, `  ${chalk19.green("\u2713")} ${file}${suffix}`);
+  }
+  const agents = detectSyncedAgents(written);
+  if (agents.length > 1) {
+    log2(quiet, chalk19.cyan(`
+  ${agents.length} agent formats in sync (${agents.join(", ")})`));
   }
   if (response.changesSummary) {
     log2(quiet, chalk19.dim(`
@@ -11201,6 +11521,7 @@ async function refreshSingleRepo(repoDir, options) {
   for (const file of builtinWritten) {
     log2(quiet, `  ${chalk19.green("\u2713")} ${file} ${chalk19.dim("(built-in)")}`);
   }
+  clearRefreshError();
   if (currentSha) {
     writeState({ lastRefreshSha: currentSha, lastRefreshTimestamp: (/* @__PURE__ */ new Date()).toISOString() });
   }
@@ -11211,11 +11532,28 @@ async function refreshCommand(options) {
     const { isCaliberRunning: isCaliberRunning2 } = await Promise.resolve().then(() => (init_lock(), lock_exports));
     if (isCaliberRunning2()) return;
   }
+  if (!quiet) {
+    const lastError = readRefreshError();
+    if (lastError) {
+      console.log(chalk19.yellow(`
+  \u26A0  Last refresh failed (${lastError.timestamp}):`));
+      console.log(chalk19.dim(`     ${lastError.error}`));
+      console.log(
+        chalk19.dim(
+          `     Run with --debug for full details, or report at https://github.com/caliber-ai-org/ai-setup/issues
+`
+        )
+      );
+      clearRefreshError();
+    }
+  }
   try {
     const config = loadConfig();
     if (!config) {
       if (quiet) return;
-      console.log(chalk19.red("No LLM provider configured. Run ") + chalk19.hex("#83D1EB")(`${resolveCaliber()} config`) + chalk19.red(" (e.g. choose Cursor) or set an API key."));
+      console.log(
+        chalk19.red("No LLM provider configured. Run ") + chalk19.hex("#83D1EB")(`${resolveCaliber()} config`) + chalk19.red(" (e.g. choose Cursor) or set an API key.")
+      );
       throw new Error("__exit__");
     }
     await validateModel({ fast: true });
@@ -11226,7 +11564,9 @@ async function refreshCommand(options) {
     const repos = discoverGitRepos(process.cwd());
     if (repos.length === 0) {
       if (quiet) return;
-      console.log(chalk19.red("Not inside a git repository and no git repos found in child directories."));
+      console.log(
+        chalk19.red("Not inside a git repository and no git repos found in child directories.")
+      );
       throw new Error("__exit__");
     }
     log2(quiet, chalk19.dim(`Found ${repos.length} git repo${repos.length === 1 ? "" : "s"}
@@ -11239,12 +11579,19 @@ async function refreshCommand(options) {
         await refreshSingleRepo(repo, { ...options, label: repoName });
       } catch (err) {
         if (err instanceof Error && err.message === "__exit__") continue;
-        log2(quiet, chalk19.yellow(`${repoName}: refresh failed \u2014 ${err instanceof Error ? err.message : "unknown error"}`));
+        writeRefreshError(err);
+        log2(
+          quiet,
+          chalk19.yellow(
+            `${repoName}: refresh failed \u2014 ${err instanceof Error ? err.message : "unknown error"}`
+          )
+        );
       }
     }
     process.chdir(originalDir);
   } catch (err) {
     if (err instanceof Error && err.message === "__exit__") throw err;
+    writeRefreshError(err);
     if (quiet) return;
     const msg = err instanceof Error ? err.message : "Unknown error";
     console.log(chalk19.red(`Refresh failed: ${msg}`));
@@ -11589,10 +11936,10 @@ function writeState2(state) {
 function resetState() {
   writeState2({ ...DEFAULT_STATE });
 }
-var LOCK_FILE2 = "finalize.lock";
+var LOCK_FILE = "finalize.lock";
 var LOCK_STALE_MS = 5 * 60 * 1e3;
 function lockFilePath() {
-  return path34.join(getLearningDir(), LOCK_FILE2);
+  return path34.join(getLearningDir(), LOCK_FILE);
 }
 function acquireFinalizeLock() {
   ensureLearningDir();