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

package/src/trails/release-smoke.ts

@@ -0,0 +1,48 @@
+/**
+ * `release.smoke` trail -- Local release confidence checks.
+ */
+
+import { Result, trail, ValidationError } from '@ontrails/core';
+import { z } from 'zod';
+
+import { releaseSmokeCheckValues, runReleaseSmoke } from '../release/smoke.js';
+
+const releaseSmokeCheckSchema = z.enum(releaseSmokeCheckValues);
+
+const releaseSmokeInputSchema = z.object({
+  check: z.string().default('all').describe('Release smoke check to run'),
+});
+
+const releaseSmokeCheckResultSchema = z.object({
+  check: z.enum(['packed-artifacts', 'wayfinder-dogfood']),
+  message: z.string(),
+  packageCount: z.number().optional(),
+  passed: z.literal(true),
+  trailCount: z.number().optional(),
+});
+
+const releaseSmokeOutputSchema = z.object({
+  checks: z.array(releaseSmokeCheckResultSchema).readonly(),
+  message: z.string(),
+  passed: z.literal(true),
+});
+
+export const releaseSmokeTrail = trail('release.smoke', {
+  blaze: async (input) => {
+    try {
+      const check = releaseSmokeCheckSchema.parse(input.check);
+      return Result.ok(await runReleaseSmoke(check));
+    } catch (error) {
+      return Result.err(
+        new ValidationError(
+          error instanceof Error ? error.message : String(error)
+        )
+      );
+    }
+  },
+  description: 'Run local release confidence smoke checks',
+  input: releaseSmokeInputSchema,
+  intent: 'read',
+  output: releaseSmokeOutputSchema,
+  permit: 'public',
+});

package/src/trails/run-example.ts

@@ -423,9 +423,24 @@ const buildComparisonEnvelope = async (
   });
 };
 
+const runExampleTrailInputSchema = z.object({
+  app: z
+    .string()
+    .optional()
+    .describe(
+      'Workspace app to resolve the trail ID against; required when the ID is exposed by more than one app'
+    ),
+  exampleName: z.string().describe('Name of the example to run'),
+  id: z.string().describe('Trail ID whose example should run'),
+  module: z.string().optional().describe('Path to the app module'),
+  rootDir: z.string().optional().describe('Workspace root directory'),
+});
+
+type RunExampleTrailInput = z.output<typeof runExampleTrailInputSchema>;
+
 export const runExampleTrail = trail('run.example', {
   args: ['id', 'exampleName'],
-  blaze: async (input, ctx) => {
+  blaze: async (input: RunExampleTrailInput, ctx) => {
     const rootDirResult = resolveTrailRootDir(input.rootDir, ctx.cwd);
     if (rootDirResult.isErr()) {
       return rootDirResult;
@@ -469,18 +484,7 @@ export const runExampleTrail = trail('run.example', {
       name: 'Run named example',
     },
   ],
-  input: z.object({
-    app: z
-      .string()
-      .optional()
-      .describe(
-        'Workspace app to resolve the trail ID against; required when the ID is exposed by more than one app'
-      ),
-    exampleName: z.string().describe('Name of the example to run'),
-    id: z.string().describe('Trail ID whose example should run'),
-    module: z.string().optional().describe('Path to the app module'),
-    rootDir: z.string().optional().describe('Workspace root directory'),
-  }),
+  input: runExampleTrailInputSchema,
   intent: 'write',
   output: runExampleComparisonSchema,
   permit: { scopes: ['trails:run'] },

package/src/trails/run-examples.ts

@@ -84,9 +84,23 @@ const buildExamplesListing = (
   });
 };
 
+const runExamplesTrailInputSchema = z.object({
+  app: z
+    .string()
+    .optional()
+    .describe(
+      'Workspace app to resolve the trail ID against; required when the ID is exposed by more than one app'
+    ),
+  id: z.string().describe('Trail ID whose examples should be listed'),
+  module: z.string().optional().describe('Path to the app module'),
+  rootDir: z.string().optional().describe('Workspace root directory'),
+});
+
+type RunExamplesTrailInput = z.output<typeof runExamplesTrailInputSchema>;
+
 export const runExamplesTrail = trail('run.examples', {
   args: ['id'],
-  blaze: async (input, ctx) => {
+  blaze: async (input: RunExamplesTrailInput, ctx) => {
     const rootDirResult = resolveTrailRootDir(input.rootDir, ctx.cwd);
     if (rootDirResult.isErr()) {
       return rootDirResult;
@@ -125,17 +139,7 @@ export const runExamplesTrail = trail('run.examples', {
       name: 'List trail examples',
     },
   ],
-  input: z.object({
-    app: z
-      .string()
-      .optional()
-      .describe(
-        'Workspace app to resolve the trail ID against; required when the ID is exposed by more than one app'
-      ),
-    id: z.string().describe('Trail ID whose examples should be listed'),
-    module: z.string().optional().describe('Path to the app module'),
-    rootDir: z.string().optional().describe('Workspace root directory'),
-  }),
+  input: runExamplesTrailInputSchema,
   intent: 'read',
   output: runExamplesListingSchema,
 });

package/src/trails/run.ts

@@ -313,13 +313,33 @@ const buildAmbiguousExampleInput = (): {
   return { id: 'shared.id', rootDir: root };
 };
 
+const runTrailInputSchema = z.object({
+  app: z
+    .string()
+    .optional()
+    .describe(
+      'Workspace app to resolve the trail ID against; required when the ID is exposed by more than one app'
+    ),
+  id: z.string().describe('Trail ID to invoke'),
+  input: z
+    .unknown()
+    .optional()
+    .describe(
+      'Parsed input for the resolved trail; the CLI surface JSON.parses the inline argument before passing it through'
+    ),
+  module: z.string().optional().describe('Path to the app module'),
+  rootDir: z.string().optional().describe('Workspace root directory'),
+});
+
+type RunTrailInput = z.output<typeof runTrailInputSchema>;
+
 // ---------------------------------------------------------------------------
 // Trail definition
 // ---------------------------------------------------------------------------
 
 export const runTrail = trail('run', {
   args: ['id'],
-  blaze: async (input, ctx) => {
+  blaze: async (input: RunTrailInput, ctx) => {
     const rootDirResult = resolveTrailRootDir(input.rootDir, ctx.cwd);
     if (rootDirResult.isErr()) {
       return rootDirResult;
@@ -383,23 +403,7 @@ export const runTrail = trail('run', {
       name: 'Reject ambiguous trail ID without --app',
     },
   ],
-  input: z.object({
-    app: z
-      .string()
-      .optional()
-      .describe(
-        'Workspace app to resolve the trail ID against; required when the ID is exposed by more than one app'
-      ),
-    id: z.string().describe('Trail ID to invoke'),
-    input: z
-      .unknown()
-      .optional()
-      .describe(
-        'Parsed input for the resolved trail; the CLI surface JSON.parses the inline argument before passing it through'
-      ),
-    module: z.string().optional().describe('Path to the app module'),
-    rootDir: z.string().optional().describe('Workspace root directory'),
-  }),
+  input: runTrailInputSchema,
   intent: 'write',
   output: innerTrailResultSchema,
   permit: { scopes: ['trails:run'] },

package/src/trails/topo-history.ts

@@ -9,8 +9,18 @@ import {
 } from './topo-support.js';
 import { resolveTrailRootDir } from './root-dir.js';
 
+const topoHistoryTrailInputSchema = z.object({
+  limit: z
+    .number()
+    .default(DEFAULT_TOPO_HISTORY_LIMIT)
+    .describe('Maximum number of snapshots to return'),
+  rootDir: z.string().optional().describe('Workspace root directory'),
+});
+
+type TopoHistoryTrailInput = z.output<typeof topoHistoryTrailInputSchema>;
+
 export const topoHistoryTrail = trail('topo.history', {
-  blaze: (input, ctx) => {
+  blaze: (input: TopoHistoryTrailInput, ctx) => {
     const rootDirResult = resolveTrailRootDir(input.rootDir, ctx.cwd);
     if (rootDirResult.isErr()) {
       return rootDirResult;
@@ -25,13 +35,7 @@ export const topoHistoryTrail = trail('topo.history', {
       name: 'Show topo history',
     },
   ],
-  input: z.object({
-    limit: z
-      .number()
-      .default(DEFAULT_TOPO_HISTORY_LIMIT)
-      .describe('Maximum number of snapshots to return'),
-    rootDir: z.string().optional().describe('Workspace root directory'),
-  }),
+  input: topoHistoryTrailInputSchema,
   intent: 'read',
   output: z.object({
     dbPath: z.string(),