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

id	type	title	domain	repo	status	owner	topic_slug	created	updated	state_hub_workstream_id
KAIZEN-WP-0011	workplan	Repository validation and metadata normalization	agents	kaizen-agentic	finished	codex	custodian	2026-08-20	2026-08-20	ceae7cdc-2ed2-5276-a520-8f2a2d1fcc23

KAIZEN-WP-0011 — Repository validation and metadata normalization

Dependency validation

id: KAIZEN-WP-0011-T01
status: done
priority: high
state_hub_task_id: "673da081-e29e-5bff-ba53-cd588f9d9863"

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
state_hub_task_id: "e02b5249-6f7c-5c22-b918-261e5a91031f"

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
state_hub_task_id: "0d31a1fa-7ac9-5476-a340-06761bd3f63a"

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
state_hub_task_id: "bfb22aee-f87a-5268-bd5c-cc8b43c99c4e"

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
state_hub_task_id: "da4970c6-7da5-5a25-b70a-f12abfd97307"

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.