archondev 2.19.54 → 2.19.55

package/dist/{chunk-TZNB4BPI.js → chunk-DDAOREZF.js}

@@ -1,6 +1,6 @@
 import {
   loadAtom
-} from "./chunk-R4A2C42M.js";
+} from "./chunk-QKHRSVUO.js";
 
 // src/cli/show.ts
 import chalk from "chalk";

package/dist/{chunk-TG3ELXS3.js → chunk-ICPOD7FC.js}

@@ -7,7 +7,7 @@ import {
   UsageRecorder,
   handleInsufficientCreditsRecovery,
   loadAtom
-} from "./chunk-R4A2C42M.js";
+} from "./chunk-QKHRSVUO.js";
 import {
   transitionAtom
 } from "./chunk-WGLVDEZC.js";
@@ -15,6 +15,10 @@ import {
   AnthropicClient,
   getDefaultModel
 } from "./chunk-F7R3QKHP.js";
+import {
+  debugLog,
+  getDebugLogPath
+} from "./chunk-R664NEAA.js";
 import {
   createAuthedSupabaseClient
 } from "./chunk-Q3GIFHIQ.js";
@@ -4208,11 +4212,12 @@ var ExecutorAgent = class {
         rollbackPerformed: false
       };
     }
-    const violations = this.checkArchitectureViolations(diffs, plan, architecture);
+    const reconciledDiffs = this.reconcileOutOfScopeDiffs(diffs, plan);
+    const violations = this.checkArchitectureViolations(reconciledDiffs, plan, architecture);
     if (violations.length > 0) {
       return {
         success: false,
-        diffs,
+        diffs: reconciledDiffs,
         usage: response.usage,
         qualityChecksPassed: false,
         errorMessage: `Architecture violations: ${violations.join(", ")}`,
@@ -4221,7 +4226,7 @@ var ExecutorAgent = class {
     }
     const originalContents = /* @__PURE__ */ new Map();
     try {
-      for (const diff of diffs) {
+      for (const diff of reconciledDiffs) {
         const fullPath = `${cwd}/${diff.path}`;
         if (existsSync6(fullPath)) {
           originalContents.set(diff.path, await readFile5(fullPath, "utf-8"));
@@ -4229,7 +4234,7 @@ var ExecutorAgent = class {
           originalContents.set(diff.path, null);
         }
       }
-      for (const diff of diffs) {
+      for (const diff of reconciledDiffs) {
         const fullPath = `${cwd}/${diff.path}`;
         if (diff.operation === "DELETE") {
           continue;
@@ -4242,10 +4247,10 @@ var ExecutorAgent = class {
       }
       const qualityChecksPassed = await this.runQualityChecks(cwd);
       if (!qualityChecksPassed) {
-        await this.rollback(cwd, originalContents, diffs);
+        await this.rollback(cwd, originalContents, reconciledDiffs);
         return {
           success: false,
-          diffs,
+          diffs: reconciledDiffs,
           usage: response.usage,
           qualityChecksPassed: false,
           errorMessage: "Quality checks failed - changes rolled back",
@@ -4254,16 +4259,16 @@ var ExecutorAgent = class {
       }
       return {
         success: true,
-        diffs,
+        diffs: reconciledDiffs,
         usage: response.usage,
         qualityChecksPassed: true,
         rollbackPerformed: false
       };
     } catch (error) {
-      await this.rollback(cwd, originalContents, diffs);
+      await this.rollback(cwd, originalContents, reconciledDiffs);
       return {
         success: false,
-        diffs,
+        diffs: reconciledDiffs,
         usage: response.usage,
         qualityChecksPassed: false,
         errorMessage: error instanceof Error ? error.message : "Unknown error",
@@ -4436,6 +4441,33 @@ var ExecutorAgent = class {
     const regexPattern = pattern.replace(/\*\*/g, ".*").replace(/\*/g, "[^/]*").replace(/\//g, "\\/");
     return new RegExp(`^${regexPattern}$`).test(path);
   }
+  reconcileOutOfScopeDiffs(diffs, plan) {
+    const allowedFiles = plan.files_to_modify;
+    if (allowedFiles.length !== 1 || diffs.length !== 1) {
+      return diffs;
+    }
+    const onlyAllowed = this.normalizePath(allowedFiles[0]);
+    const candidate = diffs[0];
+    if (!onlyAllowed || !candidate) {
+      return diffs;
+    }
+    const normalizedDiffPath = this.normalizePath(candidate.path);
+    if (normalizedDiffPath === onlyAllowed) {
+      return diffs;
+    }
+    const contentLike = /\.(md|markdown|txt)$/i.test(onlyAllowed) && /\.(md|markdown|txt)$/i.test(normalizedDiffPath);
+    const sameDir = dirname2(normalizedDiffPath) === dirname2(onlyAllowed);
+    if (!contentLike || !sameDir) {
+      return diffs;
+    }
+    return [{
+      ...candidate,
+      path: onlyAllowed
+    }];
+  }
+  normalizePath(path) {
+    return path.replace(/\\/g, "/").replace(/^\.?\//, "");
+  }
   /**
    * Run quality checks (typecheck, lint)
    */
@@ -4835,7 +4867,7 @@ async function attemptPathScopeAutoRecovery(atom, cwd, parseSchema, options) {
   if (allowedPaths.length === 0) {
     return false;
   }
-  const { listLocalAtoms, plan } = await import("./plan-V57SS7O6.js");
+  const { listLocalAtoms, plan } = await import("./plan-7YU2U4RY.js");
   const before = await listLocalAtoms();
   const recoveryStartedAt = Date.now();
   const recoverySource = atom.description ?? atom.title;
@@ -4903,13 +4935,18 @@ async function execute(atomId, options) {
     process.exit(1);
   };
   if (options.parallel && options.parallel.length > 0) {
-    const { parallelExecute } = await import("./parallel-WCUTC4FM.js");
+    const { parallelExecute } = await import("./parallel-HUAAE6PS.js");
     const allAtomIds = [atomId, ...options.parallel];
     await parallelExecute(allAtomIds, { skipGates: options.skipGates === true });
     return;
   }
   const prompt = createPrompt();
   const cwd = process.cwd();
+  const debugPath = getDebugLogPath();
+  if (debugPath) {
+    console.log(chalk2.dim(`Debug logging enabled: ${debugPath}`));
+  }
+  debugLog("execute", "start", "Execute command started", { atomId, options });
   try {
     if (options.cloud) {
       const config2 = await loadConfig();
@@ -5121,9 +5158,23 @@ ${conflictReport.blockerCount} blocking conflict(s) found.`));
       }
     }
     const executionResult = await executor.executeAtom(atom, atom.plan, parseResult.schema, cwd);
+    debugLog("execute", "result.received", "Executor returned execution result", {
+      success: executionResult.success,
+      rollbackPerformed: executionResult.rollbackPerformed,
+      diffPaths: executionResult.diffs.map((d) => d.path),
+      errorMessage: executionResult.errorMessage ?? null,
+      plannedFiles: atom.plan.files_to_modify
+    });
     const filesChanged = executionResult.diffs.map((d) => d.path);
     if (!executionResult.success) {
       if (isGovernanceViolation(executionResult.errorMessage)) {
+        debugLog("execute", "result.governance_violation", "Execution blocked by governance", {
+          atomId: atom.externalId,
+          errorMessage: executionResult.errorMessage ?? null,
+          diffPaths: executionResult.diffs.map((d) => d.path),
+          plannedFiles: atom.plan.files_to_modify,
+          violations: extractGovernanceViolations(executionResult.errorMessage)
+        });
         console.log(chalk2.yellow("\n\u26A0\uFE0F  Execution paused by governance guidance"));
         console.log(chalk2.dim("No changes were committed. Update the plan/path scope, then continue."));
         const violations = extractGovernanceViolations(executionResult.errorMessage);
@@ -5164,6 +5215,10 @@ ${conflictReport.blockerCount} blocking conflict(s) found.`));
       if (isGovernanceViolation(executionResult.errorMessage)) {
         const pathScopeViolation = isPathScopeGovernanceViolation(executionResult.errorMessage);
         if (pathScopeViolation && options.pathScopeAutoRecover !== false) {
+          debugLog("execute", "auto_recover.attempt", "Attempting path-scope auto recovery", {
+            atomId: atom.externalId,
+            autoRecoverDepth: options.autoRecoverDepth ?? 0
+          });
           const recovered = await attemptPathScopeAutoRecovery(
             atom,
             cwd,
@@ -5171,8 +5226,14 @@ ${conflictReport.blockerCount} blocking conflict(s) found.`));
             options
           );
           if (recovered) {
+            debugLog("execute", "auto_recover.success", "Path-scope auto recovery succeeded", {
+              atomId: atom.externalId
+            });
             return;
           }
+          debugLog("execute", "auto_recover.failed", "Path-scope auto recovery did not produce a replacement atom", {
+            atomId: atom.externalId
+          });
         }
         printExecuteNextActions(
           atom.externalId,

package/dist/{chunk-L3FRKAIO.js → chunk-K6A6CWUG.js}

@@ -6,7 +6,7 @@ import {
 import {
   listLocalAtoms,
   loadAtom
-} from "./chunk-R4A2C42M.js";
+} from "./chunk-QKHRSVUO.js";
 import {
   loadConfig
 } from "./chunk-SVU7MLG6.js";

package/dist/{chunk-SAM5CXO4.js → chunk-LM5UBTSS.js}

@@ -1,3 +1,7 @@
+import {
+  debugLog,
+  getDebugLogPath
+} from "./chunk-R664NEAA.js";
 import {
   createAuthedSupabaseClient
 } from "./chunk-Q3GIFHIQ.js";
@@ -1312,12 +1316,26 @@ function aggregateUsageRows(rows, start, end) {
   return { totalInputTokens, totalOutputTokens, totalCost, byModel };
 }
 async function showUsageDetails(options = {}) {
-  const { pauseForInput = false } = options;
+  const { pauseForInput = false, debug = false } = options;
   console.log(chalk.bold("\n-- Usage Details --\n"));
+  if (debug) {
+    const debugPath = getDebugLogPath();
+    if (debugPath) {
+      console.log(chalk.dim(`Debug logging enabled: ${debugPath}`));
+    } else {
+      console.log(chalk.dim("Tip: set ARCHON_DEBUG=1 to persist diagnostics to .archon/debug/*.log"));
+    }
+  }
   const spinner = ora("Loading usage data...").start();
   const config = await loadConfig();
   const authToken = getAuthToken(config);
   const authId = config.userId;
+  if (debug) {
+    debugLog("usage", "start", "Usage command started", {
+      authId: authId ?? null,
+      hasToken: !!authToken
+    });
+  }
   if (!authToken) {
     spinner.fail("Not logged in");
     return;
@@ -1327,6 +1345,11 @@ async function showUsageDetails(options = {}) {
     const response = await fetch(`${apiUrl}/api/usage`, {
       headers: { "Authorization": `Bearer ${authToken}` }
     });
+    if (debug) {
+      debugLog("usage", "api.response", "Received /api/usage response", {
+        status: response.status
+      });
+    }
     spinner.stop();
     if (!response.ok) {
       console.log(chalk.yellow("Unable to fetch usage data."));
@@ -1335,6 +1358,9 @@ async function showUsageDetails(options = {}) {
     const data = await response.json();
     if (data.tier === "BYOK") {
       const ids = await resolveAuthAndProfileIds(authToken, authId);
+      if (debug) {
+        debugLog("usage", "byok.identity", "Resolved auth/profile IDs for BYOK usage command", ids);
+      }
       if (!ids.authId || !ids.profileId) {
         console.log(chalk.yellow("Unable to resolve user ID for usage details."));
         return;
@@ -1342,6 +1368,14 @@ async function showUsageDetails(options = {}) {
       const now = /* @__PURE__ */ new Date();
       const yearStart = new Date(now.getFullYear(), 0, 1);
       const usageRows = await fetchUsageRows(authToken, ids.profileId, yearStart.toISOString(), now.toISOString());
+      if (debug) {
+        debugLog("usage", "byok.rows", "Fetched BYOK token usage rows", {
+          profileId: ids.profileId,
+          rowCount: usageRows?.length ?? 0,
+          start: yearStart.toISOString(),
+          end: now.toISOString()
+        });
+      }
       if (!usageRows) {
         console.log(chalk.yellow("Unable to fetch BYOK usage data."));
         return;
@@ -1412,6 +1446,9 @@ async function showUsageDetails(options = {}) {
       }
     }
   } catch {
+    if (debug) {
+      debugLog("usage", "error", "Usage command threw exception");
+    }
     spinner.stop();
     console.log(chalk.yellow("Error fetching usage data."));
   }

package/dist/{chunk-R4A2C42M.js → chunk-QKHRSVUO.js}

@@ -9,6 +9,9 @@ import {
   AnthropicClient,
   getDefaultModel
 } from "./chunk-F7R3QKHP.js";
+import {
+  debugLog
+} from "./chunk-R664NEAA.js";
 import {
   createAuthedSupabaseClient
 } from "./chunk-Q3GIFHIQ.js";
@@ -38,7 +41,7 @@ import {
 import chalk2 from "chalk";
 import { existsSync } from "fs";
 import { readFile, writeFile, mkdir, stat } from "fs/promises";
-import { join, dirname, basename, extname } from "path";
+import { join, dirname, basename, extname, isAbsolute, resolve, relative } from "path";
 import { createInterface } from "readline";
 
 // src/agents/sentinel.ts
@@ -851,14 +854,14 @@ function isUuid(value) {
 import chalk from "chalk";
 import readline from "readline";
 function prompt(question) {
-  return new Promise((resolve) => {
+  return new Promise((resolve2) => {
     const rl = readline.createInterface({
       input: process.stdin,
       output: process.stdout
     });
     rl.question(`${chalk.cyan("?")} ${question}: `, (answer) => {
       rl.close();
-      resolve(answer.trim());
+      resolve2(answer.trim());
     });
   });
 }
@@ -899,8 +902,8 @@ function createPrompt() {
     output: process.stdout
   });
   return {
-    ask: (question) => new Promise((resolve) => {
-      rl.question(question, resolve);
+    ask: (question) => new Promise((resolve2) => {
+      rl.question(question, resolve2);
     }),
     close: () => rl.close()
   };
@@ -930,7 +933,15 @@ async function plan(description, options) {
     }
     const requirements = extractNumberedRequirements(description);
     const references = extractReferencedFiles(description);
+    debugLog("plan", "references.extracted", "Referenced files extracted from prompt", {
+      references
+    });
     const { foundFiles, missingFiles, fileSummaries } = await loadReferencedFileSummaries(references);
+    debugLog("plan", "references.resolved", "Referenced files resolved on disk", {
+      foundFiles,
+      missingFiles,
+      summaryCount: fileSummaries.length
+    });
     if (references.length > 0) {
       console.log(chalk2.dim("\nReferenced inputs detected:"));
       for (const ref of references) {
@@ -1595,9 +1606,8 @@ function resolveContentOutputTargets(description, referencedFiles, deliverableTa
 }
 function deriveDefaultContentOutputPath(description, referencedFiles) {
   const sampleSuffix = /\b(sample|first lesson)\b/i.test(description) ? ".sample-capsule" : ".capsule";
-  const preferredRef = referencedFiles.find(
-    (ref) => /^(daily-exercises|curriculum|research)\//i.test(ref) && /\.(md|txt|markdown)$/i.test(ref)
-  );
+  const desiredDay = inferRequestedDay(description);
+  const preferredRef = pickPreferredReference(referencedFiles, desiredDay);
   const primaryRef = preferredRef ?? referencedFiles.find((ref) => /\.(md|txt|markdown)$/i.test(ref));
   if (!primaryRef) {
     return `daily-exercises/capsule-output${sampleSuffix}.md`;
@@ -1606,12 +1616,19 @@ function deriveDefaultContentOutputPath(description, referencedFiles) {
   const fileBase = basename(primaryRef, extname(primaryRef));
   const outName = `${fileBase}${sampleSuffix}.md`;
   const output = baseDir === "." ? `daily-exercises/${outName}` : join(baseDir, outName);
-  return output.replace(/\\/g, "/");
+  const normalizedOutput = output.replace(/\\/g, "/");
+  debugLog("plan", "outputs.derived", "Derived default content output path", {
+    desiredDay,
+    primaryRef,
+    output: normalizedOutput
+  });
+  return normalizedOutput;
 }
 function extractReferencedFiles(description) {
   const references = /* @__PURE__ */ new Set();
   const barePattern = /\b[\w./-]+\.(md|txt|json|yaml|yml|png|jpg|jpeg|gif|svg|pdf)\b/gi;
-  const quotedPattern = /"([^"]+\.(?:md|txt|json|yaml|yml|png|jpg|jpeg|gif|svg|pdf))"/gi;
+  const absolutePattern = /(?:^|[\s("'`])((?:\/[^"'`\s]+)+\.(?:md|txt|json|yaml|yml|png|jpg|jpeg|gif|svg|pdf))/gi;
+  const quotedPattern = /["']([^"']+\.(?:md|txt|json|yaml|yml|png|jpg|jpeg|gif|svg|pdf))["']/gi;
   let match;
   while ((match = quotedPattern.exec(description)) !== null) {
     if (match[1]) {
@@ -1623,6 +1640,11 @@ function extractReferencedFiles(description) {
       references.add(match[0].replace(/["'`,]/g, "").trim());
     }
   }
+  while ((match = absolutePattern.exec(description)) !== null) {
+    if (match[1]) {
+      references.add(match[1].replace(/["'`,]/g, "").trim());
+    }
+  }
   return Array.from(references).filter((ref) => ref.length > 0);
 }
 async function loadReferencedFileSummaries(references) {
@@ -1630,13 +1652,21 @@ async function loadReferencedFileSummaries(references) {
   const missingFiles = [];
   const fileSummaries = [];
   for (const ref of references) {
-    const normalized = ref.replace(/^\.?\//, "");
-    const absolute = join(process.cwd(), normalized);
+    const absolute = resolveReferencePath(process.cwd(), ref);
     if (!existsSync(absolute)) {
       missingFiles.push(ref);
+      debugLog("plan", "references.missing", "Referenced file missing on disk", {
+        ref,
+        absolute
+      });
       continue;
     }
     foundFiles.push(ref);
+    debugLog("plan", "references.found", "Referenced file found on disk", {
+      ref,
+      absolute,
+      relative: relative(process.cwd(), absolute).replace(/\\/g, "/")
+    });
     const isImage = /\.(png|jpg|jpeg|gif|svg)$/i.test(ref);
     if (isImage) {
       try {
@@ -1669,6 +1699,40 @@ async function loadReferencedFileSummaries(references) {
   }
   return { foundFiles, missingFiles, fileSummaries };
 }
+function resolveReferencePath(cwd, ref) {
+  const cleaned = ref.trim().replace(/^["']|["']$/g, "");
+  if (isAbsolute(cleaned)) {
+    return resolve(cleaned);
+  }
+  return resolve(cwd, cleaned.replace(/^\.?\//, ""));
+}
+function inferRequestedDay(description) {
+  if (/\bfirst lesson\b/i.test(description)) return 1;
+  const dayMatch = description.match(/\bday[\s_-]*0?(\d{1,2})\b/i);
+  if (!dayMatch?.[1]) return null;
+  const parsed = Number.parseInt(dayMatch[1], 10);
+  return Number.isFinite(parsed) ? parsed : null;
+}
+function pickPreferredReference(referencedFiles, desiredDay) {
+  const markdownRefs = referencedFiles.filter((ref) => /\.(md|txt|markdown)$/i.test(ref));
+  if (markdownRefs.length === 0) return void 0;
+  const prioritized = markdownRefs.slice().sort((a, b) => {
+    const aOld = /(^|\/)oldies(\/|$)/i.test(a) ? 1 : 0;
+    const bOld = /(^|\/)oldies(\/|$)/i.test(b) ? 1 : 0;
+    if (aOld !== bOld) return aOld - bOld;
+    const aCore = /^(daily-exercises|curriculum|research)\//i.test(a) ? 0 : 1;
+    const bCore = /^(daily-exercises|curriculum|research)\//i.test(b) ? 0 : 1;
+    return aCore - bCore;
+  });
+  if (desiredDay !== null) {
+    const matchByDay = prioritized.find((ref) => {
+      const dayPattern = new RegExp(`\\b(day|lesson|email[-_ ]day)[-_ ]?0*${desiredDay}\\b`, "i");
+      return dayPattern.test(ref);
+    });
+    if (matchByDay) return matchByDay;
+  }
+  return prioritized[0];
+}
 async function promptForDeliverableTarget(prompt2, requirements, references) {
   const mentionsResearch = requirements.some((req) => req.toLowerCase().includes("research"));
   const defaultTarget = references.find((ref) => ref.toLowerCase().endsWith(".md"));

package/dist/chunk-R664NEAA.js

@@ -0,0 +1,66 @@
+// src/cli/debug.ts
+import { appendFileSync, existsSync, mkdirSync } from "fs";
+import { join } from "path";
+function isDebugEnabled() {
+  const value = process.env["ARCHON_DEBUG"]?.trim().toLowerCase();
+  return value === "1" || value === "true" || value === "yes" || value === "on";
+}
+function createRunId() {
+  const now = /* @__PURE__ */ new Date();
+  const yyyy = String(now.getFullYear());
+  const mm = String(now.getMonth() + 1).padStart(2, "0");
+  const dd = String(now.getDate()).padStart(2, "0");
+  const hh = String(now.getHours()).padStart(2, "0");
+  const mi = String(now.getMinutes()).padStart(2, "0");
+  const ss = String(now.getSeconds()).padStart(2, "0");
+  return `${yyyy}${mm}${dd}-${hh}${mi}${ss}-${process.pid}`;
+}
+var RUN_ID = createRunId();
+var LOG_PATH = join(process.cwd(), ".archon", "debug", `${RUN_ID}.log`);
+function redactValue(value) {
+  if (typeof value === "string") {
+    if (value.length > 3e3) {
+      return `${value.slice(0, 3e3)}... [truncated]`;
+    }
+    return value;
+  }
+  if (Array.isArray(value)) {
+    return value.map(redactValue);
+  }
+  if (value && typeof value === "object") {
+    const out = {};
+    for (const [key, nested] of Object.entries(value)) {
+      if (/(token|secret|key|password|authorization|auth)/i.test(key)) {
+        out[key] = "[redacted]";
+        continue;
+      }
+      out[key] = redactValue(nested);
+    }
+    return out;
+  }
+  return value;
+}
+function getDebugLogPath() {
+  return isDebugEnabled() ? LOG_PATH : null;
+}
+function debugLog(scope, stage, message, data) {
+  if (!isDebugEnabled()) return;
+  const payload = {
+    ts: (/* @__PURE__ */ new Date()).toISOString(),
+    scope,
+    stage,
+    message,
+    data: redactValue(data)
+  };
+  const dir = join(process.cwd(), ".archon", "debug");
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+  appendFileSync(LOG_PATH, `${JSON.stringify(payload)}
+`);
+}
+
+export {
+  getDebugLogPath,
+  debugLog
+};

package/dist/{chunk-XHIVKDU5.js → chunk-TNS5OLCD.js}

@@ -1,6 +1,6 @@
 import {
   listLocalAtoms
-} from "./chunk-R4A2C42M.js";
+} from "./chunk-QKHRSVUO.js";
 
 // src/cli/list.ts
 import chalk from "chalk";

package/dist/{execute-HQ5XANCR.js → execute-4KDY6MOO.js}

@@ -1,11 +1,12 @@
 import {
   execute
-} from "./chunk-TG3ELXS3.js";
+} from "./chunk-ICPOD7FC.js";
 import "./chunk-EBHHIUCB.js";
-import "./chunk-R4A2C42M.js";
+import "./chunk-QKHRSVUO.js";
 import "./chunk-WGLVDEZC.js";
 import "./chunk-3MZOEZUH.js";
 import "./chunk-F7R3QKHP.js";
+import "./chunk-R664NEAA.js";
 import "./chunk-Q3GIFHIQ.js";
 import "./chunk-5EVHUDQX.js";
 import "./chunk-7C6JELBL.js";

package/dist/index.js

@@ -13,7 +13,7 @@ import {
 } from "./chunk-6URKZ7NB.js";
 import {
   show
-} from "./chunk-TZNB4BPI.js";
+} from "./chunk-DDAOREZF.js";
 import {
   bugReport
 } from "./chunk-AHK2ITJX.js";
@@ -38,7 +38,7 @@ import {
   showExecutionPreferences,
   showPreferences,
   showUsageDetails
-} from "./chunk-SAM5CXO4.js";
+} from "./chunk-LM5UBTSS.js";
 import {
   init,
   isInitialized
@@ -50,13 +50,13 @@ import {
   parallelRunWaves,
   parallelSchedule,
   parallelStatus
-} from "./chunk-L3FRKAIO.js";
+} from "./chunk-K6A6CWUG.js";
 import {
   DependencyParser,
   EnvironmentConfigLoader,
   EnvironmentValidator,
   execute
-} from "./chunk-TG3ELXS3.js";
+} from "./chunk-ICPOD7FC.js";
 import {
   cloudCancel,
   cloudLogs,
@@ -64,12 +64,12 @@ import {
 } from "./chunk-EBHHIUCB.js";
 import {
   list
-} from "./chunk-XHIVKDU5.js";
+} from "./chunk-TNS5OLCD.js";
 import {
   listLocalAtoms,
   loadAtom,
   plan
-} from "./chunk-R4A2C42M.js";
+} from "./chunk-QKHRSVUO.js";
 import "./chunk-WGLVDEZC.js";
 import "./chunk-3MZOEZUH.js";
 import {
@@ -77,6 +77,10 @@ import {
   ok,
   sleep
 } from "./chunk-F7R3QKHP.js";
+import {
+  debugLog,
+  getDebugLogPath
+} from "./chunk-R664NEAA.js";
 import {
   createAuthedSupabaseClient
 } from "./chunk-Q3GIFHIQ.js";
@@ -2714,6 +2718,11 @@ function uiSeparator() {
 }
 async function start(options = {}) {
   const cwd = process.cwd();
+  const debugPath = getDebugLogPath();
+  if (debugPath) {
+    console.log(chalk6.dim(`Debug logging enabled: ${debugPath}`));
+  }
+  debugLog("start", "session.begin", "Starting archon session", { cwd });
   displayBrandedHeader();
   const updateCheckPromise = startBackgroundUpdateCheck();
   let config = await loadConfig();
@@ -2844,13 +2853,40 @@ async function start(options = {}) {
   if (currentTier === "BYOK" && config.accessToken) {
     try {
       const resolvedAuthId = await resolveAuthIdFromToken(config.accessToken, config.userId);
+      debugLog("start", "byok_usage.identity", "Resolved auth/profile identity for BYOK startup usage", {
+        configUserId: config.userId ?? null,
+        resolvedAuthId
+      });
       let usageStats = await fetchByokUsageStats(config.accessToken);
       const apiLooksEmpty = !!usageStats && usageStats.totalInputTokens === 0 && usageStats.totalOutputTokens === 0 && usageStats.totalBaseCost === 0 && usageStats.byModel.length === 0;
+      debugLog("start", "byok_usage.api", "Fetched BYOK usage from /api/usage", {
+        usageStatsPresent: !!usageStats,
+        apiLooksEmpty,
+        totals: usageStats ? {
+          totalInputTokens: usageStats.totalInputTokens,
+          totalOutputTokens: usageStats.totalOutputTokens,
+          totalBaseCost: usageStats.totalBaseCost,
+          byModelCount: usageStats.byModel.length
+        } : null
+      });
       if (!usageStats || apiLooksEmpty && resolvedAuthId) {
         const supabaseStats = resolvedAuthId ? await fetchByokUsageStatsFromSupabase(config.accessToken, resolvedAuthId) : null;
         if (supabaseStats) {
           usageStats = supabaseStats;
         }
+        debugLog("start", "byok_usage.supabase_fallback", "Fetched BYOK usage from Supabase fallback", {
+          fallbackAttempted: !!resolvedAuthId,
+          fallbackReturned: !!supabaseStats,
+          totals: supabaseStats ? {
+            totalInputTokens: supabaseStats.totalInputTokens,
+            totalOutputTokens: supabaseStats.totalOutputTokens,
+            totalBaseCost: supabaseStats.totalBaseCost,
+            byModelCount: supabaseStats.byModel.length,
+            periodStart: supabaseStats.periodStart,
+            periodEnd: supabaseStats.periodEnd,
+            periodSource: supabaseStats.periodSource
+          } : null
+        });
       }
       const usageStatsUnavailable = !usageStats;
       if (!usageStats) {
@@ -2892,7 +2928,7 @@ async function start(options = {}) {
       }
       console.log(chalk6.dim(uiSeparator()));
       if (usageStatsUnavailable) {
-        console.log(chalk6.dim("Usage details may be delayed. Run `archon usage` to refresh."));
+        console.log(chalk6.dim("Usage details may be delayed. Run `archon usage --debug` to inspect identity/source windows."));
       }
       console.log(chalk6.dim("View details: archon usage  |  Models: archon preferences  |  Switch tier: archon upgrade"));
     } catch {
@@ -3078,6 +3114,9 @@ async function fetchByokUsageStats(accessToken) {
       }
     });
     if (!response.ok) {
+      debugLog("start", "byok_usage.api_error", "BYOK /api/usage returned non-OK status", {
+        status: response.status
+      });
       return null;
     }
     const data = await response.json();
@@ -3098,6 +3137,7 @@ async function fetchByokUsageStats(accessToken) {
       periodSource: data.periodSource
     };
   } catch {
+    debugLog("start", "byok_usage.api_exception", "BYOK /api/usage request threw exception");
     return null;
   }
 }
@@ -3108,12 +3148,21 @@ async function fetchByokUsageStatsFromSupabase(accessToken, authId) {
     const supabase = createAuthedSupabaseClient2(SUPABASE_URL2, SUPABASE_ANON_KEY2, accessToken);
     const profileId = await resolveProfileIdForUsage(supabase, authId);
     if (!profileId) {
+      debugLog("start", "byok_usage.profile_missing", "Could not resolve profile ID for BYOK Supabase fallback", {
+        authId
+      });
       return null;
     }
     const now = /* @__PURE__ */ new Date();
     const monthStart = new Date(now.getFullYear(), now.getMonth(), 1);
     const monthStats = await fetchByokUsageWindow(supabase, profileId, monthStart, now);
     if (hasAnyByokUsage(monthStats)) {
+      debugLog("start", "byok_usage.window", "Using month-to-date BYOK fallback window", {
+        profileId,
+        start: monthStart.toISOString(),
+        end: now.toISOString(),
+        totals: monthStats
+      });
       return {
         ...monthStats,
         periodStart: monthStart.toISOString(),
@@ -3123,6 +3172,12 @@ async function fetchByokUsageStatsFromSupabase(accessToken, authId) {
     }
     const trailingStart = new Date(now.getTime() - 30 * 24 * 60 * 60 * 1e3);
     const trailingStats = await fetchByokUsageWindow(supabase, profileId, trailingStart, now);
+    debugLog("start", "byok_usage.window", "Using trailing 30-day BYOK fallback window", {
+      profileId,
+      start: trailingStart.toISOString(),
+      end: now.toISOString(),
+      totals: trailingStats
+    });
     return {
       ...trailingStats,
       periodStart: trailingStart.toISOString(),
@@ -3130,6 +3185,7 @@ async function fetchByokUsageStatsFromSupabase(accessToken, authId) {
       periodSource: "profile_period"
     };
   } catch {
+    debugLog("start", "byok_usage.supabase_exception", "BYOK Supabase fallback threw exception");
     return null;
   }
 }
@@ -3419,7 +3475,7 @@ async function runExploreFlow(cwd, followUpInput, options = {}) {
     case "1": {
       const description = await promptWithCommands("Describe what you want to do", { allowMultiline: true });
       if (description.trim()) {
-        const { plan: plan2 } = await import("./plan-V57SS7O6.js");
+        const { plan: plan2 } = await import("./plan-7YU2U4RY.js");
         await plan2(description, { conversational: true });
       }
       await showMainMenu();
@@ -3664,7 +3720,7 @@ ${state.forbiddenPatterns?.length ? `- **Forbidden patterns:** ${state.forbidden
   const hintedTask = initialTaskHint?.trim() ?? "";
   if (hintedTask) {
     console.log(chalk6.dim("Using your request above as the first task.\n"));
-    const { plan: plan2 } = await import("./plan-V57SS7O6.js");
+    const { plan: plan2 } = await import("./plan-7YU2U4RY.js");
     await plan2(hintedTask, { conversational: true });
     return;
   }
@@ -3689,7 +3745,7 @@ ${state.forbiddenPatterns?.length ? `- **Forbidden patterns:** ${state.forbidden
     description = continueAnswer.trim();
   }
   if (description.trim()) {
-    const { plan: plan2 } = await import("./plan-V57SS7O6.js");
+    const { plan: plan2 } = await import("./plan-7YU2U4RY.js");
     await plan2(description, { conversational: true });
   }
 }
@@ -3918,7 +3974,7 @@ async function handleAgentConversationInput(cwd, input) {
     return true;
   }
   console.log(chalk6.dim("\n> Got it! Creating a task for this...\n"));
-  const { plan: plan2 } = await import("./plan-V57SS7O6.js");
+  const { plan: plan2 } = await import("./plan-7YU2U4RY.js");
   await plan2(await withAllowedPathScope(cwd, input), { conversational: true });
   if (shouldAutoExecuteAfterPlanning(input)) {
     await continueWithCurrentTask(cwd, { runAllReady: true });
@@ -3965,7 +4021,7 @@ async function showProposalForApproval(input) {
   }
 }
 async function showLatestPlannedAtom(cwd) {
-  const { listLocalAtoms: listLocalAtoms2 } = await import("./plan-V57SS7O6.js");
+  const { listLocalAtoms: listLocalAtoms2 } = await import("./plan-7YU2U4RY.js");
   const atoms = await listLocalAtoms2();
   if (atoms.length === 0) {
     console.log(chalk6.yellow("No atoms found yet. Tell me what to plan."));
@@ -3983,7 +4039,7 @@ async function showLatestPlannedAtom(cwd) {
   console.log(chalk6.dim(`
 Showing latest planned atom (${latest.externalId})...
 `));
-  const { show: show2 } = await import("./show-QDTDTY4P.js");
+  const { show: show2 } = await import("./show-VLTLYZDI.js");
   await show2(latest.externalId);
 }
 function isContinuationDirective(input) {
@@ -4116,7 +4172,7 @@ async function applyApprovedProposal(cwd) {
   console.log(chalk6.dim('\nReply "continue" when you want execution to start.'));
 }
 async function createTaskFromRequest(cwd, request) {
-  const { plan: plan2, listLocalAtoms: listLocalAtoms2 } = await import("./plan-V57SS7O6.js");
+  const { plan: plan2, listLocalAtoms: listLocalAtoms2 } = await import("./plan-7YU2U4RY.js");
   const before = await listLocalAtoms2();
   const beforeIds = new Set(before.map((atom) => atom.externalId));
   await plan2(await withAllowedPathScope(cwd, request), { conversational: true });
@@ -4292,13 +4348,13 @@ function buildSampleCapsuleDraft(cwd, files, capsuleCount) {
   ].join("\n");
 }
 async function continueWithCurrentTask(cwd, options = {}) {
-  const { listLocalAtoms: listLocalAtoms2 } = await import("./plan-V57SS7O6.js");
+  const { listLocalAtoms: listLocalAtoms2 } = await import("./plan-7YU2U4RY.js");
   const byMostRecent = (a, b) => {
     const aTime = new Date(String(a.updatedAt ?? a.createdAt ?? "")).getTime() || 0;
     const bTime = new Date(String(b.updatedAt ?? b.createdAt ?? "")).getTime() || 0;
     return bTime - aTime;
   };
-  const { execute: execute2 } = await import("./execute-HQ5XANCR.js");
+  const { execute: execute2 } = await import("./execute-4KDY6MOO.js");
   const runAllReady = options.runAllReady === true;
   const scopeIds = options.onlyAtomIds ? new Set(options.onlyAtomIds) : null;
   const attempted = /* @__PURE__ */ new Set();
@@ -4358,7 +4414,7 @@ Continuing with ${nextAtom.externalId}...
     }
     await execute2(nextAtom.externalId, {
       nonTerminating: true,
-      pathScopeAutoRecover: false
+      pathScopeAutoRecover: true
     });
     if (!runAllReady) {
       return;
@@ -4374,7 +4430,7 @@ Continuing with ${nextAtom.externalId}...
   }
 }
 async function replanLatestBlockedAtom(cwd) {
-  const { listLocalAtoms: listLocalAtoms2, plan: plan2 } = await import("./plan-V57SS7O6.js");
+  const { listLocalAtoms: listLocalAtoms2, plan: plan2 } = await import("./plan-7YU2U4RY.js");
   const atoms = await listLocalAtoms2();
   const blocked = atoms.filter((a) => a.status === "BLOCKED" && (a.errorMessage ?? "").toLowerCase().includes("outside the allowed paths")).sort((a, b) => {
     const aTime = new Date(String(a.updatedAt ?? a.createdAt ?? "")).getTime() || 0;
@@ -4488,7 +4544,7 @@ async function handleFreeformJourneyInput(cwd, input) {
     const state = detectProjectState(cwd);
     if (state.hasArchitecture) {
       console.log(chalk6.dim("\n> Got it! Creating a task for this...\n"));
-      const { plan: plan3 } = await import("./plan-V57SS7O6.js");
+      const { plan: plan3 } = await import("./plan-7YU2U4RY.js");
       await plan3(await withAllowedPathScope(cwd, freeform), { conversational: true });
       return true;
     }
@@ -4497,7 +4553,7 @@ async function handleFreeformJourneyInput(cwd, input) {
     return true;
   }
   console.log(chalk6.dim("\n> Got it! Creating a task for this...\n"));
-  const { plan: plan2 } = await import("./plan-V57SS7O6.js");
+  const { plan: plan2 } = await import("./plan-7YU2U4RY.js");
   await plan2(await withAllowedPathScope(cwd, freeform), { conversational: true });
   return true;
 }
@@ -4546,7 +4602,7 @@ function isFileLocationQuestion(input) {
   return true;
 }
 async function answerLatestOutputLocation(cwd) {
-  const { listLocalAtoms: listLocalAtoms2 } = await import("./plan-V57SS7O6.js");
+  const { listLocalAtoms: listLocalAtoms2 } = await import("./plan-7YU2U4RY.js");
   const atoms = await listLocalAtoms2();
   const latestDone = atoms.filter((atom) => atom.status === "DONE").sort((a, b) => {
     const aTime = new Date(String(a.updatedAt ?? a.createdAt ?? "")).getTime() || 0;
@@ -4595,7 +4651,7 @@ async function handlePostExploreAction(cwd, request, options = {}) {
   } else {
     console.log(chalk6.dim("> Got it! Creating a task for this...\n"));
   }
-  const { plan: plan2 } = await import("./plan-V57SS7O6.js");
+  const { plan: plan2 } = await import("./plan-7YU2U4RY.js");
   await plan2(await withAllowedPathScope(cwd, request), { conversational: true });
   if (options.agentMode) {
     if (shouldAutoExecuteAfterPlanning(sourceInput)) {
@@ -4619,20 +4675,20 @@ Constraints:
 - If required files are outside this scope, propose the minimum architecture path update first.`;
 }
 async function planTask() {
-  const { plan: plan2 } = await import("./plan-V57SS7O6.js");
+  const { plan: plan2 } = await import("./plan-7YU2U4RY.js");
   const description = await promptWithCommands("Describe what you want to build", { allowMultiline: true });
   if (description.trim()) {
     await plan2(description, { conversational: true });
   }
 }
 async function listAtoms() {
-  const { list: list2 } = await import("./list-QKB55FIY.js");
+  const { list: list2 } = await import("./list-D4THOSHG.js");
   await list2({});
 }
 async function executeNext() {
-  const { listLocalAtoms: listLocalAtoms2 } = await import("./plan-V57SS7O6.js");
+  const { listLocalAtoms: listLocalAtoms2 } = await import("./plan-7YU2U4RY.js");
   const { analyzeProject, getComplexityDescription, getModeDescription } = await import("./orchestration-HIF3KP25.js");
-  const { loadExecutionPreferences } = await import("./preferences-MTGN2VZK.js");
+  const { loadExecutionPreferences } = await import("./preferences-QTPQLCXN.js");
   const cwd = process.cwd();
   const atoms = await listLocalAtoms2();
   const pendingAtoms = atoms.filter((a) => a.status === "READY" || a.status === "IN_PROGRESS");
@@ -4701,11 +4757,11 @@ async function executeNext() {
         }
       }
       if (selectedMode === "parallel-cloud") {
-        const { parallelExecuteCloud: parallelExecuteCloud2 } = await import("./parallel-WCUTC4FM.js");
+        const { parallelExecuteCloud: parallelExecuteCloud2 } = await import("./parallel-HUAAE6PS.js");
         await parallelExecuteCloud2(runIds);
         return;
       }
-      const { parallelExecute } = await import("./parallel-WCUTC4FM.js");
+      const { parallelExecute } = await import("./parallel-HUAAE6PS.js");
       await parallelExecute(runIds);
       return;
     }
@@ -4713,7 +4769,7 @@ async function executeNext() {
   const atomId = await prompt("Enter atom ID to execute (or press Enter for first pending)");
   const targetId = atomId.trim() || pendingAtoms[0]?.id;
   if (targetId) {
-    const { execute: execute2 } = await import("./execute-HQ5XANCR.js");
+    const { execute: execute2 } = await import("./execute-4KDY6MOO.js");
     await execute2(targetId, {});
   } else {
     console.log(chalk6.yellow("No atom to execute."));
@@ -4731,7 +4787,7 @@ async function viewStatus() {
   await status2();
 }
 async function settingsMenu() {
-  const { interactiveSettings } = await import("./preferences-MTGN2VZK.js");
+  const { interactiveSettings } = await import("./preferences-QTPQLCXN.js");
   await interactiveSettings();
 }
 async function reviewCode() {
@@ -4862,7 +4918,7 @@ async function handleSlashCommand(input) {
   const arg = parts.slice(1).join(" ").trim();
   switch (command) {
     case "/plan": {
-      const { plan: plan2 } = await import("./plan-V57SS7O6.js");
+      const { plan: plan2 } = await import("./plan-7YU2U4RY.js");
       if (arg) {
         await plan2(arg, { conversational: true });
       } else {
@@ -9249,8 +9305,8 @@ creditsCommand.command("audit").description("Show billing audit log (immutable r
 creditsCommand.action(async () => {
   await showCredits();
 });
-program.command("usage").description("Show usage by period and model").action(async () => {
-  await showUsageDetails();
+program.command("usage").description("Show usage by period and model").option("--debug", "Show usage diagnostics (identity/window/source details)").action(async (options) => {
+  await showUsageDetails({ debug: options.debug === true });
 });
 var preferencesCommand = program.command("preferences").description("Manage default model preferences");
 preferencesCommand.command("set <key> <model>").description("Set a model preference (fast-model, thinking-model, primary-adversarial, secondary-adversarial)").action(async (key, model) => {

package/dist/{list-QKB55FIY.js → list-D4THOSHG.js}

@@ -1,10 +1,11 @@
 import {
   list
-} from "./chunk-XHIVKDU5.js";
-import "./chunk-R4A2C42M.js";
+} from "./chunk-TNS5OLCD.js";
+import "./chunk-QKHRSVUO.js";
 import "./chunk-WGLVDEZC.js";
 import "./chunk-3MZOEZUH.js";
 import "./chunk-F7R3QKHP.js";
+import "./chunk-R664NEAA.js";
 import "./chunk-Q3GIFHIQ.js";
 import "./chunk-5EVHUDQX.js";
 import "./chunk-7C6JELBL.js";

package/dist/{parallel-WCUTC4FM.js → parallel-HUAAE6PS.js}

@@ -6,12 +6,13 @@ import {
   parallelRunWaves,
   parallelSchedule,
   parallelStatus
-} from "./chunk-L3FRKAIO.js";
+} from "./chunk-K6A6CWUG.js";
 import "./chunk-EBHHIUCB.js";
-import "./chunk-R4A2C42M.js";
+import "./chunk-QKHRSVUO.js";
 import "./chunk-WGLVDEZC.js";
 import "./chunk-3MZOEZUH.js";
 import "./chunk-F7R3QKHP.js";
+import "./chunk-R664NEAA.js";
 import "./chunk-Q3GIFHIQ.js";
 import "./chunk-5EVHUDQX.js";
 import "./chunk-7C6JELBL.js";

package/dist/{plan-V57SS7O6.js → plan-7YU2U4RY.js}

@@ -3,10 +3,11 @@ import {
   loadAtom,
   parseAtomDescription,
   plan
-} from "./chunk-R4A2C42M.js";
+} from "./chunk-QKHRSVUO.js";
 import "./chunk-WGLVDEZC.js";
 import "./chunk-3MZOEZUH.js";
 import "./chunk-F7R3QKHP.js";
+import "./chunk-R664NEAA.js";
 import "./chunk-Q3GIFHIQ.js";
 import "./chunk-5EVHUDQX.js";
 import "./chunk-7C6JELBL.js";

package/dist/{preferences-MTGN2VZK.js → preferences-QTPQLCXN.js}

@@ -9,7 +9,8 @@ import {
   showExecutionPreferences,
   showPreferences,
   showUsageDetails
-} from "./chunk-SAM5CXO4.js";
+} from "./chunk-LM5UBTSS.js";
+import "./chunk-R664NEAA.js";
 import "./chunk-Q3GIFHIQ.js";
 import "./chunk-7C6JELBL.js";
 import "./chunk-TFSHS7EN.js";

package/dist/{show-QDTDTY4P.js → show-VLTLYZDI.js}

@@ -1,10 +1,11 @@
 import {
   show
-} from "./chunk-TZNB4BPI.js";
-import "./chunk-R4A2C42M.js";
+} from "./chunk-DDAOREZF.js";
+import "./chunk-QKHRSVUO.js";
 import "./chunk-WGLVDEZC.js";
 import "./chunk-3MZOEZUH.js";
 import "./chunk-F7R3QKHP.js";
+import "./chunk-R664NEAA.js";
 import "./chunk-Q3GIFHIQ.js";
 import "./chunk-5EVHUDQX.js";
 import "./chunk-7C6JELBL.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "archondev",
-  "version": "2.19.54",
+  "version": "2.19.55",
   "description": "Local-first AI-powered development governance system",
   "main": "dist/index.js",
   "bin": {