@ontrails/warden 1.0.0-beta.8 → 1.0.0-beta.9

package/.turbo/turbo-lint.log

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

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # @ontrails/warden
 
+## 1.0.0-beta.9
+
+### Minor Changes
+
+- Consolidated improvements across all surface packages.
+
+  **core**: Add `TrailResult<T>` utility type, `topo.ids()` and `topo.count` accessors, `dispatch()` for headless trail execution, and extract shared `executeTrail` pipeline used by CLI/MCP/HTTP.
+
+  **http**: Detect route path collisions and return `Result` from `buildHttpRoutes()`, wire request `AbortSignal` through to trail context, and make write → POST mapping explicit in intent-to-method lookup.
+
+  **mcp**: Return `Result` from `buildMcpTools()` on collision instead of throwing.
+
+  **cli**: Verify exception catching via centralized `executeTrail`.
+
+  **testing**: Follow context awareness improvements.
+
+  **warden**: Refactor rules as composable trails with examples.
+
+  **schema**: Error code and empty body fixes.
+
+### Patch Changes
+
+- Updated dependencies
+  - @ontrails/core@1.0.0-beta.9
+  - @ontrails/schema@1.0.0-beta.9
+
 ## 1.0.0-beta.8
 
 ### Patch Changes

package/README.md

@@ -71,6 +71,24 @@ CI formatters for structured output:
 import { formatGitHubAnnotations, formatJson, formatSummary } from '@ontrails/warden';
 ```
 
+## Trail-based API
+
+Every built-in warden rule is also available as a composable trail. This makes rules queryable, testable, and invocable through any Trails surface.
+
+```typescript
+import { wardenTopo, runWardenTrails } from '@ontrails/warden';
+
+// Inspect the warden rule trails
+console.log(wardenTopo.ids()); // ['warden.rule.no-throw-in-implementation', ...]
+
+// Run all rule trails against a source file
+const diagnostics = await runWardenTrails(filePath, sourceCode, {
+  knownTrailIds: myApp.ids(),
+});
+```
+
+To wrap a custom rule as a trail, use `wrapRule` (imported from `@ontrails/warden/trails/wrap-rule`). This is the same factory used internally to build all built-in rule trails.
+
 ## API
 
 | Export | What it does |
@@ -79,6 +97,8 @@ import { formatGitHubAnnotations, formatJson, formatSummary } from '@ontrails/wa
 | `formatWardenReport(report)` | Human-readable report |
 | `checkDrift(app)` | Check if `surface.lock` matches the current topo |
 | `wardenRules` | Registry of all built-in rules |
+| `wardenTopo` | `Topo` of all built-in rule trails (one per rule) |
+| `runWardenTrails(filePath, sourceCode, options?)` | Dispatch all rule trails for a file, collect diagnostics |
 | `formatGitHubAnnotations(report)` | GitHub Actions annotation format |
 | `formatJson(report)` | Machine-readable JSON |
 | `formatSummary(report)` | Compact summary line |

package/dist/index.d.ts

@@ -23,4 +23,8 @@ export { formatWardenReport, runWarden } from './cli.js';
 export { formatGitHubAnnotations, formatJson, formatSummary, } from './formatters.js';
 export type { DriftResult } from './drift.js';
 export { checkDrift } from './drift.js';
+export { wardenTopo } from './trails/topo.js';
+export { runWardenTrails } from './trails/run.js';
+export { contextNoSurfaceTypesTrail, diagnosticSchema, followDeclarationsTrail, implementationReturnsResultTrail, noDirectImplInRouteTrail, noDirectImplementationCallTrail, noSyncResultAssumptionTrail, noThrowInDetourTargetTrail, noThrowInImplementationTrail, preferSchemaInferenceTrail, ruleInput, ruleOutput, validDescribeRefsTrail, validDetourRefsTrail, } from './trails/index.js';
+export type { RuleInput, RuleOutput } from './trails/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EACV,sBAAsB,EACtB,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,cAAc,GACf,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AACtF,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AACvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAGnE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAGzD,OAAO,EACL,uBAAuB,EACvB,UAAU,EACV,aAAa,GACd,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EACV,sBAAsB,EACtB,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,cAAc,GACf,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AACtF,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AACvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAGnE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAGzD,OAAO,EACL,uBAAuB,EACvB,UAAU,EACV,aAAa,GACd,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGxC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,EAChB,uBAAuB,EACvB,gCAAgC,EAChC,wBAAwB,EACxB,+BAA+B,EAC/B,2BAA2B,EAC3B,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,EAC1B,SAAS,EACT,UAAU,EACV,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -23,4 +23,8 @@ export { formatWardenReport, runWarden } from './cli.js';
 // CI formatters
 export { formatGitHubAnnotations, formatJson, formatSummary, } from './formatters.js';
 export { checkDrift } from './drift.js';
+// Trail layer
+export { wardenTopo } from './trails/topo.js';
+export { runWardenTrails } from './trails/run.js';
+export { contextNoSurfaceTypesTrail, diagnosticSchema, followDeclarationsTrail, implementationReturnsResultTrail, noDirectImplInRouteTrail, noDirectImplementationCallTrail, noSyncResultAssumptionTrail, noThrowInDetourTargetTrail, noThrowInImplementationTrail, preferSchemaInferenceTrail, ruleInput, ruleOutput, validDescribeRefsTrail, validDetourRefsTrail, } from './trails/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,mBAAmB;AACnB,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AACtF,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AACvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAEnE,gBAAgB;AAChB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAI/C,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEzD,gBAAgB;AAChB,OAAO,EACL,uBAAuB,EACvB,UAAU,EACV,aAAa,GACd,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,mBAAmB;AACnB,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AACtF,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AACvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAEnE,gBAAgB;AAChB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAI/C,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEzD,gBAAgB;AAChB,OAAO,EACL,uBAAuB,EACvB,UAAU,EACV,aAAa,GACd,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,cAAc;AACd,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,EAChB,uBAAuB,EACvB,gCAAgC,EAChC,wBAAwB,EACxB,+BAA+B,EAC/B,2BAA2B,EAC3B,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,EAC1B,SAAS,EACT,UAAU,EACV,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC"}

package/dist/trails/context-no-surface-types.trail.d.ts

@@ -0,0 +1,13 @@
+export declare const contextNoSurfaceTypesTrail: import("@ontrails/core").Trail<{
+    filePath: string;
+    sourceCode: string;
+}, {
+    diagnostics: {
+        filePath: string;
+        line: number;
+        message: string;
+        rule: string;
+        severity: "error" | "warn";
+    }[];
+}>;
+//# sourceMappingURL=context-no-surface-types.trail.d.ts.map

package/dist/trails/context-no-surface-types.trail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-no-surface-types.trail.d.ts","sourceRoot":"","sources":["../../src/trails/context-no-surface-types.trail.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,0BAA0B;;;;;;;;;;;EAiBrC,CAAC"}

package/dist/trails/context-no-surface-types.trail.js

@@ -0,0 +1,21 @@
+import { contextNoSurfaceTypes } from '../rules/context-no-surface-types.js';
+import { wrapRule } from './wrap-rule.js';
+export const contextNoSurfaceTypesTrail = wrapRule({
+    examples: [
+        {
+            expected: { diagnostics: [] },
+            input: {
+                filePath: 'clean.ts',
+                sourceCode: `import { trail, Result } from "@ontrails/core";
+trail("entity.show", {
+  run: async (input, ctx) => {
+    return Result.ok({ name: "test" });
+  }
+})`,
+            },
+            name: 'Clean trail without surface imports',
+        },
+    ],
+    rule: contextNoSurfaceTypes,
+});
+//# sourceMappingURL=context-no-surface-types.trail.js.map

package/dist/trails/context-no-surface-types.trail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-no-surface-types.trail.js","sourceRoot":"","sources":["../../src/trails/context-no-surface-types.trail.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,CAAC,MAAM,0BAA0B,GAAG,QAAQ,CAAC;IACjD,QAAQ,EAAE;QACR;YACE,QAAQ,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;YAC7B,KAAK,EAAE;gBACL,QAAQ,EAAE,UAAU;gBACpB,UAAU,EAAE;;;;;GAKjB;aACI;YACD,IAAI,EAAE,qCAAqC;SAC5C;KACF;IACD,IAAI,EAAE,qBAAqB;CAC5B,CAAC,CAAC"}

package/dist/trails/follow-declarations.trail.d.ts

@@ -0,0 +1,13 @@
+export declare const followDeclarationsTrail: import("@ontrails/core").Trail<{
+    filePath: string;
+    sourceCode: string;
+}, {
+    diagnostics: {
+        filePath: string;
+        line: number;
+        message: string;
+        rule: string;
+        severity: "error" | "warn";
+    }[];
+}>;
+//# sourceMappingURL=follow-declarations.trail.d.ts.map

package/dist/trails/follow-declarations.trail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"follow-declarations.trail.d.ts","sourceRoot":"","sources":["../../src/trails/follow-declarations.trail.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,uBAAuB;;;;;;;;;;;EAkBlC,CAAC"}

package/dist/trails/follow-declarations.trail.js

@@ -0,0 +1,22 @@
+import { followDeclarations } from '../rules/follow-declarations.js';
+import { wrapRule } from './wrap-rule.js';
+export const followDeclarationsTrail = wrapRule({
+    examples: [
+        {
+            expected: { diagnostics: [] },
+            input: {
+                filePath: 'clean.ts',
+                sourceCode: `trail("entity.onboard", {
+  follow: ["entity.create"],
+  run: async (input, ctx) => {
+    const result = await ctx.follow("entity.create", input);
+    return Result.ok(result);
+  }
+})`,
+            },
+            name: 'Matched follow declarations and calls',
+        },
+    ],
+    rule: followDeclarations,
+});
+//# sourceMappingURL=follow-declarations.trail.js.map

package/dist/trails/follow-declarations.trail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"follow-declarations.trail.js","sourceRoot":"","sources":["../../src/trails/follow-declarations.trail.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,CAAC,MAAM,uBAAuB,GAAG,QAAQ,CAAC;IAC9C,QAAQ,EAAE;QACR;YACE,QAAQ,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;YAC7B,KAAK,EAAE;gBACL,QAAQ,EAAE,UAAU;gBACpB,UAAU,EAAE;;;;;;GAMjB;aACI;YACD,IAAI,EAAE,uCAAuC;SAC9C;KACF;IACD,IAAI,EAAE,kBAAkB;CACzB,CAAC,CAAC"}

package/dist/trails/implementation-returns-result.trail.d.ts

@@ -0,0 +1,13 @@
+export declare const implementationReturnsResultTrail: import("@ontrails/core").Trail<{
+    filePath: string;
+    sourceCode: string;
+}, {
+    diagnostics: {
+        filePath: string;
+        line: number;
+        message: string;
+        rule: string;
+        severity: "error" | "warn";
+    }[];
+}>;
+//# sourceMappingURL=implementation-returns-result.trail.d.ts.map

package/dist/trails/implementation-returns-result.trail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"implementation-returns-result.trail.d.ts","sourceRoot":"","sources":["../../src/trails/implementation-returns-result.trail.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,gCAAgC;;;;;;;;;;;EAgB3C,CAAC"}

package/dist/trails/implementation-returns-result.trail.js

@@ -0,0 +1,20 @@
+import { implementationReturnsResult } from '../rules/implementation-returns-result.js';
+import { wrapRule } from './wrap-rule.js';
+export const implementationReturnsResultTrail = wrapRule({
+    examples: [
+        {
+            expected: { diagnostics: [] },
+            input: {
+                filePath: 'clean.ts',
+                sourceCode: `trail("entity.show", {
+  run: async (input, ctx) => {
+    return Result.ok({ name: "test" });
+  }
+})`,
+            },
+            name: 'Implementation returning Result.ok()',
+        },
+    ],
+    rule: implementationReturnsResult,
+});
+//# sourceMappingURL=implementation-returns-result.trail.js.map

package/dist/trails/implementation-returns-result.trail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"implementation-returns-result.trail.js","sourceRoot":"","sources":["../../src/trails/implementation-returns-result.trail.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AACxF,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,CAAC,MAAM,gCAAgC,GAAG,QAAQ,CAAC;IACvD,QAAQ,EAAE;QACR;YACE,QAAQ,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;YAC7B,KAAK,EAAE;gBACL,QAAQ,EAAE,UAAU;gBACpB,UAAU,EAAE;;;;GAIjB;aACI;YACD,IAAI,EAAE,sCAAsC;SAC7C;KACF;IACD,IAAI,EAAE,2BAA2B;CAClC,CAAC,CAAC"}

package/dist/trails/index.d.ts

@@ -0,0 +1,14 @@
+export { contextNoSurfaceTypesTrail } from './context-no-surface-types.trail.js';
+export { followDeclarationsTrail } from './follow-declarations.trail.js';
+export { implementationReturnsResultTrail } from './implementation-returns-result.trail.js';
+export { noDirectImplInRouteTrail } from './no-direct-impl-in-route.trail.js';
+export { noDirectImplementationCallTrail } from './no-direct-implementation-call.trail.js';
+export { noSyncResultAssumptionTrail } from './no-sync-result-assumption.trail.js';
+export { noThrowInDetourTargetTrail } from './no-throw-in-detour-target.trail.js';
+export { noThrowInImplementationTrail } from './no-throw-in-implementation.trail.js';
+export { preferSchemaInferenceTrail } from './prefer-schema-inference.trail.js';
+export { validDescribeRefsTrail } from './valid-describe-refs.trail.js';
+export { validDetourRefsTrail } from './valid-detour-refs.trail.js';
+export { ruleInput, ruleOutput, diagnosticSchema } from './schema.js';
+export type { RuleInput, RuleOutput } from './schema.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/trails/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,gCAAgC,EAAE,MAAM,0CAA0C,CAAC;AAC5F,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,EAAE,+BAA+B,EAAE,MAAM,0CAA0C,CAAC;AAC3F,OAAO,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAClF,OAAO,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAC;AACrF,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACtE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/trails/index.js

@@ -0,0 +1,13 @@
+export { contextNoSurfaceTypesTrail } from './context-no-surface-types.trail.js';
+export { followDeclarationsTrail } from './follow-declarations.trail.js';
+export { implementationReturnsResultTrail } from './implementation-returns-result.trail.js';
+export { noDirectImplInRouteTrail } from './no-direct-impl-in-route.trail.js';
+export { noDirectImplementationCallTrail } from './no-direct-implementation-call.trail.js';
+export { noSyncResultAssumptionTrail } from './no-sync-result-assumption.trail.js';
+export { noThrowInDetourTargetTrail } from './no-throw-in-detour-target.trail.js';
+export { noThrowInImplementationTrail } from './no-throw-in-implementation.trail.js';
+export { preferSchemaInferenceTrail } from './prefer-schema-inference.trail.js';
+export { validDescribeRefsTrail } from './valid-describe-refs.trail.js';
+export { validDetourRefsTrail } from './valid-detour-refs.trail.js';
+export { ruleInput, ruleOutput, diagnosticSchema } from './schema.js';
+//# sourceMappingURL=index.js.map

package/dist/trails/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/trails/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,gCAAgC,EAAE,MAAM,0CAA0C,CAAC;AAC5F,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,EAAE,+BAA+B,EAAE,MAAM,0CAA0C,CAAC;AAC3F,OAAO,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAClF,OAAO,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAC;AACrF,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/trails/no-direct-impl-in-route.trail.d.ts

@@ -0,0 +1,13 @@
+export declare const noDirectImplInRouteTrail: import("@ontrails/core").Trail<{
+    filePath: string;
+    sourceCode: string;
+}, {
+    diagnostics: {
+        filePath: string;
+        line: number;
+        message: string;
+        rule: string;
+        severity: "error" | "warn";
+    }[];
+}>;
+//# sourceMappingURL=no-direct-impl-in-route.trail.d.ts.map

package/dist/trails/no-direct-impl-in-route.trail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-direct-impl-in-route.trail.d.ts","sourceRoot":"","sources":["../../src/trails/no-direct-impl-in-route.trail.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,wBAAwB;;;;;;;;;;;EAkBnC,CAAC"}

package/dist/trails/no-direct-impl-in-route.trail.js

@@ -0,0 +1,22 @@
+import { noDirectImplInRoute } from '../rules/no-direct-impl-in-route.js';
+import { wrapRule } from './wrap-rule.js';
+export const noDirectImplInRouteTrail = wrapRule({
+    examples: [
+        {
+            expected: { diagnostics: [] },
+            input: {
+                filePath: 'clean.ts',
+                sourceCode: `trail("entity.onboard", {
+  follow: ["entity.create"],
+  run: async (input, ctx) => {
+    const result = await ctx.follow("entity.create", input);
+    return Result.ok(result);
+  }
+})`,
+            },
+            name: 'Trail with follow using ctx.follow()',
+        },
+    ],
+    rule: noDirectImplInRoute,
+});
+//# sourceMappingURL=no-direct-impl-in-route.trail.js.map

package/dist/trails/no-direct-impl-in-route.trail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-direct-impl-in-route.trail.js","sourceRoot":"","sources":["../../src/trails/no-direct-impl-in-route.trail.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,CAAC,MAAM,wBAAwB,GAAG,QAAQ,CAAC;IAC/C,QAAQ,EAAE;QACR;YACE,QAAQ,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;YAC7B,KAAK,EAAE;gBACL,QAAQ,EAAE,UAAU;gBACpB,UAAU,EAAE;;;;;;GAMjB;aACI;YACD,IAAI,EAAE,sCAAsC;SAC7C;KACF;IACD,IAAI,EAAE,mBAAmB;CAC1B,CAAC,CAAC"}

package/dist/trails/no-direct-implementation-call.trail.d.ts

@@ -0,0 +1,13 @@
+export declare const noDirectImplementationCallTrail: import("@ontrails/core").Trail<{
+    filePath: string;
+    sourceCode: string;
+}, {
+    diagnostics: {
+        filePath: string;
+        line: number;
+        message: string;
+        rule: string;
+        severity: "error" | "warn";
+    }[];
+}>;
+//# sourceMappingURL=no-direct-implementation-call.trail.d.ts.map

package/dist/trails/no-direct-implementation-call.trail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-direct-implementation-call.trail.d.ts","sourceRoot":"","sources":["../../src/trails/no-direct-implementation-call.trail.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,+BAA+B;;;;;;;;;;;EAY1C,CAAC"}

package/dist/trails/no-direct-implementation-call.trail.js

@@ -0,0 +1,16 @@
+import { noDirectImplementationCall } from '../rules/no-direct-implementation-call.js';
+import { wrapRule } from './wrap-rule.js';
+export const noDirectImplementationCallTrail = wrapRule({
+    examples: [
+        {
+            expected: { diagnostics: [] },
+            input: {
+                filePath: 'clean.ts',
+                sourceCode: `const data = await ctx.follow("entity.show", { id: "1" });`,
+            },
+            name: 'Clean code using ctx.follow instead of .run()',
+        },
+    ],
+    rule: noDirectImplementationCall,
+});
+//# sourceMappingURL=no-direct-implementation-call.trail.js.map

package/dist/trails/no-direct-implementation-call.trail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-direct-implementation-call.trail.js","sourceRoot":"","sources":["../../src/trails/no-direct-implementation-call.trail.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,2CAA2C,CAAC;AACvF,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,CAAC,MAAM,+BAA+B,GAAG,QAAQ,CAAC;IACtD,QAAQ,EAAE;QACR;YACE,QAAQ,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;YAC7B,KAAK,EAAE;gBACL,QAAQ,EAAE,UAAU;gBACpB,UAAU,EAAE,4DAA4D;aACzE;YACD,IAAI,EAAE,+CAA+C;SACtD;KACF;IACD,IAAI,EAAE,0BAA0B;CACjC,CAAC,CAAC"}

package/dist/trails/no-sync-result-assumption.trail.d.ts

@@ -0,0 +1,13 @@
+export declare const noSyncResultAssumptionTrail: import("@ontrails/core").Trail<{
+    filePath: string;
+    sourceCode: string;
+}, {
+    diagnostics: {
+        filePath: string;
+        line: number;
+        message: string;
+        rule: string;
+        severity: "error" | "warn";
+    }[];
+}>;
+//# sourceMappingURL=no-sync-result-assumption.trail.d.ts.map

package/dist/trails/no-sync-result-assumption.trail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-sync-result-assumption.trail.d.ts","sourceRoot":"","sources":["../../src/trails/no-sync-result-assumption.trail.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,2BAA2B;;;;;;;;;;;EAetC,CAAC"}

package/dist/trails/no-sync-result-assumption.trail.js

@@ -0,0 +1,19 @@
+import { noSyncResultAssumption } from '../rules/no-sync-result-assumption.js';
+import { wrapRule } from './wrap-rule.js';
+export const noSyncResultAssumptionTrail = wrapRule({
+    examples: [
+        {
+            expected: { diagnostics: [] },
+            input: {
+                filePath: 'clean.ts',
+                sourceCode: `const result = await myTrail.run(input, ctx);
+if (result.isOk()) {
+  console.log(result.value);
+}`,
+            },
+            name: 'Properly awaited .run() call',
+        },
+    ],
+    rule: noSyncResultAssumption,
+});
+//# sourceMappingURL=no-sync-result-assumption.trail.js.map

package/dist/trails/no-sync-result-assumption.trail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-sync-result-assumption.trail.js","sourceRoot":"","sources":["../../src/trails/no-sync-result-assumption.trail.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,CAAC,MAAM,2BAA2B,GAAG,QAAQ,CAAC;IAClD,QAAQ,EAAE;QACR;YACE,QAAQ,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;YAC7B,KAAK,EAAE;gBACL,QAAQ,EAAE,UAAU;gBACpB,UAAU,EAAE;;;EAGlB;aACK;YACD,IAAI,EAAE,8BAA8B;SACrC;KACF;IACD,IAAI,EAAE,sBAAsB;CAC7B,CAAC,CAAC"}

package/dist/trails/no-throw-in-detour-target.trail.d.ts

@@ -0,0 +1,14 @@
+export declare const noThrowInDetourTargetTrail: import("@ontrails/core").Trail<{
+    filePath: string;
+    sourceCode: string;
+    knownTrailIds?: string[] | undefined;
+}, {
+    diagnostics: {
+        filePath: string;
+        line: number;
+        message: string;
+        rule: string;
+        severity: "error" | "warn";
+    }[];
+}>;
+//# sourceMappingURL=no-throw-in-detour-target.trail.d.ts.map

package/dist/trails/no-throw-in-detour-target.trail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-throw-in-detour-target.trail.d.ts","sourceRoot":"","sources":["../../src/trails/no-throw-in-detour-target.trail.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,0BAA0B;;;;;;;;;;;;EAgBrC,CAAC"}

package/dist/trails/no-throw-in-detour-target.trail.js

@@ -0,0 +1,20 @@
+import { noThrowInDetourTarget } from '../rules/no-throw-in-detour-target.js';
+import { wrapRule } from './wrap-rule.js';
+export const noThrowInDetourTargetTrail = wrapRule({
+    examples: [
+        {
+            expected: { diagnostics: [] },
+            input: {
+                filePath: 'clean.ts',
+                sourceCode: `trail("entity.fallback", {
+  run: async (input, ctx) => {
+    return Result.ok({ recovered: true });
+  }
+})`,
+            },
+            name: 'Detour target without throw',
+        },
+    ],
+    rule: noThrowInDetourTarget,
+});
+//# sourceMappingURL=no-throw-in-detour-target.trail.js.map

package/dist/trails/no-throw-in-detour-target.trail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-throw-in-detour-target.trail.js","sourceRoot":"","sources":["../../src/trails/no-throw-in-detour-target.trail.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,CAAC,MAAM,0BAA0B,GAAG,QAAQ,CAAC;IACjD,QAAQ,EAAE;QACR;YACE,QAAQ,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;YAC7B,KAAK,EAAE;gBACL,QAAQ,EAAE,UAAU;gBACpB,UAAU,EAAE;;;;GAIjB;aACI;YACD,IAAI,EAAE,6BAA6B;SACpC;KACF;IACD,IAAI,EAAE,qBAAqB;CAC5B,CAAC,CAAC"}

package/dist/trails/no-throw-in-implementation.trail.d.ts

@@ -0,0 +1,13 @@
+export declare const noThrowInImplementationTrail: import("@ontrails/core").Trail<{
+    filePath: string;
+    sourceCode: string;
+}, {
+    diagnostics: {
+        filePath: string;
+        line: number;
+        message: string;
+        rule: string;
+        severity: "error" | "warn";
+    }[];
+}>;
+//# sourceMappingURL=no-throw-in-implementation.trail.d.ts.map

package/dist/trails/no-throw-in-implementation.trail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-throw-in-implementation.trail.d.ts","sourceRoot":"","sources":["../../src/trails/no-throw-in-implementation.trail.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,4BAA4B;;;;;;;;;;;EAgBvC,CAAC"}

package/dist/trails/no-throw-in-implementation.trail.js

@@ -0,0 +1,20 @@
+import { noThrowInImplementation } from '../rules/no-throw-in-implementation.js';
+import { wrapRule } from './wrap-rule.js';
+export const noThrowInImplementationTrail = wrapRule({
+    examples: [
+        {
+            expected: { diagnostics: [] },
+            input: {
+                filePath: 'clean.ts',
+                sourceCode: `trail("entity.show", {
+  run: async (input, ctx) => {
+    return Result.ok({ name: "test" });
+  }
+})`,
+            },
+            name: 'Clean implementation without throw',
+        },
+    ],
+    rule: noThrowInImplementation,
+});
+//# sourceMappingURL=no-throw-in-implementation.trail.js.map

package/dist/trails/no-throw-in-implementation.trail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-throw-in-implementation.trail.js","sourceRoot":"","sources":["../../src/trails/no-throw-in-implementation.trail.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,CAAC,MAAM,4BAA4B,GAAG,QAAQ,CAAC;IACnD,QAAQ,EAAE;QACR;YACE,QAAQ,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;YAC7B,KAAK,EAAE;gBACL,QAAQ,EAAE,UAAU;gBACpB,UAAU,EAAE;;;;GAIjB;aACI;YACD,IAAI,EAAE,oCAAoC;SAC3C;KACF;IACD,IAAI,EAAE,uBAAuB;CAC9B,CAAC,CAAC"}

package/dist/trails/prefer-schema-inference.trail.d.ts

@@ -0,0 +1,13 @@
+export declare const preferSchemaInferenceTrail: import("@ontrails/core").Trail<{
+    filePath: string;
+    sourceCode: string;
+}, {
+    diagnostics: {
+        filePath: string;
+        line: number;
+        message: string;
+        rule: string;
+        severity: "error" | "warn";
+    }[];
+}>;
+//# sourceMappingURL=prefer-schema-inference.trail.d.ts.map

package/dist/trails/prefer-schema-inference.trail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefer-schema-inference.trail.d.ts","sourceRoot":"","sources":["../../src/trails/prefer-schema-inference.trail.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,0BAA0B;;;;;;;;;;;EAiBrC,CAAC"}

package/dist/trails/prefer-schema-inference.trail.js

@@ -0,0 +1,21 @@
+import { preferSchemaInference } from '../rules/prefer-schema-inference.js';
+import { wrapRule } from './wrap-rule.js';
+export const preferSchemaInferenceTrail = wrapRule({
+    examples: [
+        {
+            expected: { diagnostics: [] },
+            input: {
+                filePath: 'clean.ts',
+                sourceCode: `trail("entity.show", {
+  input: z.object({ name: z.string() }),
+  run: async (input, ctx) => {
+    return Result.ok({ name: input.name });
+  }
+})`,
+            },
+            name: 'Trail without redundant field overrides',
+        },
+    ],
+    rule: preferSchemaInference,
+});
+//# sourceMappingURL=prefer-schema-inference.trail.js.map

package/dist/trails/prefer-schema-inference.trail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefer-schema-inference.trail.js","sourceRoot":"","sources":["../../src/trails/prefer-schema-inference.trail.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,CAAC,MAAM,0BAA0B,GAAG,QAAQ,CAAC;IACjD,QAAQ,EAAE;QACR;YACE,QAAQ,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;YAC7B,KAAK,EAAE;gBACL,QAAQ,EAAE,UAAU;gBACpB,UAAU,EAAE;;;;;GAKjB;aACI;YACD,IAAI,EAAE,yCAAyC;SAChD;KACF;IACD,IAAI,EAAE,qBAAqB;CAC5B,CAAC,CAAC"}

package/dist/trails/run.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Run all warden rule trails against a single source file.
+ *
+ * Returns a flat array of diagnostics from every rule.
+ */
+import type { WardenDiagnostic } from '../rules/types.js';
+/**
+ * Dispatch all warden rule trails for a given file and collect diagnostics.
+ *
+ * Each rule trail runs independently. Errors from individual trails are
+ * silently skipped so that one broken rule does not block the rest.
+ */
+export declare const runWardenTrails: (filePath: string, sourceCode: string, options?: {
+    readonly knownTrailIds?: readonly string[];
+}) => Promise<readonly WardenDiagnostic[]>;
+//# sourceMappingURL=run.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/trails/run.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAI1D;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAC1B,UAAU,MAAM,EAChB,YAAY,MAAM,EAClB,UAAU;IAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,KACvD,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAiBrC,CAAC"}

package/dist/trails/run.js

@@ -0,0 +1,30 @@
+/**
+ * Run all warden rule trails against a single source file.
+ *
+ * Returns a flat array of diagnostics from every rule.
+ */
+import { dispatch } from '@ontrails/core';
+import { wardenTopo } from './topo.js';
+/**
+ * Dispatch all warden rule trails for a given file and collect diagnostics.
+ *
+ * Each rule trail runs independently. Errors from individual trails are
+ * silently skipped so that one broken rule does not block the rest.
+ */
+export const runWardenTrails = async (filePath, sourceCode, options) => {
+    const allDiagnostics = [];
+    for (const id of wardenTopo.ids()) {
+        const input = options?.knownTrailIds
+            ? { filePath, knownTrailIds: options.knownTrailIds, sourceCode }
+            : { filePath, sourceCode };
+        const result = await dispatch(wardenTopo, id, input);
+        if (result.isOk()) {
+            const { diagnostics } = result.value;
+            for (const d of diagnostics) {
+                allDiagnostics.push(d);
+            }
+        }
+    }
+    return allDiagnostics;
+};
+//# sourceMappingURL=run.js.map

package/dist/trails/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/trails/run.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI1C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAClC,QAAgB,EAChB,UAAkB,EAClB,OAAwD,EAClB,EAAE;IACxC,MAAM,cAAc,GAAuB,EAAE,CAAC;IAE9C,KAAK,MAAM,EAAE,IAAI,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,OAAO,EAAE,aAAa;YAClC,CAAC,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,UAAU,EAAE;YAChE,CAAC,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;QACrD,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YAClB,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,KAAmB,CAAC;YACnD,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;gBAC5B,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,cAAc,CAAC;AACxB,CAAC,CAAC"}