"""Platform-owned handler contracts. Registry entries are not executable plugins.""" from src.modules.skill.domain.models import Operation, Port, SkillError SPECS = [ ("AO01", "解析需求资料", "parse_requirements", "read", ["knowledge.read"], 0, [("requirement", "string")], [("document", "object")]), ("AO02", "检索领域知识", "retrieve_knowledge", "read", ["knowledge.read"], 0, [("query", "string")], [("citations", "array")]), ("AO03", "装配研发上下文", "assemble_context", "read", ["context.read"], 0, [("document", "object"), ("citations", "array")], [("snapshot", "object")]), ("AO04", "形成需求与设计建议", "design_proposal", "read", ["model.generate"], 1, [("snapshot", "object")], [("design", "object")]), ("AO05", "生成候选代码与测试", "generate_candidate", "read", ["model.generate"], 1, [("design", "object")], [("patch", "object")]), ("AO06", "核验并应用Patch", "apply_patch", "idempotent", ["code.write"], 0, [("patch", "object")], [("source", "object")]), ("AO07", "检查编码与依赖", "check_policy", "read", ["code.read"], 0, [("source", "object")], [("policy_evidence", "object")]), ("AO08", "隔离构建", "sandbox_build", "confirm", ["sandbox.build"], 0, [("source", "object"), ("policy_evidence", "object")], [("candidate", "object")]), ("AO09", "独立测试", "sandbox_test", "confirm", ["sandbox.test"], 0, [("candidate", "object")], [("test_evidence", "object")]), ("AO10", "启动并检查预览", "sandbox_preview", "confirm", ["sandbox.preview"], 0, [("candidate", "object"), ("test_evidence", "object")], [("preview_evidence", "object")]), ("AO11", "登记交付证据", "register_evidence", "idempotent", ["evidence.write"], 0, [("preview_evidence", "object"), ("test_evidence", "object")], [("manifest", "object")]), ("AO12", "解释失败并提出修复", "propose_repair", "read", ["model.generate"], 1, [("failure_evidence", "object")], [("patch", "object")]), ] def builtin_operations(): return [Operation(operation_id=oid, version="0.1.0", name=name, handler_ref=handler, inputs=[Port(name=n, type=t) for n, t in ins], outputs=[Port(name=n, type=t) for n, t in outs], permissions=permissions, replay=replay, timeout_seconds=300, model_calls=calls, token_limit=20000 if calls else 0, state="approved", evidence_refs=["platform-owned-contract:0.1.0;executor-not-installed"]) for oid, name, handler, replay, permissions, calls, ins, outs in SPECS] def routing_operations(): """Explicit larger-context contracts; never mutate the published 0.1.0 versions.""" return [op.model_copy(update={'version':'0.2.0','token_limit':32000, 'evidence_refs':['platform-owned-contract:0.2.0;bounded-bailian-context']}) for op in builtin_operations() if op.operation_id in {'AO05','AO12'}] def check_handler(operation): if operation.operation_id=='AO13': expected=code_review_operation(operation.version) if operation.version in {'0.1.0','0.2.0'} else None else: expected=None expected = expected or next((op for op in routing_operations() if op.handler_ref==operation.handler_ref and op.version==operation.version),None) expected = expected or next((op for op in builtin_operations() if op.handler_ref == operation.handler_ref), None) if expected is None: raise SkillError("HANDLER_NOT_APPROVED", "处理器未进入平台批准目录。") if (operation.operation_id != expected.operation_id or operation.handler_ref != expected.handler_ref or operation.inputs != expected.inputs or operation.outputs != expected.outputs or not set(operation.permissions).issuperset(expected.permissions) or operation.replay != expected.replay or operation.model_calls != expected.model_calls or operation.token_limit > expected.token_limit): raise SkillError("HANDLER_CONTRACT_MISMATCH", "原子操作不能降低批准处理器的契约或权限要求。") if operation.state == "approved" and not operation.evidence_refs: raise SkillError("OPERATION_EVIDENCE_REQUIRED", "批准版本必须有契约证据引用。") def code_review_operation(version='0.2.0'): return Operation(operation_id='AO13',version=version,name='代码检视与候选修正',handler_ref='review_candidate', inputs=[Port(name='patch',type='object'),Port(name='design',type='object')], outputs=[Port(name='patch',type='object'),Port(name='review',type='object')], permissions=['model.generate','code.read'],replay='read',timeout_seconds=300, model_calls=1,token_limit=24000 if version=='0.1.0' else 40000,state='approved', evidence_refs=['user-authorized-code-review:2026-10-27;model-findings-not-runtime-proof'])