@ontrails/cli 1.0.0-beta.3 → 1.0.0-beta.4

package/.turbo/turbo-lint.log

@@ -1,3 +1,3 @@
 $ oxlint ./src
 Found 0 warnings and 0 errors.
-Finished in 24ms on 18 files with 93 rules using 24 threads.
+Finished in 18ms on 18 files with 93 rules using 24 threads.

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # @ontrails/cli
 
+## 1.0.0-beta.4
+
+### Major Changes
+
+- API simplification: unified trail model, intent enum, run, metadata.
+
+  **BREAKING CHANGES:**
+
+  - `hike()` removed — use `trail()` with optional `follow: [...]` field
+  - `follows` renamed to `follow` (singular, matching `ctx.follow()`)
+  - `topo.hikes` removed — single `topo.trails` map
+  - `kind: 'hike'` removed — everything is `kind: 'trail'`
+  - `readOnly`/`destructive` booleans replaced by `intent: 'read' | 'write' | 'destroy'`
+  - `implementation` field renamed to `run`
+  - `markers` field renamed to `metadata`
+  - `testHike` renamed to `testFollows`, `HikeScenario` to `FollowScenario`
+  - `blaze()` now returns the surface handle (`Command` for CLI, `Server` for MCP)
+
+### Patch Changes
+
+- Updated dependencies
+  - @ontrails/core@1.0.0-beta.4
+
 ## 1.0.0-beta.3
 
 ### Minor Changes

package/README.md

@@ -11,7 +11,7 @@ import { z } from 'zod';
 
 const greet = trail('greet', {
   input: z.object({ name: z.string().describe('Who to greet') }),
-  implementation: (input) => Result.ok(`Hello, ${input.name}!`),
+  run: (input) => Result.ok(`Hello, ${input.name}!`),
 });
 
 const app = topo('myapp', { greet });

package/dist/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAS,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EACL,MAAM,EAKP,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAElE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMjD,+CAA+C;AAC/C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;CAC1B;AAED,oCAAoC;AACpC,MAAM,WAAW,uBAAuB;IACtC,aAAa,CAAC,EAAE,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,GAAG,SAAS,CAAC;IACzE,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC;IAC7B,QAAQ,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;IACrE,OAAO,CAAC,EAAE,OAAO,EAAE,EAAE,GAAG,SAAS,CAAC;IAClC,YAAY,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;CAC1C;AAiND,eAAO,MAAM,gBAAgB,GAC3B,KAAK,IAAI,EACT,UAAU,uBAAuB,KAChC,UAAU,EAiBZ,CAAC"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAS,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EACL,MAAM,EAKP,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAElE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMjD,+CAA+C;AAC/C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;CAC1B;AAED,oCAAoC;AACpC,MAAM,WAAW,uBAAuB;IACtC,aAAa,CAAC,EAAE,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,GAAG,SAAS,CAAC;IACzE,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC;IAC7B,QAAQ,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;IACrE,OAAO,CAAC,EAAE,OAAO,EAAE,EAAE,GAAG,SAAS,CAAC;IAClC,YAAY,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;CAC1C;AAgND,eAAO,MAAM,gBAAgB,GAC3B,KAAK,IAAI,EACT,UAAU,uBAAuB,KAChC,UAAU,EAiBZ,CAAC"}

package/dist/build.js

@@ -90,7 +90,7 @@ const reportResult = async (options, ctx) => {
 const executeTrail = async (t, validatedInput, ctxOverrides, options) => {
     const ctx = await resolveContext(ctxOverrides, options);
     const layers = options?.layers ?? [];
-    const impl = composeLayers(layers, t, t.implementation);
+    const impl = composeLayers(layers, t, t.run);
     return impl(validatedInput, ctx);
 };
 /** Create the execute function for a CLI command. */
@@ -120,12 +120,12 @@ const createExecute = (t, fields, _flags, options) => async (parsedArgs, parsedF
     return result;
 };
 /** Derive and merge flags for a trail. */
-const buildFlags = (fields, destructive, options) => {
+const buildFlags = (fields, intent, options) => {
     let flags = toFlags(fields);
     if (options?.presets) {
         flags = mergeFlags(options.presets.flat(), flags);
     }
-    if (destructive) {
+    if (intent === 'destroy') {
         flags = mergeFlags(dryRunPreset(), flags);
     }
     return flags;
@@ -134,30 +134,29 @@ const buildFlags = (fields, destructive, options) => {
 const toCliCommand = (t, options) => {
     const { group, name } = parseTrailId(t.id);
     const fields = deriveFields(t.input, t.fields);
-    const flags = buildFlags(fields, t.destructive, options);
+    const flags = buildFlags(fields, t.intent, options);
     return {
         args: [],
         description: t.description,
-        destructive: t.destructive,
         execute: createExecute(t, fields, flags, options),
         flags,
         group,
         idempotent: t.idempotent,
+        intent: t.intent,
         layers: options?.layers,
         name,
-        readOnly: t.readOnly,
         trail: t,
     };
 };
 export const buildCliCommands = (app, options) => {
     const commands = [];
     for (const item of app.list()) {
-        if (item.kind !== 'trail' && item.kind !== 'hike') {
+        if (item.kind !== 'trail') {
             continue;
         }
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         const t = item;
-        if (t.markers?.['internal'] === true) {
+        if (t.metadata?.['internal'] === true) {
             continue;
         }
         commands.push(toCliCommand(t, options));

package/dist/build.js.map

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

package/dist/command.d.ts

@@ -39,8 +39,7 @@ export interface CliCommand {
     readonly args: CliArg[];
     readonly trail: AnyTrail;
     readonly layers?: Layer[] | undefined;
-    readonly readOnly?: boolean | undefined;
-    readonly destructive?: boolean | undefined;
+    readonly intent: 'read' | 'write' | 'destroy';
     readonly idempotent?: boolean | undefined;
     execute(parsedArgs: Record<string, unknown>, parsedFlags: Record<string, unknown>, ctx?: Partial<TrailContext>): Promise<Result<unknown, Error>>;
 }

package/dist/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAMzE;;;;GAIG;AAEH,MAAM,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAMvC,mEAAmE;AACnE,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;IACzE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAMD,iCAAiC;AACjC,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAMD,4DAA4D;AAC5D,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAE1C,OAAO,CACL,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,GAAG,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAC1B,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;CACpC"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAMzE;;;;GAIG;AAEH,MAAM,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAMvC,mEAAmE;AACnE,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;IACzE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAMD,iCAAiC;AACjC,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAMD,4DAA4D;AAC5D,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAE1C,OAAO,CACL,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,GAAG,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAC1B,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;CACpC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ontrails/cli",
-  "version": "1.0.0-beta.3",
+  "version": "1.0.0-beta.4",
   "type": "module",
   "exports": {
     ".": "./src/index.ts",

package/src/__tests__/blaze.test.ts

@@ -15,8 +15,8 @@ import { defaultOnResult } from '../on-result.js';
 describe('blaze', () => {
   test('smoke test: buildCliCommands + toCommander wiring does not throw', () => {
     const t = trail('ping', {
-      implementation: () => Result.ok('pong'),
       input: z.object({}),
+      run: () => Result.ok('pong'),
     });
     const app = topo('smoke-test', { ping: t });
 
@@ -33,8 +33,8 @@ describe('blaze', () => {
 
   test('uses defaultOnResult when none provided', () => {
     const t = trail('echo', {
-      implementation: (input: { msg: string }) => Result.ok(input.msg),
       input: z.object({ msg: z.string() }),
+      run: (input: { msg: string }) => Result.ok(input.msg),
     });
     const app = topo('default-on-result', { echo: t });
 
@@ -67,9 +67,8 @@ describe('blaze', () => {
 
     try {
       const t = trail('greet', {
-        implementation: (input: { name: string }) =>
-          Result.ok(`Hello, ${input.name}!`),
         input: z.object({ name: z.string() }),
+        run: (input: { name: string }) => Result.ok(`Hello, ${input.name}!`),
       });
       const app = topo('e2e-test', { greet: t });
 

package/src/__tests__/build.test.ts

@@ -36,9 +36,8 @@ const requireCommand = (commands: ReturnType<typeof buildCliCommands>) => {
 describe('buildCliCommands', () => {
   test('builds commands from a simple app with one trail', () => {
     const t = trail('greet', {
-      implementation: (input: { name: string }) =>
-        Result.ok(`Hello, ${input.name}`),
       input: z.object({ name: z.string() }),
+      run: (input: { name: string }) => Result.ok(`Hello, ${input.name}`),
     });
     const app = makeApp(t);
     const commands = buildCliCommands(app);
@@ -49,13 +48,12 @@ describe('buildCliCommands', () => {
 
   test('builds grouped subcommands from dotted trail IDs', () => {
     const show = trail('entity.show', {
-      implementation: (input: { id: string }) => Result.ok({ id: input.id }),
       input: z.object({ id: z.string() }),
+      run: (input: { id: string }) => Result.ok({ id: input.id }),
     });
     const add = trail('entity.add', {
-      implementation: (input: { name: string }) =>
-        Result.ok({ name: input.name }),
       input: z.object({ name: z.string() }),
+      run: (input: { name: string }) => Result.ok({ name: input.name }),
     });
     const app = makeApp(show, add);
     const commands = buildCliCommands(app);
@@ -68,11 +66,11 @@ describe('buildCliCommands', () => {
 
   test('derives flags from input schema', () => {
     const t = trail('search', {
-      implementation: () => Result.ok([]),
       input: z.object({
         limit: z.number().optional(),
         query: z.string(),
       }),
+      run: () => Result.ok([]),
     });
     const app = makeApp(t);
     const { flags } = requireCommand(buildCliCommands(app));
@@ -84,11 +82,11 @@ describe('buildCliCommands', () => {
     expect(limitFlag?.required).toBe(false);
   });
 
-  test('adds --dry-run for destructive trails', () => {
+  test('adds --dry-run for destroy intent trails', () => {
     const t = trail('entity.delete', {
-      destructive: true,
-      implementation: () => Result.ok(),
       input: z.object({ id: z.string() }),
+      intent: 'destroy',
+      run: () => Result.ok(),
     });
     const app = makeApp(t);
     const commands = buildCliCommands(app);
@@ -100,8 +98,8 @@ describe('buildCliCommands', () => {
   test('calls onResult with correct context', async () => {
     let captured: ActionResultContext | undefined;
     const t = trail('ping', {
-      implementation: (input: { msg: string }) => Result.ok(input.msg),
       input: z.object({ msg: z.string() }),
+      run: (input: { msg: string }) => Result.ok(input.msg),
     });
     const app = makeApp(t);
     const commands = buildCliCommands(app, {
@@ -122,11 +120,11 @@ describe('buildCliCommands', () => {
   test('validates input before calling implementation', async () => {
     let implCalled = false;
     const t = trail('strict', {
-      implementation: () => {
+      input: z.object({ name: z.string() }),
+      run: () => {
         implCalled = true;
         return Result.ok('done');
       },
-      input: z.object({ name: z.string() }),
     });
     const app = makeApp(t);
     const commands = buildCliCommands(app);
@@ -143,11 +141,11 @@ describe('buildCliCommands', () => {
   test('applies layers in order', async () => {
     const order: string[] = [];
     const t = trail('layered', {
-      implementation: (input: { x: string }) => {
+      input: z.object({ x: z.string() }),
+      run: (input: { x: string }) => {
         order.push('impl');
         return Result.ok(input.x);
       },
-      input: z.object({ x: z.string() }),
     });
     const app = makeApp(t);
     const commands = buildCliCommands(app, {
@@ -186,11 +184,11 @@ describe('buildCliCommands', () => {
   test('uses provided createContext factory', async () => {
     let usedRequestId: string | undefined;
     const t = trail('ctx-test', {
-      implementation: (_input: Record<string, never>, ctx: TrailContext) => {
+      input: z.object({}),
+      run: (_input: Record<string, never>, ctx: TrailContext) => {
         usedRequestId = ctx.requestId;
         return Result.ok('ok');
       },
-      input: z.object({}),
     });
     const app = makeApp(t);
     const commands = buildCliCommands(app, {
@@ -204,11 +202,11 @@ describe('buildCliCommands', () => {
   test('converts kebab-case flags back to camelCase for input', async () => {
     let receivedInput: unknown;
     const t = trail('camel', {
-      implementation: (input) => {
+      input: z.object({ sortOrder: z.string() }),
+      run: (input) => {
         receivedInput = input;
         return Result.ok('ok');
       },
-      input: z.object({ sortOrder: z.string() }),
     });
     const app = makeApp(t);
     const commands = buildCliCommands(app);

package/src/__tests__/layers.test.ts

@@ -48,7 +48,6 @@ const expectSameDate = (value: string | undefined, expected: Date) => {
 
 describe('autoIterateLayer', () => {
   const paginatedTrail = trail('list-items', {
-    implementation: () => Result.ok({ hasMore: false, items: [] }),
     input: z.object({
       all: z.boolean().optional(),
       cursor: z.string().optional(),
@@ -58,6 +57,7 @@ describe('autoIterateLayer', () => {
       items: z.array(z.string()),
       nextCursor: z.string().optional(),
     }),
+    run: () => Result.ok({ hasMore: false, items: [] }),
   });
 
   test('collects paginated results with --all flag', async () => {
@@ -112,8 +112,8 @@ describe('autoIterateLayer', () => {
 
   test('ignores non-paginated trails', () => {
     const simpleTrail = trail('simple', {
-      implementation: (input: { name: string }) => Result.ok(input.name),
       input: z.object({ name: z.string() }),
+      run: (input: { name: string }) => Result.ok(input.name),
     });
 
     const impl: Implementation<{ name: string }, string> = async (input) =>
@@ -132,14 +132,12 @@ describe('autoIterateLayer', () => {
 
 describe('dateShortcutsLayer', () => {
   const dateTrail = trail('events', {
-    implementation: (input: {
-      since?: string | undefined;
-      until?: string | undefined;
-    }) => Result.ok(input),
     input: z.object({
       since: z.string().optional(),
       until: z.string().optional(),
     }),
+    run: (input: { since?: string | undefined; until?: string | undefined }) =>
+      Result.ok(input),
   });
 
   test("expands 'today' to correct date", async () => {
@@ -180,8 +178,8 @@ describe('dateShortcutsLayer', () => {
 
   test('ignores trails without date range fields', () => {
     const noDateTrail = trail('no-dates', {
-      implementation: (input: { name: string }) => Result.ok(input.name),
       input: z.object({ name: z.string() }),
+      run: (input: { name: string }) => Result.ok(input.name),
     });
 
     const impl: Implementation<{ name: string }, string> = async (input) =>

package/src/__tests__/to-commander.test.ts

@@ -62,9 +62,8 @@ const requireCommand = (
 describe('toCommander', () => {
   test('creates a Commander program with correct commands', () => {
     const t = trail('greet', {
-      implementation: (input: { name: string }) =>
-        Result.ok(`Hello, ${input.name}`),
       input: z.object({ name: z.string() }),
+      run: (input: { name: string }) => Result.ok(`Hello, ${input.name}`),
     });
     const app = makeApp(t);
     const commands = buildCliCommands(app);
@@ -78,12 +77,12 @@ describe('toCommander', () => {
 
   test('grouped commands create parent/subcommand structure', () => {
     const show = trail('entity.show', {
-      implementation: () => Result.ok({}),
       input: z.object({ id: z.string() }),
+      run: () => Result.ok({}),
     });
     const add = trail('entity.add', {
-      implementation: () => Result.ok({}),
       input: z.object({ name: z.string() }),
+      run: () => Result.ok({}),
     });
     const app = makeApp(show, add);
     const commands = buildCliCommands(app);
@@ -100,7 +99,6 @@ describe('toCommander', () => {
 
   test('flag types map correctly to Commander options', () => {
     const t = trail('search', {
-      implementation: () => Result.ok([]),
       input: z.object({
         format: z.enum(['json', 'text']).optional(),
         limit: z.number().optional(),
@@ -108,6 +106,7 @@ describe('toCommander', () => {
         tags: z.array(z.string()).optional(),
         verbose: z.boolean().optional(),
       }),
+      run: () => Result.ok([]),
     });
     const app = makeApp(t);
     const commands = buildCliCommands(app);
@@ -125,8 +124,8 @@ describe('toCommander', () => {
   describe('boolean flag negation', () => {
     test('boolean flags get --no-<name> negation options', () => {
       const t = trail('check', {
-        implementation: () => Result.ok('ok'),
         input: z.object({ strict: z.boolean() }),
+        run: () => Result.ok('ok'),
       });
       const app = makeApp(t);
       const commands = buildCliCommands(app);
@@ -142,8 +141,8 @@ describe('toCommander', () => {
 
     test('--no-<flag> sets value to false via parseAsync', async () => {
       const t = trail('check', {
-        implementation: () => Result.ok('ok'),
         input: z.object({ strict: z.boolean().default(true) }),
+        run: () => Result.ok('ok'),
       });
       const app = makeApp(t);
       const commands = buildCliCommands(app, { onResult: noopResult });
@@ -157,8 +156,8 @@ describe('toCommander', () => {
 
     test('--flag sets boolean value to true via parseAsync', async () => {
       const t = trail('check', {
-        implementation: () => Result.ok('ok'),
         input: z.object({ strict: z.boolean().default(false) }),
+        run: () => Result.ok('ok'),
       });
       const app = makeApp(t);
       const commands = buildCliCommands(app, { onResult: noopResult });
@@ -174,8 +173,8 @@ describe('toCommander', () => {
   describe('strict number parsing', () => {
     const buildNumberProgram = () => {
       const t = trail('count', {
-        implementation: () => Result.ok('ok'),
         input: z.object({ limit: z.number() }),
+        run: () => Result.ok('ok'),
       });
       const app = makeApp(t);
       const commands = buildCliCommands(app);
@@ -247,8 +246,8 @@ describe('toCommander', () => {
       { expected: -5, input: '-5' },
     ])('accepts valid number "$input"', async ({ expected, input }) => {
       const t = trail('count', {
-        implementation: () => Result.ok('ok'),
         input: z.object({ limit: z.number() }),
+        run: () => Result.ok('ok'),
       });
       const app = makeApp(t);
       const commands = buildCliCommands(app, { onResult: noopResult });
@@ -263,8 +262,8 @@ describe('toCommander', () => {
 
   test('sets version when provided', () => {
     const t = trail('ping', {
-      implementation: () => Result.ok('pong'),
       input: z.object({}),
+      run: () => Result.ok('pong'),
     });
     const app = makeApp(t);
     const commands = buildCliCommands(app);
@@ -283,8 +282,8 @@ describe('toCommander', () => {
     // This test verifies the error handling structure exists.
     // Full integration would need process.exit mocking.
     const t = trail('fail', {
-      implementation: () => Result.ok('ok'),
       input: z.object({}),
+      run: () => Result.ok('ok'),
     });
     const app = makeApp(t);
     const commands = buildCliCommands(app);

package/src/build.ts

@@ -155,7 +155,7 @@ const executeTrail = async (
 ): Promise<Result<unknown, Error>> => {
   const ctx = await resolveContext(ctxOverrides, options);
   const layers = options?.layers ?? [];
-  const impl = composeLayers(layers, t, t.implementation);
+  const impl = composeLayers(layers, t, t.run);
   return impl(validatedInput, ctx);
 };
 
@@ -207,14 +207,14 @@ const createExecute =
 /** Derive and merge flags for a trail. */
 const buildFlags = (
   fields: readonly Field[],
-  destructive: boolean | undefined,
+  intent: 'read' | 'write' | 'destroy',
   options?: BuildCliCommandsOptions
 ): CliFlag[] => {
   let flags = toFlags(fields);
   if (options?.presets) {
     flags = mergeFlags(options.presets.flat(), flags);
   }
-  if (destructive) {
+  if (intent === 'destroy') {
     flags = mergeFlags(dryRunPreset(), flags);
   }
   return flags;
@@ -227,19 +227,18 @@ const toCliCommand = (
 ): CliCommand => {
   const { group, name } = parseTrailId(t.id);
   const fields = deriveFields(t.input, t.fields);
-  const flags = buildFlags(fields, t.destructive, options);
+  const flags = buildFlags(fields, t.intent, options);
 
   return {
     args: [],
     description: t.description,
-    destructive: t.destructive,
     execute: createExecute(t, fields, flags, options),
     flags,
     group,
     idempotent: t.idempotent,
+    intent: t.intent,
     layers: options?.layers,
     name,
-    readOnly: t.readOnly,
     trail: t,
   };
 };
@@ -251,13 +250,13 @@ export const buildCliCommands = (
   const commands: CliCommand[] = [];
 
   for (const item of app.list()) {
-    if (item.kind !== 'trail' && item.kind !== 'hike') {
+    if (item.kind !== 'trail') {
       continue;
     }
 
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     const t = item as AnyTrail;
-    if (t.markers?.['internal'] === true) {
+    if (t.metadata?.['internal'] === true) {
       continue;
     }
     commands.push(toCliCommand(t, options));

package/src/command.ts

@@ -61,8 +61,7 @@ export interface CliCommand {
   readonly args: CliArg[];
   readonly trail: AnyTrail;
   readonly layers?: Layer[] | undefined;
-  readonly readOnly?: boolean | undefined;
-  readonly destructive?: boolean | undefined;
+  readonly intent: 'read' | 'write' | 'destroy';
   readonly idempotent?: boolean | undefined;
 
   execute(