fix: package quality-debt CLI support

Assistant: codex
Assistant-Model: gpt-5.6-sol
Assistant-Session: 01a053ff-1d6f-7fe2-ac1c-a6eb40a42a0c

WORK-RECORDS.md

@@ -67,6 +67,7 @@
 | task | STATE-WP-ADHOC-2026-08-08-T04 | done | — | workplans/ADHOC-2026-08-08.md |
 | task | STATE-WP-ADHOC-2026-08-23-T01 | done | — | workplans/ADHOC-2026-08-23.md |
 | task | STATE-WP-ADHOC-2026-08-30-T01 | done | — | workplans/ADHOC-2026-08-30.md |
+| task | STATE-WP-ADHOC-2026-08-30-T02 | done | — | workplans/ADHOC-2026-08-30.md |
 | task | CUST-WP-0003-T01 | done | — | workplans/CUST-WP-0003-whi-kpi-card.md |
 | task | CUST-WP-0003-T02 | done | — | workplans/CUST-WP-0003-whi-kpi-card.md |
 | task | CUST-WP-0003-T03 | done | — | workplans/CUST-WP-0003-whi-kpi-card.md |

pyproject.toml

@@ -37,6 +37,8 @@ artifacts = [
     "repository_rename_workplan.py",
     "statehub_register.py",
     "scripts/consistency_check.py",
+    "scripts/quality_assessment.py",
+    "scripts/quality_debt.py",
     "scripts/repo_sync.py",
     "scripts/mcp_registration.py",
     "scripts/project_claude_md.template",
@@ -50,6 +52,8 @@ artifacts = [
 "statehub_register.py" = "statehub_register.py"
 "scripts/consistency_check.py" = "scripts/consistency_check.py"
 "scripts/ensure_gitignore_claude_rules.py" = "scripts/ensure_gitignore_claude_rules.py"
+"scripts/quality_assessment.py" = "scripts/quality_assessment.py"
+"scripts/quality_debt.py" = "scripts/quality_debt.py"
 "scripts/repo_sync.py" = "scripts/repo_sync.py"
 "scripts/mcp_registration.py" = "scripts/mcp_registration.py"
 "scripts/project_claude_md.template" = "scripts/project_claude_md.template"

tests/test_statehub_register_cli.py

@@ -3,6 +3,7 @@ from __future__ import annotations
 import argparse
 import json
 import sys
+import tomllib
 from pathlib import Path
 
 import pytest
@@ -475,3 +476,20 @@ def test_fix_consistency_remote_requires_explicit_repo_or_all(monkeypatch, tmp_p
 
     assert exc.value.code == 1
     assert calls == []
+
+
+def test_quality_debt_cli_support_files_ship_in_the_wheel():
+    config = tomllib.loads(
+        (Path(__file__).resolve().parents[1] / "pyproject.toml").read_text(
+            encoding="utf-8"
+        )
+    )
+    force_include = config["tool"]["hatch"]["build"]["targets"]["wheel"][
+        "force-include"
+    ]
+
+    assert force_include["scripts/quality_debt.py"] == "scripts/quality_debt.py"
+    assert (
+        force_include["scripts/quality_assessment.py"]
+        == "scripts/quality_assessment.py"
+    )

workplans/ADHOC-2026-08-30.md

@@ -32,3 +32,15 @@ require `primary/railiance01`; `make dashboard-local` remains available for
 intentional fallback development. `make dashboard-check` built all 71 pages
 successfully (with the pre-existing `/docs/intakes` → `/suggestions` broken-link
 warning).
+
+## Package the quality-debt CLI
+
+```task
+id: STATE-WP-ADHOC-2026-08-30-T02
+status: done
+priority: medium
+state_hub_task_id: "2fdc57f8-af0b-54e5-98b6-8476d53cddb1"
+description: "Included scripts/quality_debt.py and scripts/quality_assessment.py in State Hub wheels. Added a packaging regression; 21 focused CLI tests pass. A clean wheel install ran statehub quality-debt successfully and reported 43 existing quality-debt items."
+```
+
+Include the quality-debt scanner and its assessment helper in State Hub wheels, and verify the installed CLI works outside the source checkout.