qodewk 0.7.0 → 0.9.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 path11 = require("path");
-    var fs11 = require("fs");
+    var path13 = require("path");
+    var fs12 = 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 (fs11.existsSync(executableFile)) return;
+        if (fs12.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 = path11.resolve(baseDir, baseName);
-          if (fs11.existsSync(localBin)) return localBin;
-          if (sourceExt.includes(path11.extname(baseName))) return void 0;
+          const localBin = path13.resolve(baseDir, baseName);
+          if (fs12.existsSync(localBin)) return localBin;
+          if (sourceExt.includes(path13.extname(baseName))) return void 0;
           const foundExt = sourceExt.find(
-            (ext) => fs11.existsSync(`${localBin}${ext}`)
+            (ext) => fs12.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 = fs11.realpathSync(this._scriptPath);
+            resolvedScriptPath = fs12.realpathSync(this._scriptPath);
           } catch {
             resolvedScriptPath = this._scriptPath;
           }
-          executableDir = path11.resolve(
-            path11.dirname(resolvedScriptPath),
+          executableDir = path13.resolve(
+            path13.dirname(resolvedScriptPath),
             executableDir
           );
         }
         if (executableDir) {
           let localFile = findFile(executableDir, executableFile);
           if (!localFile && !subcommand._executableFile && this._scriptPath) {
-            const legacyName = path11.basename(
+            const legacyName = path13.basename(
               this._scriptPath,
-              path11.extname(this._scriptPath)
+              path13.extname(this._scriptPath)
             );
             if (legacyName !== this._name) {
               localFile = findFile(
@@ -2194,7 +2194,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
           }
           executableFile = localFile || executableFile;
         }
-        launchWithNode = sourceExt.includes(path11.extname(executableFile));
+        launchWithNode = sourceExt.includes(path13.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 = path11.basename(filename, path11.extname(filename));
+        this._name = path13.basename(filename, path13.extname(filename));
         return this;
       }
       /**
@@ -3055,9 +3055,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} [path]
        * @return {(string|null|Command)}
        */
-      executableDir(path12) {
-        if (path12 === void 0) return this._executableDir;
-        this._executableDir = path12;
+      executableDir(path14) {
+        if (path14 === void 0) return this._executableDir;
+        this._executableDir = path14;
         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(path11, isFile, isDirectory) {
-      log(`checking %s`, path11);
+    function check(path13, isFile, isDirectory) {
+      log(`checking %s`, path13);
       try {
-        const stat = fs_1.statSync(path11);
+        const stat = fs_1.statSync(path13);
         if (stat.isFile() && isFile) {
           log(`[OK] path represents a file`);
           return true;
@@ -4090,8 +4090,8 @@ var require_src2 = __commonJS({
         throw e;
       }
     }
-    function exists2(path11, type = exports2.READABLE) {
-      return check(path11, (type & exports2.FILE) > 0, (type & exports2.FOLDER) > 0);
+    function exists2(path13, type = exports2.READABLE) {
+      return check(path13, (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 fs10 = __toESM(require("fs"), 1);
-var path10 = __toESM(require("path"), 1);
+var fs11 = __toESM(require("fs"), 1);
+var path12 = __toESM(require("path"), 1);
 
 // ../../node_modules/.pnpm/commander@13.1.0/node_modules/commander/esm.mjs
 var import_index = __toESM(require_commander(), 1);
@@ -4659,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: path11, errorMaps, issueData } = params;
-  const fullPath = [...path11, ...issueData.path || []];
+  const { data, path: path13, errorMaps, issueData } = params;
+  const fullPath = [...path13, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -4776,11 +4776,11 @@ var errorUtil;
 
 // ../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value, path11, key) {
+  constructor(parent, value, path13, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path11;
+    this._path = path13;
     this._key = key;
   }
   get path() {
@@ -8892,8 +8892,8 @@ function toLinesWithContent(input = "", trimmed2 = true, separator = "\n") {
 function forEachLineWithContent(input, callback) {
   return toLinesWithContent(input, true).map((line) => callback(line));
 }
-function folderExists(path11) {
-  return (0, import_file_exists.exists)(path11, import_file_exists.FOLDER);
+function folderExists(path13) {
+  return (0, import_file_exists.exists)(path13, import_file_exists.FOLDER);
 }
 function append(target, item) {
   if (Array.isArray(target)) {
@@ -9295,8 +9295,8 @@ function checkIsRepoRootTask() {
     commands,
     format: "utf-8",
     onError,
-    parser(path11) {
-      return /^\.(git)?$/.test(path11.trim());
+    parser(path13) {
+      return /^\.(git)?$/.test(path13.trim());
     }
   };
 }
@@ -9730,11 +9730,11 @@ function parseGrep(grep) {
   const paths = /* @__PURE__ */ new Set();
   const results = {};
   forEachLineWithContent(grep, (input) => {
-    const [path11, line, preview] = input.split(NULL);
-    paths.add(path11);
-    (results[path11] = results[path11] || []).push({
+    const [path13, line, preview] = input.split(NULL);
+    paths.add(path13);
+    (results[path13] = results[path13] || []).push({
       line: asNumber(line),
-      path: path11,
+      path: path13,
       preview
     });
   });
@@ -10498,14 +10498,14 @@ var init_hash_object = __esm({
     init_task();
   }
 });
-function parseInit(bare, path11, text) {
+function parseInit(bare, path13, text) {
   const response = String(text).trim();
   let result;
   if (result = initResponseRegex.exec(response)) {
-    return new InitSummary(bare, path11, false, result[1]);
+    return new InitSummary(bare, path13, false, result[1]);
   }
   if (result = reInitResponseRegex.exec(response)) {
-    return new InitSummary(bare, path11, true, result[1]);
+    return new InitSummary(bare, path13, true, result[1]);
   }
   let gitDir = "";
   const tokens = response.split(" ");
@@ -10516,7 +10516,7 @@ function parseInit(bare, path11, text) {
       break;
     }
   }
-  return new InitSummary(bare, path11, /^re/i.test(response), gitDir);
+  return new InitSummary(bare, path13, /^re/i.test(response), gitDir);
 }
 var InitSummary;
 var initResponseRegex;
@@ -10525,9 +10525,9 @@ var init_InitSummary = __esm({
   "src/lib/responses/InitSummary.ts"() {
     "use strict";
     InitSummary = class {
-      constructor(bare, path11, existing, gitDir) {
+      constructor(bare, path13, existing, gitDir) {
         this.bare = bare;
-        this.path = path11;
+        this.path = path13;
         this.existing = existing;
         this.gitDir = gitDir;
       }
@@ -10539,7 +10539,7 @@ var init_InitSummary = __esm({
 function hasBareCommand(command) {
   return command.includes(bareCommand);
 }
-function initTask(bare = false, path11, customArgs) {
+function initTask(bare = false, path13, customArgs) {
   const commands = ["init", ...customArgs];
   if (bare && !hasBareCommand(commands)) {
     commands.splice(1, 0, bareCommand);
@@ -10548,7 +10548,7 @@ function initTask(bare = false, path11, customArgs) {
     commands,
     format: "utf-8",
     parser(text) {
-      return parseInit(commands.includes("--bare"), path11, text);
+      return parseInit(commands.includes("--bare"), path13, text);
     }
   };
 }
@@ -11363,12 +11363,12 @@ var init_FileStatusSummary = __esm({
     "use strict";
     fromPathRegex = /^(.+)\0(.+)$/;
     FileStatusSummary = class {
-      constructor(path11, index, working_dir) {
-        this.path = path11;
+      constructor(path13, index, working_dir) {
+        this.path = path13;
         this.index = index;
         this.working_dir = working_dir;
         if (index === "R" || working_dir === "R") {
-          const detail = fromPathRegex.exec(path11) || [null, path11, path11];
+          const detail = fromPathRegex.exec(path13) || [null, path13, path13];
           this.from = detail[2] || "";
           this.path = detail[1] || "";
         }
@@ -11399,14 +11399,14 @@ function splitLine(result, lineStr) {
     default:
       return;
   }
-  function data(index, workingDir, path11) {
+  function data(index, workingDir, path13) {
     const raw = `${index}${workingDir}`;
     const handler = parsers6.get(raw);
     if (handler) {
-      handler(result, path11);
+      handler(result, path13);
     }
     if (raw !== "##" && raw !== "!!") {
-      result.files.push(new FileStatusSummary(path11, index, workingDir));
+      result.files.push(new FileStatusSummary(path13, index, workingDir));
     }
   }
 }
@@ -11757,9 +11757,9 @@ var init_simple_git_api = __esm({
           next
         );
       }
-      hashObject(path11, write) {
+      hashObject(path13, write) {
         return this._runTask(
-          hashObjectTask(path11, write === true),
+          hashObjectTask(path13, write === true),
           trailingFunctionArgument(arguments)
         );
       }
@@ -12113,8 +12113,8 @@ var init_branch = __esm({
   }
 });
 function toPath(input) {
-  const path11 = input.trim().replace(/^["']|["']$/g, "");
-  return path11 && (0, import_node_path.normalize)(path11);
+  const path13 = input.trim().replace(/^["']|["']$/g, "");
+  return path13 && (0, import_node_path.normalize)(path13);
 }
 var parseCheckIgnore;
 var init_CheckIgnore = __esm({
@@ -12399,8 +12399,8 @@ __export2(sub_module_exports, {
   subModuleTask: () => subModuleTask,
   updateSubModuleTask: () => updateSubModuleTask
 });
-function addSubModuleTask(repo, path11) {
-  return subModuleTask(["add", repo, path11]);
+function addSubModuleTask(repo, path13) {
+  return subModuleTask(["add", repo, path13]);
 }
 function initSubModuleTask(customArgs) {
   return subModuleTask(["init", ...customArgs]);
@@ -12714,8 +12714,8 @@ var require_git = __commonJS2({
       }
       return this._runTask(straightThroughStringTask2(command, this._trimmed), next);
     };
-    Git2.prototype.submoduleAdd = function(repo, path11, then) {
-      return this._runTask(addSubModuleTask2(repo, path11), trailingFunctionArgument2(arguments));
+    Git2.prototype.submoduleAdd = function(repo, path13, then) {
+      return this._runTask(addSubModuleTask2(repo, path13), trailingFunctionArgument2(arguments));
     };
     Git2.prototype.submoduleUpdate = function(args, then) {
       return this._runTask(
@@ -13280,6 +13280,9 @@ function parseSinceOption(since) {
   if (s === "today") {
     return new Date(now.getFullYear(), now.getMonth(), now.getDate());
   }
+  if (s === "yesterday") {
+    return new Date(now.getFullYear(), now.getMonth(), now.getDate() - 1);
+  }
   const hoursMatch = s.match(/^(\d+)\s*h(?:ours?)?$/);
   if (hoursMatch && hoursMatch[1]) {
     const hours = parseInt(hoursMatch[1], 10);
@@ -13849,15 +13852,29 @@ var MODEL_ALIASES = {
   "deepseek-reasoner": "deepseek-r1",
   "deepseek/deepseek-r1": "deepseek-r1"
 };
+var DYNAMIC_RATE_CARDS = {};
+var DYNAMIC_ALIASES = {};
+function updatePricingRegistry(newCards, newAliases) {
+  DYNAMIC_RATE_CARDS = { ...DYNAMIC_RATE_CARDS, ...newCards };
+  if (newAliases) {
+    DYNAMIC_ALIASES = { ...DYNAMIC_ALIASES, ...newAliases };
+  }
+}
 function getRateCard(modelId) {
   if (!modelId)
-    return RATE_CARDS["default"];
+    return DYNAMIC_RATE_CARDS["default"] ?? RATE_CARDS["default"];
   let key = modelId.toLowerCase().replace(/[^a-z0-9-]/g, "-");
-  if (MODEL_ALIASES[modelId.toLowerCase()]) {
-    key = MODEL_ALIASES[modelId.toLowerCase()];
-  } else if (MODEL_ALIASES[key]) {
-    key = MODEL_ALIASES[key];
+  const aliasMatch = DYNAMIC_ALIASES[modelId.toLowerCase()] ?? MODEL_ALIASES[modelId.toLowerCase()];
+  if (aliasMatch) {
+    key = aliasMatch;
+  } else {
+    const fallbackAliasMatch = DYNAMIC_ALIASES[key] ?? MODEL_ALIASES[key];
+    if (fallbackAliasMatch) {
+      key = fallbackAliasMatch;
+    }
   }
+  if (DYNAMIC_RATE_CARDS[key])
+    return DYNAMIC_RATE_CARDS[key];
   if (RATE_CARDS[key])
     return RATE_CARDS[key];
   if (key.includes("opus")) {
@@ -14189,8 +14206,8 @@ function harvestAntigravityFootprints(repoPath, sinceDate) {
   const DatabaseSync2 = getSqliteDatabase();
   if (!DatabaseSync2)
     return footprints;
-  const homedir7 = os2.homedir();
-  const antigravityDir = process.env.ANTIGRAVITY_APP_DATA_DIR || path3.join(homedir7, ".gemini", "antigravity");
+  const homedir8 = os2.homedir();
+  const antigravityDir = process.env.ANTIGRAVITY_APP_DATA_DIR || path3.join(homedir8, ".gemini", "antigravity");
   const dbPath = path3.join(antigravityDir, "conversation_summaries.db");
   if (!fs2.existsSync(dbPath)) {
     return footprints;
@@ -14230,7 +14247,7 @@ function harvestAntigravityFootprints(repoPath, sinceDate) {
               continue;
             if (line.includes("Model Selection")) {
               const match = line.match(/Model Selection` from .*?to ([^\.\(\n\r]+)/);
-              if (match && match[1]) {
+              if (match && match[1] && match[1].length < 30) {
                 const rawModel = match[1].trim();
                 if (rawModel.toLowerCase().includes("opus"))
                   detectedModel = "claude-opus-4-6-thinking";
@@ -14286,8 +14303,8 @@ function harvestAntigravityFootprints(repoPath, sinceDate) {
           cached: estimatedCached
         },
         cost,
-        mode: "verified",
-        confidence: 0.95,
+        mode: "estimated",
+        confidence: 0.65,
         rawTranscriptPath: transcriptPath
       });
     }
@@ -14302,8 +14319,8 @@ var path4 = __toESM(require("path"), 1);
 var os3 = __toESM(require("os"), 1);
 function harvestClaudeFootprints(repoPath, projectAlias, sinceDate) {
   const footprints = [];
-  const homedir7 = os3.homedir();
-  const claudeProjectsDir = path4.join(homedir7, ".claude", "projects");
+  const homedir8 = os3.homedir();
+  const claudeProjectsDir = path4.join(homedir8, ".claude", "projects");
   if (!fs3.existsSync(claudeProjectsDir)) {
     return footprints;
   }
@@ -15060,6 +15077,10 @@ function parseSinceOption2(since) {
     const today = new Date(now.getFullYear(), now.getMonth(), now.getDate());
     return today;
   }
+  if (s === "yesterday") {
+    const yesterday = new Date(now.getFullYear(), now.getMonth(), now.getDate() - 1);
+    return yesterday;
+  }
   const hoursMatch = s.match(/^(\d+)\s*h(?:ours?)?$/);
   if (hoursMatch && hoursMatch[1]) {
     const hours = parseInt(hoursMatch[1], 10);
@@ -15105,7 +15126,7 @@ async function harvestUniversalFootprints(options) {
     allFootprints.push(...trailerFps);
   }
   const { primary, rankedFootprints } = selectPrimaryFootprint(allFootprints, options.gitContext);
-  allFootprints = rankedFootprints;
+  allFootprints = rankedFootprints.filter((fp) => fp.attributionScore === void 0 || fp.attributionScore >= 0.1);
   try {
     const db = new LocalStateDB();
     for (const fp of allFootprints) {
@@ -15224,6 +15245,49 @@ function estimateCost(options) {
   };
 }
 
+// ../core/dist/pricing-sync.js
+var fs8 = __toESM(require("fs"), 1);
+var path9 = __toESM(require("path"), 1);
+var os7 = __toESM(require("os"), 1);
+async function syncDynamicPricing(options) {
+  try {
+    const qodewkDir = path9.join(os7.homedir(), ".qodewk");
+    if (!fs8.existsSync(qodewkDir)) {
+      fs8.mkdirSync(qodewkDir, { recursive: true });
+    }
+    const cacheFile = path9.join(qodewkDir, "pricing_registry_cache.json");
+    const TTL_MS = 24 * 60 * 60 * 1e3;
+    const now = Date.now();
+    if (!options?.force && fs8.existsSync(cacheFile)) {
+      try {
+        const stats = fs8.statSync(cacheFile);
+        if (now - stats.mtimeMs < TTL_MS) {
+          const cachedData = JSON.parse(fs8.readFileSync(cacheFile, "utf-8"));
+          if (cachedData.rates) {
+            updatePricingRegistry(cachedData.rates, cachedData.aliases);
+          }
+          return;
+        }
+      } catch {
+      }
+    }
+    const REMOTE_URL = process.env.QODEWK_PRICING_URL || "https://raw.githubusercontent.com/abushaidislam/Qodewk/master/registry/pricing.json";
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), options?.timeoutMs || 2500);
+    const response = await fetch(REMOTE_URL, { signal: controller.signal });
+    clearTimeout(timeout);
+    if (response.ok) {
+      const data = await response.json();
+      if (data && typeof data === "object" && data.rates) {
+        updatePricingRegistry(data.rates, data.aliases);
+        fs8.promises.writeFile(cacheFile, JSON.stringify(data, null, 2), "utf-8").catch(() => {
+        });
+      }
+    }
+  } catch (error) {
+  }
+}
+
 // ../core/dist/format.js
 function formatMarkdownReceipt(receipt, publicUrl) {
   const baseUrl = process.env.NEXT_PUBLIC_APP_URL || process.env.QODEWK_APP_URL || "https://qodewk.flinkeo.online";
@@ -15283,6 +15347,7 @@ function sanitizeReceiptForShare(receipt) {
   };
 }
 async function generateReceipt(options = {}) {
+  await syncDynamicPricing({ timeoutMs: 1500 });
   const metrics = await extractGitMetrics({
     repoPath: options.repoPath || process.cwd(),
     baseSha: options.baseSha,
@@ -15388,7 +15453,7 @@ async function generateReceipt(options = {}) {
 }
 
 // src/receipt-view.ts
-var fs8 = __toESM(require("fs"), 1);
+var fs9 = __toESM(require("fs"), 1);
 var import_picocolors = __toESM(require_picocolors(), 1);
 
 // src/barcode.ts
@@ -15618,9 +15683,17 @@ var ansiHex = (hexColor) => {
   const b2 = num & 255;
   return (text) => `\x1B[38;2;${r2};${g};${b2}m${text}\x1B[39m`;
 };
+var bgAnsiHex = (hexColor) => {
+  const num = parseInt(hexColor.replace("#", ""), 16);
+  const r2 = num >> 16 & 255;
+  const g = num >> 8 & 255;
+  const b2 = num & 255;
+  return (text) => `\x1B[48;2;${r2};${g};${b2}m${text}\x1B[49m`;
+};
 var colors = {
   coral: ansiHex(THEME.primary),
   coralActive: ansiHex(THEME.primaryActive),
+  ink: ansiHex(THEME.ink),
   muted: ansiHex(THEME.muted),
   mutedSoft: ansiHex(THEME.mutedSoft),
   teal: ansiHex(THEME.teal),
@@ -15630,6 +15703,20 @@ var colors = {
   hairline: ansiHex(THEME.hairline),
   canvas: ansiHex(THEME.canvas)
 };
+var bg = {
+  coral: bgAnsiHex(THEME.primary),
+  teal: bgAnsiHex(THEME.teal),
+  dark: bgAnsiHex(THEME.surfaceDark),
+  card: bgAnsiHex(THEME.surfaceCard)
+};
+var bannerGradient = [
+  ansiHex("#e6dfd8"),
+  ansiHex("#b3aca4"),
+  ansiHex("#8e8b82"),
+  ansiHex("#6c6a64"),
+  ansiHex("#454440"),
+  ansiHex("#454440")
+];
 var stripAnsi = (str) => {
   return str.replace(/\x1B\[[0-9;]*[a-zA-Z]/g, "").replace(/\x1B\([B0]/g, "");
 };
@@ -15644,27 +15731,27 @@ function buildTerminalReceipt(receipt, publicUrl) {
   const green = colors.green;
   const red = colors.red;
   const teal = colors.teal;
-  const INNER_WIDTH2 = 52;
+  const INNER_WIDTH = 52;
   const push = (line) => lines.push(line);
-  const printRow = (content, width = INNER_WIDTH2) => {
+  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_WIDTH2) => {
+  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_WIDTH2) => {
+  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_WIDTH2) => {
+  const printDivider = (char = "=", width = INNER_WIDTH) => {
     push(`  | ${char.repeat(width)} |`);
   };
   const totalTokens = (receipt.ai.tokens.input + receipt.ai.tokens.output).toLocaleString();
@@ -15713,7 +15800,7 @@ function buildTerminalReceipt(receipt, publicUrl) {
   }
   if (receipt.ai.aiWrittenRatio !== void 0) {
     const aiPct = Math.round(receipt.ai.aiWrittenRatio * 100);
-    printRowSplit("AI Written Code", `${aiPct}% (Human: ${100 - aiPct}%)`);
+    printRowSplit("AI Touched Files", `${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;
@@ -15735,7 +15822,7 @@ function buildTerminalReceipt(receipt, publicUrl) {
     maxChars: 28
   });
   const barcodeRows = renderTerminalBarcode(barcodePayload, {
-    maxWidth: INNER_WIDTH2,
+    maxWidth: INNER_WIDTH,
     height: 3,
     quietZone: 8
   });
@@ -15780,7 +15867,7 @@ async function outputReceipt(receipt, options, publicUrl) {
   }
   if (options.out) {
     const fileContent = format === "terminal" ? stripAnsi(content) : content;
-    fs8.writeFileSync(options.out, fileContent.endsWith("\n") ? fileContent : fileContent + "\n", "utf-8");
+    fs9.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) {
@@ -15793,8 +15880,8 @@ async function outputReceipt(receipt, options, publicUrl) {
 }
 
 // src/hooks.ts
-var fs9 = __toESM(require("fs"), 1);
-var path9 = __toESM(require("path"), 1);
+var fs10 = __toESM(require("fs"), 1);
+var path10 = __toESM(require("path"), 1);
 var HOOK_MARKER_BEGIN = "# --- BEGIN QODEWK HOOK ---";
 var HOOK_MARKER_END = "# --- END QODEWK HOOK ---";
 var HOOK_SNIPPET = `
@@ -15806,37 +15893,37 @@ fi
 ${HOOK_MARKER_END}
 `;
 function resolveGitHooksDir(cwd = process.cwd()) {
-  const gitPath = path9.join(cwd, ".git");
-  if (!fs9.existsSync(gitPath)) return null;
+  const gitPath = path10.join(cwd, ".git");
+  if (!fs10.existsSync(gitPath)) return null;
   let gitCommonDir;
-  const stat = fs9.statSync(gitPath);
+  const stat = fs10.statSync(gitPath);
   if (stat.isDirectory()) {
     gitCommonDir = gitPath;
   } else {
-    const content = fs9.readFileSync(gitPath, "utf-8");
+    const content = fs10.readFileSync(gitPath, "utf-8");
     const match = content.match(/gitdir:\s*(.+)/i);
     if (!match?.[1]) return null;
     let gitDir = match[1].trim();
-    if (!path9.isAbsolute(gitDir)) {
-      gitDir = path9.resolve(cwd, gitDir);
+    if (!path10.isAbsolute(gitDir)) {
+      gitDir = path10.resolve(cwd, gitDir);
     }
-    const commonFile = path9.join(gitDir, "commondir");
-    if (fs9.existsSync(commonFile)) {
-      let common = fs9.readFileSync(commonFile, "utf-8").trim();
-      if (!path9.isAbsolute(common)) {
-        common = path9.resolve(gitDir, common);
+    const commonFile = path10.join(gitDir, "commondir");
+    if (fs10.existsSync(commonFile)) {
+      let common = fs10.readFileSync(commonFile, "utf-8").trim();
+      if (!path10.isAbsolute(common)) {
+        common = path10.resolve(gitDir, common);
       }
       gitCommonDir = common;
-    } else if (path9.basename(path9.dirname(gitDir)) === "worktrees") {
-      gitCommonDir = path9.dirname(path9.dirname(gitDir));
+    } else if (path10.basename(path10.dirname(gitDir)) === "worktrees") {
+      gitCommonDir = path10.dirname(path10.dirname(gitDir));
     } else {
       gitCommonDir = gitDir;
     }
   }
-  return path9.join(gitCommonDir, "hooks");
+  return path10.join(gitCommonDir, "hooks");
 }
 function checkHookStatus(hooksDir) {
-  if (!hooksDir || !fs9.existsSync(hooksDir)) {
+  if (!hooksDir || !fs10.existsSync(hooksDir)) {
     return {
       isGit: Boolean(hooksDir),
       hooksDir,
@@ -15844,12 +15931,12 @@ function checkHookStatus(hooksDir) {
       postRewriteInstalled: false
     };
   }
-  const postCommit = path9.join(hooksDir, "post-commit");
-  const postRewrite = path9.join(hooksDir, "post-rewrite");
+  const postCommit = path10.join(hooksDir, "post-commit");
+  const postRewrite = path10.join(hooksDir, "post-rewrite");
   const hasHook = (p2) => {
-    if (!fs9.existsSync(p2)) return false;
+    if (!fs10.existsSync(p2)) return false;
     try {
-      const content = fs9.readFileSync(p2, "utf-8");
+      const content = fs10.readFileSync(p2, "utf-8");
       return content.includes(HOOK_MARKER_BEGIN);
     } catch {
       return false;
@@ -15864,32 +15951,40 @@ function checkHookStatus(hooksDir) {
 }
 function installHookFile(hookFile) {
   let content = "";
-  if (fs9.existsSync(hookFile)) {
-    content = fs9.readFileSync(hookFile, "utf-8");
+  if (fs10.existsSync(hookFile)) {
+    content = fs10.readFileSync(hookFile, "utf-8");
   } else {
     content = "#!/bin/sh\n";
   }
   if (content.includes(HOOK_MARKER_BEGIN)) {
     return "exists";
   }
-  fs9.writeFileSync(hookFile, content + HOOK_SNIPPET, { mode: 493 });
+  fs10.writeFileSync(hookFile, content + HOOK_SNIPPET, { mode: 493 });
   return "installed";
 }
 function uninstallHookFile(hookFile) {
-  if (!fs9.existsSync(hookFile)) return "absent";
-  const content = fs9.readFileSync(hookFile, "utf-8");
+  if (!fs10.existsSync(hookFile)) return "absent";
+  const content = fs10.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, "");
-  fs9.writeFileSync(hookFile, updated, { mode: 493 });
+  fs10.writeFileSync(hookFile, updated, { mode: 493 });
   return "removed";
 }
 
 // src/menu.ts
 var readline = __toESM(require("readline"), 1);
+var path11 = __toESM(require("path"), 1);
 var import_picocolors2 = __toESM(require_picocolors(), 1);
-var INNER_WIDTH = 58;
 var SHARE_PAYLOAD_MAX_BYTES = 5e4;
+var BANNER_LINES = [
+  "  \u2588\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557    \u2588\u2588\u2557\u2588\u2588\u2557  \u2588\u2588\u2557",
+  " \u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2551    \u2588\u2588\u2551\u2588\u2588\u2551 \u2588\u2588\u2554\u255D",
+  " \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551 \u2588\u2557 \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2554\u255D ",
+  " \u2588\u2588\u2551\u2584\u2584 \u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u255D  \u2588\u2588\u2551\u2588\u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2588\u2588\u2557 ",
+  " \u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u255A\u2588\u2588\u2588\u2554\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551  \u2588\u2588\u2557",
+  "  \u255A\u2550\u2550\u2580\u2580\u2550\u255D  \u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u255D\u255A\u2550\u2550\u255D \u255A\u2550\u255D  \u255A\u2550\u255D"
+];
 var MENU_ITEMS = [
   {
     id: "receipt",
@@ -15913,7 +16008,7 @@ var MENU_ITEMS = [
     id: "hooks",
     key: "4",
     label: "Configure Git Hooks",
-    description: "Non-blocking background telemetry recording"
+    description: "Non-blocking background telemetry recording (< 5ms)"
   },
   {
     id: "storage",
@@ -15921,6 +16016,12 @@ var MENU_ITEMS = [
     label: "Database & Storage Status",
     description: "Inspect local SQLite (~/.qodewk/state.db) records"
   },
+  {
+    id: "notes",
+    key: "6",
+    label: "Git Notes Management",
+    description: "Inspect & attach receipts to refs/notes/qodewk"
+  },
   {
     id: "exit",
     key: "0",
@@ -15928,79 +16029,95 @@ var MENU_ITEMS = [
     description: "Return to shell"
   }
 ];
-function buildMenuFrame(selectedIndex, items = MENU_ITEMS) {
+var RECEIPT_HORIZON_ITEMS = [
+  {
+    id: "latest",
+    key: "1",
+    label: "Latest Changes (Default)",
+    description: "Current git working tree or latest commit"
+  },
+  {
+    id: "today",
+    key: "2",
+    label: "Today's Work Session",
+    description: "Commits & agent activity since midnight (--today)"
+  },
+  {
+    id: "yesterday",
+    key: "3",
+    label: "Yesterday's Work",
+    description: "Activity from yesterday to now (--since yesterday)"
+  },
+  {
+    id: "week",
+    key: "4",
+    label: "Past 7 Days (Sprint)",
+    description: "Weekly sprint telemetry across all agents (--since 7d)"
+  },
+  {
+    id: "custom",
+    key: "5",
+    label: "Custom Duration",
+    description: "Specify hours (e.g. 12h) or days (e.g. 3d, 14d)"
+  },
+  {
+    id: "back",
+    key: "0",
+    label: "Back to Main Menu",
+    description: "Return to previous screen"
+  }
+];
+function buildMenuFrame(selectedIndex, items = MENU_ITEMS, title = "Telemetry Control Panel", subtitle = "\u2191\u2193 move \xB7 enter select \xB7 0-6 quick jump \xB7 q quit", options = {}) {
   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("");
+  if (options.showBanner ?? true) {
+    push("");
+    for (let i2 = 0; i2 < BANNER_LINES.length; i2++) {
+      const gradFn = bannerGradient[i2] || bannerGradient[bannerGradient.length - 1];
+      push(gradFn(BANNER_LINES[i2]));
     }
   }
-  printRow("");
-  if (exitItem) {
-    printDivider();
-    const exitIndex = items.indexOf(exitItem);
-    const isSelected = exitIndex === selectedIndex;
+  push("");
+  const badge = bg.teal(import_picocolors2.default.bold(colors.ink(" qodewk ")));
+  push(`  ${colors.mutedSoft("\u250C")}  ${badge}  ${import_picocolors2.default.dim("v0.9.0")}`);
+  push(`  ${colors.mutedSoft("\u2502")}`);
+  if (options.actionContext) {
+    push(`  ${colors.teal("\u25C7")}  ${import_picocolors2.default.dim("Action:")} ${import_picocolors2.default.white(options.actionContext)}`);
+    push(`  ${colors.mutedSoft("\u2502")}`);
+  } else {
+    const repo = options.repoContext?.alias || "Qodewk";
+    const branch = options.repoContext?.branch ? `(${options.repoContext.branch})` : "";
+    push(`  ${colors.teal("\u25C7")}  ${import_picocolors2.default.dim("Repository:")} ${import_picocolors2.default.white(repo)} ${import_picocolors2.default.dim(branch)}`);
+    push(`  ${colors.mutedSoft("\u2502")}`);
+    push(`  ${colors.teal("\u25C7")}  ${import_picocolors2.default.dim("Telemetry:")} ${import_picocolors2.default.white("Claude Warm Editorial Rate Cards")}`);
+    push(`  ${colors.mutedSoft("\u2502")}`);
+  }
+  push(`  ${colors.coral("\u25C6")}  ${import_picocolors2.default.bold(import_picocolors2.default.white(title))}`);
+  push(`  ${colors.mutedSoft("\u2502")}`);
+  const selectedItem = items[selectedIndex] || items[0];
+  for (let i2 = 0; i2 < items.length; i2++) {
+    const item = items[i2];
+    const isSelected = i2 === 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)}`);
+      push(
+        `  ${colors.mutedSoft("\u2502")}  ${import_picocolors2.default.bold(colors.coral("\u203A"))} ${import_picocolors2.default.bold(colors.coral(item.key))}  ${import_picocolors2.default.bold(import_picocolors2.default.white(item.label))}`
+      );
     } 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)}`);
+      push(
+        `  ${colors.mutedSoft("\u2502")}    ${import_picocolors2.default.dim(item.key)}  ${import_picocolors2.default.dim(import_picocolors2.default.white(item.label))}`
+      );
     }
   }
-  printDivider();
-  printCenteredRow(import_picocolors2.default.dim("[\u2713] Source code was never uploaded to Qodewk"));
-  push(`  ${border("\u2514" + "\u2500".repeat(INNER_WIDTH + 2) + "\u2518")}`);
+  const divider = colors.mutedSoft("\u2500".repeat(58));
+  push(`  ${colors.mutedSoft("\u2502")}`);
+  push(`  ${colors.mutedSoft("\u2502")}  ${divider}`);
+  push(`  ${colors.mutedSoft("\u2502")}  ${import_picocolors2.default.bold(import_picocolors2.default.dim("Description"))}`);
+  push(`  ${colors.mutedSoft("\u2502")}  ${colors.amber(selectedItem.description)}`);
+  push(`  ${colors.mutedSoft("\u2502")}  ${divider}`);
+  push(`  ${colors.mutedSoft("\u2502")}`);
+  push(`  ${colors.mutedSoft("\u2502")}  ${import_picocolors2.default.dim(subtitle)}`);
+  push(`  ${colors.mutedSoft("\u2502")}  ${colors.green("[\u2713]")} ${import_picocolors2.default.dim("Source code was never uploaded to Qodewk")}`);
+  push(`  ${colors.mutedSoft("\u2514")}`);
   push("");
   return lines.join("\n");
 }
@@ -16034,17 +16151,50 @@ function waitForKeyToReturn() {
     process.stdin.once("data", onKey);
   });
 }
+var cachedRepoContext = null;
+async function getRepoContext() {
+  if (cachedRepoContext) return cachedRepoContext;
+  try {
+    const { simpleGit: simpleGit2 } = await import("simple-git");
+    const git = simpleGit2(process.cwd());
+    const isRepo = await git.checkIsRepo();
+    if (!isRepo) {
+      cachedRepoContext = { alias: "Workspace", branch: "detached" };
+      return cachedRepoContext;
+    }
+    const branchSummary = await git.branch();
+    const branch = branchSummary.current || "HEAD";
+    const alias = path11.basename(process.cwd());
+    cachedRepoContext = { alias, branch };
+    return cachedRepoContext;
+  } catch {
+    cachedRepoContext = { alias: "Workspace", branch: "detached" };
+    return cachedRepoContext;
+  }
+}
 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;
   }
+  const repoContext = await getRepoContext();
+  let currentScreen = "main";
   let selectedIndex = 0;
   let active = true;
   let lastRenderedLinesCount = 0;
+  const getActiveItems = () => currentScreen === "main" ? MENU_ITEMS : RECEIPT_HORIZON_ITEMS;
   const render = () => {
-    const frame = buildMenuFrame(selectedIndex);
+    const items = getActiveItems();
+    const title = currentScreen === "main" ? "Telemetry Control Panel" : "Generate Local Receipt";
+    const subtitle = currentScreen === "main" ? "\u2191\u2193 move \xB7 enter select \xB7 0-6 quick jump \xB7 q quit" : "\u2191\u2193 move \xB7 enter select \xB7 0-5 quick jump \xB7 esc / 0 back";
+    const actionContext = currentScreen === "receipt_horizon" ? "Generate Local Receipt" : void 0;
+    const showBanner = currentScreen === "main";
+    const frame = buildMenuFrame(selectedIndex, items, title, subtitle, {
+      repoContext,
+      actionContext,
+      showBanner
+    });
     const lineCount = frame.split("\n").length;
     if (lastRenderedLinesCount > 0) {
       readline.cursorTo(process.stdout, 0);
@@ -16062,28 +16212,52 @@ async function runInteractiveMenu() {
     process.stdout.write("\x1B[?25h");
   };
   process.on("exit", cleanup);
+  const executeReceiptHorizon = async (item) => {
+    cleanup();
+    console.log("");
+    lastRenderedLinesCount = 0;
+    let since = void 0;
+    let label = "latest git diff";
+    if (item.id === "today") {
+      since = "today";
+      label = "today's work session (--today)";
+    } else if (item.id === "yesterday") {
+      since = "yesterday";
+      label = "yesterday's work (--since yesterday)";
+    } else if (item.id === "week") {
+      since = "7d";
+      label = "past 7 days weekly sprint (--since 7d)";
+    } else if (item.id === "custom") {
+      console.log(import_picocolors2.default.bold(import_picocolors2.default.white("  Custom Telemetry Horizon")));
+      console.log(import_picocolors2.default.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+      const input = await askLine("  \u203A Enter duration or date (e.g. 12h, 3d, 2026-10-01): ");
+      if (input) {
+        since = input;
+        label = `custom range: ${input}`;
+      }
+    }
+    console.log(import_picocolors2.default.dim(`  [\xB7] Generating local receipt for ${label}...`));
+    try {
+      const receipt = await generateReceipt({ since, 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();
+    currentScreen = "main";
+    selectedIndex = 0;
+  };
   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"));
@@ -16148,6 +16322,16 @@ async function runInteractiveMenu() {
           });
           if (!response.ok) {
             const errText = await response.text().catch(() => "");
+            if (response.status === 503) {
+              console.log(import_picocolors2.default.yellow("\n  Notice: Remote server requires durable storage (Supabase or PostgreSQL) in production"));
+              console.log(import_picocolors2.default.dim("  to protect receipts from serverless cold-start data loss."));
+              console.log(import_picocolors2.default.dim(`  Endpoint: ${endpoint}`));
+              console.log(colors.green("\n  [\u2713] Your receipt is safely saved locally in: ~/.qodewk/state.db"));
+              console.log(import_picocolors2.default.dim("      You can also save it as a local Git note: qodewk --notes\n"));
+              await renderTerminalReceipt(sanitized);
+              await waitForKeyToReturn();
+              break;
+            }
             throw new Error(`API responded with ${response.status}${errText ? `: ${errText.slice(0, 100)}` : ""}`);
           }
           const data = await response.json();
@@ -16176,6 +16360,10 @@ async function runInteractiveMenu() {
         await showStorageStatus();
         break;
       }
+      case "notes": {
+        await manageGitNotesSubmenu();
+        break;
+      }
       case "exit": {
         active = false;
         cleanup();
@@ -16210,7 +16398,6 @@ async function runInteractiveMenu() {
     const choice = await askLine("  \u203A Select option [0-2]: ");
     if (choice === "1") {
       if (status.hooksDir) {
-        const path11 = await import("path");
         const targets = ["post-commit", "post-rewrite"];
         for (const t2 of targets) {
           installHookFile(path11.join(status.hooksDir, t2));
@@ -16219,7 +16406,6 @@ async function runInteractiveMenu() {
       }
     } else if (choice === "2") {
       if (status.hooksDir) {
-        const path11 = await import("path");
         const targets = ["post-commit", "post-rewrite"];
         for (const t2 of targets) {
           uninstallHookFile(path11.join(status.hooksDir, t2));
@@ -16229,6 +16415,66 @@ async function runInteractiveMenu() {
     }
     await waitForKeyToReturn();
   };
+  const manageGitNotesSubmenu = async () => {
+    console.log(import_picocolors2.default.bold(import_picocolors2.default.white("\n  Qodewk Git Notes Management (refs/notes/qodewk)")));
+    console.log(import_picocolors2.default.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+    console.log("  [1] List commits with attached Qodewk notes");
+    console.log("  [2] Show receipt note on a commit (default: HEAD)");
+    console.log("  [3] Attach receipt note to a Git commit (default: HEAD)");
+    console.log("  [0] Back to main menu");
+    console.log("");
+    const choice = await askLine("  \u203A Select option [0-3]: ");
+    if (choice === "1") {
+      try {
+        const shas = await listGitReceiptNotes();
+        if (shas.length === 0) {
+          console.log(import_picocolors2.default.yellow("\n  No Qodewk Git notes found in repository."));
+        } else {
+          console.log(import_picocolors2.default.bold(`
+  Found ${shas.length} commit note(s) in refs/notes/qodewk:`));
+          for (const sha of shas) {
+            console.log(`    ${import_picocolors2.default.cyan(sha.slice(0, 10))} ${import_picocolors2.default.dim(sha)}`);
+          }
+        }
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(import_picocolors2.default.red(`
+  Error listing Git notes: ${message}`));
+      }
+    } else if (choice === "2") {
+      const commit = await askLine("  \u203A Commit SHA or ref [default: HEAD]: ") || "HEAD";
+      try {
+        const receipt = await readGitReceiptNote(commit);
+        if (!receipt) {
+          console.log(import_picocolors2.default.yellow(`
+  No Qodewk receipt note found on commit '${commit}'.`));
+        } else {
+          await renderTerminalReceipt(receipt);
+        }
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(import_picocolors2.default.red(`
+  Error reading Git note: ${message}`));
+      }
+    } else if (choice === "3") {
+      const commit = await askLine("  \u203A Commit SHA to attach note [default: HEAD]: ") || "HEAD";
+      try {
+        console.log(import_picocolors2.default.dim(`
+  [\xB7] Generating receipt for ${commit}...`));
+        const receipt = await generateReceipt({ headSha: commit });
+        await writeGitReceiptNote(receipt.repository.headSha, receipt);
+        console.log(
+          colors.green(`
+  [\u2713] Attached receipt note to ${receipt.repository.headSha.slice(0, 7)} (refs/notes/qodewk)`)
+        );
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(import_picocolors2.default.red(`
+  Error writing Git note: ${message}`));
+      }
+    }
+    await waitForKeyToReturn();
+  };
   const showStorageStatus = async () => {
     console.log(import_picocolors2.default.bold(import_picocolors2.default.white("\n  Qodewk Local Database & Storage Status")));
     console.log(import_picocolors2.default.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
@@ -16271,31 +16517,55 @@ async function runInteractiveMenu() {
     render();
     const onKeypress = async (_str, key) => {
       if (!active) return;
+      const items = getActiveItems();
       if (key.ctrl && key.name === "c") {
         cleanup();
         process.exit(0);
       }
       if (key.name === "q" || key.name === "escape") {
+        if (currentScreen !== "main") {
+          currentScreen = "main";
+          selectedIndex = 0;
+          render();
+          return;
+        }
         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;
+        selectedIndex = (selectedIndex - 1 + items.length) % items.length;
         render();
         return;
       }
       if (key.name === "down" || key.name === "j") {
-        selectedIndex = (selectedIndex + 1) % MENU_ITEMS.length;
+        selectedIndex = (selectedIndex + 1) % items.length;
         render();
         return;
       }
-      const itemByKey = MENU_ITEMS.findIndex((item) => item.key === key.name || item.key === _str);
+      const itemByKey = items.findIndex((item) => item.key === key.name || item.key === _str);
       if (itemByKey !== -1) {
         selectedIndex = itemByKey;
         render();
         process.stdin.removeListener("keypress", onKeypress);
-        await executeSelectedAction();
+        const selected = items[selectedIndex];
+        if (currentScreen === "main") {
+          if (selected.id === "receipt") {
+            currentScreen = "receipt_horizon";
+            selectedIndex = 0;
+            if (active) startLoop();
+            return;
+          }
+          await executeSelectedAction();
+        } else {
+          if (selected.id === "back") {
+            currentScreen = "main";
+            selectedIndex = 0;
+            if (active) startLoop();
+            return;
+          }
+          await executeReceiptHorizon(selected);
+        }
         if (active) {
           startLoop();
         }
@@ -16303,7 +16573,24 @@ async function runInteractiveMenu() {
       }
       if (key.name === "return" || key.name === "enter") {
         process.stdin.removeListener("keypress", onKeypress);
-        await executeSelectedAction();
+        const selected = items[selectedIndex];
+        if (currentScreen === "main") {
+          if (selected.id === "receipt") {
+            currentScreen = "receipt_horizon";
+            selectedIndex = 0;
+            if (active) startLoop();
+            return;
+          }
+          await executeSelectedAction();
+        } else {
+          if (selected.id === "back") {
+            currentScreen = "main";
+            selectedIndex = 0;
+            if (active) startLoop();
+            return;
+          }
+          await executeReceiptHorizon(selected);
+        }
         if (active) {
           startLoop();
         }
@@ -16319,19 +16606,19 @@ async function runInteractiveMenu() {
 var SHARE_PAYLOAD_MAX_BYTES2 = 5e4;
 function resolveCliVersion() {
   try {
-    const argv1 = process.argv[1] ? path10.dirname(path10.resolve(process.argv[1])) : process.cwd();
+    const argv1 = process.argv[1] ? path12.dirname(path12.resolve(process.argv[1])) : process.cwd();
     const candidates = [
-      path10.join(argv1, "..", "package.json"),
-      path10.join(argv1, "package.json")
+      path12.join(argv1, "..", "package.json"),
+      path12.join(argv1, "package.json")
     ];
     for (const candidate of candidates) {
-      if (!fs10.existsSync(candidate)) continue;
-      const pkg = JSON.parse(fs10.readFileSync(candidate, "utf-8"));
+      if (!fs11.existsSync(candidate)) continue;
+      const pkg = JSON.parse(fs11.readFileSync(candidate, "utf-8"));
       if (pkg.name === "qodewk" && pkg.version) return pkg.version;
     }
   } catch {
   }
-  return "0.3.0";
+  return "0.9.0";
 }
 function resolveSince(options) {
   return options.today ? "today" : options.since;
@@ -16350,6 +16637,12 @@ program2.name("qodewk").description("Universal telemetry and digital receipt gen
     await runInteractiveMenu();
     return;
   }
+  const hasExplicitOption = options.json || options.out || options.provider || options.model || options.since || options.today || options.platform || options.anon || options.local || options.notes || options.format && options.format !== "terminal";
+  const isInteractiveTerminal = Boolean(process.stdin.isTTY && !process.env.CI);
+  if (!hasExplicitOption && isInteractiveTerminal) {
+    await runInteractiveMenu();
+    return;
+  }
   try {
     const receipt = await generateReceipt({
       provider: options.provider,
@@ -16492,14 +16785,14 @@ hookCommand.command("install").description("Install non-blocking post-commit and
       console.error(import_picocolors3.default.red("Error: Current directory is not a Git repository (.git not found)."));
       process.exit(1);
     }
-    if (!fs10.existsSync(hooksDir)) {
-      fs10.mkdirSync(hooksDir, { recursive: true });
+    if (!fs11.existsSync(hooksDir)) {
+      fs11.mkdirSync(hooksDir, { recursive: true });
     }
     const targets = ["post-commit", "post-rewrite"];
     let installed = 0;
     let existing = 0;
     for (const name of targets) {
-      const result = installHookFile(path10.join(hooksDir, name));
+      const result = installHookFile(path12.join(hooksDir, name));
       if (result === "installed") installed++;
       else existing++;
     }
@@ -16531,7 +16824,7 @@ hookCommand.command("uninstall").description("Remove Qodewk post-commit and post
     const targets = ["post-commit", "post-rewrite"];
     let removed = 0;
     for (const name of targets) {
-      const result = uninstallHookFile(path10.join(hooksDir, name));
+      const result = uninstallHookFile(path12.join(hooksDir, name));
       if (result === "removed") removed++;
     }
     if (removed === 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qodewk",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Universal telemetry and digital receipt generator for the AI coding agent era",
   "type": "module",
   "bin": {