specweave 0.22.0 → 0.22.2

package/dist/src/core/workflow/cost-estimator.js

@@ -0,0 +1,222 @@
+/**
+ * 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
+ */
+import * as fs from 'fs-extra';
+import * as path from 'path';
+/**
+ * Risk level for cost
+ */
+export var RiskLevel;
+(function (RiskLevel) {
+    /** < $1 */
+    RiskLevel["LOW"] = "low";
+    /** $1 - $5 */
+    RiskLevel["MEDIUM"] = "medium";
+    /** $5 - $20 */
+    RiskLevel["HIGH"] = "high";
+    /** > $20 */
+    RiskLevel["CRITICAL"] = "critical";
+})(RiskLevel || (RiskLevel = {}));
+/**
+ * Cost Estimator - Estimate autonomous execution costs
+ */
+export class CostEstimator {
+    constructor(config = {}) {
+        this.costPerCall = config.costPerCall || 0.01;
+        this.lowThreshold = config.lowThreshold || 1.0;
+        this.mediumThreshold = config.mediumThreshold || 5.0;
+        this.highThreshold = config.highThreshold || 20.0;
+    }
+    /**
+     * Estimate cost for increment execution
+     *
+     * @param incrementPath - Path to increment directory
+     * @returns Cost estimate
+     */
+    async estimateIncrement(incrementPath) {
+        const breakdown = [];
+        let totalCost = 0;
+        // Planning phase: 2 AI calls (Architect + test-aware-planner)
+        const planningCost = this.estimatePlanning(incrementPath);
+        breakdown.push(planningCost);
+        totalCost += planningCost.cost;
+        // Execution phase: Based on task count
+        const executionCost = await this.estimateExecution(incrementPath);
+        breakdown.push(executionCost);
+        totalCost += executionCost.cost;
+        // Validation phase: 1 AI call (PM validation)
+        const validationCost = this.estimateValidation();
+        breakdown.push(validationCost);
+        totalCost += validationCost.cost;
+        // QA phase: 1 AI call (judge LLM)
+        const qaCost = this.estimateQA();
+        breakdown.push(qaCost);
+        totalCost += qaCost.cost;
+        // Determine risk level
+        const riskLevel = this.determineRiskLevel(totalCost);
+        // Calculate confidence based on data availability
+        const confidence = await this.calculateConfidence(incrementPath);
+        return {
+            estimatedCost: totalCost,
+            breakdown,
+            riskLevel,
+            explanation: this.generateExplanation(totalCost, riskLevel, breakdown),
+            confidence
+        };
+    }
+    /**
+     * Estimate planning cost
+     */
+    estimatePlanning(incrementPath) {
+        // Planning = Architect + test-aware-planner = 2 calls
+        return {
+            phase: 'Planning',
+            aiCalls: 2,
+            cost: 2 * this.costPerCall
+        };
+    }
+    /**
+     * Estimate execution cost based on task count
+     */
+    async estimateExecution(incrementPath) {
+        const tasksPath = path.join(incrementPath, 'tasks.md');
+        let taskCount = 0;
+        // Try to count tasks from tasks.md
+        if (await fs.pathExists(tasksPath)) {
+            try {
+                const content = await fs.readFile(tasksPath, 'utf-8');
+                // Count task headers (#### T-XXX:)
+                const taskMatches = content.match(/^####\s+T-\d+:/gm);
+                taskCount = taskMatches ? taskMatches.length : 0;
+            }
+            catch (error) {
+                // If can't read tasks, estimate based on spec
+                taskCount = 10; // Default estimate
+            }
+        }
+        else {
+            // No tasks.md yet, estimate from spec.md
+            taskCount = await this.estimateTasksFromSpec(incrementPath);
+        }
+        // Assume 3 AI calls per task (avg: simple=1, medium=3, complex=5)
+        const aiCalls = taskCount * 3;
+        return {
+            phase: 'Execution',
+            aiCalls,
+            cost: aiCalls * this.costPerCall
+        };
+    }
+    /**
+     * Estimate task count from spec.md
+     */
+    async estimateTasksFromSpec(incrementPath) {
+        const specPath = path.join(incrementPath, 'spec.md');
+        if (!await fs.pathExists(specPath)) {
+            return 10; // Default estimate
+        }
+        try {
+            const content = await fs.readFile(specPath, 'utf-8');
+            // Count acceptance criteria as rough proxy for tasks
+            const acMatches = content.match(/^- \[.\] AC-/gm);
+            const acCount = acMatches ? acMatches.length : 0;
+            // Rough heuristic: 2 ACs ≈ 1 task
+            return Math.max(Math.floor(acCount / 2), 5);
+        }
+        catch (error) {
+            return 10;
+        }
+    }
+    /**
+     * Estimate validation cost
+     */
+    estimateValidation() {
+        // Validation = 1 PM validation call
+        return {
+            phase: 'Validation',
+            aiCalls: 1,
+            cost: 1 * this.costPerCall
+        };
+    }
+    /**
+     * Estimate QA cost
+     */
+    estimateQA() {
+        // QA = 1 judge LLM call
+        return {
+            phase: 'QA',
+            aiCalls: 1,
+            cost: 1 * this.costPerCall
+        };
+    }
+    /**
+     * Determine risk level based on total cost
+     */
+    determineRiskLevel(cost) {
+        if (cost < this.lowThreshold) {
+            return RiskLevel.LOW;
+        }
+        else if (cost < this.mediumThreshold) {
+            return RiskLevel.MEDIUM;
+        }
+        else if (cost < this.highThreshold) {
+            return RiskLevel.HIGH;
+        }
+        else {
+            return RiskLevel.CRITICAL;
+        }
+    }
+    /**
+     * Calculate confidence in estimate
+     */
+    async calculateConfidence(incrementPath) {
+        // Higher confidence if tasks.md exists
+        const tasksExists = await fs.pathExists(path.join(incrementPath, 'tasks.md'));
+        const planExists = await fs.pathExists(path.join(incrementPath, 'plan.md'));
+        const specExists = await fs.pathExists(path.join(incrementPath, 'spec.md'));
+        if (tasksExists && planExists) {
+            return 0.9; // High confidence (tasks are defined)
+        }
+        else if (specExists) {
+            return 0.6; // Medium confidence (only spec exists)
+        }
+        else {
+            return 0.3; // Low confidence (estimating blindly)
+        }
+    }
+    /**
+     * Generate human-readable explanation
+     */
+    generateExplanation(totalCost, riskLevel, breakdown) {
+        const parts = [];
+        parts.push(`Estimated cost: $${totalCost.toFixed(2)} (Risk: ${riskLevel.toUpperCase()})`);
+        parts.push('\nBreakdown:');
+        breakdown.forEach(item => {
+            parts.push(`  - ${item.phase}: ${item.aiCalls} AI calls ($${item.cost.toFixed(2)})`);
+        });
+        if (riskLevel === RiskLevel.CRITICAL) {
+            parts.push('\n⚠️  CRITICAL: Cost exceeds $20. Consider manual execution or splitting work.');
+        }
+        else if (riskLevel === RiskLevel.HIGH) {
+            parts.push('\n⚠️  HIGH: Cost is significant ($5-$20). Confirm before proceeding.');
+        }
+        return parts.join('\n');
+    }
+    /**
+     * Check if cost exceeds threshold
+     *
+     * @param estimate - Cost estimate
+     * @returns True if cost exceeds HIGH threshold
+     */
+    checkThreshold(estimate) {
+        return estimate.riskLevel === RiskLevel.HIGH || estimate.riskLevel === RiskLevel.CRITICAL;
+    }
+}
+//# sourceMappingURL=cost-estimator.js.map

package/dist/src/core/workflow/cost-estimator.js.map

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

package/dist/src/core/workflow/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Workflow Orchestration Module
+ *
+ * Provides intelligent workflow orchestration for SpecWeave,
+ * enabling autonomous and semi-autonomous workflow execution.
+ *
+ * Part of increment 0039: Ultra-Smart Next Command
+ *
+ * @module core/workflow
+ * @since v0.22.0
+ */
+export { WorkflowOrchestrator, WorkflowExecuteOptions, WorkflowExecutionResult } from './workflow-orchestrator.js';
+export { AutonomousExecutor, AutonomousConfig, AutonomousResult } from './autonomous-executor.js';
+export { PhaseDetector } from './phase-detector.js';
+export { WorkflowPhase, PhaseDetectionResult, DetectionContext, PhaseEvidence } from './types.js';
+export { BacklogScanner, BacklogItem, RankedBacklogItem, BacklogRecommendation } from './backlog-scanner.js';
+export { CostEstimator, CostEstimate, CostBreakdown, RiskLevel, CostEstimatorConfig } from './cost-estimator.js';
+export { CommandInvoker, InvokeOptions, InvokeResult, ErrorSeverity } from './command-invoker.js';
+export { StateManager, Checkpoint } from './state-manager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/workflow/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/workflow/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACnH,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAGlG,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,EACd,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,aAAa,EACb,YAAY,EACZ,aAAa,EACb,SAAS,EACT,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAClG,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/src/core/workflow/index.js

@@ -0,0 +1,24 @@
+/**
+ * Workflow Orchestration Module
+ *
+ * Provides intelligent workflow orchestration for SpecWeave,
+ * enabling autonomous and semi-autonomous workflow execution.
+ *
+ * Part of increment 0039: Ultra-Smart Next Command
+ *
+ * @module core/workflow
+ * @since v0.22.0
+ */
+// Core orchestration
+export { WorkflowOrchestrator } from './workflow-orchestrator.js';
+export { AutonomousExecutor } from './autonomous-executor.js';
+// Phase detection
+export { PhaseDetector } from './phase-detector.js';
+export { WorkflowPhase } from './types.js';
+// Intelligence
+export { BacklogScanner } from './backlog-scanner.js';
+export { CostEstimator, RiskLevel } from './cost-estimator.js';
+// Execution infrastructure
+export { CommandInvoker, ErrorSeverity } from './command-invoker.js';
+export { StateManager } from './state-manager.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/workflow/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/workflow/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,qBAAqB;AACrB,OAAO,EAAE,oBAAoB,EAAmD,MAAM,4BAA4B,CAAC;AACnH,OAAO,EAAE,kBAAkB,EAAsC,MAAM,0BAA0B,CAAC;AAElG,kBAAkB;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EACL,aAAa,EAId,MAAM,YAAY,CAAC;AAEpB,eAAe;AACf,OAAO,EACL,cAAc,EAIf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,aAAa,EAGb,SAAS,EAEV,MAAM,qBAAqB,CAAC;AAE7B,2BAA2B;AAC3B,OAAO,EAAE,cAAc,EAA+B,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAClG,OAAO,EAAE,YAAY,EAAc,MAAM,oBAAoB,CAAC"}

package/dist/src/core/workflow/state-manager.d.ts

@@ -0,0 +1,107 @@
+/**
+ * State Manager - Workflow state tracking and checkpointing
+ *
+ * Manages workflow state, checkpoints, and recovery for autonomous execution.
+ *
+ * Part of increment 0039: Ultra-Smart Next Command
+ *
+ * @module core/workflow/state-manager
+ * @since v0.22.0
+ */
+import { WorkflowPhase } from './types.js';
+/**
+ * Checkpoint - Saved workflow state
+ */
+export interface Checkpoint {
+    /** Unique checkpoint ID */
+    id: string;
+    /** Timestamp */
+    timestamp: number;
+    /** Increment ID */
+    incrementId: string;
+    /** Current workflow phase */
+    phase: WorkflowPhase;
+    /** Iteration count */
+    iteration: number;
+    /** Actions taken */
+    actions: string[];
+    /** Last successful action */
+    lastAction?: string;
+    /** Custom metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * State transition record
+ */
+export interface StateTransition {
+    /** From phase */
+    from: WorkflowPhase;
+    /** To phase */
+    to: WorkflowPhase;
+    /** Timestamp */
+    timestamp: number;
+    /** Action that caused transition */
+    action: string;
+    /** Success flag */
+    success: boolean;
+}
+/**
+ * State Manager - Track workflow state and checkpoints
+ */
+export declare class StateManager {
+    private checkpointDir;
+    private maxCheckpoints;
+    constructor(checkpointDir?: string, maxCheckpoints?: number);
+    /**
+     * Save checkpoint
+     *
+     * @param checkpoint - Checkpoint data
+     */
+    saveCheckpoint(checkpoint: Checkpoint): Promise<void>;
+    /**
+     * Load checkpoints for increment
+     *
+     * @param incrementId - Increment ID
+     * @returns Array of checkpoints (sorted by timestamp, newest first)
+     */
+    loadCheckpoints(incrementId: string): Promise<Checkpoint[]>;
+    /**
+     * Get latest checkpoint for increment
+     *
+     * @param incrementId - Increment ID
+     * @returns Latest checkpoint or null
+     */
+    getLatestCheckpoint(incrementId: string): Promise<Checkpoint | null>;
+    /**
+     * Delete checkpoint
+     *
+     * @param incrementId - Increment ID
+     * @param checkpointId - Checkpoint ID
+     */
+    deleteCheckpoint(incrementId: string, checkpointId: string): Promise<void>;
+    /**
+     * Cleanup old checkpoints (keep only N most recent)
+     *
+     * @param incrementId - Increment ID
+     */
+    private cleanupOldCheckpoints;
+    /**
+     * Detect infinite loop in phase history
+     *
+     * Checks if the same phase has been visited too many times in a row.
+     *
+     * @param phaseHistory - Recent phase history
+     * @param threshold - Max same-phase repetitions (default: 3)
+     * @returns True if loop detected
+     */
+    detectLoop(phaseHistory: WorkflowPhase[], threshold?: number): boolean;
+    /**
+     * Record state transition
+     *
+     * (For now, this is a no-op - will be used for analytics/debugging)
+     *
+     * @param transition - State transition record
+     */
+    recordTransition(transition: StateTransition): void;
+}
+//# sourceMappingURL=state-manager.d.ts.map

package/dist/src/core/workflow/state-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-manager.d.ts","sourceRoot":"","sources":["../../../../src/core/workflow/state-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,2BAA2B;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,KAAK,EAAE,aAAa,CAAC;IACrB,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,6BAA6B;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iBAAiB;IACjB,IAAI,EAAE,aAAa,CAAC;IACpB,eAAe;IACf,EAAE,EAAE,aAAa,CAAC;IAClB,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,cAAc,CAAS;gBAEnB,aAAa,CAAC,EAAE,MAAM,EAAE,cAAc,GAAE,MAAW;IAK/D;;;;OAIG;IACG,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAc3D;;;;;OAKG;IACG,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAyBjE;;;;;OAKG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAK1E;;;;;OAKG;IACG,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWhF;;;;OAIG;YACW,qBAAqB;IAYnC;;;;;;;;OAQG;IACH,UAAU,CAAC,YAAY,EAAE,aAAa,EAAE,EAAE,SAAS,GAAE,MAAU,GAAG,OAAO;IAYzE;;;;;;OAMG;IACH,gBAAgB,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI;CAKpD"}

package/dist/src/core/workflow/state-manager.js

@@ -0,0 +1,126 @@
+/**
+ * State Manager - Workflow state tracking and checkpointing
+ *
+ * Manages workflow state, checkpoints, and recovery for autonomous execution.
+ *
+ * Part of increment 0039: Ultra-Smart Next Command
+ *
+ * @module core/workflow/state-manager
+ * @since v0.22.0
+ */
+import * as fs from 'fs-extra';
+import * as path from 'path';
+/**
+ * State Manager - Track workflow state and checkpoints
+ */
+export class StateManager {
+    constructor(checkpointDir, maxCheckpoints = 10) {
+        this.checkpointDir = checkpointDir || '.specweave/checkpoints';
+        this.maxCheckpoints = maxCheckpoints;
+    }
+    /**
+     * Save checkpoint
+     *
+     * @param checkpoint - Checkpoint data
+     */
+    async saveCheckpoint(checkpoint) {
+        await fs.ensureDir(this.checkpointDir);
+        const checkpointPath = path.join(this.checkpointDir, `${checkpoint.incrementId}-${checkpoint.id}.json`);
+        await fs.writeJson(checkpointPath, checkpoint, { spaces: 2 });
+        // Cleanup old checkpoints
+        await this.cleanupOldCheckpoints(checkpoint.incrementId);
+    }
+    /**
+     * Load checkpoints for increment
+     *
+     * @param incrementId - Increment ID
+     * @returns Array of checkpoints (sorted by timestamp, newest first)
+     */
+    async loadCheckpoints(incrementId) {
+        if (!await fs.pathExists(this.checkpointDir)) {
+            return [];
+        }
+        const files = await fs.readdir(this.checkpointDir);
+        const checkpointFiles = files.filter(f => f.startsWith(`${incrementId}-`) && f.endsWith('.json'));
+        const checkpoints = [];
+        for (const file of checkpointFiles) {
+            try {
+                const checkpoint = await fs.readJson(path.join(this.checkpointDir, file));
+                checkpoints.push(checkpoint);
+            }
+            catch (error) {
+                // Skip corrupted checkpoints
+                console.warn(`Failed to load checkpoint ${file}:`, error);
+            }
+        }
+        // Sort by timestamp (newest first)
+        return checkpoints.sort((a, b) => b.timestamp - a.timestamp);
+    }
+    /**
+     * Get latest checkpoint for increment
+     *
+     * @param incrementId - Increment ID
+     * @returns Latest checkpoint or null
+     */
+    async getLatestCheckpoint(incrementId) {
+        const checkpoints = await this.loadCheckpoints(incrementId);
+        return checkpoints[0] || null;
+    }
+    /**
+     * Delete checkpoint
+     *
+     * @param incrementId - Increment ID
+     * @param checkpointId - Checkpoint ID
+     */
+    async deleteCheckpoint(incrementId, checkpointId) {
+        const checkpointPath = path.join(this.checkpointDir, `${incrementId}-${checkpointId}.json`);
+        if (await fs.pathExists(checkpointPath)) {
+            await fs.remove(checkpointPath);
+        }
+    }
+    /**
+     * Cleanup old checkpoints (keep only N most recent)
+     *
+     * @param incrementId - Increment ID
+     */
+    async cleanupOldCheckpoints(incrementId) {
+        const checkpoints = await this.loadCheckpoints(incrementId);
+        if (checkpoints.length > this.maxCheckpoints) {
+            const toDelete = checkpoints.slice(this.maxCheckpoints);
+            for (const checkpoint of toDelete) {
+                await this.deleteCheckpoint(incrementId, checkpoint.id);
+            }
+        }
+    }
+    /**
+     * Detect infinite loop in phase history
+     *
+     * Checks if the same phase has been visited too many times in a row.
+     *
+     * @param phaseHistory - Recent phase history
+     * @param threshold - Max same-phase repetitions (default: 3)
+     * @returns True if loop detected
+     */
+    detectLoop(phaseHistory, threshold = 3) {
+        if (phaseHistory.length < threshold) {
+            return false;
+        }
+        // Check if last N phases are all the same
+        const recentPhases = phaseHistory.slice(-threshold);
+        const uniquePhases = new Set(recentPhases);
+        return uniquePhases.size === 1;
+    }
+    /**
+     * Record state transition
+     *
+     * (For now, this is a no-op - will be used for analytics/debugging)
+     *
+     * @param transition - State transition record
+     */
+    recordTransition(transition) {
+        // TODO: Implement transition logging
+        // For now, just log to console
+        console.log(`State transition: ${transition.from} → ${transition.to} (${transition.action})`);
+    }
+}
+//# sourceMappingURL=state-manager.js.map

package/dist/src/core/workflow/state-manager.js.map

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

package/dist/src/core/workflow/workflow-orchestrator.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Workflow Orchestrator - Core orchestration logic for /specweave:next
+ *
+ * Coordinates workflow execution by detecting current phase and
+ * invoking appropriate commands.
+ *
+ * Part of increment 0039: Ultra-Smart Next Command
+ *
+ * @module core/workflow/workflow-orchestrator
+ * @since v0.22.0
+ */
+import { WorkflowPhase } from './types.js';
+/**
+ * Workflow execution options
+ */
+export interface WorkflowExecuteOptions {
+    /** Auto-approve actions without prompting (dangerous!) */
+    autonomous?: boolean;
+    /** Show detailed execution information */
+    verbose?: boolean;
+    /** Dry-run mode (preview actions without executing) */
+    dryRun?: boolean;
+    /** Force execution even with low confidence */
+    force?: boolean;
+}
+/**
+ * Workflow execution result
+ */
+export interface WorkflowExecutionResult {
+    /** Execution succeeded */
+    success: boolean;
+    /** Phase that was detected */
+    phase: WorkflowPhase;
+    /** Confidence score for phase detection */
+    confidence: number;
+    /** Action that was taken */
+    action?: string;
+    /** Command that was invoked */
+    command?: string;
+    /** Error message if failed */
+    error?: string;
+    /** Human-readable explanation */
+    reasoning?: string;
+    /** Phase detection evidence */
+    evidence?: string[];
+}
+/**
+ * Workflow Orchestrator - Coordinates intelligent workflow execution
+ *
+ * This is a simplified initial implementation focusing on core phase detection.
+ * Full autonomous execution will be added in future tasks.
+ */
+export declare class WorkflowOrchestrator {
+    private phaseDetector;
+    private activeIncrementManager;
+    constructor();
+    /**
+     * Execute next step in workflow (interactive mode)
+     *
+     * Detects current phase and suggests/executes appropriate action.
+     *
+     * @param incrementId - Optional increment ID (auto-detects if not provided)
+     * @param options - Execution options
+     * @returns Workflow execution result
+     */
+    executeNext(incrementId?: string, options?: WorkflowExecuteOptions): Promise<WorkflowExecutionResult>;
+    /**
+     * Format reasoning from phase detection result
+     */
+    private formatReasoning;
+    /**
+     * Detect current workflow phase for increment
+     *
+     * @param incrementId - Increment ID (auto-detects if not provided)
+     * @returns Phase detection result
+     */
+    private detectCurrentPhase;
+    /**
+     * Auto-detect active increment
+     *
+     * @returns Increment ID or throws if none found
+     */
+    private detectActiveIncrement;
+    /**
+     * Determine action based on phase and confidence
+     *
+     * @param detection - Phase detection result
+     * @param options - Execution options
+     * @returns Suggested action
+     */
+    private determineAction;
+}
+//# sourceMappingURL=workflow-orchestrator.d.ts.map

package/dist/src/core/workflow/workflow-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-orchestrator.d.ts","sourceRoot":"","sources":["../../../../src/core/workflow/workflow-orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,aAAa,EAA0C,MAAM,YAAY,CAAC;AAGnF;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,0DAA0D;IAC1D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uDAAuD;IACvD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,0BAA0B;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;GAKG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,sBAAsB,CAAyB;;IAOvD;;;;;;;;OAQG;IACG,WAAW,CACf,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,uBAAuB,CAAC;IA0CnC;;OAEG;IACH,OAAO,CAAC,eAAe;IAmBvB;;;;;OAKG;YACW,kBAAkB;IAiBhC;;;;OAIG;YACW,qBAAqB;IAiBnC;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;CAuExB"}