cngkit 1.1.3 → 1.1.4

package/README.md

@@ -14,6 +14,9 @@ the Cloudflare-backed Harness knowledges catalog:
 - `cngkit coderoom join <room-code>` joins another developer's shared code room.
 - `cngkit scrub [path]` scans a file or directory with TruffleHog and prints a redacted report.
 - `cngkit scrub [path] --yes` rewrites detected secret values inline with `[CNGKIT_SECRET:<detector>:<verified|unverified>]` placeholders.
+- `cngkit transcripts list [--source all|codex|claude] [--limit n]` lists recent local Claude/Codex transcript files.
+- `cngkit transcripts read <path-or-session-id> [--limit n]` prints normalized user/assistant transcript entries.
+- `cngkit transcripts grep <query> [--limit n] [--file-limit n]` searches recent local transcript entries.
 - `cngkit knowledges status` prints the remote catalog state.
 - `cngkit knowledges audiences` lists available audience filters.
 - `cngkit knowledges search <query> [--limit n]` runs semantic search against Cloudflare Vectorize (default limit 5).
@@ -30,6 +33,7 @@ Help is baked into the CLI as Markdown with progressive disclosure:
 ```bash
 cngkit --help
 cngkit scrub --help
+cngkit transcripts --help
 cngkit knowledges --help
 cngkit knowledges read --help
 cngkit knowledges grep --help
@@ -46,6 +50,11 @@ The canonical CLI spec lives at `docs/superpowers/specs/2026-06-25-cngkit-cli-sp
 in the repository. The baked help source lives in `src/help-specs.ts`; keep both
 aligned when changing command behavior.
 
+Command routing is implemented with Pastel route files under `src/commands/`, rendered
+through Ink. `tsup` emits a file-preserving ESM build so the published package contains
+`dist/cli.js` plus `dist/commands/**`; the private workspace client stays bundled while
+public runtime packages remain normal package dependencies.
+
 `scrub` requires the `trufflehog` binary on `PATH`. On macOS, install it with:
 
 ```bash
@@ -54,6 +63,21 @@ brew install trufflehog
 
 Inline masking is intentionally gated behind `--yes` because it rewrites files in place.
 
+## Local Agent Transcripts
+
+The `transcripts` command reads local JSONL logs from `~/.codex/sessions`,
+`~/.codex/archived_sessions`, `~/.claude/projects`, and `~/.claude/history.jsonl`.
+It is local-only operator tooling: transcript contents are not uploaded to the Curly backend.
+
+```bash
+cngkit transcripts list --limit 12
+cngkit transcripts read <path-or-session-id> --source codex --limit 80
+cngkit transcripts grep "deploy failed" --source all --file-limit 60 --limit 20
+```
+
+By default, `read` and `grep` print only user/assistant text and skip internal prompt,
+hook, and tool noise. Use `--include-internal` when debugging transcript plumbing.
+
 ## Coderoom
 
 Coderoom is for quickly uniting developers around one working tree. One developer starts