@rely-ai/caliber 1.35.0 → 1.36.0

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 {
@@ -3325,6 +3370,11 @@ Quality constraints (the output is scored deterministically):
 - 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
 - Do NOT modify CALIBER_LEARNINGS.md \u2014 it is managed separately
@@ -3338,7 +3388,6 @@ 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
   },
@@ -3930,7 +3979,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 +4010,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 +4048,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;
@@ -5294,7 +5349,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 +5381,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"),
+      appendLearningsBlock(appendPreCommitBlock(config.instructions, "copilot"))
+    );
     written.push(".github/copilot-instructions.md");
   }
   if (config.instructionFiles?.length) {
@@ -5345,7 +5406,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) {
@@ -10660,12 +10724,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 +10789,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 +10810,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 +10833,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 +10854,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 +10870,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 +10900,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]");
@@ -10839,20 +10914,25 @@ Changed files: ${diff.changedFiles.join(", ")}`);
     parts.push("\n[.cursorrules]");
     parts.push(existingDocs.cursorrules);
   }
-  if (existingDocs.claudeSkills?.length) {
-    for (const skill of existingDocs.claudeSkills) {
-      parts.push(`
-[.claude/skills/${skill.filename}]`);
-      parts.push(skill.content);
-    }
-  }
   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 +11142,40 @@ 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 log2(quiet, ...args) {
   if (!quiet) console.log(...args);
 }
@@ -11080,21 +11194,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 +11237,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 +11258,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 +11301,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 +11327,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() });
@@ -11201,6 +11349,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 +11360,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 +11392,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 +11407,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 +11764,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();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rely-ai/caliber",
-  "version": "1.35.0",
+  "version": "1.36.0",
   "description": "AI context infrastructure for coding agents — keeps CLAUDE.md, Cursor rules, and skills in sync as your codebase evolves",
   "type": "module",
   "bin": {