sdd-pipeline 1.2.4 → 1.2.6

package/bin/sdd.cjs

@@ -0,0 +1,201 @@
+#!/usr/bin/env node
+// sdd — Spec-Driven Development CLI
+// Unified entry point for both npm package and local development
+
+const path = require('path')
+const fs = require('fs')
+
+// Determine if we're in npm package or local development
+const isNpmPackage = fs.existsSync(path.join(__dirname, 'lib/bmad.js'))
+const libDir = isNpmPackage ? path.join(__dirname, 'lib') : path.join(__dirname, '..', 'lib')
+
+// Dynamic requires
+const init = require(path.join(libDir, 'init'))
+const bmad = require(path.join(libDir, 'bmad/index'))
+const config = require(path.join(libDir, 'config'))
+
+const args = process.argv.slice(2)
+const cmd = args[0]
+
+// PowerShell detection - use correct command for platform
+function getPowerShellCommand() {
+  if (process.platform === 'win32') {
+    // Windows: try powershell.exe first (always available), then pwsh
+    const system32 = 'C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe'
+    if (fs.existsSync(system32)) {
+      return 'powershell'
+    }
+    return 'powershell' // Fallback to whatever is in PATH
+  }
+  return 'pwsh' // macOS/Linux: PowerShell Core
+}
+
+function runPowerShellScript(scriptPath, scriptArgs, callback) {
+  const psCmd = getPowerShellCommand()
+  const psArgs = ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', scriptPath, ...scriptArgs]
+
+  const { spawn } = require('child_process')
+  const ps = spawn(psCmd, psArgs, {
+    stdio: 'inherit',
+    shell: false,
+    windowsHide: true
+  })
+
+  ps.on('error', (err) => {
+    callback(err, null)
+  })
+
+  ps.on('close', (code) => {
+    callback(null, code)
+  })
+}
+
+switch (cmd) {
+  case 'init':
+    init.run()
+    break
+
+  case 'bmad': {
+    const input = args.slice(1).join(' ')
+    if (!input) {
+      console.error('Usage: sdd bmad <feature description>')
+      console.error('Example: sdd bmad "landing page for my SaaS product"')
+      console.error('')
+      console.error('For interactive mode (9-question interview), use Claude Code:')
+      console.error('  claude "/sdd-bmad landing page for my SaaS"')
+      process.exit(1)
+    }
+
+    // Try to run PowerShell script if available
+    const commandsDir = isNpmPackage
+      ? path.join(libDir, 'bundle', '.claude', 'commands')
+      : path.join(__dirname, '..', '.claude', 'commands')
+    const bmadScript = path.join(commandsDir, 'sdd-bmad.md')
+
+    // Note: Claude Code commands are .md files designed for Claude Code CLI
+    // PowerShell cannot run .md files directly
+    // So we always use the Node.js module for fast mode
+
+    // Generate brief using Node.js module
+    const session = bmad.init(input)
+    const result = bmad.generateBrief()
+
+    console.log('[OK] sdd/brief.md created.')
+    console.log(`Confidence: ${result.confidence.score}/100 — ${result.confidence.level}`)
+    console.log('')
+    console.log('Output: sdd/brief.md')
+    console.log('')
+    if (result.confidence.score < 70) {
+      console.log('Tip: For higher confidence, use Claude Code with interactive mode:')
+      console.log('  claude "/sdd-bmad ' + input.substring(0, 30) + '..."')
+    }
+    console.log('')
+    console.log('Next: claude "/sdd-spec" to generate SPEC.md')
+    console.log('      (or use Claude Code for full interactive experience)')
+    break
+  }
+
+  case 'spec':
+    console.log('=== SDD SPEC Generation ===')
+    console.log('')
+    console.log('This command requires Claude Code for best results.')
+    console.log('')
+    console.log('Run: claude "/sdd-spec"')
+    console.log('')
+    console.log('Claude Code will:')
+    console.log('  1. Read sdd/brief.md')
+    console.log('  2. Validate confidence score (requires >= 20)')
+    console.log('  3. Generate sdd/SPEC.md from template')
+    break
+
+  case 'tasks':
+    console.log('=== SDD Task Generation ===')
+    console.log('')
+    console.log('This command requires Claude Code.')
+    console.log('')
+    console.log('Run: claude "/sdd-tasks"')
+    console.log('')
+    console.log('Claude Code will:')
+    console.log('  1. Read sdd/SPEC.md')
+    console.log('  2. Extract features from Section 4.1')
+    console.log('  3. Generate sdd/tasks/task-*/ directory')
+    console.log('  4. Create MASTER-TASKS.md and T-XXX-*.md files')
+    break
+
+  case 'cook':
+    console.log('=== SDD Implementation ===')
+    console.log('')
+    console.log('This command requires Claude Code.')
+    console.log('')
+    console.log('Run: claude "/sdd-cook"')
+    console.log('')
+    console.log('Claude Code will:')
+    console.log('  1. Read sdd/tasks/task-*/MASTER-TASKS.md')
+    console.log('  2. Execute tasks sequentially')
+    console.log('  3. Scout, implement, test, review each task')
+    console.log('')
+    console.log('Flags:')
+    console.log('  --all      Execute all pending tasks')
+    console.log('  --task T-001  Execute specific task')
+    break
+
+  case 'converge':
+    console.log('=== SDD Converge Validation ===')
+    console.log('')
+    console.log('Full validation (requires dev server):')
+    console.log('  pwsh run-converge.ps1 -Url http://localhost:3000 -Strict')
+    console.log('')
+    console.log('Per-task validation:')
+    console.log('  pwsh run-converge.ps1 -TaskId T-001')
+    console.log('')
+    console.log('Claude Code:')
+    console.log('  claude "/sdd-converge"')
+    break
+
+  case 'status': {
+    config.printStatus()
+    break
+  }
+
+  case 'help':
+  default:
+    if (cmd && cmd !== 'help') {
+      console.error(`Unknown command: ${cmd}\n`)
+    }
+    console.log(`
+sdd — Spec-Driven Development CLI
+
+Output Structure (v1.1.0+):
+  sdd/                    All generated artifacts
+    brief.md             Phase 0: BMAD brief
+    SPEC.md              Phase 2: Specification
+    tasks/              Phase 3: Task directories
+    converge/           Phase 5: Validation reports
+
+Usage:
+  sdd init               Initialize SDD pipeline
+  sdd bmad <desc>       Phase 0: Generate brief (fast mode)
+  sdd status             Show pipeline status
+  sdd help               Show this help
+
+Full Pipeline (requires Claude Code):
+  claude "/sdd-bmad"    Interactive 9-question interview (high confidence)
+  claude "/sdd-spec"    Generate SPEC.md
+  claude "/sdd-tasks"   Generate task directory
+  claude "/sdd-cook"    Execute implementation
+  claude "/sdd-converge"  Validate implementation
+
+Quick Start:
+  1. sdd init
+  2. sdd bmad "my feature idea"
+  3. claude "/sdd-spec"
+  4. claude "/sdd-tasks"
+  5. claude "/sdd-cook"
+  6. claude "/sdd-converge"
+
+Notes:
+- Claude Code CLI provides the best experience with interactive commands
+- Install Claude Code: npm install -g @anthropic-ai/claude-code
+- Without Claude Code, use "sdd bmad" for fast mode (lower confidence)
+`)
+}

package/lib/bmad/index.js

@@ -7,7 +7,7 @@
  * - 9-question interview framework
  * - 3-agent synthesis (single-pass LLM mode)
  * - Confidence scoring
- * - BMAD-brief.md output
+ * - Brief output to sdd/ directory
  */
 
 const fs = require('fs')
@@ -18,7 +18,9 @@ const problemFirst = require('./problem-first')
 const synthesis = require('./synthesis')
 const confidenceCalc = require('./confidence')
 
-const OUTPUT_FILE = 'BMAD-brief.md'
+// Output directory - can be overridden via environment
+const OUTPUT_BASE = process.env.SDD_OUTPUT_BASE || 'sdd'
+const OUTPUT_FILE = path.join(OUTPUT_BASE, 'brief.md')
 const TEMPLATE_DATE = new Date().toISOString().split('T')[0]
 const TEMPLATE_EXPIRY = new Date(Date.now() + 30 * 24 * 60 * 60 * 1000)
   .toISOString()
@@ -33,6 +35,15 @@ let state = {
   currentTier: 0,
 }
 
+/**
+ * Ensure output directory exists
+ */
+function ensureOutputDir() {
+  if (!fs.existsSync(OUTPUT_BASE)) {
+    fs.mkdirSync(OUTPUT_BASE, { recursive: true })
+  }
+}
+
 /**
  * Initialize a new BMAD interview session.
  * @param {string} rawInput - Raw user feature description
@@ -85,7 +96,7 @@ function canProceed() {
 }
 
 /**
- * Generate the BMAD-brief.md file.
+ * Generate the sdd/brief.md file.
  * @returns {{ filePath: string, confidence: object }}
  */
 function generateBrief() {
@@ -102,11 +113,16 @@ function generateBrief() {
 
   const fullContent = header + brief
 
+  // Ensure output directory exists
+  ensureOutputDir()
+
+  // Write to sdd/brief.md
   fs.writeFileSync(OUTPUT_FILE, fullContent, 'utf8')
 
   return {
     filePath: path.resolve(OUTPUT_FILE),
     confidence,
+    outputDir: OUTPUT_BASE,
   }
 }
 
@@ -137,4 +153,5 @@ module.exports = {
   getState,
   getQuestionsWithStatus,
   OUTPUT_FILE,
+  OUTPUT_BASE,
 }

package/lib/bundle/.claude/commands/sdd-check.md

@@ -0,0 +1,153 @@
+# SDD Inline Check — Real-time Spec Validation
+---
+tool: Bash
+when: always
+args: <file-path> --section <spec-section>
+description: Real-time inline validation. Check file(s) against SPEC.md clauses ([SC-xxx], [AC-xxx]). Catches missing text/colors/dimensions during implementation, not at end. Args: <file-path> [--section <spec-section>]
+---
+
+## SDD Check — Real-Time Inline Validation
+
+**Purpose:** Validate current file against SPEC.md during implementation. Get instant feedback.
+
+### Usage
+
+```bash
+# Check specific file against SPEC.md
+sdd check src/components/Button.tsx
+
+# Check with specific spec section
+sdd check src/components/Button.tsx --section 4.1.1
+
+# Check multiple files
+sdd check src/components/ src/utils/
+```
+
+---
+
+## What It Does
+
+### 1. Extract Spec Clauses
+Reads SPEC.md and extracts all `[SC-xxx]` clause IDs with their text.
+
+### 2. Search Implementation
+Searches the target file(s) for:
+- ✅ Exact text matches
+- ✅ Color hex values
+- ✅ Dimension values
+- ✅ Component patterns
+
+### 3. Inline Report
+
+```
+╔══════════════════════════════════════════════════════════╗
+║  SDD Check: src/components/Button.tsx                  ║
+╠══════════════════════════════════════════════════════════╣
+║  ✅ SC-001: "Start Free Trial" found at line 42         ║
+║  ✅ SC-COLOR-001: #22c55e found                        ║
+║  ❌ SC-002: "Get Started" NOT FOUND                    ║
+║     → Expected at: line 45                             ║
+║  ✅ AC-001: Loading state implemented                   ║
+╚══════════════════════════════════════════════════════════╝
+
+Result: 2/3 clauses verified | 1 ISSUE
+```
+
+---
+
+## Implementation
+
+```powershell
+# sdd-check.ps1
+param(
+    [Parameter(Mandatory=$true)]
+    [string]$FilePath,
+    
+    [string]$Section = "",
+    
+    [string]$SpecFile = "SPEC.md"
+)
+
+$ErrorActionPreference = "Continue"
+
+# Extract clauses from SPEC.md
+$specContent = Get-Content $SpecFile -Raw
+$clausePattern = '\[(SC-[A-Z0-9]+-[0-9]+|SC-[0-9]+)\]'
+$clauses = [regex]::Matches($specContent, $clausePattern) | ForEach-Object {
+    @{
+        Id = $_.Groups[1].Value
+        Text = (Get-ClauseContext -SpecFile $SpecFile -ClauseId $_.Groups[1].Value)
+    }
+}
+
+# Read implementation file
+$implContent = Get-Content $FilePath -Raw
+
+# Check each clause
+$passCount = 0
+$failCount = 0
+
+foreach ($clause in $clauses) {
+    $searchText = $clause.Text -replace '\[.*?\]', '' -replace '\(.*?\)', ''
+    
+    if ($implContent -match [regex]::Escape($searchText)) {
+        Write-Host "✅ $($clause.Id): FOUND" -ForegroundColor Green
+        $passCount++
+    } else {
+        Write-Host "❌ $($clause.Id): NOT FOUND" -ForegroundColor Red
+        Write-Host "   Expected: $searchText" -ForegroundColor Yellow
+        $failCount++
+    }
+}
+
+Write-Host ""
+Write-Host "Result: $passCount/$($clauses.Count) clauses verified" -ForegroundColor $(if ($failCount -eq 0) { "Green" } else { "Yellow" })
+```
+
+---
+
+## Example Workflow
+
+### Before Implementation
+```bash
+sdd check src/components/Button.tsx --section 4.1.1
+```
+→ Shows what clauses should be in the file
+
+### During Implementation
+```bash
+sdd check src/components/Button.tsx
+```
+→ Real-time feedback on what's missing
+
+### After Implementation
+```bash
+sdd converge --task T-001
+```
+→ Full converge report
+
+---
+
+## For Claude Code Agents
+
+Add to your implementation loop:
+
+```
+1. Read SPEC.md → identify relevant clauses
+2. Implement feature
+3. Run: sdd check [file]
+4. Fix any ❌ issues
+5. Run: sdd converge --task T-XXX
+6. Proceed to next task
+```
+
+---
+
+## Benefits
+
+| Benefit | Description |
+|---------|-------------|
+| Early Detection | Catch missing clauses before converge |
+| Faster Iterations | Don't wait until end to find issues |
+| Clear Direction | Know exactly what's missing |
+| Less Rework | Fix as you go, not all at once |