@archme/cli 0.8.0 → 0.8.1

package/dist/cli.js

@@ -10344,10 +10344,31 @@ var init_preflight = __esm({
 });
 
 // ../shared/daemonModel.ts
-var DEFAULT_CLAUDE_MODEL;
+function parseClaudeCodeVersion(output) {
+  return /(\d+)\.(\d+)\.(\d+)/.exec(output ?? "")?.[0] ?? null;
+}
+function versionBelow(version, minimum) {
+  const a2 = version.split(".").map(Number);
+  const b = minimum.split(".").map(Number);
+  for (let i2 = 0; i2 < Math.max(a2.length, b.length); i2++) {
+    const d = (a2[i2] ?? 0) - (b[i2] ?? 0);
+    if (d !== 0) return d < 0;
+  }
+  return false;
+}
+function runnableModel(requested, installedVersion) {
+  const needs = MIN_CLAUDE_CODE_VERSION[requested];
+  if (!needs || !installedVersion || !versionBelow(installedVersion, needs)) return { model: requested };
+  return { model: FALLBACK_CLAUDE_MODEL, fellBack: { from: requested, needs } };
+}
+var DEFAULT_CLAUDE_MODEL, FALLBACK_CLAUDE_MODEL, MIN_CLAUDE_CODE_VERSION;
 var init_daemonModel = __esm({
   "../shared/daemonModel.ts"() {
     DEFAULT_CLAUDE_MODEL = "claude-opus-5-5";
+    FALLBACK_CLAUDE_MODEL = "claude-opus-4-8";
+    MIN_CLAUDE_CODE_VERSION = {
+      "claude-opus-5-5": "2.1.280"
+    };
   }
 });
 
@@ -10509,6 +10530,39 @@ var init_spawn_claude = __esm({
   }
 });
 
+// src/scan/claudeVersion.ts
+async function runClaudeVersion() {
+  const r = await execa("claude", ["--version"], { reject: false, timeout: 15e3 });
+  return r.exitCode === 0 ? String(r.stdout) : null;
+}
+function createClaudeVersionProbe(opts = {}) {
+  const exec = opts.exec ?? runClaudeVersion;
+  const now = opts.now ?? Date.now;
+  const ttlMs = opts.ttlMs ?? DEFAULT_TTL_MS;
+  let cached;
+  return async () => {
+    if (cached && now() - cached.at < ttlMs) return cached.version;
+    let version = null;
+    try {
+      version = parseClaudeCodeVersion(await exec());
+    } catch {
+      version = null;
+    }
+    cached = { version, at: now() };
+    return version;
+  };
+}
+var DEFAULT_TTL_MS, claudeCodeVersion;
+var init_claudeVersion = __esm({
+  "src/scan/claudeVersion.ts"() {
+    "use strict";
+    init_execa();
+    init_daemonModel();
+    DEFAULT_TTL_MS = 10 * 6e4;
+    claudeCodeVersion = createClaudeVersionProbe();
+  }
+});
+
 // src/scan/model-pin.ts
 async function resolveModelPin(supabase) {
   try {
@@ -10522,10 +10576,30 @@ async function resolveModelPin(supabase) {
     return DEFAULT_CLAUDE_MODEL;
   }
 }
+async function resolveRunnableModel(supabase, deps = {}) {
+  const requested = await resolveModelPin(supabase);
+  const installed = await (deps.version ?? claudeCodeVersion)();
+  const { model, fellBack } = runnableModel(requested, installed);
+  if (fellBack) {
+    const warned = deps.warned ?? warnedFallbacks;
+    const key = `${fellBack.from}@${installed}`;
+    if (!warned.has(key)) {
+      warned.add(key);
+      (deps.warn ?? console.warn)(
+        `Claude Code ${installed} can't run ${fellBack.from} (needs ${fellBack.needs}+); running ${model} instead. Run \`claude update\` to use ${fellBack.from}.`
+      );
+    }
+  }
+  return model;
+}
+var warnedFallbacks;
 var init_model_pin = __esm({
   "src/scan/model-pin.ts"() {
     "use strict";
     init_spawn_claude();
+    init_daemonModel();
+    init_claudeVersion();
+    warnedFallbacks = /* @__PURE__ */ new Set();
   }
 });
 
@@ -10646,7 +10720,7 @@ async function runDigestJob(ctx, job, deviceId, inFlight2, mcp) {
       mcpConfigPath = join8(dir, "mcp.json");
       await writeFile5(mcpConfigPath, JSON.stringify({ mcpServers: {} }));
     }
-    const model = await resolveModelPin(ctx.supabase);
+    const model = await resolveRunnableModel(ctx.supabase);
     const proc = spawnClaude({
       prompt: buildDigestPrompt(payload),
       mcpConfigPath,
@@ -17051,6 +17125,7 @@ __export(run_exports, {
   buildClaudeExitMessage: () => buildClaudeExitMessage,
   buildDevices: () => buildDevices,
   buildDiffPrompt: () => buildDiffPrompt,
+  claudeFailureDetail: () => claudeFailureDetail,
   computeDiff: () => computeDiff,
   parseClaudeResult: () => parseClaudeResult,
   probeMcpAuth: () => probeMcpAuth,
@@ -17074,6 +17149,12 @@ function attributeKillCause(result, recorded) {
 function buildClaudeExitMessage(exitCode, causeSuffix, stderr) {
   return `claude exited ${exitCode}${causeSuffix}: ${stderr.slice(0, 4e3)}`;
 }
+function claudeFailureDetail(stderr, stdout) {
+  if (stderr.trim() || !stdout.trim()) return null;
+  const parsed = parseClaudeResult(stdout);
+  const text = (parsed.parsed ? parsed.summary : stdout).trim();
+  return text ? text.slice(-FAILURE_DETAIL_MAX) : null;
+}
 async function routeShutdownInterrupt(id, cancelled2, fail, exitCode) {
   if (cancelled2.has(id)) return;
   if (exitCode === 0) {
@@ -18016,7 +18097,7 @@ async function runJob(ctx, job, claimDeviceId) {
         `MCP auth preflight failed after ${probe.attempts} attempt(s) (last status ${probe.lastStatus ?? "n/a"}): ${probe.detail}. Not spawning claude \u2014 the architecture would not be writable and the run would silently no-op. Failing the job so it retries with a freshly minted token.`
       );
     }
-    const model = await resolveModelPin(ctx.supabase);
+    const model = await resolveRunnableModel(ctx.supabase, { warn: log });
     metrics.model = model;
     log(`spawning claude (mcp config at ${configPath}, model ${model})`);
     const proc = spawnClaude({
@@ -18054,6 +18135,8 @@ async function runJob(ctx, job, claimDeviceId) {
     if (result.exitCode !== 0) {
       const causeSuffix = cause ? ` (${result.signal ?? "exit"}, cause: ${cause})` : "";
       const stderr = result.stderr ? String(result.stderr) : "";
+      const detail = claudeFailureDetail(stderr, result.stdout ? String(result.stdout) : "");
+      if (detail) log(`claude output: ${detail.replace(/\n/g, " ")}`);
       throw new Error(buildClaudeExitMessage(result.exitCode, causeSuffix, stderr));
     }
     const runResult = parseClaudeResult(result.stdout ? String(result.stdout) : "");
@@ -18557,7 +18640,7 @@ ${signal} received, shutting down`);
   process.on("SIGINT", () => shutdown("SIGINT"));
   process.on("SIGTERM", () => shutdown("SIGTERM"));
 }
-var HEARTBEAT_INTERVAL_MS, CLAUDE_TIMEOUT_MS, CLAUDE_LARGE_DIFF_TIMEOUT_MS, SAFETY_SWEEP_MS, LOG_STDOUT_CAP_BYTES, LOG_STDERR_CAP_BYTES, PRE_SPAWN_TOKEN_MIN_LIFETIME_MS, SUPABASE_URL, SUPABASE_ANON_KEY, ARCHME_DAEMON_CLIENT_ID, ARCHME_MCP_BASE_URL, CLONE_BASE_DIR, DAEMON_ID, LEASE_SECONDS, inFlight, cancelled, killReasons, activeCleanups, cloneMutex, shuttingDown, daemonVersion, pauseUntilMs, resumeTimer, currentSched, MAX_CONCURRENT_JOBS, ctxByJob, deviceByJob, DEFAULT_CLONE_BASE_DIR, INLINE_PATCH_BYTE_CAP, GIT_SHA_RE, CURATOR_PREAMBLE, CORE_PRINCIPLES, STORY_COVERAGE_GATE, NEW_STORY_GUIDANCE, STORY_DESCRIPTION_EDIT_RULE, PHASE_GUIDANCE, BASE_RULES, DIFF_RULES, finite, channelSeq, MultipleAccountsError, __testDispatch;
+var HEARTBEAT_INTERVAL_MS, CLAUDE_TIMEOUT_MS, CLAUDE_LARGE_DIFF_TIMEOUT_MS, SAFETY_SWEEP_MS, LOG_STDOUT_CAP_BYTES, LOG_STDERR_CAP_BYTES, FAILURE_DETAIL_MAX, PRE_SPAWN_TOKEN_MIN_LIFETIME_MS, SUPABASE_URL, SUPABASE_ANON_KEY, ARCHME_DAEMON_CLIENT_ID, ARCHME_MCP_BASE_URL, CLONE_BASE_DIR, DAEMON_ID, LEASE_SECONDS, inFlight, cancelled, killReasons, activeCleanups, cloneMutex, shuttingDown, daemonVersion, pauseUntilMs, resumeTimer, currentSched, MAX_CONCURRENT_JOBS, ctxByJob, deviceByJob, DEFAULT_CLONE_BASE_DIR, INLINE_PATCH_BYTE_CAP, GIT_SHA_RE, CURATOR_PREAMBLE, CORE_PRINCIPLES, STORY_COVERAGE_GATE, NEW_STORY_GUIDANCE, STORY_DESCRIPTION_EDIT_RULE, PHASE_GUIDANCE, BASE_RULES, DIFF_RULES, finite, channelSeq, MultipleAccountsError, __testDispatch;
 var init_run = __esm({
   "src/daemon/run.ts"() {
     "use strict";
@@ -18603,6 +18686,7 @@ var init_run = __esm({
     SAFETY_SWEEP_MS = 3e4;
     LOG_STDOUT_CAP_BYTES = 30 * 1024;
     LOG_STDERR_CAP_BYTES = 30 * 1024;
+    FAILURE_DETAIL_MAX = 400;
     PRE_SPAWN_TOKEN_MIN_LIFETIME_MS = CLAUDE_LARGE_DIFF_TIMEOUT_MS + 5 * 60 * 1e3;
     inFlight = /* @__PURE__ */ new Map();
     cancelled = /* @__PURE__ */ new Set();
@@ -19983,7 +20067,7 @@ async function runScan(opts, deps = {}) {
     ...sourceRepo ? { source: await buildScanSource(opts.repoPath, sourceRepo, headSha) } : {}
   });
   try {
-    const model = await resolveModelPin(supabase);
+    const model = await resolveRunnableModel(supabase, { warn: log });
     const interactive = opts.interactive !== false;
     log(
       interactive ? `starting claude (mcp config at ${configPath}, model ${model}) \u2014 this session is interactive; answer its questions as they come` : `spawning claude (mcp config at ${configPath}, model ${model}, timeout ${Math.round(SCAN_CLAUDE_TIMEOUT_MS / 6e4)} min)`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@archme/cli",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "Map your codebase into a living architecture diagram: run `archme init` in a repo to scan it, `archme daemon start` to keep it current on every commit.",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",