@c4a/context-cli 0.6.19 → 0.7.0

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

@@ -0,0 +1,42 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "context.indexer.project-observation-result/v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "protocol",
+    "state",
+    "proposal_digest",
+    "apply_receipt_digest",
+    "target_set_digest",
+    "requirement_set_digest",
+    "registry_digest",
+    "indexer_selection_digest",
+    "validation_report_digests",
+    "selection_proposal_input",
+    "observation_digest",
+    "result_digest"
+  ],
+  "properties": {
+    "protocol": { "const": "context.indexer.project-observation-result/v1" },
+    "state": { "const": "current" },
+    "proposal_digest": { "$ref": "#/$defs/digest" },
+    "apply_receipt_digest": { "$ref": "#/$defs/digest" },
+    "target_set_digest": { "$ref": "#/$defs/digest" },
+    "requirement_set_digest": { "$ref": "#/$defs/digest" },
+    "registry_digest": { "$ref": "#/$defs/digest" },
+    "indexer_selection_digest": { "$ref": "#/$defs/digest" },
+    "validation_report_digests": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": { "$ref": "#/$defs/digest" }
+    },
+    "selection_proposal_input": { "type": "object" },
+    "observation_digest": { "$ref": "#/$defs/digest" },
+    "result_digest": { "$ref": "#/$defs/digest" }
+  },
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+  }
+}

package/providers/context/schemas/indexer-provider-route-input.schema.json

@@ -0,0 +1,55 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "context.indexer.provider-route-input/v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "protocol",
+    "project_ref",
+    "registry",
+    "visible_skills",
+    "community_fallback_attempted",
+    "input_digest"
+  ],
+  "properties": {
+    "protocol": { "const": "context.indexer.provider-route-input/v1" },
+    "project_ref": { "type": "string", "minLength": 1 },
+    "registry": { "$ref": "#/$defs/registry" },
+    "visible_skills": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["skill", "version", "source_type"],
+        "properties": {
+          "skill": { "$ref": "#/$defs/id" },
+          "version": {
+            "anyOf": [
+              { "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.-]+)?$" },
+              { "type": "null" }
+            ]
+          },
+          "source_type": {
+            "enum": ["community-plugin", "cli-bundled", "workspace", "installed-plugin", "marketplace"]
+          }
+        }
+      }
+    },
+    "community_fallback_attempted": { "type": "boolean" },
+    "input_digest": { "$ref": "#/$defs/digest" }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9._/-]*$" },
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "registry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["protocol", "requirements", "indexers"],
+      "properties": {
+        "protocol": { "const": "context.indexer.registry/v1" },
+        "requirements": { "type": "array", "minItems": 1, "items": { "type": "object" } },
+        "indexers": { "type": "array", "items": { "type": "object" } }
+      }
+    }
+  }
+}

package/providers/context/schemas/indexer-provider-route-report.schema.json

@@ -0,0 +1,188 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "context.indexer.provider-route-report/v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "protocol",
+    "project_ref",
+    "input_digest",
+    "requirement_set_digest",
+    "registry_digest",
+    "visible_skill_set_digest",
+    "selected_skill_ids",
+    "composition_mode",
+    "community_fallback_attempted",
+    "unowned_required_owner_cells",
+    "conflicting_owner_cells",
+    "read_scope_overlaps",
+    "capability_gaps",
+    "capability_gap_proof",
+    "route",
+    "selection_proposal_input",
+    "report_digest"
+  ],
+  "properties": {
+    "protocol": { "const": "context.indexer.provider-route-report/v1" },
+    "project_ref": { "type": "string", "minLength": 1 },
+    "input_digest": { "$ref": "#/$defs/digest" },
+    "requirement_set_digest": { "$ref": "#/$defs/digest" },
+    "registry_digest": { "$ref": "#/$defs/digest" },
+    "visible_skill_set_digest": { "$ref": "#/$defs/digest" },
+    "selected_skill_ids": { "type": "array", "items": { "$ref": "#/$defs/id" } },
+    "composition_mode": { "enum": ["none", "single-skill", "multi-skill"] },
+    "community_fallback_attempted": { "type": "boolean" },
+    "unowned_required_owner_cells": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+    "conflicting_owner_cells": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["owner_cell_ref", "indexer_ids", "skill_ids"],
+        "properties": {
+          "owner_cell_ref": { "type": "string", "minLength": 1 },
+          "indexer_ids": { "type": "array", "minItems": 2, "items": { "$ref": "#/$defs/id" } },
+          "skill_ids": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/id" } }
+        }
+      }
+    },
+    "read_scope_overlaps": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["left_indexer_id", "right_indexer_id", "scope_refs"],
+        "properties": {
+          "left_indexer_id": { "$ref": "#/$defs/id" },
+          "right_indexer_id": { "$ref": "#/$defs/id" },
+          "scope_refs": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } }
+        }
+      }
+    },
+    "capability_gaps": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["owner_cell_ref", "requirement_ref", "coverage_domain", "capability"],
+        "properties": {
+          "owner_cell_ref": { "type": ["string", "null"] },
+          "requirement_ref": { "anyOf": [{ "$ref": "#/$defs/id" }, { "type": "null" }] },
+          "coverage_domain": { "anyOf": [{ "$ref": "#/$defs/id" }, { "type": "null" }] },
+          "capability": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "capability_gap_proof": {
+      "anyOf": [
+        { "$ref": "#/$defs/capabilityGapProof" },
+        { "type": "null" }
+      ]
+    },
+    "route": {
+      "oneOf": [
+        { "$ref": "#/$defs/selectionRoute" },
+        { "$ref": "#/$defs/fallbackRoute" },
+        { "$ref": "#/$defs/conflictRoute" },
+        { "$ref": "#/$defs/gapRoute" }
+      ]
+    },
+    "selection_proposal_input": {
+      "anyOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["protocol", "project_ref", "registry"],
+          "properties": {
+            "protocol": { "const": "context.indexer.selection-proposal-input/v1" },
+            "project_ref": { "type": "string", "minLength": 1 },
+            "registry": { "type": "object" }
+          }
+        },
+        { "type": "null" }
+      ]
+    },
+    "report_digest": { "$ref": "#/$defs/digest" }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9._/-]*$" },
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "capabilityGap": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["owner_cell_ref", "requirement_ref", "coverage_domain", "capability"],
+      "properties": {
+        "owner_cell_ref": { "type": ["string", "null"] },
+        "requirement_ref": { "anyOf": [{ "$ref": "#/$defs/id" }, { "type": "null" }] },
+        "coverage_domain": { "anyOf": [{ "$ref": "#/$defs/id" }, { "type": "null" }] },
+        "capability": { "type": "string", "minLength": 1 }
+      }
+    },
+    "capabilityGapProof": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "protocol",
+        "project_ref",
+        "route_input_digest",
+        "requirement_set_digest",
+        "registry_digest",
+        "visible_skill_set_digest",
+        "community_fallback_attempted",
+        "gaps",
+        "gap_digest"
+      ],
+      "properties": {
+        "protocol": { "const": "context.indexer.capability-gap-proof/v1" },
+        "project_ref": { "type": "string", "minLength": 1 },
+        "route_input_digest": { "$ref": "#/$defs/digest" },
+        "requirement_set_digest": { "$ref": "#/$defs/digest" },
+        "registry_digest": { "$ref": "#/$defs/digest" },
+        "visible_skill_set_digest": { "$ref": "#/$defs/digest" },
+        "community_fallback_attempted": { "const": true },
+        "gaps": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "$ref": "#/$defs/capabilityGap" }
+        },
+        "gap_digest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "selectionRoute": {
+      "type": "object", "additionalProperties": false,
+      "required": ["outcome", "graph_outcome", "next_action"],
+      "properties": {
+        "outcome": { "const": "selection-validation-required" },
+        "graph_outcome": { "const": "completed" },
+        "next_action": { "const": "validate-indexer-selection-proposal" }
+      }
+    },
+    "fallbackRoute": {
+      "type": "object", "additionalProperties": false,
+      "required": ["outcome", "graph_outcome", "next_action"],
+      "properties": {
+        "outcome": { "const": "community-fallback-required" },
+        "graph_outcome": { "const": "partial" },
+        "next_action": { "const": "configure-community-indexer-fallback" }
+      }
+    },
+    "conflictRoute": {
+      "type": "object", "additionalProperties": false,
+      "required": ["outcome", "graph_outcome", "next_action"],
+      "properties": {
+        "outcome": { "const": "indexer-provider-conflict" },
+        "graph_outcome": { "const": "waiting-user" },
+        "next_action": { "const": "configure-indexer-providers" }
+      }
+    },
+    "gapRoute": {
+      "type": "object", "additionalProperties": false,
+      "required": ["outcome", "graph_outcome", "next_action"],
+      "properties": {
+        "outcome": { "const": "indexer-customization-required" },
+        "graph_outcome": { "const": "blocked" },
+        "next_action": { "const": "propose-indexer-customization" }
+      }
+    }
+  }
+}

package/providers/context/schemas/indexer-requirement-confirmation-input.schema.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "context.indexer.requirement-confirmation-input/v1",
+  "oneOf": [
+    {
+      "type": "object",
+      "required": ["protocol", "report"],
+      "properties": {
+        "protocol": { "const": "context.indexer.requirement-confirmation-route-input/v1" },
+        "report": { "type": "object" }
+      },
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "required": ["protocol", "report", "authority", "confirmed_by", "confirmed_at"],
+      "properties": {
+        "protocol": { "const": "context.indexer.requirement-confirmation-action-input/v1" },
+        "report": { "type": "object" },
+        "authority": { "enum": ["managed", "human"] },
+        "confirmed_by": { "type": "string", "minLength": 1 },
+        "confirmed_at": { "type": "string", "format": "date-time" }
+      },
+      "additionalProperties": false
+    }
+  ]
+}

package/providers/context/schemas/indexer-requirement-confirmation-output.schema.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "context.indexer.requirement-confirmation-output/v1",
+  "type": "object",
+  "required": ["protocol", "graph_outcome"],
+  "properties": {
+    "protocol": {
+      "enum": [
+        "context.indexer.requirement-confirmation-route-result/v1",
+        "context.indexer.requirement-confirmation-action-result/v1"
+      ]
+    },
+    "report": { "type": "object" },
+    "confirmation": { "type": "object" },
+    "outcome": {
+      "enum": [
+        "requirement-confirmation-required",
+        "requirement-contraction-confirmation-required"
+      ]
+    },
+    "graph_outcome": { "enum": ["completed", "waiting-user", "blocked"] }
+  },
+  "additionalProperties": false
+}

package/providers/context/schemas/indexer-result-reconciliation-input.schema.json

@@ -0,0 +1,59 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "context.indexer.result-reconciliation-input/v1",
+  "type": "object",
+  "required": [
+    "protocol",
+    "requirement_set_digest",
+    "question_target_inventory",
+    "resolved_questions",
+    "target_facts",
+    "allowed_selector_fact_paths",
+    "registered_material_sources"
+  ],
+  "properties": {
+    "protocol": { "const": "context.indexer.result-reconciliation-input/v1" },
+    "requirement_set_digest": { "$ref": "#/$defs/digest" },
+    "question_target_inventory": { "type": "object" },
+    "resolved_questions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["requirement_ref", "question"],
+        "properties": {
+          "requirement_ref": { "type": "string", "minLength": 1 },
+          "question": { "type": "object" }
+        },
+        "additionalProperties": false
+      }
+    },
+    "target_facts": { "type": "object" },
+    "allowed_selector_fact_paths": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 },
+      "uniqueItems": true
+    },
+    "registered_material_sources": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["source_ref", "source_input_digest", "evidence_kinds"],
+        "properties": {
+          "source_ref": { "type": "string", "minLength": 1 },
+          "source_input_digest": { "$ref": "#/$defs/digest" },
+          "evidence_kinds": {
+            "type": "array",
+            "items": { "type": "string", "minLength": 1 },
+            "minItems": 1,
+            "uniqueItems": true
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+  }
+}

package/providers/context/schemas/indexer-result-reconciliation-output.schema.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "context.indexer.coverage-completion-report/v1",
+  "type": "object",
+  "required": [
+    "protocol",
+    "requirement_set_digest",
+    "registry_digest",
+    "question_target_inventory_digest",
+    "registered_material_source_set_digest",
+    "domains",
+    "capability_gaps",
+    "material_gaps",
+    "blocking_count",
+    "partial_domain_count",
+    "outcome",
+    "graph_outcome",
+    "can_report_complete",
+    "report_digest"
+  ],
+  "properties": {
+    "protocol": { "const": "context.indexer.coverage-completion-report/v1" },
+    "requirement_set_digest": { "$ref": "#/$defs/digest" },
+    "registry_digest": { "$ref": "#/$defs/digest" },
+    "question_target_inventory_digest": { "$ref": "#/$defs/digest" },
+    "registered_material_source_set_digest": { "$ref": "#/$defs/digest" },
+    "domains": { "type": "array", "items": { "type": "object" } },
+    "capability_gaps": { "type": "array", "items": { "type": "object" } },
+    "material_gaps": { "type": "array", "items": { "type": "object" } },
+    "blocking_count": { "type": "integer", "minimum": 0 },
+    "partial_domain_count": { "type": "integer", "minimum": 0 },
+    "outcome": {
+      "enum": ["complete", "index-material-required", "indexer-capability-gap"]
+    },
+    "graph_outcome": { "enum": ["completed", "partial", "blocked"] },
+    "can_report_complete": { "type": "boolean" },
+    "report_digest": { "$ref": "#/$defs/digest" }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+  }
+}

package/providers/context/schemas/indexer-selection-proposal-input.schema.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "context.indexer.selection-proposal-input/v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["protocol", "project_ref", "registry"],
+  "properties": {
+    "protocol": { "const": "context.indexer.selection-proposal-input/v1" },
+    "project_ref": { "type": "string", "minLength": 1 },
+    "registry": { "type": "object" }
+  }
+}

package/providers/context/schemas/indexer-selection-proposal-validation.schema.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "context.indexer.selection-proposal-validation/v1",
+  "type": "object",
+  "required": [
+    "protocol",
+    "proposal",
+    "static_report",
+    "outcome",
+    "next_provider_requests",
+    "resolution_requests",
+    "validation_digest"
+  ],
+  "properties": {
+    "protocol": { "const": "context.indexer.selection-proposal-validation/v1" },
+    "proposal": { "type": "object" },
+    "static_report": { "type": "object" },
+    "outcome": { "const": "provider-resolution-required" },
+    "next_provider_requests": { "type": "array", "items": { "type": "object" } },
+    "resolution_requests": { "type": "array", "items": { "type": "object" } },
+    "validation_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+  }
+}

package/providers/context/schemas/indexer-subject-reidentification-input.schema.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "context.indexer.subject-reidentification-input/v1",
+  "oneOf": [
+    {
+      "type": "object",
+      "required": ["protocol", "project_ref", "old_schema", "new_schema", "approved_subjects", "proposed_mappings"],
+      "properties": {
+        "protocol": { "const": "context.indexer.subject-key-validation-input/v1" },
+        "project_ref": { "type": "string", "minLength": 1 },
+        "old_schema": { "type": "object" },
+        "new_schema": { "type": "object" },
+        "approved_subjects": { "type": "array", "items": { "type": "object" } },
+        "proposed_mappings": { "type": "array", "items": { "type": "object" } },
+        "report": { "type": "object" },
+        "authorization": { "type": "object" }
+      },
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "required": ["protocol", "project_ref", "old_schema", "new_schema", "approved_subjects", "proposed_mappings", "report", "authorized_by", "authorized_at"],
+      "properties": {
+        "protocol": { "const": "context.indexer.subject-reidentification-confirmation-input/v1" },
+        "project_ref": { "type": "string", "minLength": 1 },
+        "old_schema": { "type": "object" },
+        "new_schema": { "type": "object" },
+        "approved_subjects": { "type": "array", "items": { "type": "object" } },
+        "proposed_mappings": { "type": "array", "items": { "type": "object" } },
+        "report": { "type": "object" },
+        "authorized_by": { "type": "string", "minLength": 1 },
+        "authorized_at": { "type": "string", "format": "date-time" }
+      },
+      "additionalProperties": false
+    }
+  ]
+}

package/providers/context/schemas/indexer-subject-reidentification-output.schema.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "context.indexer.subject-reidentification-output/v1",
+  "type": "object",
+  "required": ["protocol", "report", "graph_outcome"],
+  "properties": {
+    "protocol": {
+      "enum": [
+        "context.indexer.subject-key-validation-result/v1",
+        "context.indexer.subject-reidentification-confirmation-result/v1"
+      ]
+    },
+    "report": { "type": "object" },
+    "authorization": { "type": "object" },
+    "authorization_digest": {
+      "oneOf": [
+        { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        { "type": "null" }
+      ]
+    },
+    "outcome": {
+      "enum": [
+        "subject-key-schema-current",
+        "index-subject-reidentification-required",
+        "index-subject-reidentification-invalid"
+      ]
+    },
+    "graph_outcome": { "enum": ["completed", "blocked", "failed"] }
+  },
+  "additionalProperties": false
+}

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

@@ -0,0 +1,58 @@
+---
+name: context-configure-indexer-providers
+description: Build one path-free Context Indexer Provider selection from current requirements and visible Indexer Skills; use during the provider-selection Graph route, not for executing Providers or changing requirements.
+metadata:
+  agent-graph: path:../../provider.yaml
+  agent-graph.graph: indexer
+  agent-graph.entry: provider-selection
+---
+
+# Configure Indexer Providers
+
+Read
+`node_modules/@c4a/context/docs/guides/indexer-provider-and-customization.md`
+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.
+
+Report the exact CLI-bundled catalog 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. Preserve distinct source
+observations in `visible_skills`, keep different versions separate, and never
+use source count or discovery order as precedence. Do not scan plugin caches or
+persist this discovery list.
+
+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
+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.
+
+Produce `context.indexer.provider-route-input/v1` for the current, unchanged
+requirement set. Select portable distribution locators and exact versions and
+integrities. 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 Provider array order is not precedence.
+
+On the first pass set `community_fallback_attempted: false`. If the CLI records
+the route Action as `partial`, retry with the applicable CLI-bundled community
+profile and set it to `true`. If the CLI reports conflicting primary owner cells,
+do not choose one by name order: present the exact conflict and wait for a
+decision. If fallback still leaves an unowned required cell, preserve the exact
+CLI `capability_gap_proof` and record `blocked`; never invent a Provider or
+weaken the requirement. Only the following `propose-indexer-customization`
+Action may use that proof to draft a dependency-free minimal `extend`.
+
+Record the CLI Route Action outcome exactly from `route.graph_outcome`. Only a
+`completed` report may pass its `selection_proposal_input` to
+`validate-indexer-selection-proposal`. Provider resolution and execution remain
+separate Actions.

package/providers/context/skills/prepare-indexer-customization-project/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: prepare-indexer-customization-project
+description: Resolve the exact validated customization selection and stage its CAS-bound project proposal.
+---
+
+# Prepare Indexer customization project
+
+Read
+`node_modules/@c4a/context/docs/guides/indexer-provider-and-customization.md`
+before staging a project proposal. If validation reports an invalid local
+resource or upstream drift, preserve the exact
+`indexer-customization-invalid`/`indexer-customization-upstream-changed`
+diagnostic and return to reconciliation; do not silently drop or overwrite the
+affected override.
+
+Consume only the current `context.indexer.customization-validation-result/v1`.
+
+1. Pass `selection_proposal_input` to `context indexer validate-indexer-selection-proposal`.
+2. Resolve every emitted Provider request through `context indexer resolve-indexer-providers`; never scan a
+   plugin cache or substitute another version. Stage each resolved Bundle with
+   `context indexer stage-indexer-provider-bundle`.
+3. Build `context.indexer.customization-project-preparation-input/v1` with the exact validation digest,
+   static report, resolved/staged Bundle inputs, and current CLI operator/profile contracts. Run
+   `context indexer prepare-indexer-customization-project`.
+4. If the result is `program-authorization-required`, stop at the independent program-execution authority.
+   Do not invent the authority receipt and do not apply any source file.
+5. If the result is `project-confirmation-required`, preserve the returned proposal digest and staging
+   validation unchanged for the confirmation/apply route.
+
+Never copy Provider files into the project, widen requirement scope, add dependency intents, or bypass the
+content-addressed customization stage.