@c4a/context-cli 0.6.19 → 0.7.0

package/providers/context/schemas/indexer-candidate-review-readiness-output.schema.json

@@ -0,0 +1,104 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "context.indexer.candidate-review-readiness-result/v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "protocol",
+    "state",
+    "binding",
+    "precompile_audit_report_digest",
+    "postcompile_audit_report_digest",
+    "baseline_failed_check_ids",
+    "profile_state",
+    "profile_failed_metric_ids",
+    "profile_override_receipt_digest",
+    "profile_override_applied",
+    "audit_facts",
+    "review_binding_digest",
+    "graph_outcome",
+    "result_digest",
+    "reason_code"
+  ],
+  "properties": {
+    "protocol": { "const": "context.indexer.candidate-review-readiness-result/v1" },
+    "state": { "enum": ["ready", "baseline-blocked", "profile-blocked"] },
+    "binding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "requirement_set_digest",
+        "registry_digest",
+        "inventory_digest",
+        "layout_digest",
+        "candidate_set_digest",
+        "effective_revision_digest"
+      ],
+      "properties": {
+        "requirement_set_digest": { "$ref": "#/$defs/digest" },
+        "registry_digest": { "$ref": "#/$defs/digest" },
+        "inventory_digest": { "$ref": "#/$defs/digest" },
+        "layout_digest": { "$ref": "#/$defs/digest" },
+        "candidate_set_digest": { "$ref": "#/$defs/digest" },
+        "effective_revision_digest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "precompile_audit_report_digest": { "$ref": "#/$defs/digest" },
+    "postcompile_audit_report_digest": { "$ref": "#/$defs/digest" },
+    "baseline_failed_check_ids": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "profile_state": {
+      "enum": ["not-applicable", "passed", "revision-required", "human-guidance-required"]
+    },
+    "profile_failed_metric_ids": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "profile_override_receipt_digest": {
+      "oneOf": [{ "$ref": "#/$defs/digest" }, { "type": "null" }]
+    },
+    "profile_override_applied": { "type": "boolean" },
+    "audit_facts": { "$ref": "#/$defs/auditFacts" },
+    "review_binding_digest": { "$ref": "#/$defs/digest" },
+    "graph_outcome": { "enum": ["completed", "failed", "blocked"] },
+    "result_digest": { "$ref": "#/$defs/digest" },
+    "reason_code": {
+      "enum": [
+        "index-review-required",
+        "index-baseline-audit-failed",
+        "index-profile-revision-required",
+        "index-profile-human-guidance-required"
+      ]
+    }
+  },
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "auditFacts": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["protocol", "audit", "facts_digest"],
+      "properties": {
+        "protocol": { "const": "context.indexer.audit-facts/v1" },
+        "audit": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["baseline_clear", "profile_state", "problem_lineage_id", "profile_attempt_count", "profile_report_digest", "profile_override_eligible", "profile_override_receipt_digest"],
+          "properties": {
+            "baseline_clear": { "type": "boolean" },
+            "profile_state": { "enum": ["not-applicable", "passed", "revision-required", "human-guidance-required"] },
+            "problem_lineage_id": { "oneOf": [{ "$ref": "#/$defs/digest" }, { "type": "null" }] },
+            "profile_attempt_count": { "type": "integer", "minimum": 0, "maximum": 3 },
+            "profile_report_digest": { "oneOf": [{ "$ref": "#/$defs/digest" }, { "type": "null" }] },
+            "profile_override_eligible": { "type": "boolean" },
+            "profile_override_receipt_digest": { "oneOf": [{ "$ref": "#/$defs/digest" }, { "type": "null" }] }
+          }
+        },
+        "facts_digest": { "$ref": "#/$defs/digest" }
+      }
+    }
+  }
+}

package/providers/context/schemas/indexer-contract-overlay-authorization-input.schema.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "context.indexer.contract-overlay-authorization-input/v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "protocol",
+    "validation_input",
+    "expected_conformance_report_digest",
+    "authority_ref",
+    "authority_scope_digest",
+    "input_digest"
+  ],
+  "properties": {
+    "protocol": { "const": "context.indexer.contract-overlay-authorization-input/v1" },
+    "validation_input": {
+      "type": "object",
+      "required": ["protocol", "input_digest"],
+      "properties": {
+        "protocol": { "const": "context.indexer.contract-overlay-validation-input/v1" },
+        "input_digest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "expected_conformance_report_digest": { "$ref": "#/$defs/digest" },
+    "authority_ref": { "type": "string", "minLength": 1 },
+    "authority_scope_digest": { "$ref": "#/$defs/digest" },
+    "input_digest": { "$ref": "#/$defs/digest" }
+  },
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+  }
+}

package/providers/context/schemas/indexer-contract-overlay-authorization-result.schema.json

@@ -0,0 +1,121 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "context.indexer.contract-overlay-authorization-result/v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "protocol",
+    "trusted_validation_input",
+    "validation",
+    "project_authorization",
+    "result_digest"
+  ],
+  "properties": {
+    "protocol": { "const": "context.indexer.contract-overlay-authorization-result/v1" },
+    "trusted_validation_input": {
+      "type": "object",
+      "required": ["protocol", "project_authorization", "input_digest"],
+      "properties": {
+        "protocol": { "const": "context.indexer.contract-overlay-validation-input/v1" },
+        "project_authorization": { "type": "object" },
+        "input_digest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "validation": {
+      "type": "object",
+      "required": [
+        "protocol",
+        "outcome",
+        "graph_outcome",
+        "validation_input_digest",
+        "trust_receipt",
+        "result_digest"
+      ],
+      "properties": {
+        "protocol": { "const": "context.indexer.contract-overlay-validation-result/v1" },
+        "outcome": { "const": "trusted" },
+        "graph_outcome": { "const": "completed" },
+        "validation_input_digest": { "$ref": "#/$defs/digest" },
+        "trust_receipt": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "protocol",
+            "trust_class",
+            "project_ref",
+            "overlay_digest",
+            "attestation_digest",
+            "base_contract_digest",
+            "provider_integrity",
+            "operator_contract_digest",
+            "conformance_report_digest",
+            "trust_adapter",
+            "trust_adapter_version",
+            "trust_management_authority_digest",
+            "trust_policy_digest",
+            "authorization_receipt_digest",
+            "receipt_digest"
+          ],
+          "properties": {
+            "protocol": { "const": "context.indexer.overlay-trust-receipt/v1" },
+            "trust_class": { "const": "project-authorized-exact-digest" },
+            "project_ref": { "type": "string", "minLength": 1 },
+            "overlay_digest": { "$ref": "#/$defs/digest" },
+            "attestation_digest": { "$ref": "#/$defs/nullableDigest" },
+            "base_contract_digest": { "$ref": "#/$defs/digest" },
+            "provider_integrity": { "$ref": "#/$defs/digest" },
+            "operator_contract_digest": { "$ref": "#/$defs/digest" },
+            "conformance_report_digest": { "$ref": "#/$defs/digest" },
+            "trust_adapter": { "type": "null" },
+            "trust_adapter_version": { "type": "null" },
+            "trust_management_authority_digest": { "type": "null" },
+            "trust_policy_digest": { "type": "null" },
+            "authorization_receipt_digest": { "$ref": "#/$defs/digest" },
+            "receipt_digest": { "$ref": "#/$defs/digest" }
+          }
+        },
+        "result_digest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "project_authorization": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "protocol",
+        "project_ref",
+        "overlay_digest",
+        "attestation_digest",
+        "base_contract_digest",
+        "provider_integrity",
+        "operator_contract_digest",
+        "conformance_report_digest",
+        "authority_ref",
+        "authority_scope_digest",
+        "authorization_receipt_digest"
+      ],
+      "properties": {
+        "protocol": { "const": "context.indexer.overlay-project-authorization/v1" },
+        "project_ref": { "type": "string", "minLength": 1 },
+        "overlay_digest": { "$ref": "#/$defs/digest" },
+        "attestation_digest": { "$ref": "#/$defs/nullableDigest" },
+        "base_contract_digest": { "$ref": "#/$defs/digest" },
+        "provider_integrity": { "$ref": "#/$defs/digest" },
+        "operator_contract_digest": { "$ref": "#/$defs/digest" },
+        "conformance_report_digest": { "$ref": "#/$defs/digest" },
+        "authority_ref": { "const": "context.indexer-contract-overlay" },
+        "authority_scope_digest": { "$ref": "#/$defs/digest" },
+        "authorization_receipt_digest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "result_digest": { "$ref": "#/$defs/digest" }
+  },
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "nullableDigest": {
+      "oneOf": [
+        { "type": "null" },
+        { "$ref": "#/$defs/digest" }
+      ]
+    }
+  }
+}

package/providers/context/schemas/indexer-contract-overlay-validation-input.schema.json

@@ -0,0 +1,90 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "context.indexer.contract-overlay-validation-input/v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "protocol",
+    "project_ref",
+    "overlay",
+    "base_contract",
+    "operator_contract",
+    "provider_integrity",
+    "attestation",
+    "trust_bundle_envelope",
+    "project_authorization",
+    "input_digest"
+  ],
+  "properties": {
+    "protocol": { "const": "context.indexer.contract-overlay-validation-input/v1" },
+    "project_ref": { "type": "string", "minLength": 1 },
+    "overlay": {
+      "type": "object",
+      "required": ["protocol", "overlay_digest"],
+      "properties": {
+        "protocol": { "const": "context.indexer.contract-overlay/v1" },
+        "overlay_digest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "base_contract": {
+      "type": "object",
+      "required": ["protocol", "contract_digest"],
+      "properties": {
+        "protocol": { "const": "context.indexer.profile-contract/v1" },
+        "contract_digest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "operator_contract": {
+      "type": "object",
+      "required": ["protocol", "contract_digest"],
+      "properties": {
+        "protocol": { "const": "context.indexer.operator-contract/v1" },
+        "contract_digest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "provider_integrity": { "$ref": "#/$defs/digest" },
+    "attestation": {
+      "oneOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "required": ["protocol", "attestation_digest"],
+          "properties": {
+            "protocol": { "const": "context.indexer.overlay-attestation/v1" },
+            "attestation_digest": { "$ref": "#/$defs/digest" }
+          }
+        }
+      ]
+    },
+    "trust_bundle_envelope": {
+      "oneOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "required": ["protocol", "bundle"],
+          "properties": {
+            "protocol": { "const": "context.indexer.overlay-trust-bundle-envelope/v1" },
+            "bundle": { "type": "object" }
+          }
+        }
+      ]
+    },
+    "project_authorization": {
+      "oneOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "required": ["protocol", "authorization_receipt_digest"],
+          "properties": {
+            "protocol": { "const": "context.indexer.overlay-project-authorization/v1" },
+            "authorization_receipt_digest": { "$ref": "#/$defs/digest" }
+          }
+        }
+      ]
+    },
+    "input_digest": { "$ref": "#/$defs/digest" }
+  },
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+  }
+}

package/providers/context/schemas/indexer-contract-overlay-validation-result.schema.json

@@ -0,0 +1,158 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "context.indexer.contract-overlay-validation-result/v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "protocol",
+    "outcome",
+    "graph_outcome",
+    "validation_input_digest",
+    "project_ref",
+    "overlay",
+    "effective_profile",
+    "conformance_report",
+    "trust_receipt",
+    "authorization_request",
+    "result_digest"
+  ],
+  "properties": {
+    "protocol": { "const": "context.indexer.contract-overlay-validation-result/v1" },
+    "outcome": { "enum": ["trusted", "authorization-required"] },
+    "graph_outcome": { "enum": ["completed", "waiting-user"] },
+    "validation_input_digest": { "$ref": "#/$defs/digest" },
+    "project_ref": { "type": "string", "minLength": 1 },
+    "overlay": { "type": "object" },
+    "effective_profile": { "type": "object" },
+    "conformance_report": {
+      "type": "object",
+      "required": ["protocol", "report_digest"],
+      "properties": {
+        "protocol": { "const": "context.indexer.overlay-conformance-report/v1" },
+        "report_digest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "trust_receipt": {
+      "oneOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "protocol",
+            "trust_class",
+            "project_ref",
+            "overlay_digest",
+            "attestation_digest",
+            "base_contract_digest",
+            "provider_integrity",
+            "operator_contract_digest",
+            "conformance_report_digest",
+            "trust_adapter",
+            "trust_adapter_version",
+            "trust_management_authority_digest",
+            "trust_policy_digest",
+            "authorization_receipt_digest",
+            "receipt_digest"
+          ],
+          "properties": {
+            "protocol": { "const": "context.indexer.overlay-trust-receipt/v1" },
+            "trust_class": {
+              "enum": ["enterprise-signed", "project-authorized-exact-digest"]
+            },
+            "project_ref": { "type": ["string", "null"] },
+            "overlay_digest": { "$ref": "#/$defs/digest" },
+            "attestation_digest": { "$ref": "#/$defs/nullableDigest" },
+            "base_contract_digest": { "$ref": "#/$defs/digest" },
+            "provider_integrity": { "$ref": "#/$defs/digest" },
+            "operator_contract_digest": { "$ref": "#/$defs/digest" },
+            "conformance_report_digest": { "$ref": "#/$defs/digest" },
+            "trust_adapter": { "type": ["string", "null"], "minLength": 1 },
+            "trust_adapter_version": {
+              "oneOf": [
+                { "type": "null" },
+                { "type": "string", "pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)(?:-[0-9A-Za-z.-]+)?(?:\\+[0-9A-Za-z.-]+)?$" }
+              ]
+            },
+            "trust_management_authority_digest": { "$ref": "#/$defs/nullableDigest" },
+            "trust_policy_digest": { "$ref": "#/$defs/nullableDigest" },
+            "authorization_receipt_digest": { "$ref": "#/$defs/nullableDigest" },
+            "receipt_digest": { "$ref": "#/$defs/digest" }
+          },
+          "allOf": [
+            {
+              "if": { "properties": { "trust_class": { "const": "enterprise-signed" } } },
+              "then": {
+                "properties": {
+                  "project_ref": { "type": "null" },
+                  "attestation_digest": { "$ref": "#/$defs/digest" },
+                  "trust_adapter": { "type": "string", "minLength": 1 },
+                  "trust_adapter_version": { "type": "string" },
+                  "trust_management_authority_digest": { "$ref": "#/$defs/digest" },
+                  "trust_policy_digest": { "$ref": "#/$defs/digest" },
+                  "authorization_receipt_digest": { "type": "null" }
+                }
+              }
+            },
+            {
+              "if": { "properties": { "trust_class": { "const": "project-authorized-exact-digest" } } },
+              "then": {
+                "properties": {
+                  "project_ref": { "type": "string", "minLength": 1 },
+                  "trust_adapter": { "type": "null" },
+                  "trust_adapter_version": { "type": "null" },
+                  "trust_management_authority_digest": { "type": "null" },
+                  "trust_policy_digest": { "type": "null" },
+                  "authorization_receipt_digest": { "$ref": "#/$defs/digest" }
+                }
+              }
+            }
+          ]
+        }
+      ]
+    },
+    "authorization_request": {
+      "oneOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "protocol",
+            "project_ref",
+            "overlay_digest",
+            "attestation_digest",
+            "base_contract_digest",
+            "provider_integrity",
+            "operator_contract_digest",
+            "conformance_report_digest",
+            "request_digest"
+          ],
+          "properties": {
+            "protocol": {
+              "const": "context.indexer.contract-overlay-authorization-request/v1"
+            },
+            "project_ref": { "type": "string", "minLength": 1 },
+            "overlay_digest": { "$ref": "#/$defs/digest" },
+            "attestation_digest": { "$ref": "#/$defs/nullableDigest" },
+            "base_contract_digest": { "$ref": "#/$defs/digest" },
+            "provider_integrity": { "$ref": "#/$defs/digest" },
+            "operator_contract_digest": { "$ref": "#/$defs/digest" },
+            "conformance_report_digest": { "$ref": "#/$defs/digest" },
+            "request_digest": { "$ref": "#/$defs/digest" }
+          }
+        }
+      ]
+    },
+    "result_digest": { "$ref": "#/$defs/digest" }
+  },
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "nullableDigest": {
+      "oneOf": [
+        { "type": "null" },
+        { "$ref": "#/$defs/digest" }
+      ]
+    }
+  }
+}

package/providers/context/schemas/indexer-customization-project-preparation-result.schema.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "context.indexer.customization-project-preparation-result/v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["protocol", "outcome", "validation_digest", "result_digest"],
+  "properties": {
+    "protocol": { "const": "context.indexer.customization-project-preparation-result/v1" },
+    "outcome": {
+      "enum": ["program-authorization-required", "project-confirmation-required"]
+    },
+    "validation_digest": { "$ref": "#/$defs/digest" },
+    "authorization_report": { "type": "object" },
+    "proposal": { "type": "object" },
+    "stage_receipt": { "type": "object" },
+    "staging_validation": { "type": "object" },
+    "result_digest": { "$ref": "#/$defs/digest" }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "outcome": { "const": "program-authorization-required" } } },
+      "then": {
+        "required": ["authorization_report"],
+        "not": {
+          "anyOf": [
+            { "required": ["proposal"] },
+            { "required": ["stage_receipt"] },
+            { "required": ["staging_validation"] }
+          ]
+        }
+      }
+    },
+    {
+      "if": { "properties": { "outcome": { "const": "project-confirmation-required" } } },
+      "then": {
+        "required": ["proposal", "stage_receipt", "staging_validation"],
+        "not": { "required": ["authorization_report"] }
+      }
+    }
+  ],
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+  }
+}

package/providers/context/schemas/indexer-customization-proposal-draft.schema.json

@@ -0,0 +1,83 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "context.indexer.customization-proposal-draft/v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "protocol",
+    "capability_gap",
+    "capability_gap_digest",
+    "indexer_id",
+    "mode",
+    "selected_step",
+    "rejected_smaller_steps",
+    "gap_summary",
+    "affected_scope_refs",
+    "files",
+    "dependency_intents"
+  ],
+  "properties": {
+    "protocol": { "const": "context.indexer.customization-proposal-draft/v1" },
+    "capability_gap": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["route_input", "route_report"],
+      "properties": {
+        "route_input": { "type": "object" },
+        "route_report": { "type": "object" }
+      }
+    },
+    "capability_gap_digest": { "$ref": "#/$defs/digest" },
+    "indexer_id": { "$ref": "#/$defs/id" },
+    "mode": { "const": "extend" },
+    "selected_step": {
+      "enum": ["instructions-append", "template-override", "program-extend"]
+    },
+    "rejected_smaller_steps": {
+      "type": "array",
+      "minItems": 2,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["step", "disposition", "reason_code", "evidence_digest"],
+        "properties": {
+          "step": { "enum": ["provider-only", "config", "instructions-append", "template-override"] },
+          "disposition": { "enum": ["unsupported", "insufficient"] },
+          "reason_code": { "$ref": "#/$defs/id" },
+          "evidence_digest": { "$ref": "#/$defs/digest" }
+        }
+      }
+    },
+    "gap_summary": { "type": "string", "minLength": 1 },
+    "affected_scope_refs": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "files": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["path", "content"],
+        "properties": {
+          "path": {
+            "type": "string",
+            "pattern": "^src/indexer/[a-z0-9][a-z0-9._/-]*/(?:instructions\\.md|templates/[a-z0-9][a-z0-9._/-]*\\.md|(?:index|variables|helpers)\\.ts)$"
+          },
+          "content": { "type": "string", "minLength": 1, "maxLength": 4194304 }
+        }
+      }
+    },
+    "dependency_intents": {
+      "type": "array",
+      "maxItems": 0
+    }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9._/-]*$" },
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+  }
+}