blue/.blue/docs/spikes/2026-01-24T0300Z-audit-path-integration.wip.md
Eric Garcia 0fea499957 feat: lifecycle suffixes for all document states + resolve all clippy warnings
Every document filename now mirrors its lifecycle state with a status
suffix (e.g., .draft.md, .wip.md, .accepted.md). No more bare .md for
tracked document types. Also renamed all from_str methods to parse to
avoid FromStr trait confusion, introduced StagingDeploymentParams struct,
and fixed all 19 clippy warnings across the codebase.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-26 12:19:46 -05:00

62 lines
1.6 KiB
Markdown

# Spike: Audit Path Integration
| | |
|---|---|
| **Status** | In Progress |
| **Date** | 2026-01-24 |
| **Time Box** | 30 minutes |
---
## Question
Does Blue MCP need updates for audit document paths and integration?
---
## Findings
### Current State
1. **`blue_audit` tool exists** but it's a health checker, not document management:
- Checks for stalled RFCs (in-progress without worktree)
- Finds implemented RFCs without ADRs
- Detects overdue reminders
- Identifies expired staging locks
2. **No `DocType::Audit`** in `blue-core/src/store.rs`:
```rust
pub enum DocType {
Rfc, Spike, Adr, Decision, Prd, Postmortem, Runbook, Dialogue
}
```
3. **No audit document paths** - `BlueHome` doesn't define an audits directory
4. **Fungal has audit documents** in `docs/audits/`:
- `2026-01-17-repository-audit.md` - Full repo audit report
- `2026-01-17-rfc-status-verification.md` - RFC status verification
### Gap Analysis
| Feature | Status |
|---------|--------|
| DocType::Audit | ❌ Missing |
| `.blue/docs/audits/` path | ❌ Missing |
| `blue_audit_create` tool | ❌ Missing |
| `blue_audit_list` tool | ❌ Missing |
### Recommendation
**Yes, Blue MCP needs updates** to support audit documents as a first-class document type:
1. Add `DocType::Audit` to store.rs
2. Add `audits_path` to `BlueHome`
3. Create `blue_audit_create` tool for generating audit reports
4. Rename current `blue_audit` to `blue_health_check` to avoid confusion
---
*"Two audits with the same name. One checks health, one documents findings. Let's clarify."*
— Blue