eslint-plugin-traceability 1.6.5 → 1.7.1

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

@@ -1,126 +1,62 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-const STORY_EXAMPLE_PATH = "docs/stories/005.0-DEV-EXAMPLE.story.md";
+const valid_annotation_options_1 = require("./helpers/valid-annotation-options");
+const valid_annotation_utils_1 = require("./helpers/valid-annotation-utils");
+const valid_implements_utils_1 = require("./helpers/valid-implements-utils");
+const valid_annotation_format_internal_1 = require("./helpers/valid-annotation-format-internal");
 /**
- * Constant to represent the "tag not found" index when searching
- * for @story or @req within a comment.
- *
- * @story docs/stories/005.0-DEV-ANNOTATION-VALIDATION.story.md
- * @story docs/stories/008.0-DEV-AUTO-FIX.story.md
- * @req REQ-AUTOFIX-FORMAT - Provide safe, minimal automatic fixes for common format issues
- * @req REQ-AUTOFIX-PRESERVE - Avoid risky text replacements when the annotation tag cannot be located
- */
-const TAG_NOT_FOUND_INDEX = -1;
-/**
- * Normalize a raw comment line to make annotation parsing more robust.
- *
- * This function trims whitespace, keeps any annotation tags that appear
- * later in the line, and supports common JSDoc styles such as leading "*".
- *
- * @story docs/stories/005.0-DEV-ANNOTATION-VALIDATION.story.md
- * @story docs/stories/008.0-DEV-AUTO-FIX.story.md
- * @req REQ-FLEXIBLE-PARSING - Support reasonable variations in whitespace and formatting
- * @req REQ-AUTOFIX-FORMAT - Provide safe, minimal automatic fixes for common format issues
- */
-function normalizeCommentLine(rawLine) {
-    const trimmed = rawLine.trim();
-    if (!trimmed) {
-        return "";
-    }
-    const annotationMatch = trimmed.match(/@story\b|@req\b/);
-    if (!annotationMatch || annotationMatch.index === undefined) {
-        const withoutLeadingStar = trimmed.replace(/^\*\s?/, "");
-        return withoutLeadingStar;
-    }
-    return trimmed.slice(annotationMatch.index);
-}
-/**
- * Collapse internal whitespace in an annotation value so that multi-line
- * annotations are treated as a single logical value.
- *
- * Example:
- *   "docs/stories/005.0-DEV-ANNOTATION-VALIDATION.story.md" across
- *   multiple lines will be collapsed before validation.
- *
- * @story docs/stories/005.0-DEV-ANNOTATION-VALIDATION.story.md
- * @story docs/stories/008.0-DEV-AUTO-FIX.story.md
- * @req REQ-MULTILINE-SUPPORT - Handle annotations split across multiple lines
- * @req REQ-AUTOFIX-FORMAT - Provide safe, minimal automatic fixes for common format issues
- */
-function collapseAnnotationValue(value) {
-    return value.replace(/\s+/g, "");
-}
-/**
- * Build a detailed error message for invalid @story annotations.
- *
- * @story docs/stories/005.0-DEV-ANNOTATION-VALIDATION.story.md
- * @story docs/stories/008.0-DEV-AUTO-FIX.story.md
- * @req REQ-ERROR-SPECIFICITY - Provide specific error messages for different format violations
- * @req REQ-AUTOFIX-FORMAT - Provide safe, minimal automatic fixes for common format issues
- */
-function buildStoryErrorMessage(kind, value) {
-    if (kind === "missing") {
-        return `Missing story path for @story annotation. Expected a path like "${STORY_EXAMPLE_PATH}".`;
-    }
-    return `Invalid story path "${value ?? ""}" for @story annotation. Expected a path like "${STORY_EXAMPLE_PATH}".`;
-}
-/**
- * Build a detailed error message for invalid @req annotations.
+ * Report an invalid @story annotation without applying a fix.
  *
  * @story docs/stories/005.0-DEV-ANNOTATION-VALIDATION.story.md
  * @story docs/stories/008.0-DEV-AUTO-FIX.story.md
- * @req REQ-ERROR-SPECIFICITY - Provide specific error messages for different format violations
+ * @story docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md
  * @req REQ-AUTOFIX-FORMAT - Provide safe, minimal automatic fixes for common format issues
  */
-function buildReqErrorMessage(kind, value) {
-    if (kind === "missing") {
-        return 'Missing requirement ID for @req annotation. Expected an identifier like "REQ-EXAMPLE".';
-    }
-    return `Invalid requirement ID "${value ?? ""}" for @req annotation. Expected an identifier like "REQ-EXAMPLE" (uppercase letters, numbers, and dashes only).`;
+function reportInvalidStoryFormat(context, comment, collapsed, options) {
+    context.report({
+        node: comment,
+        messageId: "invalidStoryFormat",
+        data: { details: (0, valid_annotation_utils_1.buildStoryErrorMessage)("invalid", collapsed, options) },
+    });
 }
 /**
- * Attempt a minimal, safe auto-fix for common @story path suffix issues.
+ * Compute the text replacement for an invalid @story annotation within a comment.
  *
- * Only handles:
- *   - missing ".md"
- *   - missing ".story.md"
- * and skips any paths with traversal segments (e.g. "..").
+ * This helper:
+ *   - 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.
  *
- * Returns the fixed path when safe, or null if no fix should be applied.
+ * Returns null when the tag or value cannot be safely located.
  *
  * @story docs/stories/008.0-DEV-AUTO-FIX.story.md
- * @req REQ-AUTOFIX-FORMAT - Provide safe, minimal automatic fixes for common format issues
- * @req REQ-AUTOFIX-SAFE - Auto-fix must be conservative and never broaden the referenced path
- * @req REQ-AUTOFIX-PRESERVE - Preserve surrounding formatting when normalizing story path suffixes
+ * @req REQ-AUTOFIX-SAFE
+ * @req REQ-AUTOFIX-PRESERVE
  */
-function getFixedStoryPath(original) {
-    if (original.includes("..")) {
+function createStoryFix(context, comment, fixed) {
+    const sourceCode = context.getSourceCode();
+    const commentText = sourceCode.getText(comment);
+    const search = "@story";
+    const tagIndex = commentText.indexOf(search);
+    if (tagIndex === valid_annotation_utils_1.TAG_NOT_FOUND_INDEX) {
         return null;
     }
-    if (/\.story\.md$/.test(original)) {
+    const afterTagIndex = tagIndex + search.length;
+    const rest = commentText.slice(afterTagIndex);
+    const valueMatch = rest.match(/[^\S\r\n]*([^\r\n*]+)/);
+    if (!valueMatch || valueMatch.index === undefined) {
         return null;
     }
-    if (/\.story$/.test(original)) {
-        return `${original}.md`;
-    }
-    if (/\.md$/.test(original)) {
-        return original.replace(/\.md$/, ".story.md");
-    }
-    return `${original}.story.md`;
-}
-/**
- * Report an invalid @story annotation without applying a fix.
- *
- * @story docs/stories/005.0-DEV-ANNOTATION-VALIDATION.story.md
- * @story docs/stories/008.0-DEV-AUTO-FIX.story.md
- * @req REQ-AUTOFIX-FORMAT - Provide safe, minimal automatic fixes for common format issues
- */
-function reportInvalidStoryFormat(context, comment, collapsed) {
-    context.report({
-        node: comment,
-        messageId: "invalidStoryFormat",
-        data: { details: buildStoryErrorMessage("invalid", collapsed) },
-    });
+    const valueStartInComment = afterTagIndex +
+        valueMatch.index +
+        (valueMatch[0].length - valueMatch[1].length);
+    const valueEndInComment = valueStartInComment + valueMatch[1].length;
+    const start = comment.range[0];
+    const fixRange = [
+        start + valueStartInComment,
+        start + valueEndInComment,
+    ];
+    return () => (fixer) => fixer.replaceTextRange(fixRange, fixed);
 }
 /**
  * Report an invalid @story annotation and attempt a minimal, safe auto-fix
@@ -135,43 +71,25 @@ function reportInvalidStoryFormat(context, comment, collapsed) {
  *
  * @story docs/stories/005.0-DEV-ANNOTATION-VALIDATION.story.md
  * @story docs/stories/008.0-DEV-AUTO-FIX.story.md
+ * @story docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md
  * @req REQ-PATH-FORMAT - Validate @story paths follow expected patterns
  * @req REQ-AUTOFIX-FORMAT - Provide safe, minimal automatic fixes for common format issues
  * @req REQ-AUTOFIX-SAFE - Auto-fix must be conservative and avoid changing semantics
  * @req REQ-AUTOFIX-PRESERVE - Auto-fix must preserve surrounding formatting and comments
  */
 function reportInvalidStoryFormatWithFix(context, comment, collapsed, fixed) {
-    const sourceCode = context.getSourceCode();
-    const commentText = sourceCode.getText(comment);
-    const search = "@story";
-    const tagIndex = commentText.indexOf(search);
-    if (tagIndex === TAG_NOT_FOUND_INDEX) {
-        reportInvalidStoryFormat(context, comment, collapsed);
+    const fixFactory = createStoryFix(context, comment, fixed);
+    if (!fixFactory) {
+        reportInvalidStoryFormat(context, comment, collapsed, (0, valid_annotation_options_1.getResolvedDefaults)());
         return;
     }
-    const afterTagIndex = tagIndex + search.length;
-    const rest = commentText.slice(afterTagIndex);
-    const valueMatch = rest.match(/[^\S\r\n]*([^\r\n*]+)/);
-    if (!valueMatch || valueMatch.index === undefined) {
-        reportInvalidStoryFormat(context, comment, collapsed);
-        return;
-    }
-    const valueStartInComment = afterTagIndex +
-        valueMatch.index +
-        (valueMatch[0].length - valueMatch[1].length);
-    const valueEndInComment = valueStartInComment + valueMatch[1].length;
-    const start = comment.range[0];
-    const fixRange = [
-        start + valueStartInComment,
-        start + valueEndInComment,
-    ];
     context.report({
         node: comment,
         messageId: "invalidStoryFormat",
-        data: { details: buildStoryErrorMessage("invalid", collapsed) },
-        fix(fixer) {
-            return fixer.replaceTextRange(fixRange, fixed);
+        data: {
+            details: (0, valid_annotation_utils_1.buildStoryErrorMessage)("invalid", collapsed, (0, valid_annotation_options_1.getResolvedDefaults)()),
         },
+        fix: fixFactory(),
     });
 }
 /**
@@ -180,147 +98,235 @@ function reportInvalidStoryFormatWithFix(context, comment, collapsed, fixed) {
  *
  * @story docs/stories/005.0-DEV-ANNOTATION-VALIDATION.story.md
  * @story docs/stories/008.0-DEV-AUTO-FIX.story.md
+ * @story docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md
  * @req REQ-PATH-FORMAT - Validate @story paths follow expected patterns
  * @req REQ-ERROR-SPECIFICITY - Provide specific error messages for different format violations
  * @req REQ-AUTOFIX-FORMAT - Provide safe, minimal automatic fixes for common format issues
+ * @req REQ-REGEX-VALIDATION - Validate configurable story regex patterns and fall back safely
+ * @req REQ-BACKWARD-COMP - Preserve behavior when invalid regex config is supplied
+ * @req REQ-MIXED-SUPPORT - Support mixed @story/@req/@implements usage in comments
  */
-function validateStoryAnnotation(context, comment, rawValue) {
+function validateStoryAnnotation(context, comment, rawValue, options) {
     const trimmed = rawValue.trim();
     if (!trimmed) {
         context.report({
             node: comment,
             messageId: "invalidStoryFormat",
-            data: { details: buildStoryErrorMessage("missing", null) },
+            data: { details: (0, valid_annotation_utils_1.buildStoryErrorMessage)("missing", null, options) },
         });
         return;
     }
-    const collapsed = collapseAnnotationValue(trimmed);
-    const pathPattern = /^docs\/stories\/[0-9]+\.[0-9]+-DEV-[\w-]+\.story\.md$/;
+    const collapsed = (0, valid_annotation_utils_1.collapseAnnotationValue)(trimmed);
+    const pathPattern = options.storyPattern;
     if (pathPattern.test(collapsed)) {
         return;
     }
     if (/\s/.test(trimmed)) {
-        reportInvalidStoryFormat(context, comment, collapsed);
+        reportInvalidStoryFormat(context, comment, collapsed, options);
         return;
     }
-    const fixed = getFixedStoryPath(collapsed);
+    const fixed = (0, valid_annotation_utils_1.getFixedStoryPath)(collapsed);
     if (fixed && pathPattern.test(fixed)) {
         reportInvalidStoryFormatWithFix(context, comment, collapsed, fixed);
         return;
     }
-    reportInvalidStoryFormat(context, comment, collapsed);
+    reportInvalidStoryFormat(context, comment, collapsed, options);
 }
 /**
  * Validate a @req annotation value and report detailed errors when needed.
  *
  * @story docs/stories/005.0-DEV-ANNOTATION-VALIDATION.story.md
  * @story docs/stories/008.0-DEV-AUTO-FIX.story.md
+ * @story docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md
  * @req REQ-REQ-FORMAT - Validate @req identifiers follow expected patterns
  * @req REQ-ERROR-SPECIFICITY - Provide specific error messages for different format violations
+ * @req REQ-REGEX-VALIDATION - Validate configurable requirement regex patterns and fall back safely
+ * @req REQ-BACKWARD-COMP - Preserve behavior when invalid regex config is supplied
+ * @req REQ-MIXED-SUPPORT - Support mixed @story/@req/@implements usage in comments
  */
-function validateReqAnnotation(context, comment, rawValue) {
+function validateReqAnnotation(context, comment, rawValue, options) {
     const trimmed = rawValue.trim();
     if (!trimmed) {
         context.report({
             node: comment,
             messageId: "invalidReqFormat",
-            data: { details: buildReqErrorMessage("missing", null) },
+            data: { details: (0, valid_annotation_utils_1.buildReqErrorMessage)("missing", null, options) },
         });
         return;
     }
-    const collapsed = collapseAnnotationValue(trimmed);
-    const reqPattern = /^REQ-[A-Z0-9-]+$/;
+    const collapsed = (0, valid_annotation_utils_1.collapseAnnotationValue)(trimmed);
+    const reqPattern = options.reqPattern;
     if (!reqPattern.test(collapsed)) {
         context.report({
             node: comment,
             messageId: "invalidReqFormat",
-            data: { details: buildReqErrorMessage("invalid", collapsed) },
+            data: { details: (0, valid_annotation_utils_1.buildReqErrorMessage)("invalid", collapsed, options) },
         });
     }
 }
 /**
- * Process a single comment node and validate any @story/@req annotations it contains.
+ * Validate an @implements annotation value and report detailed errors when needed.
+ *
+ * Expected format:
+ *   @implements <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).
+ *   - Each subsequent token must match reqPattern and is validated individually.
+ *
+ * Story path issues are reported with "invalidImplementsFormat" and
+ * requirement ID issues reuse the existing "invalidReqFormat" message.
+ *
+ * @story docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md
+ * @req REQ-IMPLEMENTS-PARSE - Parse @implements annotations without affecting @story/@req
+ * @req REQ-FORMAT-VALIDATION - Validate @implements story path and requirement IDs
+ * @req REQ-MIXED-SUPPORT - Support mixed @story/@req/@implements usage in comments
+ */
+function validateImplementsAnnotation(context, comment, rawValue, options) {
+    const deps = {
+        MIN_IMPLEMENTS_TOKENS: valid_implements_utils_1.MIN_IMPLEMENTS_TOKENS,
+        reportMissingImplementsReqIds: valid_implements_utils_1.reportMissingImplementsReqIds,
+        reportMissingImplementsValue: valid_implements_utils_1.reportMissingImplementsValue,
+        reportInvalidImplementsReqId: valid_implements_utils_1.reportInvalidImplementsReqId,
+        reportInvalidImplementsStoryPath: valid_implements_utils_1.reportInvalidImplementsStoryPath,
+    };
+    (0, valid_implements_utils_1.validateImplementsAnnotationHelper)(deps, context, comment, {
+        rawValue,
+        options,
+    });
+}
+/**
+ * Finalize and validate the currently pending annotation, if any.
+ *
+ * @story docs/stories/005.0-DEV-ANNOTATION-VALIDATION.story.md
+ * @story docs/stories/008.0-DEV-AUTO-FIX.story.md
+ * @story docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md
+ * @req REQ-SYNTAX-VALIDATION - Validate annotation syntax matches specification
+ * @req REQ-AUTOFIX-FORMAT - Provide safe, minimal automatic fixes for common format issues
+ * @req REQ-MIXED-SUPPORT - Support mixed @story/@req/@implements usage in comments
+ */
+function finalizePendingAnnotation(context, comment, options, pending) {
+    if (!pending) {
+        return null;
+    }
+    // @story docs/stories/005.0-DEV-ANNOTATION-VALIDATION.story.md
+    // @story docs/stories/008.0-DEV-AUTO-FIX.story.md
+    // @story docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md
+    // @req REQ-SYNTAX-VALIDATION - Dispatch validation based on annotation type
+    // @req REQ-AUTOFIX-FORMAT - Provide safe, minimal automatic fixes for common format issues
+    // @req REQ-MIXED-SUPPORT - Support mixed @story/@req/@implements usage in comments
+    if (pending.type === "story") {
+        validateStoryAnnotation(context, comment, pending.value, options);
+    }
+    else {
+        validateReqAnnotation(context, comment, pending.value, options);
+    }
+    return null;
+}
+/**
+ * Process a single normalized comment line and update the pending annotation state.
  *
- * Supports annotations whose values span multiple lines within the same
+ * @story docs/stories/005.0-DEV-ANNOTATION-VALIDATION.story.md
+ * @story docs/stories/008.0-DEV-AUTO-FIX.story.md
+ * @story docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md
+ * @req REQ-SYNTAX-VALIDATION - Start new pending annotation when a tag is found
+ * @req REQ-MULTILINE-SUPPORT - Treat subsequent lines as continuation for pending annotation
+ * @req REQ-AUTOFIX-FORMAT - Provide safe, minimal automatic fixes for common format issues
+ * @req REQ-IMPLEMENTS-PARSE - Parse @implements annotations without affecting @story/@req
+ * @req REQ-FORMAT-VALIDATION - Validate @implements story path and requirement IDs
+ * @req REQ-MIXED-SUPPORT - Support mixed @story/@req/@implements usage in comments
+ */
+function processCommentLine({ normalized, pending, context, comment, options, }) {
+    if (!normalized) {
+        return pending;
+    }
+    const isStory = /@story\b/.test(normalized);
+    const isReq = /@req\b/.test(normalized);
+    const isImplements = /@implements\b/.test(normalized);
+    // Handle @implements as an immediate, single-line annotation
+    if (isImplements) {
+        const implementsValue = normalized.replace(/^@implements\b/, "").trim();
+        validateImplementsAnnotation(context, comment, implementsValue, options);
+        return pending;
+    }
+    // @story docs/stories/005.0-DEV-ANNOTATION-VALIDATION.story.md
+    // @story docs/stories/008.0-DEV-AUTO-FIX.story.md
+    // @story docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md
+    // @req REQ-SYNTAX-VALIDATION - Start new pending annotation when a tag is found
+    // @req REQ-AUTOFIX-FORMAT - Provide safe, minimal automatic fixes for common format issues
+    // @req REQ-MIXED-SUPPORT - Support mixed @story/@req/@implements usage in comments
+    if (isStory || isReq) {
+        finalizePendingAnnotation(context, comment, options, pending);
+        const value = normalized.replace(/^@story\b|^@req\b/, "").trim();
+        return {
+            type: isStory ? "story" : "req",
+            value,
+            hasValue: value.trim().length > 0,
+        };
+    }
+    // @story docs/stories/005.0-DEV-ANNOTATION-VALIDATION.story.md
+    // @story docs/stories/008.0-DEV-AUTO-FIX.story.md
+    // @story docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md
+    // @req REQ-MULTILINE-SUPPORT - Treat subsequent lines as continuation for pending annotation
+    // @req REQ-AUTOFIX-FORMAT - Provide safe, minimal automatic fixes for common format issues
+    // @req REQ-MIXED-SUPPORT - Support mixed @story/@req/@implements usage in comments
+    if (pending) {
+        const continuation = normalized.trim();
+        if (!continuation) {
+            return pending;
+        }
+        const updatedValue = pending.value
+            ? `${pending.value} ${continuation}`
+            : continuation;
+        return {
+            ...pending,
+            value: updatedValue,
+            hasValue: pending.hasValue || continuation.length > 0,
+        };
+    }
+    return pending;
+}
+/**
+ * Process a single comment node and validate any @story/@req/@implements annotations it contains.
+ *
+ * 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.
  *
+ * @implements 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
  * @story docs/stories/008.0-DEV-AUTO-FIX.story.md
+ * @story docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md
  * @req REQ-MULTILINE-SUPPORT - Handle annotations split across multiple lines
  * @req REQ-FLEXIBLE-PARSING - Support reasonable variations in whitespace and formatting
  * @req REQ-AUTOFIX-FORMAT - Provide safe, minimal automatic fixes for common format issues
+ * @req REQ-IMPLEMENTS-PARSE - Parse @implements annotations without affecting @story/@req
+ * @req REQ-FORMAT-VALIDATION - Validate @implements story path and requirement IDs
+ * @req REQ-MIXED-SUPPORT - Support mixed @story/@req/@implements usage in comments
  */
-function processComment(context, comment) {
+function processComment(context, comment, options) {
     const rawLines = (comment.value || "").split(/\r?\n/);
     let pending = null;
-    /**
-     * Finalize and validate the currently pending annotation, if any.
-     *
-     * @story docs/stories/005.0-DEV-ANNOTATION-VALIDATION.story.md
-     * @story docs/stories/008.0-DEV-AUTO-FIX.story.md
-     * @req REQ-SYNTAX-VALIDATION - Validate annotation syntax matches specification
-     * @req REQ-AUTOFIX-FORMAT - Provide safe, minimal automatic fixes for common format issues
-     */
-    function finalizePending() {
-        if (!pending) {
-            return;
-        }
-        // @story docs/stories/005.0-DEV-ANNOTATION-VALIDATION.story.md
-        // @story docs/stories/008.0-DEV-AUTO-FIX.story.md
-        // @req REQ-SYNTAX-VALIDATION - Dispatch validation based on annotation type
-        // @req REQ-AUTOFIX-FORMAT - Provide safe, minimal automatic fixes for common format issues
-        if (pending.type === "story") {
-            validateStoryAnnotation(context, comment, pending.value);
-        }
-        else {
-            validateReqAnnotation(context, comment, pending.value);
-        }
-        pending = null;
-    }
     rawLines.forEach((rawLine) => {
-        const normalized = normalizeCommentLine(rawLine);
-        if (!normalized) {
-            return;
-        }
-        const isStory = /@story\b/.test(normalized);
-        const isReq = /@req\b/.test(normalized);
-        // @story docs/stories/005.0-DEV-ANNOTATION-VALIDATION.story.md
-        // @story docs/stories/008.0-DEV-AUTO-FIX.story.md
-        // @req REQ-SYNTAX-VALIDATION - Start new pending annotation when a tag is found
-        // @req REQ-AUTOFIX-FORMAT - Provide safe, minimal automatic fixes for common format issues
-        if (isStory || isReq) {
-            finalizePending();
-            const value = normalized.replace(/^@story\b|^@req\b/, "").trim();
-            pending = {
-                type: isStory ? "story" : "req",
-                value,
-                hasValue: value.trim().length > 0,
-            };
-            return;
-        }
-        // @story docs/stories/005.0-DEV-ANNOTATION-VALIDATION.story.md
-        // @story docs/stories/008.0-DEV-AUTO-FIX.story.md
-        // @req REQ-MULTILINE-SUPPORT - Treat subsequent lines as continuation for pending annotation
-        // @req REQ-AUTOFIX-FORMAT - Provide safe, minimal automatic fixes for common format issues
-        if (pending) {
-            const continuation = normalized.trim();
-            if (!continuation) {
-                return;
-            }
-            pending.value = pending.value
-                ? `${pending.value} ${continuation}`
-                : continuation;
-            pending.hasValue = pending.hasValue || continuation.length > 0;
-        }
+        const normalized = (0, valid_annotation_format_internal_1.normalizeCommentLine)(rawLine);
+        pending = processCommentLine({
+            normalized,
+            pending,
+            context,
+            comment,
+            options,
+        });
     });
-    finalizePending();
+    finalizePendingAnnotation(context, comment, options, pending);
 }
 exports.default = {
     meta: {
         type: "problem",
         docs: {
-            description: "Validate format and syntax of @story and @req annotations",
+            description: "Validate format and syntax of @story, @req, and @implements annotations",
             recommended: "error",
         },
         messages: {
@@ -338,8 +344,22 @@ exports.default = {
              * @req REQ-ERROR-CONSISTENCY - Use shared "Invalid annotation format: {{details}}." message pattern across rules
              */
             invalidReqFormat: "Invalid annotation format: {{details}}.",
+            /**
+             * @story docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md
+             * @req REQ-ERROR-SPECIFIC - Provide specific details about invalid @implements annotation format
+             * @req REQ-ERROR-CONTEXT - Include human-readable details about the expected @implements annotation format
+             * @req REQ-ERROR-CONSISTENCY - Use shared "Invalid annotation format: {{details}}." message pattern across rules
+             * @req REQ-FORMAT-VALIDATION - Validate @implements story path and requirement IDs
+             */
+            invalidImplementsFormat: "Invalid annotation format: {{details}}.",
+            /**
+             * @story docs/stories/010.1-DEV-CONFIGURABLE-PATTERNS.story.md
+             * @req REQ-REGEX-VALIDATION - Surface configuration errors for invalid regex patterns
+             * @req REQ-BACKWARD-COMP - Preserve behavior by falling back to default patterns on error
+             */
+            invalidRuleConfiguration: "Invalid configuration for valid-annotation-format: {{details}}",
         },
-        schema: [],
+        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
@@ -348,32 +368,59 @@ exports.default = {
          * @story docs/stories/008.0-DEV-AUTO-FIX.story.md
          * @req REQ-AUTOFIX-SAFE
          * @req REQ-AUTOFIX-PRESERVE
+         * @req REQ-REGEX-VALIDATION - Ensure regex configuration does not affect fix safety
+         * @req REQ-BACKWARD-COMP - Maintain previous auto-fix behavior under invalid configs
          */
         fixable: "code",
     },
     /**
      * @story docs/stories/005.0-DEV-ANNOTATION-VALIDATION.story.md
      * @story docs/stories/008.0-DEV-AUTO-FIX.story.md
+     * @story docs/stories/010.1-DEV-CONFIGURABLE-PATTERNS.story.md
+     * @story docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md
      * @req REQ-SYNTAX-VALIDATION - Ensure rule create function validates annotations syntax
      * @req REQ-FORMAT-SPECIFICATION - Implement formatting checks per specification
      * @req REQ-AUTOFIX-FORMAT - Provide safe, minimal automatic fixes for common format issues
+     * @req REQ-REGEX-VALIDATION - Derive validation regexes from shared options helper
+     * @req REQ-BACKWARD-COMP - Fall back to default patterns and continue validation on config errors
+     * @req REQ-IMPLEMENTS-PARSE - Parse @implements annotations without affecting @story/@req
+     * @req REQ-FORMAT-VALIDATION - Validate @implements story path and requirement IDs
+     * @req REQ-MIXED-SUPPORT - Support mixed @story/@req/@implements usage in comments
      */
     create(context) {
         const sourceCode = context.getSourceCode();
+        const options = (0, valid_annotation_options_1.resolveOptions)(context.options || []);
+        const optionErrors = (0, valid_annotation_options_1.getOptionErrors)();
         return {
             /**
-             * Program-level handler that inspects all comments for @story and @req tags
+             * Program-level handler that inspects all comments for @story, @req, and @implements tags
              *
              * @story docs/stories/005.0-DEV-ANNOTATION-VALIDATION.story.md
              * @story docs/stories/008.0-DEV-AUTO-FIX.story.md
+             * @story docs/stories/010.1-DEV-CONFIGURABLE-PATTERNS.story.md
+             * @story docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md
              * @req REQ-PATH-FORMAT - Validate @story paths follow expected patterns
              * @req REQ-REQ-FORMAT - Validate @req identifiers follow expected patterns
              * @req REQ-AUTOFIX-FORMAT - Provide safe, minimal automatic fixes for common format issues
+             * @req REQ-REGEX-VALIDATION - Surface regex configuration errors without blocking validation
+             * @req REQ-BACKWARD-COMP - Continue validating comments using default patterns on error
+             * @req REQ-IMPLEMENTS-PARSE - Parse @implements annotations without affecting @story/@req
+             * @req REQ-FORMAT-VALIDATION - Validate @implements story path and requirement IDs
+             * @req REQ-MIXED-SUPPORT - Support mixed @story/@req/@implements usage in comments
              */
-            Program() {
+            Program(node) {
+                if (optionErrors && optionErrors.length > 0) {
+                    optionErrors.forEach((details) => {
+                        context.report({
+                            node,
+                            messageId: "invalidRuleConfiguration",
+                            data: { details },
+                        });
+                    });
+                }
                 const comments = sourceCode.getAllComments() || [];
                 comments.forEach((comment) => {
-                    processComment(context, comment);
+                    processComment(context, comment, options);
                 });
             },
         };