@ontrails/warden 1.0.0-beta.2 → 1.0.0-beta.22

package/dist/formatters.js

@@ -1,87 +0,0 @@
-/**
- * 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

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

package/dist/index.d.ts

@@ -1,26 +0,0 @@
-/**
- * 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

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"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"}

package/dist/index.js

@@ -1,26 +0,0 @@
-/**
- * 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`
- */
-// Individual rules
-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';
-// Rule registry
-export { wardenRules } from './rules/index.js';
-export { formatWardenReport, runWarden } from './cli.js';
-// CI formatters
-export { formatGitHubAnnotations, formatJson, formatSummary, } from './formatters.js';
-export { checkDrift } from './drift.js';
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"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"}

package/dist/rules/ast.d.ts

@@ -1,41 +0,0 @@
-/**
- * Shared AST utilities for warden rules.
- *
- * Uses oxc-parser for native-speed TypeScript parsing. Provides a lightweight
- * walker and helpers for finding trail implementation bodies.
- */
-export interface AstNode {
-    readonly type: string;
-    readonly start: number;
-    readonly end: number;
-    readonly key?: {
-        readonly name?: string;
-    };
-    readonly value?: AstNode;
-    readonly body?: AstNode | readonly AstNode[];
-    readonly [key: string]: unknown;
-}
-/** Parse TypeScript source into an AST. Returns null on parse failure. */
-export declare const parse: (filePath: string, sourceCode: string) => AstNode | null;
-/** Walk an AST node tree, calling `visit` on every node. */
-export declare const walk: (node: unknown, visit: (node: AstNode) => void) => void;
-/** Find the byte offset's line number (1-based) in source code. */
-export declare const offsetToLine: (sourceCode: string, offset: number) => number;
-/** Find all `implementation:` property values in an AST. */
-export declare const findImplementationBodies: (ast: AstNode) => AstNode[];
-export interface TrailDefinition {
-    /** Trail ID string, e.g. "entity.show" */
-    readonly id: string;
-    /** "trail" or "hike" */
-    readonly kind: string;
-    /** The config object argument (second arg to trail/hike call) */
-    readonly config: AstNode;
-    /** Start offset of the call expression */
-    readonly start: number;
-}
-/** Check if a node is a call to `.implementation()` on some object. */
-export declare const isImplementationCall: (node: AstNode) => boolean;
-export declare const findTrailDefinitions: (ast: AstNode) => TrailDefinition[];
-/** Find a Property node by key name inside an ObjectExpression config. */
-export declare const findConfigProperty: (config: AstNode, propertyName: string) => AstNode | null;
-//# sourceMappingURL=ast.d.ts.map

package/dist/rules/ast.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ast.d.ts","sourceRoot":"","sources":["../../src/rules/ast.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,OAAO,EAAE,CAAC;IAC7C,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAMD,0EAA0E;AAC1E,eAAO,MAAM,KAAK,GAAI,UAAU,MAAM,EAAE,YAAY,MAAM,KAAG,OAAO,GAAG,IAOtE,CAAC;AAMF,4DAA4D;AAC5D,eAAO,MAAM,IAAI,GAAI,MAAM,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,KAAG,IAiBpE,CAAC;AAMF,mEAAmE;AACnE,eAAO,MAAM,YAAY,GAAI,YAAY,MAAM,EAAE,QAAQ,MAAM,KAAG,MAQjE,CAAC;AAEF,4DAA4D;AAC5D,eAAO,MAAM,wBAAwB,GAAI,KAAK,OAAO,KAAG,OAAO,EAY9D,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AA2DD,uEAAuE;AACvE,eAAO,MAAM,oBAAoB,GAAI,MAAM,OAAO,KAAG,OAmBpD,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,KAAK,OAAO,KAAG,eAAe,EAWlE,CAAC;AAMF,0EAA0E;AAC1E,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,OAAO,EACf,cAAc,MAAM,KACnB,OAAO,GAAG,IAcZ,CAAC"}

package/dist/rules/ast.js

@@ -1,163 +0,0 @@
-/**
- * Shared AST utilities for warden rules.
- *
- * Uses oxc-parser for native-speed TypeScript parsing. Provides a lightweight
- * walker and helpers for finding trail implementation bodies.
- */
-import { parseSync } from 'oxc-parser';
-// ---------------------------------------------------------------------------
-// Parser
-// ---------------------------------------------------------------------------
-/** Parse TypeScript source into an AST. Returns null on parse failure. */
-export const parse = (filePath, sourceCode) => {
-    try {
-        const result = parseSync(filePath, sourceCode, { sourceType: 'module' });
-        return result.program;
-    }
-    catch {
-        return null;
-    }
-};
-// ---------------------------------------------------------------------------
-// Walker
-// ---------------------------------------------------------------------------
-/** Walk an AST node tree, calling `visit` on every node. */
-export const walk = (node, visit) => {
-    if (!node || typeof node !== 'object') {
-        return;
-    }
-    const n = node;
-    if (n.type) {
-        visit(n);
-    }
-    for (const val of Object.values(n)) {
-        if (Array.isArray(val)) {
-            for (const item of val) {
-                walk(item, visit);
-            }
-        }
-        else if (val && typeof val === 'object' && val.type) {
-            walk(val, visit);
-        }
-    }
-};
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-/** Find the byte offset's line number (1-based) in source code. */
-export const offsetToLine = (sourceCode, offset) => {
-    let line = 1;
-    for (let i = 0; i < offset && i < sourceCode.length; i += 1) {
-        if (sourceCode[i] === '\n') {
-            line += 1;
-        }
-    }
-    return line;
-};
-/** Find all `implementation:` property values in an AST. */
-export const findImplementationBodies = (ast) => {
-    const bodies = [];
-    walk(ast, (node) => {
-        if (node.type === 'Property' &&
-            node.key?.name === 'implementation' &&
-            node.value) {
-            bodies.push(node.value);
-        }
-    });
-    return bodies;
-};
-/**
- * Find all `trail("id", { ... })` and `hike("id", { ... })` call sites.
- *
- * Returns the trail ID, kind, and config object node for each definition.
- */
-const TRAIL_CALLEE_NAMES = new Set(['trail', 'hike']);
-const getTrailCalleeName = (node) => {
-    if (node.type !== 'CallExpression') {
-        return null;
-    }
-    const callee = node['callee'];
-    if (!callee || callee.type !== 'Identifier') {
-        return null;
-    }
-    const { name } = callee;
-    return name && TRAIL_CALLEE_NAMES.has(name) ? name : null;
-};
-const extractTrailArgs = (node) => {
-    const args = node['arguments'];
-    if (!args || args.length < 2) {
-        return null;
-    }
-    const [idArg, configArg] = args;
-    if (!idArg || !configArg) {
-        return null;
-    }
-    return { configArg, idArg };
-};
-const extractTrailDefinition = (node) => {
-    const calleeName = getTrailCalleeName(node);
-    if (!calleeName) {
-        return null;
-    }
-    const trailArgs = extractTrailArgs(node);
-    if (!trailArgs) {
-        return null;
-    }
-    const trailId = trailArgs.idArg.value;
-    if (!trailId) {
-        return null;
-    }
-    return {
-        config: trailArgs.configArg,
-        id: trailId,
-        kind: calleeName,
-        start: node.start,
-    };
-};
-/** Check if a node is a call to `.implementation()` on some object. */
-export const isImplementationCall = (node) => {
-    if (node.type !== 'CallExpression') {
-        return false;
-    }
-    const callee = node['callee'];
-    if (!callee) {
-        return false;
-    }
-    if (callee.type !== 'StaticMemberExpression' &&
-        callee.type !== 'MemberExpression') {
-        return false;
-    }
-    const prop = callee.property;
-    return (prop?.type === 'Identifier' &&
-        prop.name === 'implementation');
-};
-export const findTrailDefinitions = (ast) => {
-    const definitions = [];
-    walk(ast, (node) => {
-        const def = extractTrailDefinition(node);
-        if (def) {
-            definitions.push(def);
-        }
-    });
-    return definitions;
-};
-// ---------------------------------------------------------------------------
-// Config property extraction helpers
-// ---------------------------------------------------------------------------
-/** Find a Property node by key name inside an ObjectExpression config. */
-export const findConfigProperty = (config, propertyName) => {
-    if (config.type !== 'ObjectExpression') {
-        return null;
-    }
-    const properties = config['properties'];
-    if (!properties) {
-        return null;
-    }
-    for (const prop of properties) {
-        if (prop.type === 'Property' && prop.key?.name === propertyName) {
-            return prop;
-        }
-    }
-    return null;
-};
-//# sourceMappingURL=ast.js.map

package/dist/rules/ast.js.map

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

package/dist/rules/context-no-surface-types.d.ts

@@ -1,12 +0,0 @@
-/**
- * Detects imports of surface-specific modules and types in trail files.
- *
- * Uses AST parsing for accurate detection — no false positives from
- * imports in comments or strings.
- */
-import type { WardenRule } from './types.js';
-/**
- * Detects imports of surface-specific types in trail implementation files.
- */
-export declare const contextNoSurfaceTypes: WardenRule;
-//# sourceMappingURL=context-no-surface-types.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"context-no-surface-types.d.ts","sourceRoot":"","sources":["../../src/rules/context-no-surface-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAoB,UAAU,EAAE,MAAM,YAAY,CAAC;AAgH/D;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,UA0BnC,CAAC"}

package/dist/rules/context-no-surface-types.js

@@ -1,96 +0,0 @@
-/**
- * Detects imports of surface-specific modules and types in trail files.
- *
- * Uses AST parsing for accurate detection — no false positives from
- * imports in comments or strings.
- */
-import { offsetToLine, parse, walk } from './ast.js';
-const SURFACE_MODULES = new Set([
-    'express',
-    'hono',
-    'fastify',
-    '@modelcontextprotocol/sdk',
-    'node:http',
-    'node:https',
-    '@hono/node-server',
-    'koa',
-]);
-const SURFACE_TYPE_NAMES = new Set([
-    'Request',
-    'Response',
-    'NextFunction',
-    'McpSession',
-    'McpCallToolRequest',
-    'IncomingMessage',
-    'ServerResponse',
-]);
-const makeDiag = (filePath, sourceCode, node, message) => ({
-    filePath,
-    line: offsetToLine(sourceCode, node.start),
-    message,
-    rule: 'context-no-surface-types',
-    severity: 'error',
-});
-const findSurfaceTypeName = (specifiers) => {
-    for (const spec of specifiers) {
-        const name = spec.imported?.name ?? spec.local?.name;
-        if (name && SURFACE_TYPE_NAMES.has(name)) {
-            return name;
-        }
-    }
-    return undefined;
-};
-const getImportModuleName = (node) => {
-    if (node.type !== 'ImportDeclaration') {
-        return null;
-    }
-    const source = node['source'];
-    return source?.value ?? null;
-};
-const checkSpecifiersForSurfaceTypes = (node, filePath, sourceCode) => {
-    const specifiers = node['specifiers'];
-    if (!specifiers) {
-        return undefined;
-    }
-    const typeName = findSurfaceTypeName(specifiers);
-    if (!typeName) {
-        return undefined;
-    }
-    return makeDiag(filePath, sourceCode, node, `Do not import surface type "${typeName}" in trail implementation files.`);
-};
-const classifyImport = (node, filePath, sourceCode) => {
-    const moduleName = getImportModuleName(node);
-    if (!moduleName) {
-        return undefined;
-    }
-    if (SURFACE_MODULES.has(moduleName)) {
-        return makeDiag(filePath, sourceCode, node, `Do not import from surface module "${moduleName}" in trail implementation files.`);
-    }
-    return checkSpecifiersForSurfaceTypes(node, filePath, sourceCode);
-};
-/**
- * Detects imports of surface-specific types in trail implementation files.
- */
-export const contextNoSurfaceTypes = {
-    check(sourceCode, filePath) {
-        if (!/\b(?:trail|hike)\s*\(/.test(sourceCode)) {
-            return [];
-        }
-        const ast = parse(filePath, sourceCode);
-        if (!ast) {
-            return [];
-        }
-        const diagnostics = [];
-        walk(ast, (node) => {
-            const diag = classifyImport(node, filePath, sourceCode);
-            if (diag) {
-                diagnostics.push(diag);
-            }
-        });
-        return diagnostics;
-    },
-    description: 'Disallow surface-specific type imports (Request, Response, McpSession, etc.) in trail implementation files.',
-    name: 'context-no-surface-types',
-    severity: 'error',
-};
-//# sourceMappingURL=context-no-surface-types.js.map

package/dist/rules/context-no-surface-types.js.map

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

package/dist/rules/implementation-returns-result.d.ts

@@ -1,13 +0,0 @@
-/**
- * Finds implementations that return raw values instead of `Result`.
- *
- * Uses AST parsing to find `implementation:` bodies and check that
- * every return statement returns Result.ok(), Result.err(), ctx.follow(),
- * or a tracked Result-typed variable.
- */
-import type { WardenRule } from './types.js';
-/**
- * Finds implementations that return raw values instead of `Result`.
- */
-export declare const implementationReturnsResult: WardenRule;
-//# sourceMappingURL=implementation-returns-result.d.ts.map

package/dist/rules/implementation-returns-result.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"implementation-returns-result.d.ts","sourceRoot":"","sources":["../../src/rules/implementation-returns-result.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,OAAO,KAAK,EAAoB,UAAU,EAAE,MAAM,YAAY,CAAC;AAkT/D;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,UAiBzC,CAAC"}