@c4a/context-cli 0.7.8 → 0.7.9

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

@@ -460,163 +460,197 @@
               "providers": {
                 "type": "array",
                 "items": {
-                  "type": "object",
-                  "properties": {
-                    "id": {
-                      "$ref": "#/$defs/providerSelection/properties/indexers/items/properties/id"
-                    },
-                    "role": {
-                      "type": "string",
-                      "enum": [
-                        "primary",
-                        "extension"
-                      ],
-                      "default": "primary"
-                    },
-                    "skill": {
-                      "$ref": "#/$defs/providerSelection/properties/indexers/items/properties/id"
-                    },
-                    "version": {
-                      "type": "string",
-                      "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$"
-                    },
-                    "integrity": {
-                      "type": "string",
-                      "pattern": "^sha256:[a-f0-9]{64}$"
-                    },
-                    "distribution": {
-                      "anyOf": [
-                        {
-                          "type": "object",
-                          "properties": {
-                            "kind": {
-                              "type": "string",
-                              "const": "cli-bundled"
-                            },
-                            "locator": {
-                              "type": "string",
-                              "pattern": "^cli-bundled:\\/\\/[a-z0-9][a-z0-9._-]*\\/[a-z0-9][a-z0-9._-]*$"
-                            }
-                          },
-                          "required": [
-                            "kind",
-                            "locator"
-                          ],
-                          "additionalProperties": false
+                  "anyOf": [
+                    {
+                      "type": "object",
+                      "properties": {
+                        "id": {
+                          "$ref": "#/$defs/providerSelection/properties/indexers/items/properties/id"
                         },
-                        {
-                          "type": "object",
-                          "properties": {
-                            "kind": {
-                              "type": "string",
-                              "const": "bundled"
-                            },
-                            "locator": {
-                              "type": "string",
-                              "pattern": "^plugin:\\/\\/[a-z0-9][a-z0-9._-]*\\/[a-z0-9][a-z0-9._-]*$"
-                            }
-                          },
-                          "required": [
-                            "kind",
-                            "locator"
+                        "role": {
+                          "type": "string",
+                          "enum": [
+                            "primary",
+                            "extension"
                           ],
-                          "additionalProperties": false
+                          "default": "primary"
                         },
-                        {
+                        "catalog_skill": {
+                          "$ref": "#/$defs/providerSelection/properties/indexers/items/properties/id"
+                        },
+                        "config": {
                           "type": "object",
-                          "properties": {
-                            "kind": {
-                              "type": "string",
-                              "const": "workspace"
-                            },
-                            "locator": {
-                              "type": "string",
-                              "pattern": "^workspace:\\/\\/[A-Za-z0-9._~-]+(?:\\/[A-Za-z0-9._~-]+)*$"
-                            }
-                          },
-                          "required": [
-                            "kind",
-                            "locator"
+                          "additionalProperties": {
+                            "anyOf": [
+                              {
+                                "type": "null"
+                              },
+                              {
+                                "type": "boolean"
+                              },
+                              {
+                                "type": "number"
+                              },
+                              {
+                                "type": "string"
+                              },
+                              {
+                                "type": "array",
+                                "items": {
+                                  "$ref": "#/$defs/providerSelection/properties/indexers/items/properties/providers/items/anyOf/0/properties/config/additionalProperties"
+                                }
+                              },
+                              {
+                                "type": "object",
+                                "additionalProperties": {
+                                  "$ref": "#/$defs/providerSelection/properties/indexers/items/properties/providers/items/anyOf/0/properties/config/additionalProperties"
+                                }
+                              }
+                            ]
+                          }
+                        }
+                      },
+                      "required": [
+                        "id",
+                        "catalog_skill"
+                      ],
+                      "additionalProperties": false
+                    },
+                    {
+                      "type": "object",
+                      "properties": {
+                        "id": {
+                          "$ref": "#/$defs/providerSelection/properties/indexers/items/properties/id"
+                        },
+                        "role": {
+                          "type": "string",
+                          "enum": [
+                            "primary",
+                            "extension"
                           ],
-                          "additionalProperties": false
+                          "default": "primary"
                         },
-                        {
-                          "type": "object",
-                          "properties": {
-                            "kind": {
-                              "type": "string",
-                              "const": "package"
+                        "skill": {
+                          "$ref": "#/$defs/providerSelection/properties/indexers/items/properties/id"
+                        },
+                        "version": {
+                          "type": "string",
+                          "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$"
+                        },
+                        "integrity": {
+                          "type": "string",
+                          "pattern": "^sha256:[a-f0-9]{64}$"
+                        },
+                        "distribution": {
+                          "anyOf": [
+                            {
+                              "type": "object",
+                              "properties": {
+                                "kind": {
+                                  "type": "string",
+                                  "const": "cli-bundled"
+                                },
+                                "locator": {
+                                  "type": "string",
+                                  "pattern": "^cli-bundled:\\/\\/[a-z0-9][a-z0-9._-]*\\/[a-z0-9][a-z0-9._-]*$"
+                                }
+                              },
+                              "required": [
+                                "kind",
+                                "locator"
+                              ],
+                              "additionalProperties": false
                             },
-                            "locator": {
-                              "type": "string",
-                              "pattern": "^package:\\/\\/[a-z0-9][a-z0-9._-]*\\/[^/#\\s]+#[A-Za-z0-9._~-]+(?:\\/[A-Za-z0-9._~-]+)*$"
+                            {
+                              "type": "object",
+                              "properties": {
+                                "kind": {
+                                  "type": "string",
+                                  "const": "bundled"
+                                },
+                                "locator": {
+                                  "type": "string",
+                                  "pattern": "^plugin:\\/\\/[a-z0-9][a-z0-9._-]*\\/[a-z0-9][a-z0-9._-]*$"
+                                }
+                              },
+                              "required": [
+                                "kind",
+                                "locator"
+                              ],
+                              "additionalProperties": false
+                            },
+                            {
+                              "type": "object",
+                              "properties": {
+                                "kind": {
+                                  "type": "string",
+                                  "const": "workspace"
+                                },
+                                "locator": {
+                                  "type": "string",
+                                  "pattern": "^workspace:\\/\\/[A-Za-z0-9._~-]+(?:\\/[A-Za-z0-9._~-]+)*$"
+                                }
+                              },
+                              "required": [
+                                "kind",
+                                "locator"
+                              ],
+                              "additionalProperties": false
+                            },
+                            {
+                              "type": "object",
+                              "properties": {
+                                "kind": {
+                                  "type": "string",
+                                  "const": "package"
+                                },
+                                "locator": {
+                                  "type": "string",
+                                  "pattern": "^package:\\/\\/[a-z0-9][a-z0-9._-]*\\/[^/#\\s]+#[A-Za-z0-9._~-]+(?:\\/[A-Za-z0-9._~-]+)*$"
+                                }
+                              },
+                              "required": [
+                                "kind",
+                                "locator"
+                              ],
+                              "additionalProperties": false
+                            },
+                            {
+                              "type": "object",
+                              "properties": {
+                                "kind": {
+                                  "type": "string",
+                                  "const": "marketplace"
+                                },
+                                "locator": {
+                                  "type": "string",
+                                  "pattern": "^marketplace:\\/\\/[a-z0-9][a-z0-9._-]*\\/[a-z0-9][a-z0-9._-]*\\/[a-z0-9][a-z0-9._-]*$"
+                                }
+                              },
+                              "required": [
+                                "kind",
+                                "locator"
+                              ],
+                              "additionalProperties": false
                             }
-                          },
-                          "required": [
-                            "kind",
-                            "locator"
-                          ],
-                          "additionalProperties": false
+                          ]
                         },
-                        {
+                        "config": {
                           "type": "object",
-                          "properties": {
-                            "kind": {
-                              "type": "string",
-                              "const": "marketplace"
-                            },
-                            "locator": {
-                              "type": "string",
-                              "pattern": "^marketplace:\\/\\/[a-z0-9][a-z0-9._-]*\\/[a-z0-9][a-z0-9._-]*\\/[a-z0-9][a-z0-9._-]*$"
-                            }
-                          },
-                          "required": [
-                            "kind",
-                            "locator"
-                          ],
-                          "additionalProperties": false
-                        }
-                      ]
-                    },
-                    "config": {
-                      "type": "object",
-                      "additionalProperties": {
-                        "anyOf": [
-                          {
-                            "type": "null"
-                          },
-                          {
-                            "type": "boolean"
-                          },
-                          {
-                            "type": "number"
-                          },
-                          {
-                            "type": "string"
-                          },
-                          {
-                            "type": "array",
-                            "items": {
-                              "$ref": "#/$defs/providerSelection/properties/indexers/items/properties/providers/items/properties/config/additionalProperties"
-                            }
-                          },
-                          {
-                            "type": "object",
-                            "additionalProperties": {
-                              "$ref": "#/$defs/providerSelection/properties/indexers/items/properties/providers/items/properties/config/additionalProperties"
-                            }
+                          "additionalProperties": {
+                            "$ref": "#/$defs/providerSelection/properties/indexers/items/properties/providers/items/anyOf/0/properties/config/additionalProperties"
                           }
-                        ]
-                      }
+                        }
+                      },
+                      "required": [
+                        "id",
+                        "skill",
+                        "version",
+                        "integrity"
+                      ],
+                      "additionalProperties": false
                     }
-                  },
-                  "required": [
-                    "id",
-                    "skill",
-                    "version",
-                    "integrity"
-                  ],
-                  "additionalProperties": false
+                  ]
                 },
                 "minItems": 1
               },
@@ -1164,7 +1198,8 @@
                       },
                       "group_key": {
                         "type": "string",
-                        "minLength": 1
+                        "minLength": 1,
+                        "description": "May be omitted in a CLI batch to inherit the current task's group. An explicit value must match; standalone SDK results still require it."
                       },
                       "outcome": {
                         "type": "string",
@@ -1549,7 +1584,6 @@
                     },
                     "required": [
                       "stage",
-                      "group_key",
                       "outcome",
                       "title",
                       "summary",
@@ -1565,7 +1599,8 @@
                         "$ref": "#/$defs/authorBatch/properties/results/items/properties/result/anyOf/0/properties/stage"
                       },
                       "group_key": {
-                        "$ref": "#/$defs/authorBatch/properties/results/items/properties/result/anyOf/0/properties/group_key"
+                        "$ref": "#/$defs/authorBatch/properties/results/items/properties/result/anyOf/0/properties/group_key",
+                        "description": "May be omitted in a CLI batch to inherit the current task's group. An explicit value must match; standalone SDK results still require it."
                       },
                       "outcome": {
                         "type": "string",
@@ -1615,7 +1650,6 @@
                     },
                     "required": [
                       "stage",
-                      "group_key",
                       "outcome",
                       "articles",
                       "member_dispositions"
@@ -1629,7 +1663,8 @@
                         "$ref": "#/$defs/authorBatch/properties/results/items/properties/result/anyOf/0/properties/stage"
                       },
                       "group_key": {
-                        "$ref": "#/$defs/authorBatch/properties/results/items/properties/result/anyOf/0/properties/group_key"
+                        "$ref": "#/$defs/authorBatch/properties/results/items/properties/result/anyOf/0/properties/group_key",
+                        "description": "May be omitted in a CLI batch to inherit the current task's group. An explicit value must match; standalone SDK results still require it."
                       },
                       "outcome": {
                         "type": "string",
@@ -1680,7 +1715,6 @@
                     },
                     "required": [
                       "stage",
-                      "group_key",
                       "outcome",
                       "member_dispositions"
                     ],
@@ -1693,7 +1727,8 @@
                         "$ref": "#/$defs/authorBatch/properties/results/items/properties/result/anyOf/0/properties/stage"
                       },
                       "group_key": {
-                        "$ref": "#/$defs/authorBatch/properties/results/items/properties/result/anyOf/0/properties/group_key"
+                        "$ref": "#/$defs/authorBatch/properties/results/items/properties/result/anyOf/0/properties/group_key",
+                        "description": "May be omitted in a CLI batch to inherit the current task's group. An explicit value must match; standalone SDK results still require it."
                       },
                       "outcome": {
                         "type": "string",
@@ -1738,7 +1773,6 @@
                     },
                     "required": [
                       "stage",
-                      "group_key",
                       "outcome",
                       "member_dispositions"
                     ],
@@ -1751,7 +1785,8 @@
                         "$ref": "#/$defs/authorBatch/properties/results/items/properties/result/anyOf/0/properties/stage"
                       },
                       "group_key": {
-                        "$ref": "#/$defs/authorBatch/properties/results/items/properties/result/anyOf/0/properties/group_key"
+                        "$ref": "#/$defs/authorBatch/properties/results/items/properties/result/anyOf/0/properties/group_key",
+                        "description": "May be omitted in a CLI batch to inherit the current task's group. An explicit value must match; standalone SDK results still require it."
                       },
                       "outcome": {
                         "type": "string",
@@ -1796,7 +1831,6 @@
                     },
                     "required": [
                       "stage",
-                      "group_key",
                       "outcome",
                       "member_dispositions"
                     ],
@@ -2063,7 +2097,7 @@
               "type": "string",
               "const": "structure-review"
             },
-            "reading_structure": {
+            "knowledge_map": {
               "type": "object",
               "properties": {
                 "expected_revision": {
@@ -2162,8 +2196,8 @@
             "stage": {
               "$ref": "#/$defs/structureReview/anyOf/0/properties/stage"
             },
-            "reading_structure": {
-              "$ref": "#/$defs/structureReview/anyOf/0/properties/reading_structure"
+            "knowledge_map": {
+              "$ref": "#/$defs/structureReview/anyOf/0/properties/knowledge_map"
             },
             "decision": {
               "type": "string",
@@ -2185,8 +2219,8 @@
             "stage": {
               "$ref": "#/$defs/structureReview/anyOf/0/properties/stage"
             },
-            "reading_structure": {
-              "$ref": "#/$defs/structureReview/anyOf/0/properties/reading_structure"
+            "knowledge_map": {
+              "$ref": "#/$defs/structureReview/anyOf/0/properties/knowledge_map"
             },
             "decision": {
               "type": "string",

package/providers/context/schemas/source-batch-input.schema.json

@@ -3,23 +3,30 @@
   "$id": "https://context4ai.dev/schemas/context-source-batch-input.v1.json",
   "title": "Context source batch input",
   "description": "One confirmed batch of repository, local document, and Lark document source boundaries.",
-  "oneOf": [
-    {
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "work_start_report",
+    "sources"
+  ],
+  "properties": {
+    "work_start_report": {
       "type": "object",
       "additionalProperties": false,
       "required": [
-        "sources"
+        "path"
       ],
       "properties": {
-        "sources": {
-          "$ref": "#/$defs/sources"
+        "path": {
+          "const": ".tmp/work-start-report.md"
         }
-      }
+      },
+      "description": "The complete report already presented at the first-task source-boundary gate."
     },
-    {
+    "sources": {
       "$ref": "#/$defs/sources"
     }
-  ],
+  },
   "$defs": {
     "module": {
       "type": "string",

package/providers/context/skills/configure-indexer-providers/SKILL.md

@@ -9,6 +9,12 @@ metadata:
 
 # Configure Indexer Providers
 
+Before dependent bulk work, follow
+[the shared homogeneous-source review](../../resources/procedures/homogeneous-source-review.md).
+Reuse explicit group decisions; when a newly observed group needs user choice,
+present its concrete scope and pause before parsing or submitting dependent work.
+
+
 Read
 the `context.indexer.provider-guide` resource at the exact path in the current Route
 for the registry-only default, Provider-layer rules, conflict handling and
@@ -29,8 +35,12 @@ the shipped release. Read those files only for a Provider you intend to select
 when its guidance is not already available; resolve its relative references
 against that supplied bundle, not an arbitrary installed copy. Do not run a separate catalog command,
 enumerate every installed Skill, or require a discovery report/confirmation.
-For a selected shipped Provider, copy its exact version, integrity and
-cli-bundled distribution from the supplied catalog. The same Skill/version
+For a selected shipped Provider, submit `{id, role, catalog_skill}` using the
+catalog's exact skill name, plus `config` only when needed. The CLI expands the
+version, integrity and distribution from the revision-bound catalog and validates
+the complete registry. Do not supply identity overrides alongside `catalog_skill`.
+Use full identity fields for an external Provider or a deliberately pinned existing
+entry; those still follow normal resolution and authorization. The same Skill/version
 visible in the Host is a projection, not another Provider or a reason for Host
 resolution. If selecting a relevant external Skill, read only its exact
 Host-exposed frontmatter and sibling `context-indexer.yaml` needed to identify
@@ -79,8 +89,10 @@ current Route when the work warrants a report. This is the last planning handoff
 before Partition: write or update `.tmp/work-start-report.md` with the Host file
 tool. Explain discovered Indexer choices and non-selections using the supplied
 catalog, visible relevant Skills and this task's materials; label unapplied choices
-as proposals. Follow the report procedure's reading invitation and pause before
-submitting the normal Provider selection below, unless explicitly waived.
+as proposals. Reuse the first report's confirmed purpose, scope and authority;
+updating it with compatible Provider choices does not require another pause.
+Ask again only for a material unresolved user decision or a current authorization
+Gate; do not bypass the initial report handoff if it has not happened.
 A useful report already formed during requirement setup should be reused; do not
 restart discussion or add report fields to the selection Result.
 
@@ -98,7 +110,8 @@ visible to the Host; leave it empty for a CLI-bundled selection without external
 observations. It is not an inventory of installed Skills. `indexers` contains
 the semantic registry entries selected for the
 unchanged requirements in the Action input. Select portable distribution
-locators and exact versions and integrities. Each required
+locators and exact versions and integrities for full identity entries; use
+`catalog_skill` for an explicit bundled catalog choice. Each required
 requirement/domain/source/module owner cell needs one primary Indexer;
 overlapping read scope is allowed for enrichers. One Indexer may combine a
 primary layer, supporting profiles, extension layers, and composers, but