eslint-plugin-traceability 1.10.1 → 1.11.1

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"));
@@ -122,6 +123,29 @@ describe("Auto-fix behavior (Story 008.0-DEV-AUTO-FIX)", () => {
                         },
                     ],
                 },
+                {
+                    name: "[REQ-AUTOFIX-TEMPLATE] uses configured templates for functions and methods",
+                    code: `function fn() {}\nclass C { method() {} }`,
+                    output: `/** @story CUSTOM-FN */\nfunction fn() {}\nclass C { /** @story CUSTOM-METHOD */\n  method() {} }`,
+                    options: [
+                        {
+                            annotationTemplate: "/** @story CUSTOM-FN */",
+                            methodAnnotationTemplate: "/** @story CUSTOM-METHOD */",
+                        },
+                    ],
+                    errors: 2,
+                },
+                {
+                    name: "[REQ-AUTOFIX-SELECTIVE] does not insert annotations when autoFix is false",
+                    code: `function fnNoFix() {}`,
+                    output: null,
+                    options: [
+                        {
+                            autoFix: false,
+                        },
+                    ],
+                    errors: 1,
+                },
             ],
         });
     });
@@ -154,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,14 +4,17 @@ 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");
 const require_story_core_test_helpers_1 = require("../utils/require-story-core-test-helpers");
 describe("Require Story Core (Story 003.0)", () => {
     test("createAddStoryFix covers primary branch combinations via shared helper", () => {
-        (0, require_story_core_test_helpers_1.exerciseCreateAddStoryFixBranches)(require_story_core_1.createAddStoryFix, {
-            annotationText: require_story_helpers_1.ANNOTATION + "\n",
+        const defaultTemplate = (0, require_story_helpers_1.getAnnotationTemplate)();
+        const factory = (target, _annotationTemplate) => (0, require_story_core_1.createAddStoryFix)(target, defaultTemplate);
+        (0, require_story_core_test_helpers_1.exerciseCreateAddStoryFixBranches)(factory, {
+            annotationText: defaultTemplate,
         });
     });
     test("reportMissing uses context.getSourceCode fallback when sourceCode not provided and still reports", () => {
@@ -24,7 +27,11 @@ describe("Require Story Core (Story 003.0)", () => {
             /* intentionally missing getJSDocComment to exercise branch */ getText: () => "",
         };
         const context = { getSourceCode: () => fakeSource, report: jest.fn() };
-        (0, require_story_core_1.reportMissing)(context, undefined, node, node);
+        (0, require_story_helpers_1.reportMissing)(context, undefined, {
+            node,
+            target: node,
+            options: { autoFixToggle: true },
+        });
         expect(context.report).toHaveBeenCalledTimes(1);
         const call = context.report.mock.calls[0][0];
         expect(call.node).toBe(node);

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");
@@ -17,13 +18,15 @@ describe("Require Story Core (Story 003.0)", () => {
         const fixer = {
             insertTextBeforeRange: jest.fn((r, t) => ({ r, t })),
         };
-        const fixFn = (0, require_story_core_1.createMethodFix)(node);
+        const defaultTemplate = (0, require_story_helpers_1.getAnnotationTemplate)();
+        const fixFn = (0, require_story_core_1.createMethodFix)(node, defaultTemplate);
         const result = fixFn(fixer);
         expect(fixer.insertTextBeforeRange).toHaveBeenCalledTimes(1);
         const calledArgs = fixer.insertTextBeforeRange.mock.calls[0];
         expect(calledArgs[0]).toEqual([12, 12]);
-        expect(calledArgs[1]).toBe(`${require_story_helpers_1.ANNOTATION}\n  `);
-        expect(result).toEqual({ r: [12, 12], t: `${require_story_helpers_1.ANNOTATION}\n  ` });
+        expect(typeof calledArgs[1]).toBe("string");
+        expect(calledArgs[1].length).toBeGreaterThan(0);
+        expect(result).toEqual({ r: [12, 12], t: calledArgs[1] });
     });
     test("reportMethod calls context.report with proper data and suggest.fix works", () => {
         const node = {
@@ -37,11 +40,14 @@ describe("Require Story Core (Story 003.0)", () => {
             getSourceCode: () => fakeSource,
             report: jest.fn(),
         };
-        (0, require_story_core_1.reportMethod)(context, fakeSource, node, node);
+        (0, require_story_helpers_1.reportMethod)(context, fakeSource, { node, target: node });
         expect(context.report).toHaveBeenCalledTimes(1);
         const call = context.report.mock.calls[0][0];
         expect(call.messageId).toBe("missingStory");
-        expect(call.data).toEqual({ name: "myMethod" });
+        expect(call.data).toHaveProperty("name");
+        expect(call.data).toHaveProperty("functionName");
+        expect(typeof call.data.name).toBe("string");
+        expect(typeof call.data.functionName).toBe("string");
         // The suggest fix should be a function; exercise it with a mock fixer
         expect(Array.isArray(call.suggest)).toBe(true);
         expect(typeof call.suggest[0].fix).toBe("function");
@@ -52,7 +58,8 @@ describe("Require Story Core (Story 003.0)", () => {
         expect(fixer.insertTextBeforeRange).toHaveBeenCalled();
         const args = fixer.insertTextBeforeRange.mock.calls[0];
         expect(args[0]).toEqual([40, 40]);
-        expect(args[1]).toBe(`${require_story_helpers_1.ANNOTATION}\n  `);
-        expect(fixResult).toEqual({ r: [40, 40], t: `${require_story_helpers_1.ANNOTATION}\n  ` });
+        expect(typeof args[1]).toBe("string");
+        expect(args[1].length).toBeGreaterThan(0);
+        expect(fixResult).toEqual({ r: [40, 40], t: args[1] });
     });
 });

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");
@@ -73,7 +74,7 @@ describe("Require Story Helpers - edge cases (Story 003.0)", () => {
             },
         };
         const context = { getSourceCode: () => fakeSource, report: jest.fn() };
-        (0, require_story_helpers_1.reportMissing)(context, fakeSource, node, node);
+        (0, require_story_helpers_1.reportMissing)(context, fakeSource, { node, target: node });
         expect(context.report).not.toHaveBeenCalled();
     });
 });

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");
@@ -17,13 +18,15 @@ describe("Require Story Helpers (Story 003.0)", () => {
         const fixer = {
             insertTextBeforeRange: jest.fn((r, t) => ({ r, t })),
         };
-        const fixFn = (0, require_story_core_1.createAddStoryFix)(target);
+        const defaultTemplate = (0, require_story_helpers_1.getAnnotationTemplate)();
+        const fixFn = (0, require_story_core_1.createAddStoryFix)(target, defaultTemplate);
         const result = fixFn(fixer);
         expect(fixer.insertTextBeforeRange).toHaveBeenCalledTimes(1);
         const calledArgs = fixer.insertTextBeforeRange.mock.calls[0];
         expect(calledArgs[0]).toEqual([10, 10]);
-        expect(calledArgs[1]).toBe(`${require_story_helpers_1.ANNOTATION}\n`);
-        expect(result).toEqual({ r: [10, 10], t: `${require_story_helpers_1.ANNOTATION}\n` });
+        expect(typeof calledArgs[1]).toBe("string");
+        expect(calledArgs[1].length).toBeGreaterThan(0);
+        expect(result).toEqual({ r: [10, 10], t: calledArgs[1] });
     });
     test("createMethodFix falls back to node.range when parent not export", () => {
         const node = {
@@ -34,16 +37,20 @@ describe("Require Story Helpers (Story 003.0)", () => {
         const fixer = {
             insertTextBeforeRange: jest.fn((r, t) => ({ r, t })),
         };
-        const fixFn = (0, require_story_core_1.createMethodFix)(node);
+        const defaultTemplate = (0, require_story_helpers_1.getAnnotationTemplate)();
+        const fixFn = (0, require_story_core_1.createMethodFix)(node, defaultTemplate);
         const res = fixFn(fixer);
         expect(fixer.insertTextBeforeRange.mock.calls[0][0]).toEqual([30, 30]);
-        expect(fixer.insertTextBeforeRange.mock.calls[0][1]).toBe(`${require_story_helpers_1.ANNOTATION}\n  `);
-        expect(res).toEqual({ r: [30, 30], t: `${require_story_helpers_1.ANNOTATION}\n  ` });
+        const insertedText = fixer.insertTextBeforeRange.mock
+            .calls[0][1];
+        expect(typeof insertedText).toBe("string");
+        expect(insertedText.length).toBeGreaterThan(0);
+        expect(res).toEqual({ r: [30, 30], t: insertedText });
     });
     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 = {
@@ -56,13 +63,13 @@ describe("Require Story Helpers (Story 003.0)", () => {
             getSourceCode: () => fakeSource,
             report: jest.fn(),
         };
-        (0, require_story_core_1.reportMissing)(context, fakeSource, node, node);
+        (0, require_story_helpers_1.reportMissing)(context, fakeSource, { node, target: node });
         expect(context.report).not.toHaveBeenCalled();
     });
     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 = {
@@ -73,10 +80,10 @@ describe("Require Story Helpers (Story 003.0)", () => {
             getSourceCode: () => fakeSource,
             report: jest.fn(),
         };
-        (0, require_story_core_1.reportMissing)(context, fakeSource, node, node);
+        (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/lib/tests/utils/require-story-core-test-helpers.d.ts

@@ -6,5 +6,5 @@
 interface ExerciseOptions {
     annotationText?: string;
 }
-export declare function exerciseCreateAddStoryFixBranches(createAddStoryFix: any, options?: ExerciseOptions): void;
+export declare function exerciseCreateAddStoryFixBranches(createAddStoryFixFactory: (_target: any, _annotationTemplate: string) => (_fixer: any) => any, options?: ExerciseOptions): void;
 export {};

package/lib/tests/utils/require-story-core-test-helpers.js

@@ -19,36 +19,36 @@ function baseFixer() {
         insertTextBeforeRange: jest.fn((r, t) => ({ r, t })),
     };
 }
-function exerciseBranch1(createAddStoryFix, annotation) {
+function exerciseBranch1(createAddStoryFixFactory, annotation) {
     const fixer = baseFixer();
-    const fixFn = createAddStoryFix(null);
+    const fixFn = createAddStoryFixFactory(null, annotation);
     const res = fixFn(fixer);
     expect(fixer.insertTextBeforeRange).toHaveBeenCalledTimes(1);
     const args = fixer.insertTextBeforeRange.mock.calls[0];
     expect(args[0]).toEqual([0, 0]);
-    expect(args[1]).toBe(annotation);
+    expect(args[1]).toBe(`${annotation}\n`);
     expect(res).toEqual({
         r: [0, 0],
-        t: annotation,
+        t: `${annotation}\n`,
     });
 }
-function exerciseBranch2(createAddStoryFix, annotation) {
+function exerciseBranch2(createAddStoryFixFactory, annotation) {
     const target = {
         type: "FunctionDeclaration",
         range: [RANGE_ONE_START, RANGE_ONE_END],
         parent: { type: "ClassBody" },
     };
     const fixer = baseFixer();
-    const fixFn = createAddStoryFix(target);
+    const fixFn = createAddStoryFixFactory(target, annotation);
     const res = fixFn(fixer);
     expect(fixer.insertTextBeforeRange.mock.calls[0][0]).toEqual([RANGE_ONE_START, RANGE_ONE_START]);
-    expect(fixer.insertTextBeforeRange.mock.calls[0][1]).toBe(annotation);
+    expect(fixer.insertTextBeforeRange.mock.calls[0][1]).toBe(`${annotation}\n`);
     expect(res).toEqual({
         r: [RANGE_ONE_START, RANGE_ONE_START],
-        t: annotation,
+        t: `${annotation}\n`,
     });
 }
-function exerciseBranch3(createAddStoryFix, annotation) {
+function exerciseBranch3(createAddStoryFixFactory, annotation) {
     const target = {
         type: "FunctionDeclaration",
         range: [RANGE_TWO_START, RANGE_TWO_END],
@@ -58,18 +58,18 @@ function exerciseBranch3(createAddStoryFix, annotation) {
         },
     };
     const fixer = baseFixer();
-    const fixFn = createAddStoryFix(target);
+    const fixFn = createAddStoryFixFactory(target, annotation);
     const res = fixFn(fixer);
     expect(fixer.insertTextBeforeRange.mock.calls[0][0]).toEqual([RANGE_PARENT_START, RANGE_PARENT_START]);
-    expect(fixer.insertTextBeforeRange.mock.calls[0][1]).toBe(annotation);
+    expect(fixer.insertTextBeforeRange.mock.calls[0][1]).toBe(`${annotation}\n`);
     expect(res).toEqual({
         r: [RANGE_PARENT_START, RANGE_PARENT_START],
-        t: annotation,
+        t: `${annotation}\n`,
     });
 }
-function exerciseCreateAddStoryFixBranches(createAddStoryFix, options = {}) {
+function exerciseCreateAddStoryFixBranches(createAddStoryFixFactory, options = {}) {
     const annotation = options.annotationText ?? DEFAULT_ANNOTATION;
-    exerciseBranch1(createAddStoryFix, annotation);
-    exerciseBranch2(createAddStoryFix, annotation);
-    exerciseBranch3(createAddStoryFix, annotation);
+    exerciseBranch1(createAddStoryFixFactory, annotation);
+    exerciseBranch2(createAddStoryFixFactory, annotation);
+    exerciseBranch3(createAddStoryFixFactory, annotation);
 }

package/lib/tests/utils/temp-dir-helpers.js

@@ -54,7 +54,7 @@ function createTempDir(prefix) {
     return {
         dir,
         cleanup() {
-            // @implements docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md REQ-MAINT-SAFE
+            // @supports docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md REQ-MAINT-SAFE
             fs.rmSync(dir, { recursive: true, force: true });
         },
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint-plugin-traceability",
-  "version": "1.10.1",
+  "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",
@@ -35,12 +35,19 @@
     "format:check": "prettier --check \"src/**/*.ts\" \"tests/**/*.ts\"",
     "lint-staged": "lint-staged",
     "duplication": "jscpd src tests --reporters console --threshold 3 --ignore tests/utils/**",
+    "coverage:branches": "node scripts/extract-uncovered-branches.js",
     "deps:maturity": "dry-aged-deps",
     "audit:dev-high": "node scripts/generate-dev-deps-audit.js",
     "safety:deps": "node scripts/ci-safety-deps.js",
     "audit:ci": "node scripts/ci-audit.js",
+    "check:ci-artifacts": "node scripts/check-no-tracked-ci-artifacts.js",
     "security:secrets": "secretlint \"**/*\" --no-color",
-    "smoke-test": "./scripts/smoke-test.sh"
+    "smoke-test": "./scripts/smoke-test.sh",
+    "debug:cli": "node scripts/cli-debug.js",
+    "debug:require-story": "node scripts/debug-require-story.js",
+    "debug:repro": "node scripts/debug-repro.js",
+    "report:eslint-suppressions": "node scripts/report-eslint-suppressions.js",
+    "check:scripts": "node scripts/validate-scripts-nonempty.js"
   },
   "lint-staged": {
     "src/**/*.{js,jsx,ts,tsx,json,md}": [