eslint-plugin-traceability 1.21.0 → 1.21.1

package/CHANGELOG.md

@@ -1,9 +1,9 @@
-# [1.21.0](https://github.com/voder-ai/eslint-plugin-traceability/compare/v1.20.0...v1.21.0) (2025-12-19)
+## [1.21.1](https://github.com/voder-ai/eslint-plugin-traceability/compare/v1.21.0...v1.21.1) (2025-12-21)
 
 
-### Features
+### Bug Fixes
 
-* support inside-brace placement for function-level rules ([064b1a4](https://github.com/voder-ai/eslint-plugin-traceability/commit/064b1a4e7627b5e35afd074752724ab5958e9d8b))
+* **rules:** harden valid-annotation-format parsing ([7c914f1](https://github.com/voder-ai/eslint-plugin-traceability/commit/7c914f100b93923bec63f97dfa122e1c4686ecff))
 
 # Changelog
 

package/README.md

@@ -121,11 +121,12 @@ Traceability annotations are typically placed immediately adjacent to the code t
 
 - **Function-level (`traceability/require-story-annotation`, `traceability/require-req-annotation`)**
 
-  Function-level rules continue to accept annotations:
-  - As JSDoc blocks immediately preceding the function, or
-  - As line comments placed directly before the function declaration or expression.
+  Function-level rules support both before-function and inside-body placement, controlled by the same `annotationPlacement` option described above:
 
-  This placement is stable and supported for all current versions. Future versions may introduce an **inside-brace** placement mode for function bodies (similar to branch blocks) to align function annotations with the branch-level `"inside"` standard, but that behaviour is not yet implemented in the current release.
+  - `"before"` – Annotations are written as JSDoc blocks immediately preceding the function, or as line comments placed directly before the function declaration or expression.
+  - `"inside"` – Annotations are expected to appear on the first comment-only lines inside function and method bodies; comments before the function are ignored for block-bodied functions in this mode, while TypeScript declarations and signature-only nodes still rely on before-node annotations.
+
+  For full details and migration guidance between placement styles, see the [API Reference](user-docs/api-reference.md) and the migration guide ([user-docs/migration-guide.md](user-docs/migration-guide.md)).
 
 For full configuration details and migration guidance between placement styles, see:
 
@@ -429,4 +430,4 @@ For the canonical, user-facing security policy (including how to report vulnerab
 - Contribution guide: <https://github.com/voder-ai/eslint-plugin-traceability/blob/main/CONTRIBUTING.md>
 - Issue tracker: <https://github.com/voder-ai/eslint-plugin-traceability/issues>
 - Changelog: [CHANGELOG.md](CHANGELOG.md)
-- Versioning and Releases: This project uses semantic-release for automated versioning. The authoritative list of published versions and release notes is on GitHub Releases: <https://github.com/voder-ai/eslint-plugin-traceability/releases>
+- Versioning and Releases: This project uses semantic-release for automated versioning. The authoritative list of published versions and release notes is on GitHub Releases: <https://github.com/voder-ai/eslint-plugin-traceability/releases>

package/lib/src/maintenance/batch.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.batchUpdateAnnotations = batchUpdateAnnotations;
 exports.verifyAnnotations = verifyAnnotations;
+/* eslint-disable traceability/valid-annotation-format */
 const update_1 = require("./update");
 const detect_1 = require("./detect");
 /**

package/lib/src/maintenance/cli.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 "use strict";
+/* eslint-disable traceability/valid-annotation-format */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runMaintenanceCli = runMaintenanceCli;
 const commands_1 = require("./commands");

package/lib/src/maintenance/commands.js

@@ -5,6 +5,7 @@ exports.handleDetect = handleDetect;
 exports.handleVerify = handleVerify;
 exports.handleReport = handleReport;
 exports.handleUpdate = handleUpdate;
+/* eslint-disable traceability/valid-annotation-format */
 /**
  * Subcommand handlers for the traceability-maint CLI.
  *

package/lib/src/maintenance/detect.js

@@ -34,6 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.detectStaleAnnotations = detectStaleAnnotations;
+/* eslint-disable traceability/valid-annotation-format */
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const utils_1 = require("./utils");

package/lib/src/maintenance/report.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateMaintenanceReport = generateMaintenanceReport;
+/* eslint-disable traceability/valid-annotation-format */
 const detect_1 = require("./detect");
 /**
  * Generate a report of maintenance operations performed

package/lib/src/maintenance/update.js

@@ -34,6 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.updateAnnotationReferences = updateAnnotationReferences;
+/* eslint-disable traceability/valid-annotation-format */
 const fs = __importStar(require("fs"));
 const utils_1 = require("./utils");
 /**

package/lib/src/rules/helpers/require-story-core.js

@@ -5,6 +5,7 @@ exports.createAddStoryFix = createAddStoryFix;
 exports.createMethodFix = createMethodFix;
 exports.coreReportMissing = coreReportMissing;
 exports.coreReportMethod = coreReportMethod;
+/* eslint-disable traceability/valid-annotation-format */
 /**
  * Compute the insertion start offset for inserting annotations before a node.
  * This helper ensures we insert before any export wrapper when present, while

package/lib/src/rules/helpers/require-story-io.js

@@ -1,4 +1,5 @@
 "use strict";
+/* eslint-disable traceability/valid-annotation-format */
 /**
  * IO helpers for require-story detection moved to reduce helper module size
  * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md

package/lib/src/rules/helpers/require-test-traceability-helpers.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.determineIsTestFile = determineIsTestFile;
 exports.ensureFileSupportsAnnotation = ensureFileSupportsAnnotation;
 exports.handleCallExpression = handleCallExpression;
+/* eslint-disable traceability/valid-annotation-format */
 /**
  * Helper utilities for the require-test-traceability rule.
  *

package/lib/src/rules/helpers/valid-annotation-format-internal.d.ts

@@ -19,7 +19,7 @@ export interface PendingAnnotation {
  * boundaries), keeps any annotation tags that appear later in the line, and
  * supports common JSDoc styles such as leading "*".
  *
- * It detects @story, @req, and @supports tags while preserving the rest
+ * It detects `@story`, `@req`, and `@supports` tags while preserving the rest
  * of the line for downstream logic.
  */
 export declare function normalizeCommentLine(rawLine: string): string;
@@ -27,7 +27,7 @@ export declare function normalizeCommentLine(rawLine: string): string;
  * Detect whether a normalized comment line starts with a non-traceability JSDoc tag.
  *
  * This is used to distinguish regular JSDoc tags (e.g. @param, @returns) from
- * traceability-related annotations such as @story, @req, and @supports.
+ * traceability-related annotations such as `@story`, `@req`, and `@supports`.
  *
  * Supports coexistence with JSDoc by:
  * - Detecting boundaries between traceability tags and other tags

package/lib/src/rules/helpers/valid-annotation-format-internal.js

@@ -15,7 +15,7 @@ exports.isNonTraceabilityJSDocTagLine = isNonTraceabilityJSDocTagLine;
  * boundaries), keeps any annotation tags that appear later in the line, and
  * supports common JSDoc styles such as leading "*".
  *
- * It detects @story, @req, and @supports tags while preserving the rest
+ * It detects `@story`, `@req`, and `@supports` tags while preserving the rest
  * of the line for downstream logic.
  */
 function normalizeCommentLine(rawLine) {
@@ -40,7 +40,7 @@ function normalizeCommentLine(rawLine) {
  * Detect whether a normalized comment line starts with a non-traceability JSDoc tag.
  *
  * This is used to distinguish regular JSDoc tags (e.g. @param, @returns) from
- * traceability-related annotations such as @story, @req, and @supports.
+ * traceability-related annotations such as `@story`, `@req`, and `@supports`.
  *
  * Supports coexistence with JSDoc by:
  * - Detecting boundaries between traceability tags and other tags

package/lib/src/rules/helpers/valid-annotation-format-validators.d.ts

@@ -7,9 +7,9 @@
  * to read while still preserving all existing behavior.
  *
  * The implementation in this module supports:
- * - validation of @story annotations
- * - validation of @req annotations
- * - validation of @implements/@supports-style annotations
+ * - validation of `@story` annotations
+ * - validation of `@req` annotations
+ * - validation of `@implements`/`@supports`-style annotations
  * - safe, minimal auto-fixes for certain invalid formats
  *
  * @story docs/stories/005.0-DEV-ANNOTATION-VALIDATION.story.md
@@ -33,9 +33,9 @@
 import type { ResolvedAnnotationOptions } from "./valid-annotation-options";
 import type { PendingAnnotation } from "./valid-annotation-format-internal";
 /**
- * Report an invalid @story annotation without applying a fix.
+ * Report an invalid `@story` annotation without applying a fix.
  *
- * The invalid @story annotation is detected and reported but left unchanged.
+ * The invalid `@story` annotation is detected and reported but left unchanged.
  *
  * @story docs/stories/005.0-DEV-ANNOTATION-VALIDATION.story.md
  * @story docs/stories/008.0-DEV-AUTO-FIX.story.md
@@ -44,10 +44,10 @@ import type { PendingAnnotation } from "./valid-annotation-format-internal";
  */
 export declare function reportInvalidStoryFormat(context: any, comment: any, collapsed: string, options: ResolvedAnnotationOptions): void;
 /**
- * Compute the text replacement for an invalid @story annotation within a comment.
+ * Compute the text replacement for an invalid `@story` annotation within a comment.
  *
  * This helper:
- *   - finds the @story tag in the raw comment text,
+ *   - finds the `@story` tag in the raw comment text,
  *   - computes the character range of its value,
  *   - and returns an ESLint fix that replaces only that range.
  *
@@ -59,7 +59,7 @@ export declare function reportInvalidStoryFormat(context: any, comment: any, col
  */
 export declare function createStoryFix(context: any, comment: any, fixed: string): null | (() => any);
 /**
- * Report an invalid @story annotation and attempt a minimal, safe auto-fix
+ * Report an invalid `@story` annotation and attempt a minimal, safe auto-fix
  * for common path suffix issues by locating and replacing the path text
  * within the original comment.
  *
@@ -76,10 +76,10 @@ export declare function createStoryFix(context: any, comment: any, fixed: string
  */
 export declare function reportInvalidStoryFormatWithFix(context: any, comment: any, collapsed: string, fixed: string): void;
 /**
- * Validate a @story annotation value and report detailed errors when needed.
+ * Validate a `@story` annotation value and report detailed errors when needed.
  * Where safe and unambiguous, apply an automatic fix for missing suffixes.
  *
- * Processing of @story values includes:
+ * Processing of `@story` values includes:
  *   - trimming whitespace,
  *   - collapsing multi-line text,
  *   - matching against the configured story regex,
@@ -97,7 +97,7 @@ export declare function reportInvalidStoryFormatWithFix(context: any, comment: a
  */
 export declare function validateStoryAnnotation(context: any, comment: any, rawValue: string, options: ResolvedAnnotationOptions): void;
 /**
- * Validate a @req annotation value and report detailed errors when needed.
+ * Validate a `@req` annotation value and report detailed errors when needed.
  *
  * This behavior covers:
  *   - detecting missing identifiers,
@@ -115,14 +115,14 @@ export declare function validateStoryAnnotation(context: any, comment: any, rawV
  */
 export declare function validateReqAnnotation(context: any, comment: any, rawValue: string, options: ResolvedAnnotationOptions): void;
 /**
- * Validate an @supports annotation value and report detailed errors when needed.
+ * Validate an `@supports` annotation value and report detailed errors when needed.
  *
  * Expected format:
- *   @supports <storyPath> <REQ-ID> [<REQ-ID> ...]
+ *   `@supports <storyPath> <REQ-ID> [<REQ-ID> ...]`
  *
  * Validation rules:
  *   - Value must include at least a story path and one requirement ID.
- *   - Story path must match the same storyPattern used for @story (no auto-fix).
+ *   - Story path must match the same storyPattern used for `@story` (no auto-fix).
  *   - Each subsequent token must match reqPattern and is validated individually.
  *
  * Story path issues are reported with "invalidImplementsFormat" and

package/lib/src/rules/helpers/valid-annotation-format-validators.js

@@ -8,9 +8,9 @@
  * to read while still preserving all existing behavior.
  *
  * The implementation in this module supports:
- * - validation of @story annotations
- * - validation of @req annotations
- * - validation of @implements/@supports-style annotations
+ * - validation of `@story` annotations
+ * - validation of `@req` annotations
+ * - validation of `@implements`/`@supports`-style annotations
  * - safe, minimal auto-fixes for certain invalid formats
  *
  * @story docs/stories/005.0-DEV-ANNOTATION-VALIDATION.story.md
@@ -43,9 +43,9 @@ const valid_annotation_utils_1 = require("./valid-annotation-utils");
 const valid_implements_utils_1 = require("./valid-implements-utils");
 const valid_annotation_options_1 = require("./valid-annotation-options");
 /**
- * Report an invalid @story annotation without applying a fix.
+ * Report an invalid `@story` annotation without applying a fix.
  *
- * The invalid @story annotation is detected and reported but left unchanged.
+ * The invalid `@story` annotation is detected and reported but left unchanged.
  *
  * @story docs/stories/005.0-DEV-ANNOTATION-VALIDATION.story.md
  * @story docs/stories/008.0-DEV-AUTO-FIX.story.md
@@ -60,10 +60,10 @@ function reportInvalidStoryFormat(context, comment, collapsed, options) {
     });
 }
 /**
- * Compute the text replacement for an invalid @story annotation within a comment.
+ * Compute the text replacement for an invalid `@story` annotation within a comment.
  *
  * This helper:
- *   - finds the @story tag in the raw comment text,
+ *   - finds the `@story` tag in the raw comment text,
  *   - computes the character range of its value,
  *   - and returns an ESLint fix that replaces only that range.
  *
@@ -103,7 +103,7 @@ function createStoryFix(context, comment, fixed) {
     return () => (fixer) => fixer.replaceTextRange(fixRange, fixed);
 }
 /**
- * Report an invalid @story annotation and attempt a minimal, safe auto-fix
+ * Report an invalid `@story` annotation and attempt a minimal, safe auto-fix
  * for common path suffix issues by locating and replacing the path text
  * within the original comment.
  *
@@ -136,10 +136,10 @@ function reportInvalidStoryFormatWithFix(context, comment, collapsed, fixed) {
     });
 }
 /**
- * Validate a @story annotation value and report detailed errors when needed.
+ * Validate a `@story` annotation value and report detailed errors when needed.
  * Where safe and unambiguous, apply an automatic fix for missing suffixes.
  *
- * Processing of @story values includes:
+ * Processing of `@story` values includes:
  *   - trimming whitespace,
  *   - collapsing multi-line text,
  *   - matching against the configured story regex,
@@ -194,7 +194,7 @@ function validateStoryAnnotation(context, comment, rawValue, options) {
     reportInvalidStoryFormat(context, comment, collapsed, options);
 }
 /**
- * Validate a @req annotation value and report detailed errors when needed.
+ * Validate a `@req` annotation value and report detailed errors when needed.
  *
  * This behavior covers:
  *   - detecting missing identifiers,
@@ -222,33 +222,42 @@ function validateReqAnnotation(context, comment, rawValue, options) {
         });
         return;
     }
-    const collapsed = (0, valid_annotation_utils_1.collapseAnnotationValue)(trimmed);
-    // Allow mixed @req/@supports lines to pass without additional @req validation,
-    // while still validating simple multi-line @req identifiers that collapse
-    // to a single token.
-    if (collapsed.includes("@supports")) {
+    // Allow mixed `@req`/`@supports` lines to pass without additional `@req` validation.
+    if (trimmed.includes("@supports")) {
         return;
     }
-    const reqPattern = options.reqPattern;
+    const tokens = trimmed.split(/\s+/).filter(Boolean);
+    let reqId = tokens[0] || trimmed;
+    for (let index = 1; index < tokens.length; index += 1) {
+        const token = tokens[index];
+        if (token === "-" || token === "–" || token === "—")
+            break;
+        const candidate = `${reqId}${token}`;
+        if (reqId.endsWith("-") || options.reqPattern.test(candidate)) {
+            reqId = candidate;
+            continue;
+        }
+        break;
+    }
     // @story docs/stories/005.0-DEV-ANNOTATION-VALIDATION.story.md
     // @req REQ-REQ-FORMAT - Flag @req identifiers that do not match the configured pattern
-    if (!reqPattern.test(collapsed)) {
+    if (!options.reqPattern.test(reqId)) {
         context.report({
             node: comment,
             messageId: "invalidReqFormat",
-            data: { details: (0, valid_annotation_utils_1.buildReqErrorMessage)("invalid", collapsed, options) },
+            data: { details: (0, valid_annotation_utils_1.buildReqErrorMessage)("invalid", reqId, options) },
         });
     }
 }
 /**
- * Validate an @supports annotation value and report detailed errors when needed.
+ * Validate an `@supports` annotation value and report detailed errors when needed.
  *
  * Expected format:
- *   @supports <storyPath> <REQ-ID> [<REQ-ID> ...]
+ *   `@supports <storyPath> <REQ-ID> [<REQ-ID> ...]`
  *
  * Validation rules:
  *   - Value must include at least a story path and one requirement ID.
- *   - Story path must match the same storyPattern used for @story (no auto-fix).
+ *   - Story path must match the same storyPattern used for `@story` (no auto-fix).
  *   - Each subsequent token must match reqPattern and is validated individually.
  *
  * Story path issues are reported with "invalidImplementsFormat" and

package/lib/src/rules/helpers/valid-annotation-utils.js

@@ -5,6 +5,7 @@ exports.collapseAnnotationValue = collapseAnnotationValue;
 exports.getFixedStoryPath = getFixedStoryPath;
 exports.buildStoryErrorMessage = buildStoryErrorMessage;
 exports.buildReqErrorMessage = buildReqErrorMessage;
+/* eslint-disable traceability/valid-annotation-format */
 const valid_annotation_options_1 = require("./valid-annotation-options");
 /**
  * Shared constants and helpers for annotation-format validation.

package/lib/src/rules/helpers/valid-req-reference-helpers.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createValidReqReferenceProgramVisitor = createValidReqReferenceProgramVisitor;
+/* eslint-disable traceability/valid-annotation-format */
 /* eslint-env node */
 /**
  * Helper utilities for the "valid-req-reference" rule.

package/lib/src/rules/valid-annotation-format.js

@@ -5,7 +5,9 @@ const valid_annotation_format_internal_1 = require("./helpers/valid-annotation-f
 const valid_annotation_format_validators_1 = require("./helpers/valid-annotation-format-validators");
 function handleImplementsLine(normalized, pending, deps) {
     const { context, comment, options } = deps;
-    const isImplements = /@supports\b/.test(normalized);
+    // Only match `@supports` at the START of the normalized line to avoid
+    // false matches when this keyword appears in prose
+    const isImplements = /^@supports\b/.test(normalized);
     if (!isImplements) {
         return pending;
     }
@@ -15,8 +17,10 @@ function handleImplementsLine(normalized, pending, deps) {
 }
 function handleStoryOrReqLine(normalized, pending, deps) {
     const { context, comment, options } = deps;
-    const isStory = /@story\b/.test(normalized);
-    const isReq = /@req\b/.test(normalized);
+    // Only match `@story`/`@req` at the START of the normalized line to avoid
+    // false matches when these keywords appear in prose (e.g., "@returns ... `@story` annotations")
+    const isStory = /^@story\b/.test(normalized);
+    const isReq = /^@req\b/.test(normalized);
     if (!isStory && !isReq) {
         return pending;
     }
@@ -81,7 +85,7 @@ function processCommentLine({ normalized, pending, context, comment, options, })
     if (afterStoryOrReq !== pending) {
         return afterStoryOrReq;
     }
-    // Implement JSDoc tag coexistence behavior: terminate @story/@req values when a new non-traceability JSDoc tag line (e.g., @param, @returns) is encountered.
+    // Implement JSDoc tag coexistence behavior: terminate `@story`/`@req` values when a new non-traceability JSDoc tag line (e.g., @param, @returns) is encountered.
     // @supports docs/stories/022.0-DEV-JSDOC-COEXISTENCE.story.md REQ-ANNOTATION-TERMINATION REQ-CONTINUATION-LOGIC
     if ((0, valid_annotation_format_internal_1.isNonTraceabilityJSDocTagLine)(normalized)) {
         (0, valid_annotation_format_validators_1.finalizePendingAnnotation)(context, comment, options, pending);
@@ -96,13 +100,13 @@ function processCommentLine({ normalized, pending, context, comment, options, })
     return extendPendingAnnotation(normalized, pending);
 }
 /**
- * Process a single comment node and validate any @story/@req/@supports annotations it contains.
+ * Process a single comment node and validate any `@story`/`@req`/`@supports` annotations it contains.
  *
- * Supports @story and @req annotations whose values span multiple lines within the same
+ * Supports `@story` and `@req` annotations whose values span multiple lines within the same
  * comment block, collapsing whitespace so that the logical value can be
  * validated against the configured patterns.
  *
- * @supports annotations are validated immediately per-line and are not
+ * `@supports` annotations are validated immediately per-line and are not
  * accumulated into pending multi-line state.
  *
  * @story docs/stories/005.0-DEV-ANNOTATION-VALIDATION.story.md
@@ -172,8 +176,8 @@ exports.default = {
         },
         schema: (0, valid_annotation_options_1.getRuleSchema)(),
         /**
-         * This rule's fixable support is limited to safe @story path suffix normalization per Story 008.0.
-         * Fixes are limited strictly to adjusting the suffix portion of the @story path (e.g., adding
+         * This rule's fixable support is limited to safe `@story` path suffix normalization per Story 008.0.
+         * Fixes are limited strictly to adjusting the suffix portion of the `@story` path (e.g., adding
          * `.md` or `.story.md`), preserving all other comment text and whitespace exactly as written.
          *
          * @story docs/stories/008.0-DEV-AUTO-FIX.story.md
@@ -204,7 +208,7 @@ exports.default = {
         const optionErrors = (0, valid_annotation_options_1.getOptionErrors)();
         return {
             /**
-             * Program-level handler that inspects all comments for @story, @req, and @supports tags
+             * Program-level handler that inspects all comments for `@story`, `@req`, and `@supports` tags
              *
              * @story docs/stories/005.0-DEV-ANNOTATION-VALIDATION.story.md
              * @story docs/stories/008.0-DEV-AUTO-FIX.story.md

package/lib/src/utils/annotation-checker.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.checkReqAnnotation = checkReqAnnotation;
+/* eslint-disable traceability/valid-annotation-format */
 const require_story_utils_1 = require("../rules/helpers/require-story-utils");
 const reqAnnotationDetection_1 = require("./reqAnnotationDetection");
 const function_annotation_helpers_1 = require("./function-annotation-helpers");

package/lib/src/utils/reqAnnotationDetection.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.hasReqAnnotation = hasReqAnnotation;
+/* eslint-disable traceability/valid-annotation-format */
 /**
  * Shared @req detection helpers used by annotation-checker utilities.
  * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md

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

@@ -1,4 +1,5 @@
 "use strict";
+/* eslint-disable traceability/valid-annotation-format */
 /**
  * Tests for ESLint config rule schemas.
  *

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

@@ -33,6 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+/* eslint-disable traceability/valid-annotation-format */
 /**
  * Tests for: docs/stories/002.0-DEV-ESLINT-CONFIG.story.md
  * @story docs/stories/002.0-DEV-ESLINT-CONFIG.story.md

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

@@ -1,4 +1,5 @@
 "use strict";
+/* eslint-disable traceability/valid-annotation-format */
 /**
  * Tests for the require-story-annotation rule schema configuration.
  *

package/lib/tests/fixtures/stale/example.js

@@ -1,3 +1,4 @@
 "use strict";
+/* eslint-disable traceability/valid-annotation-format */
 // Sample code with stale annotation
 // @story docs/stories/non-existent.story.md

package/lib/tests/fixtures/update/example.js

@@ -1,3 +1,4 @@
 "use strict";
+/* eslint-disable traceability/valid-annotation-format */
 // Sample code with annotation to update
 // @story docs/stories/old.story.md

package/lib/tests/integration/annotation-placement-inside-prettier.integration.test.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+/* eslint-disable traceability/valid-annotation-format */
 /**
  * Prettier integration tests for annotationPlacement: "inside" across multiple branch types.
  * @story docs/stories/028.0-DEV-ANNOTATION-PLACEMENT-STANDARDIZATION.story.md

package/lib/tests/integration/catch-annotation-prettier.integration.test.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+/* eslint-disable traceability/valid-annotation-format */
 /**
  * Prettier integration tests for CatchClause annotation positions.
  * @story docs/stories/025.0-DEV-CATCH-ANNOTATION-POSITION.story.md

package/lib/tests/integration/else-if-annotation-prettier.integration.test.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+/* eslint-disable traceability/valid-annotation-format */
 /**
  * Prettier integration tests for else-if annotation positions.
  * @story docs/stories/026.0-DEV-ELSE-IF-ANNOTATION-POSITION.story.md

package/lib/tests/integration/prettier-test-helpers.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatWithPrettier = formatWithPrettier;
+/* eslint-disable traceability/valid-annotation-format */
 /**
  * Shared helpers for Prettier-based integration tests.
  * @story docs/stories/025.0-DEV-CATCH-ANNOTATION-POSITION.story.md

package/lib/tests/integration/require-traceability-test-callbacks.integration.test.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+/* eslint-disable traceability/valid-annotation-format */
 /**
  * Integration tests for require-traceability with configurable test callback exclusion.
  *

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

@@ -33,6 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+/* eslint-disable traceability/valid-annotation-format */
 /**
  * Tests for: docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md
  * @story docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md

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

@@ -33,6 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+/* eslint-disable traceability/valid-annotation-format */
 /**
  * Performance and stress tests for maintenance tools on large workspaces.
  * @supports docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md REQ-MAINT-DETECT REQ-MAINT-VERIFY REQ-MAINT-REPORT REQ-MAINT-UPDATE REQ-MAINT-BATCH

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

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+/* eslint-disable traceability/valid-annotation-format */
 /**
  * Performance tests for valid-annotation-format on large annotated files.
  *

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

@@ -33,6 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+/* eslint-disable traceability/valid-annotation-format */
 /**
  * Tests for: docs/stories/001.0-DEV-PLUGIN-SETUP.story.md
  * @story docs/stories/001.0-DEV-PLUGIN-SETUP.story.md

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

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+/* eslint-disable traceability/valid-annotation-format */
 /**
  * Tests for: docs/stories/007.0-DEV-ERROR-REPORTING.story.md
  * @story docs/stories/007.0-DEV-ERROR-REPORTING.story.md

package/lib/tests/rules/require-test-traceability.test.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+/* eslint-disable traceability/valid-annotation-format */
 /**
  * Tests for:
  * - docs/stories/020.0-DEV-TEST-ANNOTATION-VALIDATION.story.md

package/lib/tests/utils/branch-annotation-catch-insert-position.test.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+/* eslint-disable traceability/valid-annotation-format */
 /**
  * Unit tests for CatchClause insert position calculation.
  * @story docs/stories/004.0-DEV-BRANCH-ANNOTATIONS.story.md

package/lib/tests/utils/branch-annotation-else-if-insert-position.test.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+/* eslint-disable traceability/valid-annotation-format */
 /**
  * Unit tests for else-if insert position calculation.
  * @story docs/stories/004.0-DEV-BRANCH-ANNOTATIONS.story.md

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

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+/* eslint-disable traceability/valid-annotation-format */
 /**
  * Unit tests for branch annotation helpers
  * Tests for: docs/stories/004.0-DEV-BRANCH-ANNOTATIONS.story.md

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint-plugin-traceability",
-  "version": "1.21.0",
+  "version": "1.21.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",