qodewk 0.9.2 → 0.10.0

package/dist/index.cjs

@@ -1157,8 +1157,8 @@ var require_command = __commonJS({
     "use strict";
     var EventEmitter2 = require("events").EventEmitter;
     var childProcess = require("child_process");
-    var path16 = require("path");
-    var fs15 = require("fs");
+    var path17 = require("path");
+    var fs16 = require("fs");
     var process3 = require("process");
     var { Argument: Argument2, humanReadableArgName } = require_argument();
     var { CommanderError: CommanderError2 } = require_error();
@@ -2139,7 +2139,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} subcommandName
        */
       _checkForMissingExecutable(executableFile, executableDir, subcommandName) {
-        if (fs15.existsSync(executableFile)) return;
+        if (fs16.existsSync(executableFile)) return;
         const executableDirMessage = executableDir ? `searched for local subcommand relative to directory '${executableDir}'` : "no directory for search for local subcommand, use .executableDir() to supply a custom directory";
         const executableMissing = `'${executableFile}' does not exist
  - if '${subcommandName}' is not meant to be an executable command, remove description parameter from '.command()' and use '.description()' instead
@@ -2157,11 +2157,11 @@ Expecting one of '${allowedValues.join("', '")}'`);
         let launchWithNode = false;
         const sourceExt = [".js", ".ts", ".tsx", ".mjs", ".cjs"];
         function findFile(baseDir, baseName) {
-          const localBin = path16.resolve(baseDir, baseName);
-          if (fs15.existsSync(localBin)) return localBin;
-          if (sourceExt.includes(path16.extname(baseName))) return void 0;
+          const localBin = path17.resolve(baseDir, baseName);
+          if (fs16.existsSync(localBin)) return localBin;
+          if (sourceExt.includes(path17.extname(baseName))) return void 0;
           const foundExt = sourceExt.find(
-            (ext) => fs15.existsSync(`${localBin}${ext}`)
+            (ext) => fs16.existsSync(`${localBin}${ext}`)
           );
           if (foundExt) return `${localBin}${foundExt}`;
           return void 0;
@@ -2173,21 +2173,21 @@ Expecting one of '${allowedValues.join("', '")}'`);
         if (this._scriptPath) {
           let resolvedScriptPath;
           try {
-            resolvedScriptPath = fs15.realpathSync(this._scriptPath);
+            resolvedScriptPath = fs16.realpathSync(this._scriptPath);
           } catch {
             resolvedScriptPath = this._scriptPath;
           }
-          executableDir = path16.resolve(
-            path16.dirname(resolvedScriptPath),
+          executableDir = path17.resolve(
+            path17.dirname(resolvedScriptPath),
             executableDir
           );
         }
         if (executableDir) {
           let localFile = findFile(executableDir, executableFile);
           if (!localFile && !subcommand._executableFile && this._scriptPath) {
-            const legacyName = path16.basename(
+            const legacyName = path17.basename(
               this._scriptPath,
-              path16.extname(this._scriptPath)
+              path17.extname(this._scriptPath)
             );
             if (legacyName !== this._name) {
               localFile = findFile(
@@ -2198,7 +2198,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
           }
           executableFile = localFile || executableFile;
         }
-        launchWithNode = sourceExt.includes(path16.extname(executableFile));
+        launchWithNode = sourceExt.includes(path17.extname(executableFile));
         let proc;
         if (process3.platform !== "win32") {
           if (launchWithNode) {
@@ -3045,7 +3045,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @return {Command}
        */
       nameFromFilename(filename) {
-        this._name = path16.basename(filename, path16.extname(filename));
+        this._name = path17.basename(filename, path17.extname(filename));
         return this;
       }
       /**
@@ -3059,9 +3059,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} [path]
        * @return {(string|null|Command)}
        */
-      executableDir(path17) {
-        if (path17 === void 0) return this._executableDir;
-        this._executableDir = path17;
+      executableDir(path18) {
+        if (path18 === void 0) return this._executableDir;
+        this._executableDir = path18;
         return this;
       }
       /**
@@ -4207,10 +4207,10 @@ var require_src2 = __commonJS({
     var fs_1 = require("fs");
     var debug_1 = __importDefault(require_src());
     var log = debug_1.default("@kwsites/file-exists");
-    function check(path16, isFile, isDirectory) {
-      log(`checking %s`, path16);
+    function check(path17, isFile, isDirectory) {
+      log(`checking %s`, path17);
       try {
-        const stat = fs_1.statSync(path16);
+        const stat = fs_1.statSync(path17);
         if (stat.isFile() && isFile) {
           log(`[OK] path represents a file`);
           return true;
@@ -4230,8 +4230,8 @@ var require_src2 = __commonJS({
         throw e;
       }
     }
-    function exists2(path16, type = exports2.READABLE) {
-      return check(path16, (type & exports2.FILE) > 0, (type & exports2.FOLDER) > 0);
+    function exists2(path17, type = exports2.READABLE) {
+      return check(path17, (type & exports2.FILE) > 0, (type & exports2.FOLDER) > 0);
     }
     exports2.exists = exists2;
     exports2.FILE = 1;
@@ -4842,8 +4842,8 @@ function toLinesWithContent(input = "", trimmed2 = true, separator = "\n") {
 function forEachLineWithContent(input, callback) {
   return toLinesWithContent(input, true).map((line) => callback(line));
 }
-function folderExists(path16) {
-  return (0, import_file_exists.exists)(path16, import_file_exists.FOLDER);
+function folderExists(path17) {
+  return (0, import_file_exists.exists)(path17, import_file_exists.FOLDER);
 }
 function append(target, item) {
   if (Array.isArray(target)) {
@@ -5034,8 +5034,8 @@ function checkIsRepoRootTask() {
     commands,
     format: "utf-8",
     onError,
-    parser(path16) {
-      return /^\.(git)?$/.test(path16.trim());
+    parser(path17) {
+      return /^\.(git)?$/.test(path17.trim());
     }
   };
 }
@@ -5291,11 +5291,11 @@ function parseGrep(grep) {
   const paths = /* @__PURE__ */ new Set();
   const results = {};
   forEachLineWithContent(grep, (input) => {
-    const [path16, line, preview] = input.split(NULL);
-    paths.add(path16);
-    (results[path16] = results[path16] || []).push({
+    const [path17, line, preview] = input.split(NULL);
+    paths.add(path17);
+    (results[path17] = results[path17] || []).push({
       line: asNumber(line),
-      path: path16,
+      path: path17,
       preview
     });
   });
@@ -5592,14 +5592,14 @@ function hashObjectTask(filePath, write) {
   }
   return straightThroughStringTask(commands, true);
 }
-function parseInit(bare, path16, text) {
+function parseInit(bare, path17, text) {
   const response = String(text).trim();
   let result;
   if (result = initResponseRegex.exec(response)) {
-    return new InitSummary(bare, path16, false, result[1]);
+    return new InitSummary(bare, path17, false, result[1]);
   }
   if (result = reInitResponseRegex.exec(response)) {
-    return new InitSummary(bare, path16, true, result[1]);
+    return new InitSummary(bare, path17, true, result[1]);
   }
   let gitDir = "";
   const tokens = response.split(" ");
@@ -5610,12 +5610,12 @@ function parseInit(bare, path16, text) {
       break;
     }
   }
-  return new InitSummary(bare, path16, /^re/i.test(response), gitDir);
+  return new InitSummary(bare, path17, /^re/i.test(response), gitDir);
 }
 function hasBareCommand(command) {
   return command.includes(bareCommand);
 }
-function initTask(bare = false, path16, customArgs) {
+function initTask(bare = false, path17, customArgs) {
   const commands = ["init", ...customArgs];
   if (bare && !hasBareCommand(commands)) {
     commands.splice(1, 0, bareCommand);
@@ -5624,7 +5624,7 @@ function initTask(bare = false, path16, customArgs) {
     commands,
     format: "utf-8",
     parser(text) {
-      return parseInit(commands.includes("--bare"), path16, text);
+      return parseInit(commands.includes("--bare"), path17, text);
     }
   };
 }
@@ -5903,14 +5903,14 @@ function splitLine(result, lineStr) {
     default:
       return;
   }
-  function data(index, workingDir, path16) {
+  function data(index, workingDir, path17) {
     const raw = `${index}${workingDir}`;
     const handler = parsers6.get(raw);
     if (handler) {
-      handler(result, path16);
+      handler(result, path17);
     }
     if (raw !== "##" && raw !== "!!") {
-      result.files.push(new FileStatusSummary(path16, index, workingDir));
+      result.files.push(new FileStatusSummary(path17, index, workingDir));
     }
   }
 }
@@ -6097,8 +6097,8 @@ function deleteBranchTask(branch, forceDelete = false) {
   return task;
 }
 function toPath(input) {
-  const path16 = input.trim().replace(/^["']|["']$/g, "");
-  return path16 && (0, import_node_path.normalize)(path16);
+  const path17 = input.trim().replace(/^["']|["']$/g, "");
+  return path17 && (0, import_node_path.normalize)(path17);
 }
 function checkIgnoreTask(paths) {
   return {
@@ -6237,8 +6237,8 @@ function stashListTask(opt = {}, customArgs) {
     parser: parser4
   };
 }
-function addSubModuleTask(repo, path16) {
-  return subModuleTask(["add", repo, path16]);
+function addSubModuleTask(repo, path17) {
+  return subModuleTask(["add", repo, path17]);
 }
 function initSubModuleTask(customArgs) {
   return subModuleTask(["init", ...customArgs]);
@@ -6646,12 +6646,12 @@ function gitP(...args) {
         );
       }
       return chain.then(function() {
-        return new Promise(function(resolve5, reject) {
+        return new Promise(function(resolve6, reject) {
           const callback = (err, result) => {
             if (err) {
               return reject(toError(err));
             }
-            resolve5(result);
+            resolve6(result);
           };
           args2.push(callback);
           git2[fn].apply(git2, args2);
@@ -7570,9 +7570,9 @@ var init_esm = __esm({
       "src/lib/responses/InitSummary.ts"() {
         "use strict";
         InitSummary = class {
-          constructor(bare, path16, existing, gitDir) {
+          constructor(bare, path17, existing, gitDir) {
             this.bare = bare;
-            this.path = path16;
+            this.path = path17;
             this.existing = existing;
             this.gitDir = gitDir;
           }
@@ -8105,12 +8105,12 @@ var init_esm = __esm({
         "use strict";
         fromPathRegex = /^(.+)\0(.+)$/;
         FileStatusSummary = class {
-          constructor(path16, index, working_dir) {
-            this.path = path16;
+          constructor(path17, index, working_dir) {
+            this.path = path17;
             this.index = index;
             this.working_dir = working_dir;
             if (index === "R" || working_dir === "R") {
-              const detail = fromPathRegex.exec(path16) || [null, path16, path16];
+              const detail = fromPathRegex.exec(path17) || [null, path17, path17];
               this.from = detail[2] || "";
               this.path = detail[1] || "";
             }
@@ -8372,9 +8372,9 @@ var init_esm = __esm({
               next
             );
           }
-          hashObject(path16, write) {
+          hashObject(path17, write) {
             return this._runTask(
-              hashObjectTask(path16, write === true),
+              hashObjectTask(path17, write === true),
               trailingFunctionArgument(arguments)
             );
           }
@@ -9011,8 +9011,8 @@ var init_esm = __esm({
           }
           return this._runTask(straightThroughStringTask2(command, this._trimmed), next);
         };
-        Git2.prototype.submoduleAdd = function(repo, path16, then) {
-          return this._runTask(addSubModuleTask2(repo, path16), trailingFunctionArgument2(arguments));
+        Git2.prototype.submoduleAdd = function(repo, path17, then) {
+          return this._runTask(addSubModuleTask2(repo, path17), trailingFunctionArgument2(arguments));
         };
         Git2.prototype.submoduleUpdate = function(args, then) {
           return this._runTask(
@@ -9318,8 +9318,8 @@ var init_esm = __esm({
 });
 
 // src/index.ts
-var fs14 = __toESM(require("fs"), 1);
-var path15 = __toESM(require("path"), 1);
+var fs15 = __toESM(require("fs"), 1);
+var path16 = __toESM(require("path"), 1);
 
 // ../../node_modules/.pnpm/commander@13.1.0/node_modules/commander/esm.mjs
 var import_index = __toESM(require_commander(), 1);
@@ -9339,7 +9339,7 @@ var {
 } = import_index.default;
 
 // src/index.ts
-var import_picocolors3 = __toESM(require_picocolors(), 1);
+var import_picocolors4 = __toESM(require_picocolors(), 1);
 
 // ../core/dist/index.js
 var crypto2 = __toESM(require("crypto"), 1);
@@ -9822,8 +9822,8 @@ function getErrorMap() {
 
 // ../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/helpers/parseUtil.js
 var makeIssue = (params) => {
-  const { data, path: path16, errorMaps, issueData } = params;
-  const fullPath = [...path16, ...issueData.path || []];
+  const { data, path: path17, errorMaps, issueData } = params;
+  const fullPath = [...path17, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -9939,11 +9939,11 @@ var errorUtil;
 
 // ../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value, path16, key) {
+  constructor(parent, value, path17, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path16;
+    this._path = path17;
     this._key = key;
   }
   get path() {
@@ -14496,8 +14496,8 @@ function harvestAntigravityFootprints(repoPath, sinceDate) {
   const DatabaseSync2 = getSqliteDatabase();
   if (!DatabaseSync2)
     return footprints;
-  const homedir11 = os3.homedir();
-  const antigravityDir = process.env.ANTIGRAVITY_APP_DATA_DIR || path3.join(homedir11, ".gemini", "antigravity");
+  const homedir12 = os3.homedir();
+  const antigravityDir = process.env.ANTIGRAVITY_APP_DATA_DIR || path3.join(homedir12, ".gemini", "antigravity");
   const dbPath = path3.join(antigravityDir, "conversation_summaries.db");
   if (!fs2.existsSync(dbPath)) {
     return footprints;
@@ -14599,8 +14599,8 @@ var path4 = __toESM(require("path"), 1);
 var os4 = __toESM(require("os"), 1);
 function harvestClaudeFootprints(repoPath, projectAlias, sinceDate) {
   const footprints = [];
-  const homedir11 = os4.homedir();
-  const claudeProjectsDir = path4.join(homedir11, ".claude", "projects");
+  const homedir12 = os4.homedir();
+  const claudeProjectsDir = path4.join(homedir12, ".claude", "projects");
   if (!fs3.existsSync(claudeProjectsDir)) {
     return footprints;
   }
@@ -15175,9 +15175,9 @@ function resolveClineStorageDirs(customDir) {
   if (process.env.ROO_STORAGE_DIR && fs7.existsSync(process.env.ROO_STORAGE_DIR)) {
     dirs.push(process.env.ROO_STORAGE_DIR);
   }
-  const homedir11 = os7.homedir();
+  const homedir12 = os7.homedir();
   if (process.platform === "win32") {
-    const appData = process.env.APPDATA || path8.join(homedir11, "AppData", "Roaming");
+    const appData = process.env.APPDATA || path8.join(homedir12, "AppData", "Roaming");
     const ideRoots = ["Code", "Code - Insiders", "Cursor", "Windsurf"];
     const extensionIds = [
       "saoudrizwan.claude-dev",
@@ -15191,7 +15191,7 @@ function resolveClineStorageDirs(customDir) {
       }
     }
   } else if (process.platform === "darwin") {
-    const appSupport = path8.join(homedir11, "Library", "Application Support");
+    const appSupport = path8.join(homedir12, "Library", "Application Support");
     const ideRoots = ["Code", "Code - Insiders", "Cursor", "Windsurf"];
     const extensionIds = [
       "saoudrizwan.claude-dev",
@@ -15205,7 +15205,7 @@ function resolveClineStorageDirs(customDir) {
       }
     }
   } else {
-    const configRoot = process.env.XDG_CONFIG_HOME || path8.join(homedir11, ".config");
+    const configRoot = process.env.XDG_CONFIG_HOME || path8.join(homedir12, ".config");
     const ideRoots = ["Code", "Code - Insiders", "Cursor", "Windsurf"];
     const extensionIds = [
       "saoudrizwan.claude-dev",
@@ -16063,6 +16063,289 @@ function formatMarkdownReceipt(receipt, publicUrl) {
   return lines.join("\n");
 }
 
+// ../core/dist/doctor.js
+var fs12 = __toESM(require("fs"), 1);
+var path13 = __toESM(require("path"), 1);
+var os12 = __toESM(require("os"), 1);
+var import_node_child_process = require("child_process");
+var HOOK_MARKER_BEGIN = "# --- BEGIN QODEWK HOOK ---";
+function auditAgentEnvironments(repoPath = process.cwd()) {
+  const homedir12 = os12.homedir();
+  const results = [];
+  const agEnv = process.env.ANTIGRAVITY_APP_DATA_DIR;
+  const agHome = path13.join(homedir12, ".gemini", "antigravity");
+  const agPath = agEnv && fs12.existsSync(agEnv) ? agEnv : fs12.existsSync(agHome) ? agHome : void 0;
+  results.push({
+    id: "antigravity",
+    name: "Google Antigravity",
+    status: agPath ? "active" : "not_detected",
+    path: agPath,
+    details: agPath ? "Antigravity brain telemetry detected" : "No active session brain found"
+  });
+  const claudeProjects = path13.join(homedir12, ".claude", "projects");
+  const claudeExists = fs12.existsSync(claudeProjects);
+  results.push({
+    id: "claude",
+    name: "Claude Code CLI",
+    status: claudeExists ? "active" : "not_detected",
+    path: claudeExists ? claudeProjects : void 0,
+    details: claudeExists ? "Claude project session directory found" : "No ~/.claude/projects directory found"
+  });
+  let cursorPath;
+  if (process.platform === "win32") {
+    const c3 = path13.join(process.env.APPDATA || path13.join(homedir12, "AppData", "Roaming"), "Cursor", "User", "workspaceStorage");
+    if (fs12.existsSync(c3))
+      cursorPath = c3;
+  } else if (process.platform === "darwin") {
+    const c3 = path13.join(homedir12, "Library", "Application Support", "Cursor", "User", "workspaceStorage");
+    if (fs12.existsSync(c3))
+      cursorPath = c3;
+  } else {
+    const c3 = path13.join(homedir12, ".config", "Cursor", "User", "workspaceStorage");
+    if (fs12.existsSync(c3))
+      cursorPath = c3;
+  }
+  results.push({
+    id: "cursor",
+    name: "Cursor IDE",
+    status: cursorPath ? "active" : "not_detected",
+    path: cursorPath,
+    details: cursorPath ? "Cursor workspace storage detected" : "Cursor IDE storage not detected"
+  });
+  let windsurfPath;
+  if (process.platform === "win32") {
+    const w = path13.join(process.env.APPDATA || path13.join(homedir12, "AppData", "Roaming"), "Windsurf", "User", "workspaceStorage");
+    if (fs12.existsSync(w))
+      windsurfPath = w;
+  } else if (process.platform === "darwin") {
+    const w = path13.join(homedir12, "Library", "Application Support", "Windsurf", "User", "workspaceStorage");
+    if (fs12.existsSync(w))
+      windsurfPath = w;
+  } else {
+    const w = path13.join(homedir12, ".config", "Windsurf", "User", "workspaceStorage");
+    if (fs12.existsSync(w))
+      windsurfPath = w;
+  }
+  results.push({
+    id: "windsurf",
+    name: "Windsurf IDE",
+    status: windsurfPath ? "active" : "not_detected",
+    path: windsurfPath,
+    details: windsurfPath ? "Cascade session workspace storage detected" : "Windsurf IDE storage not detected"
+  });
+  let clinePath;
+  const localCline = path13.join(repoPath, ".cline");
+  const localRoo = path13.join(repoPath, ".roo");
+  if (fs12.existsSync(localCline)) {
+    clinePath = localCline;
+  } else if (fs12.existsSync(localRoo)) {
+    clinePath = localRoo;
+  } else {
+    const appData = process.platform === "win32" ? process.env.APPDATA || path13.join(homedir12, "AppData", "Roaming") : process.platform === "darwin" ? path13.join(homedir12, "Library", "Application Support") : path13.join(homedir12, ".config");
+    const clineExt = path13.join(appData, "Code", "User", "globalStorage", "saoudrizwan.claude-dev", "tasks");
+    const rooExt = path13.join(appData, "Code", "User", "globalStorage", "rooveterinaryinc.roo-cline", "tasks");
+    if (fs12.existsSync(clineExt))
+      clinePath = clineExt;
+    else if (fs12.existsSync(rooExt))
+      clinePath = rooExt;
+  }
+  results.push({
+    id: "cline",
+    name: "Cline / Roo Code",
+    status: clinePath ? "active" : "not_detected",
+    path: clinePath,
+    details: clinePath ? "VS Code autonomous agent task storage detected" : "No active Cline or Roo Code tasks found"
+  });
+  const aiderPath = path13.join(repoPath, ".aider.chat.history.md");
+  const aiderExists = fs12.existsSync(aiderPath);
+  results.push({
+    id: "aider",
+    name: "Aider CLI",
+    status: aiderExists ? "active" : "not_detected",
+    path: aiderExists ? aiderPath : void 0,
+    details: aiderExists ? "Repository pairing transcript found" : "No repo-local .aider.chat.history.md found"
+  });
+  const localOpenCode = path13.join(repoPath, ".opencode");
+  const homeOpenCode = path13.join(homedir12, ".opencode", "sessions");
+  const opencodePath = fs12.existsSync(localOpenCode) ? localOpenCode : fs12.existsSync(homeOpenCode) ? homeOpenCode : void 0;
+  results.push({
+    id: "opencode",
+    name: "OpenCode CLI",
+    status: opencodePath ? "active" : "not_detected",
+    path: opencodePath,
+    details: opencodePath ? "OpenCode session history detected" : "No OpenCode session files found"
+  });
+  return results;
+}
+function resolveHooksDir(cwd = process.cwd()) {
+  const gitPath = path13.join(cwd, ".git");
+  if (!fs12.existsSync(gitPath))
+    return null;
+  try {
+    const stat = fs12.statSync(gitPath);
+    if (stat.isDirectory()) {
+      return path13.join(gitPath, "hooks");
+    }
+    const content = fs12.readFileSync(gitPath, "utf-8");
+    const match = content.match(/gitdir:\s*(.+)/i);
+    if (!match?.[1])
+      return null;
+    let gitDir = match[1].trim();
+    if (!path13.isAbsolute(gitDir)) {
+      gitDir = path13.resolve(cwd, gitDir);
+    }
+    const commonFile = path13.join(gitDir, "commondir");
+    if (fs12.existsSync(commonFile)) {
+      let common = fs12.readFileSync(commonFile, "utf-8").trim();
+      if (!path13.isAbsolute(common))
+        common = path13.resolve(gitDir, common);
+      return path13.join(common, "hooks");
+    } else if (path13.basename(path13.dirname(gitDir)) === "worktrees") {
+      return path13.join(path13.dirname(path13.dirname(gitDir)), "hooks");
+    }
+    return path13.join(gitDir, "hooks");
+  } catch {
+    return null;
+  }
+}
+function auditGitHooks(repoPath = process.cwd()) {
+  const hooksDir = resolveHooksDir(repoPath);
+  if (!hooksDir || !fs12.existsSync(hooksDir)) {
+    return {
+      isGitRepo: Boolean(hooksDir),
+      hooksDir,
+      postCommitInstalled: false,
+      postRewriteInstalled: false,
+      markerFound: false
+    };
+  }
+  const postCommit = path13.join(hooksDir, "post-commit");
+  const postRewrite = path13.join(hooksDir, "post-rewrite");
+  const hasMarker = (filePath) => {
+    if (!fs12.existsSync(filePath))
+      return false;
+    try {
+      return fs12.readFileSync(filePath, "utf-8").includes(HOOK_MARKER_BEGIN);
+    } catch {
+      return false;
+    }
+  };
+  const commitOk = hasMarker(postCommit);
+  const rewriteOk = hasMarker(postRewrite);
+  return {
+    isGitRepo: true,
+    hooksDir,
+    postCommitInstalled: commitOk,
+    postRewriteInstalled: rewriteOk,
+    markerFound: commitOk || rewriteOk
+  };
+}
+async function benchmarkHookLatency(trials = 3) {
+  const samples = [];
+  for (let i2 = 0; i2 < trials; i2++) {
+    const start = process.hrtime.bigint();
+    try {
+      const child = (0, import_node_child_process.spawn)(process.execPath, ["-e", "process.exit(0)"], {
+        detached: true,
+        stdio: "ignore",
+        windowsHide: true
+      });
+      child.unref();
+      const end = process.hrtime.bigint();
+      const diffMs = Number(end - start) / 1e6;
+      samples.push(diffMs);
+    } catch {
+      samples.push(99);
+    }
+  }
+  const minMs = samples.length > 0 ? Math.min(...samples) : 99;
+  const roundedMs = Number(minMs.toFixed(2));
+  if (roundedMs < 5) {
+    return {
+      executionMs: roundedMs,
+      passedInvariant: true,
+      status: "pass",
+      message: `Detached in ${roundedMs} ms (passed < 5ms invariant)`
+    };
+  } else if (roundedMs < 45) {
+    return {
+      executionMs: roundedMs,
+      passedInvariant: true,
+      status: "warn",
+      message: `Detached in ${roundedMs} ms (acceptable cold spawn, target is < 5ms)`
+    };
+  } else {
+    return {
+      executionMs: roundedMs,
+      passedInvariant: false,
+      status: "fail",
+      message: `Detached in ${roundedMs} ms (exceeded non-blocking threshold)`
+    };
+  }
+}
+function auditStorageHealth() {
+  const dbPath = path13.join(os12.homedir(), ".qodewk", "state.db");
+  try {
+    const db = new LocalStateDB();
+    const stats = db.getStats();
+    db.close();
+    let sizeBytes = 0;
+    if (fs12.existsSync(dbPath)) {
+      sizeBytes = fs12.statSync(dbPath).size;
+    }
+    return {
+      healthy: true,
+      dbPath,
+      receiptsCount: stats.totalReceipts,
+      footprintsCount: stats.totalFootprints,
+      sizeBytes
+    };
+  } catch {
+    return {
+      healthy: false,
+      dbPath,
+      receiptsCount: 0,
+      footprintsCount: 0
+    };
+  }
+}
+function auditPricingSync() {
+  const modelsCount = Object.keys(RATE_CARDS).length;
+  const cachedJson = path13.join(os12.homedir(), ".qodewk", "pricing.json");
+  const hasCached = fs12.existsSync(cachedJson);
+  return {
+    modelsLoaded: modelsCount,
+    cachedRegistryPresent: hasCached,
+    status: modelsCount > 0 ? "active" : "offline"
+  };
+}
+async function runDiagnostics(options = {}) {
+  const repoPath = options.repoPath || process.cwd();
+  const agents = auditAgentEnvironments(repoPath);
+  const hooks = auditGitHooks(repoPath);
+  const benchmark = await benchmarkHookLatency();
+  const storage = auditStorageHealth();
+  const pricing = auditPricingSync();
+  const activeAgents = agents.filter((a) => a.status === "active").length;
+  let overallStatus = "healthy";
+  if (!storage.healthy || !hooks.isGitRepo) {
+    overallStatus = "error";
+  } else if (!hooks.markerFound || activeAgents === 0) {
+    overallStatus = "warning";
+  }
+  return {
+    overallStatus,
+    version: "0.10.0",
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    repoPath,
+    agents,
+    hooks,
+    benchmark,
+    storage,
+    pricing
+  };
+}
+
 // ../core/dist/index.js
 function sanitizeReceiptForShare(receipt) {
   const sessions = receipt.ai.sessions?.map((s) => ({
@@ -16194,7 +16477,7 @@ async function generateReceipt(options = {}) {
 }
 
 // src/receipt-view.ts
-var fs12 = __toESM(require("fs"), 1);
+var fs13 = __toESM(require("fs"), 1);
 var import_picocolors = __toESM(require_picocolors(), 1);
 
 // src/barcode.ts
@@ -16608,7 +16891,7 @@ async function outputReceipt(receipt, options, publicUrl) {
   }
   if (options.out) {
     const fileContent = format === "terminal" ? stripAnsi(content) : content;
-    fs12.writeFileSync(options.out, fileContent.endsWith("\n") ? fileContent : fileContent + "\n", "utf-8");
+    fs13.writeFileSync(options.out, fileContent.endsWith("\n") ? fileContent : fileContent + "\n", "utf-8");
     console.log(import_picocolors.default.green(`\u2713 Receipt written to ${options.out}`));
   }
   if (!options.out) {
@@ -16621,12 +16904,12 @@ async function outputReceipt(receipt, options, publicUrl) {
 }
 
 // src/hooks.ts
-var fs13 = __toESM(require("fs"), 1);
-var path13 = __toESM(require("path"), 1);
-var HOOK_MARKER_BEGIN = "# --- BEGIN QODEWK HOOK ---";
+var fs14 = __toESM(require("fs"), 1);
+var path14 = __toESM(require("path"), 1);
+var HOOK_MARKER_BEGIN2 = "# --- BEGIN QODEWK HOOK ---";
 var HOOK_MARKER_END = "# --- END QODEWK HOOK ---";
 var HOOK_SNIPPET = `
-${HOOK_MARKER_BEGIN}
+${HOOK_MARKER_BEGIN2}
 # Non-blocking Qodewk background recorder (< 5ms)
 if command -v qodewk >/dev/null 2>&1 || command -v pnpm >/dev/null 2>&1 || [ -f "./node_modules/.bin/qodewk" ]; then
   ( ( qodewk record || pnpm qodewk record || npx qodewk record ) >/dev/null 2>&1 & )
@@ -16634,37 +16917,37 @@ fi
 ${HOOK_MARKER_END}
 `;
 function resolveGitHooksDir(cwd = process.cwd()) {
-  const gitPath = path13.join(cwd, ".git");
-  if (!fs13.existsSync(gitPath)) return null;
+  const gitPath = path14.join(cwd, ".git");
+  if (!fs14.existsSync(gitPath)) return null;
   let gitCommonDir;
-  const stat = fs13.statSync(gitPath);
+  const stat = fs14.statSync(gitPath);
   if (stat.isDirectory()) {
     gitCommonDir = gitPath;
   } else {
-    const content = fs13.readFileSync(gitPath, "utf-8");
+    const content = fs14.readFileSync(gitPath, "utf-8");
     const match = content.match(/gitdir:\s*(.+)/i);
     if (!match?.[1]) return null;
     let gitDir = match[1].trim();
-    if (!path13.isAbsolute(gitDir)) {
-      gitDir = path13.resolve(cwd, gitDir);
+    if (!path14.isAbsolute(gitDir)) {
+      gitDir = path14.resolve(cwd, gitDir);
     }
-    const commonFile = path13.join(gitDir, "commondir");
-    if (fs13.existsSync(commonFile)) {
-      let common = fs13.readFileSync(commonFile, "utf-8").trim();
-      if (!path13.isAbsolute(common)) {
-        common = path13.resolve(gitDir, common);
+    const commonFile = path14.join(gitDir, "commondir");
+    if (fs14.existsSync(commonFile)) {
+      let common = fs14.readFileSync(commonFile, "utf-8").trim();
+      if (!path14.isAbsolute(common)) {
+        common = path14.resolve(gitDir, common);
       }
       gitCommonDir = common;
-    } else if (path13.basename(path13.dirname(gitDir)) === "worktrees") {
-      gitCommonDir = path13.dirname(path13.dirname(gitDir));
+    } else if (path14.basename(path14.dirname(gitDir)) === "worktrees") {
+      gitCommonDir = path14.dirname(path14.dirname(gitDir));
     } else {
       gitCommonDir = gitDir;
     }
   }
-  return path13.join(gitCommonDir, "hooks");
+  return path14.join(gitCommonDir, "hooks");
 }
 function checkHookStatus(hooksDir) {
-  if (!hooksDir || !fs13.existsSync(hooksDir)) {
+  if (!hooksDir || !fs14.existsSync(hooksDir)) {
     return {
       isGit: Boolean(hooksDir),
       hooksDir,
@@ -16672,13 +16955,13 @@ function checkHookStatus(hooksDir) {
       postRewriteInstalled: false
     };
   }
-  const postCommit = path13.join(hooksDir, "post-commit");
-  const postRewrite = path13.join(hooksDir, "post-rewrite");
+  const postCommit = path14.join(hooksDir, "post-commit");
+  const postRewrite = path14.join(hooksDir, "post-rewrite");
   const hasHook = (p2) => {
-    if (!fs13.existsSync(p2)) return false;
+    if (!fs14.existsSync(p2)) return false;
     try {
-      const content = fs13.readFileSync(p2, "utf-8");
-      return content.includes(HOOK_MARKER_BEGIN);
+      const content = fs14.readFileSync(p2, "utf-8");
+      return content.includes(HOOK_MARKER_BEGIN2);
     } catch {
       return false;
     }
@@ -16692,31 +16975,118 @@ function checkHookStatus(hooksDir) {
 }
 function installHookFile(hookFile) {
   let content = "";
-  if (fs13.existsSync(hookFile)) {
-    content = fs13.readFileSync(hookFile, "utf-8");
+  if (fs14.existsSync(hookFile)) {
+    content = fs14.readFileSync(hookFile, "utf-8");
   } else {
     content = "#!/bin/sh\n";
   }
-  if (content.includes(HOOK_MARKER_BEGIN)) {
+  if (content.includes(HOOK_MARKER_BEGIN2)) {
     return "exists";
   }
-  fs13.writeFileSync(hookFile, content + HOOK_SNIPPET, { mode: 493 });
+  fs14.writeFileSync(hookFile, content + HOOK_SNIPPET, { mode: 493 });
   return "installed";
 }
 function uninstallHookFile(hookFile) {
-  if (!fs13.existsSync(hookFile)) return "absent";
-  const content = fs13.readFileSync(hookFile, "utf-8");
-  if (!content.includes(HOOK_MARKER_BEGIN)) return "missing";
-  const regex = new RegExp(`\\n?${HOOK_MARKER_BEGIN}[\\s\\S]*?${HOOK_MARKER_END}\\n?`, "g");
+  if (!fs14.existsSync(hookFile)) return "absent";
+  const content = fs14.readFileSync(hookFile, "utf-8");
+  if (!content.includes(HOOK_MARKER_BEGIN2)) return "missing";
+  const regex = new RegExp(`\\n?${HOOK_MARKER_BEGIN2}[\\s\\S]*?${HOOK_MARKER_END}\\n?`, "g");
   const updated = content.replace(regex, "");
-  fs13.writeFileSync(hookFile, updated, { mode: 493 });
+  fs14.writeFileSync(hookFile, updated, { mode: 493 });
   return "removed";
 }
 
 // src/menu.ts
 var readline = __toESM(require("readline"), 1);
-var path14 = __toESM(require("path"), 1);
+var path15 = __toESM(require("path"), 1);
+var import_picocolors3 = __toESM(require_picocolors(), 1);
+
+// src/doctor-view.ts
 var import_picocolors2 = __toESM(require_picocolors(), 1);
+function formatDoctorReport(report) {
+  const lines = [];
+  const push = (l) => lines.push(l);
+  push("");
+  const badge = bg.teal(import_picocolors2.default.bold(colors.ink(" qodewk doctor ")));
+  push(`  ${colors.mutedSoft("\u250C")}  ${badge}  ${import_picocolors2.default.dim(`v${report.version}`)}`);
+  push(`  ${colors.mutedSoft("\u2502")}`);
+  push(`  ${colors.teal("\u25C7")}  ${import_picocolors2.default.bold(import_picocolors2.default.white("AI Agent Environment"))}`);
+  push(`  ${colors.mutedSoft("\u2502")}`);
+  for (const agent of report.agents) {
+    const isAct = agent.status === "active";
+    const icon = isAct ? colors.green("\u2713") : import_picocolors2.default.dim("-");
+    const namePad = agent.name.padEnd(20, ".");
+    const statusText = isAct ? colors.green("Active") : import_picocolors2.default.dim("Not detected");
+    const detail = agent.path ? import_picocolors2.default.dim(` (${agent.path})`) : "";
+    push(`  ${colors.mutedSoft("\u2502")}  ${icon} ${import_picocolors2.default.white(namePad)} ${statusText}${detail}`);
+  }
+  push(`  ${colors.mutedSoft("\u2502")}`);
+  push(`  ${colors.teal("\u25C7")}  ${import_picocolors2.default.bold(import_picocolors2.default.white("Git Hook Telemetry"))}`);
+  push(`  ${colors.mutedSoft("\u2502")}`);
+  const hookDirText = report.hooks.hooksDir ? import_picocolors2.default.dim(` (${report.hooks.hooksDir})`) : "";
+  const pcIcon = report.hooks.postCommitInstalled ? colors.green("\u2713") : colors.red("\xD7");
+  const pcStatus = report.hooks.postCommitInstalled ? colors.green("Installed") : colors.red("Missing");
+  push(`  ${colors.mutedSoft("\u2502")}  ${pcIcon} ${import_picocolors2.default.white("post-commit hook ...")} ${pcStatus}${hookDirText}`);
+  const prIcon = report.hooks.postRewriteInstalled ? colors.green("\u2713") : colors.red("\xD7");
+  const prStatus = report.hooks.postRewriteInstalled ? colors.green("Installed") : colors.red("Missing");
+  push(`  ${colors.mutedSoft("\u2502")}  ${prIcon} ${import_picocolors2.default.white("post-rewrite hook ..")} ${prStatus}`);
+  const bench = report.benchmark;
+  const benchIcon = bench.status === "pass" ? colors.green("\u2713") : bench.status === "warn" ? colors.amber("!") : colors.red("\xD7");
+  const benchColor = bench.status === "pass" ? colors.green : bench.status === "warn" ? colors.amber : colors.red;
+  push(`  ${colors.mutedSoft("\u2502")}  ${benchIcon} ${import_picocolors2.default.white("Hook spawn latency .")} ${benchColor(`${bench.executionMs} ms`)} ${import_picocolors2.default.dim(`(${bench.message})`)}`);
+  push(`  ${colors.mutedSoft("\u2502")}`);
+  push(`  ${colors.teal("\u25C7")}  ${import_picocolors2.default.bold(import_picocolors2.default.white("Local Storage & Pricing"))}`);
+  push(`  ${colors.mutedSoft("\u2502")}`);
+  const dbIcon = report.storage.healthy ? colors.green("\u2713") : colors.red("\xD7");
+  const dbStatus = report.storage.healthy ? colors.green("Healthy") : colors.red("Failed");
+  const dbDetail = report.storage.healthy ? import_picocolors2.default.dim(` (${report.storage.receiptsCount} receipts, ${report.storage.footprintsCount} footprints)`) : "";
+  push(`  ${colors.mutedSoft("\u2502")}  ${dbIcon} ${import_picocolors2.default.white("SQLite Database ....")} ${dbStatus}${dbDetail}`);
+  const prcIcon = report.pricing.status === "active" ? colors.green("\u2713") : colors.red("\xD7");
+  const prcStatus = report.pricing.status === "active" ? colors.green("Active") : colors.red("Offline");
+  push(`  ${colors.mutedSoft("\u2502")}  ${prcIcon} ${import_picocolors2.default.white("Rate Card Registry .")} ${prcStatus} ${import_picocolors2.default.dim(`(${report.pricing.modelsLoaded} model rate cards loaded)`)}`);
+  push(`  ${colors.mutedSoft("\u2502")}`);
+  if (report.overallStatus === "healthy") {
+    push(`  ${colors.coral("\u25C6")}  ${import_picocolors2.default.bold(colors.green("All Systems Operational \u2014 Telemetry Ready"))}`);
+  } else if (report.overallStatus === "warning") {
+    push(`  ${colors.amber("\u25C6")}  ${import_picocolors2.default.bold(colors.amber("Operational with Warnings \u2014 Run `qodewk hook install` to enable automatic recording"))}`);
+  } else {
+    push(`  ${colors.red("\u25C6")}  ${import_picocolors2.default.bold(colors.red("Diagnostic Issues Detected \u2014 Check Git repository or database status"))}`);
+  }
+  push(`  ${colors.mutedSoft("\u2514")}`);
+  push("");
+  return lines.join("\n");
+}
+function formatHookTestReport(hooks, benchmark) {
+  const lines = [];
+  const push = (l) => lines.push(l);
+  push("");
+  const badge = bg.teal(import_picocolors2.default.bold(colors.ink(" qodewk hook test ")));
+  push(`  ${colors.mutedSoft("\u250C")}  ${badge}`);
+  push(`  ${colors.mutedSoft("\u2502")}`);
+  const pcIcon = hooks.postCommitInstalled ? colors.green("\u2713") : colors.red("\xD7");
+  const pcStatus = hooks.postCommitInstalled ? colors.green("Installed") : colors.red("Missing");
+  push(`  ${colors.mutedSoft("\u2502")}  ${pcIcon} post-commit hook: ${pcStatus}`);
+  const prIcon = hooks.postRewriteInstalled ? colors.green("\u2713") : colors.red("\xD7");
+  const prStatus = hooks.postRewriteInstalled ? colors.green("Installed") : colors.red("Missing");
+  push(`  ${colors.mutedSoft("\u2502")}  ${prIcon} post-rewrite hook: ${prStatus}`);
+  const benchIcon = benchmark.status === "pass" ? colors.green("\u2713") : benchmark.status === "warn" ? colors.amber("!") : colors.red("\xD7");
+  const benchColor = benchmark.status === "pass" ? colors.green : benchmark.status === "warn" ? colors.amber : colors.red;
+  push(`  ${colors.mutedSoft("\u2502")}  ${benchIcon} Detachment Latency: ${benchColor(`${benchmark.executionMs} ms`)}`);
+  push(`  ${colors.mutedSoft("\u2502")}    ${import_picocolors2.default.dim(benchmark.message)}`);
+  push(`  ${colors.mutedSoft("\u2502")}`);
+  if (benchmark.passedInvariant && hooks.markerFound) {
+    push(`  ${colors.coral("\u25C6")}  ${import_picocolors2.default.bold(colors.green("Non-blocking Hook Verified (< 5ms Invariant Passed)"))}`);
+  } else if (!hooks.markerFound) {
+    push(`  ${colors.amber("\u25C6")}  ${import_picocolors2.default.bold(colors.amber("Hooks Not Installed \u2014 Run `qodewk hook install`"))}`);
+  } else {
+    push(`  ${colors.red("\u25C6")}  ${import_picocolors2.default.bold(colors.red("Latency Threshold Exceeded \u2014 Reinstall recommended"))}`);
+  }
+  push(`  ${colors.mutedSoft("\u2514")}`);
+  push("");
+  return lines.join("\n");
+}
+
+// src/menu.ts
 var SHARE_PAYLOAD_MAX_BYTES = 5e4;
 var BANNER_LINES = [
   "  \u2588\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557    \u2588\u2588\u2557\u2588\u2588\u2557  \u2588\u2588\u2557",
@@ -16763,6 +17133,12 @@ var MENU_ITEMS = [
     label: "Git Notes Management",
     description: "Inspect & attach receipts to refs/notes/qodewk"
   },
+  {
+    id: "doctor",
+    key: "7",
+    label: "System Health & Diagnostics",
+    description: "Audit AI agents, Git hooks, SQLite & pricing registry (doctor)"
+  },
   {
     id: "exit",
     key: "0",
@@ -16808,7 +17184,7 @@ var RECEIPT_HORIZON_ITEMS = [
     description: "Return to previous screen"
   }
 ];
-function buildMenuFrame(selectedIndex, items = MENU_ITEMS, title = "Telemetry Control Panel", subtitle = "\u2191\u2193 move \xB7 enter select \xB7 0-6 quick jump \xB7 q quit", options = {}) {
+function buildMenuFrame(selectedIndex, items = MENU_ITEMS, title = "Telemetry Control Panel", subtitle = "\u2191\u2193 move \xB7 enter select \xB7 0-7 quick jump \xB7 q quit", options = {}) {
   const lines = [];
   const push = (line) => lines.push(line);
   if (options.showBanner ?? true) {
@@ -16819,21 +17195,21 @@ function buildMenuFrame(selectedIndex, items = MENU_ITEMS, title = "Telemetry Co
     }
   }
   push("");
-  const badge = bg.teal(import_picocolors2.default.bold(colors.ink(" qodewk ")));
-  push(`  ${colors.mutedSoft("\u250C")}  ${badge}  ${import_picocolors2.default.dim("v0.9.2")}`);
+  const badge = bg.teal(import_picocolors3.default.bold(colors.ink(" qodewk ")));
+  push(`  ${colors.mutedSoft("\u250C")}  ${badge}  ${import_picocolors3.default.dim("v0.10.0")}`);
   push(`  ${colors.mutedSoft("\u2502")}`);
   if (options.actionContext) {
-    push(`  ${colors.teal("\u25C7")}  ${import_picocolors2.default.dim("Action:")} ${import_picocolors2.default.white(options.actionContext)}`);
+    push(`  ${colors.teal("\u25C7")}  ${import_picocolors3.default.dim("Action:")} ${import_picocolors3.default.white(options.actionContext)}`);
     push(`  ${colors.mutedSoft("\u2502")}`);
   } else {
     const repo = options.repoContext?.alias || "Qodewk";
     const branch = options.repoContext?.branch ? `(${options.repoContext.branch})` : "";
-    push(`  ${colors.teal("\u25C7")}  ${import_picocolors2.default.dim("Repository:")} ${import_picocolors2.default.white(repo)} ${import_picocolors2.default.dim(branch)}`);
+    push(`  ${colors.teal("\u25C7")}  ${import_picocolors3.default.dim("Repository:")} ${import_picocolors3.default.white(repo)} ${import_picocolors3.default.dim(branch)}`);
     push(`  ${colors.mutedSoft("\u2502")}`);
-    push(`  ${colors.teal("\u25C7")}  ${import_picocolors2.default.dim("Telemetry:")} ${import_picocolors2.default.white("Claude Warm Editorial Rate Cards")}`);
+    push(`  ${colors.teal("\u25C7")}  ${import_picocolors3.default.dim("Telemetry:")} ${import_picocolors3.default.white("Claude Warm Editorial Rate Cards")}`);
     push(`  ${colors.mutedSoft("\u2502")}`);
   }
-  push(`  ${colors.coral("\u25C6")}  ${import_picocolors2.default.bold(import_picocolors2.default.white(title))}`);
+  push(`  ${colors.coral("\u25C6")}  ${import_picocolors3.default.bold(import_picocolors3.default.white(title))}`);
   push(`  ${colors.mutedSoft("\u2502")}`);
   const selectedItem = items[selectedIndex] || items[0];
   for (let i2 = 0; i2 < items.length; i2++) {
@@ -16841,44 +17217,44 @@ function buildMenuFrame(selectedIndex, items = MENU_ITEMS, title = "Telemetry Co
     const isSelected = i2 === selectedIndex;
     if (isSelected) {
       push(
-        `  ${colors.mutedSoft("\u2502")}  ${import_picocolors2.default.bold(colors.coral("\u203A"))} ${import_picocolors2.default.bold(colors.coral(item.key))}  ${import_picocolors2.default.bold(import_picocolors2.default.white(item.label))}`
+        `  ${colors.mutedSoft("\u2502")}  ${import_picocolors3.default.bold(colors.coral("\u203A"))} ${import_picocolors3.default.bold(colors.coral(item.key))}  ${import_picocolors3.default.bold(import_picocolors3.default.white(item.label))}`
       );
     } else {
       push(
-        `  ${colors.mutedSoft("\u2502")}    ${import_picocolors2.default.dim(item.key)}  ${import_picocolors2.default.dim(import_picocolors2.default.white(item.label))}`
+        `  ${colors.mutedSoft("\u2502")}    ${import_picocolors3.default.dim(item.key)}  ${import_picocolors3.default.dim(import_picocolors3.default.white(item.label))}`
       );
     }
   }
   const divider = colors.mutedSoft("\u2500".repeat(58));
   push(`  ${colors.mutedSoft("\u2502")}`);
   push(`  ${colors.mutedSoft("\u2502")}  ${divider}`);
-  push(`  ${colors.mutedSoft("\u2502")}  ${import_picocolors2.default.bold(import_picocolors2.default.dim("Description"))}`);
+  push(`  ${colors.mutedSoft("\u2502")}  ${import_picocolors3.default.bold(import_picocolors3.default.dim("Description"))}`);
   push(`  ${colors.mutedSoft("\u2502")}  ${colors.amber(selectedItem.description)}`);
   push(`  ${colors.mutedSoft("\u2502")}  ${divider}`);
   push(`  ${colors.mutedSoft("\u2502")}`);
-  push(`  ${colors.mutedSoft("\u2502")}  ${import_picocolors2.default.dim(subtitle)}`);
-  push(`  ${colors.mutedSoft("\u2502")}  ${colors.green("[\u2713]")} ${import_picocolors2.default.dim("Source code was never uploaded to Qodewk")}`);
+  push(`  ${colors.mutedSoft("\u2502")}  ${import_picocolors3.default.dim(subtitle)}`);
+  push(`  ${colors.mutedSoft("\u2502")}  ${colors.green("[\u2713]")} ${import_picocolors3.default.dim("Source code was never uploaded to Qodewk")}`);
   push(`  ${colors.mutedSoft("\u2514")}`);
   push("");
   return lines.join("\n");
 }
 function askLine(promptText) {
-  return new Promise((resolve5) => {
+  return new Promise((resolve6) => {
     const rl = readline.createInterface({
       input: process.stdin,
       output: process.stdout
     });
     rl.question(promptText, (answer) => {
       rl.close();
-      resolve5(answer.trim());
+      resolve6(answer.trim());
     });
   });
 }
 function waitForKeyToReturn() {
-  return new Promise((resolve5) => {
-    console.log(import_picocolors2.default.dim("\n  Press any key or Enter to return to menu..."));
+  return new Promise((resolve6) => {
+    console.log(import_picocolors3.default.dim("\n  Press any key or Enter to return to menu..."));
     if (!process.stdin.isTTY) {
-      resolve5();
+      resolve6();
       return;
     }
     const wasRaw = process.stdin.isRaw;
@@ -16887,7 +17263,7 @@ function waitForKeyToReturn() {
     const onKey = () => {
       process.stdin.removeListener("data", onKey);
       if (wasRaw !== void 0) process.stdin.setRawMode(wasRaw);
-      resolve5();
+      resolve6();
     };
     process.stdin.once("data", onKey);
   });
@@ -16905,7 +17281,7 @@ async function getRepoContext() {
     }
     const branchSummary = await git.branch();
     const branch = branchSummary.current || "HEAD";
-    const alias = path14.basename(process.cwd());
+    const alias = path15.basename(process.cwd());
     cachedRepoContext = { alias, branch };
     return cachedRepoContext;
   } catch {
@@ -16916,7 +17292,7 @@ async function getRepoContext() {
 async function runInteractiveMenu() {
   if (!process.stdin.isTTY) {
     console.log(buildMenuFrame(0));
-    console.log(import_picocolors2.default.yellow("Interactive menu requires a TTY terminal. Use `qodewk --help` for commands."));
+    console.log(import_picocolors3.default.yellow("Interactive menu requires a TTY terminal. Use `qodewk --help` for commands."));
     return;
   }
   const repoContext = await getRepoContext();
@@ -16928,7 +17304,7 @@ async function runInteractiveMenu() {
   const render = () => {
     const items = getActiveItems();
     const title = currentScreen === "main" ? "Telemetry Control Panel" : "Generate Local Receipt";
-    const subtitle = currentScreen === "main" ? "\u2191\u2193 move \xB7 enter select \xB7 0-6 quick jump \xB7 q quit" : "\u2191\u2193 move \xB7 enter select \xB7 0-5 quick jump \xB7 esc / 0 back";
+    const subtitle = currentScreen === "main" ? "\u2191\u2193 move \xB7 enter select \xB7 0-7 quick jump \xB7 q quit" : "\u2191\u2193 move \xB7 enter select \xB7 0-5 quick jump \xB7 esc / 0 back";
     const actionContext = currentScreen === "receipt_horizon" ? "Generate Local Receipt" : void 0;
     const showBanner = currentScreen === "main";
     const frame = buildMenuFrame(selectedIndex, items, title, subtitle, {
@@ -16969,15 +17345,15 @@ async function runInteractiveMenu() {
       since = "7d";
       label = "past 7 days weekly sprint (--since 7d)";
     } else if (item.id === "custom") {
-      console.log(import_picocolors2.default.bold(import_picocolors2.default.white("  Custom Telemetry Horizon")));
-      console.log(import_picocolors2.default.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+      console.log(import_picocolors3.default.bold(import_picocolors3.default.white("  Custom Telemetry Horizon")));
+      console.log(import_picocolors3.default.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
       const input = await askLine("  \u203A Enter duration or date (e.g. 12h, 3d, 2026-10-01): ");
       if (input) {
         since = input;
         label = `custom range: ${input}`;
       }
     }
-    console.log(import_picocolors2.default.dim(`  [\xB7] Generating local receipt for ${label}...`));
+    console.log(import_picocolors3.default.dim(`  [\xB7] Generating local receipt for ${label}...`));
     try {
       const receipt = await generateReceipt({ since, isPublic: false });
       const db = new LocalStateDB();
@@ -16986,7 +17362,7 @@ async function runInteractiveMenu() {
       await renderTerminalReceipt(receipt);
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
-      console.error(import_picocolors2.default.red(`
+      console.error(import_picocolors3.default.red(`
   Failed to generate receipt: ${message}`));
     }
     await waitForKeyToReturn();
@@ -17000,8 +17376,8 @@ async function runInteractiveMenu() {
     const selectedItem = MENU_ITEMS[selectedIndex];
     switch (selectedItem.id) {
       case "audit": {
-        console.log(import_picocolors2.default.bold(import_picocolors2.default.white("\n  Audit Branch or Revision Diff")));
-        console.log(import_picocolors2.default.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+        console.log(import_picocolors3.default.bold(import_picocolors3.default.white("\n  Audit Branch or Revision Diff")));
+        console.log(import_picocolors3.default.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
         let defaultBase = "origin/main";
         try {
           defaultBase = await detectDefaultBaseBranch(process.cwd());
@@ -17013,7 +17389,7 @@ async function runInteractiveMenu() {
         const head = await askLine(
           `  \u203A Head git ref or commit SHA [default: HEAD]: `
         );
-        console.log(import_picocolors2.default.dim("\n  [\xB7] Auditing git revision range..."));
+        console.log(import_picocolors3.default.dim("\n  [\xB7] Auditing git revision range..."));
         try {
           const receipt = await generateReceipt({
             baseSha: base || defaultBase,
@@ -17026,18 +17402,18 @@ async function runInteractiveMenu() {
           await renderTerminalReceipt(receipt);
         } catch (err) {
           const message = err instanceof Error ? err.message : String(err);
-          console.error(import_picocolors2.default.red(`
+          console.error(import_picocolors3.default.red(`
   Audit failed: ${message}`));
         }
         await waitForKeyToReturn();
         break;
       }
       case "share": {
-        console.log(import_picocolors2.default.dim("  [\xB7] Generating and sanitizing receipt for cloud publishing..."));
+        console.log(import_picocolors3.default.dim("  [\xB7] Generating and sanitizing receipt for cloud publishing..."));
         try {
           const receipt = await generateReceipt({ isPublic: false });
           if (process.env.QODEWK_TELEMETRY === "off") {
-            console.log(import_picocolors2.default.yellow("\n  Cloud publishing is disabled by QODEWK_TELEMETRY=off."));
+            console.log(import_picocolors3.default.yellow("\n  Cloud publishing is disabled by QODEWK_TELEMETRY=off."));
             await renderTerminalReceipt(receipt);
             await waitForKeyToReturn();
             break;
@@ -17052,7 +17428,7 @@ async function runInteractiveMenu() {
             body = JSON.stringify(trimmed2);
           }
           const endpoint = resolveApiUrl();
-          console.log(import_picocolors2.default.dim(`  [\xB7] Uploading metadata to ${endpoint}...`));
+          console.log(import_picocolors3.default.dim(`  [\xB7] Uploading metadata to ${endpoint}...`));
           const response = await fetch(endpoint, {
             method: "POST",
             headers: {
@@ -17064,11 +17440,11 @@ async function runInteractiveMenu() {
           if (!response.ok) {
             const errText = await response.text().catch(() => "");
             if (response.status === 503) {
-              console.log(import_picocolors2.default.yellow("\n  Notice: Remote server requires durable storage (Supabase or PostgreSQL) in production"));
-              console.log(import_picocolors2.default.dim("  to protect receipts from serverless cold-start data loss."));
-              console.log(import_picocolors2.default.dim(`  Endpoint: ${endpoint}`));
+              console.log(import_picocolors3.default.yellow("\n  Notice: Remote server requires durable storage (Supabase or PostgreSQL) in production"));
+              console.log(import_picocolors3.default.dim("  to protect receipts from serverless cold-start data loss."));
+              console.log(import_picocolors3.default.dim(`  Endpoint: ${endpoint}`));
               console.log(colors.green("\n  [\u2713] Your receipt is safely saved locally in: ~/.qodewk/state.db"));
-              console.log(import_picocolors2.default.dim("      You can also save it as a local Git note: qodewk --notes\n"));
+              console.log(import_picocolors3.default.dim("      You can also save it as a local Git note: qodewk --notes\n"));
               await renderTerminalReceipt(sanitized);
               await waitForKeyToReturn();
               break;
@@ -17081,13 +17457,13 @@ async function runInteractiveMenu() {
           db.close();
           console.log("");
           console.log(colors.green("  [\u2713] Published successfully."));
-          console.log(`  ${import_picocolors2.default.dim("Public URL:")}  ${import_picocolors2.default.underline(import_picocolors2.default.cyan(data.url))}`);
-          console.log(`  ${import_picocolors2.default.bold(colors.amber("Claim token:"))} ${colors.amber(data.claimToken)}`);
-          console.log(import_picocolors2.default.dim("  (Saved to ~/.qodewk/state.db for future authorship proofs)\n"));
+          console.log(`  ${import_picocolors3.default.dim("Public URL:")}  ${import_picocolors3.default.underline(import_picocolors3.default.cyan(data.url))}`);
+          console.log(`  ${import_picocolors3.default.bold(colors.amber("Claim token:"))} ${colors.amber(data.claimToken)}`);
+          console.log(import_picocolors3.default.dim("  (Saved to ~/.qodewk/state.db for future authorship proofs)\n"));
           await renderTerminalReceipt(sanitized, data.url);
         } catch (err) {
           const message = err instanceof Error ? err.message : String(err);
-          console.error(import_picocolors2.default.red(`
+          console.error(import_picocolors3.default.red(`
   Share failed: ${message}`));
         }
         await waitForKeyToReturn();
@@ -17105,10 +17481,14 @@ async function runInteractiveMenu() {
         await manageGitNotesSubmenu();
         break;
       }
+      case "doctor": {
+        await runDoctorDiagnosticsAction();
+        break;
+      }
       case "exit": {
         active = false;
         cleanup();
-        console.log(import_picocolors2.default.dim("  Exited Qodewk.\n"));
+        console.log(import_picocolors3.default.dim("  Exited Qodewk.\n"));
         process.exit(0);
         return;
       }
@@ -17117,31 +17497,32 @@ async function runInteractiveMenu() {
   const manageHooksSubmenu = async () => {
     const hooksDir = resolveGitHooksDir();
     const status = checkHookStatus(hooksDir);
-    console.log(import_picocolors2.default.bold(import_picocolors2.default.white("\n  Qodewk Git Hooks Management")));
-    console.log(import_picocolors2.default.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+    console.log(import_picocolors3.default.bold(import_picocolors3.default.white("\n  Qodewk Git Hooks Management")));
+    console.log(import_picocolors3.default.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
     if (!status.isGit) {
-      console.log(import_picocolors2.default.yellow("  Not inside a Git repository. Hooks cannot be configured."));
+      console.log(import_picocolors3.default.yellow("  Not inside a Git repository. Hooks cannot be configured."));
       await waitForKeyToReturn();
       return;
     }
-    console.log(`  Hooks directory: ${import_picocolors2.default.dim(status.hooksDir || "None")}`);
+    console.log(`  Hooks directory: ${import_picocolors3.default.dim(status.hooksDir || "None")}`);
     console.log(
-      `  post-commit:     ${status.postCommitInstalled ? colors.green("[\u2713 Installed]") : import_picocolors2.default.dim("[\xB7 Not installed]")}`
+      `  post-commit:     ${status.postCommitInstalled ? colors.green("[\u2713 Installed]") : import_picocolors3.default.dim("[\xB7 Not installed]")}`
     );
     console.log(
-      `  post-rewrite:    ${status.postRewriteInstalled ? colors.green("[\u2713 Installed]") : import_picocolors2.default.dim("[\xB7 Not installed]")}`
+      `  post-rewrite:    ${status.postRewriteInstalled ? colors.green("[\u2713 Installed]") : import_picocolors3.default.dim("[\xB7 Not installed]")}`
     );
     console.log("");
     console.log("  [1] Install non-blocking hooks (< 5ms background recorder)");
     console.log("  [2] Uninstall Qodewk hooks");
+    console.log("  [3] Test & benchmark hook latency (< 5ms invariant)");
     console.log("  [0] Back to main menu");
     console.log("");
-    const choice = await askLine("  \u203A Select option [0-2]: ");
+    const choice = await askLine("  \u203A Select option [0-3]: ");
     if (choice === "1") {
       if (status.hooksDir) {
         const targets = ["post-commit", "post-rewrite"];
         for (const t2 of targets) {
-          installHookFile(path14.join(status.hooksDir, t2));
+          installHookFile(path15.join(status.hooksDir, t2));
         }
         console.log(colors.green("\n  [\u2713] Non-blocking hooks installed successfully."));
       }
@@ -17149,16 +17530,20 @@ async function runInteractiveMenu() {
       if (status.hooksDir) {
         const targets = ["post-commit", "post-rewrite"];
         for (const t2 of targets) {
-          uninstallHookFile(path14.join(status.hooksDir, t2));
+          uninstallHookFile(path15.join(status.hooksDir, t2));
         }
         console.log(colors.green("\n  [\u2713] Qodewk hooks removed."));
       }
+    } else if (choice === "3") {
+      const hooks = auditGitHooks();
+      const bench = await benchmarkHookLatency();
+      console.log(formatHookTestReport(hooks, bench));
     }
     await waitForKeyToReturn();
   };
   const manageGitNotesSubmenu = async () => {
-    console.log(import_picocolors2.default.bold(import_picocolors2.default.white("\n  Qodewk Git Notes Management (refs/notes/qodewk)")));
-    console.log(import_picocolors2.default.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+    console.log(import_picocolors3.default.bold(import_picocolors3.default.white("\n  Qodewk Git Notes Management (refs/notes/qodewk)")));
+    console.log(import_picocolors3.default.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
     console.log("  [1] List commits with attached Qodewk notes");
     console.log("  [2] Show receipt note on a commit (default: HEAD)");
     console.log("  [3] Attach receipt note to a Git commit (default: HEAD)");
@@ -17169,17 +17554,17 @@ async function runInteractiveMenu() {
       try {
         const shas = await listGitReceiptNotes();
         if (shas.length === 0) {
-          console.log(import_picocolors2.default.yellow("\n  No Qodewk Git notes found in repository."));
+          console.log(import_picocolors3.default.yellow("\n  No Qodewk Git notes found in repository."));
         } else {
-          console.log(import_picocolors2.default.bold(`
+          console.log(import_picocolors3.default.bold(`
   Found ${shas.length} commit note(s) in refs/notes/qodewk:`));
           for (const sha of shas) {
-            console.log(`    ${import_picocolors2.default.cyan(sha.slice(0, 10))} ${import_picocolors2.default.dim(sha)}`);
+            console.log(`    ${import_picocolors3.default.cyan(sha.slice(0, 10))} ${import_picocolors3.default.dim(sha)}`);
           }
         }
       } catch (err) {
         const message = err instanceof Error ? err.message : String(err);
-        console.error(import_picocolors2.default.red(`
+        console.error(import_picocolors3.default.red(`
   Error listing Git notes: ${message}`));
       }
     } else if (choice === "2") {
@@ -17187,20 +17572,20 @@ async function runInteractiveMenu() {
       try {
         const receipt = await readGitReceiptNote(commit);
         if (!receipt) {
-          console.log(import_picocolors2.default.yellow(`
+          console.log(import_picocolors3.default.yellow(`
   No Qodewk receipt note found on commit '${commit}'.`));
         } else {
           await renderTerminalReceipt(receipt);
         }
       } catch (err) {
         const message = err instanceof Error ? err.message : String(err);
-        console.error(import_picocolors2.default.red(`
+        console.error(import_picocolors3.default.red(`
   Error reading Git note: ${message}`));
       }
     } else if (choice === "3") {
       const commit = await askLine("  \u203A Commit SHA to attach note [default: HEAD]: ") || "HEAD";
       try {
-        console.log(import_picocolors2.default.dim(`
+        console.log(import_picocolors3.default.dim(`
   [\xB7] Generating receipt for ${commit}...`));
         const receipt = await generateReceipt({ headSha: commit });
         await writeGitReceiptNote(receipt.repository.headSha, receipt);
@@ -17210,30 +17595,30 @@ async function runInteractiveMenu() {
         );
       } catch (err) {
         const message = err instanceof Error ? err.message : String(err);
-        console.error(import_picocolors2.default.red(`
+        console.error(import_picocolors3.default.red(`
   Error writing Git note: ${message}`));
       }
     }
     await waitForKeyToReturn();
   };
   const showStorageStatus = async () => {
-    console.log(import_picocolors2.default.bold(import_picocolors2.default.white("\n  Qodewk Local Database & Storage Status")));
-    console.log(import_picocolors2.default.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+    console.log(import_picocolors3.default.bold(import_picocolors3.default.white("\n  Qodewk Local Database & Storage Status")));
+    console.log(import_picocolors3.default.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
     try {
       const db = new LocalStateDB();
       const stats = db.getStats();
       const recent = db.getRecentReceipts(5);
       db.close();
-      console.log(`  Database path:          ${import_picocolors2.default.dim("~/.qodewk/state.db")}`);
-      console.log(`  Total saved receipts:   ${import_picocolors2.default.bold(import_picocolors2.default.white(String(stats.totalReceipts)))}`);
-      console.log(`  Total agent footprints: ${import_picocolors2.default.bold(import_picocolors2.default.white(String(stats.totalFootprints)))}`);
+      console.log(`  Database path:          ${import_picocolors3.default.dim("~/.qodewk/state.db")}`);
+      console.log(`  Total saved receipts:   ${import_picocolors3.default.bold(import_picocolors3.default.white(String(stats.totalReceipts)))}`);
+      console.log(`  Total agent footprints: ${import_picocolors3.default.bold(import_picocolors3.default.white(String(stats.totalFootprints)))}`);
       console.log("");
       if (recent.length === 0) {
-        console.log(import_picocolors2.default.dim("  No stored receipts yet. Run 'Generate Local Receipt' to record your first."));
+        console.log(import_picocolors3.default.dim("  No stored receipts yet. Run 'Generate Local Receipt' to record your first."));
       } else {
-        console.log(import_picocolors2.default.dim("  Recent Receipts:"));
-        console.log(import_picocolors2.default.dim("  " + "ID".padEnd(26) + "DATE".padEnd(12) + "BRANCH".padEnd(18) + "COST"));
-        console.log(import_picocolors2.default.dim("  " + "\u2500".repeat(60)));
+        console.log(import_picocolors3.default.dim("  Recent Receipts:"));
+        console.log(import_picocolors3.default.dim("  " + "ID".padEnd(26) + "DATE".padEnd(12) + "BRANCH".padEnd(18) + "COST"));
+        console.log(import_picocolors3.default.dim("  " + "\u2500".repeat(60)));
         for (const item of recent) {
           const id = item.receipt.receipt.id.slice(0, 24).padEnd(26);
           const date = item.receipt.receipt.createdAt.slice(0, 10).padEnd(12);
@@ -17243,10 +17628,23 @@ async function runInteractiveMenu() {
         }
       }
       console.log("");
-      console.log(`  ${colors.green("[\u2713]")} ${import_picocolors2.default.dim("Privacy guarantee: raw source code is never stored in SQLite")}`);
+      console.log(`  ${colors.green("[\u2713]")} ${import_picocolors3.default.dim("Privacy guarantee: raw source code is never stored in SQLite")}`);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      console.error(import_picocolors3.default.red(`  Failed to inspect storage: ${message}`));
+    }
+    await waitForKeyToReturn();
+  };
+  const runDoctorDiagnosticsAction = async () => {
+    console.log(import_picocolors3.default.bold(import_picocolors3.default.white("\n  Qodewk System Health & Diagnostics (Doctor)")));
+    console.log(import_picocolors3.default.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+    console.log(import_picocolors3.default.dim("  [\xB7] Running diagnostic audit across agents, hooks, storage, and pricing...\n"));
+    try {
+      const report = await runDiagnostics();
+      console.log(formatDoctorReport(report));
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
-      console.error(import_picocolors2.default.red(`  Failed to inspect storage: ${message}`));
+      console.error(import_picocolors3.default.red(`  Diagnostic check failed: ${message}`));
     }
     await waitForKeyToReturn();
   };
@@ -17271,7 +17669,7 @@ async function runInteractiveMenu() {
           return;
         }
         cleanup();
-        console.log(import_picocolors2.default.dim("\n  Exited Qodewk.\n"));
+        console.log(import_picocolors3.default.dim("\n  Exited Qodewk.\n"));
         process.exit(0);
       }
       if (key.name === "up" || key.name === "k") {
@@ -17348,19 +17746,19 @@ loadQodewkEnv();
 var SHARE_PAYLOAD_MAX_BYTES2 = 5e4;
 function resolveCliVersion() {
   try {
-    const argv1 = process.argv[1] ? path15.dirname(path15.resolve(process.argv[1])) : process.cwd();
+    const argv1 = process.argv[1] ? path16.dirname(path16.resolve(process.argv[1])) : process.cwd();
     const candidates = [
-      path15.join(argv1, "..", "package.json"),
-      path15.join(argv1, "package.json")
+      path16.join(argv1, "..", "package.json"),
+      path16.join(argv1, "package.json")
     ];
     for (const candidate of candidates) {
-      if (!fs14.existsSync(candidate)) continue;
-      const pkg = JSON.parse(fs14.readFileSync(candidate, "utf-8"));
+      if (!fs15.existsSync(candidate)) continue;
+      const pkg = JSON.parse(fs15.readFileSync(candidate, "utf-8"));
       if (pkg.name === "qodewk" && pkg.version) return pkg.version;
     }
   } catch {
   }
-  return "0.9.2";
+  return "0.10.0";
 }
 function resolveSince(options) {
   return options.today ? "today" : options.since;
@@ -17398,21 +17796,39 @@ program2.name("qodewk").description("Universal telemetry and digital receipt gen
     if (options.notes) {
       try {
         await writeGitReceiptNote(receipt.repository.headSha, receipt);
-        console.log(import_picocolors3.default.green(`\u2713 Attached receipt note to ${receipt.repository.headSha.slice(0, 7)} (refs/notes/qodewk)`));
+        console.log(import_picocolors4.default.green(`\u2713 Attached receipt note to ${receipt.repository.headSha.slice(0, 7)} (refs/notes/qodewk)`));
       } catch (noteErr) {
-        console.warn(import_picocolors3.default.yellow(`Warning: Could not write Git note: ${noteErr.message}`));
+        console.warn(import_picocolors4.default.yellow(`Warning: Could not write Git note: ${noteErr.message}`));
       }
     }
     await outputReceipt(receipt, options);
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
-    console.error(import_picocolors3.default.red(`Error generating receipt: ${message}`));
+    console.error(import_picocolors4.default.red(`Error generating receipt: ${message}`));
     process.exit(1);
   }
 });
 program2.command("menu").description("Launch interactive terminal control panel").action(async () => {
   await runInteractiveMenu();
 });
+program2.command("doctor").description("Run complete diagnostic health check of AI agents, git hooks, and local telemetry").option("-j, --json", "Output diagnostic report in machine-readable JSON format").action(async (options) => {
+  try {
+    const isJson = Boolean(options.json || program2.opts().json);
+    const report = await runDiagnostics();
+    if (isJson) {
+      console.log(JSON.stringify(report, null, 2));
+    } else {
+      console.log(formatDoctorReport(report));
+    }
+    if (report.overallStatus === "error") {
+      process.exit(1);
+    }
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(import_picocolors4.default.red(`Error running diagnostics: ${message}`));
+    process.exit(1);
+  }
+});
 program2.command("audit").description("Audit PR or branch diff against a target base commit").option("-b, --base <base>", "Base git ref or commit SHA (e.g. origin/main)").option("-H, --head <head>", "Head git ref or commit SHA").option("-f, --format <format>", "Output format (terminal, json, markdown)", "terminal").option("-o, --out <path>", "Write receipt output to specified file path").option("-p, --provider <provider>", "Specify AI provider").option("-m, --model <model>", "Specify AI model").option("-s, --since <duration>", "Harvest agent footprints since duration").option("--today", "Harvest agent footprints for today").option("--platform <platform>", "Filter agent platform").option("--anon", "Anonymize branch name in output").option("--barcode", "Render classic 1D thermal barcode (always on; kept for compatibility)").action(async (options) => {
   try {
     const receipt = await generateReceipt({
@@ -17429,7 +17845,7 @@ program2.command("audit").description("Audit PR or branch diff against a target
     await outputReceipt(receipt, options);
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
-    console.error(import_picocolors3.default.red(`Error auditing git range: ${message}`));
+    console.error(import_picocolors4.default.red(`Error auditing git range: ${message}`));
     process.exit(1);
   }
 });
@@ -17446,12 +17862,12 @@ program2.command("share").description("Publish privacy-safe receipt to Qodewk cl
     const localFlag = program2.opts().local === true;
     if (process.env.QODEWK_TELEMETRY === "off" || localFlag) {
       console.log(
-        import_picocolors3.default.yellow(
+        import_picocolors4.default.yellow(
           `
 Cloud publishing is disabled (${localFlag ? "--local" : "QODEWK_TELEMETRY=off"}).`
         )
       );
-      console.log(import_picocolors3.default.dim("Telemetry remains strictly stored in local SQLite (~/.qodewk/state.db).\n"));
+      console.log(import_picocolors4.default.dim("Telemetry remains strictly stored in local SQLite (~/.qodewk/state.db).\n"));
       persistReceipt(receipt);
       await renderTerminalReceipt(receipt);
       return;
@@ -17466,11 +17882,11 @@ Cloud publishing is disabled (${localFlag ? "--local" : "QODEWK_TELEMETRY=off"})
       body = JSON.stringify(trimmed2);
     }
     if (Buffer.byteLength(body, "utf-8") > SHARE_PAYLOAD_MAX_BYTES2) {
-      console.error(import_picocolors3.default.red("Sanitized receipt still exceeds the 50 KB cloud payload limit."));
+      console.error(import_picocolors4.default.red("Sanitized receipt still exceeds the 50 KB cloud payload limit."));
       process.exit(1);
     }
     const endpoint = resolveApiUrl();
-    console.log(import_picocolors3.default.dim(`Publishing receipt ${sanitized.receipt.id} to ${endpoint}...`));
+    console.log(import_picocolors4.default.dim(`Publishing receipt ${sanitized.receipt.id} to ${endpoint}...`));
     try {
       const response = await fetch(endpoint, {
         method: "POST",
@@ -17487,11 +17903,11 @@ Cloud publishing is disabled (${localFlag ? "--local" : "QODEWK_TELEMETRY=off"})
       const data = await response.json();
       persistReceipt(sanitized, data.claimToken);
       console.log("");
-      console.log(import_picocolors3.default.green("  Published successfully."));
-      console.log(`  ${import_picocolors3.default.dim("Public URL:")} ${import_picocolors3.default.underline(import_picocolors3.default.cyan(data.url))}`);
-      console.log(`  ${import_picocolors3.default.bold(import_picocolors3.default.yellow("  Claim token (store securely \u2014 shown once):"))}`);
-      console.log(`  ${import_picocolors3.default.yellow(data.claimToken)}`);
-      console.log(import_picocolors3.default.dim("  Saved to ~/.qodewk/state.db \u2014 required to prove authorship later."));
+      console.log(import_picocolors4.default.green("  Published successfully."));
+      console.log(`  ${import_picocolors4.default.dim("Public URL:")} ${import_picocolors4.default.underline(import_picocolors4.default.cyan(data.url))}`);
+      console.log(`  ${import_picocolors4.default.bold(import_picocolors4.default.yellow("  Claim token (store securely \u2014 shown once):"))}`);
+      console.log(`  ${import_picocolors4.default.yellow(data.claimToken)}`);
+      console.log(import_picocolors4.default.dim("  Saved to ~/.qodewk/state.db \u2014 required to prove authorship later."));
       console.log("");
       await renderTerminalReceipt(sanitized, data.url);
       if (options.json) {
@@ -17499,14 +17915,14 @@ Cloud publishing is disabled (${localFlag ? "--local" : "QODEWK_TELEMETRY=off"})
       }
     } catch (networkErr) {
       const message = networkErr instanceof Error ? networkErr.message : String(networkErr);
-      console.log(import_picocolors3.default.yellow(`
+      console.log(import_picocolors4.default.yellow(`
 Could not reach cloud API (${message}). Rendered locally:`));
       persistReceipt(receipt);
       await renderTerminalReceipt(receipt);
     }
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
-    console.error(import_picocolors3.default.red(`Error sharing receipt: ${message}`));
+    console.error(import_picocolors4.default.red(`Error sharing receipt: ${message}`));
     process.exit(1);
   }
 });
@@ -17524,35 +17940,35 @@ hookCommand.command("install").description("Install non-blocking post-commit and
   try {
     const hooksDir = resolveGitHooksDir();
     if (!hooksDir) {
-      console.error(import_picocolors3.default.red("Error: Current directory is not a Git repository (.git not found)."));
+      console.error(import_picocolors4.default.red("Error: Current directory is not a Git repository (.git not found)."));
       process.exit(1);
     }
-    if (!fs14.existsSync(hooksDir)) {
-      fs14.mkdirSync(hooksDir, { recursive: true });
+    if (!fs15.existsSync(hooksDir)) {
+      fs15.mkdirSync(hooksDir, { recursive: true });
     }
     const targets = ["post-commit", "post-rewrite"];
     let installed = 0;
     let existing = 0;
     for (const name of targets) {
-      const result = installHookFile(path15.join(hooksDir, name));
+      const result = installHookFile(path16.join(hooksDir, name));
       if (result === "installed") installed++;
       else existing++;
     }
     if (installed === 0 && existing > 0) {
-      console.log(import_picocolors3.default.yellow("Qodewk Git hooks are already installed (post-commit, post-rewrite)."));
+      console.log(import_picocolors4.default.yellow("Qodewk Git hooks are already installed (post-commit, post-rewrite)."));
       return;
     }
     console.log(
-      import_picocolors3.default.green(
+      import_picocolors4.default.green(
         `\u2713 Non-blocking Qodewk hooks installed in ${hooksDir} (post-commit${installed > 1 || existing > 0 ? ", post-rewrite" : installed === 1 && targets.length === 2 ? " + post-rewrite" : ""})`
       )
     );
     if (existing > 0) {
-      console.log(import_picocolors3.default.dim(`  (${existing} hook file(s) already contained the Qodewk marker)`));
+      console.log(import_picocolors4.default.dim(`  (${existing} hook file(s) already contained the Qodewk marker)`));
     }
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
-    console.error(import_picocolors3.default.red(`Failed to install Git hook: ${message}`));
+    console.error(import_picocolors4.default.red(`Failed to install Git hook: ${message}`));
     process.exit(1);
   }
 });
@@ -17560,23 +17976,42 @@ hookCommand.command("uninstall").description("Remove Qodewk post-commit and post
   try {
     const hooksDir = resolveGitHooksDir();
     if (!hooksDir) {
-      console.log(import_picocolors3.default.yellow("No Git repository found."));
+      console.log(import_picocolors4.default.yellow("No Git repository found."));
       return;
     }
     const targets = ["post-commit", "post-rewrite"];
     let removed = 0;
     for (const name of targets) {
-      const result = uninstallHookFile(path15.join(hooksDir, name));
+      const result = uninstallHookFile(path16.join(hooksDir, name));
       if (result === "removed") removed++;
     }
     if (removed === 0) {
-      console.log(import_picocolors3.default.yellow("Qodewk hooks are not installed."));
+      console.log(import_picocolors4.default.yellow("Qodewk hooks are not installed."));
       return;
     }
-    console.log(import_picocolors3.default.green(`\u2713 Qodewk hook markers removed from ${removed} file(s).`));
+    console.log(import_picocolors4.default.green(`\u2713 Qodewk hook markers removed from ${removed} file(s).`));
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(import_picocolors4.default.red(`Failed to uninstall hook: ${message}`));
+    process.exit(1);
+  }
+});
+hookCommand.command("test").aliases(["verify", "check"]).description("Verify non-blocking Git hook installation and benchmark latency (< 5ms invariant)").option("-j, --json", "Output benchmark in JSON format").action(async (options) => {
+  try {
+    const hooks = auditGitHooks();
+    const benchmark = await benchmarkHookLatency();
+    const isJson = Boolean(options.json || program2.opts().json);
+    if (isJson) {
+      console.log(JSON.stringify({ hooks, benchmark }, null, 2));
+    } else {
+      console.log(formatHookTestReport(hooks, benchmark));
+    }
+    if (!benchmark.passedInvariant) {
+      process.exit(1);
+    }
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
-    console.error(import_picocolors3.default.red(`Failed to uninstall hook: ${message}`));
+    console.error(import_picocolors4.default.red(`Error testing hooks: ${message}`));
     process.exit(1);
   }
 });
@@ -17585,7 +18020,7 @@ notesCmd.command("show [commit]").description("Display Qodewk receipt attached t
   try {
     const receipt = await readGitReceiptNote(commit);
     if (!receipt) {
-      console.log(import_picocolors3.default.yellow(`No Qodewk receipt note found on commit '${commit}'.`));
+      console.log(import_picocolors4.default.yellow(`No Qodewk receipt note found on commit '${commit}'.`));
       return;
     }
     if (opts.json) {
@@ -17595,7 +18030,7 @@ notesCmd.command("show [commit]").description("Display Qodewk receipt attached t
     }
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
-    console.error(import_picocolors3.default.red(`Error reading Git note: ${message}`));
+    console.error(import_picocolors4.default.red(`Error reading Git note: ${message}`));
     process.exit(1);
   }
 });
@@ -17604,11 +18039,11 @@ notesCmd.command("write [commit]").description("Generate and attach receipt to a
     const receipt = await generateReceipt({ headSha: commit });
     await writeGitReceiptNote(receipt.repository.headSha, receipt);
     console.log(
-      import_picocolors3.default.green(`\u2713 Attached receipt note to ${receipt.repository.headSha.slice(0, 7)} (refs/notes/qodewk)`)
+      import_picocolors4.default.green(`\u2713 Attached receipt note to ${receipt.repository.headSha.slice(0, 7)} (refs/notes/qodewk)`)
     );
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
-    console.error(import_picocolors3.default.red(`Error writing Git note: ${message}`));
+    console.error(import_picocolors4.default.red(`Error writing Git note: ${message}`));
     process.exit(1);
   }
 });
@@ -17616,16 +18051,16 @@ notesCmd.command("list").description("List all commits with attached Qodewk rece
   try {
     const shas = await listGitReceiptNotes();
     if (shas.length === 0) {
-      console.log(import_picocolors3.default.yellow("No Qodewk Git notes found in repository."));
+      console.log(import_picocolors4.default.yellow("No Qodewk Git notes found in repository."));
       return;
     }
-    console.log(import_picocolors3.default.bold(`Found ${shas.length} commit note(s) in refs/notes/qodewk:`));
+    console.log(import_picocolors4.default.bold(`Found ${shas.length} commit note(s) in refs/notes/qodewk:`));
     for (const sha of shas) {
-      console.log(`  ${import_picocolors3.default.cyan(sha.slice(0, 10))} ${import_picocolors3.default.dim(sha)}`);
+      console.log(`  ${import_picocolors4.default.cyan(sha.slice(0, 10))} ${import_picocolors4.default.dim(sha)}`);
     }
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
-    console.error(import_picocolors3.default.red(`Error listing Git notes: ${message}`));
+    console.error(import_picocolors4.default.red(`Error listing Git notes: ${message}`));
     process.exit(1);
   }
 });