eslint-plugin-traceability 1.0.3 → 1.0.5

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

@@ -1,87 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * Tests for: docs/stories/010.0-DEV-DEEP-VALIDATION.story.md
- * @story docs/stories/010.0-DEV-DEEP-VALIDATION.story.md
- * @req REQ-DEEP-PARSE - Verify valid-req-reference rule enforces existing requirement content
- */
-const eslint_1 = require("eslint");
-const valid_req_reference_1 = __importDefault(require("../../src/rules/valid-req-reference"));
-const ruleTester = new eslint_1.RuleTester({
-    languageOptions: { parserOptions: { ecmaVersion: 2020 } },
-});
-describe("Valid Req Reference Rule (Story 010.0-DEV-DEEP-VALIDATION)", () => {
-    ruleTester.run("valid-req-reference", valid_req_reference_1.default, {
-        valid: [
-            {
-                name: "[REQ-DEEP-PARSE] valid requirement reference existing in story file",
-                code: `// @story docs/stories/001.0-DEV-PLUGIN-SETUP.story.md
-// @req REQ-PLUGIN-STRUCTURE`,
-            },
-            {
-                name: "[REQ-DEEP-BULLET] valid bullet list requirement existing in bullet story fixture",
-                code: `// @story tests/fixtures/story_bullet.md
-// @req REQ-BULLET-LIST`,
-            },
-        ],
-        invalid: [
-            {
-                name: "[REQ-DEEP-MATCH] missing requirement in story file",
-                code: `// @story docs/stories/001.0-DEV-PLUGIN-SETUP.story.md
-// @req REQ-NON-EXISTENT`,
-                errors: [
-                    {
-                        messageId: "reqMissing",
-                        data: {
-                            reqId: "REQ-NON-EXISTENT",
-                            storyPath: "docs/stories/001.0-DEV-PLUGIN-SETUP.story.md",
-                        },
-                    },
-                ],
-            },
-            {
-                name: "[REQ-DEEP-PARSE] disallow path traversal in story path",
-                code: `// @story ../docs/stories/001.0-DEV-PLUGIN-SETUP.story.md
-// @req REQ-PLUGIN-STRUCTURE`,
-                errors: [
-                    {
-                        messageId: "invalidPath",
-                        data: {
-                            storyPath: "../docs/stories/001.0-DEV-PLUGIN-SETUP.story.md",
-                        },
-                    },
-                ],
-            },
-            {
-                name: "[REQ-DEEP-PARSE] disallow absolute path in story path",
-                code: `// @story /absolute/path/docs/stories/001.0-DEV-PLUGIN-SETUP.story.md
-// @req REQ-PLUGIN-STRUCTURE`,
-                errors: [
-                    {
-                        messageId: "invalidPath",
-                        data: {
-                            storyPath: "/absolute/path/docs/stories/001.0-DEV-PLUGIN-SETUP.story.md",
-                        },
-                    },
-                ],
-            },
-            {
-                name: "[REQ-DEEP-BULLET] missing bullet list requirement in bullet story fixture",
-                code: `// @story tests/fixtures/story_bullet.md
-// @req REQ-MISSING-BULLET`,
-                errors: [
-                    {
-                        messageId: "reqMissing",
-                        data: {
-                            reqId: "REQ-MISSING-BULLET",
-                            storyPath: "tests/fixtures/story_bullet.md",
-                        },
-                    },
-                ],
-            },
-        ],
-    });
-});

package/lib/tests/rules/valid-story-reference.test.d.ts

@@ -1 +0,0 @@
-export {};

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

@@ -1,69 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * Tests for: docs/stories/006.0-DEV-FILE-VALIDATION.story.md
- * @story docs/stories/006.0-DEV-FILE-VALIDATION.story.md
- * @req REQ-FILE-EXISTENCE - Verify valid-story-reference rule enforces existing .story.md files
- */
-const eslint_1 = require("eslint");
-const valid_story_reference_1 = __importDefault(require("../../src/rules/valid-story-reference"));
-const ruleTester = new eslint_1.RuleTester({
-    languageOptions: { parserOptions: { ecmaVersion: 2020 } },
-});
-describe("Valid Story Reference Rule (Story 006.0-DEV-FILE-VALIDATION)", () => {
-    ruleTester.run("valid-story-reference", valid_story_reference_1.default, {
-        valid: [
-            {
-                name: "[REQ-FILE-EXISTENCE] valid story file reference",
-                code: `// @story docs/stories/001.0-DEV-PLUGIN-SETUP.story.md`,
-            },
-            {
-                name: "[REQ-EXTENSION] valid .story.md extension",
-                code: `// @story docs/stories/002.0-DEV-ESLINT-CONFIG.story.md`,
-            },
-            {
-                name: "[REQ-PATH-RESOLUTION] valid relative path with ./ prefix",
-                code: `// @story ./docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md`,
-            },
-        ],
-        invalid: [
-            {
-                name: "[REQ-PATH-RESOLUTION] missing file",
-                code: `// @story docs/stories/missing-file.story.md`,
-                errors: [
-                    {
-                        messageId: "fileMissing",
-                        data: { path: "docs/stories/missing-file.story.md" },
-                    },
-                ],
-            },
-            {
-                name: "[REQ-EXTENSION] invalid extension",
-                code: `// @story docs/stories/001.0-DEV-PLUGIN-SETUP.md`,
-                errors: [
-                    {
-                        messageId: "invalidExtension",
-                        data: { path: "docs/stories/001.0-DEV-PLUGIN-SETUP.md" },
-                    },
-                ],
-            },
-            {
-                name: "[REQ-PATH-SECURITY] path traversal",
-                code: `// @story ../outside.story.md`,
-                errors: [
-                    { messageId: "invalidPath", data: { path: "../outside.story.md" } },
-                ],
-            },
-            {
-                name: "[REQ-ABSOLUTE-PATH] absolute path not allowed",
-                code: `// @story /etc/passwd.story.md`,
-                errors: [
-                    { messageId: "invalidPath", data: { path: "/etc/passwd.story.md" } },
-                ],
-            },
-        ],
-    });
-});

package/tests/integration/file-validation.test.ts

@@ -1,78 +0,0 @@
-/**
- * Integration tests for file-validation rules via ESLint CLI
- * @story docs/stories/006.0-DEV-FILE-VALIDATION.story.md
- * @req REQ-PERFORMANCE-OPTIMIZATION - Verify CLI integration of valid-story-reference and valid-req-reference rules
- */
-import { spawnSync } from "child_process";
-import path from "path";
-
-// Ensure ESLint CLI uses built plugin
-const eslintBin = path.resolve(__dirname, "../../node_modules/.bin/eslint");
-const configPath = path.resolve(__dirname, "../../eslint.config.js");
-
-describe("File and Req Validation CLI Integration (Story 006.0-DEV-FILE-VALIDATION)", () => {
-  function runLint(code: string, rules: string[]) {
-    const ruleArgs = ["--rule", "no-unused-vars:off"];
-    for (const r of rules) {
-      ruleArgs.push("--rule", r);
-    }
-    return spawnSync(
-      "node",
-      [
-        eslintBin,
-        "--no-config-lookup",
-        "--config",
-        configPath,
-        "--stdin",
-        "--stdin-filename",
-        "foo.js",
-        ...ruleArgs,
-      ],
-      {
-        encoding: "utf-8",
-        input: code,
-      },
-    );
-  }
-
-  it("[REQ-FILE-EXISTENCE] reports missing story file via CLI", () => {
-    // Arrange
-    const code = "// @story docs/stories/missing-file.story.md";
-    // Act
-    const res = runLint(code, ["traceability/valid-story-reference:error"]);
-    // Assert
-    expect(res.status).toBe(1);
-    expect(res.stdout).toContain("Story file");
-  });
-
-  it("[REQ-EXTENSION] reports invalid extension via CLI", () => {
-    // Arrange
-    const code = "// @story docs/stories/001.0-DEV-PLUGIN-SETUP.md";
-    // Act
-    const res = runLint(code, ["traceability/valid-story-reference:error"]);
-    // Assert
-    expect(res.status).toBe(1);
-    expect(res.stdout).toContain("Invalid story file extension");
-  });
-
-  it("[REQ-DEEP-PARSE] reports missing requirement via CLI", () => {
-    // Arrange
-    const code =
-      "// @story docs/stories/001.0-DEV-PLUGIN-SETUP.story.md\n// @req REQ-UNKNOWN";
-    // Act
-    const res = runLint(code, ["traceability/valid-req-reference:error"]);
-    // Assert
-    expect(res.status).toBe(1);
-    expect(res.stdout).toContain("Requirement 'REQ-UNKNOWN' not found");
-  });
-
-  it("[REQ-DEEP-MATCH] valid story and requirement via CLI", () => {
-    // Arrange
-    const code =
-      "// @story docs/stories/001.0-DEV-PLUGIN-SETUP.story.md\n// @req REQ-PLUGIN-STRUCTURE";
-    // Act
-    const res = runLint(code, ["traceability/valid-req-reference:error"]);
-    // Assert
-    expect(res.status).toBe(0);
-  });
-});

package/tests/integration/plugin-validation.test.ts

@@ -1,84 +0,0 @@
-/**
- * Integration tests for ESLint plugin via CLI
- * @story docs/stories/001.0-DEV-PLUGIN-SETUP.story.md
- * @req REQ-PLUGIN-STRUCTURE - Validate plugin registers via CLI
- */
-/* eslint-env node, jest */
-import { spawnSync, SpawnSyncReturns } from "child_process";
-import path from "path";
-
-// Ensure ESLint CLI uses built plugin
-const eslintBin = path.resolve(__dirname, "../../node_modules/.bin/eslint");
-const configPath = path.resolve(__dirname, "../../eslint.config.js");
-
-describe("ESLint CLI Integration (Story 001.0-DEV-PLUGIN-SETUP)", () => {
-  /**
-   * Helper to run ESLint CLI with the traceability plugin and custom rule
-   * @story docs/stories/001.0-DEV-PLUGIN-SETUP.story.md
-   * @req REQ-PLUGIN-STRUCTURE - Invoke ESLint CLI for integration testing
-   */
-  function runEslint(code: string, rule: string): SpawnSyncReturns<string> {
-    const args = [
-      "--no-config-lookup",
-      "--config",
-      configPath,
-      "--stdin",
-      "--stdin-filename",
-      "foo.js",
-      "--rule",
-      "no-unused-vars:off",
-      "--rule",
-      rule,
-    ];
-    return spawnSync("node", [eslintBin, ...args], {
-      encoding: "utf-8",
-      input: code,
-    });
-  }
-
-  it("[REQ-PLUGIN-STRUCTURE] reports error when @story annotation is missing", () => {
-    // Arrange
-    const code = "function foo() {}";
-    const rule = "traceability/require-story-annotation:error";
-    // Act
-    const result = runEslint(code, rule);
-    // Assert
-    expect(result.status).toBe(1);
-    expect(result.stdout).toMatch(/require-story-annotation/);
-  });
-
-  it("[REQ-PLUGIN-STRUCTURE] does not report error when @story annotation is present", () => {
-    // Arrange
-    const code = `/**
- * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
- */
-function foo() {}`;
-    const rule = "traceability/require-story-annotation:error";
-    // Act
-    const result = runEslint(code, rule);
-    // Assert
-    expect(result.status).toBe(0);
-  });
-
-  it("[REQ-REQ-CLI] reports error when @req annotation is missing", () => {
-    // Arrange
-    const code = "function foo() {}";
-    const rule = "traceability/require-req-annotation:error";
-    // Act
-    const result = runEslint(code, rule);
-    // Assert
-    expect(result.status).toBe(1);
-    expect(result.stdout).toMatch(/require-req-annotation/);
-  });
-
-  it("[REQ-BRANCH-CLI] reports error when branch annotations missing", () => {
-    // Arrange
-    const code = "if (true) {}";
-    const rule = "traceability/require-branch-annotation:error";
-    // Act
-    const result = runEslint(code, rule);
-    // Assert
-    expect(result.status).toBe(1);
-    expect(result.stdout).toMatch(/require-branch-annotation/);
-  });
-});