speccrew 0.6.68 → 0.7.0

package/.speccrew/skills/speccrew-deploy-build/workflow.agentflow.xml

@@ -0,0 +1,125 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<workflow id="deploy-build" status="pending" version="1.0" desc="Execute application build and verify artifacts">
+
+  <!-- ============================================================
+       Input Parameters Definition
+       ============================================================ -->
+  <block type="input" id="I1" desc="Workflow input parameters">
+    <field name="platform_id" required="true" type="string" desc="Platform identifier (e.g., backend-spring, frontend-react)"/>
+    <field name="build_cmd" required="true" type="string" desc="Build command from conventions-data/build (e.g., mvn package -DskipTests)"/>
+    <field name="project_root" required="true" type="string" desc="Absolute path to the project root directory"/>
+    <field name="iteration_path" required="true" type="string" desc="Current iteration directory path"/>
+  </block>
+
+  <!-- ============================================================
+       Global Constraints
+       ============================================================ -->
+  <block type="rule" id="R1" level="mandatory" desc="Build execution constraints">
+    <field name="text">All build commands come from input parameters - NO hard-coded commands</field>
+    <field name="text">Always verify expected artifacts exist after build</field>
+    <field name="text">Record and report build duration</field>
+    <field name="text">Capture and report relevant build output</field>
+  </block>
+
+  <!-- ============================================================
+       Main Processing Sequence
+       ============================================================ -->
+  <sequence id="S1" name="Build Application" status="pending" desc="Pre-check, execute build, verify output">
+
+    <!-- Step 1: Pre-build Check -->
+    <block type="task" id="B1" action="validate" desc="Verify project root exists">
+      <field name="check">directory_exists(${project_root})</field>
+      <field name="on_fail">STOP with Error Category: DEPENDENCY_MISSING</field>
+      <field name="output" var="project_root_valid"/>
+    </block>
+
+    <block type="task" id="B2" action="run-script" desc="Verify build tool is available">
+      <field name="command">detect build tool from "${build_cmd}" and run version check</field>
+      <field name="rules">
+        - mvn → Run `mvn --version`
+        - npm/pnpm/yarn → Run `{tool} --version`
+        - gradle → Run `gradle --version`
+        - go → Run `go version`
+      </field>
+      <field name="on_fail">STOP with Error Category: DEPENDENCY_MISSING</field>
+      <field name="output" var="tool_check_result"/>
+    </block>
+
+    <block type="task" id="B3" action="validate" desc="Check for build config files">
+      <field name="rules">
+        - Maven: pom.xml must exist in project_root
+        - Node.js: package.json must exist in project_root
+        - Gradle: build.gradle or build.gradle.kts must exist
+        - Go: go.mod must exist
+      </field>
+      <field name="on_fail">STOP with Error Category: VALIDATION_ERROR</field>
+      <field name="output" var="config_check_result"/>
+    </block>
+
+    <!-- Step 2: Execute Build -->
+    <block type="event" id="E1" action="log" level="info" desc="Record build start time">
+      <field name="message">Build starting for platform: ${platform_id}</field>
+      <field name="output" var="start_time"/>
+    </block>
+
+    <block type="task" id="B4" action="run-script" desc="Execute build command">
+      <field name="command">${build_cmd}</field>
+      <field name="working_directory">${project_root}</field>
+      <field name="capture_stdout">true</field>
+      <field name="capture_stderr">true</field>
+      <field name="output" var="build_result"/>
+    </block>
+
+    <block type="gateway" id="G1" mode="guard" desc="Check build exit code"
+           test="${build_result.exit_code} == 0"
+           fail-action="stop">
+      <field name="message">Build failed with exit code ${build_result.exit_code}. Error Category: BUILD_FAILURE</field>
+    </block>
+
+    <block type="event" id="E2" action="log" level="info" desc="Record build end time">
+      <field name="output" var="end_time"/>
+    </block>
+
+    <!-- Step 3: Verify Build Output -->
+    <block type="task" id="B5" action="analyze" desc="Detect expected artifacts by platform">
+      <field name="rules">
+        - Spring/Maven: target/*.jar files
+        - Node.js: dist/ or build/ directory
+        - Gradle: build/libs/*.jar
+        - Go: Binary executable in project root or bin/
+      </field>
+      <field name="output" var="artifact_patterns"/>
+    </block>
+
+    <block type="task" id="B6" action="search" desc="Find build artifacts">
+      <field name="patterns">${artifact_patterns}</field>
+      <field name="base_path">${project_root}</field>
+      <field name="output" var="artifacts"/>
+    </block>
+
+    <block type="gateway" id="G2" mode="guard" desc="Verify artifacts exist"
+           test="${artifacts.length} > 0"
+           fail-action="stop">
+      <field name="message">No build artifacts found. Error Category: BUILD_FAILURE</field>
+    </block>
+
+    <block type="event" id="E3" action="log" level="info" desc="Build completed successfully">
+      <field name="message">Build completed with ${artifacts.length} artifacts</field>
+    </block>
+
+  </sequence>
+
+  <!-- ============================================================
+       Output Results
+       ============================================================ -->
+  <block type="output" id="O1" desc="Workflow output results">
+    <field name="status" value="SUCCESS" type="string" desc="Build status"/>
+    <field name="platform_id" from="${platform_id}" type="string" desc="Platform identifier"/>
+    <field name="project_root" from="${project_root}" type="string" desc="Project root path"/>
+    <field name="build_duration" from="${end_time - start_time}" type="number" desc="Build duration in seconds"/>
+    <field name="build_command" from="${build_cmd}" type="string" desc="Build command executed"/>
+    <field name="artifact_paths" from="${artifacts}" type="array" desc="List of generated artifact paths"/>
+    <field name="artifact_count" from="${artifacts.length}" type="number" desc="Number of artifacts generated"/>
+  </block>
+
+</workflow>

package/.speccrew/skills/speccrew-deploy-migrate/SKILL.md

@@ -21,72 +21,11 @@ tools: Read, Bash, Glob
 | `project_root` | Yes | string | Absolute path to the project root directory |
 | `iteration_path` | Yes | string | Current iteration directory path |
 
-# Workflow
+## AgentFlow Definition
 
-## Step 1: Pre-migration Check
+<!-- @agentflow: workflow.agentflow.xml -->
 
-Verify prerequisites before executing migrations:
-
-1. **Verify migration script files exist**
-   - Parse `migration_scripts` JSON array
-   - For each script, verify file exists at specified `path`
-   - If any script missing → FAILED with Error Category: DEPENDENCY_MISSING
-
-2. **Verify migration tool is available**
-   - Detect tool from `migration_cmd` (e.g., `mvn`, `npm`, `npx`)
-   - Run tool version check
-   - If tool not available → FAILED with Error Category: DEPENDENCY_MISSING
-
-3. **Count total scripts to execute**
-   - Record total script count from `migration_scripts`
-   - Log: "Preparing to execute {count} migration scripts"
-
-## Step 2: Execute Migration
-
-Run the migration command:
-
-1. **Execute migration_cmd via Bash**
-   - Working directory: `project_root`
-   - Command: `migration_cmd`
-   - Capture stdout and stderr
-   - Record start time before execution
-
-2. **Check exit code**
-   - Exit code 0 → Continue to Step 3
-   - Exit code non-zero → FAILED with Error Category: BUILD_FAILURE
-
-## Step 3: Validate Migration (if validation_cmd provided)
-
-Run validation if command is provided:
-
-1. **Execute validation_cmd via Bash**
-   - Working directory: `project_root`
-   - Command: `validation_cmd`
-   - Capture output
-
-2. **Verify validation result**
-   - Exit code 0 → All migrations applied successfully
-   - Exit code non-zero → FAILED with Error Category: VALIDATION_ERROR
-
-3. **If validation fails**
-   - Report specific failure reason from output
-   - Include suggestion for manual intervention
-
-## Step 4: Report Migration Results
-
-Compile and report migration summary:
-
-1. **List scripts executed**
-   - Extract from migration output or use input `migration_scripts`
-
-2. **List tables affected**
-   - Parse `type` field from each script:
-     - CREATE TABLE → New table created
-     - ALTER TABLE → Table modified
-     - DROP TABLE → Table removed
-
-3. **Calculate execution duration**
-   - Duration = end_time - start_time
+> **REQUIRED**: Before executing this workflow, read the XML workflow specification: `speccrew-workspace/docs/rules/agentflow-spec.md`
 
 # Task Completion Report
 

package/.speccrew/skills/speccrew-deploy-migrate/workflow.agentflow.xml

@@ -0,0 +1,135 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<workflow id="deploy-migrate" status="pending" version="1.0" desc="Execute database migration and validate results">
+
+  <!-- ============================================================
+       Input Parameters Definition
+       ============================================================ -->
+  <block type="input" id="I1" desc="Workflow input parameters">
+    <field name="platform_id" required="true" type="string" desc="Platform identifier"/>
+    <field name="migration_cmd" required="true" type="string" desc="Migration execution command from conventions-data (e.g., mvn flyway:migrate)"/>
+    <field name="validation_cmd" required="false" type="string" desc="Migration validation command (e.g., mvn flyway:validate)"/>
+    <field name="migration_scripts" required="true" type="string" desc="JSON array of migration scripts: [{name, path, type}]"/>
+    <field name="project_root" required="true" type="string" desc="Absolute path to the project root directory"/>
+    <field name="iteration_path" required="true" type="string" desc="Current iteration directory path"/>
+  </block>
+
+  <!-- ============================================================
+       Global Constraints
+       ============================================================ -->
+  <block type="rule" id="R1" level="mandatory" desc="Migration execution constraints">
+    <field name="text">Always verify migration script files exist before execution</field>
+    <field name="text">Validation step is optional based on validation_cmd presence</field>
+    <field name="text">Parse migration_scripts JSON to extract script metadata</field>
+    <field name="text">Report tables affected by each migration script</field>
+    <field name="text">Record and report migration execution duration</field>
+  </block>
+
+  <!-- ============================================================
+       Main Processing Sequence
+       ============================================================ -->
+  <sequence id="S1" name="Database Migration" status="pending" desc="Pre-check, execute migration, validate results">
+
+    <!-- Step 1: Pre-migration Check -->
+    <block type="task" id="B1" action="analyze" desc="Parse migration scripts JSON">
+      <field name="input">${migration_scripts}</field>
+      <field name="parse_json">true</field>
+      <field name="output" var="scripts_list"/>
+    </block>
+
+    <block type="loop" id="L1" over="${scripts_list}" as="script" desc="Verify each migration script file exists">
+      <block type="task" action="validate" desc="Verify script file exists">
+        <field name="check">file_exists(${script.path})</field>
+        <field name="on_fail">STOP with Error Category: DEPENDENCY_MISSING</field>
+      </block>
+    </block>
+
+    <block type="task" id="B2" action="run-script" desc="Verify migration tool is available">
+      <field name="command">detect tool from "${migration_cmd}" (e.g., mvn, npm, npx) and run version check</field>
+      <field name="on_fail">STOP with Error Category: DEPENDENCY_MISSING</field>
+      <field name="output" var="tool_check_result"/>
+    </block>
+
+    <block type="event" id="E1" action="log" level="info" desc="Log script count">
+      <field name="message">Preparing to execute ${scripts_list.length} migration scripts</field>
+    </block>
+
+    <!-- Step 2: Execute Migration -->
+    <block type="event" id="E2" action="log" level="info" desc="Record migration start time">
+      <field name="output" var="start_time"/>
+    </block>
+
+    <block type="task" id="B3" action="run-script" desc="Execute migration command">
+      <field name="command">${migration_cmd}</field>
+      <field name="working_directory">${project_root}</field>
+      <field name="capture_stdout">true</field>
+      <field name="capture_stderr">true</field>
+      <field name="output" var="migration_result"/>
+    </block>
+
+    <block type="gateway" id="G1" mode="guard" desc="Check migration exit code"
+           test="${migration_result.exit_code} == 0"
+           fail-action="stop">
+      <field name="message">Migration failed with exit code ${migration_result.exit_code}. Error Category: BUILD_FAILURE</field>
+    </block>
+
+    <!-- Step 3: Validate Migration (if validation_cmd provided) -->
+    <block type="gateway" id="G2" mode="exclusive" desc="Check if validation is required">
+      <branch test="${validation_cmd} != null AND ${validation_cmd} != ''" name="Run Validation">
+        <block type="task" id="B4" action="run-script" desc="Execute validation command">
+          <field name="command">${validation_cmd}</field>
+          <field name="working_directory">${project_root}</field>
+          <field name="capture_output">true</field>
+          <field name="output" var="validation_result"/>
+        </block>
+
+        <block type="gateway" id="G3" mode="guard" desc="Check validation result"
+               test="${validation_result.exit_code} == 0"
+               fail-action="stop">
+          <field name="message">Migration validation failed. Error Category: VALIDATION_ERROR</field>
+        </block>
+
+        <block type="event" action="log" level="info" desc="Log validation passed">
+          <field name="message">Migration validation passed</field>
+          <field name="output" var="validation_status" value="PASSED"/>
+        </block>
+      </branch>
+      <branch default="true" name="Skip Validation">
+        <block type="event" action="log" level="info" desc="Log validation skipped">
+          <field name="message">No validation command provided, skipping validation</field>
+          <field name="output" var="validation_status" value="SKIPPED"/>
+        </block>
+      </branch>
+    </block>
+
+    <!-- Step 4: Report Migration Results -->
+    <block type="event" id="E3" action="log" level="info" desc="Record migration end time">
+      <field name="output" var="end_time"/>
+    </block>
+
+    <block type="task" id="B5" action="analyze" desc="Analyze tables affected">
+      <field name="rules">
+        - Parse `type` field from each script:
+          - CREATE TABLE → New table created
+          - ALTER TABLE → Table modified
+          - DROP TABLE → Table removed
+      </field>
+      <field name="output" var="tables_affected"/>
+    </block>
+
+  </sequence>
+
+  <!-- ============================================================
+       Output Results
+       ============================================================ -->
+  <block type="output" id="O1" desc="Workflow output results">
+    <field name="status" value="SUCCESS" type="string" desc="Migration status"/>
+    <field name="platform_id" from="${platform_id}" type="string" desc="Platform identifier"/>
+    <field name="project_root" from="${project_root}" type="string" desc="Project root path"/>
+    <field name="migration_command" from="${migration_cmd}" type="string" desc="Migration command executed"/>
+    <field name="scripts_executed" from="${scripts_list.length}" type="number" desc="Number of scripts executed"/>
+    <field name="tables_affected" from="${tables_affected}" type="object" desc="Tables affected by migration"/>
+    <field name="validation_status" from="${validation_status}" type="string" desc="Validation status"/>
+    <field name="execution_duration" from="${end_time - start_time}" type="number" desc="Execution duration in seconds"/>
+  </block>
+
+</workflow>

package/.speccrew/skills/speccrew-deploy-smoke-test/SKILL.md

@@ -24,163 +24,11 @@ tools: Read, Bash, Glob
 | `expected_log_patterns` | No | string | Comma-separated regex patterns expected in log for `log` mode (e.g., `"DB initialized,UI loaded"`) |
 | `process_name` | No | string | Process name or pattern to check (for `process` mode, e.g., `myapp.exe` or `MyApp`) |
 
-# Workflow
-
-### Test Strategy
-
-Based on `test_mode` parameter:
-
-**Mode: `http`** (default — for server/web applications)
-- Parse API Contract documents
-- curl each endpoint and verify HTTP status codes
-- Pass criteria: GET returns 200; POST/PUT/DELETE returns non-404
-
-**Mode: `process`** (for client/desktop applications)
-- Verify the application process is still running (not crashed)
-- If the app supports a CLI health check command, run it
-- Pass criteria: Process alive AND exit code matches `expected_exit_code` (if process has exited)
-- For GUI apps: Check process exists and has been running for at least 10 seconds without crash
-
-**Mode: `log`** (for log-based verification)
-- Read `log_file` content
-- Check for each pattern in `expected_log_patterns`
-- Pass criteria: ALL expected patterns found in log
-- Fail: Any pattern missing → report which patterns were not found
-- Example patterns for client with local DB:
-  - "Database migration completed" (DB initialized)
-  - "Application ready" (app started)
-  - "UI rendered" (UI loaded, for GUI apps)
-
-## Step 1: Parse API Contracts (HTTP Mode)
-
-Extract endpoints from API Contract documents:
-
-1. **Read each API Contract document**
-   - Split `api_contract_paths` by comma
-   - Read each document using Read tool
-
-2. **Extract endpoint list**
-   - Parse endpoints from contract:
-     - Method: GET, POST, PUT, DELETE, etc.
-     - Path: endpoint path (e.g., `/api/users`)
-     - Expected status code: from contract definition
-
-3. **Filter for core endpoints**
-   - Focus on core endpoints only
-   - For GET endpoints: test directly with full validation
-   - For POST/PUT/DELETE: only verify endpoint exists (expect 400/401/405 is acceptable, NOT 404)
-
-## Step 2: Execute Smoke Tests (HTTP Mode)
-
-Test each endpoint:
-
-1. **For each endpoint, execute curl command**
-   ```bash
-   curl -s -o /dev/null -w "%{http_code}" -X {METHOD} {base_url}{path}
-   ```
-
-2. **Record test results**
-   - Endpoint path
-   - HTTP method
-   - Expected status (or status range)
-   - Actual status code
-   - Pass/fail status
-
-3. **Handle connection errors**
-   - If curl fails to connect → mark as FAILED
-   - Report: "Cannot connect to {base_url}"
-
-## Step 2 (Alternative): Process Mode Verification
-
-For client/desktop applications:
-
-1. **Check process is still running**
-   - **Windows**:
-     ```powershell
-     tasklist /FI "IMAGENAME eq {process_name}" | findstr /I "{process_name}"
-     ```
-   - **Unix/Mac**:
-     ```bash
-     pgrep -f "{process_name}"
-     ```
-
-2. **Verify process stability**
-   - Record process start time
-   - Wait 10 seconds
-   - Check if process is still running (not crashed)
-   - If process has exited:
-     - Get exit code
-     - Compare with `expected_exit_code` (default: 0)
-
-3. **Record test results**
-   - Process name
-   - Status: RUNNING / EXITED
-   - Exit code (if exited)
-   - Uptime (if running)
-   - Pass/fail status
-
-## Step 2 (Alternative): Log Mode Verification
-
-For log-based smoke testing:
-
-1. **Read log file content**
-   - Use Read tool to read `log_file`
-   - If file not found → FAILED
-
-2. **Parse expected patterns**
-   - Split `expected_log_patterns` by comma
-   - Trim whitespace from each pattern
-
-3. **Check each pattern**
-   - For each pattern in expected patterns:
-     - **Windows**:
-       ```powershell
-       Select-String -Path "{log_file}" -Pattern "{pattern}"
-       ```
-     - **Unix/Mac**:
-       ```bash
-       grep -E "{pattern}" "{log_file}"
-       ```
-   - Record whether pattern was found
-
-4. **Record test results**
-   - Pattern name
-   - Found: YES/NO
-   - Pass/fail status
-
-5. **Report missing patterns**
-   - List all patterns not found
-   - Include context from log if available
-
-## Step 3: Evaluate Results
-
-Apply pass criteria:
-
-1. **GET endpoints**
-   - Pass: HTTP 200 or 301/302 (redirect)
-   - Fail: 404 or connection error
-
-2. **POST/PUT/DELETE endpoints**
-   - Pass: NOT 404 (any other status is acceptable for smoke test)
-   - Acceptable: 400 (bad request), 401 (unauthorized), 405 (method not allowed)
-   - Fail: 404 (not found)
-
-3. **Health endpoint**
-   - Pass: HTTP 200
-   - Fail: Any other status
-
-4. **Calculate pass rate**
-   - pass_rate = (passed_count / total_count) * 100
-
-## Step 4: Report Smoke Test Results
-
-Compile test results table:
+## AgentFlow Definition
 
-| Endpoint | Method | Expected | Actual | Status |
-|----------|--------|----------|--------|--------|
-| /api/users | GET | 200 | 200 | PASS |
-| /api/auth/login | POST | !404 | 401 | PASS |
-| /api/orders | GET | 200 | 404 | FAIL |
+<!-- @agentflow: workflow.agentflow.xml -->
+
+> **REQUIRED**: Before executing this workflow, read the XML workflow specification: `speccrew-workspace/docs/rules/agentflow-spec.md`
 
 # Task Completion Report