feat(v2): T06-c 方案治理入口与 Tools 卡守卫,T06 收尾

T06 第三块,收尾。方案提案复用既有组件治理(registry.draft/release),
不新建发布路径;自批拒绝等既有保证有测试锁定。

- propose_plan():维度在提案时即去重与冲突拦截(T06-a 的解析前移),
  保证草稿阶段就挡住"同 ID 不同定义"
- **不得出现业务 Tools 卡**(ADR-11):方案自带 tools/tool_cards/
  allowed_tools/permissions 一律拒绝,否则业务侧可绕过工具白名单;
  工具只能由后台治理
- validate_critical_checks():关键核查项必须真由本方案的 Skill/规则产生,
  凭空声明的"关键项"会让 BR-06 的硬性阻断语义失去可追溯性

T06 三块完成,卡片验收对照:AC-28(装配与依赖拒绝)· AC-29(维度去重与刻度
冲突)· AC-44(0/2/6/9 维与异刻度的呈现判定)均有测试;"没有 Tools 卡" 有守卫。

测试:test_review_plan.py 增至 34 项。全量 349 项 OK(340 → 349);
verify.py 10/10 PASS。

Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
2026-09-29 20:24:24 +08:00
co-authored by Claude Code
parent 8a9005036c
commit 1bc17bb9bc
2 changed files with 139 additions and 0 deletions
+92
View File
@@ -251,5 +251,97 @@ class PlanAssemblyTests(unittest.TestCase):
self.assertIn("不一致定义", str(ctx.exception))
class PlanGovernanceTests(unittest.TestCase):
"""T06-c:方案治理复用既有入口;不得出现业务 Tools 卡(ADR-11)。"""
def setUp(self):
self._tmp = tempfile.TemporaryDirectory(ignore_cleanup_errors=True)
self.db_path = Path(self._tmp.name) / "governance.sqlite3"
store.initialize(self.db_path)
with store.transaction(self.db_path) as db:
registry.seed(db)
def tearDown(self):
self._tmp.cleanup()
def plan_body(self, **over):
body = {"id": "corporate.custom", "kind": "plan", "name": "自定义方案",
"version": "1.0.0", "scope": "demo", "skills": ["corporate.cashflow"],
"rules": ["demo.coverage"], "template": "template.ai-pre-review",
"dimensions": [spec("d1", order=0), spec("d2", "负债率", 1), spec("d3", "设备", 2)]}
body.update(over)
return body
def propose(self, body=None, actor="demo-manager"):
with store.transaction(self.db_path) as db:
return plan.propose_plan(db, body or self.plan_body(), actor, "DEMO-A")
def test_plan_proposal_creates_a_draft_only(self):
draft = self.propose()
self.assertEqual(draft["status"], "draft")
with store.transaction(self.db_path) as db:
published = [r for r in store.listing(db, "component_version")
if r.get("component_id") == "corporate.custom"]
self.assertEqual(published, [], "提议方案不得直接生效")
def test_business_tools_card_is_rejected(self):
# ADR-11:不开放业务 Tools 卡,方案不得自带工具配置面
for key in ("tools", "tool_cards", "allowed_tools", "permissions"):
with self.subTest(key=key):
with self.assertRaises(ValueError) as ctx:
self.propose(self.plan_body(**{key: ["terminal"]}))
self.assertIn("不开放业务 Tools 卡", str(ctx.exception))
def test_dimensions_are_deduplicated_at_proposal(self):
draft = self.propose(self.plan_body(dimensions=[spec("d1"), spec("d1")]))
with store.transaction(self.db_path) as db:
row = store.get(db, "component_draft", draft["id"])
self.assertEqual(len(row["dimensions"]), 1, "相同定义只应保留一份")
def test_conflicting_dimensions_are_rejected_at_proposal(self):
with self.assertRaises(ValueError) as ctx:
self.propose(self.plan_body(dimensions=[spec("d1"), spec("d1", scale_version="v2")]))
self.assertIn("不一致定义", str(ctx.exception))
def test_self_approval_is_rejected_by_existing_governance(self):
draft = self.propose()
with store.transaction(self.db_path) as db:
with self.assertRaises(PermissionError) as ctx:
registry.release(db, draft["id"], "demo-manager")
self.assertIn("独立审核人", str(ctx.exception))
def test_only_plans_can_be_proposed_through_this_entry(self):
with self.assertRaises(ValueError):
self.propose(self.plan_body(kind="skill"))
class CriticalCheckTests(unittest.TestCase):
def setUp(self):
self._tmp = tempfile.TemporaryDirectory(ignore_cleanup_errors=True)
self.db_path = Path(self._tmp.name) / "checks.sqlite3"
store.initialize(self.db_path)
with store.transaction(self.db_path) as db:
registry.seed(db)
self.frozen = plan.assemble(db, "corporate.default")
def tearDown(self):
self._tmp.cleanup()
def test_real_codes_are_accepted(self):
codes = sorted(plan._plan_codes(self.frozen))
self.assertTrue(codes)
plan.validate_critical_checks(self.frozen, codes[:1])
def test_invented_critical_check_is_rejected(self):
with self.assertRaises(ValueError) as ctx:
plan.validate_critical_checks(self.frozen, ["not.a.real.code"])
self.assertIn("不属于本方案", str(ctx.exception))
def test_empty_critical_list_is_allowed(self):
plan.validate_critical_checks(self.frozen, [])
if __name__ == "__main__":
unittest.main()