specweave 0.21.2 → 0.22.0

package/dist/src/cli/commands/plan/agent-invoker.js

@@ -0,0 +1,383 @@
+/**
+ * Agent Invoker - Orchestrates AI agent invocations for plan generation
+ *
+ * This module provides utilities to invoke the Architect and test-aware-planner
+ * agents within the Claude Code ecosystem.
+ *
+ * @module cli/commands/plan/agent-invoker
+ * @since v0.22.0 (Increment 0039)
+ */
+/**
+ * Agent Invoker - Coordinates agent invocations for plan generation
+ */
+export class AgentInvoker {
+    /**
+     * Invoke Architect Agent to generate plan.md
+     *
+     * @param context - Pipeline context with spec.md content
+     * @returns Agent invocation result with generated plan.md content
+     */
+    async invokeArchitectAgent(context) {
+        const specContent = context.specContent;
+        const incrementId = context.incrementId;
+        // Read spec.md to extract requirements
+        const requirements = this.extractRequirements(specContent);
+        const userStories = this.extractUserStories(specContent);
+        const acceptanceCriteria = this.extractAcceptanceCriteria(specContent);
+        // Generate architectural plan instructions
+        const architectPrompt = this.buildArchitectPrompt(incrementId, requirements, userStories, acceptanceCriteria);
+        // In Claude Code context, this would be picked up by the Architect agent
+        // For now, return instruction mode with generated content
+        return {
+            success: true,
+            content: architectPrompt,
+            agentName: 'architect',
+            executionMode: 'instruction'
+        };
+    }
+    /**
+     * Invoke test-aware-planner Agent to generate tasks.md
+     *
+     * @param context - Pipeline context with spec.md and plan.md content
+     * @returns Agent invocation result with generated tasks.md content
+     */
+    async invokeTestAwarePlanner(context) {
+        const specContent = context.specContent;
+        const planContent = context.generatedPlanContent;
+        const incrementId = context.incrementId;
+        // Extract data from spec and plan
+        const acceptanceCriteria = this.extractAcceptanceCriteria(specContent);
+        const phases = this.extractPhases(planContent);
+        const components = this.extractComponents(planContent);
+        // Generate task planning instructions
+        const plannerPrompt = this.buildPlannerPrompt(incrementId, acceptanceCriteria, phases, components);
+        return {
+            success: true,
+            content: plannerPrompt,
+            agentName: 'test-aware-planner',
+            executionMode: 'instruction'
+        };
+    }
+    /**
+     * Extract requirements from spec.md
+     */
+    extractRequirements(specContent) {
+        const requirements = [];
+        const reqRegex = /(?:^|\n)(?:###?|#{1,3})\s*(?:Requirement|FR-|NFR-|Functional|Non-Functional).*$/gim;
+        const matches = specContent.matchAll(reqRegex);
+        for (const match of matches) {
+            requirements.push(match[0].trim());
+        }
+        return requirements;
+    }
+    /**
+     * Extract user stories from spec.md
+     */
+    extractUserStories(specContent) {
+        const userStories = [];
+        const usRegex = /(?:^|\n)(?:###?)\s*(?:US-\d+|User Story).*$/gim;
+        const matches = specContent.matchAll(usRegex);
+        for (const match of matches) {
+            userStories.push(match[0].trim());
+        }
+        return userStories;
+    }
+    /**
+     * Extract acceptance criteria from spec.md
+     */
+    extractAcceptanceCriteria(specContent) {
+        const acMap = new Map();
+        const acRegex = /-\s*\[[ x]\]\s*(AC-\w+-\d+):\s*(.+)/gi;
+        const matches = specContent.matchAll(acRegex);
+        for (const match of matches) {
+            const acId = match[1];
+            const acText = match[2];
+            if (!acMap.has(acId)) {
+                acMap.set(acId, []);
+            }
+            acMap.get(acId).push(acText);
+        }
+        return acMap;
+    }
+    /**
+     * Extract implementation phases from plan.md
+     */
+    extractPhases(planContent) {
+        const phases = [];
+        const phaseRegex = /(?:^|\n)(?:###?)\s*(?:Phase \d+|Stage \d+).*$/gim;
+        const matches = planContent.matchAll(phaseRegex);
+        for (const match of matches) {
+            phases.push(match[0].trim());
+        }
+        return phases;
+    }
+    /**
+     * Extract components from plan.md
+     */
+    extractComponents(planContent) {
+        const components = [];
+        const compRegex = /(?:^|\n)(?:###?)\s*(?:Component|Module|Service).*$/gim;
+        const matches = planContent.matchAll(compRegex);
+        for (const match of matches) {
+            components.push(match[0].trim());
+        }
+        return components;
+    }
+    /**
+     * Build prompt for Architect Agent
+     */
+    buildArchitectPrompt(incrementId, requirements, userStories, acceptanceCriteria) {
+        return `# Architect Agent Invocation for ${incrementId}
+
+## Task
+Create a comprehensive implementation plan (plan.md) for increment ${incrementId}.
+
+## Requirements Summary
+${requirements.length > 0 ? requirements.join('\n') : 'No explicit requirements found - extract from user stories.'}
+
+## User Stories
+${userStories.length > 0 ? userStories.join('\n') : 'No user stories found - check spec.md structure.'}
+
+## Acceptance Criteria
+Total AC count: ${acceptanceCriteria.size}
+
+## Expected Output
+Generate a plan.md file that includes:
+
+1. **Architecture Overview**
+   - System components and their interactions
+   - Technology stack decisions
+   - Design patterns to be used
+
+2. **Implementation Phases**
+   - Break down work into logical phases
+   - Define dependencies between phases
+   - Estimate effort for each phase
+
+3. **Component Design**
+   - Detailed design for each major component
+   - API contracts and interfaces
+   - Data models and schemas
+
+4. **Technology Stack**
+   - Framework/library selection with rationale
+   - Architecture decisions (ADRs if significant)
+
+5. **Testing Strategy**
+   - Unit test approach
+   - Integration test approach
+   - E2E test approach
+   - Coverage targets (95% for this increment)
+
+6. **Deployment Architecture** (if applicable)
+   - Infrastructure requirements
+   - Deployment strategy
+
+## Format
+Follow the standard SpecWeave plan.md format with:
+- YAML frontmatter (increment ID, architecture docs references)
+- Clear section headers
+- Markdown formatting
+- Mermaid diagrams where helpful
+
+## Constraints
+- Must cover all ${acceptanceCriteria.size} acceptance criteria
+- Must be implementable with SpecWeave's tech stack (TypeScript, Node.js)
+- Must align with existing SpecWeave architecture
+`;
+    }
+    /**
+     * Build prompt for test-aware-planner Agent
+     */
+    buildPlannerPrompt(incrementId, acceptanceCriteria, phases, components) {
+        const acList = Array.from(acceptanceCriteria.keys());
+        return `# Test-Aware Planner Invocation for ${incrementId}
+
+## Task
+Generate a tasks.md file with embedded test plans for increment ${incrementId}.
+
+## Input Summary
+
+### Acceptance Criteria (${acList.length} total)
+${acList.join(', ')}
+
+### Implementation Phases (${phases.length} phases)
+${phases.join('\n')}
+
+### Components (${components.length} components)
+${components.join('\n')}
+
+## Expected Output
+
+Generate tasks.md with:
+
+1. **Task Breakdown**
+   - Each task implements 1-3 related acceptance criteria
+   - Clear task IDs (T-001, T-002, etc.)
+   - Sequential ordering with dependencies
+
+2. **Embedded Test Plans**
+   - BDD format (Given/When/Then)
+   - Specific test cases (unit/integration/E2E)
+   - Coverage targets (95% for this increment)
+
+3. **Task Format**
+\`\`\`markdown
+### T-001: [Task Name]
+
+**User Story**: [US reference]
+**AC**: AC-US##-##
+**Priority**: P1
+**Estimate**: X hours
+
+**Test Plan**:
+- **Given** [precondition]
+- **When** [action]
+- **Then** [expected outcome]
+
+**Test Cases**:
+1. **Unit**: tests/unit/[file].test.ts
+   - [test case description]
+   - Coverage Target: 95%
+
+2. **Integration**: tests/integration/[file].test.ts
+   - [test case description]
+
+**Dependencies**: T-XXX (if any)
+\`\`\`
+
+4. **Coverage Requirements**
+   - Overall target: 95%
+   - Critical paths: 100%
+   - Edge cases: 90%+
+
+5. **Test Mode**
+   - TDD (Test-Driven Development)
+   - Write tests first, then implementation
+
+## Constraints
+- Must cover ALL ${acList.length} acceptance criteria
+- Each AC must map to at least one task
+- No task should take more than 8 hours
+- Follow SpecWeave testing conventions
+`;
+    }
+    /**
+     * Generate plan.md content (temporary implementation)
+     *
+     * This generates a basic plan structure. In production, this would be
+     * replaced by actual Architect Agent invocation.
+     */
+    generateTemporaryPlan(context) {
+        const { incrementId, specContent } = context;
+        const requirements = this.extractRequirements(specContent);
+        const userStories = this.extractUserStories(specContent);
+        return `---
+increment: ${incrementId}
+architecture_docs:
+  - ../../docs/internal/architecture/system-design.md
+---
+
+# Implementation Plan: ${incrementId}
+
+**Status**: Planning
+**Created**: ${new Date().toISOString().split('T')[0]}
+
+---
+
+## Architecture Overview
+
+**Component Design**: To be defined by Architect Agent
+
+**Technology Stack**: SpecWeave standard stack (TypeScript, Node.js, Jest)
+
+---
+
+## Implementation Phases
+
+### Phase 1: Foundation
+- Requirements analysis
+- Architecture design
+- Technology selection
+
+### Phase 2: Implementation
+- Core component development
+- Integration
+- Testing
+
+### Phase 3: Polish
+- UX refinement
+- Documentation
+- Performance optimization
+
+---
+
+## User Stories Summary
+
+${userStories.length} user stories identified:
+${userStories.map((us, i) => `${i + 1}. ${us}`).join('\n')}
+
+---
+
+## Testing Strategy
+
+**Test Mode**: TDD
+**Coverage Target**: 95%
+
+**Approach**:
+- Unit tests: 100+ test cases
+- Integration tests: 40+ scenarios
+- E2E tests: 15+ workflows
+
+---
+
+**Note**: This is a placeholder plan. Run the Architect Agent to generate the complete implementation plan.
+`;
+    }
+    /**
+     * Generate tasks.md content (temporary implementation)
+     */
+    generateTemporaryTasks(context) {
+        const { incrementId, specContent } = context;
+        const acceptanceCriteria = this.extractAcceptanceCriteria(specContent);
+        return `# Tasks: ${incrementId}
+
+---
+increment: ${incrementId}
+status: planned
+test_mode: TDD
+coverage_target: 95%
+---
+
+## Phase 1: Foundation
+
+### T-001: Setup and Planning
+
+**AC**: ${Array.from(acceptanceCriteria.keys()).slice(0, 3).join(', ')}
+**Priority**: P1
+**Estimate**: 4 hours
+
+**Test Plan**:
+- **Given** project structure exists
+- **When** setup is complete
+- **Then** all dependencies are installed and build passes
+
+**Test Cases**:
+1. **Unit**: tests/unit/setup.test.ts
+   - Should install dependencies successfully
+   - Should compile TypeScript without errors
+   - Coverage Target: 95%
+
+**Status**: [ ] pending
+
+---
+
+**Note**: This is a placeholder tasks file. Run the test-aware-planner Agent to generate the complete task breakdown with embedded test plans.
+
+**Total Acceptance Criteria**: ${acceptanceCriteria.size}
+**Mapped to Tasks**: 1 (placeholder)
+**Unmapped**: ${acceptanceCriteria.size - 1} (requires full task generation)
+`;
+    }
+}
+//# sourceMappingURL=agent-invoker.js.map

package/dist/src/cli/commands/plan/agent-invoker.js.map

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

package/dist/src/cli/commands/plan/increment-detector.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Increment Detector
+ *
+ * Auto-detects active increment when not explicitly specified.
+ * Prefers PLANNING status, falls back to ACTIVE if WIP=1.
+ *
+ * Part of increment 0039: Ultra-Smart Next Command
+ */
+import { IncrementDetectionResult } from './types.js';
+export declare class IncrementDetector {
+    private projectRoot;
+    constructor(projectRoot?: string);
+    /**
+     * Auto-detect increment to plan
+     * Priority: PLANNING status > single ACTIVE increment
+     */
+    detect(): Promise<IncrementDetectionResult>;
+    /**
+     * Validate that specified increment exists and is in suitable state
+     */
+    validate(incrementId: string): Promise<IncrementDetectionResult>;
+    /**
+     * List all available increments
+     */
+    private listAvailableIncrements;
+}
+//# sourceMappingURL=increment-detector.d.ts.map

package/dist/src/cli/commands/plan/increment-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"increment-detector.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/plan/increment-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAItD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,GAAE,MAAsB;IAI/C;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,wBAAwB,CAAC;IA4FjD;;OAEG;IACG,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAyCtE;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAchC"}

package/dist/src/cli/commands/plan/increment-detector.js

@@ -0,0 +1,159 @@
+/**
+ * Increment Detector
+ *
+ * Auto-detects active increment when not explicitly specified.
+ * Prefers PLANNING status, falls back to ACTIVE if WIP=1.
+ *
+ * Part of increment 0039: Ultra-Smart Next Command
+ */
+import { MetadataManager } from '../../../core/increment/metadata-manager.js';
+import { IncrementStatus } from '../../../core/types/increment-metadata.js';
+import * as fs from 'fs';
+import * as path from 'path';
+export class IncrementDetector {
+    constructor(projectRoot = process.cwd()) {
+        this.projectRoot = projectRoot;
+    }
+    /**
+     * Auto-detect increment to plan
+     * Priority: PLANNING status > single ACTIVE increment
+     */
+    async detect() {
+        const incrementsDir = path.join(this.projectRoot, '.specweave/increments');
+        // Check if increments directory exists
+        if (!fs.existsSync(incrementsDir)) {
+            return {
+                success: false,
+                reason: 'No .specweave/increments directory found. Run `specweave init` first.',
+                candidates: []
+            };
+        }
+        // Get all increment directories
+        const allIncrements = fs.readdirSync(incrementsDir)
+            .filter(dir => {
+            const fullPath = path.join(incrementsDir, dir);
+            return fs.statSync(fullPath).isDirectory() && /^\d{4}-/.test(dir);
+        });
+        if (allIncrements.length === 0) {
+            return {
+                success: false,
+                reason: 'No increments found. Create an increment with `/specweave:increment` first.',
+                candidates: []
+            };
+        }
+        // Filter to PLANNING and ACTIVE increments
+        const planningIncrements = [];
+        const activeIncrements = [];
+        for (const incrementId of allIncrements) {
+            try {
+                const metadata = MetadataManager.read(incrementId);
+                if (metadata.status === IncrementStatus.PLANNING) {
+                    planningIncrements.push(incrementId);
+                }
+                else if (metadata.status === IncrementStatus.ACTIVE) {
+                    activeIncrements.push(incrementId);
+                }
+            }
+            catch (error) {
+                // Skip increments with invalid metadata
+                continue;
+            }
+        }
+        // Priority 1: Single PLANNING increment
+        if (planningIncrements.length === 1) {
+            return {
+                success: true,
+                incrementId: planningIncrements[0],
+                reason: `Auto-detected increment in PLANNING status: ${planningIncrements[0]}`,
+                candidates: planningIncrements
+            };
+        }
+        // Priority 2: Multiple PLANNING increments (error - user must specify)
+        if (planningIncrements.length > 1) {
+            return {
+                success: false,
+                reason: `Multiple increments in PLANNING status found. Please specify which one to plan:\n${planningIncrements.map(id => `  - ${id}`).join('\n')}`,
+                candidates: planningIncrements
+            };
+        }
+        // Priority 3: Single ACTIVE increment (if WIP=1)
+        if (activeIncrements.length === 1) {
+            return {
+                success: true,
+                incrementId: activeIncrements[0],
+                reason: `Auto-detected single ACTIVE increment: ${activeIncrements[0]}`,
+                candidates: activeIncrements
+            };
+        }
+        // Priority 4: Multiple ACTIVE increments (error - user must specify)
+        if (activeIncrements.length > 1) {
+            return {
+                success: false,
+                reason: `Multiple ACTIVE increments found. Please specify which one to plan:\n${activeIncrements.map(id => `  - ${id}`).join('\n')}`,
+                candidates: activeIncrements
+            };
+        }
+        // No suitable increments found
+        return {
+            success: false,
+            reason: 'No PLANNING or ACTIVE increments found. Create an increment with `/specweave:increment` first.',
+            candidates: []
+        };
+    }
+    /**
+     * Validate that specified increment exists and is in suitable state
+     */
+    async validate(incrementId) {
+        const incrementPath = path.join(this.projectRoot, '.specweave/increments', incrementId);
+        // Check if increment exists
+        if (!fs.existsSync(incrementPath)) {
+            return {
+                success: false,
+                reason: `Increment '${incrementId}' not found. Available increments:\n${this.listAvailableIncrements().map(id => `  - ${id}`).join('\n')}`,
+                candidates: this.listAvailableIncrements()
+            };
+        }
+        // Read metadata
+        try {
+            const metadata = MetadataManager.read(incrementId);
+            // Check if increment is in suitable state
+            if (metadata.status === IncrementStatus.COMPLETED ||
+                metadata.status === IncrementStatus.ABANDONED) {
+                return {
+                    success: false,
+                    reason: `Increment '${incrementId}' is ${metadata.status}. Cannot generate plan for closed increments.`,
+                    candidates: []
+                };
+            }
+            return {
+                success: true,
+                incrementId,
+                reason: `Validated increment '${incrementId}' (status: ${metadata.status})`,
+                candidates: [incrementId]
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                reason: `Failed to read metadata for increment '${incrementId}': ${error instanceof Error ? error.message : String(error)}`,
+                candidates: []
+            };
+        }
+    }
+    /**
+     * List all available increments
+     */
+    listAvailableIncrements() {
+        const incrementsDir = path.join(this.projectRoot, '.specweave/increments');
+        if (!fs.existsSync(incrementsDir)) {
+            return [];
+        }
+        return fs.readdirSync(incrementsDir)
+            .filter(dir => {
+            const fullPath = path.join(incrementsDir, dir);
+            return fs.statSync(fullPath).isDirectory() && /^\d{4}-/.test(dir);
+        })
+            .sort();
+    }
+}
+//# sourceMappingURL=increment-detector.js.map

package/dist/src/cli/commands/plan/increment-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"increment-detector.js","sourceRoot":"","sources":["../../../../../src/cli/commands/plan/increment-detector.ts"],"names":[],"mappings":"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"}

package/dist/src/cli/commands/plan/plan-orchestrator.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Plan Command Orchestrator
+ *
+ * Main orchestration logic for /specweave:plan command.
+ * Coordinates: detection → validation → architect agent → task generator → file write
+ *
+ * Part of increment 0039: Ultra-Smart Next Command
+ */
+import { PlanCommandConfig, PlanCommandResult } from './types.js';
+export declare class PlanCommandOrchestrator {
+    private projectRoot;
+    private detector;
+    private validator;
+    private agentInvoker;
+    constructor(projectRoot?: string);
+    /**
+     * Execute /specweave:plan command
+     */
+    execute(config: PlanCommandConfig): Promise<PlanCommandResult>;
+    /**
+     * Detect or validate increment ID
+     */
+    private detectIncrement;
+    /**
+     * Write plan.md and tasks.md files
+     */
+    private writeFiles;
+    /**
+     * Update increment metadata after planning
+     */
+    private updateMetadata;
+    /**
+     * Create failure result
+     */
+    private createFailureResult;
+    /**
+     * Generate placeholder plan.md (temporary - will be replaced with Architect Agent)
+     */
+    private generatePlaceholderPlan;
+    /**
+     * Generate placeholder tasks.md (temporary - will be replaced with TaskGenerator)
+     */
+    private generatePlaceholderTasks;
+}
+//# sourceMappingURL=plan-orchestrator.d.ts.map

package/dist/src/cli/commands/plan/plan-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-orchestrator.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/plan/plan-orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EAIlB,MAAM,YAAY,CAAC;AAQpB,qBAAa,uBAAuB;IAClC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,YAAY,CAAe;gBAEvB,WAAW,GAAE,MAAsB;IAO/C;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAqFpE;;OAEG;YACW,eAAe;IAsB7B;;OAEG;YACW,UAAU;IAuBxB;;OAEG;YACW,cAAc;IA0B5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAgB3B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAgC/B;;OAEG;IACH,OAAO,CAAC,wBAAwB;CAqBjC"}