86 lines
2.3 KiB
Markdown
86 lines
2.3 KiB
Markdown
---
|
|
id: CUST-WP-0008
|
|
type: workplan
|
|
title: Consistency Checking Engine
|
|
domain: custodian
|
|
status: done
|
|
owner: custodian
|
|
topic_slug: the-custodian
|
|
repo_slug: the-custodian
|
|
created: 2026-03-03
|
|
updated: 2026-03-03
|
|
state_hub_workstream_id: "78891e58-2889-43d7-9c1a-d7637990dc82"
|
|
---
|
|
|
|
# CUST-WP-0008 — Consistency Checking Engine
|
|
|
|
Implements a bidirectional ADR-001 consistency checker between workplan files
|
|
in registered repos and the state-hub DB. The file is always authoritative;
|
|
the DB is the cache/index layer.
|
|
|
|
Checks C-01 through C-12 cover: missing workplans/, parse failures, stale
|
|
references, status/title drift, unlinked workplans, orphan DB workstreams,
|
|
repo mismatches, task drift, and orphan DB tasks.
|
|
|
|
The `--fix` flag applies auto-fixable issues (C-04, C-05, C-06, C-09, C-10, C-11).
|
|
|
|
---
|
|
|
|
## Task T01: Implement consistency_check.py
|
|
|
|
```task
|
|
id: CUST-WP-0008-T01
|
|
status: done
|
|
priority: critical
|
|
assignee: custodian
|
|
state_hub_task_id: "a18c2389-ee98-40e9-a392-b5ff3deab838"
|
|
```
|
|
|
|
Core engine + CLI at `state-hub/scripts/consistency_check.py`.
|
|
- Checks C-01 through C-12
|
|
- `--repo SLUG` or `--all` mode
|
|
- `--fix` applies auto-fixable issues
|
|
- `--json` machine-readable output
|
|
- Exit codes: 0=ok, 1=fail, 2=warn-only
|
|
|
|
## Task T02: Add MCP tool check_repo_consistency
|
|
|
|
```task
|
|
id: CUST-WP-0008-T02
|
|
status: done
|
|
priority: high
|
|
assignee: custodian
|
|
state_hub_task_id: "90b626e5-3f0c-47ba-be32-e57e1132563a"
|
|
```
|
|
|
|
Add `check_repo_consistency(repo_slug, fix=False)` tool to
|
|
`state-hub/mcp_server/server.py` following the validate_repo_adr pattern.
|
|
|
|
## Task T03: Add Makefile targets
|
|
|
|
```task
|
|
id: CUST-WP-0008-T03
|
|
status: done
|
|
priority: medium
|
|
assignee: custodian
|
|
state_hub_task_id: "151ba804-9938-4734-a49c-20bcd7c0b10b"
|
|
```
|
|
|
|
Add `check-consistency`, `fix-consistency`, `check-consistency-all`,
|
|
`fix-consistency-all` targets to `state-hub/Makefile`.
|
|
|
|
## Task T04: Run dry-run and apply auto-fixes
|
|
|
|
```task
|
|
id: CUST-WP-0008-T04
|
|
status: done
|
|
priority: high
|
|
assignee: custodian
|
|
state_hub_task_id: "ad2a697e-6eb4-4ccf-8c76-82984e354571"
|
|
```
|
|
|
|
1. Run `check-consistency-all` to verify findings match expected issues
|
|
2. Run `fix-consistency-all` to apply C-09 repo remaps and C-04 status drift fix
|
|
3. Verify `activity-core-foundation` and `activity-core-triggers-ops` repo_id updated
|
|
4. Verify railiance-bootstrap `phase-0-operational-baseline` status updated
|