@opensoha/contracts 0.1.4

package/fixtures/json-schema/approval-request/invalid/missing-status.json

@@ -0,0 +1,12 @@
+{
+  "id": "approval-01HZW9WJQ3Y7QH3QZW2KN4T4GX",
+  "strategy": "role_quorum",
+  "actorType": "user",
+  "actorId": "user-123",
+  "toolName": "k8s.deployments.restart",
+  "riskLevel": "high",
+  "requiresApproval": true,
+  "summary": "Restart checkout-api deployment in payments namespace.",
+  "createdAt": "2026-06-12T02:30:00Z",
+  "updatedAt": "2026-06-12T02:30:00Z"
+}

package/fixtures/json-schema/approval-request/valid/high-risk-tool.json

@@ -0,0 +1,56 @@
+{
+  "id": "approval-01HZW9WJQ3Y7QH3QZW2KN4T4GX",
+  "status": "pending",
+  "strategy": "role_quorum",
+  "policyId": "policy-prod-mutate",
+  "approvalPolicyRef": "gateway.prod-mutate",
+  "actorType": "user",
+  "actorId": "user-123",
+  "actorName": "Ada",
+  "actorRoles": ["sre"],
+  "actorTeams": ["platform"],
+  "aiClientId": "codex-local",
+  "aiClientName": "Codex",
+  "skillId": "k8s-sre",
+  "toolName": "k8s.deployments.restart",
+  "riskLevel": "high",
+  "requiresApproval": true,
+  "resourceScope": {
+    "clusterId": "cluster-prod",
+    "namespace": "payments"
+  },
+  "toolInput": {
+    "deployment": "checkout-api"
+  },
+  "relatedIds": {
+    "requestId": "req-approval-123"
+  },
+  "approvalTrace": {
+    "approvalMode": "role_quorum",
+    "currentStageIndex": 0,
+    "currentStageName": "platform-sre",
+    "stageCount": 1,
+    "approvedCount": 0,
+    "requiredApprovals": 1,
+    "pendingRequirements": ["role:sre"],
+    "candidateRoles": ["sre"]
+  },
+  "timelineEvents": [
+    {
+      "id": "approval-event-1",
+      "kind": "approval",
+      "action": "created",
+      "result": "pending",
+      "summary": "Approval request created.",
+      "actorType": "user",
+      "actorId": "user-123",
+      "createdAt": "2026-06-12T02:30:00Z"
+    }
+  ],
+  "summary": "Restart checkout-api deployment in payments namespace.",
+  "requestId": "req-approval-123",
+  "sourceIp": "203.0.113.10",
+  "expiresAt": "2026-06-12T03:00:00Z",
+  "createdAt": "2026-06-12T02:30:00Z",
+  "updatedAt": "2026-06-12T02:30:00Z"
+}

package/fixtures/json-schema/audit-log/invalid/extra-field.json

@@ -0,0 +1,10 @@
+{
+  "id": "audit-01HZW9WJQ3Y7QH3QZW2KN4T4GX",
+  "actorType": "user",
+  "actorId": "user-123",
+  "action": "tool.invoke",
+  "result": "denied",
+  "summary": "High-risk deployment restart was denied because approval is required.",
+  "createdAt": "2026-06-12T02:31:00Z",
+  "secretToken": "must-not-be-here"
+}

package/fixtures/json-schema/audit-log/valid/tool-denied.json

@@ -0,0 +1,23 @@
+{
+  "id": "audit-01HZW9WJQ3Y7QH3QZW2KN4T4GX",
+  "actorType": "user",
+  "actorId": "user-123",
+  "actorName": "Ada",
+  "aiClientId": "codex-local",
+  "skillId": "k8s-sre",
+  "toolName": "k8s.deployments.restart",
+  "riskLevel": "high",
+  "resourceScope": {
+    "clusterId": "cluster-prod",
+    "namespace": "payments"
+  },
+  "action": "tool.invoke",
+  "result": "denied",
+  "summary": "High-risk deployment restart was denied because approval is required.",
+  "requestId": "req-audit-123",
+  "sourceIp": "203.0.113.10",
+  "metadata": {
+    "approvalRequestId": "approval-01HZW9WJQ3Y7QH3QZW2KN4T4GX"
+  },
+  "createdAt": "2026-06-12T02:31:00Z"
+}

package/fixtures/json-schema/cluster-capability-matrix/invalid/missing-agent-support.json

@@ -0,0 +1,16 @@
+{
+  "generatedAt": "2026-06-12T02:00:00Z",
+  "items": [
+    {
+      "key": "kubernetes.exec",
+      "label": "Exec Into Pod",
+      "category": "exec",
+      "riskLevel": "execute",
+      "requiresApproval": true,
+      "direct": {
+        "status": "available",
+        "requiredScopes": ["cluster:exec"]
+      }
+    }
+  ]
+}

package/fixtures/json-schema/cluster-capability-matrix/invalid/partial-without-reason.json

@@ -0,0 +1,18 @@
+{
+  "generatedAt": "2026-06-12T02:00:00Z",
+  "items": [
+    {
+      "key": "kubernetes.logs.stream",
+      "label": "Stream Kubernetes Logs",
+      "category": "logs",
+      "riskLevel": "read",
+      "requiresApproval": false,
+      "direct": {
+        "status": "available"
+      },
+      "agent": {
+        "status": "partial"
+      }
+    }
+  ]
+}

package/fixtures/json-schema/cluster-capability-matrix/valid/runtime-parity.json

@@ -0,0 +1,59 @@
+{
+  "generatedAt": "2026-06-12T02:00:00Z",
+  "capabilitySetVersion": "2026.06",
+  "items": [
+    {
+      "key": "kubernetes.yaml.apply",
+      "label": "Apply Kubernetes YAML",
+      "category": "yaml",
+      "riskLevel": "mutate",
+      "requiresApproval": true,
+      "direct": {
+        "status": "available",
+        "requiredScopes": ["cluster:write", "kubernetes:apply"]
+      },
+      "agent": {
+        "status": "available",
+        "requiredAgentVersion": "0.1.0",
+        "requiredScopes": ["agent:kubernetes:apply"]
+      },
+      "metadata": {
+        "resourceKinds": ["Deployment", "Service", "ConfigMap"]
+      }
+    },
+    {
+      "key": "kubernetes.logs.stream",
+      "label": "Stream Kubernetes Logs",
+      "category": "logs",
+      "riskLevel": "read",
+      "requiresApproval": false,
+      "direct": {
+        "status": "available",
+        "requiredScopes": ["cluster:read", "logs:read"]
+      },
+      "agent": {
+        "status": "partial",
+        "reason": "Agent stream resume is limited to one active container per request.",
+        "diagnostic": "upgrade_agent_for_multi_container_logs",
+        "requiredAgentVersion": "0.1.0",
+        "requiredScopes": ["agent:logs:read"]
+      }
+    },
+    {
+      "key": "docker.runtime.stream",
+      "label": "Docker Runtime Streams",
+      "category": "docker",
+      "riskLevel": "execute",
+      "requiresApproval": true,
+      "direct": {
+        "status": "unsupported",
+        "reason": "Docker runtime streams require an agent runtime."
+      },
+      "agent": {
+        "status": "available",
+        "requiredAgentVersion": "0.1.0",
+        "requiredScopes": ["agent:docker:execute"]
+      }
+    }
+  ]
+}

package/fixtures/json-schema/conformance-run/invalid/missing.json

@@ -0,0 +1 @@
+{}

package/fixtures/json-schema/conformance-run/valid/passed.json

@@ -0,0 +1 @@
+{"schemaVersion":"opensoha.dev/agent-conformance-run/v1","id":"conformance-1","providerRef":"codex:v1","environmentRef":"container:v1","suiteVersion":"v1","status":"passed","results":[{"name":"cancel","passed":true}],"startedAt":"2026-07-15T00:00:00Z"}

package/fixtures/json-schema/connector-checkpoint/invalid/missing.json

@@ -0,0 +1 @@
+{}

package/fixtures/json-schema/connector-checkpoint/valid/http.json

@@ -0,0 +1 @@
+{"schemaVersion":"opensoha.dev/knowledge-connector-checkpoint/v1","sourceId":"source-1","connectorVersion":"v1","cursor":{"etag":"abc"},"configHash":"sha256:0000000000000000000000000000000000000000000000000000000000000000","committedAt":"2026-07-15T00:00:00Z"}

package/fixtures/json-schema/connector-definition/invalid/missing.json

@@ -0,0 +1 @@
+{}

package/fixtures/json-schema/connector-definition/valid/http.json

@@ -0,0 +1 @@
+{"schemaVersion":"opensoha.dev/knowledge-connector-definition/v1","id":"docs-http","kind":"http","version":"v1","configRef":"secret:http-docs","enabled":true}

package/fixtures/json-schema/connector-event-envelope/invalid/missing-payload.json

@@ -0,0 +1,11 @@
+{
+  "connectorId": "feishu",
+  "events": [
+    {
+      "id": "feishu-msg-01HZW9WJQ3Y7QH3QZW2KN4T4GX",
+      "type": "im.message.receive_v1",
+      "source": "feishu",
+      "occurredAt": "2026-06-11T08:30:00Z"
+    }
+  ]
+}

package/fixtures/json-schema/connector-event-envelope/invalid/unknown-top-level-field.json

@@ -0,0 +1,13 @@
+{
+  "connectorId": "feishu",
+  "events": [
+    {
+      "id": "feishu-msg-01HZW9WJQ3Y7QH3QZW2KN4T4GX",
+      "type": "im.message.receive_v1",
+      "source": "feishu",
+      "occurredAt": "2026-06-11T08:30:00Z",
+      "payload": {}
+    }
+  ],
+  "rawSecret": "must-not-be-top-level"
+}

package/fixtures/json-schema/connector-event-envelope/valid/feishu-message.json

@@ -0,0 +1,19 @@
+{
+  "connectorId": "feishu",
+  "events": [
+    {
+      "id": "feishu-msg-01HZW9WJQ3Y7QH3QZW2KN4T4GX",
+      "type": "im.message.receive_v1",
+      "source": "feishu",
+      "occurredAt": "2026-06-11T08:30:00Z",
+      "subject": "chat:oc_1234567890",
+      "payload": {
+        "messageId": "om_1234567890",
+        "chatId": "oc_1234567890",
+        "senderId": "ou_1234567890",
+        "messageType": "text",
+        "text": "deploy status?"
+      }
+    }
+  ]
+}

package/fixtures/json-schema/context-envelope/invalid/envelope.json

@@ -0,0 +1 @@
+{"version":"v2","id":"context-1","requestId":"","principal":{},"task":{"goal":""},"budgets":{},"budgetUsage":{},"policySnapshot":{},"contentHash":"invalid","createdAt":"not-a-date"}

package/fixtures/json-schema/context-envelope/valid/envelope.json

@@ -0,0 +1 @@
+{"version":"v1","id":"context-1","requestId":"request-1","principal":{"userId":"user-1"},"task":{"goal":"diagnose rollout"},"budgets":{"maxInputTokens":16000},"budgetUsage":{"evidenceTokens":0},"policySnapshot":{"id":"knowledge-acl","version":"v1"},"contentHash":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","createdAt":"2026-07-14T00:00:00Z"}

package/fixtures/json-schema/environment-lease/invalid/unbounded.json

@@ -0,0 +1 @@
+{"schemaVersion":"opensoha.dev/environment-lease/v1","id":"lease-1","runId":"run-1","ownerId":"runner-1","scopeHash":"sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc","mode":"observe-only","quota":{"diskBytes":0,"memoryBytes":2048,"cpuUnits":100,"maxProcesses":2,"networkEgress":false},"issuedAt":"2026-07-14T08:00:00Z","expiresAt":"2026-07-14T08:10:00Z"}

package/fixtures/json-schema/environment-lease/valid/observe.json

@@ -0,0 +1 @@
+{"schemaVersion":"opensoha.dev/environment-lease/v1","id":"lease-1","runId":"run-1","ownerId":"runner-1","scopeHash":"sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc","mode":"observe-only","quota":{"diskBytes":1024,"memoryBytes":2048,"cpuUnits":100,"maxProcesses":2,"networkEgress":false},"issuedAt":"2026-07-14T08:00:00Z","expiresAt":"2026-07-14T08:10:00Z"}

package/fixtures/json-schema/environment-snapshot/invalid/negative-usage.json

@@ -0,0 +1 @@
+{"schemaVersion":"opensoha.dev/environment-snapshot/v1","leaseId":"lease-1","runId":"run-1","state":"active","resourceUsage":{"diskBytes":-1,"memoryBytes":20,"cpuTimeNanos":30,"processes":1},"observedAt":"2026-07-14T08:00:00Z"}

package/fixtures/json-schema/environment-snapshot/valid/active.json

@@ -0,0 +1 @@
+{"schemaVersion":"opensoha.dev/environment-snapshot/v1","leaseId":"lease-1","runId":"run-1","state":"active","resourceUsage":{"diskBytes":10,"memoryBytes":20,"cpuTimeNanos":30,"processes":1},"artifactRefs":["artifact:1"],"observedAt":"2026-07-14T08:00:00Z"}

package/fixtures/json-schema/environment-template/invalid/missing.json

@@ -0,0 +1 @@
+{}

package/fixtures/json-schema/environment-template/valid/container.json

@@ -0,0 +1 @@
+{"schemaVersion":"opensoha.dev/agent-environment-template/v1","id":"eval-container","version":"v1","backend":"container","isolationMode":"disposable-write","quota":{"cpuUnits":1000,"memoryBytes":1073741824,"diskBytes":1073741824,"maxProcesses":32},"ttlSeconds":3600,"enabled":true}

package/fixtures/json-schema/evaluation-dataset/invalid/no-samples.json

@@ -0,0 +1 @@
+{"schemaVersion":"opensoha.dev/evaluation-dataset/v1","id":"rag-regression","name":"RAG regression","version":"v1","samples":[],"createdAt":"2026-07-14T08:00:00Z"}

package/fixtures/json-schema/evaluation-dataset/valid/minimal.json

@@ -0,0 +1 @@
+{"schemaVersion":"opensoha.dev/evaluation-dataset/v1","id":"rag-regression","name":"RAG regression","version":"v1","samples":[{"id":"s1","input":"What failed?","expectedSources":["doc:1"],"forbiddenActions":["delete"]}],"createdAt":"2026-07-14T08:00:00Z"}

package/fixtures/json-schema/evaluation-result/invalid/bad-score.json

@@ -0,0 +1 @@
+{"schemaVersion":"opensoha.dev/evaluation-result/v1","sampleId":"s1","scores":{"source_recall":1.2},"passed":true}

package/fixtures/json-schema/evaluation-result/valid/passed.json

@@ -0,0 +1 @@
+{"schemaVersion":"opensoha.dev/evaluation-result/v1","sampleId":"s1","scores":{"source_recall":1,"action_safety":1},"passed":true}

package/fixtures/json-schema/evaluation-run/invalid/no-candidate.json

@@ -0,0 +1 @@
+{"schemaVersion":"opensoha.dev/evaluation-run/v1","id":"eval-1","datasetId":"rag-regression","datasetVersion":"v1","candidateRefs":{},"status":"running","startedAt":"2026-07-14T08:00:00Z"}

package/fixtures/json-schema/evaluation-run/valid/running.json

@@ -0,0 +1 @@
+{"schemaVersion":"opensoha.dev/evaluation-run/v1","id":"eval-1","datasetId":"rag-regression","datasetVersion":"v1","candidateRefs":{"prompt":"prompt:v2"},"status":"running","startedAt":"2026-07-14T08:00:00Z"}

package/fixtures/json-schema/event-envelope/invalid/bad-severity.json

@@ -0,0 +1,7 @@
+{
+  "id": "evt-1",
+  "source": "soha-core",
+  "category": "audit",
+  "severity": "urgent",
+  "summary": "Plugin was installed."
+}

package/fixtures/json-schema/event-envelope/valid/minimal.json

@@ -0,0 +1,14 @@
+{
+  "id": "evt-1",
+  "tenantId": "default",
+  "workspaceId": "default",
+  "source": "soha-core",
+  "category": "audit",
+  "eventType": "plugin.installed",
+  "severity": "info",
+  "summary": "Plugin was installed.",
+  "timestamp": "2026-06-09T12:00:00Z",
+  "payload": {
+    "pluginId": "opensoha.k8s-sre"
+  }
+}

package/fixtures/json-schema/executor-profile/invalid/missing.json

@@ -0,0 +1 @@
+{}

package/fixtures/json-schema/executor-profile/valid/readonly.json

@@ -0,0 +1 @@
+{"schemaVersion":"opensoha.dev/evaluation-executor-profile/v1","id":"readonly","environmentPolicy":"evaluation-readonly","isolationMode":"read-only","timeoutSeconds":120,"enabled":true}

package/fixtures/json-schema/feedback-sample/invalid/missing.json

@@ -0,0 +1 @@
+{}

package/fixtures/json-schema/feedback-sample/valid/pending.json

@@ -0,0 +1 @@
+{"schemaVersion":"opensoha.dev/evaluation-feedback-sample/v1","id":"feedback-1","traceRef":"trace-1","scopeHash":"sha256:0000000000000000000000000000000000000000000000000000000000000000","redactedInput":"question","redactedOutput":"answer","licenseRef":"internal-evaluation","decision":"pending","createdAt":"2026-07-15T00:00:00Z"}

package/fixtures/json-schema/fleet-target/invalid/missing.json

@@ -0,0 +1 @@
+{}

package/fixtures/json-schema/fleet-target/valid/linux.json

@@ -0,0 +1 @@
+{"schemaVersion":"opensoha.dev/agent-fleet-target/v1","platforms":["linux"],"architectures":["amd64"]}

package/fixtures/json-schema/gate-decision/invalid/missing.json

@@ -0,0 +1 @@
+{}

package/fixtures/json-schema/gate-decision/valid/pass.json

@@ -0,0 +1 @@
+{"schemaVersion":"opensoha.dev/evaluation-gate-decision/v1","id":"decision-1","policyId":"release","policyVersion":"v1","baselineRunId":"run-1","candidateRunId":"run-2","decision":"pass","reasons":[],"evidenceRefs":["evaluation-run:run-2"],"evaluatedAt":"2026-07-15T00:00:00Z"}

package/fixtures/json-schema/gate-policy/invalid/missing.json

@@ -0,0 +1 @@
+{}

package/fixtures/json-schema/gate-policy/valid/release.json

@@ -0,0 +1 @@
+{"schemaVersion":"opensoha.dev/evaluation-gate-policy/v1","id":"release","version":"v1","minimumScores":{"fact_recall":0.8},"enabled":true}

package/fixtures/json-schema/gateway-capability-baseline/invalid/missing-owner.json

@@ -0,0 +1,32 @@
+{
+  "schemaVersion": "opensoha.dev/gateway-capability-catalog/v1",
+  "version": "0.1.0",
+  "source": {
+    "repository": "github.com/opensoha/soha",
+    "path": "internal/application/aigateway/catalog.go",
+    "syncStrategy": "stable-runtime entries are checked against runtime Gateway catalog output before release."
+  },
+  "tools": [
+    {
+      "name": "delivery.execution_logs.list",
+      "title": "List Execution Logs",
+      "domain": "delivery",
+      "action": "logs",
+      "riskLevel": "read",
+      "permissionKeys": ["ai.gateway.invoke", "delivery.execution-tasks.view"],
+      "requiredScopes": ["application", "environment", "executionTask"],
+      "mcpAdapterId": "delivery.v1",
+      "mcpToolName": "delivery.execution_logs.list",
+      "requiresApproval": false,
+      "status": "stable-runtime",
+      "skillRefs": ["delivery-tester"],
+      "audit": {
+        "resourceKind": "AIGatewayTool",
+        "relatedIds": ["taskId"]
+      },
+      "redaction": ["logs"],
+      "moduleId": "delivery",
+      "routeEvidence": ["registerDeliveryRoutes"]
+    }
+  ]
+}

package/fixtures/json-schema/gateway-capability-baseline/valid/minimal.json

@@ -0,0 +1,61 @@
+{
+  "schemaVersion": "opensoha.dev/gateway-capability-catalog/v1",
+  "version": "0.1.0",
+  "source": {
+    "repository": "github.com/opensoha/soha",
+    "path": "internal/application/aigateway/catalog.go",
+    "syncStrategy": "stable-runtime entries are checked against runtime Gateway catalog output before release."
+  },
+  "plannedSkills": ["gateway-governance"],
+  "tools": [
+    {
+      "name": "delivery.execution_logs.list",
+      "title": "List Execution Logs",
+      "domain": "delivery",
+      "owningWorkbench": "delivery",
+      "owningService": "internal/application/delivery.Service",
+      "action": "logs",
+      "riskLevel": "read",
+      "permissionKeys": ["ai.gateway.invoke", "delivery.execution-tasks.view"],
+      "requiredScopes": ["application", "environment", "executionTask"],
+      "mcpAdapterId": "delivery.v1",
+      "mcpToolName": "delivery.execution_logs.list",
+      "requiresApproval": false,
+      "status": "stable-runtime",
+      "skillRefs": ["delivery-tester"],
+      "resourceRefs": ["soha://delivery/execution-tasks"],
+      "promptRefs": ["soha.delivery.plan_release"],
+      "audit": {
+        "resourceKind": "AIGatewayTool",
+        "relatedIds": ["taskId"]
+      },
+      "redaction": ["logs"],
+      "moduleId": "delivery",
+      "routeEvidence": ["registerDeliveryRoutes", "registerAIGatewayRoutes"]
+    }
+  ],
+  "resources": [
+    {
+      "name": "soha://delivery/execution-tasks",
+      "description": "Durable delivery execution tasks, callbacks, artifacts, and logs.",
+      "permissionKeys": ["ai.gateway.invoke", "delivery.execution-tasks.view"],
+      "requiredScopes": ["application", "environment"],
+      "status": "stable-runtime",
+      "skillRefs": ["delivery-tester"],
+      "toolRefs": ["delivery.execution_logs.list"],
+      "promptRefs": ["soha.delivery.plan_release"]
+    }
+  ],
+  "prompts": [
+    {
+      "name": "soha.delivery.plan_release",
+      "description": "Build a release or rollback plan from delivery evidence.",
+      "permissionKeys": ["ai.gateway.invoke", "delivery.applications.view"],
+      "requiredScopes": ["application", "environment"],
+      "status": "stable-runtime",
+      "skillRefs": ["delivery-tester"],
+      "toolRefs": ["delivery.execution_logs.list"],
+      "resourceRefs": ["soha://delivery/execution-tasks"]
+    }
+  ]
+}

package/fixtures/json-schema/gateway-manifest/invalid/bad-risk-level.json

@@ -0,0 +1,37 @@
+{
+  "name": "soha-ai-gateway",
+  "version": "0.1.0",
+  "generatedAt": "2026-06-09T12:00:00Z",
+  "principal": {
+    "userId": "u-1",
+    "userName": "admin",
+    "email": "admin@example.com",
+    "roles": [],
+    "teams": [],
+    "projects": [],
+    "tags": []
+  },
+  "caller": {
+    "identityMode": "user"
+  },
+  "permissionKeys": [],
+  "tools": [
+    {
+      "name": "dangerous.tool",
+      "title": "Dangerous tool",
+      "description": "Invalid risk level should fail.",
+      "domain": "test",
+      "action": "mutate",
+      "riskLevel": "catastrophic",
+      "permissionKeys": [],
+      "requiresApproval": true
+    }
+  ],
+  "summary": {
+    "toolCount": 1,
+    "resourceCount": 0,
+    "promptCount": 0,
+    "skillCount": 0,
+    "deniedCount": 0
+  }
+}

package/fixtures/json-schema/gateway-manifest/valid/minimal.json

@@ -0,0 +1,48 @@
+{
+  "name": "soha-ai-gateway",
+  "version": "0.1.0",
+  "generatedAt": "2026-06-09T12:00:00Z",
+  "principal": {
+    "userId": "u-1",
+    "userName": "admin",
+    "email": "admin@example.com",
+    "roles": ["platform-admin"],
+    "teams": [],
+    "projects": [],
+    "tags": [],
+    "permissionKeys": ["ai.gateway.tools.read"]
+  },
+  "caller": {
+    "identityMode": "user",
+    "source": "cli"
+  },
+  "permissionKeys": ["ai.gateway.tools.read"],
+  "tools": [
+    {
+      "name": "k8s.list_pods",
+      "title": "List pods",
+      "description": "List Kubernetes pods in a namespace.",
+      "domain": "kubernetes",
+      "action": "read",
+      "riskLevel": "read",
+      "permissionKeys": ["k8s.pods.read"],
+      "requiresApproval": false,
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "namespace": { "type": "string" }
+        }
+      }
+    }
+  ],
+  "resources": [],
+  "prompts": [],
+  "skills": [],
+  "summary": {
+    "toolCount": 1,
+    "resourceCount": 0,
+    "promptCount": 0,
+    "skillCount": 0,
+    "deniedCount": 0
+  }
+}

package/fixtures/json-schema/graph-revision/invalid/missing.json

@@ -0,0 +1 @@
+{}

package/fixtures/json-schema/graph-revision/valid/active.json

@@ -0,0 +1 @@
+{"schemaVersion":"opensoha.dev/knowledge-graph-revision/v1","id":"graph-1","knowledgeBaseId":"kb-1","sourceIndexRef":"revision-2","extractorVersion":"v1","status":"active","entityCount":20,"relationCount":10,"createdAt":"2026-07-15T00:00:00Z"}

package/fixtures/json-schema/index-publish/invalid/missing.json

@@ -0,0 +1 @@
+{}

package/fixtures/json-schema/index-publish/valid/publish.json

@@ -0,0 +1 @@
+{"schemaVersion":"opensoha.dev/knowledge-index-publish/v1","knowledgeBaseId":"kb-1","revisionId":"revision-2","expectedActiveRevision":"revision-1","decision":"publish","decidedAt":"2026-07-15T00:00:00Z"}

package/fixtures/json-schema/ingestion-job/invalid/missing.json

@@ -0,0 +1 @@
+{}

package/fixtures/json-schema/ingestion-job/valid/queued.json

@@ -0,0 +1 @@
+{"schemaVersion":"opensoha.dev/knowledge-ingestion-job/v1","id":"job-1","sourceId":"source-1","targetRevision":"revision-2","stage":"discovering","status":"queued","attempt":0,"createdAt":"2026-07-15T00:00:00Z"}

package/fixtures/json-schema/ingestion-stage/invalid/missing.json

@@ -0,0 +1 @@
+{}

package/fixtures/json-schema/ingestion-stage/valid/succeeded.json

@@ -0,0 +1 @@
+{"schemaVersion":"opensoha.dev/knowledge-ingestion-stage/v1","jobId":"job-1","stage":"discovering","attempt":1,"status":"succeeded","completedAt":"2026-07-15T00:00:00Z"}

package/fixtures/json-schema/knowledge-base/invalid/base.json

@@ -0,0 +1 @@
+{"id":"base-1","name":"","status":"unknown","ownerId":"user-1","scope":{"visibility":"private"},"retrievalPolicy":{}}

package/fixtures/json-schema/knowledge-base/valid/base.json

@@ -0,0 +1 @@
+{"id":"base-1","name":"Runbooks","status":"active","ownerId":"user-1","scope":{"visibility":"private","users":["user-1"]},"retrievalPolicy":{"defaultTopK":5,"maxTopK":20,"lexicalWeight":0.45,"vectorWeight":0.55,"minScore":0.05},"createdAt":"2026-07-14T00:00:00Z","updatedAt":"2026-07-14T00:00:00Z"}

package/fixtures/json-schema/knowledge-search/invalid/search.json

@@ -0,0 +1 @@
+{"knowledgeBaseIds":[],"query":"","topK":500}

package/fixtures/json-schema/knowledge-search/valid/search.json

@@ -0,0 +1 @@
+{"knowledgeBaseIds":["base-1"],"query":"deployment readiness probe","topK":5,"filters":{"sourceIds":["source-1"]}}

package/fixtures/json-schema/knowledge-source/invalid/source.json

@@ -0,0 +1 @@
+{"id":"source-1","knowledgeBaseId":"base-1","name":"Runbooks","kind":"database","syncPolicy":{"mode":"sometimes"},"status":"pending"}

package/fixtures/json-schema/knowledge-source/valid/source.json

@@ -0,0 +1 @@
+{"id":"source-1","knowledgeBaseId":"base-1","name":"Runbooks","kind":"git","configRef":"secret://git","syncPolicy":{"mode":"manual"},"status":"pending","createdAt":"2026-07-14T00:00:00Z","updatedAt":"2026-07-14T00:00:00Z"}

package/fixtures/json-schema/marketplace-catalog/invalid/missing-source.json

@@ -0,0 +1,5 @@
+{
+  "schemaVersion": "marketplace.opensoha.io/v1",
+  "generatedAt": "2026-06-28T00:00:00Z",
+  "plugins": []
+}