specweave 0.28.17 → 0.28.19

package/plugins/specweave/agents/pm/AGENT.md

@@ -615,6 +615,208 @@ With project-scoped stories:
 
 ---
 
+## 🌐 Multi-Project User Stories (v0.29.0+ - JIRA Boards/ADO Area Paths)
+
+**⚠️ CRITICAL: User Stories MUST Consider ALL Relevant Projects!**
+
+When working with enterprise setups where JIRA boards or ADO area paths map to SpecWeave projects, a single user story often spans MULTIPLE projects.
+
+### STEP 0C: Detect Multi-Project Mode (Board/Area Path Mapping)
+
+**YOU MUST CHECK THIS BEFORE WRITING ANY USER STORIES:**
+
+```bash
+# Check for JIRA board mapping
+cat .specweave/config.json | jq '.sync.profiles[].config.boardMapping'
+
+# Check for ADO area path mapping
+cat .specweave/config.json | jq '.sync.profiles[].config.areaPathMapping'
+
+# Check for 2-level spec structure
+ls -la .specweave/docs/internal/specs/JIRA-*/
+ls -la .specweave/docs/internal/specs/ADO-*/
+```
+
+**Decision Flow:**
+```
+Is boardMapping or areaPathMapping configured?
+  → YES → MUST use multi-project-aware user stories
+         Each US must list ALL affected projects with scope
+  → NO → Check for umbrella mode (see Step 0)
+         Use standard or project-scoped user stories
+```
+
+### Multi-Project User Story Format (v0.29.0+)
+
+**When board/area path mapping is detected, EVERY user story MUST:**
+
+1. List ALL projects it touches
+2. Define scope per project
+3. Identify cross-project dependencies
+
+**Example: OAuth Implementation Spanning 3 Projects**
+
+```markdown
+### US-001: OAuth Authentication (Priority: P0 - Critical)
+
+**Projects Involved**:
+| Project | Scope | Keywords |
+|---------|-------|----------|
+| BE (Backend Board) | OAuth API endpoints, token validation, session management | api, oauth, token, session |
+| FE (Frontend Board) | Login UI with OIDC, token storage, logout flow | ui, login, oidc, logout |
+| Shared | Common auth types, interfaces, JWT utilities | types, interfaces, jwt |
+
+**As a** user
+**I want** to log in using Google OAuth
+**So that** I can access the system without creating a new password
+
+**Cross-Project Dependencies**:
+- FE depends on Shared (auth types/interfaces)
+- BE depends on Shared (JWT utilities)
+- FE calls BE (OAuth callback API)
+
+**Acceptance Criteria**:
+
+**BE Project (Backend Board)**:
+- [ ] **AC-BE-US1-01**: POST /api/auth/oauth/google initiates OAuth flow
+  - Priority: P0
+  - Testable: Yes (integration test)
+- [ ] **AC-BE-US1-02**: GET /api/auth/oauth/callback processes OAuth response
+  - Priority: P0
+  - Testable: Yes (integration test)
+- [ ] **AC-BE-US1-03**: JWT tokens generated with 1-hour expiry
+  - Priority: P0
+  - Testable: Yes (unit test)
+
+**FE Project (Frontend Board)**:
+- [ ] **AC-FE-US1-01**: "Sign in with Google" button visible on login page
+  - Priority: P0
+  - Testable: Yes (E2E test)
+- [ ] **AC-FE-US1-02**: OAuth redirect handled correctly
+  - Priority: P0
+  - Testable: Yes (E2E test)
+- [ ] **AC-FE-US1-03**: Token stored securely in HTTP-only cookie
+  - Priority: P0
+  - Testable: Yes (security test)
+
+**Shared Project**:
+- [ ] **AC-SHARED-US1-01**: AuthUser interface defined with OAuth fields
+  - Priority: P0
+  - Testable: Yes (type check)
+- [ ] **AC-SHARED-US1-02**: JWT decode utility function
+  - Priority: P0
+  - Testable: Yes (unit test)
+```
+
+### spec.md Frontmatter for Multi-Project US
+
+```yaml
+---
+increment: 0001-oauth-implementation
+feature_id: FS-001
+status: active
+
+# Single project (legacy - backward compatible)
+# project: BE
+
+# Multi-project user story (v0.29.0+)
+projects:
+  - id: BE
+    scope: "OAuth API endpoints, token validation, session management"
+    keywords: ["api", "oauth", "token", "session"]
+    effort_percentage: 50
+  - id: FE
+    scope: "Login UI with OIDC, token storage, logout flow"
+    keywords: ["ui", "login", "oidc", "logout"]
+    effort_percentage: 35
+  - id: Shared
+    scope: "Common auth types, interfaces, JWT utilities"
+    keywords: ["types", "interfaces", "jwt"]
+    effort_percentage: 15
+
+cross_dependencies:
+  - from: FE
+    to: Shared
+    reason: "FE uses auth types from Shared"
+  - from: BE
+    to: Shared
+    reason: "BE uses JWT utilities from Shared"
+  - from: FE
+    to: BE
+    reason: "FE calls OAuth callback API"
+
+sync_strategy: linked  # 'linked' | 'primary-only' | 'all'
+primary_project: BE    # Which project owns the main issue
+---
+```
+
+### Sync Behavior for Multi-Project US
+
+**sync_strategy options**:
+
+| Strategy | Behavior |
+|----------|----------|
+| `linked` | Create main issue in primary_project, linked child issues in others |
+| `primary-only` | Only create issue in primary_project |
+| `all` | Create full issues in all projects (may cause duplication) |
+
+**Example: `linked` strategy with JIRA boards**:
+```
+JIRA Project: CORE
+
+Backend Board (BE project):
+  → CORE-123: [Epic] OAuth Authentication (parent)
+    → CORE-124: OAuth API endpoints
+    → CORE-125: Token validation
+
+Frontend Board (FE project):
+  → CORE-130: OAuth Login UI (linked to CORE-123)
+    → CORE-131: Google sign-in button
+    → CORE-132: Token storage
+
+Both boards can track progress, but CORE-123 is the parent epic.
+```
+
+### Why Multi-Project Awareness Matters
+
+**Without multi-project awareness**:
+- ❌ US created in ONE board/area only (wrong!)
+- ❌ Cross-team dependencies unclear
+- ❌ Frontend dev doesn't know backend is a blocker
+- ❌ Shared changes not communicated to dependent teams
+- ❌ Progress tracking incomplete
+
+**With multi-project awareness**:
+- ✅ Each board/area gets relevant ACs
+- ✅ Clear cross-project dependencies
+- ✅ All teams know their scope
+- ✅ Linked issues enable coordination
+- ✅ Progress tracked across all projects
+
+### PM Agent Workflow for Multi-Project US
+
+1. **Detect** board/area path mapping in config.json
+2. **Analyze** user story for multi-project scope
+3. **Ask** user: "This feature spans BE, FE, and Shared. Should I create linked issues?"
+4. **Generate** spec.md with `projects` array in frontmatter
+5. **Create** ACs grouped by project (AC-BE-*, AC-FE-*, AC-SHARED-*)
+6. **Document** cross-project dependencies
+7. **Sync** to external tool based on sync_strategy
+
+### Validation Checklist for Multi-Project US
+
+Before finalizing any user story:
+
+- [ ] Analyzed scope across ALL configured projects (BE, FE, Shared, etc.)
+- [ ] `projects` array in frontmatter lists all affected projects
+- [ ] Each project has defined scope and keywords
+- [ ] ACs are grouped by project with correct prefixes
+- [ ] Cross-project dependencies documented
+- [ ] sync_strategy explicitly chosen
+- [ ] primary_project designated for linked strategy
+
+---
+
 **Role**: Product Manager specialized in product strategy, requirements gathering, and feature prioritization.
 
 ## Purpose

package/plugins/specweave/commands/specweave-import-external.md

@@ -1,11 +1,13 @@
 ---
 name: specweave:import-external
-description: Manually pull external work items from GitHub, JIRA, or Azure DevOps into living docs. Supports time range filtering, platform selection, and dry-run mode for ongoing imports after initial setup.
+description: Pull external work items from GitHub, JIRA, or Azure DevOps into living docs as READ-ONLY REFERENCES (not increments). To implement imported items, manually create an increment. Supports time range filtering and dry-run mode.
 ---
 
-# Import External Work Items
+# Import External Work Items (Reference Import)
 
-Import work items from GitHub (issues/milestones), JIRA (epics/stories), or Azure DevOps (work items) into SpecWeave living docs.
+Import work items from GitHub (issues/milestones), JIRA (epics/stories), or Azure DevOps (work items) into SpecWeave living docs **as read-only references**.
+
+> **Important**: This command creates a **reference catalog**, NOT increments. Imported items have E-suffix IDs (US-001E, FS-042E). To implement an imported item, you must **manually create an increment** that references it.
 
 ## What This Does
 

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/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":"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"}

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