@sentropic/track 0.1.0

package/dist/report/format.js

@@ -0,0 +1,81 @@
+import { BUCKETS } from './buckets.js';
+const BACKSLASH = String.fromCharCode(92);
+// Markdown metacharacters escaped in `md` titles so a user title can't inject formatting.
+const MD_META = new Set([
+    BACKSLASH, '`', '*', '_', '[', ']', '{', '}', '(', ')', '#', '+', '|', '<', '>', '!', '~', '-',
+]);
+/** Collapse control characters (newlines, tabs, line separators) to single spaces. */
+function clean(s) {
+    let out = '';
+    let prevSpace = false;
+    for (const ch of s) {
+        const code = ch.codePointAt(0) ?? 0;
+        const isControlOrSpace = code < 0x20 || code === 0x7f || code === 0x2028 || code === 0x2029 || ch === ' ';
+        if (isControlOrSpace) {
+            if (!prevSpace) {
+                out += ' ';
+                prevSpace = true;
+            }
+        }
+        else {
+            out += ch;
+            prevSpace = false;
+        }
+    }
+    return out.trim();
+}
+/** A display-safe title: control-normalized for text, plus markdown-metacharacter-escaped for md. */
+function title(s, format) {
+    const t = clean(s);
+    if (format !== 'md')
+        return t;
+    let out = '';
+    for (const ch of t)
+        out += MD_META.has(ch) ? BACKSLASH + ch : ch;
+    return out;
+}
+function heading(label, count, format) {
+    return format === 'md' ? `## ${label} (${count})` : `${label} (${count})`;
+}
+function meta(r) {
+    return `${r.realization} · ${r.acceptance}${r.priority !== undefined ? ` · wsjf:${r.priority}` : ''}`;
+}
+function rowLine(r, format) {
+    return format === 'md'
+        ? `- **${title(r.title, format)}** — ${meta(r)}`
+        : `  - ${title(r.title, format)} [${meta(r)}]`;
+}
+export function formatReport(report, format) {
+    if (format === 'json')
+        return JSON.stringify(report, null, 2);
+    const lines = [];
+    for (const bucket of BUCKETS) {
+        const rows = report.buckets[bucket];
+        lines.push(heading(bucket, rows.length, format));
+        for (const r of rows)
+            lines.push(rowLine(r, format));
+        lines.push('');
+    }
+    if (report.decisions !== undefined) {
+        lines.push(heading('DECISIONS', report.decisions.length, format));
+        for (const d of report.decisions) {
+            const t = title(d.title, format);
+            lines.push(format === 'md'
+                ? `- **${t}** — ${d.decisionKind} · ${d.realization} · outcome:${d.outcome}`
+                : `  - ${t} [${d.decisionKind}, ${d.realization}, outcome:${d.outcome}]`);
+        }
+    }
+    return lines.join('\n').trimEnd() + '\n';
+}
+export function formatRows(rows, format) {
+    if (format === 'json')
+        return JSON.stringify(rows, null, 2);
+    if (rows.length === 0)
+        return '';
+    return (rows
+        .map((r) => format === 'md'
+        ? `- **${title(r.title, format)}** — ${r.bucket} · ${r.realization} · ${r.acceptance}`
+        : `  - ${title(r.title, format)} [${r.bucket}, ${r.realization}, ${r.acceptance}]`)
+        .join('\n') + '\n');
+}
+//# sourceMappingURL=format.js.map

package/dist/report/format.js.map

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

package/dist/report/index.d.ts

@@ -0,0 +1,4 @@
+export { BUCKETS, bucketOf, type Bucket, type ReportConfig } from './buckets.js';
+export { buildReport, query, type DecisionRow, type QueryFilter, type Report, type ReportOptions, type ReportRow, } from './build.js';
+export { formatReport, formatRows, type Format } from './format.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/report/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,MAAM,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAA;AAChF,OAAO,EACL,WAAW,EACX,KAAK,EACL,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,MAAM,EACX,KAAK,aAAa,EAClB,KAAK,SAAS,GACf,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAA"}

package/dist/report/index.js

@@ -0,0 +1,5 @@
+// report + query: bucket engine with SPEC §7 precedence (AWAITED > DROPPED > DONE > TO-DO).
+export { BUCKETS, bucketOf } from './buckets.js';
+export { buildReport, query, } from './build.js';
+export { formatReport, formatRows } from './format.js';
+//# sourceMappingURL=index.js.map

package/dist/report/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/report/index.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAkC,MAAM,cAAc,CAAA;AAChF,OAAO,EACL,WAAW,EACX,KAAK,GAMN,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAe,MAAM,aAAa,CAAA"}

package/dist/state/fold.d.ts

@@ -0,0 +1,25 @@
+import type { TrackEvent } from '../events/types.js';
+import type { CriterionState, EvidenceState } from '../model/acceptance.js';
+import type { BlockerState } from '../model/blocker.js';
+import type { DecisionState } from '../model/decision.js';
+import type { BlockerId, ItemId, ItemState } from '../model/item.js';
+/**
+ * Materialized state (SPEC §2). The fold *mechanism* (replay in stream order, per-aggregate by
+ * `seq`) is the frozen part (Lot 1); the *shape* below grows per lot. Acceptance *status* is a
+ * pure function of this state + a baselineCommit (see `accept/`), not stored here.
+ *
+ * Precondition: `events` is a VALIDATED stream (the store runs `validate` before every append).
+ */
+export interface State {
+    items: Map<ItemId, ItemState>;
+    decisions: Map<ItemId, DecisionState>;
+    blockers: Map<BlockerId, BlockerState>;
+    criteria: Map<string, CriterionState>;
+    evidence: Map<string, EvidenceState>;
+}
+export declare function fold(events: ReadonlyArray<TrackEvent>): State;
+/** Open blockers across the whole backlog (SPEC §2.9; report AWAITED bucket, §7). */
+export declare function openBlockers(state: State): BlockerState[];
+/** Open blockers targeting a given item. */
+export declare function openBlockersForItem(state: State, itemId: ItemId): BlockerState[];
+//# sourceMappingURL=fold.d.ts.map

package/dist/state/fold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fold.d.ts","sourceRoot":"","sources":["../../src/state/fold.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,KAAK,EACV,cAAc,EAEd,aAAa,EAEd,MAAM,wBAAwB,CAAA;AAC/B,OAAO,KAAK,EAAwB,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAC7E,OAAO,KAAK,EAEV,aAAa,EAGd,MAAM,sBAAsB,CAAA;AAG7B,OAAO,KAAK,EACV,SAAS,EAIT,MAAM,EACN,SAAS,EAGV,MAAM,kBAAkB,CAAA;AAEzB;;;;;;GAMG;AACH,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAC7B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IACrC,QAAQ,EAAE,GAAG,CAAC,SAAS,EAAE,YAAY,CAAC,CAAA;IACtC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IACrC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;CACrC;AAYD,wBAAgB,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,KAAK,CAS7D;AAED,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY,EAAE,CAEzD;AAED,4CAA4C;AAC5C,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE,CAEhF"}

package/dist/state/fold.js

@@ -0,0 +1,208 @@
+import { isSettled } from '../model/decision.js';
+function emptyState() {
+    return {
+        items: new Map(),
+        decisions: new Map(),
+        blockers: new Map(),
+        criteria: new Map(),
+        evidence: new Map(),
+    };
+}
+export function fold(events) {
+    const state = emptyState();
+    for (const event of events) {
+        applyEvent(state, event);
+    }
+    for (const blocker of state.blockers.values()) {
+        blocker.open = isOpen(blocker, state.items);
+    }
+    return state;
+}
+/** Open blockers across the whole backlog (SPEC §2.9; report AWAITED bucket, §7). */
+export function openBlockers(state) {
+    return [...state.blockers.values()].filter((b) => b.open);
+}
+/** Open blockers targeting a given item. */
+export function openBlockersForItem(state, itemId) {
+    return openBlockers(state).filter((b) => b.targetId === itemId);
+}
+function applyEvent(state, event) {
+    switch (event.type) {
+        case 'item.created': {
+            const payload = event.payload;
+            const item = {
+                id: event.aggregateId,
+                kind: payload.kind,
+                title: payload.title,
+                workspace: payload.workspace,
+                specStatus: payload.kind === 'decision' ? 'n/a' : 'to-specify',
+                realization: 'to-do',
+                disposition: { orientation: 'required', commitment: 'required' },
+                ...(payload.parentId !== undefined ? { parentId: payload.parentId } : {}),
+                ...(payload.sourceKey !== undefined ? { sourceKey: payload.sourceKey } : {}),
+                ...(payload.body !== undefined ? { body: payload.body } : {}),
+                ...(payload.links !== undefined ? { links: payload.links } : {}),
+            };
+            state.items.set(item.id, item);
+            break;
+        }
+        case 'decision.created': {
+            const payload = event.payload;
+            const decision = {
+                id: event.aggregateId,
+                kind: 'decision',
+                title: payload.title,
+                workspace: payload.workspace,
+                realization: 'to-do',
+                decisionKind: payload.decisionKind,
+                targets: payload.targets,
+                outcome: 'pending',
+                dossier: payload.dossier,
+                ...(payload.parentId !== undefined ? { parentId: payload.parentId } : {}),
+                ...(payload.sourceKey !== undefined ? { sourceKey: payload.sourceKey } : {}),
+                ...(payload.body !== undefined ? { body: payload.body } : {}),
+                ...(payload.links !== undefined ? { links: payload.links } : {}),
+            };
+            state.decisions.set(decision.id, decision);
+            break;
+        }
+        case 'spec.transition': {
+            const item = state.items.get(event.aggregateId);
+            if (item)
+                item.specStatus = event.payload.to;
+            break;
+        }
+        case 'realization.transition': {
+            const target = state.items.get(event.aggregateId) ?? state.decisions.get(event.aggregateId);
+            if (target)
+                target.realization = event.payload.to;
+            break;
+        }
+        case 'decision.outcome': {
+            const decision = state.decisions.get(event.aggregateId);
+            if (!decision)
+                break;
+            const to = event.payload.to;
+            decision.outcome = to; // legality is checked at append; fold takes the latest in stream order
+            if (isSettled(to)) {
+                for (const targetId of decision.targets) {
+                    const target = state.items.get(targetId);
+                    if (target)
+                        target.disposition[decision.decisionKind] = 'completed';
+                }
+            }
+            break;
+        }
+        case 'decision.disposition': {
+            const payload = event.payload;
+            const item = state.items.get(payload.itemId);
+            if (item)
+                item.disposition[payload.gate] = payload.disposition;
+            break;
+        }
+        case 'dossier.revised': {
+            const decision = state.decisions.get(event.aggregateId);
+            if (decision)
+                decision.dossier = event.payload.dossier;
+            break;
+        }
+        case 'acceptance.criterion.added': {
+            const payload = event.payload;
+            state.criteria.set(payload.criterionId, {
+                id: payload.criterionId,
+                itemId: event.aggregateId,
+                statement: payload.statement,
+            });
+            break;
+        }
+        case 'acceptance.evidence.linked': {
+            const payload = event.payload;
+            state.evidence.set(payload.evidenceId, {
+                id: payload.evidenceId,
+                criterionId: payload.criterionId,
+                kind: payload.kind,
+                locator: payload.locator,
+            });
+            break;
+        }
+        case 'acceptance.run': {
+            const payload = event.payload;
+            const evidence = state.evidence.get(payload.evidenceId);
+            // latest run wins (stream order)
+            if (evidence) {
+                evidence.latestRun = {
+                    evidenceId: payload.evidenceId,
+                    commit: payload.commit,
+                    env: payload.env,
+                    runner: payload.runner,
+                    result: payload.result,
+                    at: event.at,
+                };
+            }
+            break;
+        }
+        case 'acceptance.waived': {
+            const payload = event.payload;
+            const criterion = state.criteria.get(payload.criterionId);
+            if (criterion) {
+                criterion.waiver = {
+                    criterionId: payload.criterionId,
+                    reason: payload.reason,
+                    by: payload.by,
+                    at: event.at,
+                };
+            }
+            break;
+        }
+        case 'blocker.opened': {
+            const payload = event.payload;
+            const resolutionRule = payload.resolutionRule ?? (payload.kind === 'dependency' ? 'linked-done' : undefined);
+            const blocker = {
+                id: event.aggregateId,
+                targetId: payload.targetId,
+                kind: payload.kind,
+                ref: payload.ref,
+                reason: payload.reason,
+                openedAt: event.at,
+                resolvedByEvent: false,
+                open: true,
+                ...(resolutionRule !== undefined ? { resolutionRule } : {}),
+                ...(payload.owner !== undefined ? { owner: payload.owner } : {}),
+            };
+            state.blockers.set(blocker.id, blocker);
+            break;
+        }
+        case 'blocker.resolved': {
+            const blocker = state.blockers.get(event.aggregateId);
+            if (blocker) {
+                blocker.resolvedByEvent = true;
+                blocker.resolvedAt = event.at;
+            }
+            break;
+        }
+        case 'priority.assessed': {
+            const payload = event.payload;
+            const item = state.items.get(event.aggregateId);
+            if (item)
+                item.priority = payload; // latest in stream order = live priority (SPEC §2.8)
+            break;
+        }
+        default:
+            // branch.imported provenance is folded in Lot 6.
+            break;
+    }
+}
+function isOpen(blocker, items) {
+    if (blocker.resolvedByEvent)
+        return false;
+    // Dependency default is linked-done (robust even if the rule was omitted upstream).
+    if (blocker.kind === 'dependency' && (blocker.resolutionRule ?? 'linked-done') === 'linked-done') {
+        // NOTE (open question, flagged for Lot 5): a ref that ends `cancelled`/`rejected` keeps this
+        // blocker OPEN (target stays AWAITED) — SPEC §2.9 resolves only on ref `done`. Reversible.
+        return items.get(blocker.ref)?.realization !== 'done';
+    }
+    // decision blockers, manual dependency blockers, and (until Lot 4) linked-accepted stay open
+    // until an explicit blocker.resolved event (a decision blocker resolves on its go/no-go batch).
+    return true;
+}
+//# sourceMappingURL=fold.js.map

package/dist/state/fold.js.map

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

package/dist/state/index.d.ts

@@ -0,0 +1,3 @@
+export { fold, openBlockers, openBlockersForItem, type State } from './fold.js';
+export { deserializeState, loadLatestSnapshot, saveSnapshot, serializeState, type SerializedState, type Snapshot, } from './snapshot.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,mBAAmB,EAAE,KAAK,KAAK,EAAE,MAAM,WAAW,CAAA;AAC/E,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,QAAQ,GACd,MAAM,eAAe,CAAA"}

package/dist/state/index.js

@@ -0,0 +1,4 @@
+// State: fold(events) -> materialized state, rebuildable snapshots (SPEC §2, §3, §4).
+export { fold, openBlockers, openBlockersForItem } from './fold.js';
+export { deserializeState, loadLatestSnapshot, saveSnapshot, serializeState, } from './snapshot.js';
+//# sourceMappingURL=index.js.map

package/dist/state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,mBAAmB,EAAc,MAAM,WAAW,CAAA;AAC/E,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,cAAc,GAGf,MAAM,eAAe,CAAA"}

package/dist/state/snapshot.d.ts

@@ -0,0 +1,27 @@
+import type { TrackEvent } from '../events/types.js';
+import type { CriterionState, EvidenceState } from '../model/acceptance.js';
+import type { BlockerState } from '../model/blocker.js';
+import type { DecisionState } from '../model/decision.js';
+import type { ItemState } from '../model/item.js';
+import { type State } from './fold.js';
+/**
+ * Snapshots are NON-AUTHORITATIVE caches of `fold(events)` keyed by stream length
+ * (SPEC §4: `.track/snapshots/<len>.json`). The append-only log is always the source of truth;
+ * a snapshot can be deleted and rebuilt by re-folding.
+ */
+export interface SerializedState {
+    items: ItemState[];
+    decisions: DecisionState[];
+    blockers: BlockerState[];
+    criteria: CriterionState[];
+    evidence: EvidenceState[];
+}
+export interface Snapshot {
+    streamLength: number;
+    state: SerializedState;
+}
+export declare function serializeState(state: State): SerializedState;
+export declare function deserializeState(serialized: Partial<SerializedState>): State;
+export declare function saveSnapshot(trackDir: string, events: ReadonlyArray<TrackEvent>): Snapshot;
+export declare function loadLatestSnapshot(trackDir: string): Snapshot | null;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/state/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/state/snapshot.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAQ,KAAK,KAAK,EAAE,MAAM,WAAW,CAAA;AAE5C;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,SAAS,EAAE,CAAA;IAClB,SAAS,EAAE,aAAa,EAAE,CAAA;IAC1B,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB,QAAQ,EAAE,cAAc,EAAE,CAAA;IAC1B,QAAQ,EAAE,aAAa,EAAE,CAAA;CAC1B;AAED,MAAM,WAAW,QAAQ;IACvB,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,eAAe,CAAA;CACvB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,eAAe,CAS5D;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,KAAK,CAU5E;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,QAAQ,CAS1F;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAWpE"}

package/dist/state/snapshot.js

@@ -0,0 +1,49 @@
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { fold } from './fold.js';
+export function serializeState(state) {
+    // Structured-clone so a caller mutating the serialized form cannot corrupt a live fold.
+    return {
+        items: [...state.items.values()].map((i) => structuredClone(i)),
+        decisions: [...state.decisions.values()].map((d) => structuredClone(d)),
+        blockers: [...state.blockers.values()].map((b) => structuredClone(b)),
+        criteria: [...state.criteria.values()].map((c) => structuredClone(c)),
+        evidence: [...state.evidence.values()].map((e) => structuredClone(e)),
+    };
+}
+export function deserializeState(serialized) {
+    // Tolerate older (pre-Lot-4) snapshots missing newer collections — they are non-authoritative
+    // and rebuildable, so an absent array defaults to empty rather than crashing.
+    return {
+        items: new Map((serialized.items ?? []).map((i) => [i.id, i])),
+        decisions: new Map((serialized.decisions ?? []).map((d) => [d.id, d])),
+        blockers: new Map((serialized.blockers ?? []).map((b) => [b.id, b])),
+        criteria: new Map((serialized.criteria ?? []).map((c) => [c.id, c])),
+        evidence: new Map((serialized.evidence ?? []).map((e) => [e.id, e])),
+    };
+}
+export function saveSnapshot(trackDir, events) {
+    const snapshot = {
+        streamLength: events.length,
+        state: serializeState(fold(events)),
+    };
+    const dir = join(trackDir, 'snapshots');
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(join(dir, `${events.length}.json`), JSON.stringify(snapshot, null, 2));
+    return snapshot;
+}
+export function loadLatestSnapshot(trackDir) {
+    const dir = join(trackDir, 'snapshots');
+    if (!existsSync(dir))
+        return null;
+    const lengths = readdirSync(dir)
+        .filter((f) => f.endsWith('.json'))
+        .map((f) => Number.parseInt(f, 10))
+        .filter((n) => !Number.isNaN(n))
+        .sort((a, b) => b - a);
+    const latest = lengths[0];
+    if (latest === undefined)
+        return null;
+    return JSON.parse(readFileSync(join(dir, `${latest}.json`), 'utf8'));
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/state/snapshot.js.map

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

package/dist/track.d.ts

@@ -0,0 +1,118 @@
+import { EventStore } from './events/store.js';
+import type { ActorId, Ulid } from './events/types.js';
+import { type RunReportFormat } from './accept/ingest.js';
+import { type QueryFilter, type Report, type ReportOptions, type ReportRow } from './report/build.js';
+import type { EvidenceKind, RunResult } from './model/acceptance.js';
+import { type PriorityAssessment, type WsjfInputs } from './model/priority.js';
+import { type BlockerKind, type ResolutionRule } from './model/blocker.js';
+import { type DecisionCreatedPayload, type Dossier, type Outcome } from './model/decision.js';
+import { type BlockerId, type Disposition, type Gate, type ItemCreatedPayload, type ItemId, type Realization, type SpecStatus } from './model/item.js';
+import { type State } from './state/fold.js';
+export interface ImportResult {
+    branchSlug: string;
+    featureId: ItemId;
+    created: number;
+    updated: number;
+}
+export interface TrackOptions {
+    /** Injectable clock (ISO-8601 ms). Defaults to wall clock. */
+    now?: () => string;
+    /** Injectable id generator. Defaults to ULID. */
+    newId?: () => Ulid;
+    /** Default actor recorded on events. */
+    by?: ActorId;
+}
+export interface OpenBlockerInput {
+    targetId: ItemId;
+    kind: BlockerKind;
+    ref: ItemId;
+    reason: string;
+    resolutionRule?: ResolutionRule;
+    owner?: ActorId;
+}
+/**
+ * Command facade over the frozen event store (SPEC §6). Each mutating command folds the current
+ * state, checks the transition against it (rejecting illegal ones BEFORE any append — SPEC §3),
+ * then appends. Lots 3+ extend this with decisions, acceptance, priority.
+ */
+export declare class Track {
+    private readonly store;
+    private readonly clock;
+    private readonly newId;
+    private readonly actor;
+    constructor(store: EventStore, opts?: TrackOptions);
+    /** Materialized state from a full replay of the log. */
+    state(): State;
+    createItem(input: ItemCreatedPayload): ItemId;
+    setSpec(itemId: ItemId, to: SpecStatus): void;
+    /**
+     * Public realization transitions: `in-progress`, `done`, `cancelled`. `rejected` is NOT
+     * settable here — it is the consequence of a `no-go` Decision (SPEC §2.3, §2.6) and is emitted
+     * internally by Lot 3's outcome batch (with a `cause`). `assertRealizationTransition(_, _, false)`
+     * rejects a direct `→rejected` here.
+     */
+    setRealization(itemId: ItemId, to: Realization): void;
+    /**
+     * Create a Decision (SPEC §2.5): emits `decision.created` + one `blocker.opened` (kind:decision)
+     * per target as ONE atomic batch (A7). Targets must be existing non-decision items (A3 recursion
+     * guard). The decision starts `outcome:"pending"`, leaving every target AWAITED until it settles.
+     */
+    createDecision(input: DecisionCreatedPayload): ItemId;
+    /**
+     * Settle (or defer) a Decision's outcome (SPEC §2.6). Legal: pending→{go,no-go,deferred};
+     * deferred→{go,no-go}; go/no-go terminal. Emits the effect as ONE atomic batch (A5):
+     * `go` resolves each target's decision blocker; `no-go` also rejects each non-terminal target
+     * (cause:{decisionId}); `deferred` emits only the outcome (target stays AWAITED).
+     */
+    setOutcome(decisionId: ItemId, to: Outcome): void;
+    reviseDossier(decisionId: ItemId, dossier: Dossier): void;
+    /**
+     * Set a gate disposition explicitly (SPEC §2.10). `completed` is NOT settable here — it is set
+     * automatically when a Decision of that gate targeting the item settles.
+     */
+    setDisposition(itemId: ItemId, gate: Gate, disposition: Disposition, reason?: string): void;
+    openBlocker(input: OpenBlockerInput): BlockerId;
+    resolveBlocker(blockerId: BlockerId): void;
+    /** Add an acceptance criterion to a non-decision item (A3 forbids criteria on a Decision). */
+    addCriterion(itemId: ItemId, statement: string): string;
+    linkEvidence(criterionId: string, kind: EvidenceKind, locator: string): string;
+    recordRun(evidenceId: string, run: {
+        commit: string;
+        env: string;
+        runner: string;
+        result: RunResult;
+    }): void;
+    waive(criterionId: string, reason: string): void;
+    /**
+     * Ingest a test report (`accept run --from`): match each entry to an evidence by `locator` and
+     * emit one `acceptance.run` per match as a single atomic batch. Returns the number of runs.
+     */
+    ingestRuns(content: string, format: RunReportFormat, run: {
+        commit: string;
+        env: string;
+        runner: string;
+    }): number;
+    /** Append a WSJF priority assessment; the latest becomes the item's live `priority`. */
+    assessPriority(itemId: ItemId, inputs: WsjfInputs): PriorityAssessment;
+    /** Bucketed backlog report over non-decision items (SPEC §7). */
+    report(options: ReportOptions): Report;
+    /** Flat, filtered query over the report rows (SPEC §6). */
+    query(filter: QueryFilter, options: ReportOptions): ReportRow[];
+    /**
+     * Idempotent, read-only import of a `BRANCH.md` file: derive a parent `feature` Item + one
+     * `chore` Item per lot (resolved by stable `sourceKey = branchSlug/lotSlug`), map lot `[x]`→done
+     * and nested UAT checkboxes → acceptance criteria (`[x]` → a manual pass run). Re-import emits
+     * ONLY deltas (survives lot reordering) and NEVER writes the file. Returns the change counts.
+     */
+    importBranch(content: string, opts: {
+        locator: string;
+        fileSlug?: string;
+        commit?: string;
+    }): ImportResult;
+    private evidenceOwner;
+    private requireItem;
+    private emit;
+    /** Append a command's events; a multi-event command is one atomic `cmdId` batch (SPEC §3). */
+    private emitBatch;
+}
+//# sourceMappingURL=track.d.ts.map

package/dist/track.d.ts.map

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