whodecided 0.1.0

package/dist/distill/prompt.js

@@ -0,0 +1,53 @@
+/**
+ * `claude -p` distiller calls get logged as their own sessions under
+ * ~/.claude/projects. This sentinel is embedded in every distiller prompt so
+ * locate can skip those sessions - otherwise whodecided audits its own
+ * distiller output (a feedback loop that surfaces the prompt as a "decision").
+ */
+export const DISTILLER_SENTINEL = "WHODECIDED_DISTILLER_SESSION_v1";
+/**
+ * Native language scans faster: when lang is "auto", follow whichever
+ * language dominates the user's own messages in the slices.
+ */
+export function resolveLang(candidates, lang) {
+    if (lang !== "auto")
+        return lang;
+    const userText = candidates
+        .flatMap((c) => c.slice.split("\n"))
+        .filter((l) => l.includes("] USER"))
+        .join("");
+    const cjk = (userText.match(/[一-鿿]/g) ?? []).length;
+    return cjk > userText.length * 0.1 ? "zh" : "en";
+}
+export function buildPrompt(candidates, budget, lang = "en") {
+    const langRule = lang === "zh"
+        ? 'Write "what", "why", "note" and "alternatives" values in Simplified Chinese (keep code identifiers, commands and product names as-is).'
+        : 'Write "what", "why", "note" and "alternatives" values in English.';
+    const instructions = `[${DISTILLER_SENTINEL}] You are a decision distiller auditing an AI coding session.
+
+Definition of a decision (the only test that matters):
+a reasonable alternative existed, and choosing it would change behavior,
+security, or maintenance cost. Purely mechanical actions (fixing typos,
+following existing code style) do NOT count.
+
+Compression rules:
+1. Keep only decisions that changed the outcome; if deleting the entry does not change the understanding of "what was chosen", drop it.
+2. Merge repetition (e.g. 8 rapid approvals in a row -> one entry).
+3. Hard budget: at most ${budget} entries total. Exceeding it means your bar is too low.
+4. "what" is a single line, commit-message style.
+
+Input: a JSON array of candidates (provided separately). Each has a "ref" (transcript anchor),
+a "kind", an "aware" flag, and a "slice" (transcript excerpt).
+- kind "question"/"plan"/"veto": an explicit user decision point. Extract WHAT was decided from the slice. For "plan" with bundled=true, unpack the plan into its distinct decisions, one entry each, all sharing that candidate's ref.
+- kind "turn": mine the excerpt for SILENT AGENT decisions (technology picks, defaults chosen, edge cases skipped, tests skipped). by="agent", aware=false unless the slice shows the agent explicitly asked the user first.
+
+Output: ONLY a JSON array, no prose, no markdown fence. Each element:
+{"id":"D<n>","what":"<one line>","why":"<short reason if recoverable>","by":"agent"|"user","aware":<boolean>,"alternatives":["..."],"reversibility":"low"|"medium"|"high","ref":"<ref of the source candidate>"}
+- "ref" MUST be copied exactly from one of the input candidates.
+- "aware" for user decisions: copy the candidate's aware flag.
+- Omit "why"/"alternatives"/"reversibility" when unknown; never invent.
+- ${langRule}`;
+    const payload = JSON.stringify(candidates.map(({ ref, kind, aware, bundled, latencyMs, slice }) => ({ ref, kind, aware, bundled, latencyMs, slice })));
+    return { instructions, payload };
+}
+//# sourceMappingURL=prompt.js.map

package/dist/distill/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/distill/prompt.ts"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,iCAAiC,CAAC;AAEpE;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,UAA+B,EAAE,IAA0B;IACrF,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,QAAQ,GAAG,UAAU;SACxB,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;SACnC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;SACnC,IAAI,CAAC,EAAE,CAAC,CAAC;IACZ,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IACpD,OAAO,GAAG,GAAG,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,UAA+B,EAAE,MAAc,EAAE,OAAoB,IAAI;IACnG,MAAM,QAAQ,GACZ,IAAI,KAAK,IAAI;QACX,CAAC,CAAC,wIAAwI;QAC1I,CAAC,CAAC,mEAAmE,CAAC;IAC1E,MAAM,YAAY,GAAG,IAAI,kBAAkB;;;;;;;;;;0BAUnB,MAAM;;;;;;;;;;;;;IAa5B,QAAQ,EAAE,CAAC;IACb,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAC5B,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,CACvH,CAAC;IACF,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;AACnC,CAAC"}

package/dist/distill/watermark.d.ts

@@ -0,0 +1,5 @@
+/** Highest transcript line already distilled, per session. Disposable cache. */
+export type Watermark = Record<string, number>;
+export declare function watermarkPath(repoRoot: string): string;
+export declare function loadWatermark(file: string): Watermark;
+export declare function saveWatermark(file: string, wm: Watermark): void;

package/dist/distill/watermark.js

@@ -0,0 +1,22 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { parse, stringify } from "yaml";
+export function watermarkPath(repoRoot) {
+    return join(repoRoot, ".wdd", ".cache", "watermark.yaml");
+}
+export function loadWatermark(file) {
+    if (!existsSync(file))
+        return {};
+    try {
+        const data = parse(readFileSync(file, "utf8"));
+        return typeof data === "object" && data !== null ? data : {};
+    }
+    catch {
+        return {};
+    }
+}
+export function saveWatermark(file, wm) {
+    mkdirSync(dirname(file), { recursive: true });
+    writeFileSync(file, stringify(wm));
+}
+//# sourceMappingURL=watermark.js.map

package/dist/distill/watermark.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watermark.js","sourceRoot":"","sources":["../../src/distill/watermark.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAKxC,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,OAAO,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QAC/C,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC,CAAE,IAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,EAAa;IACvD,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,aAAa,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;AACrC,CAAC"}

package/dist/extract/candidates.d.ts

@@ -0,0 +1,25 @@
+import type { SessionEvent } from "../transcript/parser.js";
+export interface DecisionCandidate {
+    ref: string;
+    kind: "question" | "plan" | "veto" | "turn";
+    aware: boolean;
+    t?: string;
+    cwd?: string;
+    model?: string;
+    latencyMs?: number;
+    bundled?: boolean;
+    files?: string[];
+    summary: string;
+    slice: string;
+}
+export interface Heuristics {
+    reflexMs: number;
+}
+export declare const DEFAULT_HEURISTICS: Heuristics;
+/**
+ * Deterministic candidate extraction, no LLM. Two kinds of output:
+ * explicit user decision points (question/plan/veto, with clean latency where
+ * the tool blocks on the human), and per-turn slices for the distiller to
+ * mine silent agent decisions from.
+ */
+export declare function extractCandidates(events: SessionEvent[], heuristics?: Heuristics): DecisionCandidate[];

package/dist/extract/candidates.js

@@ -0,0 +1,136 @@
+export const DEFAULT_HEURISTICS = { reflexMs: 3000 };
+// File-editing tools whose input is a path (grounds "what" in actual code).
+const FILE_TOOLS = new Set(["Edit", "Write", "MultiEdit", "NotebookEdit", "Update"]);
+function filesTouched(events) {
+    const files = [];
+    for (const e of events) {
+        if (e.kind === "tool_use" && e.toolName && FILE_TOOLS.has(e.toolName) && e.text && !files.includes(e.text)) {
+            files.push(e.text);
+        }
+    }
+    return files.slice(0, 8);
+}
+const MAX_SLICE_LINES = 200;
+const MAX_LINE_CHARS = 240;
+/**
+ * Deterministic candidate extraction, no LLM. Two kinds of output:
+ * explicit user decision points (question/plan/veto, with clean latency where
+ * the tool blocks on the human), and per-turn slices for the distiller to
+ * mine silent agent decisions from.
+ */
+export function extractCandidates(events, heuristics = DEFAULT_HEURISTICS) {
+    const candidates = [];
+    // Decision anchors are often user events (which carry no model); track the
+    // model of the most recent assistant turn so each candidate records which
+    // model was acting when the decision was made.
+    let activeModel;
+    for (const e of events) {
+        if (e.model)
+            activeModel = e.model;
+        if (e.kind === "question_response") {
+            candidates.push({
+                ref: ref(e),
+                kind: "question",
+                aware: e.latencyMs === undefined || e.latencyMs >= heuristics.reflexMs,
+                ...anchor(e, activeModel),
+                latencyMs: e.latencyMs,
+                summary: firstLine(e.text),
+                slice: sliceAround(events, e),
+            });
+        }
+        else if (e.kind === "plan_approval") {
+            // Latency evidence is one-sided: fast proves blind, slow proves nothing
+            // (the user may have been away). Approval alone never earns aware:true.
+            candidates.push({
+                ref: ref(e),
+                kind: "plan",
+                aware: false,
+                ...anchor(e, activeModel),
+                latencyMs: e.latencyMs,
+                bundled: true,
+                summary: firstLine(e.text),
+                slice: sliceAround(events, e),
+            });
+        }
+        else if (e.kind === "tool_result" && e.rejected) {
+            candidates.push({
+                ref: ref(e),
+                kind: "veto",
+                aware: true,
+                ...anchor(e, activeModel),
+                summary: `rejected ${e.toolName ?? "tool"}`,
+                slice: sliceAround(events, e),
+            });
+        }
+    }
+    candidates.push(...turnSlices(events));
+    return candidates;
+}
+function ref(e) {
+    return `tx:${e.session}:${e.line}`;
+}
+function anchor(e, model) {
+    return { ...(e.t ? { t: e.t } : {}), ...(e.cwd ? { cwd: e.cwd } : {}), ...(model ? { model } : {}) };
+}
+function firstLine(text) {
+    return (text ?? "").split("\n")[0]?.slice(0, 120) ?? "";
+}
+/** Compact excerpt of the events surrounding one decision point. */
+function sliceAround(events, center) {
+    const i = events.indexOf(center);
+    return renderSlice(events.slice(Math.max(0, i - 15), i + 3));
+}
+/** One candidate per user turn: the distiller mines agent decisions from it. */
+function turnSlices(events) {
+    const turns = [];
+    let start = -1;
+    const flush = (end) => {
+        if (start < 0)
+            return;
+        const turn = events.slice(start, end);
+        const first = turn[0];
+        if (!first || turn.length < 2)
+            return;
+        // The turn's agent decisions come from its assistant events; record the
+        // last model that acted within the turn.
+        const turnModel = turn.filter((e) => e.model).at(-1)?.model;
+        const files = filesTouched(turn);
+        turns.push({
+            ref: ref(first),
+            kind: "turn",
+            aware: false,
+            ...anchor(first, turnModel),
+            ...(files.length ? { files } : {}),
+            summary: firstLine(first.text),
+            slice: renderSlice(turn),
+        });
+    };
+    events.forEach((e, i) => {
+        if (e.kind === "user_text") {
+            flush(i);
+            start = i;
+        }
+    });
+    flush(events.length);
+    return turns;
+}
+function renderSlice(events) {
+    const lines = [];
+    for (const e of events) {
+        if (lines.length >= MAX_SLICE_LINES)
+            break;
+        const tag = e.kind === "user_text" ? "USER" :
+            e.kind === "assistant_text" ? "AGENT" :
+                e.kind === "tool_use" ? `TOOL ${e.toolName}` :
+                    e.kind === "tool_result" && e.rejected ? "USER-REJECTED" :
+                        e.kind === "question_response" ? "USER-ANSWERED" :
+                            e.kind === "plan_approval" ? "USER-APPROVED-PLAN" :
+                                null;
+        if (tag === null)
+            continue;
+        const text = (e.text ?? "").replace(/\s+/g, " ").slice(0, MAX_LINE_CHARS);
+        lines.push(`[${e.line}] ${tag}: ${text}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=candidates.js.map

package/dist/extract/candidates.js.map

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

package/dist/git.d.ts

@@ -0,0 +1,22 @@
+export declare function git(cwd: string, ...args: string[]): string;
+export declare function tryGit(cwd: string, ...args: string[]): string | undefined;
+export declare function repoRoot(cwd: string): string | undefined;
+export declare function currentBranch(cwd: string): string | undefined;
+export declare function defaultBranch(cwd: string): string | undefined;
+/** ISO time of the merge-base with the default branch, if on a feature branch. */
+export declare function branchSinceTime(cwd: string): string | undefined;
+/** All worktree paths of this repo (including the main checkout). */
+export declare function worktreePaths(cwd: string): string[];
+/** True if the path is excluded by some .gitignore (git check-ignore exits 0). */
+export declare function pathIgnored(cwd: string, relPath: string): boolean;
+export interface CommitResult {
+    sha?: string;
+    committed: boolean;
+    ignored: boolean;
+}
+/**
+ * Stage only the given files and commit. Never throws on the ignored case
+ * (the audit's whole premise is being committed, but the file is already on
+ * disk either way) - callers surface an actionable message instead.
+ */
+export declare function commitFiles(cwd: string, files: string[], message: string): CommitResult;

package/dist/git.js

@@ -0,0 +1,78 @@
+import { execFileSync } from "node:child_process";
+export function git(cwd, ...args) {
+    return execFileSync("git", args, { cwd, encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] }).trim();
+}
+export function tryGit(cwd, ...args) {
+    try {
+        return git(cwd, ...args);
+    }
+    catch {
+        return undefined;
+    }
+}
+export function repoRoot(cwd) {
+    return tryGit(cwd, "rev-parse", "--show-toplevel");
+}
+export function currentBranch(cwd) {
+    const branch = tryGit(cwd, "rev-parse", "--abbrev-ref", "HEAD");
+    return branch === "HEAD" ? undefined : branch;
+}
+export function defaultBranch(cwd) {
+    const remote = tryGit(cwd, "rev-parse", "--abbrev-ref", "origin/HEAD");
+    if (remote)
+        return remote.replace("origin/", "");
+    for (const name of ["main", "master"]) {
+        if (tryGit(cwd, "rev-parse", "--verify", name) !== undefined)
+            return name;
+    }
+    return undefined;
+}
+/** ISO time of the merge-base with the default branch, if on a feature branch. */
+export function branchSinceTime(cwd) {
+    const branch = currentBranch(cwd);
+    const base = defaultBranch(cwd);
+    if (!branch || !base || branch === base)
+        return undefined;
+    const sha = tryGit(cwd, "merge-base", "HEAD", base);
+    return sha ? tryGit(cwd, "show", "-s", "--format=%cI", sha) : undefined;
+}
+/** All worktree paths of this repo (including the main checkout). */
+export function worktreePaths(cwd) {
+    const out = tryGit(cwd, "worktree", "list", "--porcelain");
+    if (!out)
+        return [];
+    return out
+        .split("\n")
+        .filter((l) => l.startsWith("worktree "))
+        .map((l) => l.slice("worktree ".length));
+}
+/** True if the path is excluded by some .gitignore (git check-ignore exits 0). */
+export function pathIgnored(cwd, relPath) {
+    try {
+        execFileSync("git", ["check-ignore", "-q", "--", relPath], { cwd, stdio: "ignore" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Stage only the given files and commit. Never throws on the ignored case
+ * (the audit's whole premise is being committed, but the file is already on
+ * disk either way) - callers surface an actionable message instead.
+ */
+export function commitFiles(cwd, files, message) {
+    if (files.some((f) => pathIgnored(cwd, f)))
+        return { committed: false, ignored: true };
+    git(cwd, "add", "--", ...files);
+    try {
+        git(cwd, "diff", "--cached", "--quiet", "--", ...files);
+        return { committed: false, ignored: false };
+    }
+    catch {
+        git(cwd, "commit", "-m", message, "--", ...files);
+        const sha = tryGit(cwd, "rev-parse", "--short", "HEAD");
+        return { committed: true, ignored: false, ...(sha ? { sha } : {}) };
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/git.js.map

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

package/dist/jsonl.d.ts

@@ -0,0 +1,14 @@
+export interface LineError {
+    line: number;
+    message: string;
+}
+export interface JsonlResult<T> {
+    values: T[];
+    errors: LineError[];
+}
+/**
+ * Parse jsonl text line by line. Bad lines are collected as errors and
+ * skipped, never aborting the whole file (hand-edited ledgers must survive).
+ * `parseValue` returns the parsed value, or an error message string.
+ */
+export declare function parseJsonl<T>(text: string, parseValue: (value: unknown) => T | string): JsonlResult<T>;

package/dist/jsonl.js

@@ -0,0 +1,30 @@
+/**
+ * Parse jsonl text line by line. Bad lines are collected as errors and
+ * skipped, never aborting the whole file (hand-edited ledgers must survive).
+ * `parseValue` returns the parsed value, or an error message string.
+ */
+export function parseJsonl(text, parseValue) {
+    const values = [];
+    const errors = [];
+    text.split("\n").forEach((raw, index) => {
+        if (raw.trim() === "")
+            return;
+        let json;
+        try {
+            json = JSON.parse(raw);
+        }
+        catch {
+            errors.push({ line: index + 1, message: "invalid JSON" });
+            return;
+        }
+        const result = parseValue(json);
+        if (typeof result === "string") {
+            errors.push({ line: index + 1, message: result });
+        }
+        else {
+            values.push(result);
+        }
+    });
+    return { values, errors };
+}
+//# sourceMappingURL=jsonl.js.map

package/dist/jsonl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl.js","sourceRoot":"","sources":["../src/jsonl.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,MAAM,UAAU,UAAU,CACxB,IAAY,EACZ,UAA0C;IAE1C,MAAM,MAAM,GAAQ,EAAE,CAAC;IACvB,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QACtC,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO;QAC9B,IAAI,IAAa,CAAC;QAClB,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;YAC1D,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QACpD,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtB,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC"}

package/dist/ledger/io.d.ts

@@ -0,0 +1,30 @@
+import type { LineError } from "../jsonl.js";
+import { type DecisionEntry, type LedgerLine, type RatifyEntry } from "./schema.js";
+export interface Ledger {
+    entries: DecisionEntry[];
+    ratifies: RatifyEntry[];
+    errors: LineError[];
+}
+export declare function ledgerPath(repoRoot: string): string;
+export declare function readLedger(file: string): Ledger;
+/** Single atomic append; also drops a .gitignore for the cache dir on first write. */
+export declare function appendLedgerLines(file: string, lines: LedgerLine[]): void;
+/** Latest ratify wins per target. */
+export declare function verdictOf(ratifies: RatifyEntry[], id: string): "accept" | "reject" | undefined;
+/** Whether the latest ratify pinned this decision into agent memory. */
+export declare function isPinned(ratifies: RatifyEntry[], id: string): boolean;
+/** The latest ratify's note for this decision (user's supplement to the rule). */
+export declare function noteOf(ratifies: RatifyEntry[], id: string): string | undefined;
+export interface Followup {
+    entry: DecisionEntry;
+    correction?: string;
+}
+/**
+ * The v2 seam. Overturning records "this was the wrong call" but never touches
+ * code (honest v1 boundary). This returns the decisions ruled `reject` together
+ * with the correction note, i.e. the work still owed. v1 surfaces it (apply
+ * reminder, report section); a v2 task layer consumes it to spawn follow-up
+ * tickets. Shape is stable so the task adapter binds to this, not to internals.
+ */
+export declare function followups(entries: DecisionEntry[], ratifies: RatifyEntry[]): Followup[];
+export declare function nextDecisionNumber(entries: DecisionEntry[]): number;

package/dist/ledger/io.js

@@ -0,0 +1,85 @@
+import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { isRatify, parseLedger } from "./schema.js";
+export function ledgerPath(repoRoot) {
+    return join(repoRoot, ".wdd", "ledger.jsonl");
+}
+export function readLedger(file) {
+    if (!existsSync(file))
+        return { entries: [], ratifies: [], errors: [] };
+    const { values, errors } = parseLedger(readFileSync(file, "utf8"));
+    return {
+        entries: values.filter((l) => !isRatify(l)),
+        ratifies: values.filter(isRatify),
+        errors,
+    };
+}
+/** Single atomic append; also drops a .gitignore for the cache dir on first write. */
+export function appendLedgerLines(file, lines) {
+    if (lines.length === 0)
+        return;
+    const dir = dirname(file);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(join(dir, ".gitignore"), ".cache/\n");
+    }
+    appendFileSync(file, lines.map((l) => JSON.stringify(l)).join("\n") + "\n");
+}
+/** Latest ratify wins per target. */
+export function verdictOf(ratifies, id) {
+    for (let i = ratifies.length - 1; i >= 0; i--) {
+        if (ratifies[i]?.target === id)
+            return ratifies[i]?.verdict;
+    }
+    return undefined;
+}
+/** Whether the latest ratify pinned this decision into agent memory. */
+export function isPinned(ratifies, id) {
+    for (let i = ratifies.length - 1; i >= 0; i--) {
+        if (ratifies[i]?.target === id)
+            return ratifies[i]?.pin === true;
+    }
+    return false;
+}
+/** The latest ratify's note for this decision (user's supplement to the rule). */
+export function noteOf(ratifies, id) {
+    for (let i = ratifies.length - 1; i >= 0; i--) {
+        if (ratifies[i]?.target === id)
+            return ratifies[i]?.note;
+    }
+    return undefined;
+}
+/**
+ * The v2 seam. Overturning records "this was the wrong call" but never touches
+ * code (honest v1 boundary). This returns the decisions ruled `reject` together
+ * with the correction note, i.e. the work still owed. v1 surfaces it (apply
+ * reminder, report section); a v2 task layer consumes it to spawn follow-up
+ * tickets. Shape is stable so the task adapter binds to this, not to internals.
+ */
+export function followups(entries, ratifies) {
+    const out = [];
+    for (const entry of entries) {
+        if (verdictOf(ratifies, entry.id) !== "reject")
+            continue;
+        const note = lastRejectNote(ratifies, entry.id);
+        out.push({ entry, ...(note ? { correction: note } : {}) });
+    }
+    return out;
+}
+function lastRejectNote(ratifies, id) {
+    for (let i = ratifies.length - 1; i >= 0; i--) {
+        if (ratifies[i]?.target === id && ratifies[i]?.verdict === "reject")
+            return ratifies[i]?.note;
+    }
+    return undefined;
+}
+export function nextDecisionNumber(entries) {
+    let max = 0;
+    for (const e of entries) {
+        const m = /^D(\d+)$/.exec(e.id);
+        if (m)
+            max = Math.max(max, Number(m[1]));
+    }
+    return max + 1;
+}
+//# sourceMappingURL=io.js.map

package/dist/ledger/io.js.map

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

package/dist/ledger/schema.d.ts

@@ -0,0 +1,31 @@
+import { type JsonlResult } from "../jsonl.js";
+export interface DecisionEntry {
+    id: string;
+    what: string;
+    by: "agent" | "user";
+    aware: boolean;
+    ref: string;
+    t?: string;
+    cwd?: string;
+    model?: string;
+    latencyMs?: number;
+    why?: string;
+    note?: string;
+    alternatives?: string[];
+    reversibility?: "low" | "medium" | "high";
+    branch?: string;
+    precedent?: string;
+    files?: string[];
+}
+export interface RatifyEntry {
+    type: "ratify";
+    target: string;
+    verdict: "accept" | "reject";
+    t: string;
+    note?: string;
+    pin?: boolean;
+}
+export type LedgerLine = DecisionEntry | RatifyEntry;
+export declare function isRatify(line: LedgerLine): line is RatifyEntry;
+export declare function parseLedgerLine(value: unknown): LedgerLine | string;
+export declare function parseLedger(text: string): JsonlResult<LedgerLine>;

package/dist/ledger/schema.js

@@ -0,0 +1,57 @@
+import { parseJsonl } from "../jsonl.js";
+import { isIsoTimestamp, isNonEmptyString, isOptionalString, isRecord } from "../validate.js";
+const REF_PATTERN = /^tx:[^\s:]+:\d+$/;
+const REVERSIBILITIES = ["low", "medium", "high"];
+export function isRatify(line) {
+    return "type" in line && line.type === "ratify";
+}
+export function parseLedgerLine(value) {
+    if (!isRecord(value))
+        return "not an object";
+    return value.type === "ratify" ? parseRatify(value) : parseDecision(value);
+}
+export function parseLedger(text) {
+    return parseJsonl(text, parseLedgerLine);
+}
+function parseDecision(v) {
+    if (!isNonEmptyString(v.id))
+        return "id: non-empty string required";
+    if (!isNonEmptyString(v.what) || v.what.includes("\n"))
+        return "what: non-empty single line required";
+    if (v.by !== "agent" && v.by !== "user")
+        return 'by: "agent" or "user" required';
+    if (typeof v.aware !== "boolean")
+        return "aware: boolean required";
+    if (typeof v.ref !== "string" || !REF_PATTERN.test(v.ref))
+        return "ref: tx:<session>:<line> required";
+    for (const key of ["why", "note", "branch", "precedent", "t", "cwd", "model"]) {
+        if (!isOptionalString(v[key]))
+            return `${key}: string expected`;
+    }
+    for (const key of ["alternatives", "files"]) {
+        if (v[key] !== undefined && !(Array.isArray(v[key]) && v[key].every((a) => typeof a === "string"))) {
+            return `${key}: string array expected`;
+        }
+    }
+    if (v.reversibility !== undefined && !REVERSIBILITIES.includes(v.reversibility)) {
+        return 'reversibility: "low" | "medium" | "high" expected';
+    }
+    if (v.latencyMs !== undefined && typeof v.latencyMs !== "number")
+        return "latencyMs: number expected";
+    // Extra fields pass through untouched: hand edits and future fields must survive.
+    return v;
+}
+function parseRatify(v) {
+    if (!isNonEmptyString(v.target))
+        return "target: non-empty string required";
+    if (v.verdict !== "accept" && v.verdict !== "reject")
+        return 'verdict: "accept" or "reject" required';
+    if (!isIsoTimestamp(v.t))
+        return "t: ISO timestamp required";
+    if (!isOptionalString(v.note))
+        return "note: string expected";
+    if (v.pin !== undefined && typeof v.pin !== "boolean")
+        return "pin: boolean expected";
+    return v;
+}
+//# sourceMappingURL=schema.js.map

package/dist/ledger/schema.js.map

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