@ontrails/trails 1.0.0-beta.0

package/.turbo/turbo-build.log

@@ -0,0 +1 @@
+$ tsc -b

package/.turbo/turbo-lint.log

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

package/.turbo/turbo-typecheck.log

@@ -0,0 +1 @@
+$ tsc --noEmit

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# trails
+
+## 0.1.1-beta.0
+
+### Patch Changes
+
+- Updated dependencies
+  - @ontrails/core@1.0.0-beta.0
+  - @ontrails/cli@1.0.0-beta.0
+  - @ontrails/logging@1.0.0-beta.0
+  - @ontrails/warden@1.0.0-beta.0
+  - @ontrails/schema@1.0.0-beta.0

package/__tests__/examples.test.ts

@@ -0,0 +1,6 @@
+/* oxlint-disable eslint-plugin-jest/require-hook -- testExamples registers tests at module scope */
+import { testExamples } from '@ontrails/testing';
+
+import { app } from '../src/app.js';
+
+testExamples(app);

package/bin/trails.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+/* oxlint-disable eslint-plugin-jest/require-hook -- CLI bin entrypoints execute at module scope */
+import '../src/cli.js';

package/dist/bin/trails.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+import '../src/cli.js';
+//# sourceMappingURL=trails.d.ts.map

package/dist/bin/trails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trails.d.ts","sourceRoot":"","sources":["../../bin/trails.ts"],"names":[],"mappings":";AAEA,OAAO,eAAe,CAAC"}

package/dist/bin/trails.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env bun
+/* oxlint-disable eslint-plugin-jest/require-hook -- CLI bin entrypoints execute at module scope */
+import '../src/cli.js';
+//# sourceMappingURL=trails.js.map

package/dist/bin/trails.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trails.js","sourceRoot":"","sources":["../../bin/trails.ts"],"names":[],"mappings":";AACA,mGAAmG;AACnG,OAAO,eAAe,CAAC"}

package/dist/src/app.d.ts

@@ -0,0 +1,2 @@
+export declare const app: import("@ontrails/core").Topo;
+//# sourceMappingURL=app.d.ts.map

package/dist/src/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/app.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,GAAG,+BAUf,CAAC"}

package/dist/src/app.js

@@ -0,0 +1,11 @@
+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 create from './trails/create.js';
+import * as createScaffold from './trails/create-scaffold.js';
+import * as guide from './trails/guide.js';
+import * as survey from './trails/survey.js';
+import * as warden from './trails/warden.js';
+export const app = topo('trails', survey, guide, warden, create, createScaffold, addSurface, addVerify, addTrail);
+//# sourceMappingURL=app.js.map

package/dist/src/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEtC,OAAO,KAAK,UAAU,MAAM,yBAAyB,CAAC;AACtD,OAAO,KAAK,QAAQ,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,SAAS,MAAM,wBAAwB,CAAC;AACpD,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAC;AAC7C,OAAO,KAAK,cAAc,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,KAAK,MAAM,mBAAmB,CAAC;AAC3C,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAC;AAC7C,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAC;AAE7C,MAAM,CAAC,MAAM,GAAG,GAAG,IAAI,CACrB,QAAQ,EACR,MAAM,EACN,KAAK,EACL,MAAM,EACN,MAAM,EACN,cAAc,EACd,UAAU,EACV,SAAS,EACT,QAAQ,CACT,CAAC"}

package/dist/src/clack.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Clack-backed input resolver for the Trails CLI.
+ *
+ * This stays at the app layer so @ontrails/cli remains prompt-library agnostic.
+ */
+import type { InputResolver } from '@ontrails/cli';
+/** Fill missing input by prompting with Clack when interactive. */
+export declare const resolveInputWithClack: InputResolver;
+//# sourceMappingURL=clack.d.ts.map

package/dist/src/clack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clack.d.ts","sourceRoot":"","sources":["../../src/clack.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAS,aAAa,EAAuB,MAAM,eAAe,CAAC;AA6D/E,mEAAmE;AACnE,eAAO,MAAM,qBAAqB,EAAE,aAoBnC,CAAC"}

package/dist/src/clack.js

@@ -0,0 +1,62 @@
+/**
+ * Clack-backed input resolver for the Trails CLI.
+ *
+ * This stays at the app layer so @ontrails/cli remains prompt-library agnostic.
+ */
+import { isInteractive } from '@ontrails/cli';
+import * as clack from '@clack/prompts';
+/** Check whether a field still needs input. */
+const needsInput = (field, current) => current[field.name] === undefined &&
+    field.required &&
+    field.default === undefined;
+/** Build Clack options from field options. */
+const toClackOptions = (field) => field.options?.map((option) => ({
+    ...(option.hint === undefined ? {} : { hint: option.hint }),
+    label: option.label ?? option.value,
+    value: option.value,
+})) ?? [];
+/** Normalize cancelled prompts to `undefined`. */
+const cancelable = async (value) => await (clack.isCancel(value) ? undefined : value);
+const fieldResolvers = {
+    boolean: async (field) => cancelable(await clack.confirm({
+        initialValue: field.default ?? false,
+        message: field.label,
+    })),
+    enum: async (field) => cancelable(await clack.select({
+        message: field.label,
+        options: toClackOptions(field),
+    })),
+    multiselect: async (field) => cancelable(await clack.multiselect({
+        initialValues: field.default ?? [],
+        message: field.label,
+        options: toClackOptions(field),
+    })),
+    number: async (field) => {
+        const raw = await clack.text({ message: field.label });
+        return clack.isCancel(raw) ? undefined : Number(raw);
+    },
+    string: async (field) => cancelable(await clack.text({ message: field.label })),
+};
+/** Resolve a single field value with Clack. */
+const resolveField = (field) => {
+    const resolver = fieldResolvers[field.type];
+    return resolver(field);
+};
+/** Fill missing input by prompting with Clack when interactive. */
+export const resolveInputWithClack = async (fields, provided, options) => {
+    if (!isInteractive(options)) {
+        return provided;
+    }
+    const resolved = { ...provided };
+    for (const field of fields) {
+        if (!needsInput(field, resolved)) {
+            continue;
+        }
+        const value = await resolveField(field);
+        if (value !== undefined) {
+            resolved[field.name] = value;
+        }
+    }
+    return resolved;
+};
+//# sourceMappingURL=clack.js.map

package/dist/src/clack.js.map

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

package/dist/src/cli.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/src/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":""}

package/dist/src/cli.js

@@ -0,0 +1,13 @@
+import { outputModePreset } from '@ontrails/cli';
+import { blaze } from '@ontrails/cli/commander';
+import { app } from './app.js';
+import { resolveInputWithClack } from './clack.js';
+// oxlint-disable-next-line require-hook -- CLI entry point
+blaze(app, {
+    description: 'Agent-native, contract-first TypeScript framework',
+    name: 'trails',
+    presets: [outputModePreset()],
+    resolveInput: resolveInputWithClack,
+    version: '0.1.0',
+});
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAEhD,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD,2DAA2D;AAC3D,KAAK,CAAC,GAAG,EAAE;IACT,WAAW,EAAE,mDAAmD;IAChE,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,CAAC,gBAAgB,EAAE,CAAC;IAC7B,YAAY,EAAE,qBAAqB;IACnC,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC"}

package/dist/src/trails/add-surface.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `add.surface` trail -- Add a surface to an existing project.
+ *
+ * Generates the CLI or MCP entry point and updates package.json dependencies.
+ */
+export declare const addSurface: import("@ontrails/core").Trail<{
+    surface: "cli" | "mcp";
+    dir?: string | undefined;
+}, {
+    created: string;
+    dependency: string;
+}>;
+//# sourceMappingURL=add-surface.d.ts.map

package/dist/src/trails/add-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-surface.d.ts","sourceRoot":"","sources":["../../../src/trails/add-surface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAwFH,eAAO,MAAM,UAAU;;;;;;EA0BrB,CAAC"}

package/dist/src/trails/add-surface.js

@@ -0,0 +1,88 @@
+/**
+ * `add.surface` trail -- Add a surface to an existing project.
+ *
+ * Generates the CLI or MCP entry point and updates package.json dependencies.
+ */
+import { existsSync, mkdirSync } from 'node:fs';
+import { basename, dirname, join, resolve } from 'node:path';
+import { Result, trail } from '@ontrails/core';
+import { z } from 'zod';
+import { findTopoPath } from './project.js';
+const generateCliEntry = (appImportPath) => `import { blaze } from '@ontrails/cli/commander';
+
+import { app } from '${appImportPath}';
+
+blaze(app);
+`;
+const generateMcpEntry = (appImportPath) => `import { blaze } from '@ontrails/mcp';
+
+import { app } from '${appImportPath}';
+
+await blaze(app);
+`;
+/** Resolve the entry file for a surface. */
+const getEntryFile = (surface) => surface === 'cli' ? 'src/cli.ts' : 'src/mcp.ts';
+// ---------------------------------------------------------------------------
+// Trail definition
+// ---------------------------------------------------------------------------
+/** Patch deps and optionally bin in a parsed package.json. */
+const patchPkgDeps = (pkg, surface, cwd) => {
+    const depName = surface === 'cli' ? '@ontrails/cli' : '@ontrails/mcp';
+    const deps = (pkg['dependencies'] ?? {});
+    deps[depName] = 'workspace:*';
+    if (surface === 'cli') {
+        deps['commander'] = '^14.0.0';
+        pkg['bin'] = {
+            [pkg['name'] ?? basename(cwd)]: './src/cli.ts',
+        };
+    }
+    pkg['dependencies'] = Object.fromEntries(Object.entries(deps).toSorted(([a], [b]) => a.localeCompare(b)));
+    return depName;
+};
+/** Update package.json with surface dependency and CLI bin if needed. */
+const updatePkgJsonForSurface = async (cwd, surface) => {
+    const pkgPath = join(cwd, 'package.json');
+    if (!existsSync(pkgPath)) {
+        return surface === 'cli' ? '@ontrails/cli' : '@ontrails/mcp';
+    }
+    const pkg = (await Bun.file(pkgPath).json());
+    const depName = patchPkgDeps(pkg, surface, cwd);
+    await Bun.write(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`);
+    return depName;
+};
+/** Create the entry file for a surface and return the relative path. */
+const writeSurfaceEntry = async (cwd, surface) => {
+    const entryFile = getEntryFile(surface);
+    const fullEntryPath = join(cwd, entryFile);
+    const appImport = (await findTopoPath(cwd)) ?? './app.js';
+    const content = surface === 'cli'
+        ? generateCliEntry(appImport)
+        : generateMcpEntry(appImport);
+    mkdirSync(dirname(fullEntryPath), { recursive: true });
+    await Bun.write(fullEntryPath, content);
+    return entryFile;
+};
+export const addSurface = trail('add.surface', {
+    description: 'Add a surface to an existing project',
+    implementation: async (input) => {
+        const cwd = resolve(input.dir ?? '.');
+        const { surface } = input;
+        const entryFile = getEntryFile(surface);
+        if (existsSync(join(cwd, entryFile))) {
+            return Result.err(new Error(`${surface.toUpperCase()} is already blazed. Nothing to do.`));
+        }
+        return Result.ok({
+            created: await writeSurfaceEntry(cwd, surface),
+            dependency: await updatePkgJsonForSurface(cwd, surface),
+        });
+    },
+    input: z.object({
+        dir: z.string().optional().describe('Project directory'),
+        surface: z.enum(['cli', 'mcp']).describe('Surface to add'),
+    }),
+    output: z.object({
+        created: z.string(),
+        dependency: z.string(),
+    }),
+});
+//# sourceMappingURL=add-surface.js.map

package/dist/src/trails/add-surface.js.map

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

package/dist/src/trails/add-trail.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `add.trail` trail -- Scaffold a new trail file with tests.
+ */
+export declare const addTrail: import("@ontrails/core").Trail<{
+    destructive: boolean;
+    id: string;
+    readOnly: boolean;
+}, {
+    created: string[];
+}>;
+//# sourceMappingURL=add-trail.d.ts.map

package/dist/src/trails/add-trail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-trail.d.ts","sourceRoot":"","sources":["../../../src/trails/add-trail.ts"],"names":[],"mappings":"AAAA;;GAEG;AAuEH,eAAO,MAAM,QAAQ;;;;;;EA6BnB,CAAC"}

package/dist/src/trails/add-trail.js

@@ -0,0 +1,85 @@
+/**
+ * `add.trail` trail -- Scaffold a new trail file with tests.
+ */
+import { mkdirSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { Result, trail } from '@ontrails/core';
+import { z } from 'zod';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+const generateTrailFile = (id, readOnly, destructive) => {
+    const markers = [];
+    if (readOnly) {
+        markers.push('  readOnly: true,');
+    }
+    if (destructive) {
+        markers.push('  destructive: true,');
+    }
+    const markerBlock = markers.length > 0 ? `\n${markers.join('\n')}` : '';
+    return `import { Result, trail } from '@ontrails/core';
+import { z } from 'zod';
+
+export const ${id.replaceAll('.', '_')} = trail('${id}', {
+  description: 'TODO: describe this trail',
+  examples: [
+    {
+      input: {},
+      name: 'TODO: add example',
+    },
+  ],
+  implementation: async (input) => {
+    return Result.ok({ message: 'TODO' });
+  },
+  input: z.object({}),${markerBlock}
+  output: z.object({ message: z.string() }),
+});
+`;
+};
+const generateTestFile = (id) => {
+    const moduleName = id.replaceAll('.', '-');
+    const trailName = id.replaceAll('.', '_');
+    return `import { testTrail } from '@ontrails/testing';
+import { ${trailName} } from '../src/trails/${moduleName}.js';
+
+testTrail(${trailName}, [
+  { description: 'basic test', input: {}, expectOk: true },
+]);
+`;
+};
+// ---------------------------------------------------------------------------
+// Trail definition
+// ---------------------------------------------------------------------------
+/** Write a file, creating parent directories as needed. */
+const writeWithDirs = async (filePath, content) => {
+    mkdirSync(dirname(filePath), { recursive: true });
+    await Bun.write(filePath, content);
+};
+export const addTrail = trail('add.trail', {
+    description: 'Scaffold a new trail with tests and examples',
+    implementation: async (input, ctx) => {
+        const { id } = input;
+        const moduleName = id.replaceAll('.', '-');
+        const cwd = resolve(ctx.cwd ?? '.');
+        const files = new Map([
+            [
+                `src/trails/${moduleName}.ts`,
+                generateTrailFile(id, input.readOnly, input.destructive),
+            ],
+            [`__tests__/${moduleName}.test.ts`, generateTestFile(id)],
+        ]);
+        for (const [relativePath, content] of files) {
+            await writeWithDirs(join(cwd, relativePath), content);
+        }
+        return Result.ok({ created: [...files.keys()] });
+    },
+    input: z.object({
+        destructive: z.boolean().default(false).describe('Destructive trail'),
+        id: z.string().describe('Trail ID (e.g., entity.update)'),
+        readOnly: z.boolean().default(false).describe('Read-only trail'),
+    }),
+    output: z.object({
+        created: z.array(z.string()),
+    }),
+});
+//# sourceMappingURL=add-trail.js.map

package/dist/src/trails/add-trail.js.map

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

package/dist/src/trails/add-verify.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `add.verify` trail -- Add testing + warden setup to a project.
+ */
+export declare const addVerify: import("@ontrails/core").Trail<{
+    name: string;
+    dir?: string | undefined;
+}, {
+    created: string[];
+}>;
+//# sourceMappingURL=add-verify.d.ts.map

package/dist/src/trails/add-verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-verify.d.ts","sourceRoot":"","sources":["../../../src/trails/add-verify.ts"],"names":[],"mappings":"AAAA;;GAEG;AAsDH,eAAO,MAAM,SAAS;;;;;EA8BpB,CAAC"}

package/dist/src/trails/add-verify.js

@@ -0,0 +1,67 @@
+/**
+ * `add.verify` trail -- Add testing + warden setup to a project.
+ */
+import { existsSync, mkdirSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { Result, trail } from '@ontrails/core';
+import { z } from 'zod';
+// ---------------------------------------------------------------------------
+// Content generators
+// ---------------------------------------------------------------------------
+const generateTestFile = () => `import { testAll } from '@ontrails/testing';
+import { app } from '../src/app.js';
+
+testAll(app);
+`;
+const generateLefthookYml = () => `pre-push:
+  commands:
+    warden:
+      run: bunx trails warden --exit-code
+`;
+/** Add testing and warden devDependencies to package.json when present. */
+const patchVerifyDeps = (pkg) => {
+    const devDeps = (pkg['devDependencies'] ?? {});
+    devDeps['@ontrails/testing'] = 'workspace:*';
+    devDeps['@ontrails/warden'] = 'workspace:*';
+    devDeps['lefthook'] = '^2.1.1';
+    pkg['devDependencies'] = Object.fromEntries(Object.entries(devDeps).toSorted(([a], [b]) => a.localeCompare(b)));
+};
+/** Update package.json in the target project with verify dependencies. */
+const updatePackageJsonForVerify = async (projectDir) => {
+    const pkgPath = join(projectDir, 'package.json');
+    if (!existsSync(pkgPath)) {
+        return;
+    }
+    const pkg = (await Bun.file(pkgPath).json());
+    patchVerifyDeps(pkg);
+    await Bun.write(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`);
+};
+// ---------------------------------------------------------------------------
+// Trail definition
+// ---------------------------------------------------------------------------
+export const addVerify = trail('add.verify', {
+    description: 'Add testing and warden verification',
+    implementation: async (input) => {
+        const projectDir = resolve(input.dir ?? '.', input.name);
+        const files = [];
+        const writeFile = async (relativePath, content) => {
+            const fullPath = join(projectDir, relativePath);
+            mkdirSync(dirname(fullPath), { recursive: true });
+            await Bun.write(fullPath, content);
+            files.push(relativePath);
+        };
+        await writeFile('__tests__/examples.test.ts', generateTestFile());
+        await writeFile('lefthook.yml', generateLefthookYml());
+        await updatePackageJsonForVerify(projectDir);
+        return Result.ok({ created: files });
+    },
+    input: z.object({
+        dir: z.string().optional().describe('Parent directory'),
+        name: z.string().describe('Project name'),
+    }),
+    markers: { internal: true },
+    output: z.object({
+        created: z.array(z.string()),
+    }),
+});
+//# sourceMappingURL=add-verify.js.map

package/dist/src/trails/add-verify.js.map

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

package/dist/src/trails/create-scaffold.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `create.scaffold` trail -- Creates base project structure.
+ *
+ * Generates package.json, tsconfig, app.ts, starter trails, and .trails/ directory.
+ */
+export declare const createScaffold: import("@ontrails/core").Trail<{
+    name: string;
+    starter: "empty" | "entity" | "hello";
+    dir?: string | undefined;
+}, {
+    created: string[];
+    dir: string;
+    name: string;
+}>;
+//# sourceMappingURL=create-scaffold.d.ts.map

package/dist/src/trails/create-scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-scaffold.d.ts","sourceRoot":"","sources":["../../../src/trails/create-scaffold.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA8TH,eAAO,MAAM,cAAc;;;;;;;;EA6BzB,CAAC"}