@ontrails/warden 1.0.0-beta.14 → 1.0.0-beta.16

package/dist/rules/cross-declarations.js

@@ -1,264 +0,0 @@
-/**
- * Validates that `ctx.cross()` calls match the declared `crosses` array.
- *
- * Statically analyzes trail `blaze` functions to find `ctx.cross('trailId', ...)`
- * calls and compares them against the `crosses: [...]` declaration in the trail
- * config. Reports errors for undeclared crossings and warnings for unused ones.
- */
-import { findConfigProperty, findBlazeBodies, findTrailDefinitions, offsetToLine, parse, walk, } from './ast.js';
-import { isTestFile } from './scan.js';
-// ---------------------------------------------------------------------------
-// Shared identifier helpers
-// ---------------------------------------------------------------------------
-/** Get the name of an Identifier node, or null. */
-const identifierName = (node) => {
-    if (node?.type !== 'Identifier') {
-        return null;
-    }
-    return node.name ?? null;
-};
-// ---------------------------------------------------------------------------
-// String literal helpers
-// ---------------------------------------------------------------------------
-/** Check if a node is a string literal (covers `StringLiteral` and `Literal` with string value). */
-const isStringLiteral = (node) => {
-    if (node.type === 'StringLiteral') {
-        return true;
-    }
-    if (node.type === 'Literal') {
-        return typeof node.value === 'string';
-    }
-    return false;
-};
-/** Extract the string value from a string literal node. */
-const getStringValue = (node) => {
-    const val = node.value;
-    return typeof val === 'string' ? val : null;
-};
-// ---------------------------------------------------------------------------
-// Const identifier resolution
-// ---------------------------------------------------------------------------
-/**
- * Best-effort resolution of `const NAME = 'value'` declarations via regex.
- *
- * Returns the string value if a simple `const <name> = '...'` or `"..."` is
- * found in the source. Returns null for anything more complex.
- */
-const resolveConstString = (name, sourceCode) => {
-    const pattern = new RegExp(`const\\s+${name}\\s*=\\s*(?:'([^']*)'|"([^"]*)")`);
-    const match = pattern.exec(sourceCode);
-    if (!match) {
-        return null;
-    }
-    return match[1] ?? match[2] ?? null;
-};
-/** Try to resolve an Identifier element to a string via const declaration. */
-const resolveIdentifierElement = (el, sourceCode) => {
-    const name = identifierName(el);
-    if (!name) {
-        return null;
-    }
-    return resolveConstString(name, sourceCode);
-};
-/** Resolve an array element to a static trail ID when possible. */
-const resolveCrossElementId = (element, sourceCode) => {
-    if (isStringLiteral(element)) {
-        return getStringValue(element);
-    }
-    if (element.type === 'Identifier') {
-        return resolveIdentifierElement(element, sourceCode);
-    }
-    return null;
-};
-// ---------------------------------------------------------------------------
-// Declared crossing extraction
-// ---------------------------------------------------------------------------
-/** Extract the ArrayExpression elements from a config's `crosses` property. */
-const getCrossElements = (config) => {
-    const crossesProp = findConfigProperty(config, 'crosses');
-    if (!crossesProp) {
-        return null;
-    }
-    const arrayNode = crossesProp.value;
-    if (!arrayNode || arrayNode.type !== 'ArrayExpression') {
-        return null;
-    }
-    const elements = arrayNode['elements'];
-    return elements ?? null;
-};
-/** Collect string IDs from array elements, resolving identifiers when possible. */
-const collectStringIds = (elements, sourceCode) => {
-    const ids = new Set();
-    for (const element of elements) {
-        const resolved = resolveCrossElementId(element, sourceCode);
-        if (resolved) {
-            ids.add(resolved);
-        }
-    }
-    return ids;
-};
-/** Extract string literal elements from a `crosses: [...]` array property. */
-const extractDeclaredCrosses = (config, sourceCode) => {
-    const elements = getCrossElements(config);
-    return elements ? collectStringIds(elements, sourceCode) : new Set();
-};
-// ---------------------------------------------------------------------------
-// Called crossing extraction — member expression helpers
-// ---------------------------------------------------------------------------
-const MEMBER_TYPES = new Set(['StaticMemberExpression', 'MemberExpression']);
-/** Extract object and property Identifier names from a MemberExpression. */
-const extractMemberPair = (callee) => {
-    if (!MEMBER_TYPES.has(callee.type)) {
-        return null;
-    }
-    const objName = identifierName(callee.object);
-    const propName = identifierName(callee.property);
-    return objName && propName ? { objName, propName } : null;
-};
-/** Extract the first argument string from a CallExpression's arguments list. */
-const extractFirstStringArg = (node) => {
-    const args = node['arguments'];
-    if (!args || args.length === 0) {
-        return null;
-    }
-    const [firstArg] = args;
-    if (!firstArg || !isStringLiteral(firstArg)) {
-        return null;
-    }
-    return getStringValue(firstArg);
-};
-/**
- * Extract the second parameter name from a blaze function node.
- *
- * Handles `(input, ctx) => ...`, `async (input, context) => ...`, and
- * `function(input, ctx) { ... }` forms.
- */
-const extractContextParamName = (blazeBody) => {
-    const params = blazeBody['params'];
-    if (!params || params.length < 2) {
-        return null;
-    }
-    return identifierName(params[1]);
-};
-/** Check if a callee is a member-style cross call: <ctxName>.cross(...). */
-const isMemberCrossCall = (callee, ctxNames) => {
-    const pair = extractMemberPair(callee);
-    return !!pair && ctxNames.has(pair.objName) && pair.propName === 'cross';
-};
-/**
- * Check if a node is a `<ctxName>.cross(...)` call and return the string trail ID.
- *
- * Also matches bare `cross(...)` calls from destructuring.
- */
-const extractCrossCallId = (node, ctxNames) => {
-    if (node.type !== 'CallExpression') {
-        return null;
-    }
-    const callee = node['callee'];
-    if (!callee) {
-        return null;
-    }
-    if (isMemberCrossCall(callee, ctxNames)) {
-        return extractFirstStringArg(node);
-    }
-    if (identifierName(callee) === 'cross') {
-        return extractFirstStringArg(node);
-    }
-    return null;
-};
-/** Build the set of context parameter names to match against. */
-const buildCtxNames = (body) => {
-    const ctxNames = new Set(['ctx', 'context']);
-    const paramName = extractContextParamName(body);
-    if (paramName) {
-        ctxNames.add(paramName);
-    }
-    return ctxNames;
-};
-/** Walk blaze bodies and collect all statically resolvable ctx.cross() trail IDs. */
-const extractCalledCrosses = (config) => {
-    const ids = new Set();
-    for (const body of findBlazeBodies(config)) {
-        const ctxNames = buildCtxNames(body);
-        walk(body, (node) => {
-            const id = extractCrossCallId(node, ctxNames);
-            if (id) {
-                ids.add(id);
-            }
-        });
-    }
-    return ids;
-};
-// ---------------------------------------------------------------------------
-// Diagnostic builders
-// ---------------------------------------------------------------------------
-const buildUndeclaredDiagnostic = (trailId, crossedId, filePath, line) => ({
-    filePath,
-    line,
-    message: `Trail "${trailId}": ctx.cross('${crossedId}') called but '${crossedId}' is not declared in crosses`,
-    rule: 'cross-declarations',
-    severity: 'error',
-});
-const buildUnusedDiagnostic = (trailId, crossedId, filePath, line) => ({
-    filePath,
-    line,
-    message: `Trail "${trailId}": '${crossedId}' declared in crosses but ctx.cross('${crossedId}') never called`,
-    rule: 'cross-declarations',
-    severity: 'warn',
-});
-// ---------------------------------------------------------------------------
-// Comparison
-// ---------------------------------------------------------------------------
-/** Emit error for each called ID not present in declared set. */
-const reportUndeclared = (called, declared, ctx, diagnostics) => {
-    for (const id of called) {
-        if (!declared.has(id)) {
-            diagnostics.push(buildUndeclaredDiagnostic(ctx.trailId, id, ctx.filePath, ctx.line));
-        }
-    }
-};
-/** Emit warning for each declared ID not present in called set. */
-const reportUnused = (declared, called, ctx, diagnostics) => {
-    for (const id of declared) {
-        if (!called.has(id)) {
-            diagnostics.push(buildUnusedDiagnostic(ctx.trailId, id, ctx.filePath, ctx.line));
-        }
-    }
-};
-const checkTrailDefinition = (def, filePath, sourceCode, diagnostics) => {
-    const declared = extractDeclaredCrosses(def.config, sourceCode);
-    const called = extractCalledCrosses(def.config);
-    if (declared.size === 0 && called.size === 0) {
-        return;
-    }
-    const line = offsetToLine(sourceCode, def.start);
-    const ctx = { filePath, line, trailId: def.id };
-    reportUndeclared(called, declared, ctx, diagnostics);
-    reportUnused(declared, called, ctx, diagnostics);
-};
-// ---------------------------------------------------------------------------
-// Rule
-// ---------------------------------------------------------------------------
-/**
- * Validates that `ctx.cross()` calls align with declared `crosses` arrays.
- */
-export const crossDeclarations = {
-    check(sourceCode, filePath) {
-        if (isTestFile(filePath)) {
-            return [];
-        }
-        const ast = parse(filePath, sourceCode);
-        if (!ast) {
-            return [];
-        }
-        const diagnostics = [];
-        for (const def of findTrailDefinitions(ast)) {
-            checkTrailDefinition(def, filePath, sourceCode, diagnostics);
-        }
-        return diagnostics;
-    },
-    description: 'Ensure ctx.cross() calls match the declared crosses array in trail definitions.',
-    name: 'cross-declarations',
-    severity: 'error',
-};
-//# sourceMappingURL=cross-declarations.js.map

package/dist/rules/cross-declarations.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cross-declarations.js","sourceRoot":"","sources":["../../src/rules/cross-declarations.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,YAAY,EACZ,KAAK,EACL,IAAI,GACL,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGvC,8EAA8E;AAC9E,4BAA4B;AAC5B,8EAA8E;AAE9E,mDAAmD;AACnD,MAAM,cAAc,GAAG,CAAC,IAAyB,EAAiB,EAAE;IAClE,IAAI,IAAI,EAAE,IAAI,KAAK,YAAY,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAQ,IAAqC,CAAC,IAAI,IAAI,IAAI,CAAC;AAC7D,CAAC,CAAC;AAEF,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E,oGAAoG;AACpG,MAAM,eAAe,GAAG,CAAC,IAAa,EAAW,EAAE;IACjD,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,OAAQ,IAAuC,CAAC,KAAK,KAAK,QAAQ,CAAC;IAC5E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,2DAA2D;AAC3D,MAAM,cAAc,GAAG,CAAC,IAAa,EAAiB,EAAE;IACtD,MAAM,GAAG,GAAI,IAAuC,CAAC,KAAK,CAAC;IAC3D,OAAO,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9C,CAAC,CAAC;AAEF,8EAA8E;AAC9E,8BAA8B;AAC9B,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,kBAAkB,GAAG,CACzB,IAAY,EACZ,UAAkB,EACH,EAAE;IACjB,MAAM,OAAO,GAAG,IAAI,MAAM,CACxB,YAAY,IAAI,kCAAkC,CACnD,CAAC;IACF,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AACtC,CAAC,CAAC;AAEF,8EAA8E;AAC9E,MAAM,wBAAwB,GAAG,CAC/B,EAAW,EACX,UAAkB,EACH,EAAE;IACjB,MAAM,IAAI,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC;IAChC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,kBAAkB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AAC9C,CAAC,CAAC;AAEF,mEAAmE;AACnE,MAAM,qBAAqB,GAAG,CAC5B,OAAgB,EAChB,UAAkB,EACH,EAAE;IACjB,IAAI,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAClC,OAAO,wBAAwB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,8EAA8E;AAC9E,+BAA+B;AAC/B,8EAA8E;AAE9E,+EAA+E;AAC/E,MAAM,gBAAgB,GAAG,CAAC,MAAe,EAA6B,EAAE;IACtE,MAAM,WAAW,GAAG,kBAAkB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC1D,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC;IACpC,IAAI,CAAC,SAAS,IAAK,SAAqB,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;QACpE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAI,SAAqB,CAAC,UAAU,CAErC,CAAC;IACd,OAAO,QAAQ,IAAI,IAAI,CAAC;AAC1B,CAAC,CAAC;AAEF,mFAAmF;AACnF,MAAM,gBAAgB,GAAG,CACvB,QAA4B,EAC5B,UAAkB,EACL,EAAE;IACf,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,qBAAqB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAC5D,IAAI,QAAQ,EAAE,CAAC;YACb,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAEF,8EAA8E;AAC9E,MAAM,sBAAsB,GAAG,CAC7B,MAAe,EACf,UAAkB,EACG,EAAE;IACvB,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC;AACvE,CAAC,CAAC;AAEF,8EAA8E;AAC9E,yDAAyD;AACzD,8EAA8E;AAE9E,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,wBAAwB,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAE7E,4EAA4E;AAC5E,MAAM,iBAAiB,GAAG,CACxB,MAAe,EAC+B,EAAE;IAChD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,cAAc,CAC3B,MAA0C,CAAC,MAAM,CACnD,CAAC;IACF,MAAM,QAAQ,GAAG,cAAc,CAC5B,MAA4C,CAAC,QAAQ,CACvD,CAAC;IAEF,OAAO,OAAO,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5D,CAAC,CAAC;AAEF,gFAAgF;AAChF,MAAM,qBAAqB,GAAG,CAAC,IAAa,EAAiB,EAAE;IAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAmC,CAAC;IACjE,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IACxB,IAAI,CAAC,QAAQ,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,cAAc,CAAC,QAAQ,CAAC,CAAC;AAClC,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,uBAAuB,GAAG,CAAC,SAAkB,EAAiB,EAAE;IACpE,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAmC,CAAC;IACrE,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AACnC,CAAC,CAAC;AAEF,4EAA4E;AAC5E,MAAM,iBAAiB,GAAG,CACxB,MAAe,EACf,QAA6B,EACpB,EAAE;IACX,MAAM,IAAI,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACvC,OAAO,CAAC,CAAC,IAAI,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,KAAK,OAAO,CAAC;AAC3E,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,kBAAkB,GAAG,CACzB,IAAa,EACb,QAA6B,EACd,EAAE;IACjB,IAAI,IAAI,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAwB,CAAC;IACrD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;QACxC,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,cAAc,CAAC,MAAM,CAAC,KAAK,OAAO,EAAE,CAAC;QACvC,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,iEAAiE;AACjE,MAAM,aAAa,GAAG,CAAC,IAAa,EAAuB,EAAE;IAC3D,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,SAAS,EAAE,CAAC;QACd,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEF,qFAAqF;AACrF,MAAM,oBAAoB,GAAG,CAAC,MAAe,EAAuB,EAAE;IACpE,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAE9B,KAAK,MAAM,IAAI,IAAI,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3C,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAErC,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;YAClB,MAAM,EAAE,GAAG,kBAAkB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC9C,IAAI,EAAE,EAAE,CAAC;gBACP,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACd,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAEF,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,MAAM,yBAAyB,GAAG,CAChC,OAAe,EACf,SAAiB,EACjB,QAAgB,EAChB,IAAY,EACM,EAAE,CAAC,CAAC;IACtB,QAAQ;IACR,IAAI;IACJ,OAAO,EAAE,UAAU,OAAO,iBAAiB,SAAS,kBAAkB,SAAS,8BAA8B;IAC7G,IAAI,EAAE,oBAAoB;IAC1B,QAAQ,EAAE,OAAO;CAClB,CAAC,CAAC;AAEH,MAAM,qBAAqB,GAAG,CAC5B,OAAe,EACf,SAAiB,EACjB,QAAgB,EAChB,IAAY,EACM,EAAE,CAAC,CAAC;IACtB,QAAQ;IACR,IAAI;IACJ,OAAO,EAAE,UAAU,OAAO,OAAO,SAAS,wCAAwC,SAAS,iBAAiB;IAC5G,IAAI,EAAE,oBAAoB;IAC1B,QAAQ,EAAE,MAAM;CACjB,CAAC,CAAC;AAEH,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E,iEAAiE;AACjE,MAAM,gBAAgB,GAAG,CACvB,MAA2B,EAC3B,QAA6B,EAC7B,GAAwD,EACxD,WAA+B,EACzB,EAAE;IACR,KAAK,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;QACxB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACtB,WAAW,CAAC,IAAI,CACd,yBAAyB,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,CACnE,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAEF,mEAAmE;AACnE,MAAM,YAAY,GAAG,CACnB,QAA6B,EAC7B,MAA2B,EAC3B,GAAwD,EACxD,WAA+B,EACzB,EAAE;IACR,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC1B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACpB,WAAW,CAAC,IAAI,CACd,qBAAqB,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,CAC/D,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAC3B,GAAmD,EACnD,QAAgB,EAChB,UAAkB,EAClB,WAA+B,EACzB,EAAE;IACR,MAAM,QAAQ,GAAG,sBAAsB,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAChE,MAAM,MAAM,GAAG,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAEhD,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAC7C,OAAO;IACT,CAAC;IAED,MAAM,IAAI,GAAG,YAAY,CAAC,UAAU,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC;IAEhD,gBAAgB,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;IACrD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;AACnD,CAAC,CAAC;AAEF,8EAA8E;AAC9E,OAAO;AACP,8EAA8E;AAE9E;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAe;IAC3C,KAAK,CAAC,UAAkB,EAAE,QAAgB;QACxC,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QACxC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,WAAW,GAAuB,EAAE,CAAC;QAE3C,KAAK,MAAM,GAAG,IAAI,oBAAoB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5C,oBAAoB,CAAC,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;QAC/D,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,WAAW,EACT,iFAAiF;IACnF,IAAI,EAAE,oBAAoB;IAC1B,QAAQ,EAAE,OAAO;CAClB,CAAC"}

package/dist/rules/draft-file-marking.d.ts

@@ -1,6 +0,0 @@
-import type { WardenRule } from './types.js';
-/**
- * Ensures files containing draft ids are visibly marked as draft-bearing files.
- */
-export declare const draftFileMarking: WardenRule;
-//# sourceMappingURL=draft-file-marking.d.ts.map

package/dist/rules/draft-file-marking.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"draft-file-marking.d.ts","sourceRoot":"","sources":["../../src/rules/draft-file-marking.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAoB,UAAU,EAAE,MAAM,YAAY,CAAC;AA2F/D;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,UAa9B,CAAC"}

package/dist/rules/draft-file-marking.js

@@ -1,65 +0,0 @@
-import { isDraftId } from '@ontrails/core';
-import { isDraftMarkedFile } from '../draft.js';
-import { findStringLiterals, offsetToLine, parse } from './ast.js';
-const messageForMissingMarker = (draftId) => `Draft id "${draftId}" appears in source, but the file is not draft-marked. ` +
-    'Rename it with an _draft. prefix or a .draft. trailing segment.';
-const makeDiagnostic = (sourceCode, filePath, start, message, severity) => ({
-    filePath,
-    line: offsetToLine(sourceCode, start),
-    message,
-    rule: 'draft-file-marking',
-    severity,
-});
-const draftMissingMarkerDiagnostic = (sourceCode, filePath, ast) => {
-    const draftMatches = findStringLiterals(ast, (value) => isDraftId(value));
-    if (!draftMatches.length || isDraftMarkedFile(filePath)) {
-        return null;
-    }
-    const [first] = draftMatches;
-    if (!first) {
-        return null;
-    }
-    return makeDiagnostic(sourceCode, filePath, first.start, messageForMissingMarker(first.value), 'error');
-};
-const draftMarkedWithoutIdsDiagnostic = (filePath, ast) => {
-    if (findStringLiterals(ast, (value) => isDraftId(value)).length > 0) {
-        return null;
-    }
-    if (!isDraftMarkedFile(filePath)) {
-        return null;
-    }
-    return {
-        filePath,
-        line: 1,
-        message: 'File is draft-marked but no longer contains draft ids. Remove the draft filename marker or finish the promotion cleanup.',
-        rule: 'draft-file-marking',
-        severity: 'warn',
-    };
-};
-const collectDraftFileMarkingDiagnostics = (sourceCode, filePath, ast) => {
-    const missingMarkerDiagnostic = draftMissingMarkerDiagnostic(sourceCode, filePath, ast);
-    if (missingMarkerDiagnostic) {
-        return [missingMarkerDiagnostic];
-    }
-    const markedWithoutIdsDiagnostic = draftMarkedWithoutIdsDiagnostic(filePath, ast);
-    if (markedWithoutIdsDiagnostic) {
-        return [markedWithoutIdsDiagnostic];
-    }
-    return [];
-};
-/**
- * Ensures files containing draft ids are visibly marked as draft-bearing files.
- */
-export const draftFileMarking = {
-    check(sourceCode, filePath) {
-        const ast = parse(filePath, sourceCode);
-        if (!ast) {
-            return [];
-        }
-        return collectDraftFileMarkingDiagnostics(sourceCode, filePath, ast);
-    },
-    description: 'Require draft-bearing files to use _draft.* or *.draft.* filename markers.',
-    name: 'draft-file-marking',
-    severity: 'error',
-};
-//# sourceMappingURL=draft-file-marking.js.map

package/dist/rules/draft-file-marking.js.map

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

package/dist/rules/draft-visible-debt.d.ts

@@ -1,12 +0,0 @@
-import type { WardenRule } from './types.js';
-/**
- * Warns when draft ids are still present so the debt stays visible during
- * review even when the file is correctly marked.
- *
- * Severity is intentionally `warn`, not `error`. The hard rejection gate for
- * draft state leaking into established outputs is `validateEstablishedTopo` at
- * runtime — it blocks topo export, trailhead projection, and lockfile writes.
- * This rule surfaces the debt for human reviewers without duplicating that gate.
- */
-export declare const draftVisibleDebt: WardenRule;
-//# sourceMappingURL=draft-visible-debt.d.ts.map

package/dist/rules/draft-visible-debt.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"draft-visible-debt.d.ts","sourceRoot":"","sources":["../../src/rules/draft-visible-debt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAoB,UAAU,EAAE,MAAM,YAAY,CAAC;AAoC/D;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,EAAE,UAa9B,CAAC"}

package/dist/rules/draft-visible-debt.js

@@ -1,45 +0,0 @@
-import { isDraftId } from '@ontrails/core';
-import { findStringLiterals, offsetToLine, parse } from './ast.js';
-const createDiagnostic = (sourceCode, filePath, match) => ({
-    filePath,
-    line: offsetToLine(sourceCode, match.start),
-    message: `Draft id "${match.value}" is still visible debt. ` +
-        'Established trailheads, lock export, and OpenAPI generation will reject it until it is promoted.',
-    rule: 'draft-visible-debt',
-    severity: 'warn',
-});
-const collectDraftVisibleDebtDiagnostics = (sourceCode, filePath, ast) => {
-    const seen = new Set();
-    const diagnostics = [];
-    for (const match of findStringLiterals(ast, (value) => isDraftId(value))) {
-        const key = `${match.value}:${String(match.start)}`;
-        if (seen.has(key)) {
-            continue;
-        }
-        seen.add(key);
-        diagnostics.push(createDiagnostic(sourceCode, filePath, match));
-    }
-    return diagnostics;
-};
-/**
- * Warns when draft ids are still present so the debt stays visible during
- * review even when the file is correctly marked.
- *
- * Severity is intentionally `warn`, not `error`. The hard rejection gate for
- * draft state leaking into established outputs is `validateEstablishedTopo` at
- * runtime — it blocks topo export, trailhead projection, and lockfile writes.
- * This rule surfaces the debt for human reviewers without duplicating that gate.
- */
-export const draftVisibleDebt = {
-    check(sourceCode, filePath) {
-        const ast = parse(filePath, sourceCode);
-        if (!ast) {
-            return [];
-        }
-        return collectDraftVisibleDebtDiagnostics(sourceCode, filePath, ast);
-    },
-    description: 'Warn when draft ids remain in source so the debt stays visible during review.',
-    name: 'draft-visible-debt',
-    severity: 'warn',
-};
-//# sourceMappingURL=draft-visible-debt.js.map

package/dist/rules/draft-visible-debt.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"draft-visible-debt.js","sourceRoot":"","sources":["../../src/rules/draft-visible-debt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAGnE,MAAM,gBAAgB,GAAG,CACvB,UAAkB,EAClB,QAAgB,EAChB,KAAuC,EACrB,EAAE,CAAC,CAAC;IACtB,QAAQ;IACR,IAAI,EAAE,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC;IAC3C,OAAO,EACL,aAAa,KAAK,CAAC,KAAK,2BAA2B;QACnD,kGAAkG;IACpG,IAAI,EAAE,oBAAoB;IAC1B,QAAQ,EAAE,MAAM;CACjB,CAAC,CAAC;AAEH,MAAM,kCAAkC,GAAG,CACzC,UAAkB,EAClB,QAAgB,EAChB,GAA0C,EACtB,EAAE;IACtB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,WAAW,GAAuB,EAAE,CAAC;IAE3C,KAAK,MAAM,KAAK,IAAI,kBAAkB,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QACzE,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAClB,SAAS;QACX,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,WAAW,CAAC,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAe;IAC1C,KAAK,CAAC,UAAkB,EAAE,QAAgB;QACxC,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QACxC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,kCAAkC,CAAC,UAAU,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;IACvE,CAAC;IACD,WAAW,EACT,+EAA+E;IACjF,IAAI,EAAE,oBAAoB;IAC1B,QAAQ,EAAE,MAAM;CACjB,CAAC"}

package/dist/rules/follow-declarations.d.ts

@@ -1,13 +0,0 @@
-/**
- * Validates that `ctx.follow()` calls match the declared `follow` array.
- *
- * Statically analyzes trail `blaze` functions to find `ctx.follow('trailId', ...)`
- * calls and compares them against the `follow: [...]` declaration in the trail
- * config. Reports errors for undeclared follows and warnings for unused ones.
- */
-import type { WardenRule } from './types.js';
-/**
- * Validates that `ctx.follow()` calls align with declared `follow` arrays.
- */
-export declare const followDeclarations: WardenRule;
-//# sourceMappingURL=follow-declarations.d.ts.map

package/dist/rules/follow-declarations.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"follow-declarations.d.ts","sourceRoot":"","sources":["../../src/rules/follow-declarations.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,OAAO,KAAK,EAAoB,UAAU,EAAE,MAAM,YAAY,CAAC;AA+U/D;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,UAuBhC,CAAC"}