eslint-plugin-traceability 1.0.3 → 1.0.5

package/lib/src/rules/valid-story-reference.js

@@ -1,168 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-/* eslint-env node */
-/**
- * Rule to validate @story annotation references refer to existing story files
- * @story docs/stories/006.0-DEV-FILE-VALIDATION.story.md
- * @req REQ-FILE-EXISTENCE - Validate that story file paths reference existing files
- * @req REQ-PATH-RESOLUTION - Resolve relative paths correctly and enforce configuration
- * @req REQ-SECURITY-VALIDATION - Prevent path traversal and absolute path usage
- */
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const defaultStoryDirs = ["docs/stories", "stories"];
-const fileExistCache = new Map();
-/**
- * Build possible file paths for a given storyPath.
- * @story docs/stories/006.0-DEV-FILE-VALIDATION.story.md
- * @req REQ-PATH-RESOLUTION - Resolve relative paths correctly and enforce configuration
- */
-function buildCandidates(storyPath, cwd, storyDirs) {
-    const candidates = [];
-    if (storyPath.startsWith("./") || storyPath.startsWith("../")) {
-        candidates.push(path_1.default.resolve(cwd, storyPath));
-    }
-    else {
-        candidates.push(path_1.default.resolve(cwd, storyPath));
-        for (const dir of storyDirs) {
-            candidates.push(path_1.default.resolve(cwd, dir, path_1.default.basename(storyPath)));
-        }
-    }
-    return candidates;
-}
-/**
- * Check if any of the candidate files exist.
- * @story docs/stories/006.0-DEV-FILE-VALIDATION.story.md
- * @req REQ-FILE-EXISTENCE - Validate that story file paths reference existing files
- */
-function existsAny(paths) {
-    for (const candidate of paths) {
-        let ok = fileExistCache.get(candidate);
-        if (ok === undefined) {
-            ok = fs_1.default.existsSync(candidate) && fs_1.default.statSync(candidate).isFile();
-            fileExistCache.set(candidate, ok);
-        }
-        if (ok) {
-            return true;
-        }
-    }
-    return false;
-}
-/**
- * Validate a single @story annotation line.
- * @story docs/stories/006.0-DEV-FILE-VALIDATION.story.md
- * @req REQ-FILE-EXISTENCE - Validate that story file paths reference existing files
- * @req REQ-PATH-RESOLUTION - Resolve relative paths correctly and enforce configuration
- * @req REQ-SECURITY-VALIDATION - Prevent path traversal and absolute path usage
- */
-function validateStoryPath(line, commentNode, context, cwd, storyDirs, allowAbsolute, requireExt) {
-    const parts = line.split(/\s+/);
-    const storyPath = parts[1];
-    if (!storyPath) {
-        return;
-    }
-    // Absolute path check
-    if (path_1.default.isAbsolute(storyPath)) {
-        if (!allowAbsolute) {
-            context.report({
-                node: commentNode,
-                messageId: "invalidPath",
-                data: { path: storyPath },
-            });
-        }
-        return;
-    }
-    // Path traversal prevention
-    if (storyPath.includes("..")) {
-        const normalized = path_1.default.normalize(storyPath);
-        const full = path_1.default.resolve(cwd, normalized);
-        if (!full.startsWith(cwd + path_1.default.sep)) {
-            context.report({
-                node: commentNode,
-                messageId: "invalidPath",
-                data: { path: storyPath },
-            });
-            return;
-        }
-    }
-    // Extension check
-    if (requireExt && !storyPath.endsWith(".story.md")) {
-        context.report({
-            node: commentNode,
-            messageId: "invalidExtension",
-            data: { path: storyPath },
-        });
-        return;
-    }
-    // Build candidate paths and check existence
-    const candidates = buildCandidates(storyPath, cwd, storyDirs);
-    if (!existsAny(candidates)) {
-        context.report({
-            node: commentNode,
-            messageId: "fileMissing",
-            data: { path: storyPath },
-        });
-    }
-}
-/**
- * Handle a single comment node by processing its lines.
- * @story docs/stories/006.0-DEV-FILE-VALIDATION.story.md
- * @req REQ-ANNOTATION-VALIDATION - Ensure each annotation line is parsed
- */
-function handleComment(commentNode, context, sourceCode, cwd, storyDirs, allowAbsolute, requireExt) {
-    const lines = commentNode.value
-        .split(/\r?\n/)
-        .map((l) => l.replace(/^[^@]*/, "").trim());
-    for (const line of lines) {
-        if (line.startsWith("@story")) {
-            validateStoryPath(line, commentNode, context, cwd, storyDirs, allowAbsolute, requireExt);
-        }
-    }
-}
-exports.default = {
-    meta: {
-        type: "problem",
-        docs: {
-            description: "Validate that @story annotations reference existing .story.md files",
-            recommended: "error",
-        },
-        messages: {
-            fileMissing: "Story file '{{path}}' not found",
-            invalidExtension: "Invalid story file extension for '{{path}}', expected '.story.md'",
-            invalidPath: "Invalid story path '{{path}}'",
-        },
-        schema: [
-            {
-                type: "object",
-                properties: {
-                    storyDirectories: {
-                        type: "array",
-                        items: { type: "string" },
-                    },
-                    allowAbsolutePaths: { type: "boolean" },
-                    requireStoryExtension: { type: "boolean" },
-                },
-                additionalProperties: false,
-            },
-        ],
-    },
-    create(context) {
-        const sourceCode = context.getSourceCode();
-        const cwd = process.cwd();
-        const opts = context.options[0];
-        const storyDirs = opts?.storyDirectories || defaultStoryDirs;
-        const allowAbsolute = opts?.allowAbsolutePaths || false;
-        const requireExt = opts?.requireStoryExtension !== false;
-        return {
-            Program() {
-                const comments = sourceCode.getAllComments() || [];
-                for (const comment of comments) {
-                    handleComment(comment, context, sourceCode, cwd, storyDirs, allowAbsolute, requireExt);
-                }
-            },
-        };
-    },
-};

package/lib/tests/basic.test.d.ts

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

package/lib/tests/basic.test.js

@@ -1,51 +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/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
- */
-const index_1 = __importStar(require("../lib/index"));
-describe("Traceability ESLint Plugin (Story 001.0-DEV-PLUGIN-SETUP)", () => {
-    it("[REQ-PLUGIN-STRUCTURE] plugin exports rules and configs", () => {
-        expect(index_1.rules).toBeDefined();
-        expect(index_1.configs).toBeDefined();
-        expect(typeof index_1.rules).toBe("object");
-        expect(typeof index_1.configs).toBe("object");
-        expect(index_1.default.rules).toBe(index_1.rules);
-        expect(index_1.default.configs).toBe(index_1.configs);
-    });
-});

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

@@ -1,3 +0,0 @@
-"use strict";
-// Sample code with stale annotation
-// @story non-existent.md

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

@@ -1,3 +0,0 @@
-"use strict";
-// Sample code with annotation to update
-// @story old.md

package/lib/tests/fixtures/valid-annotations/example.js

@@ -1,3 +0,0 @@
-"use strict";
-// Valid annotation
-// @story docs/stories/001.0-DEV-PLUGIN-SETUP.story.md

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

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

package/lib/tests/index.test.js

@@ -1,72 +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/001.0-DEV-PLUGIN-SETUP.story.md
- * @story docs/stories/001.0-DEV-PLUGIN-SETUP.story.md
- * @req REQ-PLUGIN-STRUCTURE - Validate plugin default export and configs in src/index.ts
- */
-const index_1 = __importStar(require("../src/index"));
-describe("Plugin Default Export and Configs (Story 001.0-DEV-PLUGIN-SETUP)", () => {
-    it("[REQ-PLUGIN-STRUCTURE] default export includes rules and configs", () => {
-        expect(index_1.default.rules).toBe(index_1.rules);
-        expect(index_1.default.configs).toBe(index_1.configs);
-    });
-    it("[REQ-PLUGIN-STRUCTURE] rules object has correct rule names", () => {
-        // Arrange: expected rule names in insertion order
-        const expected = [
-            "require-story-annotation",
-            "require-req-annotation",
-            "require-branch-annotation",
-            "valid-annotation-format",
-            "valid-story-reference",
-            "valid-req-reference",
-        ];
-        // Act: get actual rule names from plugin
-        const actual = Object.keys(index_1.rules);
-        // Assert: actual matches expected
-        expect(actual).toEqual(expected);
-    });
-    it("[REQ-RULE-REGISTRY] configs.recommended contains correct rule configuration", () => {
-        const recommendedRules = index_1.configs.recommended[0].rules;
-        expect(recommendedRules).toHaveProperty("traceability/require-story-annotation", "error");
-        expect(recommendedRules).toHaveProperty("traceability/require-req-annotation", "error");
-        expect(recommendedRules).toHaveProperty("traceability/require-branch-annotation", "error");
-    });
-    it("[REQ-CONFIG-SYSTEM] configs.strict contains same rules as recommended", () => {
-        const strictRules = index_1.configs.strict[0].rules;
-        expect(strictRules).toEqual(index_1.configs.recommended[0].rules);
-    });
-});

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

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

package/lib/tests/integration/file-validation.test.js

@@ -1,71 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * 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
- */
-const child_process_1 = require("child_process");
-const path_1 = __importDefault(require("path"));
-// Ensure ESLint CLI uses built plugin
-const eslintBin = path_1.default.resolve(__dirname, "../../node_modules/.bin/eslint");
-const configPath = path_1.default.resolve(__dirname, "../../eslint.config.js");
-describe("File and Req Validation CLI Integration (Story 006.0-DEV-FILE-VALIDATION)", () => {
-    function runLint(code, rules) {
-        const ruleArgs = ["--rule", "no-unused-vars:off"];
-        for (const r of rules) {
-            ruleArgs.push("--rule", r);
-        }
-        return (0, child_process_1.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/lib/tests/integration/plugin-validation.test.d.ts

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

package/lib/tests/integration/plugin-validation.test.js

@@ -1,83 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * 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 */
-const child_process_1 = require("child_process");
-const path_1 = __importDefault(require("path"));
-// Ensure ESLint CLI uses built plugin
-const eslintBin = path_1.default.resolve(__dirname, "../../node_modules/.bin/eslint");
-const configPath = path_1.default.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, rule) {
-        const args = [
-            "--no-config-lookup",
-            "--config",
-            configPath,
-            "--stdin",
-            "--stdin-filename",
-            "foo.js",
-            "--rule",
-            "no-unused-vars:off",
-            "--rule",
-            rule,
-        ];
-        return (0, child_process_1.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/);
-    });
-});

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

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

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

@@ -1,79 +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-BATCH - Perform batch updates
- * @req REQ-MAINT-VERIFY - Verify annotation references
- */
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const os = __importStar(require("os"));
-const batch_1 = require("../../src/maintenance/batch");
-describe("batchUpdateAnnotations (Story 009.0-DEV-MAINTENANCE-TOOLS)", () => {
-    let tmpDir;
-    beforeAll(() => {
-        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "batch-test-"));
-    });
-    afterAll(() => {
-        fs.rmSync(tmpDir, { recursive: true, force: true });
-    });
-    it("[REQ-MAINT-BATCH] should return 0 when no mappings applied", () => {
-        const count = (0, batch_1.batchUpdateAnnotations)(tmpDir, []);
-        expect(count).toBe(0);
-    });
-});
-describe("verifyAnnotations (Story 009.0-DEV-MAINTENANCE-TOOLS)", () => {
-    let tmpDir;
-    beforeAll(() => {
-        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "verify-test-"));
-        const tsContent = `
-/**
- * Tests for: my-story.story.md
- * @story my-story.story.md
- */
-`;
-        fs.writeFileSync(path.join(tmpDir, "test.ts"), tsContent);
-        fs.writeFileSync(path.join(tmpDir, "my-story.story.md"), "# Dummy Story");
-    });
-    afterAll(() => {
-        fs.rmSync(tmpDir, { recursive: true, force: true });
-    });
-    it("[REQ-MAINT-VERIFY] should return true when annotations are valid", () => {
-        const valid = (0, batch_1.verifyAnnotations)(tmpDir);
-        expect(valid).toBe(true);
-    });
-});

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

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

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

@@ -1,95 +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-DETECT - Detect stale annotation references
- */
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const os = __importStar(require("os"));
-const detect_1 = require("../../src/maintenance/detect");
-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", () => {
-        // Arrange
-        const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "tmp-nested-"));
-        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 stale1.story.md
- */
-`;
-        fs.writeFileSync(filePath1, content1, "utf8");
-        const content2 = `
-/**
- * @story stale2.story.md
- */
-`;
-        fs.writeFileSync(filePath2, content2, "utf8");
-        // Act
-        const result = (0, detect_1.detectStaleAnnotations)(tmpDir);
-        // Assert
-        expect(result).toHaveLength(2);
-        expect(result).toContain("stale1.story.md");
-        expect(result).toContain("stale2.story.md");
-    });
-    it("[REQ-MAINT-DETECT] throws error on permission denied", () => {
-        const tmpDir2 = fs.mkdtempSync(path.join(os.tmpdir(), "tmp-perm-"));
-        const dir = path.join(tmpDir2, "subdir");
-        fs.mkdirSync(dir);
-        const filePath = path.join(dir, "file.ts");
-        const content = `
-/**
- * @story none.story.md
- */
-`;
-        fs.writeFileSync(filePath, content, "utf8");
-        // Remove read permission
-        fs.chmodSync(dir, 0o000);
-        expect(() => (0, detect_1.detectStaleAnnotations)(tmpDir2)).toThrow();
-        // Restore permissions
-        fs.chmodSync(dir, 0o700);
-        // Cleanup temporary directory
-        fs.rmSync(tmpDir2, { recursive: true, force: true });
-    });
-});

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

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