specweave 0.34.5 → 0.34.6

package/dist/src/core/living-docs/operations/ops-generator.js

@@ -0,0 +1,462 @@
+/**
+ * Operations Documentation Generator
+ *
+ * Generates operational documentation:
+ * - Runbooks from hook scripts and patterns
+ * - Monitoring guidance
+ * - Incident templates
+ * - SLA tracking
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { glob } from 'glob';
+import { consoleLogger } from '../../../utils/logger.js';
+/**
+ * Generates operations documentation
+ */
+export class OpsGenerator {
+    constructor(options) {
+        this.projectPath = options.projectPath;
+        this.logger = options.logger ?? consoleLogger;
+        this.opsPath = path.join(this.projectPath, '.specweave/docs/internal/operations');
+    }
+    /**
+     * Generate all operations documentation
+     */
+    async generate() {
+        const filesCreated = [];
+        // Ensure operations directory exists
+        fs.mkdirSync(this.opsPath, { recursive: true });
+        // 1. Generate Runbooks
+        this.logger.info('  Generating runbooks...');
+        const runbookResult = await this.generateRunbooks();
+        if (runbookResult.file) {
+            filesCreated.push(runbookResult.file);
+        }
+        // 2. Generate Monitoring documentation
+        this.logger.info('  Generating monitoring docs...');
+        const monitoringResult = await this.generateMonitoringDocs();
+        if (monitoringResult.file) {
+            filesCreated.push(monitoringResult.file);
+        }
+        // 3. Generate Incident templates
+        this.logger.info('  Generating incident templates...');
+        const incidentResult = await this.generateIncidentDocs();
+        if (incidentResult.file) {
+            filesCreated.push(incidentResult.file);
+        }
+        // 4. Generate SLA documentation
+        this.logger.info('  Generating SLA docs...');
+        const slaResult = await this.generateSLADocs();
+        if (slaResult.file) {
+            filesCreated.push(slaResult.file);
+        }
+        return {
+            filesCreated,
+            savedFiles: filesCreated, // Alias for consistency
+            runbooksFound: runbookResult.count,
+            monitoringConfigsFound: monitoringResult.count,
+        };
+    }
+    /**
+     * Generate runbooks from hooks and scripts
+     */
+    async generateRunbooks() {
+        const runbooks = [];
+        // Find hook scripts
+        const hookPaths = [
+            path.join(this.projectPath, 'plugins/specweave/hooks'),
+            path.join(this.projectPath, '.specweave/hooks'),
+        ];
+        for (const hookPath of hookPaths) {
+            if (!fs.existsSync(hookPath))
+                continue;
+            const scripts = await glob('**/*.sh', { cwd: hookPath, nodir: true });
+            for (const script of scripts) {
+                const info = this.parseHookScript(path.join(hookPath, script));
+                if (info) {
+                    runbooks.push({
+                        name: info.name,
+                        description: info.description,
+                        type: 'hook',
+                        source: script,
+                        steps: info.steps,
+                    });
+                }
+            }
+        }
+        // Find shell scripts in scripts/ folder
+        const scriptsPath = path.join(this.projectPath, 'scripts');
+        if (fs.existsSync(scriptsPath)) {
+            const scripts = await glob('**/*.sh', { cwd: scriptsPath, nodir: true });
+            for (const script of scripts) {
+                const info = this.parseHookScript(path.join(scriptsPath, script));
+                if (info) {
+                    runbooks.push({
+                        name: info.name,
+                        description: info.description,
+                        type: 'script',
+                        source: `scripts/${script}`,
+                        steps: info.steps,
+                    });
+                }
+            }
+        }
+        // Add standard runbooks based on detected patterns
+        const standardRunbooks = this.generateStandardRunbooks();
+        runbooks.push(...standardRunbooks);
+        // Generate documentation
+        const lines = [
+            '# Operational Runbooks',
+            '',
+            `*Generated: ${new Date().toLocaleDateString()} | Runbooks: ${runbooks.length}*`,
+            '',
+            '## Quick Reference',
+            '',
+            '| Runbook | Type | Description |',
+            '|---------|------|-------------|',
+        ];
+        for (const rb of runbooks) {
+            lines.push(`| [${rb.name}](#${rb.name.toLowerCase().replace(/\s+/g, '-')}) | ${rb.type} | ${rb.description.substring(0, 50)}... |`);
+        }
+        lines.push('', '## Runbook Details', '');
+        for (const rb of runbooks) {
+            lines.push(`### ${rb.name}`, '');
+            lines.push(`**Type**: ${rb.type}`);
+            if (rb.source) {
+                lines.push(`**Source**: \`${rb.source}\``);
+            }
+            lines.push('');
+            lines.push(rb.description, '');
+            if (rb.steps.length > 0) {
+                lines.push('**Steps**:', '');
+                for (let i = 0; i < rb.steps.length; i++) {
+                    lines.push(`${i + 1}. ${rb.steps[i]}`);
+                }
+                lines.push('');
+            }
+        }
+        lines.push('---', `*Last updated: ${new Date().toISOString()}*`);
+        const filePath = path.join(this.opsPath, 'RUNBOOKS.md');
+        fs.writeFileSync(filePath, lines.join('\n'));
+        return { file: filePath, count: runbooks.length };
+    }
+    /**
+     * Generate monitoring documentation
+     */
+    async generateMonitoringDocs() {
+        const monitoringConfigs = [];
+        // Check for common monitoring configurations
+        const prometheusPath = path.join(this.projectPath, 'prometheus.yml');
+        if (fs.existsSync(prometheusPath)) {
+            monitoringConfigs.push({
+                name: 'Prometheus',
+                type: 'metrics',
+                configFile: 'prometheus.yml',
+            });
+        }
+        const grafanaPath = path.join(this.projectPath, 'grafana');
+        if (fs.existsSync(grafanaPath)) {
+            monitoringConfigs.push({
+                name: 'Grafana',
+                type: 'dashboards',
+                configFile: 'grafana/',
+            });
+        }
+        // Check package.json for monitoring dependencies
+        const pkgPath = path.join(this.projectPath, 'package.json');
+        if (fs.existsSync(pkgPath)) {
+            try {
+                const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+                const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+                if (deps['prom-client']) {
+                    monitoringConfigs.push({ name: 'Prometheus Client', type: 'metrics' });
+                }
+                if (deps['dd-trace']) {
+                    monitoringConfigs.push({ name: 'Datadog APM', type: 'tracing' });
+                }
+                if (deps['@opentelemetry/api']) {
+                    monitoringConfigs.push({ name: 'OpenTelemetry', type: 'tracing' });
+                }
+                if (deps['newrelic']) {
+                    monitoringConfigs.push({ name: 'New Relic', type: 'apm' });
+                }
+            }
+            catch { /* ignore */ }
+        }
+        // Generate documentation
+        const lines = [
+            '# Monitoring Documentation',
+            '',
+            `*Generated: ${new Date().toLocaleDateString()}*`,
+            '',
+            '## Monitoring Stack',
+            '',
+            '| Tool | Type | Config |',
+            '|------|------|--------|',
+        ];
+        for (const config of monitoringConfigs) {
+            lines.push(`| ${config.name} | ${config.type} | ${config.configFile || '-'} |`);
+        }
+        lines.push('', '## Key Metrics to Monitor', '');
+        lines.push('### Application Metrics', '');
+        lines.push('- Request latency (p50, p95, p99)');
+        lines.push('- Error rate');
+        lines.push('- Request throughput');
+        lines.push('- Active connections');
+        lines.push('');
+        lines.push('### Infrastructure Metrics', '');
+        lines.push('- CPU utilization');
+        lines.push('- Memory usage');
+        lines.push('- Disk I/O');
+        lines.push('- Network throughput');
+        lines.push('');
+        lines.push('### Business Metrics', '');
+        lines.push('- Feature usage rates');
+        lines.push('- User sessions');
+        lines.push('- Transaction volume');
+        lines.push('');
+        lines.push('## Alerting Guidelines', '');
+        lines.push('| Severity | Response Time | Examples |');
+        lines.push('|----------|---------------|----------|');
+        lines.push('| P1 - Critical | 15 min | Service down, data loss |');
+        lines.push('| P2 - High | 1 hour | Degraded performance, partial outage |');
+        lines.push('| P3 - Medium | 4 hours | Non-critical errors, capacity warnings |');
+        lines.push('| P4 - Low | 24 hours | Minor issues, optimization opportunities |');
+        lines.push('');
+        lines.push('---', `*Last updated: ${new Date().toISOString()}*`);
+        const filePath = path.join(this.opsPath, 'MONITORING.md');
+        fs.writeFileSync(filePath, lines.join('\n'));
+        return { file: filePath, count: monitoringConfigs.length };
+    }
+    /**
+     * Generate incident documentation templates
+     */
+    async generateIncidentDocs() {
+        const lines = [
+            '# Incident Management',
+            '',
+            `*Generated: ${new Date().toLocaleDateString()}*`,
+            '',
+            '## Incident Response Process',
+            '',
+            '```mermaid',
+            'graph LR',
+            '    A[Detect] --> B[Assess]',
+            '    B --> C[Triage]',
+            '    C --> D[Investigate]',
+            '    D --> E[Mitigate]',
+            '    E --> F[Resolve]',
+            '    F --> G[Post-mortem]',
+            '```',
+            '',
+            '## Incident Severity Levels',
+            '',
+            '| Level | Description | Response | Examples |',
+            '|-------|-------------|----------|----------|',
+            '| SEV1 | Critical - Complete outage | Immediate, all hands | Service unreachable |',
+            '| SEV2 | Major - Partial outage | < 30 min, on-call | Degraded performance |',
+            '| SEV3 | Minor - Limited impact | < 4 hours | Feature unavailable |',
+            '| SEV4 | Low - Minimal impact | Next business day | Minor bug |',
+            '',
+            '## Incident Template',
+            '',
+            '### Incident Report: [TITLE]',
+            '',
+            '**Date**: YYYY-MM-DD',
+            '**Severity**: SEV[1-4]',
+            '**Duration**: X hours',
+            '**Impact**: [Description of impact]',
+            '',
+            '#### Timeline',
+            '',
+            '| Time | Event |',
+            '|------|-------|',
+            '| HH:MM | Issue detected |',
+            '| HH:MM | Investigation started |',
+            '| HH:MM | Root cause identified |',
+            '| HH:MM | Mitigation applied |',
+            '| HH:MM | Resolved |',
+            '',
+            '#### Root Cause',
+            '',
+            '[Description of root cause]',
+            '',
+            '#### Resolution',
+            '',
+            '[Description of how it was resolved]',
+            '',
+            '#### Action Items',
+            '',
+            '- [ ] Prevent recurrence',
+            '- [ ] Improve detection',
+            '- [ ] Update documentation',
+            '',
+            '## Post-Mortem Process',
+            '',
+            '1. Schedule post-mortem within 48 hours',
+            '2. Gather all participants',
+            '3. Review timeline and facts',
+            '4. Identify root causes (5 Whys)',
+            '5. Define action items',
+            '6. Document and share learnings',
+            '',
+            '---',
+            `*Last updated: ${new Date().toISOString()}*`,
+        ];
+        const filePath = path.join(this.opsPath, 'INCIDENT-HISTORY.md');
+        fs.writeFileSync(filePath, lines.join('\n'));
+        return { file: filePath };
+    }
+    /**
+     * Generate SLA documentation
+     */
+    async generateSLADocs() {
+        const lines = [
+            '# Service Level Agreements (SLA)',
+            '',
+            `*Generated: ${new Date().toLocaleDateString()}*`,
+            '',
+            '## SLA Overview',
+            '',
+            '| Service | Target | Current | Status |',
+            '|---------|--------|---------|--------|',
+            '| Availability | 99.9% | TBD | 🟡 |',
+            '| Response Time (p95) | < 200ms | TBD | 🟡 |',
+            '| Error Rate | < 0.1% | TBD | 🟡 |',
+            '',
+            '## Definitions',
+            '',
+            '### Availability',
+            '',
+            'Percentage of time the service is operational and accessible.',
+            '',
+            '| Target | Monthly Downtime |',
+            '|--------|-----------------|',
+            '| 99.9% | 43.8 minutes |',
+            '| 99.95% | 21.9 minutes |',
+            '| 99.99% | 4.38 minutes |',
+            '',
+            '### Response Time',
+            '',
+            'Time from request receipt to response delivery.',
+            '',
+            '| Percentile | Target |',
+            '|------------|--------|',
+            '| p50 | < 50ms |',
+            '| p95 | < 200ms |',
+            '| p99 | < 500ms |',
+            '',
+            '### Error Rate',
+            '',
+            'Percentage of requests resulting in 5xx errors.',
+            '',
+            '## Error Budget',
+            '',
+            '```',
+            'Monthly Error Budget = (100% - SLA Target) * Total Minutes',
+            '',
+            'For 99.9% SLA:',
+            'Error Budget = 0.1% * 43,200 minutes = 43.2 minutes/month',
+            '```',
+            '',
+            '## Measurement',
+            '',
+            '- **Tool**: [Prometheus/Datadog/etc.]',
+            '- **Dashboard**: [Link to monitoring dashboard]',
+            '- **Reporting**: Monthly SLA report',
+            '',
+            '---',
+            `*Last updated: ${new Date().toISOString()}*`,
+        ];
+        const filePath = path.join(this.opsPath, 'SLA-TRACKING.md');
+        fs.writeFileSync(filePath, lines.join('\n'));
+        return { file: filePath };
+    }
+    // Helper methods
+    parseHookScript(filePath) {
+        try {
+            const content = fs.readFileSync(filePath, 'utf-8');
+            const name = path.basename(filePath, '.sh');
+            // Extract description from first comment block
+            const descMatch = content.match(/^#\s*(.+)/m);
+            const description = descMatch ? descMatch[1] : `Script: ${name}`;
+            // Extract major steps from comments
+            const steps = [];
+            const stepMatches = content.match(/^#\s*\d+[\.\)]\s*(.+)/gm);
+            if (stepMatches) {
+                for (const match of stepMatches) {
+                    steps.push(match.replace(/^#\s*\d+[\.\)]\s*/, ''));
+                }
+            }
+            return { name, description, steps };
+        }
+        catch {
+            return null;
+        }
+    }
+    generateStandardRunbooks() {
+        const runbooks = [];
+        // Check for npm project
+        if (fs.existsSync(path.join(this.projectPath, 'package.json'))) {
+            runbooks.push({
+                name: 'Application Restart',
+                description: 'Steps to safely restart the application',
+                type: 'standard',
+                steps: [
+                    'Check current service health',
+                    'Notify stakeholders',
+                    'Stop the service: `npm stop` or `systemctl stop app`',
+                    'Clear cache if needed: `npm cache clean --force`',
+                    'Start the service: `npm start` or `systemctl start app`',
+                    'Verify health: check logs and health endpoint',
+                    'Notify stakeholders of completion',
+                ],
+            });
+            runbooks.push({
+                name: 'Dependency Update',
+                description: 'Process for updating npm dependencies',
+                type: 'standard',
+                steps: [
+                    'Create a new branch: `git checkout -b deps-update`',
+                    'Check for updates: `npm outdated`',
+                    'Update dependencies: `npm update`',
+                    'Run tests: `npm test`',
+                    'Review changes: `git diff package-lock.json`',
+                    'Commit and create PR',
+                ],
+            });
+        }
+        // Check for Docker
+        if (fs.existsSync(path.join(this.projectPath, 'Dockerfile'))) {
+            runbooks.push({
+                name: 'Container Restart',
+                description: 'Steps to restart Docker containers',
+                type: 'standard',
+                steps: [
+                    'Check container status: `docker ps`',
+                    'Stop container: `docker-compose stop` or `docker stop <id>`',
+                    'Remove container (optional): `docker rm <id>`',
+                    'Rebuild if needed: `docker-compose build`',
+                    'Start container: `docker-compose up -d`',
+                    'Verify logs: `docker logs -f <id>`',
+                ],
+            });
+        }
+        // Add cleanup runbook
+        runbooks.push({
+            name: 'Cache Cleanup',
+            description: 'Clear various caches to resolve issues',
+            type: 'standard',
+            steps: [
+                'Clear npm cache: `npm cache clean --force`',
+                'Clear build artifacts: `rm -rf dist/ build/`',
+                'Clear node_modules if needed: `rm -rf node_modules && npm install`',
+                'Clear SpecWeave cache: `rm -rf .specweave/cache/`',
+                'Restart the application',
+            ],
+        });
+        return runbooks;
+    }
+}
+//# sourceMappingURL=ops-generator.js.map

package/dist/src/core/living-docs/operations/ops-generator.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "0.34.5",
+  "version": "0.34.6",
   "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",