@rubric-protocol/evidence 1.0.0

package/dist/adapters.d.ts

@@ -0,0 +1,6 @@
+import type { EvidenceIndex, StorePort } from "./ports.js";
+/** Index reader backed by the read-only SQLite day-shards under `indexDir`. */
+export declare function openIndexReader(indexDir: string): EvidenceIndex;
+/** Store reader over `storeDir`; a row's bundlePath is relative to it. */
+export declare function openStoreReader(storeDir: string): StorePort;
+//# sourceMappingURL=adapters.d.ts.map

package/dist/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAoB,MAAM,YAAY,CAAC;AAE7E,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAM/D;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAkB3D"}

package/dist/adapters.js

@@ -0,0 +1,37 @@
+/**
+ * Offline adapters (tasks/P5.md): read the SQLite index shards (read-only) and
+ * the bundle-store files directly — no network, no HCS, no payment.
+ */
+import { readFileSync } from "node:fs";
+import { isAbsolute, relative, resolve, sep } from "node:path";
+import { Index } from "@rubric-protocol/attest-index";
+/** Index reader backed by the read-only SQLite day-shards under `indexDir`. */
+export function openIndexReader(indexDir) {
+    const index = new Index(indexDir, { readonly: true });
+    return {
+        byAgentRange: (agentId, from, to) => index.byAgentRange(agentId, from, to),
+        close: () => index.close(),
+    };
+}
+/** Store reader over `storeDir`; a row's bundlePath is relative to it. */
+export function openStoreReader(storeDir) {
+    const root = resolve(storeDir);
+    return {
+        get(bundlePath) {
+            // Contain reads within storeDir — a hostile bundlePath ("../…") must not
+            // escape the store (path-traversal / arbitrary file read).
+            const full = resolve(root, bundlePath);
+            const rel = relative(root, full);
+            if (rel === ".." || rel.startsWith(".." + sep) || isAbsolute(rel)) {
+                return undefined;
+            }
+            try {
+                return JSON.parse(readFileSync(full, "utf8"));
+            }
+            catch {
+                return undefined;
+            }
+        },
+    };
+}
+//# sourceMappingURL=adapters.js.map

package/dist/adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAGtD,+EAA+E;AAC/E,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,OAAO;QACL,YAAY,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;QAC1E,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE;KAC3B,CAAC;AACJ,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/B,OAAO;QACL,GAAG,CAAC,UAAkB;YACpB,yEAAyE;YACzE,2DAA2D;YAC3D,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YACvC,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACjC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClE,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,IAAI,CAAC;gBACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAqB,CAAC;YACpE,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/bundle.d.ts

@@ -0,0 +1,11 @@
+import type { EvidenceBundle, EvidenceIndex, IndexRow, SchemaEpoch, StorePort } from "./ports.js";
+/** Consecutive-run epochs of schemaHash across ordered rows. */
+export declare function buildSchemaChangeLog(rows: IndexRow[]): SchemaEpoch[];
+export interface AssembleOptions {
+    agent: string;
+    from: string;
+    to: string;
+    generatedAt: string;
+}
+export declare function assembleEvidence(index: EvidenceIndex, store: StorePort, opts: AssembleOptions): EvidenceBundle;
+//# sourceMappingURL=bundle.d.ts.map

package/dist/bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../src/bundle.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAEV,cAAc,EACd,aAAa,EACb,QAAQ,EACR,WAAW,EACX,SAAS,EACV,MAAM,YAAY,CAAC;AAEpB,gEAAgE;AAChE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,WAAW,EAAE,CAWpE;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,eAAe,GACpB,cAAc,CAqBhB"}

package/dist/bundle.js

@@ -0,0 +1,41 @@
+/**
+ * Assemble an evidence bundle (tasks/P5.md): DARs + proofs + anchor refs for an
+ * agent over a ts range, a continuity report (reusing @rubric-protocol/verify chainCheck,
+ * so forks render as branches and gaps as gaps), and a schema-change log.
+ */
+import { chainCheck } from "@rubric-protocol/verify";
+/** Consecutive-run epochs of schemaHash across ordered rows. */
+export function buildSchemaChangeLog(rows) {
+    const log = [];
+    for (const r of rows) {
+        const last = log[log.length - 1];
+        if (last && last.schemaHash === r.schemaHash) {
+            last.count++;
+        }
+        else {
+            log.push({ schemaHash: r.schemaHash, fromDecisionId: r.decisionId, fromTs: r.ts, count: 1 });
+        }
+    }
+    return log;
+}
+export function assembleEvidence(index, store, opts) {
+    const rows = index.byAgentRange(opts.agent, opts.from, opts.to);
+    const decisions = rows.map((r) => {
+        const bundle = store.get(r.bundlePath);
+        if (!bundle) {
+            throw new Error(`evidence: bundle missing for ${r.decisionId} at ${r.bundlePath}`);
+        }
+        return bundle;
+    });
+    return {
+        version: "rubric-evidence/0.1",
+        agent: opts.agent,
+        range: { from: opts.from, to: opts.to },
+        generatedAt: opts.generatedAt,
+        decisionCount: decisions.length,
+        decisions,
+        continuity: chainCheck(opts.agent, rows),
+        schemaChangeLog: buildSchemaChangeLog(rows),
+    };
+}
+//# sourceMappingURL=bundle.js.map

package/dist/bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.js","sourceRoot":"","sources":["../src/bundle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAUrD,gEAAgE;AAChE,MAAM,UAAU,oBAAoB,CAAC,IAAgB;IACnD,MAAM,GAAG,GAAkB,EAAE,CAAC;IAC9B,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACjC,IAAI,IAAI,IAAI,IAAI,CAAC,UAAU,KAAK,CAAC,CAAC,UAAU,EAAE,CAAC;YAC7C,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,cAAc,EAAE,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAC/F,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AASD,MAAM,UAAU,gBAAgB,CAC9B,KAAoB,EACpB,KAAgB,EAChB,IAAqB;IAErB,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IAEhE,MAAM,SAAS,GAAuB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACnD,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC,UAAU,OAAO,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;QACrF,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE,qBAAqB;QAC9B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE;QACvC,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,aAAa,EAAE,SAAS,CAAC,MAAM;QAC/B,SAAS;QACT,UAAU,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC;QACxC,eAAe,EAAE,oBAAoB,CAAC,IAAI,CAAC;KAC5C,CAAC;AACJ,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+/**
+ * CLI (tasks/P5.md):
+ *   rubric-evidence export --agent <id> --index <dir> --store <dir> \
+ *     [--from <ts>] [--to <ts>] [--out <file>] [--summary <file>]
+ *
+ * Writes the JSON evidence bundle (to --out or stdout) and the plain-text
+ * summary (to --summary or stderr). Runs offline against the index shards.
+ */
+import { writeFileSync } from "node:fs";
+import { parseArgs } from "node:util";
+import { openIndexReader, openStoreReader } from "./adapters.js";
+import { exportEvidence } from "./export.js";
+const MIN_TS = "0000-01-01T00:00:00.000Z";
+const MAX_TS = "9999-12-31T23:59:59.999Z";
+function usage() {
+    process.stderr.write("usage: rubric-evidence export --agent <id> --index <dir> --store <dir> " +
+        "[--from <ts>] [--to <ts>] [--out <file>] [--summary <file>]\n");
+    process.exit(2);
+}
+function main(argv) {
+    const { values } = parseArgs({
+        args: argv,
+        options: {
+            agent: { type: "string" },
+            from: { type: "string" },
+            to: { type: "string" },
+            index: { type: "string" },
+            store: { type: "string" },
+            out: { type: "string" },
+            summary: { type: "string" },
+            "generated-at": { type: "string" },
+        },
+    });
+    if (!values.agent || !values.index || !values.store)
+        usage();
+    const index = openIndexReader(values.index);
+    try {
+        const { bundle, summary } = exportEvidence(index, openStoreReader(values.store), {
+            agent: values.agent,
+            from: values.from ?? MIN_TS,
+            to: values.to ?? MAX_TS,
+            generatedAt: values["generated-at"] ?? new Date().toISOString(),
+        });
+        const json = JSON.stringify(bundle, null, 2) + "\n";
+        if (values.out)
+            writeFileSync(values.out, json);
+        else
+            process.stdout.write(json);
+        if (values.summary)
+            writeFileSync(values.summary, summary);
+        else
+            process.stderr.write("\n" + summary);
+    }
+    finally {
+        index.close?.();
+    }
+}
+// Support the `export` subcommand verb: `rubric-evidence export --agent ...`.
+const args = process.argv.slice(2);
+main(args[0] === "export" ? args.slice(1) : args);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,MAAM,GAAG,0BAA0B,CAAC;AAC1C,MAAM,MAAM,GAAG,0BAA0B,CAAC;AAE1C,SAAS,KAAK;IACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,yEAAyE;QACvE,+DAA+D,CAClE,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,IAAI,CAAC,IAAc;IAC1B,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;QAC3B,IAAI,EAAE,IAAI;QACV,OAAO,EAAE;YACP,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACtB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACvB,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC3B,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SACnC;KACF,CAAC,CAAC;IAEH,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,KAAK;QAAE,KAAK,EAAE,CAAC;IAE7D,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5C,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,cAAc,CAAC,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;YAC/E,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,MAAM;YAC3B,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,MAAM;YACvB,WAAW,EAAE,MAAM,CAAC,cAAc,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SAChE,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;QACpD,IAAI,MAAM,CAAC,GAAG;YAAE,aAAa,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;;YAC3C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEhC,IAAI,MAAM,CAAC,OAAO;YAAE,aAAa,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;;YACtD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC;IAC5C,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;IAClB,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC"}

package/dist/export.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Export orchestration: assemble the evidence bundle and render its plain-text
+ * summary together (tasks/P5.md).
+ */
+import { type AssembleOptions } from "./bundle.js";
+import type { EvidenceBundle, EvidenceIndex, StorePort } from "./ports.js";
+export interface ExportResult {
+    bundle: EvidenceBundle;
+    summary: string;
+}
+export declare function exportEvidence(index: EvidenceIndex, store: StorePort, opts: AssembleOptions): ExportResult;
+//# sourceMappingURL=export.d.ts.map

package/dist/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../src/export.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAoB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAErE,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE3E,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,eAAe,GACpB,YAAY,CAGd"}

package/dist/export.js

@@ -0,0 +1,11 @@
+/**
+ * Export orchestration: assemble the evidence bundle and render its plain-text
+ * summary together (tasks/P5.md).
+ */
+import { assembleEvidence } from "./bundle.js";
+import { renderSummary } from "./summary.js";
+export function exportEvidence(index, store, opts) {
+    const bundle = assembleEvidence(index, store, opts);
+    return { bundle, summary: renderSummary(bundle) };
+}
+//# sourceMappingURL=export.js.map

package/dist/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../src/export.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,gBAAgB,EAAwB,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAQ7C,MAAM,UAAU,cAAc,CAC5B,KAAoB,EACpB,KAAgB,EAChB,IAAqB;IAErB,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IACpD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;AACpD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @rubric-protocol/evidence — offline evidence export (tasks/P5.md).
+ *
+ * Assembles a JSON evidence bundle (DARs, proofs, anchor refs, continuity
+ * report, schema-change log) plus a plain-text summary, reading the SQLite index
+ * shards and bundle store directly (no network). Exposed as the CLI
+ * `rubric-evidence export`.
+ */
+export { exportEvidence, type ExportResult } from "./export.js";
+export { assembleEvidence, buildSchemaChangeLog, type AssembleOptions } from "./bundle.js";
+export { renderSummary } from "./summary.js";
+export { openIndexReader, openStoreReader } from "./adapters.js";
+export type { EvidenceBundle, EvidenceIndex, StorePort, DecisionEvidence, SchemaEpoch, ContinuityReport, IndexRow, VerifiableBundle, } from "./ports.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACjE,YAAY,EACV,cAAc,EACd,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * @rubric-protocol/evidence — offline evidence export (tasks/P5.md).
+ *
+ * Assembles a JSON evidence bundle (DARs, proofs, anchor refs, continuity
+ * report, schema-change log) plus a plain-text summary, reading the SQLite index
+ * shards and bundle store directly (no network). Exposed as the CLI
+ * `rubric-evidence export`.
+ */
+export { exportEvidence } from "./export.js";
+export { assembleEvidence, buildSchemaChangeLog } from "./bundle.js";
+export { renderSummary } from "./summary.js";
+export { openIndexReader, openStoreReader } from "./adapters.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,cAAc,EAAqB,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAwB,MAAM,aAAa,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/ports.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Ports for evidence export (tasks/P5.md). The assembly logic depends only on
+ * these, so tests inject mocks and the CLI injects real adapters that read the
+ * SQLite index shards + bundle-store files offline.
+ */
+import type { IndexRow, StorePort, VerifiableBundle, ContinuityReport } from "@rubric-protocol/verify";
+export type { IndexRow, StorePort, VerifiableBundle, ContinuityReport };
+/** Index reader: an agent's rows within a ts range, ordered (ts, decisionId). */
+export interface EvidenceIndex {
+    byAgentRange(agentId: string, fromTs: string, toTs: string): IndexRow[];
+    close?(): void;
+}
+/** One decision's evidence: the DAR plus its proof, anchor ref, and signature. */
+export type DecisionEvidence = VerifiableBundle;
+/** A schema epoch: a run of consecutive decisions under one schemaHash. */
+export interface SchemaEpoch {
+    schemaHash: string;
+    fromDecisionId: string;
+    fromTs: string;
+    count: number;
+}
+export interface EvidenceBundle {
+    version: "rubric-evidence/0.1";
+    agent: string;
+    range: {
+        from: string;
+        to: string;
+    };
+    generatedAt: string;
+    decisionCount: number;
+    decisions: DecisionEvidence[];
+    continuity: ContinuityReport;
+    schemaChangeLog: SchemaEpoch[];
+}
+//# sourceMappingURL=ports.d.ts.map

package/dist/ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../src/ports.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEvG,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;AAExE,iFAAiF;AACjF,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,CAAC;IACxE,KAAK,CAAC,IAAI,IAAI,CAAC;CAChB;AAED,kFAAkF;AAClF,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,CAAC;AAEhD,2EAA2E;AAC3E,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,qBAAqB,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,UAAU,EAAE,gBAAgB,CAAC;IAC7B,eAAe,EAAE,WAAW,EAAE,CAAC;CAChC"}

package/dist/ports.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ports.js.map

package/dist/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../src/ports.ts"],"names":[],"mappings":""}

package/dist/summary.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Plain-text summary of an evidence bundle (tasks/P5.md). Deterministic — every
+ * line is derived from bundle fields, so it is stable for golden comparison.
+ */
+import type { EvidenceBundle } from "./ports.js";
+export declare function renderSummary(bundle: EvidenceBundle): string;
+//# sourceMappingURL=summary.d.ts.map

package/dist/summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../src/summary.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAwC5D"}

package/dist/summary.js

@@ -0,0 +1,38 @@
+export function renderSummary(bundle) {
+    const lines = [];
+    lines.push("Rubric Decision Evidence");
+    lines.push(`  version:   ${bundle.version}`);
+    lines.push(`  agent:     ${bundle.agent}`);
+    lines.push(`  range:     ${bundle.range.from} .. ${bundle.range.to}`);
+    lines.push(`  generated: ${bundle.generatedAt}`);
+    lines.push(`  decisions: ${bundle.decisionCount}`);
+    const c = bundle.continuity;
+    const shape = c.linear
+        ? "linear"
+        : [
+            c.branches.length ? `${c.branches.length} fork(s)` : "",
+            c.gaps.length ? `${c.gaps.length} gap(s)` : "",
+        ]
+            .filter(Boolean)
+            .join(", ") || "non-linear";
+    lines.push("");
+    lines.push(`Continuity: ${shape} (tampering: ${c.tampering})`);
+    lines.push(`  genesis: ${c.genesis.join(", ") || "(none)"}`);
+    lines.push(`  heads:   ${c.heads.join(", ") || "(none)"}`);
+    for (const b of c.branches) {
+        lines.push(`  fork at ${b.parent} -> ${b.children.join(", ")}`);
+    }
+    for (const g of c.gaps) {
+        lines.push(`  gap: ${g.decisionId} references missing ${g.missingPrev}`);
+    }
+    lines.push("");
+    lines.push(`Schema epochs: ${bundle.schemaChangeLog.length}`);
+    for (const e of bundle.schemaChangeLog) {
+        lines.push(`  ${e.schemaHash} from ${e.fromDecisionId} @ ${e.fromTs} (${e.count} decision(s))`);
+    }
+    const anchors = new Set(bundle.decisions.map((d) => `${d.anchorRef.network}:${d.anchorRef.topicId}`));
+    lines.push("");
+    lines.push(`Anchors: ${[...anchors].sort().join(", ") || "(none)"}`);
+    return lines.join("\n") + "\n";
+}
+//# sourceMappingURL=summary.js.map

package/dist/summary.js.map

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

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@rubric-protocol/evidence",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Rubric evidence export CLI: offline evidence bundles from index shards + bundle store",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/0xsims/rubric-attest.git",
+    "directory": "packages/evidence"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "development": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "rubric-evidence": "./dist/cli.js"
+  },
+  "files": ["dist", "src"],
+  "publishConfig": { "access": "public" },
+  "scripts": {
+    "prepublishOnly": "npm run build",
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@rubric-protocol/attest-decision": "^1.0.0",
+    "@rubric-protocol/attest-index": "^1.0.0",
+    "@rubric-protocol/verify": "^1.0.0"
+  }
+}

package/src/adapters.ts

@@ -0,0 +1,38 @@
+/**
+ * Offline adapters (tasks/P5.md): read the SQLite index shards (read-only) and
+ * the bundle-store files directly — no network, no HCS, no payment.
+ */
+import { readFileSync } from "node:fs";
+import { isAbsolute, relative, resolve, sep } from "node:path";
+import { Index } from "@rubric-protocol/attest-index";
+import type { EvidenceIndex, StorePort, VerifiableBundle } from "./ports.js";
+
+/** Index reader backed by the read-only SQLite day-shards under `indexDir`. */
+export function openIndexReader(indexDir: string): EvidenceIndex {
+  const index = new Index(indexDir, { readonly: true });
+  return {
+    byAgentRange: (agentId, from, to) => index.byAgentRange(agentId, from, to),
+    close: () => index.close(),
+  };
+}
+
+/** Store reader over `storeDir`; a row's bundlePath is relative to it. */
+export function openStoreReader(storeDir: string): StorePort {
+  const root = resolve(storeDir);
+  return {
+    get(bundlePath: string): VerifiableBundle | undefined {
+      // Contain reads within storeDir — a hostile bundlePath ("../…") must not
+      // escape the store (path-traversal / arbitrary file read).
+      const full = resolve(root, bundlePath);
+      const rel = relative(root, full);
+      if (rel === ".." || rel.startsWith(".." + sep) || isAbsolute(rel)) {
+        return undefined;
+      }
+      try {
+        return JSON.parse(readFileSync(full, "utf8")) as VerifiableBundle;
+      } catch {
+        return undefined;
+      }
+    },
+  };
+}

package/src/bundle.ts

@@ -0,0 +1,62 @@
+/**
+ * Assemble an evidence bundle (tasks/P5.md): DARs + proofs + anchor refs for an
+ * agent over a ts range, a continuity report (reusing @rubric-protocol/verify chainCheck,
+ * so forks render as branches and gaps as gaps), and a schema-change log.
+ */
+import { chainCheck } from "@rubric-protocol/verify";
+import type {
+  DecisionEvidence,
+  EvidenceBundle,
+  EvidenceIndex,
+  IndexRow,
+  SchemaEpoch,
+  StorePort,
+} from "./ports.js";
+
+/** Consecutive-run epochs of schemaHash across ordered rows. */
+export function buildSchemaChangeLog(rows: IndexRow[]): SchemaEpoch[] {
+  const log: SchemaEpoch[] = [];
+  for (const r of rows) {
+    const last = log[log.length - 1];
+    if (last && last.schemaHash === r.schemaHash) {
+      last.count++;
+    } else {
+      log.push({ schemaHash: r.schemaHash, fromDecisionId: r.decisionId, fromTs: r.ts, count: 1 });
+    }
+  }
+  return log;
+}
+
+export interface AssembleOptions {
+  agent: string;
+  from: string;
+  to: string;
+  generatedAt: string;
+}
+
+export function assembleEvidence(
+  index: EvidenceIndex,
+  store: StorePort,
+  opts: AssembleOptions,
+): EvidenceBundle {
+  const rows = index.byAgentRange(opts.agent, opts.from, opts.to);
+
+  const decisions: DecisionEvidence[] = rows.map((r) => {
+    const bundle = store.get(r.bundlePath);
+    if (!bundle) {
+      throw new Error(`evidence: bundle missing for ${r.decisionId} at ${r.bundlePath}`);
+    }
+    return bundle;
+  });
+
+  return {
+    version: "rubric-evidence/0.1",
+    agent: opts.agent,
+    range: { from: opts.from, to: opts.to },
+    generatedAt: opts.generatedAt,
+    decisionCount: decisions.length,
+    decisions,
+    continuity: chainCheck(opts.agent, rows),
+    schemaChangeLog: buildSchemaChangeLog(rows),
+  };
+}

package/src/cli.ts

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+/**
+ * CLI (tasks/P5.md):
+ *   rubric-evidence export --agent <id> --index <dir> --store <dir> \
+ *     [--from <ts>] [--to <ts>] [--out <file>] [--summary <file>]
+ *
+ * Writes the JSON evidence bundle (to --out or stdout) and the plain-text
+ * summary (to --summary or stderr). Runs offline against the index shards.
+ */
+import { writeFileSync } from "node:fs";
+import { parseArgs } from "node:util";
+import { openIndexReader, openStoreReader } from "./adapters.js";
+import { exportEvidence } from "./export.js";
+
+const MIN_TS = "0000-01-01T00:00:00.000Z";
+const MAX_TS = "9999-12-31T23:59:59.999Z";
+
+function usage(): never {
+  process.stderr.write(
+    "usage: rubric-evidence export --agent <id> --index <dir> --store <dir> " +
+      "[--from <ts>] [--to <ts>] [--out <file>] [--summary <file>]\n",
+  );
+  process.exit(2);
+}
+
+function main(argv: string[]): void {
+  const { values } = parseArgs({
+    args: argv,
+    options: {
+      agent: { type: "string" },
+      from: { type: "string" },
+      to: { type: "string" },
+      index: { type: "string" },
+      store: { type: "string" },
+      out: { type: "string" },
+      summary: { type: "string" },
+      "generated-at": { type: "string" },
+    },
+  });
+
+  if (!values.agent || !values.index || !values.store) usage();
+
+  const index = openIndexReader(values.index);
+  try {
+    const { bundle, summary } = exportEvidence(index, openStoreReader(values.store), {
+      agent: values.agent,
+      from: values.from ?? MIN_TS,
+      to: values.to ?? MAX_TS,
+      generatedAt: values["generated-at"] ?? new Date().toISOString(),
+    });
+
+    const json = JSON.stringify(bundle, null, 2) + "\n";
+    if (values.out) writeFileSync(values.out, json);
+    else process.stdout.write(json);
+
+    if (values.summary) writeFileSync(values.summary, summary);
+    else process.stderr.write("\n" + summary);
+  } finally {
+    index.close?.();
+  }
+}
+
+// Support the `export` subcommand verb: `rubric-evidence export --agent ...`.
+const args = process.argv.slice(2);
+main(args[0] === "export" ? args.slice(1) : args);

package/src/export.ts

@@ -0,0 +1,21 @@
+/**
+ * Export orchestration: assemble the evidence bundle and render its plain-text
+ * summary together (tasks/P5.md).
+ */
+import { assembleEvidence, type AssembleOptions } from "./bundle.js";
+import { renderSummary } from "./summary.js";
+import type { EvidenceBundle, EvidenceIndex, StorePort } from "./ports.js";
+
+export interface ExportResult {
+  bundle: EvidenceBundle;
+  summary: string;
+}
+
+export function exportEvidence(
+  index: EvidenceIndex,
+  store: StorePort,
+  opts: AssembleOptions,
+): ExportResult {
+  const bundle = assembleEvidence(index, store, opts);
+  return { bundle, summary: renderSummary(bundle) };
+}

package/src/index.ts

@@ -0,0 +1,22 @@
+/**
+ * @rubric-protocol/evidence — offline evidence export (tasks/P5.md).
+ *
+ * Assembles a JSON evidence bundle (DARs, proofs, anchor refs, continuity
+ * report, schema-change log) plus a plain-text summary, reading the SQLite index
+ * shards and bundle store directly (no network). Exposed as the CLI
+ * `rubric-evidence export`.
+ */
+export { exportEvidence, type ExportResult } from "./export.js";
+export { assembleEvidence, buildSchemaChangeLog, type AssembleOptions } from "./bundle.js";
+export { renderSummary } from "./summary.js";
+export { openIndexReader, openStoreReader } from "./adapters.js";
+export type {
+  EvidenceBundle,
+  EvidenceIndex,
+  StorePort,
+  DecisionEvidence,
+  SchemaEpoch,
+  ContinuityReport,
+  IndexRow,
+  VerifiableBundle,
+} from "./ports.js";

package/src/ports.ts

@@ -0,0 +1,36 @@
+/**
+ * Ports for evidence export (tasks/P5.md). The assembly logic depends only on
+ * these, so tests inject mocks and the CLI injects real adapters that read the
+ * SQLite index shards + bundle-store files offline.
+ */
+import type { IndexRow, StorePort, VerifiableBundle, ContinuityReport } from "@rubric-protocol/verify";
+
+export type { IndexRow, StorePort, VerifiableBundle, ContinuityReport };
+
+/** Index reader: an agent's rows within a ts range, ordered (ts, decisionId). */
+export interface EvidenceIndex {
+  byAgentRange(agentId: string, fromTs: string, toTs: string): IndexRow[];
+  close?(): void;
+}
+
+/** One decision's evidence: the DAR plus its proof, anchor ref, and signature. */
+export type DecisionEvidence = VerifiableBundle;
+
+/** A schema epoch: a run of consecutive decisions under one schemaHash. */
+export interface SchemaEpoch {
+  schemaHash: string;
+  fromDecisionId: string;
+  fromTs: string;
+  count: number;
+}
+
+export interface EvidenceBundle {
+  version: "rubric-evidence/0.1";
+  agent: string;
+  range: { from: string; to: string };
+  generatedAt: string;
+  decisionCount: number;
+  decisions: DecisionEvidence[];
+  continuity: ContinuityReport;
+  schemaChangeLog: SchemaEpoch[];
+}

package/src/summary.ts

@@ -0,0 +1,47 @@
+/**
+ * Plain-text summary of an evidence bundle (tasks/P5.md). Deterministic — every
+ * line is derived from bundle fields, so it is stable for golden comparison.
+ */
+import type { EvidenceBundle } from "./ports.js";
+
+export function renderSummary(bundle: EvidenceBundle): string {
+  const lines: string[] = [];
+  lines.push("Rubric Decision Evidence");
+  lines.push(`  version:   ${bundle.version}`);
+  lines.push(`  agent:     ${bundle.agent}`);
+  lines.push(`  range:     ${bundle.range.from} .. ${bundle.range.to}`);
+  lines.push(`  generated: ${bundle.generatedAt}`);
+  lines.push(`  decisions: ${bundle.decisionCount}`);
+
+  const c = bundle.continuity;
+  const shape = c.linear
+    ? "linear"
+    : [
+        c.branches.length ? `${c.branches.length} fork(s)` : "",
+        c.gaps.length ? `${c.gaps.length} gap(s)` : "",
+      ]
+        .filter(Boolean)
+        .join(", ") || "non-linear";
+  lines.push("");
+  lines.push(`Continuity: ${shape} (tampering: ${c.tampering})`);
+  lines.push(`  genesis: ${c.genesis.join(", ") || "(none)"}`);
+  lines.push(`  heads:   ${c.heads.join(", ") || "(none)"}`);
+  for (const b of c.branches) {
+    lines.push(`  fork at ${b.parent} -> ${b.children.join(", ")}`);
+  }
+  for (const g of c.gaps) {
+    lines.push(`  gap: ${g.decisionId} references missing ${g.missingPrev}`);
+  }
+
+  lines.push("");
+  lines.push(`Schema epochs: ${bundle.schemaChangeLog.length}`);
+  for (const e of bundle.schemaChangeLog) {
+    lines.push(`  ${e.schemaHash} from ${e.fromDecisionId} @ ${e.fromTs} (${e.count} decision(s))`);
+  }
+
+  const anchors = new Set(bundle.decisions.map((d) => `${d.anchorRef.network}:${d.anchorRef.topicId}`));
+  lines.push("");
+  lines.push(`Anchors: ${[...anchors].sort().join(", ") || "(none)"}`);
+
+  return lines.join("\n") + "\n";
+}