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

package/dist/src/trails/draft-promote.d.ts

@@ -0,0 +1,18 @@
+export declare const draftPromoteTrail: import("@ontrails/core").Trail<{
+    fromId: string;
+    renameFiles: boolean;
+    toId: string;
+    appModule?: string | undefined;
+    rootDir?: string | undefined;
+}, {
+    appModule: string | null;
+    message: string;
+    promotedEstablished: boolean;
+    remainingDraftIds: string[];
+    renamedFiles: {
+        from: string;
+        to: string;
+    }[];
+    updatedFiles: string[];
+}>;
+//# sourceMappingURL=draft-promote.d.ts.map

package/dist/src/trails/draft-promote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft-promote.d.ts","sourceRoot":"","sources":["../../../src/trails/draft-promote.ts"],"names":[],"mappings":"AAkpBA,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;EA6C5B,CAAC"}

package/dist/src/trails/draft-promote.js

@@ -0,0 +1,386 @@
+import { existsSync, renameSync, statSync } from 'node:fs';
+import { basename, dirname, join, relative } from 'node:path';
+import { Result, ValidationError, analyzeDraftState, isDraftId, trail, } from '@ontrails/core';
+import { DRAFT_FILE_PREFIX, findStringLiterals, isDraftMarkedFile, parse, stripDraftFileMarkers, } from '@ontrails/warden';
+import { z } from 'zod';
+import { loadApp } from './load-app.js';
+import { findTopoPath } from './project.js';
+const isManagedSourceFile = (match) => !match.endsWith('.d.ts') &&
+    !match.startsWith('node_modules/') &&
+    !match.startsWith('dist/') &&
+    !match.startsWith('.git/');
+const collectTsFiles = (rootDir) => {
+    const files = [];
+    for (const match of new Bun.Glob('**/*.ts').scanSync({
+        cwd: rootDir,
+        dot: false,
+        onlyFiles: true,
+    })) {
+        if (isManagedSourceFile(match)) {
+            files.push(join(rootDir, match));
+        }
+    }
+    return files.toSorted();
+};
+const applyEdits = (sourceCode, edits) => {
+    let updated = sourceCode;
+    for (const edit of [...edits].toSorted((a, b) => b.start - a.start)) {
+        updated =
+            updated.slice(0, edit.start) + edit.replacement + updated.slice(edit.end);
+    }
+    return updated;
+};
+const literalQuote = (raw) => {
+    const [first] = raw;
+    return first === '"' || first === '`' ? first : "'";
+};
+const replaceQuotedLiteral = (sourceCode, start, end, nextValue) => {
+    const quote = literalQuote(sourceCode.slice(start, end));
+    return `${quote}${nextValue}${quote}`;
+};
+const replaceIdLiterals = (sourceCode, filePath, fromId, toId) => {
+    const ast = parse(filePath, sourceCode);
+    if (!ast) {
+        return { changed: false, nextSource: sourceCode };
+    }
+    const edits = findStringLiterals(ast, (value) => value === fromId).map((match) => ({
+        end: match.end,
+        replacement: replaceQuotedLiteral(sourceCode, match.start, match.end, toId),
+        start: match.start,
+    }));
+    if (edits.length === 0) {
+        return { changed: false, nextSource: sourceCode };
+    }
+    return {
+        changed: true,
+        nextSource: applyEdits(sourceCode, edits),
+    };
+};
+const hasDraftIds = (sourceCode, filePath) => {
+    const ast = parse(filePath, sourceCode);
+    if (!ast) {
+        return sourceCode.includes(DRAFT_FILE_PREFIX);
+    }
+    return findStringLiterals(ast, (value) => isDraftId(value)).length > 0;
+};
+const toJsPath = (filePath) => filePath.replace(/\.ts$/, '.js');
+const toRelativeModulePath = (fromFile, toFile) => {
+    const rel = relative(dirname(fromFile), toJsPath(toFile)).replaceAll('\\', '/');
+    return rel.startsWith('.') ? rel : `./${rel}`;
+};
+const replaceLiteralValue = (sourceCode, filePath, currentValue, nextValue) => {
+    const ast = parse(filePath, sourceCode);
+    if (!ast) {
+        return { changed: false, nextSource: sourceCode };
+    }
+    const edits = findStringLiterals(ast, (value) => value === currentValue).map((match) => ({
+        end: match.end,
+        replacement: replaceQuotedLiteral(sourceCode, match.start, match.end, nextValue),
+        start: match.start,
+    }));
+    if (edits.length === 0) {
+        return { changed: false, nextSource: sourceCode };
+    }
+    return {
+        changed: true,
+        nextSource: applyEdits(sourceCode, edits),
+    };
+};
+const collectOutputId = (app, id) => app.get(id) ?? app.signals.get(id) ?? app.getProvision(id);
+const toRelativeOutputPath = (rootDir, filePath) => relative(rootDir, filePath).replaceAll('\\', '/');
+const toProjectModulePath = (sourceImport) => sourceImport.startsWith('./')
+    ? `./src/${sourceImport.slice(2)}`
+    : sourceImport;
+const validatePromotionInput = (input) => {
+    if (!isDraftId(input.fromId)) {
+        return Result.err(new ValidationError(`fromId must use the reserved draft prefix: "${input.fromId}"`));
+    }
+    if (isDraftId(input.toId)) {
+        return Result.err(new ValidationError(`toId must be established, not draft: "${input.toId}"`));
+    }
+    return Result.ok();
+};
+const validatePromotionRoot = (rootDir) => {
+    if (!existsSync(rootDir)) {
+        return Result.err(new ValidationError(`rootDir does not exist: "${rootDir}"`));
+    }
+    if (!statSync(rootDir).isDirectory()) {
+        return Result.err(new ValidationError(`rootDir must be a directory: "${rootDir}"`));
+    }
+    return Result.ok();
+};
+const resolveValidatedPromotionRoot = (input, ctx) => {
+    const validation = validatePromotionInput(input);
+    if (validation.isErr()) {
+        return validation;
+    }
+    const rootDir = input.rootDir ?? ctx.cwd ?? process.cwd();
+    const rootValidation = validatePromotionRoot(rootDir);
+    if (rootValidation.isErr()) {
+        return rootValidation;
+    }
+    return Result.ok(rootDir);
+};
+const rewritePromotedSourceFiles = async (filePaths, fromId, toId, updatedSourceFiles) => {
+    for (const filePath of filePaths) {
+        const sourceCode = await Bun.file(filePath).text();
+        const replaced = replaceIdLiterals(sourceCode, filePath, fromId, toId);
+        if (!replaced.changed) {
+            continue;
+        }
+        await Bun.write(filePath, replaced.nextSource);
+        updatedSourceFiles.add(filePath);
+    }
+};
+const hasDraftIdsInFile = async (filePath) => {
+    const sourceCode = await Bun.file(filePath).text();
+    return hasDraftIds(sourceCode, filePath);
+};
+const buildPromotableFileRename = (filePath, fileName) => {
+    const nextFileName = stripDraftFileMarkers(fileName);
+    if (nextFileName === fileName) {
+        return Result.ok(null);
+    }
+    const nextPath = join(dirname(filePath), nextFileName);
+    if (nextPath !== filePath && existsSync(nextPath)) {
+        return Result.err(new ValidationError(`Cannot promote draft file "${filePath}" because "${nextPath}" already exists.`));
+    }
+    return Result.ok({ from: filePath, to: nextPath });
+};
+const collectPromotableFileRename = async (filePath) => {
+    if (!isDraftMarkedFile(filePath)) {
+        return Result.ok(null);
+    }
+    const fileName = basename(filePath);
+    if (!fileName) {
+        return Result.ok(null);
+    }
+    if (await hasDraftIdsInFile(filePath)) {
+        return Result.ok(null);
+    }
+    return buildPromotableFileRename(filePath, fileName);
+};
+/** Validate that no two renames target the same path and no target already exists. */
+const validateRenameTargets = (renames) => {
+    const targets = new Set();
+    for (const r of renames) {
+        if (targets.has(r.to)) {
+            return Result.err(new ValidationError(`Duplicate rename target "${r.to}" — multiple draft files would be renamed to the same path`));
+        }
+        if (existsSync(r.to)) {
+            return Result.err(new ValidationError(`Rename target "${r.to}" already exists — cannot overwrite`));
+        }
+        targets.add(r.to);
+    }
+    return Result.ok();
+};
+const collectFileRenames = async (filePaths) => {
+    const renames = [];
+    for (const filePath of filePaths) {
+        const renameResult = await collectPromotableFileRename(filePath);
+        if (renameResult.isErr()) {
+            return renameResult;
+        }
+        if (renameResult.value !== null) {
+            renames.push(renameResult.value);
+        }
+    }
+    return Result.ok(renames);
+};
+const collectAndApplyFileRenames = async (filePaths) => {
+    const collected = await collectFileRenames(filePaths);
+    if (collected.isErr()) {
+        return collected;
+    }
+    const renames = collected.value;
+    const valid = validateRenameTargets(renames);
+    if (valid.isErr()) {
+        return valid;
+    }
+    for (const r of renames) {
+        renameSync(r.from, r.to);
+    }
+    return Result.ok(renames);
+};
+const applyRenameEffects = (updatedSourceFiles, renames) => {
+    for (const rename of renames) {
+        if (updatedSourceFiles.delete(rename.from)) {
+            updatedSourceFiles.add(rename.to);
+        }
+    }
+};
+const applyRelativeImportRename = (sourceCode, filePath, rename) => {
+    const currentValue = toRelativeModulePath(filePath, rename.from);
+    const nextValue = toRelativeModulePath(filePath, rename.to);
+    if (currentValue === nextValue) {
+        return { changed: false, sourceCode };
+    }
+    const replaced = replaceLiteralValue(sourceCode, filePath, currentValue, nextValue);
+    if (!replaced.changed) {
+        return { changed: false, sourceCode };
+    }
+    return { changed: true, sourceCode: replaced.nextSource };
+};
+const rewriteRelativeImportsForFile = (filePath, renames, sourceCode) => {
+    let nextSourceCode = sourceCode;
+    let changed = false;
+    for (const rename of renames) {
+        const updated = applyRelativeImportRename(nextSourceCode, filePath, rename);
+        if (!updated.changed) {
+            continue;
+        }
+        nextSourceCode = updated.sourceCode;
+        changed = true;
+    }
+    return { changed, sourceCode: nextSourceCode };
+};
+const updateRelativeImportsForFile = async (filePath, renames) => {
+    const sourceCode = await Bun.file(filePath).text();
+    const updated = rewriteRelativeImportsForFile(filePath, renames, sourceCode);
+    if (updated.changed) {
+        await Bun.write(filePath, updated.sourceCode);
+        return true;
+    }
+    return false;
+};
+const updateRelativeImports = async (filePaths, renames) => {
+    const updatedFiles = new Set();
+    for (const filePath of filePaths) {
+        const changed = await updateRelativeImportsForFile(filePath, renames);
+        if (changed) {
+            updatedFiles.add(filePath);
+        }
+    }
+    return [...updatedFiles].toSorted();
+};
+const rewritePromotionState = async (rootDir, input) => {
+    const initialFiles = collectTsFiles(rootDir);
+    const updatedSourceFiles = new Set();
+    await rewritePromotedSourceFiles(initialFiles, input.fromId, input.toId, updatedSourceFiles);
+    const renamesResult = input.renameFiles
+        ? await collectAndApplyFileRenames(initialFiles)
+        : Result.ok([]);
+    if (renamesResult.isErr()) {
+        return Result.err(renamesResult.error);
+    }
+    applyRenameEffects(updatedSourceFiles, renamesResult.value);
+    for (const f of await updateRelativeImports(collectTsFiles(rootDir), renamesResult.value)) {
+        updatedSourceFiles.add(f);
+    }
+    return Result.ok({ renames: renamesResult.value, updatedSourceFiles });
+};
+const resolvePromotionAppModule = async (input, rootDir) => {
+    const discoveredAppModule = await findTopoPath(rootDir);
+    return (input.appModule ??
+        (discoveredAppModule === null
+            ? null
+            : toProjectModulePath(discoveredAppModule)));
+};
+const loadVerifiedApp = async (appModule, rootDir) => {
+    if (appModule === null) {
+        return { appModule, loadError: null, loadedApp: undefined };
+    }
+    let loadError = null;
+    const loadedApp = await loadApp(appModule, rootDir, { fresh: true }).catch((error) => {
+        loadError = error instanceof Error ? error.message : String(error);
+        return undefined;
+    });
+    return { appModule, loadError, loadedApp };
+};
+const toRenamedFiles = (rootDir, renames) => renames.map((rename) => ({
+    from: toRelativeOutputPath(rootDir, rename.from),
+    to: toRelativeOutputPath(rootDir, rename.to),
+}));
+const toUpdatedFiles = (rootDir, updatedSourceFiles) => [...updatedSourceFiles]
+    .toSorted()
+    .map((filePath) => toRelativeOutputPath(rootDir, filePath));
+const buildUnverifiedPromotionResult = (rootDir, loadError, renames, updatedSourceFiles, appModule) => Result.ok({
+    appModule,
+    message: loadError === null
+        ? 'Promotion rewrote source files, but no topo entrypoint could be loaded for verification.'
+        : `Promotion rewrote source files, but verification failed: ${loadError}`,
+    promotedEstablished: false,
+    remainingDraftIds: [],
+    renamedFiles: toRenamedFiles(rootDir, renames),
+    updatedFiles: toUpdatedFiles(rootDir, updatedSourceFiles),
+});
+const buildVerifiedPromotionResult = (rootDir, analysis, promotedEstablished, renames, updatedSourceFiles, appModule, toId) => {
+    const blockingFinding = analysis.findings.find((finding) => finding.id === toId);
+    return Result.ok({
+        appModule,
+        message: blockingFinding?.message ??
+            (promotedEstablished
+                ? `Promoted "${toId}" is now established.`
+                : `Promoted "${toId}" could not be verified as established.`),
+        promotedEstablished,
+        remainingDraftIds: [...analysis.declaredDraftIds].toSorted(),
+        renamedFiles: toRenamedFiles(rootDir, renames),
+        updatedFiles: toUpdatedFiles(rootDir, updatedSourceFiles),
+    });
+};
+const buildVerifiedPromotionResultFromApp = (rootDir, loadedApp, renames, updatedSourceFiles, appModule, toId) => {
+    const analysis = analyzeDraftState(loadedApp);
+    const promotedNode = collectOutputId(loadedApp, toId);
+    const promotedEstablished = promotedNode !== undefined && !analysis.contaminatedIds.has(toId);
+    return buildVerifiedPromotionResult(rootDir, analysis, promotedEstablished, renames, updatedSourceFiles, appModule, toId);
+};
+const promoteDraftState = async (input, ctx) => {
+    const rootDirResult = resolveValidatedPromotionRoot(input, ctx);
+    if (rootDirResult.isErr()) {
+        return rootDirResult;
+    }
+    const rewriteResult = await rewritePromotionState(rootDirResult.value, input);
+    if (rewriteResult.isErr()) {
+        return Result.err(rewriteResult.error);
+    }
+    const { renames, updatedSourceFiles } = rewriteResult.value;
+    const appModule = await resolvePromotionAppModule(input, rootDirResult.value);
+    const { loadError, loadedApp } = await loadVerifiedApp(appModule, rootDirResult.value);
+    return loadedApp
+        ? buildVerifiedPromotionResultFromApp(rootDirResult.value, loadedApp, renames, updatedSourceFiles, appModule, input.toId)
+        : buildUnverifiedPromotionResult(rootDirResult.value, loadError, renames, updatedSourceFiles, appModule);
+};
+export const draftPromoteTrail = trail('draft.promote', {
+    blaze: promoteDraftState,
+    description: 'Promote a draft id to an established id, rewrite inbound references, and verify the result against a fresh topo load.',
+    examples: [
+        {
+            error: 'ValidationError',
+            input: {
+                fromId: '_draft.entity.prepare',
+                renameFiles: true,
+                rootDir: './__does_not_exist__/draft-promote-example',
+                toId: 'entity.prepare',
+            },
+            name: 'Rejects a missing project root before any rewrite begins',
+        },
+    ],
+    input: z.object({
+        appModule: z
+            .string()
+            .optional()
+            .describe('Optional app module to verify after promotion'),
+        fromId: z.string().describe('Draft id to promote'),
+        renameFiles: z
+            .boolean()
+            .default(true)
+            .describe('Rename draft-marked files that no longer contain draft ids'),
+        rootDir: z.string().optional().describe('Project root directory'),
+        toId: z
+            .string()
+            .describe('Established id to write in place of the draft id'),
+    }),
+    intent: 'write',
+    output: z.object({
+        appModule: z.string().nullable(),
+        message: z.string(),
+        promotedEstablished: z.boolean(),
+        remainingDraftIds: z.array(z.string()),
+        renamedFiles: z.array(z.object({
+            from: z.string(),
+            to: z.string(),
+        })),
+        updatedFiles: z.array(z.string()),
+    }),
+});
+//# sourceMappingURL=draft-promote.js.map

package/dist/src/trails/draft-promote.js.map

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

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

@@ -3,9 +3,19 @@
  *
  * Lists trails with descriptions and examples. Detailed guidance is planned for post-v1.
  */
-import type { Trail } from '@ontrails/core';
-export declare const guideTrail: Trail<{
+export declare const guideTrail: import("@ontrails/core").Trail<{
     module: string;
     trailId?: string | undefined;
-}, object>;
+}, {
+    description: string;
+    exampleCount: number;
+    id: string;
+    kind: string;
+}[] | {
+    description: string | null;
+    detours: unknown;
+    examples: unknown[];
+    id: string;
+    kind: string;
+}>;
 //# sourceMappingURL=guide.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"guide.d.ts","sourceRoot":"","sources":["../../../src/trails/guide.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAQ,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAkDlD,eAAO,MAAM,UAAU;;;UA+CrB,CAAC"}
+{"version":3,"file":"guide.d.ts","sourceRoot":"","sources":["../../../src/trails/guide.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA0BH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;EA0DrB,CAAC"}

package/dist/src/trails/guide.js

@@ -3,42 +3,37 @@
  *
  * Lists trails with descriptions and examples. Detailed guidance is planned for post-v1.
  */
-import { Result, trail } from '@ontrails/core';
+import { NotFoundError, Result, trail } from '@ontrails/core';
 import { z } from 'zod';
 import { loadApp } from './load-app.js';
+import { buildCurrentGuideEntries, buildCurrentTopoDetail, } from './topo-read-support.js';
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
-const toGuideEntries = (app) => {
-    const entries = [];
-    for (const item of app.list()) {
-        const raw = item;
-        entries.push({
-            description: typeof raw['description'] === 'string'
-                ? raw['description']
-                : '(no description)',
-            exampleCount: Array.isArray(raw['examples'])
-                ? raw['examples'].length
-                : 0,
-            id: item.id,
-            kind: item.kind,
-        });
-    }
-    return entries;
-};
-const toGuideDetail = (item) => ({
-    description: item.description ?? null,
-    detours: item.detours ?? null,
-    examples: item.examples ?? [],
-    id: item.id,
-    kind: item.kind,
-});
 export const guideTrail = trail('guide', {
+    blaze: async (input, ctx) => {
+        const rootDir = ctx.cwd ?? '.';
+        const app = await loadApp(input.module, rootDir);
+        if (input.trailId) {
+            const detail = buildCurrentTopoDetail(app, input.trailId, { rootDir });
+            if (detail === undefined || detail.kind !== 'trail') {
+                return Result.err(new NotFoundError(`Trail not found: ${input.trailId}`));
+            }
+            return Result.ok({
+                description: detail.description,
+                detours: detail.detours,
+                examples: detail.examples,
+                id: detail.id,
+                kind: detail.kind,
+            });
+        }
+        return Result.ok(buildCurrentGuideEntries(app, { rootDir }));
+    },
     description: 'Runtime guidance for trails',
     examples: [
         {
             description: 'Lists all trails with descriptions and example counts',
-            input: {},
+            input: { module: './src/app.ts' },
             name: 'List trail guidance',
         },
     ],
@@ -65,16 +60,5 @@ export const guideTrail = trail('guide', {
             kind: z.string(),
         }),
     ]),
-    run: async (input, ctx) => {
-        const app = await loadApp(input.module, ctx.cwd ?? '.');
-        if (input.trailId) {
-            const item = app.get(input.trailId);
-            if (!item) {
-                return Result.err(new Error(`Trail not found: ${input.trailId}`));
-            }
-            return Result.ok(toGuideDetail(item));
-        }
-        return Result.ok(toGuideEntries(app));
-    },
 });
 //# sourceMappingURL=guide.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"guide.js","sourceRoot":"","sources":["../../../src/trails/guide.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"guide.js","sourceRoot":"","sources":["../../../src/trails/guide.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EACL,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAahC,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,EAAE;IACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC1B,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC;QAC/B,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAEjD,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,MAAM,GAAG,sBAAsB,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;YACvE,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBACpD,OAAO,MAAM,CAAC,GAAG,CACf,IAAI,aAAa,CAAC,oBAAoB,KAAK,CAAC,OAAO,EAAE,CAAC,CACvD,CAAC;YACJ,CAAC;YACD,OAAO,MAAM,CAAC,EAAE,CAAC;gBACf,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,IAAI,EAAE,MAAM,CAAC,IAAI;aAClB,CAAC,CAAC;QACL,CAAC;QAED,OAAO,MAAM,CAAC,EAAE,CACd,wBAAwB,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAiB,CAC3D,CAAC;IACJ,CAAC;IACD,WAAW,EAAE,6BAA6B;IAC1C,QAAQ,EAAE;QACR;YACE,WAAW,EAAE,uDAAuD;YACpE,KAAK,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE;YACjC,IAAI,EAAE,qBAAqB;SAC5B;KACF;IACD,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,OAAO,CAAC,cAAc,CAAC;aACvB,QAAQ,CAAC,wBAAwB,CAAC;QACrC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;KAC1E,CAAC;IACF,MAAM,EAAE,MAAM;IACd,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC;QACd,CAAC,CAAC,KAAK,CACL,CAAC,CAAC,MAAM,CAAC;YACP,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;YACvB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;YACxB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;YACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;SACjB,CAAC,CACH;QACD,CAAC,CAAC,MAAM,CAAC;YACP,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAClC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YAC/B,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YAC9B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;YACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;SACjB,CAAC;KACH,CAAC;CACH,CAAC,CAAC"}

package/dist/src/trails/load-app.d.ts

@@ -1,4 +1,6 @@
 import type { Topo } from '@ontrails/core';
 /** Load a Topo export from a module path relative to cwd. */
-export declare const loadApp: (modulePath: string, cwd: string) => Promise<Topo>;
+export declare const loadApp: (modulePath: string, cwd: string, options?: {
+    fresh?: boolean | undefined;
+}) => Promise<Topo>;
 //# sourceMappingURL=load-app.d.ts.map

package/dist/src/trails/load-app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load-app.d.ts","sourceRoot":"","sources":["../../../src/trails/load-app.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAgB3C,6DAA6D;AAC7D,eAAO,MAAM,OAAO,GAClB,YAAY,MAAM,EAClB,KAAK,MAAM,KACV,OAAO,CAAC,IAAI,CAad,CAAC"}
+{"version":3,"file":"load-app.d.ts","sourceRoot":"","sources":["../../../src/trails/load-app.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAuE3C,6DAA6D;AAC7D,eAAO,MAAM,OAAO,GAClB,YAAY,MAAM,EAClB,KAAK,MAAM,EACX,UAAS;IAAE,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAAO,KAC5C,OAAO,CAAC,IAAI,CAmBd,CAAC"}

package/dist/src/trails/load-app.js

@@ -1,19 +1,62 @@
-import { isAbsolute, resolve } from 'node:path';
-import { pathToFileURL } from 'node:url';
+import { existsSync, rmSync } from 'node:fs';
+import { basename, dirname, isAbsolute, join, resolve } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
 const URL_SCHEME = /^[a-zA-Z][a-zA-Z\d+.-]*:/;
-/** Resolve a module path from cwd so CLI defaults behave like shell paths. */
-const resolveModuleSpecifier = (modulePath, cwd) => {
-    if (URL_SCHEME.test(modulePath)) {
-        return modulePath;
-    }
+const resolveUrlModulePath = (modulePath) => {
+    const url = new URL(modulePath);
+    return url.protocol === 'file:' ? fileURLToPath(url) : modulePath;
+};
+const resolveFilesystemModulePath = (modulePath, cwd) => {
     const absolutePath = isAbsolute(modulePath)
         ? modulePath
         : resolve(cwd, modulePath);
-    return pathToFileURL(absolutePath).href;
+    if (!absolutePath.endsWith('.js') || existsSync(absolutePath)) {
+        return absolutePath;
+    }
+    const tsPath = absolutePath.replace(/\.js$/, '.ts');
+    return existsSync(tsPath) ? tsPath : absolutePath;
+};
+/** Resolve a module path from cwd so CLI defaults behave like shell paths. */
+const resolveAbsoluteModulePath = (modulePath, cwd) => URL_SCHEME.test(modulePath)
+    ? resolveUrlModulePath(modulePath)
+    : resolveFilesystemModulePath(modulePath, cwd);
+const freshModuleCopyPath = (absolutePath) => join(dirname(absolutePath), `.__fresh-${Date.now()}-${Math.random().toString(36).slice(2)}-${basename(absolutePath)}`);
+/**
+ * Import a module bypassing the ESM cache for the entry file.
+ *
+ * @remarks
+ * Cache-busting applies to the entry module only. Transitive imports resolved
+ * by the entry file are still served from Bun's module cache. This is
+ * acceptable for the draft promotion workflow (the only caller) because
+ * promotion changes which modules the entry file imports, not the modules
+ * themselves. If a deeper cache-bust is needed in the future, consider
+ * Bun's `Loader.registry` or a full process restart.
+ */
+const importFreshModule = async (modulePath, cwd) => {
+    const absolutePath = resolveAbsoluteModulePath(modulePath, cwd);
+    if (URL_SCHEME.test(absolutePath) && !absolutePath.startsWith('/')) {
+        const url = new URL(absolutePath);
+        url.searchParams.set('t', Date.now().toString());
+        return (await import(url.href));
+    }
+    const freshPath = freshModuleCopyPath(absolutePath);
+    await Bun.write(freshPath, await Bun.file(absolutePath).text());
+    try {
+        return (await import(pathToFileURL(freshPath).href));
+    }
+    finally {
+        rmSync(freshPath, { force: true });
+    }
 };
 /** Load a Topo export from a module path relative to cwd. */
-export const loadApp = async (modulePath, cwd) => {
-    const mod = (await import(resolveModuleSpecifier(modulePath, cwd)));
+export const loadApp = async (modulePath, cwd, options = {}) => {
+    const resolvedModulePath = resolveAbsoluteModulePath(modulePath, cwd);
+    const mod = options.fresh === true
+        ? await importFreshModule(modulePath, cwd)
+        : (await import(URL_SCHEME.test(resolvedModulePath) &&
+            !resolvedModulePath.startsWith('/')
+            ? new URL(resolvedModulePath).href
+            : pathToFileURL(resolvedModulePath).href));
     const app = (mod['default'] ?? mod['app']);
     if (!app?.trails) {
         throw new Error(`Could not find a Topo export in "${modulePath}". ` +