qodewk 0.3.0 โ 0.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +67 -12
- package/dist/index.cjs +1216 -544
- package/package.json +3 -4
package/README.md
CHANGED
|
@@ -15,6 +15,11 @@
|
|
|
15
15
|
Run directly from any Git repository without installing any packages globally:
|
|
16
16
|
|
|
17
17
|
```bash
|
|
18
|
+
# Launch interactive terminal control panel (TUI menu)
|
|
19
|
+
npx qodewk menu
|
|
20
|
+
# or shortcut:
|
|
21
|
+
npx qodewk -i
|
|
22
|
+
|
|
18
23
|
# Generate monospace thermal receipt for latest commit / working tree
|
|
19
24
|
npx qodewk
|
|
20
25
|
|
|
@@ -34,10 +39,53 @@ npx qodewk --json
|
|
|
34
39
|
# Publish privacy-safe receipt to web and get shareable URL
|
|
35
40
|
npx qodewk share
|
|
36
41
|
|
|
37
|
-
# Audit a PR branch diff range against base
|
|
38
|
-
npx qodewk audit --base
|
|
42
|
+
# Audit a PR branch diff range against base (supports branch names, short SHAs, and HEAD)
|
|
43
|
+
npx qodewk audit --base master --head 7076f0a --format markdown --out receipt.md
|
|
39
44
|
```
|
|
40
45
|
|
|
46
|
+
---
|
|
47
|
+
|
|
48
|
+
## ๐๏ธ Interactive Terminal Control Panel
|
|
49
|
+
|
|
50
|
+
Run `npx qodewk menu` (or `qodewk -i`) to open the keyboard-navigable interactive terminal control panel:
|
|
51
|
+
|
|
52
|
+
```text
|
|
53
|
+
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
|
|
54
|
+
โ Q O D E W K โ
|
|
55
|
+
โ Telemetry Control Panel โ
|
|
56
|
+
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
|
|
57
|
+
โ Use โ / โ to navigate ยท Enter to select ยท q to quit โ
|
|
58
|
+
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
|
|
59
|
+
โ โ
|
|
60
|
+
โ โบ [1] Generate Local Receipt โ
|
|
61
|
+
โ Inspect git diff and print digital receipt โ
|
|
62
|
+
โ โ
|
|
63
|
+
โ [2] Audit Branch or Revision Range โ
|
|
64
|
+
โ Compare against base commit or upstream branch โ
|
|
65
|
+
โ โ
|
|
66
|
+
โ [3] Publish Receipt to Cloud โ
|
|
67
|
+
โ Privacy-safe shareable URL & claim token โ
|
|
68
|
+
โ โ
|
|
69
|
+
โ [4] Configure Git Hooks โ
|
|
70
|
+
โ Non-blocking background telemetry recording โ
|
|
71
|
+
โ โ
|
|
72
|
+
โ [5] Database & Storage Status โ
|
|
73
|
+
โ Inspect local SQLite (~/.qodewk/state.db) records โ
|
|
74
|
+
โ โ
|
|
75
|
+
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
|
|
76
|
+
โ [0] Exit โ
|
|
77
|
+
โ Return to shell โ
|
|
78
|
+
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
|
|
79
|
+
โ [โ] Source code was never uploaded to Qodewk โ
|
|
80
|
+
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
### Purposeful Visual Hierarchy
|
|
84
|
+
- **Control Panel:** Clean, modern developer CLI box (`โโโ`, `โ`, `โโโค`, `โโโ`) following the Claude Warm Editorial design tokens (`#cc785c` coral accents, `#e8a55a` amber highlights, `#8e8b82` muted hairlines) with **zero cheap emojis**.
|
|
85
|
+
- **Tactile Thermal Artifact:** The signature serrated zig-zag edges (`/\/\/\...` and `\/\/\/\...`) and inline Code 128 thermal barcode are preserved **exclusively** for the generated Proof of Shipment digital receipt!
|
|
86
|
+
|
|
87
|
+
---
|
|
88
|
+
|
|
41
89
|
### Verified Thermal ASCII Receipt Preview
|
|
42
90
|
```text
|
|
43
91
|
/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
|
|
@@ -65,8 +113,9 @@ npx qodewk audit --base origin/main --head HEAD --format markdown --out receipt.
|
|
|
65
113
|
| CONFIDENCE: 95% [Mode: verified] |
|
|
66
114
|
| ==================================================== |
|
|
67
115
|
| |
|
|
68
|
-
|
|
|
69
|
-
|
|
|
116
|
+
| โ โ โโ โ โโ โ โ โโ โโโโ โโ โ โ โโโ โโ |
|
|
117
|
+
| โ โ โโ โ โโ โ โ โโ โโโโ โโ โ โ โโโ โโ |
|
|
118
|
+
| [ LOCAL RECORD โ NOT PUBLISHED ] |
|
|
70
119
|
| |
|
|
71
120
|
| [โ] Source code was never uploaded to Qodewk |
|
|
72
121
|
\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/
|
|
@@ -74,7 +123,7 @@ npx qodewk audit --base origin/main --head HEAD --format markdown --out receipt.
|
|
|
74
123
|
|
|
75
124
|
---
|
|
76
125
|
|
|
77
|
-
## ๐
|
|
126
|
+
## ๐ Universal Multi-Platform Footprint Harvester
|
|
78
127
|
|
|
79
128
|
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.
|
|
80
129
|
|
|
@@ -88,16 +137,20 @@ Unlike single-vendor utilities (like Chit, which only support Claude Code CLI),
|
|
|
88
137
|
|
|
89
138
|
### Key Capabilities
|
|
90
139
|
|
|
91
|
-
1. **
|
|
140
|
+
1. **Interactive Control Panel (`qodewk menu`):**
|
|
141
|
+
Full TUI control with keyboard navigation (`โ`/`โ`, `1`โ`5`, `0`, `Enter`, `q`), status inspection, and action routing.
|
|
142
|
+
2. **Smart Git Ref & Short SHA Resolution:**
|
|
143
|
+
Audits accept arbitrary branch names (`master`, `main`), short commit SHAs (`7076f0a`), or relative refs (`HEAD`, `HEAD~1`), automatically resolving them into canonical 40-character SHAs.
|
|
144
|
+
3. **Date-wise & Duration Filtering:**
|
|
92
145
|
Analyze agent output over arbitrary time windows (`--today`, `--since 24h`, `--since 7d`, `--since "2026-09-28"`).
|
|
93
|
-
|
|
146
|
+
4. **AI vs. Human Code Attribution:**
|
|
94
147
|
Cross-references Git diff hunks against agent tool calls to calculate exact contribution percentages (e.g. `AI Written Code: 88% (Human: 12%)`).
|
|
95
|
-
|
|
148
|
+
5. **Shipped Task Recognition:**
|
|
96
149
|
Extracts high-level task summaries and user prompts directly from session databases, so your receipt doubles as an instant standup or PR summary.
|
|
97
|
-
|
|
150
|
+
6. **Never Fake Precision (Dual-Engine Provenance):**
|
|
98
151
|
- **`verified` (95% Confidence):** Harvested directly from local agent transcripts & SQLite databases.
|
|
99
152
|
- **`estimated` (45โ65% Confidence):** Contextual Git diff & AST complexity fallback when operating in closed/uninstrumented environments.
|
|
100
|
-
|
|
153
|
+
7. **Modern Frontier Rate Cards:**
|
|
101
154
|
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`.
|
|
102
155
|
|
|
103
156
|
---
|
|
@@ -106,6 +159,8 @@ Unlike single-vendor utilities (like Chit, which only support Claude Code CLI),
|
|
|
106
159
|
|
|
107
160
|
| Command / Option | Description | Output / Example |
|
|
108
161
|
|---|---|---|
|
|
162
|
+
| `npx qodewk menu` | Open interactive terminal control panel (TUI menu) | Interactive terminal box |
|
|
163
|
+
| `npx qodewk -i` / `--menu` | Flag shortcut to launch interactive menu | Interactive terminal box |
|
|
109
164
|
| `npx qodewk` | Harvest local agent footprints and inspect Git commit | Monospace thermal receipt |
|
|
110
165
|
| `npx qodewk --today` | Generate receipt for all agent sessions and code written today | Daily shipment receipt |
|
|
111
166
|
| `npx qodewk --since <duration>` | Filter agent work by duration (e.g. `24h`, `7d`, `2026-09-28`) | Time-bounded telemetry receipt |
|
|
@@ -114,8 +169,8 @@ Unlike single-vendor utilities (like Chit, which only support Claude Code CLI),
|
|
|
114
169
|
| `npx qodewk share` | Publish privacy-safe metadata to Qodewk Cloud and generate short link | `https://qodewk.dev/r/rec_...` |
|
|
115
170
|
| `npx qodewk share --today` | Share today's harvested footprint window | Public URL + claim token |
|
|
116
171
|
| `npx qodewk audit --base <branch>` | Calculate aggregate diff and telemetry across an entire PR branch range | Git revision delta receipt |
|
|
117
|
-
| `npx qodewk hook install` / `hooks install` | Install non-blocking `post-commit` + `post-rewrite` hooks | Local auto-record |
|
|
118
|
-
| `npx qodewk
|
|
172
|
+
| `npx qodewk hook install` / `hooks install` | Install non-blocking `post-commit` + `post-rewrite` hooks (< 5ms background recorder) | Local auto-record |
|
|
173
|
+
| `npx qodewk hook uninstall` | Remove Qodewk Git hooks non-destructively | Clean uninstallation |
|
|
119
174
|
| `npx qodewk -f markdown -o receipt.md` | Export sticky Markdown receipt directly formatted for GitHub PR comments | File `receipt.md` |
|
|
120
175
|
| `npx qodewk -p <provider> -m <model>` | Override detected provider & frontier model pricing rate card | Custom model cost estimate |
|
|
121
176
|
| `npx qodewk --anon` | Redact sensitive repository and branch identifiers | Privacy-hardened receipt |
|