eslint-plugin-traceability 1.11.0 → 1.11.1

package/lib/src/utils/reqAnnotationDetection.js

@@ -138,6 +138,38 @@ function fallbackTextBeforeHasReq(sourceCode, node) {
     }
     return false;
 }
+/**
+ * Helper to combine advanced, location-based heuristics for requirement detection.
+ * Uses preceding lines, parent-chain comments, and fallback text windows to find @req/@supports.
+ * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
+ * @story docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md
+ * @req REQ-ANNOTATION-REQ-DETECTION - Use multiple heuristics to detect @req markers around the node
+ * @req REQ-REQUIRE-ACCEPTS-IMPLEMENTS - Use multiple heuristics to detect @supports markers around the node
+ */
+function hasReqInAdvancedHeuristics(sourceCode, node) {
+    if (!sourceCode || !node) {
+        return false;
+    }
+    return (linesBeforeHasReq(sourceCode, node) ||
+        parentChainHasReq(sourceCode, node) ||
+        fallbackTextBeforeHasReq(sourceCode, node));
+}
+/**
+ * Helper to check JSDoc and nearby comments for requirement annotations.
+ * Accepts both @req and @supports markers as evidence of requirement coverage.
+ * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
+ * @story docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md
+ * @req REQ-ANNOTATION-REQ-DETECTION - Determine presence of @req annotation in JSDoc/comments
+ * @req REQ-REQUIRE-ACCEPTS-IMPLEMENTS - Accept @supports as requirement coverage in JSDoc/comments
+ */
+function hasReqInJsdocOrComments(jsdoc, comments) {
+    if (jsdoc &&
+        typeof jsdoc.value === "string" &&
+        (jsdoc.value.includes("@req") || jsdoc.value.includes("@supports"))) {
+        return true;
+    }
+    return comments.some(commentContainsReq);
+}
 /**
  * Helper to determine whether a JSDoc or any nearby comments contain a requirement annotation.
  * Treats both @req and @supports annotations as evidence of requirement coverage.
@@ -151,30 +183,12 @@ function hasReqAnnotation(jsdoc, comments, context, node) {
         const sourceCode = context && typeof context.getSourceCode === "function"
             ? context.getSourceCode()
             : undefined;
-        // Prefer robust, location-based heuristics when sourceCode and node are available.
-        // @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
-        // @req REQ-ANNOTATION-REQ-DETECTION - Use multiple heuristics to detect @req markers around the node
-        // @req REQ-REQUIRE-ACCEPTS-IMPLEMENTS - Use multiple heuristics to detect @supports markers around the node
-        if (sourceCode && node) {
-            if (linesBeforeHasReq(sourceCode, node) ||
-                parentChainHasReq(sourceCode, node) ||
-                fallbackTextBeforeHasReq(sourceCode, node)) {
-                return true;
-            }
+        if (hasReqInAdvancedHeuristics(sourceCode, node)) {
+            return true;
         }
     }
     catch {
-        // Swallow detection errors and fall through to simple checks.
-        // @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
-        // @req REQ-ANNOTATION-REQ-DETECTION - Fail gracefully when advanced detection heuristics throw
+        // swallow and fall through to simple checks
     }
-    // BRANCH requirement detection on JSDoc or comments, accepting both @req and @supports.
-    // @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
-    // @story docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md
-    // @req REQ-ANNOTATION-REQ-DETECTION
-    // @req REQ-REQUIRE-ACCEPTS-IMPLEMENTS
-    return ((jsdoc &&
-        typeof jsdoc.value === "string" &&
-        (jsdoc.value.includes("@req") || jsdoc.value.includes("@supports"))) ||
-        comments.some(commentContainsReq));
+    return hasReqInJsdocOrComments(jsdoc, comments);
 }

package/lib/tests/cli-error-handling.test.js

@@ -7,6 +7,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * Tests for CLI error handling when plugin loading fails
  * @story docs/stories/001.0-DEV-PLUGIN-SETUP.story.md
  * @req REQ-ERROR-HANDLING - Plugin CLI should exit with error on rule load failure
+ * @supports docs/stories/001.0-DEV-PLUGIN-SETUP.story.md REQ-ERROR-HANDLING
  */
 const child_process_1 = require("child_process");
 const path_1 = __importDefault(require("path"));

package/lib/tests/config/eslint-config-validation.test.d.ts

@@ -1 +1,9 @@
+/**
+ * Tests for ESLint config rule schemas.
+ *
+ * @supports docs/stories/002.0-DEV-ESLINT-CONFIG.story.md
+ * @req REQ-RULE-OPTIONS
+ * @req REQ-CONFIG-VALIDATION
+ * @story docs/stories/002.0-DEV-ESLINT-CONFIG.story.md
+ */
 export {};

package/lib/tests/config/eslint-config-validation.test.js

@@ -1,4 +1,12 @@
 "use strict";
+/**
+ * Tests for ESLint config rule schemas.
+ *
+ * @supports docs/stories/002.0-DEV-ESLINT-CONFIG.story.md
+ * @req REQ-RULE-OPTIONS
+ * @req REQ-CONFIG-VALIDATION
+ * @story docs/stories/002.0-DEV-ESLINT-CONFIG.story.md
+ */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };

package/lib/tests/config/flat-config-presets-integration.test.js

@@ -36,9 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 /**
  * Tests for: docs/stories/002.0-DEV-ESLINT-CONFIG.story.md
  * @story docs/stories/002.0-DEV-ESLINT-CONFIG.story.md
- * @req REQ-CONFIG-PRESETS - Validate flat-config presets register traceability plugin and rules
- * @req REQ-FLAT-CONFIG - Ensure presets work with ESLint v9 flat config
- * @req REQ-PROJECT-INTEGRATION - Support seamless integration via documented preset usage
+ * @supports docs/stories/002.0-DEV-ESLINT-CONFIG.story.md REQ-CONFIG-PRESETS REQ-FLAT-CONFIG REQ-PROJECT-INTEGRATION
  */
 const use_at_your_own_risk_1 = require("eslint/use-at-your-own-risk");
 const index_1 = __importStar(require("../../src/index"));

package/lib/tests/config/require-story-annotation-config.test.d.ts

@@ -1 +1,10 @@
+/**
+ * Tests for the require-story-annotation rule schema configuration.
+ *
+ * Verifies that the ESLint rule options for require-story-annotation
+ * define the expected schema properties and constraints.
+ *
+ * @story docs/stories/002.0-DEV-ESLINT-CONFIG.story.md
+ * @supports docs/stories/002.0-DEV-ESLINT-CONFIG.story.md REQ-RULE-OPTIONS
+ */
 export {};

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

@@ -1,4 +1,13 @@
 "use strict";
+/**
+ * Tests for the require-story-annotation rule schema configuration.
+ *
+ * Verifies that the ESLint rule options for require-story-annotation
+ * define the expected schema properties and constraints.
+ *
+ * @story docs/stories/002.0-DEV-ESLINT-CONFIG.story.md
+ * @supports docs/stories/002.0-DEV-ESLINT-CONFIG.story.md REQ-RULE-OPTIONS
+ */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };

package/lib/tests/integration/cli-integration.test.js

@@ -3,6 +3,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Tests for CLI integration of the traceability plugin.
+ * Validates that the plugin registers correctly and enforces
+ * traceability-related rules when invoked via the ESLint CLI.
+ *
+ * @supports docs/stories/001.0-DEV-PLUGIN-SETUP.story.md REQ-PLUGIN-STRUCTURE
+ * @story docs/stories/001.0-DEV-PLUGIN-SETUP.story.md
+ */
 /**
  * Tests for CLI integration functionality
  * @story docs/stories/001.0-DEV-PLUGIN-SETUP.story.md
@@ -10,7 +18,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  */
 const child_process_1 = require("child_process");
 const path_1 = __importDefault(require("path"));
-describe("[docs/stories/001.0-DEV-PLUGIN-SETUP.story.md] CLI Integration (traceability plugin)", () => {
+describe("CLI Integration (Story 001.0-DEV-PLUGIN-SETUP)", () => {
     const eslintPkgDir = path_1.default.dirname(require.resolve("eslint/package.json"));
     const eslintCliPath = path_1.default.join(eslintPkgDir, "bin", "eslint.js");
     const configPath = path_1.default.resolve(__dirname, "../../eslint.config.js");

package/lib/tests/maintenance/batch.test.js

@@ -38,6 +38,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * @story docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md
  * @req REQ-MAINT-BATCH - Perform batch updates
  * @req REQ-MAINT-VERIFY - Verify annotation references
+ * @supports docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md REQ-MAINT-BATCH REQ-MAINT-VERIFY
  */
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));

package/lib/tests/maintenance/cli.test.js

@@ -11,6 +11,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * @req REQ-MAINT-REPORT - CLI reporting of stale annotations
  * @req REQ-MAINT-UPDATE - CLI updating of annotation references
  * @req REQ-MAINT-SAFE - Clear exit codes and non-destructive dry-run
+ * @supports docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md REQ-MAINT-DETECT REQ-MAINT-VERIFY REQ-MAINT-REPORT REQ-MAINT-UPDATE REQ-MAINT-SAFE
  */
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));

package/lib/tests/maintenance/detect-isolated.test.js

@@ -37,6 +37,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * Tests for: docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md
  * @story docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md
  * @req REQ-MAINT-DETECT - Detect stale annotation references
+ * @supports docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md REQ-MAINT-DETECT
  */
 const path = __importStar(require("path"));
 const os = __importStar(require("os"));

package/lib/tests/maintenance/detect.test.js

@@ -7,6 +7,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * Tests for: docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md
  * @story docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md
  * @req REQ-MAINT-DETECT - Detect stale annotation references
+ * @supports docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md REQ-MAINT-DETECT
  */
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));

package/lib/tests/maintenance/index.test.js

@@ -4,6 +4,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * Tests for: docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md
  * @story docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md
  * @req REQ-MAINT-SAFE - Ensure all maintenance tools are exported correctly
+ * @supports docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md REQ-MAINT-SAFE REQ-MAINT-DETECT REQ-MAINT-UPDATE REQ-MAINT-BATCH REQ-MAINT-VERIFY REQ-MAINT-REPORT
  */
 const maintenance_1 = require("../../src/maintenance");
 describe("Maintenance Tools Index Exports (Story 009.0-DEV-MAINTENANCE-TOOLS)", () => {

package/lib/tests/maintenance/report.test.js

@@ -38,6 +38,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * @story docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md
  * @req REQ-MAINT-REPORT - Generate maintenance report
  * @req REQ-MAINT-SAFE - Ensure operations are safe and reversible
+ * @supports docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md REQ-MAINT-REPORT REQ-MAINT-SAFE
  */
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));

package/lib/tests/maintenance/update-isolated.test.js

@@ -37,6 +37,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * Tests for: docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md
  * @story docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md
  * @req REQ-MAINT-UPDATE - Update annotation references
+ * @supports docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md REQ-MAINT-UPDATE
  */
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));

package/lib/tests/maintenance/update.test.js

@@ -7,6 +7,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * Tests for: docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md
  * @story docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md
  * @req REQ-MAINT-UPDATE - Update annotation references
+ * @supports docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md REQ-MAINT-UPDATE
  */
 const fs_1 = __importDefault(require("fs"));
 const os_1 = __importDefault(require("os"));

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

@@ -35,6 +35,8 @@ var __importStar = (this && this.__importStar) || (function () {
 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

package/lib/tests/plugin-setup-error.test.d.ts

@@ -2,4 +2,5 @@
  * Tests for: docs/stories/001.0-DEV-PLUGIN-SETUP.story.md
  * @story docs/stories/001.0-DEV-PLUGIN-SETUP.story.md
  * @req REQ-ERROR-HANDLING - Gracefully handles plugin loading errors and missing dependencies
+ * @supports docs/stories/001.0-DEV-PLUGIN-SETUP.story.md REQ-ERROR-HANDLING
  */

package/lib/tests/plugin-setup-error.test.js

@@ -3,6 +3,7 @@
  * Tests for: docs/stories/001.0-DEV-PLUGIN-SETUP.story.md
  * @story docs/stories/001.0-DEV-PLUGIN-SETUP.story.md
  * @req REQ-ERROR-HANDLING - Gracefully handles plugin loading errors and missing dependencies
+ * @supports docs/stories/001.0-DEV-PLUGIN-SETUP.story.md REQ-ERROR-HANDLING
  */
 describe("Traceability ESLint Plugin Error Handling (Story 001.0-DEV-PLUGIN-SETUP)", () => {
     beforeEach(() => {

package/lib/tests/plugin-setup.test.js

@@ -36,7 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 /**
  * Tests for: docs/stories/001.0-DEV-PLUGIN-SETUP.story.md
  * @story docs/stories/001.0-DEV-PLUGIN-SETUP.story.md
- * @req REQ-PLUGIN-STRUCTURE - plugin exports rules and configs
+ * @supports docs/stories/001.0-DEV-PLUGIN-SETUP.story.md REQ-PLUGIN-STRUCTURE
  */
 const index_1 = __importStar(require("../src/index"));
 describe("Traceability ESLint Plugin (Story 001.0-DEV-PLUGIN-SETUP)", () => {

package/lib/tests/rules/auto-fix-behavior-008.test.js

@@ -8,6 +8,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * @story docs/stories/008.0-DEV-AUTO-FIX.story.md
  * @req REQ-AUTOFIX-MISSING - Verify ESLint --fix automatically adds missing @story annotations to functions
  * @req REQ-AUTOFIX-FORMAT - Verify ESLint --fix corrects simple annotation format issues for @story annotations
+ * @supports docs/stories/008.0-DEV-AUTO-FIX.story.md REQ-AUTOFIX-MISSING REQ-AUTOFIX-FORMAT
  */
 const eslint_1 = require("eslint");
 const require_story_annotation_1 = __importDefault(require("../../src/rules/require-story-annotation"));
@@ -177,6 +178,21 @@ describe("Auto-fix behavior (Story 008.0-DEV-AUTO-FIX)", () => {
                         },
                     ],
                 },
+                {
+                    name: "[REQ-AUTOFIX-SELECTIVE] does not apply suffix fix when autoFix is false",
+                    code: `// @story docs/stories/005.0-DEV-ANNOTATION-VALIDATION.story`,
+                    output: null,
+                    options: [
+                        {
+                            autoFix: false,
+                        },
+                    ],
+                    errors: [
+                        {
+                            messageId: "invalidStoryFormat",
+                        },
+                    ],
+                },
             ],
         });
     });

package/lib/tests/rules/error-reporting.test.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 /**
  * Tests for: docs/stories/007.0-DEV-ERROR-REPORTING.story.md
  * @story docs/stories/007.0-DEV-ERROR-REPORTING.story.md
+ * @supports docs/stories/007.0-DEV-ERROR-REPORTING.story.md REQ-ERROR-SPECIFIC REQ-ERROR-SUGGESTION REQ-ERROR-CONTEXT REQ-ERROR-LOCATION
  * @req REQ-ERROR-SPECIFIC - Specific details about what annotation is missing or invalid
  * @req REQ-ERROR-SUGGESTION - Suggest concrete steps to fix the issue
  * @req REQ-ERROR-CONTEXT - Include relevant context in error messages

package/lib/tests/rules/prefer-implements-annotation.test.js

@@ -33,6 +33,14 @@ describe("prefer-implements-annotation rule (Story 010.3-DEV-MIGRATE-TO-SUPPORTS
                 name: "[REQ-BACKWARD-COMP-VALIDATION] comment with @supports only is ignored",
                 code: `/**\n * @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md REQ-ANNOTATION-REQUIRED\n */\nfunction alreadyImplements() {}`,
             },
+            {
+                name: "[REQ-BACKWARD-COMP-VALIDATION] comment with @story and @supports but no @req is ignored",
+                code: `/**\n * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md\n * @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md REQ-ANNOTATION-REQUIRED\n */\nfunction storyAndSupportsNoReq() {}`,
+            },
+            {
+                name: "[REQ-BACKWARD-COMP-VALIDATION] comment with @req and @supports but no @story is ignored",
+                code: `/**\n * @req REQ-ANNOTATION-REQUIRED\n * @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md REQ-ANNOTATION-REQUIRED\n */\nfunction reqAndSupportsNoStory() {}`,
+            },
         ],
         invalid: [
             {

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

@@ -11,6 +11,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * @req REQ-ERROR-SPECIFIC - Branch-level missing-annotation error messages are specific and informative
  * @req REQ-ERROR-CONSISTENCY - Branch-level missing-annotation error messages follow shared conventions
  * @req REQ-ERROR-SUGGESTION - Branch-level missing-annotation errors include suggestions when applicable
+ * @supports docs/stories/004.0-DEV-BRANCH-ANNOTATIONS.story.md REQ-BRANCH-DETECTION
+ * @supports docs/stories/007.0-DEV-ERROR-REPORTING.story.md REQ-ERROR-SPECIFIC REQ-ERROR-CONSISTENCY REQ-ERROR-SUGGESTION
  */
 const eslint_1 = require("eslint");
 const require_branch_annotation_1 = __importDefault(require("../../src/rules/require-branch-annotation"));

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

@@ -4,6 +4,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * Edge-case tests for: docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
  * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
  * @req REQ-AUTOFIX - Cover additional branch cases in require-story-core (addStoryFixer/reportMissing)
+ * @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md REQ-AUTOFIX
  */
 const require_story_core_1 = require("../../src/rules/helpers/require-story-core");
 const require_story_core_test_helpers_1 = require("../utils/require-story-core-test-helpers");

package/lib/tests/rules/require-story-core.autofix.test.js

@@ -4,6 +4,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * Tests for: docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
  * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
  * @req REQ-AUTOFIX - Cover additional branch cases in require-story-core (addStoryFixer/reportMissing)
+ * @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md REQ-AUTOFIX
  */
 const require_story_core_1 = require("../../src/rules/helpers/require-story-core");
 const require_story_helpers_1 = require("../../src/rules/helpers/require-story-helpers");

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

@@ -4,6 +4,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * Tests for: docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
  * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
  * @req REQ-AUTOFIX - Verify createMethodFix and reportMethod behaviors
+ * @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md REQ-AUTOFIX
  */
 const require_story_core_1 = require("../../src/rules/helpers/require-story-core");
 const require_story_helpers_1 = require("../../src/rules/helpers/require-story-helpers");

package/lib/tests/rules/require-story-helpers-edgecases.test.d.ts

@@ -2,5 +2,6 @@
  * Tests for: docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
  * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
  * @req REQ-HELPERS-EDGE-CASES - Edge-case behavior tests for helpers in require-story-helpers.ts
+ * @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md REQ-HELPERS-EDGE-CASES
  */
 export {};

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

@@ -3,6 +3,7 @@
  * Tests for: docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
  * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
  * @req REQ-HELPERS-EDGE-CASES - Edge-case behavior tests for helpers in require-story-helpers.ts
+ * @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md REQ-HELPERS-EDGE-CASES
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 const require_story_helpers_1 = require("../../src/rules/helpers/require-story-helpers");

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

@@ -4,6 +4,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * Tests for: docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
  * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
  * @req REQ-ANNOTATION-REQUIRED - Verify helper functions in require-story helpers produce correct fixes and reporting behavior
+ * @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md REQ-ANNOTATION-REQUIRED
  */
 const require_story_core_1 = require("../../src/rules/helpers/require-story-core");
 const require_story_helpers_1 = require("../../src/rules/helpers/require-story-helpers");
@@ -49,7 +50,7 @@ describe("Require Story Helpers (Story 003.0)", () => {
     test("reportMissing does not call context.report if JSDoc contains @story", () => {
         const node = {
             type: "FunctionDeclaration",
-            id: { name: "fn" },
+            id: { type: "Identifier", name: "fn" },
             range: [0, 10],
         };
         const fakeSource = {
@@ -68,7 +69,7 @@ describe("Require Story Helpers (Story 003.0)", () => {
     test("reportMissing calls context.report when no JSDoc story present", () => {
         const node = {
             type: "FunctionDeclaration",
-            id: { name: "fn2" },
+            id: { type: "Identifier", name: "fn2" },
             range: [0, 10],
         };
         const fakeSource = {
@@ -82,7 +83,7 @@ describe("Require Story Helpers (Story 003.0)", () => {
         (0, require_story_helpers_1.reportMissing)(context, fakeSource, { node, target: node });
         expect(context.report).toHaveBeenCalledTimes(1);
         const call = context.report.mock.calls[0][0];
-        expect(call.node).toBe(node);
+        expect(call.node).toBe(node.id);
         expect(call.messageId).toBe("missingStory");
     });
     /**

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

@@ -2,5 +2,6 @@
  * Tests for: docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
  * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
  * @req REQ-IO-BEHAVIOR-EDGE-CASES - Edge-case behavior tests for IO helpers in require-story-io.ts
+ * @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md REQ-IO-BEHAVIOR-EDGE-CASES
  */
 export {};

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

@@ -3,6 +3,7 @@
  * Tests for: docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
  * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
  * @req REQ-IO-BEHAVIOR-EDGE-CASES - Edge-case behavior tests for IO helpers in require-story-io.ts
+ * @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md REQ-IO-BEHAVIOR-EDGE-CASES
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 const require_story_io_1 = require("../../src/rules/helpers/require-story-io");

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

@@ -2,5 +2,6 @@
  * Tests for: docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
  * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
  * @req REQ-ANNOTATION-REQUIRED - Edge case tests for IO helpers (linesBeforeHasStory/fallbackTextBeforeHasStory/parentChainHasStory)
+ * @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md REQ-ANNOTATION-REQUIRED
  */
 export {};

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

@@ -3,6 +3,7 @@
  * Tests for: docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
  * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
  * @req REQ-ANNOTATION-REQUIRED - Edge case tests for IO helpers (linesBeforeHasStory/fallbackTextBeforeHasStory/parentChainHasStory)
+ * @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md REQ-ANNOTATION-REQUIRED
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 const require_story_io_1 = require("../../src/rules/helpers/require-story-io");

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

@@ -2,5 +2,6 @@
  * Tests for: docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
  * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
  * @req REQ-VISITORS-BEHAVIOR - Behavior tests for visitors in require-story-visitors.ts
+ * @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md REQ-VISITORS-BEHAVIOR
  */
 export {};

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

@@ -3,6 +3,7 @@
  * Tests for: docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
  * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
  * @req REQ-VISITORS-BEHAVIOR - Behavior tests for visitors in require-story-visitors.ts
+ * @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md REQ-VISITORS-BEHAVIOR
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 const require_story_visitors_1 = require("../../src/rules/helpers/require-story-visitors");

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

@@ -45,6 +45,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * @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"));

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

@@ -6,6 +6,7 @@ exports.runAnnotationCheckerTests = runAnnotationCheckerTests;
  * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
  * @req REQ-TYPESCRIPT-SUPPORT - Support TypeScript-specific function syntax
  * @req REQ-TEST-UTILS-TS-LANG - Shared TS RuleTester language options helper
+ * @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md REQ-TYPESCRIPT-SUPPORT REQ-TEST-UTILS-TS-LANG
  */
 const eslint_1 = require("eslint");
 const annotation_checker_1 = require("../../src/utils/annotation-checker");
@@ -52,7 +53,7 @@ const rule = {
         };
     },
 };
-describe("annotation-checker helper", () => {
+describe("annotation-checker helper (Story 003.0-DEV-FUNCTION-ANNOTATIONS)", () => {
     runAnnotationCheckerTests("annotation-checker", {
         rule,
         valid: [

package/lib/tests/utils/branch-annotation-helpers.test.js

@@ -5,9 +5,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * Tests for: docs/stories/004.0-DEV-BRANCH-ANNOTATIONS.story.md
  * @story docs/stories/004.0-DEV-BRANCH-ANNOTATIONS.story.md
  * @req REQ-CONFIGURABLE-SCOPE - Allow configuration of branch types for annotation enforcement
+ * @supports docs/stories/004.0-DEV-BRANCH-ANNOTATIONS.story.md REQ-CONFIGURABLE-SCOPE
  */
 const branch_annotation_helpers_1 = require("../../src/utils/branch-annotation-helpers");
-describe("validateBranchTypes helper", () => {
+describe("validateBranchTypes helper (Story 004.0-DEV-BRANCH-ANNOTATIONS)", () => {
     let context;
     beforeEach(() => {
         context = { options: [], report: jest.fn() };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint-plugin-traceability",
-  "version": "1.11.0",
+  "version": "1.11.1",
   "description": "A customizable ESLint plugin that enforces traceability annotations in your code, ensuring each implementation is linked to its requirement or test case.",
   "main": "lib/src/index.js",
   "types": "lib/src/index.d.ts",