@lannguyensi/harness 0.5.0

package/dist/cli/apply/generate-settings.js

@@ -0,0 +1,87 @@
+// Inverse of `src/cli/adopt/derive.ts#parseSettingsHooks`: turn the manifest's
+// `hooks[]` into the nested Claude Code settings.json shape that `harness apply`
+// writes to `harness.generated/settings.json`. Pure function, no I/O.
+//
+// Output shape (matches Claude Code's settings.json `hooks` section):
+//
+//   { hooks: { <EventName>: [ { matcher?, hooks: [{ type, command, timeout? }] } ] } }
+//
+// Field decisions for v1 (per ARCHITECTURE §5 + Phase 3 #2 task scope):
+//   - `type: "command"` is always emitted explicitly. Claude Code accepts
+//     missing `type` (it defaults to "command") but explicit is friendlier
+//     to humans diffing the file.
+//   - `matcher` is omitted when the manifest hook has no `match`. Hooks with
+//     a match string emit a `matcher` field with that exact string. Regex
+//     metacharacters are passed through unchanged.
+//   - `timeout` is always emitted (the manifest's `budget_ms` is always set
+//     after schema-defaulting). Always-emit is the conservative choice
+//     against an unknown runtime default; an explicit value is consumed
+//     identically whether or not the runtime would have defaulted to it.
+//   - `path_match` and `bash_match` are NOT projected. Claude Code's
+//     settings.json `matcher` filters only on the tool name, so there is
+//     no native settings.json field for "additional filter when this hook
+//     fires". Per the canonical example in ARCHITECTURE.md Appendix A
+//     (e.g. `require-preflight-evidence` with `bash_match: "^git ..."`),
+//     these filters are enforced inside the referenced hook script, not by
+//     harness's wiring. The manifest fields are documentation: they tell
+//     `harness validate`/`doctor` what the script claims to filter on, so
+//     the script's behaviour can be cross-checked, but `harness apply`
+//     does not synthesise wrapper shell to enforce them. Wrapping was
+//     considered and rejected: it (a) doubles the surface for hook bugs,
+//     (b) hard-codes shell semantics into the manifest projection, and
+//     (c) the canonical hook scripts already enforce these filters.
+//   - `blocking` is harness-internal: it tells `validate`/`doctor` how to
+//     classify a hook for soft/hard-failure reporting. Claude Code's
+//     settings.json has no documented equivalent (verified against the
+//     ecosystem as of 2026-04 — revisit if a runtime field appears), so
+//     it does NOT survive the projection.
+//
+// Stable-output rules (load-bearing for byte-equivalent regeneration on a
+// no-op apply):
+//   - Event keys sorted ascending by name (insertion order in the JSON
+//     object reflects this; JSON.stringify preserves it).
+//   - Within an event, groups sorted by (matcher, command).
+//   - Within a group, the inner hooks[] preserves matcher-grouping order
+//     and is sorted by command for the same reason.
+export const DEFAULT_BUDGET_MS = 30_000;
+export function generateSettings(manifest) {
+    const byEvent = new Map();
+    for (const h of manifest.hooks) {
+        const list = byEvent.get(h.event) ?? [];
+        list.push(h);
+        byEvent.set(h.event, list);
+    }
+    const out = { hooks: {} };
+    const eventNames = [...byEvent.keys()].sort();
+    for (const event of eventNames) {
+        const hooks = byEvent.get(event) ?? [];
+        out.hooks[event] = buildGroups(hooks);
+    }
+    return out;
+}
+function buildGroups(hooks) {
+    // Group by exact `match` value. Unmatched hooks share the empty-string
+    // bucket and emit a group without a `matcher` field.
+    const byMatcher = new Map();
+    for (const h of hooks) {
+        const key = h.match ?? "";
+        const list = byMatcher.get(key) ?? [];
+        list.push(h);
+        byMatcher.set(key, list);
+    }
+    const matcherKeys = [...byMatcher.keys()].sort();
+    const groups = [];
+    for (const key of matcherKeys) {
+        const groupHooks = byMatcher.get(key) ?? [];
+        const inner = [...groupHooks]
+            .sort((a, b) => (a.command < b.command ? -1 : a.command > b.command ? 1 : 0))
+            .map(toSettingsCommand);
+        const group = key === "" ? { hooks: inner } : { matcher: key, hooks: inner };
+        groups.push(group);
+    }
+    return groups;
+}
+function toSettingsCommand(h) {
+    return { type: "command", command: h.command, timeout: h.budget_ms };
+}
+//# sourceMappingURL=generate-settings.js.map

package/dist/cli/apply/generate-settings.js.map

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

package/dist/cli/apply/index.d.ts

@@ -0,0 +1 @@
+export { apply, DRIFT_HINT_MESSAGE, GENERATED_DIRNAME, MANIFEST_BASENAME, MEMORY_BASENAME, SETTINGS_BASENAME, type ApplyOptions, type ApplyOutcome, type ApplyResult, type FileApplyOutcome, } from "./apply.js";

package/dist/cli/apply/index.js

@@ -0,0 +1,2 @@
+export { apply, DRIFT_HINT_MESSAGE, GENERATED_DIRNAME, MANIFEST_BASENAME, MEMORY_BASENAME, SETTINGS_BASENAME, } from "./apply.js";
+//# sourceMappingURL=index.js.map

package/dist/cli/apply/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/apply/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,GAKlB,MAAM,YAAY,CAAC"}

package/dist/cli/audit.d.ts

@@ -0,0 +1,36 @@
+import { type LedgerQueryResult } from "../policies/index.js";
+import { type PolicyDecisionPayload } from "../runtime/ledger-record.js";
+import { type LoaderOptions } from "./loader.js";
+export type AuditOutcome = PolicyDecisionPayload["outcome"];
+export interface AuditOptions extends LoaderOptions {
+    json?: boolean;
+    since?: string;
+    policy?: string;
+    outcome?: AuditOutcome;
+    sessionId?: string;
+    /**
+     * Override the ledger fetcher (tests). The optional `filters` arg
+     * carries the Phase 5 #5 server-side narrowing hints (sinceIso,
+     * contentPrefix); test fakes can ignore it without consequence.
+     */
+    fetchLedger?: (sessionId: string, filters?: {
+        sinceIso?: string;
+        contentPrefix?: string;
+    }) => Promise<LedgerQueryResult>;
+    /** Override "now" (tests). */
+    now?: Date;
+}
+export interface AuditDecisionRow {
+    timestamp: string;
+    name: string;
+    outcome: AuditOutcome;
+    enforcement: PolicyDecisionPayload["enforcement"];
+    reason: string;
+    ledgerTag: string;
+    extractValues: Record<string, string>;
+}
+export interface AuditResult {
+    output: string;
+    decisions: AuditDecisionRow[];
+}
+export declare function audit(opts?: AuditOptions): Promise<AuditResult>;

package/dist/cli/audit.js

@@ -0,0 +1,121 @@
+import { parseDurationSeconds, parseLedgerTimestamp, queryLedgerByTag, } from "../policies/index.js";
+import { decisionSortKey, decodeLedgerContent, } from "../runtime/ledger-record.js";
+import { resolveSessionId } from "../runtime/session-id.js";
+import { EX_UNAVAILABLE, EX_USAGE, HarnessExitError } from "./exit-codes.js";
+import { loadManifest } from "./loader.js";
+const DEFAULT_SINCE = "24h";
+const VALID_OUTCOMES = ["allow", "deny", "warn-degraded"];
+function isValidOutcome(v) {
+    return VALID_OUTCOMES.includes(v);
+}
+function defaultFetcher(opts) {
+    return async (sessionId, filters) => {
+        const { manifest } = loadManifest(opts);
+        const server = manifest.tools.mcp.find((m) => m.name === "grounding-mcp");
+        if (!server) {
+            return { kind: "degraded", reason: "grounding-mcp not declared in manifest" };
+        }
+        const command = Array.isArray(server.command)
+            ? server.command
+            : server.command.trim().split(/\s+/);
+        return queryLedgerByTag({
+            mcpCommand: command,
+            ...(server.env && { mcpEnv: server.env }),
+            sessionId,
+            timeoutMs: server.health?.timeout_ms ?? 5_000,
+            ...(filters?.sinceIso !== undefined && { sinceIso: filters.sinceIso }),
+            ...(filters?.contentPrefix !== undefined && { contentPrefix: filters.contentPrefix }),
+        });
+    };
+}
+function rowsFromEntries(entries) {
+    // Decode + retain the entry/payload pair so we can sort by Phase 5 #9's
+    // ms-precision `evaluatedAt` before flattening to the display row. The
+    // displayed `timestamp` field stays the ledger's `createdAt` (which is
+    // what users see in the table); only the sort key changes.
+    const decoded = [];
+    for (const entry of entries) {
+        const payload = decodeLedgerContent(entry.content);
+        if (!payload)
+            continue;
+        decoded.push({ entry, payload });
+    }
+    decoded.sort((a, b) => decisionSortKey(a.entry, a.payload) - decisionSortKey(b.entry, b.payload));
+    return decoded.map(({ entry, payload }) => ({
+        timestamp: typeof entry.createdAt === "string"
+            ? entry.createdAt
+            : entry.createdAt.toISOString(),
+        name: payload.name,
+        outcome: payload.outcome,
+        enforcement: payload.enforcement,
+        reason: payload.reason,
+        ledgerTag: payload.ledgerTag,
+        extractValues: payload.extractValues,
+    }));
+}
+function formatTable(rows) {
+    if (rows.length === 0)
+        return "";
+    const header = ["timestamp", "policy", "outcome", "reason"];
+    // Reasons are normally single-line; flatten just in case so the column
+    // alignment doesn't break on a newline buried in a future policy's reason.
+    const flatten = (s) => s.replace(/\s+/g, " ").trim();
+    const data = rows.map((r) => [r.timestamp, r.name, r.outcome, flatten(r.reason)]);
+    const widths = header.map((h, i) => Math.max(h.length, ...data.map((row) => row[i].length)));
+    const fmt = (cells) => cells.map((c, i) => c.padEnd(widths[i])).join("  ").trimEnd();
+    const lines = [];
+    lines.push(fmt(header));
+    lines.push(widths.map((w) => "-".repeat(w)).join("  ").trimEnd());
+    for (const row of data)
+        lines.push(fmt(row));
+    return `${lines.join("\n")}\n`;
+}
+export async function audit(opts = {}) {
+    const since = opts.since ?? DEFAULT_SINCE;
+    let windowSeconds;
+    try {
+        windowSeconds = parseDurationSeconds(since);
+    }
+    catch (err) {
+        throw new HarnessExitError(`--since: ${err.message}`, EX_USAGE);
+    }
+    if (opts.outcome !== undefined && !isValidOutcome(opts.outcome)) {
+        throw new HarnessExitError(`--outcome: must be one of allow, deny, warn-degraded (got "${opts.outcome}")`, EX_USAGE);
+    }
+    const sessionId = resolveSessionId(opts.sessionId);
+    const fetch = opts.fetchLedger ?? defaultFetcher(opts);
+    // Phase 5 #5 — push filters server-side when the connected
+    // grounding-mcp supports them (capability-detected by
+    // queryLedgerByTag via tools/list). The audit's own client-side
+    // filter math at line ~165 is preserved verbatim, so an old server
+    // ignoring these args still produces the correct table.
+    const now = opts.now ?? new Date();
+    const cutoffMs = now.getTime() - windowSeconds * 1000;
+    const sinceIso = new Date(cutoffMs).toISOString();
+    const result = await fetch(sessionId, {
+        sinceIso,
+        contentPrefix: "policy_decision:",
+    });
+    if (result.kind === "degraded") {
+        throw new HarnessExitError(`ledger unreachable: ${result.reason}`, EX_UNAVAILABLE);
+    }
+    const all = rowsFromEntries(result.entries);
+    let filtered = all.filter((r) => parseLedgerTimestamp(r.timestamp) >= cutoffMs);
+    if (opts.policy) {
+        filtered = filtered.filter((r) => r.name === opts.policy);
+    }
+    if (opts.outcome) {
+        filtered = filtered.filter((r) => r.outcome === opts.outcome);
+    }
+    if (filtered.length === 0) {
+        const output = opts.json
+            ? `${JSON.stringify({ decisions: [] }, null, 2)}\n`
+            : `no policy decisions in the last ${since}\n`;
+        return { output, decisions: [] };
+    }
+    const output = opts.json
+        ? `${JSON.stringify({ decisions: filtered }, null, 2)}\n`
+        : formatTable(filtered);
+    return { output, decisions: filtered };
+}
+//# sourceMappingURL=audit.js.map

package/dist/cli/audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../src/cli/audit.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,GAGjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,eAAe,EACf,mBAAmB,GAEpB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAsB,MAAM,aAAa,CAAC;AAE/D,MAAM,aAAa,GAAG,KAAK,CAAC;AAsC5B,MAAM,cAAc,GAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC;AAE1E,SAAS,cAAc,CAAC,CAAS;IAC/B,OAAQ,cAA2B,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,cAAc,CAAC,IAAkB;IACxC,OAAO,KAAK,EACV,SAAiB,EACjB,OAAuD,EAC3B,EAAE;QAC9B,MAAM,EAAE,QAAQ,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC;QAC1E,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,wCAAwC,EAAE,CAAC;QAChF,CAAC;QACD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;YAC3C,CAAC,CAAC,MAAM,CAAC,OAAO;YAChB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACvC,OAAO,gBAAgB,CAAC;YACtB,UAAU,EAAE,OAAO;YACnB,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC;YACzC,SAAS;YACT,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,IAAI,KAAK;YAC7C,GAAG,CAAC,OAAO,EAAE,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;YACtE,GAAG,CAAC,OAAO,EAAE,aAAa,KAAK,SAAS,IAAI,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC;SACtF,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,OAAsB;IAC7C,wEAAwE;IACxE,uEAAuE;IACvE,uEAAuE;IACvE,2DAA2D;IAC3D,MAAM,OAAO,GAA6D,EAAE,CAAC;IAC7E,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,CAAC,IAAI,CACV,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,CACpF,CAAC;IACF,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QAC1C,SAAS,EACP,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;YACjC,CAAC,CAAC,KAAK,CAAC,SAAS;YACjB,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE;QACnC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,aAAa,EAAE,OAAO,CAAC,aAAa;KACrC,CAAC,CAAC,CAAC;AACN,CAAC;AAED,SAAS,WAAW,CAAC,IAAwB;IAC3C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,MAAM,MAAM,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC5D,uEAAuE;IACvE,2EAA2E;IAC3E,MAAM,OAAO,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACrE,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAClF,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACjC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC,MAAM,CAAC,CAAC,CACzD,CAAC;IACF,MAAM,GAAG,GAAG,CAAC,KAAe,EAAU,EAAE,CACtC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;IACjE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACxB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAClE,KAAK,MAAM,GAAG,IAAI,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7C,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,OAAqB,EAAE;IACjD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,aAAa,CAAC;IAC1C,IAAI,aAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,aAAa,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,gBAAgB,CACxB,YAAa,GAAa,CAAC,OAAO,EAAE,EACpC,QAAQ,CACT,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,gBAAgB,CACxB,8DAA8D,IAAI,CAAC,OAAO,IAAI,EAC9E,QAAQ,CACT,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;IACvD,2DAA2D;IAC3D,sDAAsD;IACtD,gEAAgE;IAChE,mEAAmE;IACnE,wDAAwD;IACxD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;IACnC,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,aAAa,GAAG,IAAI,CAAC;IACtD,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IAClD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,SAAS,EAAE;QACpC,QAAQ;QACR,aAAa,EAAE,kBAAkB;KAClC,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,MAAM,IAAI,gBAAgB,CACxB,uBAAuB,MAAM,CAAC,MAAM,EAAE,EACtC,cAAc,CACf,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC,CAAC;IAChF,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC;IAChE,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI;YACtB,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI;YACnD,CAAC,CAAC,mCAAmC,KAAK,IAAI,CAAC;QACjD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IACnC,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI;QACtB,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI;QACzD,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC1B,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;AACzC,CAAC"}

package/dist/cli/describe.d.ts

@@ -0,0 +1,13 @@
+import type { Manifest } from "../schema/index.js";
+import { type LoaderOptions } from "./loader.js";
+export type Pillar = "grounding" | "tools" | "memory" | "hooks" | "policies";
+export declare function isPillar(value: string): value is Pillar;
+export interface DescribeOptions extends LoaderOptions {
+    pillar?: Pillar;
+    json?: boolean;
+}
+export interface DescribeResult {
+    output: string;
+    manifest: Manifest;
+}
+export declare function describe(opts?: DescribeOptions): DescribeResult;

package/dist/cli/describe.js

@@ -0,0 +1,26 @@
+import { stringify as stringifyYaml } from "yaml";
+import { loadManifest } from "./loader.js";
+const PILLARS = [
+    "grounding",
+    "tools",
+    "memory",
+    "hooks",
+    "policies",
+];
+export function isPillar(value) {
+    return PILLARS.includes(value);
+}
+function projectPillar(manifest, pillar) {
+    return { version: manifest.version, [pillar]: manifest[pillar] };
+}
+export function describe(opts = {}) {
+    const { manifest } = loadManifest(opts);
+    const projection = opts.pillar
+        ? projectPillar(manifest, opts.pillar)
+        : manifest;
+    const output = opts.json
+        ? JSON.stringify(projection, null, 2)
+        : stringifyYaml(projection, { lineWidth: 0 });
+    return { output, manifest };
+}
+//# sourceMappingURL=describe.js.map

package/dist/cli/describe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe.js","sourceRoot":"","sources":["../../src/cli/describe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,MAAM,CAAC;AAElD,OAAO,EAAE,YAAY,EAAsB,MAAM,aAAa,CAAC;AAI/D,MAAM,OAAO,GAAsB;IACjC,WAAW;IACX,OAAO;IACP,QAAQ;IACR,OAAO;IACP,UAAU;CACX,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,OAAQ,OAA6B,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC;AAYD,SAAS,aAAa,CAAC,QAAkB,EAAE,MAAc;IACvD,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAwB,EAAE;IACjD,MAAM,EAAE,QAAQ,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,UAAU,GAA4B,IAAI,CAAC,MAAM;QACrD,CAAC,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC;QACtC,CAAC,CAAE,QAA+C,CAAC;IAErD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI;QACtB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;QACrC,CAAC,CAAC,aAAa,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;IAEhD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAC9B,CAAC"}

package/dist/cli/diff/engine.d.ts

@@ -0,0 +1,21 @@
+export type ChangeKind = "added" | "removed" | "modified";
+export interface Change {
+    kind: ChangeKind;
+    path: string;
+    before?: unknown;
+    after?: unknown;
+}
+declare function isNameKeyedList(arr: unknown[]): arr is Array<Record<string, unknown> & {
+    name: string;
+}>;
+declare function fmtPath(parts: Array<string | number>): string;
+export declare function diffManifests(before: unknown, after: unknown): Change[];
+declare function pillarOf(changePath: string): string;
+export declare function groupByPillar(changes: Change[]): Map<string, Change[]>;
+export declare function formatDiff(changes: Change[]): string;
+export declare const __testables: {
+    isNameKeyedList: typeof isNameKeyedList;
+    fmtPath: typeof fmtPath;
+    pillarOf: typeof pillarOf;
+};
+export {};

package/dist/cli/diff/engine.js

@@ -0,0 +1,161 @@
+const PILLAR_ORDER = ["version", "grounding", "tools", "memory", "hooks", "policies"];
+function isPlainObject(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function isNameKeyedList(arr) {
+    if (arr.length === 0)
+        return false;
+    return arr.every((item) => isPlainObject(item) && typeof item.name === "string");
+}
+function fmtPath(parts) {
+    let out = "";
+    for (const p of parts) {
+        if (typeof p === "number") {
+            out += `[${p}]`;
+        }
+        else if (out === "") {
+            out = p;
+        }
+        else {
+            out += `.${p}`;
+        }
+    }
+    return out;
+}
+function fmtPathWithName(parts) {
+    let out = "";
+    for (const p of parts) {
+        if (typeof p === "number") {
+            out += `[${p}]`;
+        }
+        else if (typeof p === "object") {
+            out += `[${p.name}]`;
+        }
+        else if (out === "") {
+            out = p;
+        }
+        else {
+            out += `.${p}`;
+        }
+    }
+    return out;
+}
+function diffArrays(before, after, pathParts, out) {
+    const beforeNamed = isNameKeyedList(before);
+    const afterNamed = isNameKeyedList(after);
+    if (beforeNamed && afterNamed) {
+        const byName = new Map();
+        for (const item of before)
+            byName.set(item.name, item);
+        const seen = new Set();
+        for (const item of after) {
+            const prev = byName.get(item.name);
+            seen.add(item.name);
+            if (!prev) {
+                out.push({ kind: "added", path: fmtPathWithName([...pathParts, { name: item.name }]), after: item });
+            }
+            else {
+                diffValue(prev, item, [...pathParts, { name: item.name }], out);
+            }
+        }
+        for (const [name, item] of byName) {
+            if (!seen.has(name)) {
+                out.push({ kind: "removed", path: fmtPathWithName([...pathParts, { name }]), before: item });
+            }
+        }
+        return;
+    }
+    if (JSON.stringify(before) !== JSON.stringify(after)) {
+        out.push({ kind: "modified", path: fmtPathWithName(pathParts), before, after });
+    }
+}
+function diffObjects(before, after, pathParts, out) {
+    const keys = new Set([...Object.keys(before), ...Object.keys(after)]);
+    for (const key of keys) {
+        const a = before[key];
+        const b = after[key];
+        if (a === undefined && b !== undefined) {
+            out.push({ kind: "added", path: fmtPathWithName([...pathParts, key]), after: b });
+        }
+        else if (b === undefined && a !== undefined) {
+            out.push({ kind: "removed", path: fmtPathWithName([...pathParts, key]), before: a });
+        }
+        else if (!equal(a, b)) {
+            diffValue(a, b, [...pathParts, key], out);
+        }
+    }
+}
+function equal(a, b) {
+    return JSON.stringify(a) === JSON.stringify(b);
+}
+function diffValue(before, after, pathParts, out) {
+    if (equal(before, after))
+        return;
+    if (Array.isArray(before) && Array.isArray(after)) {
+        diffArrays(before, after, pathParts, out);
+        return;
+    }
+    if (isPlainObject(before) && isPlainObject(after)) {
+        diffObjects(before, after, pathParts, out);
+        return;
+    }
+    out.push({ kind: "modified", path: fmtPathWithName(pathParts), before, after });
+}
+export function diffManifests(before, after) {
+    const out = [];
+    diffValue(before, after, [], out);
+    return out;
+}
+function pillarOf(changePath) {
+    for (const pillar of PILLAR_ORDER) {
+        if (changePath === pillar || changePath.startsWith(`${pillar}.`) || changePath.startsWith(`${pillar}[`)) {
+            return pillar;
+        }
+    }
+    return "(other)";
+}
+export function groupByPillar(changes) {
+    const out = new Map();
+    for (const pillar of PILLAR_ORDER)
+        out.set(pillar, []);
+    out.set("(other)", []);
+    for (const c of changes) {
+        const p = pillarOf(c.path);
+        out.get(p).push(c);
+    }
+    for (const [k, v] of out)
+        if (v.length === 0)
+            out.delete(k);
+    return out;
+}
+function renderValue(v) {
+    if (typeof v === "string")
+        return v;
+    return JSON.stringify(v);
+}
+export function formatDiff(changes) {
+    if (changes.length === 0)
+        return "no changes\n";
+    const lines = [];
+    const grouped = groupByPillar(changes);
+    for (const [pillar, group] of grouped) {
+        lines.push(`## ${pillar}`);
+        for (const c of group) {
+            switch (c.kind) {
+                case "added":
+                    lines.push(`+ ${c.path}: ${renderValue(c.after)}`);
+                    break;
+                case "removed":
+                    lines.push(`- ${c.path}: ${renderValue(c.before)}`);
+                    break;
+                case "modified":
+                    lines.push(`~ ${c.path}: ${renderValue(c.before)} → ${renderValue(c.after)}`);
+                    break;
+            }
+        }
+        lines.push("");
+    }
+    return `${lines.join("\n")}`;
+}
+export const __testables = { isNameKeyedList, fmtPath, pillarOf };
+//# sourceMappingURL=engine.js.map

package/dist/cli/diff/engine.js.map

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

package/dist/cli/diff/git.d.ts

@@ -0,0 +1,6 @@
+export interface GitContext {
+    root: string;
+    manifestRelPath: string;
+}
+export declare function locateGitContext(manifestPath: string): GitContext;
+export declare function readManifestAtRef(ctx: GitContext, ref: string): string;

package/dist/cli/diff/git.js

@@ -0,0 +1,32 @@
+import { execFileSync } from "node:child_process";
+import * as path from "node:path";
+import { EX_UNAVAILABLE, EX_USAGE, HarnessExitError } from "../exit-codes.js";
+function runGit(args, cwd) {
+    return execFileSync("git", args, {
+        cwd,
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "pipe"],
+    });
+}
+export function locateGitContext(manifestPath) {
+    const dir = path.dirname(path.resolve(manifestPath));
+    let root;
+    try {
+        root = runGit(["rev-parse", "--show-toplevel"], dir).trim();
+    }
+    catch (err) {
+        throw new HarnessExitError(`git is not available or ${dir} is not inside a git work tree: ${err.message.trim()}`, EX_UNAVAILABLE);
+    }
+    const relPath = path.relative(root, path.resolve(manifestPath));
+    return { root, manifestRelPath: relPath };
+}
+export function readManifestAtRef(ctx, ref) {
+    try {
+        return runGit(["show", `${ref}:${ctx.manifestRelPath}`], ctx.root);
+    }
+    catch (err) {
+        const message = err.stderr?.trim() || err.message;
+        throw new HarnessExitError(`cannot read ${ctx.manifestRelPath} at git ref "${ref}": ${message}`, EX_USAGE);
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/cli/diff/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../../src/cli/diff/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAO9E,SAAS,MAAM,CAAC,IAAc,EAAE,GAAW;IACzC,OAAO,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE;QAC/B,GAAG;QACH,QAAQ,EAAE,MAAM;QAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;KAClC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,YAAoB;IACnD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;IACrD,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,CAAC,CAAC,WAAW,EAAE,iBAAiB,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,gBAAgB,CACxB,2BAA2B,GAAG,mCAAoC,GAAa,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,EAChG,cAAc,CACf,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;IAChE,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAe,EAAE,GAAW;IAC5D,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,GAAG,CAAC,eAAe,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IACrE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAI,GAAmC,CAAC,MAAM,EAAE,IAAI,EAAE,IAAK,GAAa,CAAC,OAAO,CAAC;QAC9F,MAAM,IAAI,gBAAgB,CACxB,eAAe,GAAG,CAAC,eAAe,gBAAgB,GAAG,MAAM,OAAO,EAAE,EACpE,QAAQ,CACT,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/cli/diff/index.d.ts

@@ -0,0 +1,15 @@
+import { type Manifest } from "../../schema/index.js";
+import { type LoaderOptions } from "../loader.js";
+import { type Change } from "./engine.js";
+export interface DiffOptions extends LoaderOptions {
+    since?: string;
+}
+export interface DiffResult {
+    changes: Change[];
+    output: string;
+    before: Manifest;
+    after: Manifest;
+}
+export declare function diff(opts: DiffOptions): DiffResult;
+export { diffManifests, formatDiff } from "./engine.js";
+export type { Change, ChangeKind } from "./engine.js";

package/dist/cli/diff/index.js

@@ -0,0 +1,39 @@
+import { parse as parseYaml } from "yaml";
+import { ManifestParseError, parseManifest } from "../../schema/index.js";
+import { EX_NOINPUT, EX_USAGE, HarnessExitError } from "../exit-codes.js";
+import { loadManifest, resolvePaths } from "../loader.js";
+import { diffManifests, formatDiff } from "./engine.js";
+import { locateGitContext, readManifestAtRef } from "./git.js";
+function parseRefManifest(raw) {
+    let parsed;
+    try {
+        parsed = parseYaml(raw);
+    }
+    catch (err) {
+        throw new HarnessExitError(`manifest at git ref is not valid YAML: ${err.message}`, EX_NOINPUT);
+    }
+    try {
+        return parseManifest(parsed);
+    }
+    catch (err) {
+        if (err instanceof ManifestParseError) {
+            throw new HarnessExitError(`manifest at git ref failed schema validation:\n${err.message}`, EX_NOINPUT);
+        }
+        throw err;
+    }
+}
+export function diff(opts) {
+    if (!opts.since) {
+        throw new HarnessExitError("harness diff requires --since <ref>; --since-apply lands in Phase 3", EX_USAGE);
+    }
+    const resolved = resolvePaths(opts);
+    const ctx = locateGitContext(resolved.base);
+    const refRaw = readManifestAtRef(ctx, opts.since);
+    const before = parseRefManifest(refRaw);
+    const { manifest: after } = loadManifest(opts);
+    const changes = diffManifests(before, after);
+    const output = formatDiff(changes);
+    return { changes, output, before, after };
+}
+export { diffManifests, formatDiff } from "./engine.js";
+//# sourceMappingURL=index.js.map

package/dist/cli/diff/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/diff/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAiB,MAAM,uBAAuB,CAAC;AACzF,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,YAAY,EAAsB,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,UAAU,EAAe,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAa/D,SAAS,gBAAgB,CAAC,GAAW;IACnC,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,gBAAgB,CACxB,0CAA2C,GAAa,CAAC,OAAO,EAAE,EAClE,UAAU,CACX,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,kBAAkB,EAAE,CAAC;YACtC,MAAM,IAAI,gBAAgB,CACxB,kDAAkD,GAAG,CAAC,OAAO,EAAE,EAC/D,UAAU,CACX,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,IAAiB;IACpC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,gBAAgB,CACxB,qEAAqE,EACrE,QAAQ,CACT,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACnC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC5C,CAAC;AAED,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}