@ontrails/core 1.0.0-beta.13 → 1.0.0-beta.15

package/dist/internal/topo-snapshots.js

@@ -0,0 +1,372 @@
+import { ensureSubsystemSchema } from './trails-db.js';
+const TOPO_SUBSYSTEM = 'topo';
+const TOPO_TABLE_STATEMENTS = [
+    `CREATE TABLE IF NOT EXISTS topo_snapshots (
+    id TEXT PRIMARY KEY,
+    git_sha TEXT,
+    git_dirty INTEGER NOT NULL DEFAULT 0,
+    trail_count INTEGER NOT NULL DEFAULT 0,
+    signal_count INTEGER NOT NULL DEFAULT 0,
+    resource_count INTEGER NOT NULL DEFAULT 0,
+    pinned_as TEXT,
+    created_at TEXT NOT NULL
+  )`,
+    `CREATE TABLE IF NOT EXISTS topo_trails (
+    id TEXT NOT NULL,
+    intent TEXT,
+    idempotent INTEGER NOT NULL DEFAULT 0,
+    has_output INTEGER NOT NULL DEFAULT 0,
+    has_examples INTEGER NOT NULL DEFAULT 0,
+    example_count INTEGER NOT NULL DEFAULT 0,
+    description TEXT,
+    pattern TEXT,
+    meta TEXT,
+    snapshot_id TEXT NOT NULL,
+    PRIMARY KEY (id, snapshot_id),
+    FOREIGN KEY (snapshot_id) REFERENCES topo_snapshots(id) ON DELETE CASCADE
+  )`,
+    `CREATE TABLE IF NOT EXISTS topo_crossings (
+    source_id TEXT NOT NULL,
+    target_id TEXT NOT NULL,
+    snapshot_id TEXT NOT NULL,
+    PRIMARY KEY (source_id, target_id, snapshot_id),
+    FOREIGN KEY (snapshot_id) REFERENCES topo_snapshots(id) ON DELETE CASCADE
+  )`,
+    `CREATE TABLE IF NOT EXISTS topo_trail_resources (
+    trail_id TEXT NOT NULL,
+    resource_id TEXT NOT NULL,
+    snapshot_id TEXT NOT NULL,
+    PRIMARY KEY (trail_id, resource_id, snapshot_id),
+    FOREIGN KEY (snapshot_id) REFERENCES topo_snapshots(id) ON DELETE CASCADE
+  )`,
+    `CREATE TABLE IF NOT EXISTS topo_resources (
+    id TEXT NOT NULL,
+    has_mock INTEGER NOT NULL DEFAULT 0,
+    has_health INTEGER NOT NULL DEFAULT 0,
+    snapshot_id TEXT NOT NULL,
+    PRIMARY KEY (id, snapshot_id),
+    FOREIGN KEY (snapshot_id) REFERENCES topo_snapshots(id) ON DELETE CASCADE
+  )`,
+    `CREATE TABLE IF NOT EXISTS topo_signals (
+    id TEXT NOT NULL,
+    description TEXT,
+    snapshot_id TEXT NOT NULL,
+    PRIMARY KEY (id, snapshot_id),
+    FOREIGN KEY (snapshot_id) REFERENCES topo_snapshots(id) ON DELETE CASCADE
+  )`,
+    `CREATE TABLE IF NOT EXISTS topo_trail_signals (
+    trail_id TEXT NOT NULL,
+    signal_id TEXT NOT NULL,
+    snapshot_id TEXT NOT NULL,
+    PRIMARY KEY (trail_id, signal_id, snapshot_id),
+    FOREIGN KEY (snapshot_id) REFERENCES topo_snapshots(id) ON DELETE CASCADE
+  )`,
+    `CREATE TABLE IF NOT EXISTS topo_surfaces (
+    trail_id TEXT NOT NULL,
+    surface TEXT NOT NULL,
+    derived_name TEXT NOT NULL,
+    method TEXT,
+    snapshot_id TEXT NOT NULL,
+    PRIMARY KEY (trail_id, surface, snapshot_id),
+    FOREIGN KEY (snapshot_id) REFERENCES topo_snapshots(id) ON DELETE CASCADE
+  )`,
+    `CREATE TABLE IF NOT EXISTS topo_examples (
+    id TEXT PRIMARY KEY,
+    trail_id TEXT NOT NULL,
+    ordinal INTEGER NOT NULL,
+    name TEXT NOT NULL,
+    description TEXT,
+    input TEXT NOT NULL,
+    expected TEXT,
+    error TEXT,
+    snapshot_id TEXT NOT NULL,
+    FOREIGN KEY (snapshot_id) REFERENCES topo_snapshots(id) ON DELETE CASCADE
+  )`,
+    `CREATE TABLE IF NOT EXISTS topo_schemas (
+    owner_id TEXT NOT NULL,
+    owner_kind TEXT NOT NULL,
+    schema_kind TEXT NOT NULL,
+    zod_hash TEXT NOT NULL,
+    json_schema TEXT NOT NULL,
+    snapshot_id TEXT NOT NULL,
+    PRIMARY KEY (owner_id, owner_kind, schema_kind, snapshot_id),
+    FOREIGN KEY (snapshot_id) REFERENCES topo_snapshots(id) ON DELETE CASCADE
+  )`,
+    `CREATE TABLE IF NOT EXISTS topo_exports (
+    snapshot_id TEXT PRIMARY KEY,
+    surface_map TEXT NOT NULL,
+    surface_hash TEXT NOT NULL,
+    serialized_lock TEXT NOT NULL,
+    FOREIGN KEY (snapshot_id) REFERENCES topo_snapshots(id) ON DELETE CASCADE
+  )`,
+    `CREATE TABLE IF NOT EXISTS topo_trail_fires (
+    trail_id TEXT NOT NULL,
+    signal_id TEXT NOT NULL,
+    snapshot_id TEXT NOT NULL,
+    PRIMARY KEY (trail_id, signal_id, snapshot_id),
+    FOREIGN KEY (snapshot_id) REFERENCES topo_snapshots(id) ON DELETE CASCADE
+  )`,
+    `CREATE TABLE IF NOT EXISTS topo_trail_on (
+    trail_id TEXT NOT NULL,
+    signal_id TEXT NOT NULL,
+    snapshot_id TEXT NOT NULL,
+    PRIMARY KEY (trail_id, signal_id, snapshot_id),
+    FOREIGN KEY (snapshot_id) REFERENCES topo_snapshots(id) ON DELETE CASCADE
+  )`,
+];
+const TOPO_INDEX_STATEMENTS = [
+    'CREATE INDEX IF NOT EXISTS idx_topo_snapshots_created_at ON topo_snapshots(created_at DESC)',
+    `CREATE UNIQUE INDEX IF NOT EXISTS idx_topo_snapshots_pinned_as
+   ON topo_snapshots(pinned_as) WHERE pinned_as IS NOT NULL`,
+    'CREATE INDEX IF NOT EXISTS idx_topo_trails_snapshot_id ON topo_trails(snapshot_id)',
+    'CREATE INDEX IF NOT EXISTS idx_topo_crossings_snapshot_id ON topo_crossings(snapshot_id)',
+    'CREATE INDEX IF NOT EXISTS idx_topo_trail_resources_snapshot_id ON topo_trail_resources(snapshot_id)',
+    'CREATE INDEX IF NOT EXISTS idx_topo_resources_snapshot_id ON topo_resources(snapshot_id)',
+    'CREATE INDEX IF NOT EXISTS idx_topo_signals_snapshot_id ON topo_signals(snapshot_id)',
+    'CREATE INDEX IF NOT EXISTS idx_topo_trail_signals_snapshot_id ON topo_trail_signals(snapshot_id)',
+    'CREATE INDEX IF NOT EXISTS idx_topo_surfaces_snapshot_id ON topo_surfaces(snapshot_id)',
+    'CREATE UNIQUE INDEX IF NOT EXISTS idx_topo_examples_snapshot_trail_ordinal ON topo_examples(snapshot_id, trail_id, ordinal)',
+    'CREATE INDEX IF NOT EXISTS idx_topo_schemas_snapshot_id ON topo_schemas(snapshot_id)',
+    `CREATE INDEX IF NOT EXISTS idx_topo_schemas_lookup
+   ON topo_schemas(owner_id, owner_kind, schema_kind, zod_hash)`,
+    'CREATE INDEX IF NOT EXISTS idx_topo_trail_fires_snapshot_id ON topo_trail_fires(snapshot_id)',
+    'CREATE INDEX IF NOT EXISTS idx_topo_trail_on_snapshot_id ON topo_trail_on(snapshot_id)',
+];
+const rowToSnapshot = (row) => ({
+    createdAt: row.created_at,
+    gitDirty: row.git_dirty === 1,
+    id: row.id,
+    resourceCount: row.resource_count,
+    signalCount: row.signal_count,
+    trailCount: row.trail_count,
+    ...(row.git_sha === null ? {} : { gitSha: row.git_sha }),
+    ...(row.pinned_as === null ? {} : { pinnedAs: row.pinned_as }),
+});
+const tableExists = (db, tableName) => {
+    const row = db
+        .query("SELECT name FROM sqlite_master WHERE type = 'table' AND name = ?")
+        .get(tableName);
+    return row?.name === tableName;
+};
+const runStatements = (db, statements) => {
+    for (const statement of statements) {
+        db.run(statement);
+    }
+};
+const createAllTopoTables = (db) => {
+    runStatements(db, TOPO_TABLE_STATEMENTS);
+    runStatements(db, TOPO_INDEX_STATEMENTS);
+};
+/**
+ * Current topo subsystem schema version.
+ *
+ * Version 8 adds `pattern TEXT` column to `topo_trails`.
+ *
+ * Version 7 defined the snapshot-first topo tables (`topo_snapshots`,
+ * `topo_surfaces`, and `snapshot_id` foreign keys) as the only supported
+ * schema. Older pre-release tables are ignored in place; we create the current
+ * tables and advance the subsystem version without translating or deleting
+ * legacy rows.
+ */
+export const TOPO_SCHEMA_VERSION = 8;
+export const ensureTopoSnapshotSchema = (db) => {
+    ensureSubsystemSchema(db, {
+        migrate: (currentVersion) => {
+            createAllTopoTables(db);
+            if (currentVersion === 7) {
+                db.run('ALTER TABLE topo_trails ADD COLUMN pattern TEXT');
+            }
+        },
+        subsystem: TOPO_SUBSYSTEM,
+        version: TOPO_SCHEMA_VERSION,
+    });
+};
+export const insertTopoSnapshotRecord = (db, input) => {
+    const record = {
+        createdAt: input?.createdAt ?? new Date().toISOString(),
+        gitDirty: input?.gitDirty ?? false,
+        id: input?.id ?? Bun.randomUUIDv7(),
+        resourceCount: input?.resourceCount ?? 0,
+        signalCount: input?.signalCount ?? 0,
+        trailCount: input?.trailCount ?? 0,
+        ...(input?.gitSha === undefined ? {} : { gitSha: input.gitSha }),
+    };
+    db.run(`INSERT INTO topo_snapshots (
+      id, git_sha, git_dirty, trail_count, signal_count, resource_count, pinned_as, created_at
+    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?)`, [
+        record.id,
+        record.gitSha ?? null,
+        record.gitDirty ? 1 : 0,
+        record.trailCount,
+        record.signalCount,
+        record.resourceCount,
+        null,
+        record.createdAt,
+    ]);
+    return record;
+};
+const normalizeLimit = (limit) => {
+    if (limit === undefined) {
+        return undefined;
+    }
+    return Math.max(0, Math.trunc(limit));
+};
+export const readTopoSnapshot = (db, id) => {
+    if (!tableExists(db, 'topo_snapshots')) {
+        return undefined;
+    }
+    const row = db
+        .query(`SELECT id, git_sha, git_dirty, trail_count, signal_count, resource_count, pinned_as, created_at
+       FROM topo_snapshots
+       WHERE id = ?`)
+        .get(id);
+    return row === null || row === undefined ? undefined : rowToSnapshot(row);
+};
+export const readPinnedTopoSnapshot = (db, name) => {
+    if (!tableExists(db, 'topo_snapshots')) {
+        return undefined;
+    }
+    const row = db
+        .query(`SELECT id, git_sha, git_dirty, trail_count, signal_count, resource_count, pinned_as, created_at
+       FROM topo_snapshots
+       WHERE pinned_as = ?
+       LIMIT 1`)
+        .get(name);
+    return row === null || row === undefined ? undefined : rowToSnapshot(row);
+};
+const applyBeforeSnapshotClause = (db, beforeId, bindings, conditions) => {
+    if (beforeId === undefined) {
+        return true;
+    }
+    const before = readTopoSnapshot(db, beforeId);
+    if (before === undefined) {
+        return false;
+    }
+    conditions.push('(created_at < ? OR (created_at = ? AND id < ?))');
+    bindings.push(before.createdAt, before.createdAt, before.id);
+    return true;
+};
+const applyPinnedSnapshotClause = (pinned, conditions) => {
+    if (pinned === true) {
+        conditions.push('pinned_as IS NOT NULL');
+        return;
+    }
+    if (pinned === false) {
+        conditions.push('pinned_as IS NULL');
+    }
+};
+const buildSnapshotWhereClause = (conditions) => conditions.length === 0 ? '' : ` WHERE ${conditions.join(' AND ')}`;
+const buildSnapshotLimitClause = (limit, bindings) => {
+    if (limit === undefined) {
+        return '';
+    }
+    bindings.push(limit);
+    return ' LIMIT ?';
+};
+const listSnapshotRows = (db, options) => {
+    if (!tableExists(db, 'topo_snapshots')) {
+        return [];
+    }
+    const bindings = [];
+    const conditions = [];
+    if (!applyBeforeSnapshotClause(db, options?.before, bindings, conditions)) {
+        return [];
+    }
+    applyPinnedSnapshotClause(options?.pinned, conditions);
+    const whereClause = buildSnapshotWhereClause(conditions);
+    const limitClause = buildSnapshotLimitClause(normalizeLimit(options?.limit), bindings);
+    return db
+        .query(`SELECT id, git_sha, git_dirty, trail_count, signal_count, resource_count, pinned_as, created_at
+       FROM topo_snapshots${whereClause}
+       ORDER BY created_at DESC, id DESC${limitClause}`)
+        .all(...bindings);
+};
+export const listTopoSnapshots = (db, options) => listSnapshotRows(db, options).map(rowToSnapshot);
+const countSnapshots = (db, whereClause) => {
+    const query = whereClause === undefined
+        ? 'SELECT COUNT(*) as count FROM topo_snapshots'
+        : `SELECT COUNT(*) as count FROM topo_snapshots WHERE ${whereClause}`;
+    const row = db.query(query).get();
+    return row?.count ?? 0;
+};
+export const countTopoSnapshots = (db) => {
+    if (!tableExists(db, 'topo_snapshots')) {
+        return 0;
+    }
+    return countSnapshots(db);
+};
+export const countPinnedSnapshots = (db) => {
+    if (!tableExists(db, 'topo_snapshots')) {
+        return 0;
+    }
+    return countSnapshots(db, 'pinned_as IS NOT NULL');
+};
+export const countPrunableSnapshots = (db, options) => {
+    if (!tableExists(db, 'topo_snapshots')) {
+        return 0;
+    }
+    const row = db
+        .query(`SELECT COUNT(*) as count
+       FROM (
+         SELECT id
+         FROM topo_snapshots
+         WHERE pinned_as IS NULL
+         ORDER BY created_at DESC, id DESC
+         LIMIT -1 OFFSET ?
+       )`)
+        .get(options.keep);
+    return row?.count ?? 0;
+};
+export const createTopoSnapshot = (db, input) => {
+    ensureTopoSnapshotSchema(db);
+    return insertTopoSnapshotRecord(db, input);
+};
+export const pinTopoSnapshot = (db, input) => {
+    ensureTopoSnapshotSchema(db);
+    return db.transaction(() => {
+        const snapshot = readTopoSnapshot(db, input.id);
+        if (snapshot === undefined) {
+            return;
+        }
+        db.run('UPDATE topo_snapshots SET pinned_as = NULL WHERE pinned_as = ?', [
+            input.name,
+        ]);
+        db.run('UPDATE topo_snapshots SET pinned_as = ? WHERE id = ?', [
+            input.name,
+            input.id,
+        ]);
+        return readTopoSnapshot(db, input.id);
+    })();
+};
+export const unpinTopoSnapshot = (db, nameOrId) => {
+    ensureTopoSnapshotSchema(db);
+    return db.transaction(() => {
+        const snapshot = readPinnedTopoSnapshot(db, nameOrId) ?? readTopoSnapshot(db, nameOrId);
+        if (snapshot?.pinnedAs === undefined) {
+            return;
+        }
+        db.run('UPDATE topo_snapshots SET pinned_as = NULL WHERE id = ?', [
+            snapshot.id,
+        ]);
+        return readTopoSnapshot(db, snapshot.id);
+    })();
+};
+export const pruneUnpinnedSnapshots = (db, options) => {
+    if (!tableExists(db, 'topo_snapshots')) {
+        return 0;
+    }
+    if (countPrunableSnapshots(db, options) === 0) {
+        return 0;
+    }
+    db.run(`DELETE FROM topo_snapshots
+     WHERE id IN (
+       SELECT id
+       FROM topo_snapshots
+       WHERE pinned_as IS NULL
+       ORDER BY created_at DESC, id DESC
+       LIMIT -1 OFFSET ?
+     )`, [options.keep]);
+    return (db.query('SELECT changes() as changes').get()
+        ?.changes ?? 0);
+};
+//# sourceMappingURL=topo-snapshots.js.map

package/dist/internal/topo-snapshots.js.map

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

package/dist/internal/topo-store-read.d.ts

@@ -0,0 +1,70 @@
+import type { Database, SQLQueryBindings } from 'bun:sqlite';
+import type { ListTopoSnapshotsOptions, TopoSnapshot } from './topo-snapshots.js';
+import type { StoredTopoExport } from './topo-store.js';
+export interface TopoStoreRef {
+    readonly pin?: string;
+    readonly snapshotId?: string;
+}
+export interface TopoStoreTrailRecord {
+    readonly description: string | null;
+    readonly exampleCount: number;
+    readonly hasExamples: boolean;
+    readonly hasOutput: boolean;
+    readonly id: string;
+    readonly idempotent: boolean;
+    readonly intent: 'destroy' | 'read' | 'write';
+    readonly kind: 'trail';
+    readonly meta: Readonly<Record<string, unknown>> | null;
+    readonly pattern: string | null;
+    readonly safety: '-' | 'destroy' | 'read' | 'write';
+    readonly snapshotId: string;
+}
+export interface TopoStoreExampleRecord {
+    readonly description: string | null;
+    readonly error: string | null;
+    readonly expected: unknown;
+    readonly input: unknown;
+    readonly name: string;
+    readonly ordinal: number;
+}
+export interface TopoStoreTrailDetailRecord extends TopoStoreTrailRecord {
+    readonly crosses: readonly string[];
+    readonly detours: readonly {
+        readonly on: string;
+        readonly maxAttempts: number;
+    }[] | null;
+    readonly examples: readonly TopoStoreExampleRecord[];
+    readonly resources: readonly string[];
+}
+export interface TopoStoreResourceRecord {
+    readonly description: string | null;
+    readonly hasHealth: boolean;
+    readonly hasMock: boolean;
+    readonly health: 'available' | 'none';
+    readonly id: string;
+    readonly kind: 'resource';
+    readonly lifetime: 'singleton';
+    readonly snapshotId: string;
+    readonly usedBy: readonly string[];
+}
+export interface TopoStoreExportRecord extends StoredTopoExport {
+    readonly snapshot: TopoSnapshot;
+}
+export declare const readTopoStoreSnapshot: (db: Database, ref?: TopoStoreRef) => TopoSnapshot | undefined;
+export declare const listTopoStoreSnapshots: (db: Database, options?: ListTopoSnapshotsOptions) => readonly TopoSnapshot[];
+export declare const getTopoStoreExport: (db: Database, ref?: TopoStoreRef) => TopoStoreExportRecord | undefined;
+export declare const listTopoStoreTrails: (db: Database, options?: {
+    readonly intent?: TopoStoreTrailRecord["intent"];
+    readonly snapshot?: TopoStoreRef;
+}) => readonly TopoStoreTrailRecord[];
+export declare const getTopoStoreTrail: (db: Database, trailId: string, options?: {
+    readonly snapshot?: TopoStoreRef;
+}) => TopoStoreTrailDetailRecord | undefined;
+export declare const listTopoStoreResources: (db: Database, options?: {
+    readonly snapshot?: TopoStoreRef;
+}) => readonly TopoStoreResourceRecord[];
+export declare const getTopoStoreResource: (db: Database, resourceId: string, options?: {
+    readonly snapshot?: TopoStoreRef;
+}) => TopoStoreResourceRecord | undefined;
+export declare const queryTopoStore: <TRow extends Record<string, unknown>>(db: Database, sql: string, bindings?: readonly SQLQueryBindings[]) => readonly TRow[];
+//# sourceMappingURL=topo-store-read.d.ts.map

package/dist/internal/topo-store-read.d.ts.map

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

package/dist/internal/topo-store-read.js

@@ -0,0 +1,221 @@
+import { ValidationError } from '../errors.js';
+import { listTopoSnapshots, readPinnedTopoSnapshot, readTopoSnapshot, } from './topo-snapshots.js';
+import { getStoredTopoExport } from './topo-store.js';
+const ensureSingleRefSelector = (ref) => {
+    if (ref?.pin !== undefined && ref.snapshotId !== undefined) {
+        throw new ValidationError('Topo store references may use pin or snapshotId, not both');
+    }
+};
+const normalizeIntent = (intent) => {
+    if (intent === 'destroy' || intent === 'read') {
+        return intent;
+    }
+    return 'write';
+};
+const safetyForIntent = (intent) => {
+    if (intent === 'destroy') {
+        return 'destroy';
+    }
+    if (intent === 'read') {
+        return 'read';
+    }
+    return 'write';
+};
+const parseMeta = (value) => value === null
+    ? null
+    : JSON.parse(value);
+const parseJson = (value) => JSON.parse(value);
+const readSnapshotRef = (db, ref) => {
+    ensureSingleRefSelector(ref);
+    if (ref?.snapshotId !== undefined) {
+        return readTopoSnapshot(db, ref.snapshotId);
+    }
+    if (ref?.pin !== undefined) {
+        return readPinnedTopoSnapshot(db, ref.pin);
+    }
+    return listTopoSnapshots(db, { limit: 1 })[0];
+};
+const readStoredEntry = (db, snapshotId, kind, id) => {
+    const stored = getStoredTopoExport(db, snapshotId);
+    if (stored === undefined) {
+        return undefined;
+    }
+    const map = JSON.parse(stored.surfaceMapJson);
+    return map.entries.find((entry) => entry.id === id && entry.kind === kind);
+};
+const mapTrailRow = (row) => {
+    const intent = normalizeIntent(row.intent);
+    return {
+        description: row.description,
+        exampleCount: row.example_count,
+        hasExamples: row.has_examples === 1,
+        hasOutput: row.has_output === 1,
+        id: row.id,
+        idempotent: row.idempotent === 1,
+        intent,
+        kind: 'trail',
+        meta: parseMeta(row.meta),
+        pattern: row.pattern,
+        safety: safetyForIntent(intent),
+        snapshotId: row.snapshot_id,
+    };
+};
+const readTrailCrossings = (db, snapshotId, trailId) => db
+    .query(`SELECT target_id
+       FROM topo_crossings
+       WHERE snapshot_id = ? AND source_id = ?
+       ORDER BY target_id ASC`)
+    .all(snapshotId, trailId)
+    .map((row) => row.target_id);
+const readTrailResourceIds = (db, snapshotId, trailId) => db
+    .query(`SELECT resource_id
+       FROM topo_trail_resources
+       WHERE snapshot_id = ? AND trail_id = ?
+       ORDER BY resource_id ASC`)
+    .all(snapshotId, trailId)
+    .map((row) => row.resource_id);
+const readTrailExamples = (db, snapshotId, trailId) => db
+    .query(`SELECT ordinal, name, description, input, expected, error
+       FROM topo_examples
+       WHERE snapshot_id = ? AND trail_id = ?
+       ORDER BY ordinal ASC`)
+    .all(snapshotId, trailId)
+    .map((row) => ({
+    description: row.description,
+    error: row.error,
+    expected: row.expected === null ? null : parseJson(row.expected),
+    input: parseJson(row.input),
+    name: row.name,
+    ordinal: row.ordinal,
+}));
+const readResourceUsage = (db, snapshotId) => {
+    const rows = db
+        .query(`SELECT resource_id, trail_id
+       FROM topo_trail_resources
+       WHERE snapshot_id = ?
+       ORDER BY resource_id ASC, trail_id ASC`)
+        .all(snapshotId);
+    const usage = new Map();
+    for (const row of rows) {
+        const trails = usage.get(row.resource_id) ?? [];
+        trails.push(row.trail_id);
+        usage.set(row.resource_id, trails);
+    }
+    return new Map([...usage.entries()].map(([id, trails]) => [id, trails]));
+};
+export const readTopoStoreSnapshot = (db, ref) => readSnapshotRef(db, ref);
+export const listTopoStoreSnapshots = (db, options) => listTopoSnapshots(db, options);
+export const getTopoStoreExport = (db, ref) => {
+    const snapshot = readSnapshotRef(db, ref);
+    if (snapshot === undefined) {
+        return undefined;
+    }
+    const stored = getStoredTopoExport(db, snapshot.id);
+    if (stored === undefined) {
+        return undefined;
+    }
+    return {
+        ...stored,
+        snapshot,
+    };
+};
+export const listTopoStoreTrails = (db, options) => {
+    const snapshot = readSnapshotRef(db, options?.snapshot);
+    if (snapshot === undefined) {
+        return [];
+    }
+    const baseQuery = `SELECT id, intent, idempotent, has_output, has_examples, example_count, description, pattern, meta, snapshot_id
+             FROM topo_trails`;
+    let rows;
+    if (options?.intent === undefined) {
+        rows = db
+            .query(`${baseQuery} WHERE snapshot_id = ? ORDER BY id ASC`)
+            .all(snapshot.id);
+    }
+    else if (options.intent === 'write') {
+        rows = db
+            .query(`${baseQuery} WHERE snapshot_id = ? AND intent = 'write' ORDER BY id ASC`)
+            .all(snapshot.id);
+    }
+    else {
+        rows = db
+            .query(`${baseQuery} WHERE snapshot_id = ? AND intent = ? ORDER BY id ASC`)
+            .all(snapshot.id, options.intent);
+    }
+    return rows.map(mapTrailRow);
+};
+export const getTopoStoreTrail = (db, trailId, options) => {
+    const snapshot = readSnapshotRef(db, options?.snapshot);
+    if (snapshot === undefined) {
+        return undefined;
+    }
+    const row = db
+        .query(`SELECT id, intent, idempotent, has_output, has_examples, example_count, description, pattern, meta, snapshot_id
+       FROM topo_trails
+       WHERE snapshot_id = ? AND id = ?
+       LIMIT 1`)
+        .get(snapshot.id, trailId);
+    if (row === null || row === undefined) {
+        return undefined;
+    }
+    const storedEntry = readStoredEntry(db, snapshot.id, 'trail', trailId);
+    return {
+        ...mapTrailRow(row),
+        crosses: readTrailCrossings(db, snapshot.id, trailId),
+        detours: storedEntry?.detours ?? null,
+        examples: readTrailExamples(db, snapshot.id, trailId),
+        resources: readTrailResourceIds(db, snapshot.id, trailId),
+    };
+};
+const mapResourceRow = (row, usedBy, storedEntry) => ({
+    description: storedEntry?.description ?? null,
+    hasHealth: row.has_health === 1,
+    hasMock: row.has_mock === 1,
+    health: row.has_health === 1 || storedEntry?.healthcheck === true
+        ? 'available'
+        : 'none',
+    id: row.id,
+    kind: 'resource',
+    lifetime: 'singleton',
+    snapshotId: row.snapshot_id,
+    usedBy,
+});
+export const listTopoStoreResources = (db, options) => {
+    const snapshot = readSnapshotRef(db, options?.snapshot);
+    if (snapshot === undefined) {
+        return [];
+    }
+    const usage = readResourceUsage(db, snapshot.id);
+    const rows = db
+        .query(`SELECT id, has_mock, has_health, snapshot_id
+       FROM topo_resources
+       WHERE snapshot_id = ?
+       ORDER BY id ASC`)
+        .all(snapshot.id);
+    const stored = getStoredTopoExport(db, snapshot.id);
+    const entries = stored
+        ? JSON.parse(stored.surfaceMapJson).entries
+        : [];
+    return rows.map((row) => mapResourceRow(row, usage.get(row.id) ?? [], entries.find((entry) => entry.id === row.id && entry.kind === 'resource')));
+};
+export const getTopoStoreResource = (db, resourceId, options) => {
+    const snapshot = readSnapshotRef(db, options?.snapshot);
+    if (snapshot === undefined) {
+        return undefined;
+    }
+    const row = db
+        .query(`SELECT id, has_mock, has_health, snapshot_id
+       FROM topo_resources
+       WHERE snapshot_id = ? AND id = ?
+       LIMIT 1`)
+        .get(snapshot.id, resourceId);
+    if (row === null || row === undefined) {
+        return undefined;
+    }
+    const usage = readResourceUsage(db, snapshot.id);
+    return mapResourceRow(row, usage.get(resourceId) ?? [], readStoredEntry(db, snapshot.id, 'resource', resourceId));
+};
+export const queryTopoStore = (db, sql, bindings) => db
+    .query(sql)
+    .all(...(bindings === undefined ? [] : [...bindings]));
+//# sourceMappingURL=topo-store-read.js.map