ghostrail 0.0.0

package/dist/source/linear.js

@@ -0,0 +1,166 @@
+export const LINEAR_ENDPOINT = "https://api.linear.app/graphql";
+/**
+ * A default requester over `fetch`, authenticating with a Linear personal API
+ * key (sent verbatim in the Authorization header, per Linear's API).
+ */
+export function createFetchRequester(apiKey, endpoint = LINEAR_ENDPOINT, fetchImpl = fetch) {
+    return async (query, variables) => {
+        const response = await fetchImpl(endpoint, {
+            method: "POST",
+            headers: { "Content-Type": "application/json", Authorization: apiKey },
+            body: JSON.stringify({ query, variables }),
+        });
+        if (!response.ok) {
+            throw new Error(`Linear HTTP ${response.status}`);
+        }
+        const body = (await response.json());
+        if (body.errors !== undefined) {
+            throw new Error(`Linear GraphQL error: ${JSON.stringify(body.errors)}`);
+        }
+        return (body.data ?? {});
+    };
+}
+export const ELIGIBLE_ISSUES_QUERY = `
+query EligibleIssues($filter: IssueFilter!, $first: Int!) {
+  issues(filter: $filter, first: $first, orderBy: updatedAt) {
+    nodes { id identifier title url }
+  }
+}`;
+/**
+ * Build the Linear `IssueFilter` for an eligibility spec: state name, each label
+ * (via `and`), unassigned, and optionally scoped to a team key. Only the
+ * provided fields are included.
+ */
+export function buildIssueFilter(eligible, teamKey) {
+    const filter = {};
+    if (teamKey !== undefined)
+        filter.team = { key: { eq: teamKey } };
+    if (eligible.state !== undefined)
+        filter.state = { name: { eq: eligible.state } };
+    if (eligible.unassigned)
+        filter.assignee = { null: true };
+    if (eligible.labels.length > 0) {
+        filter.and = eligible.labels.map((name) => ({ labels: { some: { name: { eq: name } } } }));
+    }
+    return filter;
+}
+/** Extract issue nodes from an `issues` query payload, ignoring malformed nodes. */
+export function parseIssueNodes(data) {
+    const issues = data.issues;
+    const nodes = Array.isArray(issues?.nodes) ? issues.nodes : [];
+    const parsed = [];
+    for (const node of nodes) {
+        if (node === null || typeof node !== "object")
+            continue;
+        const record = node;
+        const { id, identifier, title, url } = record;
+        if (typeof id === "string" &&
+            typeof identifier === "string" &&
+            typeof title === "string" &&
+            typeof url === "string") {
+            parsed.push({ id, identifier, title, url });
+        }
+    }
+    return parsed;
+}
+const BOOTSTRAP_QUERY = `
+query Bootstrap($teamKey: String!) {
+  viewer { id }
+  workflowStates(filter: { team: { key: { eq: $teamKey } } }) {
+    nodes { id name }
+  }
+}`;
+const ISSUE_UPDATE = `
+mutation IssueUpdate($id: String!, $input: IssueUpdateInput!) {
+  issueUpdate(id: $id, input: $input) { success }
+}`;
+const COMMENT_CREATE = `
+mutation CommentCreate($input: CommentCreateInput!) {
+  commentCreate(input: $input) { success }
+}`;
+/**
+ * The Linear implementation of the {@link Source} port, over the GraphQL API
+ * (a headless `claude -p` has no Linear MCP). Claiming an item moves it to the
+ * in-progress state and assigns it to the acting user, which removes it from the
+ * eligible pool; reset returns it to the reset state, unassigned.
+ */
+export class LinearSource {
+    request;
+    opts;
+    bootstrap;
+    uuidByIdentifier = new Map();
+    constructor(request, opts) {
+        this.request = request;
+        this.opts = {
+            teamKey: opts.teamKey,
+            eligible: opts.eligible,
+            inProgressState: opts.inProgressState ?? "In Progress",
+            resetState: opts.resetState ?? opts.eligible.state ?? "Todo",
+            maxItems: opts.maxItems ?? 50,
+        };
+    }
+    async listEligible() {
+        const data = await this.request(ELIGIBLE_ISSUES_QUERY, {
+            filter: buildIssueFilter(this.opts.eligible, this.opts.teamKey),
+            first: this.opts.maxItems,
+        });
+        const nodes = parseIssueNodes(data);
+        for (const node of nodes)
+            this.uuidByIdentifier.set(node.identifier, node.id);
+        return nodes.map((node) => ({ id: node.identifier, title: node.title, url: node.url }));
+    }
+    async claim(item) {
+        const { viewerId, stateIdByName } = await this.ensureBootstrap();
+        const stateId = stateIdByName.get(this.opts.inProgressState);
+        await this.request(ISSUE_UPDATE, {
+            id: await this.uuidFor(item),
+            input: stateId === undefined ? { assigneeId: viewerId } : { stateId, assigneeId: viewerId },
+        });
+        return true;
+    }
+    async comment(item, body) {
+        await this.request(COMMENT_CREATE, { input: { issueId: await this.uuidFor(item), body } });
+    }
+    async reassignToHuman(item) {
+        const { viewerId } = await this.ensureBootstrap();
+        await this.request(ISSUE_UPDATE, {
+            id: await this.uuidFor(item),
+            input: { assigneeId: viewerId },
+        });
+    }
+    async reset(item) {
+        const { stateIdByName } = await this.ensureBootstrap();
+        const stateId = stateIdByName.get(this.opts.resetState);
+        await this.request(ISSUE_UPDATE, {
+            id: await this.uuidFor(item),
+            input: stateId === undefined ? { assigneeId: null } : { stateId, assigneeId: null },
+        });
+    }
+    async ensureBootstrap() {
+        if (this.bootstrap !== undefined)
+            return this.bootstrap;
+        const data = await this.request(BOOTSTRAP_QUERY, { teamKey: this.opts.teamKey });
+        const viewer = data.viewer;
+        const states = data.workflowStates?.nodes;
+        const stateIdByName = new Map();
+        if (Array.isArray(states)) {
+            for (const node of states) {
+                const record = node;
+                if (typeof record.id === "string" && typeof record.name === "string") {
+                    stateIdByName.set(record.name, record.id);
+                }
+            }
+        }
+        if (typeof viewer?.id !== "string")
+            throw new Error("Linear bootstrap: no viewer id");
+        this.bootstrap = { viewerId: viewer.id, stateIdByName };
+        return this.bootstrap;
+    }
+    async uuidFor(item) {
+        const cached = this.uuidByIdentifier.get(item.id);
+        if (cached !== undefined)
+            return cached;
+        throw new Error(`Linear: unknown issue ${item.id} (list eligible before acting on it)`);
+    }
+}
+//# sourceMappingURL=linear.js.map

package/dist/source/linear.js.map

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

package/dist/store/events.d.ts

@@ -0,0 +1,105 @@
+/**
+ * The append-only event is the source of truth (research Appendix C). A run row
+ * is a fold over its events, so a crashed mid-stage run still leaves a trail and
+ * the row is always rebuildable. `ts` is an epoch-millis timestamp stamped by
+ * the emitter.
+ */
+export type RunEvent = {
+    type: "claimed";
+    runId: string;
+    ts: number;
+    itemId: string;
+    title?: string;
+    kind?: string;
+} | {
+    type: "provisioned";
+    runId: string;
+    ts: number;
+    backend: string;
+    branch: string;
+} | {
+    type: "agent_finished";
+    runId: string;
+    ts: number;
+    status: string;
+    costUsd?: number;
+    tokensIn?: number;
+    tokensOut?: number;
+} | {
+    type: "gate_step";
+    runId: string;
+    ts: number;
+    name: string;
+    exitCode: number;
+    durationMs: number;
+} | {
+    type: "pr_opened";
+    runId: string;
+    ts: number;
+    prNumber: number;
+    prUrl: string;
+} | {
+    type: "artifact";
+    runId: string;
+    ts: number;
+    name: string;
+    hash: string;
+} | {
+    type: "outcome";
+    runId: string;
+    ts: number;
+    state: string;
+    error?: string;
+};
+/** A sink the loop emits run events to. A no-op sink means "don't record". */
+export interface EventSink {
+    emit(event: RunEvent): Promise<void>;
+}
+export interface GateStepRow {
+    name: string;
+    exitCode: number;
+    durationMs: number;
+}
+export interface ArtifactRef {
+    name: string;
+    hash: string;
+}
+/** The current run-row schema version, so stored rows can be migrated later. */
+export declare const ROW_SCHEMA_VERSION = 1;
+/** A run row: the folded, board-renderable view of one run's events. */
+export interface RunRow {
+    schemaVersion: number;
+    runId: string;
+    itemId?: string;
+    title?: string;
+    kind?: string;
+    backend?: string;
+    branch?: string;
+    /** Final outcome state (done/blocked/failed/noop/skipped), once known. */
+    state?: string;
+    costUsd?: number;
+    tokensIn?: number;
+    tokensOut?: number;
+    gate: GateStepRow[];
+    prNumber?: number;
+    prUrl?: string;
+    error?: string;
+    artifacts: ArtifactRef[];
+    /** Epoch millis of the first and last events seen. */
+    startedAt?: number;
+    finishedAt?: number;
+    /** Number of events folded into this row. */
+    events: number;
+}
+/** An empty row for a run id, before any event is applied. */
+export declare function emptyRow(runId: string): RunRow;
+/**
+ * Apply one event to a run row, returning the updated row (does not mutate the
+ * input). `startedAt` tracks the earliest `ts`, `finishedAt` the latest, and
+ * `events` counts applications. Later same-kind fields overwrite earlier ones;
+ * gate steps and artifacts accumulate in arrival order.
+ */
+export declare function applyEvent(row: RunRow, event: RunEvent): RunRow;
+/** Fold a run's events (in order) into its row. */
+export declare function foldRun(runId: string, events: readonly RunEvent[]): RunRow;
+//# sourceMappingURL=events.d.ts.map

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

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

package/dist/store/events.js

@@ -0,0 +1,64 @@
+/** The current run-row schema version, so stored rows can be migrated later. */
+export const ROW_SCHEMA_VERSION = 1;
+/** An empty row for a run id, before any event is applied. */
+export function emptyRow(runId) {
+    return { schemaVersion: ROW_SCHEMA_VERSION, runId, gate: [], artifacts: [], events: 0 };
+}
+/**
+ * Apply one event to a run row, returning the updated row (does not mutate the
+ * input). `startedAt` tracks the earliest `ts`, `finishedAt` the latest, and
+ * `events` counts applications. Later same-kind fields overwrite earlier ones;
+ * gate steps and artifacts accumulate in arrival order.
+ */
+export function applyEvent(row, event) {
+    const next = {
+        ...row,
+        events: row.events + 1,
+        startedAt: row.startedAt === undefined ? event.ts : Math.min(row.startedAt, event.ts),
+        finishedAt: row.finishedAt === undefined ? event.ts : Math.max(row.finishedAt, event.ts),
+        gate: [...row.gate],
+        artifacts: [...row.artifacts],
+    };
+    switch (event.type) {
+        case "claimed":
+            next.itemId = event.itemId;
+            if (event.title !== undefined)
+                next.title = event.title;
+            if (event.kind !== undefined)
+                next.kind = event.kind;
+            break;
+        case "provisioned":
+            next.backend = event.backend;
+            next.branch = event.branch;
+            break;
+        case "agent_finished":
+            if (event.costUsd !== undefined)
+                next.costUsd = event.costUsd;
+            if (event.tokensIn !== undefined)
+                next.tokensIn = event.tokensIn;
+            if (event.tokensOut !== undefined)
+                next.tokensOut = event.tokensOut;
+            break;
+        case "gate_step":
+            next.gate.push({ name: event.name, exitCode: event.exitCode, durationMs: event.durationMs });
+            break;
+        case "pr_opened":
+            next.prNumber = event.prNumber;
+            next.prUrl = event.prUrl;
+            break;
+        case "artifact":
+            next.artifacts.push({ name: event.name, hash: event.hash });
+            break;
+        case "outcome":
+            next.state = event.state;
+            if (event.error !== undefined)
+                next.error = event.error;
+            break;
+    }
+    return next;
+}
+/** Fold a run's events (in order) into its row. */
+export function foldRun(runId, events) {
+    return events.reduce(applyEvent, emptyRow(runId));
+}
+//# sourceMappingURL=events.js.map

package/dist/store/events.js.map

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

package/dist/store/file-store.d.ts

@@ -0,0 +1,49 @@
+import { type EventSink, type RunEvent, type RunRow } from "./events.js";
+export interface RunFilter {
+    state?: string;
+    /** Only runs whose startedAt is at or after this epoch-millis timestamp. */
+    since?: number;
+}
+export interface RetentionPolicy {
+    /** Drop run rows older than this many ms (by startedAt). */
+    retainRunsMs?: number;
+    /** Drop events older than this many ms (by ts). */
+    retainEventsMs?: number;
+    /** Drop artifacts older than this many ms (by mtime). */
+    retainArtifactsMs?: number;
+    /** Cap total artifact bytes; oldest are removed first when over. */
+    maxArtifactBytes?: number;
+}
+/**
+ * The local-by-default run store (research Appendix C). `events.ndjson` is the
+ * append-only source of truth; each run's row (`runs/<id>.json`) is the fold
+ * over its events, updated on every append; artifacts are content-addressed
+ * blobs under `artifacts/<sha256>`. Rows are rebuildable from the events, so a
+ * lost row is a re-fold, not an incident. Retention is tuned per tier.
+ *
+ * A derived SQLite index for O(1) history queries is a drop-in optimization over
+ * this same event log (Appendix C) and is deferred to a later phase.
+ */
+export declare class FileStore implements EventSink {
+    private readonly eventsPath;
+    private readonly runsDir;
+    private readonly artifactsDir;
+    constructor(dir: string);
+    emit(event: RunEvent): Promise<void>;
+    /** Append an event and fold it into the run's row. */
+    append(event: RunEvent): Promise<void>;
+    getRun(runId: string): Promise<RunRow | undefined>;
+    /** Rows matching the filter, newest first. */
+    listRuns(filter?: RunFilter): Promise<RunRow[]>;
+    /** The events for one run, in order (read from the source-of-truth log). */
+    getEvents(runId: string): Promise<RunEvent[]>;
+    /** Store a blob by content hash and return the sha256 hex id. */
+    putArtifact(content: string | Buffer): Promise<string>;
+    getArtifact(hash: string): Promise<Buffer | undefined>;
+    /** Apply retention: drop old rows, old events, and old/oversized artifacts. */
+    prune(policy: RetentionPolicy, now: number): Promise<void>;
+    private pruneEvents;
+    private pruneArtifacts;
+    private rowPath;
+}
+//# sourceMappingURL=file-store.d.ts.map

package/dist/store/file-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-store.d.ts","sourceRoot":"","sources":["../../src/store/file-store.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,KAAK,MAAM,EAAwB,MAAM,aAAa,CAAC;AAE/F,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;GASG;AACH,qBAAa,SAAU,YAAW,SAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,GAAG,EAAE,MAAM;IAMvB,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpC,sDAAsD;IAChD,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAWtC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAQxD,8CAA8C;IACxC,QAAQ,CAAC,MAAM,GAAE,SAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAyBzD,4EAA4E;IACtE,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAoBnD,iEAAiE;IAC3D,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQtD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAQ5D,+EAA+E;IACzE,KAAK,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAalD,WAAW;YAqBX,cAAc;IAsC5B,OAAO,CAAC,OAAO;CAGhB"}

package/dist/store/file-store.js

@@ -0,0 +1,188 @@
+import { createHash } from "node:crypto";
+import { appendFile, mkdir, readFile, readdir, rm, stat, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { applyEvent, emptyRow } from "./events.js";
+/**
+ * The local-by-default run store (research Appendix C). `events.ndjson` is the
+ * append-only source of truth; each run's row (`runs/<id>.json`) is the fold
+ * over its events, updated on every append; artifacts are content-addressed
+ * blobs under `artifacts/<sha256>`. Rows are rebuildable from the events, so a
+ * lost row is a re-fold, not an incident. Retention is tuned per tier.
+ *
+ * A derived SQLite index for O(1) history queries is a drop-in optimization over
+ * this same event log (Appendix C) and is deferred to a later phase.
+ */
+export class FileStore {
+    eventsPath;
+    runsDir;
+    artifactsDir;
+    constructor(dir) {
+        this.eventsPath = join(dir, "events.ndjson");
+        this.runsDir = join(dir, "runs");
+        this.artifactsDir = join(dir, "artifacts");
+    }
+    emit(event) {
+        return this.append(event);
+    }
+    /** Append an event and fold it into the run's row. */
+    async append(event) {
+        await mkdir(this.runsDir, { recursive: true });
+        await appendFile(this.eventsPath, `${JSON.stringify(event)}\n`, "utf8");
+        const current = (await this.getRun(event.runId)) ?? emptyRow(event.runId);
+        await writeFile(this.rowPath(event.runId), `${JSON.stringify(applyEvent(current, event))}\n`, "utf8");
+    }
+    async getRun(runId) {
+        try {
+            return JSON.parse(await readFile(this.rowPath(runId), "utf8"));
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /** Rows matching the filter, newest first. */
+    async listRuns(filter = {}) {
+        let names;
+        try {
+            names = await readdir(this.runsDir);
+        }
+        catch {
+            return [];
+        }
+        const rows = [];
+        for (const name of names) {
+            if (!name.endsWith(".json"))
+                continue;
+            try {
+                rows.push(JSON.parse(await readFile(join(this.runsDir, name), "utf8")));
+            }
+            catch {
+                // skip an unreadable row
+            }
+        }
+        const filtered = rows.filter((row) => (filter.state === undefined || row.state === filter.state) &&
+            (filter.since === undefined || (row.startedAt ?? 0) >= filter.since));
+        filtered.sort((a, b) => (b.startedAt ?? 0) - (a.startedAt ?? 0));
+        return filtered;
+    }
+    /** The events for one run, in order (read from the source-of-truth log). */
+    async getEvents(runId) {
+        let raw;
+        try {
+            raw = await readFile(this.eventsPath, "utf8");
+        }
+        catch {
+            return [];
+        }
+        const events = [];
+        for (const line of raw.split("\n")) {
+            if (line.length === 0)
+                continue;
+            try {
+                const event = JSON.parse(line);
+                if (event.runId === runId)
+                    events.push(event);
+            }
+            catch {
+                // skip a corrupt line
+            }
+        }
+        return events;
+    }
+    /** Store a blob by content hash and return the sha256 hex id. */
+    async putArtifact(content) {
+        const buffer = typeof content === "string" ? Buffer.from(content, "utf8") : content;
+        const hash = createHash("sha256").update(buffer).digest("hex");
+        await mkdir(this.artifactsDir, { recursive: true });
+        await writeFile(join(this.artifactsDir, hash), buffer);
+        return hash;
+    }
+    async getArtifact(hash) {
+        try {
+            return await readFile(join(this.artifactsDir, hash));
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /** Apply retention: drop old rows, old events, and old/oversized artifacts. */
+    async prune(policy, now) {
+        if (policy.retainRunsMs !== undefined) {
+            const cutoff = now - policy.retainRunsMs;
+            for (const row of await this.listRuns()) {
+                if ((row.startedAt ?? 0) < cutoff)
+                    await rm(this.rowPath(row.runId), { force: true });
+            }
+        }
+        if (policy.retainEventsMs !== undefined) {
+            await this.pruneEvents(now - policy.retainEventsMs);
+        }
+        await this.pruneArtifacts(policy, now);
+    }
+    async pruneEvents(cutoff) {
+        let raw;
+        try {
+            raw = await readFile(this.eventsPath, "utf8");
+        }
+        catch {
+            return;
+        }
+        const kept = raw
+            .split("\n")
+            .filter((line) => {
+            if (line.length === 0)
+                return false;
+            try {
+                return JSON.parse(line).ts >= cutoff;
+            }
+            catch {
+                return false;
+            }
+        })
+            .join("\n");
+        await writeFile(this.eventsPath, kept.length > 0 ? `${kept}\n` : "", "utf8");
+    }
+    async pruneArtifacts(policy, now) {
+        let names;
+        try {
+            names = await readdir(this.artifactsDir);
+        }
+        catch {
+            return;
+        }
+        const entries = [];
+        for (const hash of names) {
+            try {
+                const info = await stat(join(this.artifactsDir, hash));
+                entries.push({ hash, mtimeMs: info.mtimeMs, size: info.size });
+            }
+            catch {
+                // skip
+            }
+        }
+        let survivors = entries;
+        if (policy.retainArtifactsMs !== undefined) {
+            const cutoff = now - policy.retainArtifactsMs;
+            survivors = [];
+            for (const entry of entries) {
+                if (entry.mtimeMs < cutoff)
+                    await rm(join(this.artifactsDir, entry.hash), { force: true });
+                else
+                    survivors.push(entry);
+            }
+        }
+        if (policy.maxArtifactBytes !== undefined) {
+            survivors.sort((a, b) => a.mtimeMs - b.mtimeMs); // oldest first
+            let total = survivors.reduce((sum, e) => sum + e.size, 0);
+            for (const entry of survivors) {
+                if (total <= policy.maxArtifactBytes)
+                    break;
+                await rm(join(this.artifactsDir, entry.hash), { force: true });
+                total -= entry.size;
+            }
+        }
+    }
+    rowPath(runId) {
+        return join(this.runsDir, `${encodeURIComponent(runId)}.json`);
+    }
+}
+//# sourceMappingURL=file-store.js.map

package/dist/store/file-store.js.map

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

package/dist/store/index.d.ts

@@ -0,0 +1,3 @@
+export { applyEvent, type ArtifactRef, emptyRow, type EventSink, foldRun, type GateStepRow, ROW_SCHEMA_VERSION, type RunEvent, type RunRow, } from "./events.js";
+export { FileStore, type RetentionPolicy, type RunFilter } from "./file-store.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,KAAK,WAAW,EAChB,QAAQ,EACR,KAAK,SAAS,EACd,OAAO,EACP,KAAK,WAAW,EAChB,kBAAkB,EAClB,KAAK,QAAQ,EACb,KAAK,MAAM,GACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/store/index.js

@@ -0,0 +1,3 @@
+export { applyEvent, emptyRow, foldRun, ROW_SCHEMA_VERSION, } from "./events.js";
+export { FileStore } from "./file-store.js";
+//# sourceMappingURL=index.js.map

package/dist/store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAEV,QAAQ,EAER,OAAO,EAEP,kBAAkB,GAGnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,SAAS,EAAwC,MAAM,iBAAiB,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,3 @@
+/** The resolved ghostrail version string. */
+export declare const VERSION: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAmBA,6CAA6C;AAC7C,eAAO,MAAM,OAAO,EAAE,MAAsB,CAAC"}

package/dist/version.js

@@ -0,0 +1,21 @@
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+/**
+ * Read the ghostrail version from the package manifest at runtime so the CLI
+ * output and the published package can never drift. Falls back to "0.0.0" if
+ * the manifest cannot be read (e.g. an unusual install layout).
+ */
+function readVersion() {
+    try {
+        const pkgUrl = new URL("../package.json", import.meta.url);
+        const raw = readFileSync(fileURLToPath(pkgUrl), "utf8");
+        const pkg = JSON.parse(raw);
+        return typeof pkg.version === "string" ? pkg.version : "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+/** The resolved ghostrail version string. */
+export const VERSION = readVersion();
+//# sourceMappingURL=version.js.map