@opensip-cli/checks-universal 0.1.0

package/dist/checks/documentation/_directives/eslint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eslint.d.ts","sourceRoot":"","sources":["../../../../src/checks/documentation/_directives/eslint.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,YAAY,CAAC;AAoLhE,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,aAAa,EAAE,CA0CjB"}

package/dist/checks/documentation/_directives/eslint.js

@@ -0,0 +1,168 @@
+/**
+ * @fileoverview ESLint directive parser
+ * (`eslint-disable`, `eslint-disable-next-line`, `eslint-disable-line`).
+ *
+ * Extracted from `directive-audit.ts` in Phase C4.
+ */
+const ESLINT_DISABLE_NEXT_LINE = 'eslint-disable-next-line';
+const ESLINT_DISABLE_LINE = 'eslint-disable-line';
+function determineESLintScope(text) {
+    if (text.includes(ESLINT_DISABLE_NEXT_LINE)) {
+        return 'next-line';
+    }
+    if (text.includes(ESLINT_DISABLE_LINE)) {
+        return 'same-line';
+    }
+    return 'file';
+}
+function parseRulesAndReason(rulesAndReasonRaw) {
+    const rulesAndReason = rulesAndReasonRaw?.trim() ?? '';
+    const parts = rulesAndReason.split('--');
+    const rulesPart = parts[0]?.trim() ?? '';
+    const reasonPart = parts[1]?.trim() ?? '';
+    const rules = rulesPart
+        .split(',')
+        .map((r) => r.trim())
+        .filter((r) => r && r !== '*');
+    return { rules, reason: reasonPart };
+}
+function createESLintDirective(options) {
+    const { rule, scope, lineNumber, file, filePath, reason, rawLine } = options;
+    return {
+        file,
+        filePath,
+        line: lineNumber,
+        source: 'eslint',
+        scope,
+        rule,
+        reason,
+        raw: rawLine.trim(),
+    };
+}
+function addESLintDirectives(options) {
+    const { rulesAndReasonRaw, scope, rawLine, lineNumber, file, filePath, directives } = options;
+    if (!Array.isArray(directives)) {
+        return;
+    }
+    const { rules, reason } = parseRulesAndReason(rulesAndReasonRaw);
+    if (rules.length === 0) {
+        directives.push(createESLintDirective({ rule: '*', scope, lineNumber, file, filePath, reason, rawLine }));
+        return;
+    }
+    for (const rule of rules) {
+        directives.push(createESLintDirective({
+            rule: `eslint/${rule}`,
+            scope,
+            lineNumber,
+            file,
+            filePath,
+            reason,
+            rawLine,
+        }));
+    }
+}
+function processESLintBlockComments(options) {
+    const { line, lineNumber, file, filePath, directives } = options;
+    if (!Array.isArray(directives)) {
+        return;
+    }
+    // Find block comments: /* eslint-disable[-next-line|-line] rules */
+    let searchStart = 0;
+    while (searchStart < line.length) {
+        const blockStart = line.indexOf('/*', searchStart);
+        if (blockStart === -1) {
+            return;
+        }
+        const blockEnd = line.indexOf('*/', blockStart + 2);
+        if (blockEnd === -1) {
+            return;
+        }
+        const blockContent = line.slice(blockStart + 2, blockEnd);
+        // Bounded quantifiers prevent ReDoS.
+        const eslintMatch = /\s{0,5}eslint-disable(?:-next-line|-line)?\s{1,5}([^*]{1,500})/.exec(blockContent);
+        if (eslintMatch) {
+            const scope = determineESLintScope(blockContent);
+            addESLintDirectives({
+                rulesAndReasonRaw: eslintMatch[1],
+                scope,
+                rawLine: line,
+                lineNumber,
+                file,
+                filePath,
+                directives,
+            });
+        }
+        searchStart = blockEnd + 2;
+    }
+}
+function processESLintLineComments(options) {
+    const { line, lineNumber, file, filePath, directives } = options;
+    if (!Array.isArray(directives)) {
+        return;
+    }
+    // Find line comments: // eslint-disable[-next-line|-line] rules
+    const commentStart = line.indexOf('//');
+    if (commentStart === -1) {
+        return;
+    }
+    const afterComment = line.slice(commentStart + 2);
+    // Bounded quantifiers prevent ReDoS.
+    const eslintMatch = /\s{0,5}eslint-disable(?:-next-line|-line)\s{1,5}(.{1,500})$/.exec(afterComment);
+    if (eslintMatch) {
+        const scope = determineESLintScope(afterComment);
+        addESLintDirectives({
+            rulesAndReasonRaw: eslintMatch[1],
+            scope,
+            rawLine: line,
+            lineNumber,
+            file,
+            filePath,
+            directives,
+        });
+    }
+}
+function isFileLevelDisable(line) {
+    const pattern = '/* eslint-disable */';
+    return line.includes(pattern) || line.includes('/*eslint-disable*/');
+}
+export function parseESLintDirectives(content, filePath, file) {
+    const directives = [];
+    const lines = content.split('\n');
+    for (const [i, line] of lines.entries()) {
+        if (line === undefined) {
+            continue;
+        }
+        const lineNumber = i + 1;
+        // File-level eslint-disable at start of file (first 50 lines)
+        if (i < 50 && isFileLevelDisable(line)) {
+            directives.push({
+                file,
+                filePath,
+                line: lineNumber,
+                source: 'eslint',
+                scope: 'file',
+                rule: '*',
+                reason: '',
+                raw: line.trim(),
+            });
+        }
+        else {
+            processESLintBlockComments({
+                line,
+                lineNumber,
+                file,
+                filePath,
+                directives,
+            });
+            processESLintLineComments({
+                line,
+                lineNumber,
+                file,
+                filePath,
+                directives,
+            });
+        }
+    }
+    return directives;
+}
+//# sourceMappingURL=eslint.js.map

package/dist/checks/documentation/_directives/eslint.js.map

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

package/dist/checks/documentation/_directives/fitness.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview Fitness directive parser
+ * (`@fitness-ignore-file`, `@fitness-ignore-next-line`).
+ *
+ * Extracted from `directive-audit.ts` in Phase C4.
+ */
+import type { DirectiveInfo } from './types.js';
+export declare function parseFitnessDirectives(content: string, filePath: string, file: string): DirectiveInfo[];
+//# sourceMappingURL=fitness.d.ts.map

package/dist/checks/documentation/_directives/fitness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fitness.d.ts","sourceRoot":"","sources":["../../../../src/checks/documentation/_directives/fitness.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAyDhD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,aAAa,EAAE,CAgBjB"}

package/dist/checks/documentation/_directives/fitness.js

@@ -0,0 +1,64 @@
+/**
+ * @fileoverview Fitness directive parser
+ * (`@fitness-ignore-file`, `@fitness-ignore-next-line`).
+ *
+ * Extracted from `directive-audit.ts` in Phase C4.
+ */
+function extractFitnessDirective(line, lineIndex, filePath, file) {
+    const fileMarker = '@fitness-ignore-file';
+    const nextLineMarker = '@fitness-ignore-next-line';
+    let scopeType;
+    let markerEnd;
+    const fileIdx = line.indexOf(fileMarker);
+    const nextLineIdx = line.indexOf(nextLineMarker);
+    if (fileIdx !== -1) {
+        scopeType = 'file';
+        markerEnd = fileIdx + fileMarker.length;
+    }
+    else if (nextLineIdx === -1) {
+        return null;
+    }
+    else {
+        scopeType = 'next-line';
+        markerEnd = nextLineIdx + nextLineMarker.length;
+    }
+    // Extract check ID and reason
+    const afterMarker = line.slice(markerEnd).trim();
+    const spaceIdx = afterMarker.indexOf(' ');
+    if (spaceIdx === -1) {
+        return null;
+    }
+    const checkId = afterMarker.slice(0, spaceIdx);
+    const rest = afterMarker.slice(spaceIdx).trim();
+    // Look for -- separator
+    const separatorIdx = rest.indexOf('--');
+    if (separatorIdx === -1) {
+        return null;
+    }
+    const reason = rest.slice(separatorIdx + 2).trim();
+    return {
+        file,
+        filePath,
+        line: lineIndex + 1,
+        source: 'fitness',
+        scope: scopeType,
+        rule: `fitness/${checkId}`,
+        reason,
+        raw: line.trim(),
+    };
+}
+export function parseFitnessDirectives(content, filePath, file) {
+    const directives = [];
+    const lines = content.split('\n');
+    for (const [i, line] of lines.entries()) {
+        if (line === undefined) {
+            continue;
+        }
+        const directive = extractFitnessDirective(line, i, filePath, file);
+        if (directive) {
+            directives.push(directive);
+        }
+    }
+    return directives;
+}
+//# sourceMappingURL=fitness.js.map

package/dist/checks/documentation/_directives/fitness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fitness.js","sourceRoot":"","sources":["../../../../src/checks/documentation/_directives/fitness.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,SAAS,uBAAuB,CAC9B,IAAY,EACZ,SAAiB,EACjB,QAAgB,EAChB,IAAY;IAEZ,MAAM,UAAU,GAAG,sBAAsB,CAAC;IAC1C,MAAM,cAAc,GAAG,2BAA2B,CAAC;IAEnD,IAAI,SAA+B,CAAC;IACpC,IAAI,SAAiB,CAAC;IAEtB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACzC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAEjD,IAAI,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC;QACnB,SAAS,GAAG,MAAM,CAAC;QACnB,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC;IAC1C,CAAC;SAAM,IAAI,WAAW,KAAK,CAAC,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;SAAM,CAAC;QACN,SAAS,GAAG,WAAW,CAAC;QACxB,SAAS,GAAG,WAAW,GAAG,cAAc,CAAC,MAAM,CAAC;IAClD,CAAC;IAED,8BAA8B;IAC9B,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;IAEhD,wBAAwB;IACxB,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAEnD,OAAO;QACL,IAAI;QACJ,QAAQ;QACR,IAAI,EAAE,SAAS,GAAG,CAAC;QACnB,MAAM,EAAE,SAAS;QACjB,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,WAAW,OAAO,EAAE;QAC1B,MAAM;QACN,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE;KACjB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,OAAe,EACf,QAAgB,EAChB,IAAY;IAEZ,MAAM,UAAU,GAAoB,EAAE,CAAC;IACvC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAElC,KAAK,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QACxC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,SAAS;QACX,CAAC;QAED,MAAM,SAAS,GAAG,uBAAuB,CAAC,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QACnE,IAAI,SAAS,EAAE,CAAC;YACd,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/checks/documentation/_directives/graph.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Graph directive parser
+ * (`@graph-ignore-file`, `@graph-ignore-next-line`).
+ *
+ * Modeled on `./fitness.ts`. Graph rule ids are already namespaced
+ * (`graph:<…>`), so the parsed id is used directly as `rule`.
+ */
+import type { DirectiveInfo } from './types.js';
+export declare function parseGraphDirectives(content: string, filePath: string, file: string): DirectiveInfo[];
+//# sourceMappingURL=graph.d.ts.map

package/dist/checks/documentation/_directives/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../../src/checks/documentation/_directives/graph.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAyDhD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,aAAa,EAAE,CAgBjB"}

package/dist/checks/documentation/_directives/graph.js

@@ -0,0 +1,65 @@
+/**
+ * @fileoverview Graph directive parser
+ * (`@graph-ignore-file`, `@graph-ignore-next-line`).
+ *
+ * Modeled on `./fitness.ts`. Graph rule ids are already namespaced
+ * (`graph:<…>`), so the parsed id is used directly as `rule`.
+ */
+function extractGraphDirective(line, lineIndex, filePath, file) {
+    const fileMarker = '@graph-ignore-file';
+    const nextLineMarker = '@graph-ignore-next-line';
+    let scopeType;
+    let markerEnd;
+    const fileIdx = line.indexOf(fileMarker);
+    const nextLineIdx = line.indexOf(nextLineMarker);
+    if (fileIdx !== -1) {
+        scopeType = 'file';
+        markerEnd = fileIdx + fileMarker.length;
+    }
+    else if (nextLineIdx === -1) {
+        return null;
+    }
+    else {
+        scopeType = 'next-line';
+        markerEnd = nextLineIdx + nextLineMarker.length;
+    }
+    // Extract rule id and reason
+    const afterMarker = line.slice(markerEnd).trim();
+    const spaceIdx = afterMarker.indexOf(' ');
+    if (spaceIdx === -1) {
+        return null;
+    }
+    const ruleId = afterMarker.slice(0, spaceIdx);
+    const rest = afterMarker.slice(spaceIdx).trim();
+    // Look for -- separator
+    const separatorIdx = rest.indexOf('--');
+    if (separatorIdx === -1) {
+        return null;
+    }
+    const reason = rest.slice(separatorIdx + 2).trim();
+    return {
+        file,
+        filePath,
+        line: lineIndex + 1,
+        source: 'graph',
+        scope: scopeType,
+        rule: ruleId,
+        reason,
+        raw: line.trim(),
+    };
+}
+export function parseGraphDirectives(content, filePath, file) {
+    const directives = [];
+    const lines = content.split('\n');
+    for (const [i, line] of lines.entries()) {
+        if (line === undefined) {
+            continue;
+        }
+        const directive = extractGraphDirective(line, i, filePath, file);
+        if (directive) {
+            directives.push(directive);
+        }
+    }
+    return directives;
+}
+//# sourceMappingURL=graph.js.map

package/dist/checks/documentation/_directives/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../../../src/checks/documentation/_directives/graph.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,SAAS,qBAAqB,CAC5B,IAAY,EACZ,SAAiB,EACjB,QAAgB,EAChB,IAAY;IAEZ,MAAM,UAAU,GAAG,oBAAoB,CAAC;IACxC,MAAM,cAAc,GAAG,yBAAyB,CAAC;IAEjD,IAAI,SAA+B,CAAC;IACpC,IAAI,SAAiB,CAAC;IAEtB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACzC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAEjD,IAAI,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC;QACnB,SAAS,GAAG,MAAM,CAAC;QACnB,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC;IAC1C,CAAC;SAAM,IAAI,WAAW,KAAK,CAAC,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;SAAM,CAAC;QACN,SAAS,GAAG,WAAW,CAAC;QACxB,SAAS,GAAG,WAAW,GAAG,cAAc,CAAC,MAAM,CAAC;IAClD,CAAC;IAED,6BAA6B;IAC7B,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;IAEhD,wBAAwB;IACxB,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAEnD,OAAO;QACL,IAAI;QACJ,QAAQ;QACR,IAAI,EAAE,SAAS,GAAG,CAAC;QACnB,MAAM,EAAE,OAAO;QACf,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,MAAM;QACZ,MAAM;QACN,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE;KACjB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,OAAe,EACf,QAAgB,EAChB,IAAY;IAEZ,MAAM,UAAU,GAAoB,EAAE,CAAC;IACvC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAElC,KAAK,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QACxC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,SAAS;QACX,CAAC;QAED,MAAM,SAAS,GAAG,qBAAqB,CAAC,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QACjE,IAAI,SAAS,EAAE,CAAC;YACd,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/checks/documentation/_directives/graph.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=graph.test.d.ts.map

package/dist/checks/documentation/_directives/graph.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.test.d.ts","sourceRoot":"","sources":["../../../../src/checks/documentation/_directives/graph.test.ts"],"names":[],"mappings":""}

package/dist/checks/documentation/_directives/graph.test.js

@@ -0,0 +1,54 @@
+/**
+ * Coverage for `parseGraphDirectives` — the graph grammar of the
+ * directive-audit parser family (`@graph-ignore-file`,
+ * `@graph-ignore-next-line`). Graph rule ids are already `graph:`-namespaced,
+ * so the parsed id is used verbatim as `rule` (unlike fitness's `fitness/<id>`
+ * prefixing).
+ */
+import { describe, expect, it } from 'vitest';
+import { parseGraphDirectives } from './graph.js';
+const FILE = 'src/foo.ts';
+const SHORT = 'foo.ts';
+describe('parseGraphDirectives', () => {
+    it('parses a next-line directive into a graph-sourced DirectiveInfo', () => {
+        const content = [
+            '// @graph-ignore-next-line graph:cycle -- intentional recursion',
+            'function visit() {}',
+        ].join('\n');
+        const directives = parseGraphDirectives(content, FILE, SHORT);
+        expect(directives).toHaveLength(1);
+        const d = directives[0];
+        expect(d?.source).toBe('graph');
+        expect(d?.scope).toBe('next-line');
+        expect(d?.rule).toBe('graph:cycle');
+        expect(d?.reason).toBe('intentional recursion');
+        expect(d?.file).toBe(SHORT);
+        expect(d?.filePath).toBe(FILE);
+        expect(d?.line).toBe(1);
+    });
+    it('parses a file-level directive with scope "file"', () => {
+        const content = [
+            '// @graph-ignore-file graph:wide-function -- generated code',
+            'export const x = 1',
+        ].join('\n');
+        const directives = parseGraphDirectives(content, FILE, SHORT);
+        expect(directives).toHaveLength(1);
+        expect(directives[0]?.scope).toBe('file');
+        expect(directives[0]?.rule).toBe('graph:wide-function');
+        expect(directives[0]?.reason).toBe('generated code');
+    });
+    it('preserves the full reason text after the -- separator', () => {
+        const content = '// @graph-ignore-next-line graph:large-function -- big switch is clearer inline';
+        const directives = parseGraphDirectives(content, FILE, SHORT);
+        expect(directives[0]?.reason).toBe('big switch is clearer inline');
+    });
+    it('skips a directive with no -- reason separator (audit requires a reason)', () => {
+        const content = '// @graph-ignore-next-line graph:cycle';
+        expect(parseGraphDirectives(content, FILE, SHORT)).toHaveLength(0);
+    });
+    it('returns no directives for content with no graph markers', () => {
+        const content = ['function visit() {}', '// @fitness-ignore-next-line some-check -- nope'].join('\n');
+        expect(parseGraphDirectives(content, FILE, SHORT)).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=graph.test.js.map

package/dist/checks/documentation/_directives/graph.test.js.map

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

package/dist/checks/documentation/_directives/semgrep.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview Semgrep directive parser (`nosemgrep`).
+ *
+ * Extracted from `directive-audit.ts` in Phase C4.
+ */
+import type { DirectiveInfo } from './types.js';
+export declare function parseSemgrepDirectives(content: string, filePath: string, file: string): DirectiveInfo[];
+//# sourceMappingURL=semgrep.d.ts.map

package/dist/checks/documentation/_directives/semgrep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semgrep.d.ts","sourceRoot":"","sources":["../../../../src/checks/documentation/_directives/semgrep.ts"],"names":[],"mappings":"AACA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAgEhD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,aAAa,EAAE,CAgBjB"}

package/dist/checks/documentation/_directives/semgrep.js

@@ -0,0 +1,72 @@
+// @fitness-ignore-file semgrep-justifications -- this file's job is to parse nosemgrep directives; example nosemgrep strings appear in JSDoc by necessity
+/**
+ * @fileoverview Semgrep directive parser (`nosemgrep`).
+ *
+ * Extracted from `directive-audit.ts` in Phase C4.
+ */
+/**
+ * Extract semgrep rule ID and reason from a nosemgrep directive line.
+ *
+ * Formats:
+ * - `// nosemgrep: rule.id -- reason`
+ * - `// nosemgrep: rule.id`
+ * - `// nosemgrep`
+ */
+function extractSemgrepDirective(line, lineIndex, filePath, file) {
+    const nosemgrepMarker = 'nosemgrep';
+    // Find the nosemgrep marker in a comment
+    const commentIdx = line.indexOf('//');
+    if (commentIdx === -1) {
+        return null;
+    }
+    const afterComment = line.slice(commentIdx + 2).trim();
+    if (!afterComment.startsWith(nosemgrepMarker)) {
+        return null;
+    }
+    const afterMarker = afterComment.slice(nosemgrepMarker.length);
+    // Extract rule ID and reason
+    let ruleId = '*'; // Default to all rules
+    let reason = '';
+    // Check for : separator (rule ID follows)
+    if (afterMarker.startsWith(':')) {
+        const afterColon = afterMarker.slice(1).trim();
+        // Check for -- separator (reason follows)
+        const reasonSeparator = afterColon.indexOf('--');
+        if (reasonSeparator === -1) {
+            ruleId = afterColon.trim() || '*';
+        }
+        else {
+            ruleId = afterColon.slice(0, reasonSeparator).trim() || '*';
+            reason = afterColon.slice(reasonSeparator + 2).trim();
+        }
+    }
+    else if (afterMarker.trim().startsWith('--')) {
+        // Just a reason, no rule ID
+        reason = afterMarker.trim().slice(2).trim();
+    }
+    return {
+        file,
+        filePath,
+        line: lineIndex + 1,
+        source: 'semgrep',
+        scope: 'next-line',
+        rule: `semgrep/${ruleId}`,
+        reason,
+        raw: line.trim(),
+    };
+}
+export function parseSemgrepDirectives(content, filePath, file) {
+    const directives = [];
+    const lines = content.split('\n');
+    for (const [i, line] of lines.entries()) {
+        if (line === undefined) {
+            continue;
+        }
+        const directive = extractSemgrepDirective(line, i, filePath, file);
+        if (directive) {
+            directives.push(directive);
+        }
+    }
+    return directives;
+}
+//# sourceMappingURL=semgrep.js.map

package/dist/checks/documentation/_directives/semgrep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semgrep.js","sourceRoot":"","sources":["../../../../src/checks/documentation/_directives/semgrep.ts"],"names":[],"mappings":"AAAA,0JAA0J;AAC1J;;;;GAIG;AAIH;;;;;;;GAOG;AACH,SAAS,uBAAuB,CAC9B,IAAY,EACZ,SAAiB,EACjB,QAAgB,EAChB,IAAY;IAEZ,MAAM,eAAe,GAAG,WAAW,CAAC;IAEpC,yCAAyC;IACzC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACvD,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,WAAW,GAAG,YAAY,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAE/D,6BAA6B;IAC7B,IAAI,MAAM,GAAG,GAAG,CAAC,CAAC,uBAAuB;IACzC,IAAI,MAAM,GAAG,EAAE,CAAC;IAEhB,0CAA0C;IAC1C,IAAI,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAE/C,0CAA0C;QAC1C,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,eAAe,KAAK,CAAC,CAAC,EAAE,CAAC;YAC3B,MAAM,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC;QACpC,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC;YAC5D,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACxD,CAAC;IACH,CAAC;SAAM,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,4BAA4B;QAC5B,MAAM,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,CAAC;IAED,OAAO;QACL,IAAI;QACJ,QAAQ;QACR,IAAI,EAAE,SAAS,GAAG,CAAC;QACnB,MAAM,EAAE,SAAS;QACjB,KAAK,EAAE,WAAW;QAClB,IAAI,EAAE,WAAW,MAAM,EAAE;QACzB,MAAM;QACN,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE;KACjB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,OAAe,EACf,QAAgB,EAChB,IAAY;IAEZ,MAAM,UAAU,GAAoB,EAAE,CAAC;IACvC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAElC,KAAK,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QACxC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,SAAS;QACX,CAAC;QAED,MAAM,SAAS,GAAG,uBAAuB,CAAC,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QACnE,IAAI,SAAS,EAAE,CAAC;YACd,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/checks/documentation/_directives/types.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Shared directive parser types.
+ *
+ * The directive-audit check delegates per-grammar parsing to the
+ * sibling modules in this folder. They share the `DirectiveInfo`
+ * shape so the audit can sort and emit them uniformly.
+ */
+type DirectiveSource = 'typescript' | 'eslint' | 'fitness' | 'semgrep' | 'graph';
+export type DirectiveScope = 'file' | 'next-line' | 'same-line';
+export interface DirectiveInfo {
+    file: string;
+    filePath: string;
+    line: number;
+    source: DirectiveSource;
+    scope: DirectiveScope;
+    rule: string;
+    reason: string;
+    raw: string;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/checks/documentation/_directives/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/checks/documentation/_directives/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,KAAK,eAAe,GAAG,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AACjF,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,WAAW,GAAG,WAAW,CAAC;AAEhE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,EAAE,cAAc,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb"}

package/dist/checks/documentation/_directives/types.js

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview Shared directive parser types.
+ *
+ * The directive-audit check delegates per-grammar parsing to the
+ * sibling modules in this folder. They share the `DirectiveInfo`
+ * shape so the audit can sort and emit them uniformly.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/checks/documentation/_directives/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/checks/documentation/_directives/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/checks/documentation/_directives/typescript.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview TypeScript directive parser (`@ts-expect-error`, etc.).
+ *
+ * Extracted from `directive-audit.ts` in Phase C4 — the parsers used
+ * to live inline in the check, but the four grammars are best read
+ * (and tested) as siblings.
+ */
+import type { DirectiveInfo } from './types.js';
+export declare function parseTypeScriptDirectives(content: string, filePath: string, file: string): DirectiveInfo[];
+//# sourceMappingURL=typescript.d.ts.map

package/dist/checks/documentation/_directives/typescript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript.d.ts","sourceRoot":"","sources":["../../../../src/checks/documentation/_directives/typescript.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAiChD,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,aAAa,EAAE,CAuBjB"}

package/dist/checks/documentation/_directives/typescript.js

@@ -0,0 +1,54 @@
+/**
+ * @fileoverview TypeScript directive parser (`@ts-expect-error`, etc.).
+ *
+ * Extracted from `directive-audit.ts` in Phase C4 — the parsers used
+ * to live inline in the check, but the four grammars are best read
+ * (and tested) as siblings.
+ */
+const TS_DIRECTIVE_KEYWORD = '@ts-expect-error';
+const TS_EXPECT_ERROR_KEYWORD = '@ts-expect-error';
+function extractTsDirectiveAndReason(line) {
+    let directiveStart = line.indexOf(TS_DIRECTIVE_KEYWORD);
+    let directive = TS_DIRECTIVE_KEYWORD;
+    if (directiveStart === -1) {
+        directiveStart = line.indexOf(TS_EXPECT_ERROR_KEYWORD);
+        directive = TS_EXPECT_ERROR_KEYWORD;
+    }
+    if (directiveStart === -1) {
+        return null;
+    }
+    // Must be in a `//` comment.
+    const beforeDirective = line.slice(0, directiveStart);
+    if (!beforeDirective.includes('//')) {
+        return null;
+    }
+    // Extract reason after directive (after : or - or em-dash).
+    // Bounded quantifiers prevent ReDoS.
+    const afterDirective = line.slice(directiveStart + directive.length);
+    const separatorMatch = /^\s{0,5}[:-—]\s{0,5}(.{0,500})/.exec(afterDirective);
+    const reason = separatorMatch?.[1]?.trim() ?? '';
+    return { directive, reason };
+}
+export function parseTypeScriptDirectives(content, filePath, file) {
+    const directives = [];
+    const lines = content.split('\n');
+    for (const [i, line] of lines.entries()) {
+        if (line === undefined)
+            continue;
+        const result = extractTsDirectiveAndReason(line);
+        if (result) {
+            directives.push({
+                file,
+                filePath,
+                line: i + 1,
+                source: 'typescript',
+                scope: 'next-line',
+                rule: result.directive,
+                reason: result.reason,
+                raw: line.trim(),
+            });
+        }
+    }
+    return directives;
+}
+//# sourceMappingURL=typescript.js.map

package/dist/checks/documentation/_directives/typescript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript.js","sourceRoot":"","sources":["../../../../src/checks/documentation/_directives/typescript.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AAChD,MAAM,uBAAuB,GAAG,kBAAkB,CAAC;AAEnD,SAAS,2BAA2B,CAAC,IAAY;IAC/C,IAAI,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACxD,IAAI,SAAS,GAAG,oBAAoB,CAAC;IAErC,IAAI,cAAc,KAAK,CAAC,CAAC,EAAE,CAAC;QAC1B,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;QACvD,SAAS,GAAG,uBAAuB,CAAC;IACtC,CAAC;IAED,IAAI,cAAc,KAAK,CAAC,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,6BAA6B;IAC7B,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;IACtD,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4DAA4D;IAC5D,qCAAqC;IACrC,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IACrE,MAAM,cAAc,GAAG,gCAAgC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC7E,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAEjD,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,OAAe,EACf,QAAgB,EAChB,IAAY;IAEZ,MAAM,UAAU,GAAoB,EAAE,CAAC;IACvC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAElC,KAAK,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QACxC,IAAI,IAAI,KAAK,SAAS;YAAE,SAAS;QAEjC,MAAM,MAAM,GAAG,2BAA2B,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,MAAM,EAAE,CAAC;YACX,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI;gBACJ,QAAQ;gBACR,IAAI,EAAE,CAAC,GAAG,CAAC;gBACX,MAAM,EAAE,YAAY;gBACpB,KAAK,EAAE,WAAW;gBAClB,IAAI,EAAE,MAAM,CAAC,SAAS;gBACtB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE;aACjB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}