specweave 0.12.1 → 0.12.3

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

@@ -1,207 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,31 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,202 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,60 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

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

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

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

package/dist/utils/plugin-detection.d.ts

@@ -1,50 +0,0 @@
-/**
- * Plugin Detection Utility
- *
- * Maps project tech stack signals to SpecWeave plugins.
- * Used by:
- * - specweave init (scan project structure)
- * - plugin-detector skill (runtime detection)
- */
-/**
- * Plugin detection result
- */
-export interface DetectedPlugin {
-    name: string;
-    reason: string;
-    confidence: 'high' | 'medium' | 'low';
-    signals: string[];
-}
-/**
- * Project tech stack signals
- */
-interface TechStackSignals {
-    hasPackageJson: boolean;
-    hasPyProject: boolean;
-    hasRequirementsTxt: boolean;
-    hasCsproj: boolean;
-    hasGemfile: boolean;
-    dependencies: string[];
-    devDependencies: string[];
-    files: string[];
-    folders: string[];
-    gitRemote: string | null;
-}
-/**
- * Scan project directory for tech stack signals
- */
-export declare function scanProjectStructure(projectDir: string): Promise<TechStackSignals>;
-/**
- * Detect required plugins based on tech stack signals
- */
-export declare function detectPlugins(signals: TechStackSignals): DetectedPlugin[];
-/**
- * Format detected plugins for CLI output
- */
-export declare function formatDetectedPlugins(plugins: DetectedPlugin[]): string;
-/**
- * Generate install commands for detected plugins
- */
-export declare function generateInstallCommands(plugins: DetectedPlugin[]): string[];
-export {};
-//# sourceMappingURL=plugin-detection.d.ts.map

package/dist/utils/plugin-detection.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin-detection.d.ts","sourceRoot":"","sources":["../../src/utils/plugin-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,UAAU,gBAAgB;IAExB,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IAGpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;IAG1B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAGlB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAkExF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,cAAc,EAAE,CAwLzE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,CAoCvE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,EAAE,CAQ3E"}