qodewk 0.1.9 → 0.1.10

package/README.md

@@ -1,12 +1,12 @@
 # Qodewk — Proof of Shipment for the AI Coding Agent Era
 
-> **Universal telemetry and digital receipt generator for autonomous software development.**  
-> Built for Claude Code, Cursor, Copilot, Codex, and multi-agent Git workflows.
+> **Universal telemetry, multi-platform agent footprint harvester, and digital receipt generator for autonomous software development.**  
+> Built for Google Antigravity, Claude Code, Cursor, Copilot, Windsurf, Aider, and multi-agent Git workflows.
 
 [![npm version](https://img.shields.io/npm/v/qodewk.svg?color=cc785c&label=npm%20package)](https://www.npmjs.com/package/qodewk)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 [![Built with Turborepo](https://img.shields.io/badge/monorepo-Turborepo-ef4444.svg)](https://turbo.build)
-[![Design: Claude Warm Editorial](https://img.shields.io/badge/design-Claude%20Editorial-cc785c.svg)](docs/design-system.md)
+[![Design: Claude Warm Editorial](https://img.shields.io/badge/design-Claude%20Editorial-cc785c.svg)](https://qodewk.dev)
 
 ---
 
@@ -15,9 +15,19 @@
 Run directly from any Git repository without installing any packages globally:
 
 ```bash
-# Generate monospace thermal receipt in terminal
+# Generate monospace thermal receipt for latest commit / working tree
 npx qodewk
 
+# Harvest agent work for today (Chit-style proof of shipment)
+npx qodewk --today
+
+# Harvest agent work from the last 24 hours or 7 days
+npx qodewk --since 24h
+npx qodewk --since 7d
+
+# Filter to a specific agent platform (antigravity, claude, cursor)
+npx qodewk --platform antigravity
+
 # Output machine-readable JSON telemetry
 npx qodewk --json
 
@@ -28,33 +38,35 @@ npx qodewk share
 npx qodewk audit --base origin/main --head HEAD --format markdown --out receipt.md
 ```
 
-### Thermal ASCII Receipt Preview
+### Verified Thermal ASCII Receipt Preview
 ```text
   /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
-  |                   Q O D E W K                        |
-  |             *** PROOF OF SHIPMENT ***                |
+  |                     Q O D E W K                      |
+  |              *** PROOF OF SHIPMENT ***               |
   |                                                      |
-  | ID:     rec_dd56d34a6bb4ff290b1d DATE: 2026-09-27    |
-  | REPO:   qodewk             BRANCH: master            |
+  | ID:   rec_8381ef3792010f9a2cfe      DATE: 2026-09-28 |
+  | REPO: qodewk                          BRANCH: master |
+  | TASK: Antigravity Model Provider Issues              |
   | ==================================================== |
   | ITEMS CHANGED                                    QTY |
   | ---------------------------------------------------- |
-  | Files Touched                                     40 |
-  | Lines Inserted                                + 3952 |
-  | Lines Deleted                                    - 0 |
-  | Net Code Delta                                + 3952 |
+  | Files Touched                                      1 |
+  | Lines Inserted                                  + 50 |
+  | Lines Deleted                                   - 58 |
+  | Net Code Delta                                   - 8 |
   | ---------------------------------------------------- |
-  | AI TELEMETRY                                         |
-  | Provider: anthropic · claude-3-7-sonnet              |
-  | Tokens:   200k in (120k cached) / 35k out            |
-  | Total Tokens:                                234,580 |
+  | AI TELEMETRY & ATTRIBUTION                           |
+  | Provider: antigravity · gemini-3                     |
+  | AI Written Code                     88% (Human: 12%) |
+  | Tokens:   935k in (654k cached) / 112k out           |
+  | Total Tokens:                              1,046,640 |
   | ==================================================== |
-  | ESTIMATED AI COST                             ~$0.79 |
-  | CONFIDENCE: 45%    [Mode: unknown  ]                 |
+  | VERIFIED AI COST                               $2.72 |
+  | CONFIDENCE: 95%                     [Mode: verified] |
   | ==================================================== |
   |                                                      |
   |   ||| | ||||| ||| |||| |||||| |||| ||| ||||||| |||   |
-  |   https://qodewk.dev/r/rec_dd56d34a6bb4ff290b1d830   |
+  |   https://qodewk.dev/r/rec_8381ef3792010f9a2cfe52…   |
   |                                                      |
   |   [✓] Source code was never uploaded to Qodewk       |
   \/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/
@@ -62,11 +74,44 @@ npx qodewk audit --base origin/main --head HEAD --format markdown --out receipt.
 
 ---
 
+## 🌟 What's New: Universal Multi-Platform Footprint Harvester
+
+Unlike single-vendor utilities (like Chit, which only support Claude Code CLI), **Qodewk operates globally across all major AI coding platforms**. It reads your local agent transcripts, matches them with your repository's Git revision graph, and proves what was actually shipped.
+
+### Supported Platforms & Harvesters
+
+| Platform | Local Data Source / Footprint | Captured Telemetry |
+|---|---|---|
+| **Google Antigravity** | `~/.gemini/antigravity/conversation_summaries.db` & `brain/<id>/.../transcript.jsonl` | Shipped task titles, exact models (`Claude Opus 4.6 Thinking`, `Gemini 3.8 Flash`, etc.), tool calls (`replace_file_content`, `write_to_file`), and multi-turn tokens |
+| **Claude Code CLI** | `~/.claude/projects/<slug>/sessions/*.jsonl` | User prompts, exact input/output/cached token usage, and `Edit`/`Write` file mutations |
+| **Cursor IDE** | `%APPDATA%\Cursor\User\workspaceStorage\*\state.vscdb` (Win) / `Library/Application Support/Cursor/...` (Mac) | Workspace session bubbles, model types (`claude-3-5-sonnet`, `gpt-4o`), and generation timestamps |
+| **Aider** | `.aider.chat.history.md` (Repository root) | Session prompts, model IDs, and code file diffs |
+| **GitHub Copilot** | Git commit revision graph trailers (`Co-authored-by: Copilot`) | Commit-level author attribution |
+
+### Key Capabilities
+
+1. **Date-wise & Duration Filtering:**
+   Analyze agent output over arbitrary time windows (`--today`, `--since 24h`, `--since 7d`, `--since "2026-09-28"`).
+2. **AI vs. Human Code Attribution:**
+   Cross-references Git diff hunks against agent tool calls to calculate exact contribution percentages (e.g. `AI Written Code: 88% (Human: 12%)`).
+3. **Shipped Task Recognition:**
+   Extracts high-level task summaries and user prompts directly from session databases, so your receipt doubles as an instant standup or PR summary.
+4. **Never Fake Precision (Dual-Engine Provenance):**
+   - **`verified` (95% Confidence):** Harvested directly from local agent transcripts & SQLite databases.
+   - **`estimated` (45–65% Confidence):** Contextual Git diff & AST complexity fallback when operating in closed/uninstrumented environments.
+5. **Modern Frontier Rate Cards:**
+   Built-in pricing cards with cache read/write rates for `claude-opus-4-6-thinking`, `claude-sonnet-4-6-thinking`, `gemini-3-8-flash`, `gemini-2-5-pro`, `gpt-4o`, `o3-mini`, `deepseek-v3`, and `deepseek-r1`.
+
+---
+
 ## 💻 CLI Command Reference
 
 | Command / Option | Description | Output / Example |
 |---|---|---|
-| `npx qodewk` | Inspect latest Git commit and generate monospace thermal receipt | Monospace terminal box |
+| `npx qodewk` | Harvest local agent footprints and inspect Git commit | Monospace thermal receipt |
+| `npx qodewk --today` | Generate receipt for all agent sessions and code written today | Daily shipment receipt |
+| `npx qodewk --since <duration>` | Filter agent work by duration (e.g. `24h`, `7d`, `2026-09-28`) | Time-bounded telemetry receipt |
+| `npx qodewk --platform <platform>` | Filter telemetry to a specific platform (`antigravity`, `claude`, `cursor`, `all`) | Single-platform audit |
 | `npx qodewk --json` | Export machine-readable telemetry conforming to canonical `ReceiptV1` schema | Formatted JSON output |
 | `npx qodewk share` | Publish privacy-safe metadata to Qodewk Cloud and generate short link | `https://qodewk.dev/r/rec_...` |
 | `npx qodewk audit --base <branch>` | Calculate aggregate diff and telemetry across an entire PR branch range | Git revision delta receipt |
@@ -76,106 +121,13 @@ npx qodewk audit --base origin/main --head HEAD --format markdown --out receipt.
 
 ---
 
-## 🤖 GitHub Action (Automated PR Sticky Receipts)
-
-Add Qodewk directly to your repository workflow to generate verifiable shipment receipts on every Pull Request:
-
-```yaml
-# .github/workflows/qodewk.yml
-name: "Qodewk Telemetry Receipt"
-
-on:
-  pull_request:
-    types: [opened, synchronize, reopened]
-
-permissions:
-  contents: read
-  pull-requests: write
-
-jobs:
-  audit-receipt:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout Code
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - name: Run Qodewk Audit
-        uses: abushaidislam/Qodewk/packages/action@v0.1.6
-        with:
-          github-token: ${{ secrets.GITHUB_TOKEN }}
-          base-ref: origin/${{ github.base_ref }}
-          head-sha: ${{ github.sha }}
-          publish-cloud: "true"
-```
-
----
-
 ## 🔒 Privacy Invariant (Zero Source Exfiltration)
 
 1. **No Code Leaves Your Machine:** Source code files and raw Git diff bodies **never** touch the network.
-2. **Metadata Only:** Public receipts contain only file counts, line insertions/deletions, language ratios, token counts, and cryptographic hashes (`HMAC-SHA256`).
+2. **Metadata Only:** Public receipts contain only file counts, line insertions/deletions, language ratios, token counts, task titles, and cryptographic hashes (`HMAC-SHA256`).
 3. **Hard 50 KB Request Cap:** The `/api/receipts` endpoint enforces a strict `50 KB` request body ceiling.
 4. **Kill Switch:** Set `QODEWK_TELEMETRY=off` to disable all cloud publishing permanently.
-
----
-
-## 🏛️ Monorepo Structure
-
-```text
-Qodewk/
-├── apps/
-│   └── web/                   # Next.js 15 (App Router, Claude Warm Editorial, Satori OG)
-├── packages/
-│   ├── protocol/              # Canonical Zod schemas & TypeScript contracts (Receipt v1.0)
-│   ├── pricing/               # Versioned frontier rate card registry (Claude, OpenAI, Gemini, DeepSeek)
-│   ├── core/                  # Git engine (simple-git), dual-engine estimator, zero-native node:sqlite
-│   ├── cli/                   # Self-contained bundled executable (`qodewk`, `npx qodewk`)
-│   └── action/                # GitHub Action for automated sticky PR comment receipts
-├── docs/                      # Architectural whitepaper, design specs, and deployment guides
-├── .github/workflows/         # CI/CD & PR telemetry workflow
-├── README.md
-└── AGENTS.md                  # Strict contributor invariants & coding rules
-```
-
----
-
-## 📖 Documentation Map
-
-### Architecture & Specs
-- [`docs/blueprint.md`](file:///c:/Users/ASUS/Desktop/Qodewk/docs/blueprint.md) — Master Architecture Blueprint (158KB Deep-Tech Whitepaper)
-- [`docs/design-system.md`](file:///c:/Users/ASUS/Desktop/Qodewk/docs/design-system.md) — Claude-inspired Warm Editorial Design System & Thermal Receipt Tokens
-- [`docs/deployment.md`](file:///c:/Users/ASUS/Desktop/Qodewk/docs/deployment.md) — Production Deployment (Vercel, Docker, Cloud Run) & NPM Publishing Guide
-- [`AGENTS.md`](file:///c:/Users/ASUS/Desktop/Qodewk/AGENTS.md) — Strict Invariant Engineering Rules & Aesthetic Mandates
-
-### Modular Deep Dives
-- [`docs/00-product-thesis.md`](file:///c:/Users/ASUS/Desktop/Qodewk/docs/00-product-thesis.md) — Product definition & market positioning
-- [`docs/01-architecture.md`](file:///c:/Users/ASUS/Desktop/Qodewk/docs/01-architecture.md) — System boundaries & capture pipelines
-- [`docs/02-receipt-protocol.md`](file:///c:/Users/ASUS/Desktop/Qodewk/docs/02-receipt-protocol.md) — Receipt v1.0 schema specification
-- [`docs/03-token-cost-estimation.md`](file:///c:/Users/ASUS/Desktop/Qodewk/docs/03-token-cost-estimation.md) — Dual-engine estimation & confidence scoring
-- [`docs/04-privacy-security.md`](file:///c:/Users/ASUS/Desktop/Qodewk/docs/04-privacy-security.md) — Threat model & 50 KB security boundaries
-- [`docs/06-plg-growth.md`](file:///c:/Users/ASUS/Desktop/Qodewk/docs/06-plg-growth.md) — Viral receipt loops & PR sticky comment integration
-- [`docs/10-mvp-48h.md`](file:///c:/Users/ASUS/Desktop/Qodewk/docs/10-mvp-48h.md) — 48-Hour MVP scope and verification criteria
-
----
-
-## 🚀 Running Locally
-
-```bash
-# Install dependencies
-pnpm install
-
-# Build all packages with Turborepo
-pnpm build
-
-# Start web app in development
-pnpm --filter web dev
-# App is available at http://localhost:3000
-
-# Run CLI standalone bundle directly
-node packages/cli/dist/index.cjs
-```
+5. **Local SQLite Footprint Storage:** Telemetry remains strictly stored in local SQLite (`~/.qodewk/state.db`).
 
 ---
 

package/dist/index.cjs

@@ -13269,6 +13269,32 @@ var path = __toESM(require("path"), 1);
 function computeSaltedHash(value, salt = "qodewk-default-salt") {
   return crypto.createHmac("sha256", salt).update(value).digest("hex");
 }
+function parseSinceOption(since) {
+  if (!since)
+    return void 0;
+  if (since instanceof Date)
+    return since;
+  const s = since.trim().toLowerCase();
+  const now = /* @__PURE__ */ new Date();
+  if (s === "today") {
+    return new Date(now.getFullYear(), now.getMonth(), now.getDate());
+  }
+  const hoursMatch = s.match(/^(\d+)\s*h(?:ours?)?$/);
+  if (hoursMatch && hoursMatch[1]) {
+    const hours = parseInt(hoursMatch[1], 10);
+    return new Date(now.getTime() - hours * 60 * 60 * 1e3);
+  }
+  const daysMatch = s.match(/^(\d+)\s*d(?:ays?)?$/);
+  if (daysMatch && daysMatch[1]) {
+    const days = parseInt(daysMatch[1], 10);
+    return new Date(now.getTime() - days * 24 * 60 * 60 * 1e3);
+  }
+  const parsed = new Date(since);
+  if (!isNaN(parsed.getTime())) {
+    return parsed;
+  }
+  return void 0;
+}
 async function extractGitMetrics(optionsOrPath = process.cwd()) {
   const options = typeof optionsOrPath === "string" ? { repoPath: optionsOrPath } : optionsOrPath;
   const repoPath = options.repoPath || process.cwd();
@@ -13282,18 +13308,43 @@ async function extractGitMetrics(optionsOrPath = process.cwd()) {
   let headSha = options.headSha || "0000000000000000000000000000000000000000";
   let baseSha = options.baseSha;
   let commitMessage = void 0;
-  try {
-    const log = await git.log({ maxCount: 2 });
-    if (log.latest) {
-      if (!options.headSha) {
-        headSha = log.latest.hash;
+  let commitsCount = 1;
+  const sinceDate = parseSinceOption(options.since);
+  if (sinceDate && !options.baseSha) {
+    try {
+      const sinceIso = sinceDate.toISOString();
+      const commitsRaw = await git.raw(["log", `--since=${sinceIso}`, "--format=%H"]);
+      const commitShas = commitsRaw.split("\n").map((s) => s.trim()).filter(Boolean);
+      if (commitShas.length > 0) {
+        commitsCount = commitShas.length;
+        if (!options.headSha) {
+          headSha = commitShas[0];
+        }
+        const oldestSha = commitShas[commitShas.length - 1];
+        try {
+          const parentSha = (await git.raw(["rev-parse", `${oldestSha}^`])).trim();
+          baseSha = parentSha;
+        } catch {
+          baseSha = oldestSha;
+        }
       }
-      commitMessage = log.latest.message;
-      if (!options.baseSha && log.all.length > 1 && log.all[1]) {
-        baseSha = log.all[1].hash;
+    } catch {
+    }
+  }
+  if (!baseSha) {
+    try {
+      const log = await git.log({ maxCount: 2 });
+      if (log.latest) {
+        if (!options.headSha) {
+          headSha = log.latest.hash;
+        }
+        commitMessage = log.latest.message;
+        if (!options.baseSha && log.all.length > 1 && log.all[1]) {
+          baseSha = log.all[1].hash;
+        }
       }
+    } catch {
     }
-  } catch {
   }
   let repoIdentifier = path.basename(path.resolve(repoPath));
   try {
@@ -13308,13 +13359,18 @@ async function extractGitMetrics(optionsOrPath = process.cwd()) {
   const repoHash = computeSaltedHash(repoIdentifier);
   let diffSummary;
   if (baseSha && headSha && baseSha !== headSha) {
-    diffSummary = await git.diffSummary([`${baseSha}...${headSha}`]);
+    const status = await git.status();
+    if (status.files.length > 0) {
+      diffSummary = await git.diffSummary([baseSha]);
+    } else {
+      diffSummary = await git.diffSummary([`${baseSha}..${headSha}`]);
+    }
   } else {
     const status = await git.status();
     if (status.files.length > 0) {
       diffSummary = await git.diffSummary(["HEAD"]);
     } else if (baseSha) {
-      diffSummary = await git.diffSummary([`${baseSha}...${headSha}`]);
+      diffSummary = await git.diffSummary([`${baseSha}..${headSha}`]);
     } else if (headSha !== "0000000000000000000000000000000000000000") {
       diffSummary = await git.diffSummary([headSha]);
     } else {
@@ -13359,7 +13415,8 @@ async function extractGitMetrics(optionsOrPath = process.cwd()) {
     baseSha,
     repoHash,
     projectAlias,
-    commitMessage
+    commitMessage,
+    commitsCount
   };
 }
 function mapExtensionToLanguage(ext) {
@@ -14120,7 +14177,7 @@ var LocalStateDB = class {
 };
 
 // ../core/dist/harvester/index.js
-function parseSinceOption(since) {
+function parseSinceOption2(since) {
   if (!since)
     return void 0;
   if (since instanceof Date)
@@ -14148,7 +14205,7 @@ function parseSinceOption(since) {
   return void 0;
 }
 async function harvestUniversalFootprints(options) {
-  const sinceDate = parseSinceOption(options.since);
+  const sinceDate = parseSinceOption2(options.since);
   const alias = options.projectAlias || "";
   let allFootprints = [];
   if (!options.platform || options.platform === "all" || options.platform === "antigravity") {
@@ -14318,7 +14375,8 @@ async function generateReceipt(options = {}) {
   const metrics = await extractGitMetrics({
     repoPath: options.repoPath || process.cwd(),
     baseSha: options.baseSha,
-    headSha: options.headSha
+    headSha: options.headSha,
+    since: options.since
   });
   const repoPath = options.repoPath || process.cwd();
   const harvestResult = await harvestUniversalFootprints({
@@ -14380,7 +14438,7 @@ async function generateReceipt(options = {}) {
       branch: options.anonymizeBranch ? "anonymized-branch" : metrics.branch,
       headSha: metrics.headSha,
       baseSha: metrics.baseSha,
-      commitsCount: 1
+      commitsCount: metrics.commitsCount || 1
     },
     mutation: {
       files: metrics.files,
@@ -14569,7 +14627,8 @@ function renderTerminalReceipt(receipt, publicUrl) {
     printRow(`TASK: ${taskClean}`);
   }
   printDivider("=");
-  printRowSplit("ITEMS CHANGED", "QTY");
+  const itemsHeader = receipt.repository.commitsCount && receipt.repository.commitsCount > 1 ? `ITEMS CHANGED (${receipt.repository.commitsCount} COMMITS)` : "ITEMS CHANGED";
+  printRowSplit(itemsHeader, "QTY");
   printDivider("-");
   printRowSplit("Files Touched", String(receipt.mutation.files));
   printRowSplit("Lines Inserted", green("+ " + receipt.mutation.insertions));

package/package.json

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