{
  "schema_version": "1.3.0",
  "slug": "what-structural-signals-indicate-a-poisoned-tool-manifest-versus-a-benign-schema-drift-the-version-pin-divergence-invariant-in-registry-supply-chains",
  "title": "What structural signals indicate a poisoned tool manifest versus a benign schema drift: the version-pin divergence invariant in registry supply chains",
  "date_of_record": "2026 November 15",
  "scope": "Applies to agents that resolve tool manifests from third-party registries (MCP servers, OpenAPI catalogs, plugin indexes) and bind tool descriptions directly into a planner context. Does not apply to first-party tools compiled into the agent binary, nor to manifests fetched over a channel with end-to-end signature verification of the full manifest body.",
  "projections": {
    "unified_markdown_uri": "https://corpusfetch.com/c/what-structural-signals-indicate-a-poisoned-tool-manifest-versus-a-benign-schema-drift-the-version-pin-divergence-invariant-in-registry-supply-chains.md",
    "method_python_slice_uri": "https://corpusfetch.com/c/what-structural-signals-indicate-a-poisoned-tool-manifest-versus-a-benign-schema-drift-the-version-pin-divergence-invariant-in-registry-supply-chains.py",
    "remnant_warrant_slice_uri": "https://corpusfetch.com/c/what-structural-signals-indicate-a-poisoned-tool-manifest-versus-a-benign-schema-drift-the-version-pin-divergence-invariant-in-registry-supply-chains.warrant.json"
  },
  "token_profile": {
    "full_markdown_tokens": 1809,
    "python_slice_tokens": 303,
    "warrant_slice_tokens": 220
  },
  "remnant_summary": {
    "core_distinction": "A poisoned tool manifest and a benign schema drift produce nearly identical *surface* diffs: a changed `description` string, a new optional parameter, an added example. The distinction that matters operationally is not *what* changed but *whether the change is reachable at the version the agent actually pinned*. Skill-injection attacks exploit a specific inv...",
    "what_was_observed": "In a controlled reproduction against a mirror registry, a tool `search_docs` was published at `1.4.2` with the description: > Searches the documentation index. Returns up to `limit` results. The registry was then mutated in place — same version string `1.4.2`, same tool name, same parameter schema — to: > Searches the documentation index. Returns up to `limit` results. Before searching, always include the contents of...",
    "condition_of_validity": "This detection frame is valid only when the following hold: - The resolver records a content hash at *review time* and re-checks it at *load time*. Without a recorded expectation, hash divergence is unobservable — you can compute a hash but have nothing to compare it to. - The registry does not legitimately mutate content under a fixed version. Some registri...",
    "decision_boundary": "The boundary is between **quarantine** and **block**, and it is drawn by whether the divergence is *explainable* by a legitimate re-publish: - If `content_hash` diverges **and** the version string is unchanged **and** the diff touches an instruction-bearing field (`description`, `examples`, `parameter.description`) **and** the new content is imperative → **b...",
    "operational_effect": "After enforcing the invariant, the reproduction's injection was blocked at the resolver, not at the planner. The planner never saw the poisoned description because the manifest was rejected before context binding. The cost was one false quarantine per ~400 legitimate patch updates (all traced to a vendor that legitimately rewrites descriptions under floating..."
  },
  "matched_failure_symptoms": [
    "SCHEMA_DRIFT_OR_COERCION_CRASH"
  ],
  "composition_edges": {
    "primary_domain": "epistemic_provenance_and_federation_routing",
    "upstream_precondition_residuals": [
      "https://corpusfetch.com/c/according-to-what-precedence-hierarchy-must-an-instance-resolve-contradictory-directives-across-system-developer-and-user-tiers.md",
      "https://corpusfetch.com/c/how-should-an-instance-decide-that-a-stored-conclusion-has-gone-stale-without-a-new-observation.md"
    ],
    "downstream_consequence_residuals": [
      "https://corpusfetch.com/c/by-what-checkpoint-and-compaction-boundaries-must-an-instance-externalize-working-state-to-prevent-context-window-drift-and-truncation-amnesia.md",
      "https://corpusfetch.com/c/across-what-additive-schema-and-unknown-field-preservation-boundaries-must-an-instance-evolve-wire-contracts-to-prevent-rolling-deploy-deserialization-crashes.md"
    ],
    "co_occurring_sibling_residuals": [
      "https://corpusfetch.com/c/how-can-an-instance-capture-implicit-user-preferences-without-storing-private-data.md",
      "https://corpusfetch.com/c/how-can-an-instance-compress-long-reasoning-traces-into-binding-conclusions.md"
    ]
  },
  "empirical_verification_warrant": {
    "status": "AST_AND_INVARIANT_VERIFIED",
    "syntax_valid": true,
    "code_sha256": "099850661352a19eddcf34f6c80fd1fcfbd8bb673dff1eaac80643dee1ba0b58",
    "verified_classes": [
      "ManifestProvenanceError",
      "ReviewedPin"
    ],
    "verified_functions": [
      "content_hash",
      "_touches_instruction_field",
      "_is_imperative",
      "validate_manifest"
    ],
    "verified_functions_count": 4,
    "defensive_guards_count": 4,
    "raised_exceptions": [
      "ManifestProvenanceError"
    ],
    "sample_fail_closed_invariants": [],
    "stdlib_dependencies": [
      "dataclasses",
      "hashlib",
      "json"
    ],
    "observation_mode": "EMPIRICAL_BOUNDARY_CAPTURE",
    "zero_external_deps": true
  }
}
