@ontrails/trails 1.0.0-beta.17 → 1.0.0-beta.19

package/CHANGELOG.md

@@ -1,5 +1,144 @@
 # trails
 
+## 1.0.0-beta.19
+
+### Major Changes
+
+- 1eb5bdc: Rename first-class trail composition from the `cross` API family to the `compose` family across core contracts, testing helpers, topo projections, Warden rules, CLI scaffolds, and docs. `composes`, `ctx.compose`, `composeInput`, and `Compose*` type names are now the public authoring vocabulary; topo persistence migrates legacy composition rows and graph keys forward.
+- 120caf5: Promote topo artifact commands to `trails compile` and `trails validate`.
+
+### Patch Changes
+
+- e41c382: Document beta-channel install guidance in package and adapter README install snippets so consumers use explicit `@beta` (or pinned `1.0.0-beta.N`) tags instead of accidental `latest` resolution during the prerelease line. Adds the policy doc at `docs/releases/beta-channel-policy.md`, prints both `latest` and `beta` dist-tags in `bun run publish:registry-check`, and aligns plugin/skill install snippets.
+- 14714b8: Add a beta.15 to beta.19 downstream migration guide (`docs/releases/beta15-to-beta19.md`) that ties together package install, CLI/MCP/HTTP surface decisions, public output schemas, contract testing, resource mocks / `unmockable`, error taxonomy, observability, Topographer artifact workflow, layer evolution, the `cross`→`compose` composition rename, trail-versioning runtime adoption, and adapter authoring. Linked from `docs/index.md` Release Notes and cross-references the focused migration guides under `docs/migration/`.
+- 91328d3: Make `trails create` reruns reconcile existing scaffold files instead of overwriting present files and then failing on existing surfaces.
+- 6471b73: Preserve the original `create.scaffold` Result boundary when `trails create` cannot scaffold a project.
+- 51aac45: Add `entity.list` and `entity.delete` trails to the generated entity starter so fresh scaffolds model complete CRUD coverage.
+- 5efa32c: Generate project-level `AGENTS.md` and `CLAUDE.md` guidance so new Trails apps
+  start with canonical agent instructions.
+- 88c0316: Generate a contextual `README.md` for new Trails projects with first-run
+  commands, selected surfaces, starter notes, and agent guidance pointers.
+- 99154d4: Generate `tsconfig.tests.json` in new Trails projects so root test files are
+  covered by editor TypeScript tooling without changing build output.
+- 492f71c: Move CLI, MCP, HTTP, established-surface, and surface-parity helpers behind explicit subpaths so root contract testing imports no longer require optional surface peers. The Trails CLI scaffolder now emits `import { testAllEstablished } from '@ontrails/testing/established'` for generated verification.
+- 4bc8a99: Clarify the Topographer artifact workflow around top-level `trails compile`, `trails validate`, and `trails diff` commands, including explicit diagnostics for retired `trails topo compile`, `trails topo verify`, and `trails topo check` attempts.
+- 16cb740: Run examples and contract checks across live trail version entries, and project version-entry example coverage into topo and survey reports.
+- 92e709b: Declare explicit permit scopes on mutating built-in CLI trails and scaffolded entity starter trails.
+
+  Preserve the resolved CLI permit on result callbacks so run-collision recovery can re-execute protected trails without losing authorization context.
+
+- 1f48342: Preserve original Result error boundaries in CLI trails by returning existing Result failures directly instead of re-wrapping their errors.
+- c14aa3a: Report structured entry and graph force audit details from `trails doctor`.
+- 2df73cc: Configure scaffolded Trails projects to allow `TODO :::` fieldwork markers while keeping standard `TODO:` warning comments blocked.
+- 7f50fe2: Add version lifecycle CLI trails for revising, deprecating, archiving, and diagnosing trail version entries.
+- 653d1fc: Add a top-level `trails diff` command and extend TopoGraph diffs with version, marker, lifecycle status, support set, and force-event audit details.
+- 2e76288: Add graph-only force event projection for forced compile break acceptance and block unforced breaking topo changes.
+- 52e4e8f: Add the `@ontrails/trails` CLI package and core framework command scripts to newly scaffolded projects.
+- 58be821: Generated projects now pin `@ontrails/*` packages to the exact scaffolded
+  package version instead of emitting caret prerelease ranges.
+- da7cbcb: Generated projects now include a minimal `.trails/scaffold.json` provenance
+  breadcrumb recording the scaffold schema version, package version, starter
+  template, and generation timestamp.
+- fc00aeb: Add adapter target conformance metadata and scaffold extracted HTTP adapters through `trails create adapter`.
+- 1c975c3: Define the Warden fix-metadata contract (`WardenFix`, `WardenFixCapability`, `WardenFixClass`, `WardenFixSafety`, `WardenFixEdit`) with optional `fix` metadata on diagnostics and rule metadata, projected through the guide, manifest, markdown, and agent guidance. Export `wardenFixClasses`/`wardenFixSafeties` value arrays and surface the rule `fix` capability in the `warden.guide` trail output schema. Dormant until a rule declares it.
+- d5d518e: Add `warden --fix` to apply safe source fixes. The executor applies only `safety: 'safe'` edits last-to-first, re-reading and rewriting affected files, while review-required, edit-less, and topo diagnostics stay reported but unapplied. The report surfaces applied, changed-file, and skipped counts.
+
+  Expose `fix` through the Trails app wrapper and mark the `warden` trail as write intent with explicit public access because `fix: true` mutates source files while the local governance command remains directly runnable.
+
+- 678cb1c: Expose the shared adapter readiness engine through Warden's opt-in
+  `--adapter-check` diagnostics and the local `trails adapter check` authoring
+  workflow.
+- 619cb15: Add a Warden rule (`no-destructured-compose`) that coaches trail blazes to call `ctx.compose(...)` directly instead of destructuring `compose` from the context.
+
+  Keep the generated `create` trail on the direct `ctx.compose(...)` shape so framework-authored trails follow the same composition guidance.
+
+- Updated dependencies [bb81ffe]
+- Updated dependencies [e41c382]
+- Updated dependencies [ed5926b]
+- Updated dependencies [a2f1825]
+- Updated dependencies [a2f1825]
+- Updated dependencies [1eb5bdc]
+- Updated dependencies [f8d80b9]
+- Updated dependencies [94a8380]
+- Updated dependencies [94a8380]
+- Updated dependencies [846a597]
+- Updated dependencies [8638dae]
+- Updated dependencies [8638dae]
+- Updated dependencies [8638dae]
+- Updated dependencies [f0f7e2f]
+- Updated dependencies [223aaad]
+- Updated dependencies [3125f4d]
+- Updated dependencies [2494dc6]
+- Updated dependencies [4bc8a99]
+- Updated dependencies [120caf5]
+- Updated dependencies [2d53717]
+- Updated dependencies [16cb740]
+- Updated dependencies [8894ecb]
+- Updated dependencies [fdf7ec9]
+- Updated dependencies [92e709b]
+- Updated dependencies [d76be13]
+- Updated dependencies [84f56a5]
+- Updated dependencies [64fb15a]
+- Updated dependencies [653d1fc]
+- Updated dependencies [431b04c]
+- Updated dependencies [2e76288]
+- Updated dependencies [5d88104]
+- Updated dependencies [f04a9ef]
+- Updated dependencies [fc00aeb]
+- Updated dependencies [1c975c3]
+- Updated dependencies [48d5ff4]
+- Updated dependencies [d5d518e]
+- Updated dependencies [216bf10]
+- Updated dependencies [ab1c77c]
+- Updated dependencies [8ca5b85]
+- Updated dependencies [4f43874]
+- Updated dependencies [678cb1c]
+- Updated dependencies [5874fd6]
+- Updated dependencies [619cb15]
+- Updated dependencies [4642268]
+- Updated dependencies [9bab0cf]
+- Updated dependencies [3ceeba8]
+- Updated dependencies [beafd03]
+- Updated dependencies [7b173e0]
+- Updated dependencies [6e50e7b]
+- Updated dependencies [48edf8d]
+- Updated dependencies [12ffa3b]
+- Updated dependencies [2f262f7]
+- Updated dependencies [58b01f2]
+  - @ontrails/adapter-kit@1.0.0-beta.19
+  - @ontrails/core@1.0.0-beta.19
+  - @ontrails/cli@1.0.0-beta.19
+  - @ontrails/commander@1.0.0-beta.19
+  - @ontrails/http@1.0.0-beta.19
+  - @ontrails/mcp@1.0.0-beta.19
+  - @ontrails/topographer@1.0.0-beta.19
+  - @ontrails/warden@1.0.0-beta.19
+  - @ontrails/observe@1.0.0-beta.19
+  - @ontrails/tracing@1.0.0-beta.19
+  - @ontrails/permits@1.0.0-beta.19
+
+## 1.0.0-beta.18
+
+### Patch Changes
+
+- Updated dependencies [c0b2948]
+- Updated dependencies [fc3219c]
+- Updated dependencies [bc2d327]
+- Updated dependencies [bf44972]
+- Updated dependencies [57c8672]
+- Updated dependencies [510ea50]
+- Updated dependencies [e0ae995]
+  - @ontrails/http@1.0.0-beta.18
+  - @ontrails/observe@1.0.0-beta.18
+  - @ontrails/tracing@1.0.0-beta.18
+  - @ontrails/commander@1.0.0-beta.18
+  - @ontrails/cli@1.0.0-beta.18
+  - @ontrails/core@1.0.0-beta.18
+  - @ontrails/mcp@1.0.0-beta.18
+  - @ontrails/permits@1.0.0-beta.18
+  - @ontrails/topographer@1.0.0-beta.18
+  - @ontrails/warden@1.0.0-beta.18
+
 ## 1.0.0-beta.17
 
 ### Patch Changes

package/README.md

@@ -2,8 +2,7 @@
 
 Command-line tools for working with Trails projects.
 
-Use the CLI to scaffold a Trails app, add surfaces, inspect the current topo, run
-warden checks, manage draft state, and keep local Trails project state tidy.
+Use the CLI to scaffold a Trails app, add surfaces, inspect the current topo, run warden checks, manage draft state, and keep local Trails project state tidy.
 
 ```bash
 bunx @ontrails/trails create
@@ -11,17 +10,15 @@ bunx @ontrails/trails create
 
 Common workflows:
 
-- `trails create` starts a new Trails project with generated trail, topo, surface,
-  and verification files.
+- `trails create` starts a new Trails project with generated trail, topo, surface, and verification files.
 - `trails add surface` adds another surface entrypoint to an existing project.
-- `trails topo` inspects, exports, verifies, pins, and unpins topo state.
-- `trails warden` runs Trails governance checks for contract and architecture
-  drift.
+- `trails topo` inspects topo state and manages pins/history.
+- `trails compile` writes committed topo artifacts.
+- `trails validate` checks committed topo artifacts for drift.
+- `trails warden` runs Trails governance checks for contract and architecture drift.
 - `trails guide` shows available trails and examples from a project.
 
-Trails is contract-first: define trails once with typed input, Result output,
-examples, and meta; the framework derives CLI, MCP, HTTP, and future surfaces from
-the same contracts.
+Trails is contract-first: define trails once with typed input, Result output, examples, and meta; the framework derives CLI, MCP, HTTP, and future surfaces from the same contracts.
 
 See the main Trails documentation for the full framework guide:
 <https://github.com/outfitter-dev/trails>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ontrails/trails",
-  "version": "1.0.0-beta.17",
+  "version": "1.0.0-beta.19",
   "bin": {
     "trails": "./bin/trails.ts"
   },
@@ -23,20 +23,21 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.1.0",
-    "@ontrails/cli": "^1.0.0-beta.16",
-    "@ontrails/commander": "^1.0.0-beta.16",
-    "@ontrails/core": "^1.0.0-beta.16",
-    "@ontrails/http": "^1.0.0-beta.16",
-    "@ontrails/mcp": "^1.0.0-beta.16",
-    "@ontrails/observe": "^1.0.0-beta.16",
-    "@ontrails/permits": "^1.0.0-beta.16",
-    "@ontrails/topographer": "^1.0.0-beta.16",
-    "@ontrails/tracing": "^1.0.0-beta.16",
-    "@ontrails/warden": "^1.0.0-beta.16",
+    "@ontrails/adapter-kit": "^1.0.0-beta.19",
+    "@ontrails/cli": "^1.0.0-beta.19",
+    "@ontrails/commander": "^1.0.0-beta.19",
+    "@ontrails/core": "^1.0.0-beta.19",
+    "@ontrails/http": "^1.0.0-beta.19",
+    "@ontrails/mcp": "^1.0.0-beta.19",
+    "@ontrails/observe": "^1.0.0-beta.19",
+    "@ontrails/permits": "^1.0.0-beta.19",
+    "@ontrails/topographer": "^1.0.0-beta.19",
+    "@ontrails/tracing": "^1.0.0-beta.19",
+    "@ontrails/warden": "^1.0.0-beta.19",
     "commander": "^14.0.3",
     "zod": "^4.3.5"
   },
   "devDependencies": {
-    "@ontrails/testing": "^1.0.0-beta.16"
+    "@ontrails/testing": "^1.0.0-beta.19"
   }
 }

package/src/app.ts

@@ -3,25 +3,30 @@ import { topo } from '@ontrails/core';
 import * as addSurface from './trails/add-surface.js';
 import * as addTrail from './trails/add-trail.js';
 import * as addVerify from './trails/add-verify.js';
+import * as adapterCheck from './trails/adapter-check.js';
+import * as compile from './trails/compile.js';
 import * as completions from './trails/completions.js';
 import * as completionsComplete from './trails/completions-complete.js';
 import * as create from './trails/create.js';
+import * as createAdapter from './trails/create-adapter.js';
 import * as createScaffold from './trails/create-scaffold.js';
+import * as deprecate from './trails/deprecate.js';
 import * as devClean from './trails/dev-clean.js';
 import * as devReset from './trails/dev-reset.js';
 import * as devStats from './trails/dev-stats.js';
+import * as doctor from './trails/doctor.js';
 import * as draftPromote from './trails/draft-promote.js';
 import * as guide from './trails/guide.js';
+import * as revise from './trails/revise.js';
 import * as run from './trails/run.js';
 import * as runExample from './trails/run-example.js';
 import * as runExamples from './trails/run-examples.js';
 import * as survey from './trails/survey.js';
-import * as topoCompile from './trails/topo-compile.js';
 import * as topoHistory from './trails/topo-history.js';
 import * as topoPin from './trails/topo-pin.js';
 import * as topoCommand from './trails/topo.js';
 import * as topoUnpin from './trails/topo-unpin.js';
-import * as topoVerify from './trails/topo-verify.js';
+import * as validate from './trails/validate.js';
 import * as warden from './trails/warden.js';
 import * as wardenGuide from './trails/warden-guide.js';
 
@@ -32,19 +37,24 @@ export const app = topo(
   runExample,
   survey,
   topoCommand,
-  topoCompile,
+  compile,
   topoHistory,
   topoPin,
   topoUnpin,
-  topoVerify,
+  validate,
+  revise,
+  deprecate,
+  doctor,
   devStats,
   devClean,
   devReset,
   guide,
   draftPromote,
+  adapterCheck,
   warden,
   wardenGuide,
   create,
+  createAdapter,
   createScaffold,
   addSurface,
   addVerify,

package/src/cli.ts

@@ -21,7 +21,12 @@ import { deriveTopoGraph } from '@ontrails/topographer';
 
 import { app } from './app.js';
 import { resolveInputWithClack } from './clack.js';
+import { getRetiredTopoCommandDiagnostic } from './retired-topo-command.js';
 import { attachCompletionsInstallCommand } from './run-completions-install.js';
+import {
+  applyAdapterCheckExitCode,
+  tryAdapterCheckOutput,
+} from './run-adapter-check.js';
 import { tryRecoverFromRunCollision } from './run-collision.js';
 import { tryExampleRunOutput } from './run-example.js';
 import { tryExamplesRunOutput } from './run-examples.js';
@@ -64,6 +69,7 @@ const buildOnResult =
     // envelope on stdout that includes the captured records under
     // `tracing`. Hand that case off before the regular chain so the
     // existing handlers do not also write to stdout.
+    applyAdapterCheckExitCode(resolvedCtx);
     if (session !== undefined && tryTraceJsonOutput(resolvedCtx, session)) {
       return;
     }
@@ -80,6 +86,9 @@ const buildOnResult =
     if (tryWardenOutput(resolvedCtx)) {
       return;
     }
+    if (tryAdapterCheckOutput(resolvedCtx)) {
+      return;
+    }
     await defaultOnResult(resolvedCtx);
   };
 
@@ -267,6 +276,13 @@ const normalizeWardenArgv = (argv: readonly string[]): string[] => {
  * process-lifetime sink.
  */
 const runSurfaceOnce = async (): Promise<void> => {
+  const retiredTopoCommand = getRetiredTopoCommandDiagnostic(process.argv);
+  if (retiredTopoCommand !== null) {
+    process.stderr.write(`${retiredTopoCommand.message}\n`);
+    process.exitCode = 1;
+    return;
+  }
+
   const session = maybeInstallTraceSession();
   try {
     const program = createProgram(app, {

package/src/lifecycle-source-io.ts

@@ -0,0 +1,33 @@
+import { readFileSync, writeFileSync } from 'node:fs';
+
+import { InternalError, Result } from '@ontrails/core';
+
+export const readLifecycleSourceFile = (
+  filePath: string
+): Result<string, Error> => {
+  try {
+    return Result.ok(readFileSync(filePath, 'utf8'));
+  } catch (error: unknown) {
+    return Result.err(
+      error instanceof Error
+        ? error
+        : new InternalError(`Unable to read lifecycle source file ${filePath}`)
+    );
+  }
+};
+
+export const writeLifecycleSourceFile = (
+  filePath: string,
+  source: string
+): Result<void, Error> => {
+  try {
+    writeFileSync(filePath, source);
+    return Result.ok();
+  } catch (error: unknown) {
+    return Result.err(
+      error instanceof Error
+        ? error
+        : new InternalError(`Unable to write lifecycle source file ${filePath}`)
+    );
+  }
+};

package/src/project-writes.ts

@@ -36,6 +36,10 @@ export type ProjectWriteOperation =
       readonly path: string;
     };
 
+interface ProjectOperationOptions {
+  readonly existing?: 'overwrite' | 'preserve';
+}
+
 export const validateProjectName = (
   name: string
 ): TrailsResult<string, ValidationError> =>
@@ -222,12 +226,59 @@ export const planProjectOperation = (
   }
 };
 
+const shouldApplyProjectOperation = (
+  projectDir: string,
+  operation: ProjectWriteOperation,
+  options: ProjectOperationOptions
+): TrailsResult<boolean, Error> => {
+  if (options.existing !== 'preserve' || operation.kind === 'rename') {
+    return Result.ok(true);
+  }
+
+  const { path } = operation;
+  const target = resolveProjectPath(projectDir, path);
+  if (target.isErr()) {
+    return Result.err(target.error);
+  }
+
+  return Result.ok(!existsSync(target.value));
+};
+
+const selectProjectOperations = (
+  projectDir: string,
+  operations: readonly ProjectWriteOperation[],
+  options: ProjectOperationOptions
+): TrailsResult<ProjectWriteOperation[], Error> => {
+  const selected: ProjectWriteOperation[] = [];
+  for (const operation of operations) {
+    const shouldApply = shouldApplyProjectOperation(
+      projectDir,
+      operation,
+      options
+    );
+    if (shouldApply.isErr()) {
+      return Result.err(shouldApply.error);
+    }
+    if (shouldApply.value) {
+      selected.push(operation);
+    }
+  }
+
+  return Result.ok(selected);
+};
+
 export const planProjectOperations = (
   projectDir: string,
-  operations: readonly ProjectWriteOperation[]
+  operations: readonly ProjectWriteOperation[],
+  options: ProjectOperationOptions = {}
 ): TrailsResult<PlannedProjectOperation[], Error> => {
+  const selected = selectProjectOperations(projectDir, operations, options);
+  if (selected.isErr()) {
+    return Result.err(selected.error);
+  }
+
   const planned: PlannedProjectOperation[] = [];
-  for (const operation of operations) {
+  for (const operation of selected.value) {
     const result = planProjectOperation(projectDir, operation);
     if (result.isErr()) {
       return Result.err(result.error);
@@ -302,14 +353,20 @@ const applyProjectOperation = async (
 
 export const applyProjectOperations = async (
   projectDir: string,
-  operations: readonly ProjectWriteOperation[]
+  operations: readonly ProjectWriteOperation[],
+  options: ProjectOperationOptions = {}
 ): Promise<TrailsResult<PlannedProjectOperation[], Error>> => {
-  const planned = planProjectOperations(projectDir, operations);
+  const selected = selectProjectOperations(projectDir, operations, options);
+  if (selected.isErr()) {
+    return Result.err(selected.error);
+  }
+
+  const planned = planProjectOperations(projectDir, selected.value);
   if (planned.isErr()) {
     return Result.err(planned.error);
   }
 
-  for (const operation of operations) {
+  for (const operation of selected.value) {
     const applied = await applyProjectOperation(projectDir, operation);
     if (applied.isErr()) {
       return Result.err(applied.error);

package/src/retired-topo-command.ts

@@ -0,0 +1,36 @@
+const retiredTopoCommandReplacements = {
+  check: 'trails validate',
+  compile: 'trails compile',
+  verify: 'trails validate',
+} as const;
+
+export type RetiredTopoCommand = keyof typeof retiredTopoCommandReplacements;
+
+export interface RetiredTopoCommandDiagnostic {
+  readonly attempted: `trails topo ${RetiredTopoCommand}`;
+  readonly message: string;
+  readonly replacement: (typeof retiredTopoCommandReplacements)[RetiredTopoCommand];
+}
+
+const isRetiredTopoCommand = (
+  command: string | undefined
+): command is RetiredTopoCommand =>
+  command !== undefined && command in retiredTopoCommandReplacements;
+
+export const getRetiredTopoCommandDiagnostic = (
+  argv: readonly string[]
+): RetiredTopoCommandDiagnostic | null => {
+  const [command, subcommand] = argv.slice(2);
+  if (command !== 'topo' || !isRetiredTopoCommand(subcommand)) {
+    return null;
+  }
+
+  const replacement = retiredTopoCommandReplacements[subcommand];
+  const attempted = `trails topo ${subcommand}` as const;
+
+  return {
+    attempted,
+    message: `"${attempted}" was retired. Use "${replacement}" instead.\nTopographer artifact commands now live at the top level: "trails compile", "trails validate", and "trails diff". "trails topo" is for topo-store history, pin, and unpin.`,
+    replacement,
+  };
+};

package/src/run-adapter-check.ts

@@ -0,0 +1,76 @@
+import type { ActionResultContext } from '@ontrails/cli';
+import { deriveOutputMode } from '@ontrails/cli';
+
+interface AdapterCheckResultValue {
+  readonly formatted: string;
+  readonly passed: boolean;
+}
+
+const isAdapterCheckResultValue = (
+  value: unknown
+): value is AdapterCheckResultValue => {
+  if (typeof value !== 'object' || value === null) {
+    return false;
+  }
+  const candidate = value as Record<string, unknown>;
+  return (
+    typeof candidate['formatted'] === 'string' &&
+    typeof candidate['passed'] === 'boolean'
+  );
+};
+
+const wantsStructuredOutput = (ctx: ActionResultContext): boolean =>
+  deriveOutputMode(ctx.flags, ctx.topoName).mode !== 'text';
+
+const isAdapterCheckTrail = (ctx: ActionResultContext): boolean =>
+  ctx.trail.id === 'adapter.check';
+
+const readAdapterCheckResultValue = (
+  ctx: ActionResultContext
+): AdapterCheckResultValue | undefined => {
+  if (!isAdapterCheckTrail(ctx) || ctx.result.isErr()) {
+    return undefined;
+  }
+
+  return isAdapterCheckResultValue(ctx.result.value)
+    ? ctx.result.value
+    : undefined;
+};
+
+export const applyAdapterCheckExitCode = (
+  ctx: ActionResultContext
+): boolean => {
+  if (!isAdapterCheckTrail(ctx)) {
+    return false;
+  }
+
+  if (ctx.result.isErr()) {
+    process.exitCode = 1;
+    return true;
+  }
+
+  const value = readAdapterCheckResultValue(ctx);
+  if (!value) {
+    return false;
+  }
+
+  process.exitCode = value.passed ? 0 : 1;
+  return true;
+};
+
+export const tryAdapterCheckOutput = (ctx: ActionResultContext): boolean => {
+  const value = readAdapterCheckResultValue(ctx);
+  if (!value) {
+    return false;
+  }
+
+  applyAdapterCheckExitCode(ctx);
+  if (wantsStructuredOutput(ctx)) {
+    return false;
+  }
+
+  if (value.formatted.length > 0) {
+    process.stdout.write(`${value.formatted}\n`);
+  }
+  return true;
+};

package/src/run-collision.ts

@@ -120,6 +120,7 @@ export const tryRecoverFromRunCollision = async (
   }
 
   return await executeTrail(ctx.trail, mergeAppOverride(ctx.input, chosen), {
+    ctx: ctx.permit === undefined ? {} : { permit: ctx.permit },
     topo: deps.graph,
   });
 };