K 协议 · 组件契约

{
  "component_id": "k.policy.component_protocol_v2",
  "component_type": "K-Policy",
  "version": "0.1.0",
  "purpose": "Define the public starter contract for governed K components.",
  "inputs": ["component_profile"],
  "outputs": ["validated_component_contract"],
  "risk_level": "B",
  "gates": [],
  "dependencies": [],
  "runtime": {"mode": "python_api", "binding": "kcomponents.validate_component"},
  "tests": [{"name": "package_validation", "command": "python -B tools/validate_package.py"}],
  "audit": {"required": true, "evidence": ["component_hash", "validation_output"]},
  "lifecycle": "active",
  "protocol_version": "KGL-C/V2",
  "contracts": {
    "interface": {"input_schema_ref": ["schemas/k_component_v2.schema.json"], "output_schema_ref": ["validation_report"]},
    "execution": {"side_effect_class": "read_only", "idempotency": "required"},
    "resource": {"network": "disabled_by_default", "cost_budget": "zero_paid_usage"},
    "stability": {"fallback": "fail_closed"},
    "cache": {"cacheable": true},
    "state": {"write_scope": "declared_outputs_only"},
    "security": {"secret_policy": "no_secret_read_by_default"},
    "observability": {"trace_id_required": true},
    "adapter": {"cli_binding": true, "api_binding": false},
    "selection": {"capability_score": 0.8}
  }
}

完整文件与许可说明随下载包提供。