eslint-plugin-traceability 1.23.0 → 1.24.0

package/lib/tests/perf/maintenance-cli-large-workspace.test.js

@@ -1,229 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * CLI-level performance tests for maintenance tools on large workspaces.
- * @supports docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md REQ-MAINT-DETECT REQ-MAINT-REPORT REQ-MAINT-SAFE
- */
-const fs = __importStar(require("fs"));
-const os = __importStar(require("os"));
-const path = __importStar(require("path"));
-const perf_hooks_1 = require("perf_hooks");
-const cli_1 = require("../../src/maintenance/cli");
-// Performance budget documented in docs/maintenance-performance-tests.md
-const CLI_LARGE_WORKSPACE_PERF_BUDGET_MS = 5000;
-function createCliLargeWorkspace() {
-    const root = fs.mkdtempSync(path.join(os.tmpdir(), "traceability-cli-large-"));
-    // Create a modestly sized workspace reusing the same shape as the core perf tests,
-    // but with fewer files to keep end-to-end CLI timing predictable.
-    for (let moduleIndex = 0; moduleIndex < 5; moduleIndex += 1) {
-        const moduleDir = path.join(root, `module-${moduleIndex.toString().padStart(3, "0")}`);
-        fs.mkdirSync(moduleDir);
-        for (let fileIndex = 0; fileIndex < 20; fileIndex += 1) {
-            const filePath = path.join(moduleDir, `file-${fileIndex.toString().padStart(3, "0")}.ts`);
-            const validStory = "cli-valid.story.md";
-            const staleStory = "cli-stale.story.md";
-            const content = `/**
- * @story ${validStory}
- * @story ${staleStory}
- */
-export function cli_example_${moduleIndex}_${fileIndex}() {}
-`;
-            fs.writeFileSync(filePath, content, "utf8");
-        }
-    }
-    // Create the valid story file so that only the stale entries are reported.
-    fs.writeFileSync(path.join(root, "cli-valid.story.md"), "# cli valid", "utf8");
-    return {
-        root,
-        cleanup: () => {
-            fs.rmSync(root, { recursive: true, force: true });
-        },
-    };
-}
-function createDeepNestedCliWorkspace() {
-    const root = fs.mkdtempSync(path.join(os.tmpdir(), "traceability-cli-deep-nested-"));
-    // Create a deeply nested directory structure with a small number of files.
-    for (let branchIndex = 0; branchIndex < 3; branchIndex += 1) {
-        const level1 = path.join(root, `branch-${branchIndex.toString().padStart(3, "0")}`);
-        fs.mkdirSync(level1);
-        const level2 = path.join(level1, "deep", "nested", "structure");
-        fs.mkdirSync(path.join(level1, "deep"), { recursive: true });
-        fs.mkdirSync(path.join(level1, "deep", "nested"), { recursive: true });
-        fs.mkdirSync(level2, { recursive: true });
-        for (let fileIndex = 0; fileIndex < 3; fileIndex += 1) {
-            const filePath = path.join(level2, `deep-file-${fileIndex.toString().padStart(3, "0")}.ts`);
-            const validStory = "cli-valid.story.md";
-            const staleStory = "cli-deep-stale.story.md";
-            const content = `/**
- * @story ${validStory}
- * @story ${staleStory}
- */
-export function cli_deep_example_${branchIndex}_${fileIndex}() {}
-`;
-            fs.writeFileSync(filePath, content, "utf8");
-        }
-    }
-    // Create the valid story file so that only the stale entries are reported.
-    fs.writeFileSync(path.join(root, "cli-valid.story.md"), "# cli valid", "utf8");
-    return {
-        root,
-        cleanup: () => {
-            fs.rmSync(root, { recursive: true, force: true });
-        },
-    };
-}
-describe("Maintenance CLI on large workspaces (Story 009.0-DEV-MAINTENANCE-TOOLS)", () => {
-    it("[REQ-MAINT-DETECT] detect --json completes within a generous time budget and returns JSON payload", () => {
-        const { root, cleanup } = createCliLargeWorkspace();
-        const originalCwd = process.cwd();
-        process.chdir(root);
-        const logSpy = jest.spyOn(console, "log").mockImplementation(() => { });
-        try {
-            const start = perf_hooks_1.performance.now();
-            const exitCode = (0, cli_1.runMaintenanceCli)([
-                "node",
-                "traceability-maint",
-                "detect",
-                "--root",
-                root,
-                "--json",
-            ]);
-            const durationMs = perf_hooks_1.performance.now() - start;
-            expect(exitCode === 0 || exitCode === 1).toBe(true);
-            expect(durationMs).toBeLessThan(CLI_LARGE_WORKSPACE_PERF_BUDGET_MS);
-            expect(logSpy).toHaveBeenCalledTimes(1);
-            const payloadRaw = String(logSpy.mock.calls[0][0]);
-            const payload = JSON.parse(payloadRaw);
-            expect(payload.root).toBe(root);
-            expect(Array.isArray(payload.stale)).toBe(true);
-            expect(payload.stale.length).toBeGreaterThan(0);
-        }
-        finally {
-            logSpy.mockRestore();
-            process.chdir(originalCwd);
-            cleanup();
-        }
-    });
-    it("[REQ-MAINT-REPORT] report --format=json completes within a generous time budget", () => {
-        const { root, cleanup } = createCliLargeWorkspace();
-        const originalCwd = process.cwd();
-        process.chdir(root);
-        const logSpy = jest.spyOn(console, "log").mockImplementation(() => { });
-        try {
-            const start = perf_hooks_1.performance.now();
-            const exitCode = (0, cli_1.runMaintenanceCli)([
-                "node",
-                "traceability-maint",
-                "report",
-                "--root",
-                root,
-                "--format",
-                "json",
-            ]);
-            const durationMs = perf_hooks_1.performance.now() - start;
-            expect(exitCode).toBe(0);
-            expect(durationMs).toBeLessThan(CLI_LARGE_WORKSPACE_PERF_BUDGET_MS);
-            expect(logSpy).toHaveBeenCalledTimes(1);
-            const payloadRaw = String(logSpy.mock.calls[0][0]);
-            const payload = JSON.parse(payloadRaw);
-            expect(payload.root).toBe(root);
-            expect(typeof payload.report).toBe("string");
-        }
-        finally {
-            logSpy.mockRestore();
-            process.chdir(originalCwd);
-            cleanup();
-        }
-    });
-    it("[REQ-MAINT-VERIFY] verify completes within a generous time budget and reports stale annotations", () => {
-        const { root, cleanup } = createCliLargeWorkspace();
-        const originalCwd = process.cwd();
-        process.chdir(root);
-        const logSpy = jest.spyOn(console, "log").mockImplementation(() => { });
-        try {
-            const start = perf_hooks_1.performance.now();
-            const exitCode = (0, cli_1.runMaintenanceCli)([
-                "node",
-                "traceability-maint",
-                "verify",
-                "--root",
-                root,
-            ]);
-            const durationMs = perf_hooks_1.performance.now() - start;
-            expect(exitCode).toBe(1);
-            expect(durationMs).toBeLessThan(CLI_LARGE_WORKSPACE_PERF_BUDGET_MS);
-            expect(logSpy).toHaveBeenCalledTimes(1);
-            const message = String(logSpy.mock.calls[0][0]);
-            expect(message).toContain("Stale or invalid traceability annotations detected under");
-        }
-        finally {
-            logSpy.mockRestore();
-            process.chdir(originalCwd);
-            cleanup();
-        }
-    });
-    it("[REQ-MAINT-DETECT] detect traverses deeply nested directories within a generous time budget", () => {
-        const { root, cleanup } = createDeepNestedCliWorkspace();
-        const originalCwd = process.cwd();
-        process.chdir(root);
-        const logSpy = jest.spyOn(console, "log").mockImplementation(() => { });
-        try {
-            const start = perf_hooks_1.performance.now();
-            const exitCode = (0, cli_1.runMaintenanceCli)([
-                "node",
-                "traceability-maint",
-                "detect",
-                "--root",
-                root,
-                "--json",
-            ]);
-            const durationMs = perf_hooks_1.performance.now() - start;
-            expect(exitCode === 0 || exitCode === 1).toBe(true);
-            expect(durationMs).toBeLessThan(CLI_LARGE_WORKSPACE_PERF_BUDGET_MS);
-            expect(logSpy).toHaveBeenCalledTimes(1);
-            const payloadRaw = String(logSpy.mock.calls[0][0]);
-            const payload = JSON.parse(payloadRaw);
-            expect(payload.root).toBe(root);
-            expect(Array.isArray(payload.stale)).toBe(true);
-            expect(payload.stale.length).toBeGreaterThan(0);
-        }
-        finally {
-            logSpy.mockRestore();
-            process.chdir(originalCwd);
-            cleanup();
-        }
-    });
-});

package/lib/tests/perf/maintenance-large-workspace.test.d.ts

@@ -1 +0,0 @@
-export {};

package/lib/tests/perf/maintenance-large-workspace.test.js

@@ -1,169 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-/* eslint-disable traceability/valid-annotation-format */
-/**
- * Performance and stress tests for maintenance tools on large workspaces.
- * @supports docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md REQ-MAINT-DETECT REQ-MAINT-VERIFY REQ-MAINT-REPORT REQ-MAINT-UPDATE REQ-MAINT-BATCH
- */
-const fs = __importStar(require("fs"));
-const os = __importStar(require("os"));
-const path = __importStar(require("path"));
-const perf_hooks_1 = require("perf_hooks");
-const detect_1 = require("../../src/maintenance/detect");
-const batch_1 = require("../../src/maintenance/batch");
-const report_1 = require("../../src/maintenance/report");
-const update_1 = require("../../src/maintenance/update");
-// Performance budget for large-workspace maintenance tests; documented in docs/maintenance-performance-tests.md.
-const LARGE_WORKSPACE_PERF_BUDGET_MS = 5000;
-/**
- * Shape of the synthetic large workspace:
- * - 10 modules (module-000 .. module-009)
- * - 50 files per module (file-000.ts .. file-049.ts)
- * - Each file includes a mix of valid and stale @story references.
- */
-function createLargeWorkspace() {
-    const root = fs.mkdtempSync(path.join(os.tmpdir(), "traceability-large-"));
-    // Create a pool of story files that will be considered "valid".
-    const validStories = [];
-    for (let i = 0; i < 250; i += 1) {
-        const storyName = `valid-story-${i.toString().padStart(4, "0")}.story.md`;
-        const storyPath = path.join(root, storyName);
-        fs.writeFileSync(storyPath, `# ${storyName}`, "utf8");
-        validStories.push(storyName);
-    }
-    let validIndex = 0;
-    let staleIndex = 0;
-    for (let moduleIndex = 0; moduleIndex < 10; moduleIndex += 1) {
-        const moduleDir = path.join(root, `module-${moduleIndex.toString().padStart(3, "0")}`);
-        fs.mkdirSync(moduleDir);
-        for (let fileIndex = 0; fileIndex < 50; fileIndex += 1) {
-            const filePath = path.join(moduleDir, `file-${fileIndex.toString().padStart(3, "0")}.ts`);
-            const validStory = validStories[validIndex % validStories.length] ??
-                "valid-story-0000.story.md";
-            validIndex += 1;
-            const staleStory = `stale-story-${staleIndex
-                .toString()
-                .padStart(4, "0")}.story.md`;
-            staleIndex += 1;
-            const content = `/**
- * @story ${validStory}
- * @story ${staleStory}
- */
-export function example_${moduleIndex}_${fileIndex}() {}
-`;
-            fs.writeFileSync(filePath, content, "utf8");
-        }
-    }
-    return {
-        root,
-        cleanup: () => {
-            fs.rmSync(root, { recursive: true, force: true });
-        },
-    };
-}
-describe("Maintenance tools on large workspaces (Story 009.0-DEV-MAINTENANCE-TOOLS)", () => {
-    it("[REQ-MAINT-DETECT] detectStaleAnnotations completes within a generous time budget", () => {
-        const workspace = createLargeWorkspace();
-        try {
-            const start = perf_hooks_1.performance.now();
-            const stale = (0, detect_1.detectStaleAnnotations)(workspace.root);
-            const durationMs = perf_hooks_1.performance.now() - start;
-            // Sanity check: we expect at least some stale entries due to the generated stale-story-* references.
-            expect(stale.length).toBeGreaterThan(0);
-            // Guardrail: this operation should remain comfortably under ~5 seconds on CI hardware.
-            expect(durationMs).toBeLessThan(LARGE_WORKSPACE_PERF_BUDGET_MS);
-        }
-        finally {
-            workspace.cleanup();
-        }
-    });
-    it("[REQ-MAINT-VERIFY] verifyAnnotations remains fast on large workspaces", () => {
-        const workspace = createLargeWorkspace();
-        try {
-            const start = perf_hooks_1.performance.now();
-            const result = (0, batch_1.verifyAnnotations)(workspace.root);
-            const durationMs = perf_hooks_1.performance.now() - start;
-            // With both valid and stale references, verification should report false.
-            expect(result).toBe(false);
-            expect(durationMs).toBeLessThan(LARGE_WORKSPACE_PERF_BUDGET_MS);
-        }
-        finally {
-            workspace.cleanup();
-        }
-    });
-    it("[REQ-MAINT-REPORT] generateMaintenanceReport produces output within a generous time budget", () => {
-        const workspace = createLargeWorkspace();
-        try {
-            const start = perf_hooks_1.performance.now();
-            const report = (0, report_1.generateMaintenanceReport)(workspace.root);
-            const durationMs = perf_hooks_1.performance.now() - start;
-            expect(report).not.toBe("");
-            expect(durationMs).toBeLessThan(LARGE_WORKSPACE_PERF_BUDGET_MS);
-        }
-        finally {
-            workspace.cleanup();
-        }
-    });
-    it("[REQ-MAINT-UPDATE] updateAnnotationReferences and batchUpdateAnnotations remain tractable", () => {
-        const workspace = createLargeWorkspace();
-        try {
-            const exampleOldPath = "stale-story-0000.story.md";
-            const exampleNewPath = "updated-story-0000.story.md";
-            const singleStart = perf_hooks_1.performance.now();
-            const updatedCount = (0, update_1.updateAnnotationReferences)(workspace.root, exampleOldPath, exampleNewPath);
-            const singleDuration = perf_hooks_1.performance.now() - singleStart;
-            expect(updatedCount).toBeGreaterThan(0);
-            expect(singleDuration).toBeLessThan(LARGE_WORKSPACE_PERF_BUDGET_MS);
-            const batchStart = perf_hooks_1.performance.now();
-            const totalUpdated = (0, batch_1.batchUpdateAnnotations)(workspace.root, [
-                {
-                    oldPath: "stale-story-0001.story.md",
-                    newPath: "updated-story-0001.story.md",
-                },
-                {
-                    oldPath: "stale-story-0002.story.md",
-                    newPath: "updated-story-0002.story.md",
-                },
-            ]);
-            const batchDuration = perf_hooks_1.performance.now() - batchStart;
-            expect(totalUpdated).toBeGreaterThanOrEqual(2);
-            expect(batchDuration).toBeLessThan(LARGE_WORKSPACE_PERF_BUDGET_MS);
-        }
-        finally {
-            workspace.cleanup();
-        }
-    });
-});

package/lib/tests/perf/require-branch-annotation-large-file.test.d.ts

@@ -1 +0,0 @@
-export {};

package/lib/tests/perf/require-branch-annotation-large-file.test.js

@@ -1,67 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * Performance tests for require-branch-annotation on large nested-branch files.
- *
- * @supports docs/stories/004.0-DEV-BRANCH-ANNOTATIONS.story.md REQ-PERFORMANCE-OPTIMIZATION REQ-NESTED-HANDLING
- */
-const eslint_1 = require("eslint");
-const perf_hooks_1 = require("perf_hooks");
-const require_branch_annotation_1 = __importDefault(require("../../src/rules/require-branch-annotation"));
-/**
- * Build a large source file containing many nested branch structures
- * (if-statements within if-statements) to exercise the rule at scale.
- *
- * The generated code intentionally omits annotations so that the rule
- * produces diagnostics for both outer and inner branches.
- */
-function buildLargeNestedBranchSource(functionCount, nestingDepth) {
-    const lines = [];
-    for (let i = 0; i < functionCount; i += 1) {
-        lines.push(`function fn_${i}() {`);
-        lines.push("  let x = 0;");
-        // Create a staircase of nested if-statements.
-        for (let depth = 0; depth < nestingDepth; depth += 1) {
-            const indent = "  ".repeat(depth + 1);
-            lines.push(`${indent}if (x > ${depth}) {`);
-        }
-        const innerIndent = "  ".repeat(nestingDepth + 1);
-        lines.push(`${innerIndent}if (x % 2 === 0) {`);
-        lines.push(`${innerIndent}  x++;`);
-        lines.push(`${innerIndent}} else {`);
-        lines.push(`${innerIndent}  x--;`);
-        lines.push(`${innerIndent}}`);
-        // Close all nested if blocks.
-        for (let depth = nestingDepth - 1; depth >= 0; depth -= 1) {
-            const indent = "  ".repeat(depth + 1);
-            lines.push(`${indent}}`);
-        }
-        lines.push("}");
-    }
-    return lines.join("\n");
-}
-describe("require-branch-annotation performance on large nested-branch files (Story 004.0-DEV-BRANCH-ANNOTATIONS)", () => {
-    const ruleName = "traceability/require-branch-annotation";
-    it("[REQ-PERFORMANCE-OPTIMIZATION] analyzes a large nested-branch file within a generous time budget", () => {
-        const linter = new eslint_1.Linter({ configType: "eslintrc" });
-        linter.defineRule(ruleName, require_branch_annotation_1.default);
-        // 200 functions each with several nested branches gives us
-        // a substantial number of branch nodes without being extreme.
-        const source = buildLargeNestedBranchSource(200, 3);
-        const start = perf_hooks_1.performance.now();
-        const messages = linter.verify(source, {
-            parserOptions: { ecmaVersion: 2020, sourceType: "module" },
-            rules: {
-                [ruleName]: "error",
-            },
-        });
-        const durationMs = perf_hooks_1.performance.now() - start;
-        // Sanity check: we expect diagnostics for many branches.
-        expect(messages.length).toBeGreaterThan(0);
-        // Guardrail: keep analysis comfortably under ~5 seconds on CI hardware.
-        expect(durationMs).toBeLessThan(5000);
-    });
-});

package/lib/tests/perf/valid-annotation-format-large-file.test.d.ts

@@ -1 +0,0 @@
-export {};

package/lib/tests/perf/valid-annotation-format-large-file.test.js

@@ -1,75 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-/* eslint-disable traceability/valid-annotation-format */
-/**
- * Performance tests for valid-annotation-format on large annotated files.
- *
- * @supports docs/stories/005.0-DEV-ANNOTATION-VALIDATION.story.md REQ-MULTILINE-SUPPORT REQ-FLEXIBLE-PARSING REQ-SYNTAX-VALIDATION
- */
-const eslint_1 = require("eslint");
-const perf_hooks_1 = require("perf_hooks");
-const valid_annotation_format_1 = __importDefault(require("../../src/rules/valid-annotation-format"));
-/**
- * Build a large source file containing many functions with traceability
- * annotations in both line and block comments.
- *
- * The generated code mixes valid and invalid annotation formats to exercise
- * parsing, multi-line handling, and error-reporting paths at scale without
- * relying on auto-fix.
- */
-function buildLargeAnnotatedSource(functionCount, annotationsPerFunction) {
-    const lines = [];
-    for (let i = 0; i < functionCount; i += 1) {
-        // JSDoc-style block comment with multi-line @story/@req values.
-        lines.push("/**");
-        lines.push(" * @story docs/stories/005.0-DEV-ANNOTATION-VALIDATION.story.md");
-        lines.push(" * @req REQ-FORMAT-SPECIFICATION");
-        lines.push(" */");
-        // Additional line comments with a mix of valid and intentionally
-        // invalid formats (missing extensions, traversal, malformed IDs).
-        for (let j = 0; j < annotationsPerFunction; j += 1) {
-            const selector = (i + j) % 4;
-            if (selector === 0) {
-                lines.push("// @story docs/stories/005.0-DEV-ANNOTATION-VALIDATION.story");
-            }
-            else if (selector === 1) {
-                lines.push("// @req REQ-EXAMPLE-" + i.toString(10));
-            }
-            else if (selector === 2) {
-                lines.push("// @story ../outside-project.story.md");
-            }
-            else {
-                lines.push("// @req invalid-format-id");
-            }
-        }
-        lines.push(`function annotated_fn_${i}() {`);
-        lines.push('  return "ok";\n}');
-    }
-    return lines.join("\n");
-}
-describe("valid-annotation-format performance on large annotated files (Story 005.0-DEV-ANNOTATION-VALIDATION)", () => {
-    const ruleName = "traceability/valid-annotation-format";
-    it("[REQ-MULTILINE-SUPPORT][REQ-FLEXIBLE-PARSING] analyzes a large annotated file within a generous time budget", () => {
-        const linter = new eslint_1.Linter({ configType: "eslintrc" });
-        linter.defineRule(ruleName, valid_annotation_format_1.default);
-        // 150 functions each with several annotations provides a substantial
-        // volume of comments and annotation patterns without being extreme.
-        const source = buildLargeAnnotatedSource(150, 3);
-        const start = perf_hooks_1.performance.now();
-        const messages = linter.verify(source, {
-            parserOptions: { ecmaVersion: 2020, sourceType: "module" },
-            rules: {
-                [ruleName]: "error",
-            },
-        });
-        const durationMs = perf_hooks_1.performance.now() - start;
-        // Sanity check: we expect diagnostics for some invalid annotations so the
-        // rule is definitely executing its validation logic.
-        expect(messages.length).toBeGreaterThan(0);
-        // Guardrail: keep analysis comfortably under ~5 seconds on CI hardware.
-        expect(durationMs).toBeLessThan(5000);
-    });
-});

package/lib/tests/plugin-default-export-and-configs.test.d.ts

@@ -1 +0,0 @@
-export {};

package/lib/tests/plugin-default-export-and-configs.test.js

@@ -1,121 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * Tests for: docs/stories/001.0-DEV-PLUGIN-SETUP.story.md
- * @supports docs/stories/001.0-DEV-PLUGIN-SETUP.story.md REQ-PLUGIN-STRUCTURE REQ-RULE-REGISTRY REQ-CONFIG-SYSTEM
- * @supports docs/stories/007.0-DEV-ERROR-REPORTING.story.md REQ-ERROR-SEVERITY
- * @story docs/stories/001.0-DEV-PLUGIN-SETUP.story.md
- * @story docs/stories/007.0-DEV-ERROR-REPORTING.story.md
- * @req REQ-PLUGIN-STRUCTURE - Validate plugin default export and configs in src/index.ts
- * @req REQ-ERROR-SEVERITY - Validate error severity configuration in plugin configs
- */
-const index_1 = __importStar(require("../src/index"));
-describe("Plugin Default Export and Configs (Story 001.0-DEV-PLUGIN-SETUP)", () => {
-    it("[REQ-PLUGIN-STRUCTURE] default export includes rules and configs", () => {
-        expect(index_1.default.rules).toBe(index_1.rules);
-        expect(index_1.default.configs).toBe(index_1.configs);
-    });
-    it("[REQ-PLUGIN-STRUCTURE] rules object has correct rule names", () => {
-        // Arrange: expected rule names in insertion order
-        const expected = [
-            "require-traceability",
-            "require-story-annotation",
-            "require-req-annotation",
-            "require-branch-annotation",
-            "valid-annotation-format",
-            "valid-story-reference",
-            "valid-req-reference",
-            "prefer-implements-annotation",
-            "require-test-traceability",
-            "no-redundant-annotation",
-            "prefer-supports-annotation",
-        ];
-        // Act: get actual rule names from plugin
-        const actual = Object.keys(index_1.rules);
-        // Assert: actual matches expected
-        expect(actual).toEqual(expected);
-    });
-    it("[REQ-RULE-REGISTRY] configs.recommended contains correct rule configuration", () => {
-        const recommendedRules = index_1.configs.recommended[0].rules;
-        expect(recommendedRules).toHaveProperty("traceability/require-traceability", "error");
-        expect(recommendedRules).toHaveProperty("traceability/require-story-annotation", "error");
-        expect(recommendedRules).toHaveProperty("traceability/require-req-annotation", "error");
-        expect(recommendedRules).toHaveProperty("traceability/require-branch-annotation", "error");
-    });
-    it("[REQ-CONFIG-SYSTEM] configs.strict contains same rules as recommended", () => {
-        const strictRules = index_1.configs.strict[0].rules;
-        expect(strictRules).toEqual(index_1.configs.recommended[0].rules);
-    });
-    it("[REQ-ERROR-SEVERITY] configs.recommended maps valid-annotation-format to warn and others to error", () => {
-        const recommendedRules = index_1.configs.recommended[0].rules;
-        expect(recommendedRules).toHaveProperty("traceability/valid-annotation-format", "warn");
-        expect(recommendedRules).toHaveProperty("traceability/require-traceability", "error");
-        expect(recommendedRules).toHaveProperty("traceability/require-story-annotation", "error");
-        expect(recommendedRules).toHaveProperty("traceability/require-req-annotation", "error");
-        expect(recommendedRules).toHaveProperty("traceability/require-branch-annotation", "error");
-        expect(recommendedRules).toHaveProperty("traceability/valid-story-reference", "error");
-        expect(recommendedRules).toHaveProperty("traceability/valid-req-reference", "error");
-        expect(recommendedRules).toHaveProperty("traceability/require-test-traceability", "error");
-    });
-    it("[REQ-ERROR-SEVERITY] configs.strict uses same severity mapping as recommended", () => {
-        const strictRules = index_1.configs.strict[0].rules;
-        const recommendedRules = index_1.configs.recommended[0].rules;
-        expect(strictRules).toEqual(recommendedRules);
-    });
-    describe("Unified function-annotation rule aliases (Story 003.0-DEV-FUNCTION-ANNOTATIONS)", () => {
-        it("[REQ-ANNOTATION-REQUIRED] legacy rule names share the unified require-traceability implementation", () => {
-            const unified = index_1.rules["require-traceability"];
-            const storyAlias = index_1.rules["require-story-annotation"];
-            const reqAlias = index_1.rules["require-req-annotation"];
-            expect(typeof unified.create).toBe("function");
-            expect(storyAlias.create).toBe(unified.create);
-            expect(reqAlias.create).toBe(unified.create);
-        });
-        it("[REQ-CONFIGURABLE-SCOPE] alias rules preserve metadata needed for configuration and diagnostics", () => {
-            const unified = index_1.rules["require-traceability"];
-            const storyAlias = index_1.rules["require-story-annotation"];
-            const reqAlias = index_1.rules["require-req-annotation"];
-            // All variants should expose a schema and messages map so that options
-            // like scope/exportPriority and the core diagnostics remain available.
-            expect(unified.meta?.schema).toBeDefined();
-            expect(storyAlias.meta?.schema).toBeDefined();
-            expect(reqAlias.meta?.schema).toBeDefined();
-            expect(unified.meta?.messages).toBeDefined();
-            expect(storyAlias.meta?.messages).toBeDefined();
-            expect(reqAlias.meta?.messages).toBeDefined();
-        });
-    });
-});