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

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

@@ -0,0 +1,76 @@
+import type { Topo, TopoSnapshot } from '@ontrails/core';
+import { z } from 'zod';
+import type { BriefReport, SurveyListReport } from './topo-reports.js';
+/** Output schema for a topo snapshot record. Shared across topo trails. */
+export declare const topoSnapshotOutput: z.ZodObject<{
+    createdAt: z.ZodString;
+    gitDirty: z.ZodBoolean;
+    gitSha: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    pinnedAs: z.ZodOptional<z.ZodString>;
+    resourceCount: z.ZodNumber;
+    signalCount: z.ZodNumber;
+    trailCount: z.ZodNumber;
+}, z.core.$strip>;
+export declare const DEFAULT_APP_MODULE = "./src/app.ts";
+export declare const DEFAULT_TOPO_HISTORY_LIMIT = 10;
+export declare const LOCK_PATH = ".trails/trails.lock";
+export interface TopoSummaryReport {
+    readonly app: BriefReport;
+    readonly dbPath: string;
+    readonly list: SurveyListReport;
+    readonly lockExists: boolean;
+    readonly lockPath: string;
+}
+export interface TopoHistoryReport {
+    readonly dbPath: string;
+    readonly limit: number;
+    readonly pinnedCount: number;
+    readonly snapshotCount: number;
+    readonly snapshots: TopoSnapshot[];
+}
+export interface TopoExportReport {
+    readonly hash: string;
+    readonly lockPath: string;
+    readonly mapPath: string;
+    readonly snapshot: TopoSnapshot;
+}
+export interface TopoVerifyReport {
+    readonly committedHash: string;
+    readonly currentHash: string;
+    readonly lockPath: string;
+    readonly stale: false;
+}
+export declare const deriveRootDir: (cwd?: string) => string;
+export declare const readGitState: (rootDir: string) => {
+    readonly gitDirty: boolean;
+    readonly gitSha?: string;
+};
+export declare const deriveTopoCounts: (app: Topo) => Pick<TopoSnapshot, "resourceCount" | "signalCount" | "trailCount">;
+export declare const createIsolatedExampleInput: (name: string) => {
+    readonly module: string;
+    readonly rootDir: string;
+};
+export declare const createCurrentTopoSnapshot: (app: Topo, options?: {
+    readonly rootDir?: string;
+}) => TopoSnapshot;
+export declare const listTopoHistory: (options?: {
+    readonly limit?: number;
+    readonly rootDir?: string;
+}) => TopoHistoryReport;
+export declare const pinCurrentTopoSnapshot: (app: Topo, input: {
+    readonly name: string;
+    readonly rootDir?: string;
+}) => {
+    readonly snapshot: TopoSnapshot;
+};
+export declare const removePinnedTopoSnapshot: (input: {
+    readonly dryRun: boolean;
+    readonly name: string;
+    readonly rootDir?: string;
+}) => {
+    readonly dryRun: boolean;
+    readonly removed: boolean;
+    readonly snapshot?: TopoSnapshot;
+};
+//# sourceMappingURL=topo-support.d.ts.map

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

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

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

@@ -0,0 +1,132 @@
+import { existsSync, mkdirSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { createTopoSnapshot as persistTopoSnapshot, listTopoSnapshots as readTopoSnapshots, pinTopoSnapshot, unpinTopoSnapshot, } from '@ontrails/core';
+import { deriveTrailsDbPath } from '@ontrails/core/internal/trails-db';
+import { z } from 'zod';
+/** Output schema for a topo snapshot record. Shared across topo trails. */
+export const topoSnapshotOutput = z.object({
+    createdAt: z.string(),
+    gitDirty: z.boolean(),
+    gitSha: z.string().optional(),
+    id: z.string(),
+    pinnedAs: z.string().optional(),
+    resourceCount: z.number(),
+    signalCount: z.number(),
+    trailCount: z.number(),
+});
+export const DEFAULT_APP_MODULE = './src/app.ts';
+export const DEFAULT_TOPO_HISTORY_LIMIT = 10;
+export const LOCK_PATH = '.trails/trails.lock';
+const EXAMPLE_APP_MODULE = fileURLToPath(new URL('../app.ts', import.meta.url));
+export const deriveRootDir = (cwd) => cwd ?? process.cwd();
+const safeGit = (cwd, args) => {
+    const proc = Bun.spawnSync({
+        cmd: ['git', '-C', cwd, ...args],
+        stderr: 'ignore',
+        stdout: 'pipe',
+    });
+    if (!proc.success) {
+        return undefined;
+    }
+    const text = Buffer.from(proc.stdout).toString('utf8').trim();
+    return text.length === 0 ? undefined : text;
+};
+export const readGitState = (rootDir) => {
+    const gitSha = safeGit(rootDir, ['rev-parse', 'HEAD']);
+    const status = safeGit(rootDir, ['status', '--porcelain']);
+    return {
+        gitDirty: (status?.length ?? 0) > 0,
+        ...(gitSha === undefined ? {} : { gitSha }),
+    };
+};
+export const deriveTopoCounts = (app) => ({
+    resourceCount: app.resources.size,
+    signalCount: app.signals.size,
+    trailCount: app.trails.size,
+});
+const emptyTopoHistory = (dbPath, limit) => ({
+    dbPath,
+    limit,
+    pinnedCount: 0,
+    snapshotCount: 0,
+    snapshots: [],
+});
+const collectTopoHistory = (dbPath, limit, snapshots) => ({
+    dbPath,
+    limit,
+    pinnedCount: snapshots.filter((snapshot) => snapshot.pinnedAs !== undefined)
+        .length,
+    snapshotCount: snapshots.length,
+    snapshots: snapshots.slice(0, limit),
+});
+const buildSnapshotInput = (app, rootDir) => ({
+    ...readGitState(rootDir),
+    ...deriveTopoCounts(app),
+});
+export const createIsolatedExampleInput = (name) => {
+    const rootDir = join(tmpdir(), 'ontrails-trails-examples', name);
+    rmSync(rootDir, { force: true, recursive: true });
+    mkdirSync(rootDir, { recursive: true });
+    return {
+        module: EXAMPLE_APP_MODULE,
+        rootDir,
+    };
+};
+export const createCurrentTopoSnapshot = (app, options) => {
+    const rootDir = deriveRootDir(options?.rootDir);
+    const result = persistTopoSnapshot(app, {
+        rootDir,
+        ...buildSnapshotInput(app, rootDir),
+    });
+    if (result.isErr()) {
+        throw result.error;
+    }
+    return result.value;
+};
+export const listTopoHistory = (options) => {
+    const rootDir = deriveRootDir(options?.rootDir);
+    const limit = options?.limit ?? DEFAULT_TOPO_HISTORY_LIMIT;
+    const dbPath = deriveTrailsDbPath({ rootDir });
+    if (!existsSync(dbPath)) {
+        return emptyTopoHistory(dbPath, limit);
+    }
+    return collectTopoHistory(dbPath, limit, readTopoSnapshots({ rootDir }));
+};
+export const pinCurrentTopoSnapshot = (app, input) => {
+    const rootDir = deriveRootDir(input.rootDir);
+    const created = persistTopoSnapshot(app, {
+        rootDir,
+        ...buildSnapshotInput(app, rootDir),
+    });
+    if (created.isErr()) {
+        throw created.error;
+    }
+    const snapshot = pinTopoSnapshot(created.value.id, input.name, {
+        rootDir,
+    });
+    if (snapshot === undefined) {
+        throw new Error(`Missing topo snapshot "${created.value.id}" to pin`);
+    }
+    return { snapshot };
+};
+export const removePinnedTopoSnapshot = (input) => {
+    const rootDir = deriveRootDir(input.rootDir);
+    if (!existsSync(deriveTrailsDbPath({ rootDir }))) {
+        return { dryRun: input.dryRun, removed: false };
+    }
+    if (input.dryRun) {
+        const snapshot = readTopoSnapshots({ pinned: true, rootDir }).find((candidate) => candidate.pinnedAs === input.name);
+        return snapshot === undefined
+            ? { dryRun: true, removed: false }
+            : { dryRun: true, removed: false, snapshot };
+    }
+    const snapshot = unpinTopoSnapshot(input.name, { rootDir });
+    return {
+        dryRun: false,
+        removed: snapshot !== undefined,
+        ...(snapshot === undefined ? {} : { snapshot }),
+    };
+};
+//# sourceMappingURL=topo-support.js.map

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

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

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

@@ -0,0 +1,20 @@
+export declare const topoUnpinTrail: import("@ontrails/core").Trail<{
+    dryRun: boolean;
+    name: string;
+    yes: boolean;
+    rootDir?: string | undefined;
+}, {
+    dryRun: boolean;
+    removed: boolean;
+    snapshot?: {
+        createdAt: string;
+        gitDirty: boolean;
+        id: string;
+        resourceCount: number;
+        signalCount: number;
+        trailCount: number;
+        gitSha?: string | undefined;
+        pinnedAs?: string | undefined;
+    } | undefined;
+}, never>;
+//# sourceMappingURL=topo-unpin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"topo-unpin.d.ts","sourceRoot":"","sources":["../../../src/trails/topo-unpin.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;SA8CzB,CAAC"}

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

@@ -0,0 +1,44 @@
+import { Result, ValidationError, trail } from '@ontrails/core';
+import { z } from 'zod';
+import { createIsolatedExampleInput, removePinnedTopoSnapshot, topoSnapshotOutput, } from './topo-support.js';
+export const topoUnpinTrail = trail('topo.unpin', {
+    blaze: (input, ctx) => {
+        if (input.dryRun !== true && input.yes !== true) {
+            return Result.err(new ValidationError('Refusing to remove a pin without `--yes` or `--dry-run`.'));
+        }
+        const rootDir = input.rootDir ?? ctx.cwd ?? process.cwd();
+        return Result.ok(removePinnedTopoSnapshot({
+            dryRun: input.dryRun,
+            name: input.name,
+            rootDir,
+        }));
+    },
+    description: 'Remove a named topo pin',
+    examples: [
+        {
+            input: {
+                ...createIsolatedExampleInput('topo-unpin'),
+                dryRun: true,
+                name: 'before-auth-refactor',
+            },
+            name: 'Preview pin removal',
+        },
+    ],
+    input: z.object({
+        dryRun: z
+            .boolean()
+            .default(true)
+            .describe('Preview the removal without changing state'),
+        name: z.string().describe('Pin name'),
+        rootDir: z.string().optional().describe('Workspace root directory'),
+        yes: z.boolean().default(false).describe('Confirm destructive changes'),
+    }),
+    intent: 'destroy',
+    output: z.object({
+        dryRun: z.boolean(),
+        removed: z.boolean(),
+        snapshot: topoSnapshotOutput.optional(),
+    }),
+    permit: { scopes: ['topo:delete'] },
+});
+//# sourceMappingURL=topo-unpin.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"topo-unpin.js","sourceRoot":"","sources":["../../../src/trails/topo-unpin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC,YAAY,EAAE;IAChD,KAAK,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACpB,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC;YAChD,OAAO,MAAM,CAAC,GAAG,CACf,IAAI,eAAe,CACjB,0DAA0D,CAC3D,CACF,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,GAAG,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAC1D,OAAO,MAAM,CAAC,EAAE,CACd,wBAAwB,CAAC;YACvB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO;SACR,CAAC,CACH,CAAC;IACJ,CAAC;IACD,WAAW,EAAE,yBAAyB;IACtC,QAAQ,EAAE;QACR;YACE,KAAK,EAAE;gBACL,GAAG,0BAA0B,CAAC,YAAY,CAAC;gBAC3C,MAAM,EAAE,IAAI;gBACZ,IAAI,EAAE,sBAAsB;aAC7B;YACD,IAAI,EAAE,qBAAqB;SAC5B;KACF;IACD,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,MAAM,EAAE,CAAC;aACN,OAAO,EAAE;aACT,OAAO,CAAC,IAAI,CAAC;aACb,QAAQ,CAAC,4CAA4C,CAAC;QACzD,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;QACnE,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,6BAA6B,CAAC;KACxE,CAAC;IACF,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;QACnB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;QACpB,QAAQ,EAAE,kBAAkB,CAAC,QAAQ,EAAE;KACxC,CAAC;IACF,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,aAAa,CAAC,EAAE;CACpC,CAAC,CAAC"}

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

@@ -0,0 +1,5 @@
+export declare const topoVerifyTrail: import("@ontrails/core").Trail<{
+    module?: string | undefined;
+    rootDir?: string | undefined;
+}, import("./topo-support.js").TopoVerifyReport, never>;
+//# sourceMappingURL=topo-verify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"topo-verify.d.ts","sourceRoot":"","sources":["../../../src/trails/topo-verify.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,eAAe;;;uDAkB1B,CAAC"}

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

@@ -0,0 +1,24 @@
+import { trail } from '@ontrails/core';
+import { z } from 'zod';
+import { loadApp } from './load-app.js';
+import { verifyCurrentTopo } from './topo-read-support.js';
+export const topoVerifyTrail = trail('topo.verify', {
+    blaze: async (input, ctx) => {
+        const rootDir = input.rootDir ?? ctx.cwd ?? process.cwd();
+        const app = await loadApp(input.module, rootDir);
+        return verifyCurrentTopo(app, { rootDir });
+    },
+    description: 'Verify that the committed lockfile matches the current topo',
+    input: z.object({
+        module: z.string().optional().describe('Path to the app module'),
+        rootDir: z.string().optional().describe('Workspace root directory'),
+    }),
+    intent: 'read',
+    output: z.object({
+        committedHash: z.string(),
+        currentHash: z.string(),
+        lockPath: z.string(),
+        stale: z.literal(false),
+    }),
+});
+//# sourceMappingURL=topo-verify.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"topo-verify.js","sourceRoot":"","sources":["../../../src/trails/topo-verify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC,aAAa,EAAE;IAClD,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,iBAAiB,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC7C,CAAC;IACD,WAAW,EAAE,6DAA6D;IAC1E,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;QAChE,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,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;QACzB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;KACxB,CAAC;CACH,CAAC,CAAC"}

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

@@ -0,0 +1,5 @@
+export declare const topoTrail: import("@ontrails/core").Trail<{
+    module?: string | undefined;
+    rootDir?: string | undefined;
+}, import("./topo-support.js").TopoSummaryReport, never>;
+//# sourceMappingURL=topo.d.ts.map

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

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

package/dist/src/trails/topo.js

@@ -0,0 +1,63 @@
+import { Result, trail } from '@ontrails/core';
+import { z } from 'zod';
+import { loadApp } from './load-app.js';
+import { buildTopoSummary } from './topo-read-support.js';
+const summaryOutput = z.object({
+    app: z.object({
+        contractVersion: z.string(),
+        features: z.object({
+            detours: z.boolean(),
+            examples: z.boolean(),
+            outputSchemas: z.boolean(),
+            resources: z.boolean(),
+            signals: z.boolean(),
+        }),
+        name: z.string(),
+        resources: z.number(),
+        signals: z.number(),
+        trails: z.number(),
+        version: z.string(),
+    }),
+    dbPath: z.string(),
+    list: z.object({
+        count: z.number(),
+        entries: z.array(z.object({
+            examples: z.number(),
+            id: z.string(),
+            kind: z.string(),
+            safety: z.string(),
+        })),
+        resourceCount: z.number(),
+        resources: z.array(z.object({
+            description: z.string().nullable(),
+            health: z.enum(['available', 'none']),
+            id: z.string(),
+            kind: z.literal('resource'),
+            lifetime: z.literal('singleton'),
+            usedBy: z.array(z.string()),
+        })),
+    }),
+    lockExists: z.boolean(),
+    lockPath: z.string(),
+});
+export const topoTrail = trail('topo', {
+    blaze: async (input, ctx) => {
+        const rootDir = input.rootDir ?? ctx.cwd ?? process.cwd();
+        const app = await loadApp(input.module, rootDir);
+        return Result.ok(buildTopoSummary(app, { rootDir }));
+    },
+    description: 'Show the current topo summary and entry list',
+    examples: [
+        {
+            input: {},
+            name: 'Show the current topo summary',
+        },
+    ],
+    input: z.object({
+        module: z.string().optional().describe('Path to the app module'),
+        rootDir: z.string().optional().describe('Workspace root directory'),
+    }),
+    intent: 'read',
+    output: summaryOutput,
+});
+//# sourceMappingURL=topo.js.map

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

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

package/dist/src/trails/warden.d.ts

@@ -5,8 +5,9 @@
  */
 export declare const wardenTrail: import("@ontrails/core").Trail<{
     driftOnly: boolean;
-    format: "summary" | "text" | "github" | "json";
+    format: "text" | "summary" | "json" | "github";
     lintOnly: boolean;
+    module?: string | undefined;
     rootDir?: string | undefined;
 }, {
     diagnostics: readonly import("@ontrails/warden").WardenDiagnostic[];
@@ -15,5 +16,5 @@ export declare const wardenTrail: import("@ontrails/core").Trail<{
     formatted: string;
     passed: boolean;
     warnCount: number;
-}>;
+}, never>;
 //# sourceMappingURL=warden.d.ts.map

package/dist/src/trails/warden.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"warden.d.ts","sourceRoot":"","sources":["../../../src/trails/warden.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH,eAAO,MAAM,WAAW;;;;;;;;;;;;EAiFtB,CAAC"}
+{"version":3,"file":"warden.d.ts","sourceRoot":"","sources":["../../../src/trails/warden.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH,eAAO,MAAM,WAAW;;;;;;;;;;;;;SA2FtB,CAAC"}

package/dist/src/trails/warden.js

@@ -11,6 +11,38 @@ import { loadApp } from './load-app.js';
 // Trail definition
 // ---------------------------------------------------------------------------
 export const wardenTrail = trail('warden', {
+    blaze: async (input, ctx) => {
+        const rootDir = input.rootDir ?? ctx.cwd ?? process.cwd();
+        // oxlint-disable-next-line prefer-await-to-then -- catch preserves graceful degradation
+        const topo = await loadApp(input.module, rootDir).catch((error) => {
+            ctx.logger?.warn('Could not load app for topo-aware governance', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return undefined;
+        });
+        const report = await runWarden({
+            driftOnly: input.driftOnly,
+            lintOnly: input.lintOnly,
+            rootDir,
+            topo,
+        });
+        const formatters = {
+            github: formatGitHubAnnotations,
+            json: formatJson,
+            summary: formatSummary,
+            text: formatWardenReport,
+        };
+        const formatter = formatters[input.format] ?? formatWardenReport;
+        const formatted = formatter(report);
+        return Result.ok({
+            diagnostics: report.diagnostics,
+            drift: report.drift,
+            errorCount: report.errorCount,
+            formatted,
+            passed: report.passed,
+            warnCount: report.warnCount,
+        });
+    },
     description: 'Run governance checks (lint + drift)',
     examples: [
         {
@@ -34,6 +66,10 @@ export const wardenTrail = trail('warden', {
             .default('text')
             .describe('Output format: text, json, github, or summary'),
         lintOnly: z.boolean().default(false).describe('Only run lint rules'),
+        module: z
+            .string()
+            .optional()
+            .describe('App module path (auto-discovered if omitted)'),
         rootDir: z.string().optional().describe('Root directory to scan'),
     }),
     intent: 'read',
@@ -47,6 +83,7 @@ export const wardenTrail = trail('warden', {
         })),
         drift: z
             .object({
+            blockedReason: z.string().optional(),
             committedHash: z.string().nullable(),
             currentHash: z.string(),
             stale: z.boolean(),
@@ -57,32 +94,5 @@ export const wardenTrail = trail('warden', {
         passed: z.boolean(),
         warnCount: z.number(),
     }),
-    run: async (input, ctx) => {
-        const rootDir = input.rootDir ?? ctx.cwd ?? process.cwd();
-        // oxlint-disable-next-line prefer-await-to-then -- catch converts rejection to undefined cleanly
-        const topo = await loadApp('./src/app.ts', rootDir).catch(() => undefined);
-        const report = await runWarden({
-            driftOnly: input.driftOnly,
-            lintOnly: input.lintOnly,
-            rootDir,
-            topo,
-        });
-        const formatters = {
-            github: formatGitHubAnnotations,
-            json: formatJson,
-            summary: formatSummary,
-            text: formatWardenReport,
-        };
-        const formatter = formatters[input.format] ?? formatWardenReport;
-        const formatted = formatter(report);
-        return Result.ok({
-            diagnostics: report.diagnostics,
-            drift: report.drift,
-            errorCount: report.errorCount,
-            formatted,
-            passed: report.passed,
-            warnCount: report.warnCount,
-        });
-    },
 });
 //# sourceMappingURL=warden.js.map

package/dist/src/trails/warden.js.map

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

package/dist/src/versions.d.ts

@@ -0,0 +1,12 @@
+export declare const trailsPackageVersion: string;
+export declare const ontrailsPackageRange: string;
+export declare const scaffoldDependencyVersions: {
+    readonly bunTypes: string;
+    readonly commander: string;
+    readonly lefthook: string;
+    readonly oxlint: string;
+    readonly typescript: string;
+    readonly ultracite: string;
+    readonly zod: string;
+};
+//# sourceMappingURL=versions.d.ts.map

package/dist/src/versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.d.ts","sourceRoot":"","sources":["../../src/versions.ts"],"names":[],"mappings":"AA2BA,eAAO,MAAM,oBAAoB,QAGhC,CAAC;AAEF,eAAO,MAAM,oBAAoB,QAA6B,CAAC;AAE/D,eAAO,MAAM,0BAA0B;;;;;;;;CAQ7B,CAAC"}

package/dist/src/versions.js

@@ -0,0 +1,23 @@
+const readPackageJson = async (url) => (await Bun.file(url).json());
+const appPackageJson = await readPackageJson(new URL('../package.json', import.meta.url));
+const rootPackageJson = await readPackageJson(new URL('../../../package.json', import.meta.url));
+const requireVersion = (value, label) => {
+    if (typeof value !== 'string' || value.length === 0) {
+        throw new Error(`Missing version for ${label}`);
+    }
+    return value;
+};
+const rootCatalog = rootPackageJson.catalog ?? {};
+const rootDevDependencies = rootPackageJson.devDependencies ?? {};
+export const trailsPackageVersion = requireVersion(appPackageJson.version, '@ontrails/trails');
+export const ontrailsPackageRange = `^${trailsPackageVersion}`;
+export const scaffoldDependencyVersions = {
+    bunTypes: requireVersion(rootDevDependencies['@types/bun'], '@types/bun'),
+    commander: requireVersion(rootCatalog['commander'], 'commander'),
+    lefthook: requireVersion(rootDevDependencies['lefthook'], 'lefthook'),
+    oxlint: requireVersion(rootDevDependencies['oxlint'], 'oxlint'),
+    typescript: requireVersion(rootDevDependencies['typescript'], 'typescript'),
+    ultracite: requireVersion(rootDevDependencies['ultracite'], 'ultracite'),
+    zod: requireVersion(rootCatalog['zod'], 'zod'),
+};
+//# sourceMappingURL=versions.js.map

package/dist/src/versions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.js","sourceRoot":"","sources":["../../src/versions.ts"],"names":[],"mappings":"AAOA,MAAM,eAAe,GAAG,KAAK,EAAE,GAAQ,EAAwB,EAAE,CAC/D,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAgB,CAAC;AAE9C,MAAM,cAAc,GAAG,MAAM,eAAe,CAC1C,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAC5C,CAAC;AACF,MAAM,eAAe,GAAG,MAAM,eAAe,CAC3C,IAAI,GAAG,CAAC,uBAAuB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAClD,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,KAAyB,EAAE,KAAa,EAAU,EAAE;IAC1E,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,uBAAuB,KAAK,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,eAAe,CAAC,OAAO,IAAI,EAAE,CAAC;AAClD,MAAM,mBAAmB,GAAG,eAAe,CAAC,eAAe,IAAI,EAAE,CAAC;AAElE,MAAM,CAAC,MAAM,oBAAoB,GAAG,cAAc,CAChD,cAAc,CAAC,OAAO,EACtB,kBAAkB,CACnB,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAE/D,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,QAAQ,EAAE,cAAc,CAAC,mBAAmB,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACzE,SAAS,EAAE,cAAc,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IAChE,QAAQ,EAAE,cAAc,CAAC,mBAAmB,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACrE,MAAM,EAAE,cAAc,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC/D,UAAU,EAAE,cAAc,CAAC,mBAAmB,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC3E,SAAS,EAAE,cAAc,CAAC,mBAAmB,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACxE,GAAG,EAAE,cAAc,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;CACtC,CAAC"}

package/dist/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/app.ts","../src/clack.ts","../src/cli.ts","../src/trails/add-surface.ts","../src/trails/add-trail.ts","../src/trails/add-verify.ts","../src/trails/create-scaffold.ts","../src/trails/create.ts","../src/trails/guide.ts","../src/trails/load-app.ts","../src/trails/project.ts","../src/trails/survey.ts","../src/trails/warden.ts","../bin/trails.ts"],"version":"5.9.3"}
+{"root":["../src/app.ts","../src/clack.ts","../src/cli.ts","../src/versions.ts","../src/trails/add-surface.ts","../src/trails/add-trail.ts","../src/trails/add-verify.ts","../src/trails/create-scaffold.ts","../src/trails/create.ts","../src/trails/dev-clean.ts","../src/trails/dev-reset.ts","../src/trails/dev-stats.ts","../src/trails/dev-support.ts","../src/trails/draft-promote.ts","../src/trails/guide.ts","../src/trails/load-app.ts","../src/trails/project.ts","../src/trails/survey.ts","../src/trails/topo-constants.ts","../src/trails/topo-export.ts","../src/trails/topo-history.ts","../src/trails/topo-pin.ts","../src/trails/topo-read-support.ts","../src/trails/topo-reports.ts","../src/trails/topo-show.ts","../src/trails/topo-store-support.ts","../src/trails/topo-support.ts","../src/trails/topo-unpin.ts","../src/trails/topo-verify.ts","../src/trails/topo.ts","../src/trails/warden.ts","../bin/trails.ts"],"version":"5.9.3"}