@facet-coverage/core 0.1.0

package/dist/core/CoverageCalculator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoverageCalculator.js","sourceRoot":"","sources":["../../src/core/CoverageCalculator.ts"],"names":[],"mappings":"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"}

package/dist/core/FacetParser.d.ts

@@ -0,0 +1,39 @@
+import type { MarkdownSection, ParsedMarkdown } from '../types.js';
+/**
+ * Parses markdown files and extracts sections
+ */
+export declare class FacetParser {
+    /**
+     * Convert a title to a URL-friendly slug
+     */
+    static slugify(title: string): string;
+    /**
+     * Parse a markdown file and extract all sections
+     */
+    parseFile(filePath: string): ParsedMarkdown;
+    /**
+     * Parse markdown content and extract sections
+     */
+    parseContent(content: string, filePath?: string): ParsedMarkdown;
+    /**
+     * Find a section by its slug
+     */
+    findSection(parsed: ParsedMarkdown, slug: string): MarkdownSection | undefined;
+    /**
+     * Check if a section exists in a file
+     */
+    sectionExists(filePath: string, sectionSlug: string): boolean;
+    /**
+     * Get all section slugs from a file
+     */
+    getSectionSlugs(filePath: string): string[];
+    /**
+     * Extract the filename without extension as a prefix
+     */
+    static getFilePrefix(filePath: string): string;
+    /**
+     * Generate facet ID from file and section
+     */
+    static generateFacetId(filePath: string, sectionSlug: string): string;
+}
+//# sourceMappingURL=FacetParser.d.ts.map

package/dist/core/FacetParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FacetParser.d.ts","sourceRoot":"","sources":["../../src/core/FacetParser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEnE;;GAEG;AACH,qBAAa,WAAW;IACtB;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAUrC;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc;IAS3C;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAW,GAAG,cAAc;IAgDpE;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI9E;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO;IAS7D;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE;IAK3C;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAK9C;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;CAItE"}

package/dist/core/FacetParser.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FacetParser = void 0;
+const fs_1 = require("fs");
+/**
+ * Parses markdown files and extracts sections
+ */
+class FacetParser {
+    /**
+     * Convert a title to a URL-friendly slug
+     */
+    static slugify(title) {
+        return title
+            .toLowerCase()
+            .trim()
+            .replace(/[^\w\s-]/g, '') // Remove special characters
+            .replace(/\s+/g, '-') // Replace spaces with hyphens
+            .replace(/-+/g, '-') // Replace multiple hyphens with single
+            .replace(/^-|-$/g, ''); // Remove leading/trailing hyphens
+    }
+    /**
+     * Parse a markdown file and extract all sections
+     */
+    parseFile(filePath) {
+        if (!(0, fs_1.existsSync)(filePath)) {
+            throw new Error(`Markdown file not found: ${filePath}`);
+        }
+        const content = (0, fs_1.readFileSync)(filePath, 'utf-8');
+        return this.parseContent(content, filePath);
+    }
+    /**
+     * Parse markdown content and extract sections
+     */
+    parseContent(content, filePath = '') {
+        const lines = content.split('\n');
+        const sections = [];
+        // First pass: find all headings
+        const headings = [];
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const match = line.match(/^(#{1,6})\s+(.+)$/);
+            if (match) {
+                headings.push({
+                    level: match[1].length,
+                    title: match[2].trim(),
+                    line: i + 1, // 1-indexed
+                });
+            }
+        }
+        // Second pass: create sections with content
+        for (let i = 0; i < headings.length; i++) {
+            const heading = headings[i];
+            const nextHeading = headings[i + 1];
+            const startLine = heading.line;
+            const endLine = nextHeading ? nextHeading.line - 1 : lines.length;
+            // Extract content between headings
+            const contentLines = lines.slice(startLine, endLine - 1);
+            const sectionContent = contentLines.join('\n').trim();
+            sections.push({
+                title: heading.title,
+                slug: FacetParser.slugify(heading.title),
+                level: heading.level,
+                startLine,
+                endLine,
+                content: sectionContent,
+            });
+        }
+        return {
+            file: filePath,
+            sections,
+        };
+    }
+    /**
+     * Find a section by its slug
+     */
+    findSection(parsed, slug) {
+        return parsed.sections.find(s => s.slug === slug);
+    }
+    /**
+     * Check if a section exists in a file
+     */
+    sectionExists(filePath, sectionSlug) {
+        try {
+            const parsed = this.parseFile(filePath);
+            return this.findSection(parsed, sectionSlug) !== undefined;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get all section slugs from a file
+     */
+    getSectionSlugs(filePath) {
+        const parsed = this.parseFile(filePath);
+        return parsed.sections.map(s => s.slug);
+    }
+    /**
+     * Extract the filename without extension as a prefix
+     */
+    static getFilePrefix(filePath) {
+        const basename = filePath.split('/').pop() || '';
+        return basename.replace(/\.md$/i, '').toLowerCase();
+    }
+    /**
+     * Generate facet ID from file and section
+     */
+    static generateFacetId(filePath, sectionSlug) {
+        const prefix = FacetParser.getFilePrefix(filePath);
+        return `${prefix}:${sectionSlug}`;
+    }
+}
+exports.FacetParser = FacetParser;
+//# sourceMappingURL=FacetParser.js.map

package/dist/core/FacetParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FacetParser.js","sourceRoot":"","sources":["../../src/core/FacetParser.ts"],"names":[],"mappings":"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"}

package/dist/core/StructureReader.d.ts

@@ -0,0 +1,37 @@
+import type { FacetStructure, Facet, FacetConfig } from '../types.js';
+/**
+ * Reads and parses facet structure files
+ */
+export declare class StructureReader {
+    private config;
+    constructor(config?: Partial<FacetConfig>);
+    /**
+     * Find all structure files matching the configured patterns
+     */
+    findStructureFiles(cwd?: string): Promise<string[]>;
+    /**
+     * Read and parse a single structure file
+     */
+    readStructure(filePath: string): FacetStructure;
+    /**
+     * Read all structure files and return combined facets
+     */
+    readAllStructures(cwd?: string): Promise<Map<string, FacetStructure>>;
+    /**
+     * Get all facets from all structure files
+     */
+    getAllFacets(cwd?: string): Promise<Facet[]>;
+    /**
+     * Get facet by ID
+     */
+    getFacetById(id: string, cwd?: string): Promise<Facet | undefined>;
+    /**
+     * Resolve the absolute path to a facet's source file
+     */
+    resolveSourcePath(facet: Facet, structureFilePath: string): string;
+    /**
+     * Validate structure object
+     */
+    private validateStructure;
+}
+//# sourceMappingURL=StructureReader.d.ts.map

package/dist/core/StructureReader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StructureReader.d.ts","sourceRoot":"","sources":["../../src/core/StructureReader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,WAAW,EAAiB,MAAM,aAAa,CAAC;AAErF;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAc;gBAEhB,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM;IAK7C;;OAEG;IACG,kBAAkB,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAWxE;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc;IA8B/C;;OAEG;IACG,iBAAiB,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAY1F;;OAEG;IACG,YAAY,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAWjE;;OAEG;IACG,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC;IAKvF;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,GAAG,MAAM;IAOlE;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAkC1B"}

package/dist/core/StructureReader.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StructureReader = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const glob_1 = require("glob");
+/**
+ * Reads and parses facet structure files
+ */
+class StructureReader {
+    config;
+    constructor(config = {}) {
+        const { defaultConfig } = require('../types.js');
+        this.config = { ...defaultConfig, ...config };
+    }
+    /**
+     * Find all structure files matching the configured patterns
+     */
+    async findStructureFiles(cwd = process.cwd()) {
+        const files = [];
+        for (const pattern of this.config.structureFiles) {
+            const matches = await (0, glob_1.glob)(pattern, { cwd, absolute: true });
+            files.push(...matches);
+        }
+        return [...new Set(files)]; // Remove duplicates
+    }
+    /**
+     * Read and parse a single structure file
+     */
+    readStructure(filePath) {
+        if (!(0, fs_1.existsSync)(filePath)) {
+            throw new Error(`Structure file not found: ${filePath}`);
+        }
+        const content = (0, fs_1.readFileSync)(filePath, 'utf-8');
+        let structure;
+        try {
+            structure = JSON.parse(content);
+        }
+        catch (error) {
+            throw new Error(`Invalid JSON in structure file: ${filePath}`);
+        }
+        // Validate structure
+        this.validateStructure(structure, filePath);
+        // Resolve relative paths in facets
+        const structureDir = (0, path_1.dirname)(filePath);
+        structure.facets = structure.facets.map(facet => ({
+            ...facet,
+            source: {
+                ...facet.source,
+                file: facet.source.file, // Keep relative for portability
+            },
+        }));
+        return structure;
+    }
+    /**
+     * Read all structure files and return combined facets
+     */
+    async readAllStructures(cwd = process.cwd()) {
+        const files = await this.findStructureFiles(cwd);
+        const structures = new Map();
+        for (const file of files) {
+            const structure = this.readStructure(file);
+            structures.set(file, structure);
+        }
+        return structures;
+    }
+    /**
+     * Get all facets from all structure files
+     */
+    async getAllFacets(cwd = process.cwd()) {
+        const structures = await this.readAllStructures(cwd);
+        const facets = [];
+        for (const structure of structures.values()) {
+            facets.push(...structure.facets);
+        }
+        return facets;
+    }
+    /**
+     * Get facet by ID
+     */
+    async getFacetById(id, cwd = process.cwd()) {
+        const facets = await this.getAllFacets(cwd);
+        return facets.find(f => f.id === id);
+    }
+    /**
+     * Resolve the absolute path to a facet's source file
+     */
+    resolveSourcePath(facet, structureFilePath) {
+        const structureDir = (0, path_1.dirname)(structureFilePath);
+        // Go up one level from .facet directory to get feature directory
+        const featureDir = (0, path_1.dirname)(structureDir);
+        return (0, path_1.resolve)(featureDir, facet.source.file);
+    }
+    /**
+     * Validate structure object
+     */
+    validateStructure(structure, filePath) {
+        if (!structure.feature) {
+            throw new Error(`Missing 'feature' field in structure file: ${filePath}`);
+        }
+        if (!Array.isArray(structure.facets)) {
+            throw new Error(`Missing or invalid 'facets' array in structure file: ${filePath}`);
+        }
+        const seenIds = new Set();
+        for (const facet of structure.facets) {
+            if (!facet.id) {
+                throw new Error(`Facet missing 'id' field in structure file: ${filePath}`);
+            }
+            if (seenIds.has(facet.id)) {
+                throw new Error(`Duplicate facet ID '${facet.id}' in structure file: ${filePath}`);
+            }
+            seenIds.add(facet.id);
+            if (!facet.source?.file) {
+                throw new Error(`Facet '${facet.id}' missing 'source.file' in structure file: ${filePath}`);
+            }
+            if (!facet.source?.section) {
+                throw new Error(`Facet '${facet.id}' missing 'source.section' in structure file: ${filePath}`);
+            }
+            if (!facet.type) {
+                throw new Error(`Facet '${facet.id}' missing 'type' in structure file: ${filePath}`);
+            }
+        }
+    }
+}
+exports.StructureReader = StructureReader;
+//# sourceMappingURL=StructureReader.js.map

package/dist/core/StructureReader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StructureReader.js","sourceRoot":"","sources":["../../src/core/StructureReader.ts"],"names":[],"mappings":"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"}

package/dist/core/TestScanner.d.ts

@@ -0,0 +1,36 @@
+import type { TestLink, FacetConfig } from '../types.js';
+/**
+ * Scans test files for facet annotations
+ */
+export declare class TestScanner {
+    private config;
+    constructor(config?: Partial<FacetConfig>);
+    /**
+     * Find all test files matching configured patterns
+     */
+    findTestFiles(cwd?: string): Promise<string[]>;
+    /**
+     * Scan a single test file for facet annotations
+     */
+    scanFile(filePath: string, cwd?: string): TestLink[];
+    /**
+     * Scan test content for facet annotations
+     * Supports both Playwright-style annotations and comment-based annotations:
+     * - Playwright: test('name', { annotation: facet('id1', 'id2') }, ...)
+     * - Comment: // @facet id1, id2 \n test('name', ...)
+     */
+    scanContent(content: string, filePath: string, cwd?: string): TestLink[];
+    /**
+     * Scan all test files for facet annotations
+     */
+    scanAllTests(cwd?: string): Promise<TestLink[]>;
+    /**
+     * Get all facet IDs referenced in tests
+     */
+    getAllReferencedFacetIds(cwd?: string): Promise<Set<string>>;
+    /**
+     * Get tests that cover a specific facet ID
+     */
+    getTestsForFacet(facetId: string, cwd?: string): Promise<TestLink[]>;
+}
+//# sourceMappingURL=TestScanner.d.ts.map

package/dist/core/TestScanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestScanner.d.ts","sourceRoot":"","sources":["../../src/core/TestScanner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAGzD;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAc;gBAEhB,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM;IAI7C;;OAEG;IACG,aAAa,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAwBnE;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,QAAQ,EAAE;IASnE;;;;;OAKG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,QAAQ,EAAE;IAwHvF;;OAEG;IACG,YAAY,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAgBpE;;OAEG;IACG,wBAAwB,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAajF;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;CAI1F"}

package/dist/core/TestScanner.js

@@ -0,0 +1,192 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestScanner = void 0;
+const fs_1 = require("fs");
+const glob_1 = require("glob");
+const path_1 = require("path");
+const types_js_1 = require("../types.js");
+/**
+ * Scans test files for facet annotations
+ */
+class TestScanner {
+    config;
+    constructor(config = {}) {
+        this.config = { ...types_js_1.defaultConfig, ...config };
+    }
+    /**
+     * Find all test files matching configured patterns
+     */
+    async findTestFiles(cwd = process.cwd()) {
+        const patterns = this.config.testPatterns || ['**/*.spec.ts', '**/*.test.ts'];
+        const files = [];
+        // Expand testDir pattern
+        const testDirs = await (0, glob_1.glob)(this.config.testDir, { cwd, absolute: true });
+        for (const testDir of testDirs) {
+            for (const pattern of patterns) {
+                const matches = await (0, glob_1.glob)(pattern, { cwd: testDir, absolute: true });
+                files.push(...matches);
+            }
+        }
+        // Also search in the testDir pattern directly if it includes globs
+        for (const pattern of patterns) {
+            const fullPattern = `${this.config.testDir}/${pattern}`;
+            const matches = await (0, glob_1.glob)(fullPattern, { cwd, absolute: true });
+            files.push(...matches);
+        }
+        return [...new Set(files)]; // Remove duplicates
+    }
+    /**
+     * Scan a single test file for facet annotations
+     */
+    scanFile(filePath, cwd = process.cwd()) {
+        if (!(0, fs_1.existsSync)(filePath)) {
+            throw new Error(`Test file not found: ${filePath}`);
+        }
+        const content = (0, fs_1.readFileSync)(filePath, 'utf-8');
+        return this.scanContent(content, filePath, cwd);
+    }
+    /**
+     * Scan test content for facet annotations
+     * Supports both Playwright-style annotations and comment-based annotations:
+     * - Playwright: test('name', { annotation: facet('id1', 'id2') }, ...)
+     * - Comment: // @facet id1, id2 \n test('name', ...)
+     */
+    scanContent(content, filePath, cwd = process.cwd()) {
+        const testLinks = [];
+        const lines = content.split('\n');
+        // Track describe blocks for full title
+        const describeStack = [];
+        // Patterns for test definitions
+        const testPattern = /(?:test|it)\s*\(\s*(['"`])(.+?)\1\s*,\s*\{/g;
+        const testSimplePattern = /(?:test|it)\s*\(\s*(['"`])(.+?)\1\s*,/g;
+        const describePattern = /describe\s*\(\s*(['"`])(.+?)\1/g;
+        // Pattern for Playwright-style facet annotations
+        const facetPattern = /annotation\s*:\s*facet\s*\(\s*([^)]+)\s*\)/g;
+        const facetIdsPattern = /(['"`])([^'"`]+)\1/g;
+        // Pattern for comment-based facet annotations: // @facet id1, id2
+        const commentFacetPattern = /^\s*\/\/\s*@facet\s+(.+)$/;
+        // Track brace depth for describe blocks
+        let braceDepth = 0;
+        const describeDepths = [];
+        // Track pending comment-based facet IDs
+        let pendingFacetIds = [];
+        let pendingFacetLine = -1;
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const lineNumber = i + 1;
+            // Check for comment-based facet annotation
+            const commentMatch = commentFacetPattern.exec(line);
+            if (commentMatch) {
+                const facetString = commentMatch[1];
+                // Parse comma-separated facet IDs, trimming whitespace
+                pendingFacetIds = facetString.split(',').map(id => id.trim()).filter(id => id.length > 0);
+                pendingFacetLine = lineNumber;
+                continue;
+            }
+            // Track describe blocks
+            const describeMatch = describePattern.exec(line);
+            if (describeMatch) {
+                describeStack.push(describeMatch[2]);
+                describeDepths.push(braceDepth);
+                describePattern.lastIndex = 0;
+            }
+            // Count braces for scope tracking
+            const openBraces = (line.match(/\{/g) || []).length;
+            const closeBraces = (line.match(/\}/g) || []).length;
+            braceDepth += openBraces - closeBraces;
+            // Pop describe blocks when we exit their scope
+            while (describeDepths.length > 0 && braceDepth <= describeDepths[describeDepths.length - 1]) {
+                describeStack.pop();
+                describeDepths.pop();
+            }
+            // Look for test definitions
+            // First try with annotation block pattern
+            let testMatch = testPattern.exec(line);
+            testPattern.lastIndex = 0;
+            // Also try simple test pattern for comment-based annotations
+            if (!testMatch) {
+                testMatch = testSimplePattern.exec(line);
+                testSimplePattern.lastIndex = 0;
+            }
+            if (testMatch) {
+                const testTitle = testMatch[2];
+                let facetIds = [];
+                // Check for pending comment-based facet IDs (within 3 lines)
+                if (pendingFacetIds.length > 0 && lineNumber - pendingFacetLine <= 3) {
+                    facetIds = [...pendingFacetIds];
+                    pendingFacetIds = [];
+                    pendingFacetLine = -1;
+                }
+                else {
+                    // Look for Playwright-style facet annotation in the next few lines
+                    const annotationBlock = lines.slice(i, Math.min(i + 10, lines.length)).join('\n');
+                    const facetMatch = facetPattern.exec(annotationBlock);
+                    facetPattern.lastIndex = 0;
+                    if (facetMatch) {
+                        const facetArgs = facetMatch[1];
+                        let idMatch;
+                        while ((idMatch = facetIdsPattern.exec(facetArgs)) !== null) {
+                            facetIds.push(idMatch[2]);
+                        }
+                        facetIdsPattern.lastIndex = 0;
+                    }
+                }
+                if (facetIds.length > 0) {
+                    const fullTitle = [...describeStack, testTitle].join(' > ');
+                    testLinks.push({
+                        file: (0, path_1.relative)(cwd, filePath),
+                        title: testTitle,
+                        fullTitle,
+                        facetIds,
+                        line: lineNumber,
+                    });
+                }
+            }
+            // Clear pending facet IDs if we've moved too far past them
+            if (pendingFacetIds.length > 0 && lineNumber - pendingFacetLine > 3) {
+                pendingFacetIds = [];
+                pendingFacetLine = -1;
+            }
+        }
+        return testLinks;
+    }
+    /**
+     * Scan all test files for facet annotations
+     */
+    async scanAllTests(cwd = process.cwd()) {
+        const files = await this.findTestFiles(cwd);
+        const allLinks = [];
+        for (const file of files) {
+            try {
+                const links = this.scanFile(file, cwd);
+                allLinks.push(...links);
+            }
+            catch (error) {
+                console.warn(`Warning: Could not scan test file ${file}: ${error}`);
+            }
+        }
+        return allLinks;
+    }
+    /**
+     * Get all facet IDs referenced in tests
+     */
+    async getAllReferencedFacetIds(cwd = process.cwd()) {
+        const links = await this.scanAllTests(cwd);
+        const ids = new Set();
+        for (const link of links) {
+            for (const id of link.facetIds) {
+                ids.add(id);
+            }
+        }
+        return ids;
+    }
+    /**
+     * Get tests that cover a specific facet ID
+     */
+    async getTestsForFacet(facetId, cwd = process.cwd()) {
+        const links = await this.scanAllTests(cwd);
+        return links.filter(link => link.facetIds.includes(facetId));
+    }
+}
+exports.TestScanner = TestScanner;
+//# sourceMappingURL=TestScanner.js.map

package/dist/core/TestScanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestScanner.js","sourceRoot":"","sources":["../../src/core/TestScanner.ts"],"names":[],"mappings":"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"}

package/dist/core/Validator.d.ts

@@ -0,0 +1,33 @@
+import type { FacetConfig, FacetStructure, ValidationResult } from '../types.js';
+/**
+ * Validates facet structures, source files, and test links
+ */
+export declare class Validator {
+    private config;
+    private structureReader;
+    private facetParser;
+    private testScanner;
+    constructor(config?: Partial<FacetConfig>);
+    /**
+     * Run full validation
+     */
+    validate(cwd?: string): Promise<ValidationResult>;
+    /**
+     * Validate a single structure
+     */
+    validateStructure(structure: FacetStructure, structureFile: string, cwd: string): ValidationResult;
+    /**
+     * Check if a facet ID is valid
+     */
+    private isValidFacetId;
+    /**
+     * Check if a reference is a valid path-style reference
+     * e.g., 'facets/business.md#guest-purchase-flow'
+     */
+    private isValidPathReference;
+    /**
+     * Quick validation check - returns boolean
+     */
+    isValid(cwd?: string): Promise<boolean>;
+}
+//# sourceMappingURL=Validator.d.ts.map

package/dist/core/Validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Validator.d.ts","sourceRoot":"","sources":["../../src/core/Validator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EAGd,gBAAgB,EAEjB,MAAM,aAAa,CAAC;AAMrB;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM;IAO7C;;OAEG;IACG,QAAQ,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA+EtE;;OAEG;IACH,iBAAiB,CACf,SAAS,EAAE,cAAc,EACzB,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,MAAM,GACV,gBAAgB;IAuDnB;;OAEG;IACH,OAAO,CAAC,cAAc;IAKtB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IA2B5B;;OAEG;IACG,OAAO,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,OAAO,CAAC;CAI7D"}