activity-core/workplans/ACTIVITY-WP-0013-reuse-surface-report-gaps-resolver.md

id, type, title, domain, repo, status, owner, topic_slug, created, updated, state_hub_workstream_id

id	type	title	domain	repo	status	owner	topic_slug	created	updated	state_hub_workstream_id
ACTIVITY-WP-0013	workplan	Reuse Surface Report Gaps Resolver	custodian	activity-core	finished	codex	activity-core	2026-06-18	2026-06-18	01e68dfd-b146-4aef-a575-2d3b178ca5c2

Reuse Surface Report Gaps Resolver

Implement the R2 handoff from kaizen-agentic (bffa224c) so the reuse_surface_report_gaps shell context source populates context.gaps for the Coulomb daily registry hygiene sweep.

Register Shell Resolver Query

id: ACTIVITY-WP-0013-T01
status: done
priority: high
state_hub_task_id: "a6e1fc5c-7b42-436d-914e-4d605cb6f329"

Add a dedicated reuse-surface context resolver module and register reuse_surface_report_gaps on the shell resolver path while preserving the existing kaizen shell query behavior.

Implement Batch And Signal Semantics

id: ACTIVITY-WP-0013-T02
status: done
priority: high
state_hub_task_id: "229cf285-8388-471d-95fd-08400db1553e"

Load the Coulomb rollout roster, select active repos with a persisted round-robin cursor, resolve repo roots from State Hub host paths, run reuse-surface report gaps --format json, and emit gap records for the enabled registry hygiene signals.

Cover Required And Optional Failure Modes

id: ACTIVITY-WP-0013-T03
status: done
priority: high
state_hub_task_id: "85b5c7d4-40e1-4945-8ada-1dff2363c194"

Ensure missing required dependencies fail visibly while optional resolver sources bind an empty context.gaps list. Add unit coverage for fixture rollout data, mocked CLI JSON, resolver binding, and hygiene_signal rule gating.

Smoke Real Coulomb Rollout

id: ACTIVITY-WP-0013-T04
status: done
priority: medium
state_hub_task_id: "6a5446ed-b4ec-4693-b508-65415571d834"

Run a live resolver smoke against /home/worsch/coulomb-loop/loops/registry-hygiene/rollout.yaml using a temporary round-robin cursor. The real active rollout produced five gaps, including one for reuse-surface with hygiene_signal: stale_sbom. The smoke supplied reuse_surface_bin: /home/worsch/reuse-surface/.venv/bin/reuse-surface and runner_host: bnt-lap001; the worker environment or definition params must provide equivalent values before enabling the production sweep.