kaizen-agentic/workplans/KAIZEN-WP-0011-repository-health-normalization.md

id	type	title	domain	repo	status	owner	topic_slug	created	updated
KAIZEN-WP-0011	workplan	Repository validation and metadata normalization	agents	kaizen-agentic	finished	codex	custodian	2026-08-20	2026-08-20

KAIZEN-WP-0011 — Repository validation and metadata normalization

Dependency validation

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

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

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

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

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.