@c4a/context-cli 0.6.18 → 0.7.0

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}$" }
+  }
+}

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

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "context.indexer.customization-validation-result/v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "protocol",
+    "validated",
+    "stage_receipt",
+    "outcome",
+    "selection_proposal_input",
+    "result_digest"
+  ],
+  "properties": {
+    "protocol": { "const": "context.indexer.customization-validation-result/v1" },
+    "validated": { "type": "object" },
+    "stage_receipt": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["protocol", "validation_digest", "staged_file_count", "reused", "receipt_digest"],
+      "properties": {
+        "protocol": { "const": "context.indexer.customization-draft-stage-receipt/v1" },
+        "validation_digest": { "$ref": "#/$defs/digest" },
+        "staged_file_count": { "type": "integer", "minimum": 1 },
+        "reused": { "type": "boolean" },
+        "receipt_digest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "outcome": { "const": "selection-validation-required" },
+    "selection_proposal_input": { "type": "object" },
+    "result_digest": { "$ref": "#/$defs/digest" }
+  },
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+  }
+}

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

@@ -0,0 +1,71 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "context.indexer.dependency-authorization-input/v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "protocol",
+    "proposal_digest",
+    "request_intent_set_digest",
+    "intents",
+    "resolutions",
+    "authority_ref",
+    "authority_scope_digest",
+    "install_scripts",
+    "input_digest"
+  ],
+  "properties": {
+    "protocol": { "const": "context.indexer.dependency-authorization-input/v1" },
+    "proposal_digest": { "$ref": "#/$defs/digest" },
+    "request_intent_set_digest": { "$ref": "#/$defs/digest" },
+    "intents": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["package", "version", "kind", "importers", "install_scripts"],
+        "properties": {
+          "package": { "type": "string", "minLength": 1 },
+          "version": { "type": "string", "minLength": 1 },
+          "kind": { "enum": ["runtime", "development"] },
+          "importers": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "type": "string", "minLength": 1 }
+          },
+          "install_scripts": { "const": false }
+        }
+      }
+    },
+    "resolutions": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/resolution" }
+    },
+    "authority_ref": { "type": "string", "minLength": 1 },
+    "authority_scope_digest": { "$ref": "#/$defs/digest" },
+    "install_scripts": { "const": false },
+    "input_digest": { "$ref": "#/$defs/digest" }
+  },
+  "$defs": {
+    "digest": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "resolution": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["package", "version", "lock_integrity", "resolved_digest"],
+      "properties": {
+        "package": { "type": "string", "minLength": 1 },
+        "version": { "type": "string", "minLength": 1 },
+        "lock_integrity": {
+          "type": "string",
+          "pattern": "^(sha256|sha384|sha512)-[A-Za-z0-9+/]+={0,2}$"
+        },
+        "resolved_digest": { "$ref": "#/$defs/digest" }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,138 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "context.indexer.dependency-authorization-result/v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "protocol",
+    "proposal_digest",
+    "authorized_proposal_digest",
+    "request_intent_set_digest",
+    "receipt",
+    "dependencies",
+    "stage_receipt",
+    "result_digest"
+  ],
+  "properties": {
+    "protocol": { "const": "context.indexer.dependency-authorization-result/v1" },
+    "proposal_digest": { "$ref": "#/$defs/digest" },
+    "authorized_proposal_digest": { "$ref": "#/$defs/digest" },
+    "request_intent_set_digest": { "$ref": "#/$defs/digest" },
+    "receipt": { "$ref": "#/$defs/receipt" },
+    "dependencies": { "$ref": "#/$defs/dependencies" },
+    "stage_receipt": { "$ref": "#/$defs/stageReceipt" },
+    "result_digest": { "$ref": "#/$defs/digest" }
+  },
+  "$defs": {
+    "digest": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "stageReceipt": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "protocol",
+        "proposal_digest",
+        "target_count",
+        "dependency_intent_digest",
+        "reused",
+        "receipt_digest"
+      ],
+      "properties": {
+        "protocol": { "const": "context.indexer.project-proposal-stage-receipt/v1" },
+        "proposal_digest": { "$ref": "#/$defs/digest" },
+        "target_count": { "type": "integer", "minimum": 1 },
+        "dependency_intent_digest": { "$ref": "#/$defs/digest" },
+        "reused": { "type": "boolean" },
+        "receipt_digest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "resolution": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["package", "version", "lock_integrity", "resolved_digest"],
+      "properties": {
+        "package": { "type": "string", "minLength": 1 },
+        "version": { "type": "string", "minLength": 1 },
+        "lock_integrity": { "type": "string", "minLength": 1 },
+        "resolved_digest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "receipt": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "protocol",
+        "request_intent_set_digest",
+        "resolutions",
+        "authority_ref",
+        "authority_scope_digest",
+        "install_scripts",
+        "receipt_digest"
+      ],
+      "properties": {
+        "protocol": { "const": "context.indexer.dependency-authorization-receipt/v1" },
+        "request_intent_set_digest": { "$ref": "#/$defs/digest" },
+        "resolutions": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "$ref": "#/$defs/resolution" }
+        },
+        "authority_ref": { "type": "string", "minLength": 1 },
+        "authority_scope_digest": { "$ref": "#/$defs/digest" },
+        "install_scripts": { "const": false },
+        "receipt_digest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "intent": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "package",
+        "version",
+        "kind",
+        "importers",
+        "state",
+        "lock_integrity",
+        "resolved_digest",
+        "authorization_receipt_digest",
+        "install_scripts"
+      ],
+      "properties": {
+        "package": { "type": "string", "minLength": 1 },
+        "version": { "type": "string", "minLength": 1 },
+        "kind": { "enum": ["runtime", "development"] },
+        "importers": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "state": { "const": "locked" },
+        "lock_integrity": { "type": "string", "minLength": 1 },
+        "resolved_digest": { "$ref": "#/$defs/digest" },
+        "authorization_receipt_digest": { "$ref": "#/$defs/digest" },
+        "install_scripts": { "const": false }
+      }
+    },
+    "dependencies": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["protocol", "intents", "authorization_receipts", "intent_set_digest"],
+      "properties": {
+        "protocol": { "const": "context.indexer.dependency-intent-set/v1" },
+        "intents": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "$ref": "#/$defs/intent" }
+        },
+        "authorization_receipts": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "$ref": "#/$defs/receipt" }
+        },
+        "intent_set_digest": { "$ref": "#/$defs/digest" }
+      }
+    }
+  }
+}

package/providers/context/schemas/indexer-incremental-impact-input.schema.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "context.indexer.incremental-impact-input/v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["protocol", "current_runs"],
+  "properties": {
+    "protocol": { "const": "context.indexer.incremental-impact-input/v1" },
+    "current_runs": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "previous_acceptance_digest",
+          "current_request",
+          "current_dependency_view"
+        ],
+        "properties": {
+          "previous_acceptance_digest": { "$ref": "#/$defs/digest" },
+          "current_request": { "type": "object" },
+          "current_dependency_view": { "type": "object" }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+  }
+}

package/providers/context/schemas/indexer-incremental-impact-output.schema.json

@@ -0,0 +1,52 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "context.indexer.incremental-impact-report-set/v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "protocol",
+    "previous_accepted_result_set_digest",
+    "logical_unit_count",
+    "stale_logical_unit_count",
+    "stale_artifact_count",
+    "stale_section_count",
+    "recompute_required",
+    "reports",
+    "report_set_digest",
+    "outcome",
+    "graph_outcome"
+  ],
+  "properties": {
+    "protocol": { "const": "context.indexer.incremental-impact-report-set/v1" },
+    "previous_accepted_result_set_digest": { "$ref": "#/$defs/digest" },
+    "logical_unit_count": { "type": "integer", "minimum": 1 },
+    "stale_logical_unit_count": { "type": "integer", "minimum": 0 },
+    "stale_artifact_count": { "type": "integer", "minimum": 0 },
+    "stale_section_count": { "type": "integer", "minimum": 0 },
+    "recompute_required": { "type": "boolean" },
+    "reports": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": [
+          "protocol",
+          "indexer_id",
+          "logical_unit_ref",
+          "envelope_changes",
+          "dependency_changes",
+          "artifacts",
+          "logical_unit_state",
+          "recompute_scope",
+          "report_digest"
+        ]
+      }
+    },
+    "report_set_digest": { "$ref": "#/$defs/digest" },
+    "outcome": { "const": "indexer-incremental-impact-reported" },
+    "graph_outcome": { "const": "completed" }
+  },
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+  }
+}