whodecided 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kai Zhu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,84 @@
+# whodecided
+
+> *because you rubber-stamped 5 decisions yesterday and don't know it.*
+
+Your AI coding agent makes dozens of silent decisions per session - it stored the token in localStorage, skipped an edge case, defaulted page size to 20. You never saw the choice, and the diff won't show it. And half the time *you* "decided" by hitting `y` in 1.2 seconds.
+
+**whodecided** distills those decisions out of your Claude Code / Codex sessions into a one-screen ledger you rule on like a judge. Approve or reject each; the ones you approve become precedent your agents follow next time instead of guessing.
+
+It's a thin CLI + a `.wdd/` folder of plain text in your repo. No server, no database, no API keys - the distiller shells out to your already-authenticated `claude` / `codex` CLI.
+
+## Quick start
+
+```bash
+cd your-project
+npx whodecided review --distill-only   # read-only, zero config: run over your EXISTING sessions
+```
+
+That's the demo: it reads `~/.claude/projects/*.jsonl` and lists the decisions you didn't know you made. If a line makes your spine tingle, install it for real:
+
+```bash
+npm i -g whodecided       # gives you `wdd`
+wdd hook install          # trace test runs, pick a memory file for rules
+wdd review                # distill + open the workbench; Approve/Reject saves to the ledger
+```
+
+## The loop
+
+```
+ A decision happens (agent session / your keypress)
+      │  hooks auto-trace · transcript kept
+      ▼
+ distill   claude -p / codex exec → ledger  (≤10 per branch, the "why" recovered from the transcript)
+      ▼
+ review    one screen, three columns:
+             ⚠ AI decided, never asked
+             ⚠ you didn't read (the 1.2s y)
+             ✓ you decided
+           Approve / Reject each · pin the core ones as rules
+      ▼
+ recall    ratified rules → injected into the next task (CLAUDE.md / AGENTS.md + /recall)
+      └──→ the same decision never gets guessed twice
+```
+
+The audit unit is the **branch** - `wdd review` covers the decisions inside the current PR.
+
+## Commands
+
+| Command | What it does |
+|---|---|
+| `wdd review` | Distill, open the workbench, rule (Approve/Reject saves straight to the ledger). `--term` terminal flow, `--distill-only` read-only demo, `--html` static snapshot |
+| `wdd recall <term>` | Search ruled precedent (only what you've ratified) |
+| `wdd gate` | Merge gate as an exit code (ledger fresh + all silent decisions ruled); for pre-push / CI |
+| `wdd report --md` | Audit report for a PR description |
+| `wdd board [dirs...]` | Read-only multi-repo overview page |
+| `wdd hook install` | Install hooks + `/recall` skill, and choose where rules are written |
+| `wdd share <repo\|local>` | Whether `.wdd/` is tracked by git or kept local |
+| `wdd sync` | Change / refresh the memory-file target for rules |
+
+## How it works
+
+**What counts as a decision:** a reasonable alternative existed, and choosing it would change behavior, security, or maintenance cost. Mechanical actions don't count.
+
+**One ledger entry** (append-only jsonl; your ruling is a separate appended line, entries are never rewritten):
+
+```json
+{"id":"D1","what":"token → localStorage","why":"simplest, no SSR","by":"agent","aware":false,
+ "alternatives":["httpOnly cookie"],"files":["src/auth.ts"],"ref":"tx:a1b2:1042"}
+```
+
+`ref` points back into the transcript, so the ledger never re-narrates the session. Only decisions you *ruled on* become precedent - unreviewed guesses never leak into agent memory.
+
+**Review before merge, not after.** Overturning a decision pre-merge is a cheap fix in the worktree; post-merge it's a new PR or a migration.
+
+## Design constraints
+
+- **No server, no database, no daemon.** The truth is plain text in your repo; `rm -rf` the tool and it all stays readable with cat/jq/grep.
+- **It never commits for you** by default - it writes files and leaves your git history alone (opt in with `commit: on`).
+- **Zero API keys.** The one LLM consumer shells out to your `claude` / `codex` CLI; model follows your CLI's default.
+- **One screen.** Every default output fits a screen; ≤10 decisions per branch.
+- Single runtime dependency (`yaml`); the HTML workbench is a self-contained file (embedded JSON, vanilla JS, no CDN, no build).
+
+## License
+
+MIT

package/dist/checks/gate.d.ts

@@ -0,0 +1,10 @@
+import type { DecisionCandidate } from "../extract/candidates.js";
+import type { DecisionEntry, RatifyEntry } from "../ledger/schema.js";
+import type { Watermark } from "../distill/watermark.js";
+export interface GateStatus {
+    fresh: boolean;
+    staleSessions: string[];
+    pendingSilent: string[];
+    green: boolean;
+}
+export declare function gateStatus(entries: DecisionEntry[], ratifies: RatifyEntry[], candidates: DecisionCandidate[], watermark: Watermark): GateStatus;

package/dist/checks/gate.js

@@ -0,0 +1,19 @@
+import { verdictOf } from "../ledger/io.js";
+export function gateStatus(entries, ratifies, candidates, watermark) {
+    const stale = new Set();
+    for (const c of candidates) {
+        const [, session, line] = c.ref.split(":");
+        if (session && Number(line) > (watermark[session] ?? 0))
+            stale.add(session);
+    }
+    const pendingSilent = entries
+        .filter((e) => !e.aware && verdictOf(ratifies, e.id) === undefined)
+        .map((e) => e.id);
+    return {
+        fresh: stale.size === 0,
+        staleSessions: [...stale],
+        pendingSilent,
+        green: stale.size === 0 && pendingSilent.length === 0,
+    };
+}
+//# sourceMappingURL=gate.js.map

package/dist/checks/gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate.js","sourceRoot":"","sources":["../../src/checks/gate.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAU5C,MAAM,UAAU,UAAU,CACxB,OAAwB,EACxB,QAAuB,EACvB,UAA+B,EAC/B,SAAoB;IAEpB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,aAAa,GAAG,OAAO;SAC1B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,SAAS,CAAC;SAClE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACpB,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC;QACvB,aAAa,EAAE,CAAC,GAAG,KAAK,CAAC;QACzB,aAAa;QACb,KAAK,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;KACtD,CAAC;AACJ,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+const USAGE = `whodecided (wdd) - common law for agentic coding
+
+Usage: wdd <command> [args]
+
+Everyday:
+  review           Distill, open the workbench, rule (Approve/Reject save straight to the ledger).
+                   --term terminal flow · --distill-only zero-config read-only demo · --html static snapshot
+  recall <term>    Search ruled precedent (only decisions you've ratified)
+  gate             Two-green merge gate (exit 0 = all green); for pre-push / CI
+
+Setup (once):
+  hook install     Install CC hooks + /recall skill, and pick the memory file for precedents
+  share <repo|local>  Audit travels with the repo (committed) or stays local
+  sync             Change/refresh the memory-file target (auto-syncs on each ruling otherwise)
+
+Output & collaboration:
+  report [--md]    Audit report for a PR description
+  board [dirs...]  Read-only multi-repo overview page
+  apply [patch]    Land a static-snapshot patch (the live workbench saves directly)
+
+Internal (run by hooks):
+  distill          Headless incremental distill
+  hook trace | autodistill   PostToolUse / Stop receivers
+`;
+const commands = ["review", "apply", "recall", "gate", "report", "board", "share", "sync", "distill", "hook"];
+const [command, ...rest] = process.argv.slice(2);
+if (!command || command === "--help" || command === "-h") {
+    process.stdout.write(USAGE);
+    process.exit(command ? 0 : 1);
+}
+if (!commands.includes(command)) {
+    process.stderr.write(`wdd: unknown command "${command}"\n\n${USAGE}`);
+    process.exit(1);
+}
+if (command === "review") {
+    const { review } = await import("./commands/review.js");
+    process.exit(await review(rest));
+}
+if (command === "apply") {
+    const { apply } = await import("./commands/apply.js");
+    process.exit(apply(rest));
+}
+if (command === "recall") {
+    const { recall } = await import("./commands/recall.js");
+    process.exit(recall(rest));
+}
+if (command === "gate") {
+    const { gate } = await import("./commands/gate.js");
+    process.exit(gate(rest));
+}
+if (command === "report") {
+    const { report } = await import("./commands/report.js");
+    process.exit(report(rest));
+}
+if (command === "board") {
+    const { board } = await import("./commands/board.js");
+    process.exit(board(rest));
+}
+if (command === "share") {
+    const { share } = await import("./commands/share.js");
+    process.exit(share(rest));
+}
+if (command === "sync") {
+    const { sync } = await import("./commands/sync.js");
+    process.exit(await sync(rest));
+}
+if (command === "distill") {
+    const { distillCmd } = await import("./commands/distill.js");
+    process.exit(await distillCmd(rest));
+}
+if (command === "hook") {
+    const { hook } = await import("./commands/hook.js");
+    process.exit(await hook(rest));
+}
+process.stderr.write(`wdd ${command}: not implemented yet (see SPEC.md section 8)\n`);
+process.exit(1);
+export {};
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;;;;;;;CAuBb,CAAC;AAEF,MAAM,QAAQ,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;AAE9G,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEjD,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;IACzD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC5B,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;IAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,OAAO,QAAQ,KAAK,EAAE,CAAC,CAAC;IACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;IACzB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;IACxD,OAAO,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AACnC,CAAC;AACD,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;IACxB,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;IACtD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5B,CAAC;AACD,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;IACzB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;IACxD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7B,CAAC;AACD,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;IACpD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAC3B,CAAC;AACD,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;IACzB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;IACxD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7B,CAAC;AACD,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;IACxB,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;IACtD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5B,CAAC;AACD,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;IACxB,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;IACtD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5B,CAAC;AACD,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;IACpD,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACjC,CAAC;AACD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;IAC1B,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;IAC7D,OAAO,CAAC,IAAI,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;AACvC,CAAC;AACD,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;IACpD,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACjC,CAAC;AAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,OAAO,iDAAiD,CAAC,CAAC;AACtF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC"}

package/dist/commands/apply.d.ts

@@ -0,0 +1 @@
+export declare function apply(args: string[]): number;

package/dist/commands/apply.js

@@ -0,0 +1,68 @@
+import { readdirSync, readFileSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { repoRoot } from "../git.js";
+import { applyOps } from "../patch/apply.js";
+import { parsePatch } from "../patch/schema.js";
+import { IGNORED_MSG } from "./distill.js";
+export function apply(args) {
+    const root = repoRoot(process.cwd());
+    if (!root) {
+        process.stderr.write("wdd apply: not inside a git repo\n");
+        return 1;
+    }
+    // With no path, pick up the patch the workbench just exported (newest in Downloads).
+    const file = args.find((a) => !a.startsWith("--")) ?? findExportedPatch();
+    if (!file) {
+        process.stderr.write("wdd apply: no patch given and none found in Downloads.\n" +
+            "In the workbench, rule on decisions and click Export, then run `wdd apply` again.\n");
+        return 1;
+    }
+    let text;
+    try {
+        text = readFileSync(file, "utf8");
+    }
+    catch {
+        process.stderr.write(`cannot read ${file}\n`);
+        return 1;
+    }
+    if (!args.some((a) => !a.startsWith("--")))
+        process.stdout.write(`applying ${file}\n`);
+    const { values, errors } = parsePatch(text);
+    if (errors.length > 0) {
+        for (const e of errors)
+            process.stderr.write(`patch line ${e.line}: ${e.message}\n`);
+        process.stderr.write("patch rejected, nothing written\n");
+        return 1;
+    }
+    const result = applyOps(root, values);
+    if (typeof result === "string") {
+        process.stderr.write(`patch rejected, nothing written: ${result}\n`);
+        return 1;
+    }
+    process.stdout.write(`saved ${result.applied} ruling(s)${result.skipped ? `, ${result.skipped} unchanged` : ""}${result.commit ? ` → commit ${result.commit}` : ""}\n`);
+    if (result.uncommitted)
+        process.stderr.write(IGNORED_MSG + "\n");
+    if (result.overturned > 0)
+        process.stdout.write(`↳ ${result.overturned} rejected - AI won't repeat these; the code fix is separate work\n`);
+    return 0;
+}
+/** The workbench downloads review.patch.jsonl; grab the newest one from Downloads. */
+function findExportedPatch() {
+    const dir = join(homedir(), "Downloads");
+    let names;
+    try {
+        names = readdirSync(dir);
+    }
+    catch {
+        return undefined;
+    }
+    const cutoff = Date.now() - 60 * 60 * 1000; // only very recent exports, avoid stale
+    return names
+        .filter((n) => n.endsWith(".patch.jsonl"))
+        .map((n) => ({ path: join(dir, n), mtime: statSync(join(dir, n)).mtimeMs }))
+        .filter((f) => f.mtime >= cutoff)
+        .sort((a, b) => b.mtime - a.mtime)
+        .map((f) => f.path)[0];
+}
+//# sourceMappingURL=apply.js.map

package/dist/commands/apply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.js","sourceRoot":"","sources":["../../src/commands/apply.ts"],"names":[],"mappings":"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"}

package/dist/commands/board.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Read-only multi-repo overview: one static page aggregating every repo's
+ * ledger, traces, and gate status. No distilling, no LLM calls; rulings
+ * happen inside each repo via `wdd review`.
+ */
+export declare function board(args: string[]): number;

package/dist/commands/board.js

@@ -0,0 +1,57 @@
+import { existsSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
+import { basename, join, resolve } from "node:path";
+import { gateStatus } from "../checks/gate.js";
+import { loadWatermark, watermarkPath } from "../distill/watermark.js";
+import { ledgerPath, readLedger, verdictOf } from "../ledger/io.js";
+import { renderWorkbench } from "../render/html.js";
+import { parseTrace } from "../trace/schema.js";
+import { resolveScope } from "./scope.js";
+/**
+ * Read-only multi-repo overview: one static page aggregating every repo's
+ * ledger, traces, and gate status. No distilling, no LLM calls; rulings
+ * happen inside each repo via `wdd review`.
+ */
+export function board(args) {
+    const explicit = args.filter((a) => !a.startsWith("--") && args[args.indexOf(a) - 1] !== "--out");
+    const outIdx = args.indexOf("--out");
+    const out = outIdx >= 0 ? (args[outIdx + 1] ?? "wdd-board.html") : "wdd-board.html";
+    const roots = (explicit.length > 0 ? explicit.map((p) => resolve(p)) : discover(process.cwd())).filter((p) => existsSync(ledgerPath(p)));
+    if (roots.length === 0) {
+        process.stderr.write("no repos with a .wdd/ledger.jsonl found (pass paths explicitly or run in their parent dir)\n");
+        return 1;
+    }
+    const repos = roots.map((root) => {
+        const scope = resolveScope([], root);
+        const { entries, ratifies } = readLedger(ledgerPath(root));
+        const scoped = scope.branch ? entries.filter((e) => !e.branch || e.branch === scope.branch) : entries;
+        const tracePath = join(root, ".wdd", "trace.jsonl");
+        const slices = {};
+        for (const c of scope.candidates)
+            slices[c.ref] = c.slice.slice(0, 4000);
+        return {
+            repo: basename(root),
+            root,
+            branch: scope.branch,
+            entries: scoped.map((e) => ({ ...e, verdict: verdictOf(ratifies, e.id) })),
+            traces: existsSync(tracePath) ? parseTrace(readFileSync(tracePath, "utf8")).values : [],
+            slices,
+            gate: gateStatus(scoped, ratifies, scope.candidates, loadWatermark(watermarkPath(root))),
+        };
+    });
+    const pending = repos.reduce((s, r) => s + r.entries.filter((e) => !e.verdict).length, 0);
+    writeFileSync(out, renderWorkbench({ title: `board · ${repos.length} repos`, interactive: false, repos }));
+    process.stdout.write(`board written: ${out} (${repos.length} repos, ${pending} pending rulings)\n`);
+    return 0;
+}
+/** Default discovery: immediate subdirectories of cwd that carry a ledger. */
+function discover(cwd) {
+    try {
+        return readdirSync(cwd, { withFileTypes: true })
+            .filter((d) => d.isDirectory() && !d.name.startsWith("."))
+            .map((d) => join(cwd, d.name));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=board.js.map

package/dist/commands/board.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"board.js","sourceRoot":"","sources":["../../src/commands/board.ts"],"names":[],"mappings":"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"}

package/dist/commands/distill.d.ts

@@ -0,0 +1,18 @@
+import { type Scope } from "./scope.js";
+export interface DistillRunResult {
+    added: number;
+    degraded?: string;
+    uncommitted?: boolean;
+}
+/**
+ * Incremental distill: everything past the watermark, deduped by ref,
+ * appended and committed. Shared by `wdd review` and headless `wdd distill`
+ * (which the Stop hook spawns for near-real-time logging).
+ */
+export declare function runIncrementalDistill(scope: Scope, root: string, progress?: boolean): Promise<DistillRunResult>;
+/** Shown when .wdd is gitignored: data is safe on disk, just not versioned. */
+export declare const IGNORED_MSG: string;
+/** `wdd distill`: headless incremental distill, safe to run from hooks. */
+export declare function distillCmd(args: string[]): Promise<number>;
+/** Minimal stderr spinner while a blocking step runs; returns a stop function. */
+export declare function spinner(label: string): () => void;

package/dist/commands/distill.js

@@ -0,0 +1,116 @@
+import { relative } from "node:path";
+import { distill } from "../distill/distiller.js";
+import { loadWatermark, saveWatermark, watermarkPath } from "../distill/watermark.js";
+import { commitFiles } from "../git.js";
+import { appendLedgerLines, ledgerPath, nextDecisionNumber, readLedger } from "../ledger/io.js";
+import { resolveScope } from "./scope.js";
+/**
+ * Incremental distill: everything past the watermark, deduped by ref,
+ * appended and committed. Shared by `wdd review` and headless `wdd distill`
+ * (which the Stop hook spawns for near-real-time logging).
+ */
+export async function runIncrementalDistill(scope, root, progress = false) {
+    const wmFile = watermarkPath(root);
+    const watermark = loadWatermark(wmFile);
+    const fresh = scope.candidates.filter((c) => lineOf(c.ref) > (watermark[sessionOf(c.ref)] ?? 0));
+    if (fresh.length === 0) {
+        if (progress)
+            process.stderr.write("no new decisions since last review\n");
+        return { added: 0 };
+    }
+    const stop = progress
+        ? spinner(`distilling ${fresh.length} new candidate(s) with ${scope.config.distill.cmd.join(" ")} — can take ~10-60s`)
+        : () => { };
+    const { entries, degraded } = await distill(fresh, scope.config.distill);
+    stop();
+    if (degraded)
+        return { added: 0, degraded };
+    let added = 0;
+    if (entries.length > 0) {
+        const file = ledgerPath(root);
+        const existing = readLedger(file).entries;
+        const existingRefs = new Set(existing.map((e) => e.ref));
+        const novel = entries.filter((e) => !existingRefs.has(e.ref));
+        let n = nextDecisionNumber(existing);
+        const byRef = new Map(scope.candidates.map((c) => [c.ref, c]));
+        const numbered = novel.map((e) => {
+            const c = byRef.get(e.ref);
+            return {
+                ...e,
+                id: `D${n++}`,
+                ...(scope.branch ? { branch: scope.branch } : {}),
+                ...(c?.t ? { t: c.t } : {}),
+                ...(c?.cwd ? { cwd: c.cwd } : {}),
+                // The model is the decider only for agent decisions; for a user
+                // decision the human decided, so recording a model would mislead.
+                ...(c?.model && e.by === "agent" ? { model: c.model } : {}),
+                ...(c?.latencyMs !== undefined && e.by === "user" ? { latencyMs: c.latencyMs } : {}),
+                ...(c?.files && c.files.length ? { files: c.files } : {}),
+            };
+        });
+        appendLedgerLines(file, numbered);
+        added = numbered.length;
+        // Auto-commit only when the user opted in; otherwise leave it in the tree.
+        if (scope.config.share === "repo" && scope.config.commit === "on") {
+            const commit = commitFiles(root, [relative(root, file)], `wdd distill: +${numbered.length} decisions`);
+            if (commit.ignored) {
+                advanceWatermark(watermark, scope.candidates);
+                saveWatermark(wmFile, watermark);
+                return { added, uncommitted: true };
+            }
+        }
+    }
+    advanceWatermark(watermark, scope.candidates);
+    saveWatermark(wmFile, watermark);
+    return { added };
+}
+/** Shown when .wdd is gitignored: data is safe on disk, just not versioned. */
+export const IGNORED_MSG = "⚠ .wdd is gitignored, so the audit trail is written to disk but NOT committed.\n" +
+    "  The audit is meant to travel with your code - remove `.wdd` from .gitignore to version it.\n" +
+    "  (Or keep it local-only; your ledger stays readable at .wdd/ledger.jsonl either way.)";
+/** `wdd distill`: headless incremental distill, safe to run from hooks. */
+export async function distillCmd(args) {
+    const quiet = args.includes("--quiet");
+    const scope = resolveScope(args, process.cwd());
+    if (!scope.root) {
+        if (!quiet)
+            process.stderr.write("wdd distill: not inside a git repo\n");
+        return quiet ? 0 : 1;
+    }
+    const result = await runIncrementalDistill(scope, scope.root);
+    if (!quiet) {
+        if (result.degraded)
+            process.stderr.write(`distiller degraded: ${result.degraded}\n`);
+        if (result.uncommitted)
+            process.stderr.write(IGNORED_MSG + "\n");
+        process.stdout.write(`+${result.added} decisions\n`);
+    }
+    return 0;
+}
+/** Minimal stderr spinner while a blocking step runs; returns a stop function. */
+export function spinner(label) {
+    if (!process.stderr.isTTY) {
+        process.stderr.write(label + "\n");
+        return () => { };
+    }
+    const frames = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+    let i = 0;
+    const timer = setInterval(() => process.stderr.write(`\r${frames[i++ % frames.length]} ${label}`), 90);
+    return () => {
+        clearInterval(timer);
+        process.stderr.write("\r\x1b[K"); // clear the spinner line
+    };
+}
+function sessionOf(ref) {
+    return ref.split(":")[1] ?? "";
+}
+function lineOf(ref) {
+    return Number(ref.split(":")[2] ?? 0);
+}
+function advanceWatermark(watermark, candidates) {
+    for (const c of candidates) {
+        const s = sessionOf(c.ref);
+        watermark[s] = Math.max(watermark[s] ?? 0, lineOf(c.ref));
+    }
+}
+//# sourceMappingURL=distill.js.map

package/dist/commands/distill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"distill.js","sourceRoot":"","sources":["../../src/commands/distill.ts"],"names":[],"mappings":"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"}

package/dist/commands/gate.d.ts

@@ -0,0 +1,2 @@
+/** Deterministic, read-only, no LLM: safe and free to run in CI. */
+export declare function gate(args: string[]): number;

package/dist/commands/gate.js

@@ -0,0 +1,27 @@
+import { loadWatermark, watermarkPath } from "../distill/watermark.js";
+import { gateStatus } from "../checks/gate.js";
+import { ledgerPath, readLedger } from "../ledger/io.js";
+import { resolveScope } from "./scope.js";
+/** Deterministic, read-only, no LLM: safe and free to run in CI. */
+export function gate(args) {
+    const scope = resolveScope(args, process.cwd());
+    if (!scope.root) {
+        process.stderr.write("wdd gate: not inside a git repo\n");
+        return 1;
+    }
+    const { entries, ratifies } = readLedger(ledgerPath(scope.root));
+    const scoped = scope.branch ? entries.filter((e) => !e.branch || e.branch === scope.branch) : entries;
+    const status = gateStatus(scoped, ratifies, scope.candidates, loadWatermark(watermarkPath(scope.root)));
+    if (status.green) {
+        process.stdout.write("gate: green (ledger fresh, all silent decisions ruled)\n");
+        return 0;
+    }
+    if (!status.fresh) {
+        process.stdout.write(`✗ ledger stale: undistilled activity in session(s) ${status.staleSessions.join(", ")} → run wdd review\n`);
+    }
+    for (const id of status.pendingSilent) {
+        process.stdout.write(`✗ silent decision pending ruling: ${id}\n`);
+    }
+    return 1;
+}
+//# sourceMappingURL=gate.js.map

package/dist/commands/gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate.js","sourceRoot":"","sources":["../../src/commands/gate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,oEAAoE;AACpE,MAAM,UAAU,IAAI,CAAC,IAAc;IACjC,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAChD,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;QAC1D,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IACtG,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,UAAU,EAAE,aAAa,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxG,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0DAA0D,CAAC,CAAC;QACjF,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sDAAsD,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACnI,CAAC;IACD,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,EAAE,IAAI,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/commands/hook.d.ts

@@ -0,0 +1 @@
+export declare function hook(args: string[]): Promise<number>;