eslint-plugin-traceability 1.8.0 → 1.8.2

package/lib/tests/rules/require-req-annotation.test.js

@@ -14,7 +14,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * @req REQ-TYPESCRIPT-SUPPORT - Verify TypeScript declarations are checked via shared annotation checker helper
  *
  * @story docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md
- * @req REQ-REQUIRE-ACCEPTS-IMPLEMENTS - Verify @implements is accepted as satisfying requirement annotations
+ * @req REQ-REQUIRE-ACCEPTS-IMPLEMENTS - Verify @supports is accepted as satisfying requirement annotations
  */
 const eslint_1 = require("eslint");
 const require_req_annotation_1 = __importDefault(require("../../src/rules/require-req-annotation"));
@@ -25,6 +25,18 @@ const ruleTester = new eslint_1.RuleTester({
         parserOptions: { ecmaVersion: 2022, sourceType: "module" },
     },
 });
+/**
+ * Build a standard missingReq error object for a given function name.
+ *
+ * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
+ * @req REQ-ANNOTATION-REQUIRED - Standardize missingReq error shape in tests
+ */
+function missingReq(functionName) {
+    return {
+        messageId: "missingReq",
+        data: { name: functionName, functionName },
+    };
+}
 /**
  * @trace Story 003.0-DEV-FUNCTION-ANNOTATIONS / REQ-TYPESCRIPT-SUPPORT
  * Exercise the require-req-annotation rule's behavior on TSDeclareFunction and
@@ -50,22 +62,12 @@ const ruleTester = new eslint_1.RuleTester({
         {
             name: "[REQ-TYPESCRIPT-SUPPORT] missing @req on TSDeclareFunction",
             code: `declare function baz(): void;`,
-            errors: [
-                {
-                    messageId: "missingReq",
-                    data: { name: "baz", functionName: "baz" },
-                },
-            ],
+            errors: [missingReq("baz")],
         },
         {
             name: "[REQ-TYPESCRIPT-SUPPORT] missing @req on TSMethodSignature",
             code: `interface I { method(): void; }`,
-            errors: [
-                {
-                    messageId: "missingReq",
-                    data: { name: "method", functionName: "method" },
-                },
-            ],
+            errors: [missingReq("method")],
         },
     ],
 });
@@ -78,7 +80,7 @@ describe("Require Req Annotation Rule (Story 003.0-DEV-FUNCTION-ANNOTATIONS)", (
             },
             {
                 name: "[REQ-REQUIRE-ACCEPTS-IMPLEMENTS] valid with only @implements annotation",
-                code: `/**\n * @implements docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md REQ-ANNOTATION-REQUIRED\n */\nfunction implOnly() {}`,
+                code: `/**\n * @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md REQ-ANNOTATION-REQUIRED\n */\nfunction implOnly() {}`,
             },
             {
                 name: "[REQ-ANNOTATION-REQUIRED] valid with @story and @req annotations",
@@ -140,159 +142,84 @@ describe("Require Req Annotation Rule (Story 003.0-DEV-FUNCTION-ANNOTATIONS)", (
             {
                 name: "[REQ-ANNOTATION-REQUIRED][REQ-REQUIRE-ACCEPTS-IMPLEMENTS] missing @req on function without JSDoc remains invalid under multi-story support",
                 code: `function baz() {}`,
-                errors: [
-                    {
-                        messageId: "missingReq",
-                        data: { name: "baz", functionName: "baz" },
-                    },
-                ],
+                errors: [missingReq("baz")],
             },
             {
                 name: "[REQ-ANNOTATION-REQUIRED] missing @req on function with only @story annotation",
                 code: `/**\n * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md\n */\nfunction qux() {}`,
-                errors: [
-                    {
-                        messageId: "missingReq",
-                        data: { name: "qux", functionName: "qux" },
-                    },
-                ],
+                errors: [missingReq("qux")],
             },
             {
                 name: "[REQ-FUNCTION-DETECTION][Story 003.0] missing @req on FunctionExpression assigned to variable",
                 code: `const fn = function () {};`,
-                errors: [
-                    {
-                        messageId: "missingReq",
-                        data: { name: "fn", functionName: "fn" },
-                    },
-                ],
+                errors: [missingReq("fn")],
             },
             {
                 name: "[REQ-FUNCTION-DETECTION][Story 003.0] missing @req on anonymous FunctionExpression (no variable name)",
                 code: `(function () {})();`,
-                errors: [
-                    {
-                        messageId: "missingReq",
-                        data: { name: "(anonymous)", functionName: "(anonymous)" },
-                    },
-                ],
+                errors: [missingReq("(anonymous)")],
             },
             {
                 name: "[REQ-FUNCTION-DETECTION][Story 003.0] missing @req on MethodDefinition in class",
                 code: `class C {\n  m() {}\n}`,
-                errors: [
-                    {
-                        messageId: "missingReq",
-                        data: { name: "m", functionName: "m" },
-                    },
-                ],
+                errors: [missingReq("m")],
             },
             {
                 name: "[REQ-FUNCTION-DETECTION][Story 003.0] missing @req on MethodDefinition in object literal",
                 code: `const o = { m() {} };`,
-                errors: [
-                    {
-                        messageId: "missingReq",
-                        data: { name: "m", functionName: "m" },
-                    },
-                ],
+                errors: [missingReq("m")],
             },
             (0, ts_language_options_1.withTsLanguageOptions)({
                 name: "[REQ-TYPESCRIPT-SUPPORT][REQ-FUNCTION-DETECTION][Story 003.0] missing @req on TS FunctionExpression in variable declarator",
                 code: `const fn = function () {};`,
-                errors: [
-                    {
-                        messageId: "missingReq",
-                        data: { name: "fn", functionName: "fn" },
-                    },
-                ],
+                errors: [missingReq("fn")],
             }),
             (0, ts_language_options_1.withTsLanguageOptions)({
                 name: "[REQ-TYPESCRIPT-SUPPORT][REQ-FUNCTION-DETECTION][Story 003.0] missing @req on exported TS FunctionExpression in variable declarator",
                 code: `export const fn = function () {};`,
-                errors: [
-                    {
-                        messageId: "missingReq",
-                        data: { name: "fn", functionName: "fn" },
-                    },
-                ],
+                errors: [missingReq("fn")],
             }),
             {
                 name: "[REQ-CONFIGURABLE-SCOPE][Story 003.0] FunctionDeclaration still reported when scope only includes FunctionDeclaration",
                 code: `function scoped() {}`,
                 options: [{ scope: ["FunctionDeclaration"] }],
-                errors: [
-                    {
-                        messageId: "missingReq",
-                        data: { name: "scoped", functionName: "scoped" },
-                    },
-                ],
+                errors: [missingReq("scoped")],
             },
             {
                 name: "[REQ-EXPORT-PRIORITY][Story 003.0] exported function reported when exportPriority is 'exported'",
                 code: `export function exportedFn() {}`,
                 options: [{ exportPriority: "exported" }],
-                errors: [
-                    {
-                        messageId: "missingReq",
-                        data: { name: "exportedFn", functionName: "exportedFn" },
-                    },
-                ],
+                errors: [missingReq("exportedFn")],
             },
             {
                 name: "[REQ-EXPORT-PRIORITY][Story 003.0] non-exported function reported when exportPriority is 'non-exported'",
                 code: `function nonExported() {}`,
                 options: [{ exportPriority: "non-exported" }],
-                errors: [
-                    {
-                        messageId: "missingReq",
-                        data: { name: "nonExported", functionName: "nonExported" },
-                    },
-                ],
+                errors: [missingReq("nonExported")],
             },
             {
                 name: "[REQ-EXPORT-PRIORITY][Story 003.0] exported method reported when exportPriority is 'exported'",
                 code: `export class C {\n  m() {}\n}`,
-                errors: [
-                    {
-                        messageId: "missingReq",
-                        data: { name: "m", functionName: "m" },
-                    },
-                ],
+                errors: [missingReq("m")],
                 options: [{ exportPriority: "exported" }],
             },
             {
                 name: "[REQ-EXPORT-PRIORITY][Story 003.0] non-exported method reported when exportPriority is 'non-exported'",
                 code: `class C {\n  m() {}\n}`,
-                errors: [
-                    {
-                        messageId: "missingReq",
-                        data: { name: "m", functionName: "m" },
-                    },
-                ],
+                errors: [missingReq("m")],
                 options: [{ exportPriority: "non-exported" }],
             },
             {
                 name: "[REQ-EXPORT-PRIORITY][Story 003.0] exported FunctionExpression reported when exportPriority is 'exported'",
                 code: `export const fn = function () {};`,
                 options: [{ exportPriority: "exported" }],
-                errors: [
-                    {
-                        messageId: "missingReq",
-                        data: { name: "fn", functionName: "fn" },
-                    },
-                ],
+                errors: [missingReq("fn")],
             },
             {
                 name: "[REQ-EXPORT-PRIORITY][Story 003.0] non-exported FunctionExpression reported when exportPriority is 'non-exported'",
                 code: `const fn = function () {};`,
                 options: [{ exportPriority: "non-exported" }],
-                errors: [
-                    {
-                        messageId: "missingReq",
-                        data: { name: "fn", functionName: "fn" },
-                    },
-                ],
+                errors: [missingReq("fn")],
             },
         ],
     });

package/lib/tests/rules/require-story-annotation.test.js

@@ -8,7 +8,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
  * @story docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md
  * @req REQ-ANNOTATION-REQUIRED - Verify require-story-annotation rule enforces @story annotation on functions
- * @req REQ-REQUIRE-ACCEPTS-IMPLEMENTS - Verify @implements annotation is accepted as satisfying story requirements
+ * @req REQ-REQUIRE-ACCEPTS-IMPLEMENTS - Verify @supports annotation is accepted as satisfying story requirements
  */
 const eslint_1 = require("eslint");
 const require_story_annotation_1 = __importDefault(require("../../src/rules/require-story-annotation"));
@@ -25,7 +25,7 @@ describe("Require Story Annotation Rule (Story 003.0-DEV-FUNCTION-ANNOTATIONS)",
             },
             {
                 name: "[REQ-REQUIRE-ACCEPTS-IMPLEMENTS] valid with only @implements annotation",
-                code: `/**\n * @implements docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md REQ-ANNOTATION-REQUIRED\n */\nfunction implOnly() {}`,
+                code: `/**\n * @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md REQ-ANNOTATION-REQUIRED\n */\nfunction implOnly() {}`,
             },
             {
                 name: "[REQ-ANNOTATION-REQUIRED] valid with line comment @story annotation",
@@ -65,7 +65,7 @@ declare function tsDecl(): void;`,
         invalid: [
             {
                 // Backward compatibility: plain unannotated functions remain invalid under multi-story support
-                name: "[REQ-ANNOTATION-REQUIRED][BACKCOMPAT] missing @story annotation on function with no @implements",
+                name: "[REQ-ANNOTATION-REQUIRED][BACKCOMPAT] missing @story annotation on function with no @supports",
                 code: `function bar() {}`,
                 output: `/** @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */\nfunction bar() {}`,
                 errors: [

package/lib/tests/rules/require-story-io-behavior.test.js

@@ -6,6 +6,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 const require_story_io_1 = require("../../src/rules/helpers/require-story-io");
+const ioTestHelpers_1 = require("../utils/ioTestHelpers");
 describe("Require Story IO helpers - additional behavior (Story 003.0)", () => {
     test("parentChainHasStory returns false when sourceCode.getCommentsBefore is not a function", () => {
         const fakeSource = {}; // no getCommentsBefore function
@@ -39,12 +40,6 @@ describe("Require Story IO helpers - additional behavior (Story 003.0)", () => {
         expect((0, require_story_io_1.fallbackTextBeforeHasStory)(fakeSource, node)).toBe(false);
     });
     test("fallbackTextBeforeHasStory detects @story in text before node.range", () => {
-        const story = "@story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md";
-        const pre = `/* ${story} */\n`;
-        const rest = "function y() {}";
-        const full = pre + rest;
-        const fakeSource = { getText: () => full };
-        const node = { range: [full.indexOf("function"), full.length] };
-        expect((0, require_story_io_1.fallbackTextBeforeHasStory)(fakeSource, node)).toBe(true);
+        (0, ioTestHelpers_1.runFallbackTextBeforeHasStoryDetectsStoryTest)("@story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md", require_story_io_1.fallbackTextBeforeHasStory);
     });
 });

package/lib/tests/rules/require-story-io.edgecases.test.js

@@ -6,6 +6,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 const require_story_io_1 = require("../../src/rules/helpers/require-story-io");
+const ioTestHelpers_1 = require("../utils/ioTestHelpers");
 describe("Require Story IO helpers - edge cases (Story 003.0)", () => {
     test("linesBeforeHasStory returns false when source.lines missing or node.loc missing", () => {
         const fakeSource = {};
@@ -24,13 +25,7 @@ describe("Require Story IO helpers - edge cases (Story 003.0)", () => {
         expect((0, require_story_io_1.fallbackTextBeforeHasStory)(fakeSource2, node2)).toBe(false);
     });
     test("fallbackTextBeforeHasStory detects @story in text before node.range", () => {
-        const story = "@story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md";
-        const pre = `/* ${story} */\\n`;
-        const rest = "function x() {}";
-        const full = pre + rest;
-        const fakeSource = { getText: () => full };
-        const node = { range: [full.indexOf("function"), full.length] };
-        expect((0, require_story_io_1.fallbackTextBeforeHasStory)(fakeSource, node)).toBe(true);
+        (0, ioTestHelpers_1.runFallbackTextBeforeHasStoryDetectsStoryTest)(require_story_io_1.fallbackTextBeforeHasStory);
     });
     test("parentChainHasStory returns true when ancestor comments contain @story", () => {
         const fakeSource = {

package/lib/tests/rules/require-story-visitors-edgecases.test.js

@@ -6,20 +6,20 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 const require_story_visitors_1 = require("../../src/rules/helpers/require-story-visitors");
+const makeVisitors = () => {
+    const fakeContext = { getFilename: () => "file.ts" };
+    const fakeSource = { getText: () => "" };
+    const options = { shouldProcessNode: () => true };
+    return (0, require_story_visitors_1.buildVisitors)(fakeContext, fakeSource, options);
+};
 describe("Require Story Visitors - behavior (Story 003.0)", () => {
     test("build visitors returns handlers for FunctionDeclaration and ArrowFunctionExpression", () => {
-        const fakeContext = { getFilename: () => "file.ts" };
-        const fakeSource = { getText: () => "" };
-        const options = { shouldProcessNode: () => true };
-        const visitors = (0, require_story_visitors_1.buildVisitors)(fakeContext, fakeSource, options);
+        const visitors = makeVisitors();
         expect(typeof visitors.FunctionDeclaration).toBe("function");
         expect(typeof visitors.ArrowFunctionExpression).toBe("function");
     });
     test("FunctionDeclaration handler uses context.getFilename and doesn't throw when node lacks id", () => {
-        const fakeContext = { getFilename: () => "file.ts" };
-        const fakeSource = { getText: () => "" };
-        const options = { shouldProcessNode: () => true };
-        const visitors = (0, require_story_visitors_1.buildVisitors)(fakeContext, fakeSource, options);
+        const visitors = makeVisitors();
         const handler = visitors.FunctionDeclaration;
         expect(() => handler({})).not.toThrow();
     });

package/lib/tests/rules/valid-annotation-format.test.js

@@ -20,9 +20,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * @req REQ-CONFIGURABLE-PATTERNS-FALLBACK - Invalid regex patterns fall back to default behavior without crashing
  * Tests for: docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md
  * @story docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md
- * @req REQ-IMPLEMENTS-PARSE - Rule parses @implements annotations with story and requirement references
- * @req REQ-FORMAT-VALIDATION - Rule validates story and requirement formats inside @implements annotations
- * @req REQ-MIXED-SUPPORT - Rule supports mixed @story/@req/@implements usage in the same comment
+ * @req REQ-SUPPORTS-PARSE - Rule parses @supports annotations with story and requirement references
+ * @req REQ-FORMAT-VALIDATION - Rule validates story and requirement formats inside @supports annotations
+ * @req REQ-MIXED-SUPPORT - Rule supports mixed @story/@req/@supports usage in the same comment
  */
 const eslint_1 = require("eslint");
 const valid_annotation_format_1 = __importDefault(require("../../src/rules/valid-annotation-format"));
@@ -174,24 +174,24 @@ describe("Valid Annotation Format Rule (Story 005.0-DEV-ANNOTATION-VALIDATION)",
                 ],
             },
             {
-                name: "[REQ-IMPLEMENTS-PARSE] valid single @implements with one story and one requirement (default patterns)",
+                name: "[REQ-IMPLEMENTS-PARSE] valid single @supports with one story and one requirement (default patterns)",
                 code: `/**
- * @implements docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md REQ-IMPLEMENTS-PARSE
+ * @supports docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md REQ-IMPLEMENTS-PARSE
  */`,
             },
             {
-                name: "[REQ-IMPLEMENTS-PARSE] valid multiple @implements lines with different stories and requirements",
+                name: "[REQ-IMPLEMENTS-PARSE] valid multiple @supports lines with different stories and requirements",
                 code: `/**
- * @implements docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md REQ-IMPLEMENTS-PARSE REQ-FORMAT-VALIDATION
- * @implements docs/stories/005.0-DEV-ANNOTATION-VALIDATION.story.md REQ-FORMAT-SPECIFICATION
+ * @supports docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md REQ-IMPLEMENTS-PARSE REQ-FORMAT-VALIDATION
+ * @supports docs/stories/005.0-DEV-ANNOTATION-VALIDATION.story.md REQ-FORMAT-SPECIFICATION
  */`,
             },
             {
-                name: "[REQ-MIXED-SUPPORT] valid mixed @story/@req/@implements usage in same block comment",
+                name: "[REQ-MIXED-SUPPORT] valid mixed @story/@req/@supports usage in same block comment",
                 code: `/**
  * @story docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md
  * @req REQ-MIXED-SUPPORT
- * @implements docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md REQ-IMPLEMENTS-PARSE REQ-FORMAT-VALIDATION REQ-MIXED-SUPPORT
+ * @supports docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md REQ-IMPLEMENTS-PARSE REQ-FORMAT-VALIDATION REQ-MIXED-SUPPORT
  */`,
             },
         ],
@@ -507,33 +507,33 @@ describe("Valid Annotation Format Rule (Story 005.0-DEV-ANNOTATION-VALIDATION)",
                 ],
             },
             makeInvalid({
-                name: "[REQ-IMPLEMENTS-PARSE] @implements with no value is invalid",
+                name: "[REQ-SUPPORTS-PARSE] @supports with no value is invalid",
                 code: `/**
- * @implements
+ * @supports
  */`,
                 messageId: "invalidImplementsFormat",
-                details: 'Missing story path and requirement IDs for @implements annotation. Expected a value like "docs/stories/005.0-DEV-EXAMPLE.story.md REQ-EXAMPLE".',
+                details: 'Missing story path and requirement IDs for @supports annotation. Expected a value like "docs/stories/005.0-DEV-EXAMPLE.story.md REQ-EXAMPLE".',
             }),
             makeInvalid({
-                name: "[REQ-IMPLEMENTS-PARSE] @implements with only story path and no requirement IDs is invalid",
+                name: "[REQ-SUPPORTS-PARSE] @supports with only story path and no requirement IDs is invalid",
                 code: `/**
- * @implements docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md
+ * @supports docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md
  */`,
                 messageId: "invalidImplementsFormat",
-                details: 'Missing requirement IDs for @implements annotation. Expected a value like "docs/stories/005.0-DEV-EXAMPLE.story.md REQ-EXAMPLE".',
+                details: 'Missing requirement IDs for @supports annotation. Expected a value like "docs/stories/005.0-DEV-EXAMPLE.story.md REQ-EXAMPLE".',
             }),
             makeInvalid({
-                name: "[REQ-FORMAT-VALIDATION] @implements with invalid story path format",
+                name: "[REQ-FORMAT-VALIDATION] @supports with invalid story path format",
                 code: `/**
- * @implements invalid/path.txt REQ-IMPLEMENTS-PARSE
+ * @supports invalid/path.txt REQ-IMPLEMENTS-PARSE
  */`,
                 messageId: "invalidImplementsFormat",
-                details: 'Invalid story path "invalid/path.txt" for @implements annotation. Expected a path like "docs/stories/005.0-DEV-EXAMPLE.story.md".',
+                details: 'Invalid story path "invalid/path.txt" for @supports annotation. Expected a path like "docs/stories/005.0-DEV-EXAMPLE.story.md".',
             }),
             {
-                name: "[REQ-FORMAT-VALIDATION] @implements with invalid requirement ID format",
+                name: "[REQ-FORMAT-VALIDATION] @supports with invalid requirement ID format",
                 code: `/**
- * @implements docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md REQ-VALID invalid-format
+ * @supports docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md REQ-VALID invalid-format
  */`,
                 errors: [
                     {
@@ -545,9 +545,9 @@ describe("Valid Annotation Format Rule (Story 005.0-DEV-ANNOTATION-VALIDATION)",
                 ],
             },
             {
-                name: "[REQ-FORMAT-VALIDATION] @implements with multiple requirement IDs where one is invalid",
+                name: "[REQ-FORMAT-VALIDATION] @supports with multiple requirement IDs where one is invalid",
                 code: `/**
- * @implements docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md REQ-VALID-1 REQ-VALID-2 bad-id
+ * @supports docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md REQ-VALID-1 REQ-VALID-2 bad-id
  */`,
                 errors: [
                     {

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

@@ -33,13 +33,13 @@ describe("Valid Req Reference Rule (Story 010.0-DEV-DEEP-VALIDATION)", () => {
 // @req REQ-BULLET-LIST`,
             },
             {
-                name: "[REQ-DEEP-IMPLEMENTS] single implements line with multiple requirements in multi-story fixture (see 010.2-DEV-MULTI-STORY-SUPPORT)",
-                code: `// @implements tests/fixtures/story_multi_a.md REQ-SHARED-ID REQ-ONLY-A`,
+                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 implements with shared requirement IDs (see 010.2-DEV-MULTI-STORY-SUPPORT)",
-                code: `// @implements tests/fixtures/story_multi_a.md REQ-SHARED-ID REQ-ONLY-A
-// @implements tests/fixtures/story_multi_b.md REQ-SHARED-ID REQ-ONLY-B`,
+                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: [
@@ -98,8 +98,8 @@ describe("Valid Req Reference Rule (Story 010.0-DEV-DEEP-VALIDATION)", () => {
                 ],
             },
             {
-                name: "[REQ-DEEP-IMPLEMENTS] missing implements requirement in multi-story fixture (see 010.2-DEV-MULTI-STORY-SUPPORT)",
-                code: `// @implements tests/fixtures/story_multi_a.md REQ-NOT-IN-A`,
+                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",
@@ -111,8 +111,8 @@ describe("Valid Req Reference Rule (Story 010.0-DEV-DEEP-VALIDATION)", () => {
                 ],
             },
             {
-                name: "[REQ-DEEP-IMPLEMENTS] disallow path traversal in implements story path (see 010.2-DEV-MULTI-STORY-SUPPORT)",
-                code: `// @implements ../tests/fixtures/story_multi_a.md REQ-SHARED-ID`,
+                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",

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

@@ -50,6 +50,7 @@ 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 } },
 });
@@ -223,19 +224,7 @@ describe("Valid Story Reference Rule Configuration and Boundaries (Story 006.0-D
     });
     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");
-        jest.spyOn(fs, "existsSync").mockImplementation((...args) => {
-            const p = args[0];
-            return p === storyPath;
-        });
-        jest.spyOn(fs, "statSync").mockImplementation((...args) => {
-            const p = args[0];
-            if (p === storyPath) {
-                return {
-                    isFile: () => true,
-                };
-            }
-            throw Object.assign(new Error("ENOENT"), { code: "ENOENT" });
-        });
+        (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
@@ -274,21 +263,7 @@ describe("Valid Story Reference Rule Configuration and Boundaries (Story 006.0-D
         const pathModule = require("path");
         const outsideDir = pathModule.resolve(pathModule.sep, "tmp", "outside");
         const outsideFile = pathModule.join(outsideDir, "external-story.story.md");
-        jest.spyOn(fs, "existsSync").mockImplementation((...args) => {
-            const p = args[0];
-            return p === outsideFile;
-        });
-        jest.spyOn(fs, "statSync").mockImplementation((...args) => {
-            const p = args[0];
-            if (p === outsideFile) {
-                return {
-                    isFile: () => true,
-                };
-            }
-            const err = new Error("ENOENT");
-            err.code = "ENOENT";
-            throw err;
-        });
+        (0, fsTestHelpers_1.mockFsForExistingFile)(fs, outsideFile);
         const diagnostics = runRuleOnCode(`// @story ${outsideFile}\n// @story docs/stories/006.0-DEV-FILE-VALIDATION.story.md`, [
             {
                 allowAbsolutePaths: true,
@@ -308,21 +283,7 @@ describe("Valid Story Reference Rule Configuration and Boundaries (Story 006.0-D
         const fs = require("fs");
         const pathModule = require("path");
         const storyPath = pathModule.join(process.cwd(), "docs/stories/developer-story.map.md");
-        jest.spyOn(fs, "existsSync").mockImplementation((...args) => {
-            const p = args[0];
-            return p === storyPath;
-        });
-        jest.spyOn(fs, "statSync").mockImplementation((...args) => {
-            const p = args[0];
-            if (p === storyPath) {
-                return {
-                    isFile: () => true,
-                };
-            }
-            const err = new Error("ENOENT");
-            err.code = "ENOENT";
-            throw err;
-        });
+        (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"],

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

@@ -11,10 +11,6 @@ const eslint_1 = require("eslint");
 const annotation_checker_1 = require("../../src/utils/annotation-checker");
 const ts_language_options_1 = require("./ts-language-options");
 const ruleTester = new eslint_1.RuleTester();
-const withTsAnnotationCheckerOptions = (test) => ({
-    ...test,
-    languageOptions: ts_language_options_1.tsRuleTesterLanguageOptions,
-});
 /**
  * Shared helper for running tests that exercise the annotation-checker logic
  * for TypeScript constructs.
@@ -26,8 +22,8 @@ const withTsAnnotationCheckerOptions = (test) => ({
 function runAnnotationCheckerTests(ruleName, config) {
     const { rule, valid, invalid } = config;
     ruleTester.run(ruleName, rule, {
-        valid: valid.map(withTsAnnotationCheckerOptions),
-        invalid: invalid.map(withTsAnnotationCheckerOptions),
+        valid: valid.map(ts_language_options_1.withTsLanguageOptions),
+        invalid: invalid.map(ts_language_options_1.withTsLanguageOptions),
     });
 }
 const rule = {

package/lib/tests/utils/fsTestHelpers.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Shared filesystem mocking utilities for rule tests.
+ *
+ * @story docs/stories/006.0-DEV-FILE-VALIDATION.story.md
+ * @req REQ-TEST-UTILS-FS - Provide helpers to reduce duplication in fs-related tests
+ */
+export declare function mockFsForExistingFile(fs: typeof import("fs"), filePath: string): void;

package/lib/tests/utils/fsTestHelpers.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mockFsForExistingFile = mockFsForExistingFile;
+/**
+ * Shared filesystem mocking utilities for rule tests.
+ *
+ * @story docs/stories/006.0-DEV-FILE-VALIDATION.story.md
+ * @req REQ-TEST-UTILS-FS - Provide helpers to reduce duplication in fs-related tests
+ */
+function mockFsForExistingFile(fs, filePath) {
+    jest.spyOn(fs, "existsSync").mockImplementation((...args) => {
+        const p = args[0];
+        return p === filePath;
+    });
+    jest.spyOn(fs, "statSync").mockImplementation((...args) => {
+        const p = args[0];
+        if (p === filePath) {
+            return {
+                isFile: () => true,
+            };
+        }
+        const err = new Error("ENOENT");
+        err.code = "ENOENT";
+        throw err;
+    });
+}

package/lib/tests/utils/ioTestHelpers.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Shared IO helper tests for require-story-io behavior.
+ *
+ * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
+ * @req REQ-TEST-UTILS-IO - Provide reusable helpers for IO-related edge case tests
+ */
+export declare function runFallbackTextBeforeHasStoryDetectsStoryTest(storyAnnotationOrFallbackFn?: string | ((_source: any, _node: any) => boolean), maybeFallbackFn?: (_source: any, _node: any) => boolean): void;