File size: 4,879 Bytes
caf8059
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
5ca3c16
 
 
 
 
caf8059
 
 
5ca3c16
 
caf8059
 
 
 
 
5ca3c16
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
"""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'])