@piagent/platform 1.2.17 → 1.3.0-ie.9

package/schemas/benchmark-assurance-evidence.schema.json

@@ -0,0 +1,142 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://piagent.local/schemas/benchmark-assurance-evidence.schema.json",
+  "title": "Piagent benchmark assurance evidence",
+  "oneOf": [
+    { "$ref": "#/$defs/legacyV1" },
+    { "$ref": "#/$defs/custodyV2" }
+  ],
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "completeResults": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["total", "passed"],
+      "properties": {
+        "total": { "type": "integer", "minimum": 1 },
+        "passed": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "mutationResults": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["total", "killed"],
+      "properties": {
+        "total": { "type": "integer", "minimum": 1 },
+        "killed": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "legacyV1": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schemaVersion", "claimTier", "visibility", "familyDisjointSplit", "holdoutManifestDigest", "referenceSolutionDigest", "mutationReportDigest", "calibrationReportDigest", "referenceSolutions", "mutationChecks", "calibration"],
+      "properties": {
+        "schemaVersion": { "const": 1 },
+        "claimTier": { "enum": ["private-holdout", "production-shadow"] },
+        "visibility": { "const": "external-private-holdout" },
+        "familyDisjointSplit": { "const": true },
+        "holdoutManifestDigest": { "$ref": "#/$defs/sha256" },
+        "referenceSolutionDigest": { "$ref": "#/$defs/sha256" },
+        "mutationReportDigest": { "$ref": "#/$defs/sha256" },
+        "calibrationReportDigest": { "$ref": "#/$defs/sha256" },
+        "referenceSolutions": { "$ref": "#/$defs/completeResults" },
+        "mutationChecks": { "$ref": "#/$defs/mutationResults" },
+        "calibration": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["sampleSize", "reviewerCount", "agreement"],
+          "properties": {
+            "sampleSize": { "type": "integer", "minimum": 1 },
+            "reviewerCount": { "type": "integer", "minimum": 2 },
+            "agreement": { "type": "number", "minimum": 0.8, "maximum": 1 }
+          }
+        }
+      }
+    },
+    "custodyV2": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schemaVersion", "claimTier", "visibility", "familyDisjointSplit", "repositoryDisjointSplit", "holdoutManifestDigest", "referenceSolutionDigest", "mutationReportDigest", "calibrationReportDigest", "accessPolicyDigest", "disjointnessReportDigest", "humanRubricDigest", "disagreementReportDigest", "accessControl", "disjointness", "referenceSolutions", "mutationChecks", "calibration"],
+      "properties": {
+        "schemaVersion": { "const": 2 },
+        "claimTier": { "enum": ["private-holdout", "production-shadow"] },
+        "visibility": { "const": "external-private-holdout" },
+        "familyDisjointSplit": { "const": true },
+        "repositoryDisjointSplit": { "const": true },
+        "holdoutManifestDigest": { "$ref": "#/$defs/sha256" },
+        "referenceSolutionDigest": { "$ref": "#/$defs/sha256" },
+        "mutationReportDigest": { "$ref": "#/$defs/sha256" },
+        "calibrationReportDigest": { "$ref": "#/$defs/sha256" },
+        "accessPolicyDigest": { "$ref": "#/$defs/sha256" },
+        "disjointnessReportDigest": { "$ref": "#/$defs/sha256" },
+        "humanRubricDigest": { "$ref": "#/$defs/sha256" },
+        "disagreementReportDigest": { "$ref": "#/$defs/sha256" },
+        "accessControl": { "$ref": "#/$defs/accessControl" },
+        "disjointness": { "$ref": "#/$defs/disjointness" },
+        "referenceSolutions": { "$ref": "#/$defs/completeResults" },
+        "mutationChecks": { "$ref": "#/$defs/mutationResults" },
+        "calibration": { "$ref": "#/$defs/calibrationV2" }
+      }
+    },
+    "accessControl": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["protocolVersion", "policyDigest", "candidateAuthorPromptAccess", "candidateAuthorGraderAccess", "candidateAuthorRepositoryAccess", "operatorAccess", "reviewerAccess", "custodianIndependent", "reviewerIndependent", "appendOnlyAccessLog", "accessLogDigest", "issuedAt", "expiresAt"],
+      "properties": {
+        "protocolVersion": { "const": "e3-custody-v1" },
+        "policyDigest": { "$ref": "#/$defs/sha256" },
+        "candidateAuthorPromptAccess": { "const": "denied-until-rc-freeze" },
+        "candidateAuthorGraderAccess": { "const": "denied-until-rc-freeze" },
+        "candidateAuthorRepositoryAccess": { "const": "denied-until-rc-freeze" },
+        "operatorAccess": { "const": "execute-only" },
+        "reviewerAccess": { "const": "blinded-rubric-and-output" },
+        "custodianIndependent": { "const": true },
+        "reviewerIndependent": { "const": true },
+        "appendOnlyAccessLog": { "const": true },
+        "accessLogDigest": { "$ref": "#/$defs/sha256" },
+        "issuedAt": { "type": "string", "format": "date-time" },
+        "expiresAt": { "type": "string", "format": "date-time" }
+      }
+    },
+    "disjointness": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["taxonomyDigest", "publicExposureDigest", "reportDigest", "familyDisjoint", "repositoryDisjoint", "scenarioCount", "familyCount", "repositoryCount", "verifiedAt"],
+      "properties": {
+        "taxonomyDigest": { "$ref": "#/$defs/sha256" },
+        "publicExposureDigest": { "$ref": "#/$defs/sha256" },
+        "reportDigest": { "$ref": "#/$defs/sha256" },
+        "familyDisjoint": { "const": true },
+        "repositoryDisjoint": { "const": true },
+        "scenarioCount": { "type": "integer", "minimum": 6 },
+        "familyCount": { "type": "integer", "minimum": 6 },
+        "repositoryCount": { "type": "integer", "minimum": 6 },
+        "verifiedAt": { "type": "string", "format": "date-time" }
+      }
+    },
+    "calibrationV2": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["sampleSize", "reviewerCount", "sampledFamilyCount", "doubleScoredCount", "agreementCount", "disagreementCount", "resolvedDisagreementCount", "unresolvedDisagreementCount", "agreement", "blinded", "independentFirstPass", "adjudicatorIndependent", "rubricDigest", "reviewerSetDigest", "sampleSelectionDigest", "disagreementLogDigest", "adjudicationPolicyDigest"],
+      "properties": {
+        "sampleSize": { "type": "integer", "minimum": 12 },
+        "reviewerCount": { "type": "integer", "minimum": 2 },
+        "sampledFamilyCount": { "type": "integer", "minimum": 4 },
+        "doubleScoredCount": { "type": "integer", "minimum": 12 },
+        "agreementCount": { "type": "integer", "minimum": 0 },
+        "disagreementCount": { "type": "integer", "minimum": 0 },
+        "resolvedDisagreementCount": { "type": "integer", "minimum": 0 },
+        "unresolvedDisagreementCount": { "const": 0 },
+        "agreement": { "type": "number", "minimum": 0.8, "maximum": 1 },
+        "blinded": { "const": true },
+        "independentFirstPass": { "const": true },
+        "adjudicatorIndependent": { "const": true },
+        "rubricDigest": { "$ref": "#/$defs/sha256" },
+        "reviewerSetDigest": { "$ref": "#/$defs/sha256" },
+        "sampleSelectionDigest": { "$ref": "#/$defs/sha256" },
+        "disagreementLogDigest": { "$ref": "#/$defs/sha256" },
+        "adjudicationPolicyDigest": { "$ref": "#/$defs/sha256" }
+      }
+    }
+  }
+}

package/schemas/failure-classification.schema.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/Vt-mmm/piagent/schemas/failure-classification.schema.json",
+  "title": "Pi Agent Failure Classification",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "policyVersion", "evidenceDigest", "category", "ownership", "retryable", "sourceMutationPermission", "confidence", "reasonCodes", "authorizesSourceMutation", "outputRef"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "policyVersion": { "const": "failure-policy-v1" },
+    "evidenceDigest": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "category": { "enum": ["passed", "compile-typecheck", "test-assertion", "lint-format", "dependency-config", "environment", "provider-network", "permission-policy", "scope-protected-path", "flaky-infrastructure", "unknown"] },
+    "ownership": { "enum": ["none", "source", "test-expectation", "dependency", "environment", "provider", "permission", "policy", "scope", "infrastructure", "unknown"] },
+    "retryable": { "type": "boolean" },
+    "sourceMutationPermission": { "enum": ["eligible-in-scope", "conditional", "forbidden"] },
+    "confidence": { "enum": ["low", "medium", "high"] },
+    "reasonCodes": { "type": "array", "minItems": 1, "maxItems": 16, "uniqueItems": true, "items": { "$ref": "failure-evidence.schema.json#/$defs/reason" } },
+    "authorizesSourceMutation": { "const": false },
+    "outputRef": { "$ref": "failure-evidence.schema.json#/$defs/outputRef" }
+  },
+  "allOf": [
+    { "if": { "properties": { "category": { "enum": ["environment", "provider-network", "permission-policy", "scope-protected-path", "flaky-infrastructure", "unknown", "passed"] } } }, "then": { "properties": { "sourceMutationPermission": { "const": "forbidden" } } } }
+  ]
+}

package/schemas/failure-evidence.schema.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/Vt-mmm/piagent/schemas/failure-evidence.schema.json",
+  "title": "Pi Agent Failure Parser Evidence",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "parserVersion", "exitCode", "signals", "structuredEvents", "outputRef"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "parserVersion": { "const": "failure-parser-v1" },
+    "exitCode": { "type": "integer", "minimum": 0, "maximum": 255 },
+    "signals": { "type": "array", "maxItems": 16, "uniqueItems": true, "items": { "$ref": "#/$defs/reason" } },
+    "structuredEvents": { "type": "array", "maxItems": 16, "uniqueItems": true, "items": { "enum": ["scope-violation", "protected-path", "permission-denied", "policy-block", "provider-network", "environment", "flaky-infrastructure", "stale-verifier", "missing-verifier"] } },
+    "outputRef": { "$ref": "#/$defs/outputRef" }
+  },
+  "$defs": {
+    "reason": { "enum": ["exit-zero", "structured-scope", "structured-protected-path", "structured-permission", "structured-policy", "structured-provider", "structured-environment", "structured-flaky-infrastructure", "structured-stale-verifier", "structured-missing-verifier", "typescript-diagnostic", "python-type-diagnostic", "go-compile-diagnostic", "rust-compile-diagnostic", "generic-compile-diagnostic", "test-assertion-diagnostic", "lint-format-diagnostic", "dependency-config-diagnostic", "environment-diagnostic", "provider-rate-limit", "provider-transport", "permission-diagnostic", "policy-diagnostic", "scope-diagnostic", "local-port-conflict", "transient-infrastructure", "unknown-diagnostic"] },
+    "outputRef": { "type": "object", "additionalProperties": false, "required": ["sha256", "chars", "truncated", "captureRef"], "properties": { "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "chars": { "type": "integer", "minimum": 0, "maximum": 1000000000 }, "truncated": { "type": "boolean" }, "captureRef": { "type": ["string", "null"], "pattern": "^[A-Za-z0-9][A-Za-z0-9:._-]{0,255}$" } } }
+  }
+}

package/schemas/helper-request.schema.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://piagent.io.vn/schemas/helper-request.schema.json",
+  "title": "Piagent HelperRequest v1",
+  "type": "object",
+  "required": ["schemaVersion", "policyVersion", "role", "objectiveHash", "objectiveText", "taskId", "taskRunId", "sessionHash", "authority", "readScope", "writeScope", "allowedTools", "model", "contextBudget", "ceilings", "outputSchema", "stoppingRule", "approvalRestrictions", "parentAuthorityDigest", "singleWriterOwnership", "deduplicationKey"],
+  "properties": {
+    "schemaVersion": { "const": 1 }, "policyVersion": { "const": "role-policy-v1" },
+    "role": { "enum": ["retriever", "scout", "planner", "worker", "reviewer", "oracle", "researcher"] },
+    "objectiveHash": { "$ref": "#/$defs/hash" }, "objectiveText": { "type": "string", "minLength": 3, "maxLength": 1000 },
+    "taskId": { "$ref": "#/$defs/ref" }, "taskRunId": { "$ref": "#/$defs/ref" }, "sessionHash": { "$ref": "#/$defs/hash" },
+    "authority": { "enum": ["read-only", "single-writer"] }, "readScope": { "$ref": "#/$defs/scopes" }, "writeScope": { "$ref": "#/$defs/scopes" }, "allowedTools": { "$ref": "#/$defs/names" },
+    "model": { "anyOf": [{ "type": "null" }, { "type": "object", "required": ["provider", "modelId", "effort", "source"], "properties": { "provider": { "$ref": "#/$defs/text" }, "modelId": { "$ref": "#/$defs/text" }, "effort": { "$ref": "#/$defs/text" }, "source": { "$ref": "#/$defs/text" } }, "additionalProperties": false }] },
+    "contextBudget": { "type": "integer", "minimum": 256, "maximum": 100000 }, "ceilings": { "$ref": "#/$defs/ceilings" },
+    "outputSchema": { "type": "string", "minLength": 3, "maxLength": 200 }, "stoppingRule": { "type": "string", "minLength": 3, "maxLength": 500 }, "approvalRestrictions": { "$ref": "#/$defs/names" },
+    "parentAuthorityDigest": { "$ref": "#/$defs/hash" }, "singleWriterOwnership": { "type": ["string", "null"], "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:._/-]{0,255}$" }, "deduplicationKey": { "$ref": "#/$defs/hash" }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "ref": { "type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:._/-]{0,255}$" }, "text": { "type": "string", "minLength": 1, "maxLength": 160 },
+    "scopes": { "type": "array", "maxItems": 100, "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 300 } }, "names": { "type": "array", "maxItems": 32, "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 300 } },
+    "ceilings": { "type": "object", "required": ["timeSeconds", "calls", "retries"], "properties": { "timeSeconds": { "type": "integer", "minimum": 1, "maximum": 3600 }, "calls": { "type": "integer", "minimum": 1, "maximum": 100 }, "retries": { "type": "integer", "minimum": 0, "maximum": 3 } }, "additionalProperties": false }
+  }
+}

package/schemas/model-route-decision.schema.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/Vt-mmm/piagent/schemas/model-route-decision.schema.json",
+  "title": "Pi Agent Model Route Decision",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion", "policyVersion", "mappingVersion", "featureHash", "mode", "objective",
+    "capabilityBand", "safetyFloor", "fallbackBand", "provider", "modelId", "effort",
+    "currentProvider", "currentModelId", "currentEffort", "selectionSource", "confidence",
+    "disposition", "reasonCodes", "downgradeSteps", "catalogDigest", "decisionDigest", "enforced"
+  ],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "policyVersion": { "const": "model-route-v1" },
+    "mappingVersion": { "const": "openai-codex-model-route-map-v1" },
+    "featureHash": { "$ref": "#/$defs/hash" },
+    "mode": { "enum": ["off", "shadow", "recommend", "auto"] },
+    "objective": { "enum": ["intelligence", "balance", "cost"] },
+    "capabilityBand": { "enum": ["low", "medium", "high", "ultra", "abstain"] },
+    "safetyFloor": { "$ref": "#/$defs/band" },
+    "fallbackBand": { "oneOf": [{ "$ref": "#/$defs/band" }, { "type": "null" }] },
+    "provider": { "$ref": "#/$defs/nullableName" },
+    "modelId": { "$ref": "#/$defs/nullableName" },
+    "effort": { "$ref": "#/$defs/nullableName" },
+    "currentProvider": { "$ref": "#/$defs/nullableName" },
+    "currentModelId": { "$ref": "#/$defs/nullableName" },
+    "currentEffort": { "$ref": "#/$defs/nullableName" },
+    "selectionSource": { "enum": ["explicit-user-pin", "workspace-default", "global-default", "router-selected", "unknown"] },
+    "confidence": { "enum": ["low", "medium", "high"] },
+    "disposition": { "enum": ["preserved", "shadowed", "recommended", "selected", "unavailable", "abstained"] },
+    "reasonCodes": { "type": "array", "minItems": 1, "maxItems": 32, "uniqueItems": true, "items": { "$ref": "#/$defs/name" } },
+    "downgradeSteps": { "type": "integer", "minimum": 0, "maximum": 3 },
+    "catalogDigest": { "$ref": "#/$defs/hash" },
+    "decisionDigest": { "$ref": "#/$defs/hash" },
+    "enforced": { "type": "boolean" }
+  },
+  "$defs": {
+    "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "band": { "enum": ["low", "medium", "high", "ultra"] },
+    "name": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]{0,159}$" },
+    "nullableName": { "oneOf": [{ "$ref": "#/$defs/name" }, { "type": "null" }] }
+  }
+}

package/schemas/project-profile.schema.json

@@ -50,6 +50,9 @@
       "type": "string",
       "minLength": 1
     },
+    "authorityProfile": {
+      "enum": ["broad-default", "mechanical-only", "strict-high-risk"]
+    },
     "permissionProfile": {
       "description": "Runtime permission profile. workspace-write is the default; trusted-full-access still keeps Piagent protected-path and destructive/external confirmation gates.",
       "enum": [

package/schemas/role-policy.schema.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://piagent.io.vn/schemas/role-policy.schema.json",
+  "title": "Piagent RolePolicy v1",
+  "type": "object",
+  "required": ["schemaVersion", "policyVersion", "role", "authority", "enabledByDefault", "readScope", "writeScope", "allowedTools", "modelSelectionSource", "effortSelectionSource", "contextBudget", "ceilings", "outputSchema", "stoppingRule", "approvalRestrictions"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "policyVersion": { "const": "role-policy-v1" },
+    "role": { "enum": ["retriever", "scout", "planner", "worker", "reviewer", "oracle", "researcher"] },
+    "authority": { "enum": ["read-only", "single-writer"] },
+    "enabledByDefault": { "type": "boolean" },
+    "readScope": { "$ref": "#/$defs/scopes" },
+    "writeScope": { "$ref": "#/$defs/scopes" },
+    "allowedTools": { "$ref": "#/$defs/names" },
+    "modelSelectionSource": { "const": "runtime-catalog" },
+    "effortSelectionSource": { "enum": ["runtime-snapshot", "parent"] },
+    "contextBudget": { "type": "integer", "minimum": 256, "maximum": 100000 },
+    "ceilings": { "$ref": "#/$defs/ceilings" },
+    "outputSchema": { "type": "string", "minLength": 3, "maxLength": 200 },
+    "stoppingRule": { "type": "string", "minLength": 3, "maxLength": 500 },
+    "approvalRestrictions": { "$ref": "#/$defs/names" }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "scopes": { "type": "array", "maxItems": 100, "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 300 } },
+    "names": { "type": "array", "maxItems": 32, "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 300 } },
+    "ceilings": { "type": "object", "required": ["timeSeconds", "calls", "retries"], "properties": { "timeSeconds": { "type": "integer", "minimum": 1, "maximum": 3600 }, "calls": { "type": "integer", "minimum": 1, "maximum": 100 }, "retries": { "type": "integer", "minimum": 0, "maximum": 3 } }, "additionalProperties": false }
+  }
+}

package/schemas/runtime-model-snapshot.schema.json

@@ -0,0 +1,57 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/Vt-mmm/piagent/schemas/runtime-model-snapshot.schema.json",
+  "title": "Pi Agent Runtime Model Snapshot",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "capturedAt", "source", "piHostVersion", "piagentVersion", "provider", "modelId", "availability", "contextWindow", "requestedThinkingLevel", "effectiveThinkingLevel", "supportedThinkingLevels", "capabilities", "provenance", "warnings"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "capturedAt": { "$ref": "#/$defs/timestamp" },
+    "source": { "$ref": "#/$defs/source" },
+    "piHostVersion": { "$ref": "#/$defs/nullableText" },
+    "piagentVersion": { "$ref": "#/$defs/nullableText" },
+    "provider": { "$ref": "#/$defs/nullableText" },
+    "modelId": { "$ref": "#/$defs/nullableText" },
+    "availability": { "enum": ["authenticated", "unavailable", "offline", "logged-out", "unknown"] },
+    "contextWindow": { "type": ["integer", "null"], "minimum": 1, "maximum": 10000000 },
+    "requestedThinkingLevel": { "$ref": "#/$defs/nullableText" },
+    "effectiveThinkingLevel": { "$ref": "#/$defs/nullableText" },
+    "supportedThinkingLevels": {
+      "oneOf": [
+        { "type": "null" },
+        { "type": "array", "maxItems": 16, "uniqueItems": true, "items": { "$ref": "#/$defs/name" } }
+      ]
+    },
+    "capabilities": { "type": "array", "maxItems": 64, "items": { "$ref": "#/$defs/capability" } },
+    "provenance": { "type": "array", "maxItems": 128, "items": { "$ref": "#/$defs/provenance" } },
+    "warnings": { "type": "array", "maxItems": 32, "items": { "type": "string", "minLength": 1, "maxLength": 240 } }
+  },
+  "$defs": {
+    "timestamp": { "type": "string", "format": "date-time", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$" },
+    "source": { "enum": ["pi-runtime", "authenticated-catalog", "provider-profile", "api-doc-hint"] },
+    "nullableText": { "type": ["string", "null"], "minLength": 1, "maxLength": 160 },
+    "name": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}$" },
+    "capability": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "value", "source"],
+      "properties": {
+        "name": { "$ref": "#/$defs/name" },
+        "value": { "type": ["boolean", "null"] },
+        "source": { "$ref": "#/$defs/source" }
+      }
+    },
+    "provenance": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["field", "source", "capturedAt"],
+      "properties": {
+        "field": { "$ref": "#/$defs/name" },
+        "source": { "$ref": "#/$defs/source" },
+        "capturedAt": { "$ref": "#/$defs/timestamp" },
+        "detail": { "type": "string", "maxLength": 240 }
+      }
+    }
+  }
+}

package/schemas/solver-decision.schema.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/Vt-mmm/piagent/schemas/solver-decision.schema.json",
+  "title": "Pi Agent Solver Decision",
+  "type": "object", "additionalProperties": false,
+  "required": ["schemaVersion", "policyVersion", "featureHash", "route", "plannedPhases", "context", "toolGroups", "helper", "parentModel", "reasonCodes", "confidence", "mode", "override"],
+  "properties": {
+    "schemaVersion": { "const": 1 }, "policyVersion": { "const": "solver-v1" }, "featureHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "route": { "$ref": "#/$defs/route" }, "plannedPhases": { "type": "array", "minItems": 1, "maxItems": 7, "uniqueItems": true, "items": { "enum": ["intake", "context", "plan", "implement", "verify", "review", "handoff"] } },
+    "context": { "type": "object", "additionalProperties": false, "required": ["recommendation", "budgetBand"], "properties": { "recommendation": { "enum": ["none", "targeted", "bounded"] }, "budgetBand": { "enum": ["none", "small", "medium", "large"] } } },
+    "toolGroups": { "type": "array", "maxItems": 10, "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 128 } },
+    "helper": { "type": "object", "additionalProperties": false, "required": ["needed", "role", "enforced"], "properties": { "needed": { "type": "boolean" }, "role": { "enum": ["scout", "planner", "reviewer", null] }, "enforced": { "const": false } } },
+    "parentModel": { "type": "object", "additionalProperties": false, "required": ["provider", "modelId", "effort", "enforced"], "properties": { "provider": { "type": ["string", "null"], "maxLength": 128 }, "modelId": { "type": ["string", "null"], "maxLength": 128 }, "effort": { "type": ["string", "null"], "maxLength": 128 }, "enforced": { "const": false } } },
+    "reasonCodes": { "type": "array", "minItems": 1, "maxItems": 24, "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 128 } },
+    "confidence": { "enum": ["low", "medium", "high"] }, "mode": { "enum": ["off", "shadow", "recommend"] },
+    "override": { "type": "object", "additionalProperties": false, "required": ["observed", "route", "recordedAt"], "properties": { "observed": { "type": "boolean" }, "route": { "oneOf": [{ "$ref": "#/$defs/route" }, { "type": "null" }] }, "recordedAt": { "type": ["string", "null"], "format": "date-time" } } }
+  },
+  "$defs": { "route": { "enum": ["direct", "scout-first", "plan-first", "review-only", "blocked-preflight"] } }
+}

package/schemas/task-authority-snapshot.schema.json

@@ -0,0 +1,86 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/Vt-mmm/piagent/schemas/task-authority-snapshot.schema.json",
+  "title": "Piagent Immutable Task Authority Snapshot",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "snapshotVersion", "manifestVersion", "manifestDigest", "releaseVersion", "profile", "taskId", "taskRunId", "capturedAt", "resolution", "globalBudgets", "capabilities", "snapshotDigest"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "snapshotVersion": { "const": "task-authority-snapshot-v1" },
+    "manifestVersion": { "const": "authority-v1" },
+    "manifestDigest": { "$ref": "#/$defs/hash" },
+    "releaseVersion": { "const": "1.3.0" },
+    "profile": { "enum": ["broad-default", "mechanical-only", "strict-high-risk"] },
+    "taskId": { "$ref": "#/$defs/name" },
+    "taskRunId": { "$ref": "#/$defs/name" },
+    "capturedAt": { "type": "string", "format": "date-time" },
+    "resolution": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["source", "modeOverrides"],
+      "properties": {
+        "source": { "enum": ["profile", "explicit-overrides", "legacy-feature-modes-v0"] },
+        "modeOverrides": { "$ref": "#/$defs/modeOverrides" }
+      }
+    },
+    "globalBudgets": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["maxSystemContinuationsPerTask", "maxAutomaticDispatchesPerTask", "maxSpecialistReviewRoundsPerTask"],
+      "properties": {
+        "maxSystemContinuationsPerTask": { "const": 1 },
+        "maxAutomaticDispatchesPerTask": { "const": 1 },
+        "maxSpecialistReviewRoundsPerTask": { "const": 1 }
+      }
+    },
+    "capabilities": {
+      "type": "array",
+      "minItems": 17,
+      "maxItems": 17,
+      "items": { "$ref": "#/$defs/entry" }
+    },
+    "snapshotDigest": { "$ref": "#/$defs/hash" }
+  },
+  "$defs": {
+    "hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "name": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]{0,159}$" },
+    "capabilityId": { "type": "string", "pattern": "^CAP-(0[1-9]|1[0-7])$" },
+    "authority": { "enum": ["off", "observe", "advise", "enforce", "orchestrate"] },
+    "modeOverrides": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "CAP-01": { "$ref": "#/$defs/name" }, "CAP-02": { "$ref": "#/$defs/name" }, "CAP-03": { "$ref": "#/$defs/name" },
+        "CAP-04": { "$ref": "#/$defs/name" }, "CAP-05": { "$ref": "#/$defs/name" }, "CAP-06": { "$ref": "#/$defs/name" },
+        "CAP-07": { "$ref": "#/$defs/name" }, "CAP-08": { "$ref": "#/$defs/name" }, "CAP-09": { "$ref": "#/$defs/name" },
+        "CAP-10": { "$ref": "#/$defs/name" }, "CAP-11": { "$ref": "#/$defs/name" }, "CAP-12": { "$ref": "#/$defs/name" },
+        "CAP-13": { "$ref": "#/$defs/name" }, "CAP-14": { "$ref": "#/$defs/name" }, "CAP-15": { "$ref": "#/$defs/name" },
+        "CAP-16": { "$ref": "#/$defs/name" }, "CAP-17": { "$ref": "#/$defs/name" }
+      }
+    },
+    "budget": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["systemContinuations", "automaticDispatches", "reviewRounds"],
+      "properties": {
+        "systemContinuations": { "type": "integer", "minimum": 0, "maximum": 8 },
+        "automaticDispatches": { "type": "integer", "minimum": 0, "maximum": 8 },
+        "reviewRounds": { "type": "integer", "minimum": 0, "maximum": 8 }
+      }
+    },
+    "entry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "owner", "mode", "authority", "dependencies", "budgets"],
+      "properties": {
+        "id": { "$ref": "#/$defs/capabilityId" },
+        "owner": { "$ref": "#/$defs/name" },
+        "mode": { "$ref": "#/$defs/name" },
+        "authority": { "$ref": "#/$defs/authority" },
+        "dependencies": { "type": "array", "maxItems": 17, "uniqueItems": true, "items": { "$ref": "#/$defs/capabilityId" } },
+        "budgets": { "$ref": "#/$defs/budget" }
+      }
+    }
+  }
+}