@facet-coverage/core 0.3.0 → 0.5.0

package/dist/core/Validator.js

@@ -100,6 +100,8 @@ class Validator {
         const warnings = [];
         const structureDir = (0, path_1.dirname)(structureFile);
         const featureDir = (0, path_1.dirname)(structureDir);
+        // Build a set of all facet IDs in this structure for parent validation
+        const facetIdsInStructure = new Set(structure.facets.map(f => f.id));
         for (const facet of structure.facets) {
             // Validate source file exists
             if (this.config.validation.requireSourceExists) {
@@ -113,8 +115,8 @@ class Validator {
                     });
                     continue; // Skip section check if file doesn't exist
                 }
-                // Validate section exists
-                if (this.config.validation.requireSectionExists) {
+                // Validate section exists (only for non-sub-facets, sub-facets reference parent's section)
+                if (this.config.validation.requireSectionExists && !facet.isSubFacet) {
                     const sectionExists = this.facetParser.sectionExists(sourcePath, facet.source.section);
                     if (!sectionExists) {
                         errors.push({
@@ -135,6 +137,17 @@ class Validator {
                     facetId: facet.id,
                 });
             }
+            // Validate sub-facet parent relationship
+            if (facet.isSubFacet && facet.parentId) {
+                if (!facetIdsInStructure.has(facet.parentId)) {
+                    errors.push({
+                        type: 'orphan-subfacet',
+                        message: `Sub-facet '${facet.id}' references non-existent parent '${facet.parentId}'`,
+                        file: structureFile,
+                        facetId: facet.id,
+                    });
+                }
+            }
         }
         return {
             valid: errors.length === 0,
@@ -144,10 +157,15 @@ class Validator {
     }
     /**
      * Check if a facet ID is valid
+     * Valid formats:
+     * - type:section (e.g., "business:guest-purchase-flow")
+     * - path/type:section (e.g., "features/cli/product:generate-command")
+     * - type:section/sub-id (e.g., "compliance:pci-dss/tls") - sub-facet
      */
     isValidFacetId(id) {
-        // Allow alphanumeric, hyphens, underscores, and colons
-        return /^[a-zA-Z0-9_-]+(:?[a-zA-Z0-9_-]+)*$/.test(id);
+        // Allow alphanumeric, hyphens, underscores, colons, and slashes
+        // Format: [path/]*type:section[/sub-id]
+        return /^[a-zA-Z0-9/_-]+:[a-zA-Z0-9_-]+(?:\/[a-zA-Z0-9_-]+)?$/.test(id);
     }
     /**
      * Check if a reference is a valid path-style reference

package/dist/core/Validator.js.map

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

package/dist/server/DevServer.d.ts

@@ -0,0 +1,48 @@
+import type { FacetConfig, CoverageReport } from '../types.js';
+export interface DevServerOptions {
+    port: number;
+    host: string;
+    open: boolean;
+    packageRoot: string;
+}
+export interface WebSocketData {
+    id: string;
+}
+/**
+ * Development server for browsing facet documentation with live coverage
+ */
+export declare class DevServer {
+    private server;
+    private hotReload;
+    private config;
+    private cwd;
+    private options;
+    private router;
+    private coverageReport;
+    constructor(config: FacetConfig, cwd: string, options: DevServerOptions);
+    /**
+     * Get the current coverage report
+     */
+    getCoverageReport(): CoverageReport | null;
+    /**
+     * Get config
+     */
+    getConfig(): FacetConfig;
+    /**
+     * Get current working directory
+     */
+    getCwd(): string;
+    /**
+     * Calculate coverage and update the cached report
+     */
+    refreshCoverage(): Promise<CoverageReport>;
+    /**
+     * Start the development server
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the server
+     */
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=DevServer.d.ts.map

package/dist/server/DevServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevServer.d.ts","sourceRoot":"","sources":["../../src/server/DevServer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAK/D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAA6C;IAC3D,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,cAAc,CAA+B;gBAEzC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB;IASvE;;OAEG;IACH,iBAAiB,IAAI,cAAc,GAAG,IAAI;IAI1C;;OAEG;IACH,SAAS,IAAI,WAAW;IAIxB;;OAEG;IACH,MAAM,IAAI,MAAM;IAIhB;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,cAAc,CAAC;IAMhD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuE5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAO5B"}

package/dist/server/DevServer.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DevServer = void 0;
+const CoverageCalculator_js_1 = require("../core/CoverageCalculator.js");
+const HotReloadManager_js_1 = require("./HotReloadManager.js");
+const routes_js_1 = require("./routes.js");
+/**
+ * Development server for browsing facet documentation with live coverage
+ */
+class DevServer {
+    server = null;
+    hotReload;
+    config;
+    cwd;
+    options;
+    router;
+    coverageReport = null;
+    constructor(config, cwd, options) {
+        this.config = config;
+        this.cwd = cwd;
+        this.options = options;
+        this.hotReload = new HotReloadManager_js_1.HotReloadManager(config, cwd);
+        this.hotReload.setPackageRoot(options.packageRoot);
+        this.router = (0, routes_js_1.createRouter)(this, options.packageRoot);
+    }
+    /**
+     * Get the current coverage report
+     */
+    getCoverageReport() {
+        return this.coverageReport;
+    }
+    /**
+     * Get config
+     */
+    getConfig() {
+        return this.config;
+    }
+    /**
+     * Get current working directory
+     */
+    getCwd() {
+        return this.cwd;
+    }
+    /**
+     * Calculate coverage and update the cached report
+     */
+    async refreshCoverage() {
+        const calculator = new CoverageCalculator_js_1.CoverageCalculator(this.config);
+        this.coverageReport = await calculator.calculateCoverage(this.cwd);
+        return this.coverageReport;
+    }
+    /**
+     * Start the development server
+     */
+    async start() {
+        // Initial coverage calculation
+        console.log('Calculating initial coverage...');
+        await this.refreshCoverage();
+        const self = this;
+        this.server = Bun.serve({
+            port: this.options.port,
+            hostname: this.options.host,
+            fetch(req, server) {
+                const url = new URL(req.url);
+                // Handle WebSocket upgrade
+                if (url.pathname === '/ws') {
+                    const upgraded = server.upgrade(req, {
+                        data: { id: crypto.randomUUID() },
+                    });
+                    if (upgraded)
+                        return undefined;
+                    return new Response('WebSocket upgrade failed', { status: 400 });
+                }
+                // Handle HTTP requests via router
+                return self.router.handle(req);
+            },
+            websocket: {
+                open(ws) {
+                    self.hotReload.addClient(ws);
+                    ws.send(JSON.stringify({ type: 'connected', data: { timestamp: new Date().toISOString() } }));
+                },
+                close(ws) {
+                    self.hotReload.removeClient(ws);
+                },
+                message(_ws, _message) {
+                    // Client messages not needed for now
+                },
+            },
+        });
+        // Start file watching for hot reload
+        this.hotReload.start(async () => {
+            await this.refreshCoverage();
+            return this.coverageReport;
+        }, () => {
+            (0, routes_js_1.clearClientBundleCache)();
+            console.log('  Client bundle cache cleared');
+        });
+        const url = `http://${this.options.host}:${this.options.port}`;
+        console.log(`
+\x1b[36m\x1b[1m   Facet Documentation Server\x1b[0m
+
+   Local:   ${url}
+
+   Watching for changes...
+   Press Ctrl+C to stop.
+`);
+        // Open browser if requested
+        if (this.options.open) {
+            const { exec } = await import('child_process');
+            const command = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
+            exec(`${command} ${url}`);
+        }
+    }
+    /**
+     * Stop the server
+     */
+    async stop() {
+        this.hotReload.stop();
+        if (this.server) {
+            this.server.stop();
+            this.server = null;
+        }
+    }
+}
+exports.DevServer = DevServer;
+//# sourceMappingURL=DevServer.js.map

package/dist/server/DevServer.js.map

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

package/dist/server/HotReloadManager.d.ts

@@ -0,0 +1,49 @@
+import type { ServerWebSocket } from 'bun';
+import type { FacetConfig, CoverageReport } from '../types.js';
+import type { WebSocketData } from './DevServer.js';
+/**
+ * Manages WebSocket connections and file watching for hot reload
+ */
+export declare class HotReloadManager {
+    private watcher;
+    private clientWatcher;
+    private clients;
+    private config;
+    private cwd;
+    private packageRoot;
+    private debounceTimer;
+    private clientDebounceTimer;
+    private onRefresh;
+    private onClientChange;
+    constructor(config: FacetConfig, cwd: string);
+    setPackageRoot(packageRoot: string): void;
+    /**
+     * Add a WebSocket client
+     */
+    addClient(ws: ServerWebSocket<WebSocketData>): void;
+    /**
+     * Remove a WebSocket client
+     */
+    removeClient(ws: ServerWebSocket<WebSocketData>): void;
+    /**
+     * Start watching for file changes
+     */
+    start(onRefresh: () => Promise<CoverageReport>, onClientChange?: () => void): void;
+    /**
+     * Stop watching and clean up
+     */
+    stop(): void;
+    /**
+     * Handle file change event with debouncing
+     */
+    private handleFileChange;
+    /**
+     * Handle client source file change with debouncing
+     */
+    private handleClientFileChange;
+    /**
+     * Broadcast a message to all connected clients
+     */
+    private broadcast;
+}
+//# sourceMappingURL=HotReloadManager.d.ts.map

package/dist/server/HotReloadManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HotReloadManager.d.ts","sourceRoot":"","sources":["../../src/server/HotReloadManager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,KAAK,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpD;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,aAAa,CAA0B;IAC/C,OAAO,CAAC,OAAO,CAAkD;IACjE,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,aAAa,CAA8C;IACnE,OAAO,CAAC,mBAAmB,CAA8C;IACzE,OAAO,CAAC,SAAS,CAAgD;IACjE,OAAO,CAAC,cAAc,CAA6B;gBAEvC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM;IAK5C,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAIzC;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,eAAe,CAAC,aAAa,CAAC,GAAG,IAAI;IAInD;;OAEG;IACH,YAAY,CAAC,EAAE,EAAE,eAAe,CAAC,aAAa,CAAC,GAAG,IAAI;IAItD;;OAEG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC,EAAE,MAAM,IAAI,GAAG,IAAI;IAmClF;;OAEG;IACH,IAAI,IAAI,IAAI;IAoBZ;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAyDxB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAuB9B;;OAEG;IACH,OAAO,CAAC,SAAS;CAWlB"}

package/dist/server/HotReloadManager.js

@@ -0,0 +1,187 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HotReloadManager = void 0;
+const chokidar_1 = require("chokidar");
+const generate_js_1 = require("../cli/commands/generate.js");
+/**
+ * Manages WebSocket connections and file watching for hot reload
+ */
+class HotReloadManager {
+    watcher = null;
+    clientWatcher = null;
+    clients = new Set();
+    config;
+    cwd;
+    packageRoot = '';
+    debounceTimer = null;
+    clientDebounceTimer = null;
+    onRefresh = null;
+    onClientChange = null;
+    constructor(config, cwd) {
+        this.config = config;
+        this.cwd = cwd;
+    }
+    setPackageRoot(packageRoot) {
+        this.packageRoot = packageRoot;
+    }
+    /**
+     * Add a WebSocket client
+     */
+    addClient(ws) {
+        this.clients.add(ws);
+    }
+    /**
+     * Remove a WebSocket client
+     */
+    removeClient(ws) {
+        this.clients.delete(ws);
+    }
+    /**
+     * Start watching for file changes
+     */
+    start(onRefresh, onClientChange) {
+        this.onRefresh = onRefresh;
+        this.onClientChange = onClientChange || null;
+        // Watch patterns matching facet markdown files and test files
+        const watchPatterns = [
+            ...this.config.structureFiles,
+            'features/**/facets/**/*.md',
+            `${this.config.testDir}/**/*.{ts,js,tsx,jsx}`,
+        ];
+        this.watcher = (0, chokidar_1.watch)(watchPatterns, {
+            cwd: this.cwd,
+            ignoreInitial: true,
+            persistent: true,
+        });
+        this.watcher.on('all', (event, path) => {
+            this.handleFileChange(event, path);
+        });
+        // Watch client source files for hot reload
+        if (this.packageRoot) {
+            const clientPath = `${this.packageRoot}/src/server/client`;
+            this.clientWatcher = (0, chokidar_1.watch)(`${clientPath}/**/*.{ts,tsx,css}`, {
+                ignoreInitial: true,
+                persistent: true,
+            });
+            this.clientWatcher.on('all', (event, path) => {
+                this.handleClientFileChange(event, path);
+            });
+        }
+    }
+    /**
+     * Stop watching and clean up
+     */
+    stop() {
+        if (this.debounceTimer) {
+            clearTimeout(this.debounceTimer);
+            this.debounceTimer = null;
+        }
+        if (this.clientDebounceTimer) {
+            clearTimeout(this.clientDebounceTimer);
+            this.clientDebounceTimer = null;
+        }
+        if (this.watcher) {
+            this.watcher.close();
+            this.watcher = null;
+        }
+        if (this.clientWatcher) {
+            this.clientWatcher.close();
+            this.clientWatcher = null;
+        }
+        this.clients.clear();
+    }
+    /**
+     * Handle file change event with debouncing
+     */
+    handleFileChange(event, path) {
+        // Clear existing timer
+        if (this.debounceTimer) {
+            clearTimeout(this.debounceTimer);
+        }
+        // Notify clients that a change was detected
+        this.broadcast({
+            type: 'file-change',
+            data: { event, path, timestamp: new Date().toISOString() },
+        });
+        // Check if this is a markdown file (facet definition)
+        const isMarkdownChange = path.endsWith('.md');
+        // Debounce to avoid multiple rapid refreshes
+        this.debounceTimer = setTimeout(async () => {
+            console.log(`\n  Change detected: ${path} (${event})`);
+            // If markdown changed, regenerate facet structure first
+            if (isMarkdownChange) {
+                console.log('  Regenerating facet structure...');
+                try {
+                    // Save and restore cwd since generateCommand uses process.cwd()
+                    const originalCwd = process.cwd();
+                    process.chdir(this.cwd);
+                    await (0, generate_js_1.generateCommand)(undefined, { quiet: true });
+                    process.chdir(originalCwd);
+                }
+                catch (error) {
+                    console.error('  Error regenerating structure:', error);
+                }
+            }
+            console.log('  Refreshing coverage...');
+            if (this.onRefresh) {
+                try {
+                    const report = await this.onRefresh();
+                    console.log(`  Coverage: ${report.summary.percentage}% (${report.summary.coveredFacets}/${report.summary.totalFacets})`);
+                    this.broadcast({
+                        type: 'coverage-update',
+                        data: {
+                            timestamp: new Date().toISOString(),
+                            summary: report.summary,
+                        },
+                    });
+                }
+                catch (error) {
+                    console.error('  Error refreshing coverage:', error);
+                    this.broadcast({
+                        type: 'error',
+                        data: { message: String(error), timestamp: new Date().toISOString() },
+                    });
+                }
+            }
+        }, 300);
+    }
+    /**
+     * Handle client source file change with debouncing
+     */
+    handleClientFileChange(event, path) {
+        // Clear existing timer
+        if (this.clientDebounceTimer) {
+            clearTimeout(this.clientDebounceTimer);
+        }
+        // Debounce to avoid multiple rapid rebuilds
+        this.clientDebounceTimer = setTimeout(() => {
+            console.log(`\n  Client change detected: ${path} (${event})`);
+            console.log('  Rebuilding client bundle...');
+            // Clear the bundle cache and notify clients to reload
+            if (this.onClientChange) {
+                this.onClientChange();
+            }
+            this.broadcast({
+                type: 'client-reload',
+                data: { timestamp: new Date().toISOString() },
+            });
+        }, 200);
+    }
+    /**
+     * Broadcast a message to all connected clients
+     */
+    broadcast(message) {
+        const json = JSON.stringify(message);
+        for (const client of this.clients) {
+            try {
+                client.send(json);
+            }
+            catch {
+                // Client may have disconnected
+                this.clients.delete(client);
+            }
+        }
+    }
+}
+exports.HotReloadManager = HotReloadManager;
+//# sourceMappingURL=HotReloadManager.js.map

package/dist/server/HotReloadManager.js.map

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

package/dist/server/index.d.ts

@@ -0,0 +1,3 @@
+export { DevServer } from './DevServer.js';
+export type { DevServerOptions } from './DevServer.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/server/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DevServer = void 0;
+var DevServer_js_1 = require("./DevServer.js");
+Object.defineProperty(exports, "DevServer", { enumerable: true, get: function () { return DevServer_js_1.DevServer; } });
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":";;;AAAA,+CAA2C;AAAlC,yGAAA,SAAS,OAAA"}

package/dist/server/routes.d.ts

@@ -0,0 +1,12 @@
+import type { DevServer } from './DevServer.js';
+/**
+ * Clear the client bundle cache (for hot reload)
+ */
+export declare function clearClientBundleCache(): void;
+/**
+ * Simple router for handling HTTP requests
+ */
+export declare function createRouter(server: DevServer, packageRoot: string): {
+    handle(req: Request): Promise<Response>;
+};
+//# sourceMappingURL=routes.d.ts.map

package/dist/server/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/server/routes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAahD;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAuFD;;GAEG;AAEH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM;gBAqK7C,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;EA2BhD"}