qodewk 0.2.0 → 0.2.1

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 path7 = require("path");
+    var path8 = require("path");
     var fs7 = 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 = path7.resolve(baseDir, baseName);
+          const localBin = path8.resolve(baseDir, baseName);
           if (fs7.existsSync(localBin)) return localBin;
-          if (sourceExt.includes(path7.extname(baseName))) return void 0;
+          if (sourceExt.includes(path8.extname(baseName))) return void 0;
           const foundExt = sourceExt.find(
             (ext) => fs7.existsSync(`${localBin}${ext}`)
           );
@@ -2173,17 +2173,17 @@ Expecting one of '${allowedValues.join("', '")}'`);
           } catch {
             resolvedScriptPath = this._scriptPath;
           }
-          executableDir = path7.resolve(
-            path7.dirname(resolvedScriptPath),
+          executableDir = path8.resolve(
+            path8.dirname(resolvedScriptPath),
             executableDir
           );
         }
         if (executableDir) {
           let localFile = findFile(executableDir, executableFile);
           if (!localFile && !subcommand._executableFile && this._scriptPath) {
-            const legacyName = path7.basename(
+            const legacyName = path8.basename(
               this._scriptPath,
-              path7.extname(this._scriptPath)
+              path8.extname(this._scriptPath)
             );
             if (legacyName !== this._name) {
               localFile = findFile(
@@ -2194,7 +2194,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
           }
           executableFile = localFile || executableFile;
         }
-        launchWithNode = sourceExt.includes(path7.extname(executableFile));
+        launchWithNode = sourceExt.includes(path8.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 = path7.basename(filename, path7.extname(filename));
+        this._name = path8.basename(filename, path8.extname(filename));
         return this;
       }
       /**
@@ -3055,9 +3055,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} [path]
        * @return {(string|null|Command)}
        */
-      executableDir(path8) {
-        if (path8 === void 0) return this._executableDir;
-        this._executableDir = path8;
+      executableDir(path9) {
+        if (path9 === void 0) return this._executableDir;
+        this._executableDir = path9;
         return this;
       }
       /**
@@ -4956,10 +4956,10 @@ var require_segments = __commonJS({
       const segs = getSegmentsFromString(data, Utils.isKanjiModeEnabled());
       const nodes = buildNodes(segs);
       const graph = buildGraph(nodes, version);
-      const path7 = dijkstra.find_path(graph.map, "start", "end");
+      const path8 = dijkstra.find_path(graph.map, "start", "end");
       const optimizedSegs = [];
-      for (let i2 = 1; i2 < path7.length - 1; i2++) {
-        optimizedSegs.push(graph.table[path7[i2]].node);
+      for (let i2 = 1; i2 < path8.length - 1; i2++) {
+        optimizedSegs.push(graph.table[path8[i2]].node);
       }
       return exports2.fromArray(mergeSegments(optimizedSegs));
     };
@@ -6001,10 +6001,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(path7, isFile, isDirectory) {
-      log(`checking %s`, path7);
+    function check(path8, isFile, isDirectory) {
+      log(`checking %s`, path8);
       try {
-        const stat = fs_1.statSync(path7);
+        const stat = fs_1.statSync(path8);
         if (stat.isFile() && isFile) {
           log(`[OK] path represents a file`);
           return true;
@@ -6024,8 +6024,8 @@ var require_src2 = __commonJS({
         throw e;
       }
     }
-    function exists2(path7, type = exports2.READABLE) {
-      return check(path7, (type & exports2.FILE) > 0, (type & exports2.FOLDER) > 0);
+    function exists2(path8, type = exports2.READABLE) {
+      return check(path8, (type & exports2.FILE) > 0, (type & exports2.FOLDER) > 0);
     }
     exports2.exists = exists2;
     exports2.FILE = 1;
@@ -6090,6 +6090,7 @@ var require_dist2 = __commonJS({
 
 // src/index.ts
 var fs6 = __toESM(require("fs"), 1);
+var path7 = __toESM(require("path"), 1);
 
 // ../../node_modules/.pnpm/commander@13.1.0/node_modules/commander/esm.mjs
 var import_index = __toESM(require_commander(), 1);
@@ -6605,8 +6606,8 @@ function getErrorMap() {
 
 // ../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/helpers/parseUtil.js
 var makeIssue = (params) => {
-  const { data, path: path7, errorMaps, issueData } = params;
-  const fullPath = [...path7, ...issueData.path || []];
+  const { data, path: path8, errorMaps, issueData } = params;
+  const fullPath = [...path8, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -6722,11 +6723,11 @@ var errorUtil;
 
 // ../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value, path7, key) {
+  constructor(parent, value, path8, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path7;
+    this._path = path8;
     this._key = key;
   }
   get path() {
@@ -10838,8 +10839,8 @@ function toLinesWithContent(input = "", trimmed2 = true, separator = "\n") {
 function forEachLineWithContent(input, callback) {
   return toLinesWithContent(input, true).map((line) => callback(line));
 }
-function folderExists(path7) {
-  return (0, import_file_exists.exists)(path7, import_file_exists.FOLDER);
+function folderExists(path8) {
+  return (0, import_file_exists.exists)(path8, import_file_exists.FOLDER);
 }
 function append(target, item) {
   if (Array.isArray(target)) {
@@ -11241,8 +11242,8 @@ function checkIsRepoRootTask() {
     commands,
     format: "utf-8",
     onError,
-    parser(path7) {
-      return /^\.(git)?$/.test(path7.trim());
+    parser(path8) {
+      return /^\.(git)?$/.test(path8.trim());
     }
   };
 }
@@ -11676,11 +11677,11 @@ function parseGrep(grep) {
   const paths = /* @__PURE__ */ new Set();
   const results = {};
   forEachLineWithContent(grep, (input) => {
-    const [path7, line, preview] = input.split(NULL);
-    paths.add(path7);
-    (results[path7] = results[path7] || []).push({
+    const [path8, line, preview] = input.split(NULL);
+    paths.add(path8);
+    (results[path8] = results[path8] || []).push({
       line: asNumber(line),
-      path: path7,
+      path: path8,
       preview
     });
   });
@@ -12444,14 +12445,14 @@ var init_hash_object = __esm({
     init_task();
   }
 });
-function parseInit(bare, path7, text) {
+function parseInit(bare, path8, text) {
   const response = String(text).trim();
   let result;
   if (result = initResponseRegex.exec(response)) {
-    return new InitSummary(bare, path7, false, result[1]);
+    return new InitSummary(bare, path8, false, result[1]);
   }
   if (result = reInitResponseRegex.exec(response)) {
-    return new InitSummary(bare, path7, true, result[1]);
+    return new InitSummary(bare, path8, true, result[1]);
   }
   let gitDir = "";
   const tokens = response.split(" ");
@@ -12462,7 +12463,7 @@ function parseInit(bare, path7, text) {
       break;
     }
   }
-  return new InitSummary(bare, path7, /^re/i.test(response), gitDir);
+  return new InitSummary(bare, path8, /^re/i.test(response), gitDir);
 }
 var InitSummary;
 var initResponseRegex;
@@ -12471,9 +12472,9 @@ var init_InitSummary = __esm({
   "src/lib/responses/InitSummary.ts"() {
     "use strict";
     InitSummary = class {
-      constructor(bare, path7, existing, gitDir) {
+      constructor(bare, path8, existing, gitDir) {
         this.bare = bare;
-        this.path = path7;
+        this.path = path8;
         this.existing = existing;
         this.gitDir = gitDir;
       }
@@ -12485,7 +12486,7 @@ var init_InitSummary = __esm({
 function hasBareCommand(command) {
   return command.includes(bareCommand);
 }
-function initTask(bare = false, path7, customArgs) {
+function initTask(bare = false, path8, customArgs) {
   const commands = ["init", ...customArgs];
   if (bare && !hasBareCommand(commands)) {
     commands.splice(1, 0, bareCommand);
@@ -12494,7 +12495,7 @@ function initTask(bare = false, path7, customArgs) {
     commands,
     format: "utf-8",
     parser(text) {
-      return parseInit(commands.includes("--bare"), path7, text);
+      return parseInit(commands.includes("--bare"), path8, text);
     }
   };
 }
@@ -13309,12 +13310,12 @@ var init_FileStatusSummary = __esm({
     "use strict";
     fromPathRegex = /^(.+)\0(.+)$/;
     FileStatusSummary = class {
-      constructor(path7, index, working_dir) {
-        this.path = path7;
+      constructor(path8, index, working_dir) {
+        this.path = path8;
         this.index = index;
         this.working_dir = working_dir;
         if (index === "R" || working_dir === "R") {
-          const detail = fromPathRegex.exec(path7) || [null, path7, path7];
+          const detail = fromPathRegex.exec(path8) || [null, path8, path8];
           this.from = detail[2] || "";
           this.path = detail[1] || "";
         }
@@ -13345,14 +13346,14 @@ function splitLine(result, lineStr) {
     default:
       return;
   }
-  function data(index, workingDir, path7) {
+  function data(index, workingDir, path8) {
     const raw = `${index}${workingDir}`;
     const handler = parsers6.get(raw);
     if (handler) {
-      handler(result, path7);
+      handler(result, path8);
     }
     if (raw !== "##" && raw !== "!!") {
-      result.files.push(new FileStatusSummary(path7, index, workingDir));
+      result.files.push(new FileStatusSummary(path8, index, workingDir));
     }
   }
 }
@@ -13703,9 +13704,9 @@ var init_simple_git_api = __esm({
           next
         );
       }
-      hashObject(path7, write) {
+      hashObject(path8, write) {
         return this._runTask(
-          hashObjectTask(path7, write === true),
+          hashObjectTask(path8, write === true),
           trailingFunctionArgument(arguments)
         );
       }
@@ -14059,8 +14060,8 @@ var init_branch = __esm({
   }
 });
 function toPath(input) {
-  const path7 = input.trim().replace(/^["']|["']$/g, "");
-  return path7 && (0, import_node_path.normalize)(path7);
+  const path8 = input.trim().replace(/^["']|["']$/g, "");
+  return path8 && (0, import_node_path.normalize)(path8);
 }
 var parseCheckIgnore;
 var init_CheckIgnore = __esm({
@@ -14345,8 +14346,8 @@ __export2(sub_module_exports, {
   subModuleTask: () => subModuleTask,
   updateSubModuleTask: () => updateSubModuleTask
 });
-function addSubModuleTask(repo, path7) {
-  return subModuleTask(["add", repo, path7]);
+function addSubModuleTask(repo, path8) {
+  return subModuleTask(["add", repo, path8]);
 }
 function initSubModuleTask(customArgs) {
   return subModuleTask(["init", ...customArgs]);
@@ -14660,8 +14661,8 @@ var require_git = __commonJS2({
       }
       return this._runTask(straightThroughStringTask2(command, this._trimmed), next);
     };
-    Git2.prototype.submoduleAdd = function(repo, path7, then) {
-      return this._runTask(addSubModuleTask2(repo, path7), trailingFunctionArgument2(arguments));
+    Git2.prototype.submoduleAdd = function(repo, path8, then) {
+      return this._runTask(addSubModuleTask2(repo, path8), trailingFunctionArgument2(arguments));
     };
     Git2.prototype.submoduleUpdate = function(args, then) {
       return this._runTask(
@@ -16418,7 +16419,7 @@ async function generateReceipt(options = {}) {
 
 // src/index.ts
 var program2 = new Command();
-program2.name("qodewk").description("Universal telemetry and digital receipt generator for the AI coding agent era").version("0.1.10").option("-j, --json", "Output receipt in machine-readable JSON format").option("-f, --format <format>", "Output format (terminal, json, markdown)", "terminal").option("-o, --out <path>", "Write receipt output to specified file path").option("-p, --provider <provider>", "Specify AI provider (antigravity, claude, cursor, etc.)").option("-m, --model <model>", "Specify AI model identifier").option("-s, --since <duration>", "Harvest agent footprints since duration (e.g. today, 24h, 7d)").option("--today", "Harvest agent footprints for today").option("--platform <platform>", "Filter agent platform (antigravity, claude, cursor, all)").option("--anon", "Anonymize branch name in output").option("--barcode", "Render 1D barcode simulation instead of scannable 2D QR code").action(async (options) => {
+program2.name("qodewk").description("Universal telemetry and digital receipt generator for the AI coding agent era").version("0.2.1").option("-j, --json", "Output receipt in machine-readable JSON format").option("-f, --format <format>", "Output format (terminal, json, markdown)", "terminal").option("-o, --out <path>", "Write receipt output to specified file path").option("-p, --provider <provider>", "Specify AI provider (antigravity, claude, cursor, etc.)").option("-m, --model <model>", "Specify AI model identifier").option("-s, --since <duration>", "Harvest agent footprints since duration (e.g. today, 24h, 7d)").option("--today", "Harvest agent footprints for today").option("--platform <platform>", "Filter agent platform (antigravity, claude, cursor, all)").option("--anon", "Anonymize branch name in output").option("--barcode", "Render 1D barcode simulation instead of scannable 2D QR code").action(async (options) => {
   try {
     const since = options.today ? "today" : options.since;
     const receipt = await generateReceipt({
@@ -16466,7 +16467,7 @@ program2.command("share").description("Publish privacy-safe receipt to Qodewk cl
       await renderTerminalReceipt(receipt, void 0, options.barcode);
       return;
     }
-    const endpoint = process.env.QODEWK_API_URL || "https://qodewk.flinkeo.online/api/receipts";
+    const endpoint = process.env.QODEWK_API_URL || `${process.env.NEXT_PUBLIC_APP_URL || process.env.QODEWK_APP_URL || "https://qodewk.flinkeo.online"}/api/receipts`;
     console.log(import_picocolors.default.dim(`Publishing receipt ${receipt.receipt.id} to ${endpoint}...`));
     try {
       const response = await fetch(endpoint, {
@@ -16494,6 +16495,80 @@ Could not reach cloud API (${networkErr.message}). Rendered locally:`));
     process.exit(1);
   }
 });
+program2.command("record").description("Silently record local telemetry receipt into SQLite (used by git hooks)").action(async () => {
+  try {
+    const receipt = await generateReceipt();
+    const db = new LocalStateDB();
+    db.saveReceipt(receipt);
+    db.close();
+    process.exit(0);
+  } catch {
+    process.exit(0);
+  }
+});
+var hookCommand = program2.command("hook").description("Manage non-blocking Git hooks for automatic telemetry recording");
+hookCommand.command("install").description("Install non-blocking post-commit Git hook into current repository").action(async () => {
+  try {
+    const gitDir = path7.join(process.cwd(), ".git");
+    if (!fs6.existsSync(gitDir)) {
+      console.error(import_picocolors.default.red("Error: Current directory is not a Git repository root (.git not found)."));
+      process.exit(1);
+    }
+    const hooksDir = path7.join(gitDir, "hooks");
+    if (!fs6.existsSync(hooksDir)) {
+      fs6.mkdirSync(hooksDir, { recursive: true });
+    }
+    const hookFile = path7.join(hooksDir, "post-commit");
+    const hookMarkerBegin = "# --- BEGIN QODEWK HOOK ---";
+    const hookMarkerEnd = "# --- END QODEWK HOOK ---";
+    const hookSnippet = `
+${hookMarkerBegin}
+# Non-blocking Qodewk background recorder (< 5ms)
+if command -v qodewk >/dev/null 2>&1 || command -v pnpm >/dev/null 2>&1 || [ -f "./node_modules/.bin/qodewk" ]; then
+  ( ( qodewk record || pnpm qodewk record || npx qodewk record ) >/dev/null 2>&1 & )
+fi
+${hookMarkerEnd}
+`;
+    let content = "";
+    if (fs6.existsSync(hookFile)) {
+      content = fs6.readFileSync(hookFile, "utf-8");
+    } else {
+      content = "#!/bin/sh\n";
+    }
+    if (content.includes(hookMarkerBegin)) {
+      console.log(import_picocolors.default.yellow("Qodewk post-commit hook is already installed."));
+      return;
+    }
+    fs6.writeFileSync(hookFile, content + hookSnippet, { mode: 493 });
+    console.log(import_picocolors.default.green("\u2713 Non-blocking Qodewk post-commit hook successfully installed in .git/hooks/post-commit"));
+  } catch (err) {
+    console.error(import_picocolors.default.red(`Failed to install Git hook: ${err.message}`));
+    process.exit(1);
+  }
+});
+hookCommand.command("uninstall").description("Remove Qodewk post-commit Git hook").action(async () => {
+  try {
+    const hookFile = path7.join(process.cwd(), ".git", "hooks", "post-commit");
+    if (!fs6.existsSync(hookFile)) {
+      console.log(import_picocolors.default.yellow("No post-commit hook found."));
+      return;
+    }
+    const content = fs6.readFileSync(hookFile, "utf-8");
+    const hookMarkerBegin = "# --- BEGIN QODEWK HOOK ---";
+    const hookMarkerEnd = "# --- END QODEWK HOOK ---";
+    if (!content.includes(hookMarkerBegin)) {
+      console.log(import_picocolors.default.yellow("Qodewk hook is not installed."));
+      return;
+    }
+    const regex = new RegExp(`\\n?${hookMarkerBegin}[\\s\\S]*?${hookMarkerEnd}\\n?`, "g");
+    const updated = content.replace(regex, "");
+    fs6.writeFileSync(hookFile, updated, { mode: 493 });
+    console.log(import_picocolors.default.green("\u2713 Qodewk post-commit hook removed."));
+  } catch (err) {
+    console.error(import_picocolors.default.red(`Failed to uninstall hook: ${err.message}`));
+    process.exit(1);
+  }
+});
 var ansiHex = (hexColor) => {
   const num = parseInt(hexColor.replace("#", ""), 16);
   const r2 = num >> 16 & 255;
@@ -16611,6 +16686,7 @@ async function renderTerminalReceipt(receipt, publicUrl, useBarcode) {
   printDivider("=");
   printRow("");
   const baseUrl = process.env.NEXT_PUBLIC_APP_URL || process.env.QODEWK_APP_URL || "https://qodewk.flinkeo.online";
+  const isPublished = Boolean(publicUrl);
   const urlToDisplay = publicUrl || `${baseUrl}/r/${receipt.receipt.id}`;
   const displayHost = baseUrl.replace(/^https?:\/\//, "");
   if (useBarcode) {
@@ -16625,7 +16701,7 @@ async function renderTerminalReceipt(receipt, publicUrl, useBarcode) {
   } else {
     const qrRows = renderTerminalQr(urlToDisplay);
     if (qrRows.length > 0) {
-      printCenteredRow(import_picocolors.default.dim("--- SCAN WITH PHONE ---"));
+      printCenteredRow(import_picocolors.default.dim(isPublished ? "--- SCAN PUBLIC RECEIPT ---" : "--- LOCAL PROOF OF WORK ---"));
       printRow("");
       for (const qrRow of qrRows) {
         printCenteredRow(qrRow);
@@ -16635,8 +16711,12 @@ async function renderTerminalReceipt(receipt, publicUrl, useBarcode) {
       printCenteredRow(import_picocolors.default.bold("||| | ||||| ||| |||| |||||| |||| ||| ||||||| |||"));
     }
   }
-  printCenteredRow(import_picocolors.default.cyan(displayHost));
-  printCenteredRow(import_picocolors.default.underline(import_picocolors.default.cyan(`r/${receipt.receipt.id}`)));
+  if (isPublished) {
+    printCenteredRow(import_picocolors.default.cyan(displayHost));
+    printCenteredRow(import_picocolors.default.underline(import_picocolors.default.cyan(`r/${receipt.receipt.id}`)));
+  } else {
+    printCenteredRow(import_picocolors.default.yellow("[ LOCAL RECORD \u2014 NOT PUBLISHED ]"));
+  }
   printRow("");
   if (process.env.QODEWK_TELEMETRY === "off") {
     printRow(`  ${teal("[\u2713]")} QODEWK_TELEMETRY=off (Cloud sync disabled)`);
@@ -16644,9 +16724,14 @@ async function renderTerminalReceipt(receipt, publicUrl, useBarcode) {
   printRow(`  ${green("[\u2713]")} Source code was never uploaded to Qodewk`);
   console.log("  " + import_picocolors.default.bold(coral("\\/".repeat(28))));
   console.log("");
-  console.log(`  ${import_picocolors.default.dim("\u{1F517} Public Receipt:")} ${import_picocolors.default.underline(import_picocolors.default.cyan(urlToDisplay))}`);
+  if (isPublished) {
+    console.log(`  ${import_picocolors.default.dim("\u{1F517} Public Receipt:")} ${import_picocolors.default.underline(import_picocolors.default.cyan(urlToDisplay))}`);
+  } else {
+    console.log(`  ${import_picocolors.default.dim("\u{1F4BE} Saved to local DB:")} ${import_picocolors.default.dim("~/.qodewk/state.db")}`);
+    console.log(`  ${import_picocolors.default.dim("\u{1F4A1} To publish & get shareable URL:")} ${import_picocolors.default.cyan("qodewk share")}`);
+  }
   if (!useBarcode) {
-    console.log(`  ${import_picocolors.default.dim("\u{1F4CA} View classic 1D barcode:")} ${import_picocolors.default.cyan("pnpm qodewk --barcode")}`);
+    console.log(`  ${import_picocolors.default.dim("\u{1F4CA} View classic 1D barcode:")} ${import_picocolors.default.cyan("qodewk --barcode")}`);
   }
   console.log("");
 }

package/package.json

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