@ontrails/warden 1.0.0-beta.13 → 1.0.0-beta.15

package/dist/rules/warden-export-symmetry.js

@@ -0,0 +1,352 @@
+/**
+ * Enforces ADR-0036: `@ontrails/warden` exposes only a trail-wrapper + registry
+ * surface. Raw rule objects stay internal to `./rules/`. The public barrel
+ * (`packages/warden/src/index.ts`) must:
+ *
+ *  1. Export a matching `*Trail` identifier for every entry in
+ *     `wardenRules` / `wardenTopoRules`.
+ *  2. Not expose a `*Trail` identifier with no matching registry entry.
+ *  3. Not re-export a raw rule object by its camelCased name.
+ *
+ * Properties 1 and 2 cannot be fully derived today because the registry holds
+ * raw `WardenRule` objects whose `.check()` methods are called by the trail
+ * wrappers; flipping the dependency (registry ← trails) would require unwrapping
+ * trails at dispatch time and is out of scope for TRL-341. Enforcement therefore
+ * lives as a lint rule keyed on the warden barrel file path.
+ */
+import { resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { walk, offsetToLine, parse } from './ast.js';
+import { registeredRuleNames } from './registry-names.js';
+const SELF_RULE_NAME = 'warden-export-symmetry';
+/**
+ * Absolute path to this package's own `src/index.ts`, resolved from the rule's
+ * own module URL. Anchoring to the real on-disk location prevents the rule
+ * from firing against a foreign `packages/warden/src/index.ts` in a consumer
+ * repository with the same folder structure — the rule would otherwise compare
+ * that unrelated barrel against `@ontrails/warden`'s internal registry and
+ * emit bogus missing/orphan diagnostics that break consumer CI.
+ */
+const SELF_BARREL_PATH = resolve(fileURLToPath(new URL('../index.ts', import.meta.url)));
+const isTargetFile = (filePath) => resolve(filePath) === SELF_BARREL_PATH;
+const kebabToCamel = (value) => value.replaceAll(/-([a-z0-9])/g, (_, char) => char.toUpperCase());
+const readIdentifierOrStringName = (node) => {
+    if (!node) {
+        return null;
+    }
+    if (node.type === 'Identifier') {
+        return node.name ?? null;
+    }
+    if (node.type === 'Literal' || node.type === 'StringLiteral') {
+        const { value } = node;
+        return typeof value === 'string' ? value : null;
+    }
+    return null;
+};
+const extractSpecifierNames = (specifier) => {
+    const { exported, local } = specifier;
+    const name = readIdentifierOrStringName(exported);
+    if (!name) {
+        return null;
+    }
+    const localName = readIdentifierOrStringName(local) ?? name;
+    return { localName, name };
+};
+const isTypeExportSpecifier = (specifier) => specifier.exportKind === 'type';
+const specifierSite = (specifier) => {
+    if (specifier.type !== 'ExportSpecifier' ||
+        isTypeExportSpecifier(specifier)) {
+        return null;
+    }
+    const names = extractSpecifierNames(specifier);
+    return names ? { ...names, start: specifier.start } : null;
+};
+const TYPE_ONLY_DECL_TYPES = new Set([
+    'TSTypeAliasDeclaration',
+    'TSInterfaceDeclaration',
+]);
+const namedSiteFromDeclId = (declId, start) => {
+    const name = readIdentifierOrStringName(declId);
+    return name ? { localName: name, name, start } : null;
+};
+/**
+ * Extract an identifier or `AssignmentPattern`'s left-hand identifier as a
+ * single export site. Returns null for anything else (nested patterns should
+ * be routed through `sitesFromPattern`).
+ */
+const siteFromSimpleBinding = (node, start) => {
+    if (!node) {
+        return null;
+    }
+    if (node.type === 'Identifier') {
+        const name = readIdentifierOrStringName(node);
+        return name ? { localName: name, name, start } : null;
+    }
+    if (node.type === 'AssignmentPattern') {
+        const { left } = node;
+        return left ? siteFromSimpleBinding(left, start) : null;
+    }
+    return null;
+};
+/**
+ * Compose a rename-pair site from an `ObjectPattern` property's `key` and a
+ * resolved value site. Rename pairs (`{ foo: bar }`) emit one site whose
+ * `localName` is the source binding `foo` and whose public `name` is the
+ * target `bar`, mirroring `extractSpecifierNames` for `export { foo as bar }`.
+ */
+const renamePairSite = (key, valueSite, start) => {
+    const keyName = readIdentifierOrStringName(key);
+    return {
+        localName: keyName ?? valueSite.localName,
+        name: valueSite.name,
+        start,
+    };
+};
+const isNestedPatternValue = (value) => !!value && value.type !== 'Identifier' && value.type !== 'AssignmentPattern';
+/**
+ * Extract sites from a single `ObjectPattern` property.
+ */
+const sitesFromObjectProperty = (prop, start, recurse) => {
+    if (prop.type === 'RestElement') {
+        const { argument } = prop;
+        return recurse(argument, start);
+    }
+    if (prop.type !== 'Property') {
+        return [];
+    }
+    const { key, value } = prop;
+    if (isNestedPatternValue(value)) {
+        return recurse(value, start);
+    }
+    const valueSite = siteFromSimpleBinding(value, start);
+    return valueSite ? [renamePairSite(key, valueSite, start)] : [];
+};
+const sitesFromArrayElement = (element, start, recurse) => {
+    if (!element) {
+        return [];
+    }
+    if (element.type === 'RestElement') {
+        const { argument } = element;
+        return recurse(argument, start);
+    }
+    return recurse(element, start);
+};
+const sitesFromObjectPattern = (pattern, start, recurse) => {
+    const properties = pattern.properties ??
+        [];
+    return properties.flatMap((prop) => sitesFromObjectProperty(prop, start, recurse));
+};
+const sitesFromArrayPattern = (pattern, start, recurse) => {
+    const elements = pattern
+        .elements ?? [];
+    return elements.flatMap((element) => sitesFromArrayElement(element, start, recurse));
+};
+/**
+ * Recursively extract export sites from a declarator id, supporting
+ * `ObjectPattern` and `ArrayPattern` destructuring. Without this, a
+ * destructured `export const { wardenExportSymmetry } = rulesModule` silently
+ * bypasses orphan-trail and raw-rule-leak checks because the id is not an
+ * `Identifier`.
+ */
+const sitesFromPattern = (pattern, start) => {
+    if (!pattern) {
+        return [];
+    }
+    const simple = siteFromSimpleBinding(pattern, start);
+    if (simple) {
+        return [simple];
+    }
+    if (pattern.type === 'ObjectPattern') {
+        return sitesFromObjectPattern(pattern, start, sitesFromPattern);
+    }
+    if (pattern.type === 'ArrayPattern') {
+        return sitesFromArrayPattern(pattern, start, sitesFromPattern);
+    }
+    return [];
+};
+const sitesForDeclaration = (declaration) => {
+    if (TYPE_ONLY_DECL_TYPES.has(declaration.type)) {
+        return [];
+    }
+    if (declaration.type === 'FunctionDeclaration' ||
+        declaration.type === 'ClassDeclaration') {
+        const { id } = declaration;
+        const site = namedSiteFromDeclId(id, declaration.start);
+        return site ? [site] : [];
+    }
+    if (declaration.type === 'VariableDeclaration') {
+        const declarations = declaration
+            .declarations ?? [];
+        return declarations.flatMap((declarator) => {
+            const { id } = declarator;
+            return sitesFromPattern(id, declarator.start);
+        });
+    }
+    return [];
+};
+const sitesForExportNode = (node) => {
+    if (node.type !== 'ExportNamedDeclaration') {
+        return [];
+    }
+    if (node.exportKind === 'type') {
+        return [];
+    }
+    const { declaration } = node;
+    if (declaration) {
+        return sitesForDeclaration(declaration);
+    }
+    const specifiers = node['specifiers'] ?? [];
+    return specifiers.flatMap((specifier) => {
+        const site = specifierSite(specifier);
+        return site ? [site] : [];
+    });
+};
+const collectNamedExports = (ast) => {
+    const sites = [];
+    walk(ast, (node) => {
+        sites.push(...sitesForExportNode(node));
+    });
+    return sites;
+};
+const collectNamespaceReexports = (ast) => {
+    const sites = [];
+    walk(ast, (node) => {
+        if (node.type !== 'ExportAllDeclaration') {
+            return;
+        }
+        // Mirror the `ExportNamedDeclaration` guard: `export type * from ...` and
+        // `export type * as ns from ...` propagate types only, never runtime
+        // identifiers, so they cannot leak raw rule objects and must be allowed.
+        if (node.exportKind === 'type') {
+            return;
+        }
+        const { source, exported } = node;
+        const target = typeof source?.value === 'string' ? source.value : '<unknown>';
+        // `export * as <alias> from '...'` exposes the alias as an
+        // `IdentifierName` / string-literal node on `exported`. Bare `export *`
+        // has `exported === null`.
+        const alias = readIdentifierOrStringName(exported);
+        sites.push({ alias, start: node.start, target });
+    });
+    return sites;
+};
+const formatNamespaceReexport = (site) => site.alias
+    ? `* as ${site.alias} from '${site.target}'`
+    : `* from '${site.target}'`;
+const namespaceReexportDiagnostics = (sourceCode, filePath, sites) => sites.map((site) => ({
+    filePath,
+    line: offsetToLine(sourceCode, site.start),
+    message: `warden-export-symmetry: namespace re-export "export ${formatNamespaceReexport(site)}" is not permitted on the warden public barrel. ` +
+        'The rule cannot verify registry ↔ trail symmetry through a star export — list each *Trail by name instead (ADR-0036).',
+    rule: 'warden-export-symmetry',
+    severity: 'error',
+}));
+const buildRegistryNameSets = () => {
+    const ruleNames = [...registeredRuleNames, SELF_RULE_NAME];
+    const camelNames = ruleNames.map(kebabToCamel);
+    return {
+        expectedTrailExports: new Set(camelNames.map((name) => `${name}Trail`)),
+        rawRuleCamelNames: new Set(camelNames),
+        ruleNames,
+    };
+};
+const missingTrailDiagnostics = (filePath, expected, present) => [...expected]
+    .filter((name) => !present.has(name))
+    .map((name) => ({
+    filePath,
+    line: 1,
+    message: `warden-export-symmetry: missing trail export "${name}" for registered warden rule. ` +
+        'Every wardenRules / wardenTopoRules entry must have a matching *Trail export on the public barrel (ADR-0036).',
+    rule: 'warden-export-symmetry',
+    severity: 'error',
+}));
+const orphanTrailDiagnostics = (sourceCode, filePath, exports, expected) => exports
+    .filter((site) => site.name.endsWith('Trail') && !expected.has(site.name))
+    .map((site) => ({
+    filePath,
+    line: offsetToLine(sourceCode, site.start),
+    message: `warden-export-symmetry: orphan trail export "${site.name}" has no matching wardenRules / wardenTopoRules entry. ` +
+        'Remove the export or register the corresponding rule (ADR-0036).',
+    rule: 'warden-export-symmetry',
+    severity: 'error',
+}));
+const pickRawRuleMatch = (site, rawNames) => {
+    if (rawNames.has(site.localName)) {
+        return site.localName;
+    }
+    if (rawNames.has(site.name)) {
+        return site.name;
+    }
+    return null;
+};
+const rawRuleLeakDiagnostics = (sourceCode, filePath, exports, rawNames) => exports.flatMap((site) => {
+    // Check BOTH the public name and the local source binding — aliasing a
+    // raw rule (`export { wardenExportSymmetry as disguised }`) must not
+    // sanitize the leak. Prefer the raw-matching name in the diagnostic so
+    // the incident points at the actual rule identifier.
+    const matched = pickRawRuleMatch(site, rawNames);
+    if (!matched) {
+        return [];
+    }
+    const alias = site.localName === site.name ? '' : ` (aliased as "${site.name}")`;
+    return [
+        {
+            filePath,
+            line: offsetToLine(sourceCode, site.start),
+            message: `warden-export-symmetry: raw rule export "${matched}"${alias} must not appear on the public barrel. ` +
+                'Raw WardenRule objects are internal; expose the matching *Trail wrapper instead (ADR-0036).',
+            rule: 'warden-export-symmetry',
+            severity: 'error',
+        },
+    ];
+});
+const collectDefaultExports = (ast) => {
+    const sites = [];
+    walk(ast, (node) => {
+        if (node.type !== 'ExportDefaultDeclaration') {
+            return;
+        }
+        sites.push({ localName: 'default', name: 'default', start: node.start });
+    });
+    return sites;
+};
+const defaultExportDiagnostics = (sourceCode, filePath, sites) => sites.map((site) => ({
+    filePath,
+    line: offsetToLine(sourceCode, site.start),
+    message: 'warden-export-symmetry: default export is not permitted on the warden public barrel. ' +
+        'Use named exports only so registry ↔ trail symmetry is discoverable (ADR-0036).',
+    rule: 'warden-export-symmetry',
+    severity: 'error',
+}));
+const analyzeBarrel = (sourceCode, filePath, ast) => {
+    const exports = collectNamedExports(ast);
+    const presentExports = new Set(exports.map((site) => site.name));
+    const { expectedTrailExports, rawRuleCamelNames } = buildRegistryNameSets();
+    return [
+        ...namespaceReexportDiagnostics(sourceCode, filePath, collectNamespaceReexports(ast)),
+        ...defaultExportDiagnostics(sourceCode, filePath, collectDefaultExports(ast)),
+        ...missingTrailDiagnostics(filePath, expectedTrailExports, presentExports),
+        ...orphanTrailDiagnostics(sourceCode, filePath, exports, expectedTrailExports),
+        ...rawRuleLeakDiagnostics(sourceCode, filePath, exports, rawRuleCamelNames),
+    ];
+};
+/**
+ * Warden rule enforcing ADR-0036 registry ↔ trail export symmetry on the
+ * `@ontrails/warden` public barrel.
+ */
+export const wardenExportSymmetry = {
+    check(sourceCode, filePath) {
+        if (!isTargetFile(filePath)) {
+            return [];
+        }
+        const ast = parse(filePath, sourceCode);
+        if (!ast) {
+            return [];
+        }
+        return analyzeBarrel(sourceCode, filePath, ast);
+    },
+    description: 'Enforces ADR-0036: every wardenRules / wardenTopoRules entry has a matching *Trail export, no orphan *Trail exports, and no raw rule objects leak onto the @ontrails/warden public barrel.',
+    name: 'warden-export-symmetry',
+    severity: 'error',
+};
+//# sourceMappingURL=warden-export-symmetry.js.map

package/dist/rules/warden-export-symmetry.js.map

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

package/dist/rules/warden-rules-use-ast.d.ts

@@ -0,0 +1,17 @@
+import type { WardenRule } from './types.js';
+/**
+ * Replace only the LAST occurrence of `/dist/` with `/src/`. A blanket
+ * `replaceAll` over-substitutes on paths that contain other `/dist/`
+ * segments higher up (e.g. `/home/runner/dist-artifacts/warden/dist/rules/`
+ * would incorrectly become `/home/runner/src-artifacts/warden/src/rules/`,
+ * a nonexistent directory — silently defeating the rule).
+ *
+ * Exported for unit testing. Not part of the public rule API.
+ */
+export declare const replaceLastDistSegmentWithSrc: (path: string) => string;
+/**
+ * Warden rule enforcing that warden rules themselves walk the AST rather than
+ * regex-scan raw source text.
+ */
+export declare const wardenRulesUseAst: WardenRule;
+//# sourceMappingURL=warden-rules-use-ast.d.ts.map

package/dist/rules/warden-rules-use-ast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warden-rules-use-ast.d.ts","sourceRoot":"","sources":["../../src/rules/warden-rules-use-ast.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAoB,UAAU,EAAE,MAAM,YAAY,CAAC;AAsB/D;;;;;;;;GAQG;AACH,eAAO,MAAM,6BAA6B,GAAI,MAAM,MAAM,KAAG,MAY5D,CAAC;AAy4BF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,UAe/B,CAAC"}