@forestrie/forestrie-cli 0.8.0

package/dist/lib/decode-receipt-decode.js.map

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

package/dist/lib/decode-receipt-labels.d.ts

@@ -0,0 +1,54 @@
+/**
+ * COSE / forestrie header label registry for `forestrie decode-receipt`
+ * (FOR-346). Naming only — decoding never requires a label to be known,
+ * and unknown labels are always shown raw, never dropped.
+ *
+ * Sources: RFC 9052 (COSE headers), RFC 9597 (CWT claims header 15),
+ * RFC 8392 (CWT claim keys), draft-ietf-cose-merkle-tree-proofs
+ * (395 vds / 396 verifiable proofs), and the forestrie private-use
+ * labels (canopy grants.md, ADR-0046, plan-0033 format v3,
+ * `@forestrie/receipt-verify` forest-genesis-labels).
+ */
+/** CBOR tag for COSE_Sign1 (RFC 9052 §2). */
+export declare const COSE_SIGN1_TAG = 18;
+/** Verifiable proofs unprotected header (draft-ietf-cose-merkle-tree-proofs). */
+export declare const VERIFIABLE_PROOFS_LABEL = 396;
+/** Verifiable data structure protected header (draft-ietf-cose-merkle-tree-proofs). */
+export declare const VDS_LABEL = 395;
+/** CWT claims in a COSE header (RFC 9597). */
+export declare const CWT_CLAIMS_LABEL = 15;
+/** Delegation certificate — Custodian per-log delegation, nested COSE_Sign1. */
+export declare const DELEGATION_CERT_LABEL = 1000;
+/** Pre-signed peak inclusion receipts on a checkpoint (`SealPeakReceiptsLabel`). */
+export declare const SEAL_PEAK_RECEIPTS_LABEL = -65931;
+/** Inclusion proofs key inside header 396. */
+export declare const PROOFS_INCLUSION_KEY = -1;
+/** Consistency proofs key inside header 396. */
+export declare const PROOFS_CONSISTENCY_KEY = -2;
+export type LabelInfo = {
+    name: string;
+    /** Short provenance / meaning note for human output. */
+    note?: string;
+};
+/** COSE header labels (protected and unprotected share the number space). */
+export declare const HEADER_LABELS: ReadonlyMap<number, LabelInfo>;
+/** COSE algorithm names (RFC 9053 + forestrie private-use). */
+export declare const ALG_NAMES: ReadonlyMap<number, string>;
+/**
+ * Verifiable data structure ids (draft-ietf-cose-merkle-tree-proofs
+ * registry). 3 is NOT a registered codepoint: draft-bryce-cose-merkle-
+ * mountain-range-proofs requests TBD_1 (registration pending), and 3 is
+ * only the value our test fixtures use — production emitters do not emit
+ * header 395 at all. Render it as the draft's unregistered codepoint,
+ * never as registry fact (F7, plan-2607-14 W1.5).
+ */
+export declare const VDS_NAMES: ReadonlyMap<number, string>;
+/** CWT claim keys (RFC 8392 §3.1, cnf per RFC 8747). */
+export declare const CWT_CLAIM_NAMES: ReadonlyMap<number, string>;
+/** COSE_Key parameter names (RFC 9052 §7) — for cnf / ephemeral keys. */
+export declare const COSE_KEY_PARAM_NAMES: ReadonlyMap<number, string>;
+/** Keys inside header 396 (draft-ietf-cose-merkle-tree-proofs). */
+export declare const PROOF_KIND_NAMES: ReadonlyMap<number, string>;
+/** Look up a header label name; null when unknown (caller shows it raw). */
+export declare function headerLabelInfo(label: number): LabelInfo | null;
+//# sourceMappingURL=decode-receipt-labels.d.ts.map

package/dist/lib/decode-receipt-labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode-receipt-labels.d.ts","sourceRoot":"","sources":["../../src/lib/decode-receipt-labels.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,6CAA6C;AAC7C,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC,iFAAiF;AACjF,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,uFAAuF;AACvF,eAAO,MAAM,SAAS,MAAM,CAAC;AAC7B,8CAA8C;AAC9C,eAAO,MAAM,gBAAgB,KAAK,CAAC;AACnC,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAC1C,oFAAoF;AACpF,eAAO,MAAM,wBAAwB,SAAS,CAAC;AAE/C,8CAA8C;AAC9C,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,gDAAgD;AAChD,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAqCvD,CAAC;AAEH,+DAA+D;AAC/D,eAAO,MAAM,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAMhD,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAIhD,CAAC;AAEH,wDAAwD;AACxD,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAStD,CAAC;AAEH,yEAAyE;AACzE,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAO3D,CAAC;AAEH,mEAAmE;AACnE,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAGvD,CAAC;AAEH,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAE/D"}

package/dist/lib/decode-receipt-labels.js

@@ -0,0 +1,117 @@
+/**
+ * COSE / forestrie header label registry for `forestrie decode-receipt`
+ * (FOR-346). Naming only — decoding never requires a label to be known,
+ * and unknown labels are always shown raw, never dropped.
+ *
+ * Sources: RFC 9052 (COSE headers), RFC 9597 (CWT claims header 15),
+ * RFC 8392 (CWT claim keys), draft-ietf-cose-merkle-tree-proofs
+ * (395 vds / 396 verifiable proofs), and the forestrie private-use
+ * labels (canopy grants.md, ADR-0046, plan-0033 format v3,
+ * `@forestrie/receipt-verify` forest-genesis-labels).
+ */
+/** CBOR tag for COSE_Sign1 (RFC 9052 §2). */
+export const COSE_SIGN1_TAG = 18;
+/** Verifiable proofs unprotected header (draft-ietf-cose-merkle-tree-proofs). */
+export const VERIFIABLE_PROOFS_LABEL = 396;
+/** Verifiable data structure protected header (draft-ietf-cose-merkle-tree-proofs). */
+export const VDS_LABEL = 395;
+/** CWT claims in a COSE header (RFC 9597). */
+export const CWT_CLAIMS_LABEL = 15;
+/** Delegation certificate — Custodian per-log delegation, nested COSE_Sign1. */
+export const DELEGATION_CERT_LABEL = 1000;
+/** Pre-signed peak inclusion receipts on a checkpoint (`SealPeakReceiptsLabel`). */
+export const SEAL_PEAK_RECEIPTS_LABEL = -65931;
+/** Inclusion proofs key inside header 396. */
+export const PROOFS_INCLUSION_KEY = -1;
+/** Consistency proofs key inside header 396. */
+export const PROOFS_CONSISTENCY_KEY = -2;
+/** COSE header labels (protected and unprotected share the number space). */
+export const HEADER_LABELS = new Map([
+    [1, { name: "alg" }],
+    [2, { name: "crit" }],
+    [3, { name: "content type" }],
+    [4, { name: "kid" }],
+    [5, { name: "IV" }],
+    [6, { name: "partial IV" }],
+    [CWT_CLAIMS_LABEL, { name: "CWT claims", note: "RFC 9597" }],
+    [
+        VDS_LABEL,
+        { name: "verifiable data structure", note: "COSE receipts (draft)" },
+    ],
+    [
+        VERIFIABLE_PROOFS_LABEL,
+        { name: "verifiable proofs", note: "COSE receipts (draft)" },
+    ],
+    [
+        DELEGATION_CERT_LABEL,
+        {
+            name: "delegation certificate",
+            note: "forestrie: Custodian per-log delegation (nested COSE_Sign1)",
+        },
+    ],
+    [-65537, { name: "idtimestamp", note: "forestrie private-use" }],
+    [-65538, { name: "forestrie grant v0", note: "forestrie private-use" }],
+    [
+        SEAL_PEAK_RECEIPTS_LABEL,
+        {
+            name: "pre-signed peak receipts",
+            note: "forestrie SealPeakReceiptsLabel (checkpoint header)",
+        },
+    ],
+    [-68009, { name: "forest genesis version", note: "forestrie private-use" }],
+    [-68011, { name: "univocity address", note: "forestrie private-use" }],
+    [-68013, { name: "chain id", note: "forestrie private-use" }],
+    [-68014, { name: "forest genesis alg", note: "forestrie private-use" }],
+    [-68015, { name: "bootstrap key", note: "forestrie private-use" }],
+]);
+/** COSE algorithm names (RFC 9053 + forestrie private-use). */
+export const ALG_NAMES = new Map([
+    [-7, "ES256 (ECDSA P-256 + SHA-256)"],
+    [-8, "EdDSA"],
+    [-35, "ES384"],
+    [-36, "ES512"],
+    [-65799, "KS256 (secp256k1 + Keccak-256, forestrie private-use)"],
+]);
+/**
+ * Verifiable data structure ids (draft-ietf-cose-merkle-tree-proofs
+ * registry). 3 is NOT a registered codepoint: draft-bryce-cose-merkle-
+ * mountain-range-proofs requests TBD_1 (registration pending), and 3 is
+ * only the value our test fixtures use — production emitters do not emit
+ * header 395 at all. Render it as the draft's unregistered codepoint,
+ * never as registry fact (F7, plan-2607-14 W1.5).
+ */
+export const VDS_NAMES = new Map([
+    [1, "RFC9162_SHA256 (Certificate Transparency)"],
+    [2, "CCF_LEDGER_SHA256"],
+    [3, "MMR profile (draft-bryce, codepoint TBD)"],
+]);
+/** CWT claim keys (RFC 8392 §3.1, cnf per RFC 8747). */
+export const CWT_CLAIM_NAMES = new Map([
+    [1, "iss"],
+    [2, "sub"],
+    [3, "aud"],
+    [4, "exp"],
+    [5, "nbf"],
+    [6, "iat"],
+    [7, "cti"],
+    [8, "cnf (confirmation / ephemeral key)"],
+]);
+/** COSE_Key parameter names (RFC 9052 §7) — for cnf / ephemeral keys. */
+export const COSE_KEY_PARAM_NAMES = new Map([
+    [1, "kty"],
+    [2, "kid"],
+    [3, "alg"],
+    [-1, "crv"],
+    [-2, "x"],
+    [-3, "y"],
+]);
+/** Keys inside header 396 (draft-ietf-cose-merkle-tree-proofs). */
+export const PROOF_KIND_NAMES = new Map([
+    [PROOFS_INCLUSION_KEY, "inclusion proofs"],
+    [PROOFS_CONSISTENCY_KEY, "consistency proofs"],
+]);
+/** Look up a header label name; null when unknown (caller shows it raw). */
+export function headerLabelInfo(label) {
+    return HEADER_LABELS.get(label) ?? null;
+}
+//# sourceMappingURL=decode-receipt-labels.js.map

package/dist/lib/decode-receipt-labels.js.map

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

package/dist/lib/decode-receipt-render.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Human rendering for `forestrie decode-receipt` (FOR-346).
+ *
+ * The demo money-shot: an annotated tree that makes the receipt legible
+ * to an audience — it's just COSE (Sign1 + MMR inclusion). Works purely
+ * from the display model so `--json` and the tree always agree.
+ */
+import type { DecodedReceipt } from "./decode-receipt-decode.js";
+/** Render the receipt as the annotated human tree. */
+export declare function renderReceipt(receipt: DecodedReceipt): string;
+//# sourceMappingURL=decode-receipt-render.d.ts.map

package/dist/lib/decode-receipt-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode-receipt-render.d.ts","sourceRoot":"","sources":["../../src/lib/decode-receipt-render.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAEV,cAAc,EAEf,MAAM,4BAA4B,CAAC;AA+MpC,sDAAsD;AACtD,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CA+D7D"}

package/dist/lib/decode-receipt-render.js

@@ -0,0 +1,242 @@
+/**
+ * Human rendering for `forestrie decode-receipt` (FOR-346).
+ *
+ * The demo money-shot: an annotated tree that makes the receipt legible
+ * to an audience — it's just COSE (Sign1 + MMR inclusion). Works purely
+ * from the display model so `--json` and the tree always agree.
+ */
+import { CWT_CLAIMS_LABEL, DELEGATION_CERT_LABEL, PROOF_KIND_NAMES, SEAL_PEAK_RECEIPTS_LABEL, VDS_LABEL, VERIFIABLE_PROOFS_LABEL, } from "./decode-receipt-labels.js";
+/** Shorten `h'…'` / hex strings for tree display; JSON keeps full bytes. */
+function shortHex(hex, keepBytes = 8) {
+    const byteLength = hex.length / 2;
+    if (byteLength <= keepBytes * 2)
+        return hex;
+    return `${hex.slice(0, keepBytes * 2)}…${hex.slice(-4)}`;
+}
+function describeJson(value) {
+    if (typeof value === "string") {
+        const bytes = /^h'([0-9a-f]*)'$/.exec(value);
+        if (bytes) {
+            const hex = bytes[1] ?? "";
+            return `${shortHex(hex)} (${hex.length / 2} bytes)`;
+        }
+        return JSON.stringify(value);
+    }
+    if (value === null)
+        return "null";
+    if (typeof value === "number" || typeof value === "boolean") {
+        return String(value);
+    }
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return "[]";
+        return `array of ${value.length}`;
+    }
+    return `map of ${Object.keys(value).length}`;
+}
+function labelPrefix(entry) {
+    return entry.name !== null
+        ? `${entry.label} (${entry.name})`
+        : `${entry.label} (unknown label)`;
+}
+/** Render one unprotected 396 verifiable-proofs map as sub-lines. */
+function proofLines(value, receipt, depth) {
+    const lines = [];
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        lines.push({ depth, text: describeJson(value) });
+        return lines;
+    }
+    for (const [key, entry] of Object.entries(value)) {
+        const kind = PROOF_KIND_NAMES.get(Number(key));
+        const head = kind ? `${key} (${kind})` : `${key} (unknown proof kind)`;
+        if (Number(key) === -1) {
+            // Inclusion proofs — expand from the verified summary.
+            lines.push({ depth, text: `${head}: 1 entry` });
+            lines.push({
+                depth: depth + 1,
+                text: `1 (mmr index): ${receipt.inclusion.mmrIndex}`,
+            });
+            lines.push({
+                depth: depth + 1,
+                text: `2 (path): ${receipt.inclusion.pathLength} × 32-byte hashes`,
+            });
+            for (const [i, hash] of receipt.inclusion.path.entries()) {
+                lines.push({ depth: depth + 2, text: `[${i}] ${shortHex(hash)}` });
+            }
+            continue;
+        }
+        lines.push({ depth, text: `${head}: ${describeJson(entry)}` });
+    }
+    return lines;
+}
+function unprotectedLines(entry, receipt, depth) {
+    if (entry.label === VERIFIABLE_PROOFS_LABEL) {
+        return [
+            { depth, text: `${labelPrefix(entry)}:` },
+            ...proofLines(entry.value, receipt, depth + 1),
+        ];
+    }
+    if (entry.label === DELEGATION_CERT_LABEL &&
+        receipt.unprotected.delegation) {
+        const d = receipt.unprotected.delegation;
+        const nested = d.nestedCoseSign1
+            ? " — parses as a nested COSE_Sign1"
+            : "";
+        return [
+            {
+                depth,
+                text: `${labelPrefix(entry)}: ${d.byteLength} bytes${nested}`,
+            },
+        ];
+    }
+    if (entry.label === SEAL_PEAK_RECEIPTS_LABEL &&
+        receipt.unprotected.peakReceipts) {
+        return [
+            {
+                depth,
+                text: `${labelPrefix(entry)}: ${receipt.unprotected.peakReceipts.count} receipts`,
+            },
+        ];
+    }
+    return [{ depth, text: `${labelPrefix(entry)}: ${describeJson(entry.value)}` }];
+}
+function protectedLines(entry, receipt, depth) {
+    const p = receipt.protected;
+    if (entry.label === 1 && p.alg) {
+        const name = p.alg.name ?? "unknown alg";
+        return [{ depth, text: `1 (alg): ${p.alg.value} — ${name}` }];
+    }
+    if (entry.label === 4 && p.kid) {
+        const text = "hex" in p.kid
+            ? `${shortHex(p.kid.hex)} (${p.kid.byteLength} bytes)`
+            : JSON.stringify(p.kid.text);
+        return [{ depth, text: `4 (kid): ${text}` }];
+    }
+    if (entry.label === VDS_LABEL && p.vds) {
+        const name = p.vds.name ?? "unknown verifiable data structure";
+        return [
+            {
+                depth,
+                text: `${VDS_LABEL} (verifiable data structure): ${p.vds.value} — ${name}`,
+            },
+        ];
+    }
+    if (entry.label === CWT_CLAIMS_LABEL && p.cwtClaims) {
+        const lines = [{ depth, text: `15 (CWT claims):` }];
+        for (const claim of p.cwtClaims) {
+            const head = claim.name ? `${claim.key} (${claim.name})` : `${claim.key}`;
+            lines.push({
+                depth: depth + 1,
+                text: `${head}: ${describeJson(claim.value)}`,
+            });
+            if (claim.value !== null &&
+                typeof claim.value === "object" &&
+                !Array.isArray(claim.value)) {
+                for (const [k, v] of Object.entries(claim.value)) {
+                    lines.push({ depth: depth + 2, text: `${k}: ${describeJson(v)}` });
+                }
+            }
+        }
+        return lines;
+    }
+    return [{ depth, text: `${labelPrefix(entry)}: ${describeJson(entry.value)}` }];
+}
+/** Draw the annotated COSE tree with box-drawing connectors. */
+function drawTree(lines) {
+    const out = [];
+    for (let i = 0; i < lines.length; i += 1) {
+        const line = lines[i];
+        if (line.depth === 0) {
+            out.push(line.text);
+            continue;
+        }
+        // A node is "last" among its siblings if no later line has its depth
+        // before a shallower one appears.
+        const isLast = (depth, from) => {
+            for (let j = from + 1; j < lines.length; j += 1) {
+                const d = lines[j].depth;
+                if (d < depth)
+                    return true;
+                if (d === depth)
+                    return false;
+            }
+            return true;
+        };
+        let prefix = "";
+        for (let depth = 1; depth < line.depth; depth += 1) {
+            // Find the nearest ancestor line at `depth` at or before i.
+            let ancestor = -1;
+            for (let j = i; j >= 0; j -= 1) {
+                if (lines[j].depth === depth) {
+                    ancestor = j;
+                    break;
+                }
+                if (lines[j].depth < depth)
+                    break;
+            }
+            prefix += ancestor >= 0 && isLast(depth, ancestor) ? "   " : "│  ";
+        }
+        prefix += isLast(line.depth, i) ? "└─ " : "├─ ";
+        out.push(prefix + line.text);
+    }
+    return out;
+}
+/** Render the receipt as the annotated human tree. */
+export function renderReceipt(receipt) {
+    const tagText = receipt.tag !== null
+        ? `tagged ${receipt.tag} (COSE_Sign1)`
+        : "untagged (tag 18 omitted)";
+    const lines = [
+        {
+            depth: 0,
+            text: `COSE_Sign1 — ${tagText} — ${receipt.byteLength} bytes`,
+        },
+    ];
+    lines.push({
+        depth: 1,
+        text: `protected: ${receipt.protected.byteLength} bytes (CBOR map, covered by the signature)`,
+    });
+    if (receipt.protected.entries.length === 0) {
+        lines.push({ depth: 2, text: "(empty)" });
+    }
+    for (const entry of receipt.protected.entries) {
+        lines.push(...protectedLines(entry, receipt, 2));
+    }
+    lines.push({ depth: 1, text: "unprotected: (not covered by the signature)" });
+    if (receipt.unprotected.entries.length === 0) {
+        lines.push({ depth: 2, text: "(empty)" });
+    }
+    for (const entry of receipt.unprotected.entries) {
+        lines.push(...unprotectedLines(entry, receipt, 2));
+    }
+    if (receipt.payload.detached) {
+        lines.push({
+            depth: 1,
+            text: "payload: detached (nil) — the verifier recomputes the MMR peak from the inclusion path",
+        });
+    }
+    else {
+        lines.push({
+            depth: 1,
+            text: `payload: ${receipt.payload.byteLength} bytes — MMR peak hash ${shortHex(receipt.payload.hex)}`,
+        });
+    }
+    lines.push({
+        depth: 1,
+        text: `signature: ${receipt.signature.byteLength} bytes — ${shortHex(receipt.signature.hex)}`,
+    });
+    const tree = drawTree(lines);
+    const inclusion = receipt.inclusion;
+    const peak = inclusion.peakHex !== null
+        ? `${shortHex(inclusion.peakHex)} (from payload)`
+        : inclusion.peakSource;
+    return [
+        ...tree,
+        "",
+        "MMR inclusion",
+        `  mmr index:    ${inclusion.mmrIndex}`,
+        `  path length:  ${inclusion.pathLength}`,
+        `  peak:         ${peak}`,
+    ].join("\n");
+}
+//# sourceMappingURL=decode-receipt-render.js.map

package/dist/lib/decode-receipt-render.js.map

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

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "@forestrie/forestrie-cli",
+  "version": "0.8.0",
+  "description": "forestrie — participant CLI for forestrie transparency logs (SCITT / COSE receipts)",
+  "keywords": [
+    "forestrie",
+    "scitt",
+    "cose",
+    "receipt",
+    "transparency-log",
+    "merkle",
+    "cli"
+  ],
+  "license": "MIT",
+  "homepage": "https://github.com/forestrie/forestrie-cli#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/forestrie/forestrie-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/forestrie/forestrie-cli/issues"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=20.10.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "bin": {
+    "forestrie": "dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./decode-receipt": {
+      "types": "./dist/decode-receipt.d.ts",
+      "import": "./dist/decode-receipt.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src",
+    "LICENSE",
+    "README.md",
+    "TRUST-MODEL.md"
+  ],
+  "scripts": {
+    "dev": "bun run ./src/cli.ts",
+    "clean": "rm -rf dist",
+    "build": "bun run clean && bun run build:lib && bun run build:cli",
+    "build:cli": "bun build ./src/cli.ts --outdir dist --target node",
+    "build:lib": "tsc -p tsconfig.lib.json",
+    "build:binary": "bun scripts/build-binary.ts",
+    "build:binary:linux-x64": "bun scripts/build-binary.ts --target bun-linux-x64",
+    "build:binary:darwin-arm64": "bun scripts/build-binary.ts --target bun-darwin-arm64",
+    "typecheck": "tsc --noEmit",
+    "check:cbor": "bun scripts/check-cbor-codec.ts",
+    "test": "bun test",
+    "prepack": "bun run build"
+  },
+  "dependencies": {
+    "@forestrie/chain-rpc": "^0.2.0",
+    "@forestrie/cli-kit": "^0.1.1",
+    "@forestrie/delegation-cose": "^0.3.1",
+    "@forestrie/deploy-core": "^0.7.1",
+    "@forestrie/encoding": "^0.7.0",
+    "@forestrie/grant-builder": "^0.4.1",
+    "@forestrie/merklelog": "^0.3.0",
+    "@forestrie/receipt-verify": "^1.0.0",
+    "@forestrie/scrapi-client": "^0.1.4",
+    "citty": "^0.2.2",
+    "viem": "^2.31.0"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.9.2"
+  }
+}

package/src/cli.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { runMain } from "citty";
+import command from "./command.js";
+
+runMain(command);

package/src/command.ts

@@ -0,0 +1,51 @@
+import pkg from "../package.json" with { type: "json" };
+import { defineForestrieCommand } from "./commoncli.js";
+
+/**
+ * Root `forestrie` command. Subcommands are lazy-loaded citty modules;
+ * argument parsing lives in `src/options/`, behaviour in `src/main/`
+ * (parse/execute split — see AGENTS.md).
+ */
+export default defineForestrieCommand({
+  meta: {
+    name: "forestrie",
+    // Single source of truth: release.yml's assert-tag-version checks
+    // package.json, so deriving here keeps `forestrie --version` honest
+    // (the v0.3.0 binary self-reported 0.2.0 from a stale literal).
+    version: pkg.version,
+    description:
+      "Participant CLI for forestrie transparency logs (SCITT / COSE receipts; ES256 is the paved path)",
+  },
+  subCommands: {
+    admin: () => import("./commands/admin.js").then((m) => m.default),
+    deploy: () => import("./commands/deploy.js").then((m) => m.default),
+    "sign-statement": () =>
+      import("./commands/sign-statement.js").then((m) => m.default),
+    register: () => import("./commands/register.js").then((m) => m.default),
+    "create-log": () =>
+      import("./commands/create-log.js").then((m) => m.default),
+    "register-grant": () =>
+      import("./commands/register-grant.js").then((m) => m.default),
+    delegate: () => import("./commands/delegate.js").then((m) => m.default),
+    "onboard-genesis": () =>
+      import("./commands/onboard-genesis.js").then((m) => m.default),
+    "onboard-request": () =>
+      import("./commands/onboard-request.js").then((m) => m.default),
+    "complete-grant": () =>
+      import("./commands/complete-grant.js").then((m) => m.default),
+    "resolve-receipt": () =>
+      import("./commands/resolve-receipt.js").then((m) => m.default),
+    // Non-breaking alias for the pre-FOR-418 name (plan-2607-32 D5).
+    "create-receipt": () =>
+      import("./commands/resolve-receipt.js").then((m) => m.default),
+    "decode-receipt": () =>
+      import("./commands/decode-receipt.js").then((m) => m.default),
+    verify: () => import("./commands/verify.js").then((m) => m.default),
+    "verify-grant": () =>
+      import("./commands/verify-grant.js").then((m) => m.default),
+    "fetch-accumulator": () =>
+      import("./commands/fetch-accumulator.js").then((m) => m.default),
+    "create-consistency-proof": () =>
+      import("./commands/create-consistency-proof.js").then((m) => m.default),
+  },
+});