qodewk 0.2.3 → 0.4.0

package/dist/index.cjs

@@ -1153,8 +1153,8 @@ var require_command = __commonJS({
     "use strict";
     var EventEmitter2 = require("events").EventEmitter;
     var childProcess = require("child_process");
-    var path8 = require("path");
-    var fs7 = require("fs");
+    var path9 = require("path");
+    var fs9 = require("fs");
     var process2 = require("process");
     var { Argument: Argument2, humanReadableArgName } = require_argument();
     var { CommanderError: CommanderError2 } = require_error();
@@ -2135,7 +2135,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} subcommandName
        */
       _checkForMissingExecutable(executableFile, executableDir, subcommandName) {
-        if (fs7.existsSync(executableFile)) return;
+        if (fs9.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
@@ -2153,11 +2153,11 @@ Expecting one of '${allowedValues.join("', '")}'`);
         let launchWithNode = false;
         const sourceExt = [".js", ".ts", ".tsx", ".mjs", ".cjs"];
         function findFile(baseDir, baseName) {
-          const localBin = path8.resolve(baseDir, baseName);
-          if (fs7.existsSync(localBin)) return localBin;
-          if (sourceExt.includes(path8.extname(baseName))) return void 0;
+          const localBin = path9.resolve(baseDir, baseName);
+          if (fs9.existsSync(localBin)) return localBin;
+          if (sourceExt.includes(path9.extname(baseName))) return void 0;
           const foundExt = sourceExt.find(
-            (ext) => fs7.existsSync(`${localBin}${ext}`)
+            (ext) => fs9.existsSync(`${localBin}${ext}`)
           );
           if (foundExt) return `${localBin}${foundExt}`;
           return void 0;
@@ -2169,21 +2169,21 @@ Expecting one of '${allowedValues.join("', '")}'`);
         if (this._scriptPath) {
           let resolvedScriptPath;
           try {
-            resolvedScriptPath = fs7.realpathSync(this._scriptPath);
+            resolvedScriptPath = fs9.realpathSync(this._scriptPath);
           } catch {
             resolvedScriptPath = this._scriptPath;
           }
-          executableDir = path8.resolve(
-            path8.dirname(resolvedScriptPath),
+          executableDir = path9.resolve(
+            path9.dirname(resolvedScriptPath),
             executableDir
           );
         }
         if (executableDir) {
           let localFile = findFile(executableDir, executableFile);
           if (!localFile && !subcommand._executableFile && this._scriptPath) {
-            const legacyName = path8.basename(
+            const legacyName = path9.basename(
               this._scriptPath,
-              path8.extname(this._scriptPath)
+              path9.extname(this._scriptPath)
             );
             if (legacyName !== this._name) {
               localFile = findFile(
@@ -2194,7 +2194,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
           }
           executableFile = localFile || executableFile;
         }
-        launchWithNode = sourceExt.includes(path8.extname(executableFile));
+        launchWithNode = sourceExt.includes(path9.extname(executableFile));
         let proc;
         if (process2.platform !== "win32") {
           if (launchWithNode) {
@@ -3041,7 +3041,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @return {Command}
        */
       nameFromFilename(filename) {
-        this._name = path8.basename(filename, path8.extname(filename));
+        this._name = path9.basename(filename, path9.extname(filename));
         return this;
       }
       /**
@@ -3055,9 +3055,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} [path]
        * @return {(string|null|Command)}
        */
-      executableDir(path9) {
-        if (path9 === void 0) return this._executableDir;
-        this._executableDir = path9;
+      executableDir(path10) {
+        if (path10 === void 0) return this._executableDir;
+        this._executableDir = path10;
         return this;
       }
       /**
@@ -4067,10 +4067,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(path8, isFile, isDirectory) {
-      log(`checking %s`, path8);
+    function check(path9, isFile, isDirectory) {
+      log(`checking %s`, path9);
       try {
-        const stat = fs_1.statSync(path8);
+        const stat = fs_1.statSync(path9);
         if (stat.isFile() && isFile) {
           log(`[OK] path represents a file`);
           return true;
@@ -4090,8 +4090,8 @@ var require_src2 = __commonJS({
         throw e;
       }
     }
-    function exists2(path8, type = exports2.READABLE) {
-      return check(path8, (type & exports2.FILE) > 0, (type & exports2.FOLDER) > 0);
+    function exists2(path9, type = exports2.READABLE) {
+      return check(path9, (type & exports2.FILE) > 0, (type & exports2.FOLDER) > 0);
     }
     exports2.exists = exists2;
     exports2.FILE = 1;
@@ -4155,8 +4155,8 @@ var require_dist2 = __commonJS({
 });
 
 // src/index.ts
-var fs6 = __toESM(require("fs"), 1);
-var path7 = __toESM(require("path"), 1);
+var fs8 = __toESM(require("fs"), 1);
+var path8 = __toESM(require("path"), 1);
 
 // ../../node_modules/.pnpm/commander@13.1.0/node_modules/commander/esm.mjs
 var import_index = __toESM(require_commander(), 1);
@@ -4176,204 +4176,7 @@ var {
 } = import_index.default;
 
 // src/index.ts
-var import_picocolors = __toESM(require_picocolors(), 1);
-
-// src/barcode.ts
-var CODE128_PATTERNS = [
-  "11011001100",
-  "11001101100",
-  "11001100110",
-  "10010011000",
-  "10010001100",
-  "10001001100",
-  "10011001000",
-  "10011000100",
-  "10001100100",
-  "11001001000",
-  "11001000100",
-  "11000100100",
-  "10110011100",
-  "10011011100",
-  "10011001110",
-  "10111001100",
-  "10011101100",
-  "10011100110",
-  "11001110010",
-  "11001011100",
-  "11001001110",
-  "11011100100",
-  "11001110100",
-  "11101101110",
-  "11101001100",
-  "11100101100",
-  "11100100110",
-  "11101100100",
-  "11100110100",
-  "11100110010",
-  "11011011000",
-  "11011000110",
-  "11000110110",
-  "10100011000",
-  "10001011000",
-  "10001000110",
-  "10110001000",
-  "10001101000",
-  "10001100010",
-  "11010001000",
-  "11000101000",
-  "11000100010",
-  "10110111000",
-  "10110001110",
-  "10001101110",
-  "10111011000",
-  "10111000110",
-  "10001110110",
-  "11101110110",
-  "11010001110",
-  "11000101110",
-  "11011101000",
-  "11011100010",
-  "11011101110",
-  "11101011000",
-  "11101000110",
-  "11100010110",
-  "11101101000",
-  "11101100010",
-  "11100011010",
-  "11101111010",
-  "11001000010",
-  "11110001010",
-  "10100110000",
-  "10100001100",
-  "10010110000",
-  "10010000110",
-  "10000101100",
-  "10000100110",
-  "10110010000",
-  "10110000100",
-  "10011010000",
-  "10011000010",
-  "10000110100",
-  "10000110010",
-  "11000010010",
-  "11001010000",
-  "11110111010",
-  "11000010100",
-  "10001111010",
-  "10100111100",
-  "10010111100",
-  "10010011110",
-  "10111100100",
-  "10011110100",
-  "10011110010",
-  "11110100100",
-  "11110010100",
-  "11110010010",
-  "11011011110",
-  "11011110110",
-  "11110110110",
-  "10101111000",
-  "10100011110",
-  "10001011110",
-  "10111101000",
-  "10111100010",
-  "11110101000",
-  "11110100010",
-  "10111011110",
-  "10111101110",
-  "11101011110",
-  "11110101110",
-  "11010000100",
-  "11010010000",
-  "11010011100",
-  "1100011101011"
-];
-var START_B = 104;
-var STOP = 106;
-function encodeCode128B(text) {
-  const codes = [START_B];
-  for (const ch of text) {
-    const code = ch.charCodeAt(0) - 32;
-    if (code < 0 || code > 95) {
-      throw new Error(`Code 128-B cannot encode character: ${JSON.stringify(ch)}`);
-    }
-    codes.push(code);
-  }
-  let checksum = START_B;
-  for (let i2 = 1; i2 < codes.length; i2++) {
-    checksum += codes[i2] * i2;
-  }
-  codes.push(checksum % 103);
-  codes.push(STOP);
-  return codes;
-}
-function code128Modules(text) {
-  const codes = encodeCode128B(text);
-  let modules = "";
-  for (const code of codes) {
-    modules += CODE128_PATTERNS[code] ?? "";
-  }
-  return modules;
-}
-function renderTerminalBarcode(text, options = {}) {
-  const maxWidth = Math.max(16, options.maxWidth ?? 52);
-  const height = Math.max(2, options.height ?? 3);
-  const quietZone = Math.max(0, options.quietZone ?? 10);
-  let payload = text;
-  payload = [...payload].filter((ch) => {
-    const c3 = ch.charCodeAt(0);
-    return c3 >= 32 && c3 <= 126;
-  }).join("");
-  if (!payload) payload = "QODEWK";
-  let modules;
-  try {
-    modules = code128Modules(payload);
-  } catch {
-    modules = code128Modules("QODEWK");
-  }
-  const withQuiet = "0".repeat(quietZone) + modules + "0".repeat(quietZone);
-  const scaled = downsampleModules(withQuiet, maxWidth);
-  const row = modulesToBlocks(scaled);
-  return Array.from({ length: height }, () => row);
-}
-function downsampleModules(modules, maxWidth) {
-  if (modules.length <= maxWidth) return modules;
-  const out = [];
-  const ratio = modules.length / maxWidth;
-  for (let i2 = 0; i2 < maxWidth; i2++) {
-    const start = Math.floor(i2 * ratio);
-    const end = Math.max(start + 1, Math.floor((i2 + 1) * ratio));
-    let bars = 0;
-    for (let j2 = start; j2 < end && j2 < modules.length; j2++) {
-      if (modules[j2] === "1") bars++;
-    }
-    out.push(bars * 2 >= end - start ? "1" : "0");
-  }
-  return out.join("");
-}
-function modulesToBlocks(modules) {
-  let out = "";
-  for (const bit of modules) {
-    out += bit === "1" ? "\u2588" : " ";
-  }
-  return out;
-}
-function pickBarcodePayload(input) {
-  const maxChars = input.maxChars ?? 24;
-  const candidates = [];
-  if (input.publicUrl) candidates.push(input.publicUrl);
-  if (input.displayHost && input.receiptId) {
-    candidates.push(`${input.displayHost}/r/${input.receiptId}`);
-  }
-  candidates.push(input.receiptId);
-  if (input.receiptId.length > 12) {
-    candidates.push(input.receiptId.replace(/^rec_/, "").slice(0, 12));
-  }
-  for (const c3 of candidates) {
-    if (c3.length <= maxChars) return c3;
-  }
-  return candidates[candidates.length - 1].slice(0, maxChars);
-}
+var import_picocolors3 = __toESM(require_picocolors(), 1);
 
 // ../core/dist/index.js
 var crypto2 = __toESM(require("crypto"), 1);
@@ -4856,8 +4659,8 @@ function getErrorMap() {
 
 // ../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/helpers/parseUtil.js
 var makeIssue = (params) => {
-  const { data, path: path8, errorMaps, issueData } = params;
-  const fullPath = [...path8, ...issueData.path || []];
+  const { data, path: path9, errorMaps, issueData } = params;
+  const fullPath = [...path9, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -4973,11 +4776,11 @@ var errorUtil;
 
 // ../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value, path8, key) {
+  constructor(parent, value, path9, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path8;
+    this._path = path9;
     this._key = key;
   }
   get path() {
@@ -9089,8 +8892,8 @@ function toLinesWithContent(input = "", trimmed2 = true, separator = "\n") {
 function forEachLineWithContent(input, callback) {
   return toLinesWithContent(input, true).map((line) => callback(line));
 }
-function folderExists(path8) {
-  return (0, import_file_exists.exists)(path8, import_file_exists.FOLDER);
+function folderExists(path9) {
+  return (0, import_file_exists.exists)(path9, import_file_exists.FOLDER);
 }
 function append(target, item) {
   if (Array.isArray(target)) {
@@ -9492,8 +9295,8 @@ function checkIsRepoRootTask() {
     commands,
     format: "utf-8",
     onError,
-    parser(path8) {
-      return /^\.(git)?$/.test(path8.trim());
+    parser(path9) {
+      return /^\.(git)?$/.test(path9.trim());
     }
   };
 }
@@ -9927,11 +9730,11 @@ function parseGrep(grep) {
   const paths = /* @__PURE__ */ new Set();
   const results = {};
   forEachLineWithContent(grep, (input) => {
-    const [path8, line, preview] = input.split(NULL);
-    paths.add(path8);
-    (results[path8] = results[path8] || []).push({
+    const [path9, line, preview] = input.split(NULL);
+    paths.add(path9);
+    (results[path9] = results[path9] || []).push({
       line: asNumber(line),
-      path: path8,
+      path: path9,
       preview
     });
   });
@@ -10695,14 +10498,14 @@ var init_hash_object = __esm({
     init_task();
   }
 });
-function parseInit(bare, path8, text) {
+function parseInit(bare, path9, text) {
   const response = String(text).trim();
   let result;
   if (result = initResponseRegex.exec(response)) {
-    return new InitSummary(bare, path8, false, result[1]);
+    return new InitSummary(bare, path9, false, result[1]);
   }
   if (result = reInitResponseRegex.exec(response)) {
-    return new InitSummary(bare, path8, true, result[1]);
+    return new InitSummary(bare, path9, true, result[1]);
   }
   let gitDir = "";
   const tokens = response.split(" ");
@@ -10713,7 +10516,7 @@ function parseInit(bare, path8, text) {
       break;
     }
   }
-  return new InitSummary(bare, path8, /^re/i.test(response), gitDir);
+  return new InitSummary(bare, path9, /^re/i.test(response), gitDir);
 }
 var InitSummary;
 var initResponseRegex;
@@ -10722,9 +10525,9 @@ var init_InitSummary = __esm({
   "src/lib/responses/InitSummary.ts"() {
     "use strict";
     InitSummary = class {
-      constructor(bare, path8, existing, gitDir) {
+      constructor(bare, path9, existing, gitDir) {
         this.bare = bare;
-        this.path = path8;
+        this.path = path9;
         this.existing = existing;
         this.gitDir = gitDir;
       }
@@ -10736,7 +10539,7 @@ var init_InitSummary = __esm({
 function hasBareCommand(command) {
   return command.includes(bareCommand);
 }
-function initTask(bare = false, path8, customArgs) {
+function initTask(bare = false, path9, customArgs) {
   const commands = ["init", ...customArgs];
   if (bare && !hasBareCommand(commands)) {
     commands.splice(1, 0, bareCommand);
@@ -10745,7 +10548,7 @@ function initTask(bare = false, path8, customArgs) {
     commands,
     format: "utf-8",
     parser(text) {
-      return parseInit(commands.includes("--bare"), path8, text);
+      return parseInit(commands.includes("--bare"), path9, text);
     }
   };
 }
@@ -11560,12 +11363,12 @@ var init_FileStatusSummary = __esm({
     "use strict";
     fromPathRegex = /^(.+)\0(.+)$/;
     FileStatusSummary = class {
-      constructor(path8, index, working_dir) {
-        this.path = path8;
+      constructor(path9, index, working_dir) {
+        this.path = path9;
         this.index = index;
         this.working_dir = working_dir;
         if (index === "R" || working_dir === "R") {
-          const detail = fromPathRegex.exec(path8) || [null, path8, path8];
+          const detail = fromPathRegex.exec(path9) || [null, path9, path9];
           this.from = detail[2] || "";
           this.path = detail[1] || "";
         }
@@ -11596,14 +11399,14 @@ function splitLine(result, lineStr) {
     default:
       return;
   }
-  function data(index, workingDir, path8) {
+  function data(index, workingDir, path9) {
     const raw = `${index}${workingDir}`;
     const handler = parsers6.get(raw);
     if (handler) {
-      handler(result, path8);
+      handler(result, path9);
     }
     if (raw !== "##" && raw !== "!!") {
-      result.files.push(new FileStatusSummary(path8, index, workingDir));
+      result.files.push(new FileStatusSummary(path9, index, workingDir));
     }
   }
 }
@@ -11954,9 +11757,9 @@ var init_simple_git_api = __esm({
           next
         );
       }
-      hashObject(path8, write) {
+      hashObject(path9, write) {
         return this._runTask(
-          hashObjectTask(path8, write === true),
+          hashObjectTask(path9, write === true),
           trailingFunctionArgument(arguments)
         );
       }
@@ -12310,8 +12113,8 @@ var init_branch = __esm({
   }
 });
 function toPath(input) {
-  const path8 = input.trim().replace(/^["']|["']$/g, "");
-  return path8 && (0, import_node_path.normalize)(path8);
+  const path9 = input.trim().replace(/^["']|["']$/g, "");
+  return path9 && (0, import_node_path.normalize)(path9);
 }
 var parseCheckIgnore;
 var init_CheckIgnore = __esm({
@@ -12596,8 +12399,8 @@ __export2(sub_module_exports, {
   subModuleTask: () => subModuleTask,
   updateSubModuleTask: () => updateSubModuleTask
 });
-function addSubModuleTask(repo, path8) {
-  return subModuleTask(["add", repo, path8]);
+function addSubModuleTask(repo, path9) {
+  return subModuleTask(["add", repo, path9]);
 }
 function initSubModuleTask(customArgs) {
   return subModuleTask(["init", ...customArgs]);
@@ -12911,8 +12714,8 @@ var require_git = __commonJS2({
       }
       return this._runTask(straightThroughStringTask2(command, this._trimmed), next);
     };
-    Git2.prototype.submoduleAdd = function(repo, path8, then) {
-      return this._runTask(addSubModuleTask2(repo, path8), trailingFunctionArgument2(arguments));
+    Git2.prototype.submoduleAdd = function(repo, path9, then) {
+      return this._runTask(addSubModuleTask2(repo, path9), trailingFunctionArgument2(arguments));
     };
     Git2.prototype.submoduleUpdate = function(args, then) {
       return this._runTask(
@@ -13493,6 +13296,57 @@ function parseSinceOption(since) {
   }
   return void 0;
 }
+async function resolveGitSha(git, ref) {
+  const trimmed2 = ref.trim();
+  if (!trimmed2) {
+    throw new Error("Git reference cannot be empty.");
+  }
+  try {
+    const full = (await git.raw(["rev-parse", "--verify", trimmed2])).trim();
+    if (/^[0-9a-f]{40}$/i.test(full)) {
+      return full.toLowerCase();
+    }
+  } catch {
+  }
+  try {
+    const full = (await git.raw(["rev-parse", trimmed2])).trim();
+    if (/^[0-9a-f]{40}$/i.test(full)) {
+      return full.toLowerCase();
+    }
+  } catch {
+  }
+  try {
+    const fullOrigin = (await git.raw(["rev-parse", `origin/${trimmed2}`])).trim();
+    if (/^[0-9a-f]{40}$/i.test(fullOrigin)) {
+      return fullOrigin.toLowerCase();
+    }
+  } catch {
+  }
+  try {
+    const fullRef = (await git.raw(["rev-parse", `refs/heads/${trimmed2}`])).trim();
+    if (/^[0-9a-f]{40}$/i.test(fullRef)) {
+      return fullRef.toLowerCase();
+    }
+  } catch {
+  }
+  if (/^[0-9a-f]{40}$/i.test(trimmed2)) {
+    return trimmed2.toLowerCase();
+  }
+  throw new Error(`Unable to resolve git reference '${ref}' to a valid commit SHA.`);
+}
+async function detectDefaultBaseBranch(git) {
+  const candidates = ["origin/main", "main", "origin/master", "master"];
+  for (const c3 of candidates) {
+    try {
+      const sha = (await git.raw(["rev-parse", "--verify", c3])).trim();
+      if (/^[0-9a-f]{40}$/i.test(sha)) {
+        return c3;
+      }
+    } catch {
+    }
+  }
+  return "main";
+}
 async function extractGitMetrics(optionsOrPath = process.cwd()) {
   const options = typeof optionsOrPath === "string" ? { repoPath: optionsOrPath } : optionsOrPath;
   const repoPath = options.repoPath || process.cwd();
@@ -13503,9 +13357,22 @@ async function extractGitMetrics(optionsOrPath = process.cwd()) {
   }
   const branchSummary = await git.branch();
   const branch = branchSummary.current || "HEAD";
-  let headSha = options.headSha || "0000000000000000000000000000000000000000";
-  let baseSha = options.baseSha;
+  let headSha;
+  if (options.headSha) {
+    headSha = await resolveGitSha(git, options.headSha);
+  } else {
+    try {
+      headSha = (await git.raw(["rev-parse", "HEAD"])).trim().toLowerCase();
+    } catch {
+      headSha = "0000000000000000000000000000000000000000";
+    }
+  }
+  let baseSha = void 0;
+  if (options.baseSha) {
+    baseSha = await resolveGitSha(git, options.baseSha);
+  }
   let commitMessage = void 0;
+  let commitDate = void 0;
   let commitsCount = 1;
   const sinceDate = parseSinceOption(options.since);
   if (sinceDate && !options.baseSha) {
@@ -13537,6 +13404,7 @@ async function extractGitMetrics(optionsOrPath = process.cwd()) {
           headSha = log.latest.hash;
         }
         commitMessage = log.latest.message;
+        commitDate = log.latest.date;
         if (!options.baseSha && log.all.length > 1 && log.all[1]) {
           baseSha = log.all[1].hash;
         }
@@ -13544,6 +13412,27 @@ async function extractGitMetrics(optionsOrPath = process.cwd()) {
     } catch {
     }
   }
+  if (!commitMessage && headSha && headSha !== "0000000000000000000000000000000000000000") {
+    try {
+      const headLog = await git.show(["-s", "--format=%B%x00%aI", headSha]);
+      const parts = headLog.split("\0");
+      if (parts[0])
+        commitMessage = parts[0].trim();
+      if (parts[1])
+        commitDate = parts[1].trim();
+    } catch {
+    }
+  }
+  if (baseSha && headSha && baseSha !== headSha) {
+    try {
+      const countRaw = await git.raw(["rev-list", "--count", `${baseSha}..${headSha}`]);
+      const count = parseInt(countRaw.trim(), 10);
+      if (!isNaN(count) && count > 0) {
+        commitsCount = count;
+      }
+    } catch {
+    }
+  }
   let repoIdentifier = path.basename(path.resolve(repoPath));
   try {
     const remotes = await git.getRemotes(true);
@@ -13556,22 +13445,34 @@ async function extractGitMetrics(optionsOrPath = process.cwd()) {
   const projectAlias = path.basename(path.resolve(repoPath)).toLowerCase().replace(/[^a-z0-9_-]/g, "-");
   const repoHash = computeSaltedHash(repoIdentifier);
   let diffSummary;
-  if (baseSha && headSha && baseSha !== headSha) {
-    const status = await git.status();
-    if (status.files.length > 0) {
-      diffSummary = await git.diffSummary([baseSha]);
+  try {
+    if (baseSha && headSha && baseSha !== headSha) {
+      const status = await git.status();
+      if (status.files.length > 0) {
+        diffSummary = await git.diffSummary([baseSha]);
+      } else {
+        diffSummary = await git.diffSummary([`${baseSha}...${headSha}`]).catch(async () => {
+          return await git.diffSummary([`${baseSha}..${headSha}`]);
+        });
+      }
     } else {
-      diffSummary = await git.diffSummary([`${baseSha}..${headSha}`]);
+      const status = await git.status();
+      if (status.files.length > 0) {
+        diffSummary = await git.diffSummary(["HEAD"]);
+      } else if (baseSha) {
+        diffSummary = await git.diffSummary([`${baseSha}..${headSha}`]);
+      } else if (headSha !== "0000000000000000000000000000000000000000") {
+        diffSummary = await git.diffSummary([`${headSha}~1..${headSha}`]).catch(async () => {
+          return await git.diffSummary([headSha]);
+        });
+      } else {
+        diffSummary = { changed: 0, insertions: 0, deletions: 0, files: [] };
+      }
     }
-  } else {
-    const status = await git.status();
-    if (status.files.length > 0) {
+  } catch {
+    try {
       diffSummary = await git.diffSummary(["HEAD"]);
-    } else if (baseSha) {
-      diffSummary = await git.diffSummary([`${baseSha}..${headSha}`]);
-    } else if (headSha !== "0000000000000000000000000000000000000000") {
-      diffSummary = await git.diffSummary([headSha]);
-    } else {
+    } catch {
       diffSummary = { changed: 0, insertions: 0, deletions: 0, files: [] };
     }
   }
@@ -13621,6 +13522,7 @@ async function extractGitMetrics(optionsOrPath = process.cwd()) {
     repoHash,
     projectAlias,
     commitMessage,
+    commitDate,
     commitsCount
   };
 }
@@ -13757,7 +13659,17 @@ var RATE_CARDS = {
     cacheWritePerMTok: 3.75,
     contextWindow: 2e5
   },
-  "claude-3-7-sonnet": {
+  "claude-sonnet-4": {
+    id: "claude-sonnet-4",
+    provider: "anthropic",
+    name: "Claude Sonnet 4",
+    inputPerMTok: 3,
+    outputPerMTok: 15,
+    cacheReadPerMTok: 0.3,
+    cacheWritePerMTok: 3.75,
+    contextWindow: 2e5
+  },
+  "claude-3-7-sonnet": {
     id: "claude-3-7-sonnet",
     provider: "anthropic",
     name: "Claude 3.7 Sonnet",
@@ -13798,6 +13710,26 @@ var RATE_CARDS = {
     cacheWritePerMTok: 2.5,
     contextWindow: 128e3
   },
+  "gpt-4o-mini": {
+    id: "gpt-4o-mini",
+    provider: "openai",
+    name: "GPT-4o Mini",
+    inputPerMTok: 0.15,
+    outputPerMTok: 0.6,
+    cacheReadPerMTok: 0.075,
+    cacheWritePerMTok: 0.15,
+    contextWindow: 128e3
+  },
+  "o1": {
+    id: "o1",
+    provider: "openai",
+    name: "o1",
+    inputPerMTok: 15,
+    outputPerMTok: 60,
+    cacheReadPerMTok: 7.5,
+    cacheWritePerMTok: 15,
+    contextWindow: 2e5
+  },
   "o3-mini": {
     id: "o3-mini",
     provider: "openai",
@@ -13889,31 +13821,163 @@ function getRateCard(modelId) {
   if (RATE_CARDS[key])
     return RATE_CARDS[key];
   if (key.includes("opus")) {
-    return RATE_CARDS["claude-opus-4-6-thinking"] || RATE_CARDS["claude-opus-4"];
+    return RATE_CARDS["claude-opus-4-6-thinking"] ?? RATE_CARDS["claude-opus-4"];
+  }
+  if (key.includes("sonnet")) {
+    if (key.includes("4-6") || key.includes("thinking")) {
+      return RATE_CARDS["claude-sonnet-4-6-thinking"];
+    }
+    if (key.includes("3-7") || key.includes("sonnet-3-7")) {
+      return RATE_CARDS["claude-3-7-sonnet"];
+    }
+    if (key.includes("3-5") || key.includes("sonnet-3-5")) {
+      return RATE_CARDS["claude-3-5-sonnet"];
+    }
+    if (key.includes("sonnet-4") || key.includes("claude-4") || key.includes("sonnet-v4")) {
+      return RATE_CARDS["claude-sonnet-4"] ?? RATE_CARDS["claude-sonnet-4-6-thinking"];
+    }
+  }
+  if (key.includes("o1-mini") || key.includes("o3-mini")) {
+    return RATE_CARDS["o3-mini"];
   }
-  if (key.includes("sonnet") && (key.includes("4-6") || key.includes("thinking"))) {
-    return RATE_CARDS["claude-sonnet-4-6-thinking"];
+  if (key.includes("o1")) {
+    return RATE_CARDS["o1"];
   }
-  if (key.includes("3-7") || key.includes("sonnet-3-7")) {
-    return RATE_CARDS["claude-3-7-sonnet"];
+  if (key.includes("4o-mini")) {
+    return RATE_CARDS["gpt-4o-mini"];
   }
-  if (key.includes("3-5") || key.includes("sonnet-3-5")) {
-    return RATE_CARDS["claude-3-5-sonnet"];
+  if (key.includes("4o")) {
+    return RATE_CARDS["gpt-4o"];
   }
   if (key.includes("gemini") && key.includes("flash")) {
-    return RATE_CARDS["gemini-3-8-flash"] || RATE_CARDS["gemini-2-0-flash"];
+    return RATE_CARDS["gemini-3-8-flash"] ?? RATE_CARDS["gemini-2-0-flash"];
   }
   if (key.includes("gemini") && (key.includes("pro") || key.includes("2-5"))) {
-    return RATE_CARDS["gemini-2-5-pro"] || RATE_CARDS["gemini-1-5-pro"];
+    return RATE_CARDS["gemini-2-5-pro"] ?? RATE_CARDS["gemini-1-5-pro"];
   }
   return RATE_CARDS["default"];
 }
-function computeCost(inputTokens, outputTokens, cachedTokens, card) {
+function computeCost(inputTokens, outputTokens, cachedTokens, card, cacheWriteTokens = 0) {
   const freshInput = Math.max(0, inputTokens - cachedTokens);
   const freshCost = freshInput / 1e6 * card.inputPerMTok;
-  const cacheCost = cachedTokens / 1e6 * card.cacheReadPerMTok;
+  const cacheReadCost = cachedTokens / 1e6 * card.cacheReadPerMTok;
+  const cacheWriteCost = cacheWriteTokens / 1e6 * card.cacheWritePerMTok;
   const outCost = outputTokens / 1e6 * card.outputPerMTok;
-  return Number((freshCost + cacheCost + outCost).toFixed(4));
+  return Number((freshCost + cacheReadCost + cacheWriteCost + outCost).toFixed(4));
+}
+
+// ../core/dist/harvester/scoring.js
+function normalizeFilePath(filePath, repoPath) {
+  let p2 = filePath.replace(/\\/g, "/").trim();
+  p2 = p2.replace(/^file:\/\/\/?/, "");
+  if (repoPath) {
+    const normRepo = repoPath.replace(/\\/g, "/").replace(/\/$/, "");
+    if (p2.toLowerCase().startsWith(normRepo.toLowerCase())) {
+      p2 = p2.slice(normRepo.length);
+    }
+  }
+  p2 = p2.replace(/^\.?\//, "");
+  return p2.toLowerCase();
+}
+function scoreFootprint(fp, gitCtx) {
+  if (!gitCtx) {
+    return 0.5;
+  }
+  let score = 0.1;
+  if (fp.boundCommitSha && gitCtx.headSha) {
+    const bound = fp.boundCommitSha.toLowerCase().trim();
+    const head = gitCtx.headSha.toLowerCase().trim();
+    if (bound === head || bound.startsWith(head.slice(0, 7)) || head.startsWith(bound.slice(0, 7))) {
+      score += 1;
+    } else {
+      score -= 0.5;
+    }
+  }
+  if (gitCtx.changedFiles && gitCtx.changedFiles.length > 0) {
+    const normChanged = gitCtx.changedFiles.map((f) => normalizeFilePath(f, fp.repoPath));
+    const normEdited = (fp.filesEdited || []).map((f) => normalizeFilePath(f, fp.repoPath));
+    if (normEdited.length > 0) {
+      let matches = 0;
+      for (const cf of normChanged) {
+        const found = normEdited.some((ef) => ef === cf || cf.endsWith("/" + ef) || ef.endsWith("/" + cf) || cf.endsWith(ef) || ef.endsWith(cf));
+        if (found)
+          matches++;
+      }
+      const ratio = matches / normChanged.length;
+      if (matches > 0) {
+        score += ratio * 0.4;
+      } else {
+        score -= 0.15;
+      }
+    }
+  }
+  if (gitCtx.commitDate && fp.timestamp) {
+    try {
+      const commitTime = new Date(gitCtx.commitDate).getTime();
+      const fpTime = new Date(fp.timestamp).getTime();
+      if (!isNaN(commitTime) && !isNaN(fpTime)) {
+        const diffMinutes = Math.abs(commitTime - fpTime) / (60 * 1e3);
+        if (diffMinutes <= 15) {
+          score += 0.25;
+        } else if (diffMinutes <= 60) {
+          score += 0.2;
+        } else if (diffMinutes <= 180) {
+          score += 0.15;
+        } else if (diffMinutes <= 720) {
+          score += 0.08;
+        } else if (diffMinutes <= 1440) {
+          score += 0.03;
+        } else {
+          score -= 0.1;
+        }
+      }
+    } catch {
+    }
+  }
+  switch (fp.mode) {
+    case "verified":
+      score += 0.1;
+      break;
+    case "observed":
+      score += 0.08;
+      break;
+    case "imported":
+      score += 0.05;
+      break;
+    case "estimated":
+      score += 0.02;
+      break;
+    default:
+      break;
+  }
+  return Math.max(0, Math.round(score * 100) / 100);
+}
+function selectPrimaryFootprint(footprints, gitCtx) {
+  if (footprints.length === 0) {
+    return { primary: void 0, rankedFootprints: [] };
+  }
+  if (!gitCtx || !gitCtx.headSha && !gitCtx.commitDate && (!gitCtx.changedFiles || gitCtx.changedFiles.length === 0)) {
+    const sorted2 = [...footprints].sort((a, b2) => new Date(b2.timestamp).getTime() - new Date(a.timestamp).getTime());
+    return { primary: sorted2[0], rankedFootprints: sorted2 };
+  }
+  const scored = footprints.map((fp) => {
+    const score = scoreFootprint(fp, gitCtx);
+    return {
+      ...fp,
+      attributionScore: score
+    };
+  });
+  scored.sort((a, b2) => {
+    const scoreDiff = (b2.attributionScore || 0) - (a.attributionScore || 0);
+    if (Math.abs(scoreDiff) > 1e-3) {
+      return scoreDiff;
+    }
+    return new Date(b2.timestamp).getTime() - new Date(a.timestamp).getTime();
+  });
+  return {
+    primary: scored[0],
+    rankedFootprints: scored
+  };
 }
 
 // ../core/dist/harvester/antigravity.js
@@ -14002,7 +14066,7 @@ function harvestAntigravityFootprints(repoPath, sinceDate) {
                     if ((tc.name === "replace_file_content" || tc.name === "write_to_file") && tc.args) {
                       const file = tc.args.TargetFile || tc.args.targetFile;
                       if (file) {
-                        filesEdited.add(path3.relative(repoPath, file.replace(/"/g, "")).replace(/\\/g, "/"));
+                        filesEdited.add(normalizeFilePath(String(file), repoPath));
                       }
                     }
                   }
@@ -14094,7 +14158,7 @@ function harvestClaudeFootprints(repoPath, projectAlias, sinceDate) {
           }
           if (data.tool_name === "Edit" || data.tool_name === "Write") {
             if (data.tool_input?.file_path) {
-              filesEdited.add(path4.relative(repoPath, data.tool_input.file_path).replace(/\\/g, "/"));
+              filesEdited.add(normalizeFilePath(String(data.tool_input.file_path), repoPath));
             }
           }
         } catch {
@@ -14154,88 +14218,236 @@ function getSqliteDatabase2() {
 }
 function harvestCursorFootprints(repoPath, sinceDate) {
   const footprints = [];
-  const DatabaseSync2 = getSqliteDatabase2();
-  if (!DatabaseSync2)
-    return footprints;
-  let storageDir = "";
-  if (process.platform === "win32") {
-    storageDir = path5.join(process.env.APPDATA || path5.join(os4.homedir(), "AppData", "Roaming"), "Cursor", "User", "workspaceStorage");
-  } else if (process.platform === "darwin") {
-    storageDir = path5.join(os4.homedir(), "Library", "Application Support", "Cursor", "User", "workspaceStorage");
-  } else {
-    storageDir = path5.join(os4.homedir(), ".config", "Cursor", "User", "workspaceStorage");
-  }
-  if (!fs4.existsSync(storageDir))
-    return footprints;
+  const normTarget = repoPath.toLowerCase().replace(/\\/g, "/").replace(/\/$/, "");
+  const targetBasename = path5.basename(repoPath).toLowerCase();
   try {
-    const normTarget = repoPath.toLowerCase().replace(/\\/g, "/");
-    const wsDirs = fs4.readdirSync(storageDir);
-    for (const ws of wsDirs) {
-      const wsPath = path5.join(storageDir, ws);
-      const wsJsonPath = path5.join(wsPath, "workspace.json");
-      if (!fs4.existsSync(wsJsonPath))
-        continue;
-      try {
-        const wsJson = JSON.parse(fs4.readFileSync(wsJsonPath, "utf-8"));
-        const folder = (wsJson.folder || wsJson.workspace || "").toLowerCase().replace(/\\/g, "/");
-        if (!folder.includes(normTarget) && !normTarget.includes(folder))
-          continue;
-        const dbFile = path5.join(wsPath, "state.vscdb");
-        if (!fs4.existsSync(dbFile))
-          continue;
-        const dbStat = fs4.statSync(dbFile);
-        if (sinceDate && dbStat.mtime < sinceDate)
-          continue;
-        const db = new DatabaseSync2(dbFile, { readOnly: true });
-        const row = db.prepare("SELECT value FROM ItemTable WHERE key = 'workbench.panel.aichat.chatdata' OR key = 'aiService.generations' LIMIT 1").get();
-        if (row && row.value) {
-          const parsed = JSON.parse(row.value);
-          const tabs = parsed.tabs || (Array.isArray(parsed) ? parsed : []);
-          let stepCount = 0;
-          let taskTitle = "";
-          let model = "claude-3-5-sonnet";
-          for (const tab of tabs) {
-            const bubbles = tab.bubbles || [];
-            stepCount += bubbles.length;
-            if (!taskTitle && tab.chatTitle)
-              taskTitle = tab.chatTitle;
-            for (const b2 of bubbles) {
-              if (b2.modelType)
-                model = b2.modelType;
+    const cursorProjectsDir = path5.join(os4.homedir(), ".cursor", "projects");
+    if (fs4.existsSync(cursorProjectsDir)) {
+      const projectDirs = fs4.readdirSync(cursorProjectsDir);
+      for (const pDir of projectDirs) {
+        const cleanPDir = pDir.toLowerCase().replace(/[^a-z0-9]/g, "");
+        const cleanTarget = normTarget.toLowerCase().replace(/[^a-z0-9]/g, "");
+        const cleanBase = targetBasename.replace(/[^a-z0-9]/g, "");
+        if (cleanPDir.includes(cleanTarget) || cleanTarget.includes(cleanPDir) || cleanPDir.endsWith(cleanBase)) {
+          const transcriptsDir = path5.join(cursorProjectsDir, pDir, "agent-transcripts");
+          if (!fs4.existsSync(transcriptsDir))
+            continue;
+          const sessionDirs = fs4.readdirSync(transcriptsDir);
+          for (const sDir of sessionDirs) {
+            const sPath = path5.join(transcriptsDir, sDir);
+            if (!fs4.statSync(sPath).isDirectory())
+              continue;
+            const jsonlFile = path5.join(sPath, `${sDir}.jsonl`);
+            if (!fs4.existsSync(jsonlFile))
+              continue;
+            const stat = fs4.statSync(jsonlFile);
+            if (sinceDate && stat.mtime < sinceDate)
+              continue;
+            try {
+              const content = fs4.readFileSync(jsonlFile, "utf-8");
+              const lines = content.split("\n");
+              let stepCount = 0;
+              let taskTitle = "";
+              let model = "claude-3-5-sonnet";
+              const filesEditedSet = /* @__PURE__ */ new Set();
+              for (const line of lines) {
+                if (!line.trim())
+                  continue;
+                try {
+                  const entry = JSON.parse(line);
+                  if (!taskTitle && entry.role === "user" && entry.message?.content) {
+                    for (const c3 of entry.message.content) {
+                      if (c3.type === "text" && c3.text) {
+                        const m = c3.text.match(/<user_query>\s*([\s\S]*?)\s*<\/user_query>/);
+                        if (m && m[1]) {
+                          taskTitle = m[1].replace(/\n/g, " ").trim().slice(0, 60);
+                        } else if (!c3.text.startsWith("<timestamp>")) {
+                          taskTitle = c3.text.replace(/\n/g, " ").trim().slice(0, 60);
+                        }
+                      }
+                    }
+                  }
+                  if (entry.role === "assistant" && entry.message?.content) {
+                    for (const c3 of entry.message.content) {
+                      if (c3.type === "tool_use") {
+                        stepCount++;
+                        const name = (c3.name || "").toLowerCase();
+                        const inp = c3.input || {};
+                        if (name.includes("replace") || name.includes("edit") || name.includes("write") || name.includes("diff") || name.includes("apply")) {
+                          const target = inp.path || inp.file_path || inp.target_file || inp.file;
+                          if (target && typeof target === "string") {
+                            filesEditedSet.add(normalizeFilePath(target, repoPath));
+                          }
+                        }
+                      }
+                    }
+                  }
+                } catch {
+                }
+              }
+              if (stepCount > 0) {
+                const rateCard = getRateCard(model);
+                const estInput = stepCount * 3e3;
+                const estCached = Math.round(estInput * 0.6);
+                const estOutput = stepCount * 450;
+                const cost = computeCost(estInput, estOutput, estCached, rateCard);
+                footprints.push({
+                  id: `cursor_transcript_${sDir}`,
+                  platform: "cursor",
+                  sessionId: sDir,
+                  repoPath,
+                  taskTitle: taskTitle || "Cursor Agent Session",
+                  model,
+                  stepsCount: stepCount,
+                  filesEdited: Array.from(filesEditedSet),
+                  timestamp: stat.mtime.toISOString(),
+                  tokens: {
+                    input: estInput,
+                    output: estOutput,
+                    cached: estCached
+                  },
+                  cost,
+                  mode: "imported",
+                  confidence: 0.85,
+                  rawTranscriptPath: jsonlFile
+                });
+              }
+            } catch {
             }
           }
-          if (stepCount > 0) {
-            const rateCard = getRateCard(model);
-            const estInput = stepCount * 2500;
-            const estCached = Math.round(estInput * 0.6);
-            const estOutput = stepCount * 250;
-            const cost = computeCost(estInput, estOutput, estCached, rateCard);
-            footprints.push({
-              id: `cursor_${ws}`,
-              platform: "cursor",
-              sessionId: ws,
-              repoPath,
-              taskTitle: taskTitle || "Cursor AI Session",
-              model,
-              stepsCount: stepCount,
-              filesEdited: [],
-              timestamp: dbStat.mtime.toISOString(),
-              tokens: {
-                input: estInput,
-                output: estOutput,
-                cached: estCached
-              },
-              cost,
-              mode: "imported",
-              confidence: 0.85,
-              rawTranscriptPath: dbFile
-            });
+        }
+      }
+    }
+  } catch {
+  }
+  const DatabaseSync2 = getSqliteDatabase2();
+  if (DatabaseSync2) {
+    let storageDir = "";
+    if (process.platform === "win32") {
+      storageDir = path5.join(process.env.APPDATA || path5.join(os4.homedir(), "AppData", "Roaming"), "Cursor", "User", "workspaceStorage");
+    } else if (process.platform === "darwin") {
+      storageDir = path5.join(os4.homedir(), "Library", "Application Support", "Cursor", "User", "workspaceStorage");
+    } else {
+      storageDir = path5.join(os4.homedir(), ".config", "Cursor", "User", "workspaceStorage");
+    }
+    if (fs4.existsSync(storageDir)) {
+      try {
+        const wsDirs = fs4.readdirSync(storageDir);
+        for (const ws of wsDirs) {
+          const wsPath = path5.join(storageDir, ws);
+          const wsJsonPath = path5.join(wsPath, "workspace.json");
+          if (!fs4.existsSync(wsJsonPath))
+            continue;
+          try {
+            const wsJson = JSON.parse(fs4.readFileSync(wsJsonPath, "utf-8"));
+            let folderUri = wsJson.folder || wsJson.workspace || "";
+            try {
+              folderUri = decodeURIComponent(folderUri.replace(/^file:\/\/\/?/, ""));
+            } catch {
+            }
+            const folder = folderUri.toLowerCase().replace(/\\/g, "/");
+            if (!folder.includes(normTarget) && !normTarget.includes(folder) && !folder.endsWith(targetBasename)) {
+              continue;
+            }
+            const dbFile = path5.join(wsPath, "state.vscdb");
+            if (!fs4.existsSync(dbFile))
+              continue;
+            const dbStat = fs4.statSync(dbFile);
+            if (sinceDate && dbStat.mtime < sinceDate)
+              continue;
+            const db = new DatabaseSync2(dbFile, { readOnly: true });
+            try {
+              const rowRecent = db.prepare("SELECT value FROM ItemTable WHERE key = 'aiCodeTracking.recentCommit' LIMIT 1").get();
+              if (rowRecent && rowRecent.value) {
+                const recent = JSON.parse(rowRecent.value);
+                if (recent && recent.commitHash) {
+                  const added = Number(recent.linesAdded || recent.composerLinesAdded || 0);
+                  const deleted = Number(recent.linesDeleted || recent.composerLinesDeleted || 0);
+                  const estOut = Math.max(Math.round((added + deleted) * 35 / 4), 100);
+                  const estIn = estOut * 20;
+                  const estCached = Math.round(estIn * 0.6);
+                  const rateCard = getRateCard("claude-3-7-sonnet");
+                  const cost = computeCost(estIn, estOut, estCached, rateCard);
+                  const commitDate = recent.commitDate ? new Date(recent.commitDate).toISOString() : recent.timestamp ? new Date(recent.timestamp).toISOString() : dbStat.mtime.toISOString();
+                  footprints.push({
+                    id: `cursor_commit_${recent.commitHash.slice(0, 12)}`,
+                    platform: "cursor",
+                    sessionId: ws,
+                    repoPath,
+                    taskTitle: recent.commitMessage || "Cursor AI Commit",
+                    model: "claude-3-7-sonnet",
+                    stepsCount: Math.max(Math.round((added + deleted) / 10), 1),
+                    filesEdited: [],
+                    timestamp: commitDate,
+                    boundCommitSha: recent.commitHash,
+                    tokens: {
+                      input: estIn,
+                      output: estOut,
+                      cached: estCached
+                    },
+                    cost,
+                    mode: "verified",
+                    confidence: 0.95,
+                    rawTranscriptPath: dbFile
+                  });
+                }
+              }
+            } catch {
+            }
+            const rowLegacy = db.prepare("SELECT value FROM ItemTable WHERE key = 'workbench.panel.aichat.chatdata' OR key = 'aiService.generations' LIMIT 1").get();
+            if (rowLegacy && rowLegacy.value) {
+              try {
+                const parsed = JSON.parse(rowLegacy.value);
+                const tabs = parsed.tabs || (Array.isArray(parsed) ? parsed : []);
+                let stepCount = 0;
+                let taskTitle = "";
+                let model = "claude-3-5-sonnet";
+                for (const tab of tabs) {
+                  const bubbles = tab.bubbles || [];
+                  stepCount += bubbles.length;
+                  if (!taskTitle && tab.chatTitle)
+                    taskTitle = tab.chatTitle;
+                  for (const b2 of bubbles) {
+                    if (b2.modelType)
+                      model = b2.modelType;
+                  }
+                }
+                if (stepCount > 0) {
+                  const rateCard = getRateCard(model);
+                  const estInput = stepCount * 2500;
+                  const estCached = Math.round(estInput * 0.6);
+                  const estOutput = stepCount * 250;
+                  const cost = computeCost(estInput, estOutput, estCached, rateCard);
+                  footprints.push({
+                    id: `cursor_chat_${ws}`,
+                    platform: "cursor",
+                    sessionId: ws,
+                    repoPath,
+                    taskTitle: taskTitle || "Cursor Chat Session",
+                    model,
+                    stepsCount: stepCount,
+                    filesEdited: [],
+                    timestamp: dbStat.mtime.toISOString(),
+                    tokens: {
+                      input: estInput,
+                      output: estOutput,
+                      cached: estCached
+                    },
+                    cost,
+                    mode: "imported",
+                    confidence: 0.8,
+                    rawTranscriptPath: dbFile
+                  });
+                }
+              } catch {
+              }
+            }
+          } catch {
           }
         }
       } catch {
       }
     }
-  } catch {
   }
   return footprints;
 }
@@ -14389,6 +14601,35 @@ var LocalStateDB = class {
       return null;
     return JSON.parse(row.payload_json);
   }
+  getRecentReceipts(limit = 10) {
+    if (!this.db)
+      return [];
+    try {
+      const rows = this.db.prepare("SELECT payload_json, claim_token, sync_status, created_at FROM receipts ORDER BY created_at DESC LIMIT ?").all(limit);
+      return rows.map((r2) => ({
+        receipt: JSON.parse(r2.payload_json),
+        claimToken: r2.claim_token || void 0,
+        syncStatus: r2.sync_status || "local",
+        createdAt: r2.created_at
+      }));
+    } catch {
+      return [];
+    }
+  }
+  getStats() {
+    if (!this.db)
+      return { totalReceipts: 0, totalFootprints: 0 };
+    try {
+      const rRow = this.db.prepare("SELECT COUNT(*) as cnt FROM receipts").get();
+      const fRow = this.db.prepare("SELECT COUNT(*) as cnt FROM agent_footprints").get();
+      return {
+        totalReceipts: rRow?.cnt || 0,
+        totalFootprints: fRow?.cnt || 0
+      };
+    } catch {
+      return { totalReceipts: 0, totalFootprints: 0 };
+    }
+  }
   close() {
     if (this.db) {
       this.db.close();
@@ -14440,7 +14681,8 @@ async function harvestUniversalFootprints(options) {
     const cursorFootprints = harvestCursorFootprints(options.repoPath, sinceDate);
     allFootprints.push(...cursorFootprints);
   }
-  allFootprints.sort((a, b2) => new Date(b2.timestamp).getTime() - new Date(a.timestamp).getTime());
+  const { primary, rankedFootprints } = selectPrimaryFootprint(allFootprints, options.gitContext);
+  allFootprints = rankedFootprints;
   try {
     const db = new LocalStateDB();
     for (const fp of allFootprints) {
@@ -14467,7 +14709,6 @@ async function harvestUniversalFootprints(options) {
     totalCached += fp.tokens.cached;
     totalCost += fp.cost;
   }
-  const primary = allFootprints[0];
   return {
     footprints: allFootprints,
     primaryFootprint: primary,
@@ -14501,16 +14742,16 @@ function estimateCost(options) {
       totalCost += s.cost;
     }
     return {
-      provider: primary.provider,
-      model: primary.model || "claude-3-7-sonnet",
+      provider: options.provider || primary.provider,
+      model: options.model || primary.model || "claude-3-7-sonnet",
       tokens: {
         input: totalInput,
         output: totalOutput,
         cached: totalCached
       },
       cost: Number(totalCost.toFixed(4)),
-      mode: primary.mode,
-      confidence: primary.confidence,
+      mode: options.mode || primary.mode,
+      confidence: options.confidence !== void 0 ? options.confidence : primary.confidence,
       sessions: options.sessions
     };
   }
@@ -14630,7 +14871,13 @@ async function generateReceipt(options = {}) {
     repoPath,
     projectAlias: metrics.projectAlias,
     since: options.since,
-    platform: options.platform
+    platform: options.platform,
+    gitContext: {
+      headSha: metrics.headSha,
+      commitDate: metrics.commitDate,
+      changedFiles: metrics.changedFiles,
+      branch: metrics.branch
+    }
   });
   const primaryFp = harvestResult.primaryFootprint;
   const detected = detectProviderFromCommit(metrics.commitMessage);
@@ -14716,25 +14963,954 @@ async function generateReceipt(options = {}) {
   return ReceiptV1Schema.parse(receipt);
 }
 
-// src/index.ts
-var SHARE_PAYLOAD_MAX_BYTES = 5e4;
-function resolveCliVersion() {
-  try {
-    const argv1 = process.argv[1] ? path7.dirname(path7.resolve(process.argv[1])) : process.cwd();
-    const candidates = [
-      path7.join(argv1, "..", "package.json"),
-      path7.join(argv1, "package.json")
-    ];
-    for (const candidate of candidates) {
-      if (!fs6.existsSync(candidate)) continue;
-      const pkg = JSON.parse(fs6.readFileSync(candidate, "utf-8"));
-      if (pkg.name === "qodewk" && pkg.version) return pkg.version;
+// src/receipt-view.ts
+var fs6 = __toESM(require("fs"), 1);
+var import_picocolors = __toESM(require_picocolors(), 1);
+
+// src/barcode.ts
+var CODE128_PATTERNS = [
+  "11011001100",
+  "11001101100",
+  "11001100110",
+  "10010011000",
+  "10010001100",
+  "10001001100",
+  "10011001000",
+  "10011000100",
+  "10001100100",
+  "11001001000",
+  "11001000100",
+  "11000100100",
+  "10110011100",
+  "10011011100",
+  "10011001110",
+  "10111001100",
+  "10011101100",
+  "10011100110",
+  "11001110010",
+  "11001011100",
+  "11001001110",
+  "11011100100",
+  "11001110100",
+  "11101101110",
+  "11101001100",
+  "11100101100",
+  "11100100110",
+  "11101100100",
+  "11100110100",
+  "11100110010",
+  "11011011000",
+  "11011000110",
+  "11000110110",
+  "10100011000",
+  "10001011000",
+  "10001000110",
+  "10110001000",
+  "10001101000",
+  "10001100010",
+  "11010001000",
+  "11000101000",
+  "11000100010",
+  "10110111000",
+  "10110001110",
+  "10001101110",
+  "10111011000",
+  "10111000110",
+  "10001110110",
+  "11101110110",
+  "11010001110",
+  "11000101110",
+  "11011101000",
+  "11011100010",
+  "11011101110",
+  "11101011000",
+  "11101000110",
+  "11100010110",
+  "11101101000",
+  "11101100010",
+  "11100011010",
+  "11101111010",
+  "11001000010",
+  "11110001010",
+  "10100110000",
+  "10100001100",
+  "10010110000",
+  "10010000110",
+  "10000101100",
+  "10000100110",
+  "10110010000",
+  "10110000100",
+  "10011010000",
+  "10011000010",
+  "10000110100",
+  "10000110010",
+  "11000010010",
+  "11001010000",
+  "11110111010",
+  "11000010100",
+  "10001111010",
+  "10100111100",
+  "10010111100",
+  "10010011110",
+  "10111100100",
+  "10011110100",
+  "10011110010",
+  "11110100100",
+  "11110010100",
+  "11110010010",
+  "11011011110",
+  "11011110110",
+  "11110110110",
+  "10101111000",
+  "10100011110",
+  "10001011110",
+  "10111101000",
+  "10111100010",
+  "11110101000",
+  "11110100010",
+  "10111011110",
+  "10111101110",
+  "11101011110",
+  "11110101110",
+  "11010000100",
+  "11010010000",
+  "11010011100",
+  "1100011101011"
+];
+var START_B = 104;
+var STOP = 106;
+function encodeCode128B(text) {
+  const codes = [START_B];
+  for (const ch of text) {
+    const code = ch.charCodeAt(0) - 32;
+    if (code < 0 || code > 95) {
+      throw new Error(`Code 128-B cannot encode character: ${JSON.stringify(ch)}`);
     }
-  } catch {
+    codes.push(code);
   }
-  return "0.2.1";
-}
-function resolveSince(options) {
+  let checksum = START_B;
+  for (let i2 = 1; i2 < codes.length; i2++) {
+    checksum += codes[i2] * i2;
+  }
+  codes.push(checksum % 103);
+  codes.push(STOP);
+  return codes;
+}
+function code128Modules(text) {
+  const codes = encodeCode128B(text);
+  let modules = "";
+  for (const code of codes) {
+    modules += CODE128_PATTERNS[code] ?? "";
+  }
+  return modules;
+}
+function renderTerminalBarcode(text, options = {}) {
+  const maxWidth = Math.max(16, options.maxWidth ?? 52);
+  const height = Math.max(2, options.height ?? 3);
+  const quietZone = Math.max(0, options.quietZone ?? 10);
+  let payload = text;
+  payload = [...payload].filter((ch) => {
+    const c3 = ch.charCodeAt(0);
+    return c3 >= 32 && c3 <= 126;
+  }).join("");
+  if (!payload) payload = "QODEWK";
+  let modules;
+  try {
+    modules = code128Modules(payload);
+  } catch {
+    modules = code128Modules("QODEWK");
+  }
+  const withQuiet = "0".repeat(quietZone) + modules + "0".repeat(quietZone);
+  const scaled = downsampleModules(withQuiet, maxWidth);
+  const row = modulesToBlocks(scaled);
+  return Array.from({ length: height }, () => row);
+}
+function downsampleModules(modules, maxWidth) {
+  if (modules.length <= maxWidth) return modules;
+  const out = [];
+  const ratio = modules.length / maxWidth;
+  for (let i2 = 0; i2 < maxWidth; i2++) {
+    const start = Math.floor(i2 * ratio);
+    const end = Math.max(start + 1, Math.floor((i2 + 1) * ratio));
+    let bars = 0;
+    for (let j2 = start; j2 < end && j2 < modules.length; j2++) {
+      if (modules[j2] === "1") bars++;
+    }
+    out.push(bars * 2 >= end - start ? "1" : "0");
+  }
+  return out.join("");
+}
+function modulesToBlocks(modules) {
+  let out = "";
+  for (const bit of modules) {
+    out += bit === "1" ? "\u2588" : " ";
+  }
+  return out;
+}
+function pickBarcodePayload(input) {
+  const maxChars = input.maxChars ?? 24;
+  const candidates = [];
+  if (input.publicUrl) candidates.push(input.publicUrl);
+  if (input.displayHost && input.receiptId) {
+    candidates.push(`${input.displayHost}/r/${input.receiptId}`);
+  }
+  candidates.push(input.receiptId);
+  if (input.receiptId.length > 12) {
+    candidates.push(input.receiptId.replace(/^rec_/, "").slice(0, 12));
+  }
+  for (const c3 of candidates) {
+    if (c3.length <= maxChars) return c3;
+  }
+  return candidates[candidates.length - 1].slice(0, maxChars);
+}
+
+// src/theme.ts
+var THEME = {
+  primary: "#cc785c",
+  primaryActive: "#a9583e",
+  primaryDisabled: "#e6dfd8",
+  ink: "#141413",
+  body: "#3d3d3a",
+  bodyStrong: "#252523",
+  muted: "#6c6a64",
+  mutedSoft: "#8e8b82",
+  hairline: "#e6dfd8",
+  hairlineSoft: "#ebe6df",
+  canvas: "#faf9f5",
+  surfaceCard: "#efe9de",
+  surfaceCreamStrong: "#e8e0d2",
+  surfaceDark: "#181715",
+  surfaceDarkElevated: "#252320",
+  surfaceDarkSoft: "#1f1e1b",
+  teal: "#5db8a6",
+  amber: "#e8a55a",
+  success: "#5db872",
+  error: "#c64545"
+};
+var ansiHex = (hexColor) => {
+  const num = parseInt(hexColor.replace("#", ""), 16);
+  const r2 = num >> 16 & 255;
+  const g = num >> 8 & 255;
+  const b2 = num & 255;
+  return (text) => `\x1B[38;2;${r2};${g};${b2}m${text}\x1B[39m`;
+};
+var colors = {
+  coral: ansiHex(THEME.primary),
+  coralActive: ansiHex(THEME.primaryActive),
+  muted: ansiHex(THEME.muted),
+  mutedSoft: ansiHex(THEME.mutedSoft),
+  teal: ansiHex(THEME.teal),
+  amber: ansiHex(THEME.amber),
+  green: ansiHex(THEME.success),
+  red: ansiHex(THEME.error),
+  hairline: ansiHex(THEME.hairline),
+  canvas: ansiHex(THEME.canvas)
+};
+var stripAnsi = (str) => {
+  return str.replace(/\x1B\[[0-9;]*[a-zA-Z]/g, "").replace(/\x1B\([B0]/g, "");
+};
+var visibleWidth = (str) => {
+  return stripAnsi(str).length;
+};
+
+// src/receipt-view.ts
+function buildTerminalReceipt(receipt, publicUrl) {
+  const lines = [];
+  const coral = colors.coral;
+  const green = colors.green;
+  const red = colors.red;
+  const teal = colors.teal;
+  const INNER_WIDTH2 = 52;
+  const push = (line) => lines.push(line);
+  const printRow = (content, width = INNER_WIDTH2) => {
+    const visLen = visibleWidth(content);
+    const pad = Math.max(0, width - visLen);
+    push(`  | ${content}${" ".repeat(pad)} |`);
+  };
+  const printRowSplit = (left, right, width = INNER_WIDTH2) => {
+    const leftVis = visibleWidth(left);
+    const rightVis = visibleWidth(right);
+    const pad = Math.max(1, width - leftVis - rightVis);
+    push(`  | ${left}${" ".repeat(pad)}${right} |`);
+  };
+  const printCenteredRow = (content, width = INNER_WIDTH2) => {
+    const visLen = visibleWidth(content);
+    const totalPad = Math.max(0, width - visLen);
+    const leftPad = Math.floor(totalPad / 2);
+    const rightPad = totalPad - leftPad;
+    push(`  | ${" ".repeat(leftPad)}${content}${" ".repeat(rightPad)} |`);
+  };
+  const printDivider = (char = "=", width = INNER_WIDTH2) => {
+    push(`  | ${char.repeat(width)} |`);
+  };
+  const totalTokens = (receipt.ai.tokens.input + receipt.ai.tokens.output).toLocaleString();
+  const inputK = `${Math.round(receipt.ai.tokens.input / 1e3)}k`;
+  const outputK = `${Math.round(receipt.ai.tokens.output / 1e3)}k`;
+  const costPrefix = receipt.ai.mode === "verified" ? "$" : "~$";
+  const confidencePercent = `${Math.round(receipt.ai.confidence * 100)}%`;
+  push("");
+  push("  " + import_picocolors.default.bold(coral("/\\".repeat(28))));
+  printCenteredRow(import_picocolors.default.bold(import_picocolors.default.white("Q O D E W K")));
+  printCenteredRow(coral("*** PROOF OF SHIPMENT ***"));
+  printRow("");
+  printRowSplit(
+    `ID:   ${receipt.receipt.id.slice(0, 24)}`,
+    `DATE: ${receipt.receipt.createdAt.slice(0, 10)}`
+  );
+  printRowSplit(
+    `REPO: ${receipt.repository.projectAlias.slice(0, 18)}`,
+    `BRANCH: ${receipt.repository.branch.slice(0, 16)}`
+  );
+  if (receipt.ai.task) {
+    const taskClean = receipt.ai.task.length > 44 ? receipt.ai.task.slice(0, 43) + "\u2026" : receipt.ai.task;
+    printRow(`TASK: ${taskClean}`);
+  }
+  printDivider("=");
+  const itemsHeader = receipt.repository.commitsCount && receipt.repository.commitsCount > 1 ? `ITEMS CHANGED (${receipt.repository.commitsCount} COMMITS)` : "ITEMS CHANGED";
+  printRowSplit(itemsHeader, "QTY");
+  printDivider("-");
+  printRowSplit("Files Touched", String(receipt.mutation.files));
+  printRowSplit("Lines Inserted", green("+ " + receipt.mutation.insertions));
+  printRowSplit("Lines Deleted", red("- " + receipt.mutation.deletions));
+  printRowSplit(
+    "Net Code Delta",
+    teal((receipt.mutation.netLines >= 0 ? "+ " : "- ") + Math.abs(receipt.mutation.netLines))
+  );
+  printDivider("-");
+  printRow("AI TELEMETRY & ATTRIBUTION");
+  const provString = receipt.ai.provider + " \xB7 " + (receipt.ai.model || "Unknown");
+  const cleanProv = provString.length > 40 ? provString.slice(0, 39) + "\u2026" : provString;
+  printRow(`Provider: ${cleanProv}`);
+  if (receipt.ai.sessions && receipt.ai.sessions.length > 1) {
+    const others = receipt.ai.sessions.slice(1).map((s) => s.provider).filter((p2, i2, arr) => arr.indexOf(p2) === i2 && p2 !== receipt.ai.provider);
+    if (others.length > 0) {
+      printRow(import_picocolors.default.dim(`Also seen: ${others.join(", ")}`));
+    }
+  }
+  if (receipt.ai.aiWrittenRatio !== void 0) {
+    const aiPct = Math.round(receipt.ai.aiWrittenRatio * 100);
+    printRowSplit("AI Written Code", `${aiPct}% (Human: ${100 - aiPct}%)`);
+  }
+  const tokenDetail = `${inputK} in (${Math.round(receipt.ai.tokens.cached / 1e3)}k cached) / ${outputK} out`;
+  const cleanTokens = tokenDetail.length > 40 ? tokenDetail.slice(0, 39) + "\u2026" : tokenDetail;
+  printRow(`Tokens:   ${cleanTokens}`);
+  printRowSplit("Total Tokens:", totalTokens);
+  printDivider("=");
+  const costLabel = receipt.ai.mode === "verified" ? "VERIFIED AI COST" : "ESTIMATED AI COST";
+  printRowSplit(costLabel, import_picocolors.default.bold(coral(costPrefix + receipt.ai.cost.toFixed(2))));
+  printRowSplit(`CONFIDENCE: ${confidencePercent}`, `[Mode: ${receipt.ai.mode}]`);
+  printDivider("=");
+  printRow("");
+  const baseUrl = process.env.NEXT_PUBLIC_APP_URL || process.env.QODEWK_APP_URL || "https://qodewk.flinkeo.online";
+  const isPublished = Boolean(publicUrl);
+  const displayHost = baseUrl.replace(/^https?:\/\//, "");
+  const barcodePayload = pickBarcodePayload({
+    publicUrl,
+    receiptId: receipt.receipt.id,
+    displayHost,
+    maxChars: 28
+  });
+  const barcodeRows = renderTerminalBarcode(barcodePayload, {
+    maxWidth: INNER_WIDTH2,
+    height: 3,
+    quietZone: 8
+  });
+  for (const barRow of barcodeRows) {
+    printCenteredRow(import_picocolors.default.bold(barRow));
+  }
+  if (isPublished) {
+    printCenteredRow(import_picocolors.default.cyan(displayHost));
+    printCenteredRow(import_picocolors.default.underline(import_picocolors.default.cyan(`r/${receipt.receipt.id}`)));
+  } else {
+    printCenteredRow(import_picocolors.default.yellow("[ LOCAL RECORD \u2014 NOT PUBLISHED ]"));
+  }
+  printRow("");
+  if (process.env.QODEWK_TELEMETRY === "off") {
+    printRow(`  ${teal("[\u2713]")} QODEWK_TELEMETRY=off (Cloud sync disabled)`);
+  }
+  printRow(`  ${green("[\u2713]")} Source code was never uploaded to Qodewk`);
+  push("  " + import_picocolors.default.bold(coral("\\/".repeat(28))));
+  push("");
+  if (isPublished && publicUrl) {
+    push(`  ${import_picocolors.default.dim("Public Receipt:")} ${import_picocolors.default.underline(import_picocolors.default.cyan(publicUrl))}`);
+  } else {
+    push(`  ${import_picocolors.default.dim("Saved to local DB:")} ${import_picocolors.default.dim("~/.qodewk/state.db")}`);
+    push(`  ${import_picocolors.default.dim("To publish & get shareable URL:")} ${import_picocolors.default.cyan("qodewk share")}`);
+    push(`  ${import_picocolors.default.dim("Interactive menu:")} ${import_picocolors.default.cyan("qodewk menu")}`);
+  }
+  push("");
+  return lines.join("\n");
+}
+async function renderTerminalReceipt(receipt, publicUrl) {
+  console.log(buildTerminalReceipt(receipt, publicUrl));
+}
+async function outputReceipt(receipt, options, publicUrl) {
+  const format = options.json ? "json" : options.format || "terminal";
+  let content;
+  if (format === "json") {
+    content = JSON.stringify(receipt, null, 2);
+  } else if (format === "markdown") {
+    content = formatMarkdownReceipt(receipt, publicUrl);
+  } else {
+    content = buildTerminalReceipt(receipt, publicUrl);
+  }
+  if (options.out) {
+    const fileContent = format === "terminal" ? stripAnsi(content) : content;
+    fs6.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) {
+    if (format === "terminal") {
+      console.log(content);
+    } else {
+      console.log(content);
+    }
+  }
+}
+
+// src/hooks.ts
+var fs7 = __toESM(require("fs"), 1);
+var path7 = __toESM(require("path"), 1);
+var HOOK_MARKER_BEGIN = "# --- BEGIN QODEWK HOOK ---";
+var HOOK_MARKER_END = "# --- END QODEWK HOOK ---";
+var HOOK_SNIPPET = `
+${HOOK_MARKER_BEGIN}
+# 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 & )
+fi
+${HOOK_MARKER_END}
+`;
+function resolveGitHooksDir(cwd = process.cwd()) {
+  const gitPath = path7.join(cwd, ".git");
+  if (!fs7.existsSync(gitPath)) return null;
+  let gitCommonDir;
+  const stat = fs7.statSync(gitPath);
+  if (stat.isDirectory()) {
+    gitCommonDir = gitPath;
+  } else {
+    const content = fs7.readFileSync(gitPath, "utf-8");
+    const match = content.match(/gitdir:\s*(.+)/i);
+    if (!match?.[1]) return null;
+    let gitDir = match[1].trim();
+    if (!path7.isAbsolute(gitDir)) {
+      gitDir = path7.resolve(cwd, gitDir);
+    }
+    const commonFile = path7.join(gitDir, "commondir");
+    if (fs7.existsSync(commonFile)) {
+      let common = fs7.readFileSync(commonFile, "utf-8").trim();
+      if (!path7.isAbsolute(common)) {
+        common = path7.resolve(gitDir, common);
+      }
+      gitCommonDir = common;
+    } else if (path7.basename(path7.dirname(gitDir)) === "worktrees") {
+      gitCommonDir = path7.dirname(path7.dirname(gitDir));
+    } else {
+      gitCommonDir = gitDir;
+    }
+  }
+  return path7.join(gitCommonDir, "hooks");
+}
+function checkHookStatus(hooksDir) {
+  if (!hooksDir || !fs7.existsSync(hooksDir)) {
+    return {
+      isGit: Boolean(hooksDir),
+      hooksDir,
+      postCommitInstalled: false,
+      postRewriteInstalled: false
+    };
+  }
+  const postCommit = path7.join(hooksDir, "post-commit");
+  const postRewrite = path7.join(hooksDir, "post-rewrite");
+  const hasHook = (p2) => {
+    if (!fs7.existsSync(p2)) return false;
+    try {
+      const content = fs7.readFileSync(p2, "utf-8");
+      return content.includes(HOOK_MARKER_BEGIN);
+    } catch {
+      return false;
+    }
+  };
+  return {
+    isGit: true,
+    hooksDir,
+    postCommitInstalled: hasHook(postCommit),
+    postRewriteInstalled: hasHook(postRewrite)
+  };
+}
+function installHookFile(hookFile) {
+  let content = "";
+  if (fs7.existsSync(hookFile)) {
+    content = fs7.readFileSync(hookFile, "utf-8");
+  } else {
+    content = "#!/bin/sh\n";
+  }
+  if (content.includes(HOOK_MARKER_BEGIN)) {
+    return "exists";
+  }
+  fs7.writeFileSync(hookFile, content + HOOK_SNIPPET, { mode: 493 });
+  return "installed";
+}
+function uninstallHookFile(hookFile) {
+  if (!fs7.existsSync(hookFile)) return "absent";
+  const content = fs7.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");
+  const updated = content.replace(regex, "");
+  fs7.writeFileSync(hookFile, updated, { mode: 493 });
+  return "removed";
+}
+
+// src/menu.ts
+var readline = __toESM(require("readline"), 1);
+var import_picocolors2 = __toESM(require_picocolors(), 1);
+var INNER_WIDTH = 58;
+var SHARE_PAYLOAD_MAX_BYTES = 5e4;
+var MENU_ITEMS = [
+  {
+    id: "receipt",
+    key: "1",
+    label: "Generate Local Receipt",
+    description: "Inspect git diff and print digital receipt"
+  },
+  {
+    id: "audit",
+    key: "2",
+    label: "Audit Branch or Revision Range",
+    description: "Compare against base commit or upstream branch"
+  },
+  {
+    id: "share",
+    key: "3",
+    label: "Publish Receipt to Cloud",
+    description: "Privacy-safe shareable URL & claim token"
+  },
+  {
+    id: "hooks",
+    key: "4",
+    label: "Configure Git Hooks",
+    description: "Non-blocking background telemetry recording"
+  },
+  {
+    id: "storage",
+    key: "5",
+    label: "Database & Storage Status",
+    description: "Inspect local SQLite (~/.qodewk/state.db) records"
+  },
+  {
+    id: "exit",
+    key: "0",
+    label: "Exit",
+    description: "Return to shell"
+  }
+];
+function buildMenuFrame(selectedIndex, items = MENU_ITEMS) {
+  const lines = [];
+  const coral = colors.coral;
+  const mutedSoft = colors.mutedSoft;
+  const amber = colors.amber;
+  const border = colors.mutedSoft;
+  const push = (line) => lines.push(line);
+  const printRow = (content, width = INNER_WIDTH) => {
+    const visLen = visibleWidth(content);
+    const pad = Math.max(0, width - visLen);
+    push(`  ${border("\u2502")} ${content}${" ".repeat(pad)} ${border("\u2502")}`);
+  };
+  const printCenteredRow = (content, width = INNER_WIDTH) => {
+    const visLen = visibleWidth(content);
+    const totalPad = Math.max(0, width - visLen);
+    const leftPad = Math.floor(totalPad / 2);
+    const rightPad = totalPad - leftPad;
+    push(`  ${border("\u2502")} ${" ".repeat(leftPad)}${content}${" ".repeat(rightPad)} ${border("\u2502")}`);
+  };
+  const printDivider = (width = INNER_WIDTH) => {
+    push(`  ${border("\u251C" + "\u2500".repeat(width + 2) + "\u2524")}`);
+  };
+  push("");
+  push(`  ${border("\u250C" + "\u2500".repeat(INNER_WIDTH + 2) + "\u2510")}`);
+  printCenteredRow(import_picocolors2.default.bold(import_picocolors2.default.white("Q O D E W K")));
+  printCenteredRow(coral("Telemetry Control Panel"));
+  printDivider();
+  printCenteredRow(mutedSoft("Use \u2191 / \u2193 to navigate \xB7 Enter to select \xB7 q to quit"));
+  printDivider();
+  printRow("");
+  const mainItems = items.filter((item) => item.id !== "exit");
+  const exitItem = items.find((item) => item.id === "exit");
+  for (let i2 = 0; i2 < mainItems.length; i2++) {
+    const item = mainItems[i2];
+    const itemIndex = items.indexOf(item);
+    const isSelected = itemIndex === selectedIndex;
+    if (isSelected) {
+      const pointer = import_picocolors2.default.bold(coral("\u203A"));
+      const keyTag = import_picocolors2.default.bold(coral(`[${item.key}]`));
+      const label = import_picocolors2.default.bold(import_picocolors2.default.white(item.label));
+      printRow(` ${pointer} ${keyTag} ${label}`);
+      printRow(`       ${amber(item.description)}`);
+    } else {
+      const keyTag = mutedSoft(`[${item.key}]`);
+      const label = import_picocolors2.default.dim(import_picocolors2.default.white(item.label));
+      printRow(`   ${keyTag} ${label}`);
+      printRow(`       ${import_picocolors2.default.dim(item.description)}`);
+    }
+    if (i2 < mainItems.length - 1) {
+      printRow("");
+    }
+  }
+  printRow("");
+  if (exitItem) {
+    printDivider();
+    const exitIndex = items.indexOf(exitItem);
+    const isSelected = exitIndex === selectedIndex;
+    if (isSelected) {
+      const pointer = import_picocolors2.default.bold(coral("\u203A"));
+      const keyTag = import_picocolors2.default.bold(coral(`[${exitItem.key}]`));
+      const label = import_picocolors2.default.bold(import_picocolors2.default.white(exitItem.label));
+      printRow(` ${pointer} ${keyTag} ${label}`);
+      printRow(`       ${amber(exitItem.description)}`);
+    } else {
+      const keyTag = mutedSoft(`[${exitItem.key}]`);
+      const label = import_picocolors2.default.dim(import_picocolors2.default.white(exitItem.label));
+      printRow(`   ${keyTag} ${label}`);
+      printRow(`       ${import_picocolors2.default.dim(exitItem.description)}`);
+    }
+  }
+  printDivider();
+  printCenteredRow(import_picocolors2.default.dim("[\u2713] Source code was never uploaded to Qodewk"));
+  push(`  ${border("\u2514" + "\u2500".repeat(INNER_WIDTH + 2) + "\u2518")}`);
+  push("");
+  return lines.join("\n");
+}
+function askLine(promptText) {
+  return new Promise((resolve4) => {
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout
+    });
+    rl.question(promptText, (answer) => {
+      rl.close();
+      resolve4(answer.trim());
+    });
+  });
+}
+function waitForKeyToReturn() {
+  return new Promise((resolve4) => {
+    console.log(import_picocolors2.default.dim("\n  Press any key or Enter to return to menu..."));
+    if (!process.stdin.isTTY) {
+      resolve4();
+      return;
+    }
+    const wasRaw = process.stdin.isRaw;
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    const onKey = () => {
+      process.stdin.removeListener("data", onKey);
+      if (wasRaw !== void 0) process.stdin.setRawMode(wasRaw);
+      resolve4();
+    };
+    process.stdin.once("data", onKey);
+  });
+}
+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."));
+    return;
+  }
+  let selectedIndex = 0;
+  let active = true;
+  let lastRenderedLinesCount = 0;
+  const render = () => {
+    const frame = buildMenuFrame(selectedIndex);
+    const lineCount = frame.split("\n").length;
+    if (lastRenderedLinesCount > 0) {
+      readline.cursorTo(process.stdout, 0);
+      readline.moveCursor(process.stdout, 0, -lastRenderedLinesCount);
+      readline.clearScreenDown(process.stdout);
+    }
+    process.stdout.write(frame);
+    lastRenderedLinesCount = lineCount;
+  };
+  const cleanup = () => {
+    try {
+      process.stdin.setRawMode(false);
+    } catch {
+    }
+    process.stdout.write("\x1B[?25h");
+  };
+  process.on("exit", cleanup);
+  const executeSelectedAction = async () => {
+    cleanup();
+    console.log("");
+    lastRenderedLinesCount = 0;
+    const selectedItem = MENU_ITEMS[selectedIndex];
+    switch (selectedItem.id) {
+      case "receipt": {
+        console.log(import_picocolors2.default.dim("  [\xB7] Generating local receipt from git diff..."));
+        try {
+          const receipt = await generateReceipt({ isPublic: false });
+          const db = new LocalStateDB();
+          db.saveReceipt(receipt);
+          db.close();
+          await renderTerminalReceipt(receipt);
+        } catch (err) {
+          const message = err instanceof Error ? err.message : String(err);
+          console.error(import_picocolors2.default.red(`
+  Failed to generate receipt: ${message}`));
+        }
+        await waitForKeyToReturn();
+        break;
+      }
+      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"));
+        let defaultBase = "origin/main";
+        try {
+          const { simpleGit: simpleGit2 } = await import("simple-git");
+          defaultBase = await detectDefaultBaseBranch(simpleGit2(process.cwd()));
+        } catch {
+        }
+        const base = await askLine(
+          `  \u203A Base git ref or commit SHA [default: ${defaultBase}]: `
+        );
+        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..."));
+        try {
+          const receipt = await generateReceipt({
+            baseSha: base || defaultBase,
+            headSha: head || "HEAD",
+            isPublic: false
+          });
+          const db = new LocalStateDB();
+          db.saveReceipt(receipt);
+          db.close();
+          await renderTerminalReceipt(receipt);
+        } catch (err) {
+          const message = err instanceof Error ? err.message : String(err);
+          console.error(import_picocolors2.default.red(`
+  Audit failed: ${message}`));
+        }
+        await waitForKeyToReturn();
+        break;
+      }
+      case "share": {
+        console.log(import_picocolors2.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."));
+            await renderTerminalReceipt(receipt);
+            await waitForKeyToReturn();
+            break;
+          }
+          const sanitized = sanitizeReceiptForShare(receipt);
+          let body = JSON.stringify(sanitized);
+          if (Buffer.byteLength(body, "utf-8") > SHARE_PAYLOAD_MAX_BYTES && sanitized.ai.sessions) {
+            const trimmed2 = {
+              ...sanitized,
+              ai: { ...sanitized.ai, sessions: void 0 }
+            };
+            body = JSON.stringify(trimmed2);
+          }
+          const endpoint = process.env.QODEWK_API_URL || `${process.env.NEXT_PUBLIC_APP_URL || process.env.QODEWK_APP_URL || "https://qodewk.flinkeo.online"}/api/receipts`;
+          console.log(import_picocolors2.default.dim(`  [\xB7] Uploading metadata to ${endpoint}...`));
+          const response = await fetch(endpoint, {
+            method: "POST",
+            headers: {
+              "Content-Type": "application/json",
+              "Content-Length": String(Buffer.byteLength(body, "utf-8"))
+            },
+            body
+          });
+          if (!response.ok) {
+            const errText = await response.text().catch(() => "");
+            throw new Error(`API responded with ${response.status}${errText ? `: ${errText.slice(0, 100)}` : ""}`);
+          }
+          const data = await response.json();
+          const db = new LocalStateDB();
+          db.saveReceipt(sanitized, data.claimToken);
+          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"));
+          await renderTerminalReceipt(sanitized, data.url);
+        } catch (err) {
+          const message = err instanceof Error ? err.message : String(err);
+          console.error(import_picocolors2.default.red(`
+  Share failed: ${message}`));
+        }
+        await waitForKeyToReturn();
+        break;
+      }
+      case "hooks": {
+        await manageHooksSubmenu();
+        break;
+      }
+      case "storage": {
+        await showStorageStatus();
+        break;
+      }
+      case "exit": {
+        active = false;
+        cleanup();
+        console.log(import_picocolors2.default.dim("  Exited Qodewk.\n"));
+        process.exit(0);
+        return;
+      }
+    }
+  };
+  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"));
+    if (!status.isGit) {
+      console.log(import_picocolors2.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(
+      `  post-commit:     ${status.postCommitInstalled ? colors.green("[\u2713 Installed]") : import_picocolors2.default.dim("[\xB7 Not installed]")}`
+    );
+    console.log(
+      `  post-rewrite:    ${status.postRewriteInstalled ? colors.green("[\u2713 Installed]") : import_picocolors2.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("  [0] Back to main menu");
+    console.log("");
+    const choice = await askLine("  \u203A Select option [0-2]: ");
+    if (choice === "1") {
+      if (status.hooksDir) {
+        const path9 = await import("path");
+        const targets = ["post-commit", "post-rewrite"];
+        for (const t2 of targets) {
+          installHookFile(path9.join(status.hooksDir, t2));
+        }
+        console.log(colors.green("\n  [\u2713] Non-blocking hooks installed successfully."));
+      }
+    } else if (choice === "2") {
+      if (status.hooksDir) {
+        const path9 = await import("path");
+        const targets = ["post-commit", "post-rewrite"];
+        for (const t2 of targets) {
+          uninstallHookFile(path9.join(status.hooksDir, t2));
+        }
+        console.log(colors.green("\n  [\u2713] Qodewk hooks removed."));
+      }
+    }
+    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"));
+    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("");
+      if (recent.length === 0) {
+        console.log(import_picocolors2.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)));
+        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);
+          const branch = (item.receipt.repository.branch || "unknown").slice(0, 16).padEnd(18);
+          const cost = colors.coral(`$${item.receipt.ai.cost.toFixed(2)}`);
+          console.log(`  ${id}${date}${branch}${cost}`);
+        }
+      }
+      console.log("");
+      console.log(`  ${colors.green("[\u2713]")} ${import_picocolors2.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_picocolors2.default.red(`  Failed to inspect storage: ${message}`));
+    }
+    await waitForKeyToReturn();
+  };
+  readline.emitKeypressEvents(process.stdin);
+  const startLoop = () => {
+    process.stdout.write("\x1B[?25l");
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    render();
+    const onKeypress = async (_str, key) => {
+      if (!active) return;
+      if (key.ctrl && key.name === "c") {
+        cleanup();
+        process.exit(0);
+      }
+      if (key.name === "q" || key.name === "escape") {
+        cleanup();
+        console.log(import_picocolors2.default.dim("\n  Exited Qodewk.\n"));
+        process.exit(0);
+      }
+      if (key.name === "up" || key.name === "k") {
+        selectedIndex = (selectedIndex - 1 + MENU_ITEMS.length) % MENU_ITEMS.length;
+        render();
+        return;
+      }
+      if (key.name === "down" || key.name === "j") {
+        selectedIndex = (selectedIndex + 1) % MENU_ITEMS.length;
+        render();
+        return;
+      }
+      const itemByKey = MENU_ITEMS.findIndex((item) => item.key === key.name || item.key === _str);
+      if (itemByKey !== -1) {
+        selectedIndex = itemByKey;
+        render();
+        process.stdin.removeListener("keypress", onKeypress);
+        await executeSelectedAction();
+        if (active) {
+          startLoop();
+        }
+        return;
+      }
+      if (key.name === "return" || key.name === "enter") {
+        process.stdin.removeListener("keypress", onKeypress);
+        await executeSelectedAction();
+        if (active) {
+          startLoop();
+        }
+        return;
+      }
+    };
+    process.stdin.on("keypress", onKeypress);
+  };
+  startLoop();
+}
+
+// src/index.ts
+var SHARE_PAYLOAD_MAX_BYTES2 = 5e4;
+function resolveCliVersion() {
+  try {
+    const argv1 = process.argv[1] ? path8.dirname(path8.resolve(process.argv[1])) : process.cwd();
+    const candidates = [
+      path8.join(argv1, "..", "package.json"),
+      path8.join(argv1, "package.json")
+    ];
+    for (const candidate of candidates) {
+      if (!fs8.existsSync(candidate)) continue;
+      const pkg = JSON.parse(fs8.readFileSync(candidate, "utf-8"));
+      if (pkg.name === "qodewk" && pkg.version) return pkg.version;
+    }
+  } catch {
+  }
+  return "0.3.0";
+}
+function resolveSince(options) {
   return options.today ? "today" : options.since;
 }
 function persistReceipt(receipt, claimToken) {
@@ -14745,70 +15921,12 @@ function persistReceipt(receipt, claimToken) {
   } catch {
   }
 }
-function resolveGitHooksDir(cwd = process.cwd()) {
-  const gitPath = path7.join(cwd, ".git");
-  if (!fs6.existsSync(gitPath)) return null;
-  let gitCommonDir;
-  const stat = fs6.statSync(gitPath);
-  if (stat.isDirectory()) {
-    gitCommonDir = gitPath;
-  } else {
-    const content = fs6.readFileSync(gitPath, "utf-8");
-    const match = content.match(/gitdir:\s*(.+)/i);
-    if (!match?.[1]) return null;
-    let gitDir = match[1].trim();
-    if (!path7.isAbsolute(gitDir)) {
-      gitDir = path7.resolve(cwd, gitDir);
-    }
-    const commonFile = path7.join(gitDir, "commondir");
-    if (fs6.existsSync(commonFile)) {
-      let common = fs6.readFileSync(commonFile, "utf-8").trim();
-      if (!path7.isAbsolute(common)) {
-        common = path7.resolve(gitDir, common);
-      }
-      gitCommonDir = common;
-    } else if (path7.basename(path7.dirname(gitDir)) === "worktrees") {
-      gitCommonDir = path7.dirname(path7.dirname(gitDir));
-    } else {
-      gitCommonDir = gitDir;
-    }
-  }
-  return path7.join(gitCommonDir, "hooks");
-}
-var HOOK_MARKER_BEGIN = "# --- BEGIN QODEWK HOOK ---";
-var HOOK_MARKER_END = "# --- END QODEWK HOOK ---";
-var HOOK_SNIPPET = `
-${HOOK_MARKER_BEGIN}
-# 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 & )
-fi
-${HOOK_MARKER_END}
-`;
-function installHookFile(hookFile) {
-  let content = "";
-  if (fs6.existsSync(hookFile)) {
-    content = fs6.readFileSync(hookFile, "utf-8");
-  } else {
-    content = "#!/bin/sh\n";
-  }
-  if (content.includes(HOOK_MARKER_BEGIN)) {
-    return "exists";
-  }
-  fs6.writeFileSync(hookFile, content + HOOK_SNIPPET, { mode: 493 });
-  return "installed";
-}
-function uninstallHookFile(hookFile) {
-  if (!fs6.existsSync(hookFile)) return "absent";
-  const content = fs6.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");
-  const updated = content.replace(regex, "");
-  fs6.writeFileSync(hookFile, updated, { mode: 493 });
-  return "removed";
-}
 var program2 = new Command();
-program2.name("qodewk").description("Universal telemetry and digital receipt generator for the AI coding agent era").version(resolveCliVersion()).option("-j, --json", "Output receipt in machine-readable JSON format").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 (antigravity, claude, cursor, etc.)").option("-m, --model <model>", "Specify AI model identifier").option("-s, --since <duration>", "Harvest agent footprints since duration (e.g. today, 24h, 7d)").option("--today", "Harvest agent footprints for today").option("--platform <platform>", "Filter agent platform (antigravity, claude, cursor, all)").option("--anon", "Anonymize branch name in output").option("--local", "Force local-only mode (never open network sockets)").option("--barcode", "Render classic 1D thermal barcode (always on; kept for compatibility)").action(async (options) => {
+program2.name("qodewk").description("Universal telemetry and digital receipt generator for the AI coding agent era").version(resolveCliVersion()).option("-i, --interactive", "Launch interactive terminal control panel").option("--menu", "Launch interactive terminal control panel").option("-j, --json", "Output receipt in machine-readable JSON format").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 (antigravity, claude, cursor, etc.)").option("-m, --model <model>", "Specify AI model identifier").option("-s, --since <duration>", "Harvest agent footprints since duration (e.g. today, 24h, 7d)").option("--today", "Harvest agent footprints for today").option("--platform <platform>", "Filter agent platform (antigravity, claude, cursor, all)").option("--anon", "Anonymize branch name in output").option("--local", "Force local-only mode (never open network sockets)").option("--barcode", "Render classic 1D thermal barcode (always on; kept for compatibility)").action(async (options) => {
+  if (options.interactive || options.menu) {
+    await runInteractiveMenu();
+    return;
+  }
   try {
     const receipt = await generateReceipt({
       provider: options.provider,
@@ -14822,11 +15940,14 @@ program2.name("qodewk").description("Universal telemetry and digital receipt gen
     await outputReceipt(receipt, options);
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
-    console.error(import_picocolors.default.red(`Error generating receipt: ${message}`));
+    console.error(import_picocolors3.default.red(`Error generating receipt: ${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) => {
+program2.command("menu").description("Launch interactive terminal control panel").action(async () => {
+  await runInteractiveMenu();
+});
+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({
       baseSha: options.base,
@@ -14842,7 +15963,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_picocolors.default.red(`Error auditing git range: ${message}`));
+    console.error(import_picocolors3.default.red(`Error auditing git range: ${message}`));
     process.exit(1);
   }
 });
@@ -14859,31 +15980,31 @@ 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_picocolors.default.yellow(
+        import_picocolors3.default.yellow(
           `
 Cloud publishing is disabled (${localFlag ? "--local" : "QODEWK_TELEMETRY=off"}).`
         )
       );
-      console.log(import_picocolors.default.dim("Telemetry remains strictly stored in local SQLite (~/.qodewk/state.db).\n"));
+      console.log(import_picocolors3.default.dim("Telemetry remains strictly stored in local SQLite (~/.qodewk/state.db).\n"));
       persistReceipt(receipt);
       await renderTerminalReceipt(receipt);
       return;
     }
     const sanitized = sanitizeReceiptForShare(receipt);
     let body = JSON.stringify(sanitized);
-    if (Buffer.byteLength(body, "utf-8") > SHARE_PAYLOAD_MAX_BYTES && sanitized.ai.sessions) {
+    if (Buffer.byteLength(body, "utf-8") > SHARE_PAYLOAD_MAX_BYTES2 && sanitized.ai.sessions) {
       const trimmed2 = {
         ...sanitized,
         ai: { ...sanitized.ai, sessions: void 0 }
       };
       body = JSON.stringify(trimmed2);
     }
-    if (Buffer.byteLength(body, "utf-8") > SHARE_PAYLOAD_MAX_BYTES) {
-      console.error(import_picocolors.default.red("Sanitized receipt still exceeds the 50 KB cloud payload limit."));
+    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."));
       process.exit(1);
     }
     const endpoint = process.env.QODEWK_API_URL || `${process.env.NEXT_PUBLIC_APP_URL || process.env.QODEWK_APP_URL || "https://qodewk.flinkeo.online"}/api/receipts`;
-    console.log(import_picocolors.default.dim(`Publishing receipt ${sanitized.receipt.id} to ${endpoint}...`));
+    console.log(import_picocolors3.default.dim(`Publishing receipt ${sanitized.receipt.id} to ${endpoint}...`));
     try {
       const response = await fetch(endpoint, {
         method: "POST",
@@ -14900,11 +16021,11 @@ Cloud publishing is disabled (${localFlag ? "--local" : "QODEWK_TELEMETRY=off"})
       const data = await response.json();
       persistReceipt(sanitized, data.claimToken);
       console.log("");
-      console.log(import_picocolors.default.green("  Published successfully."));
-      console.log(`  ${import_picocolors.default.dim("Public URL:")} ${import_picocolors.default.underline(import_picocolors.default.cyan(data.url))}`);
-      console.log(`  ${import_picocolors.default.bold(import_picocolors.default.yellow("  Claim token (store securely \u2014 shown once):"))}`);
-      console.log(`  ${import_picocolors.default.yellow(data.claimToken)}`);
-      console.log(import_picocolors.default.dim("  Saved to ~/.qodewk/state.db \u2014 required to prove authorship later."));
+      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("");
       await renderTerminalReceipt(sanitized, data.url);
       if (options.json) {
@@ -14912,14 +16033,14 @@ Cloud publishing is disabled (${localFlag ? "--local" : "QODEWK_TELEMETRY=off"})
       }
     } catch (networkErr) {
       const message = networkErr instanceof Error ? networkErr.message : String(networkErr);
-      console.log(import_picocolors.default.yellow(`
+      console.log(import_picocolors3.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_picocolors.default.red(`Error sharing receipt: ${message}`));
+    console.error(import_picocolors3.default.red(`Error sharing receipt: ${message}`));
     process.exit(1);
   }
 });
@@ -14937,35 +16058,35 @@ hookCommand.command("install").description("Install non-blocking post-commit and
   try {
     const hooksDir = resolveGitHooksDir();
     if (!hooksDir) {
-      console.error(import_picocolors.default.red("Error: Current directory is not a Git repository (.git not found)."));
+      console.error(import_picocolors3.default.red("Error: Current directory is not a Git repository (.git not found)."));
       process.exit(1);
     }
-    if (!fs6.existsSync(hooksDir)) {
-      fs6.mkdirSync(hooksDir, { recursive: true });
+    if (!fs8.existsSync(hooksDir)) {
+      fs8.mkdirSync(hooksDir, { recursive: true });
     }
     const targets = ["post-commit", "post-rewrite"];
     let installed = 0;
     let existing = 0;
     for (const name of targets) {
-      const result = installHookFile(path7.join(hooksDir, name));
+      const result = installHookFile(path8.join(hooksDir, name));
       if (result === "installed") installed++;
       else existing++;
     }
     if (installed === 0 && existing > 0) {
-      console.log(import_picocolors.default.yellow("Qodewk Git hooks are already installed (post-commit, post-rewrite)."));
+      console.log(import_picocolors3.default.yellow("Qodewk Git hooks are already installed (post-commit, post-rewrite)."));
       return;
     }
     console.log(
-      import_picocolors.default.green(
+      import_picocolors3.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_picocolors.default.dim(`  (${existing} hook file(s) already contained the Qodewk marker)`));
+      console.log(import_picocolors3.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_picocolors.default.red(`Failed to install Git hook: ${message}`));
+    console.error(import_picocolors3.default.red(`Failed to install Git hook: ${message}`));
     process.exit(1);
   }
 });
@@ -14973,184 +16094,24 @@ hookCommand.command("uninstall").description("Remove Qodewk post-commit and post
   try {
     const hooksDir = resolveGitHooksDir();
     if (!hooksDir) {
-      console.log(import_picocolors.default.yellow("No Git repository found."));
+      console.log(import_picocolors3.default.yellow("No Git repository found."));
       return;
     }
     const targets = ["post-commit", "post-rewrite"];
     let removed = 0;
     for (const name of targets) {
-      const result = uninstallHookFile(path7.join(hooksDir, name));
+      const result = uninstallHookFile(path8.join(hooksDir, name));
       if (result === "removed") removed++;
     }
     if (removed === 0) {
-      console.log(import_picocolors.default.yellow("Qodewk hooks are not installed."));
+      console.log(import_picocolors3.default.yellow("Qodewk hooks are not installed."));
       return;
     }
-    console.log(import_picocolors.default.green(`\u2713 Qodewk hook markers removed from ${removed} file(s).`));
+    console.log(import_picocolors3.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_picocolors.default.red(`Failed to uninstall hook: ${message}`));
+    console.error(import_picocolors3.default.red(`Failed to uninstall hook: ${message}`));
     process.exit(1);
   }
 });
-var ansiHex = (hexColor) => {
-  const num = parseInt(hexColor.replace("#", ""), 16);
-  const r2 = num >> 16 & 255;
-  const g = num >> 8 & 255;
-  const b2 = num & 255;
-  return (text) => `\x1B[38;2;${r2};${g};${b2}m${text}\x1B[39m`;
-};
-var stripAnsi = (str) => {
-  return str.replace(/\x1B\[[0-9;]*[a-zA-Z]/g, "").replace(/\x1B\([B0]/g, "");
-};
-var visibleWidth = (str) => {
-  return stripAnsi(str).length;
-};
-function buildTerminalReceipt(receipt, publicUrl) {
-  const lines = [];
-  const coral = ansiHex("#cc785c");
-  const green = ansiHex("#5db872");
-  const red = ansiHex("#c64545");
-  const teal = ansiHex("#5db8a6");
-  const INNER_WIDTH = 52;
-  const push = (line) => lines.push(line);
-  const printRow = (content, width = INNER_WIDTH) => {
-    const visLen = visibleWidth(content);
-    const pad = Math.max(0, width - visLen);
-    push(`  | ${content}${" ".repeat(pad)} |`);
-  };
-  const printRowSplit = (left, right, width = INNER_WIDTH) => {
-    const leftVis = visibleWidth(left);
-    const rightVis = visibleWidth(right);
-    const pad = Math.max(1, width - leftVis - rightVis);
-    push(`  | ${left}${" ".repeat(pad)}${right} |`);
-  };
-  const printCenteredRow = (content, width = INNER_WIDTH) => {
-    const visLen = visibleWidth(content);
-    const totalPad = Math.max(0, width - visLen);
-    const leftPad = Math.floor(totalPad / 2);
-    const rightPad = totalPad - leftPad;
-    push(`  | ${" ".repeat(leftPad)}${content}${" ".repeat(rightPad)} |`);
-  };
-  const printDivider = (char = "=", width = INNER_WIDTH) => {
-    push(`  | ${char.repeat(width)} |`);
-  };
-  const totalTokens = (receipt.ai.tokens.input + receipt.ai.tokens.output).toLocaleString();
-  const inputK = `${Math.round(receipt.ai.tokens.input / 1e3)}k`;
-  const outputK = `${Math.round(receipt.ai.tokens.output / 1e3)}k`;
-  const costPrefix = receipt.ai.mode === "verified" ? "$" : "~$";
-  const confidencePercent = `${Math.round(receipt.ai.confidence * 100)}%`;
-  push("");
-  push("  " + import_picocolors.default.bold(coral("/\\".repeat(28))));
-  printCenteredRow(import_picocolors.default.bold(import_picocolors.default.white("Q O D E W K")));
-  printCenteredRow(coral("*** PROOF OF SHIPMENT ***"));
-  printRow("");
-  printRowSplit(
-    `ID:   ${receipt.receipt.id.slice(0, 24)}`,
-    `DATE: ${receipt.receipt.createdAt.slice(0, 10)}`
-  );
-  printRowSplit(
-    `REPO: ${receipt.repository.projectAlias.slice(0, 18)}`,
-    `BRANCH: ${receipt.repository.branch.slice(0, 16)}`
-  );
-  if (receipt.ai.task) {
-    const taskClean = receipt.ai.task.length > 44 ? receipt.ai.task.slice(0, 43) + "\u2026" : receipt.ai.task;
-    printRow(`TASK: ${taskClean}`);
-  }
-  printDivider("=");
-  const itemsHeader = receipt.repository.commitsCount && receipt.repository.commitsCount > 1 ? `ITEMS CHANGED (${receipt.repository.commitsCount} COMMITS)` : "ITEMS CHANGED";
-  printRowSplit(itemsHeader, "QTY");
-  printDivider("-");
-  printRowSplit("Files Touched", String(receipt.mutation.files));
-  printRowSplit("Lines Inserted", green("+ " + receipt.mutation.insertions));
-  printRowSplit("Lines Deleted", red("- " + receipt.mutation.deletions));
-  printRowSplit(
-    "Net Code Delta",
-    teal((receipt.mutation.netLines >= 0 ? "+ " : "- ") + Math.abs(receipt.mutation.netLines))
-  );
-  printDivider("-");
-  printRow("AI TELEMETRY & ATTRIBUTION");
-  const provString = receipt.ai.provider + " \xB7 " + (receipt.ai.model || "Unknown");
-  const cleanProv = provString.length > 40 ? provString.slice(0, 39) + "\u2026" : provString;
-  printRow(`Provider: ${cleanProv}`);
-  if (receipt.ai.aiWrittenRatio !== void 0) {
-    const aiPct = Math.round(receipt.ai.aiWrittenRatio * 100);
-    printRowSplit("AI Written Code", `${aiPct}% (Human: ${100 - aiPct}%)`);
-  }
-  const tokenDetail = `${inputK} in (${Math.round(receipt.ai.tokens.cached / 1e3)}k cached) / ${outputK} out`;
-  const cleanTokens = tokenDetail.length > 40 ? tokenDetail.slice(0, 39) + "\u2026" : tokenDetail;
-  printRow(`Tokens:   ${cleanTokens}`);
-  printRowSplit("Total Tokens:", totalTokens);
-  printDivider("=");
-  const costLabel = receipt.ai.mode === "verified" ? "VERIFIED AI COST" : "ESTIMATED AI COST";
-  printRowSplit(costLabel, import_picocolors.default.bold(coral(costPrefix + receipt.ai.cost.toFixed(2))));
-  printRowSplit(`CONFIDENCE: ${confidencePercent}`, `[Mode: ${receipt.ai.mode}]`);
-  printDivider("=");
-  printRow("");
-  const baseUrl = process.env.NEXT_PUBLIC_APP_URL || process.env.QODEWK_APP_URL || "https://qodewk.flinkeo.online";
-  const isPublished = Boolean(publicUrl);
-  const displayHost = baseUrl.replace(/^https?:\/\//, "");
-  const barcodePayload = pickBarcodePayload({
-    publicUrl,
-    receiptId: receipt.receipt.id,
-    displayHost,
-    maxChars: 28
-  });
-  const barcodeRows = renderTerminalBarcode(barcodePayload, {
-    maxWidth: INNER_WIDTH,
-    height: 3,
-    quietZone: 8
-  });
-  for (const barRow of barcodeRows) {
-    printCenteredRow(import_picocolors.default.bold(barRow));
-  }
-  if (isPublished) {
-    printCenteredRow(import_picocolors.default.cyan(displayHost));
-    printCenteredRow(import_picocolors.default.underline(import_picocolors.default.cyan(`r/${receipt.receipt.id}`)));
-  } else {
-    printCenteredRow(import_picocolors.default.yellow("[ LOCAL RECORD \u2014 NOT PUBLISHED ]"));
-  }
-  printRow("");
-  if (process.env.QODEWK_TELEMETRY === "off") {
-    printRow(`  ${teal("[\u2713]")} QODEWK_TELEMETRY=off (Cloud sync disabled)`);
-  }
-  printRow(`  ${green("[\u2713]")} Source code was never uploaded to Qodewk`);
-  push("  " + import_picocolors.default.bold(coral("\\/".repeat(28))));
-  push("");
-  if (isPublished && publicUrl) {
-    push(`  ${import_picocolors.default.dim("Public Receipt:")} ${import_picocolors.default.underline(import_picocolors.default.cyan(publicUrl))}`);
-  } else {
-    push(`  ${import_picocolors.default.dim("Saved to local DB:")} ${import_picocolors.default.dim("~/.qodewk/state.db")}`);
-    push(`  ${import_picocolors.default.dim("To publish & get shareable URL:")} ${import_picocolors.default.cyan("qodewk share")}`);
-  }
-  push("");
-  return lines.join("\n");
-}
-async function renderTerminalReceipt(receipt, publicUrl) {
-  console.log(buildTerminalReceipt(receipt, publicUrl));
-}
-async function outputReceipt(receipt, options, publicUrl) {
-  const format = options.json ? "json" : options.format || "terminal";
-  let content;
-  if (format === "json") {
-    content = JSON.stringify(receipt, null, 2);
-  } else if (format === "markdown") {
-    content = formatMarkdownReceipt(receipt, publicUrl);
-  } else {
-    content = buildTerminalReceipt(receipt, publicUrl);
-  }
-  if (options.out) {
-    const fileContent = format === "terminal" ? stripAnsi(content) : content;
-    fs6.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) {
-    if (format === "terminal") {
-      console.log(content);
-    } else {
-      console.log(content);
-    }
-  } else if (format !== "terminal") {
-  }
-}
 program2.parse(process.argv);