@sentropic/track 0.1.0

package/dist/events/head.js

@@ -0,0 +1,54 @@
+import { closeSync, existsSync, fsyncSync, mkdirSync, openSync, readFileSync, renameSync, writeSync, } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { canonicalize } from './canonical.js';
+export function headPath(eventsPath) {
+    return join(dirname(eventsPath), 'head.json');
+}
+/**
+ * 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 function readHead(eventsPath) {
+    const p = headPath(eventsPath);
+    if (!existsSync(p))
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(p, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+    if (typeof parsed !== 'object' || parsed === null)
+        return null;
+    const record = parsed;
+    const len = record['streamLength'];
+    const last = record['lastContentHash'];
+    if (typeof len !== 'number' || !Number.isInteger(len) || len < 0)
+        return null;
+    if (len === 0) {
+        if (last !== null)
+            return null;
+        return { streamLength: 0, lastContentHash: null };
+    }
+    if (typeof last !== 'string' || !last.startsWith('sha256:'))
+        return null;
+    return { streamLength: len, lastContentHash: last };
+}
+/** Write the head atomically (temp file + fsync + rename) so a crash never leaves a torn head. */
+export function writeHead(eventsPath, head) {
+    const p = headPath(eventsPath);
+    mkdirSync(dirname(p), { recursive: true });
+    const tmp = `${p}.tmp`;
+    const fd = openSync(tmp, 'w');
+    try {
+        writeSync(fd, canonicalize(head) + '\n');
+        fsyncSync(fd);
+    }
+    finally {
+        closeSync(fd);
+    }
+    renameSync(tmp, p);
+}
+//# sourceMappingURL=head.js.map

package/dist/events/head.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"head.js","sourceRoot":"","sources":["../../src/events/head.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,UAAU,EACV,SAAS,EACT,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,SAAS,GACV,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEzC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAc7C,MAAM,UAAU,QAAQ,CAAC,UAAkB;IACzC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,WAAW,CAAC,CAAA;AAC/C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,UAAkB;IACzC,MAAM,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAA;IAC9B,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IAC/B,IAAI,MAAe,CAAA;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAA;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IAC9D,MAAM,MAAM,GAAG,MAAiC,CAAA;IAChD,MAAM,GAAG,GAAG,MAAM,CAAC,cAAc,CAAC,CAAA;IAClC,MAAM,IAAI,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAA;IACtC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,IAAI,CAAA;IAC7E,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC;QACd,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,IAAI,CAAA;QAC9B,OAAO,EAAE,YAAY,EAAE,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE,CAAA;IACnD,CAAC;IACD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAA;IACxE,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,eAAe,EAAE,IAAc,EAAE,CAAA;AAC/D,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,SAAS,CAAC,UAAkB,EAAE,IAAU;IACtD,MAAM,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAA;IAC9B,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC1C,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAA;IACtB,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;IAC7B,IAAI,CAAC;QACH,SAAS,CAAC,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAA;QACxC,SAAS,CAAC,EAAE,CAAC,CAAA;IACf,CAAC;YAAS,CAAC;QACT,SAAS,CAAC,EAAE,CAAC,CAAA;IACf,CAAC;IACD,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;AACpB,CAAC"}

package/dist/events/index.d.ts

@@ -0,0 +1,7 @@
+export * from './types.js';
+export { canonicalize, computeHash, materialize } from './canonical.js';
+export { contentHashOf, stripFrame } from './frame.js';
+export { headPath, readHead, writeHead, type Head } from './head.js';
+export { EventStore } from './store.js';
+export { validate, type IntegrityFinding, type IntegrityResult } from './validate.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAEA,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACvE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACtD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,IAAI,EAAE,MAAM,WAAW,CAAA;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,EAAE,QAAQ,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAA"}

package/dist/events/index.js

@@ -0,0 +1,9 @@
+// Event contract: append-only frame, contentHash, positional chain, atomic cmdId batch (SPEC §3).
+// The frozen contract everything folds over.
+export * from './types.js';
+export { canonicalize, computeHash, materialize } from './canonical.js';
+export { contentHashOf, stripFrame } from './frame.js';
+export { headPath, readHead, writeHead } from './head.js';
+export { EventStore } from './store.js';
+export { validate } from './validate.js';
+//# sourceMappingURL=index.js.map

package/dist/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,6CAA6C;AAC7C,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACvE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACtD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAa,MAAM,WAAW,CAAA;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,EAAE,QAAQ,EAA+C,MAAM,eAAe,CAAA"}

package/dist/events/store.d.ts

@@ -0,0 +1,33 @@
+import type { CommandEvent, TrackEvent, Ulid } from './types.js';
+/**
+ * Append-only single-writer event store over `.track/events.jsonl` (SPEC §3, §4).
+ * The store owns the integrity frame: it assigns per-aggregate `seq`, the positional
+ * `prevHash`, and `contentHash`, and writes a command's events as one atomic batch.
+ *
+ * Fail-closed: `appendCommand` `validate`s the existing log before extending it, so a
+ * tampered/reordered/truncated log cannot be silently grown.
+ */
+export declare class EventStore {
+    private readonly filePath;
+    constructor(filePath: string);
+    /** All events in stream (append) order. Throws on a malformed (e.g. torn) line. */
+    readAll(): TrackEvent[];
+    /**
+     * Append one command's events atomically. A multi-event command (`inputs.length > 1`)
+     * requires `opts.cmdId` and is tagged with `cmd:{i,n}`; a single-event command is
+     * standalone (no `cmdId`). Refuses to extend a log that does not pass `validate`.
+     */
+    appendCommand(inputs: ReadonlyArray<CommandEvent>, opts?: {
+        cmdId?: Ulid;
+    }): TrackEvent[];
+    /**
+     * Append all of a command's lines in one fsync'd write. Each line is the event's `canonicalize`
+     * form — the SAME serialization used for `contentHash`, so persisted bytes can never diverge
+     * from the hashed bytes (immune to prototype pollution / live values). `writeSync` may
+     * short-write, so we loop until every byte is flushed. This makes a normal append durable; it
+     * does not make a mid-write *crash* atomic — a torn trailing line is reported by
+     * `validate`/`readAll` (fail-closed), not silently skipped.
+     */
+    private appendAtomic;
+}
+//# sourceMappingURL=store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/events/store.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAqB,UAAU,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAGnF;;;;;;;GAOG;AACH,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM;IAE7C,mFAAmF;IACnF,OAAO,IAAI,UAAU,EAAE;IAiBvB;;;;OAIG;IACH,aAAa,CACX,MAAM,EAAE,aAAa,CAAC,YAAY,CAAC,EACnC,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,IAAI,CAAA;KAAO,GAC1B,UAAU,EAAE;IAgEf;;;;;;;OAOG;IACH,OAAO,CAAC,YAAY;CAcrB"}

package/dist/events/store.js

@@ -0,0 +1,121 @@
+import { closeSync, existsSync, fsyncSync, mkdirSync, openSync, readFileSync, writeSync, } from 'node:fs';
+import { dirname } from 'node:path';
+import { canonicalize, materialize } from './canonical.js';
+import { contentHashOf } from './frame.js';
+import { readHead, writeHead } from './head.js';
+import { validate } from './validate.js';
+/**
+ * Append-only single-writer event store over `.track/events.jsonl` (SPEC §3, §4).
+ * The store owns the integrity frame: it assigns per-aggregate `seq`, the positional
+ * `prevHash`, and `contentHash`, and writes a command's events as one atomic batch.
+ *
+ * Fail-closed: `appendCommand` `validate`s the existing log before extending it, so a
+ * tampered/reordered/truncated log cannot be silently grown.
+ */
+export class EventStore {
+    filePath;
+    constructor(filePath) {
+        this.filePath = filePath;
+    }
+    /** All events in stream (append) order. Throws on a malformed (e.g. torn) line. */
+    readAll() {
+        if (!existsSync(this.filePath))
+            return [];
+        const raw = readFileSync(this.filePath, 'utf8');
+        const events = [];
+        const lines = raw.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            if (line === undefined || line.trim().length === 0)
+                continue;
+            try {
+                events.push(JSON.parse(line));
+            }
+            catch {
+                throw new Error(`EventStore: malformed event line ${i + 1} in ${this.filePath}`);
+            }
+        }
+        return events;
+    }
+    /**
+     * Append one command's events atomically. A multi-event command (`inputs.length > 1`)
+     * requires `opts.cmdId` and is tagged with `cmd:{i,n}`; a single-event command is
+     * standalone (no `cmdId`). Refuses to extend a log that does not pass `validate`.
+     */
+    appendCommand(inputs, opts = {}) {
+        if (inputs.length === 0) {
+            throw new Error('EventStore.appendCommand: empty command (no events)');
+        }
+        const n = inputs.length;
+        const isBatch = n > 1;
+        if (isBatch && opts.cmdId === undefined) {
+            throw new Error('EventStore.appendCommand: a multi-event command requires a cmdId');
+        }
+        const existing = this.readAll();
+        const integrity = validate(existing, readHead(this.filePath));
+        if (!integrity.ok) {
+            const kinds = integrity.findings.map((f) => f.kind).join(', ');
+            throw new Error(`EventStore.appendCommand: refusing to extend an invalid log ` +
+                `(${integrity.findings.length} finding(s): ${kinds})`);
+        }
+        let prevHash = existing.length > 0 ? existing[existing.length - 1].contentHash : null;
+        // Next per-aggregate seq = max(seq) + 1, aligned with validate's authority.
+        const lastSeqByAggregate = new Map();
+        for (const e of existing) {
+            lastSeqByAggregate.set(e.aggregateId, e.seq);
+        }
+        const events = [];
+        inputs.forEach((input, i) => {
+            const seq = (lastSeqByAggregate.get(input.aggregateId) ?? 0) + 1;
+            lastSeqByAggregate.set(input.aggregateId, seq);
+            const core = isBatch
+                ? { ...input, cmdId: opts.cmdId, cmd: { i, n } }
+                : { ...input };
+            // Materialize ONCE to an inert plain-data snapshot, then hash AND persist that same
+            // snapshot — so a live payload (Proxy / getter / toJSON) cannot diverge between the two.
+            const materialized = materialize(core);
+            const contentHash = contentHashOf(materialized);
+            const event = { ...materialized, seq, prevHash, contentHash };
+            events.push(event);
+            prevHash = contentHash;
+        });
+        // Validate the FULL candidate stream (not just the existing prefix): the command itself
+        // could introduce a cross-event violation (e.g. an aggregate-mismatch, a malformed batch).
+        const candidate = validate([...existing, ...events]);
+        if (!candidate.ok) {
+            const kinds = candidate.findings.map((f) => f.kind).join(', ');
+            throw new Error(`EventStore.appendCommand: command would produce an invalid log ` +
+                `(${candidate.findings.length} finding(s): ${kinds})`);
+        }
+        this.appendAtomic(events);
+        writeHead(this.filePath, {
+            streamLength: existing.length + events.length,
+            lastContentHash: events[events.length - 1].contentHash,
+        });
+        return events;
+    }
+    /**
+     * Append all of a command's lines in one fsync'd write. Each line is the event's `canonicalize`
+     * form — the SAME serialization used for `contentHash`, so persisted bytes can never diverge
+     * from the hashed bytes (immune to prototype pollution / live values). `writeSync` may
+     * short-write, so we loop until every byte is flushed. This makes a normal append durable; it
+     * does not make a mid-write *crash* atomic — a torn trailing line is reported by
+     * `validate`/`readAll` (fail-closed), not silently skipped.
+     */
+    appendAtomic(events) {
+        mkdirSync(dirname(this.filePath), { recursive: true });
+        const buffer = Buffer.from(events.map((e) => canonicalize(e)).join('\n') + '\n', 'utf8');
+        const fd = openSync(this.filePath, 'a');
+        try {
+            let offset = 0;
+            while (offset < buffer.length) {
+                offset += writeSync(fd, buffer, offset, buffer.length - offset);
+            }
+            fsyncSync(fd);
+        }
+        finally {
+            closeSync(fd);
+        }
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/events/store.js.map

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

package/dist/events/types.d.ts

@@ -0,0 +1,42 @@
+export type Ulid = string;
+export type ActorId = string;
+export type Sha256 = `sha256:${string}`;
+export declare const AGGREGATES: readonly ["item", "decision", "blocker"];
+export type Aggregate = (typeof AGGREGATES)[number];
+export declare const EVENT_TYPES: readonly ["item.created", "spec.transition", "realization.transition", "acceptance.criterion.added", "acceptance.evidence.linked", "acceptance.run", "acceptance.waived", "blocker.opened", "blocker.resolved", "decision.created", "decision.disposition", "dossier.revised", "decision.outcome", "priority.assessed", "branch.imported"];
+export type EventType = (typeof EVENT_TYPES)[number];
+/**
+ * Position of an event within an atomic command batch.
+ * Lot-1 refinement of SPEC §3: the spec frame carries `cmdId?` to correlate a batch but
+ * no size, so `validate` cannot detect a *dropped trailing member*. `cmd` makes a batch
+ * self-describing (and is covered by `contentHash`). Present iff `cmdId` is present.
+ */
+export interface CmdPosition {
+    i: number;
+    n: number;
+}
+/**
+ * The command-supplied core of an event: everything except the integrity frame
+ * (`seq`, `prevHash`, `contentHash`). This is exactly the domain hashed into `contentHash`
+ * (cf. h2a `stripFrame`).
+ */
+export interface EventCore {
+    id: Ulid;
+    type: EventType;
+    aggregate: Aggregate;
+    aggregateId: Ulid;
+    at: string;
+    by: ActorId;
+    payload: Readonly<Record<string, unknown>>;
+    cmdId?: Ulid;
+    cmd?: CmdPosition;
+}
+/** A command's contribution before the store assigns the integrity frame. */
+export type CommandEvent = Omit<EventCore, 'cmdId' | 'cmd'>;
+/** A fully persisted event = core + positional/integrity frame. */
+export interface TrackEvent extends EventCore {
+    seq: number;
+    prevHash: Sha256 | null;
+    contentHash: Sha256;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/events/types.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,IAAI,GAAG,MAAM,CAAA;AACzB,MAAM,MAAM,OAAO,GAAG,MAAM,CAAA;AAC5B,MAAM,MAAM,MAAM,GAAG,UAAU,MAAM,EAAE,CAAA;AAEvC,eAAO,MAAM,UAAU,0CAA2C,CAAA;AAClE,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAA;AAEnD,eAAO,MAAM,WAAW,4UAgBd,CAAA;AACV,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAA;AAEpD;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,IAAI,CAAA;IACR,IAAI,EAAE,SAAS,CAAA;IACf,SAAS,EAAE,SAAS,CAAA;IACpB,WAAW,EAAE,IAAI,CAAA;IACjB,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,OAAO,CAAA;IACX,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAC1C,KAAK,CAAC,EAAE,IAAI,CAAA;IACZ,GAAG,CAAC,EAAE,WAAW,CAAA;CAClB;AAED,6EAA6E;AAC7E,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,KAAK,CAAC,CAAA;AAE3D,mEAAmE;AACnE,MAAM,WAAW,UAAW,SAAQ,SAAS;IAC3C,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,WAAW,EAAE,MAAM,CAAA;CACpB"}

package/dist/events/types.js

@@ -0,0 +1,22 @@
+// Event contract — the frozen core of @sentropic/track (SPEC §3).
+// Faithful to the h2a journal model (positional prevHash chain + per-aggregate seq),
+// re-expressed for a typed product backlog.
+export const AGGREGATES = ['item', 'decision', 'blocker'];
+export const EVENT_TYPES = [
+    'item.created',
+    'spec.transition',
+    'realization.transition',
+    'acceptance.criterion.added',
+    'acceptance.evidence.linked',
+    'acceptance.run',
+    'acceptance.waived',
+    'blocker.opened',
+    'blocker.resolved',
+    'decision.created',
+    'decision.disposition',
+    'dossier.revised',
+    'decision.outcome',
+    'priority.assessed',
+    'branch.imported',
+];
+//# sourceMappingURL=types.js.map

package/dist/events/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/events/types.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,qFAAqF;AACrF,4CAA4C;AAM5C,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,CAAU,CAAA;AAGlE,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,cAAc;IACd,iBAAiB;IACjB,wBAAwB;IACxB,4BAA4B;IAC5B,4BAA4B;IAC5B,gBAAgB;IAChB,mBAAmB;IACnB,gBAAgB;IAChB,kBAAkB;IAClB,kBAAkB;IAClB,sBAAsB;IACtB,iBAAiB;IACjB,kBAAkB;IAClB,mBAAmB;IACnB,iBAAiB;CACT,CAAA"}

package/dist/events/validate.d.ts

@@ -0,0 +1,72 @@
+import type { Head } from './head.js';
+import type { Sha256, TrackEvent } from './types.js';
+export type IntegrityFinding = {
+    kind: 'content-hash';
+    index: number;
+    eventId: string;
+    expected: Sha256;
+    actual: Sha256;
+} | {
+    kind: 'prev-hash';
+    index: number;
+    eventId: string;
+    expected: Sha256 | null;
+    actual: Sha256 | null;
+} | {
+    kind: 'aggregate-seq';
+    index: number;
+    eventId: string;
+    aggregateId: string;
+    expected: number;
+    actual: number;
+} | {
+    kind: 'aggregate-mismatch';
+    index: number;
+    eventId: string;
+    aggregateId: string;
+    expected: string;
+    actual: string;
+} | {
+    kind: 'batch-frame';
+    index: number;
+    eventId: string;
+    cmdId: string | null;
+    reason: string;
+} | {
+    kind: 'partial-batch';
+    cmdId: string;
+    expected: number;
+    actual: number;
+    reason: string;
+} | {
+    kind: 'batch-noncontiguous';
+    cmdId: string;
+    index: number;
+} | {
+    kind: 'truncation';
+    expected: number;
+    actual: number;
+} | {
+    kind: 'head-mismatch';
+    index: number;
+    expected: Sha256 | null;
+    actual: Sha256;
+};
+export interface IntegrityResult {
+    ok: boolean;
+    findings: IntegrityFinding[];
+}
+/**
+ * Integrity check over a stream (SPEC §3, A4 + A5). For each event in stream order:
+ * (i) recompute `contentHash` from the core (content tamper), (ii) `prevHash` equals the
+ * previous event's stored `contentHash` (insertion/reorder), (iii) per-aggregate `seq` is
+ * 1-based and strictly contiguous (drop/dup), (iv) an `aggregateId` keeps one `aggregate`
+ * type. Then per `cmdId`: `cmd` iff `cmdId`, a consistent positive integer `n`, every index
+ * unique in `[0,n)`, count `== n`, contiguous. With a `head`, suffix **truncation** and
+ * head-position tamper are detected.
+ *
+ * Frozen threat model — NOT detected from the array alone: suffix truncation without a head,
+ * a full rewrite-with-rechain, SHA-256 collisions. Durable anchoring is the docs-git layer.
+ */
+export declare function validate(events: ReadonlyArray<TrackEvent>, head?: Head | null): IntegrityResult;
+//# sourceMappingURL=validate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/events/validate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEpD,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1F;IACE,IAAI,EAAE,WAAW,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB,GACD;IACE,IAAI,EAAE,eAAe,CAAA;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACf,GACD;IACE,IAAI,EAAE,oBAAoB,CAAA;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACf,GACD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC7F;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1F;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAErF,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,OAAO,CAAA;IACX,QAAQ,EAAE,gBAAgB,EAAE,CAAA;CAC7B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CACtB,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,EACjC,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GACjB,eAAe,CAyFjB"}

package/dist/events/validate.js

@@ -0,0 +1,210 @@
+import { contentHashOf, stripFrame } from './frame.js';
+/**
+ * Integrity check over a stream (SPEC §3, A4 + A5). For each event in stream order:
+ * (i) recompute `contentHash` from the core (content tamper), (ii) `prevHash` equals the
+ * previous event's stored `contentHash` (insertion/reorder), (iii) per-aggregate `seq` is
+ * 1-based and strictly contiguous (drop/dup), (iv) an `aggregateId` keeps one `aggregate`
+ * type. Then per `cmdId`: `cmd` iff `cmdId`, a consistent positive integer `n`, every index
+ * unique in `[0,n)`, count `== n`, contiguous. With a `head`, suffix **truncation** and
+ * head-position tamper are detected.
+ *
+ * Frozen threat model — NOT detected from the array alone: suffix truncation without a head,
+ * a full rewrite-with-rechain, SHA-256 collisions. Durable anchoring is the docs-git layer.
+ */
+export function validate(events, head) {
+    const findings = [];
+    let prevHash = null;
+    const lastSeqByAggregate = new Map();
+    const aggregateKind = new Map();
+    for (let i = 0; i < events.length; i++) {
+        const e = events[i];
+        // (i) content tamper
+        const expectedHash = contentHashOf(stripFrame(e));
+        if (e.contentHash !== expectedHash) {
+            findings.push({
+                kind: 'content-hash',
+                index: i,
+                eventId: e.id,
+                expected: expectedHash,
+                actual: e.contentHash,
+            });
+        }
+        // (ii) positional chain (insertion / reorder)
+        if (e.prevHash !== prevHash) {
+            findings.push({
+                kind: 'prev-hash',
+                index: i,
+                eventId: e.id,
+                expected: prevHash,
+                actual: e.prevHash,
+            });
+        }
+        // (iii) per-aggregate seq: exact +1, 1-based
+        const expectedSeq = (lastSeqByAggregate.get(e.aggregateId) ?? 0) + 1;
+        if (e.seq !== expectedSeq) {
+            findings.push({
+                kind: 'aggregate-seq',
+                index: i,
+                eventId: e.id,
+                aggregateId: e.aggregateId,
+                expected: expectedSeq,
+                actual: e.seq,
+            });
+        }
+        lastSeqByAggregate.set(e.aggregateId, e.seq);
+        // (iv) one aggregateId keeps one aggregate type (ULID global uniqueness invariant)
+        const knownKind = aggregateKind.get(e.aggregateId);
+        if (knownKind === undefined) {
+            aggregateKind.set(e.aggregateId, e.aggregate);
+        }
+        else if (knownKind !== e.aggregate) {
+            findings.push({
+                kind: 'aggregate-mismatch',
+                index: i,
+                eventId: e.id,
+                aggregateId: e.aggregateId,
+                expected: knownKind,
+                actual: e.aggregate,
+            });
+        }
+        // batch frame: cmd iff cmdId
+        if (e.cmdId !== undefined && e.cmd === undefined) {
+            findings.push({
+                kind: 'batch-frame',
+                index: i,
+                eventId: e.id,
+                cmdId: e.cmdId,
+                reason: 'cmdId without cmd:{i,n}',
+            });
+        }
+        if (e.cmd !== undefined && e.cmdId === undefined) {
+            findings.push({
+                kind: 'batch-frame',
+                index: i,
+                eventId: e.id,
+                cmdId: null,
+                reason: 'cmd:{i,n} without cmdId',
+            });
+        }
+        prevHash = e.contentHash;
+    }
+    findings.push(...validateBatches(events));
+    findings.push(...validateHead(events, head));
+    return { ok: findings.length === 0, findings };
+}
+function validateBatches(events) {
+    const findings = [];
+    const batches = new Map();
+    events.forEach((e, index) => {
+        if (e.cmdId === undefined)
+            return;
+        const members = batches.get(e.cmdId) ?? [];
+        members.push({ index, i: e.cmd?.i, n: e.cmd?.n });
+        batches.set(e.cmdId, members);
+    });
+    for (const [cmdId, members] of batches) {
+        // Determine a consistent, valid n across members.
+        const declaredNs = [...new Set(members.map((m) => m.n).filter((n) => n !== undefined))];
+        if (declaredNs.length > 1) {
+            findings.push({
+                kind: 'partial-batch',
+                cmdId,
+                expected: -1,
+                actual: members.length,
+                reason: `inconsistent cmd.n across members: ${declaredNs.join(',')}`,
+            });
+            continue;
+        }
+        const n = declaredNs[0];
+        if (n === undefined || !Number.isInteger(n) || n <= 0) {
+            findings.push({
+                kind: 'partial-batch',
+                cmdId,
+                expected: -1,
+                actual: members.length,
+                reason: `invalid or missing cmd.n (${String(n)})`,
+            });
+            continue;
+        }
+        // count
+        if (members.length !== n) {
+            findings.push({
+                kind: 'partial-batch',
+                cmdId,
+                expected: n,
+                actual: members.length,
+                reason: `expected ${n} members, found ${members.length}`,
+            });
+        }
+        // contiguity in stream
+        const indices = members.map((m) => m.index);
+        const min = Math.min(...indices);
+        const max = Math.max(...indices);
+        if (max - min + 1 !== members.length) {
+            findings.push({ kind: 'batch-noncontiguous', cmdId, index: min });
+        }
+        // positions: each i an integer in [0,n), unique, covering 0..n-1
+        const seen = new Set();
+        for (const m of members) {
+            if (m.i === undefined || !Number.isInteger(m.i) || m.i < 0 || m.i >= n) {
+                findings.push({
+                    kind: 'partial-batch',
+                    cmdId,
+                    expected: n,
+                    actual: members.length,
+                    reason: `invalid cmd.i (${String(m.i)}) for n=${n}`,
+                });
+                continue;
+            }
+            if (seen.has(m.i)) {
+                findings.push({
+                    kind: 'partial-batch',
+                    cmdId,
+                    expected: n,
+                    actual: members.length,
+                    reason: `duplicate cmd.i (${m.i})`,
+                });
+            }
+            seen.add(m.i);
+        }
+        const missing = [];
+        for (let p = 0; p < n; p++) {
+            if (!seen.has(p))
+                missing.push(p);
+        }
+        if (missing.length > 0) {
+            findings.push({
+                kind: 'partial-batch',
+                cmdId,
+                expected: n,
+                actual: seen.size,
+                reason: `missing batch positions ${missing.join(',')}`,
+            });
+        }
+    }
+    return findings;
+}
+function validateHead(events, head) {
+    if (head === null || head === undefined)
+        return [];
+    // Suffix truncation: fewer events than the head recorded.
+    if (head.streamLength > events.length) {
+        return [{ kind: 'truncation', expected: head.streamLength, actual: events.length }];
+    }
+    // Tamper at the head position. (events.length > head.streamLength is a stale head — rebuildable, not an error.)
+    if (head.streamLength >= 1) {
+        const anchor = events[head.streamLength - 1];
+        if (anchor.contentHash !== head.lastContentHash) {
+            return [
+                {
+                    kind: 'head-mismatch',
+                    index: head.streamLength - 1,
+                    expected: head.lastContentHash,
+                    actual: anchor.contentHash,
+                },
+            ];
+        }
+    }
+    return [];
+}
+//# sourceMappingURL=validate.js.map

package/dist/events/validate.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { VERSION } from './version.js';
+export * from './events/index.js';
+export * from './model/index.js';
+export * from './state/index.js';
+export * from './accept/index.js';
+export * from './report/index.js';
+export * from './branch/index.js';
+export { Track, type ImportResult, type OpenBlockerInput, type TrackOptions } from './track.js';
+export { runCli, type CliIO } from './cli/index.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":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,KAAK,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAA;AAC/F,OAAO,EAAE,MAAM,EAAE,KAAK,KAAK,EAAE,MAAM,gBAAgB,CAAA"}