qodewk 0.7.0 → 0.8.0

package/dist/index.cjs

@@ -1153,7 +1153,7 @@ var require_command = __commonJS({
     "use strict";
     var EventEmitter2 = require("events").EventEmitter;
     var childProcess = require("child_process");
-    var path11 = require("path");
+    var path12 = require("path");
     var fs11 = require("fs");
     var process2 = require("process");
     var { Argument: Argument2, humanReadableArgName } = require_argument();
@@ -2153,9 +2153,9 @@ 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);
+          const localBin = path12.resolve(baseDir, baseName);
           if (fs11.existsSync(localBin)) return localBin;
-          if (sourceExt.includes(path11.extname(baseName))) return void 0;
+          if (sourceExt.includes(path12.extname(baseName))) return void 0;
           const foundExt = sourceExt.find(
             (ext) => fs11.existsSync(`${localBin}${ext}`)
           );
@@ -2173,17 +2173,17 @@ Expecting one of '${allowedValues.join("', '")}'`);
           } catch {
             resolvedScriptPath = this._scriptPath;
           }
-          executableDir = path11.resolve(
-            path11.dirname(resolvedScriptPath),
+          executableDir = path12.resolve(
+            path12.dirname(resolvedScriptPath),
             executableDir
           );
         }
         if (executableDir) {
           let localFile = findFile(executableDir, executableFile);
           if (!localFile && !subcommand._executableFile && this._scriptPath) {
-            const legacyName = path11.basename(
+            const legacyName = path12.basename(
               this._scriptPath,
-              path11.extname(this._scriptPath)
+              path12.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(path12.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 = path12.basename(filename, path12.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(path13) {
+        if (path13 === void 0) return this._executableDir;
+        this._executableDir = path13;
         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(path12, isFile, isDirectory) {
+      log(`checking %s`, path12);
       try {
-        const stat = fs_1.statSync(path11);
+        const stat = fs_1.statSync(path12);
         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(path12, type = exports2.READABLE) {
+      return check(path12, (type & exports2.FILE) > 0, (type & exports2.FOLDER) > 0);
     }
     exports2.exists = exists2;
     exports2.FILE = 1;
@@ -4156,7 +4156,7 @@ var require_dist2 = __commonJS({
 
 // src/index.ts
 var fs10 = __toESM(require("fs"), 1);
-var path10 = __toESM(require("path"), 1);
+var path11 = __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: path12, errorMaps, issueData } = params;
+  const fullPath = [...path12, ...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, path12, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path11;
+    this._path = path12;
     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(path12) {
+  return (0, import_file_exists.exists)(path12, 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(path12) {
+      return /^\.(git)?$/.test(path12.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 [path12, line, preview] = input.split(NULL);
+    paths.add(path12);
+    (results[path12] = results[path12] || []).push({
       line: asNumber(line),
-      path: path11,
+      path: path12,
       preview
     });
   });
@@ -10498,14 +10498,14 @@ var init_hash_object = __esm({
     init_task();
   }
 });
-function parseInit(bare, path11, text) {
+function parseInit(bare, path12, 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, path12, false, result[1]);
   }
   if (result = reInitResponseRegex.exec(response)) {
-    return new InitSummary(bare, path11, true, result[1]);
+    return new InitSummary(bare, path12, 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, path12, /^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, path12, existing, gitDir) {
         this.bare = bare;
-        this.path = path11;
+        this.path = path12;
         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, path12, 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"), path12, text);
     }
   };
 }
@@ -11363,12 +11363,12 @@ var init_FileStatusSummary = __esm({
     "use strict";
     fromPathRegex = /^(.+)\0(.+)$/;
     FileStatusSummary = class {
-      constructor(path11, index, working_dir) {
-        this.path = path11;
+      constructor(path12, index, working_dir) {
+        this.path = path12;
         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(path12) || [null, path12, path12];
           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, path12) {
     const raw = `${index}${workingDir}`;
     const handler = parsers6.get(raw);
     if (handler) {
-      handler(result, path11);
+      handler(result, path12);
     }
     if (raw !== "##" && raw !== "!!") {
-      result.files.push(new FileStatusSummary(path11, index, workingDir));
+      result.files.push(new FileStatusSummary(path12, index, workingDir));
     }
   }
 }
@@ -11757,9 +11757,9 @@ var init_simple_git_api = __esm({
           next
         );
       }
-      hashObject(path11, write) {
+      hashObject(path12, write) {
         return this._runTask(
-          hashObjectTask(path11, write === true),
+          hashObjectTask(path12, 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 path12 = input.trim().replace(/^["']|["']$/g, "");
+  return path12 && (0, import_node_path.normalize)(path12);
 }
 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, path12) {
+  return subModuleTask(["add", repo, path12]);
 }
 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, path12, then) {
+      return this._runTask(addSubModuleTask2(repo, path12), 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);
@@ -15060,6 +15063,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);
@@ -15618,9 +15625,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 +15645,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 +15673,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();
@@ -15735,7 +15764,7 @@ function buildTerminalReceipt(receipt, publicUrl) {
     maxChars: 28
   });
   const barcodeRows = renderTerminalBarcode(barcodePayload, {
-    maxWidth: INNER_WIDTH2,
+    maxWidth: INNER_WIDTH,
     height: 3,
     quietZone: 8
   });
@@ -15887,9 +15916,17 @@ function uninstallHookFile(hookFile) {
 
 // src/menu.ts
 var readline = __toESM(require("readline"), 1);
+var path10 = __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 +15950,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 +15958,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 +15971,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.8.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 +16093,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 = path10.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 +16154,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 +16264,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 +16302,10 @@ async function runInteractiveMenu() {
         await showStorageStatus();
         break;
       }
+      case "notes": {
+        await manageGitNotesSubmenu();
+        break;
+      }
       case "exit": {
         active = false;
         cleanup();
@@ -16210,25 +16340,83 @@ 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));
+          installHookFile(path10.join(status.hooksDir, t2));
         }
         console.log(colors.green("\n  [\u2713] Non-blocking hooks installed successfully."));
       }
     } 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));
+          uninstallHookFile(path10.join(status.hooksDir, t2));
         }
         console.log(colors.green("\n  [\u2713] Qodewk hooks removed."));
       }
     }
     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 +16459,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 +16515,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,10 +16548,10 @@ 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] ? path11.dirname(path11.resolve(process.argv[1])) : process.cwd();
     const candidates = [
-      path10.join(argv1, "..", "package.json"),
-      path10.join(argv1, "package.json")
+      path11.join(argv1, "..", "package.json"),
+      path11.join(argv1, "package.json")
     ];
     for (const candidate of candidates) {
       if (!fs10.existsSync(candidate)) continue;
@@ -16331,7 +16560,7 @@ function resolveCliVersion() {
     }
   } catch {
   }
-  return "0.3.0";
+  return "0.8.0";
 }
 function resolveSince(options) {
   return options.today ? "today" : options.since;
@@ -16350,6 +16579,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,
@@ -16499,7 +16734,7 @@ hookCommand.command("install").description("Install non-blocking post-commit and
     let installed = 0;
     let existing = 0;
     for (const name of targets) {
-      const result = installHookFile(path10.join(hooksDir, name));
+      const result = installHookFile(path11.join(hooksDir, name));
       if (result === "installed") installed++;
       else existing++;
     }
@@ -16531,7 +16766,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(path11.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.8.0",
   "description": "Universal telemetry and digital receipt generator for the AI coding agent era",
   "type": "module",
   "bin": {