SubMiner/backlog/tasks/task-99 - Expand-maintainability-guardrails-and-runtime-cycle-checks.md

id, title, status, assignee, created_date, updated_date, labels, dependencies, priority

id	title	status	assignee	created_date	updated_date	labels	dependencies	priority
TASK-99	Expand maintainability guardrails and runtime cycle checks	To Do		2026-02-21 07:15	2026-02-21 07:15	quality architecture ci	TASK-96 TASK-97	medium

Description

Current guardrails cover main.ts fan-in and broad file budgets. Add targeted checks for newly extracted hotspots and runtime import-cycle detection.

Action Steps

1. Rebaseline file-size budgets for known hotspots (including post-TASK-96 files).
2. Extend check:file-budgets config to enforce thresholds on new modules and key test files.
3. Add runtime dependency cycle detection for src/main/runtime/** (script + CI hook).
4. Wire new checks into local gate commands and CI workflow.
5. Add failure guidance output so contributors can remediate quickly.
6. Run gates on current branch and capture pass/fail evidence in task notes.

Acceptance Criteria

• #1 Budget thresholds include new hotspot modules and prevent silent growth.
• #2 Runtime cycle check detects at least one injected fixture cycle in tests.
• #3 CI runs both checks and fails fast on violations.
• #4 Contributor guidance exists for fixing guardrail failures.

Definition of Done

• #1 Guardrail scripts and CI wiring merged with passing checks.
• #2 Documentation updated with local commands and expected outputs.
• #3 Baseline numbers recorded to justify thresholds.