@the-bearded-bear/claude-craft 8.23.3 → 8.26.0-next.2a54921

package/Dev/i18n/en/QA/commands/regression.md

@@ -107,25 +107,25 @@ Golden Rule Check: 1 VIOLATION DETECTED
 
 ```bash
 # List all regression tests
-/qa:recette-regression --list
+/qa:regression --list
 
 # Show stability score
-/qa:recette-regression --stats
+/qa:regression --stats
 
 # Run regression check (detect Golden Rule violations)
-/qa:recette-regression --check
+/qa:regression --check
 
 # Filter by source story
-/qa:recette-regression --list --source=US-001
+/qa:regression --list --source=US-001
 
 # Filter by status
-/qa:recette-regression --list --status=active
+/qa:regression --list --status=active
 
 # Show historical trend
-/qa:recette-regression --stats --trend
+/qa:regression --stats --trend
 
 # Output as JSON
-/qa:recette-regression --list --format=json
+/qa:regression --list --format=json
 ```
 
 ## Output Structure
@@ -147,9 +147,9 @@ Golden Rule Check: 1 VIOLATION DETECTED
 | Command | Description |
 |---------|-------------|
 | `/qa:recette` | Execute acceptance tests |
-| `/qa:recette-fix` | Fix bugs from a recette session |
-| `/qa:recette-status` | Show session status |
-| `/qa:recette-report` | Generate report |
+| `/qa:fix` | Fix bugs from a recette session |
+| `/qa:status` | Show session status |
+| `/qa:status --report` | Generate report |
 
 ## Error Messages
 
@@ -157,7 +157,7 @@ Golden Rule Check: 1 VIOLATION DETECTED
 |-------|----------|
 | "Registry not found" | Run `/qa:recette` first to generate a registry |
 | "No regression tests" | No errors have been detected in previous runs |
-| "Golden Rule violation" | A bug has reappeared — run `/qa:recette-fix` to fix |
+| "Golden Rule violation" | A bug has reappeared — run `/qa:fix` to fix |
 | "History file missing" | Run at least 2 recette sessions for trend data |
 
 ## Best Practices

package/Dev/i18n/en/QA/commands/report.md

@@ -1,225 +1,9 @@
 ---
-description: Generate QA Recette reports from session data
-argument-hint: --session=<session-id> [--format=<md|html|json>] [--output=<path>]
+description: "Deprecated (removed in 9.0): use /qa:status --report"
+deprecated: true
+replaced-by: /qa:status
 ---
 
-# QA Recette Report - Report Generation
+> ⚠️ `/qa:report` is deprecated and will be removed in 9.0. Use `/qa:status --report`.
 
-Generate detailed reports from QA Recette session data. Supports multiple output formats and session comparison.
-
-## Arguments
-
-**$ARGUMENTS**
-
-- `--session=<id>`: Session ID to generate report from **[required]**
-- `--format=<type>`: Output format (md, html, json) — default: md
-- `--output=<path>`: Custom output path (default: `.recette/reports/`)
-- `--include-screenshots`: Embed screenshots in HTML report
-- `--compare=<id>`: Compare with another session for regression diff
-
-## Key Features
-
-| Feature | Description |
-|---------|-------------|
-| **Multi-Format** | Generate Markdown, HTML, or JSON reports |
-| **Session Comparison** | Compare two runs to detect regressions |
-| **Golden Rule Section** | Dedicated compliance section in reports |
-| **Screenshot Embedding** | Embed error screenshots in HTML reports |
-| **Test Traceability** | Full traceability from AC to test results |
-| **Metrics Summary** | Pass/fail rates, timing, error classification |
-
-## Process
-
-### 1. Data Collection
-
-```
-┌─────────────────────────────────────────┐
-│  1. load_session_data(session_id)       │
-│     - Read .recette/sessions/{id}/      │
-│     - Load state.yaml                   │
-│     - Load fix-state.yaml if present    │
-│     - Collect screenshots and logs      │
-│     - Load regression registry          │
-└─────────────────────────────────────────┘
-```
-
-### 2. Report Generation
-
-```
-┌─────────────────────────────────────────┐
-│  2. generate_report(format)             │
-│     - Build summary section             │
-│     - Build test results section        │
-│     - Build error details section       │
-│     - Build regression tests section    │
-│     - Build Golden Rule statement       │
-│     - Apply format template             │
-│     - Write to output path              │
-└─────────────────────────────────────────┘
-```
-
-### 3. Report Structure
-
-**Markdown Report:**
-
-```markdown
-# QA Recette Report — REC-20260130-143022
-
-## Summary
-
-| Metric | Value |
-|--------|-------|
-| Session | REC-20260130-143022 |
-| Scope | story → US-001 |
-| Date | 2026-01-30 14:30 – 14:45 |
-| Duration | 14m 48s |
-| Tests | 15 total |
-| Passed | 12 (80%) |
-| Failed | 2 (13%) |
-| Skipped | 1 (7%) |
-
-## Test Results
-
-### Passed Tests (12)
-- TC-001: User can access login page ✓
-- TC-002: Valid credentials login ✓
-...
-
-### Failed Tests (2)
-- TC-008: Login validation error display ✗
-  Error: ERR-001 — Validation message not visible
-- TC-012: API response timeout ✗
-  Error: ERR-002 — Timeout after 30s on /api/users
-
-## Error Details
-
-### ERR-001: Login validation not displayed
-- Type: visual
-- Severity: medium
-- Screenshot: screenshots/err-001.png
-- Root cause: CSS display:none not toggled
-
-### ERR-002: API timeout on /api/users
-- Type: api
-- Severity: critical
-- Logs: logs/err-002.log
-
-## Regression Tests Generated
-
-| ID | Error | Test Type | Path |
-|----|-------|-----------|------|
-| REG-001 | ERR-001 | behat | features/auth/login_validation.feature |
-| REG-002 | ERR-002 | functional | tests/Functional/Api/UsersTimeoutTest.php |
-
-## Golden Rule Compliance
-
-All detected errors have generated regression tests.
-Registry updated: .recette/regression/registry.yaml
-```
-
-### 4. Comparison Mode (--compare)
-
-When comparing two sessions:
-
-```
-## Comparison: REC-20260130-143022 vs REC-20260201-140000
-
-| Metric | Session 1 | Session 2 | Delta |
-|--------|-----------|-----------|-------|
-| Tests | 15 | 15 | = |
-| Passed | 12 | 14 | +2 |
-| Failed | 2 | 0 | -2 |
-| Duration | 14m 48s | 12m 15s | -2m 33s |
-
-### Resolved Errors
-- ERR-001: Login validation — FIXED
-- ERR-002: API timeout — FIXED
-
-### New Errors
-(none)
-
-### Regression Status
-No Golden Rule violations detected.
-```
-
-## Data Sources
-
-| Source | Path | Description |
-|--------|------|-------------|
-| Session state | `.recette/sessions/{id}/state.yaml` | Test results and progress |
-| Fix state | `.recette/sessions/{id}/fix-state.yaml` | Bug fix status |
-| Screenshots | `.recette/sessions/{id}/screenshots/` | Error screenshots |
-| Logs | `.recette/sessions/{id}/logs/` | Execution logs |
-| Registry | `.recette/regression/registry.yaml` | Regression test registry |
-| Template | `Tools/Recette/templates/report.md.template` | Report template |
-
-## Examples
-
-```bash
-# Generate Markdown report (default)
-/qa:recette-report --session=REC-20260130-143022
-
-# Generate HTML report with screenshots
-/qa:recette-report --session=REC-20260130-143022 --format=html --include-screenshots
-
-# Generate JSON report for CI integration
-/qa:recette-report --session=REC-20260130-143022 --format=json
-
-# Custom output path
-/qa:recette-report --session=REC-20260130-143022 --output=./reports/sprint-3/
-
-# Compare two sessions
-/qa:recette-report --session=REC-20260201-140000 --compare=REC-20260130-143022
-```
-
-## Output Structure
-
-```
-.recette/reports/
-├── REC-20260130-143022-report.md       # Markdown report
-├── REC-20260130-143022-report.html     # HTML report (if --format=html)
-├── REC-20260130-143022-report.json     # JSON report (if --format=json)
-└── REC-20260201-vs-20260130-diff.md    # Comparison report (if --compare)
-```
-
-## Related Commands
-
-| Command | Description |
-|---------|-------------|
-| `/qa:recette` | Execute acceptance tests |
-| `/qa:recette-fix` | Fix bugs from a recette session |
-| `/qa:recette-status` | Show session status |
-| `/qa:recette-regression` | View regression test registry |
-
-## Error Messages
-
-| Error | Solution |
-|-------|----------|
-| "Session not found" | Verify session ID in `.recette/sessions/` |
-| "No test results" | Session has no completed tests to report on |
-| "Template not found" | Verify `Tools/Recette/templates/` exists |
-| "Compare session not found" | Verify the comparison session ID |
-
-## Best Practices
-
-1. **Generate after each run**: Create a report immediately after recette execution
-2. **Use HTML for stakeholders**: HTML format with screenshots is best for sharing
-3. **Use JSON for CI**: Integrate JSON reports into your CI/CD pipeline
-4. **Compare runs**: Use --compare to track progress between iterations
-5. **Archive reports**: Keep reports in version control for audit trail
-
-## Next Step
-
-```
-╔══════════════════════════════════════════════════════════╗
-║                      NEXT STEP                           ║
-╠══════════════════════════════════════════════════════════╣
-║                                                          ║
-║  → /workflow:review                                      ║
-║    Prepare the sprint review                             ║
-║                                                          ║
-║  See also:                                               ║
-║  • /sprint:status — View sprint metrics                  ║
-║                                                          ║
-╚══════════════════════════════════════════════════════════╝
-```
+Run `/qa:status --report $ARGUMENTS`: read `.claude/commands/qa/status.md` and follow it with these arguments.

package/Dev/i18n/en/QA/commands/status.md

@@ -1,6 +1,6 @@
 ---
-description: "Show QA Recette session status and progress"
-argument-hint: "[--session=<id>|--all] [--scope=<story|sprint>] [--status=<running|completed|paused|failed>]"
+description: "Show QA Recette session status and progress, or generate reports (--report)"
+argument-hint: "[--session=<id>|--all] [--scope=<story|sprint>] [--status=<running|completed|paused|failed>] [--report] [--format=<md|html|json>] [--output=<path>] [--compare=<id>]"
 ---
 
 # QA Recette Status - Session Status and Progress
@@ -17,6 +17,11 @@ Display status and progress of QA Recette sessions. View individual session deta
 - `--status=<status>`: Filter by status (running, completed, paused, failed)
 - `--format=<type>`: Output format (table, yaml, json) — default: table
 - `--watch`: Live refresh mode (updates every 5 seconds)
+- `--report`: Report mode (former `/qa:status --report`): generate a report from a session; requires `--session=<id>`
+- `--format=<type>`: with `--report`: md, html, json (default: md)
+- `--output=<path>`: with `--report`: custom output path (default: `.recette/reports/`)
+- `--include-screenshots`: with `--report`: embed screenshots in the HTML report
+- `--compare=<id>`: with `--report`: compare with another session for a regression diff
 
 ## Key Features
 
@@ -87,6 +92,128 @@ Checkpoint:
   Resumable: false (completed)
 ```
 
+## Usage
+
+| Mode / flag | What it does | Replaces |
+|---|---|---|
+| `/qa:status --all` / `--session=<id>` | List sessions or show one session in detail | — |
+| `/qa:status --report --session=<id>` | Generate a Markdown/HTML/JSON report (`--format`, `--output`, `--include-screenshots`) | `/qa:status --report` |
+| `/qa:status --report --session=<id> --compare=<id>` | Compare two sessions to detect regressions | `/qa:status --report --compare` |
+
+## Report Mode (--report)
+
+Generate detailed reports from session data. Multi-format output (Markdown, HTML, JSON), Golden Rule compliance section, screenshot embedding, AC-to-test traceability and pass/fail metrics. Without `--format`, the report is Markdown.
+
+### Report Process
+
+```
+┌─────────────────────────────────────────┐
+│  1. load_session_data(session_id)       │
+│     - Read .recette/sessions/{id}/      │
+│     - Load state.yaml                   │
+│     - Load fix-state.yaml if present    │
+│     - Collect screenshots and logs      │
+│     - Load regression registry          │
+├─────────────────────────────────────────┤
+│  2. generate_report(format)             │
+│     - Build summary, test results,      │
+│       error details, regression tests   │
+│     - Build Golden Rule statement       │
+│     - Apply format template             │
+│     - Write to output path              │
+└─────────────────────────────────────────┘
+```
+
+### Report Structure
+
+```markdown
+# QA Recette Report — REC-20260130-143022
+
+## Summary
+| Metric | Value |
+|--------|-------|
+| Session | REC-20260130-143022 |
+| Scope | story → US-001 |
+| Duration | 14m 48s |
+| Passed / Failed / Skipped | 12 (80%) / 2 (13%) / 1 (7%) |
+
+## Test Results
+### Failed Tests (2)
+- TC-008: Login validation error display ✗ (ERR-001)
+
+## Error Details
+### ERR-001: Login validation not displayed
+- Type: visual · Severity: medium · Screenshot: screenshots/err-001.png
+
+## Regression Tests Generated
+| ID | Error | Test Type | Path |
+|----|-------|-----------|------|
+| REG-001 | ERR-001 | behat | features/auth/login_validation.feature |
+
+## Golden Rule Compliance
+All detected errors have generated regression tests.
+Registry updated: .recette/regression/registry.yaml
+```
+
+### Comparison (--compare)
+
+Compares two runs: metric deltas, resolved errors, new errors and Golden Rule violations.
+
+```
+## Comparison: REC-20260130-143022 vs REC-20260201-140000
+
+| Metric | Session 1 | Session 2 | Delta |
+|--------|-----------|-----------|-------|
+| Passed | 12 | 14 | +2 |
+| Failed | 2 | 0 | -2 |
+
+### Resolved Errors / New Errors / Regression Status
+```
+
+### Report data sources
+
+| Source | Path | Description |
+|---|---|---|
+| Registry | `.recette/regression/registry.yaml` | Regression test registry |
+| Template | `Tools/Recette/templates/report.md.template` | Report template |
+
+### Report errors
+
+| Error | Solution |
+|---|---|
+| "Template not found" | Verify `Tools/Recette/templates/` exists |
+| "Compare session not found" | Verify the comparison session ID |
+| "No test results" | Session has no completed tests to report on |
+
+### Report Examples
+
+```bash
+# Generate Markdown report (default)
+/qa:status --report --session=REC-20260130-143022
+
+# Generate HTML report with screenshots
+/qa:status --report --session=REC-20260130-143022 --format=html --include-screenshots
+
+# Generate JSON report for CI integration
+/qa:status --report --session=REC-20260130-143022 --format=json
+
+# Custom output path
+/qa:status --report --session=REC-20260130-143022 --output=./reports/sprint-3/
+
+# Compare two sessions
+/qa:status --report --session=REC-20260201-140000 --compare=REC-20260130-143022
+```
+
+### Report Output Structure
+
+```
+.recette/reports/
+├── REC-20260130-143022-report.md       # Markdown report
+├── REC-20260130-143022-report.html     # HTML report (if --format=html)
+├── REC-20260130-143022-report.json     # JSON report (if --format=json)
+└── REC-20260201-vs-20260130-diff.md    # Comparison report (if --compare)
+```
+
 ## Data Sources
 
 | Source | Path | Description |
@@ -100,25 +227,25 @@ Checkpoint:
 
 ```bash
 # List all sessions
-/qa:recette-status --all
+/qa:status --all
 
 # Show detailed status for a specific session
-/qa:recette-status --session=REC-20260130-143022
+/qa:status --session=REC-20260130-143022
 
 # Filter running sessions
-/qa:recette-status --all --status=running
+/qa:status --all --status=running
 
 # Filter by scope
-/qa:recette-status --all --scope=sprint
+/qa:status --all --scope=sprint
 
 # Live monitoring of a running session
-/qa:recette-status --session=REC-20260130-143022 --watch
+/qa:status --session=REC-20260130-143022 --watch
 
 # Output as YAML
-/qa:recette-status --session=REC-20260130-143022 --format=yaml
+/qa:status --session=REC-20260130-143022 --format=yaml
 
 # Output as JSON (for scripting)
-/qa:recette-status --all --format=json
+/qa:status --all --format=json
 ```
 
 ## Output Structure
@@ -142,9 +269,9 @@ Checkpoint:
 | Command | Description |
 |---------|-------------|
 | `/qa:recette` | Execute acceptance tests |
-| `/qa:recette-fix` | Fix bugs from a recette session |
-| `/qa:recette-regression` | View regression test registry |
-| `/qa:recette-report` | Generate report |
+| `/qa:fix` | Fix bugs from a recette session |
+| `/qa:regression` | View regression test registry |
+| `/qa:status --report` | Generate report (`--report`) |
 
 ## Error Messages
 
@@ -174,7 +301,7 @@ Checkpoint:
 ║    Fix identified bugs                                   ║
 ║                                                          ║
 ║  If session is complete:                                 ║
-║  → /qa:report                                            ║
+║  → /qa:status --report                                   ║
 ║    Generate the recette report                           ║
 ║                                                          ║
 ╚══════════════════════════════════════════════════════════╝

package/Dev/i18n/en/QA/commands/tdd.md

@@ -397,7 +397,7 @@ Fixes #XXX
 ║    Re-test after corrections                             ║
 ║                                                          ║
 ║  See also:                                               ║
-║  • /common:pre-commit-check — Validate before commit     ║
+║  • /gate:check commit — Validate before commit     ║
 ║                                                          ║
 ╚══════════════════════════════════════════════════════════╝
 ```