specweave 0.28.15 → 0.28.19

package/plugins/specweave/commands/specweave-sync-docs.md

@@ -1,11 +1,15 @@
 ---
 name: specweave:sync-docs
-description: Bidirectional documentation sync - review strategic docs before implementation OR update living docs from completed increments with conflict resolution
+description: Strategic documentation sync - review docs before implementation (pull context) OR export learnings after implementation (push to living docs). NOT bidirectional - two separate one-way operations at different phases.
 ---
 
 # Sync Documentation
 
-You are executing the SpecWeave documentation sync command. This handles bidirectional documentation synchronization between increments and living docs.
+You are executing the SpecWeave strategic documentation sync command. This handles phase-based documentation synchronization:
+- **Review mode**: Pull strategic docs for pre-implementation context
+- **Update mode**: Push implementation learnings to living docs
+
+**Note**: This is NOT bidirectional sync (simultaneous two-way). It's two separate one-way operations at different project phases.
 
 ---
 

package/plugins/specweave/commands/specweave-validate.md

@@ -232,16 +232,17 @@ Choice: _
 
 ### Step 4: Run AI Quality Assessment (If Approved)
 
-**IMPORTANT**: Invoke `increment-quality-judge-v2` **agent** (not skill) via Task tool:
+**IMPORTANT**: Use the `increment-quality-judge-v2` **skill** (auto-activated) or CLI command:
 
-```typescript
-Task({
-  subagent_type: "specweave:increment-quality-judge-v2:increment-quality-judge-v2",
-  prompt: `Assess quality of increment ${incrementId}`
-});
+```bash
+# Preferred: Use CLI command directly
+specweave qa 0001 --pre
+
+# The skill auto-activates when assessing quality
+# DO NOT spawn agents - use CLI instead
 ```
 
-Pass these parameters:
+Assessment parameters:
 - increment_id: "0001"
 - files: ["spec.md", "plan.md", "tests.md"]
 - dimensions: ["clarity", "testability", "completeness", "feasibility", "maintainability", "edge_cases"]

package/plugins/specweave/hooks/pre-task-completion.sh

@@ -38,20 +38,31 @@ if [[ "${SPECWEAVE_DISABLE_HOOKS:-0}" == "1" ]]; then
   exit 0
 fi
 
-# Find project root
-find_project_root() {
-  local dir="$1"
-  while [ "$dir" != "/" ]; do
-    if [ -d "$dir/.specweave" ]; then
-      echo "$dir"
-      return 0
-    fi
-    dir="$(dirname "$dir")"
-  done
-  pwd
-}
+# Capture stdin FIRST to extract cwd from Claude's JSON input
+_EARLY_STDIN=$(mktemp)
+cat > "$_EARLY_STDIN"
+
+# Extract cwd from JSON (Claude always provides this)
+if command -v jq >/dev/null 2>&1; then
+  PROJECT_ROOT=$(jq -r '.cwd // empty' "$_EARLY_STDIN" 2>/dev/null)
+fi
+
+# Fallback: find project root by walking up from script location
+if [ -z "$PROJECT_ROOT" ] || [ ! -d "$PROJECT_ROOT/.specweave" ]; then
+  find_project_root() {
+    local dir="$1"
+    while [ "$dir" != "/" ]; do
+      if [ -d "$dir/.specweave" ]; then
+        echo "$dir"
+        return 0
+      fi
+      dir="$(dirname "$dir")"
+    done
+    pwd
+  }
+  PROJECT_ROOT="$(find_project_root "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")"
+fi
 
-PROJECT_ROOT="$(find_project_root "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")"
 cd "$PROJECT_ROOT" 2>/dev/null || true
 
 # ============================================================================
@@ -129,8 +140,8 @@ echo "[$(date)] 🔒 Pre-task-completion hook fired" >> "$DEBUG_LOG" 2>/dev/null
 # CAPTURE INPUT
 # ============================================================================
 
-STDIN_DATA=$(mktemp)
-cat > "$STDIN_DATA"
+# Reuse the early stdin capture
+STDIN_DATA="$_EARLY_STDIN"
 
 echo "[$(date)] Input JSON:" >> "$DEBUG_LOG" 2>/dev/null || true
 cat "$STDIN_DATA" >> "$DEBUG_LOG" 2>/dev/null || true
@@ -201,13 +212,20 @@ fi
 echo "[$(date)] 🧪 Running AC test validation for $CURRENT_INCREMENT" >> "$DEBUG_LOG" 2>/dev/null || true
 
 # Determine which validation script to use
+# Priority order:
+# 1. SpecWeave development (dist/src/core/) - for contributors
+# 2. npm package installation (node_modules/specweave/dist/)
+# 3. Marketplace plugin (lib/vendor/core/) - for end users
 VALIDATOR_SCRIPT=""
 if [ -f "$PROJECT_ROOT/dist/src/core/ac-test-validator-cli.js" ]; then
+  # SpecWeave development repo
   VALIDATOR_SCRIPT="$PROJECT_ROOT/dist/src/core/ac-test-validator-cli.js"
 elif [ -f "$PROJECT_ROOT/node_modules/specweave/dist/src/core/ac-test-validator-cli.js" ]; then
+  # npm package installation
   VALIDATOR_SCRIPT="$PROJECT_ROOT/node_modules/specweave/dist/src/core/ac-test-validator-cli.js"
-elif [ -n "${CLAUDE_PLUGIN_ROOT}" ] && [ -f "${CLAUDE_PLUGIN_ROOT}/dist/src/core/ac-test-validator-cli.js" ]; then
-  VALIDATOR_SCRIPT="${CLAUDE_PLUGIN_ROOT}/dist/src/core/ac-test-validator-cli.js"
+elif [ -n "${CLAUDE_PLUGIN_ROOT}" ] && [ -f "${CLAUDE_PLUGIN_ROOT}/lib/vendor/core/ac-test-validator-cli.js" ]; then
+  # Marketplace plugin (bundled in lib/vendor/)
+  VALIDATOR_SCRIPT="${CLAUDE_PLUGIN_ROOT}/lib/vendor/core/ac-test-validator-cli.js"
 fi
 
 if [ -z "$VALIDATOR_SCRIPT" ] || ! command -v node &> /dev/null; then

package/plugins/specweave/lib/vendor/core/ac-test-validator-cli.d.ts

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+/**
+ * AC Test Validator CLI
+ *
+ * Command-line interface for validating Acceptance Criteria tests before task completion.
+ *
+ * Usage:
+ *   node ac-test-validator-cli.js <increment-id>
+ *
+ * Exit codes:
+ *   0 - All AC tests passed
+ *   1 - Validation failed (tests failed or missing)
+ *   2 - Configuration error (missing files, invalid setup)
+ */
+export {};
+//# sourceMappingURL=ac-test-validator-cli.d.ts.map

package/plugins/specweave/lib/vendor/core/ac-test-validator-cli.js

@@ -0,0 +1,121 @@
+#!/usr/bin/env node
+/**
+ * AC Test Validator CLI
+ *
+ * Command-line interface for validating Acceptance Criteria tests before task completion.
+ *
+ * Usage:
+ *   node ac-test-validator-cli.js <increment-id>
+ *
+ * Exit codes:
+ *   0 - All AC tests passed
+ *   1 - Validation failed (tests failed or missing)
+ *   2 - Configuration error (missing files, invalid setup)
+ */
+import path from 'path';
+import * as fs from '../utils/fs-native.js';
+import { createACTestValidator } from './ac-test-validator.js';
+import { parseTasksWithUSLinks, getAllTasks } from '../generators/spec/task-parser.js';
+import chalkFallback, { getChalk } from '../utils/chalk-fallback.js';
+// Use chalk if available, otherwise fallback to ANSI codes
+let chalk = chalkFallback;
+getChalk().then(c => { chalk = c; }).catch(() => { });
+async function main() {
+    // Parse arguments
+    const incrementId = process.argv[2];
+    if (!incrementId) {
+        console.error(chalk.red('Error: Missing increment ID'));
+        console.error(chalk.gray('Usage: node ac-test-validator-cli.js <increment-id>'));
+        process.exit(2);
+    }
+    // Find project root
+    const projectRoot = process.cwd();
+    // Validate increment exists
+    const incrementPath = path.join(projectRoot, '.specweave/increments', incrementId);
+    if (!await fs.pathExists(incrementPath)) {
+        console.error(chalk.red(`Error: Increment not found: ${incrementId}`));
+        process.exit(2);
+    }
+    const tasksPath = path.join(incrementPath, 'tasks.md');
+    if (!await fs.pathExists(tasksPath)) {
+        console.error(chalk.red(`Error: tasks.md not found in ${incrementId}`));
+        process.exit(2);
+    }
+    try {
+        // Parse tasks
+        console.log(chalk.blue('\n[AC Test Validator]') + ' Parsing tasks...');
+        const tasksByUS = parseTasksWithUSLinks(tasksPath);
+        const tasks = getAllTasks(tasksByUS);
+        // Filter tasks being marked complete (looking for recently modified tasks)
+        // For now, validate ALL tasks with ACs
+        const tasksToValidate = tasks.filter(t => {
+            return t.satisfiesACs && t.satisfiesACs.length > 0 && t.status === 'completed';
+        });
+        if (tasksToValidate.length === 0) {
+            console.log(chalk.yellow('No completed tasks with Acceptance Criteria to validate.'));
+            process.exit(0);
+        }
+        console.log(chalk.blue(`Found ${tasksToValidate.length} completed task(s) with ACs to validate\n`));
+        // Create validator
+        const validator = await createACTestValidator(projectRoot);
+        // Validate each task
+        const results = [];
+        let allPassed = true;
+        for (const task of tasksToValidate) {
+            console.log(chalk.bold(`\nValidating ${task.id}: ${task.title}`));
+            const result = await validator.validateTask(task, projectRoot);
+            results.push(result);
+            // Display formatted result
+            console.log(validator.formatResult(result));
+            if (!result.passed) {
+                allPassed = false;
+            }
+        }
+        // Overall summary
+        console.log(chalk.bold('\n' + '='.repeat(60)));
+        console.log(chalk.bold('OVERALL VALIDATION SUMMARY'));
+        console.log('='.repeat(60));
+        const totalTasks = results.length;
+        const passedTasks = results.filter(r => r.passed).length;
+        const failedTasks = totalTasks - passedTasks;
+        console.log(`Tasks Validated: ${totalTasks}`);
+        console.log(`Passed: ${chalk.green(passedTasks)}`);
+        console.log(`Failed: ${chalk.red(failedTasks)}`);
+        const totalACs = results.reduce((sum, r) => sum + r.summary.totalACs, 0);
+        const acsPassed = results.reduce((sum, r) => sum + r.summary.acsTested, 0);
+        const acsFailed = totalACs - acsPassed;
+        console.log(`\nTotal ACs: ${totalACs}`);
+        console.log(`ACs with Passing Tests: ${chalk.green(acsPassed)}`);
+        console.log(`ACs with Failing Tests: ${chalk.red(acsFailed)}`);
+        console.log('='.repeat(60));
+        if (allPassed) {
+            console.log(chalk.green.bold('\n✓ ALL VALIDATIONS PASSED\n'));
+            console.log(chalk.green('All Acceptance Criteria have passing tests.'));
+            console.log(chalk.green('Task completion allowed.\n'));
+            process.exit(0);
+        }
+        else {
+            console.log(chalk.red.bold('\n✗ VALIDATION FAILED\n'));
+            console.log(chalk.red('Some Acceptance Criteria have failing or missing tests.'));
+            console.log(chalk.red('Task completion blocked until all tests pass.\n'));
+            console.log(chalk.yellow('Fix the failing tests and try again.'));
+            console.log(chalk.gray('Run tests manually: npm test\n'));
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        console.error(chalk.red('\nValidation Error:'));
+        console.error(chalk.red(error.message));
+        if (error.stack) {
+            console.error(chalk.gray('\nStack trace:'));
+            console.error(chalk.gray(error.stack));
+        }
+        process.exit(2);
+    }
+}
+// Run CLI
+main().catch(error => {
+    console.error(chalk.red('Fatal error:'), error);
+    process.exit(2);
+});
+//# sourceMappingURL=ac-test-validator-cli.js.map

package/plugins/specweave/lib/vendor/core/ac-test-validator-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ac-test-validator-cli.js","sourceRoot":"","sources":["../../../src/core/ac-test-validator-cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;GAYG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAA0B,MAAM,wBAAwB,CAAC;AACvF,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AACvF,OAAO,aAAa,EAAE,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAErE,2DAA2D;AAC3D,IAAI,KAAK,GAAG,aAAa,CAAC;AAC1B,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AAErD,KAAK,UAAU,IAAI;IACjB,kBAAkB;IAClB,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAEpC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC,CAAC;QACxD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC,CAAC;QACjF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,oBAAoB;IACpB,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAElC,4BAA4B;IAC5B,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,uBAAuB,EAAE,WAAW,CAAC,CAAC;IACnF,IAAI,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACxC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,+BAA+B,WAAW,EAAE,CAAC,CAAC,CAAC;QACvE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IACvD,IAAI,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACpC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,gCAAgC,WAAW,EAAE,CAAC,CAAC,CAAC;QACxE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC;QACH,cAAc;QACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,GAAG,mBAAmB,CAAC,CAAC;QACvE,MAAM,SAAS,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;QACnD,MAAM,KAAK,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;QAErC,2EAA2E;QAC3E,uCAAuC;QACvC,MAAM,eAAe,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;YACvC,OAAO,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC;QACjF,CAAC,CAAC,CAAC;QAEH,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,0DAA0D,CAAC,CAAC,CAAC;YACtF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,eAAe,CAAC,MAAM,2CAA2C,CAAC,CAAC,CAAC;QAEpG,mBAAmB;QACnB,MAAM,SAAS,GAAG,MAAM,qBAAqB,CAAC,WAAW,CAAC,CAAC;QAE3D,qBAAqB;QACrB,MAAM,OAAO,GAA6B,EAAE,CAAC;QAC7C,IAAI,SAAS,GAAG,IAAI,CAAC;QAErB,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAElE,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YAC/D,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAErB,2BAA2B;YAC3B,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;YAE5C,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBACnB,SAAS,GAAG,KAAK,CAAC;YACpB,CAAC;QACH,CAAC;QAED,kBAAkB;QAClB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC,CAAC;QACtD,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAE5B,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;QAClC,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;QACzD,MAAM,WAAW,GAAG,UAAU,GAAG,WAAW,CAAC;QAE7C,OAAO,CAAC,GAAG,CAAC,oBAAoB,UAAU,EAAE,CAAC,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAEjD,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QACzE,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QAC3E,MAAM,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;QAEvC,OAAO,CAAC,GAAG,CAAC,gBAAgB,QAAQ,EAAE,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,2BAA2B,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACjE,OAAO,CAAC,GAAG,CAAC,2BAA2B,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAE/D,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAE5B,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC,CAAC;YAC9D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC,CAAC;YACxE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC,CAAC;YACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,CAAC;YACvD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,yDAAyD,CAAC,CAAC,CAAC;YAClF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC,CAAC;YAC1E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,sCAAsC,CAAC,CAAC,CAAC;YAClE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC,CAAC;YAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IAEH,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,CAAC;QAChD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAExC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;YAC5C,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QACzC,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,UAAU;AACV,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,KAAK,CAAC,CAAC;IAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/plugins/specweave/lib/vendor/core/ac-test-validator.d.ts

@@ -0,0 +1,111 @@
+/**
+ * AC Test Validator
+ *
+ * Validates that all Acceptance Criteria linked to a task have passing tests
+ * before allowing the task to be marked complete.
+ *
+ * **CRITICAL QUALITY GATE**: This is the enforcement point that prevents
+ * tasks from being marked complete without validated ACs.
+ *
+ * Workflow:
+ * 1. Task completion requested via TodoWrite
+ * 2. Validator extracts task's satisfiesACs field
+ * 3. Validator finds corresponding test files from Test Plan section
+ * 4. Validator runs tests using configured test runner (vitest/jest)
+ * 5. If ALL tests pass → Allow completion, auto-check ACs in spec.md
+ * 6. If ANY test fails → Block completion, show detailed error
+ */
+import { Task } from '../generators/spec/task-parser.js';
+/**
+ * Test validation result
+ */
+export interface ACTestValidationResult {
+    /** Whether all tests passed */
+    passed: boolean;
+    /** Task ID being validated */
+    taskId: string;
+    /** AC-IDs this task satisfies */
+    acIds: string[];
+    /** Test results by AC-ID */
+    testResults: Map<string, ACTestResult>;
+    /** Overall summary */
+    summary: {
+        totalACs: number;
+        acsTested: number;
+        acsUntested: number;
+        testsPassed: number;
+        testsFailed: number;
+    };
+    /** Detailed error messages (if validation failed) */
+    errors: string[];
+}
+/**
+ * Test result for a single AC
+ */
+export interface ACTestResult {
+    acId: string;
+    testFile?: string;
+    testCases: string[];
+    passed: boolean;
+    duration: number;
+    error?: string;
+}
+/**
+ * Test runner configuration
+ */
+export interface TestRunnerConfig {
+    /** Test runner command (e.g., "npm test", "vitest run") */
+    command: string;
+    /** Test file pattern (glob pattern for test files) */
+    pattern: string;
+    /** Working directory for test execution */
+    cwd: string;
+    /** Environment variables for test execution */
+    env?: Record<string, string>;
+    /** Timeout in milliseconds (default: 30000) */
+    timeout?: number;
+}
+/**
+ * AC Test Validator - Core validation engine
+ */
+export declare class ACTestValidator {
+    private config;
+    constructor(config: TestRunnerConfig);
+    /**
+     * Validate all ACs for a task have passing tests
+     *
+     * @param task - Task to validate (must have satisfiesACs field)
+     * @param projectRoot - Project root directory
+     * @returns Validation result
+     */
+    validateTask(task: Task, projectRoot: string): Promise<ACTestValidationResult>;
+    /**
+     * Validate a single AC has passing tests
+     */
+    private validateAC;
+    /**
+     * Build test command with AC-ID filter
+     */
+    private buildTestCommand;
+    /**
+     * Extract test case names from test output
+     */
+    private extractTestCases;
+    /**
+     * Extract failure message from test output
+     */
+    private extractFailureMessage;
+    /**
+     * Extract test file path from task description (Test Plan section)
+     */
+    private extractTestFile;
+    /**
+     * Format validation result for display
+     */
+    formatResult(result: ACTestValidationResult): string;
+}
+/**
+ * Create AC test validator from project config
+ */
+export declare function createACTestValidator(projectRoot: string): Promise<ACTestValidator>;
+//# sourceMappingURL=ac-test-validator.d.ts.map