harnery 0.5.0 → 0.6.0

package/dist/lib/browser/client.d.ts

@@ -1,6 +1,7 @@
 import { type Page } from "playwright";
 import type { CookieJar } from "../cookies/index.js";
 import { type OverflowResult, type WidthResult } from "./layout.js";
+import { type RuntsResult } from "./runts.js";
 import { type CheckVisibilityOptions, type VisibilityResult } from "./visibility.js";
 /**
  * Headless-Chromium wrapper for the `browse` command.
@@ -168,6 +169,19 @@ export declare class Browser {
     checkOverflow(opts?: {
         sampleLimit?: number;
     }): Promise<OverflowResult>;
+    /**
+     * Scan text blocks for runts — a single word alone on a block's last
+     * visual line. Word-count per line via per-word Range rects (the width
+     * of the last line is deliberately NOT the signal; see runts.ts).
+     */
+    checkRunts(opts?: {
+        scope?: string | null;
+        minChars?: number;
+    }): Promise<RuntsResult>;
+    /** Inject annotation overlays for runt hits. Used before screenshot. */
+    annotateRunts(result: RuntsResult): Promise<void>;
+    /** Remove runt annotation overlays. */
+    clearRuntsAnnotations(): Promise<void>;
     /** Inject annotation overlays for width + overflow results. Used before screenshot. */
     annotateLayout(args: {
         widths: WidthResult[];

package/dist/lib/browser/client.d.ts.map

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

package/dist/lib/browser/client.js

@@ -3,6 +3,7 @@ import { homedir } from "node:os";
 import { resolve } from "node:path";
 import { chromium, } from "playwright";
 import { buildClearLayoutAnnotationsScript, buildLayoutAnnotateScript, buildOverflowCheck, buildWidthCheck, } from "./layout.js";
+import { buildClearRuntsAnnotationsScript, buildRuntsAnnotateScript, buildRuntsCheck, } from "./runts.js";
 import { buildAnnotateScript, buildClearAnnotationsScript, buildVisibilityCheck, } from "./visibility.js";
 const DEFAULT_PROFILE = resolve(homedir(), ".cache", "harnery", "browser-profile");
 export class Browser {
@@ -237,6 +238,25 @@ export class Browser {
             sampleLimit: opts.sampleLimit ?? 5,
         });
     }
+    /**
+     * Scan text blocks for runts — a single word alone on a block's last
+     * visual line. Word-count per line via per-word Range rects (the width
+     * of the last line is deliberately NOT the signal; see runts.ts).
+     */
+    async checkRunts(opts = {}) {
+        return await this.currentPage.evaluate(buildRuntsCheck(), {
+            scope: opts.scope ?? null,
+            minChars: opts.minChars ?? 40,
+        });
+    }
+    /** Inject annotation overlays for runt hits. Used before screenshot. */
+    async annotateRunts(result) {
+        await this.currentPage.evaluate(buildRuntsAnnotateScript(), { runts: result.runts });
+    }
+    /** Remove runt annotation overlays. */
+    async clearRuntsAnnotations() {
+        await this.currentPage.evaluate(buildClearRuntsAnnotationsScript());
+    }
     /** Inject annotation overlays for width + overflow results. Used before screenshot. */
     async annotateLayout(args) {
         await this.currentPage.evaluate(buildLayoutAnnotateScript(), args);

package/dist/lib/browser/index.d.ts

@@ -1,5 +1,6 @@
 export { Browser, type BrowserOptions, type ConsoleEvent, type Diagnostics, type FailedRequest, type NavigateResult, type PageErrorEvent, } from "./client.js";
 export { captureDevOverlay, type DevOverlayError, type DevOverlayResult, } from "./dev-overlay.js";
 export type { OverflowElement, OverflowResult, WidthResult, } from "./layout.js";
+export type { RuntHit, RuntsResult, } from "./runts.js";
 export type { CheckVisibilityOptions, VisibilityResult, VisibilitySample, } from "./visibility.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/browser/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/browser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,eAAe,EACf,cAAc,EACd,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/browser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,eAAe,EACf,cAAc,EACd,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,OAAO,EACP,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC"}

package/dist/lib/browser/runts.d.ts

@@ -0,0 +1,44 @@
+export interface RuntHit {
+    /** Human label for the owning block: `tag#id` / `tag.class` / `tag`. */
+    block: string;
+    /** The lone word on the last visual line (trailing punctuation included). */
+    word: string;
+    /** First ~80 chars of the block's text, for locating it. */
+    snippet: string;
+    /** Document-relative rect of the runt word (scroll offsets applied). */
+    rect: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** Number of visual lines in the block. */
+    lines: number;
+}
+export interface RuntsResult {
+    /** Text blocks scanned (post length/inline-children filters). */
+    scannedBlocks: number;
+    /** True when the block sweep hit the internal cap (very large page). */
+    truncated: boolean;
+    runts: RuntHit[];
+}
+/**
+ * Build the JS function passed to `page.evaluate`. `scope` narrows the sweep
+ * to one container (null = whole body); `minChars` filters out tiny labels
+ * that can't meaningfully wrap (default 40).
+ */
+export declare function buildRuntsCheck(): (args: {
+    scope: string | null;
+    minChars: number;
+}) => RuntsResult;
+/**
+ * Annotate runt hits onto the live page before the screenshot. Uses a
+ * document-absolute root (not fixed-inset like the other check overlays)
+ * because runts are usually below the fold and the rects are document
+ * coordinates — this keeps boxes aligned on full-page captures.
+ */
+export declare function buildRuntsAnnotateScript(): (args: {
+    runts: RuntHit[];
+}) => void;
+export declare function buildClearRuntsAnnotationsScript(): () => void;
+//# sourceMappingURL=runts.d.ts.map

package/dist/lib/browser/runts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runts.d.ts","sourceRoot":"","sources":["../../../src/lib/browser/runts.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,OAAO;IACtB,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,IAAI,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,iEAAiE;IACjE,aAAa,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,CAAC,IAAI,EAAE;IACxC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB,KAAK,WAAW,CAkHhB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,IAAI,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,KAAK,IAAI,CAyC/E;AAED,wBAAgB,gCAAgC,IAAI,MAAM,IAAI,CAI7D"}

package/dist/lib/browser/runts.js

@@ -0,0 +1,193 @@
+// Runt detection for `harn browse` — a runt (a.k.a. "widow word") is a single
+// short word sitting alone on the LAST visual line of a text block. Not a
+// page-break issue; it happens mid-page and just looks sloppy.
+//
+// Detection is by COUNTING WORDS on the last visual line (== 1 word), NOT by
+// relative width: a width threshold misses runts in narrow columns (how-to
+// steps, a right-aligned contact box) where one short word still fills a big
+// slice of the skinny column. "Text block" = element with real text whose
+// element children are all inline — a <p>-only pass silently skips
+// pull-quotes, blurbs and captions that ship as <div>/<blockquote>.
+//
+// Atomic tokens (URLs, emails, phone numbers) are excluded — they can't be
+// rebalanced and usually sit on their own line by design. The detector can't
+// catch a runt that is itself one long word; eyeball as a final pass.
+//
+// The word-level line mapping (per-word Range rects grouped by line top) was
+// first built for the paged.js print-book lint; this is the generalized
+// live-page port.
+/**
+ * Build the JS function passed to `page.evaluate`. `scope` narrows the sweep
+ * to one container (null = whole body); `minChars` filters out tiny labels
+ * that can't meaningfully wrap (default 40).
+ */
+export function buildRuntsCheck() {
+    return ({ scope, minChars }) => {
+        const INLINE = new Set([
+            "B",
+            "I",
+            "EM",
+            "STRONG",
+            "SPAN",
+            "A",
+            "BR",
+            "SMALL",
+            "SUP",
+            "SUB",
+            "U",
+            "MARK",
+            "CODE",
+            "ABBR",
+            "TIME",
+            "WBR",
+        ]);
+        const ATOMIC = /@|https?:|\.(com|org|net|io|co)\b|\d-\d{3}/;
+        const BLOCK_CAP = 5000;
+        const RUNT_CAP = 50;
+        const root = scope ? document.querySelector(scope) : document.body;
+        if (!root)
+            return { scannedBlocks: 0, truncated: false, runts: [] };
+        const sx = window.scrollX;
+        const sy = window.scrollY;
+        const label = (el) => {
+            const tag = el.tagName.toLowerCase();
+            if (el.id)
+                return `${tag}#${el.id}`;
+            const cls = typeof el.className === "string" ? el.className.trim() : "";
+            if (cls)
+                return `${tag}.${cls.split(/\s+/).slice(0, 2).join(".")}`;
+            return tag;
+        };
+        const all = root.querySelectorAll("*");
+        const runts = [];
+        let scanned = 0;
+        let truncated = false;
+        for (let i = 0; i < all.length; i++) {
+            const el = all[i];
+            if (!el)
+                continue;
+            const text = el.textContent ?? "";
+            if (text.trim().length < minChars)
+                continue;
+            let allInline = true;
+            for (const c of el.children) {
+                if (!INLINE.has(c.tagName)) {
+                    allInline = false;
+                    break;
+                }
+            }
+            if (!allInline)
+                continue;
+            const elRect = el.getBoundingClientRect();
+            if (elRect.width <= 0 || elRect.height <= 0)
+                continue;
+            if (scanned >= BLOCK_CAP) {
+                truncated = true;
+                break;
+            }
+            scanned++;
+            // Map every word to its visual line by rounding the Range rect top.
+            const lines = new Map();
+            const tw = document.createTreeWalker(el, NodeFilter.SHOW_TEXT);
+            for (let n = tw.nextNode(); n; n = tw.nextNode()) {
+                const value = n.nodeValue ?? "";
+                for (const m of value.matchAll(/\S+/g)) {
+                    const r = document.createRange();
+                    r.setStart(n, m.index);
+                    r.setEnd(n, m.index + m[0].length);
+                    const rect = r.getBoundingClientRect();
+                    if (!rect.width)
+                        continue;
+                    const top = Math.round(rect.top);
+                    const entry = lines.get(top);
+                    if (entry) {
+                        entry.words.push(m[0]);
+                        entry.last = rect;
+                    }
+                    else {
+                        lines.set(top, { words: [m[0]], last: rect });
+                    }
+                }
+            }
+            const tops = [...lines.keys()].sort((a, b) => a - b);
+            if (tops.length < 2)
+                continue; // single line, no runt risk
+            const lastTop = tops[tops.length - 1];
+            const last = lastTop === undefined ? undefined : lines.get(lastTop);
+            if (last?.words.length !== 1)
+                continue;
+            const word = last.words[0] ?? "";
+            if (ATOMIC.test(word))
+                continue;
+            runts.push({
+                block: label(el),
+                word,
+                snippet: text.replace(/\s+/g, " ").trim().slice(0, 80),
+                rect: {
+                    x: Math.round(last.last.x + sx),
+                    y: Math.round(last.last.y + sy),
+                    width: Math.round(last.last.width),
+                    height: Math.round(last.last.height),
+                },
+                lines: tops.length,
+            });
+            if (runts.length >= RUNT_CAP) {
+                truncated = true;
+                break;
+            }
+        }
+        return { scannedBlocks: scanned, truncated, runts };
+    };
+}
+/**
+ * Annotate runt hits onto the live page before the screenshot. Uses a
+ * document-absolute root (not fixed-inset like the other check overlays)
+ * because runts are usually below the fold and the rects are document
+ * coordinates — this keeps boxes aligned on full-page captures.
+ */
+export function buildRuntsAnnotateScript() {
+    return ({ runts }) => {
+        const ROOT_ID = "__bp-check-runt-annotations__";
+        document.getElementById(ROOT_ID)?.remove();
+        const root = document.createElement("div");
+        root.id = ROOT_ID;
+        root.style.cssText =
+            "position: absolute; top: 0; left: 0; width: 100%; height: 0; overflow: visible; pointer-events: none; z-index: 2147483646;";
+        document.body.appendChild(root);
+        for (const hit of runts) {
+            const box = document.createElement("div");
+            box.style.cssText = `
+        position: absolute;
+        left: ${hit.rect.x - 3}px;
+        top: ${hit.rect.y - 3}px;
+        width: ${hit.rect.width + 6}px;
+        height: ${hit.rect.height + 6}px;
+        border: 2px solid #d946ef;
+        box-sizing: border-box;
+        background: #d946ef1a;
+        pointer-events: none;
+      `;
+            const tag = document.createElement("div");
+            tag.textContent = `runt: …${hit.word} (${hit.block})`;
+            tag.style.cssText = `
+        position: absolute;
+        left: 0;
+        top: -18px;
+        background: #d946ef;
+        color: #fff;
+        font: 12px/1.4 -apple-system, system-ui, sans-serif;
+        padding: 1px 6px;
+        border-radius: 3px;
+        white-space: nowrap;
+        pointer-events: none;
+      `;
+            box.appendChild(tag);
+            root.appendChild(box);
+        }
+    };
+}
+export function buildClearRuntsAnnotationsScript() {
+    return () => {
+        document.getElementById("__bp-check-runt-annotations__")?.remove();
+    };
+}

package/dist/lib/completion/walk.js

@@ -18,7 +18,7 @@ function walkCommand(cmd, parentPath, isRoot, lookup) {
     // The root program represents `harn` itself; its path stays empty so that
     // top-level subcommands have paths like "anthropic", not "harn anthropic".
     // The shell driver walks COMP_WORDS[1..], so it's already operating in
-    // post-`harn` space and shouldn't see "bp" in its lookup keys.
+    // post-`harn` space and shouldn't see the host bin name in its lookup keys.
     const path = isRoot ? "" : parentPath ? `${parentPath} ${name}` : name;
     const subcommands = cmd.commands
         .filter((c) => !isHidden(c))

package/dist/lib/cookies/client.d.ts

@@ -37,7 +37,7 @@ export interface CookieStore {
 export interface CookieJarOptions {
     /** Absolute path to the JSON store. Caller must provide. */
     path: string;
-    /** `exportedFrom` tag stamped on every save. Defaults to `"bp-cookies"`. */
+    /** `exportedFrom` tag stamped on every save. Defaults to `"harn-cookies"`. */
     source?: string;
 }
 export interface InfoResult {

package/dist/lib/cookies/client.d.ts.map

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

package/dist/lib/cookies/client.js

@@ -5,7 +5,7 @@ export class CookieJar {
     source;
     constructor(opts) {
         this.path = opts.path;
-        this.source = opts.source ?? "bp-cookies";
+        this.source = opts.source ?? "harn-cookies";
     }
     exists() {
         return existsSync(this.path);

package/dist/lib/decision/index.d.ts

@@ -0,0 +1,212 @@
+/**
+ * Decision docket: a persistent queue of decisions an agent would otherwise
+ * route to a human, plus the lifecycle that carries each one from filing to a
+ * reviewed, graduated resolution.
+ *
+ * State layout (mirrors councils):
+ *   - `.harnery/decisions/<id>.json`      — one manifest per decision
+ *   - `.harnery/decisions/<id>/`          — long-form bodies (brief, options,
+ *                                            evidence write-up) as markdown
+ *   - `.harnery/decisions/archive/`       — graduated / terminal decisions move here
+ *
+ * This module is the engine only. It stores `tier` (0/1/2) and `stakes` as
+ * opaque typed fields; what those *mean* — which decisions belong to which
+ * tier — is host policy, applied by the filing agent, never encoded here. That
+ * keeps the docket generic across host projects.
+ *
+ * Every function takes `coordRoot` explicitly (the council pattern) so the
+ * state machine is trivially testable against a tmpdir. The command layer
+ * resolves the root once via `monorepoRoot()` and threads it down.
+ *
+ * Concurrency: one file per decision (no shared index to contend on) + atomic
+ * temp→rename writes. `claim` is last-writer-wins — deliberating the same
+ * decision twice wastes tokens, not correctness.
+ */
+export declare const DECISION_SCHEMA_VERSION: 1;
+/** Tier of human-involvement. Meaning is host policy; the engine only stores it. */
+export declare const DECISION_TIERS: readonly [0, 1, 2];
+export type DecisionTier = (typeof DECISION_TIERS)[number];
+export declare const DECISION_STAKES: readonly ["small", "medium", "high"];
+export type DecisionStakes = (typeof DECISION_STAKES)[number];
+export declare const DECISION_STATUSES: readonly ["filed", "triaged", "deliberating", "resolved", "enacted", "reviewed", "archived", "superseded", "wontfix"];
+export type DecisionStatus = (typeof DECISION_STATUSES)[number];
+export declare const REVIEW_VERDICTS: readonly ["ratified", "overridden", "wrong-tier-high", "wrong-tier-low"];
+export type ReviewVerdict = (typeof REVIEW_VERDICTS)[number];
+export declare const TERMINAL_STATUSES: readonly DecisionStatus[];
+/**
+ * Legal status transitions. `superseded` is reachable from any non-terminal
+ * state (a decision can be obsoleted at any point); `wontfix` closes an
+ * un-deliberated decision. `deliberating → triaged` allows the sweeper to
+ * re-triage a decision's tier on first touch (the self-triage safeguard).
+ */
+export declare const LEGAL_TRANSITIONS: Record<DecisionStatus, readonly DecisionStatus[]>;
+export interface DecisionResolution {
+    recommendation: string;
+    confidence?: string;
+    reversal_cost?: string;
+    /** What would make this resolution wrong (the pre-mortem). */
+    wrong_if?: string;
+    /** When this should be revisited (a trigger, not a date). */
+    revisit_when?: string;
+    /** Citations: queries run, files read, costs computed. Required (≥1). */
+    evidence: string[];
+    resolved_by: string;
+    resolved_at: string;
+}
+export interface DecisionReview {
+    verdict: ReviewVerdict;
+    note?: string;
+    reviewed_at: string;
+}
+export interface DecisionManifest {
+    schema_version: typeof DECISION_SCHEMA_VERSION;
+    decision_id: string;
+    status: DecisionStatus;
+    /** Provisional at file time; the sweeper may re-check on claim. */
+    tier: DecisionTier;
+    stakes: DecisionStakes;
+    question: string;
+    context?: string;
+    /** What the filer proceeded with under always-proceed (tier 0/1), or null. */
+    default_taken?: string | null;
+    /** Agent name (e.g. "agent-Quill"), for display. */
+    filed_by?: string;
+    /** Filer instance_id. */
+    filed_by_id?: string;
+    filed_at: string;
+    /** Deliberator (agent instance_id or a sweeper session), or null. */
+    claimed_by?: string | null;
+    /** Set when escalated to a council. */
+    council_id?: string | null;
+    resolution?: DecisionResolution | null;
+    review?: DecisionReview | null;
+    /** Where the resolved output graduated (e.g. "docs/decisions.md#…"), or null. */
+    graduated_to?: string | null;
+    /** Set when superseded by another decision. */
+    superseded_by?: string | null;
+    /** Reason recorded on wontfix. */
+    wontfix_reason?: string | null;
+    updated_at?: string;
+    [extra: string]: unknown;
+}
+export interface DecisionOpResult {
+    ok: boolean;
+    reason?: string;
+    manifest?: DecisionManifest;
+}
+export declare function isTier(n: unknown): n is DecisionTier;
+export declare function isStakes(s: unknown): s is DecisionStakes;
+export declare function isStatus(s: unknown): s is DecisionStatus;
+export declare function isVerdict(v: unknown): v is ReviewVerdict;
+export declare function isTerminal(status: DecisionStatus): boolean;
+export declare function canTransition(from: DecisionStatus, to: DecisionStatus): boolean;
+export declare function decisionsDir(coordRoot: string): string;
+export declare function archiveDir(coordRoot: string): string;
+export declare function manifestPath(coordRoot: string, id: string): string;
+export declare function archivedManifestPath(coordRoot: string, id: string): string;
+export declare function decisionBodyDir(coordRoot: string, id: string): string;
+/**
+ * Kebab-case slug from question text: first 5 words, lowercased,
+ * non-alphanumerics stripped. Local (not imported from council) so the module
+ * stays standalone.
+ */
+export declare function deriveSlug(question: string): string;
+/**
+ * Build a decision_id: `<slug>-<YYYY-MM-DD>-<4hex>`. The hex suffix is
+ * crypto-random (not a hash of the question) so two decisions sharing a
+ * slug + date don't collide.
+ */
+export declare function buildDecisionId(question: string, now?: Date): string;
+/**
+ * Read a manifest by id, checking the active dir then the archive. Returns null
+ * if absent or unparseable. Throws on an unsupported schema_version (fail loud
+ * on a real-but-incompatible manifest, the way councils do).
+ */
+export declare function readManifest(coordRoot: string, id: string): DecisionManifest | null;
+export declare function writeManifest(coordRoot: string, manifest: DecisionManifest): void;
+export interface FileDecisionInput {
+    question: string;
+    tier: DecisionTier;
+    stakes: DecisionStakes;
+    context?: string;
+    defaultTaken?: string;
+    filedBy?: string;
+    filedById?: string;
+    /** Long-form brief written to `<id>/brief.md`. */
+    brief?: string;
+    now?: Date;
+}
+export declare function fileDecision(coordRoot: string, input: FileDecisionInput): DecisionOpResult;
+export declare function triageDecision(coordRoot: string, id: string, opts: {
+    tier?: DecisionTier;
+    stakes?: DecisionStakes;
+}): DecisionOpResult;
+export declare function claimDecision(coordRoot: string, id: string, owner: string): DecisionOpResult;
+export declare function escalateToCouncil(coordRoot: string, id: string, councilId: string): DecisionOpResult;
+/**
+ * Resolve a decision. Evidence is required (≥1 citation): a resolution with no
+ * cited evidence is structurally incomplete and bounced here — the same guard
+ * the sweeper enforces.
+ */
+export declare function resolveDecision(coordRoot: string, id: string, resolution: Omit<DecisionResolution, "resolved_at"> & {
+    resolved_at?: string;
+}): DecisionOpResult;
+export declare function enactDecision(coordRoot: string, id: string): DecisionOpResult;
+export declare function reviewDecision(coordRoot: string, id: string, opts: {
+    verdict: ReviewVerdict;
+    note?: string;
+}): DecisionOpResult;
+export declare function supersedeDecision(coordRoot: string, id: string, bySupersedingId?: string): DecisionOpResult;
+export declare function wontfixDecision(coordRoot: string, id: string, reason?: string): DecisionOpResult;
+/**
+ * Archive a decision (terminal). Records where its output graduated, then moves
+ * manifest + body dir into `archive/`. Idempotent-ish: safe to re-run.
+ */
+export declare function archiveDecision(coordRoot: string, id: string, graduatedTo?: string): DecisionOpResult;
+/**
+ * Reopen an archived decision back to `reviewed` — the inverse of `archive`,
+ * and the one sanctioned way out of the (otherwise terminal) archived state.
+ * Since `archived` has no legal outgoing transition, this deliberately bypasses
+ * the `transition` guard, the same way `archive` does its file moves outside it.
+ * Moves the manifest + body dir back from `archive/` into the active dir and
+ * clears `graduated_to` (a re-archive sets it fresh). Only `archived` decisions
+ * reopen; `superseded`/`wontfix` stay terminal.
+ *
+ * Ordering is write-active-then-remove-archived so an interrupted call leaves
+ * the decision reopened (active copy wins in `readManifest`) rather than lost.
+ */
+export declare function reopenDecision(coordRoot: string, id: string): DecisionOpResult;
+export interface ListFilter {
+    status?: DecisionStatus;
+    tier?: DecisionTier;
+    stakes?: DecisionStakes;
+    /** Only non-terminal decisions (the live queue). */
+    openOnly?: boolean;
+    /** Include the archive dir in the scan (default: active only). */
+    includeArchived?: boolean;
+}
+export declare function listDecisions(coordRoot: string, filter?: ListFilter): DecisionManifest[];
+export interface DecisionDetail {
+    manifest: DecisionManifest;
+    bodies: {
+        name: string;
+        content: string;
+    }[];
+    archived: boolean;
+}
+export declare function showDecision(coordRoot: string, id: string): DecisionDetail | null;
+export interface SearchHit {
+    manifest: DecisionManifest;
+    /** A short surrounding snippet of the first match. */
+    snippet: string;
+    /** Where the match landed. */
+    where: "question" | "context" | "resolution" | "body";
+}
+/**
+ * Case-insensitive substring search over manifests + bodies. Deliberately
+ * dumb: precedent recall depends on the host's decision skill running this before
+ * filing, not on ranking sophistication. Includes the archive (precedent
+ * lives there).
+ */
+export declare function searchDecisions(coordRoot: string, query: string): SearchHit[];
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/decision/index.d.ts.map

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