specweave 0.22.0 → 0.22.2

package/dist/src/core/workflow/backlog-scanner.js

@@ -0,0 +1,170 @@
+/**
+ * Backlog Scanner - Intelligent backlog scanning and ranking
+ *
+ * Scans .specweave/increments/_backlog/ directory and ranks items
+ * by priority, dependencies, and project match.
+ *
+ * Part of increment 0039: Ultra-Smart Next Command
+ *
+ * @module core/workflow/backlog-scanner
+ * @since v0.22.0
+ */
+import * as fs from 'fs-extra';
+import * as path from 'path';
+import * as yaml from 'js-yaml';
+/**
+ * Backlog Scanner - Scan and rank backlog items
+ */
+export class BacklogScanner {
+    constructor(rootDir = process.cwd()) {
+        this.backlogDir = path.join(rootDir, '.specweave/increments/_backlog');
+    }
+    /**
+     * Scan backlog directory
+     *
+     * @returns Array of backlog items
+     */
+    async scanBacklog() {
+        // Check if backlog directory exists
+        if (!await fs.pathExists(this.backlogDir)) {
+            return [];
+        }
+        const items = [];
+        const dirs = await fs.readdir(this.backlogDir);
+        for (const dir of dirs) {
+            const dirPath = path.join(this.backlogDir, dir);
+            const stat = await fs.stat(dirPath);
+            if (!stat.isDirectory()) {
+                continue;
+            }
+            // Check if spec.md exists
+            const specPath = path.join(dirPath, 'spec.md');
+            if (!await fs.pathExists(specPath)) {
+                continue;
+            }
+            // Parse spec.md frontmatter
+            try {
+                const item = await this.parseBacklogItem(dir, specPath);
+                items.push(item);
+            }
+            catch (error) {
+                console.warn(`Failed to parse backlog item ${dir}:`, error);
+            }
+        }
+        return items;
+    }
+    /**
+     * Parse backlog item from spec.md
+     */
+    async parseBacklogItem(incrementId, specPath) {
+        const content = await fs.readFile(specPath, 'utf-8');
+        // Extract YAML frontmatter
+        const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+        if (!frontmatterMatch) {
+            throw new Error('No YAML frontmatter found in spec.md');
+        }
+        const frontmatter = yaml.load(frontmatterMatch[1]);
+        // Extract title from first heading
+        const titleMatch = content.match(/^#\s+(.+)$/m);
+        const title = titleMatch ? titleMatch[1] : frontmatter.title || incrementId;
+        return {
+            incrementId,
+            specPath,
+            title,
+            priority: frontmatter.priority || 'P2',
+            project: frontmatter.project,
+            dependencies: frontmatter.dependencies || [],
+            estimatedEffort: frontmatter.estimated_effort || frontmatter.estimatedEffort,
+            created: frontmatter.created
+        };
+    }
+    /**
+     * Rank backlog items by priority, dependencies, and project match
+     *
+     * Ranking algorithm:
+     * - Priority: P0=10, P1=7, P2=5, P3=3
+     * - Dependencies met: +5
+     * - Project match: +3
+     * - Recently created: +2
+     *
+     * @param items - Backlog items to rank
+     * @param currentProject - Current project (for filtering)
+     * @param completedIncrements - List of completed increment IDs
+     * @returns Ranked items (sorted by score descending)
+     */
+    rankItems(items, currentProject, completedIncrements = []) {
+        const ranked = items.map(item => {
+            let score = 0;
+            const reasons = [];
+            // Priority score
+            const priorityScores = {
+                'P0': 10,
+                'P1': 7,
+                'P2': 5,
+                'P3': 3
+            };
+            const priorityScore = priorityScores[item.priority] || 3;
+            score += priorityScore;
+            reasons.push(`Priority ${item.priority} (${priorityScore} pts)`);
+            // Dependencies met
+            const unmetDeps = item.dependencies.filter(dep => !completedIncrements.includes(dep));
+            if (unmetDeps.length === 0 && item.dependencies.length > 0) {
+                score += 5;
+                reasons.push('All dependencies met (+5 pts)');
+            }
+            else if (unmetDeps.length > 0) {
+                reasons.push(`Blocked by: ${unmetDeps.join(', ')}`);
+            }
+            // Project match
+            if (currentProject && item.project === currentProject) {
+                score += 3;
+                reasons.push(`Project match: ${currentProject} (+3 pts)`);
+            }
+            // Recently created (bonus for new items)
+            if (item.created) {
+                const createdDate = new Date(item.created);
+                const daysSinceCreated = (Date.now() - createdDate.getTime()) / (1000 * 60 * 60 * 24);
+                if (daysSinceCreated < 7) {
+                    score += 2;
+                    reasons.push('Recently created (+2 pts)');
+                }
+            }
+            return {
+                ...item,
+                score,
+                reason: reasons.join('; ')
+            };
+        });
+        // Sort by score (descending)
+        return ranked.sort((a, b) => b.score - a.score);
+    }
+    /**
+     * Get top N recommendations
+     *
+     * @param n - Number of recommendations (default: 3)
+     * @param currentProject - Current project filter
+     * @param completedIncrements - Completed increments
+     * @returns Backlog recommendations
+     */
+    async getTopRecommendations(n = 3, currentProject, completedIncrements = []) {
+        const items = await this.scanBacklog();
+        const ranked = this.rankItems(items, currentProject, completedIncrements);
+        const topItems = ranked.slice(0, n);
+        let summary = '';
+        if (items.length === 0) {
+            summary = 'No items in backlog. Use /specweave:increment to create new work.';
+        }
+        else if (topItems.length === 0) {
+            summary = 'No actionable items found (all blocked by dependencies).';
+        }
+        else {
+            summary = `Found ${items.length} items in backlog. Top ${topItems.length} recommendations based on priority and dependencies.`;
+        }
+        return {
+            items: topItems,
+            totalItems: items.length,
+            summary
+        };
+    }
+}
+//# sourceMappingURL=backlog-scanner.js.map

package/dist/src/core/workflow/backlog-scanner.js.map

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

package/dist/src/core/workflow/command-invoker.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Command Invoker - Programmatic command execution
+ *
+ * Provides utilities to invoke SpecWeave commands programmatically
+ * from within the workflow orchestration system.
+ *
+ * Part of increment 0039: Ultra-Smart Next Command
+ *
+ * @module core/workflow/command-invoker
+ * @since v0.22.0
+ */
+/**
+ * Command invocation options
+ */
+export interface InvokeOptions {
+    /** Command arguments */
+    args?: string[];
+    /** Working directory */
+    cwd?: string;
+    /** Timeout in milliseconds */
+    timeout?: number;
+    /** Capture stdout */
+    captureOutput?: boolean;
+}
+/**
+ * Command invocation result
+ */
+export interface InvokeResult {
+    /** Command succeeded */
+    success: boolean;
+    /** Exit code */
+    exitCode: number;
+    /** Standard output */
+    stdout?: string;
+    /** Standard error */
+    stderr?: string;
+    /** Error message */
+    error?: string;
+    /** Execution time in milliseconds */
+    executionTime: number;
+}
+/**
+ * Error severity level
+ */
+export declare enum ErrorSeverity {
+    INFO = "info",
+    WARNING = "warning",
+    ERROR = "error",
+    CRITICAL = "critical"
+}
+/**
+ * Command Invoker - Execute SpecWeave commands programmatically
+ */
+export declare class CommandInvoker {
+    /**
+     * Invoke a SpecWeave command
+     *
+     * @param command - Command name (e.g., 'plan', 'do', 'validate')
+     * @param options - Invocation options
+     * @returns Command execution result
+     */
+    invoke(command: string, options?: InvokeOptions): Promise<InvokeResult>;
+    /**
+     * Invoke command with automatic retry on transient failures
+     *
+     * @param command - Command name
+     * @param options - Invocation options
+     * @param maxRetries - Maximum retry attempts (default: 3)
+     * @returns Command execution result
+     */
+    invokeWithRetry(command: string, options?: InvokeOptions, maxRetries?: number): Promise<InvokeResult>;
+    /**
+     * Classify error severity
+     *
+     * @param result - Command result
+     * @returns Error severity level
+     */
+    classifyError(result: InvokeResult): ErrorSeverity;
+    /**
+     * Delay execution
+     *
+     * @param ms - Milliseconds to delay
+     */
+    private delay;
+}
+//# sourceMappingURL=command-invoker.d.ts.map

package/dist/src/core/workflow/command-invoker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-invoker.d.ts","sourceRoot":"","sources":["../../../../src/core/workflow/command-invoker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,oBAAY,aAAa;IACvB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,QAAQ,aAAa;CACtB;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB;;;;;;OAMG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IAsCjF;;;;;;;OAOG;IACG,eAAe,CACnB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,aAAkB,EAC3B,UAAU,GAAE,MAAU,GACrB,OAAO,CAAC,YAAY,CAAC;IA+BxB;;;;;OAKG;IACH,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa;IAqBlD;;;;OAIG;IACH,OAAO,CAAC,KAAK;CAGd"}

package/dist/src/core/workflow/command-invoker.js

@@ -0,0 +1,131 @@
+/**
+ * Command Invoker - Programmatic command execution
+ *
+ * Provides utilities to invoke SpecWeave commands programmatically
+ * from within the workflow orchestration system.
+ *
+ * Part of increment 0039: Ultra-Smart Next Command
+ *
+ * @module core/workflow/command-invoker
+ * @since v0.22.0
+ */
+import { exec } from 'child_process';
+import { promisify } from 'util';
+const execAsync = promisify(exec);
+/**
+ * Error severity level
+ */
+export var ErrorSeverity;
+(function (ErrorSeverity) {
+    ErrorSeverity["INFO"] = "info";
+    ErrorSeverity["WARNING"] = "warning";
+    ErrorSeverity["ERROR"] = "error";
+    ErrorSeverity["CRITICAL"] = "critical";
+})(ErrorSeverity || (ErrorSeverity = {}));
+/**
+ * Command Invoker - Execute SpecWeave commands programmatically
+ */
+export class CommandInvoker {
+    /**
+     * Invoke a SpecWeave command
+     *
+     * @param command - Command name (e.g., 'plan', 'do', 'validate')
+     * @param options - Invocation options
+     * @returns Command execution result
+     */
+    async invoke(command, options = {}) {
+        const startTime = Date.now();
+        try {
+            // Build command string
+            const args = options.args || [];
+            const commandString = `npx specweave ${command} ${args.join(' ')}`;
+            // Execute command
+            const { stdout, stderr } = await execAsync(commandString, {
+                cwd: options.cwd || process.cwd(),
+                timeout: options.timeout || 300000, // 5 min default
+                maxBuffer: 10 * 1024 * 1024 // 10MB
+            });
+            const executionTime = Date.now() - startTime;
+            return {
+                success: true,
+                exitCode: 0,
+                stdout: options.captureOutput ? stdout : undefined,
+                stderr: stderr || undefined,
+                executionTime
+            };
+        }
+        catch (error) {
+            const executionTime = Date.now() - startTime;
+            return {
+                success: false,
+                exitCode: error.code || 1,
+                stdout: options.captureOutput ? error.stdout : undefined,
+                stderr: error.stderr || undefined,
+                error: error.message,
+                executionTime
+            };
+        }
+    }
+    /**
+     * Invoke command with automatic retry on transient failures
+     *
+     * @param command - Command name
+     * @param options - Invocation options
+     * @param maxRetries - Maximum retry attempts (default: 3)
+     * @returns Command execution result
+     */
+    async invokeWithRetry(command, options = {}, maxRetries = 3) {
+        let lastResult = null;
+        let attempt = 0;
+        while (attempt < maxRetries) {
+            attempt++;
+            const result = await this.invoke(command, options);
+            if (result.success) {
+                return result;
+            }
+            // Check if error is retryable
+            const severity = this.classifyError(result);
+            if (severity === ErrorSeverity.CRITICAL) {
+                // Don't retry critical errors
+                return result;
+            }
+            lastResult = result;
+            // Wait before retry (exponential backoff)
+            if (attempt < maxRetries) {
+                await this.delay(Math.pow(2, attempt) * 1000);
+            }
+        }
+        return lastResult;
+    }
+    /**
+     * Classify error severity
+     *
+     * @param result - Command result
+     * @returns Error severity level
+     */
+    classifyError(result) {
+        const error = result.error || result.stderr || '';
+        // Critical errors (don't retry)
+        if (error.includes('ENOENT') || error.includes('command not found')) {
+            return ErrorSeverity.CRITICAL;
+        }
+        if (error.includes('permission denied') || error.includes('EACCES')) {
+            return ErrorSeverity.CRITICAL;
+        }
+        // Transient errors (retry)
+        if (error.includes('ECONNREFUSED') || error.includes('ETIMEDOUT')) {
+            return ErrorSeverity.WARNING;
+        }
+        // Default to error
+        return ErrorSeverity.ERROR;
+    }
+    /**
+     * Delay execution
+     *
+     * @param ms - Milliseconds to delay
+     */
+    delay(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=command-invoker.js.map

package/dist/src/core/workflow/command-invoker.js.map

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

package/dist/src/core/workflow/cost-estimator.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Cost Estimator - AI execution cost estimation
+ *
+ * Estimates the cost of autonomous workflow execution based on
+ * AI API calls, task count, and complexity.
+ *
+ * Part of increment 0039: Ultra-Smart Next Command
+ *
+ * @module core/workflow/cost-estimator
+ * @since v0.22.0
+ */
+/**
+ * Cost estimate for workflow execution
+ */
+export interface CostEstimate {
+    /** Estimated cost in USD */
+    estimatedCost: number;
+    /** Cost breakdown by phase */
+    breakdown: CostBreakdown[];
+    /** Risk level */
+    riskLevel: RiskLevel;
+    /** Explanation */
+    explanation: string;
+    /** Confidence in estimate (0.0-1.0) */
+    confidence: number;
+}
+/**
+ * Cost breakdown by phase
+ */
+export interface CostBreakdown {
+    /** Phase name */
+    phase: string;
+    /** Number of AI calls */
+    aiCalls: number;
+    /** Estimated cost */
+    cost: number;
+}
+/**
+ * Risk level for cost
+ */
+export declare enum RiskLevel {
+    /** < $1 */
+    LOW = "low",
+    /** $1 - $5 */
+    MEDIUM = "medium",
+    /** $5 - $20 */
+    HIGH = "high",
+    /** > $20 */
+    CRITICAL = "critical"
+}
+/**
+ * Cost estimation configuration
+ */
+export interface CostEstimatorConfig {
+    /** Cost per AI call (default: $0.01) */
+    costPerCall?: number;
+    /** Low risk threshold (default: $1) */
+    lowThreshold?: number;
+    /** Medium risk threshold (default: $5) */
+    mediumThreshold?: number;
+    /** High risk threshold (default: $20) */
+    highThreshold?: number;
+}
+/**
+ * Cost Estimator - Estimate autonomous execution costs
+ */
+export declare class CostEstimator {
+    private costPerCall;
+    private lowThreshold;
+    private mediumThreshold;
+    private highThreshold;
+    constructor(config?: CostEstimatorConfig);
+    /**
+     * Estimate cost for increment execution
+     *
+     * @param incrementPath - Path to increment directory
+     * @returns Cost estimate
+     */
+    estimateIncrement(incrementPath: string): Promise<CostEstimate>;
+    /**
+     * Estimate planning cost
+     */
+    private estimatePlanning;
+    /**
+     * Estimate execution cost based on task count
+     */
+    private estimateExecution;
+    /**
+     * Estimate task count from spec.md
+     */
+    private estimateTasksFromSpec;
+    /**
+     * Estimate validation cost
+     */
+    private estimateValidation;
+    /**
+     * Estimate QA cost
+     */
+    private estimateQA;
+    /**
+     * Determine risk level based on total cost
+     */
+    private determineRiskLevel;
+    /**
+     * Calculate confidence in estimate
+     */
+    private calculateConfidence;
+    /**
+     * Generate human-readable explanation
+     */
+    private generateExplanation;
+    /**
+     * Check if cost exceeds threshold
+     *
+     * @param estimate - Cost estimate
+     * @returns True if cost exceeds HIGH threshold
+     */
+    checkThreshold(estimate: CostEstimate): boolean;
+}
+//# sourceMappingURL=cost-estimator.d.ts.map

package/dist/src/core/workflow/cost-estimator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-estimator.d.ts","sourceRoot":"","sources":["../../../../src/core/workflow/cost-estimator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,4BAA4B;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,8BAA8B;IAC9B,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,iBAAiB;IACjB,SAAS,EAAE,SAAS,CAAC;IACrB,kBAAkB;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,oBAAY,SAAS;IACnB,WAAW;IACX,GAAG,QAAQ;IACX,cAAc;IACd,MAAM,WAAW;IACjB,eAAe;IACf,IAAI,SAAS;IACb,YAAY;IACZ,QAAQ,aAAa;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,aAAa,CAAS;gBAElB,MAAM,GAAE,mBAAwB;IAO5C;;;;;OAKG;IACG,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAuCrE;;OAEG;IACH,OAAO,CAAC,gBAAgB;IASxB;;OAEG;YACW,iBAAiB;IA8B/B;;OAEG;YACW,qBAAqB;IAqBnC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;OAEG;IACH,OAAO,CAAC,UAAU;IASlB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;YACW,mBAAmB;IAejC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAuB3B;;;;;OAKG;IACH,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO;CAGhD"}