@ontrails/trails 1.0.0-beta.14 → 1.0.0-beta.16

package/dist/src/trails/topo-history.d.ts

@@ -1,24 +0,0 @@
-export declare const topoHistoryTrail: import("@ontrails/core").Trail<{
-    limit: number;
-    rootDir?: string | undefined;
-}, {
-    dbPath: string;
-    limit: number;
-    pinCount: number;
-    pins: {
-        createdAt: string;
-        name: string;
-        saveId: string;
-    }[];
-    saveCount: number;
-    saves: {
-        createdAt: string;
-        gitDirty: boolean;
-        id: string;
-        provisionCount: number;
-        signalCount: number;
-        trailCount: number;
-        gitSha?: string | undefined;
-    }[];
-}>;
-//# sourceMappingURL=topo-history.d.ts.map

package/dist/src/trails/topo-history.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"topo-history.d.ts","sourceRoot":"","sources":["../../../src/trails/topo-history.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;EA4B3B,CAAC"}

package/dist/src/trails/topo-history.js

@@ -1,33 +0,0 @@
-import { Result, trail } from '@ontrails/core';
-import { z } from 'zod';
-import { DEFAULT_TOPO_HISTORY_LIMIT, isolatedExampleInput, listTopoHistory, topoPinOutput, topoSaveOutput, } from './topo-support.js';
-export const topoHistoryTrail = trail('topo.history', {
-    blaze: (input, ctx) => {
-        const rootDir = input.rootDir ?? ctx.cwd ?? process.cwd();
-        return Result.ok(listTopoHistory({ limit: input.limit, rootDir }));
-    },
-    description: 'List saved topo metadata, including pins and recent autosaves',
-    examples: [
-        {
-            input: isolatedExampleInput('topo-history'),
-            name: 'Show topo history',
-        },
-    ],
-    input: z.object({
-        limit: z
-            .number()
-            .default(DEFAULT_TOPO_HISTORY_LIMIT)
-            .describe('Maximum number of autosaves to return'),
-        rootDir: z.string().optional().describe('Workspace root directory'),
-    }),
-    intent: 'read',
-    output: z.object({
-        dbPath: z.string(),
-        limit: z.number(),
-        pinCount: z.number(),
-        pins: z.array(topoPinOutput),
-        saveCount: z.number(),
-        saves: z.array(topoSaveOutput),
-    }),
-});
-//# sourceMappingURL=topo-history.js.map

package/dist/src/trails/topo-history.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"topo-history.js","sourceRoot":"","sources":["../../../src/trails/topo-history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,cAAc,GACf,MAAM,mBAAmB,CAAC;AAE3B,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC,cAAc,EAAE;IACpD,KAAK,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACpB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,GAAG,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAC1D,OAAO,MAAM,CAAC,EAAE,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,WAAW,EAAE,+DAA+D;IAC5E,QAAQ,EAAE;QACR;YACE,KAAK,EAAE,oBAAoB,CAAC,cAAc,CAAC;YAC3C,IAAI,EAAE,mBAAmB;SAC1B;KACF;IACD,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,OAAO,CAAC,0BAA0B,CAAC;aACnC,QAAQ,CAAC,uCAAuC,CAAC;QACpD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;KACpE,CAAC;IACF,MAAM,EAAE,MAAM;IACd,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC;QAC5B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC;KAC/B,CAAC;CACH,CAAC,CAAC"}

package/dist/src/trails/topo-pin.d.ts

@@ -1,21 +0,0 @@
-export declare const topoPinTrail: import("@ontrails/core").Trail<{
-    module: string;
-    name: string;
-    rootDir?: string | undefined;
-}, {
-    pin: {
-        createdAt: string;
-        name: string;
-        saveId: string;
-    };
-    save: {
-        createdAt: string;
-        gitDirty: boolean;
-        id: string;
-        provisionCount: number;
-        signalCount: number;
-        trailCount: number;
-        gitSha?: string | undefined;
-    };
-}>;
-//# sourceMappingURL=topo-pin.d.ts.map

package/dist/src/trails/topo-pin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"topo-pin.d.ts","sourceRoot":"","sources":["../../../src/trails/topo-pin.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;EA6BvB,CAAC"}

package/dist/src/trails/topo-pin.js

@@ -1,35 +0,0 @@
-import { Result, trail } from '@ontrails/core';
-import { z } from 'zod';
-import { loadApp } from './load-app.js';
-import { DEFAULT_APP_MODULE, isolatedExampleInput, pinCurrentTopo, topoPinOutput, topoSaveOutput, } from './topo-support.js';
-export const topoPinTrail = trail('topo.pin', {
-    blaze: async (input, ctx) => {
-        const rootDir = input.rootDir ?? ctx.cwd ?? process.cwd();
-        const app = await loadApp(input.module, rootDir);
-        return Result.ok(pinCurrentTopo(app, { name: input.name, rootDir }));
-    },
-    description: 'Pin the current topo under a durable name',
-    examples: [
-        {
-            input: {
-                ...isolatedExampleInput('topo-pin'),
-                name: 'before-auth-refactor',
-            },
-            name: 'Pin the current topo',
-        },
-    ],
-    input: z.object({
-        module: z
-            .string()
-            .default(DEFAULT_APP_MODULE)
-            .describe('Path to the app module'),
-        name: z.string().describe('Pin name'),
-        rootDir: z.string().optional().describe('Workspace root directory'),
-    }),
-    intent: 'write',
-    output: z.object({
-        pin: topoPinOutput,
-        save: topoSaveOutput,
-    }),
-});
-//# sourceMappingURL=topo-pin.js.map

package/dist/src/trails/topo-pin.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"topo-pin.js","sourceRoot":"","sources":["../../../src/trails/topo-pin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,cAAc,GACf,MAAM,mBAAmB,CAAC;AAE3B,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAC,UAAU,EAAE;IAC5C,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC1B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,GAAG,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAC1D,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjD,OAAO,MAAM,CAAC,EAAE,CAAC,cAAc,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IACvE,CAAC;IACD,WAAW,EAAE,2CAA2C;IACxD,QAAQ,EAAE;QACR;YACE,KAAK,EAAE;gBACL,GAAG,oBAAoB,CAAC,UAAU,CAAC;gBACnC,IAAI,EAAE,sBAAsB;aAC7B;YACD,IAAI,EAAE,sBAAsB;SAC7B;KACF;IACD,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,OAAO,CAAC,kBAAkB,CAAC;aAC3B,QAAQ,CAAC,wBAAwB,CAAC;QACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;QACrC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;KACpE,CAAC;IACF,MAAM,EAAE,OAAO;IACf,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,GAAG,EAAE,aAAa;QAClB,IAAI,EAAE,cAAc;KACrB,CAAC;CACH,CAAC,CAAC"}

package/dist/src/trails/topo-read-support.d.ts

@@ -1,54 +0,0 @@
-/**
- * Read-only topo store consumer helpers.
- *
- * Extracted from topo-support.ts so this branch (trl-132) owns its own file,
- * keeping absorb routing clean across the stack.
- */
-import type { Topo } from '@ontrails/core';
-import { Result } from '@ontrails/core';
-import type { BriefReport, SurveyListReport } from './topo-reports.js';
-import type { TopoSummaryReport, TopoVerifyReport } from './topo-support.js';
-interface CurrentTrailDetail {
-    readonly crosses: string[];
-    readonly description: string | null;
-    readonly detours: Readonly<Record<string, readonly string[]>> | null;
-    readonly examples: unknown[];
-    readonly id: string;
-    readonly intent: 'destroy' | 'read' | 'write';
-    readonly kind: string;
-    readonly provisions: string[];
-    readonly safety: string;
-}
-interface CurrentProvisionDetail {
-    readonly description: string | null;
-    readonly health: 'available' | 'none';
-    readonly id: string;
-    readonly kind: 'provision';
-    readonly lifetime: 'singleton';
-    readonly usedBy: string[];
-}
-export declare const buildTopoSummary: (app: Topo, options?: {
-    readonly rootDir?: string;
-}) => TopoSummaryReport;
-export declare const buildCurrentTopoBrief: (app: Topo, options?: {
-    readonly rootDir?: string;
-}) => BriefReport;
-export declare const buildCurrentTopoList: (app: Topo, options?: {
-    readonly rootDir?: string;
-}) => SurveyListReport;
-export declare const buildCurrentGuideEntries: (app: Topo, options?: {
-    readonly rootDir?: string;
-}) => readonly {
-    readonly description: string;
-    readonly exampleCount: number;
-    readonly id: string;
-    readonly kind: string;
-}[];
-export declare const buildCurrentTopoDetail: (app: Topo, id: string, options?: {
-    readonly rootDir?: string;
-}) => CurrentProvisionDetail | CurrentTrailDetail | undefined;
-export declare const verifyCurrentTopo: (app: Topo, options?: {
-    readonly rootDir?: string;
-}) => Promise<Result<TopoVerifyReport, Error>>;
-export {};
-//# sourceMappingURL=topo-read-support.d.ts.map

package/dist/src/trails/topo-read-support.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"topo-read-support.d.ts","sourceRoot":"","sources":["../../../src/trails/topo-read-support.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAKL,MAAM,EACP,MAAM,gBAAgB,CAAC;AAUxB,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAiB7E,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IACrE,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,UAAU,sBAAsB;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC;IACtC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;CAC3B;AAsJD,eAAO,MAAM,gBAAgB,GAC3B,KAAK,IAAI,EACT,UAAU;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,KACtC,iBAUF,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,KAAK,IAAI,EACT,UAAU;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,KACtC,WAKF,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,KAAK,IAAI,EACT,UAAU;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,KACtC,gBAKF,CAAC;AAEF,eAAO,MAAM,wBAAwB,GACnC,KAAK,IAAI,EACT,UAAU;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,KACtC,SAAS;IACV,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,EAUA,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,KAAK,IAAI,EACT,IAAI,MAAM,EACV,UAAU;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,KACtC,sBAAsB,GAAG,kBAAkB,GAAG,SAahD,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,KAAK,IAAI,EACT,UAAU;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,KACtC,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAwCzC,CAAC"}

package/dist/src/trails/topo-read-support.js

@@ -1,178 +0,0 @@
-/**
- * Read-only topo store consumer helpers.
- *
- * Extracted from topo-support.ts so this branch (trl-132) owns its own file,
- * keeping absorb routing clean across the stack.
- */
-import { existsSync } from 'node:fs';
-import { join } from 'node:path';
-import { ConflictError, createTopoStore, InternalError, NotFoundError, Result, } from '@ontrails/core';
-import { listTopoSaves } from '@ontrails/core/internal/topo-saves';
-import { openReadTrailsDb, resolveTrailsDbPath, resolveTrailsDir, } from '@ontrails/core/internal/trails-db';
-import { readTrailheadLockData } from '@ontrails/schema';
-import { REPORT_CONTRACT_VERSION, REPORT_VERSION } from './topo-constants.js';
-import { createCurrentTopoSave, LOCK_PATH, resolveRootDir, } from './topo-support.js';
-// ---------------------------------------------------------------------------
-// Store helpers
-// ---------------------------------------------------------------------------
-const topoStoreRef = (saveId) => ({ saveId });
-const hasCommittedLock = (trailsDir) => existsSync(join(trailsDir, 'trails.lock')) ||
-    existsSync(join(trailsDir, 'trailhead.lock'));
-const readTrailheadEntries = (trailheadMapJson) => JSON.parse(trailheadMapJson).entries;
-const buildBriefReportFromStore = (app, store, ref, save) => {
-    const trails = store.trails.list({ save: ref });
-    const exportRecord = store.exports.get(ref);
-    const trailEntries = exportRecord === undefined
-        ? []
-        : readTrailheadEntries(exportRecord.trailheadMapJson).filter((entry) => entry.kind === 'trail');
-    return {
-        contractVersion: REPORT_CONTRACT_VERSION,
-        features: {
-            detours: trailEntries.some((entry) => (Object.keys(entry.detours ?? {}).length ?? 0) > 0),
-            examples: trails.some((trail) => trail.hasExamples),
-            outputSchemas: trails.some((trail) => trail.hasOutput),
-            provisions: save.provisionCount > 0,
-            signals: save.signalCount > 0,
-        },
-        name: app.name,
-        provisions: save.provisionCount,
-        signals: save.signalCount,
-        trails: save.trailCount,
-        version: REPORT_VERSION,
-    };
-};
-const buildSurveyListFromStore = (store, ref) => {
-    const trails = store.trails.list({ save: ref });
-    const provisions = store.provisions.list({ save: ref });
-    return {
-        count: trails.length,
-        entries: trails.map((trail) => ({
-            examples: trail.exampleCount,
-            id: trail.id,
-            kind: trail.kind,
-            safety: trail.safety,
-        })),
-        provisionCount: provisions.length,
-        provisions: provisions.map((provision) => ({
-            description: provision.description,
-            health: provision.health,
-            id: provision.id,
-            kind: provision.kind,
-            lifetime: provision.lifetime,
-            usedBy: provision.usedBy,
-        })),
-    };
-};
-const buildTrailDetailFromStore = (detail) => ({
-    crosses: [...(detail?.crosses ?? [])],
-    description: detail?.description ?? null,
-    detours: detail?.detours ?? null,
-    examples: [...(detail?.examples ?? [])],
-    id: detail?.id ?? '',
-    intent: detail?.intent ?? 'write',
-    kind: detail?.kind ?? 'trail',
-    provisions: [...(detail?.provisions ?? [])],
-    safety: detail?.safety ?? '-',
-});
-const buildProvisionDetailFromStore = (provision) => ({
-    description: provision.description,
-    health: provision.health,
-    id: provision.id,
-    kind: provision.kind,
-    lifetime: provision.lifetime,
-    usedBy: [...provision.usedBy],
-});
-// ---------------------------------------------------------------------------
-// withCurrentTopoStore
-// ---------------------------------------------------------------------------
-/**
- * Run a read callback against the latest topo store state.
- *
- * Uses the most recent existing save when available, only creating a new save
- * when no prior save exists. This avoids unbounded save accumulation from
- * read-only operations like survey, guide, and show.
- */
-const withCurrentTopoStore = (app, rootDir, read) => {
-    const dbPath = resolveTrailsDbPath({ rootDir });
-    const existingSave = existsSync(dbPath)
-        ? (() => {
-            const db = openReadTrailsDb({ rootDir });
-            try {
-                return listTopoSaves(db)[0];
-            }
-            finally {
-                db.close();
-            }
-        })()
-        : undefined;
-    const save = existingSave ?? createCurrentTopoSave(app, { rootDir });
-    const store = createTopoStore({ rootDir });
-    return read(store, topoStoreRef(save.id), save);
-};
-// ---------------------------------------------------------------------------
-// Public read-only consumers
-// ---------------------------------------------------------------------------
-export const buildTopoSummary = (app, options) => {
-    const rootDir = resolveRootDir(options?.rootDir);
-    const trailsDir = resolveTrailsDir({ rootDir });
-    return withCurrentTopoStore(app, rootDir, (store, ref, save) => ({
-        app: buildBriefReportFromStore(app, store, ref, save),
-        dbPath: resolveTrailsDbPath({ rootDir }),
-        list: buildSurveyListFromStore(store, ref),
-        lockExists: hasCommittedLock(trailsDir),
-        lockPath: LOCK_PATH,
-    }));
-};
-export const buildCurrentTopoBrief = (app, options) => {
-    const rootDir = resolveRootDir(options?.rootDir);
-    return withCurrentTopoStore(app, rootDir, (store, ref, save) => buildBriefReportFromStore(app, store, ref, save));
-};
-export const buildCurrentTopoList = (app, options) => {
-    const rootDir = resolveRootDir(options?.rootDir);
-    return withCurrentTopoStore(app, rootDir, (store, ref) => buildSurveyListFromStore(store, ref));
-};
-export const buildCurrentGuideEntries = (app, options) => {
-    const rootDir = resolveRootDir(options?.rootDir);
-    return withCurrentTopoStore(app, rootDir, (store, ref) => store.trails.list({ save: ref }).map((trail) => ({
-        description: trail.description ?? '(no description)',
-        exampleCount: trail.exampleCount,
-        id: trail.id,
-        kind: trail.kind,
-    })));
-};
-export const buildCurrentTopoDetail = (app, id, options) => {
-    const rootDir = resolveRootDir(options?.rootDir);
-    return withCurrentTopoStore(app, rootDir, (store, ref) => {
-        const trail = store.trails.get(id, { save: ref });
-        if (trail !== undefined) {
-            return buildTrailDetailFromStore(trail);
-        }
-        const provision = store.provisions.get(id, { save: ref });
-        return provision === undefined
-            ? undefined
-            : buildProvisionDetailFromStore(provision);
-    });
-};
-export const verifyCurrentTopo = async (app, options) => {
-    const rootDir = resolveRootDir(options?.rootDir);
-    const committedLock = await readTrailheadLockData({
-        dir: resolveTrailsDir({ rootDir }),
-    });
-    if (committedLock === null) {
-        return Result.err(new NotFoundError('No committed trails.lock found. Run `trails topo export` first.'));
-    }
-    const currentHash = withCurrentTopoStore(app, rootDir, (store, ref) => store.exports.get(ref)?.trailheadHash);
-    if (currentHash === undefined) {
-        return Result.err(new InternalError('No stored topo export found for the current topo save'));
-    }
-    if (committedLock.hash !== currentHash) {
-        return Result.err(new ConflictError('trails.lock is stale. Run `trails topo export` to refresh it.'));
-    }
-    return Result.ok({
-        committedHash: committedLock.hash,
-        currentHash,
-        lockPath: LOCK_PATH,
-        stale: false,
-    });
-};
-//# sourceMappingURL=topo-read-support.js.map

package/dist/src/trails/topo-read-support.js.map

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

package/dist/src/trails/topo-reports.d.ts

@@ -1,50 +0,0 @@
-import type { Topo, Trail } from '@ontrails/core';
-export interface BriefReport {
-    readonly name: string;
-    readonly version: string;
-    readonly contractVersion: string;
-    readonly features: {
-        readonly provisions: boolean;
-        readonly outputSchemas: boolean;
-        readonly examples: boolean;
-        readonly detours: boolean;
-        readonly signals: boolean;
-    };
-    readonly trails: number;
-    readonly signals: number;
-    readonly provisions: number;
-}
-export interface SurveyListReport {
-    readonly count: number;
-    readonly entries: readonly {
-        readonly examples: number;
-        readonly id: string;
-        readonly kind: string;
-        readonly safety: string;
-    }[];
-    readonly provisionCount: number;
-    readonly provisions: readonly {
-        readonly description: string | null;
-        readonly health: 'available' | 'none';
-        readonly id: string;
-        readonly kind: 'provision';
-        readonly lifetime: 'singleton';
-        readonly usedBy: readonly string[];
-    }[];
-}
-export interface TrailDetailReport {
-    readonly description: string | null;
-    readonly detours: Trail<unknown, unknown>['detours'] | null;
-    readonly examples: readonly unknown[];
-    readonly crosses: readonly string[];
-    readonly id: string;
-    readonly intent: 'read' | 'write' | 'destroy';
-    readonly kind: string;
-    readonly safety: string;
-    readonly provisions: readonly string[];
-}
-export declare const generateBriefReport: (app: Topo) => BriefReport;
-export declare const formatProvisionDetail: (app: Topo, provisionId: string) => object;
-export declare const generateSurveyList: (app: Topo) => SurveyListReport;
-export declare const generateTrailDetail: (item: Trail<unknown, unknown>) => TrailDetailReport;
-//# sourceMappingURL=topo-reports.d.ts.map

package/dist/src/trails/topo-reports.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"topo-reports.d.ts","sourceRoot":"","sources":["../../../src/trails/topo-reports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAIlD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;QAC7B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;QAChC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;QAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;KAC3B,CAAC;IACF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS;QACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,EAAE,CAAC;IACJ,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,SAAS;QAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QACpC,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC;QACtC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;QAC3B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;QAC/B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;KACpC,EAAE,CAAC;CACL;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;IAC5D,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAgCD,eAAO,MAAM,mBAAmB,GAAI,KAAK,IAAI,KAAG,WAmB/C,CAAC;AAwCF,eAAO,MAAM,qBAAqB,GAChC,KAAK,IAAI,EACT,aAAa,MAAM,KAClB,MAYF,CAAC;AAiBF,eAAO,MAAM,kBAAkB,GAAI,KAAK,IAAI,KAAG,gBA4B9C,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAC9B,MAAM,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,KAC5B,iBAgBF,CAAC"}

package/dist/src/trails/topo-reports.js

@@ -1,122 +0,0 @@
-import { REPORT_CONTRACT_VERSION, REPORT_VERSION } from './topo-constants.js';
-const trailHas = (raw, key) => {
-    if (key === 'examples') {
-        return Array.isArray(raw[key]) && raw[key].length > 0;
-    }
-    return Boolean(raw[key]);
-};
-const detectFeatures = (app) => {
-    const trails = [...app.trails.values()].map((item) => item);
-    return {
-        hasDetours: trails.some((r) => trailHas(r, 'detours')),
-        hasExamples: trails.some((r) => trailHas(r, 'examples')),
-        hasOutputSchemas: trails.some((r) => trailHas(r, 'output')),
-        hasProvisions: trails.some((r) => Array.isArray(r['provisions']) &&
-            r['provisions'].length > 0),
-    };
-};
-export const generateBriefReport = (app) => {
-    const { hasDetours, hasExamples, hasOutputSchemas, hasProvisions } = detectFeatures(app);
-    return {
-        contractVersion: REPORT_CONTRACT_VERSION,
-        features: {
-            detours: hasDetours,
-            examples: hasExamples,
-            outputSchemas: hasOutputSchemas,
-            provisions: hasProvisions,
-            signals: app.signals.size > 0,
-        },
-        name: app.name,
-        provisions: app.provisions.size,
-        signals: app.signals.size,
-        trails: app.trails.size,
-        version: REPORT_VERSION,
-    };
-};
-const safetyLabel = (entry) => {
-    if (entry.intent === 'destroy') {
-        return 'destroy';
-    }
-    if (entry.intent === 'write') {
-        return 'write';
-    }
-    if (entry.intent === 'read') {
-        return 'read';
-    }
-    return '-';
-};
-const buildProvisionUsage = (app) => {
-    const usage = new Map();
-    for (const trailDef of app.list()) {
-        for (const declaredProvision of trailDef.provisions) {
-            const users = usage.get(declaredProvision.id) ?? [];
-            users.push(trailDef.id);
-            usage.set(declaredProvision.id, users);
-        }
-    }
-    return new Map([...usage.entries()].map(([id, users]) => [id, users.toSorted()]));
-};
-const provisionHealthStatus = (provision) => provision.health === undefined ? 'none' : 'available';
-export const formatProvisionDetail = (app, provisionId) => {
-    const item = app.getProvision(provisionId);
-    const usedBy = buildProvisionUsage(app).get(provisionId) ?? [];
-    return {
-        description: item?.description ?? null,
-        health: item ? provisionHealthStatus(item) : 'none',
-        id: provisionId,
-        kind: 'provision',
-        lifetime: 'singleton',
-        usedBy,
-    };
-};
-const formatProvisionList = (app) => {
-    const usage = buildProvisionUsage(app);
-    return app
-        .listProvisions()
-        .map((provision) => ({
-        description: provision.description ?? null,
-        health: provisionHealthStatus(provision),
-        id: provision.id,
-        kind: provision.kind,
-        lifetime: 'singleton',
-        usedBy: usage.get(provision.id) ?? [],
-    }))
-        .toSorted((a, b) => a.id.localeCompare(b.id));
-};
-export const generateSurveyList = (app) => {
-    const items = app.list();
-    const entries = items.map((item) => {
-        const safety = safetyLabel(item);
-        const examples = Array.isArray(item.examples)
-            ? item.examples.length
-            : 0;
-        return {
-            examples,
-            id: item.id,
-            kind: item.kind,
-            safety,
-        };
-    });
-    const provisions = formatProvisionList(app);
-    return {
-        count: items.length,
-        entries,
-        provisionCount: provisions.length,
-        provisions,
-    };
-};
-export const generateTrailDetail = (item) => {
-    const safety = safetyLabel(item);
-    return {
-        crosses: item.crosses.toSorted(),
-        description: item.description ?? null,
-        detours: item.detours ?? null,
-        examples: item.examples ?? [],
-        id: item.id,
-        intent: item.intent,
-        kind: item.kind,
-        provisions: item.provisions.map((provision) => provision.id).toSorted(),
-        safety,
-    };
-};
-//# sourceMappingURL=topo-reports.js.map

package/dist/src/trails/topo-reports.js.map

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

package/dist/src/trails/topo-show.d.ts

@@ -1,23 +0,0 @@
-export declare const topoShowTrail: import("@ontrails/core").Trail<{
-    id: string;
-    module: string;
-    rootDir?: string | undefined;
-}, {
-    crosses: string[];
-    description: unknown;
-    detours: unknown;
-    examples: unknown[];
-    id: string;
-    intent: "read" | "write" | "destroy";
-    kind: string;
-    provisions: string[];
-    safety: string;
-} | {
-    description: string | null;
-    health: "available" | "none";
-    id: string;
-    kind: "provision";
-    lifetime: "singleton";
-    usedBy: string[];
-}>;
-//# sourceMappingURL=topo-show.d.ts.map

package/dist/src/trails/topo-show.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"topo-show.d.ts","sourceRoot":"","sources":["../../../src/trails/topo-show.ts"],"names":[],"mappings":"AA4BA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;EA6BxB,CAAC"}

package/dist/src/trails/topo-show.js

@@ -1,53 +0,0 @@
-import { NotFoundError, Result, trail } from '@ontrails/core';
-import { z } from 'zod';
-import { loadApp } from './load-app.js';
-import { buildCurrentTopoDetail } from './topo-read-support.js';
-import { DEFAULT_APP_MODULE } from './topo-support.js';
-const trailDetailOutput = z.object({
-    crosses: z.array(z.string()),
-    description: z.unknown().nullable(),
-    detours: z.unknown().nullable(),
-    examples: z.array(z.unknown()),
-    id: z.string(),
-    intent: z.enum(['read', 'write', 'destroy']),
-    kind: z.string(),
-    provisions: z.array(z.string()),
-    safety: z.string(),
-});
-const provisionDetailOutput = z.object({
-    description: z.string().nullable(),
-    health: z.enum(['available', 'none']),
-    id: z.string(),
-    kind: z.literal('provision'),
-    lifetime: z.literal('singleton'),
-    usedBy: z.array(z.string()),
-});
-export const topoShowTrail = trail('topo.show', {
-    blaze: async (input, ctx) => {
-        const rootDir = input.rootDir ?? ctx.cwd ?? process.cwd();
-        const app = await loadApp(input.module, rootDir);
-        const detail = buildCurrentTopoDetail(app, input.id, { rootDir });
-        if (detail !== undefined) {
-            return Result.ok(detail);
-        }
-        return Result.err(new NotFoundError(`Trail or provision not found: ${input.id}`));
-    },
-    description: 'Show detail for a current trail or provision',
-    examples: [
-        {
-            input: { id: 'topo' },
-            name: 'Show current trail detail',
-        },
-    ],
-    input: z.object({
-        id: z.string().describe('Trail or provision ID to inspect'),
-        module: z
-            .string()
-            .default(DEFAULT_APP_MODULE)
-            .describe('Path to the app module'),
-        rootDir: z.string().optional().describe('Workspace root directory'),
-    }),
-    intent: 'read',
-    output: z.union([trailDetailOutput, provisionDetailOutput]),
-});
-//# sourceMappingURL=topo-show.js.map