@facet-coverage/core 0.1.0

package/dist/reporters/MarkdownReporter.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MarkdownReporter = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const types_js_1 = require("../types.js");
+/**
+ * Generates Markdown coverage reports
+ */
+class MarkdownReporter {
+    config;
+    constructor(config = {}) {
+        this.config = { ...types_js_1.defaultConfig, ...config };
+    }
+    /**
+     * Generate Markdown report
+     */
+    generate(report) {
+        const lines = [];
+        // Header
+        lines.push('# Facet Coverage Report');
+        lines.push('');
+        lines.push(`Generated: ${new Date(report.timestamp).toLocaleString()}`);
+        lines.push('');
+        // Overall Summary
+        lines.push('## Overall Summary');
+        lines.push('');
+        lines.push(`| Metric | Value |`);
+        lines.push(`| ------ | ----- |`);
+        lines.push(`| **Coverage** | **${report.summary.percentage}%** |`);
+        lines.push(`| Total Facets | ${report.summary.totalFacets} |`);
+        lines.push(`| Covered | ${report.summary.coveredFacets} |`);
+        lines.push(`| Uncovered | ${report.summary.uncoveredFacets} |`);
+        lines.push('');
+        // Coverage by Type
+        if (report.byType.length > 0) {
+            lines.push('## Coverage by Type');
+            lines.push('');
+            lines.push('| Type | Coverage | Covered | Total |');
+            lines.push('| ---- | -------- | ------- | ----- |');
+            for (const typeCov of report.byType) {
+                const icon = typeCov.percentage === 100 ? '✅' : typeCov.percentage >= 75 ? '🟡' : '❌';
+                lines.push(`| ${typeCov.type} | ${icon} ${typeCov.percentage}% | ${typeCov.covered} | ${typeCov.total} |`);
+            }
+            lines.push('');
+        }
+        // Per-Feature Coverage
+        lines.push('## Features');
+        lines.push('');
+        for (const feature of report.features) {
+            lines.push(...this.generateFeatureSection(feature));
+            lines.push('');
+        }
+        // Uncovered Facets
+        if (report.uncovered.length > 0) {
+            lines.push('## Uncovered Facets');
+            lines.push('');
+            lines.push('The following facets are not covered by any tests:');
+            lines.push('');
+            for (const facet of report.uncovered) {
+                lines.push(`- **${facet.id}** (${facet.type})`);
+                lines.push(`  - Source: \`${facet.source.file}#${facet.source.section}\``);
+            }
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Generate section for a single feature
+     */
+    generateFeatureSection(feature) {
+        const lines = [];
+        const icon = feature.percentage === 100 ? '✅' : feature.percentage >= 75 ? '🟡' : '❌';
+        lines.push(`### ${feature.feature} ${icon}`);
+        lines.push('');
+        lines.push(`**Coverage:** ${feature.percentage}% (${feature.coveredFacets}/${feature.totalFacets} facets)`);
+        lines.push('');
+        // Type breakdown for this feature
+        if (feature.byType.length > 1) {
+            lines.push('| Type | Coverage |');
+            lines.push('| ---- | -------- |');
+            for (const typeCov of feature.byType) {
+                lines.push(`| ${typeCov.type} | ${typeCov.percentage}% (${typeCov.covered}/${typeCov.total}) |`);
+            }
+            lines.push('');
+        }
+        // Covered facets
+        const covered = feature.facets.filter(f => f.covered);
+        if (covered.length > 0) {
+            lines.push('#### Covered Facets');
+            lines.push('');
+            for (const fc of covered) {
+                lines.push(...this.generateFacetDetails(fc, true));
+            }
+            lines.push('');
+        }
+        // Uncovered facets
+        const uncovered = feature.facets.filter(f => !f.covered);
+        if (uncovered.length > 0) {
+            lines.push('#### Uncovered Facets');
+            lines.push('');
+            for (const fc of uncovered) {
+                lines.push(...this.generateFacetDetails(fc, false));
+            }
+        }
+        return lines;
+    }
+    /**
+     * Generate details for a single facet
+     */
+    generateFacetDetails(fc, showTests) {
+        const lines = [];
+        const icon = fc.covered ? '✅' : '❌';
+        lines.push(`##### ${icon} ${fc.facet.id}`);
+        lines.push('');
+        lines.push(`- **Type:** ${fc.facet.type}`);
+        lines.push(`- **Source:** \`${fc.facet.source.file}#${fc.facet.source.section}\``);
+        if (showTests && fc.coveredBy.length > 0) {
+            lines.push(`- **Covered by:**`);
+            for (const test of fc.coveredBy) {
+                lines.push(`  - \`${test.file}\`: ${test.title}`);
+            }
+        }
+        lines.push('');
+        return lines;
+    }
+    /**
+     * Write Markdown report to file
+     */
+    write(report, cwd = process.cwd()) {
+        const outputDir = (0, path_1.join)(cwd, this.config.output.dir);
+        const outputPath = (0, path_1.join)(outputDir, 'coverage.md');
+        // Ensure output directory exists
+        (0, fs_1.mkdirSync)(outputDir, { recursive: true });
+        const content = this.generate(report);
+        (0, fs_1.writeFileSync)(outputPath, content, 'utf-8');
+        return outputPath;
+    }
+}
+exports.MarkdownReporter = MarkdownReporter;
+//# sourceMappingURL=MarkdownReporter.js.map

package/dist/reporters/MarkdownReporter.js.map

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

package/dist/reporters/index.d.ts

@@ -0,0 +1,4 @@
+export { JsonReporter } from './JsonReporter.js';
+export { HtmlReporter } from './HtmlReporter.js';
+export { MarkdownReporter } from './MarkdownReporter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/reporters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/reporters/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MarkdownReporter = exports.HtmlReporter = exports.JsonReporter = void 0;
+var JsonReporter_js_1 = require("./JsonReporter.js");
+Object.defineProperty(exports, "JsonReporter", { enumerable: true, get: function () { return JsonReporter_js_1.JsonReporter; } });
+var HtmlReporter_js_1 = require("./HtmlReporter.js");
+Object.defineProperty(exports, "HtmlReporter", { enumerable: true, get: function () { return HtmlReporter_js_1.HtmlReporter; } });
+var MarkdownReporter_js_1 = require("./MarkdownReporter.js");
+Object.defineProperty(exports, "MarkdownReporter", { enumerable: true, get: function () { return MarkdownReporter_js_1.MarkdownReporter; } });
+//# sourceMappingURL=index.js.map

package/dist/reporters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/reporters/index.ts"],"names":[],"mappings":";;;AAAA,qDAAiD;AAAxC,+GAAA,YAAY,OAAA;AACrB,qDAAiD;AAAxC,+GAAA,YAAY,OAAA;AACrB,6DAAyD;AAAhD,uHAAA,gBAAgB,OAAA"}

package/dist/types.d.ts

@@ -0,0 +1,205 @@
+/**
+ * Core types for Facet Coverage
+ */
+/**
+ * Represents a single facet in the structure
+ */
+export interface Facet {
+    /** Unique identifier for this facet */
+    id: string;
+    /** Source file and section information */
+    source: {
+        /** Relative path to the facet file */
+        file: string;
+        /** Section identifier within the file (slug) */
+        section: string;
+    };
+    /** Type of facet (business, compliance, ux, etc.) */
+    type: string;
+    /** Optional human-readable title */
+    title?: string;
+    /** Optional description */
+    description?: string;
+}
+/**
+ * Structure definition for a feature
+ */
+export interface FacetStructure {
+    /** Feature name */
+    feature: string;
+    /** List of facets in this feature */
+    facets: Facet[];
+    /** Optional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Represents a test that links to facets
+ */
+export interface TestLink {
+    /** Test file path */
+    file: string;
+    /** Test title/name */
+    title: string;
+    /** Full test name including describe blocks */
+    fullTitle: string;
+    /** Facet IDs this test covers */
+    facetIds: string[];
+    /** Line number in the test file */
+    line?: number;
+}
+/**
+ * Coverage information for a single facet
+ */
+export interface FacetCoverage {
+    /** The facet being tracked */
+    facet: Facet;
+    /** Whether this facet is covered by at least one test */
+    covered: boolean;
+    /** Tests that cover this facet */
+    coveredBy: TestLink[];
+}
+/**
+ * Coverage summary by facet type
+ */
+export interface TypeCoverage {
+    /** Facet type */
+    type: string;
+    /** Total number of facets of this type */
+    total: number;
+    /** Number of covered facets */
+    covered: number;
+    /** Coverage percentage */
+    percentage: number;
+}
+/**
+ * Feature-level coverage summary
+ */
+export interface FeatureCoverage {
+    /** Feature name */
+    feature: string;
+    /** Path to the feature directory */
+    path: string;
+    /** Total number of facets */
+    totalFacets: number;
+    /** Number of covered facets */
+    coveredFacets: number;
+    /** Coverage percentage */
+    percentage: number;
+    /** Coverage breakdown by type */
+    byType: TypeCoverage[];
+    /** Detailed facet coverage */
+    facets: FacetCoverage[];
+}
+/**
+ * Complete coverage report
+ */
+export interface CoverageReport {
+    /** Timestamp when report was generated */
+    timestamp: string;
+    /** Overall coverage statistics */
+    summary: {
+        totalFacets: number;
+        coveredFacets: number;
+        uncoveredFacets: number;
+        percentage: number;
+    };
+    /** Coverage breakdown by type across all features */
+    byType: TypeCoverage[];
+    /** Per-feature coverage details */
+    features: FeatureCoverage[];
+    /** All test links found */
+    tests: TestLink[];
+    /** Uncovered facets for easy access */
+    uncovered: Facet[];
+}
+/**
+ * Validation error
+ */
+export interface ValidationError {
+    /** Error type */
+    type: 'missing-source' | 'missing-section' | 'invalid-facet-id' | 'orphan-test' | 'duplicate-id';
+    /** Error message */
+    message: string;
+    /** File where the error occurred */
+    file?: string;
+    /** Line number if applicable */
+    line?: number;
+    /** Related facet ID */
+    facetId?: string;
+}
+/**
+ * Validation result
+ */
+export interface ValidationResult {
+    /** Whether validation passed */
+    valid: boolean;
+    /** List of errors found */
+    errors: ValidationError[];
+    /** List of warnings */
+    warnings: ValidationError[];
+}
+/**
+ * Configuration options
+ */
+export interface FacetConfig {
+    /** Glob patterns for structure files */
+    structureFiles: string[];
+    /** Test directory pattern */
+    testDir: string;
+    /** Test file patterns */
+    testPatterns?: string[];
+    /** Validation options */
+    validation: {
+        /** Verify facet source files exist */
+        requireSourceExists: boolean;
+        /** Verify sections exist in source files */
+        requireSectionExists: boolean;
+        /** Require all tests to be linked to facets */
+        requireAllTestsLinked: boolean;
+    };
+    /** Output options */
+    output: {
+        /** Output directory for reports */
+        dir: string;
+        /** Output formats to generate */
+        formats: ('json' | 'html' | 'markdown')[];
+    };
+    /** Coverage thresholds */
+    thresholds: {
+        /** Global coverage threshold */
+        global: number;
+        /** Per-type thresholds */
+        byType: Record<string, number>;
+    };
+}
+/**
+ * Default configuration
+ */
+export declare const defaultConfig: FacetConfig;
+/**
+ * Parsed section from a markdown file
+ */
+export interface MarkdownSection {
+    /** Section title */
+    title: string;
+    /** Slug (URL-friendly version of title) */
+    slug: string;
+    /** Heading level (1-6) */
+    level: number;
+    /** Line number where section starts */
+    startLine: number;
+    /** Line number where section ends */
+    endLine: number;
+    /** Section content */
+    content: string;
+}
+/**
+ * Parsed markdown file
+ */
+export interface ParsedMarkdown {
+    /** File path */
+    file: string;
+    /** All sections in the file */
+    sections: MarkdownSection[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * Core types for Facet Coverage
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultConfig = void 0;
+/**
+ * Default configuration
+ */
+exports.defaultConfig = {
+    structureFiles: ['features/**/.facet/structure.json'],
+    testDir: './features/**/tests',
+    testPatterns: ['**/*.spec.ts', '**/*.test.ts'],
+    validation: {
+        requireSourceExists: true,
+        requireSectionExists: true,
+        requireAllTestsLinked: false,
+    },
+    output: {
+        dir: '.facet-coverage',
+        formats: ['json', 'html', 'markdown'],
+    },
+    thresholds: {
+        global: 75,
+        byType: {},
+    },
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAuLH;;GAEG;AACU,QAAA,aAAa,GAAgB;IACxC,cAAc,EAAE,CAAC,mCAAmC,CAAC;IACrD,OAAO,EAAE,qBAAqB;IAC9B,YAAY,EAAE,CAAC,cAAc,EAAE,cAAc,CAAC;IAC9C,UAAU,EAAE;QACV,mBAAmB,EAAE,IAAI;QACzB,oBAAoB,EAAE,IAAI;QAC1B,qBAAqB,EAAE,KAAK;KAC7B;IACD,MAAM,EAAE;QACN,GAAG,EAAE,iBAAiB;QACtB,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC;KACtC;IACD,UAAU,EAAE;QACV,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,EAAE;KACX;CACF,CAAC"}

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "@facet-coverage/core",
+  "version": "0.1.0",
+  "description": "Test every facet of your features - natural specifications with rigorous coverage tracking",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "facet-coverage": "bin/facet-coverage.js",
+    "facet": "bin/facet-coverage.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./playwright": {
+      "import": "./dist/integrations/playwright.js",
+      "require": "./dist/integrations/playwright.js",
+      "types": "./dist/integrations/playwright.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "bin",
+    "templates",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "bun run tsc",
+    "dev": "bun run tsc --watch",
+    "test": "bun test features/core features/cli features/reporters features/integrations",
+    "test:all": "bun test",
+    "lint": "eslint src",
+    "prepublishOnly": "bun run build",
+    "version:patch": "npm version patch && git push && git push --tags",
+    "version:minor": "npm version minor && git push && git push --tags",
+    "version:major": "npm version major && git push && git push --tags"
+  },
+  "keywords": [
+    "testing",
+    "coverage",
+    "playwright",
+    "requirements",
+    "traceability",
+    "documentation",
+    "facet",
+    "bdd",
+    "specifications"
+  ],
+  "peerDependencies": {
+    "@playwright/test": ">=1.40.0"
+  },
+  "peerDependenciesMeta": {
+    "@playwright/test": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "glob": "^10.3.10",
+    "chokidar": "^3.5.3"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.40.0",
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0",
+    "@types/bun": "latest"
+  },
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/iraycd/facet-coverage.git"
+  },
+  "bugs": {
+    "url": "https://github.com/iraycd/facet-coverage/issues"
+  },
+  "homepage": "https://github.com/iraycd/facet-coverage#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}