@sentropic/track 0.1.0 → 0.2.1

package/dist/mcp/cli.d.ts

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

package/dist/mcp/cli.d.ts.map

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

package/dist/mcp/cli.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+// `track-mcp` bin — a stdio read-only MCP server over the current dir's `.track/events.jsonl`.
+import { join } from 'node:path';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createTrackMcpServer } from './server.js';
+const eventsPath = join(process.cwd(), '.track', 'events.jsonl');
+const server = createTrackMcpServer(eventsPath);
+server.connect(new StdioServerTransport()).catch((error) => {
+    process.stderr.write(`track-mcp failed: ${error instanceof Error ? error.message : String(error)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/mcp/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/mcp/cli.ts"],"names":[],"mappings":";AACA,+FAA+F;AAC/F,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAEhF,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAElD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAA;AAChE,MAAM,MAAM,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAA;AAE/C,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAClE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACrG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,99 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { TrackReader } from '../read/contract.js';
+/** Read-only tools, declared as plain JSON Schema (no zod) — the curated read contract over MCP. */
+export declare const READ_TOOLS: readonly [{
+    readonly name: "track_report";
+    readonly description: "Bucketed backlog report (AWAITED/DROPPED/DONE/TO-DO) as JSON. AWAITED is relative to baselineCommit.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly baselineCommit: {
+                readonly type: "string";
+                readonly description: "Commit the report is evaluated against (acceptance/staleness).";
+            };
+            readonly requireAccepted: {
+                readonly type: "boolean";
+                readonly description: "A done item counts as DONE only if acceptance=pass.";
+            };
+            readonly decisions: {
+                readonly type: "boolean";
+                readonly description: "Include the decisions view.";
+            };
+        };
+        readonly required: readonly ["baselineCommit"];
+    };
+}, {
+    readonly name: "track_query";
+    readonly description: "Flat, filtered query over the non-decision report rows, as JSON.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly baselineCommit: {
+                readonly type: "string";
+            };
+            readonly kind: {
+                readonly type: "string";
+                readonly enum: readonly ["feature", "bug", "chore"];
+            };
+            readonly workspace: {
+                readonly type: "string";
+            };
+            readonly bucket: {
+                readonly type: "string";
+                readonly enum: readonly ["AWAITED", "DROPPED", "DONE", "TO-DO"];
+            };
+            readonly realization: {
+                readonly type: "string";
+                readonly enum: readonly ["to-do", "in-progress", "done", "cancelled", "rejected"];
+            };
+            readonly acceptance: {
+                readonly type: "string";
+                readonly enum: readonly ["pass", "fail", "unknown", "stale", "waived"];
+            };
+        };
+        readonly required: readonly ["baselineCommit"];
+    };
+}, {
+    readonly name: "track_validate";
+    readonly description: "Recompute the append-only integrity chain (detect-only). Returns {ok, findings}. NOTE: integrity only — unlike the CLI `validate`, it does NOT include prose↔log desync (that would read arbitrary cwd files, breaking the read-only contract).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "track_branch_provenance";
+    readonly description: "Latest branch.imported provenance for a BRANCH.md locator (or null).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly locator: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["locator"];
+    };
+}, {
+    readonly name: "track_freshness";
+    readonly description: "Is the sidecar structurally current with the given BRANCH.md content for a locator?";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly locator: {
+                readonly type: "string";
+            };
+            readonly content: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["locator", "content"];
+    };
+}];
+/**
+ * Pure tool dispatch — used by both the server handler and the parity test. Returns the tool's
+ * text payload (JSON), identical to the CLI's `--format json` output for report/query. Throws on a
+ * missing/invalid argument (the handler turns the throw into an MCP `isError` result).
+ */
+export declare function dispatchReadTool(reader: TrackReader, name: string, args: Record<string, unknown>): string;
+/** Build a read-only MCP server bound to one `.track/events.jsonl`. */
+export declare function createTrackMcpServer(eventsPath: string): Server;
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAA;AAIlE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAUjD,oGAAoG;AACpG,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqDb,CAAA;AAmCV;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAiCR;AAED,uEAAuE;AACvE,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAuB/D"}

package/dist/mcp/server.js

@@ -0,0 +1,168 @@
+// Lot v2.3a — read-only MCP server over the shared read command layer (read/commands.ts +
+// TrackReader). Thin adapter: every tool maps 1:1 to a read on a baseline the CALLER supplies
+// (no git in this layer). Read tools are side-effect-free — they never append to the event log.
+//
+// The low-level Server does NOT auto-validate args against the advertised inputSchema, so this
+// module validates every arg itself (enum + type) and surfaces violations as `isError` — matching
+// the CLI's `oneOf` strictness so the two transports never diverge on bad input.
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { queryText, reportText } from '../read/commands.js';
+import { TrackReader } from '../read/contract.js';
+import { VERSION } from '../version.js';
+// Allowed enum values — the single source for BOTH the advertised schema and runtime validation.
+const KINDS = ['feature', 'bug', 'chore'];
+const BUCKETS = ['AWAITED', 'DROPPED', 'DONE', 'TO-DO'];
+const REALIZATIONS = ['to-do', 'in-progress', 'done', 'cancelled', 'rejected'];
+const ACCEPTANCES = ['pass', 'fail', 'unknown', 'stale', 'waived'];
+/** Read-only tools, declared as plain JSON Schema (no zod) — the curated read contract over MCP. */
+export const READ_TOOLS = [
+    {
+        name: 'track_report',
+        description: 'Bucketed backlog report (AWAITED/DROPPED/DONE/TO-DO) as JSON. AWAITED is relative to baselineCommit.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                baselineCommit: { type: 'string', description: 'Commit the report is evaluated against (acceptance/staleness).' },
+                requireAccepted: { type: 'boolean', description: 'A done item counts as DONE only if acceptance=pass.' },
+                decisions: { type: 'boolean', description: 'Include the decisions view.' },
+            },
+            required: ['baselineCommit'],
+        },
+    },
+    {
+        name: 'track_query',
+        description: 'Flat, filtered query over the non-decision report rows, as JSON.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                baselineCommit: { type: 'string' },
+                kind: { type: 'string', enum: KINDS },
+                workspace: { type: 'string' },
+                bucket: { type: 'string', enum: BUCKETS },
+                realization: { type: 'string', enum: REALIZATIONS },
+                acceptance: { type: 'string', enum: ACCEPTANCES },
+            },
+            required: ['baselineCommit'],
+        },
+    },
+    {
+        name: 'track_validate',
+        description: 'Recompute the append-only integrity chain (detect-only). Returns {ok, findings}. NOTE: integrity only — unlike the CLI `validate`, it does NOT include prose↔log desync (that would read arbitrary cwd files, breaking the read-only contract).',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'track_branch_provenance',
+        description: 'Latest branch.imported provenance for a BRANCH.md locator (or null).',
+        inputSchema: {
+            type: 'object',
+            properties: { locator: { type: 'string' } },
+            required: ['locator'],
+        },
+    },
+    {
+        name: 'track_freshness',
+        description: 'Is the sidecar structurally current with the given BRANCH.md content for a locator?',
+        inputSchema: {
+            type: 'object',
+            properties: { locator: { type: 'string' }, content: { type: 'string' } },
+            required: ['locator', 'content'],
+        },
+    },
+];
+function reqStr(args, key) {
+    const v = args[key];
+    if (typeof v !== 'string')
+        throw new Error(`tool argument "${key}" must be a string`);
+    return v;
+}
+function optBool(args, key) {
+    const v = args[key];
+    if (v === undefined)
+        return undefined;
+    if (typeof v !== 'boolean')
+        throw new Error(`tool argument "${key}" must be a boolean`);
+    return v;
+}
+function optStr(args, key) {
+    const v = args[key];
+    if (v === undefined)
+        return undefined;
+    if (typeof v !== 'string')
+        throw new Error(`tool argument "${key}" must be a string`);
+    return v;
+}
+function optEnum(args, key, allowed) {
+    const v = args[key];
+    if (v === undefined)
+        return undefined;
+    if (typeof v !== 'string' || !allowed.includes(v)) {
+        throw new Error(`tool argument "${key}" must be one of: ${allowed.join(', ')}`);
+    }
+    return v;
+}
+/**
+ * Pure tool dispatch — used by both the server handler and the parity test. Returns the tool's
+ * text payload (JSON), identical to the CLI's `--format json` output for report/query. Throws on a
+ * missing/invalid argument (the handler turns the throw into an MCP `isError` result).
+ */
+export function dispatchReadTool(reader, name, args) {
+    switch (name) {
+        case 'track_report': {
+            const options = {
+                baselineCommit: reqStr(args, 'baselineCommit'),
+                requireAccepted: optBool(args, 'requireAccepted') ?? false,
+                decisions: optBool(args, 'decisions') ?? false,
+            };
+            return reportText(reader, options, 'json');
+        }
+        case 'track_query': {
+            const filter = {};
+            const kind = optEnum(args, 'kind', KINDS);
+            if (kind !== undefined)
+                filter.kind = kind;
+            const workspace = optStr(args, 'workspace');
+            if (workspace !== undefined)
+                filter.workspace = workspace;
+            const bucket = optEnum(args, 'bucket', BUCKETS);
+            if (bucket !== undefined)
+                filter.bucket = bucket;
+            const realization = optEnum(args, 'realization', REALIZATIONS);
+            if (realization !== undefined)
+                filter.realization = realization;
+            const acceptance = optEnum(args, 'acceptance', ACCEPTANCES);
+            if (acceptance !== undefined)
+                filter.acceptance = acceptance;
+            return queryText(reader, filter, { baselineCommit: reqStr(args, 'baselineCommit') }, 'json');
+        }
+        case 'track_validate':
+            return JSON.stringify(reader.validate(), null, 2);
+        case 'track_branch_provenance':
+            return JSON.stringify(reader.branchProvenance(reqStr(args, 'locator')) ?? null, null, 2);
+        case 'track_freshness':
+            return JSON.stringify(reader.freshness(reqStr(args, 'content'), reqStr(args, 'locator')), null, 2);
+        default:
+            throw new Error(`unknown tool: ${name}`);
+    }
+}
+/** Build a read-only MCP server bound to one `.track/events.jsonl`. */
+export function createTrackMcpServer(eventsPath) {
+    const reader = new TrackReader(eventsPath);
+    const server = new Server({ name: '@sentropic/track', version: VERSION }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, () => ({ tools: READ_TOOLS }));
+    server.setRequestHandler(CallToolRequestSchema, (request) => {
+        const { name, arguments: args } = request.params;
+        try {
+            const text = dispatchReadTool(reader, name, (args ?? {}));
+            return { content: [{ type: 'text', text }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: error instanceof Error ? error.message : String(error) }],
+                isError: true,
+            };
+        }
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/read/commands.d.ts

@@ -0,0 +1,8 @@
+import { type Format } from '../report/format.js';
+import type { QueryFilter, ReportOptions } from '../report/build.js';
+import type { TrackReader } from './contract.js';
+/** `report` rendered exactly as the CLI renders it (SPEC §7). */
+export declare function reportText(reader: TrackReader, options: ReportOptions, format: Format): string;
+/** `query` rendered exactly as the CLI renders it: raw JSON for `json`, else the row formatter. */
+export declare function queryText(reader: TrackReader, filter: QueryFilter, options: ReportOptions, format: Format): string;
+//# sourceMappingURL=commands.d.ts.map

package/dist/read/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/read/commands.ts"],"names":[],"mappings":"AAKA,OAAO,EAA4B,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE9F;AAED,mGAAmG;AACnG,wBAAgB,SAAS,CACvB,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,MAAM,GACb,MAAM,CAGR"}

package/dist/read/commands.js

@@ -0,0 +1,15 @@
+// Lot v2.3a — transport-agnostic READ command layer. CLI and the MCP server are thin adapters over
+// these pure functions: a `TrackReader` (no git/fs beyond the event log) + the SAME formatters, with
+// the adapter supplying `baselineCommit` (CLI from git HEAD, MCP from a tool argument). This is what
+// makes CLI≡MCP parity STRUCTURAL (one layer), not coincidental.
+import { formatReport, formatRows } from '../report/format.js';
+/** `report` rendered exactly as the CLI renders it (SPEC §7). */
+export function reportText(reader, options, format) {
+    return formatReport(reader.report(options), format);
+}
+/** `query` rendered exactly as the CLI renders it: raw JSON for `json`, else the row formatter. */
+export function queryText(reader, filter, options, format) {
+    const rows = reader.query(filter, options);
+    return format === 'json' ? `${JSON.stringify(rows, null, 2)}\n` : formatRows(rows, format);
+}
+//# sourceMappingURL=commands.js.map

package/dist/read/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/read/commands.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,qGAAqG;AACrG,qGAAqG;AACrG,iEAAiE;AAEjE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAe,MAAM,qBAAqB,CAAA;AAI3E,iEAAiE;AACjE,MAAM,UAAU,UAAU,CAAC,MAAmB,EAAE,OAAsB,EAAE,MAAc;IACpF,OAAO,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAA;AACrD,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,SAAS,CACvB,MAAmB,EACnB,MAAmB,EACnB,OAAsB,EACtB,MAAc;IAEd,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC1C,OAAO,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;AAC5F,CAAC"}

package/dist/read/contract.d.ts

@@ -0,0 +1,77 @@
+import type { Sha256 } from '../events/types.js';
+import { type IntegrityResult } from '../events/validate.js';
+import { type QueryFilter, type Report, type ReportOptions, type ReportRow } from '../report/build.js';
+/**
+ * Semver of the skill-facing READ contract.
+ *
+ * **Policy (PLAN-v2 D7 — additive-only):** within a major, the `TrackReader` surface and the
+ * shapes it returns may only GROW (new methods / new optional fields); nothing is removed or
+ * repurposed without a major bump. Consumers gate on `reader.contractVersion`.
+ */
+export declare const READ_CONTRACT_VERSION = "1.0.0";
+/** Provenance of the last `branch.imported` for a locator (drawn from the raw event log). */
+export interface BranchProvenance {
+    locator: string;
+    branchSlug: string;
+    /** sha256 of the raw BRANCH.md bytes at import (audit). */
+    sourceHash: Sha256;
+    /** sha256 of the reconciled structural projection — drives freshness. */
+    structureHash: Sha256;
+    at: string;
+}
+/** Result of comparing live BRANCH.md content against the last imported structure. */
+export type Freshness = {
+    status: 'fresh';
+    structureHash: Sha256;
+} | {
+    status: 'stale';
+    expected: Sha256;
+    actual: Sha256;
+} | {
+    status: 'absent';
+};
+/** Thrown by `requireFresh` when the sidecar is unsafe to consume (stale, absent, or tampered). */
+export declare class StaleSidecarError extends Error {
+    readonly detail: {
+        locator: string;
+        freshness: Freshness;
+        integrityOk: boolean;
+    };
+    constructor(message: string, detail: {
+        locator: string;
+        freshness: Freshness;
+        integrityOk: boolean;
+    });
+}
+/**
+ * Read-only, versioned consumption surface over a frozen track log. Holds NO `git` and only reads
+ * the event file/head via `fs` — a baseline commit is supplied by the caller via `ReportOptions`
+ * (the adapter owns `git`, not this layer — PLAN-v2 stack note).
+ */
+export declare class TrackReader {
+    private readonly eventsPath;
+    readonly contractVersion = "1.0.0";
+    private readonly store;
+    constructor(eventsPath: string);
+    private events;
+    /** Bucketed backlog report (SPEC §7). */
+    report(options: ReportOptions): Report;
+    /** Flat, filtered query over report rows (SPEC §6). */
+    query(filter: QueryFilter, options: ReportOptions): ReportRow[];
+    /** Recompute the integrity chain (SPEC §3) — pure detector, never repairs. */
+    validate(): IntegrityResult;
+    /** Latest VALID `branch.imported` provenance for `locator`, or `undefined`. */
+    branchProvenance(locator: string): BranchProvenance | undefined;
+    /** Compare current BRANCH.md `content` against the last imported structure for `locator`. */
+    freshness(content: string, locator: string): Freshness;
+    /**
+     * Fail-closed guard for skill consumers (`scope-check`/`lot-gate`): throws `StaleSidecarError`
+     * unless the sidecar is FRESH against the given BRANCH.md AND the log integrity is intact.
+     * BRANCH.md stays master — a stale or tampered sidecar must NEVER be trusted as the backlog.
+     * Reads the log ONCE for both checks.
+     */
+    requireFresh(content: string, locator: string): void;
+    private provenanceFrom;
+    private freshnessFrom;
+}
+//# sourceMappingURL=contract.d.ts.map

package/dist/read/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/read/contract.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,MAAM,EAAc,MAAM,oBAAoB,CAAA;AAC5D,OAAO,EAAY,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACtE,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,MAAM,EACX,KAAK,aAAa,EAClB,KAAK,SAAS,EACf,MAAM,oBAAoB,CAAA;AAG3B;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,UAAU,CAAA;AAE5C,6FAA6F;AAC7F,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAA;IAClB,yEAAyE;IACzE,aAAa,EAAE,MAAM,CAAA;IACrB,EAAE,EAAE,MAAM,CAAA;CACX;AAED,sFAAsF;AACtF,MAAM,MAAM,SAAS,GACjB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,CAAA;AAExB,mGAAmG;AACnG,qBAAa,iBAAkB,SAAQ,KAAK;IAGxC,QAAQ,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,SAAS,CAAC;QAAC,WAAW,EAAE,OAAO,CAAA;KAAE;gBADhF,OAAO,EAAE,MAAM,EACN,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,SAAS,CAAC;QAAC,WAAW,EAAE,OAAO,CAAA;KAAE;CAKnF;AAID;;;;GAIG;AACH,qBAAa,WAAW;IAIV,OAAO,CAAC,QAAQ,CAAC,UAAU;IAHvC,QAAQ,CAAC,eAAe,WAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;gBAEL,UAAU,EAAE,MAAM;IAI/C,OAAO,CAAC,MAAM;IAId,yCAAyC;IACzC,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM;IAItC,uDAAuD;IACvD,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,GAAG,SAAS,EAAE;IAI/D,8EAA8E;IAC9E,QAAQ,IAAI,eAAe;IAI3B,+EAA+E;IAC/E,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI/D,6FAA6F;IAC7F,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS;IAItD;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAcpD,OAAO,CAAC,cAAc;IA6BtB,OAAO,CAAC,aAAa;CAatB"}

package/dist/read/contract.js

@@ -0,0 +1,127 @@
+// Lot v2.0 — curated, VERSIONED read contract (PLAN-v2 M2a).
+//
+// The MVP barrel (`src/index.ts`) still `export *`s internals; that is the LIBRARY surface. THIS
+// module is the *skill-facing read contract* (`scope-check` / `lot-gate` consume it via the
+// `@sentropic/track/read` subpath) — reads only (report / query / validate / branch provenance /
+// freshness), never mutations, plus a fail-closed `requireFresh` guard so a stale OR tampered
+// sidecar can never become de-facto master over BRANCH.md (the source of truth — SPEC §5,
+// INTENTION §9 pin).
+import { branchId } from '../branch/parse.js';
+import { branchSignature } from '../branch/signature.js';
+import { readHead } from '../events/head.js';
+import { EventStore } from '../events/store.js';
+import { validate } from '../events/validate.js';
+import { buildReport, query as runQuery, } from '../report/build.js';
+import { fold } from '../state/fold.js';
+/**
+ * Semver of the skill-facing READ contract.
+ *
+ * **Policy (PLAN-v2 D7 — additive-only):** within a major, the `TrackReader` surface and the
+ * shapes it returns may only GROW (new methods / new optional fields); nothing is removed or
+ * repurposed without a major bump. Consumers gate on `reader.contractVersion`.
+ */
+export const READ_CONTRACT_VERSION = '1.0.0';
+/** Thrown by `requireFresh` when the sidecar is unsafe to consume (stale, absent, or tampered). */
+export class StaleSidecarError extends Error {
+    detail;
+    constructor(message, detail) {
+        super(message);
+        this.detail = detail;
+        this.name = 'StaleSidecarError';
+    }
+}
+const isSha256 = (v) => typeof v === 'string' && v.startsWith('sha256:');
+/**
+ * Read-only, versioned consumption surface over a frozen track log. Holds NO `git` and only reads
+ * the event file/head via `fs` — a baseline commit is supplied by the caller via `ReportOptions`
+ * (the adapter owns `git`, not this layer — PLAN-v2 stack note).
+ */
+export class TrackReader {
+    eventsPath;
+    contractVersion = READ_CONTRACT_VERSION;
+    store;
+    constructor(eventsPath) {
+        this.eventsPath = eventsPath;
+        this.store = new EventStore(eventsPath);
+    }
+    events() {
+        return this.store.readAll();
+    }
+    /** Bucketed backlog report (SPEC §7). */
+    report(options) {
+        return buildReport(fold(this.events()), options);
+    }
+    /** Flat, filtered query over report rows (SPEC §6). */
+    query(filter, options) {
+        return runQuery(fold(this.events()), filter, options);
+    }
+    /** Recompute the integrity chain (SPEC §3) — pure detector, never repairs. */
+    validate() {
+        return validate(this.events(), readHead(this.eventsPath));
+    }
+    /** Latest VALID `branch.imported` provenance for `locator`, or `undefined`. */
+    branchProvenance(locator) {
+        return this.provenanceFrom(this.events(), locator);
+    }
+    /** Compare current BRANCH.md `content` against the last imported structure for `locator`. */
+    freshness(content, locator) {
+        return this.freshnessFrom(this.events(), content, locator);
+    }
+    /**
+     * Fail-closed guard for skill consumers (`scope-check`/`lot-gate`): throws `StaleSidecarError`
+     * unless the sidecar is FRESH against the given BRANCH.md AND the log integrity is intact.
+     * BRANCH.md stays master — a stale or tampered sidecar must NEVER be trusted as the backlog.
+     * Reads the log ONCE for both checks.
+     */
+    requireFresh(content, locator) {
+        const events = this.events();
+        const freshness = this.freshnessFrom(events, content, locator);
+        const integrity = validate(events, readHead(this.eventsPath));
+        if (freshness.status !== 'fresh' || !integrity.ok) {
+            throw new StaleSidecarError(`track sidecar unsafe to consume for "${locator}": freshness=${freshness.status}, integrity=${integrity.ok ? 'ok' : 'broken'} — BRANCH.md stays master`, { locator, freshness, integrityOk: integrity.ok });
+        }
+    }
+    // ---- internals (single-read helpers) ----
+    provenanceFrom(events, locator) {
+        // The LATEST `branch.imported` for the locator is authoritative. Find it regardless of shape,
+        // THEN validate its payload. A malformed latest stamp fails CLOSED (→ undefined → `absent` →
+        // requireFresh throws); we must NOT fall back to an older valid stamp, or a re-pointed/tampered
+        // latest import could read as an earlier "fresh" state even though validate passes.
+        let latest;
+        for (const e of events) {
+            if (e.type !== 'branch.imported')
+                continue;
+            if (e.payload.locator !== locator)
+                continue;
+            latest = e;
+        }
+        if (!latest)
+            return undefined;
+        const p = latest.payload;
+        if (typeof p.branchSlug !== 'string' || !isSha256(p.sourceHash) || !isSha256(p.structureHash)) {
+            return undefined;
+        }
+        return {
+            locator,
+            branchSlug: p.branchSlug,
+            sourceHash: p.sourceHash,
+            structureHash: p.structureHash,
+            at: latest.at,
+        };
+    }
+    freshnessFrom(events, content, locator) {
+        const prov = this.provenanceFrom(events, locator);
+        if (!prov)
+            return { status: 'absent' };
+        const actual = branchSignature(content);
+        // Freshness is only AUTHORITATIVE when the content carries a `BR-NN` id — the one identity
+        // import and reader provably agree on. Without it, the import's branchSlug may derive from a
+        // fileSlug (or title) the reader cannot reproduce, so even an exact structureHash match could be
+        // coincidental → fail closed (stale), never fresh.
+        if (branchId(content) === undefined || actual !== prov.structureHash) {
+            return { status: 'stale', expected: prov.structureHash, actual };
+        }
+        return { status: 'fresh', structureHash: actual };
+    }
+}
+//# sourceMappingURL=contract.js.map

package/dist/read/contract.js.map

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

package/dist/read/index.d.ts

@@ -0,0 +1,2 @@
+export { READ_CONTRACT_VERSION, StaleSidecarError, TrackReader, type BranchProvenance, type Freshness, } from './contract.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/read/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,WAAW,EACX,KAAK,gBAAgB,EACrB,KAAK,SAAS,GACf,MAAM,eAAe,CAAA"}

package/dist/read/index.js

@@ -0,0 +1,3 @@
+// Read contract barrel (Lot v2.0) — the skill-facing, versioned, read-only surface.
+export { READ_CONTRACT_VERSION, StaleSidecarError, TrackReader, } from './contract.js';
+//# sourceMappingURL=index.js.map

package/dist/read/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/read/index.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,WAAW,GAGZ,MAAM,eAAe,CAAA"}

package/dist/report/blocker-status.d.ts

@@ -0,0 +1,12 @@
+import type { BlockerState } from '../model/blocker.js';
+import type { ItemId } from '../model/item.js';
+import type { State } from '../state/fold.js';
+/**
+ * Authoritative openness of a blocker at a given `baselineCommit`. `resolvedByEvent` hard-closes
+ * first (manual/decision). For `linked-accepted` (dependency), openness = ref is not accepted at
+ * the baseline (revocable). All other rules fall back to the fold scalar `blocker.open`.
+ */
+export declare function effectiveBlockerOpen(state: State, blocker: BlockerState, baselineCommit: string): boolean;
+/** Open blockers targeting `itemId`, evaluated against `baselineCommit` (commit-relative). */
+export declare function effectiveOpenBlockersForItem(state: State, itemId: ItemId, baselineCommit: string): BlockerState[];
+//# sourceMappingURL=blocker-status.d.ts.map

package/dist/report/blocker-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocker-status.d.ts","sourceRoot":"","sources":["../../src/report/blocker-status.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAK7C;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,YAAY,EACrB,cAAc,EAAE,MAAM,GACrB,OAAO,CAMT;AAED,8FAA8F;AAC9F,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,GACrB,YAAY,EAAE,CAIhB"}

package/dist/report/blocker-status.js

@@ -0,0 +1,34 @@
+// Lot v2.2b — commit-relative ("hybrid-A") blocker openness for the `linked-accepted` rule.
+//
+// `fold()` is baseline-free, so it cannot evaluate acceptance (which is a function of
+// (state, baselineCommit) and is REVOCABLE). It therefore folds a `linked-accepted` blocker as
+// conservatively OPEN (never falsely closed). The AUTHORITATIVE openness is DERIVED HERE, at
+// report/query time, against the caller's `baselineCommit` — so a `linked-accepted` gate closes
+// only while its ref is accepted and RE-OPENS for free (no event) when the ref regresses.
+// Never call this from `fold` — it would pin the commit axis and break determinism.
+//
+// Settle-once rules (`decision`, `manual`, `linked-done`) keep their fold-scalar `blocker.open`.
+// Decision blockers ("blocked until a decision settles") are already covered by `kind:"decision"`
+// + the go/no-go batch that resolves them (`resolvedByEvent`), so no separate `decision-settled`
+// dependency rule is introduced here (see docs/plan/v2.2a-linked-accepted-DESIGN.md §4).
+import { acceptanceStatus } from '../accept/status.js';
+/** Acceptance statuses that CLOSE a `linked-accepted` gate — strict pass-only (owner policy P3). */
+const ACCEPTED_CLOSES = new Set(['pass']);
+/**
+ * Authoritative openness of a blocker at a given `baselineCommit`. `resolvedByEvent` hard-closes
+ * first (manual/decision). For `linked-accepted` (dependency), openness = ref is not accepted at
+ * the baseline (revocable). All other rules fall back to the fold scalar `blocker.open`.
+ */
+export function effectiveBlockerOpen(state, blocker, baselineCommit) {
+    if (blocker.resolvedByEvent)
+        return false;
+    if (blocker.kind === 'dependency' && blocker.resolutionRule === 'linked-accepted') {
+        return !ACCEPTED_CLOSES.has(acceptanceStatus(state, blocker.ref, baselineCommit));
+    }
+    return blocker.open;
+}
+/** Open blockers targeting `itemId`, evaluated against `baselineCommit` (commit-relative). */
+export function effectiveOpenBlockersForItem(state, itemId, baselineCommit) {
+    return [...state.blockers.values()].filter((b) => b.targetId === itemId && effectiveBlockerOpen(state, b, baselineCommit));
+}
+//# sourceMappingURL=blocker-status.js.map

package/dist/report/blocker-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocker-status.js","sourceRoot":"","sources":["../../src/report/blocker-status.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,EAAE;AACF,sFAAsF;AACtF,+FAA+F;AAC/F,6FAA6F;AAC7F,gGAAgG;AAChG,0FAA0F;AAC1F,oFAAoF;AACpF,EAAE;AACF,iGAAiG;AACjG,kGAAkG;AAClG,iGAAiG;AACjG,yFAAyF;AAEzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAMtD,oGAAoG;AACpG,MAAM,eAAe,GAAkC,IAAI,GAAG,CAAmB,CAAC,MAAM,CAAC,CAAC,CAAA;AAE1F;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAY,EACZ,OAAqB,EACrB,cAAsB;IAEtB,IAAI,OAAO,CAAC,eAAe;QAAE,OAAO,KAAK,CAAA;IACzC,IAAI,OAAO,CAAC,IAAI,KAAK,YAAY,IAAI,OAAO,CAAC,cAAc,KAAK,iBAAiB,EAAE,CAAC;QAClF,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAAA;IACnF,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,CAAA;AACrB,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,4BAA4B,CAC1C,KAAY,EACZ,MAAc,EACd,cAAsB;IAEtB,OAAO,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CACxC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,IAAI,oBAAoB,CAAC,KAAK,EAAE,CAAC,EAAE,cAAc,CAAC,CAC/E,CAAA;AACH,CAAC"}