@facet-coverage/core 0.1.0

package/dist/cli/commands/generate.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateCommand = generateCommand;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const FacetParser_js_1 = require("../../core/FacetParser.js");
+/**
+ * Generate structure.json from facet markdown files
+ */
+async function generateCommand(dir, options = {}) {
+    const facetsDir = (0, path_1.resolve)(process.cwd(), dir);
+    if (!(0, fs_1.existsSync)(facetsDir)) {
+        console.error(`❌ Directory not found: ${facetsDir}`);
+        process.exit(1);
+    }
+    console.log(`💎 Generating structure from: ${facetsDir}`);
+    // Find all markdown files in the directory
+    const files = (0, fs_1.readdirSync)(facetsDir).filter(f => f.endsWith('.md'));
+    if (files.length === 0) {
+        console.error(`❌ No markdown files found in: ${facetsDir}`);
+        process.exit(1);
+    }
+    const parser = new FacetParser_js_1.FacetParser();
+    const facets = [];
+    for (const file of files) {
+        const filePath = (0, path_1.join)(facetsDir, file);
+        const parsed = parser.parseFile(filePath);
+        // Determine facet type from filename (e.g., business.md -> business)
+        const type = options.type || (0, path_1.basename)(file, '.md');
+        console.log(`  📄 ${file}`);
+        for (const section of parsed.sections) {
+            // Only include top-level sections (h2 or the first h1 if no h2s)
+            if (section.level <= 2) {
+                const facetId = FacetParser_js_1.FacetParser.generateFacetId(file, section.slug);
+                facets.push({
+                    id: facetId,
+                    source: {
+                        file: `facets/${file}`,
+                        section: section.slug,
+                    },
+                    type,
+                    title: section.title,
+                });
+                console.log(`    ✓ ${facetId}`);
+            }
+        }
+    }
+    // Determine feature name from parent directory
+    const featureDir = (0, path_1.dirname)(facetsDir);
+    const featureName = (0, path_1.basename)(featureDir);
+    // Build structure object
+    const structure = {
+        feature: featureName,
+        facets,
+    };
+    // Determine output path
+    const outputDir = options.output || (0, path_1.join)(featureDir, '.facet');
+    const outputPath = (0, path_1.join)(outputDir, 'structure.json');
+    // Ensure output directory exists
+    (0, fs_1.mkdirSync)(outputDir, { recursive: true });
+    // Write structure file
+    (0, fs_1.writeFileSync)(outputPath, JSON.stringify(structure, null, 2));
+    console.log(`\n✅ Generated: ${outputPath}`);
+    console.log(`   Feature: ${featureName}`);
+    console.log(`   Facets: ${facets.length}`);
+}
+//# sourceMappingURL=generate.js.map

package/dist/cli/commands/generate.js.map

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

package/dist/cli/commands/validate.d.ts

@@ -0,0 +1,11 @@
+interface ValidateOptions {
+    config?: string;
+    strict?: boolean;
+    json?: boolean;
+}
+/**
+ * Validate facet structure and test links
+ */
+export declare function validateCommand(options?: ValidateOptions): Promise<void>;
+export {};
+//# sourceMappingURL=validate.d.ts.map

package/dist/cli/commands/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/validate.ts"],"names":[],"mappings":"AAMA,UAAU,eAAe;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BlF"}

package/dist/cli/commands/validate.js

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateCommand = validateCommand;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const Validator_js_1 = require("../../core/Validator.js");
+const types_js_1 = require("../../types.js");
+/**
+ * Validate facet structure and test links
+ */
+async function validateCommand(options = {}) {
+    const cwd = process.cwd();
+    // Load config
+    const config = await loadConfig(options.config, cwd);
+    // Enable strict mode if requested
+    if (options.strict) {
+        config.validation.requireAllTestsLinked = true;
+    }
+    console.log('💎 Validating Facet Coverage...\n');
+    const validator = new Validator_js_1.Validator(config);
+    const result = await validator.validate(cwd);
+    if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+    }
+    else {
+        printValidationResult(result);
+    }
+    // Exit with error code if validation failed
+    if (!result.valid) {
+        process.exit(1);
+    }
+}
+/**
+ * Load configuration from file or use defaults
+ */
+async function loadConfig(configPath, cwd) {
+    const configFiles = [
+        configPath,
+        'facet.config.js',
+        'facet.config.mjs',
+        'facet.config.json',
+    ].filter(Boolean);
+    for (const file of configFiles) {
+        const fullPath = (0, path_1.resolve)(cwd, file);
+        if ((0, fs_1.existsSync)(fullPath)) {
+            if (file.endsWith('.json')) {
+                const content = (0, fs_1.readFileSync)(fullPath, 'utf-8');
+                return { ...types_js_1.defaultConfig, ...JSON.parse(content) };
+            }
+            else {
+                try {
+                    const imported = await import(fullPath);
+                    return { ...types_js_1.defaultConfig, ...(imported.default || imported) };
+                }
+                catch (error) {
+                    console.warn(`Warning: Could not load config from ${file}`);
+                }
+            }
+        }
+    }
+    return types_js_1.defaultConfig;
+}
+/**
+ * Print validation results
+ */
+function printValidationResult(result) {
+    if (result.valid && result.warnings.length === 0) {
+        console.log('✅ Validation passed! No issues found.\n');
+        return;
+    }
+    // Print errors
+    if (result.errors.length > 0) {
+        console.log(`❌ Errors (${result.errors.length}):\n`);
+        for (const error of result.errors) {
+            const location = error.file ? ` in ${error.file}` : '';
+            const line = error.line ? `:${error.line}` : '';
+            const facet = error.facetId ? ` [${error.facetId}]` : '';
+            console.log(`  ${getErrorIcon(error.type)} ${error.message}${location}${line}${facet}`);
+        }
+        console.log('');
+    }
+    // Print warnings
+    if (result.warnings.length > 0) {
+        console.log(`⚠️  Warnings (${result.warnings.length}):\n`);
+        for (const warning of result.warnings) {
+            const location = warning.file ? ` in ${warning.file}` : '';
+            const line = warning.line ? `:${warning.line}` : '';
+            const facet = warning.facetId ? ` [${warning.facetId}]` : '';
+            console.log(`  ⚠️  ${warning.message}${location}${line}${facet}`);
+        }
+        console.log('');
+    }
+    // Summary
+    if (result.valid) {
+        console.log('✅ Validation passed with warnings.');
+    }
+    else {
+        console.log('❌ Validation failed. Please fix the errors above.');
+    }
+}
+/**
+ * Get icon for error type
+ */
+function getErrorIcon(type) {
+    switch (type) {
+        case 'missing-source':
+            return '📄';
+        case 'missing-section':
+            return '📑';
+        case 'invalid-facet-id':
+            return '🏷️';
+        case 'orphan-test':
+            return '🔗';
+        case 'duplicate-id':
+            return '🔄';
+        default:
+            return '❌';
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/cli/commands/validate.js.map

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

package/dist/cli/commands/watch.d.ts

@@ -0,0 +1,10 @@
+interface WatchOptions {
+    config?: string;
+    validate?: boolean;
+}
+/**
+ * Watch for changes and re-run analysis
+ */
+export declare function watchCommand(options?: WatchOptions): Promise<void>;
+export {};
+//# sourceMappingURL=watch.d.ts.map

package/dist/cli/commands/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/watch.ts"],"names":[],"mappings":"AAWA,UAAU,YAAY;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqD5E"}

package/dist/cli/commands/watch.js

@@ -0,0 +1,151 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.watchCommand = watchCommand;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const chokidar_1 = require("chokidar");
+const CoverageCalculator_js_1 = require("../../core/CoverageCalculator.js");
+const Validator_js_1 = require("../../core/Validator.js");
+const JsonReporter_js_1 = require("../../reporters/JsonReporter.js");
+const HtmlReporter_js_1 = require("../../reporters/HtmlReporter.js");
+const MarkdownReporter_js_1 = require("../../reporters/MarkdownReporter.js");
+const types_js_1 = require("../../types.js");
+/**
+ * Watch for changes and re-run analysis
+ */
+async function watchCommand(options = {}) {
+    const cwd = process.cwd();
+    // Load config
+    const config = await loadConfig(options.config, cwd);
+    console.log('💎 Facet Coverage Watch Mode\n');
+    console.log('Watching for changes...\n');
+    // Initial run
+    await runAnalysis(config, cwd, options.validate);
+    // Watch patterns
+    const watchPatterns = [
+        ...config.structureFiles,
+        'features/**/facets/**/*.md',
+        `${config.testDir}/**/*.{ts,js,tsx,jsx}`,
+    ];
+    // Create watcher
+    const watcher = (0, chokidar_1.watch)(watchPatterns, {
+        cwd,
+        ignoreInitial: true,
+        persistent: true,
+    });
+    // Debounce timer
+    let debounceTimer = null;
+    watcher.on('all', (event, path) => {
+        // Clear existing timer
+        if (debounceTimer) {
+            clearTimeout(debounceTimer);
+        }
+        // Debounce to avoid multiple rapid runs
+        debounceTimer = setTimeout(async () => {
+            console.log(`\n📝 Change detected: ${path} (${event})`);
+            console.log('Re-analyzing...\n');
+            await runAnalysis(config, cwd, options.validate);
+        }, 300);
+    });
+    // Handle shutdown
+    process.on('SIGINT', () => {
+        console.log('\n\n👋 Stopping watch mode...');
+        watcher.close();
+        process.exit(0);
+    });
+    // Keep process alive
+    console.log('Press Ctrl+C to stop.\n');
+}
+/**
+ * Run analysis
+ */
+async function runAnalysis(config, cwd, validate = false) {
+    const startTime = Date.now();
+    try {
+        // Optionally validate first
+        if (validate) {
+            const validator = new Validator_js_1.Validator(config);
+            const validationResult = await validator.validate(cwd);
+            if (!validationResult.valid) {
+                console.log('❌ Validation failed:');
+                for (const error of validationResult.errors) {
+                    console.log(`   - ${error.message}`);
+                }
+                console.log('');
+                return;
+            }
+        }
+        // Calculate coverage
+        const calculator = new CoverageCalculator_js_1.CoverageCalculator(config);
+        const report = await calculator.calculateCoverage(cwd);
+        // Generate reports
+        if (config.output.formats.includes('json')) {
+            const reporter = new JsonReporter_js_1.JsonReporter(config);
+            reporter.write(report, cwd);
+        }
+        if (config.output.formats.includes('html')) {
+            const reporter = new HtmlReporter_js_1.HtmlReporter(config);
+            reporter.write(report, cwd);
+        }
+        if (config.output.formats.includes('markdown')) {
+            const reporter = new MarkdownReporter_js_1.MarkdownReporter(config);
+            reporter.write(report, cwd);
+        }
+        // Print summary
+        const duration = Date.now() - startTime;
+        const icon = report.summary.percentage >= 80 ? '✅' : report.summary.percentage >= 50 ? '🟡' : '❌';
+        console.log('┌─────────────────────────────────────────────┐');
+        console.log(`│ ${icon} Coverage: ${String(report.summary.percentage + '%').padEnd(6)} (${report.summary.coveredFacets}/${report.summary.totalFacets} facets)`.padEnd(45) + ' │');
+        console.log('└─────────────────────────────────────────────┘');
+        // Show type breakdown
+        if (report.byType.length > 0) {
+            for (const type of report.byType) {
+                const typeIcon = type.percentage === 100 ? '✅' : type.percentage >= 75 ? '🟡' : '❌';
+                console.log(`  ${typeIcon} ${type.type}: ${type.percentage}%`);
+            }
+        }
+        console.log(`\n⏱️  Analysis completed in ${duration}ms`);
+        // Check thresholds
+        const thresholdResult = calculator.checkThresholds(report);
+        if (!thresholdResult.passed) {
+            console.log('\n⚠️  Thresholds not met:');
+            for (const failure of thresholdResult.failures) {
+                console.log(`   - ${failure}`);
+            }
+        }
+    }
+    catch (error) {
+        console.error('❌ Error during analysis:', error);
+    }
+}
+/**
+ * Load configuration from file or use defaults
+ */
+async function loadConfig(configPath, cwd) {
+    const configFiles = [
+        configPath,
+        'facet.config.js',
+        'facet.config.mjs',
+        'facet.config.json',
+    ].filter(Boolean);
+    for (const file of configFiles) {
+        const fullPath = (0, path_1.resolve)(cwd, file);
+        if ((0, fs_1.existsSync)(fullPath)) {
+            if (file.endsWith('.json')) {
+                const content = (0, fs_1.readFileSync)(fullPath, 'utf-8');
+                return { ...types_js_1.defaultConfig, ...JSON.parse(content) };
+            }
+            else {
+                try {
+                    const imported = await import(fullPath);
+                    return { ...types_js_1.defaultConfig, ...(imported.default || imported) };
+                }
+                catch (error) {
+                    console.warn(`Warning: Could not load config from ${file}`);
+                }
+            }
+        }
+    }
+    return types_js_1.defaultConfig;
+}
+//# sourceMappingURL=watch.js.map

package/dist/cli/commands/watch.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const generate_js_1 = require("./commands/generate.js");
+const analyze_js_1 = require("./commands/analyze.js");
+const validate_js_1 = require("./commands/validate.js");
+const watch_js_1 = require("./commands/watch.js");
+const program = new commander_1.Command();
+program
+    .name('facet')
+    .description('💎 Test every facet of your features - natural specifications with rigorous coverage tracking')
+    .version('0.1.0');
+// Generate command
+program
+    .command('generate <dir>')
+    .description('Generate structure.json from facet markdown files')
+    .option('-o, --output <path>', 'Output directory for structure.json')
+    .option('-t, --type <type>', 'Override facet type (default: derived from filename)')
+    .action(generate_js_1.generateCommand);
+// Analyze command
+program
+    .command('analyze')
+    .description('Analyze facet coverage')
+    .option('-c, --config <path>', 'Path to config file')
+    .option('-f, --format <format>', 'Output format (json, html, markdown)')
+    .option('-t, --threshold <number>', 'Coverage threshold percentage')
+    .option('--json', 'Output results as JSON')
+    .option('--silent', 'Suppress console output')
+    .action(analyze_js_1.analyzeCommand);
+// Validate command
+program
+    .command('validate')
+    .description('Validate facet structure and test links')
+    .option('-c, --config <path>', 'Path to config file')
+    .option('--strict', 'Enable strict validation (require all tests linked)')
+    .option('--json', 'Output results as JSON')
+    .action(validate_js_1.validateCommand);
+// Watch command
+program
+    .command('watch')
+    .description('Watch for changes and re-run analysis')
+    .option('-c, --config <path>', 'Path to config file')
+    .option('-v, --validate', 'Run validation before analysis')
+    .action(watch_js_1.watchCommand);
+// Parse arguments
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";;AAAA,yCAAoC;AACpC,wDAAyD;AACzD,sDAAuD;AACvD,wDAAyD;AACzD,kDAAmD;AAEnD,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,OAAO,CAAC;KACb,WAAW,CAAC,+FAA+F,CAAC;KAC5G,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,mBAAmB;AACnB,OAAO;KACJ,OAAO,CAAC,gBAAgB,CAAC;KACzB,WAAW,CAAC,mDAAmD,CAAC;KAChE,MAAM,CAAC,qBAAqB,EAAE,qCAAqC,CAAC;KACpE,MAAM,CAAC,mBAAmB,EAAE,sDAAsD,CAAC;KACnF,MAAM,CAAC,6BAAe,CAAC,CAAC;AAE3B,kBAAkB;AAClB,OAAO;KACJ,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,wBAAwB,CAAC;KACrC,MAAM,CAAC,qBAAqB,EAAE,qBAAqB,CAAC;KACpD,MAAM,CAAC,uBAAuB,EAAE,sCAAsC,CAAC;KACvE,MAAM,CAAC,0BAA0B,EAAE,+BAA+B,CAAC;KACnE,MAAM,CAAC,QAAQ,EAAE,wBAAwB,CAAC;KAC1C,MAAM,CAAC,UAAU,EAAE,yBAAyB,CAAC;KAC7C,MAAM,CAAC,2BAAc,CAAC,CAAC;AAE1B,mBAAmB;AACnB,OAAO;KACJ,OAAO,CAAC,UAAU,CAAC;KACnB,WAAW,CAAC,yCAAyC,CAAC;KACtD,MAAM,CAAC,qBAAqB,EAAE,qBAAqB,CAAC;KACpD,MAAM,CAAC,UAAU,EAAE,qDAAqD,CAAC;KACzE,MAAM,CAAC,QAAQ,EAAE,wBAAwB,CAAC;KAC1C,MAAM,CAAC,6BAAe,CAAC,CAAC;AAE3B,gBAAgB;AAChB,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,uCAAuC,CAAC;KACpD,MAAM,CAAC,qBAAqB,EAAE,qBAAqB,CAAC;KACpD,MAAM,CAAC,gBAAgB,EAAE,gCAAgC,CAAC;KAC1D,MAAM,CAAC,uBAAY,CAAC,CAAC;AAExB,kBAAkB;AAClB,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/core/CoverageCalculator.d.ts

@@ -0,0 +1,34 @@
+import type { FacetConfig, FacetCoverage, CoverageReport } from '../types.js';
+/**
+ * Calculates coverage metrics for facets
+ */
+export declare class CoverageCalculator {
+    private config;
+    private structureReader;
+    private testScanner;
+    constructor(config?: Partial<FacetConfig>);
+    /**
+     * Calculate complete coverage report
+     */
+    calculateCoverage(cwd?: string): Promise<CoverageReport>;
+    /**
+     * Calculate coverage for a single feature
+     */
+    private calculateFeatureCoverage;
+    /**
+     * Calculate coverage breakdown by facet type
+     */
+    private calculateTypeCoverage;
+    /**
+     * Check if coverage meets configured thresholds
+     */
+    checkThresholds(report: CoverageReport): {
+        passed: boolean;
+        failures: string[];
+    };
+    /**
+     * Get coverage for a specific facet
+     */
+    getFacetCoverage(facetId: string, cwd?: string): Promise<FacetCoverage | null>;
+}
+//# sourceMappingURL=CoverageCalculator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CoverageCalculator.d.ts","sourceRoot":"","sources":["../../src/core/CoverageCalculator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EAIX,aAAa,EAGb,cAAc,EACf,MAAM,aAAa,CAAC;AAKrB;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM;IAM7C;;OAEG;IACG,iBAAiB,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,cAAc,CAAC;IA+D7E;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAsChC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA6B7B;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG;QACvC,MAAM,EAAE,OAAO,CAAC;QAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB;IA0BD;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;CAYpG"}

package/dist/core/CoverageCalculator.js

@@ -0,0 +1,167 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CoverageCalculator = void 0;
+const path_1 = require("path");
+const types_js_1 = require("../types.js");
+const StructureReader_js_1 = require("./StructureReader.js");
+const TestScanner_js_1 = require("./TestScanner.js");
+/**
+ * Calculates coverage metrics for facets
+ */
+class CoverageCalculator {
+    config;
+    structureReader;
+    testScanner;
+    constructor(config = {}) {
+        this.config = { ...types_js_1.defaultConfig, ...config };
+        this.structureReader = new StructureReader_js_1.StructureReader(this.config);
+        this.testScanner = new TestScanner_js_1.TestScanner(this.config);
+    }
+    /**
+     * Calculate complete coverage report
+     */
+    async calculateCoverage(cwd = process.cwd()) {
+        // Get all structures and test links
+        const structures = await this.structureReader.readAllStructures(cwd);
+        const testLinks = await this.testScanner.scanAllTests(cwd);
+        // Build facet ID to test links map
+        const facetToTests = new Map();
+        for (const link of testLinks) {
+            for (const facetId of link.facetIds) {
+                const existing = facetToTests.get(facetId) || [];
+                existing.push(link);
+                facetToTests.set(facetId, existing);
+            }
+        }
+        // Calculate feature-level coverage
+        const features = [];
+        const allFacets = [];
+        const uncovered = [];
+        for (const [structureFile, structure] of structures) {
+            const featureCoverage = this.calculateFeatureCoverage(structure, structureFile, facetToTests);
+            features.push(featureCoverage);
+            // Collect all facet coverage data
+            allFacets.push(...featureCoverage.facets);
+            // Collect uncovered facets
+            for (const fc of featureCoverage.facets) {
+                if (!fc.covered) {
+                    uncovered.push(fc.facet);
+                }
+            }
+        }
+        // Calculate overall statistics
+        const totalFacets = allFacets.length;
+        const coveredFacets = allFacets.filter(f => f.covered).length;
+        const uncoveredFacets = totalFacets - coveredFacets;
+        const percentage = totalFacets > 0 ? Math.round((coveredFacets / totalFacets) * 100) : 100;
+        // Calculate coverage by type
+        const byType = this.calculateTypeCoverage(allFacets);
+        return {
+            timestamp: new Date().toISOString(),
+            summary: {
+                totalFacets,
+                coveredFacets,
+                uncoveredFacets,
+                percentage,
+            },
+            byType,
+            features,
+            tests: testLinks,
+            uncovered,
+        };
+    }
+    /**
+     * Calculate coverage for a single feature
+     */
+    calculateFeatureCoverage(structure, structureFile, facetToTests) {
+        const facetCoverages = [];
+        for (const facet of structure.facets) {
+            const coveredBy = facetToTests.get(facet.id) || [];
+            facetCoverages.push({
+                facet,
+                covered: coveredBy.length > 0,
+                coveredBy,
+            });
+        }
+        const totalFacets = facetCoverages.length;
+        const coveredFacets = facetCoverages.filter(f => f.covered).length;
+        const percentage = totalFacets > 0 ? Math.round((coveredFacets / totalFacets) * 100) : 100;
+        // Calculate by type for this feature
+        const byType = this.calculateTypeCoverage(facetCoverages);
+        // Get feature path (parent of .facet directory)
+        const facetDir = (0, path_1.dirname)(structureFile);
+        const featurePath = (0, path_1.dirname)(facetDir);
+        return {
+            feature: structure.feature,
+            path: featurePath,
+            totalFacets,
+            coveredFacets,
+            percentage,
+            byType,
+            facets: facetCoverages,
+        };
+    }
+    /**
+     * Calculate coverage breakdown by facet type
+     */
+    calculateTypeCoverage(facetCoverages) {
+        const typeMap = new Map();
+        for (const fc of facetCoverages) {
+            const type = fc.facet.type;
+            const existing = typeMap.get(type) || { total: 0, covered: 0 };
+            existing.total++;
+            if (fc.covered) {
+                existing.covered++;
+            }
+            typeMap.set(type, existing);
+        }
+        const result = [];
+        for (const [type, stats] of typeMap) {
+            result.push({
+                type,
+                total: stats.total,
+                covered: stats.covered,
+                percentage: stats.total > 0 ? Math.round((stats.covered / stats.total) * 100) : 100,
+            });
+        }
+        // Sort by type name
+        result.sort((a, b) => a.type.localeCompare(b.type));
+        return result;
+    }
+    /**
+     * Check if coverage meets configured thresholds
+     */
+    checkThresholds(report) {
+        const failures = [];
+        // Check global threshold
+        if (report.summary.percentage < this.config.thresholds.global) {
+            failures.push(`Global coverage ${report.summary.percentage}% is below threshold of ${this.config.thresholds.global}%`);
+        }
+        // Check per-type thresholds
+        for (const [type, threshold] of Object.entries(this.config.thresholds.byType)) {
+            const typeCoverage = report.byType.find(t => t.type === type);
+            if (typeCoverage && typeCoverage.percentage < threshold) {
+                failures.push(`${type} coverage ${typeCoverage.percentage}% is below threshold of ${threshold}%`);
+            }
+        }
+        return {
+            passed: failures.length === 0,
+            failures,
+        };
+    }
+    /**
+     * Get coverage for a specific facet
+     */
+    async getFacetCoverage(facetId, cwd = process.cwd()) {
+        const report = await this.calculateCoverage(cwd);
+        for (const feature of report.features) {
+            const facetCoverage = feature.facets.find(f => f.facet.id === facetId);
+            if (facetCoverage) {
+                return facetCoverage;
+            }
+        }
+        return null;
+    }
+}
+exports.CoverageCalculator = CoverageCalculator;
+//# sourceMappingURL=CoverageCalculator.js.map