@c4a/context-cli 0.7.1 → 0.7.5

package/providers/context/schemas/indexer-agent-step-result.schema.json

@@ -1,47 +1,400 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "context.indexer.agent-step-result/v1",
-  "type": "object",
-  "additionalProperties": false,
-  "required": [
-    "protocol",
-    "input_digest",
-    "instruction_payload_digest",
-    "run_result",
-    "execution_receipt",
-    "stable_result_digest"
+  "$id": "context.indexer.current-action-input/v2",
+  "oneOf": [
+    { "$ref": "#/$defs/providerSelection" },
+    { "$ref": "#/$defs/providerResolution" },
+    { "$ref": "#/$defs/providerProgramAuthorization" },
+    { "$ref": "#/$defs/partitionBatch" },
+    { "$ref": "#/$defs/authorBatch" },
+    { "$ref": "#/$defs/postAuthor" },
+    { "$ref": "#/$defs/structureReview" },
+    { "$ref": "#/$defs/layoutConfirmation" }
   ],
-  "properties": {
-    "protocol": { "const": "context.indexer.agent-step-result/v1" },
-    "input_digest": { "$ref": "#/$defs/digest" },
-    "instruction_payload_digest": { "$ref": "#/$defs/digest" },
-    "run_result": {
+  "$defs": {
+    "string": { "type": "string", "minLength": 1 },
+    "providerSelection": {
       "type": "object",
-      "required": ["protocol", "operation", "result"],
+      "additionalProperties": false,
+      "required": ["stage", "host_visible_skills", "indexers"],
       "properties": {
-        "protocol": { "const": "context.indexer.run-result/v1" },
-        "operation": { "enum": ["main-index", "material-answer"] },
-        "result": { "type": "object" }
+        "stage": { "const": "provider-selection" },
+        "host_visible_skills": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["skill", "version", "source_type"],
+            "properties": {
+              "skill": { "$ref": "#/$defs/string" },
+              "version": { "oneOf": [{ "$ref": "#/$defs/string" }, { "type": "null" }] },
+              "source_type": {
+                "enum": ["community-plugin", "workspace", "installed-plugin", "marketplace"]
+              }
+            }
+          }
+        },
+        "indexers": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "object" }
+        }
       }
     },
-    "execution_receipt": {
+    "providerResolution": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["adapter", "adapter_version", "execution_id", "receipt_digest"],
+      "required": ["stage", "result"],
       "properties": {
-        "adapter": { "type": "string", "minLength": 1 },
-        "adapter_version": { "type": "string", "minLength": 1 },
-        "model": { "type": "string", "minLength": 1 },
-        "execution_id": { "type": "string", "minLength": 1 },
-        "receipt_digest": { "$ref": "#/$defs/digest" }
+        "stage": { "const": "provider-resolution" },
+        "result": { "type": "object" },
+        "managed_output": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["ref", "digest", "value"],
+          "properties": {
+            "ref": { "$ref": "#/$defs/string" },
+            "digest": { "$ref": "#/$defs/string" },
+            "value": {}
+          }
+        }
       }
     },
-    "stable_result_digest": { "$ref": "#/$defs/digest" }
-  },
-  "$defs": {
-    "digest": {
-      "type": "string",
-      "pattern": "^sha256:[a-f0-9]{64}$"
+    "providerProgramAuthorization": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["stage", "decision"],
+      "properties": {
+        "stage": { "const": "provider-program-authorization" },
+        "decision": { "enum": ["approved", "rejected"] }
+      }
+    },
+    "partitionBatch": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["stage", "results"],
+      "properties": {
+        "stage": { "const": "partition" },
+        "results": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["task_key", "result"],
+            "properties": {
+              "task_key": { "type": "string", "pattern": "^task-[0-9]{3}$" },
+              "result": { "$ref": "#/$defs/partition" }
+            }
+          }
+        }
+      }
+    },
+    "partition": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["stage", "outcome", "groups", "excluded", "unsupported"],
+      "properties": {
+        "stage": { "const": "partition" },
+        "outcome": {
+          "enum": ["complete", "failed"],
+          "description": "Use complete when the semantic partition is ready; use failed only with failure details. accepted is not an Agent outcome."
+        },
+        "groups": { "type": "array", "items": { "$ref": "#/$defs/partitionGroup" } },
+        "excluded": { "type": "array", "items": { "$ref": "#/$defs/excluded" } },
+        "unsupported": { "type": "array", "items": { "$ref": "#/$defs/unsupported" } },
+        "failure": { "$ref": "#/$defs/failure" }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "outcome": { "const": "failed" } } },
+          "then": { "required": ["failure"] }
+        }
+      ]
+    },
+    "authorBatch": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["stage", "results"],
+      "properties": {
+        "stage": { "const": "author" },
+        "results": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["task_key", "result"],
+            "properties": {
+              "task_key": { "type": "string", "pattern": "^task-[0-9]{3}$" },
+              "result": { "$ref": "#/$defs/author" }
+            }
+          }
+        }
+      }
+    },
+    "partitionGroup": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["key", "title", "reader_task", "subject", "subject_intent", "members", "questions", "question_targets", "outline"],
+      "properties": {
+        "key": { "$ref": "#/$defs/string" },
+        "title": { "$ref": "#/$defs/string" },
+        "reader_task": { "$ref": "#/$defs/string" },
+        "subject": {
+          "oneOf": [
+            { "$ref": "#/$defs/string" },
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["namespace", "kind", "local_key"],
+              "properties": {
+                "namespace": { "$ref": "#/$defs/string" },
+                "kind": { "$ref": "#/$defs/string" },
+                "local_key": { "$ref": "#/$defs/string" }
+              }
+            }
+          ]
+        },
+        "subject_intent": {
+          "enum": ["primary", "enrich-or-independent"],
+          "description": "Use primary when this group owns a reader subject. Use enrich-or-independent for a publishable supplemental view, including test or example behavior: Context enriches an existing matching subject when one exists and otherwise creates an independent subject. supporting is not a valid intent; material that must never become a reader subject must not be emitted as a group."
+        },
+        "members": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/string" } },
+        "questions": { "type": "array", "items": { "$ref": "#/$defs/string" } },
+        "question_targets": { "type": "array", "items": { "$ref": "#/$defs/questionTarget" } },
+        "outline": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/string" } }
+      }
+    },
+    "questionTarget": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["target", "role"],
+      "properties": {
+        "target": { "$ref": "#/$defs/string" },
+        "role": { "enum": ["primary-carrier", "enricher"] }
+      }
+    },
+    "excluded": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["item", "reason_code"],
+      "properties": {
+        "item": { "$ref": "#/$defs/string" },
+        "reason_code": { "$ref": "#/$defs/string" }
+      }
+    },
+    "unsupported": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["item", "missing_capabilities"],
+      "properties": {
+        "item": { "$ref": "#/$defs/string" },
+        "missing_capabilities": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/string" } }
+      }
+    },
+    "failure": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "message", "unassigned"],
+      "properties": {
+        "code": { "enum": ["unsupported-domain", "no-stable-axis", "insufficient-identity-facts", "invalid-input", "strategy-failed"] },
+        "message": { "$ref": "#/$defs/string" },
+        "unassigned": { "type": "array", "items": { "$ref": "#/$defs/string" } },
+        "missing_capabilities": { "type": "array", "items": { "$ref": "#/$defs/string" } },
+        "missing_sources": { "type": "array", "items": { "$ref": "#/$defs/string" } }
+      }
+    },
+    "author": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["stage", "group_key", "outcome", "target_resolutions", "sections", "member_dispositions", "material_gaps", "diagnostics"],
+      "properties": {
+        "stage": { "const": "author" },
+        "group_key": { "$ref": "#/$defs/string" },
+        "outcome": { "enum": ["publish", "catalog-only", "request-material", "unsupported"] },
+        "artifact_intent": { "$ref": "#/$defs/string" },
+        "policy": { "$ref": "#/$defs/string" },
+        "target_resolutions": { "type": "array", "items": { "$ref": "#/$defs/targetResolution" } },
+        "title": { "$ref": "#/$defs/string" },
+        "summary": { "$ref": "#/$defs/string" },
+        "sections": { "type": "array", "items": { "$ref": "#/$defs/authorSection" } },
+        "member_dispositions": { "type": "array", "items": { "$ref": "#/$defs/memberDisposition" } },
+        "material_gaps": { "type": "array", "items": { "$ref": "#/$defs/materialGap" } },
+        "diagnostics": { "type": "array", "items": { "$ref": "#/$defs/diagnostic" } }
+      }
+    },
+    "targetResolution": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["target", "disposition"],
+      "properties": {
+        "target": { "$ref": "#/$defs/string" },
+        "disposition": { "enum": ["reuse-existing", "create-independent", "unresolved"] },
+        "reason_code": { "$ref": "#/$defs/string" }
+      }
+    },
+    "authorSection": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["key", "heading", "markdown", "source_items", "facts", "answers"],
+      "properties": {
+        "key": { "$ref": "#/$defs/string" },
+        "heading": { "$ref": "#/$defs/string" },
+        "markdown": { "$ref": "#/$defs/string" },
+        "source_items": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/string" } },
+        "facts": { "type": "array", "items": { "$ref": "#/$defs/string" } },
+        "answers": { "type": "array", "items": { "$ref": "#/$defs/string" } }
+      }
+    },
+    "memberDisposition": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["item", "state"],
+      "properties": {
+        "item": { "$ref": "#/$defs/string" },
+        "state": { "enum": ["covered", "catalog-only", "unsupported"] },
+        "section": { "$ref": "#/$defs/string" },
+        "reason_code": { "$ref": "#/$defs/string" }
+      }
+    },
+    "materialGap": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["question", "source_hints"],
+      "properties": {
+        "question": { "$ref": "#/$defs/string" },
+        "source_hints": { "type": "array", "items": { "$ref": "#/$defs/string" } }
+      }
+    },
+    "diagnostic": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "message"],
+      "properties": {
+        "code": { "$ref": "#/$defs/string" },
+        "message": { "$ref": "#/$defs/string" },
+        "target": { "$ref": "#/$defs/string" }
+      }
+    },
+    "postAuthor": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["stage", "results"],
+      "properties": {
+        "stage": { "const": "post-author" },
+        "results": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["task_key", "result"],
+            "properties": {
+              "task_key": { "type": "string", "pattern": "^task-[0-9]{3}$" },
+              "result": { "$ref": "#/$defs/postAuthorResult" }
+            }
+          }
+        }
+      }
+    },
+    "postAuthorResult": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["stage", "outcome", "proposals", "diagnostics"],
+      "properties": {
+        "stage": { "const": "post-author" },
+        "outcome": { "enum": ["complete", "failed"] },
+        "proposals": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["target", "artifact_kind", "title", "summary", "sections"],
+            "properties": {
+              "target": { "$ref": "#/$defs/string" },
+              "artifact_kind": { "$ref": "#/$defs/string" },
+              "title": { "$ref": "#/$defs/string" },
+              "summary": { "$ref": "#/$defs/string" },
+              "sections": {
+                "type": "array",
+                "minItems": 1,
+                "items": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": ["key", "heading", "markdown", "source_refs"],
+                  "properties": {
+                    "key": { "$ref": "#/$defs/string" },
+                    "heading": { "$ref": "#/$defs/string" },
+                    "markdown": { "$ref": "#/$defs/string" },
+                    "source_refs": {
+                      "type": "array",
+                      "minItems": 1,
+                      "items": { "$ref": "#/$defs/string" }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
+        "diagnostics": { "type": "array", "items": { "$ref": "#/$defs/diagnostic" } }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "outcome": { "const": "failed" } } },
+          "then": {
+            "properties": {
+              "diagnostics": { "type": "array", "minItems": 1 }
+            }
+          }
+        }
+      ]
+    },
+    "structureReview": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["stage", "decision"],
+      "properties": {
+        "stage": { "const": "structure-review" },
+        "decision": { "enum": ["approved", "request-adjustment"] },
+        "feedback": { "$ref": "#/$defs/string" }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "decision": { "const": "request-adjustment" } } },
+          "then": { "required": ["feedback"] }
+        }
+      ]
+    },
+    "layoutConfirmation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["stage", "decision"],
+      "properties": {
+        "stage": { "const": "layout-confirmation" },
+        "decision": { "enum": ["approved", "rejected"] },
+        "feedback": { "$ref": "#/$defs/string" },
+        "paths": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["artifact_ref", "output_path"],
+            "properties": {
+              "artifact_ref": { "$ref": "#/$defs/string" },
+              "output_path": { "$ref": "#/$defs/string" }
+            }
+          }
+        }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "decision": { "const": "rejected" } } },
+          "then": { "required": ["feedback"], "not": { "required": ["paths"] } }
+        }
+      ]
     }
   }
 }

package/providers/context/schemas/indexer-authorized-workset-view.schema.json

@@ -0,0 +1,65 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "context.indexer.authorized-workset-view/v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "protocol",
+    "operation",
+    "stage",
+    "workset_digest",
+    "execution_request_digest",
+    "source_ref",
+    "module_ref",
+    "projection_input_digests",
+    "items",
+    "view_digest"
+  ],
+  "properties": {
+    "protocol": { "const": "context.indexer.authorized-workset-view/v1" },
+    "operation": { "const": "main-index" },
+    "stage": { "enum": ["partition", "author"] },
+    "workset_digest": { "$ref": "#/$defs/digest" },
+    "execution_request_digest": { "$ref": "#/$defs/digest" },
+    "source_ref": { "type": "string", "minLength": 1 },
+    "module_ref": { "type": ["string", "null"] },
+    "projection_input_digests": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": { "$ref": "#/$defs/digest" }
+    },
+    "items": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["ref", "category", "provenance", "value", "item_digest"],
+        "properties": {
+          "ref": { "type": "string", "minLength": 1 },
+          "category": { "type": "string", "minLength": 1 },
+          "provenance": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["protocol", "digest"],
+            "properties": {
+              "protocol": { "type": "string", "minLength": 1 },
+              "digest": { "$ref": "#/$defs/digest" },
+              "container_ref": { "type": "string", "minLength": 1 }
+            }
+          },
+          "value": {},
+          "item_digest": { "$ref": "#/$defs/digest" }
+        }
+      }
+    },
+    "view_digest": { "$ref": "#/$defs/digest" }
+  },
+  "$defs": {
+    "digest": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    }
+  }
+}

package/providers/context/schemas/indexer-main-lifecycle-input.schema.json

@@ -4,33 +4,29 @@
   "oneOf": [
     {
       "type": "object",
-      "required": ["protocol", "requirement_set_digest", "profile_contract_digests", "source_inventory_digests", "items"],
+      "required": ["protocol", "requirement_set_digest"],
       "properties": {
         "protocol": { "const": "context.indexer.question-target-inventory-input/v1" },
-        "requirement_set_digest": { "$ref": "#/$defs/digest" },
-        "profile_contract_digests": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/digest" } },
-        "source_inventory_digests": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/digest" } },
-        "items": { "type": "array", "items": { "type": "object" } }
+        "requirement_set_digest": { "$ref": "#/$defs/digest" }
       },
       "additionalProperties": false
     },
     {
       "type": "object",
-      "required": ["protocol", "worksets"],
+      "required": ["protocol", "question_target_inventory"],
       "properties": {
         "protocol": { "const": "context.indexer.main-partition-workset-build-input/v1" },
-        "worksets": { "type": "array", "minItems": 1, "items": { "type": "object" } }
+        "question_target_inventory": { "type": "object" }
       },
       "additionalProperties": false
     },
     {
       "type": "object",
-      "required": ["protocol", "request", "result", "workset_read_receipts", "validation"],
+      "required": ["protocol", "request", "result", "validation"],
       "properties": {
         "protocol": { "const": "context.indexer.main-run-validation-input/v1" },
         "request": { "type": "object" },
         "result": { "type": "object" },
-        "workset_read_receipts": { "type": "array", "minItems": 1, "items": { "type": "object" } },
         "validation": { "type": "object" }
       },
       "additionalProperties": false
@@ -60,11 +56,11 @@
     },
     {
       "type": "object",
-      "required": ["protocol", "partitions", "group_contexts"],
+      "required": ["protocol", "partitions", "target_resolution_views"],
       "properties": {
         "protocol": { "const": "context.indexer.main-author-workset-build-input/v1" },
         "partitions": { "type": "array", "minItems": 1, "items": { "type": "object" } },
-        "group_contexts": { "type": "array", "minItems": 1, "items": { "type": "object" } }
+        "target_resolution_views": { "type": "array", "items": { "type": "object" } }
       },
       "additionalProperties": false
     },
@@ -124,38 +120,35 @@
     },
     {
       "type": "object",
-      "required": ["protocol", "requirement_set_digest", "workset_digest", "result", "workset_read_receipts"],
+      "required": ["protocol", "requirement_set_digest", "workset_digest", "result"],
       "properties": {
         "protocol": { "const": "context.indexer.main-run-partition-convergence-input/v1" },
         "requirement_set_digest": { "$ref": "#/$defs/digest" },
         "workset_digest": { "$ref": "#/$defs/digest" },
-        "result": { "type": "object" },
-        "workset_read_receipts": { "type": "array", "minItems": 1, "items": { "type": "object" } }
+        "result": { "type": "object" }
       },
       "additionalProperties": false
     },
     {
       "type": "object",
-      "required": ["protocol", "requirement_set_digest", "request", "convergence", "validation", "workset_read_receipts"],
+      "required": ["protocol", "requirement_set_digest", "request", "convergence", "validation"],
       "properties": {
         "protocol": { "const": "context.indexer.catalog-fallback-build-input/v1" },
         "requirement_set_digest": { "$ref": "#/$defs/digest" },
         "request": { "type": "object" },
         "convergence": { "type": "object" },
-        "validation": { "type": "object" },
-        "workset_read_receipts": { "type": "array", "minItems": 1, "items": { "type": "object" } }
+        "validation": { "type": "object" }
       },
       "additionalProperties": false
     },
     {
       "type": "object",
-      "required": ["protocol", "requirement_set_digest", "workset_digest", "result", "workset_read_receipts"],
+      "required": ["protocol", "requirement_set_digest", "workset_digest", "result"],
       "properties": {
         "protocol": { "const": "context.indexer.main-run-store-accept-input/v1" },
         "requirement_set_digest": { "$ref": "#/$defs/digest" },
         "workset_digest": { "$ref": "#/$defs/digest" },
-        "result": { "type": "object" },
-        "workset_read_receipts": { "type": "array", "minItems": 1, "items": { "type": "object" } }
+        "result": { "type": "object" }
       },
       "additionalProperties": false
     },

package/providers/context/schemas/indexer-main-lifecycle-output.schema.json

@@ -17,11 +17,26 @@
     },
     {
       "type": "object",
-      "required": ["protocol", "worksets", "workset_set"],
+      "required": ["protocol", "requirement_set_digest", "worksets", "workset_set", "run_specs", "graph_outcome"],
       "properties": {
-        "protocol": { "enum": ["context.indexer.main-partition-workset-build/v1", "context.indexer.main-author-workset-build/v1"] },
+        "protocol": { "const": "context.indexer.main-partition-workset-build/v1" },
+        "requirement_set_digest": { "$ref": "#/$defs/digest" },
+        "worksets": { "type": "array" },
+        "workset_set": { "type": "object" },
+        "run_specs": { "type": "array", "minItems": 1, "items": { "type": "object" } },
+        "graph_outcome": { "const": "completed" }
+      },
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "required": ["protocol", "requirement_set_digest", "worksets", "workset_set", "run_specs", "graph_outcome"],
+      "properties": {
+        "protocol": { "const": "context.indexer.main-author-workset-build/v1" },
+        "requirement_set_digest": { "$ref": "#/$defs/digest" },
         "worksets": { "type": "array" },
         "workset_set": { "type": "object" },
+        "run_specs": { "type": "array", "minItems": 1, "items": { "type": "object" } },
         "graph_outcome": { "const": "completed" }
       },
       "additionalProperties": false