@cr1992/agentkit 1.0.0

package/schemas/controller-recheck-record-v1.schema.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-skills.example/schemas/controller-recheck-record-v1.schema.json",
+  "title": "Controller Recheck Record v1",
+  "type": "object",
+  "required": ["schema_version", "report_type", "contract_digest", "stable_output_digests", "outcome", "checked_at"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "report_type": { "const": "controller_recheck" },
+    "contract_digest": { "$ref": "#/$defs/digest" },
+    "stable_output_digests": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": { "$ref": "#/$defs/digest" }
+    },
+    "outcome": { "const": "pass" },
+    "checked_at": { "type": "string", "format": "date-time" }
+  },
+  "additionalProperties": false,
+  "$defs": { "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" } }
+}

package/schemas/convergence-report-v1.schema.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-skills.local/schemas/convergence-report-v1.schema.json",
+  "title": "Convergence Report v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "report_id", "loop_id", "contract_digest", "skill_set", "outcome", "iterations", "failure_signatures", "strategy_changes", "verification_aborts", "verification_gaps", "reflection_refs", "improvement_proposal_refs", "generated_at", "report_digest"],
+  "properties": { "schema_version": { "const": 1 }, "report_id": { "type": "string" }, "loop_id": { "type": "string" }, "contract_digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "skill_set": { "type": "array" }, "outcome": { "enum": ["completed", "stopped"] }, "iterations": { "type": "integer", "minimum": 0 }, "failure_signatures": { "type": "array" }, "strategy_changes": { "type": "array" }, "verification_aborts": { "type": "array" }, "verification_gaps": { "type": "array" }, "reflection_refs": { "type": "array" }, "improvement_proposal_refs": { "type": "array" }, "generated_at": { "type": "string", "format": "date-time" }, "report_digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" } }
+}

package/schemas/effective-worker-capability-v1.schema.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-skills.local/schemas/effective-worker-capability-v1.schema.json",
+  "title": "Effective Worker Capability v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "host", "worker_profile", "capability_fingerprint", "binding", "observed_at", "expires_at", "outcomes", "evidence_refs"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "host": { "type": "string", "pattern": "^[a-z0-9][a-z0-9._-]{0,63}$" },
+    "worker_profile": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$" },
+    "capability_fingerprint": { "$ref": "#/$defs/digest" },
+    "binding": { "type": "string", "pattern": "^(session:[A-Za-z0-9._-]{1,128}|config:sha256:[0-9a-f]{64})$" },
+    "observed_at": { "type": "string", "format": "date-time" },
+    "expires_at": { "type": "string", "format": "date-time" },
+    "outcomes": {
+      "type": "object",
+      "propertyNames": { "pattern": "^worker\\.[a-z][a-z0-9_.-]{0,63}$" },
+      "additionalProperties": { "enum": ["allowed", "denied_by_policy", "unavailable_or_unproven", "approval_channel_fault", "execution_fault"] }
+    },
+    "evidence_refs": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["type", "id", "digest"],
+        "properties": {
+          "type": { "enum": ["probe", "schema", "observation"] },
+          "id": { "type": "string", "minLength": 1 },
+          "digest": { "$ref": "#/$defs/digest" }
+        }
+      }
+    }
+  },
+  "$defs": { "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" } }
+}

package/schemas/embedded-verification-record-v1.schema.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-skills.example/schemas/embedded-verification-record-v1.schema.json",
+  "title": "Embedded Verification Record v1",
+  "type": "object",
+  "required": ["schema_version", "record_type", "record_id", "loop_id", "iteration", "contract_digest", "verification_profile_digest", "artifact_ref", "l0_result", "l1_result", "independent_context", "outcome", "record_digest"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "record_type": { "const": "embedded_verification_record" },
+    "record_id": { "type": "string", "minLength": 1 },
+    "loop_id": { "type": "string", "minLength": 1 },
+    "iteration": { "type": "integer", "minimum": 1 },
+    "contract_digest": { "$ref": "#/$defs/digest" },
+    "verification_profile_digest": { "$ref": "#/$defs/digest" },
+    "artifact_ref": { "type": "object" },
+    "l0_result": { "type": "object" },
+    "l1_result": { "$ref": "review-result-v1.schema.json" },
+    "independent_context": {
+      "type": "object",
+      "required": ["assurance", "reviewer_run_id"],
+      "properties": {
+        "assurance": { "enum": ["host_reported", "user_relayed"] },
+        "reviewer_run_id": { "type": "string", "minLength": 1 }
+      },
+      "additionalProperties": false
+    },
+    "outcome": { "enum": ["pass", "fail", "undecidable", "blocked_safety"] },
+    "record_digest": { "$ref": "#/$defs/digest" }
+  },
+  "additionalProperties": false,
+  "$defs": { "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" } }
+}

package/schemas/evidence-package-v1.schema.json

@@ -0,0 +1,41 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-skills.example/schemas/evidence-package-v1.schema.json",
+  "title": "Evidence Package v1",
+  "type": "object",
+  "required": ["schema_version", "run_id", "protocol_version", "runtime_version", "contract_digest", "verification_profile_digest", "artifact_ref", "stages", "terminal_outcome", "completion_scope", "human_gate_required", "provenance", "evidence_digest"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "run_id": { "type": "string", "minLength": 1 },
+    "protocol_version": { "const": 1 },
+    "runtime_version": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+(?:[-+][0-9A-Za-z.-]+)?$" },
+    "contract_digest": { "$ref": "#/$defs/digest" },
+    "verification_profile_digest": { "$ref": "#/$defs/digest" },
+    "artifact_ref": { "type": "object" },
+    "stages": {
+      "type": "object",
+      "required": ["smoke_l0", "l1_review", "final_l0"],
+      "properties": {
+        "smoke_l0": { "type": "object" },
+        "l1_review": { "type": "object" },
+        "final_l0": { "type": "object" }
+      }
+    },
+    "terminal_outcome": { "enum": ["pass", "fail", "undecidable", "blocked_safety"] },
+    "completion_scope": { "const": "verification_only" },
+    "human_gate_required": { "type": "boolean" },
+    "provenance": {
+      "type": "object",
+      "required": ["provider", "verified_at", "verifier_run_id", "isolation_assurance", "limitations"],
+      "properties": {
+        "provider": { "const": "verify-agent-output" },
+        "verified_at": { "type": "string" },
+        "verifier_run_id": { "type": "string" },
+        "isolation_assurance": { "enum": ["host_reported", "user_relayed"] },
+        "limitations": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "evidence_digest": { "$ref": "#/$defs/digest" }
+  },
+  "$defs": { "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" } }
+}

package/schemas/improvement-proposal-v1.schema.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-skills.local/schemas/improvement-proposal-v1.schema.json",
+  "title": "Skill Improvement Proposal v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "proposal_id", "target_skill", "source_reflections", "problem", "proposed_change", "affected_scope", "counterexamples", "validation_plan", "lifecycle", "proposal_digest"],
+  "properties": {
+    "schema_version": { "const": 1 }, "proposal_id": { "type": "string" },
+    "target_skill": { "type": "object", "required": ["name", "based_on_version", "based_on_digest"], "properties": { "name": { "type": "string" }, "based_on_version": { "type": "string" }, "based_on_digest": { "$ref": "#/$defs/digest" } }, "additionalProperties": false },
+    "source_reflections": { "type": "array", "minItems": 1, "items": { "type": "object", "required": ["reflection_id", "reflection_digest"], "properties": { "reflection_id": { "type": "string" }, "reflection_digest": { "$ref": "#/$defs/digest" } }, "additionalProperties": false } },
+    "problem": { "type": "object", "required": ["type", "evidence_refs"], "properties": { "type": { "enum": ["skill_gap", "false_positive", "false_negative", "inefficiency"] }, "evidence_refs": { "type": "array", "minItems": 1 } }, "additionalProperties": false },
+    "proposed_change": { "type": "string", "minLength": 1 }, "affected_scope": { "type": "array", "items": { "type": "string" } }, "counterexamples": { "type": "array", "items": { "type": "string" } },
+    "validation_plan": { "type": "object", "required": ["replay_cases", "regression_suites", "independent_review"], "properties": { "replay_cases": { "type": "array" }, "regression_suites": { "type": "array" }, "independent_review": { "const": "required" }, "canary": { "type": "string" } }, "additionalProperties": false },
+    "lifecycle": { "const": "proposed" }, "proposal_digest": { "$ref": "#/$defs/digest" }
+  },
+  "$defs": { "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" } }
+}

package/schemas/loop-state-v1.schema.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-skills.example/schemas/loop-state-v1.schema.json",
+  "title": "Loop State v1",
+  "type": "object",
+  "required": ["schema_version", "runtime_version", "loop_id", "revision", "state", "contract_digest", "verification_profile_digest", "provider", "limits", "policy", "current_iteration", "iterations", "consumed_verification_run_ids", "human_gate", "skill_provenance", "terminal"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "runtime_version": { "type": "string" },
+    "loop_id": { "type": "string", "minLength": 1 },
+    "goal_ref": { "type": ["string", "null"] },
+    "revision": { "type": "integer", "minimum": 0 },
+    "state": { "enum": ["active", "waiting_human", "completed", "stopped"] },
+    "contract_digest": { "$ref": "#/$defs/digest" },
+    "verification_profile_digest": { "$ref": "#/$defs/digest" },
+    "provider": { "enum": ["verify-agent-output", "embedded"] },
+    "limits": {
+      "type": "object",
+      "required": ["max_iterations", "consecutive_identical_signature"],
+      "properties": {
+        "max_iterations": { "type": "integer", "minimum": 1 },
+        "consecutive_identical_signature": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "policy": { "type": "object" },
+    "current_iteration": { "type": ["object", "null"] },
+    "iterations": { "type": "array" },
+    "consumed_verification_run_ids": { "type": "array", "items": { "type": "string" } },
+    "human_gate": { "type": "object" },
+    "skill_provenance": { "type": "object" },
+    "terminal": { "type": ["object", "null"] }
+  },
+  "$defs": { "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" } }
+}

package/schemas/model-policy-resolution-v1.schema.json

@@ -0,0 +1,41 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-skills.local/schemas/model-policy-resolution-v1.schema.json",
+  "title": "Model Policy Resolution v1",
+  "type": "object",
+  "required": ["schema_version", "record_type", "host", "tier_rank", "channel", "selection_source", "dispatch_record_patch"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "record_type": { "const": "model-policy-resolution" },
+    "host": { "type": "string", "minLength": 1 },
+    "tier_rank": { "type": "integer", "minimum": 0 },
+    "channel": { "type": "string", "minLength": 1 },
+    "selection_source": { "enum": ["user-explicit", "local-config"] },
+    "dispatch_record_patch": { "$ref": "#/$defs/dispatchRecordPatch" }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "dispatchRecordPatch": {
+      "type": "object",
+      "required": ["attempt_id", "attempt", "previous_attempt_id", "tier", "model", "reasoning_effort", "adjustment_action", "failure_kind", "failure_ref", "selection_reason", "config_source", "configuration_state", "model_resolution_state", "dispatch_provenance", "max_attempts"],
+      "properties": {
+        "attempt_id": { "type": "string", "minLength": 1 },
+        "attempt": { "type": "integer", "minimum": 1 },
+        "previous_attempt_id": { "type": ["string", "null"] },
+        "tier": { "type": "string", "minLength": 1 },
+        "model": { "type": "string", "minLength": 1 },
+        "reasoning_effort": { "type": "string", "minLength": 1 },
+        "adjustment_action": { "enum": ["initial", "retry_same", "raise_effort", "switch_model", "promote_tier", "fresh_context", "change_strategy"] },
+        "failure_kind": { "type": ["string", "null"] },
+        "failure_ref": { "type": ["string", "null"] },
+        "selection_reason": { "type": "string", "minLength": 1 },
+        "config_source": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
+        "configuration_state": { "enum": ["user-explicit", "persisted-config"] },
+        "model_resolution_state": { "enum": ["discovered-and-validated", "user-explicit-unverifiable"] },
+        "dispatch_provenance": { "enum": ["explicit", "inherited-controller", "host-default"] },
+        "max_attempts": { "type": "integer", "minimum": 1 }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/orchestration-ledger-v1.schema.json

@@ -0,0 +1,110 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://agent-skills.local/schemas/orchestration-ledger-v1.schema.json", "title": "Orchestration Ledger v1", "type": "object", "required": ["schema_version", "runtime_version", "ledger_id", "revision", "contract_digest", "nodes", "edges", "attachments", "batches", "reflection_refs", "improvement_proposal_refs", "skill_provenance", "created_at", "updated_at"], "properties": { "schema_version": { "const": 1 }, "runtime_version": { "type": "string" }, "ledger_id": { "type": "string" }, "revision": { "type": "integer" }, "contract_digest": { "type": "string" }, "nodes": { "type": "object", "additionalProperties": { "$ref": "#/$defs/node" } }, "edges": { "type": "array" }, "attachments": { "type": "array", "items": { "$ref": "#/$defs/attachment" } }, "batches": { "type": "object" }, "reflection_refs": { "type": "array" }, "improvement_proposal_refs": { "type": "array" }, "skill_provenance": { "type": "object" }, "created_at": { "type": "string" }, "updated_at": { "type": "string" } }, "additionalProperties": false,
+  "$defs": {
+    "attachment": {
+      "type": "object",
+      "required": ["attachment_id", "node_id", "type", "digest", "ref"],
+      "properties": {
+        "attachment_id": { "type": "string" },
+        "node_id": { "type": "string" },
+        "type": { "enum": ["worktree", "artifact", "evidence", "loop", "report", "contract"] },
+        "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+        "ref": { "type": "string" }
+      }
+    },
+    "dispatch": {
+      "type": "object",
+      "required": ["schema_version", "worker_id", "orchestration_mode", "attempt_id", "attempt", "previous_attempt_id", "tier", "model", "reasoning_effort", "adjustment_action", "failure_kind", "failure_ref", "selection_reason", "config_source", "configuration_state", "model_resolution_state", "capability_source", "capability_fingerprint", "dispatch_provenance", "token_budget", "max_attempts"],
+      "properties": {
+        "schema_version": { "const": 2 },
+        "worker_id": { "type": "string", "minLength": 1 },
+        "orchestration_mode": { "enum": ["lightweight", "full"] },
+        "attempt_id": { "type": "string", "minLength": 1 },
+        "attempt": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 },
+        "previous_attempt_id": { "type": ["string", "null"] },
+        "tier": { "type": "string", "minLength": 1 },
+        "model": { "type": "string", "minLength": 1 },
+        "reasoning_effort": { "type": "string", "minLength": 1 },
+        "adjustment_action": { "enum": ["initial", "retry_same", "raise_effort", "switch_model", "promote_tier", "fresh_context", "change_strategy"] },
+        "failure_kind": { "type": ["string", "null"], "enum": [null, "implementation_defect", "reasoning_gap", "context_gap", "strategy_gap"] },
+        "failure_ref": { "type": ["string", "null"], "pattern": "^sha256:[0-9a-f]{64}$" },
+        "selection_reason": { "type": "string", "minLength": 1 },
+        "config_source": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
+        "configuration_state": { "enum": ["user-explicit", "session-inferred", "session-confirmed", "persisted-config", "host-default"] },
+        "model_resolution_state": { "enum": ["discovered-and-validated", "user-explicit-unverifiable", "host-default-unexposed"] },
+        "capability_source": { "type": "string", "minLength": 1 },
+        "capability_fingerprint": { "type": ["string", "null"], "pattern": "^sha256:[0-9a-f]{64}$" },
+        "dispatch_provenance": { "enum": ["explicit", "inherited-controller", "host-default"] },
+        "token_budget": { "oneOf": [{ "const": "unsupported" }, { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }] },
+        "max_attempts": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }
+      },
+      "additionalProperties": false,
+      "allOf": [
+        {
+          "if": { "properties": { "orchestration_mode": { "const": "full" } }, "required": ["orchestration_mode"] },
+          "then": { "properties": { "capability_fingerprint": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" } } }
+        },
+        {
+          "if": { "properties": { "model_resolution_state": { "const": "user-explicit-unverifiable" } }, "required": ["model_resolution_state"] },
+          "then": { "properties": { "configuration_state": { "const": "user-explicit" } } }
+        },
+        {
+          "if": { "properties": { "model_resolution_state": { "const": "host-default-unexposed" } }, "required": ["model_resolution_state"] },
+          "then": { "properties": { "model": { "const": "host-default" }, "configuration_state": { "const": "host-default" }, "dispatch_provenance": { "const": "host-default" } } }
+        },
+        {
+          "if": { "properties": { "attempt": { "const": 1 } }, "required": ["attempt"] },
+          "then": { "properties": { "adjustment_action": { "const": "initial" }, "previous_attempt_id": { "type": "null" }, "failure_kind": { "type": "null" }, "failure_ref": { "type": "null" } } },
+          "else": { "properties": { "adjustment_action": { "not": { "const": "initial" } }, "previous_attempt_id": { "type": "string", "minLength": 1 }, "failure_kind": { "type": "string" }, "failure_ref": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" } } }
+        }
+      ]
+    },
+    "node": {
+      "type": "object",
+      "required": ["node_id", "objective", "role", "required", "state", "permissions", "dependencies", "dispatch", "stable_outputs", "evidence", "created_at", "updated_at"],
+      "properties": {
+        "node_id": { "type": "string" },
+        "objective": { "type": "string" },
+        "role": { "enum": ["scout", "worker", "critic", "judge"] },
+        "required": { "type": "boolean" },
+        "state": { "enum": ["pending", "running", "blocked", "awaiting_verification", "passed", "failed", "cancelled"] },
+        "permissions": { "type": "object" },
+        "dependencies": { "type": "array" },
+        "dispatch": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/dispatch" }] },
+        "stable_outputs": { "type": "array" },
+        "evidence": { "type": "array" },
+        "verification": {
+          "type": "object",
+          "required": ["requirement", "provider", "artifact_scope"],
+          "properties": {
+            "requirement": { "description": "not_applicable 只允许 role 为 critic / scout 的只读评审节点，且必须搭配 provider none 与 artifact_scope not_applicable。", "enum": ["worker_self_check", "controller_recheck", "independent_evidence", "not_applicable"] },
+            "provider": { "enum": ["none", "verify-agent-output"] },
+            "artifact_scope": { "enum": ["node_output", "integration_candidate", "not_applicable"] }
+          },
+          "additionalProperties": false
+        },
+        "verification_assurance": { "enum": ["none", "worker_self_check", "controller_recheck", "independent_evidence", "not_applicable"] },
+        "verification_ref": { "type": ["string", "null"], "pattern": "^sha256:[0-9a-f]{64}$" },
+        "tokens": {
+          "oneOf": [
+            { "type": "null" },
+            { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
+            {
+              "type": "object",
+              "required": ["input_tokens", "output_tokens", "total_tokens"],
+              "properties": {
+                "input_tokens": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
+                "output_tokens": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
+                "total_tokens": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }
+              },
+              "additionalProperties": false
+            }
+          ]
+        },
+        "duration_ms": { "type": ["integer", "null"], "minimum": 0, "maximum": 9007199254740991 },
+        "created_at": { "type": "string" },
+        "updated_at": { "type": "string" }
+      }
+    }
+  }
+}

package/schemas/reflection-record-v1.schema.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-skills.local/schemas/reflection-record-v1.schema.json",
+  "title": "Reflection Record v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "reflection_id", "trigger", "scope", "affected_skill", "classification", "observation", "evidence_refs", "impact", "confidence", "recommended_disposition", "recorded_at", "reflection_digest"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "reflection_id": { "type": "string", "minLength": 1 },
+    "trigger": { "enum": ["repeated_failure", "undecidable", "user_correction", "runtime_abort", "workaround", "protocol_conflict", "unexpected_outcome", "terminal_retrospective"] },
+    "scope": { "type": "object", "required": ["contract_digest"], "properties": { "contract_digest": { "$ref": "#/$defs/digest" }, "loop_id": { "type": ["string", "null"] }, "iteration": { "type": ["integer", "null"] }, "run_id": { "type": ["string", "null"] } }, "additionalProperties": false },
+    "affected_skill": { "type": "object", "required": ["name", "version", "content_digest"], "properties": { "name": { "type": "string" }, "version": { "type": "string" }, "content_digest": { "$ref": "#/$defs/digest" } }, "additionalProperties": false },
+    "classification": { "enum": ["contract_gap", "skill_gap", "verification_gap", "tool_gap", "environment_gap", "false_positive", "false_negative", "inefficiency"] },
+    "observation": { "type": "string", "minLength": 1 },
+    "evidence_refs": { "type": "array", "items": { "type": "object", "required": ["type", "id", "digest"], "properties": { "type": { "enum": ["artifact", "evidence", "event", "diagnostic"] }, "id": { "type": "string" }, "digest": { "$ref": "#/$defs/digest" } }, "additionalProperties": false } },
+    "impact": { "enum": ["low", "medium", "high", "safety"] },
+    "confidence": { "enum": ["low", "medium", "high"] },
+    "recommended_disposition": { "enum": ["continue", "undecidable", "abort", "re_contract", "human_gate"] },
+    "recorded_at": { "type": "string", "format": "date-time" },
+    "reflection_digest": { "$ref": "#/$defs/digest" }
+  },
+  "$defs": { "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" } }
+}

package/schemas/review-result-v1.schema.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-skills.example/schemas/review-result-v1.schema.json",
+  "title": "Review Result v1",
+  "type": "object",
+  "required": ["schema_version", "review_result_id", "contract_digest", "verification_profile_digest", "artifact_ref", "challenge_nonce", "verdict", "findings", "forensics", "review_result_digest"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "review_result_id": { "type": "string", "minLength": 1 },
+    "contract_digest": { "$ref": "#/$defs/digest" },
+    "verification_profile_digest": { "$ref": "#/$defs/digest" },
+    "artifact_ref": { "type": "object" },
+    "challenge_nonce": { "type": "string", "minLength": 1 },
+    "verdict": { "enum": ["fail", "no_defect_found", "undecidable"] },
+    "findings": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["contract_item_id", "class", "evidence", "expected", "actual"],
+        "properties": {
+          "contract_item_id": { "type": "string", "minLength": 1 },
+          "class": { "enum": ["functional", "scope", "verification_definition", "safety"] },
+          "evidence": { "type": "string", "minLength": 1 },
+          "expected": { "type": "string", "minLength": 1 },
+          "actual": { "type": "string", "minLength": 1 }
+        },
+        "additionalProperties": false
+      }
+    },
+    "forensics": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+    "review_result_digest": { "$ref": "#/$defs/digest" }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }
+  }
+}

package/schemas/task-contract-v1.schema.json

@@ -0,0 +1,83 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-skills.example/schemas/task-contract-v1.schema.json",
+  "title": "Task Contract v1",
+  "type": "object",
+  "required": ["schema_version", "contract_id", "objective", "scope", "acceptance", "permissions", "environment", "skill_set", "stop_conditions", "extensions", "contract_digest"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "contract_id": { "type": "string", "minLength": 1 },
+    "objective": { "type": "string", "minLength": 1 },
+    "scope": {
+      "type": "object",
+      "required": ["include", "exclude"],
+      "properties": {
+        "include": { "type": "array" },
+        "exclude": { "type": "array" }
+      }
+    },
+    "acceptance": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["contract_item_id", "requirement"],
+        "properties": {
+          "contract_item_id": { "type": "string", "minLength": 1 },
+          "requirement": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "permissions": { "type": "object" },
+    "environment": { "type": "object" },
+    "skill_set": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["name", "version", "content_digest", "provider_mode"],
+        "properties": {
+          "name": { "type": "string", "minLength": 1 },
+          "version": { "type": "string", "minLength": 1 },
+          "content_digest": { "$ref": "#/$defs/digest" },
+          "provider_mode": { "enum": ["primary", "optional"] }
+        }
+      }
+    },
+    "stop_conditions": { "type": "array" },
+    "extensions": {
+      "type": "object",
+      "properties": {
+        "verification": {
+          "type": "object",
+          "required": ["provider"],
+          "properties": {
+            "provider": { "enum": ["none", "verify-agent-output", "run-agent-verify-loop"] }
+          }
+        },
+        "review_policy": {
+          "type": "object",
+          "required": ["schema_version", "max_primary_reviews_per_artifact", "max_escalation_reviews_per_artifact", "require_distinct_lens", "review_only_after_smoke_pass", "max_review_input_tokens"],
+          "properties": {
+            "schema_version": { "const": 1 },
+            "max_primary_reviews_per_artifact": { "type": "integer", "minimum": 0 },
+            "max_escalation_reviews_per_artifact": { "type": "integer", "minimum": 0 },
+            "require_distinct_lens": { "type": "boolean" },
+            "review_only_after_smoke_pass": { "type": "boolean" },
+            "max_review_input_tokens": { "type": "integer", "minimum": 1 }
+          },
+          "additionalProperties": false
+        },
+        "projection": {
+          "type": "object",
+          "required": ["parent_contract_digest", "projected_item_ids"],
+          "properties": {
+            "parent_contract_digest": { "$ref": "#/$defs/digest" },
+            "projected_item_ids": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }
+          }
+        }
+      }
+    },
+    "contract_digest": { "$ref": "#/$defs/digest" }
+  },
+  "$defs": { "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" } }
+}

package/schemas/verification-profile-v1.schema.json

@@ -0,0 +1,60 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-skills.example/schemas/verification-profile-v1.schema.json",
+  "title": "Verification Profile v1",
+  "type": "object",
+  "required": ["schema_version", "profile_id", "l0_checks", "l1_review", "protected_verifier_paths", "allowed_validation_changes", "runtime", "human_gate", "verification_profile_digest"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "profile_id": { "type": "string", "minLength": 1 },
+    "l0_checks": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["check_id", "argv", "cwd_rel", "stage", "timeout_ms", "expected_exit_codes"],
+        "properties": {
+          "check_id": { "type": "string", "minLength": 1 },
+          "argv": { "type": "array", "minItems": 1, "items": { "type": "string" } },
+          "cwd_rel": { "type": "string", "minLength": 1 },
+          "stage": { "enum": ["smoke", "final", "both"] },
+          "timeout_ms": { "type": "integer", "minimum": 1 },
+          "expected_exit_codes": { "type": "array", "minItems": 1, "items": { "type": "integer" } }
+        },
+        "additionalProperties": false
+      }
+    },
+    "l1_review": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["contract_item_id", "lenses"],
+        "properties": {
+          "contract_item_id": { "type": "string", "minLength": 1 },
+          "lenses": {
+            "type": "array",
+            "items": { "enum": ["functional", "scope", "verification_definition", "safety"] }
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "protected_verifier_paths": { "type": "array", "items": { "type": "string" } },
+    "allowed_validation_changes": { "type": "array", "items": { "type": "string" } },
+    "runtime": {
+      "type": "object",
+      "required": ["env_allowlist", "executable_paths", "cache_policy", "network_policy", "max_log_bytes"],
+      "properties": {
+        "env_allowlist": { "type": "array", "items": { "type": "string" } },
+        "executable_paths": { "type": "object", "additionalProperties": { "type": "string" } },
+        "cache_policy": { "enum": ["disabled", "isolated", "trusted_identity"] },
+        "network_policy": { "enum": ["denied", "contract_authorized"] },
+        "max_log_bytes": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "human_gate": { "enum": ["none", "release", "destructive", "external_side_effect"] },
+    "verification_profile_digest": { "$ref": "#/$defs/digest" }
+  },
+  "$defs": { "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" } }
+}

package/schemas/worker-capability-requirements-v1.schema.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-skills.local/schemas/worker-capability-requirements-v1.schema.json",
+  "title": "Worker Capability Requirements v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "host", "worker_profile", "capability_fingerprint", "binding", "required"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "host": { "type": "string", "pattern": "^[a-z0-9][a-z0-9._-]{0,63}$" },
+    "worker_profile": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$" },
+    "capability_fingerprint": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+    "binding": { "type": "string", "pattern": "^(session:[A-Za-z0-9._-]{1,128}|config:sha256:[0-9a-f]{64})$" },
+    "required": {
+      "description": "节点真正需要的 worker 能力键。每一项必须以 worker. 前缀开头（例如 worker.read.cwd、worker.execute_commands）；host.*、shell.* 等其他前缀一律拒绝。空数组表示 not_required，此时无需提供 Effective Worker Capability。",
+      "type": "array",
+      "uniqueItems": true,
+      "items": { "type": "string", "description": "worker. 前缀 + 小写点分能力名，例如 worker.read.cwd", "pattern": "^worker\\.[a-z][a-z0-9_.-]{0,63}$" }
+    }
+  }
+}

package/schemas/worktree-binding-v1.schema.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-skills.local/schemas/worktree-binding-v1.schema.json",
+  "title": "Worktree Binding v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "provider", "repository_id", "worktree_id", "workdir", "branch", "owner", "base_sha", "head_sha", "task_status", "worktree_state"],
+  "properties": {
+    "schema_version": { "const": 1 }, "provider": { "const": "manage-worktrees" }, "repository_id": { "type": "string" }, "worktree_id": { "type": "string" }, "workdir": { "type": "string" }, "branch": { "type": ["string", "null"] },
+    "owner": { "type": "object", "additionalProperties": false, "required": ["agent", "agent_id", "epoch"], "properties": { "agent": { "type": "string" }, "agent_id": { "type": "string" }, "epoch": { "type": "integer", "minimum": 1 } } },
+    "base_sha": { "type": "string", "pattern": "^(?:[0-9a-f]{40}|[0-9a-f]{64})$" }, "head_sha": { "type": "string", "pattern": "^(?:[0-9a-f]{40}|[0-9a-f]{64})$" },
+    "task_status": { "enum": ["active", "blocked", "ready_for_review", "integrating", "done", "abandoned"] }, "worktree_state": { "enum": ["present", "missing", "reclaim_ready", "reclaimed"] }
+  }
+}