@ontrails/warden 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 105ms on 30 files with 93 rules using 24 threads.

package/.turbo/turbo-typecheck.log

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

package/CHANGELOG.md

@@ -0,0 +1,21 @@
+# @ontrails/warden
+
+## 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
+  - @ontrails/schema@1.0.0-beta.0

package/README.md

@@ -0,0 +1,132 @@
+# @ontrails/warden
+
+Governance and contract enforcement for Trails. Lint rules that keep agents (and humans) on trails, surface lock drift detection, and a CLI runner for CI gating.
+
+## Installation
+
+```bash
+bun add -d @ontrails/warden
+```
+
+Peer dependencies: `@ontrails/core`, `@ontrails/schema`.
+
+## Quick Start
+
+From the Trails CLI:
+
+```bash
+trails warden              # Run all checks
+trails warden --exit-code  # Non-zero exit on errors or drift
+trails warden --lint-only  # Skip drift detection
+trails warden --drift-only # Skip lint rules
+```
+
+Or programmatically:
+
+```typescript
+import { runWarden, formatWardenReport } from '@ontrails/warden';
+
+const report = await runWarden(app, { exitCode: true });
+console.log(formatWardenReport(report));
+```
+
+## Lint Rules
+
+10 built-in rules under the `trails/` namespace:
+
+| Rule | Severity | What it catches |
+| --- | --- | --- |
+| `no-throw-in-implementation` | error | `throw` statements inside `implementation` bodies |
+| `context-no-surface-types` | error | Surface-specific type imports in trail files |
+| `prefer-schema-inference` | warn | `fields` overrides that only repeat schema-derived labels or enum options |
+| `valid-describe-refs` | warn | `@see` references inside `.describe()` strings that do not resolve |
+| `valid-detour-refs` | error | Detour targets that do not exist in the topo |
+| `no-direct-implementation-call` | warn | Direct `.implementation()` calls in application code |
+| `no-sync-result-assumption` | error | Missing `await` on `.implementation()` results |
+| `implementation-returns-result` | error | Implementations that return raw values instead of `Result` |
+| `no-throw-in-detour-target` | error | `throw` inside trails that serve as detour targets |
+| `no-direct-impl-in-route` | warn | Direct `.implementation()` calls inside hike bodies |
+
+Several structural checks (follows existence, recursive follows, event origins, example schema validation, output schema presence) are handled by `validateTopo()` in `@ontrails/core`. Follows coverage (matching `follows` declarations to actual `ctx.follow()` calls) is verified by `testExamples()` in `@ontrails/testing`.
+
+### Configuration
+
+Add to `.oxlintrc.json`:
+
+```json
+{
+  "plugins": ["trails"],
+  "rules": {
+    "trails/no-throw-in-implementation": "error",
+    "trails/context-no-surface-types": "error",
+    "trails/valid-describe-refs": "warn",
+    "trails/valid-detour-refs": "error",
+    "trails/no-sync-result-assumption": "error",
+    "trails/implementation-returns-result": "error",
+    "trails/no-throw-in-detour-target": "error",
+    "trails/no-direct-implementation-call": "warn",
+    "trails/no-direct-impl-in-route": "warn",
+    "trails/prefer-schema-inference": "warn"
+  }
+}
+```
+
+### Key Rules
+
+**`no-throw-in-implementation`** -- Implementations return `Result.err()`, never `throw`. Flags `ThrowStatement` nodes inside `implementation` function bodies.
+
+**`context-no-surface-types`** -- Implementations are pure functions. Importing `Request`, `Response`, `McpSession`, or other surface types couples domain logic to a transport.
+
+**`prefer-schema-inference`** -- `fields` is for enrichment, not repetition. If a label or enum options are already derivable from the Zod schema, remove the redundant override and let `derive()` supply it.
+
+**`no-direct-implementation-call`** -- Direct `.implementation()` calls bypass validation, tracing, and layers. Application code should use `ctx.follow()` instead.
+
+**`no-sync-result-assumption`** -- Trail implementations normalize to `Promise<Result>`, even when the author wrote a sync body. Callers must `await` before using `.isOk()`, `.value`, or other `Result` APIs.
+
+**`valid-describe-refs`** -- `@see` tags inside schema `.describe()` strings are part of the contract surface. Warden warns when those references drift away from the actual topo.
+
+## Drift Detection
+
+Warden integrates with `@ontrails/schema` to detect when the topo has changed without updating `surface.lock`:
+
+```typescript
+import { checkDrift } from '@ontrails/warden';
+
+const drift = await checkDrift(app);
+if (drift.stale) {
+  console.log(
+    'surface.lock is stale -- regenerate with `trails survey generate`'
+  );
+}
+```
+
+The check regenerates the surface map, hashes it, and compares against the committed `surface.lock`.
+
+## CI Integration
+
+Add to lefthook for pre-push enforcement:
+
+```yaml
+# lefthook.yml
+pre-push:
+  commands:
+    warden:
+      run: trails warden --exit-code
+      tags: governance
+```
+
+## API
+
+```typescript
+import {
+  runWarden,
+  formatWardenReport,
+  checkDrift,
+  wardenRules,
+} from '@ontrails/warden';
+```
+
+## Further Reading
+
+- [Architecture](../../docs/architecture.md)
+- [Testing Guide](../../docs/testing.md)

package/dist/cli.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Warden CLI command runner.
+ *
+ * Scans TypeScript files, runs all warden rules, optionally checks drift,
+ * and returns a structured report.
+ */
+import type { Topo } from '@ontrails/core';
+import type { DriftResult } from './drift.js';
+import type { WardenDiagnostic } from './rules/types.js';
+/**
+ * Options for the warden CLI runner.
+ */
+export interface WardenOptions {
+    /** Root directory to scan for TypeScript files. Defaults to cwd. */
+    readonly rootDir?: string | undefined;
+    /** Only run lint rules, skip drift detection */
+    readonly lintOnly?: boolean | undefined;
+    /** Only run drift detection, skip lint rules */
+    readonly driftOnly?: boolean | undefined;
+    /** App topology for drift detection. When provided, enables real surface lock comparison. */
+    readonly topo?: Topo | undefined;
+}
+/**
+ * Result of a warden run.
+ */
+export interface WardenReport {
+    /** All diagnostics from lint rules */
+    readonly diagnostics: readonly WardenDiagnostic[];
+    /** Count of error-severity diagnostics */
+    readonly errorCount: number;
+    /** Count of warn-severity diagnostics */
+    readonly warnCount: number;
+    /** Drift detection result, or null if skipped */
+    readonly drift: DriftResult | null;
+    /** Whether the warden run passed (no errors, no drift) */
+    readonly passed: boolean;
+}
+/**
+ * Run all warden checks and return a structured report.
+ */
+export declare const runWarden: (options?: WardenOptions) => Promise<WardenReport>;
+/**
+ * Format a warden report as a human-readable string.
+ */
+export declare const formatWardenReport: (report: WardenReport) => string;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAS9C,OAAO,KAAK,EAGV,gBAAgB,EAEjB,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACxC,gDAAgD;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACzC,6FAA6F;IAC7F,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,QAAQ,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAClD,0CAA0C;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IACnC,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAyLD;;GAEG;AACH,eAAO,MAAM,SAAS,GACpB,UAAS,aAAkB,KAC1B,OAAO,CAAC,YAAY,CAqBtB,CAAC;AAsDF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,YAAY,KAAG,MAmBzD,CAAC"}

package/dist/cli.js

@@ -0,0 +1,221 @@
+/**
+ * Warden CLI command runner.
+ *
+ * Scans TypeScript files, runs all warden rules, optionally checks drift,
+ * and returns a structured report.
+ */
+import { resolve } from 'node:path';
+import { checkDrift } from './drift.js';
+import { findConfigProperty, findTrailDefinitions, parse, walk, } from './rules/ast.js';
+import { wardenRules } from './rules/index.js';
+/**
+ * Collect all .ts files under a directory, excluding node_modules, dist, and .git.
+ */
+const isSourceFile = (match) => !match.endsWith('.d.ts') &&
+    !match.startsWith('node_modules/') &&
+    !match.startsWith('dist/') &&
+    !match.startsWith('.git/') &&
+    !match.includes('__tests__/') &&
+    !match.includes('__test__/') &&
+    !match.endsWith('.test.ts') &&
+    !match.endsWith('.spec.ts');
+const collectTsFiles = (dir) => {
+    const glob = new Bun.Glob('**/*.ts');
+    let matches;
+    try {
+        matches = glob.scanSync({ cwd: dir, dot: false, onlyFiles: true });
+    }
+    catch {
+        return [];
+    }
+    const files = [];
+    for (const match of matches) {
+        if (isSourceFile(match)) {
+            files.push(`${dir}/${match}`);
+        }
+    }
+    return files;
+};
+const collectKnownTrailIds = (sourceCode, filePath, knownTrailIds) => {
+    const ast = parse(filePath, sourceCode);
+    if (!ast) {
+        return;
+    }
+    for (const def of findTrailDefinitions(ast)) {
+        knownTrailIds.add(def.id);
+    }
+};
+const collectDetourTargetTrailIds = (sourceCode, filePath, detourTargetTrailIds) => {
+    const ast = parse(filePath, sourceCode);
+    if (!ast) {
+        return;
+    }
+    for (const def of findTrailDefinitions(ast)) {
+        const detoursProp = findConfigProperty(def.config, 'detours');
+        if (!detoursProp) {
+            continue;
+        }
+        // Walk the detours value for string literals that look like trail IDs
+        walk(detoursProp, (node) => {
+            if (node.type !== 'Literal') {
+                return;
+            }
+            const val = node.value;
+            if (val && val.includes('.')) {
+                detourTargetTrailIds.add(val);
+            }
+        });
+    }
+};
+const loadSourceFiles = async (rootDir) => {
+    const sourceFiles = [];
+    for (const filePath of collectTsFiles(rootDir)) {
+        try {
+            sourceFiles.push({
+                filePath,
+                sourceCode: await Bun.file(filePath).text(),
+            });
+        }
+        catch {
+            continue;
+        }
+    }
+    return sourceFiles;
+};
+const buildProjectContextFromTopo = (appTopo) => {
+    const knownTrailIds = new Set([
+        ...appTopo.trails.keys(),
+        ...appTopo.hikes.keys(),
+    ]);
+    const detourTargetTrailIds = new Set();
+    for (const t of appTopo.trails.values()) {
+        const detours = t['detours'];
+        if (!detours) {
+            continue;
+        }
+        for (const targets of Object.values(detours)) {
+            for (const id of targets) {
+                detourTargetTrailIds.add(id);
+            }
+        }
+    }
+    return { detourTargetTrailIds, knownTrailIds };
+};
+const buildProjectContextFromFiles = (sourceFiles) => {
+    const knownTrailIds = new Set();
+    const detourTargetTrailIds = new Set();
+    for (const sourceFile of sourceFiles) {
+        collectKnownTrailIds(sourceFile.sourceCode, sourceFile.filePath, knownTrailIds);
+        collectDetourTargetTrailIds(sourceFile.sourceCode, sourceFile.filePath, detourTargetTrailIds);
+    }
+    return {
+        detourTargetTrailIds,
+        knownTrailIds,
+    };
+};
+const isProjectAwareRule = (rule) => 'checkWithContext' in rule;
+/**
+ * Lint all files against all warden rules.
+ */
+const lintFiles = async (rootDir, appTopo) => {
+    const allDiagnostics = [];
+    const sourceFiles = await loadSourceFiles(rootDir);
+    const context = appTopo
+        ? buildProjectContextFromTopo(appTopo)
+        : buildProjectContextFromFiles(sourceFiles);
+    for (const sourceFile of sourceFiles) {
+        for (const rule of wardenRules.values()) {
+            if (isProjectAwareRule(rule)) {
+                allDiagnostics.push(...rule.checkWithContext(sourceFile.sourceCode, sourceFile.filePath, context));
+                continue;
+            }
+            allDiagnostics.push(...rule.check(sourceFile.sourceCode, sourceFile.filePath));
+        }
+    }
+    return allDiagnostics;
+};
+/**
+ * Run all warden checks and return a structured report.
+ */
+export const runWarden = async (options = {}) => {
+    const rootDir = resolve(options.rootDir ?? process.cwd());
+    const allDiagnostics = options.driftOnly
+        ? []
+        : await lintFiles(rootDir, options.topo);
+    const drift = options.lintOnly
+        ? null
+        : await checkDrift(rootDir, options.topo);
+    const errorCount = allDiagnostics.filter((d) => d.severity === 'error').length;
+    const warnCount = allDiagnostics.filter((d) => d.severity === 'warn').length;
+    return {
+        diagnostics: allDiagnostics,
+        drift,
+        errorCount,
+        passed: errorCount === 0 && !(drift?.stale ?? false),
+        warnCount,
+    };
+};
+/**
+ * Format the lint section of the report.
+ */
+const formatLintSection = (report) => {
+    if (report.diagnostics.length === 0) {
+        return ['Lint: clean'];
+    }
+    const lines = [
+        `Lint: ${report.errorCount} errors, ${report.warnCount} warnings`,
+    ];
+    for (const d of report.diagnostics) {
+        const prefix = d.severity === 'error' ? 'ERROR' : 'WARN';
+        lines.push(`  ${d.filePath}:${String(d.line)}  [${prefix}] ${d.rule}  ${d.message}`);
+    }
+    return lines;
+};
+/**
+ * Format the drift section of the report.
+ */
+const formatDriftSection = (drift) => {
+    if (drift === null) {
+        return [];
+    }
+    const label = drift.stale
+        ? 'Drift: surface.lock is stale (regenerate with `trails survey generate`)'
+        : 'Drift: clean';
+    return [label, ''];
+};
+/**
+ * Format the result line.
+ */
+const formatResultLine = (report) => {
+    if (report.passed) {
+        return 'Result: PASS';
+    }
+    const parts = [];
+    if (report.errorCount > 0) {
+        parts.push(`${report.errorCount} errors`);
+    }
+    if (report.drift?.stale) {
+        parts.push('drift detected');
+    }
+    return `Result: FAIL (${parts.join(', ')})`;
+};
+/**
+ * Format a warden report as a human-readable string.
+ */
+export const formatWardenReport = (report) => {
+    const lintLines = formatLintSection(report);
+    const driftLines = formatDriftSection(report.drift);
+    if (lintLines.length === 0 && driftLines.length === 0) {
+        return ['Warden Report', '=============', '', 'No checks were run.'].join('\n');
+    }
+    return [
+        'Warden Report',
+        '=============',
+        '',
+        ...lintLines,
+        '',
+        ...driftLines,
+        formatResultLine(report),
+    ].join('\n');
+};
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/drift.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Surface lock drift detection.
+ *
+ * Compares the committed `surface.lock` hash against a freshly generated
+ * surface map hash to detect when the trail topology has changed without
+ * updating the lock file.
+ */
+import type { Topo } from '@ontrails/core';
+/**
+ * Result of a drift check comparing committed surface.lock against the current state.
+ */
+export interface DriftResult {
+    /** Whether the committed lock is out of date */
+    readonly stale: boolean;
+    /** Hash from the committed surface.lock file, or null if not found */
+    readonly committedHash: string | null;
+    /** Hash computed from the current trail topology */
+    readonly currentHash: string;
+}
+/**
+ * Check whether the committed surface.lock is stale compared to the current topology.
+ *
+ * When no topo is provided, returns a clean result (no drift detectable without runtime info).
+ */
+export declare const checkDrift: (rootDir: string, topo?: Topo | undefined) => Promise<DriftResult>;
+//# sourceMappingURL=drift.d.ts.map

package/dist/drift.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift.d.ts","sourceRoot":"","sources":["../src/drift.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAO3C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,sEAAsE;IACtE,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,oDAAoD;IACpD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU,GACrB,SAAS,MAAM,EACf,OAAO,IAAI,GAAG,SAAS,KACtB,OAAO,CAAC,WAAW,CAcrB,CAAC"}

package/dist/drift.js

@@ -0,0 +1,27 @@
+/**
+ * Surface lock drift detection.
+ *
+ * Compares the committed `surface.lock` hash against a freshly generated
+ * surface map hash to detect when the trail topology has changed without
+ * updating the lock file.
+ */
+import { generateSurfaceMap, hashSurfaceMap, readSurfaceLock, } from '@ontrails/schema';
+/**
+ * Check whether the committed surface.lock is stale compared to the current topology.
+ *
+ * When no topo is provided, returns a clean result (no drift detectable without runtime info).
+ */
+export const checkDrift = async (rootDir, topo) => {
+    if (!topo) {
+        return { committedHash: null, currentHash: 'unknown', stale: false };
+    }
+    const surfaceMap = generateSurfaceMap(topo);
+    const currentHash = hashSurfaceMap(surfaceMap);
+    const committedHash = await readSurfaceLock({ dir: rootDir });
+    return {
+        committedHash,
+        currentHash,
+        stale: committedHash !== null && committedHash !== currentHash,
+    };
+};
+//# sourceMappingURL=drift.js.map

package/dist/drift.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift.js","sourceRoot":"","sources":["../src/drift.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAc1B;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAC7B,OAAe,EACf,IAAuB,EACD,EAAE;IACxB,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IACvE,CAAC;IAED,MAAM,UAAU,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAC/C,MAAM,aAAa,GAAG,MAAM,eAAe,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;IAE9D,OAAO;QACL,aAAa;QACb,WAAW;QACX,KAAK,EAAE,aAAa,KAAK,IAAI,IAAI,aAAa,KAAK,WAAW;KAC/D,CAAC;AACJ,CAAC,CAAC"}

package/dist/formatters.d.ts

@@ -0,0 +1,29 @@
+/**
+ * CI-oriented formatters for warden reports.
+ *
+ * Each formatter takes a `WardenReport` and produces output suited to a
+ * specific CI environment: GitHub Actions annotations, structured JSON,
+ * or a concise markdown summary.
+ */
+import type { WardenReport } from './cli.js';
+/**
+ * Produce GitHub Actions workflow command annotations, one per diagnostic.
+ *
+ * Severity mapping: `error` to `::error`, `warn` to `::warning`.
+ * Drift staleness is emitted as a single `::error` annotation when detected.
+ */
+export declare const formatGitHubAnnotations: (report: WardenReport) => string;
+/**
+ * Produce a structured JSON string from the report.
+ *
+ * Includes a `summary` object with error, warning, and suggestion counts
+ * for easy consumption by downstream tooling.
+ */
+export declare const formatJson: (report: WardenReport) => string;
+/**
+ * Produce a concise markdown summary suitable for a GitHub job summary or PR comment.
+ *
+ * Groups diagnostics by severity and includes drift status when relevant.
+ */
+export declare const formatSummary: (report: WardenReport) => string;
+//# sourceMappingURL=formatters.d.ts.map

package/dist/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../src/formatters.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAS7C;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAAI,QAAQ,YAAY,KAAG,MAiB9D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ,YAAY,KAAG,MAiBjD,CAAC;AA6BF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,QAAQ,YAAY,KAAG,MAapD,CAAC"}

package/dist/formatters.js

@@ -0,0 +1,87 @@
+/**
+ * CI-oriented formatters for warden reports.
+ *
+ * Each formatter takes a `WardenReport` and produces output suited to a
+ * specific CI environment: GitHub Actions annotations, structured JSON,
+ * or a concise markdown summary.
+ */
+/** Map warden severity to GitHub Actions annotation level. */
+const ghLevel = {
+    error: 'error',
+    warn: 'warning',
+};
+/**
+ * Produce GitHub Actions workflow command annotations, one per diagnostic.
+ *
+ * Severity mapping: `error` to `::error`, `warn` to `::warning`.
+ * Drift staleness is emitted as a single `::error` annotation when detected.
+ */
+export const formatGitHubAnnotations = (report) => {
+    const lines = [];
+    for (const d of report.diagnostics) {
+        const level = ghLevel[d.severity];
+        lines.push(`::${level} file=${d.filePath},line=${String(d.line)}::${d.rule}: ${d.message}`);
+    }
+    if (report.drift?.stale) {
+        lines.push('::error::drift: surface.lock is stale (regenerate with `trails survey generate`)');
+    }
+    return lines.join('\n');
+};
+/**
+ * Produce a structured JSON string from the report.
+ *
+ * Includes a `summary` object with error, warning, and suggestion counts
+ * for easy consumption by downstream tooling.
+ */
+export const formatJson = (report) => {
+    const summary = {
+        errors: report.errorCount,
+        suggestions: 0,
+        warnings: report.warnCount,
+    };
+    return JSON.stringify({
+        diagnostics: report.diagnostics,
+        drift: report.drift,
+        passed: report.passed,
+        summary,
+    }, null, 2);
+};
+/** Format a diagnostic as a markdown list item. */
+const diagnosticLine = (d) => `- \`${d.filePath}:${String(d.line)}\` — ${d.rule}: ${d.message}`;
+/** Render a severity group as a headed markdown section, or empty array. */
+const severitySection = (heading, diagnostics) => {
+    if (diagnostics.length === 0) {
+        return [];
+    }
+    return ['', `### ${heading}`, ...diagnostics.map(diagnosticLine)];
+};
+/** Render a drift section if stale, otherwise empty array. */
+const driftSection = (drift) => {
+    if (!drift?.stale) {
+        return [];
+    }
+    return [
+        '',
+        '### Drift',
+        '- surface.lock is stale (regenerate with `trails survey generate`)',
+    ];
+};
+/**
+ * Produce a concise markdown summary suitable for a GitHub job summary or PR comment.
+ *
+ * Groups diagnostics by severity and includes drift status when relevant.
+ */
+export const formatSummary = (report) => {
+    const result = report.passed ? 'PASS' : 'FAIL';
+    const errors = report.diagnostics.filter((d) => d.severity === 'error');
+    const warnings = report.diagnostics.filter((d) => d.severity === 'warn');
+    return [
+        '## Warden Report',
+        '',
+        `**Result: ${result}** | ${String(report.errorCount)} errors, ${String(report.warnCount)} warnings`,
+        ...severitySection('Errors', errors),
+        ...severitySection('Warnings', warnings),
+        ...driftSection(report.drift),
+    ].join('\n');
+};
+//# sourceMappingURL=formatters.js.map

package/dist/formatters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.js","sourceRoot":"","sources":["../src/formatters.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,8DAA8D;AAC9D,MAAM,OAAO,GAAmC;IAC9C,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,SAAS;CAChB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,MAAoB,EAAU,EAAE;IACtE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAClC,KAAK,CAAC,IAAI,CACR,KAAK,KAAK,SAAS,CAAC,CAAC,QAAQ,SAAS,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAChF,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CACR,kFAAkF,CACnF,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAAoB,EAAU,EAAE;IACzD,MAAM,OAAO,GAAG;QACd,MAAM,EAAE,MAAM,CAAC,UAAU;QACzB,WAAW,EAAE,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC,SAAS;KAC3B,CAAC;IAEF,OAAO,IAAI,CAAC,SAAS,CACnB;QACE,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO;KACR,EACD,IAAI,EACJ,CAAC,CACF,CAAC;AACJ,CAAC,CAAC;AAEF,mDAAmD;AACnD,MAAM,cAAc,GAAG,CAAC,CAAsC,EAAU,EAAE,CACxE,OAAO,CAAC,CAAC,QAAQ,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;AAEpE,4EAA4E;AAC5E,MAAM,eAAe,GAAG,CACtB,OAAe,EACf,WAAwC,EACrB,EAAE;IACrB,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,CAAC,EAAE,EAAE,OAAO,OAAO,EAAE,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC;AACpE,CAAC,CAAC;AAEF,8DAA8D;AAC9D,MAAM,YAAY,GAAG,CAAC,KAA4B,EAAqB,EAAE;IACvE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC;QAClB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO;QACL,EAAE;QACF,WAAW;QACX,oEAAoE;KACrE,CAAC;AACJ,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAoB,EAAU,EAAE;IAC5D,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/C,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IACxE,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC;IAEzE,OAAO;QACL,kBAAkB;QAClB,EAAE;QACF,aAAa,MAAM,QAAQ,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,YAAY,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW;QACnG,GAAG,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC;QACpC,GAAG,eAAe,CAAC,UAAU,EAAE,QAAQ,CAAC;QACxC,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC;KAC9B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Warden - Governance package for Trails.
+ *
+ * Provides lint rules, drift detection, and a CLI runner to enforce
+ * contract-first discipline at development time.
+ *
+ * Package: `@ontrails/warden`
+ */
+export type { ProjectAwareWardenRule, ProjectContext, WardenDiagnostic, WardenRule, WardenSeverity, } from './rules/index.js';
+export { noThrowInImplementation } from './rules/no-throw-in-implementation.js';
+export { contextNoSurfaceTypes } from './rules/context-no-surface-types.js';
+export { validDetourRefs } from './rules/valid-detour-refs.js';
+export { noDirectImplInRoute } from './rules/no-direct-impl-in-route.js';
+export { noDirectImplementationCall } from './rules/no-direct-implementation-call.js';
+export { noSyncResultAssumption } from './rules/no-sync-result-assumption.js';
+export { implementationReturnsResult } from './rules/implementation-returns-result.js';
+export { noThrowInDetourTarget } from './rules/no-throw-in-detour-target.js';
+export { preferSchemaInference } from './rules/prefer-schema-inference.js';
+export { validDescribeRefs } from './rules/valid-describe-refs.js';
+export { wardenRules } from './rules/index.js';
+export type { WardenOptions, WardenReport } from './cli.js';
+export { formatWardenReport, runWarden } from './cli.js';
+export { formatGitHubAnnotations, formatJson, formatSummary, } from './formatters.js';
+export type { DriftResult } from './drift.js';
+export { checkDrift } from './drift.js';
+//# sourceMappingURL=index.d.ts.map