@ontrails/trails 1.0.0-beta.39 → 1.0.0-beta.41

package/src/trails/adapter-check.ts

@@ -208,7 +208,14 @@ export const formatAdapterCheckReport = (
 };
 
 export const adapterCheckTrail = trail('adapter.check', {
-  blaze: (input, ctx) => {
+  description: 'Check adapter authoring readiness',
+  examples: [
+    {
+      input: {},
+      name: 'Check adapters in the current workspace',
+    },
+  ],
+  implementation: (input, ctx) => {
     const rootDirResult = resolveTrailRootDir(input.rootDir, ctx.cwd);
     if (rootDirResult.isErr()) {
       return rootDirResult;
@@ -230,13 +237,6 @@ export const adapterCheckTrail = trail('adapter.check', {
       targets: [...report.targets],
     });
   },
-  description: 'Check adapter authoring readiness',
-  examples: [
-    {
-      input: {},
-      name: 'Check adapters in the current workspace',
-    },
-  ],
   input: adapterCheckInputSchema,
   intent: 'read',
   output: adapterCheckOutputSchema,

package/src/trails/add-surface.ts

@@ -132,7 +132,8 @@ const writeSurfaceEntry = async (
 };
 
 export const addSurface = trail('add.surface', {
-  blaze: async (input) => {
+  description: 'Add a surface to an existing project',
+  implementation: async (input) => {
     const cwd = resolve(input.dir ?? '.');
     const { surface } = input;
     const entryFile = getEntryFile(surface);
@@ -160,7 +161,6 @@ export const addSurface = trail('add.surface', {
       dependency: dependency.value,
     });
   },
-  description: 'Add a surface to an existing project',
   input: z.object({
     dir: z.string().optional().describe('Project directory'),
     surface: z.enum(['cli', 'http', 'mcp']).describe('Surface to add'),

package/src/trails/add-trail.ts

@@ -39,7 +39,7 @@ const generateTrailFile = (
 import { z } from 'zod';
 
 export const ${trailName} = trail(${literal(id)}, {
-  blaze: async () => {
+  implementation: async () => {
     return Result.ok({ message: ${literal(exampleMessage)} });
   },
   description: ${literal(description)},
@@ -79,7 +79,8 @@ testTrail(${trailName}, [
 
 export const addTrail = trail('add.trail', {
   args: ['id'],
-  blaze: async (input, ctx) => {
+  description: 'Scaffold a new trail with tests and examples',
+  implementation: async (input, ctx) => {
     const { id } = input;
     const validated = validateTrailId(id);
     if (validated.isErr()) {
@@ -114,7 +115,6 @@ export const addTrail = trail('add.trail', {
 
     return Result.ok({ created: [...files.keys()] });
   },
-  description: 'Scaffold a new trail with tests and examples',
   input: z.object({
     description: z
       .string()

package/src/trails/add-verify.ts

@@ -92,7 +92,8 @@ const updatePackageJsonForVerify = async (
 // ---------------------------------------------------------------------------
 
 export const addVerify = trail('add.verify', {
-  blaze: async (input) => {
+  description: 'Add testing and warden verification',
+  implementation: async (input) => {
     const projectDirResult = resolveProjectDir(input.dir ?? '.', input.name);
     if (projectDirResult.isErr()) {
       return projectDirResult;
@@ -141,7 +142,6 @@ export const addVerify = trail('add.verify', {
 
     return Result.ok({ created: files });
   },
-  description: 'Add testing and warden verification',
   input: z.object({
     dir: z.string().optional().describe('Parent directory'),
     name: z

package/src/trails/compile.ts

@@ -1,6 +1,6 @@
 import { trail } from '@ontrails/core';
 import type { Result, Topo } from '@ontrails/core';
-import type { TopoGraphOverlayRegistration } from '@ontrails/topographer';
+import type { TopoGraphOverlayRegistration } from '@ontrails/topography';
 import { z } from 'zod';
 
 import { withFreshOperatorApp } from './operator-context.js';
@@ -32,14 +32,6 @@ const compileTrailInputSchema = z.object({
 type CompileTrailInput = z.output<typeof compileTrailInputSchema>;
 
 export const compileTrail = trail('compile', {
-  blaze: async (input: CompileTrailInput, ctx) =>
-    withFreshOperatorApp(input, ctx, ({ lease, rootDir }) =>
-      compileCurrentTopo(lease.app, {
-        force: input.force,
-        overlays: lease.overlays,
-        rootDir,
-      })
-    ),
   description: 'Compile the current topo to trails.lock',
   examples: [
     {
@@ -47,6 +39,14 @@ export const compileTrail = trail('compile', {
       name: 'Compile the current topo to trails.lock',
     },
   ],
+  implementation: async (input: CompileTrailInput, ctx) =>
+    withFreshOperatorApp(input, ctx, ({ lease, rootDir }) =>
+      compileCurrentTopo(lease.app, {
+        force: input.force,
+        overlays: lease.overlays,
+        rootDir,
+      })
+    ),
   input: compileTrailInputSchema,
   intent: 'write',
   output: z.object({

package/src/trails/completions-complete.ts

@@ -118,7 +118,16 @@ const SUBCOMMAND_HANDLERS: Readonly<Record<string, CompletionHandler>> = {
 };
 
 export const completionsCompleteTrail = trail('completions.__complete', {
-  blaze: async (input, ctx) => {
+  description:
+    'Internal: emit dynamic completion suggestions for the current partial argv. Invoked by the static shell completion script at tab-press time.',
+  examples: [
+    {
+      description: 'Empty argv yields no suggestions',
+      input: { args: [] },
+      name: 'Empty args',
+    },
+  ],
+  implementation: async (input, ctx) => {
     const rootDirResult = resolveTrailRootDir(input.rootDir, ctx.cwd);
     if (rootDirResult.isErr()) {
       return rootDirResult;
@@ -138,15 +147,6 @@ export const completionsCompleteTrail = trail('completions.__complete', {
     const suggestions = await handler({ args: input.args, rootDir });
     return Result.ok(renderSuggestions(suggestions));
   },
-  description:
-    'Internal: emit dynamic completion suggestions for the current partial argv. Invoked by the static shell completion script at tab-press time.',
-  examples: [
-    {
-      description: 'Empty argv yields no suggestions',
-      input: { args: [] },
-      name: 'Empty args',
-    },
-  ],
   input: z.object({
     args: z
       .array(z.string())

package/src/trails/completions.ts

@@ -16,8 +16,6 @@ const COMPLETIONS_BIN_NAME = 'trails';
 
 export const completionsTrail = trail('completions', {
   args: ['shell'],
-  blaze: async (input) =>
-    renderCompletionScript(input.shell, COMPLETIONS_BIN_NAME),
   description:
     'Print a shell completion script for the trails CLI; pipe into your shell rc to register tab-completion',
   examples: [
@@ -37,6 +35,8 @@ export const completionsTrail = trail('completions', {
       name: 'Render fish completion',
     },
   ],
+  implementation: async (input) =>
+    renderCompletionScript(input.shell, COMPLETIONS_BIN_NAME),
   input: z.object({
     shell: z
       .enum(['bash', 'zsh', 'fish'])