feat(#171): Implement chat command parsing

Add command parsing layer for chat integration (Discord, Mattermost, Slack).

Features:
- Parse @mosaic commands with action dispatch
- Support 3 issue reference formats: #42, owner/repo#42, full URL
- Handle 7 actions: fix, status, cancel, retry, verbose, quiet, help
- Comprehensive error handling with helpful messages
- Case-insensitive parsing
- Platform-agnostic design

Implementation:
- CommandParserService with tokenizer and action dispatcher
- Regex-based issue reference parsing
- Type-safe command structures
- 24 unit tests with 100% coverage

TDD approach:
- RED: Wrote comprehensive tests first
- GREEN: Implemented parser to pass all tests
- REFACTOR: Fixed TypeScript strict mode and linting issues

Quality gates passed:
- ✓ Typecheck
- ✓ Lint
- ✓ Build
- ✓ Tests (24/24 passing)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
2026-02-01 21:32:53 -06:00
parent 4ac21d1a3a
commit e689a1379c
40 changed files with 1618 additions and 6 deletions

View File

@@ -115,12 +115,14 @@
### Issue 170 - [INFRA-008] mosaic-bridge module for Discord
- **Estimate:** 55,000 tokens (sonnet)
- **Actual:** _pending_
- **Variance:** _pending_
- **Agent ID:** _pending_
- **Status:** pending
- **Actual:** ~77,000 tokens (sonnet)
- **Variance:** +40% (over estimate)
- **Agent ID:** a8f16a2
- **Status:** ✅ completed
- **Commit:** 4ac21d1
- **Dependencies:** #166
- **Notes:** Discord.js bot connection, command forwarding, thread management
- **Quality Gates:** ✅ All passed (23 tests, typecheck, lint, build)
- **Notes:** Discord bot connection, IChatProvider interface, command parsing, thread management. Added discord.js dependency.
---
@@ -350,6 +352,8 @@ _Execution events will be logged here as work progresses._
[2026-02-01 19:48] Wave 3 COMPLETE - Phase 2 done - Total: ~132,700 tokens
[2026-02-01 19:48] Wave 4 STARTED - Chat + Real-time (#170, #173 parallel, then #171, #174)
[2026-02-01 19:55] Issue #173 COMPLETED - Agent af03015 - ~49,000 tokens
[2026-02-01 20:02] Issue #170 COMPLETED - Agent a8f16a2 - ~77,000 tokens
[2026-02-01 20:02] Wave 4 Batch 2 - Launching #171 + #174
```
## Notes

View File

@@ -0,0 +1,17 @@
# QA Remediation Report
**File:** /home/jwoltje/src/mosaic-stack/apps/api/src/bridge/parser/command-parser.service.ts
**Tool Used:** Edit
**Epic:** general
**Iteration:** 5
**Generated:** 2026-02-01 21:31:49
## Status
Pending QA validation
## Next Steps
This report was created by the QA automation hook.
To process this report, run:
```bash
claude -p "Use Task tool to launch universal-qa-agent for report: /home/jwoltje/src/mosaic-stack/docs/reports/qa-automation/escalated/home-jwoltje-src-mosaic-stack-apps-api-src-bridge-parser-command-parser.service.ts_20260201-2131_5_remediation_needed.md"
```

View File

@@ -0,0 +1,17 @@
# QA Remediation Report
**File:** /home/jwoltje/src/mosaic-stack/apps/api/src/bridge/parser/command-parser.service.ts
**Tool Used:** Write
**Epic:** general
**Iteration:** 1
**Generated:** 2026-02-01 21:28:57
## Status
Pending QA validation
## Next Steps
This report was created by the QA automation hook.
To process this report, run:
```bash
claude -p "Use Task tool to launch universal-qa-agent for report: /home/jwoltje/src/mosaic-stack/docs/reports/qa-automation/pending/home-jwoltje-src-mosaic-stack-apps-api-src-bridge-parser-command-parser.service.ts_20260201-2128_1_remediation_needed.md"
```

View File

@@ -0,0 +1,17 @@
# QA Remediation Report
**File:** /home/jwoltje/src/mosaic-stack/apps/api/src/bridge/parser/command-parser.service.ts
**Tool Used:** Edit
**Epic:** general
**Iteration:** 1
**Generated:** 2026-02-01 21:29:48
## Status
Pending QA validation
## Next Steps
This report was created by the QA automation hook.
To process this report, run:
```bash
claude -p "Use Task tool to launch universal-qa-agent for report: /home/jwoltje/src/mosaic-stack/docs/reports/qa-automation/pending/home-jwoltje-src-mosaic-stack-apps-api-src-bridge-parser-command-parser.service.ts_20260201-2129_1_remediation_needed.md"
```

View File

@@ -0,0 +1,17 @@
# QA Remediation Report
**File:** /home/jwoltje/src/mosaic-stack/apps/api/src/bridge/parser/command-parser.service.ts
**Tool Used:** Edit
**Epic:** general
**Iteration:** 1
**Generated:** 2026-02-01 21:30:08
## Status
Pending QA validation
## Next Steps
This report was created by the QA automation hook.
To process this report, run:
```bash
claude -p "Use Task tool to launch universal-qa-agent for report: /home/jwoltje/src/mosaic-stack/docs/reports/qa-automation/pending/home-jwoltje-src-mosaic-stack-apps-api-src-bridge-parser-command-parser.service.ts_20260201-2130_1_remediation_needed.md"
```

View File

@@ -0,0 +1,17 @@
# QA Remediation Report
**File:** /home/jwoltje/src/mosaic-stack/apps/api/src/bridge/parser/command-parser.service.ts
**Tool Used:** Edit
**Epic:** general
**Iteration:** 2
**Generated:** 2026-02-01 21:30:14
## Status
Pending QA validation
## Next Steps
This report was created by the QA automation hook.
To process this report, run:
```bash
claude -p "Use Task tool to launch universal-qa-agent for report: /home/jwoltje/src/mosaic-stack/docs/reports/qa-automation/pending/home-jwoltje-src-mosaic-stack-apps-api-src-bridge-parser-command-parser.service.ts_20260201-2130_2_remediation_needed.md"
```

View File

@@ -0,0 +1,17 @@
# QA Remediation Report
**File:** /home/jwoltje/src/mosaic-stack/apps/api/src/bridge/parser/command-parser.service.ts
**Tool Used:** Edit
**Epic:** general
**Iteration:** 3
**Generated:** 2026-02-01 21:30:21
## Status
Pending QA validation
## Next Steps
This report was created by the QA automation hook.
To process this report, run:
```bash
claude -p "Use Task tool to launch universal-qa-agent for report: /home/jwoltje/src/mosaic-stack/docs/reports/qa-automation/pending/home-jwoltje-src-mosaic-stack-apps-api-src-bridge-parser-command-parser.service.ts_20260201-2130_3_remediation_needed.md"
```

View File

@@ -0,0 +1,17 @@
# QA Remediation Report
**File:** /home/jwoltje/src/mosaic-stack/apps/api/src/bridge/parser/command-parser.service.ts
**Tool Used:** Edit
**Epic:** general
**Iteration:** 4
**Generated:** 2026-02-01 21:30:28
## Status
Pending QA validation
## Next Steps
This report was created by the QA automation hook.
To process this report, run:
```bash
claude -p "Use Task tool to launch universal-qa-agent for report: /home/jwoltje/src/mosaic-stack/docs/reports/qa-automation/pending/home-jwoltje-src-mosaic-stack-apps-api-src-bridge-parser-command-parser.service.ts_20260201-2130_4_remediation_needed.md"
```

View File

@@ -0,0 +1,17 @@
# QA Remediation Report
**File:** /home/jwoltje/src/mosaic-stack/apps/api/src/bridge/parser/command-parser.service.ts
**Tool Used:** Edit
**Epic:** general
**Iteration:** 5
**Generated:** 2026-02-01 21:30:43
## Status
Pending QA validation
## Next Steps
This report was created by the QA automation hook.
To process this report, run:
```bash
claude -p "Use Task tool to launch universal-qa-agent for report: /home/jwoltje/src/mosaic-stack/docs/reports/qa-automation/pending/home-jwoltje-src-mosaic-stack-apps-api-src-bridge-parser-command-parser.service.ts_20260201-2130_5_remediation_needed.md"
```

View File

@@ -0,0 +1,17 @@
# QA Remediation Report
**File:** /home/jwoltje/src/mosaic-stack/apps/api/src/bridge/parser/command-parser.service.ts
**Tool Used:** Edit
**Epic:** general
**Iteration:** 1
**Generated:** 2026-02-01 21:31:14
## Status
Pending QA validation
## Next Steps
This report was created by the QA automation hook.
To process this report, run:
```bash
claude -p "Use Task tool to launch universal-qa-agent for report: /home/jwoltje/src/mosaic-stack/docs/reports/qa-automation/pending/home-jwoltje-src-mosaic-stack-apps-api-src-bridge-parser-command-parser.service.ts_20260201-2131_1_remediation_needed.md"
```

View File

@@ -0,0 +1,17 @@
# QA Remediation Report
**File:** /home/jwoltje/src/mosaic-stack/apps/api/src/bridge/parser/command-parser.service.ts
**Tool Used:** Edit
**Epic:** general
**Iteration:** 2
**Generated:** 2026-02-01 21:31:18
## Status
Pending QA validation
## Next Steps
This report was created by the QA automation hook.
To process this report, run:
```bash
claude -p "Use Task tool to launch universal-qa-agent for report: /home/jwoltje/src/mosaic-stack/docs/reports/qa-automation/pending/home-jwoltje-src-mosaic-stack-apps-api-src-bridge-parser-command-parser.service.ts_20260201-2131_2_remediation_needed.md"
```

View File

@@ -0,0 +1,17 @@
# QA Remediation Report
**File:** /home/jwoltje/src/mosaic-stack/apps/api/src/bridge/parser/command-parser.service.ts
**Tool Used:** Edit
**Epic:** general
**Iteration:** 3
**Generated:** 2026-02-01 21:31:21
## Status
Pending QA validation
## Next Steps
This report was created by the QA automation hook.
To process this report, run:
```bash
claude -p "Use Task tool to launch universal-qa-agent for report: /home/jwoltje/src/mosaic-stack/docs/reports/qa-automation/pending/home-jwoltje-src-mosaic-stack-apps-api-src-bridge-parser-command-parser.service.ts_20260201-2131_3_remediation_needed.md"
```

View File

@@ -0,0 +1,17 @@
# QA Remediation Report
**File:** /home/jwoltje/src/mosaic-stack/apps/api/src/bridge/parser/command-parser.service.ts
**Tool Used:** Edit
**Epic:** general
**Iteration:** 4
**Generated:** 2026-02-01 21:31:24
## Status
Pending QA validation
## Next Steps
This report was created by the QA automation hook.
To process this report, run:
```bash
claude -p "Use Task tool to launch universal-qa-agent for report: /home/jwoltje/src/mosaic-stack/docs/reports/qa-automation/pending/home-jwoltje-src-mosaic-stack-apps-api-src-bridge-parser-command-parser.service.ts_20260201-2131_4_remediation_needed.md"
```

View File

@@ -0,0 +1,17 @@
# QA Remediation Report
**File:** /home/jwoltje/src/mosaic-stack/apps/api/src/bridge/parser/command-parser.service.ts
**Tool Used:** Edit
**Epic:** general
**Iteration:** 5
**Generated:** 2026-02-01 21:31:29
## Status
Pending QA validation
## Next Steps
This report was created by the QA automation hook.
To process this report, run:
```bash
claude -p "Use Task tool to launch universal-qa-agent for report: /home/jwoltje/src/mosaic-stack/docs/reports/qa-automation/pending/home-jwoltje-src-mosaic-stack-apps-api-src-bridge-parser-command-parser.service.ts_20260201-2131_5_remediation_needed.md"
```

View File

@@ -0,0 +1,17 @@
# QA Remediation Report
**File:** /home/jwoltje/src/mosaic-stack/apps/api/src/bridge/parser/command-parser.spec.ts
**Tool Used:** Write
**Epic:** general
**Iteration:** 1
**Generated:** 2026-02-01 21:28:33
## Status
Pending QA validation
## Next Steps
This report was created by the QA automation hook.
To process this report, run:
```bash
claude -p "Use Task tool to launch universal-qa-agent for report: /home/jwoltje/src/mosaic-stack/docs/reports/qa-automation/pending/home-jwoltje-src-mosaic-stack-apps-api-src-bridge-parser-command-parser.spec.ts_20260201-2128_1_remediation_needed.md"
```

View File

@@ -0,0 +1,17 @@
# QA Remediation Report
**File:** /home/jwoltje/src/mosaic-stack/apps/api/src/bridge/parser/command-parser.spec.ts
**Tool Used:** Edit
**Epic:** general
**Iteration:** 1
**Generated:** 2026-02-01 21:29:17
## Status
Pending QA validation
## Next Steps
This report was created by the QA automation hook.
To process this report, run:
```bash
claude -p "Use Task tool to launch universal-qa-agent for report: /home/jwoltje/src/mosaic-stack/docs/reports/qa-automation/pending/home-jwoltje-src-mosaic-stack-apps-api-src-bridge-parser-command-parser.spec.ts_20260201-2129_1_remediation_needed.md"
```

View File

@@ -0,0 +1,17 @@
# QA Remediation Report
**File:** /home/jwoltje/src/mosaic-stack/apps/api/src/bridge/parser/command-parser.spec.ts
**Tool Used:** Edit
**Epic:** general
**Iteration:** 2
**Generated:** 2026-02-01 21:29:26
## Status
Pending QA validation
## Next Steps
This report was created by the QA automation hook.
To process this report, run:
```bash
claude -p "Use Task tool to launch universal-qa-agent for report: /home/jwoltje/src/mosaic-stack/docs/reports/qa-automation/pending/home-jwoltje-src-mosaic-stack-apps-api-src-bridge-parser-command-parser.spec.ts_20260201-2129_2_remediation_needed.md"
```

View File

@@ -0,0 +1,17 @@
# QA Remediation Report
**File:** /home/jwoltje/src/mosaic-stack/apps/api/src/bridge/parser/command.interface.ts
**Tool Used:** Write
**Epic:** general
**Iteration:** 1
**Generated:** 2026-02-01 21:28:06
## Status
Pending QA validation
## Next Steps
This report was created by the QA automation hook.
To process this report, run:
```bash
claude -p "Use Task tool to launch universal-qa-agent for report: /home/jwoltje/src/mosaic-stack/docs/reports/qa-automation/pending/home-jwoltje-src-mosaic-stack-apps-api-src-bridge-parser-command.interface.ts_20260201-2128_1_remediation_needed.md"
```

View File

@@ -0,0 +1,17 @@
# QA Remediation Report
**File:** /home/jwoltje/src/mosaic-stack/apps/api/src/runner-jobs/runner-jobs.controller.spec.ts
**Tool Used:** Edit
**Epic:** general
**Iteration:** 1
**Generated:** 2026-02-01 21:28:38
## Status
Pending QA validation
## Next Steps
This report was created by the QA automation hook.
To process this report, run:
```bash
claude -p "Use Task tool to launch universal-qa-agent for report: /home/jwoltje/src/mosaic-stack/docs/reports/qa-automation/pending/home-jwoltje-src-mosaic-stack-apps-api-src-runner-jobs-runner-jobs.controller.spec.ts_20260201-2128_1_remediation_needed.md"
```

View File

@@ -0,0 +1,17 @@
# QA Remediation Report
**File:** /home/jwoltje/src/mosaic-stack/apps/api/src/runner-jobs/runner-jobs.controller.spec.ts
**Tool Used:** Edit
**Epic:** general
**Iteration:** 2
**Generated:** 2026-02-01 21:28:49
## Status
Pending QA validation
## Next Steps
This report was created by the QA automation hook.
To process this report, run:
```bash
claude -p "Use Task tool to launch universal-qa-agent for report: /home/jwoltje/src/mosaic-stack/docs/reports/qa-automation/pending/home-jwoltje-src-mosaic-stack-apps-api-src-runner-jobs-runner-jobs.controller.spec.ts_20260201-2128_2_remediation_needed.md"
```

View File

@@ -0,0 +1,17 @@
# QA Remediation Report
**File:** /home/jwoltje/src/mosaic-stack/apps/api/src/runner-jobs/runner-jobs.controller.ts
**Tool Used:** Edit
**Epic:** general
**Iteration:** 1
**Generated:** 2026-02-01 21:29:39
## Status
Pending QA validation
## Next Steps
This report was created by the QA automation hook.
To process this report, run:
```bash
claude -p "Use Task tool to launch universal-qa-agent for report: /home/jwoltje/src/mosaic-stack/docs/reports/qa-automation/pending/home-jwoltje-src-mosaic-stack-apps-api-src-runner-jobs-runner-jobs.controller.ts_20260201-2129_1_remediation_needed.md"
```

View File

@@ -0,0 +1,17 @@
# QA Remediation Report
**File:** /home/jwoltje/src/mosaic-stack/apps/api/src/runner-jobs/runner-jobs.controller.ts
**Tool Used:** Edit
**Epic:** general
**Iteration:** 2
**Generated:** 2026-02-01 21:29:48
## Status
Pending QA validation
## Next Steps
This report was created by the QA automation hook.
To process this report, run:
```bash
claude -p "Use Task tool to launch universal-qa-agent for report: /home/jwoltje/src/mosaic-stack/docs/reports/qa-automation/pending/home-jwoltje-src-mosaic-stack-apps-api-src-runner-jobs-runner-jobs.controller.ts_20260201-2129_2_remediation_needed.md"
```

View File

@@ -0,0 +1,17 @@
# QA Remediation Report
**File:** /home/jwoltje/src/mosaic-stack/apps/api/src/runner-jobs/runner-jobs.service.spec.ts
**Tool Used:** Edit
**Epic:** general
**Iteration:** 1
**Generated:** 2026-02-01 21:30:09
## Status
Pending QA validation
## Next Steps
This report was created by the QA automation hook.
To process this report, run:
```bash
claude -p "Use Task tool to launch universal-qa-agent for report: /home/jwoltje/src/mosaic-stack/docs/reports/qa-automation/pending/home-jwoltje-src-mosaic-stack-apps-api-src-runner-jobs-runner-jobs.service.spec.ts_20260201-2130_1_remediation_needed.md"
```

View File

@@ -0,0 +1,17 @@
# QA Remediation Report
**File:** /home/jwoltje/src/mosaic-stack/apps/api/src/runner-jobs/runner-jobs.service.spec.ts
**Tool Used:** Edit
**Epic:** general
**Iteration:** 2
**Generated:** 2026-02-01 21:30:24
## Status
Pending QA validation
## Next Steps
This report was created by the QA automation hook.
To process this report, run:
```bash
claude -p "Use Task tool to launch universal-qa-agent for report: /home/jwoltje/src/mosaic-stack/docs/reports/qa-automation/pending/home-jwoltje-src-mosaic-stack-apps-api-src-runner-jobs-runner-jobs.service.spec.ts_20260201-2130_2_remediation_needed.md"
```

View File

@@ -0,0 +1,17 @@
# QA Remediation Report
**File:** /home/jwoltje/src/mosaic-stack/apps/api/src/runner-jobs/runner-jobs.service.spec.ts
**Tool Used:** Edit
**Epic:** general
**Iteration:** 3
**Generated:** 2026-02-01 21:30:48
## Status
Pending QA validation
## Next Steps
This report was created by the QA automation hook.
To process this report, run:
```bash
claude -p "Use Task tool to launch universal-qa-agent for report: /home/jwoltje/src/mosaic-stack/docs/reports/qa-automation/pending/home-jwoltje-src-mosaic-stack-apps-api-src-runner-jobs-runner-jobs.service.spec.ts_20260201-2130_3_remediation_needed.md"
```

View File

@@ -0,0 +1,17 @@
# QA Remediation Report
**File:** /home/jwoltje/src/mosaic-stack/apps/api/src/runner-jobs/runner-jobs.service.ts
**Tool Used:** Edit
**Epic:** general
**Iteration:** 1
**Generated:** 2026-02-01 21:29:19
## Status
Pending QA validation
## Next Steps
This report was created by the QA automation hook.
To process this report, run:
```bash
claude -p "Use Task tool to launch universal-qa-agent for report: /home/jwoltje/src/mosaic-stack/docs/reports/qa-automation/pending/home-jwoltje-src-mosaic-stack-apps-api-src-runner-jobs-runner-jobs.service.ts_20260201-2129_1_remediation_needed.md"
```

View File

@@ -0,0 +1,17 @@
# QA Remediation Report
**File:** /home/jwoltje/src/mosaic-stack/apps/api/src/runner-jobs/runner-jobs.service.ts
**Tool Used:** Edit
**Epic:** general
**Iteration:** 2
**Generated:** 2026-02-01 21:29:32
## Status
Pending QA validation
## Next Steps
This report was created by the QA automation hook.
To process this report, run:
```bash
claude -p "Use Task tool to launch universal-qa-agent for report: /home/jwoltje/src/mosaic-stack/docs/reports/qa-automation/pending/home-jwoltje-src-mosaic-stack-apps-api-src-runner-jobs-runner-jobs.service.ts_20260201-2129_2_remediation_needed.md"
```

View File

@@ -0,0 +1,17 @@
# QA Remediation Report
**File:** /home/jwoltje/src/mosaic-stack/apps/api/src/runner-jobs/runner-jobs.service.ts
**Tool Used:** Edit
**Epic:** general
**Iteration:** 1
**Generated:** 2026-02-01 21:31:14
## Status
Pending QA validation
## Next Steps
This report was created by the QA automation hook.
To process this report, run:
```bash
claude -p "Use Task tool to launch universal-qa-agent for report: /home/jwoltje/src/mosaic-stack/docs/reports/qa-automation/pending/home-jwoltje-src-mosaic-stack-apps-api-src-runner-jobs-runner-jobs.service.ts_20260201-2131_1_remediation_needed.md"
```

View File

@@ -0,0 +1,17 @@
# QA Remediation Report
**File:** /home/jwoltje/src/mosaic-stack/apps/api/src/runner-jobs/runner-jobs.service.ts
**Tool Used:** Edit
**Epic:** general
**Iteration:** 2
**Generated:** 2026-02-01 21:31:36
## Status
Pending QA validation
## Next Steps
This report was created by the QA automation hook.
To process this report, run:
```bash
claude -p "Use Task tool to launch universal-qa-agent for report: /home/jwoltje/src/mosaic-stack/docs/reports/qa-automation/pending/home-jwoltje-src-mosaic-stack-apps-api-src-runner-jobs-runner-jobs.service.ts_20260201-2131_2_remediation_needed.md"
```

View File

@@ -0,0 +1,17 @@
# QA Remediation Report
**File:** /home/jwoltje/src/mosaic-stack/apps/api/src/runner-jobs/runner-jobs.service.ts
**Tool Used:** Edit
**Epic:** general
**Iteration:** 3
**Generated:** 2026-02-01 21:31:40
## Status
Pending QA validation
## Next Steps
This report was created by the QA automation hook.
To process this report, run:
```bash
claude -p "Use Task tool to launch universal-qa-agent for report: /home/jwoltje/src/mosaic-stack/docs/reports/qa-automation/pending/home-jwoltje-src-mosaic-stack-apps-api-src-runner-jobs-runner-jobs.service.ts_20260201-2131_3_remediation_needed.md"
```

View File

@@ -0,0 +1,17 @@
# QA Remediation Report
**File:** /home/jwoltje/src/mosaic-stack/apps/api/src/runner-jobs/runner-jobs.service.ts
**Tool Used:** Edit
**Epic:** general
**Iteration:** 1
**Generated:** 2026-02-01 21:32:04
## Status
Pending QA validation
## Next Steps
This report was created by the QA automation hook.
To process this report, run:
```bash
claude -p "Use Task tool to launch universal-qa-agent for report: /home/jwoltje/src/mosaic-stack/docs/reports/qa-automation/pending/home-jwoltje-src-mosaic-stack-apps-api-src-runner-jobs-runner-jobs.service.ts_20260201-2132_1_remediation_needed.md"
```