eslint-plugin-traceability 1.23.0 → 1.24.0

package/lib/tests/rules/valid-req-reference.test.js

@@ -1,129 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-/****
- * Tests for: docs/stories/010.0-DEV-DEEP-VALIDATION.story.md
- * @story docs/stories/010.0-DEV-DEEP-VALIDATION.story.md
- * @req REQ-DEEP-PARSE - Verify valid-req-reference rule enforces existing requirement content
- *
- * Additional coverage for error reporting behavior:
- * @story docs/stories/007.0-DEV-ERROR-REPORTING.story.md
- * @req REQ-ERROR-SPECIFIC - Verify requirement-level errors identify the exact missing requirement
- * @req REQ-ERROR-CONTEXT - Verify requirement-level errors include relevant story path context
- * @req REQ-ERROR-CONSISTENCY - Verify requirement-level error messages are consistent across cases
- * @supports docs/stories/010.0-DEV-DEEP-VALIDATION.story.md REQ-DEEP-PARSE REQ-DEEP-BULLET REQ-DEEP-IMPLEMENTS REQ-DEEP-MATCH
- * @supports docs/stories/007.0-DEV-ERROR-REPORTING.story.md REQ-ERROR-SPECIFIC REQ-ERROR-CONTEXT REQ-ERROR-CONSISTENCY
- */
-const eslint_1 = require("eslint");
-const valid_req_reference_1 = __importDefault(require("../../src/rules/valid-req-reference"));
-const ruleTester = new eslint_1.RuleTester({
-    languageOptions: { parserOptions: { ecmaVersion: 2020 } },
-});
-describe("Valid Req Reference Rule (Story 010.0-DEV-DEEP-VALIDATION)", () => {
-    ruleTester.run("valid-req-reference", valid_req_reference_1.default, {
-        valid: [
-            {
-                name: "[REQ-DEEP-PARSE] valid requirement reference existing in story file",
-                code: `// @story docs/stories/001.0-DEV-PLUGIN-SETUP.story.md
-// @req REQ-PLUGIN-STRUCTURE`,
-            },
-            {
-                name: "[REQ-DEEP-BULLET] valid bullet list requirement existing in bullet story fixture",
-                code: `// @story tests/fixtures/story_bullet.md
-// @req REQ-BULLET-LIST`,
-            },
-            {
-                name: "[REQ-DEEP-IMPLEMENTS] single supports line with multiple requirements in multi-story fixture (see 010.2-DEV-MULTI-STORY-SUPPORT)",
-                code: `// @supports tests/fixtures/story_multi_a.md REQ-SHARED-ID REQ-ONLY-A`,
-            },
-            {
-                name: "[REQ-DEEP-IMPLEMENTS] multi-story supports with shared requirement IDs (see 010.2-DEV-MULTI-STORY-SUPPORT)",
-                code: `// @supports tests/fixtures/story_multi_a.md REQ-SHARED-ID REQ-ONLY-A
-// @supports tests/fixtures/story_multi_b.md REQ-SHARED-ID REQ-ONLY-B`,
-            },
-        ],
-        invalid: [
-            {
-                name: "[REQ-DEEP-MATCH] missing requirement in story file",
-                code: `// @story docs/stories/001.0-DEV-PLUGIN-SETUP.story.md
-// @req REQ-NON-EXISTENT`,
-                errors: [
-                    {
-                        messageId: "reqMissing",
-                        data: {
-                            reqId: "REQ-NON-EXISTENT",
-                            storyPath: "docs/stories/001.0-DEV-PLUGIN-SETUP.story.md",
-                        },
-                    },
-                ],
-            },
-            {
-                name: "[REQ-DEEP-PARSE] disallow path traversal in story path",
-                code: `// @story ../docs/stories/001.0-DEV-PLUGIN-SETUP.story.md
-// @req REQ-PLUGIN-STRUCTURE`,
-                errors: [
-                    {
-                        messageId: "invalidPath",
-                        data: {
-                            storyPath: "../docs/stories/001.0-DEV-PLUGIN-SETUP.story.md",
-                        },
-                    },
-                ],
-            },
-            {
-                name: "[REQ-DEEP-PARSE] disallow absolute path in story path",
-                code: `// @story /absolute/path/docs/stories/001.0-DEV-PLUGIN-SETUP.story.md
-// @req REQ-PLUGIN-STRUCTURE`,
-                errors: [
-                    {
-                        messageId: "invalidPath",
-                        data: {
-                            storyPath: "/absolute/path/docs/stories/001.0-DEV-PLUGIN-SETUP.story.md",
-                        },
-                    },
-                ],
-            },
-            {
-                name: "[REQ-DEEP-BULLET] missing bullet list requirement in bullet story fixture",
-                code: `// @story tests/fixtures/story_bullet.md
-// @req REQ-MISSING-BULLET`,
-                errors: [
-                    {
-                        messageId: "reqMissing",
-                        data: {
-                            reqId: "REQ-MISSING-BULLET",
-                            storyPath: "tests/fixtures/story_bullet.md",
-                        },
-                    },
-                ],
-            },
-            {
-                name: "[REQ-DEEP-IMPLEMENTS] missing supports requirement in multi-story fixture (see 010.2-DEV-MULTI-STORY-SUPPORT)",
-                code: `// @supports tests/fixtures/story_multi_a.md REQ-NOT-IN-A`,
-                errors: [
-                    {
-                        messageId: "reqMissing",
-                        data: {
-                            reqId: "REQ-NOT-IN-A",
-                            storyPath: "tests/fixtures/story_multi_a.md",
-                        },
-                    },
-                ],
-            },
-            {
-                name: "[REQ-DEEP-IMPLEMENTS] disallow path traversal in supports story path (see 010.2-DEV-MULTI-STORY-SUPPORT)",
-                code: `// @supports ../tests/fixtures/story_multi_a.md REQ-SHARED-ID`,
-                errors: [
-                    {
-                        messageId: "invalidPath",
-                        data: {
-                            storyPath: "../tests/fixtures/story_multi_a.md",
-                        },
-                    },
-                ],
-            },
-        ],
-    });
-});

package/lib/tests/rules/valid-story-reference.test.d.ts

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

package/lib/tests/rules/valid-story-reference.test.js

@@ -1,413 +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;
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * Tests for: docs/stories/006.0-DEV-FILE-VALIDATION.story.md
- * @story docs/stories/006.0-DEV-FILE-VALIDATION.story.md
- * @req REQ-FILE-EXISTENCE - Verify valid-story-reference rule enforces existing .story.md files
- * @story docs/stories/007.0-DEV-ERROR-REPORTING.story.md
- * @req REQ-ERROR-SPECIFIC - Verify file-related error messages are specific about failure causes
- * @req REQ-ERROR-CONTEXT - Verify file-related error messages include contextual information (path, underlying error)
- * @req REQ-ERROR-CONSISTENCY - Verify file-related error messages follow consistent formatting and identifiers
- * @req REQ-ERROR-HANDLING - Verify file-related errors are reported via diagnostics instead of uncaught exceptions
- * @supports docs/stories/006.0-DEV-FILE-VALIDATION.story.md REQ-FILE-EXISTENCE REQ-CONFIGURABLE-PATHS
- * @supports docs/stories/007.0-DEV-ERROR-REPORTING.story.md REQ-ERROR-SPECIFIC REQ-ERROR-CONTEXT REQ-ERROR-CONSISTENCY REQ-ERROR-HANDLING
- */
-const eslint_1 = require("eslint");
-const valid_story_reference_1 = __importDefault(require("../../src/rules/valid-story-reference"));
-const storyReferenceUtils_1 = require("../../src/utils/storyReferenceUtils");
-const path = __importStar(require("path"));
-const fsTestHelpers_1 = require("../utils/fsTestHelpers");
-const ruleTester = new eslint_1.RuleTester({
-    languageOptions: { parserOptions: { ecmaVersion: 2020 } },
-});
-describe("Valid Story Reference Rule (Story 006.0-DEV-FILE-VALIDATION)", () => {
-    ruleTester.run("valid-story-reference", valid_story_reference_1.default, {
-        valid: [
-            {
-                name: "[REQ-FILE-EXISTENCE] valid story file reference",
-                code: `// @story docs/stories/001.0-DEV-PLUGIN-SETUP.story.md`,
-            },
-            {
-                name: "[REQ-EXTENSION] valid .story.md extension",
-                code: `// @story docs/stories/002.0-DEV-ESLINT-CONFIG.story.md`,
-            },
-            {
-                name: "[REQ-PATH-RESOLUTION] valid relative path with ./ prefix",
-                code: `// @story ./docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md`,
-            },
-        ],
-        invalid: [
-            {
-                name: "[REQ-PATH-RESOLUTION] missing file",
-                code: `// @story docs/stories/missing-file.story.md`,
-                errors: [
-                    {
-                        messageId: "fileMissing",
-                        data: { path: "docs/stories/missing-file.story.md" },
-                    },
-                ],
-            },
-            {
-                name: "[REQ-EXTENSION] invalid extension",
-                code: `// @story docs/stories/001.0-DEV-PLUGIN-SETUP.md`,
-                errors: [
-                    {
-                        messageId: "invalidExtension",
-                        data: { path: "docs/stories/001.0-DEV-PLUGIN-SETUP.md" },
-                    },
-                ],
-            },
-            {
-                name: "[REQ-PATH-SECURITY] path traversal",
-                code: `// @story ../outside.story.md`,
-                errors: [
-                    { messageId: "invalidPath", data: { path: "../outside.story.md" } },
-                ],
-            },
-            {
-                name: "[REQ-ABSOLUTE-PATH] absolute path not allowed",
-                code: `// @story /etc/passwd.story.md`,
-                errors: [
-                    { messageId: "invalidPath", data: { path: "/etc/passwd.story.md" } },
-                ],
-            },
-        ],
-    });
-});
-// @story docs/stories/006.0-DEV-FILE-VALIDATION.story.md
-// @req REQ-CONFIGURABLE-PATHS - Verify custom storyDirectories behavior
-const configurablePathsTester = new eslint_1.RuleTester({
-    languageOptions: { parserOptions: { ecmaVersion: 2020 } },
-});
-configurablePathsTester.run("valid-story-reference", valid_story_reference_1.default, {
-    valid: [
-        {
-            name: "[REQ-CONFIGURABLE-PATHS] honors custom storyDirectories using docs/stories",
-            code: `// @story 001.0-DEV-PLUGIN-SETUP.story.md\n// @story docs/stories/006.0-DEV-FILE-VALIDATION.story.md`,
-            options: [{ storyDirectories: ["docs/stories"] }],
-        },
-    ],
-    invalid: [],
-});
-// @story docs/stories/006.0-DEV-FILE-VALIDATION.story.md
-// @req REQ-CONFIGURABLE-PATHS - Verify allowAbsolutePaths behavior
-const allowAbsolutePathsTester = new eslint_1.RuleTester({
-    languageOptions: { parserOptions: { ecmaVersion: 2020 } },
-});
-const absoluteStoryPath = path.resolve(process.cwd(), "docs/stories/001.0-DEV-PLUGIN-SETUP.story.md");
-allowAbsolutePathsTester.run("valid-story-reference", valid_story_reference_1.default, {
-    valid: [
-        {
-            name: "[REQ-CONFIGURABLE-PATHS] allowAbsolutePaths accepts existing absolute .story.md inside project",
-            code: `// @story ${absoluteStoryPath}\n// @story docs/stories/006.0-DEV-FILE-VALIDATION.story.md`,
-            options: [
-                {
-                    allowAbsolutePaths: true,
-                    storyDirectories: ["docs/stories"],
-                },
-            ],
-        },
-    ],
-    invalid: [
-        {
-            name: "[REQ-CONFIGURABLE-PATHS] disallows absolute paths when allowAbsolutePaths is false",
-            code: `// @story ${absoluteStoryPath}\n// @story docs/stories/006.0-DEV-FILE-VALIDATION.story.md`,
-            options: [
-                {
-                    allowAbsolutePaths: false,
-                    storyDirectories: ["docs/stories"],
-                },
-            ],
-            errors: [
-                {
-                    messageId: "invalidPath",
-                },
-            ],
-        },
-    ],
-});
-// @story docs/stories/006.0-DEV-FILE-VALIDATION.story.md
-// @req REQ-CONFIGURABLE-PATHS - Verify requireStoryExtension behavior
-const relaxedExtensionTester = new eslint_1.RuleTester({
-    languageOptions: { parserOptions: { ecmaVersion: 2020 } },
-});
-relaxedExtensionTester.run("valid-story-reference", valid_story_reference_1.default, {
-    valid: [
-        {
-            name: "[REQ-CONFIGURABLE-PATHS] accepts .story.md story path when requireStoryExtension is false (still valid and existing)",
-            code: `// @story docs/stories/001.0-DEV-PLUGIN-SETUP.story.md\n// @story docs/stories/006.0-DEV-FILE-VALIDATION.story.md`,
-            options: [
-                {
-                    storyDirectories: ["docs/stories"],
-                    requireStoryExtension: false,
-                },
-            ],
-        },
-    ],
-    invalid: [],
-});
-// @story docs/stories/006.0-DEV-FILE-VALIDATION.story.md
-// @req REQ-PROJECT-BOUNDARY - Verify project boundary handling
-const projectBoundaryTester = new eslint_1.RuleTester({
-    languageOptions: { parserOptions: { ecmaVersion: 2020 } },
-});
-projectBoundaryTester.run("valid-story-reference", valid_story_reference_1.default, {
-    valid: [],
-    invalid: [
-        {
-            name: "[REQ-PROJECT-BOUNDARY] story reference outside project root is rejected when discovered via absolute path",
-            code: `// @story ${path.resolve(path.sep, "outside-project", "001.0-DEV-PLUGIN-SETUP.story.md")}\n// @story docs/stories/006.0-DEV-FILE-VALIDATION.story.md`,
-            options: [
-                {
-                    allowAbsolutePaths: true,
-                    storyDirectories: [path.resolve(path.sep, "outside-project")],
-                },
-            ],
-            errors: [
-                {
-                    messageId: "invalidPath",
-                },
-            ],
-        },
-    ],
-});
-describe("Valid Story Reference Rule Configuration and Boundaries (Story 006.0-DEV-FILE-VALIDATION)", () => {
-    const fs = require("fs");
-    const pathModule = require("path");
-    let tempDirs = [];
-    afterEach(() => {
-        for (const dir of tempDirs) {
-            try {
-                fs.rmSync(dir, { recursive: true, force: true });
-            }
-            catch {
-                // ignore cleanup errors
-            }
-        }
-        tempDirs = [];
-        (0, storyReferenceUtils_1.__resetStoryExistenceCacheForTests)();
-        jest.restoreAllMocks();
-    });
-    it("[REQ-CONFIGURABLE-PATHS] uses storyDirectories when resolving relative paths (Story 006.0-DEV-FILE-VALIDATION)", () => {
-        const storyPath = pathModule.join(process.cwd(), "docs/stories/001.0-DEV-PLUGIN-SETUP.story.md");
-        (0, fsTestHelpers_1.mockFsForExistingFile)(fs, storyPath);
-        const diagnostics = runRuleOnCode(`// @story 001.0-DEV-PLUGIN-SETUP.story.md`, [{ storyDirectories: ["docs/stories"] }]);
-        // When storyDirectories is configured, the underlying resolution should
-        // treat the path as valid; absence of errors is asserted via RuleTester
-        // above. Here we just ensure no crash path via storyExists cache reset.
-        expect(Array.isArray(diagnostics)).toBe(true);
-    });
-    it("[REQ-CONFIGURABLE-PATHS] allowAbsolutePaths permits absolute paths inside project when enabled (Story 006.0-DEV-FILE-VALIDATION)", () => {
-        const absPath = pathModule.resolve(process.cwd(), "docs/stories/001.0-DEV-PLUGIN-SETUP.story.md");
-        const diagnostics = runRuleOnCode(`// @story ${absPath}`, [
-            {
-                allowAbsolutePaths: true,
-                storyDirectories: ["docs/stories"],
-            },
-        ]);
-        // Detailed behavior is verified by RuleTester above; this Jest test
-        // ensures helper path construction does not throw and diagnostics are collected.
-        expect(Array.isArray(diagnostics)).toBe(true);
-    });
-    it("[REQ-PROJECT-BOUNDARY] storyDirectories cannot escape project even when normalize resolves outside cwd (Story 006.0-DEV-FILE-VALIDATION)", () => {
-        const ruleModule = require("../../src/rules/valid-story-reference");
-        const originalCreate = ruleModule.default.create || ruleModule.create;
-        // Spy on create to intercept normalizeStoryPath behavior indirectly if needed
-        expect(typeof originalCreate).toBe("function");
-        const diagnostics = runRuleOnCode(`// @story ../outside-boundary.story.md\n// @story docs/stories/006.0-DEV-FILE-VALIDATION.story.md`);
-        // Behavior of reporting invalidPath for outside project is ensured
-        // in RuleTester projectBoundaryTester above; here ensure diagnostics collected.
-        expect(Array.isArray(diagnostics)).toBe(true);
-    });
-    /**
-     * @req REQ-PROJECT-BOUNDARY - Verify misconfigured storyDirectories pointing outside
-     * the project cannot cause external files to be treated as valid, and invalidPath is reported.
-     * @story docs/stories/006.0-DEV-FILE-VALIDATION.story.md
-     */
-    it("[REQ-PROJECT-BOUNDARY] misconfigured storyDirectories outside project cannot validate external files", () => {
-        const fs = require("fs");
-        const pathModule = require("path");
-        const outsideDir = pathModule.resolve(pathModule.sep, "tmp", "outside");
-        const outsideFile = pathModule.join(outsideDir, "external-story.story.md");
-        (0, fsTestHelpers_1.mockFsForExistingFile)(fs, outsideFile);
-        const diagnostics = runRuleOnCode(`// @story ${outsideFile}\n// @story docs/stories/006.0-DEV-FILE-VALIDATION.story.md`, [
-            {
-                allowAbsolutePaths: true,
-                storyDirectories: [outsideDir],
-            },
-        ]);
-        expect(Array.isArray(diagnostics)).toBe(true);
-        const invalidPathDiagnostics = diagnostics.filter((d) => d.messageId === "invalidPath");
-        expect(invalidPathDiagnostics.length).toBeGreaterThan(0);
-    });
-    /**
-     * @req REQ-CONFIGURABLE-PATHS - Verify requireStoryExtension: false allows .md story
-     * files that do not end with .story.md when they exist in storyDirectories.
-     * @story docs/stories/006.0-DEV-FILE-VALIDATION.story.md
-     */
-    it("[REQ-CONFIGURABLE-PATHS] requireStoryExtension=false accepts existing .md story file", () => {
-        const fs = require("fs");
-        const pathModule = require("path");
-        const storyPath = pathModule.join(process.cwd(), "docs/stories/developer-story.map.md");
-        (0, fsTestHelpers_1.mockFsForExistingFile)(fs, storyPath);
-        const diagnostics = runRuleOnCode(`// @story docs/stories/developer-story.map.md\n// @story docs/stories/006.0-DEV-FILE-VALIDATION.story.md`, [
-            {
-                storyDirectories: ["docs/stories"],
-                requireStoryExtension: false,
-            },
-        ]);
-        expect(Array.isArray(diagnostics)).toBe(true);
-        const invalidExtensionDiagnostics = diagnostics.filter((d) => d.messageId === "invalidExtension");
-        expect(invalidExtensionDiagnostics.length).toBe(0);
-    });
-});
-/**
- * Helper to run the valid-story-reference rule against a single source string
- * and collect reported diagnostics.
- *
- * @req REQ-ERROR-HANDLING - Used to verify fileAccessError reporting behavior
- * @story docs/stories/006.0-DEV-FILE-VALIDATION.story.md
- */
-function runRuleOnCode(code, options = []) {
-    const messages = [];
-    const context = {
-        report: (descriptor) => {
-            messages.push(descriptor);
-        },
-        getSourceCode: () => ({
-            text: code,
-            getAllComments: () => [
-                {
-                    type: "Line",
-                    value: code.replace(/^\/\//, "").trim(),
-                },
-            ],
-        }),
-        options,
-        parserOptions: { ecmaVersion: 2020 },
-    };
-    const listeners = valid_story_reference_1.default.create(context);
-    if (typeof listeners.Program === "function") {
-        listeners.Program({});
-    }
-    return messages;
-}
-describe("Valid Story Reference Rule Error Handling (Story 006.0-DEV-FILE-VALIDATION)", () => {
-    /**
-     * @req REQ-ERROR-HANDLING - Verify storyExists swallows fs errors and returns false
-     * instead of throwing when filesystem operations fail.
-     * @story docs/stories/006.0-DEV-FILE-VALIDATION.story.md
-     */
-    const fs = require("fs");
-    afterEach(() => {
-        jest.restoreAllMocks();
-    });
-    it("[REQ-ERROR-HANDLING] storyExists returns false when fs throws", () => {
-        jest.spyOn(fs, "existsSync").mockImplementation(() => {
-            const err = new Error("EACCES: permission denied");
-            err.code = "EACCES";
-            throw err;
-        });
-        jest.spyOn(fs, "statSync").mockImplementation(() => {
-            const err = new Error("EACCES: permission denied");
-            err.code = "EACCES";
-            throw err;
-        });
-        expect(() => (0, storyReferenceUtils_1.storyExists)(["docs/stories/permission-denied.story.md"])).not.toThrow();
-        expect((0, storyReferenceUtils_1.storyExists)(["docs/stories/permission-denied.story.md"])).toBe(false);
-    });
-    /**
-     * @req REQ-ERROR-HANDLING - Verify storyExists handles EIO from fs.statSync
-     * by returning false and not throwing when fs.existsSync returns true.
-     * @story docs/stories/006.0-DEV-FILE-VALIDATION.story.md
-     */
-    it("[REQ-ERROR-HANDLING] storyExists returns false when fs.statSync throws EIO and existsSync is true", () => {
-        jest.spyOn(fs, "existsSync").mockImplementation(() => true);
-        jest.spyOn(fs, "statSync").mockImplementation(() => {
-            const err = new Error("EIO: i/o error while reading file");
-            err.code = "EIO";
-            throw err;
-        });
-        expect(() => (0, storyReferenceUtils_1.storyExists)(["docs/stories/io-error.story.md"])).not.toThrow();
-        expect((0, storyReferenceUtils_1.storyExists)(["docs/stories/io-error.story.md"])).toBe(false);
-    });
-    /**
-     * @req REQ-ERROR-HANDLING - Verify rule reports fileAccessError when fs.statSync throws
-     * and fs.existsSync returns true, treating it as a filesystem access problem
-     * rather than a missing file.
-     * @story docs/stories/006.0-DEV-FILE-VALIDATION.story.md
-     */
-    it("[REQ-ERROR-HANDLING] rule reports fileAccessError when fs.statSync throws and existsSync is true", () => {
-        const accessError = new Error("EIO: i/o error while reading file metadata");
-        accessError.code = "EIO";
-        jest.spyOn(fs, "existsSync").mockImplementation(() => true);
-        jest.spyOn(fs, "statSync").mockImplementation(() => {
-            throw accessError;
-        });
-        const diagnostics = runRuleOnCode(`// @story docs/stories/fs-stat-io-error.story.md`);
-        expect(diagnostics.length).toBeGreaterThan(0);
-        const fileAccessDiagnostics = diagnostics.filter((d) => d.messageId === "fileAccessError");
-        expect(fileAccessDiagnostics.length).toBeGreaterThan(0);
-        const errorData = fileAccessDiagnostics[0].data;
-        expect(errorData).toBeDefined();
-        expect(String(errorData.error)).toMatch(/EIO/i);
-    });
-    /**
-     * @req REQ-ERROR-HANDLING - Verify rule reports fileAccessError when filesystem operations fail
-     * instead of treating it as a missing file.
-     * @story docs/stories/006.0-DEV-FILE-VALIDATION.story.md
-     */
-    it("[REQ-ERROR-HANDLING] rule reports fileAccessError when fs throws", () => {
-        const accessError = new Error("EACCES: permission denied while accessing");
-        accessError.code = "EACCES";
-        jest.spyOn(fs, "existsSync").mockImplementation(() => {
-            throw accessError;
-        });
-        jest.spyOn(fs, "statSync").mockImplementation(() => {
-            throw accessError;
-        });
-        const diagnostics = runRuleOnCode(`// @story docs/stories/fs-error.story.md`);
-        expect(diagnostics.length).toBeGreaterThan(0);
-        const fileAccessDiagnostics = diagnostics.filter((d) => d.messageId === "fileAccessError");
-        expect(fileAccessDiagnostics.length).toBeGreaterThan(0);
-        const errorData = fileAccessDiagnostics[0].data;
-        expect(errorData).toBeDefined();
-        expect(String(errorData.error)).toMatch(/EACCES/i);
-    });
-});

package/lib/tests/utils/annotation-checker-autofix-behavior.test.d.ts

@@ -1,5 +0,0 @@
-/**
- * Focused autofix behavior tests for annotation-checker helper.
- * @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md REQ-ANNOTATION-AUTOFIX REQ-ANNOTATION-REPORTING
- */
-export {};

package/lib/tests/utils/annotation-checker-autofix-behavior.test.js

@@ -1,103 +0,0 @@
-"use strict";
-/**
- * Focused autofix behavior tests for annotation-checker helper.
- * @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md REQ-ANNOTATION-AUTOFIX REQ-ANNOTATION-REPORTING
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-jest.mock("../../src/utils/reqAnnotationDetection", () => ({
-    // Always report that no requirement annotation is present so we exercise
-    // the missing-annotation reporting and autofix paths in the helper.
-    hasReqAnnotation: jest.fn(() => false),
-}));
-jest.mock("../../src/rules/helpers/require-story-utils", () => ({
-    // Provide a stable, human-readable name so reporting paths are predictable
-    // without depending on the full real implementation.
-    getNodeName: jest.fn(() => "mockName"),
-}));
-const annotation_checker_1 = require("../../src/utils/annotation-checker");
-/**
- * Build a minimal ESLint rule context stub that captures report() calls.
- *
- * @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md REQ-ANNOTATION-REPORTING
- */
-function createContextStub() {
-    const report = jest.fn();
-    const sourceCode = {
-        getJSDocComment: jest.fn(() => null),
-        getCommentsBefore: jest.fn(() => []),
-    };
-    const context = {
-        getSourceCode() {
-            return sourceCode;
-        },
-        report,
-    };
-    return { context, report };
-}
-describe("annotation-checker helper autofix behavior (Story 003.0-DEV-FUNCTION-ANNOTATIONS)", () => {
-    it("[REQ-ANNOTATION-AUTOFIX] attaches fix directly to node when parent is missing", () => {
-        const { context, report } = createContextStub();
-        const node = { type: "FunctionDeclaration" }; // no parent property
-        (0, annotation_checker_1.checkReqAnnotation)(context, node, { enableFix: true });
-        expect(report).toHaveBeenCalledTimes(1);
-        const reportArg = report.mock.calls[0][0];
-        expect(reportArg).toHaveProperty("fix");
-        const fixer = { insertTextBefore: jest.fn() };
-        reportArg.fix(fixer);
-        expect(fixer.insertTextBefore).toHaveBeenCalledWith(node, "/** @req <REQ-ID> */\n");
-    });
-    it("[REQ-ANNOTATION-AUTOFIX] attaches fix to MethodDefinition wrapper when parent is a method", () => {
-        const { context, report } = createContextStub();
-        const methodParent = { type: "MethodDefinition" };
-        const node = {
-            type: "FunctionExpression",
-            parent: methodParent,
-            id: { type: "Identifier", name: "methodImpl" },
-        };
-        (0, annotation_checker_1.checkReqAnnotation)(context, node, { enableFix: true });
-        expect(report).toHaveBeenCalledTimes(1);
-        const reportArg = report.mock.calls[0][0];
-        const fixer = { insertTextBefore: jest.fn() };
-        reportArg.fix(fixer);
-        expect(fixer.insertTextBefore).toHaveBeenCalledWith(methodParent, "/** @req <REQ-ID> */\n");
-    });
-    it("[REQ-ANNOTATION-AUTOFIX] attaches fix to VariableDeclarator when node is its init", () => {
-        const { context, report } = createContextStub();
-        const declarator = { type: "VariableDeclarator" };
-        const node = { type: "FunctionExpression", parent: declarator };
-        declarator.init = node;
-        (0, annotation_checker_1.checkReqAnnotation)(context, node, { enableFix: true });
-        expect(report).toHaveBeenCalledTimes(1);
-        const reportArg = report.mock.calls[0][0];
-        const fixer = { insertTextBefore: jest.fn() };
-        reportArg.fix(fixer);
-        expect(fixer.insertTextBefore).toHaveBeenCalledWith(declarator, "/** @req <REQ-ID> */\n");
-    });
-    it("[REQ-ANNOTATION-AUTOFIX] attaches fix to ExpressionStatement wrapper when parent is an expression", () => {
-        const { context, report } = createContextStub();
-        const expressionParent = { type: "ExpressionStatement" };
-        const node = {
-            type: "FunctionExpression",
-            parent: expressionParent,
-            id: { type: "Identifier", name: "iife" },
-        };
-        (0, annotation_checker_1.checkReqAnnotation)(context, node, { enableFix: true });
-        expect(report).toHaveBeenCalledTimes(1);
-        const reportArg = report.mock.calls[0][0];
-        const fixer = { insertTextBefore: jest.fn() };
-        reportArg.fix(fixer);
-        expect(fixer.insertTextBefore).toHaveBeenCalledWith(expressionParent, "/** @req <REQ-ID> */\n");
-    });
-    it("[REQ-ANNOTATION-AUTOFIX] omits fix when enableFix is false", () => {
-        const { context, report } = createContextStub();
-        const node = {
-            type: "FunctionDeclaration",
-            parent: { type: "Program" },
-            id: { type: "Identifier", name: "noFix" },
-        };
-        (0, annotation_checker_1.checkReqAnnotation)(context, node, { enableFix: false });
-        expect(report).toHaveBeenCalledTimes(1);
-        const reportArg = report.mock.calls[0][0];
-        expect(reportArg.fix).toBeUndefined();
-    });
-});