@ontrails/schema 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 109ms on 10 files with 93 rules using 24 threads.

package/.turbo/turbo-typecheck.log

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

package/CHANGELOG.md

@@ -0,0 +1,20 @@
+# @ontrails/schema
+
+## 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
+
+### Patch Changes
+
+- Updated dependencies
+  - @ontrails/core@1.0.0-beta.0

package/README.md

@@ -0,0 +1,139 @@
+# @ontrails/schema
+
+Surface maps, diffing, and lock files for Trails. The machine-readable contract for CI and governance.
+
+## Installation
+
+```bash
+bun add -d @ontrails/schema
+```
+
+Peer dependencies: `@ontrails/core`, `zod`.
+
+## Quick Start
+
+```typescript
+import {
+  generateSurfaceMap,
+  hashSurfaceMap,
+  diffSurfaceMaps,
+} from '@ontrails/schema';
+
+// Generate the surface map from the topo
+const surfaceMap = generateSurfaceMap(app);
+
+// Hash it for the lock file
+const hash = hashSurfaceMap(surfaceMap);
+
+// Diff two surface maps
+const diff = diffSurfaceMaps(previousMap, surfaceMap);
+if (diff.hasBreaking) {
+  console.error('Breaking changes detected:', diff.breaking);
+}
+```
+
+## API Overview
+
+### `generateSurfaceMap(topo)`
+
+Produces a deterministic manifest of every trail in the topo. Entries are sorted alphabetically by ID. Input and output schemas are converted to JSON Schema via `zodToJsonSchema()`.
+
+```typescript
+const map = generateSurfaceMap(app);
+// {
+//   version: "1.0",
+//   generatedAt: "2026-03-25T10:00:00.000Z",
+//   entries: [
+//     { id: "entity.show", kind: "trail", input: {...}, readOnly: true, exampleCount: 2 },
+//     { id: "search", kind: "trail", input: {...}, exampleCount: 1 },
+//   ]
+// }
+```
+
+Each `SurfaceMapEntry` includes:
+
+- `id`, `kind` (`"trail"` | `"hike"` | `"event"`)
+- `input` and `output` as JSON Schema
+- Safety markers: `readOnly`, `destructive`, `idempotent`
+- `deprecated`, `replacedBy`
+- `follows` (for hikes), `detours`
+- `exampleCount`, `description`
+
+### `hashSurfaceMap(surfaceMap)`
+
+SHA-256 hash of the surface map content. Excludes `generatedAt` so the same topo always produces the same hash byte-for-byte.
+
+```typescript
+const hash = hashSurfaceMap(map); // "a1b2c3d4..."
+```
+
+### `diffSurfaceMaps(prev, curr)`
+
+Semantic diff between two surface maps. Classifies every change by severity instead of producing raw JSON diffs.
+
+```typescript
+const diff = diffSurfaceMaps(previousMap, currentMap);
+
+diff.entries; // All changes
+diff.breaking; // Breaking changes only
+diff.warnings; // Warnings only
+diff.info; // Informational changes
+diff.hasBreaking; // Quick check
+```
+
+**Breaking change detection:**
+
+| Change                     | Severity |
+| -------------------------- | -------- |
+| Trail removed              | breaking |
+| Required input field added | breaking |
+| Input field removed        | breaking |
+| Output field removed       | breaking |
+| Output field type changed  | breaking |
+| Surface removed            | breaking |
+| Safety marker changed      | warning  |
+| Trail deprecated           | warning  |
+| Follows changed            | warning  |
+| Trail added                | info     |
+| Optional input field added | info     |
+| Output field added         | info     |
+| Surface added              | info     |
+
+### Lock File I/O
+
+```typescript
+import {
+  writeSurfaceMap, // .trails/_surface.json (gitignored detail file)
+  readSurfaceMap, // Read it back
+  writeSurfaceLock, // surface.lock (committed, single hash line)
+  readSurfaceLock, // Read the lock hash
+} from '@ontrails/schema';
+```
+
+Default directory: `.trails/`. Override with `{ dir: "./custom" }`.
+
+- `_surface.json` -- Full surface map, gitignored. For local inspection and debugging.
+- `surface.lock` -- Single-line SHA-256 hash, committed to the repo. Source of truth for drift detection.
+
+## Usage with Warden
+
+```typescript
+import {
+  generateSurfaceMap,
+  hashSurfaceMap,
+  readSurfaceLock,
+} from '@ontrails/schema';
+
+const map = generateSurfaceMap(app);
+const current = hashSurfaceMap(map);
+const committed = await readSurfaceLock();
+
+if (committed !== current) {
+  // surface.lock is stale -- topo has changed
+}
+```
+
+## Further Reading
+
+- [Architecture](../../docs/architecture.md)
+- [Testing Guide](../../docs/testing.md)

package/dist/diff.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Semantic diffing of surface maps.
+ */
+import type { DiffResult, SurfaceMap } from './types.js';
+export declare const diffSurfaceMaps: (prev: SurfaceMap, curr: SurfaceMap) => DiffResult;
+//# sourceMappingURL=diff.d.ts.map

package/dist/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../src/diff.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAEV,UAAU,EAEV,UAAU,EAEX,MAAM,YAAY,CAAC;AA8WpB,eAAO,MAAM,eAAe,GAC1B,MAAM,UAAU,EAChB,MAAM,UAAU,KACf,UAkBF,CAAC"}

package/dist/diff.js

@@ -0,0 +1,243 @@
+/**
+ * Semantic diffing of surface maps.
+ */
+const escalate = (acc, severity) => {
+    const rank = { breaking: 2, info: 0, warning: 1 };
+    if (rank[severity] > rank[acc.severity]) {
+        acc.severity = severity;
+    }
+};
+const addDetail = (acc, severity, message) => {
+    acc.details.push(message);
+    escalate(acc, severity);
+};
+// ---------------------------------------------------------------------------
+// Utility
+// ---------------------------------------------------------------------------
+const capitalize = (s) => `${s.charAt(0).toUpperCase()}${s.slice(1)}`;
+const getProperties = (schema) => {
+    if (!schema) {
+        return {};
+    }
+    const props = schema.properties;
+    return props ? { ...props } : {};
+};
+const getRequired = (schema) => {
+    if (!schema) {
+        return new Set();
+    }
+    const req = schema.required;
+    return new Set(req);
+};
+const inferSchemaType = (schema) => {
+    if (typeof schema['type'] === 'string') {
+        return schema['type'];
+    }
+    if (schema['const'] !== undefined) {
+        return `const(${String(schema['const'])})`;
+    }
+    if (schema['anyOf']) {
+        return 'union';
+    }
+    if (schema['enum']) {
+        return 'enum';
+    }
+    return 'unknown';
+};
+const getType = (schema) => schema ? inferSchemaType(schema) : 'unknown';
+/** Diff a single field that was added. */
+const diffAddedField = (acc, direction, key, currRequired) => {
+    if (direction === 'input' && currRequired.has(key)) {
+        addDetail(acc, 'breaking', `Required ${direction} field "${key}" added`);
+    }
+    else {
+        const label = direction === 'input' ? `Optional ${direction}` : 'Output';
+        addDetail(acc, 'info', `${label} field "${key}" added`);
+    }
+};
+/** Diff a single field present in both prev and curr. */
+const diffModifiedField = (acc, direction, key, prevProps, currProps, prevRequired, currRequired) => {
+    const prevType = getType(prevProps[key]);
+    const currType = getType(currProps[key]);
+    if (prevType !== currType) {
+        addDetail(acc, 'breaking', `${capitalize(direction)} field "${key}" type changed: ${prevType} -> ${currType}`);
+    }
+    if (direction === 'input' &&
+        !prevRequired.has(key) &&
+        currRequired.has(key)) {
+        addDetail(acc, 'breaking', `Input field "${key}" changed from optional to required`);
+    }
+};
+/** Diff a single key across prev/curr schemas. */
+const diffKey = (acc, direction, key, prevProps, currProps, prevRequired, currRequired) => {
+    const inPrev = key in prevProps;
+    const inCurr = key in currProps;
+    if (!inPrev && inCurr) {
+        diffAddedField(acc, direction, key, currRequired);
+    }
+    else if (inPrev && !inCurr) {
+        addDetail(acc, 'breaking', `${capitalize(direction)} field "${key}" removed`);
+    }
+    else if (inPrev && inCurr) {
+        diffModifiedField(acc, direction, key, prevProps, currProps, prevRequired, currRequired);
+    }
+};
+const diffSchemaFields = (acc, direction, prev, curr) => {
+    const prevProps = getProperties(prev);
+    const currProps = getProperties(curr);
+    const prevRequired = getRequired(prev);
+    const currRequired = getRequired(curr);
+    const allKeys = new Set([
+        ...Object.keys(prevProps),
+        ...Object.keys(currProps),
+    ]);
+    for (const key of [...allKeys].toSorted()) {
+        diffKey(acc, direction, key, prevProps, currProps, prevRequired, currRequired);
+    }
+};
+// ---------------------------------------------------------------------------
+// Per-entry diffing
+// ---------------------------------------------------------------------------
+/** Diff surface additions and removals. */
+const diffSurfaces = (acc, prev, curr) => {
+    const prevSurfaces = new Set(prev.surfaces);
+    const currSurfaces = new Set(curr.surfaces);
+    for (const s of [...currSurfaces].toSorted()) {
+        if (!prevSurfaces.has(s)) {
+            addDetail(acc, 'info', `Surface "${s}" added`);
+        }
+    }
+    for (const s of [...prevSurfaces].toSorted()) {
+        if (!currSurfaces.has(s)) {
+            addDetail(acc, 'breaking', `Surface "${s}" removed`);
+        }
+    }
+};
+/** Diff safety markers, description, and deprecation. */
+const diffMetadata = (acc, prev, curr) => {
+    for (const marker of ['readOnly', 'destructive', 'idempotent']) {
+        if (prev[marker] !== curr[marker]) {
+            addDetail(acc, 'warning', `${marker} changed: ${String(prev[marker] ?? false)} -> ${String(curr[marker] ?? false)}`);
+        }
+    }
+    if (prev.description !== curr.description) {
+        addDetail(acc, 'info', 'Description updated');
+    }
+    if (!prev.deprecated && curr.deprecated) {
+        const msg = curr.replacedBy
+            ? `Deprecated (replaced by ${curr.replacedBy})`
+            : 'Deprecated';
+        addDetail(acc, 'warning', msg);
+    }
+    else if (prev.deprecated && !curr.deprecated) {
+        addDetail(acc, 'info', 'Undeprecated');
+    }
+};
+/** Build a follows-changed description from added/removed arrays. */
+const buildFollowsMessage = (added, removed) => {
+    const parts = [];
+    if (added.length > 0) {
+        parts.push(`added "${added.join('", "')}"`);
+    }
+    if (removed.length > 0) {
+        parts.push(`removed "${removed.join('", "')}"`);
+    }
+    return `Follows changed: ${parts.join(', ')}`;
+};
+/** Diff follows arrays. */
+const diffFollows = (acc, prev, curr) => {
+    const prevFollows = new Set(prev.follows);
+    const currFollows = new Set(curr.follows);
+    const added = [...currFollows].filter((f) => !prevFollows.has(f)).toSorted();
+    const removed = [...prevFollows]
+        .filter((f) => !currFollows.has(f))
+        .toSorted();
+    if (added.length > 0 || removed.length > 0) {
+        addDetail(acc, 'warning', buildFollowsMessage(added, removed));
+    }
+};
+const diffEntry = (prev, curr) => {
+    const acc = { details: [], severity: 'info' };
+    diffSchemaFields(acc, 'input', prev.input, curr.input);
+    diffSchemaFields(acc, 'output', prev.output, curr.output);
+    diffSurfaces(acc, prev, curr);
+    diffMetadata(acc, prev, curr);
+    diffFollows(acc, prev, curr);
+    if (acc.details.length === 0) {
+        return undefined;
+    }
+    return {
+        change: 'modified',
+        details: acc.details,
+        id: curr.id,
+        kind: curr.kind,
+        severity: acc.severity,
+    };
+};
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Compute a semantic diff between two surface maps.
+ *
+ * Classifies each change with a severity:
+ * - `info`: new trail, optional field added, output field added, description change
+ * - `warning`: safety marker change, deprecation, follows change
+ * - `breaking`: trail removed, required input added, field removed, type change, surface removed
+ */
+/** Find entries added in curr that don't exist in prev. */
+const findAdded = (prevById, currById) => [...currById.entries()]
+    .filter(([id]) => !prevById.has(id))
+    .map(([id, entry]) => ({
+    change: 'added',
+    details: [`Trail "${id}" added`],
+    id,
+    kind: entry.kind,
+    severity: 'info',
+}));
+/** Find entries removed from prev that don't exist in curr. */
+const findRemoved = (prevById, currById) => [...prevById.entries()]
+    .filter(([id]) => !currById.has(id))
+    .map(([id, entry]) => ({
+    change: 'removed',
+    details: [`Trail "${id}" removed`],
+    id,
+    kind: entry.kind,
+    severity: 'breaking',
+}));
+/** Find entries modified between prev and curr. */
+const findModified = (prevById, currById) => {
+    const results = [];
+    for (const [id, currEntry] of currById) {
+        const prevEntry = prevById.get(id);
+        if (prevEntry) {
+            const diff = diffEntry(prevEntry, currEntry);
+            if (diff) {
+                results.push(diff);
+            }
+        }
+    }
+    return results;
+};
+/** Collect all diff entries (added, removed, modified) between two maps. */
+const collectDiffEntries = (prevById, currById) => [
+    ...findAdded(prevById, currById),
+    ...findRemoved(prevById, currById),
+    ...findModified(prevById, currById),
+];
+export const diffSurfaceMaps = (prev, curr) => {
+    const prevById = new Map(prev.entries.map((e) => [e.id, e]));
+    const currById = new Map(curr.entries.map((e) => [e.id, e]));
+    const sorted = collectDiffEntries(prevById, currById).toSorted((a, b) => a.id.localeCompare(b.id));
+    const breaking = sorted.filter((e) => e.severity === 'breaking');
+    const warnings = sorted.filter((e) => e.severity === 'warning');
+    const info = sorted.filter((e) => e.severity === 'info');
+    return {
+        breaking,
+        entries: sorted,
+        hasBreaking: breaking.length > 0,
+        info,
+        warnings,
+    };
+};
+//# sourceMappingURL=diff.js.map

package/dist/diff.js.map

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

package/dist/generate.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Generate a deterministic surface map from a Topo.
+ */
+import type { Topo } from '@ontrails/core';
+import type { SurfaceMap } from './types.js';
+/**
+ * Generate a deterministic surface map from a Topo.
+ *
+ * Entries are sorted alphabetically by id. Object keys within each entry
+ * are sorted lexicographically for stable serialization.
+ */
+export declare const generateSurfaceMap: (topo: Topo) => SurfaceMap;
+//# sourceMappingURL=generate.d.ts.map

package/dist/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAe,IAAI,EAAS,MAAM,gBAAgB,CAAC;AAE/D,OAAO,KAAK,EAAc,UAAU,EAAmB,MAAM,YAAY,CAAC;AAmL1E;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,MAAM,IAAI,KAAG,UA0B/C,CAAC"}

package/dist/generate.js

@@ -0,0 +1,171 @@
+/**
+ * Generate a deterministic surface map from a Topo.
+ */
+import { zodToJsonSchema } from '@ontrails/core';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Sort object keys lexicographically (shallow). */
+const sortKeys = (obj) => {
+    const sorted = {};
+    for (const key of Object.keys(obj).toSorted()) {
+        sorted[key] = obj[key];
+    }
+    return sorted;
+};
+/** Sort object keys recursively for deterministic JSON Schema output. */
+const deepSortKeys = (value) => {
+    if (Array.isArray(value)) {
+        return value.map(deepSortKeys);
+    }
+    if (value !== null && typeof value === 'object') {
+        const sorted = {};
+        for (const key of Object.keys(value).toSorted()) {
+            sorted[key] = deepSortKeys(value[key]);
+        }
+        return sorted;
+    }
+    return value;
+};
+/** Convert a Zod schema to a deterministically-keyed JSON Schema. */
+const toSortedJsonSchema = (schema) => {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const raw = zodToJsonSchema(schema);
+    return deepSortKeys(raw);
+};
+// ---------------------------------------------------------------------------
+// Entry builders
+// ---------------------------------------------------------------------------
+/** Extract surfaces from a raw object. */
+const extractSurfaces = (raw) => Array.isArray(raw['surfaces'])
+    ? raw['surfaces'].toSorted()
+    : [];
+/** Add optional schemas to an entry. */
+const addSchemas = (entry, t) => {
+    if (t.input) {
+        entry['input'] = toSortedJsonSchema(t.input);
+    }
+    if (t.output) {
+        entry['output'] = toSortedJsonSchema(t.output);
+    }
+};
+/** Add safety markers to an entry. */
+const addSafetyMarkers = (entry, t) => {
+    if (t.readOnly === true) {
+        entry['readOnly'] = true;
+    }
+    if (t.destructive === true) {
+        entry['destructive'] = true;
+    }
+    if (t.idempotent === true) {
+        entry['idempotent'] = true;
+    }
+};
+/** Add deprecation and detours to an entry. */
+const addExtendedMetadata = (entry, t, raw) => {
+    if (raw['deprecated'] === true) {
+        entry['deprecated'] = true;
+    }
+    if (typeof raw['replacedBy'] === 'string') {
+        entry['replacedBy'] = raw['replacedBy'];
+    }
+    if (t.detours) {
+        const detoursSorted = {};
+        for (const key of Object.keys(t.detours).toSorted()) {
+            detoursSorted[key] = (t.detours[key] ?? []).toSorted();
+        }
+        entry['detours'] = detoursSorted;
+    }
+};
+/** Add optional metadata fields to an entry. */
+const addMetadata = (entry, t, raw) => {
+    if (t.description !== undefined) {
+        entry['description'] = t.description;
+    }
+    addSafetyMarkers(entry, t);
+    addExtendedMetadata(entry, t, raw);
+};
+const trailToEntry = (t) => {
+    const raw = t;
+    const entry = {
+        exampleCount: Array.isArray(t.examples) ? t.examples.length : 0,
+        id: t.id,
+        kind: t.kind,
+        surfaces: extractSurfaces(raw),
+    };
+    addSchemas(entry, t);
+    addMetadata(entry, t, raw);
+    return sortKeys(entry);
+};
+const hikeToEntry = (r) => {
+    const base = trailToEntry(r);
+    const raw = r;
+    const entry = {
+        ...base,
+        follows: r.follows.toSorted(),
+        kind: 'hike',
+    };
+    // Re-check surfaces on the route itself
+    if (Array.isArray(raw['surfaces'])) {
+        entry['surfaces'] = raw['surfaces'].toSorted();
+    }
+    return sortKeys(entry);
+};
+/** Add optional event-specific fields. */
+const addEventFields = (entry, e, raw) => {
+    if (e.payload) {
+        entry['input'] = toSortedJsonSchema(e.payload);
+    }
+    if (e.description !== undefined) {
+        entry['description'] = e.description;
+    }
+    if (raw['deprecated'] === true) {
+        entry['deprecated'] = true;
+    }
+    if (typeof raw['replacedBy'] === 'string') {
+        entry['replacedBy'] = raw['replacedBy'];
+    }
+};
+const eventToEntry = (e) => {
+    const raw = e;
+    const entry = {
+        exampleCount: 0,
+        id: e.id,
+        kind: 'event',
+        surfaces: extractSurfaces(raw),
+    };
+    addEventFields(entry, e, raw);
+    return sortKeys(entry);
+};
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Generate a deterministic surface map from a Topo.
+ *
+ * Entries are sorted alphabetically by id. Object keys within each entry
+ * are sorted lexicographically for stable serialization.
+ */
+export const generateSurfaceMap = (topo) => {
+    const entries = [];
+    // Collect all trails
+    for (const t of topo.trails.values()) {
+        entries.push(trailToEntry(t));
+    }
+    // Collect all hikes
+    for (const r of topo.hikes.values()) {
+        entries.push(hikeToEntry(r));
+    }
+    // Collect all events
+    for (const e of topo.events.values()) {
+        entries.push(eventToEntry(e));
+    }
+    // Sort alphabetically by id
+    const sorted = entries.toSorted((a, b) => a.id.localeCompare(b.id));
+    return {
+        entries: sorted,
+        generatedAt: new Date().toISOString(),
+        version: '1.0',
+    };
+};
+//# sourceMappingURL=generate.js.map

package/dist/generate.js.map

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

package/dist/hash.d.ts

@@ -0,0 +1,14 @@
+/**
+ * SHA-256 hashing for surface maps.
+ *
+ * Uses Bun.CryptoHasher for native hashing.
+ */
+import type { SurfaceMap } from './types.js';
+/**
+ * Compute a SHA-256 hash of a surface map.
+ *
+ * The `generatedAt` field is excluded so that identical topos always
+ * produce the same hash regardless of when they were generated.
+ */
+export declare const hashSurfaceMap: (surfaceMap: SurfaceMap) => string;
+//# sourceMappingURL=hash.d.ts.map

package/dist/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA4B7C;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,YAAY,UAAU,KAAG,MAUvD,CAAC"}