@c4a/context-cli 0.7.4 → 0.7.8

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

@@ -43,13 +43,12 @@
     },
     {
       "type": "object",
-      "required": ["protocol", "request", "result", "operation_result", "authoring_audit", "accepted_record", "graph_outcome"],
+      "required": ["protocol", "request", "result", "operation_result", "accepted_record", "graph_outcome"],
       "properties": {
         "protocol": { "const": "context.indexer.main-run-validation/v1" },
         "request": { "type": "object" },
         "result": { "type": "object" },
         "operation_result": { "type": "object" },
-        "authoring_audit": { "type": ["object", "null"] },
         "accepted_record": { "type": "object" },
         "graph_outcome": { "const": "completed" }
       },

package/providers/context/schemas/indexer-materialize-request.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "context.indexer.materialize-request/v1",
+  "$id": "context.indexer.materialize-request/v2",
   "type": "object",
   "additionalProperties": false,
   "required": [
@@ -12,9 +12,7 @@
     "provider_fingerprint",
     "provider_integrity",
     "manifest_digest",
-    "requirement_set_digest",
-    "workset_ref",
-    "workset_digest",
+    "stage",
     "profile",
     "composer_id",
     "instruction_set_digest",
@@ -22,7 +20,7 @@
     "request_digest"
   ],
   "properties": {
-    "protocol": { "const": "context.indexer.materialize-request/v1" },
+    "protocol": { "const": "context.indexer.materialize-request/v2" },
     "handler": { "const": "context.materialize-indexer-instructions/v1" },
     "resource_id": { "const": "resolved-indexer-instructions" },
     "indexer_id": { "type": "string", "minLength": 1 },
@@ -30,9 +28,7 @@
     "provider_fingerprint": { "$ref": "#/$defs/digest" },
     "provider_integrity": { "$ref": "#/$defs/digest" },
     "manifest_digest": { "$ref": "#/$defs/digest" },
-    "requirement_set_digest": { "$ref": "#/$defs/digest" },
-    "workset_ref": { "type": "string", "minLength": 1 },
-    "workset_digest": { "$ref": "#/$defs/digest" },
+    "stage": { "enum": ["partition", "author", "post-author"] },
     "profile": { "type": "string", "minLength": 1 },
     "composer_id": {
       "oneOf": [

package/providers/context/schemas/indexer-registry-bootstrap.schema.json

@@ -0,0 +1,227 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "context.indexer.registry/v1",
+  "title": "Initial Indexer registry before Provider selection",
+  "description": "The requirements-only src/indexers.yaml configuration. This is not an Action Result. The Provider selection Route supplies indexers after this file is configured. Runtime validation also checks duplicate ids, source boundaries and contract references.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "protocol",
+    "requirements",
+    "indexers"
+  ],
+  "properties": {
+    "protocol": {
+      "const": "context.indexer.registry/v1"
+    },
+    "requirements": {
+      "$ref": "#/$defs/requirements"
+    },
+    "indexers": {
+      "type": "array",
+      "maxItems": 0
+    }
+  },
+  "$defs": {
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9._/-]*$",
+      "description": "Slash-separated segments cannot be empty or equal to '.' or '..'."
+    },
+    "ref": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9.-]*:[A-Za-z0-9][A-Za-z0-9._~:/#-]*$"
+    },
+    "digest": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "target": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "source_ref"
+      ],
+      "properties": {
+        "source_ref": {
+          "$ref": "#/$defs/ref"
+        },
+        "module_refs": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/ref"
+          },
+          "uniqueItems": true,
+          "default": [],
+          "description": "Omit to cover the full registered source boundary. Use only known module references to narrow it."
+        }
+      }
+    },
+    "scope": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "targets"
+      ],
+      "properties": {
+        "targets": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "$ref": "#/$defs/target"
+          }
+        }
+      }
+    },
+    "question": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "ref",
+        "authority",
+        "contract_version",
+        "contract_digest"
+      ],
+      "properties": {
+        "ref": {
+          "$ref": "#/$defs/ref"
+        },
+        "authority": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "kind",
+            "ref",
+            "digest"
+          ],
+          "properties": {
+            "kind": {
+              "enum": [
+                "cli-base-contract",
+                "verified-contract-overlay"
+              ]
+            },
+            "ref": {
+              "$ref": "#/$defs/ref"
+            },
+            "digest": {
+              "$ref": "#/$defs/digest"
+            }
+          }
+        },
+        "contract_version": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "contract_digest": {
+          "$ref": "#/$defs/digest"
+        }
+      }
+    },
+    "exclusion": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "scope",
+        "reason"
+      ],
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/id"
+        },
+        "scope": {
+          "$ref": "#/$defs/scope"
+        },
+        "reason": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "requirement": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "reader_goals",
+        "coverage_domains",
+        "target_scope",
+        "evidence_source_scope"
+      ],
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/id"
+        },
+        "reader_goals": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/id"
+          }
+        },
+        "coverage_domains": {
+          "type": "object",
+          "minProperties": 1,
+          "propertyNames": {
+            "$ref": "#/$defs/id"
+          },
+          "additionalProperties": {
+            "enum": [
+              "required",
+              "optional",
+              "out-of-scope"
+            ]
+          }
+        },
+        "target_scope": {
+          "$ref": "#/$defs/scope"
+        },
+        "evidence_source_scope": {
+          "$ref": "#/$defs/scope"
+        },
+        "questions": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/question"
+          }
+        },
+        "exclusions": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/exclusion"
+          }
+        },
+        "purpose": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Short reader and task purpose in the user language; reuse explicit goals when absent."
+        }
+      }
+    },
+    "requirements": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "$ref": "#/$defs/requirement"
+      }
+    },
+    "requirementSet": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "protocol",
+        "requirements"
+      ],
+      "properties": {
+        "protocol": {
+          "const": "context.indexer.requirement-set/v1"
+        },
+        "requirements": {
+          "$ref": "#/$defs/requirements"
+        }
+      }
+    }
+  }
+}

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

@@ -16,7 +16,10 @@
   "properties": {
     "protocol": { "const": "context.indexer.workset-view-materialization-request/v1" },
     "handler": { "const": "context.materialize-indexer-workset-view/v1" },
-    "resource_id": { "const": "authorized-indexer-workset-view" },
+    "resource_id": {
+      "type": "string",
+      "pattern": "^authorized-indexer-workset-view(?:/task-[0-9]{3})?$"
+    },
     "workset_digest": { "$ref": "#/$defs/digest" },
     "execution_request_digest": { "$ref": "#/$defs/digest" },
     "view_digest": { "$ref": "#/$defs/digest" },

package/providers/context/schemas/source-update-result.schema.json

@@ -0,0 +1,83 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "stage",
+    "decisions",
+    "scope_summary",
+    "new_topics"
+  ],
+  "properties": {
+    "stage": {
+      "const": "source-update"
+    },
+    "scope_summary": {
+      "type": "string",
+      "minLength": 1
+    },
+    "new_topics": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "path",
+          "title",
+          "source_refs",
+          "instruction"
+        ],
+        "properties": {
+          "path": {
+            "type": "string",
+            "minLength": 1
+          },
+          "title": {
+            "type": "string",
+            "minLength": 1
+          },
+          "source_refs": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "instruction": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      }
+    },
+    "decisions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "path"
+        ],
+        "properties": {
+          "path": {
+            "type": "string",
+            "minLength": 1
+          },
+          "instruction": {
+            "type": "string",
+            "minLength": 1
+          },
+          "supporting_sources": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/providers/context/skills/authorize-current-indexer-provider-program/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: context-authorize-current-indexer-provider-program
+description: Resolve the current Context Gate for an exact non-sandboxed Indexer Provider program.
+metadata:
+  agent-graph: path:../../provider.yaml
+  agent-graph.graph: indexer
+  agent-graph.entry: current-provider-program-authorization
+---
+
+# Authorize the current Provider program
+
+Read the exact program report in `gate.resolution_action.input`. Resolve only the current Gate:
+
+- return `stage: provider-program-authorization`;
+- return `decision: approved` only when the user approved it or the Route says the Gate is resolved
+  by session authority;
+- otherwise return `decision: rejected`.
+
+Do not change Provider identity, program content, scope, limits, or authority. Submit the value to
+the Route's only `complete-current` command and then follow the newly returned Route.

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

@@ -10,32 +10,80 @@ metadata:
 # Configure Indexer Providers
 
 Read
-`node_modules/@c4a/context/docs/guides/indexer-provider-and-customization.md`
+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
 completion conditions. This Action is the entry for
 `indexer-provider-required`; when an exact distribution is unavailable, follow
 the guide's `indexer-provider-unavailable` handling instead of substituting a
 different version or cache.
 
+The current output schema defines each accepted Indexer entry. Use the guide's
+Provider selection example with the current requirements and catalog values;
+the requirements-only bootstrap schema is not this Action's result schema.
+
 The current Action input already contains the exact requirements and
-CLI-bundled catalog. Report those bundled entries together with other Indexer
-entry Skills already visible in this conversation. For an exact Skill root
-already exposed by the Host, read only `SKILL.md` frontmatter and the sibling
-`context-indexer.yaml`: the manifest version is authoritative and
-`metadata.context-provider-version` must match it. Do not load Provider guidance
-until selection. Group the same Skill name and exact version into one
-conversation item with all observed source types; an installed copy of the
-same CLI-bundled identity is not another Provider. Keep different versions
-separate, never use source count or discovery order as precedence, and do not
-scan plugin caches or persist this discovery list.
+CLI-bundled catalog. Select applicable Providers using that input and the Skills
+already visible in this conversation. Each bundled entry includes compact
+`capabilities` and exact `guidance.skill_path` / `guidance.manifest_path` for
+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
+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
+it; manifest version is authoritative. Do not guess missing versions, substitute
+a different version, or scan caches. Read Provider guidance only when selected.
+
+Use `existing_indexers` in the Action input as the starting point. Preserve
+unrelated entries and reuse an applicable owner before adding a binding for a
+new reader topic. An installed Provider and a workspace binding are different:
+adding a binding does not create or install a Skill. Once the user has settled
+the knowledge purpose and workspace, complete ordinary compatible bindings
+without asking the user to approve internal Indexer counts or configuration.
+Do not invoke Indexer creation when the supplied catalog already covers the
+requested interpretation. Real capability gaps still follow the Provider guide.
+
+Business skill installation and switches belong to the Host. Discover relevant
+currently visible `context-…-indexer…` skills and read their actual manifests.
+Do not override a disabled default or a selected business replacement just
+because the CLI catalog lists it. There is no second CLI enable registry.
+
+Use Note/Sessions Providers for independent reader topics from those sources;
+a session does not require code association. FAQ, guide and decision are reader
+forms, not source types. Existing Code/Markdown pages retain one primary and
+receive supporting sources in their evidence/read scope. If specialized source
+interpretation is needed, explicitly select a compatible extension layer with
+`kind: extension`; `supporting` profiles are only from the same primary layer.
+The primary writes one final page, without duplicate session/note targets.
 
 When the Graph enters through `markdown-provider`, first require the completed
-capture report and report the visible `context-markdown-indexer*` Skills before
-building the route input. Treat only the report's exact `source_inputs` as
+capture report. Treat only the report's exact `source_inputs` as
 current evidence. Do not infer semantic ownership from filenames, titles, or
 headings, and do not persist the discovery list. Capture proves byte/currentness
 only; the selected Markdown Provider remains responsible for semantic indexing.
 
+Choose skills to cover the useful regions agreed with the user, not every
+capability a Provider advertises or every file in a registered source. Distinguish
+regions that need knowledge pages from materials only needed to support them;
+available material does not automatically require a separate skill or page.
+If representative reading exposes a substantial unresolved scope tradeoff,
+clarify it through the existing requirement workflow before dependent selection.
+This selection Result must not silently change requirements or expand read scope.
+
+Once purpose and scope are settled and the applicable Provider capabilities are
+known, use `procedure.work-start-report` and `template.work-start-report` from the
+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.
+A useful report already formed during requirement setup should be reused; do not
+restart discussion or add report fields to the selection Result.
+
 Return only the compact current-Action result:
 
 ```yaml
@@ -45,8 +93,10 @@ indexers:
   - <one complete selected Indexer registry entry>
 ```
 
-`host_visible_skills` contains only non-CLI observations already visible to
-the Host. `indexers` contains the semantic registry entries selected for the
+`host_visible_skills` contains only relevant non-CLI observations already
+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
 requirement/domain/source/module owner cell needs one primary Indexer;
@@ -54,6 +104,9 @@ overlapping read scope is allowed for enrichers. One Indexer may combine a
 primary layer, supporting profiles, extension layers, and composers, but
 Provider array order is not precedence.
 
+Keep catalog capabilities and guidance paths out of the submitted entries;
+they are selection help, not registry fields.
+
 Choose the applicable CLI-bundled community profile directly when no visible
 specialized Provider is required. The CLI constructs the full route input,
 performs fallback/conflict checks, validates the proposal, resolves and stages