{
  "schema_version": 1,
  "id": "verify-dependency-exists",
  "track": "coding",
  "name": "Dependency Allowlist",
  "version": "0.2.2",
  "sha256": "07540ee575f9a40a61c4a52fc6291d4de70c549766916d057ca01cdd420906ae",
  "sha256_v1": "224bcb5d00647ea7b0b50d57a4d0b915b35cd7f2de8e50c9fb035ecadd34859f",
  "keyword": "block",
  "word": "blocks",
  "says": "blocks on an agent's file writes and at turn end",
  "description": "Allowlist gate for new dependencies; no registry lookup. Reads Python, Node, Rust, Ruby, PHP, JVM, .NET, Go, Elixir, Dart and Swift manifests (read, never run); blocks an added name missing from .chock/dependency-allowlist.txt, asks on a lockfile-only one. Not read: computed lists, sources, versions, some forms (see docs). No allowlist file (plugin-only installs): a manifest change warns, never blocks. Repo form is opt-in: seed, observe, `chock enable`. Runs: commit, agent write, turn's end.",
  "misses": null,
  "where": [
    "write",
    "turn-end"
  ],
  "groups": [],
  "eval_cases": 61,
  "eval_executed": 61,
  "latest": {
    "version": "0.2.2",
    "date": "2026-10-25",
    "change": "Hardening (SR-2d2d): at an agent's event with no usable HEAD (a repository with no commit yet, or no git) the allowlist is treated as not seeded (warn-only) and the file on disk is never read, so an agent cannot approve its own dependencies with a freshly written allowlist; a write that adds an allowlist entry is still refused against the empty base. A person's commit, push and CI still read the file on disk. Replaces the 0.2.1 rule that read the disk when there was no commit. Tests: test_verify_dependency_exists_sr2d2.py."
  },
  "agent_labels": {
    "claude-code": {
      "keyword": "block",
      "says": "blocks on an agent's file writes and at turn end"
    },
    "cursor": {
      "keyword": "block",
      "says": "blocks on an agent's file writes and at turn end. Where its description says it asks, it refuses at both points, because this client cannot prompt at either point"
    },
    "codex": {
      "keyword": "block",
      "says": "blocks on an agent's file writes and at turn end. Where its description says it asks, it refuses at both points, because this client cannot prompt at either point. If the hook errors, the action goes through (not witnessed; the vendor's row is only partly live-run)"
    },
    "copilot": {
      "keyword": "block",
      "says": "blocks at turn end only. It does not check a file write when it happens. Where its description says it asks, it refuses at turn end, because this client cannot prompt there. If the hook errors, the action goes through (not witnessed; the vendor's row is only partly live-run)"
    },
    "devin": {
      "keyword": "block",
      "says": "blocks at turn end only. It does not check a file write when it happens. Where its description says it asks, it refuses at turn end, because this client cannot prompt there. If the hook errors, the action goes through (vendor docs only, not witnessed)"
    },
    "grok": {
      "keyword": "ungraded",
      "says": "Not graded yet for Grok"
    },
    "goose": {
      "keyword": "ungraded",
      "says": "Not graded yet for goose"
    },
    "antigravity": {
      "keyword": "ungraded",
      "says": "Not graded yet for Antigravity"
    },
    "openhands": {
      "keyword": "ungraded",
      "says": "Not graded yet for OpenHands"
    },
    "kimi-code": {
      "keyword": "ungraded",
      "says": "Not graded yet for Kimi Code"
    },
    "factory-droid": {
      "keyword": "ungraded",
      "says": "Not graded yet for Factory Droid"
    }
  },
  "source_url": "https://github.com/open-coder-ai/chock-catalog/tree/1e60d211c1bb767152c6ab0167932da06ab3a10f/base/verify-dependency-exists",
  "enforces": "enforced-at-commit",
  "examples": [
    {
      "word": "Refused",
      "prompt": "A package that is not on the allowlist, which may not exist, is added to requirements.txt or package.json.",
      "command": null
    },
    {
      "word": "Allowed",
      "prompt": "A package already listed in .chock/dependency-allowlist.txt is added.",
      "command": null
    }
  ]
}