kaizen-agentic/workplans/KAIZEN-WP-0011-repository-health-normalization.md
tegwick 9d996d7936
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
CI Smoke / container-smoke (push) Successful in 2s
ci / test (push) Successful in 1m21s
Normalize repository validation and metadata
2026-08-20 11:04:43 +02:00

88 lines
2.4 KiB
Markdown

---
id: KAIZEN-WP-0011
type: workplan
title: "Repository validation and metadata normalization"
domain: agents
repo: kaizen-agentic
status: finished
owner: codex
topic_slug: custodian
created: "2026-08-20"
updated: "2026-08-20"
---
# KAIZEN-WP-0011 — Repository validation and metadata normalization
## Dependency validation
```task
id: KAIZEN-WP-0011-T01
status: done
priority: high
```
Prevent empty dependency declarations such as `dependencies: []` from creating
an empty-name dependency, and cover the behavior with a regression test.
**Result:** dependency inputs are filtered before registration; the regression
test passes and registry validation no longer reports an empty dependency.
## Complete CI test coverage
```task
id: KAIZEN-WP-0011-T02
status: done
priority: high
```
Use the running interpreter for subprocess CLI tests and remove the Forgejo CI
exclusion for the complete CLI error-handling test module.
**Result:** the subprocess test uses `sys.executable`, the full module passes,
and Forgejo CI now runs the complete test suite.
## Documentation and capability metadata
```task
id: KAIZEN-WP-0011-T03
status: done
priority: medium
```
Align the documented agent count with the 20 packaged definitions and use
`agents-sync-package` consistently for source/package parity guidance.
**Result:** README, contributing guidance, capability source/index, and packaged
agent guidance agree on 20 agents; parity guidance uses
`make agents-sync-package`.
## Workplan convention normalization
```task
id: KAIZEN-WP-0011-T04
status: done
priority: medium
```
Normalize completed workplan statuses to `finished`, rename workplan files to
the canonical `KAIZEN-WP-NNNN-<slug>.md` convention, and update inbound links.
**Result:** all eleven workplan filenames follow the canonical convention,
completed top-level statuses use `finished`, and inbound documentation links
were updated. Stable workplan and task IDs were not changed.
## Verification and closeout
```task
id: KAIZEN-WP-0011-T05
status: done
priority: high
```
Run the full test, release, agent-validation, and State Hub consistency checks;
record the outcome and close the workplan.
**Result:** full pytest, `make release-check`, `make agents-validate`, and
`git diff --check` pass. `statehub fix-consistency` passes; all prefix and
status warnings are eliminated. UUID registration is deferred to the production
registrar, requested through State Hub message `d0d38ee7`.