specweave 0.8.2 → 0.8.4

package/dist/utils/docs-preview.bak/server-manager.js

@@ -0,0 +1,207 @@
+/**
+ * Server manager for Docusaurus dev server
+ * Handles port finding, server start/stop, browser opening
+ */
+import { spawn } from 'child_process';
+import * as net from 'net';
+import { execFileNoThrow } from '../execFileNoThrow.js';
+/**
+ * Find an available port in the given range
+ */
+export async function findAvailablePort(startPort = 3000, endPort = 3010) {
+    for (let port = startPort; port <= endPort; port++) {
+        if (await isPortAvailable(port)) {
+            return port;
+        }
+    }
+    throw new Error(`No available ports found in range ${startPort}-${endPort}`);
+}
+/**
+ * Check if a port is available
+ */
+function isPortAvailable(port) {
+    return new Promise((resolve) => {
+        const server = net.createServer();
+        server.once('error', () => {
+            resolve(false);
+        });
+        server.once('listening', () => {
+            server.close();
+            resolve(true);
+        });
+        server.listen(port);
+    });
+}
+/**
+ * Start Docusaurus dev server
+ */
+export async function startDevServer(targetDir, options) {
+    const { port, openBrowser, host = 'localhost' } = options;
+    // Check if port is available
+    if (!await isPortAvailable(port)) {
+        throw new Error(`Port ${port} is already in use`);
+    }
+    // Start Docusaurus dev server
+    const process = spawn('npm', ['run', 'start', '--', '--port', port.toString(), '--host', host], {
+        cwd: targetDir,
+        stdio: ['ignore', 'pipe', 'pipe'],
+        shell: true
+    });
+    const url = `http://${host}:${port}`;
+    // Wait for server to be ready
+    await waitForServer(url, 30000); // 30 second timeout
+    // Open browser if requested
+    if (openBrowser) {
+        await openBrowserUrl(url);
+    }
+    return {
+        pid: process.pid,
+        port,
+        url,
+        stop: async () => {
+            await stopServer(process);
+        }
+    };
+}
+/**
+ * Wait for server to be ready
+ */
+function waitForServer(url, timeout) {
+    return new Promise((resolve, reject) => {
+        const startTime = Date.now();
+        const check = async () => {
+            try {
+                const http = await import('http');
+                const urlObj = new URL(url);
+                const req = http.get({
+                    hostname: urlObj.hostname,
+                    port: urlObj.port,
+                    path: urlObj.pathname,
+                    timeout: 2000
+                }, (res) => {
+                    if (res.statusCode === 200 || res.statusCode === 304) {
+                        resolve();
+                    }
+                    else {
+                        scheduleNextCheck();
+                    }
+                });
+                req.on('error', () => {
+                    scheduleNextCheck();
+                });
+                req.on('timeout', () => {
+                    req.destroy();
+                    scheduleNextCheck();
+                });
+            }
+            catch {
+                scheduleNextCheck();
+            }
+        };
+        const scheduleNextCheck = () => {
+            if (Date.now() - startTime > timeout) {
+                reject(new Error(`Server failed to start within ${timeout}ms`));
+            }
+            else {
+                setTimeout(check, 1000);
+            }
+        };
+        check();
+    });
+}
+/**
+ * Stop server process
+ */
+function stopServer(process) {
+    return new Promise((resolve) => {
+        if (!process.pid) {
+            resolve();
+            return;
+        }
+        process.once('exit', () => {
+            resolve();
+        });
+        // Try graceful shutdown first
+        process.kill('SIGTERM');
+        // Force kill after 5 seconds if still running
+        setTimeout(() => {
+            if (process.pid) {
+                process.kill('SIGKILL');
+            }
+        }, 5000);
+    });
+}
+/**
+ * Open URL in default browser
+ */
+export async function openBrowserUrl(url) {
+    const { default: open } = await import('open');
+    await open(url);
+}
+/**
+ * Kill all Docusaurus processes (SAFE - uses execFileNoThrow)
+ */
+export async function killAllDocusaurusProcesses() {
+    const platform = process.platform;
+    try {
+        if (platform === 'win32') {
+            // Windows: Use tasklist and taskkill
+            const listResult = await execFileNoThrow('tasklist', ['/FI', 'IMAGENAME eq node.exe', '/FO', 'CSV']);
+            if (listResult.status !== 0) {
+                return 0;
+            }
+            const processes = listResult.stdout
+                .split('\n')
+                .filter(line => line.includes('docusaurus'))
+                .map(line => {
+                const match = line.match(/"([^"]+)","\d+"/);
+                return match ? match[1] : null;
+            })
+                .filter(Boolean);
+            for (const pid of processes) {
+                await execFileNoThrow('taskkill', ['/F', '/PID', pid]);
+            }
+            return processes.length;
+        }
+        else {
+            // Unix-like (macOS, Linux): Use ps and kill
+            const psResult = await execFileNoThrow('ps', ['aux']);
+            if (psResult.status !== 0) {
+                return 0;
+            }
+            const processes = psResult.stdout
+                .split('\n')
+                .filter(line => line.includes('docusaurus') && !line.includes('grep'))
+                .map(line => {
+                const parts = line.trim().split(/\s+/);
+                return parts[1]; // PID is second column
+            });
+            for (const pid of processes) {
+                try {
+                    await execFileNoThrow('kill', [pid]);
+                }
+                catch {
+                    // Ignore errors (process may have already exited)
+                }
+            }
+            return processes.length;
+        }
+    }
+    catch (error) {
+        // No processes found or error occurred
+        return 0;
+    }
+}
+/**
+ * Check if Docusaurus server is running
+ */
+export async function isDocusaurusRunning(port) {
+    return !(await isPortAvailable(port));
+}
+/**
+ * Get server URL
+ */
+export function getServerUrl(port, host = 'localhost') {
+    return `http://${host}:${port}`;
+}
+//# sourceMappingURL=server-manager.js.map

package/dist/utils/docs-preview.bak/server-manager.js.map

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

package/dist/utils/docs-preview.bak/sidebar-builder.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Sidebar builder for Docusaurus
+ * Automatically generates sidebar.js from .specweave/docs/ folder structure
+ */
+import { Sidebar } from './types.js';
+export interface SidebarBuilderOptions {
+    docsPath: string;
+    excludeFolders?: string[];
+    maxDepth?: number;
+}
+/**
+ * Build sidebar from folder structure
+ */
+export declare function buildSidebar(options: SidebarBuilderOptions): Promise<Sidebar>;
+/**
+ * Generate sidebars.js content as string
+ */
+export declare function generateSidebarsJS(sidebar: Sidebar): string;
+/**
+ * Write sidebar to file
+ */
+export declare function writeSidebar(filePath: string, sidebar: Sidebar): Promise<void>;
+/**
+ * Count total documents in sidebar
+ */
+export declare function countDocuments(sidebar: Sidebar): number;
+/**
+ * Count total categories in sidebar
+ */
+export declare function countCategories(sidebar: Sidebar): number;
+//# sourceMappingURL=sidebar-builder.d.ts.map

package/dist/utils/docs-preview.bak/sidebar-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar-builder.d.ts","sourceRoot":"","sources":["../../../src/utils/docs-preview.bak/sidebar-builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,OAAO,EAAe,MAAM,YAAY,CAAC;AA0BlD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,CAqBnF;AAwHD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAW3D;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAIpF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAevD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAgBxD"}

package/dist/utils/docs-preview.bak/sidebar-builder.js

@@ -0,0 +1,202 @@
+/**
+ * Sidebar builder for Docusaurus
+ * Automatically generates sidebar.js from .specweave/docs/ folder structure
+ */
+import * as path from 'path';
+import * as fs from 'fs-extra';
+/**
+ * Priority order for top-level folders
+ * Lower number = appears first in sidebar
+ */
+const FOLDER_PRIORITY = {
+    strategy: 1,
+    specs: 2,
+    architecture: 3,
+    delivery: 4,
+    operations: 5,
+    governance: 6,
+    projects: 7 // Multi-project support
+};
+/**
+ * Default folders to exclude from sidebar
+ */
+const DEFAULT_EXCLUDE_FOLDERS = [
+    'node_modules',
+    '.git',
+    '.DS_Store',
+    'legacy' // Brownfield imports (temporary, not for display)
+];
+/**
+ * Build sidebar from folder structure
+ */
+export async function buildSidebar(options) {
+    const { docsPath, excludeFolders = DEFAULT_EXCLUDE_FOLDERS, maxDepth = 5 } = options;
+    // Check if docs path exists
+    if (!await fs.pathExists(docsPath)) {
+        throw new Error(`Documentation path does not exist: ${docsPath}`);
+    }
+    // Scan folders and build sidebar items
+    const items = await scanFolder(docsPath, docsPath, excludeFolders, 0, maxDepth);
+    // Sort by priority (strategy first, governance last)
+    const sortedItems = sortByPriority(items);
+    return {
+        docs: sortedItems
+    };
+}
+/**
+ * Scan folder recursively and build sidebar items
+ */
+async function scanFolder(basePath, currentPath, excludeFolders, depth, maxDepth) {
+    if (depth >= maxDepth) {
+        return [];
+    }
+    const items = [];
+    try {
+        const entries = await fs.readdir(currentPath, { withFileTypes: true });
+        // Separate folders and files
+        const folders = entries.filter(e => e.isDirectory() && !excludeFolders.includes(e.name));
+        const files = entries.filter(e => e.isFile() && e.name.endsWith('.md'));
+        // Process folders first (categories)
+        for (const folder of folders) {
+            const folderPath = path.join(currentPath, folder.name);
+            const childItems = await scanFolder(basePath, folderPath, excludeFolders, depth + 1, maxDepth);
+            if (childItems.length > 0) {
+                items.push({
+                    type: 'category',
+                    label: formatLabel(folder.name),
+                    items: childItems
+                });
+            }
+        }
+        // Process markdown files (docs)
+        for (const file of files) {
+            const relativePath = path.relative(basePath, path.join(currentPath, file.name));
+            const docId = relativePath.replace(/\.md$/, '').replace(/\\/g, '/');
+            items.push({
+                type: 'doc',
+                id: docId
+            });
+        }
+        return items;
+    }
+    catch (error) {
+        console.error(`Error scanning folder ${currentPath}:`, error);
+        return [];
+    }
+}
+/**
+ * Sort sidebar items by priority
+ */
+function sortByPriority(items) {
+    return items.sort((a, b) => {
+        // Extract folder name from label
+        const aFolder = a.label?.toLowerCase().replace(/\s+/g, '-') || '';
+        const bFolder = b.label?.toLowerCase().replace(/\s+/g, '-') || '';
+        // Get priorities (default to 999 if not found)
+        const aPriority = FOLDER_PRIORITY[aFolder] || 999;
+        const bPriority = FOLDER_PRIORITY[bFolder] || 999;
+        // Sort by priority
+        if (aPriority !== bPriority) {
+            return aPriority - bPriority;
+        }
+        // If same priority, sort alphabetically
+        return aFolder.localeCompare(bFolder);
+    });
+}
+/**
+ * Format folder name to human-readable label
+ * Examples:
+ * - "strategy" → "Strategy"
+ * - "architecture" → "Architecture"
+ * - "adr" → "ADRs"
+ * - "my-feature-spec" → "My Feature Spec"
+ */
+function formatLabel(folderName) {
+    // Special cases
+    const specialCases = {
+        adr: 'ADRs',
+        adrs: 'ADRs',
+        hld: 'HLD',
+        lld: 'LLD',
+        prd: 'PRDs',
+        okr: 'OKRs',
+        api: 'API',
+        cli: 'CLI',
+        ui: 'UI',
+        ux: 'UX',
+        sre: 'SRE',
+        devops: 'DevOps',
+        mlops: 'MLOps',
+        k8s: 'Kubernetes'
+    };
+    const normalized = folderName.toLowerCase();
+    if (specialCases[normalized]) {
+        return specialCases[normalized];
+    }
+    // Convert kebab-case or snake_case to Title Case
+    return folderName
+        .replace(/[-_]/g, ' ')
+        .split(' ')
+        .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join(' ');
+}
+/**
+ * Generate sidebars.js content as string
+ */
+export function generateSidebarsJS(sidebar) {
+    return `/**
+ * Auto-generated sidebar for SpecWeave documentation
+ * Generated: ${new Date().toISOString()}
+ *
+ * DO NOT EDIT THIS FILE MANUALLY
+ * Regenerate with: /specweave:docs preview
+ */
+
+module.exports = ${JSON.stringify(sidebar, null, 2)};
+`;
+}
+/**
+ * Write sidebar to file
+ */
+export async function writeSidebar(filePath, sidebar) {
+    const content = generateSidebarsJS(sidebar);
+    await fs.ensureDir(path.dirname(filePath));
+    await fs.writeFile(filePath, content, 'utf-8');
+}
+/**
+ * Count total documents in sidebar
+ */
+export function countDocuments(sidebar) {
+    let count = 0;
+    function traverse(items) {
+        for (const item of items) {
+            if (item.type === 'doc') {
+                count++;
+            }
+            else if (item.type === 'category' && item.items) {
+                traverse(item.items);
+            }
+        }
+    }
+    traverse(sidebar.docs);
+    return count;
+}
+/**
+ * Count total categories in sidebar
+ */
+export function countCategories(sidebar) {
+    let count = 0;
+    function traverse(items) {
+        for (const item of items) {
+            if (item.type === 'category') {
+                count++;
+                if (item.items) {
+                    traverse(item.items);
+                }
+            }
+        }
+    }
+    traverse(sidebar.docs);
+    return count;
+}
+//# sourceMappingURL=sidebar-builder.js.map

package/dist/utils/docs-preview.bak/sidebar-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar-builder.js","sourceRoot":"","sources":["../../../src/utils/docs-preview.bak/sidebar-builder.ts"],"names":[],"mappings":"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"}

package/dist/utils/docs-preview.bak/types.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Type definitions for documentation preview functionality
+ */
+export interface DocusaurusConfig {
+    title: string;
+    tagline: string;
+    url: string;
+    baseUrl: string;
+    docsPath: string;
+    port?: number;
+    theme?: 'default' | 'classic' | 'dark';
+    excludeFolders?: string[];
+}
+export interface SidebarItem {
+    type: 'doc' | 'category';
+    label?: string;
+    id?: string;
+    items?: SidebarItem[];
+}
+export interface Sidebar {
+    docs: SidebarItem[];
+}
+export interface SetupOptions {
+    projectRoot: string;
+    targetDir: string;
+    docsPath: string;
+    config: DocusaurusConfig;
+    force?: boolean;
+}
+export interface ServerOptions {
+    port: number;
+    openBrowser: boolean;
+    host?: string;
+}
+export interface InstallOptions {
+    targetDir: string;
+    packages: string[];
+    dev?: boolean;
+}
+export interface NodeVersion {
+    version: string;
+    major: number;
+    minor: number;
+    patch: number;
+    compatible: boolean;
+}
+export interface BuildResult {
+    success: boolean;
+    outputPath: string;
+    size: number;
+    duration: number;
+    errors?: string[];
+}
+export interface ServerProcess {
+    pid: number;
+    port: number;
+    url: string;
+    stop: () => Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/utils/docs-preview.bak/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/docs-preview.bak/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,KAAK,GAAG,UAAU,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,WAAW,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B"}

package/dist/utils/docs-preview.bak/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for documentation preview functionality
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/utils/docs-preview.bak/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/utils/docs-preview.bak/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "0.8.2",
+  "version": "0.8.4",
   "description": "Spec-driven development framework for Claude Code. AI-native workflow with living documentation, intelligent agents, and multilingual support (9 languages). Enterprise-grade traceability with permanent specs and temporary increments.",
   "type": "module",
   "main": "dist/index.js",
@@ -17,6 +17,7 @@
     "test:e2e": "playwright test tests/e2e/ --grep-invert=\"(should create translator|should default to claude adapter|should create .claude|should initialize project with specweave init|should create correct directory structure|should handle non-interactive mode correctly|should validate config.json structure|should create .specweave directory structure|should create CLAUDE.md and AGENTS.md|should use claude adapter when explicitly requested|should create translate command|should initialize git repository|should use generic adapter|should install SpecWeave|should scaffold SaaS|should create proper directory|should create required configuration|should install core skills|should install core agents|should have deployment|should have Stripe|ADO Sync)\"",
     "test:integration": "echo 'Integration tests are temporarily disabled (excluded in jest.config.cjs line 31)' && exit 0",
     "test": "npm run test:smoke && npm run test:e2e",
+    "metrics:dora": "node dist/metrics/dora-calculator.js",
     "generate:diagrams": "bash scripts/generate-diagram-svgs.sh",
     "docs:dev": "cd docs-site && npm start",
     "docs:build": "cd docs-site && npm run build",