eslint-plugin-traceability 1.23.0 → 1.24.0

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

@@ -1,187 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-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
- * @req REQ-MAINT-DETECT - Detect stale annotation references
- * @supports docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md REQ-MAINT-DETECT
- */
-const path = __importStar(require("path"));
-const os = __importStar(require("os"));
-const detect_1 = require("../../src/maintenance/detect");
-const fs = require("fs");
-describe("detectStaleAnnotations isolated (Story 009.0-DEV-MAINTENANCE-TOOLS)", () => {
-    it("[REQ-MAINT-DETECT] returns empty array when directory does not exist", () => {
-        const result = (0, detect_1.detectStaleAnnotations)("non-existent-dir");
-        expect(result).toEqual([]);
-    });
-    it("[REQ-MAINT-DETECT] detects stale annotations in nested directories", () => {
-        const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "tmp-nested-"));
-        try {
-            const nestedDir = path.join(tmpDir, "nested");
-            fs.mkdirSync(nestedDir);
-            const filePath1 = path.join(tmpDir, "file1.ts");
-            const filePath2 = path.join(nestedDir, "file2.ts");
-            const content1 = `
-/**
- * @story docs/stories/non-existent-story.story.md
- */
-`;
-            fs.writeFileSync(filePath1, content1, "utf8");
-            const content2 = `
-/**
- * @story docs/stories/another-non-existent.story.md
- */
-`;
-            fs.writeFileSync(filePath2, content2, "utf8");
-            const result = (0, detect_1.detectStaleAnnotations)(tmpDir);
-            expect(result).toHaveLength(2);
-            expect(result).toContain("docs/stories/non-existent-story.story.md");
-            expect(result).toContain("docs/stories/another-non-existent.story.md");
-        }
-        finally {
-            fs.rmSync(tmpDir, { recursive: true, force: true });
-        }
-    });
-    it("[REQ-MAINT-DETECT] handles permission denied errors by returning an empty result", () => {
-        const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "tmp-perm-"));
-        const dir = path.join(tmpDir, "subdir");
-        fs.mkdirSync(dir);
-        const filePath = path.join(dir, "file.ts");
-        const content = `
-/**
- * @story none.story.md
- */
-`;
-        fs.writeFileSync(filePath, content, "utf8");
-        const originalReadFileSync = fs.readFileSync;
-        const readSpy = jest
-            .spyOn(fs, "readFileSync")
-            .mockImplementation((p, ...args) => {
-            const strPath = typeof p === "string" ? p : p.toString();
-            if (strPath === filePath) {
-                const err = new Error("EACCES: permission denied, open");
-                err.code = "EACCES";
-                throw err;
-            }
-            // Delegate to original implementation for all other paths
-            // to keep behavior realistic.
-            // @ts-ignore
-            return originalReadFileSync(p, ...args);
-        });
-        try {
-            const result = (0, detect_1.detectStaleAnnotations)(tmpDir);
-            expect(result).toEqual([]);
-        }
-        finally {
-            readSpy.mockRestore();
-            try {
-                fs.rmSync(tmpDir, { recursive: true, force: true });
-            }
-            catch {
-                // ignore cleanup errors
-            }
-        }
-    });
-    /**
-     * [REQ-MAINT-DETECT]
-     * Ensure detectStaleAnnotations performs security validation for unsafe
-     * and invalid-extension story paths and does not perform filesystem checks
-     * for malicious @story paths that escape the workspace
-     * (Story 009.0-DEV-MAINTENANCE-TOOLS).
-     */
-    it("[REQ-MAINT-DETECT] performs security validation for unsafe and invalid-extension story paths without stat'ing outside workspace", () => {
-        const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "tmp-workspace-"));
-        const maliciousRelative = "../outside-project.story.md";
-        const maliciousAbsolute = "/etc/passwd.story.md";
-        const traversalInside = "nested/../inside.story.md";
-        const invalidExtension = "invalid.txt";
-        const filePath = path.join(tmpDir, "file.ts");
-        const content = `
-/**
- * @story ${maliciousRelative}
- * @story ${maliciousAbsolute}
- * @story ${traversalInside}
- * @story ${invalidExtension}
- * @story legitimate.story.md
- */
-`;
-        fs.writeFileSync(filePath, content, "utf8");
-        const existsCalls = [];
-        const originalExistsSync = fs.existsSync;
-        const existsSpy = jest
-            .spyOn(fs, "existsSync")
-            .mockImplementation((p) => {
-            const strPath = typeof p === "string" ? p : p.toString();
-            existsCalls.push(strPath);
-            return originalExistsSync(p);
-        });
-        try {
-            (0, detect_1.detectStaleAnnotations)(tmpDir);
-            const allPathsChecked = [...existsCalls];
-            // Ensure no raw malicious values were checked
-            expect(allPathsChecked).not.toContain(maliciousRelative);
-            expect(allPathsChecked).not.toContain(maliciousAbsolute);
-            expect(allPathsChecked).not.toContain(invalidExtension);
-            // Also ensure no resolved variants of these paths were checked
-            const resolvedRelative = path.resolve(tmpDir, maliciousRelative);
-            const resolvedAbsolute = path.resolve(maliciousAbsolute);
-            const resolvedInvalid = path.resolve(tmpDir, invalidExtension);
-            expect(allPathsChecked).not.toContain(resolvedRelative);
-            expect(allPathsChecked).not.toContain(resolvedAbsolute);
-            expect(allPathsChecked).not.toContain(resolvedInvalid);
-            expect(allPathsChecked.some((p) => p.includes("outside-project.story.md"))).toBe(false);
-            expect(allPathsChecked.some((p) => p.includes("passwd.story.md"))).toBe(false);
-            expect(allPathsChecked.some((p) => p.includes("invalid.txt"))).toBe(false);
-            // traversalInside normalizes within workspace and should be checked
-            const resolvedTraversalInside = path.resolve(tmpDir, traversalInside);
-            expect(allPathsChecked).toContain(resolvedTraversalInside);
-            // legitimate in-workspace .story.md path should also be checked
-            const resolvedLegit = path.resolve(tmpDir, "legitimate.story.md");
-            expect(allPathsChecked).toContain(resolvedLegit);
-        }
-        finally {
-            existsSpy.mockRestore();
-            try {
-                fs.rmSync(tmpDir, { recursive: true, force: true });
-            }
-            catch {
-                // ignore cleanup errors
-            }
-        }
-    });
-});

package/lib/tests/maintenance/detect.test.d.ts

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

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

@@ -1,46 +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/009.0-DEV-MAINTENANCE-TOOLS.story.md
- * @story docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md
- * @req REQ-MAINT-DETECT - Detect stale annotation references
- * @supports docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md REQ-MAINT-DETECT
- */
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const os_1 = __importDefault(require("os"));
-const detect_1 = require("../../src/maintenance/detect");
-describe("detectStaleAnnotations (Story 009.0-DEV-MAINTENANCE-TOOLS)", () => {
-    it("[REQ-MAINT-DETECT] should return empty array when no stale annotations", () => {
-        const tmpDir = fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), "detect-test-"));
-        try {
-            // No annotation files are created in tmpDir to simulate no stale annotations
-            const result = (0, detect_1.detectStaleAnnotations)(tmpDir);
-            expect(result).toEqual([]);
-        }
-        finally {
-            fs_1.default.rmSync(tmpDir, { recursive: true, force: true });
-        }
-    });
-    it("[REQ-MAINT-DETECT] should detect stale annotation references", () => {
-        const tmpDir = fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), "detect-stale-"));
-        try {
-            const filePath = path_1.default.join(tmpDir, "file.ts");
-            const storyName = "stale.story.md";
-            const content = `
-/**
- * @story ${storyName}
- */`;
-            fs_1.default.writeFileSync(filePath, content, "utf8");
-            const result = (0, detect_1.detectStaleAnnotations)(tmpDir);
-            expect(result).toHaveLength(1);
-            expect(result).toContain(storyName);
-        }
-        finally {
-            fs_1.default.rmSync(tmpDir, { recursive: true, force: true });
-        }
-    });
-});

package/lib/tests/maintenance/index.test.d.ts

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

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

@@ -1,26 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * Tests for: docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md
- * @story docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md
- * @req REQ-MAINT-SAFE - Ensure all maintenance tools are exported correctly
- * @supports docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md REQ-MAINT-SAFE REQ-MAINT-DETECT REQ-MAINT-UPDATE REQ-MAINT-BATCH REQ-MAINT-VERIFY REQ-MAINT-REPORT
- */
-const maintenance_1 = require("../../src/maintenance");
-describe("Maintenance Tools Index Exports (Story 009.0-DEV-MAINTENANCE-TOOLS)", () => {
-    it("[REQ-MAINT-DETECT] should export detectStaleAnnotations as a function", () => {
-        expect(typeof maintenance_1.detectStaleAnnotations).toBe("function");
-    });
-    it("[REQ-MAINT-UPDATE] should export updateAnnotationReferences as a function", () => {
-        expect(typeof maintenance_1.updateAnnotationReferences).toBe("function");
-    });
-    it("[REQ-MAINT-BATCH] should export batchUpdateAnnotations as a function", () => {
-        expect(typeof maintenance_1.batchUpdateAnnotations).toBe("function");
-    });
-    it("[REQ-MAINT-VERIFY] should export verifyAnnotations as a function", () => {
-        expect(typeof maintenance_1.verifyAnnotations).toBe("function");
-    });
-    it("[REQ-MAINT-REPORT] should export generateMaintenanceReport as a function", () => {
-        expect(typeof maintenance_1.generateMaintenanceReport).toBe("function");
-    });
-});

package/lib/tests/maintenance/report.test.d.ts

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

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

@@ -1,68 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * Tests for: docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md
- * @story docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md
- * @req REQ-MAINT-REPORT - Generate maintenance report
- * @req REQ-MAINT-SAFE - Ensure operations are safe and reversible
- * @supports docs/stories/009.0-DEV-MAINTENANCE-TOOLS.story.md REQ-MAINT-REPORT REQ-MAINT-SAFE
- */
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const temp_dir_helpers_1 = require("../utils/temp-dir-helpers");
-const report_1 = require("../../src/maintenance/report");
-describe("generateMaintenanceReport (Story 009.0-DEV-MAINTENANCE-TOOLS)", () => {
-    let temp;
-    beforeAll(() => {
-        temp = (0, temp_dir_helpers_1.createTempDir)("report-test-");
-    });
-    afterAll(() => {
-        temp.cleanup();
-    });
-    it("[REQ-MAINT-REPORT] should return empty string when no operations", () => {
-        const report = (0, report_1.generateMaintenanceReport)(temp.dir);
-        expect(report).toBe("");
-    });
-    it("[REQ-MAINT-REPORT] should report stale story annotation", () => {
-        const filePath = path.join(temp.dir, "stub.md");
-        const content = `/**
- * @story non-existent.story.md
- */`;
-        fs.writeFileSync(filePath, content);
-        const report = (0, report_1.generateMaintenanceReport)(temp.dir);
-        expect(report).toContain("non-existent.story.md");
-    });
-});

package/lib/tests/maintenance/storyParser.test.d.ts

@@ -1,8 +0,0 @@
-/**
- * Tests for storyParser module
- * @story docs/stories/010.0-DEV-DEEP-VALIDATION.story.md
- * @req REQ-DEEP-PARSE - Test parsing story file content to identify available requirements
- * @req REQ-DEEP-FORMAT - Test finding requirement IDs in multiple markdown contexts
- * @req REQ-DEEP-SECTION - Test handling requirements in different story file sections
- */
-export {};