{
  "schema_version": 1,
  "id": "protect-ci-workflows",
  "track": "coding",
  "name": "Protect CI Workflows",
  "version": "0.2.7",
  "sha256": "9cdd0aba07068856569b04b202de8f6e1b5b46bff400e682e916a5a2a02bfac9",
  "sha256_v1": "3707dbb11533c8726a048fe9b9571f741d48cdd74ab2d6d340b814fc3cc1dc2f",
  "keyword": "ask",
  "word": "asks",
  "says": "refuses a matched shell command before it runs. Asks on an agent's file writes and at turn end",
  "description": "Asks a person before an agent weakens the checks that review its work. Shell guard refuses writes to .github/workflows/, .github/actions/, .github/dependabot.y*ml (redirect, rm/mv/tee/sed -i, cp into, git checkout/restore, cmdlets); reads and `chock sync` pass. Edit/Write: tool_use gate asks a person before a write to CI, hook or bot config (GitLab, Jenkins, CircleCI, CODEOWNERS, husky, more). Not judged: deletions, empty writes, shell writes to non-GitHub CI paths; plugin installs ship no gate.",
  "misses": null,
  "where": [
    "command",
    "write",
    "turn-end"
  ],
  "groups": [
    "ci-pipeline"
  ],
  "eval_cases": 63,
  "eval_executed": 63,
  "latest": {
    "version": "0.2.7",
    "date": "2026-10-24",
    "change": "Behaviour change, added coverage for equivalent spellings of the protected paths (SR-2d1; eval cases tc-056 to tc-063; tests in test_protect_ci_workflows_shell.py). The shell guard matches the folded path: `//` and `/./` collapsed, `..` resolved, trailing dots and spaces and stream suffixes dropped, case ignored. Relative paths are read from the directory a `cd`, `pushd` or `popd` before them left, and removing or moving the `.github` folder itself is refused. Shared shell reader updated (SR-2d1; the copy in implementations/chock_shellparse is regenerated, this policy's own script is unchanged). Added coverage: an arithmetic shift in `$(( ))`, `(( ))` or `$[ ]` is no longer read as the start of a here-document, so the lines after it are judged as before; the string given to `env -S` or `--split-string` is read as the command env runs; `env -i` is recorded on the command it runs. Tests: test_shellparse_sr2d1.py."
  },
  "agent_labels": {
    "claude-code": {
      "keyword": "ask",
      "says": "refuses a matched shell command before it runs. Asks on an agent's file writes and at turn end"
    },
    "cursor": {
      "keyword": "block",
      "says": "refuses a matched shell command before it runs. Refuses an agent's file writes and refuses at turn end, because this client cannot prompt at either point"
    },
    "codex": {
      "keyword": "block",
      "says": "refuses a matched shell command before it runs. Refuses an agent's file writes and refuses at turn end, 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": "refuses a matched shell command before it runs. Refuses at turn end only, because this client cannot prompt there. It does not check a file write when it happens. If the hook errors, the action goes through (not witnessed; the vendor's row is only partly live-run)"
    },
    "devin": {
      "keyword": "block",
      "says": "refuses a matched shell command before it runs. Refuses at turn end only, because this client cannot prompt there. It does not check a file write when it happens. 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/protect-ci-workflows",
  "enforces": "best-effort (pre-tool-use, once hooks are installed; fails open if the hook crashes)",
  "examples": [
    {
      "word": "Refused",
      "prompt": "A request redirects new content over a workflow file.",
      "command": "echo \"on: push\" > .github/workflows/ci.yml"
    },
    {
      "word": "Allowed",
      "prompt": "A request reads a workflow file to inspect it.",
      "command": "cat .github/workflows/ci.yml"
    }
  ]
}