@ontrails/core 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 101ms on 60 files with 93 rules using 24 threads.

package/.turbo/turbo-typecheck.log

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

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# @ontrails/core
+
+## 1.0.0-beta.0
+
+### Minor Changes
+
+- Initial v1 beta release of the Trails framework.
+
+  - **@ontrails/core** — Result type, error taxonomy, trail/hike/event/topo, validateTopo, validateInput/Output, deriveFields, patterns, redaction, branded types, resilience
+  - **@ontrails/cli** — CLI surface adapter, Commander integration, flag derivation, layers
+  - **@ontrails/mcp** — MCP surface adapter, tool generation, annotations, progress bridge
+  - **@ontrails/logging** — Structured logging, sinks, formatters, LogTape adapter
+  - **@ontrails/testing** — testAll, testExamples, testTrail, testHike, testContracts, testDetours, surface harnesses
+  - **@ontrails/warden** — AST-based code convention rules via oxc-parser, drift detection, CI formatters
+  - **@ontrails/schema** — Surface map generation, hashing, semantic diffing

package/README.md

@@ -0,0 +1,179 @@
+# @ontrails/core
+
+The foundation of Trails. Result type, error taxonomy, trail/hike/event definitions, topo, validation, patterns, redaction, branded types, and collection utilities. One external dependency: `zod`.
+
+## Installation
+
+```bash
+bun add @ontrails/core
+```
+
+## Quick Start
+
+```typescript
+import { trail, hike, topo, Result } from '@ontrails/core';
+import { z } from 'zod';
+
+// Define a trail -- the atomic unit of work
+const show = trail('entity.show', {
+  input: z.object({ name: z.string().describe('Entity name') }),
+  output: z.object({ name: z.string(), type: z.string() }),
+  readOnly: true,
+  examples: [
+    {
+      name: 'Show an entity',
+      input: { name: 'Alpha' },
+      expected: { name: 'Alpha', type: 'concept' },
+    },
+  ],
+  implementation: (input) => Result.ok({ name: input.name, type: 'concept' }),
+});
+
+// Define a hike -- a composite that follows other trails
+const onboard = hike('entity.onboard', {
+  follows: ['entity.add', 'entity.relate'],
+  input: z.object({ name: z.string(), type: z.string() }),
+  implementation: async (input, ctx) => {
+    const added = await ctx.follow('entity.add', input);
+    if (added.isErr()) return added;
+    return Result.ok({ entity: added.value });
+  },
+});
+
+// Collect into an app
+import * as entity from './trails/entity';
+const app = topo('myapp', entity);
+```
+
+Pure trails can return `Result` directly. Hikes and other I/O-bound trails can stay `async`; core normalizes both forms to one awaitable runtime shape before layers and surfaces execute them.
+
+## API Overview
+
+### Trail Primitives
+
+- **`trail(id, spec)`** -- Define an atomic unit of work. Typed input via Zod, returns `Result`. Authoring may be sync or async.
+- **`hike(id, spec)`** -- Define a composite that follows multiple trails via `ctx.follow()`. Declares dependencies with `follows: string[]`.
+- **`event(id, spec)`** -- Define a server-originated push with a typed data schema.
+- **`topo(name, ...modules)`** -- Collect trail modules into an app. Scans exports for `Trail` shapes and builds the topo.
+
+### Result Type
+
+Built-in `Result<T, E>` with no external dependency.
+
+```typescript
+Result.ok(value); // Create a success
+Result.err(error); // Create a failure
+Result.combine(results); // Collect Result<T>[] into Result<T[]>
+
+result.isOk(); // Type guard for Ok
+result.isErr(); // Type guard for Err
+result.map(fn); // Transform success value
+result.flatMap(fn); // Chain Result-returning functions
+result.match({ ok, err }); // Pattern match
+result.unwrapOr(fallback); // Value or fallback
+```
+
+Implementations return `Result`, never `throw`.
+
+### Error Taxonomy
+
+13 error classes across 10 categories, all extending `TrailsError`. Each maps to CLI exit codes, HTTP status codes, JSON-RPC codes, and retryability.
+
+| Category | Classes | Exit | HTTP | Retryable |
+| --- | --- | --- | --- | --- |
+| `validation` | `ValidationError`, `AmbiguousError`, `AssertionError` | 1 | 400 | No |
+| `not_found` | `NotFoundError` | 2 | 404 | No |
+| `conflict` | `AlreadyExistsError`, `ConflictError` | 3 | 409 | No |
+| `permission` | `PermissionError` | 4 | 403 | No |
+| `timeout` | `TimeoutError` | 5 | 504 | Yes |
+| `rate_limit` | `RateLimitError` | 6 | 429 | Yes |
+| `network` | `NetworkError` | 7 | 502 | Yes |
+| `internal` | `InternalError` | 8 | 500 | No |
+| `auth` | `AuthError` | 9 | 401 | No |
+| `cancelled` | `CancelledError` | 130 | 499 | No |
+
+All extend `TrailsError` directly (class inheritance, no factory pattern). Pattern matching via `instanceof` or `error.category`.
+
+### Patterns (`@ontrails/core/patterns`)
+
+Reusable Zod schemas for common input/output shapes:
+
+- **Pagination** -- `paginationInput`, `paginationOutput` (cursor-based)
+- **Bulk operations** -- `bulkInput`, `bulkOutput` (batch with per-item results)
+- **Timestamps** -- `timestamps` (`createdAt`/`updatedAt`)
+- **Date ranges** -- `dateRangeInput` (`since`/`until`)
+- **Sorting** -- `sortInput` (`sortBy`/`sortOrder`)
+- **Status** -- `statusField` (lifecycle state)
+- **Change tracking** -- `changeOutput` (before/after snapshots)
+- **Progress** -- `progressOutput` (completion reporting)
+
+### Redaction (`@ontrails/core/redaction`)
+
+Strip sensitive data from logs and outputs.
+
+```typescript
+import {
+  createRedactor,
+  DEFAULT_PATTERNS,
+  DEFAULT_SENSITIVE_KEYS,
+} from '@ontrails/core/redaction';
+
+const redactor = createRedactor({
+  patterns: DEFAULT_PATTERNS,
+  sensitiveKeys: DEFAULT_SENSITIVE_KEYS,
+});
+```
+
+### Validation
+
+- **`validateInput(schema, data)`** -- Validate data against a Zod schema, returning `Result`.
+- **`formatZodIssues(issues)`** -- Format Zod issues into human-readable strings.
+- **`zodToJsonSchema(schema)`** -- Convert a Zod schema to JSON Schema for MCP/HTTP surfaces.
+
+### Branded Types
+
+Nominal typing for IDs and domain-specific strings that should not be interchangeable.
+
+```typescript
+import { uuid, email, nonEmptyString, positiveInt } from '@ontrails/core';
+
+const id = uuid('550e8400-e29b-41d4-a716-446655440000');
+const addr = email('user@example.com');
+```
+
+### Collections and Guards
+
+- **Collections** -- `chunk`, `dedupe`, `groupBy`, `sortBy`, `isNonEmptyArray`
+- **Guards** -- `isDefined`, `isNonEmptyString`, `isPlainObject`, `hasProperty`, `assertNever`
+- **Resilience** -- `retry`, `withTimeout`, `shouldRetry`, `getBackoffDelay`
+- **Serialization** -- `serializeError`, `deserializeError`, `Result.fromJson`, `Result.toJson`
+- **Path Security** -- `securePath`, `isPathSafe`, `resolveSafePath`
+- **Workspace** -- `findWorkspaceRoot`, `isInsideWorkspace`, `getRelativePath`
+
+### Layers
+
+Cross-cutting concerns that wrap trail execution:
+
+```typescript
+const loggingLayer: Layer = {
+  name: 'logging',
+  wrap: (next, trail) => async (input, ctx) => {
+    ctx.logger.info(`Executing ${trail.id}`);
+    return next(input, ctx);
+  },
+};
+```
+
+## Subpath Exports
+
+| Export | Contents |
+| --- | --- |
+| `@ontrails/core` | trail, hike, event, topo, Result, errors, types, validation, guards, collections, layers |
+| `@ontrails/core/patterns` | Reusable Zod schema patterns |
+| `@ontrails/core/redaction` | Redactor, default patterns and keys |
+
+## Further Reading
+
+- [Getting Started](../../docs/getting-started.md)
+- [Architecture](../../docs/architecture.md)
+- [Vocabulary](../../docs/vocabulary.md)

package/dist/adapters.d.ts

@@ -0,0 +1,39 @@
+import type { Result } from './result.js';
+/** Options for search queries */
+export interface SearchOptions {
+    readonly limit?: number | undefined;
+    readonly offset?: number | undefined;
+    readonly filters?: Readonly<Record<string, unknown>> | undefined;
+}
+/** A single search hit */
+export interface SearchResult {
+    readonly id: string;
+    readonly score: number;
+    readonly document: Readonly<Record<string, unknown>>;
+}
+/** Options for storage writes */
+export interface StorageOptions {
+    /** Time-to-live in milliseconds */
+    readonly ttl?: number | undefined;
+}
+/** Full-text / vector index adapter */
+export interface IndexAdapter {
+    index(id: string, document: Readonly<Record<string, unknown>>): Promise<Result<void, Error>>;
+    search(query: string, options?: SearchOptions): Promise<Result<readonly SearchResult[], Error>>;
+    remove(id: string): Promise<Result<void, Error>>;
+}
+/** Key-value storage adapter */
+export interface StorageAdapter {
+    get(key: string): Promise<Result<unknown, Error>>;
+    set(key: string, value: unknown, options?: StorageOptions): Promise<Result<void, Error>>;
+    delete(key: string): Promise<Result<void, Error>>;
+    has(key: string): Promise<Result<boolean, Error>>;
+}
+/** Cache adapter with typed get/set and bulk clear */
+export interface CacheAdapter {
+    get<T>(key: string): Promise<Result<T | undefined, Error>>;
+    set<T>(key: string, value: T, options?: StorageOptions): Promise<Result<void, Error>>;
+    delete(key: string): Promise<Result<void, Error>>;
+    clear(): Promise<Result<void, Error>>;
+}
+//# sourceMappingURL=adapters.d.ts.map

package/dist/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAM1C,iCAAiC;AACjC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CAClE;AAED,0BAA0B;AAC1B,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD;AAED,iCAAiC;AACjC,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAMD,uCAAuC;AACvC,MAAM,WAAW,YAAY;IAC3B,KAAK,CACH,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC1C,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAEhC,MAAM,CACJ,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,MAAM,CAAC,SAAS,YAAY,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;IAEnD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;CAClD;AAED,gCAAgC;AAChC,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IAClD,GAAG,CACD,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAChC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAClD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;CACnD;AAED,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;IAC3D,GAAG,CAAC,CAAC,EACH,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,EACR,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAChC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAClD,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;CACvC"}

package/dist/adapters.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=adapters.js.map

package/dist/adapters.js.map

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

package/dist/blob-ref.d.ts

@@ -0,0 +1,20 @@
+/**
+ * BlobRef — a frozen reference to binary data for @ontrails/core.
+ */
+/** Immutable reference to a blob of binary data. */
+export interface BlobRef {
+    readonly name: string;
+    readonly mimeType: string;
+    readonly size: number;
+    readonly data: Uint8Array | ReadableStream<Uint8Array>;
+}
+/** Creates a frozen BlobRef. */
+export declare const createBlobRef: (options: {
+    name: string;
+    mimeType: string;
+    size: number;
+    data: Uint8Array | ReadableStream<Uint8Array>;
+}) => BlobRef;
+/** Type guard for BlobRef-shaped values. */
+export declare const isBlobRef: (value: unknown) => value is BlobRef;
+//# sourceMappingURL=blob-ref.d.ts.map

package/dist/blob-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob-ref.d.ts","sourceRoot":"","sources":["../src/blob-ref.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oDAAoD;AACpD,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;CACxD;AAED,gCAAgC;AAChC,eAAO,MAAM,aAAa,GAAI,SAAS;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;CAC/C,KAAG,OAMA,CAAC;AAEL,4CAA4C;AAC5C,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,OAWnD,CAAC"}

package/dist/blob-ref.js

@@ -0,0 +1,22 @@
+/**
+ * BlobRef — a frozen reference to binary data for @ontrails/core.
+ */
+/** Creates a frozen BlobRef. */
+export const createBlobRef = (options) => Object.freeze({
+    data: options.data,
+    mimeType: options.mimeType,
+    name: options.name,
+    size: options.size,
+});
+/** Type guard for BlobRef-shaped values. */
+export const isBlobRef = (value) => {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const obj = value;
+    return (typeof obj['name'] === 'string' &&
+        typeof obj['mimeType'] === 'string' &&
+        typeof obj['size'] === 'number' &&
+        (obj['data'] instanceof Uint8Array || obj['data'] instanceof ReadableStream));
+};
+//# sourceMappingURL=blob-ref.js.map

package/dist/blob-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob-ref.js","sourceRoot":"","sources":["../src/blob-ref.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,gCAAgC;AAChC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAK7B,EAAW,EAAE,CACZ,MAAM,CAAC,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC,IAAI;IAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;IAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;IAClB,IAAI,EAAE,OAAO,CAAC,IAAI;CACnB,CAAC,CAAC;AAEL,4CAA4C;AAC5C,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAc,EAAoB,EAAE;IAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,OAAO,CACL,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,QAAQ;QAC/B,OAAO,GAAG,CAAC,UAAU,CAAC,KAAK,QAAQ;QACnC,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,QAAQ;QAC/B,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,UAAU,IAAI,GAAG,CAAC,MAAM,CAAC,YAAY,cAAc,CAAC,CAC7E,CAAC;AACJ,CAAC,CAAC"}

package/dist/branded.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Branded types and validated constructors for @ontrails/core.
+ *
+ * Branded types enforce domain constraints at the type level while remaining
+ * plain primitives at runtime. Factory functions return Result so callers
+ * handle validation failures explicitly.
+ */
+import { ValidationError } from './errors.js';
+import type { Result } from './result.js';
+/** Attach a phantom tag to a base type. */
+export type Branded<T, Tag extends string> = T & {
+    readonly __brand: Tag;
+};
+/** Brand a value. No validation — use factory functions for safe construction. */
+export declare const brand: <T, Tag extends string>(_tag: Tag, value: T) => Branded<T, Tag>;
+/** Strip the brand and recover the underlying value. */
+export declare const unbrand: <T>(value: Branded<T, string>) => T;
+export type UUID = Branded<string, 'UUID'>;
+export type Email = Branded<string, 'Email'>;
+export type NonEmptyString = Branded<string, 'NonEmptyString'>;
+export type PositiveInt = Branded<number, 'PositiveInt'>;
+export declare const uuid: (value: string) => Result<UUID, ValidationError>;
+export declare const email: (value: string) => Result<Email, ValidationError>;
+export declare const nonEmptyString: (value: string) => Result<NonEmptyString, ValidationError>;
+export declare const positiveInt: (value: number) => Result<PositiveInt, ValidationError>;
+/**
+ * Generate a random alphanumeric ID.
+ * Runtime-agnostic: uses `crypto.getRandomValues`.
+ */
+export declare const shortId: (length?: number) => string;
+/**
+ * Produce a deterministic hex hash from an input string.
+ * Uses a simple FNV-1a 32-bit hash — good enough for non-cryptographic IDs.
+ */
+export declare const hashId: (input: string) => string;
+//# sourceMappingURL=branded.d.ts.map

package/dist/branded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branded.d.ts","sourceRoot":"","sources":["../src/branded.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAO1C,2CAA2C;AAC3C,MAAM,MAAM,OAAO,CAAC,CAAC,EAAE,GAAG,SAAS,MAAM,IAAI,CAAC,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAA;CAAE,CAAC;AAE3E,kFAAkF;AAClF,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,GAAG,SAAS,MAAM,EACzC,MAAM,GAAG,EACT,OAAO,CAAC,KACP,OAAO,CAAC,CAAC,EAAE,GAAG,CAA6B,CAAC;AAE/C,wDAAwD;AACxD,eAAO,MAAM,OAAO,GAAI,CAAC,EAAE,OAAO,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,KAAG,CAAe,CAAC;AAMvE,MAAM,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC3C,MAAM,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC7C,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAC/D,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAezD,eAAO,MAAM,IAAI,GAAI,OAAO,MAAM,KAAG,MAAM,CAAC,IAAI,EAAE,eAAe,CAShE,CAAC;AAEF,eAAO,MAAM,KAAK,GAAI,OAAO,MAAM,KAAG,MAAM,CAAC,KAAK,EAAE,eAAe,CASlE,CAAC;AAEF,eAAO,MAAM,cAAc,GACzB,OAAO,MAAM,KACZ,MAAM,CAAC,cAAc,EAAE,eAAe,CAKxC,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,OAAO,MAAM,KACZ,MAAM,CAAC,WAAW,EAAE,eAAe,CASrC,CAAC;AASF;;;GAGG;AACH,eAAO,MAAM,OAAO,GAAI,eAAU,KAAG,MAWpC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,MAAM,GAAI,OAAO,MAAM,KAAG,MAYtC,CAAC"}

package/dist/branded.js

@@ -0,0 +1,89 @@
+/**
+ * Branded types and validated constructors for @ontrails/core.
+ *
+ * Branded types enforce domain constraints at the type level while remaining
+ * plain primitives at runtime. Factory functions return Result so callers
+ * handle validation failures explicitly.
+ */
+import { ValidationError } from './errors.js';
+import { Result as R } from './result.js';
+/** Brand a value. No validation — use factory functions for safe construction. */
+export const brand = (_tag, value) => value;
+/** Strip the brand and recover the underlying value. */
+export const unbrand = (value) => value;
+// ---------------------------------------------------------------------------
+// Validation patterns
+// ---------------------------------------------------------------------------
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-7][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+const EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+// ---------------------------------------------------------------------------
+// Factory functions — each returns Result<BrandedType, ValidationError>
+// ---------------------------------------------------------------------------
+export const uuid = (value) => {
+    if (!UUID_RE.test(value)) {
+        return R.err(new ValidationError(`Invalid UUID: "${value}"`, {
+            context: { value },
+        }));
+    }
+    return R.ok(value);
+};
+export const email = (value) => {
+    if (!EMAIL_RE.test(value)) {
+        return R.err(new ValidationError(`Invalid email: "${value}"`, {
+            context: { value },
+        }));
+    }
+    return R.ok(value);
+};
+export const nonEmptyString = (value) => {
+    if (value.length === 0) {
+        return R.err(new ValidationError('String must not be empty'));
+    }
+    return R.ok(value);
+};
+export const positiveInt = (value) => {
+    if (!Number.isInteger(value) || value <= 0) {
+        return R.err(new ValidationError(`Expected positive integer, got ${value}`, {
+            context: { value },
+        }));
+    }
+    return R.ok(value);
+};
+// ---------------------------------------------------------------------------
+// ID utilities
+// ---------------------------------------------------------------------------
+const ALPHANUMERIC = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+/**
+ * Generate a random alphanumeric ID.
+ * Runtime-agnostic: uses `crypto.getRandomValues`.
+ */
+export const shortId = (length = 8) => {
+    const bytes = new Uint8Array(length);
+    crypto.getRandomValues(bytes);
+    let id = '';
+    for (let i = 0; i < length; i += 1) {
+        const byte = bytes[i];
+        if (byte !== undefined) {
+            id += ALPHANUMERIC[byte % ALPHANUMERIC.length];
+        }
+    }
+    return id;
+};
+/**
+ * Produce a deterministic hex hash from an input string.
+ * Uses a simple FNV-1a 32-bit hash — good enough for non-cryptographic IDs.
+ */
+export const hashId = (input) => {
+    // FNV offset basis
+    let hash = 2_166_136_261;
+    for (let i = 0; i < input.length; i += 1) {
+        // oxlint-disable-next-line no-bitwise -- FNV-1a hash requires XOR
+        hash ^= input.codePointAt(i) ?? 0;
+        // FNV prime
+        hash = Math.imul(hash, 0x01_00_01_93);
+    }
+    // Convert to unsigned 32-bit then hex
+    // oxlint-disable-next-line no-bitwise, prefer-math-trunc -- unsigned right shift needed for u32 conversion (Math.trunc differs semantically)
+    return (hash >>> 0).toString(16).padStart(8, '0');
+};
+//# sourceMappingURL=branded.js.map

package/dist/branded.js.map

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

package/dist/collections.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Collection utilities and type helpers for @ontrails/core.
+ */
+/** Recursively make every property optional. */
+export type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
+/** Flatten an intersection into a single object type for better IDE display. */
+export type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+/** Require at least one property from T. */
+export type AtLeastOne<T> = {
+    [K in keyof T]-?: Pick<T, K> & Partial<Omit<T, K>>;
+}[keyof T];
+/** A tuple with at least one element. */
+export type NonEmptyArray<T> = [T, ...T[]];
+/** Narrows a readonly array to a NonEmptyArray. */
+export declare const isNonEmptyArray: <T>(array: readonly T[]) => array is NonEmptyArray<T>;
+/** Split an array into chunks of at most `size` elements. */
+export declare const chunk: <T>(array: readonly T[], size: number) => T[][];
+/**
+ * Remove duplicate items. When `key` is provided, uniqueness is determined
+ * by the return value of the key function; otherwise strict equality is used.
+ */
+export declare const dedupe: <T>(array: readonly T[], key?: (item: T) => unknown) => T[];
+/** Group items by a string key. */
+export declare const groupBy: <T>(array: readonly T[], key: (item: T) => string) => Record<string, T[]>;
+/** Return a new sorted array based on a key function (ascending). */
+export declare const sortBy: <T>(array: readonly T[], key: (item: T) => string | number) => T[];
+//# sourceMappingURL=collections.d.ts.map

package/dist/collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../src/collections.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,gDAAgD;AAChD,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;KAC1B,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAChE,CAAC;AAEF,gFAAgF;AAEhF,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,EAAE,CAAC;AAExD,4CAA4C;AAC5C,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;KACzB,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CACnD,CAAC,MAAM,CAAC,CAAC,CAAC;AAEX,yCAAyC;AACzC,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;AAM3C,mDAAmD;AACnD,eAAO,MAAM,eAAe,GAAI,CAAC,EAC/B,OAAO,SAAS,CAAC,EAAE,KAClB,KAAK,IAAI,aAAa,CAAC,CAAC,CAAqB,CAAC;AAMjD,6DAA6D;AAC7D,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,OAAO,SAAS,CAAC,EAAE,EAAE,MAAM,MAAM,KAAG,CAAC,EAAE,EAS/D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,EACtB,OAAO,SAAS,CAAC,EAAE,EACnB,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,KACzB,CAAC,EAcH,CAAC;AAEF,mCAAmC;AACnC,eAAO,MAAM,OAAO,GAAI,CAAC,EACvB,OAAO,SAAS,CAAC,EAAE,EACnB,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,KACvB,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,CAOpB,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,MAAM,GAAI,CAAC,EACtB,OAAO,SAAS,CAAC,EAAE,EACnB,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,MAAM,KAChC,CAAC,EAQA,CAAC"}

package/dist/collections.js

@@ -0,0 +1,60 @@
+/**
+ * Collection utilities and type helpers for @ontrails/core.
+ */
+// ---------------------------------------------------------------------------
+// Guards
+// ---------------------------------------------------------------------------
+/** Narrows a readonly array to a NonEmptyArray. */
+export const isNonEmptyArray = (array) => array.length > 0;
+// ---------------------------------------------------------------------------
+// Collection functions
+// ---------------------------------------------------------------------------
+/** Split an array into chunks of at most `size` elements. */
+export const chunk = (array, size) => {
+    if (size < 1) {
+        throw new RangeError('chunk size must be >= 1');
+    }
+    const result = [];
+    for (let i = 0; i < array.length; i += size) {
+        result.push(array.slice(i, i + size));
+    }
+    return result;
+};
+/**
+ * Remove duplicate items. When `key` is provided, uniqueness is determined
+ * by the return value of the key function; otherwise strict equality is used.
+ */
+export const dedupe = (array, key) => {
+    if (!key) {
+        return [...new Set(array)];
+    }
+    const seen = new Set();
+    const result = [];
+    for (const item of array) {
+        const k = key(item);
+        if (!seen.has(k)) {
+            seen.add(k);
+            result.push(item);
+        }
+    }
+    return result;
+};
+/** Group items by a string key. */
+export const groupBy = (array, key) => {
+    const groups = {};
+    for (const item of array) {
+        const k = key(item);
+        (groups[k] ??= []).push(item);
+    }
+    return groups;
+};
+/** Return a new sorted array based on a key function (ascending). */
+export const sortBy = (array, key) => [...array].toSorted((a, b) => {
+    const ka = key(a);
+    const kb = key(b);
+    if (typeof ka === 'number' && typeof kb === 'number') {
+        return ka - kb;
+    }
+    return String(ka).localeCompare(String(kb));
+});
+//# sourceMappingURL=collections.js.map

package/dist/collections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.js","sourceRoot":"","sources":["../src/collections.ts"],"names":[],"mappings":"AAAA;;GAEG;AAuBH,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E,mDAAmD;AACnD,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,KAAmB,EACQ,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AAEjD,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E,6DAA6D;AAC7D,MAAM,CAAC,MAAM,KAAK,GAAG,CAAI,KAAmB,EAAE,IAAY,EAAS,EAAE;IACnE,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACb,MAAM,IAAI,UAAU,CAAC,yBAAyB,CAAC,CAAC;IAClD,CAAC;IACD,MAAM,MAAM,GAAU,EAAE,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,KAAmB,EACnB,GAA0B,EACrB,EAAE;IACP,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7B,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAW,CAAC;IAChC,MAAM,MAAM,GAAQ,EAAE,CAAC;IACvB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACjB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACZ,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,mCAAmC;AACnC,MAAM,CAAC,MAAM,OAAO,GAAG,CACrB,KAAmB,EACnB,GAAwB,EACH,EAAE;IACvB,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,qEAAqE;AACrE,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,KAAmB,EACnB,GAAiC,EAC5B,EAAE,CACP,CAAC,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;IAC3B,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IAClB,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IAClB,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;QACrD,OAAO,EAAE,GAAG,EAAE,CAAC;IACjB,CAAC;IACD,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;AAC9C,CAAC,CAAC,CAAC"}

package/dist/context.d.ts

@@ -0,0 +1,10 @@
+import type { TrailContext } from './types.js';
+/**
+ * Create a TrailContext with sensible defaults.
+ *
+ * - `requestId` defaults to `Bun.randomUUIDv7()` (sortable v7 UUID)
+ * - `signal` defaults to a fresh, non-aborted `AbortSignal`
+ * - All other fields come from `overrides`
+ */
+export declare const createTrailContext: (overrides?: Partial<TrailContext>) => TrailContext;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAC7B,YAAY,OAAO,CAAC,YAAY,CAAC,KAChC,YAMD,CAAC"}

package/dist/context.js

@@ -0,0 +1,15 @@
+/**
+ * Create a TrailContext with sensible defaults.
+ *
+ * - `requestId` defaults to `Bun.randomUUIDv7()` (sortable v7 UUID)
+ * - `signal` defaults to a fresh, non-aborted `AbortSignal`
+ * - All other fields come from `overrides`
+ */
+export const createTrailContext = (overrides) => ({
+    cwd: process.cwd(),
+    env: process.env,
+    requestId: Bun.randomUUIDv7(),
+    signal: new AbortController().signal,
+    ...overrides,
+});
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,SAAiC,EACnB,EAAE,CAAC,CAAC;IAClB,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;IAClB,GAAG,EAAE,OAAO,CAAC,GAAyC;IACtD,SAAS,EAAE,GAAG,CAAC,YAAY,EAAE;IAC7B,MAAM,EAAE,IAAI,eAAe,EAAE,CAAC,MAAM;IACpC,GAAG,SAAS;CACb,CAAC,CAAC"}

package/dist/derive.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Schema-driven field derivation for @ontrails/core
+ *
+ * Introspects Zod v4 schemas to produce a surface-agnostic Field[] descriptor
+ * that UI layers (CLI prompts, web forms, etc.) can consume.
+ */
+import type { z } from 'zod';
+/** A surface-agnostic field descriptor derived from a Zod schema. */
+export interface Field {
+    readonly name: string;
+    readonly type: 'string' | 'number' | 'boolean' | 'enum' | 'multiselect';
+    readonly label: string;
+    readonly required: boolean;
+    readonly default?: unknown | undefined;
+    readonly options?: readonly {
+        value: string;
+        label?: string | undefined;
+        hint?: string | undefined;
+    }[] | undefined;
+}
+/** Per-field overrides supplied by trail authors. */
+export interface FieldOverride {
+    readonly label?: string | undefined;
+    readonly message?: string | undefined;
+    readonly hint?: string | undefined;
+    readonly options?: readonly {
+        value: string;
+        label: string;
+        hint?: string | undefined;
+    }[] | undefined;
+}
+export declare const deriveFields: (schema: z.ZodType, overrides?: Record<string, FieldOverride>) => Field[];
+//# sourceMappingURL=derive.d.ts.map

package/dist/derive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive.d.ts","sourceRoot":"","sources":["../src/derive.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAM7B,qEAAqE;AACrE,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,aAAa,CAAC;IACxE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,OAAO,CAAC,EACb,SAAS;QACP,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC3B,EAAE,GACH,SAAS,CAAC;CACf;AAED,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,OAAO,CAAC,EACb,SAAS;QACP,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC3B,EAAE,GACH,SAAS,CAAC;CACf;AAmKD,eAAO,MAAM,YAAY,GACvB,QAAQ,CAAC,CAAC,OAAO,EACjB,YAAY,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,KACxC,KAAK,EAeP,CAAC"}