@sentropic/track 0.1.0

package/dist/cli/index.js

@@ -0,0 +1,402 @@
+#!/usr/bin/env node
+import { execFileSync } from 'node:child_process';
+import { mkdirSync, readFileSync } from 'node:fs';
+import { basename, isAbsolute, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { readHead } from '../events/head.js';
+import { EventStore } from '../events/store.js';
+import { validate } from '../events/validate.js';
+import { DomainError } from '../model/item.js';
+import { formatReport, formatRows } from '../report/format.js';
+import { Track } from '../track.js';
+import { desyncFindings } from './desync.js';
+const USAGE = `usage: track <command>
+  init
+  item new --kind <feature|bug|chore> --title <t> --workspace <w> [--body <b>] [--parent <id>]
+  item spec <itemId> <to-specify|specified>
+  item realize <itemId> <in-progress|done|cancelled>
+  item show <itemId>
+  item ls [--workspace <w>] [--kind <feature|bug|chore>] [--format json|text|md]
+  decision new --kind <orientation|commitment> --title <t> --workspace <w> --targets <id,id> [--context <c>]
+  decision outcome <decisionId> <go|no-go|deferred>
+  decision dossier <decisionId> --context <c>
+  decision disposition <itemId> <orientation|commitment> <required|skipped|not-applicable>
+  blocker raise --target <id> --kind <decision|dependency> --ref <id> [--reason <r>] [--rule <linked-done|manual>]
+  blocker resolve <blockerId>
+  accept criterion <itemId> --statement <s>
+  accept link <criterionId> --kind <unit|integration|e2e|manual> --locator <l>
+  accept run <evidenceId> --result <pass|fail> [--commit <c>] [--env <e>] [--runner <r>]
+  accept run --from <report> --format <junit|json> [--commit <c>] [--env <e>] [--runner <r>]
+  accept waive <criterionId> --reason <r>
+  priority assess <itemId> --ubv <n> --tc <n> --rr <n> --js <n>
+  report [--decisions] [--require-accepted] [--format json|text|md] [--commit <sha>]
+  query [--kind <k>] [--workspace <w>] [--bucket <AWAITED|DROPPED|DONE|TO-DO>] [--realization <r>] [--acceptance <a>] [--format json|text|md] [--commit <sha>]
+  validate [--commit <sha>]
+  branch import <BRANCH.md> [--commit <sha>]
+`;
+const ITEM_KINDS = ['feature', 'bug', 'chore'];
+const SPEC_TARGETS = ['to-specify', 'specified'];
+const REALIZE_TARGETS = ['in-progress', 'done', 'cancelled'];
+const REALIZATIONS = ['to-do', 'in-progress', 'done', 'cancelled', 'rejected'];
+const DECISION_KINDS = ['orientation', 'commitment'];
+const OUTCOMES = ['go', 'no-go', 'deferred'];
+const GATES = ['orientation', 'commitment'];
+const DISPOSITIONS = ['required', 'skipped', 'not-applicable'];
+const BLOCKER_KINDS = ['decision', 'dependency'];
+// `linked-accepted` is SPEC §10 (v2+) and not yet auto-resolvable — not offered in the MVP.
+const RESOLUTION_RULES = ['linked-done', 'manual'];
+const EVIDENCE_KINDS = ['unit', 'integration', 'e2e', 'manual'];
+const RESULTS = ['pass', 'fail'];
+const FROM_FORMATS = ['junit', 'json'];
+const BUCKETS_ARG = ['AWAITED', 'DROPPED', 'DONE', 'TO-DO'];
+// `n/a` is decision-only; `query` projects non-decision rows, so it would never match.
+const ACCEPTANCES = ['fail', 'waived', 'unknown', 'stale', 'pass'];
+function trackDir(cwd) {
+    return join(cwd, '.track');
+}
+function eventsPath(cwd) {
+    return join(trackDir(cwd), 'events.jsonl');
+}
+function store(cwd) {
+    return new EventStore(eventsPath(cwd));
+}
+function gitHead(cwd) {
+    try {
+        // stdio: silence git's own stderr (off-repo, rev-parse fails — we fall back to 'HEAD').
+        return execFileSync('git', ['rev-parse', 'HEAD'], {
+            cwd,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+    }
+    catch {
+        return 'HEAD';
+    }
+}
+function parseFlags(args) {
+    const positional = [];
+    const flags = {};
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a.startsWith('--')) {
+            const key = a.slice(2);
+            const next = args[i + 1];
+            if (next !== undefined && !next.startsWith('--')) {
+                flags[key] = next;
+                i++;
+            }
+            else {
+                flags[key] = true;
+            }
+        }
+        else {
+            positional.push(a);
+        }
+    }
+    return { positional, flags };
+}
+function req(flags, key) {
+    const v = flags[key];
+    if (typeof v !== 'string')
+        throw new DomainError(`missing required --${key}`);
+    return v;
+}
+function opt(flags, key) {
+    const v = flags[key];
+    return typeof v === 'string' ? v : undefined;
+}
+function num(flags, key) {
+    const n = Number(req(flags, key));
+    if (Number.isNaN(n))
+        throw new DomainError(`--${key} must be a number`);
+    return n;
+}
+/** Validate a positional/flag against an allowed enum (CLI-boundary input validation). */
+function oneOf(value, allowed, name) {
+    if (value === undefined || !allowed.includes(value)) {
+        throw new DomainError(`${name} must be one of: ${allowed.join('|')} (got ${value === undefined ? '<none>' : `"${value}"`})`);
+    }
+    return value;
+}
+function fmt(flags) {
+    return oneOf(opt(flags, 'format') ?? 'text', ['json', 'text', 'md'], '--format');
+}
+export function runCli(argv, io) {
+    const cmd = argv[0];
+    const rest = argv.slice(1);
+    try {
+        switch (cmd) {
+            case 'init':
+                mkdirSync(trackDir(io.cwd), { recursive: true });
+                io.out(`Initialized .track/ in ${io.cwd}\n`);
+                return 0;
+            case 'item':
+                return cmdItem(rest, io);
+            case 'decision':
+                return cmdDecision(rest, io);
+            case 'blocker':
+                return cmdBlocker(rest, io);
+            case 'accept':
+                return cmdAccept(rest, io);
+            case 'priority':
+                return cmdPriority(rest, io);
+            case 'report':
+                return cmdReport(rest, io);
+            case 'query':
+                return cmdQuery(rest, io);
+            case 'validate':
+                return cmdValidate(rest, io);
+            case 'branch':
+                return cmdBranch(rest, io);
+            default:
+                io.err(USAGE);
+                return 2;
+        }
+    }
+    catch (error) {
+        io.err(`error: ${error instanceof Error ? error.message : String(error)}\n`);
+        return 1;
+    }
+}
+function rowsOut(rows, format, io) {
+    io.out(format === 'json' ? `${JSON.stringify(rows, null, 2)}\n` : formatRows(rows, format));
+}
+function cmdItem(args, io) {
+    const sub = args[0];
+    const { positional, flags } = parseFlags(args.slice(1));
+    const track = new Track(store(io.cwd));
+    if (sub === 'new') {
+        const id = track.createItem({
+            kind: oneOf(req(flags, 'kind'), ITEM_KINDS, '--kind'),
+            title: req(flags, 'title'),
+            workspace: req(flags, 'workspace'),
+            ...(opt(flags, 'body') !== undefined ? { body: req(flags, 'body') } : {}),
+            ...(opt(flags, 'parent') !== undefined ? { parentId: req(flags, 'parent') } : {}),
+        });
+        io.out(`${id}\n`);
+        return 0;
+    }
+    if (sub === 'spec') {
+        track.setSpec(positional[0], oneOf(positional[1], SPEC_TARGETS, 'spec'));
+        io.out('ok\n');
+        return 0;
+    }
+    if (sub === 'realize') {
+        track.setRealization(positional[0], oneOf(positional[1], REALIZE_TARGETS, 'realize'));
+        io.out('ok\n');
+        return 0;
+    }
+    if (sub === 'show') {
+        io.out(`${JSON.stringify(track.state().items.get(positional[0]) ?? null, null, 2)}\n`);
+        return 0;
+    }
+    if (sub === 'ls') {
+        const rows = track.query({
+            ...(opt(flags, 'kind') !== undefined ? { kind: oneOf(req(flags, 'kind'), ITEM_KINDS, '--kind') } : {}),
+            ...(opt(flags, 'workspace') !== undefined ? { workspace: req(flags, 'workspace') } : {}),
+        }, { baselineCommit: opt(flags, 'commit') ?? gitHead(io.cwd) });
+        rowsOut(rows, fmt(flags), io);
+        return 0;
+    }
+    io.err('usage: track item <new|spec|realize|show|ls>\n');
+    return 2;
+}
+function cmdDecision(args, io) {
+    const sub = args[0];
+    const { positional, flags } = parseFlags(args.slice(1));
+    const track = new Track(store(io.cwd));
+    if (sub === 'new') {
+        const id = track.createDecision({
+            decisionKind: oneOf(req(flags, 'kind'), DECISION_KINDS, '--kind'),
+            title: req(flags, 'title'),
+            workspace: req(flags, 'workspace'),
+            targets: req(flags, 'targets').split(',').map((s) => s.trim()).filter(Boolean),
+            dossier: { context: opt(flags, 'context') ?? '', options: [], qa: [] },
+        });
+        io.out(`${id}\n`);
+        return 0;
+    }
+    if (sub === 'outcome') {
+        track.setOutcome(positional[0], oneOf(positional[1], OUTCOMES, 'outcome'));
+        io.out('ok\n');
+        return 0;
+    }
+    if (sub === 'dossier') {
+        // merge: a context-only edit must not erase existing options/qa/recommendation
+        const current = track.state().decisions.get(positional[0])?.dossier;
+        if (current === undefined)
+            throw new DomainError(`unknown decision ${positional[0]}`);
+        track.reviseDossier(positional[0], { ...current, context: opt(flags, 'context') ?? current.context });
+        io.out('ok\n');
+        return 0;
+    }
+    if (sub === 'disposition') {
+        track.setDisposition(positional[0], oneOf(positional[1], GATES, 'gate'), oneOf(positional[2], DISPOSITIONS, 'disposition'));
+        io.out('ok\n');
+        return 0;
+    }
+    io.err('usage: track decision <new|outcome|dossier|disposition>\n');
+    return 2;
+}
+function cmdBlocker(args, io) {
+    const sub = args[0];
+    const { positional, flags } = parseFlags(args.slice(1));
+    const track = new Track(store(io.cwd));
+    if (sub === 'raise') {
+        const id = track.openBlocker({
+            targetId: req(flags, 'target'),
+            kind: oneOf(req(flags, 'kind'), BLOCKER_KINDS, '--kind'),
+            ref: req(flags, 'ref'),
+            reason: opt(flags, 'reason') ?? '',
+            ...(opt(flags, 'rule') !== undefined
+                ? { resolutionRule: oneOf(req(flags, 'rule'), RESOLUTION_RULES, '--rule') }
+                : {}),
+        });
+        io.out(`${id}\n`);
+        return 0;
+    }
+    if (sub === 'resolve') {
+        track.resolveBlocker(positional[0]);
+        io.out('ok\n');
+        return 0;
+    }
+    io.err('usage: track blocker <raise|resolve>\n');
+    return 2;
+}
+function cmdAccept(args, io) {
+    const sub = args[0];
+    const { positional, flags } = parseFlags(args.slice(1));
+    const track = new Track(store(io.cwd));
+    if (sub === 'criterion') {
+        io.out(`${track.addCriterion(positional[0], req(flags, 'statement'))}\n`);
+        return 0;
+    }
+    if (sub === 'link') {
+        io.out(`${track.linkEvidence(positional[0], oneOf(req(flags, 'kind'), EVIDENCE_KINDS, '--kind'), req(flags, 'locator'))}\n`);
+        return 0;
+    }
+    if (sub === 'run') {
+        const commit = opt(flags, 'commit') ?? gitHead(io.cwd);
+        const env = opt(flags, 'env') ?? 'ci';
+        const runner = opt(flags, 'runner') ?? 'cli';
+        const from = opt(flags, 'from');
+        if (from !== undefined) {
+            const content = readFileSync(isAbsolute(from) ? from : join(io.cwd, from), 'utf8');
+            const format = oneOf(req(flags, 'format'), FROM_FORMATS, '--format');
+            io.out(`ingested ${track.ingestRuns(content, format, { commit, env, runner })} run(s)\n`);
+            return 0;
+        }
+        track.recordRun(positional[0], {
+            commit,
+            env,
+            runner,
+            result: oneOf(req(flags, 'result'), RESULTS, '--result'),
+        });
+        io.out('ok\n');
+        return 0;
+    }
+    if (sub === 'waive') {
+        track.waive(positional[0], req(flags, 'reason'));
+        io.out('ok\n');
+        return 0;
+    }
+    io.err('usage: track accept <criterion|link|run|waive>\n');
+    return 2;
+}
+function cmdPriority(args, io) {
+    const sub = args[0];
+    const { positional, flags } = parseFlags(args.slice(1));
+    const track = new Track(store(io.cwd));
+    if (sub === 'assess') {
+        const a = track.assessPriority(positional[0], {
+            userBusinessValue: num(flags, 'ubv'),
+            timeCriticality: num(flags, 'tc'),
+            riskReductionOpportunityEnablement: num(flags, 'rr'),
+            jobSize: num(flags, 'js'),
+        });
+        io.out(`wsjf score ${a.score}\n`);
+        return 0;
+    }
+    io.err('usage: track priority assess <itemId> --ubv --tc --rr --js\n');
+    return 2;
+}
+function cmdReport(args, io) {
+    const { flags } = parseFlags(args);
+    const track = new Track(store(io.cwd));
+    const report = track.report({
+        baselineCommit: opt(flags, 'commit') ?? gitHead(io.cwd),
+        requireAccepted: flags['require-accepted'] === true,
+        decisions: flags['decisions'] === true,
+    });
+    io.out(formatReport(report, fmt(flags)));
+    return 0;
+}
+function cmdQuery(args, io) {
+    const { flags } = parseFlags(args);
+    const track = new Track(store(io.cwd));
+    const rows = track.query({
+        ...(opt(flags, 'kind') !== undefined ? { kind: oneOf(req(flags, 'kind'), ITEM_KINDS, '--kind') } : {}),
+        ...(opt(flags, 'workspace') !== undefined ? { workspace: req(flags, 'workspace') } : {}),
+        ...(opt(flags, 'bucket') !== undefined ? { bucket: oneOf(req(flags, 'bucket'), BUCKETS_ARG, '--bucket') } : {}),
+        ...(opt(flags, 'realization') !== undefined
+            ? { realization: oneOf(req(flags, 'realization'), REALIZATIONS, '--realization') }
+            : {}),
+        ...(opt(flags, 'acceptance') !== undefined
+            ? { acceptance: oneOf(req(flags, 'acceptance'), ACCEPTANCES, '--acceptance') }
+            : {}),
+    }, { baselineCommit: opt(flags, 'commit') ?? gitHead(io.cwd) });
+    rowsOut(rows, fmt(flags), io);
+    return 0;
+}
+function cmdValidate(args, io) {
+    const { flags } = parseFlags(args);
+    void flags;
+    const s = store(io.cwd);
+    let events;
+    try {
+        events = s.readAll();
+    }
+    catch (error) {
+        io.out(`INVALID: ${error instanceof Error ? error.message : String(error)}\n`);
+        return 1;
+    }
+    const integrity = validate(events, readHead(eventsPath(io.cwd)));
+    const desync = desyncFindings(new Track(s).state(), io.cwd);
+    const findings = [...integrity.findings.map((f) => ({ ...f })), ...desync];
+    if (findings.length === 0) {
+        io.out(`OK: ${events.length} events, integrity + desync clean\n`);
+        return 0;
+    }
+    io.out(`INVALID: ${integrity.findings.length} integrity + ${desync.length} desync finding(s)\n`);
+    io.out(`${JSON.stringify(findings, null, 2)}\n`);
+    return 1;
+}
+function cmdBranch(args, io) {
+    if (args[0] !== 'import') {
+        io.err('usage: track branch import <BRANCH.md> [--commit <sha>]\n');
+        return 2;
+    }
+    const { positional, flags } = parseFlags(args.slice(1));
+    const file = positional[0];
+    if (file === undefined) {
+        io.err('usage: track branch import <BRANCH.md> [--commit <sha>]\n');
+        return 2;
+    }
+    const content = readFileSync(isAbsolute(file) ? file : join(io.cwd, file), 'utf8');
+    const track = new Track(store(io.cwd));
+    const result = track.importBranch(content, {
+        locator: file,
+        fileSlug: basename(file).replace(/\.md$/, ''),
+        commit: opt(flags, 'commit') ?? gitHead(io.cwd),
+    });
+    io.out(`Imported ${result.branchSlug}: ${result.created} created, ${result.updated} updated\n`);
+    return 0;
+}
+if (process.argv[1] !== undefined && process.argv[1] === fileURLToPath(import.meta.url)) {
+    process.exit(runCli(process.argv.slice(2), {
+        cwd: process.cwd(),
+        out: (s) => process.stdout.write(s),
+        err: (s) => process.stderr.write(s),
+    }));
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/events/canonical.d.ts

@@ -0,0 +1,5 @@
+/** One-pass deep clone to inert plain data, rejecting anything that would hash ≠ persist. */
+export declare function materialize(value: unknown): unknown;
+export declare function canonicalize(value: unknown): string;
+export declare function computeHash(value: unknown): string;
+//# sourceMappingURL=canonical.d.ts.map

package/dist/events/canonical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.d.ts","sourceRoot":"","sources":["../../src/events/canonical.ts"],"names":[],"mappings":"AAkDA,6FAA6F;AAC7F,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CA2CnD;AAiDD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAIlD"}

package/dist/events/canonical.js

@@ -0,0 +1,134 @@
+import { createHash } from 'node:crypto';
+/**
+ * Deterministic canonical JSON, plus `materialize`. Together they make the **hash domain equal
+ * the persisted domain by construction** — the store hashes via `computeHash` and persists via
+ * `canonicalize`, i.e. the SAME serialization function, applied to the SAME inert snapshot:
+ *
+ *  - `materialize(value)` performs ONE traversal of the (possibly live) input, returning an
+ *    inert plain-data deep clone and fail-loud rejecting anything whose hash form would differ
+ *    from its persisted form. A live value (a `Proxy`, a non-idempotent getter) is therefore
+ *    frozen to what the single traversal read.
+ *  - `canonicalize` and `materialize` inspect ONLY own properties (`Object.hasOwn`, own
+ *    descriptors) and never honour an inherited `toJSON`/accessor/index — so a polluted
+ *    `Object.prototype`/`Array.prototype` cannot make the two diverge.
+ *
+ * Rejected (fail-loud, before any write): non-finite numbers, non-plain objects (`Date`/`Map`/
+ * class), own `toJSON`, accessor (getter/setter) properties, sparse-array holes (and inherited
+ * indices), `undefined`/symbol/function members. Hardened relative to h2a's `canonical.ts`
+ * (kept h2a-free per SPEC §9).
+ */
+function rejectExoticContainer(value) {
+    if (!Array.isArray(value)) {
+        const proto = Object.getPrototypeOf(value);
+        if (proto !== null && proto !== Object.prototype) {
+            const name = value.constructor?.name ?? 'unknown';
+            throw new Error(`canonicalize: non-plain object is not supported (${name})`);
+        }
+    }
+    if (Object.hasOwn(value, 'toJSON') &&
+        typeof value.toJSON === 'function') {
+        throw new Error('canonicalize: value with an own toJSON is not supported (hash/persist divergence)');
+    }
+}
+function eachArrayIndex(value, visit) {
+    for (let i = 0; i < value.length; i++) {
+        if (!Object.hasOwn(value, i)) {
+            throw new Error('canonicalize: sparse arrays (holes / inherited indices) are not supported');
+        }
+        const descriptor = Object.getOwnPropertyDescriptor(value, i);
+        if (descriptor.get !== undefined || descriptor.set !== undefined) {
+            throw new Error(`canonicalize: accessor array index ${i} is not supported`);
+        }
+        visit(i);
+    }
+}
+/** One-pass deep clone to inert plain data, rejecting anything that would hash ≠ persist. */
+export function materialize(value) {
+    if (value === null)
+        return null;
+    if (Array.isArray(value)) {
+        rejectExoticContainer(value);
+        const out = [];
+        eachArrayIndex(value, (i) => {
+            out.push(materialize(value[i]));
+        });
+        return out;
+    }
+    const kind = typeof value;
+    if (kind === 'object') {
+        rejectExoticContainer(value);
+        const source = value;
+        // null-proto accumulator so a literal `__proto__` own key clones as a data key (no setter).
+        const out = Object.create(null);
+        for (const key of Object.keys(source)) {
+            const descriptor = Object.getOwnPropertyDescriptor(source, key);
+            if (descriptor.get !== undefined || descriptor.set !== undefined) {
+                throw new Error(`canonicalize: accessor property "${key}" is not supported`);
+            }
+            const child = source[key];
+            if (child === undefined)
+                continue;
+            out[key] = materialize(child);
+        }
+        return out;
+    }
+    if (kind === 'number') {
+        if (!Number.isFinite(value)) {
+            throw new Error(`canonicalize: non-finite numbers are not supported (${value})`);
+        }
+        return value;
+    }
+    if (kind === 'string' || kind === 'boolean') {
+        return value;
+    }
+    throw new Error(`canonicalize: unsupported value type (${kind})`);
+}
+/** Deterministic JSON string: sort keys, drop `undefined`, own-properties only. */
+function canonicalString(value) {
+    if (value === null) {
+        return 'null';
+    }
+    if (Array.isArray(value)) {
+        rejectExoticContainer(value);
+        const members = [];
+        eachArrayIndex(value, (i) => {
+            members.push(canonicalString(value[i]));
+        });
+        return '[' + members.join(',') + ']';
+    }
+    const kind = typeof value;
+    if (kind === 'object') {
+        rejectExoticContainer(value);
+        const source = value;
+        for (const key of Object.keys(source)) {
+            const descriptor = Object.getOwnPropertyDescriptor(source, key);
+            if (descriptor.get !== undefined || descriptor.set !== undefined) {
+                throw new Error(`canonicalize: accessor property "${key}" is not supported`);
+            }
+        }
+        const keys = Object.keys(source)
+            .filter((key) => source[key] !== undefined)
+            .sort();
+        const members = keys.map((key) => `${JSON.stringify(key)}:${canonicalString(source[key])}`);
+        return '{' + members.join(',') + '}';
+    }
+    if (kind === 'number') {
+        if (!Number.isFinite(value)) {
+            throw new Error(`canonicalize: non-finite numbers are not supported (${value})`);
+        }
+        return JSON.stringify(value);
+    }
+    if (kind === 'string' || kind === 'boolean') {
+        return JSON.stringify(value);
+    }
+    throw new Error(`canonicalize: unsupported value type (${kind})`);
+}
+export function canonicalize(value) {
+    return canonicalString(value);
+}
+export function computeHash(value) {
+    const canonical = canonicalize(value);
+    const digest = createHash('sha256').update(canonical, 'utf8').digest('hex');
+    return `sha256:${digest}`;
+}
+//# sourceMappingURL=canonical.js.map

package/dist/events/canonical.js.map

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

package/dist/events/frame.d.ts

@@ -0,0 +1,11 @@
+import type { EventCore, Sha256, TrackEvent } from './types.js';
+/**
+ * contentHash domain = the `EventCore` (the event minus its integrity frame
+ * `{seq, prevHash, contentHash}`), faithful to h2a `journal.ts` `stripFrame()`.
+ * canonicalize() drops `undefined` keys and sorts keys, so an absent `cmdId`/`cmd`
+ * does not change the hash.
+ */
+export declare function contentHashOf(core: EventCore): Sha256;
+/** Recover the hash domain from a persisted event (drops the integrity frame). */
+export declare function stripFrame(event: TrackEvent): EventCore;
+//# sourceMappingURL=frame.d.ts.map

package/dist/events/frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.d.ts","sourceRoot":"","sources":["../../src/events/frame.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE/D;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAErD;AAED,kFAAkF;AAClF,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,CAMvD"}

package/dist/events/frame.js

@@ -0,0 +1,19 @@
+import { computeHash } from './canonical.js';
+/**
+ * contentHash domain = the `EventCore` (the event minus its integrity frame
+ * `{seq, prevHash, contentHash}`), faithful to h2a `journal.ts` `stripFrame()`.
+ * canonicalize() drops `undefined` keys and sorts keys, so an absent `cmdId`/`cmd`
+ * does not change the hash.
+ */
+export function contentHashOf(core) {
+    return computeHash(core);
+}
+/** Recover the hash domain from a persisted event (drops the integrity frame). */
+export function stripFrame(event) {
+    const { seq: _seq, prevHash: _prevHash, contentHash: _contentHash, ...core } = event;
+    void _seq;
+    void _prevHash;
+    void _contentHash;
+    return core;
+}
+//# sourceMappingURL=frame.js.map

package/dist/events/frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.js","sourceRoot":"","sources":["../../src/events/frame.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAG5C;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,IAAe;IAC3C,OAAO,WAAW,CAAC,IAAI,CAAW,CAAA;AACpC,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,UAAU,CAAC,KAAiB;IAC1C,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAA;IACpF,KAAK,IAAI,CAAA;IACT,KAAK,SAAS,CAAA;IACd,KAAK,YAAY,CAAA;IACjB,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/events/head.d.ts

@@ -0,0 +1,21 @@
+import type { Sha256 } from './types.js';
+/**
+ * Non-authoritative anchor that lets `validate` detect suffix **truncation** of the
+ * append-only log (SPEC §3 threat model). The log stays the source of truth; the head is a
+ * convenience pointer (like snapshots), rebuildable from the log, and additionally durable via
+ * the docs-git backend.
+ */
+export interface Head {
+    streamLength: number;
+    lastContentHash: Sha256 | null;
+}
+export declare function headPath(eventsPath: string): string;
+/**
+ * Read the head, or `null` if it is missing, unparseable, OR malformed in shape. The head is
+ * rebuildable, so any problem must degrade to "no head" (never throw, never a bogus anchor that
+ * would silently disable detection or raise a false truncation/head-mismatch).
+ */
+export declare function readHead(eventsPath: string): Head | null;
+/** Write the head atomically (temp file + fsync + rename) so a crash never leaves a torn head. */
+export declare function writeHead(eventsPath: string, head: Head): void;
+//# sourceMappingURL=head.d.ts.map

package/dist/events/head.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"head.d.ts","sourceRoot":"","sources":["../../src/events/head.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAExC;;;;;GAKG;AACH,MAAM,WAAW,IAAI;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B;AAED,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAoBxD;AAED,kGAAkG;AAClG,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAY9D"}