@agenttrail/guardrails 0.2.2 → 0.2.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +132 -116
- package/dist/{chunk-GNN4TGRY.js → chunk-SLJLCAZK.js} +306 -33
- package/dist/chunk-SLJLCAZK.js.map +1 -0
- package/dist/chunk-T6MJIV52.js +72 -0
- package/dist/chunk-T6MJIV52.js.map +1 -0
- package/dist/{chunk-FTTMZCDH.js → chunk-U7KZ447W.js} +65 -4
- package/dist/chunk-U7KZ447W.js.map +1 -0
- package/dist/guardrails.cjs +374 -32
- package/dist/guardrails.cjs.map +1 -1
- package/dist/guardrails.d.cts +60 -65
- package/dist/guardrails.d.ts +60 -65
- package/dist/guardrails.js +17 -1
- package/dist/index.cjs +433 -35
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.js +20 -2
- package/dist/schema-B2pYoi9Z.d.cts +951 -0
- package/dist/schema-B2pYoi9Z.d.ts +951 -0
- package/dist/schema.cjs +91 -3
- package/dist/schema.cjs.map +1 -1
- package/dist/schema.d.cts +2 -892
- package/dist/schema.d.ts +2 -892
- package/dist/schema.js +4 -1
- package/package.json +2 -2
- package/dist/chunk-FTTMZCDH.js.map +0 -1
- package/dist/chunk-GNN4TGRY.js.map +0 -1
|
@@ -80,6 +80,7 @@ var acAgentAutonomyFlag = {
|
|
|
80
80
|
category: "agent-context",
|
|
81
81
|
severity: "high",
|
|
82
82
|
defaultAction: "require_approval",
|
|
83
|
+
owasp: ["ASI03", "ASI10", "LLM03"],
|
|
83
84
|
title: "Switching off an agent's approvals or sandbox",
|
|
84
85
|
description: "Holds the flags that make a coding agent act without asking: Claude Code's `--dangerously-skip-permissions`, `--allow-dangerously-skip-permissions` and `--permission-mode bypassPermissions`; Codex's `--dangerously-bypass-approvals-and-sandbox`, `--yolo`, `--full-auto`, `-a never` or `--ask-for-approval never`, `--sandbox danger-full-access`, and the same two settings passed as `approval_policy` or `sandbox_mode` config values; Gemini's `--yolo`, `-y` and `--approval-mode yolo`; `cursor-agent --force`, `-f` or `--yolo`; and Aider's `--yes-always`, its accepted short form `--yes`, and `AIDER_YES_ALWAYS`. Deliberately NOT matched: the narrower modes (`--permission-mode plan` or `acceptEdits`, `--sandbox workspace-write`, `-a on-request`, `--approval-mode auto_edit`), and `--auto-approve` or `-y` on any other command \u2014 `terraform apply --auto-approve` and `apt-get install -y` are not agents. Misses Cursor's CLI under its primary name `agent`, which is too generic to match on, and a setting written to an agent's config file with a file tool, which `fs.agent-self-config` holds for Claude Code and Codex. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone, as long as every shell metacharacter stays inside the quotes.",
|
|
85
86
|
match: {
|
|
@@ -155,6 +156,7 @@ var acInstructionFileEdit = {
|
|
|
155
156
|
category: "agent-context",
|
|
156
157
|
severity: "high",
|
|
157
158
|
defaultAction: "require_approval",
|
|
159
|
+
owasp: ["ASI06", "ASI10", "LLM03"],
|
|
158
160
|
title: "The agent editing its standing instructions",
|
|
159
161
|
description: "Holds a file tool opening the instructions a coding agent loads at the start of every session: `CLAUDE.md`, `CLAUDE.local.md` and `.claude/rules/`; `AGENTS.md` and `AGENTS.override.md`, which Codex, Cursor, Windsurf, Copilot and Cline all read; `GEMINI.md`; `.cursorrules`; Windsurf's `.windsurfrules`, `.windsurf/rules/` and `.devin/rules/`; Cline's `.clinerules` file or directory and its global `Cline/Rules/` folder; Copilot's `.github/copilot-instructions.md` and `.github/instructions/**/*.instructions.md`; and `.aider.conf.yml`, which sets the files Aider reads on every launch. A line written into one of these is followed in every later session. Matched in any directory and in any letter case. Reading is excluded \u2014 the `Read` and `Grep` tools never match \u2014 so an agent opening its instructions to read them is not held; every other file tool is, including one this corpus does not know. File tools carry a path and no content, so it still cannot see what was written. Does not cover `.cursor/rules/`, which `fs.agent-self-config` holds. Misses a context file renamed through Gemini's `context.fileName` or Codex's `project_doc_fallback_filenames`, Aider's `CONVENTIONS.md`, which Aider loads only when asked and which is too common a name to match, and any of these files written by a shell command instead of a file tool.",
|
|
160
162
|
match: {
|
|
@@ -226,6 +228,7 @@ var acMcpServerAdd = {
|
|
|
226
228
|
category: "agent-context",
|
|
227
229
|
severity: "high",
|
|
228
230
|
defaultAction: "require_approval",
|
|
231
|
+
owasp: ["ASI04", "ASI10", "LLM03"],
|
|
229
232
|
title: "Adding an MCP server to an agent",
|
|
230
233
|
description: "Holds the commands that register an MCP server with a coding agent \u2014 `claude mcp add`, `claude mcp add-json`, `claude mcp add-from-claude-desktop`, `codex mcp add` and `gemini mcp add` \u2014 and `claude --mcp-config`, which attaches servers to a single session. Each gives an agent a new set of tools, often a program fetched and started on the spot, with nobody reviewing the change. Deliberately NOT matched: listing or removing servers (`claude mcp list`, `claude mcp remove`), and the MCP Inspector (`npx @modelcontextprotocol/inspector`), which is a debugging tool rather than a registration. Cursor has no command for this, so its `.cursor/mcp.json`, in a project or the home directory, is matched as a file instead \u2014 written, not read: the `Read` and `Grep` tools never match it, and every other file tool does, including one this corpus does not know; a project's `.mcp.json` is held by `fs.agent-self-config`. Misses servers written into `~/.claude.json` or Gemini's `settings.json` with a file tool, and a global flag whose value is quoted when it sits before `mcp`. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone, as long as every shell metacharacter stays inside the quotes.",
|
|
231
234
|
match: {
|
|
@@ -287,6 +290,7 @@ var acMemoryStoreEdit = {
|
|
|
287
290
|
category: "agent-context",
|
|
288
291
|
severity: "high",
|
|
289
292
|
defaultAction: "require_approval",
|
|
293
|
+
owasp: ["ASI06", "LLM03"],
|
|
290
294
|
title: "The agent editing its own memory",
|
|
291
295
|
description: "Holds a file tool opening the memory a coding agent carries between sessions: Claude Code's auto memory under `.claude/projects/<project>/memory/`, and its sub-agent memory in `.claude/agent-memory/` and `.claude/agent-memory-local/`; Codex's `.codex/memories/`; Gemini's private `.gemini/tmp/<project>/memory/`; Windsurf's `.codeium/windsurf/memories/`, including `global_rules.md`; and `.cursor/memory/`. A false fact saved here is recalled as true in every later session. A `MEMORY.md` outside those directories deliberately does NOT match, and neither does a project's own `docs/memory/` folder: the name alone is not an agent's memory. Reading is excluded \u2014 the `Read` and `Grep` tools never match \u2014 so an agent recalling a memory by reading its file is not asked; every other file tool is, including one this corpus does not know. File tools carry a path and no content, so it still cannot see what was written. Misses a memory directory moved with Claude Code's `autoMemoryDirectory` setting, and Cursor memories kept anywhere other than `.cursor/memory/`, since Cursor does not document where it stores them. Gemini memories saved into `GEMINI.md` are held by `ac.instruction-file-edit` instead.",
|
|
292
296
|
match: {
|
|
@@ -340,8 +344,9 @@ var acRecursiveAgentInvoke = {
|
|
|
340
344
|
category: "agent-context",
|
|
341
345
|
severity: "high",
|
|
342
346
|
defaultAction: "require_approval",
|
|
347
|
+
owasp: ["LLM03"],
|
|
343
348
|
title: "An agent starting another agent non-interactively",
|
|
344
|
-
description: "Holds a coding agent started from a shell to run a task on its own: `claude -p` or `--print` (including through `npx @anthropic-ai/claude-code`), `codex exec` or `codex e`, `gemini -p` or `--prompt`, `cursor-agent -p` or `--print`, and `aider` run non-interactively with `--message`, `--msg`, `-m`, or `-f` \u2014 the short form of `--message-file`, which disables chat mode. `--message-file` needs no arm of its own: the `--message` arm is a prefix of it and catches it. Every spawned agent reads, writes and runs commands of its own and can start more, which is how spend and reach multiply without anyone watching. This catches the shape, not the cost:
|
|
349
|
+
description: "Holds a coding agent started from a shell to run a task on its own: `claude -p` or `--print` (including through `npx @anthropic-ai/claude-code`), `codex exec` or `codex e`, `gemini -p` or `--prompt`, `cursor-agent -p` or `--print`, and `aider` run non-interactively with `--message`, `--msg`, `-m`, or `-f` \u2014 the short form of `--message-file`, which disables chat mode. `--message-file` needs no arm of its own: the `--message` arm is a prefix of it and catches it. Every spawned agent reads, writes and runs commands of its own and can start more, which is how spend and reach multiply without anyone watching. This catches the shape, not the cost: nothing here can count calls or tokens before a tool runs. Deliberately NOT matched: `codex -p`, which selects a profile rather than a prompt, `--version` and `--help`, and listing commands such as `claude mcp list`. Misses Cursor's CLI when it is invoked by its primary name `agent`, which is too generic to match on, Gemini run headless by piping into it without `-p`, and a flag placed after a quoted argument. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone, as long as every shell metacharacter stays inside the quotes.",
|
|
345
350
|
match: {
|
|
346
351
|
any_of: [
|
|
347
352
|
{
|
|
@@ -396,6 +401,7 @@ var acSkillInstall = {
|
|
|
396
401
|
category: "agent-context",
|
|
397
402
|
severity: "high",
|
|
398
403
|
defaultAction: "require_approval",
|
|
404
|
+
owasp: ["ASI10", "LLM03"],
|
|
399
405
|
title: "The agent installing a skill, command or sub-agent",
|
|
400
406
|
description: "Holds a file tool opening a skill, slash command, sub-agent or output style that a coding agent loads by name: Claude Code's `.claude/skills/`, `.claude/commands/`, `.claude/agents/` and `.claude/output-styles/`; the shared `.agents/skills/`; Codex's `.codex/skills/`, `.codex/prompts/` and `.codex/agents/`; Gemini's `.gemini/commands/`, `.gemini/skills/` and `.gemini/agents/`; Cursor's `.cursor/skills/`, `.cursor/agents/` and `.cursor/commands/`; Windsurf's `.windsurf/workflows/` and `.windsurf/skills/` and their global copies under `.codeium/windsurf/`; Cline's `.cline/skills/`; and a `SKILL.md` anywhere, which is how a plugin ships a skill. Each becomes a reusable instruction the agent may follow later, often with a script beside it that the agent runs. Matched at project or home level and in any letter case. Reading is excluded \u2014 the `Read` and `Grep` tools never match \u2014 so an agent opening an installed skill to read it is not held; every other file tool is, including one this corpus does not know. File tools carry a path and no content, so it still cannot see what was written. Deliberately NOT matched: an ordinary `skills/`, `commands/` or `agents/` folder in a project's source, and `.clinerules/skills/`, which `ac.instruction-file-edit` holds. Misses a skill copied into one of these folders by a shell command such as `cp` or `git clone`, and the managed system-wide workflow folders.",
|
|
401
407
|
match: {
|
|
@@ -466,8 +472,9 @@ var blockDestructiveSql = {
|
|
|
466
472
|
category: "destructive-data",
|
|
467
473
|
severity: "critical",
|
|
468
474
|
defaultAction: "block",
|
|
469
|
-
|
|
470
|
-
|
|
475
|
+
owasp: ["ASI02", "LLM03", "LLM10"],
|
|
476
|
+
title: "Block destructive SQL",
|
|
477
|
+
description: 'Blocks shell commands that execute destructive SQL DDL \u2014 DROP TABLE, TRUNCATE or DROP DATABASE. The two-word phrases are matched in any case with any spacing. Bare TRUNCATE is matched only in UPPER case, so that arm is CASE-SENSITIVE by design: lower-case `truncate` is also the coreutils binary and a common identifier, so matching it would block routine work \u2014 the cost is that a lower-case `truncate users;` without the `table` keyword is NOT caught. A command naming a read-only search or history tool (grep, rg, ag, ack, git commit/log/grep/blame/show) is left alone, because searching for the words is not executing them; a compound command that both searches and executes is therefore missed. Shell commands only: SQL issued from inside application code is invisible here. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
471
478
|
match: {
|
|
472
479
|
any_of: [
|
|
473
480
|
{
|
|
@@ -515,6 +522,7 @@ var ddAcceptDataLoss = {
|
|
|
515
522
|
category: "destructive-data",
|
|
516
523
|
severity: "critical",
|
|
517
524
|
defaultAction: "block",
|
|
525
|
+
owasp: ["ASI02", "LLM03"],
|
|
518
526
|
title: "A flag that explicitly accepts data loss",
|
|
519
527
|
description: 'Matches the flags whose own names admit the consequence \u2014 `--accept-data-loss` (Prisma), `--force-reset`, and `prisma db push --force`. A tool that makes you type those words has already decided a human should be in the loop. Does NOT match `prisma db push` without a flag, which is the ordinary spelling, and it cannot tell a scratch database from a real one because no connection string reaches the guard. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
520
528
|
match: {
|
|
@@ -553,8 +561,9 @@ var ddDatabaseDrop = {
|
|
|
553
561
|
category: "destructive-data",
|
|
554
562
|
severity: "critical",
|
|
555
563
|
defaultAction: "block",
|
|
564
|
+
owasp: ["ASI02", "LLM03"],
|
|
556
565
|
title: "Dropping a database from the command line",
|
|
557
|
-
description: 'Deletes a whole database through a shell tool rather than through SQL \u2014 `dropdb`, MongoDB\'s `dropDatabase()`, and the AWS RDS delete calls. It is the companion to block-destructive-sql, which sees the SQL statement but not `dropdb myapp`, because that command contains no DROP DATABASE phrase. Known over-match: `dropdb --help` is matched too, since the
|
|
566
|
+
description: 'Deletes a whole database through a shell tool rather than through SQL \u2014 `dropdb`, MongoDB\'s `dropDatabase()`, and the AWS RDS delete calls. It is the companion to block-destructive-sql, which sees the SQL statement but not `dropdb myapp`, because that command contains no DROP DATABASE phrase. Known over-match: `dropdb --help` is matched too, since the match reads command text and cannot tell a help flag from a target. It does NOT cover a drop issued by application code or by a migration tool (see dd.migration-reset). A global flag between `aws` and `rds` is tolerated (`aws --profile <p> rds delete-db-instance \u2026`, `--region <r>`); `dropdb` and `dropDatabase()` are single commands with no subcommand gap to exploit, and an absolute tool path still matches. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
558
567
|
match: {
|
|
559
568
|
any_of: [
|
|
560
569
|
{
|
|
@@ -595,6 +604,7 @@ var ddDockerPruneVolumes = {
|
|
|
595
604
|
category: "destructive-data",
|
|
596
605
|
severity: "high",
|
|
597
606
|
defaultAction: "require_approval",
|
|
607
|
+
owasp: ["ASI02", "LLM03"],
|
|
598
608
|
title: "Docker prune with volumes deletes unused data",
|
|
599
609
|
description: 'Prunes Docker volumes, deleting the data of every project whose containers are not currently running \u2014 on a developer laptop that is usually several other repositories\' databases. Routine housekeeping is deliberately NOT matched: `docker system prune -f` without `--volumes`, `docker image prune` and `docker builder prune` all pass. It cannot tell a volume you meant to discard from one you forgot was there. Global flags between `docker` and its subcommand are tolerated (`docker --context <name> system prune --volumes`, `-H <host>`), and an absolute tool path still matches; a flag that itself runs a program is not read. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
600
610
|
match: {
|
|
@@ -633,6 +643,7 @@ var ddDockerVolumeDestroy = {
|
|
|
633
643
|
category: "destructive-data",
|
|
634
644
|
severity: "high",
|
|
635
645
|
defaultAction: "require_approval",
|
|
646
|
+
owasp: ["ASI02", "LLM03"],
|
|
636
647
|
title: "Docker volume deletion destroys container data",
|
|
637
648
|
description: 'Deletes Docker volumes, which is where a database running in a container keeps its data \u2014 `docker compose down -v` is one character away from `docker compose down` and the character is the difference between stopping the stack and losing its contents. Does NOT match `docker compose down` without the flag, `docker ps`, or `docker volume ls`, and it cannot tell a throwaway test volume from the one holding your local development data. Global flags between `docker` and its subcommand are tolerated (`docker --context <name> compose down -v`, `-H <host>`), and an absolute tool path still matches; a flag that itself runs a program is not read. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
638
649
|
match: {
|
|
@@ -673,6 +684,7 @@ var ddMigrationReset = {
|
|
|
673
684
|
category: "destructive-data",
|
|
674
685
|
severity: "high",
|
|
675
686
|
defaultAction: "require_approval",
|
|
687
|
+
owasp: ["ASI02", "LLM03"],
|
|
676
688
|
title: "Migration reset drops and rebuilds the schema",
|
|
677
689
|
description: "Drops the schema and replays migrations from scratch \u2014 Prisma's `migrate reset`, Alembic's `downgrade base`, `rails db:reset`, Django's `flush`, Sequelize's `migrate:undo:all` and Drizzle's `drop`. Held for approval rather than blocked because it is the correct thing to do against a scratch database many times a day. The guard cannot see WHICH database is configured (no environment, no connection string reaches it), so it cannot distinguish a local reset from a production one. Does NOT match the forward commands (`migrate dev`, `migrate deploy`, `upgrade head`, `migrate:latest`). A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m \"x\" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.",
|
|
678
690
|
match: {
|
|
@@ -717,6 +729,7 @@ var ddRmRfAbsolute = {
|
|
|
717
729
|
category: "destructive-data",
|
|
718
730
|
severity: "critical",
|
|
719
731
|
defaultAction: "block",
|
|
732
|
+
owasp: ["ASI02", "LLM03"],
|
|
720
733
|
title: "rm -rf against an absolute path",
|
|
721
734
|
description: 'Recursive-force delete rooted at `/` rather than at a relative path. Deliberately does NOT fire on `rm -rf ./node_modules` or `rm -rf build`, which are safe and happen many times a day. Both the r and the f flag are required, so `rm -f /tmp/app.pid` is not blocked either. Known misses: the long forms (`rm --recursive --force /`), a quoted target (`rm -rf "/"`), and a variable target (`rm -rf $DIR`) whose value is only known at run time \u2014 for those, see require-approval-rm-rf, which holds them for approval instead. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
722
735
|
match: {
|
|
@@ -757,6 +770,7 @@ var ddShadowCopyDelete = {
|
|
|
757
770
|
category: "destructive-data",
|
|
758
771
|
severity: "critical",
|
|
759
772
|
defaultAction: "block",
|
|
773
|
+
owasp: ["ASI02", "LLM03"],
|
|
760
774
|
title: "Deleting Windows shadow copies or recovery data",
|
|
761
775
|
description: 'Deletes Windows shadow copies, the backup catalog, or the recovery boot entry \u2014 the standard opening move of ransomware, because it removes the only local route back from an encrypted disk. There is no legitimate reason for a coding agent to run any of it. Does NOT match the read-only siblings (`vssadmin list shadows`, `wbadmin get status`, `bcdedit /enum`), which are reasonable while diagnosing a backup. Windows-only by nature; the equivalent on macOS (`tmutil delete`) is not covered. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
762
776
|
match: {
|
|
@@ -809,8 +823,9 @@ var exFileUpload = {
|
|
|
809
823
|
category: "exfiltration",
|
|
810
824
|
severity: "high",
|
|
811
825
|
defaultAction: "require_approval",
|
|
826
|
+
owasp: ["ASI02", "ASI03", "LLM02"],
|
|
812
827
|
title: "Uploading a local file to a remote host",
|
|
813
|
-
description: 'Holds a command that sends a local file out: `curl -T` / `--upload-file`, `curl -F name=@file`, `curl --data-binary @file`, `curl --data @file` / `-d @file`, `wget --post-file`, and an `scp` or `rsync` whose LAST argument is a remote `host:path` (an upload). It matches only the `@`-file reference forms, so a plain `curl --data "text"` or `--data-raw`, and a `curl -F name=value` with no `@`, pass \u2014 the false positive that the `mentionInPost` helper exists to prevent. Deliberately NOT matched: `scp host:path ./local` and `rsync host:src ./dst` (downloads, remote is not last), and a local-to-local `rsync ./a/ ./b/`. MISSES `-d @-` reading from stdin, a body built by command substitution (`--data "$(cat f)"`, which runs the substitution), a colon inside a local path mistaken for a host, and an upload through an SDK or MCP tool rather than a shell command. A quoted MENTION is not a use: a search, a `git commit -m` message or an `echo` that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt. `curl --data` is NOT one of those carriers here, because
|
|
828
|
+
description: 'Holds a command that sends a local file out: `curl -T` / `--upload-file`, `curl -F name=@file`, `curl --data-binary @file`, `curl --data @file` / `-d @file`, `wget --post-file`, and an `scp` or `rsync` whose LAST argument is a remote `host:path` (an upload). It matches only the `@`-file reference forms, so a plain `curl --data "text"` or `--data-raw`, and a `curl -F name=value` with no `@`, pass \u2014 the false positive that the `mentionInPost` helper exists to prevent. Deliberately NOT matched: `scp host:path ./local` and `rsync host:src ./dst` (downloads, remote is not last), and a local-to-local `rsync ./a/ ./b/`. MISSES `-d @-` reading from stdin, a body built by command substitution (`--data "$(cat f)"`, which runs the substitution), a colon inside a local path mistaken for a host, and an upload through an SDK or MCP tool rather than a shell command. A quoted MENTION is not a use: a search, a `git commit -m` message or an `echo` that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt. `curl --data` is NOT one of those carriers here, because the trigger here names `curl`: a POST body quoting an upload still asks.',
|
|
814
829
|
match: {
|
|
815
830
|
any_of: [
|
|
816
831
|
{
|
|
@@ -863,8 +878,9 @@ var exPasteService = {
|
|
|
863
878
|
category: "exfiltration",
|
|
864
879
|
severity: "high",
|
|
865
880
|
defaultAction: "require_approval",
|
|
881
|
+
owasp: ["ASI02", "ASI03", "LLM02"],
|
|
866
882
|
title: "Posting to a public paste or file-drop service",
|
|
867
|
-
description: 'Holds a command that sends content to a public paste or file-drop service: `gh gist create`, and the services `transfer.sh`, `0x0.st`, `termbin.com`, `ix.io`, `sprunge.us`, `paste.rs`, `bashupload.com`, `file.io`, `catbox.moe`, `oshi.at`, `dpaste.com` and `pastebin.com/api`. Each returns a public URL with no account, which is the fastest way to move a secret or a dump off the machine. Matched by destination \u2014 the service name, or the `gh gist create` subcommand \u2014 because the exposure is where the content lands, not how it gets there. The two whose names collide with ordinary paths \u2014 `paste.rs` (also a Rust source filename) and `file.io` \u2014 match only in a host position: after a scheme (`//`), an `@`, or a space, and ending at a `/`, a quote, or the command, so `git add src/paste.rs` and `\u2026/file.io.json` are left alone. Deliberately NOT matched: reading a paste (`gh gist list` / `view`, `curl pastebin.com/raw/\u2026`). Some of these hosts were offline at authoring time (`transfer.sh`, `ix.io`, `sprunge.us`, `bashupload.com`, `oshi.at`); their names are kept because domains revive and can be run privately. MISSES a paste service this list does not name, a private instance on another domain, an upload made through an SDK rather than a shell command, and a `paste.rs` / `file.io` upload written with no scheme (a bare host). A quoted MENTION is not a use: a search, a `git commit -m` message or an `echo` that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt. `curl --data` is NOT one of those carriers here, because
|
|
883
|
+
description: 'Holds a command that sends content to a public paste or file-drop service: `gh gist create`, and the services `transfer.sh`, `0x0.st`, `termbin.com`, `ix.io`, `sprunge.us`, `paste.rs`, `bashupload.com`, `file.io`, `catbox.moe`, `oshi.at`, `dpaste.com` and `pastebin.com/api`. Each returns a public URL with no account, which is the fastest way to move a secret or a dump off the machine. Matched by destination \u2014 the service name, or the `gh gist create` subcommand \u2014 because the exposure is where the content lands, not how it gets there. The two whose names collide with ordinary paths \u2014 `paste.rs` (also a Rust source filename) and `file.io` \u2014 match only in a host position: after a scheme (`//`), an `@`, or a space, and ending at a `/`, a quote, or the command, so `git add src/paste.rs` and `\u2026/file.io.json` are left alone. Deliberately NOT matched: reading a paste (`gh gist list` / `view`, `curl pastebin.com/raw/\u2026`). Some of these hosts were offline at authoring time (`transfer.sh`, `ix.io`, `sprunge.us`, `bashupload.com`, `oshi.at`); their names are kept because domains revive and can be run privately. MISSES a paste service this list does not name, a private instance on another domain, an upload made through an SDK rather than a shell command, and a `paste.rs` / `file.io` upload written with no scheme (a bare host). A quoted MENTION is not a use: a search, a `git commit -m` message or an `echo` that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt. `curl --data` is NOT one of those carriers here, because the trigger here can be a `curl` upload: a POST body quoting a paste command still asks.',
|
|
868
884
|
match: {
|
|
869
885
|
any_of: [
|
|
870
886
|
{
|
|
@@ -916,8 +932,9 @@ var exReverseShell = {
|
|
|
916
932
|
category: "exfiltration",
|
|
917
933
|
severity: "critical",
|
|
918
934
|
defaultAction: "block",
|
|
935
|
+
owasp: ["ASI02", "ASI03", "LLM02"],
|
|
919
936
|
title: "Opening a reverse shell to a remote host",
|
|
920
|
-
description: 'Blocks a command that hands an interactive shell to another machine: a bash/zsh/ksh redirection to `/dev/tcp/` or `/dev/udp/`, `nc`/`ncat` with `-e` pointed at a shell, `ncat --exec` or `--sh-exec`, `socat` with an `EXEC:` or `SYSTEM:` address, and a `python -c` one-liner that imports `socket` together with `subprocess`, `pty.spawn` or `os.dup2`. This is the one
|
|
937
|
+
description: 'Blocks a command that hands an interactive shell to another machine: a bash/zsh/ksh redirection to `/dev/tcp/` or `/dev/udp/`, `nc`/`ncat` with `-e` pointed at a shell, `ncat --exec` or `--sh-exec`, `socat` with an `EXEC:` or `SYSTEM:` address, and a `python -c` one-liner that imports `socket` together with `subprocess`, `pty.spawn` or `os.dup2`. This is the only one in the pack that denies rather than asks: none of these has an ordinary use in coding work. Note that plain `sh`/`dash` lack `/dev/tcp`, which is a bash/zsh/ksh feature. Deliberately NOT matched: `nc -zv host port` (a port check), `nc -l` (a listener), `socat -V`, and a `python -c` that imports `socket` alone. MISSES a `mkfifo` back-pipe shell, whose halves are split across `;`/`|` separators, a reverse shell written in Perl, Ruby, PHP or PowerShell\'s `.NET` sockets, and `nc -e` on the OpenBSD build, where `-e` means a TLS certificate name rather than a command. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
921
938
|
match: {
|
|
922
939
|
any_of: [
|
|
923
940
|
{
|
|
@@ -967,6 +984,7 @@ var exTunnelExpose = {
|
|
|
967
984
|
category: "exfiltration",
|
|
968
985
|
severity: "high",
|
|
969
986
|
defaultAction: "require_approval",
|
|
987
|
+
owasp: ["ASI02", "ASI03", "LLM02"],
|
|
970
988
|
title: "Exposing a local port through a public tunnel",
|
|
971
989
|
description: 'Holds a command that puts a local service on a public URL through a tunnel: `ngrok http|tcp|start`, `cloudflared tunnel`, `localtunnel` / `lt --port`, `tailscale funnel`, an `ssh -R` remote forward (including `-NR`, matched only when `ssh` is the command being run), the `serveo.net` and `localhost.run` SSH relays, `bore local`, `frpc` invoked with a flag (`frpc -c \u2026`), and `pinggy.io`. Each reaches past the firewall and gives the outside world a route in, which is a demo convenience and an exfiltration channel both. Deliberately NOT matched: `ssh -L` (a local forward, inbound to you) and `ssh -D` (a SOCKS proxy), `ngrok config check` / `--version`, `cloudflared --version`, `tailscale status` / `serve` (which stays inside the tailnet), `ssh-keygen -R host` (host-key removal, not a tunnel), a `-R` that appears only inside a quoted remote command (`ssh host "grep -R \u2026"`), and a path or filename that merely contains `frpc` (`scripts/frpc-parser.js`). MISSES a tunnel binary run under another name, a raw `ssh -R` to a private relay this list does not name, `frp` driven from its config file rather than the `frpc` command, `sudo frpc`, and an `frpc` subcommand invoked without a leading flag. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
972
990
|
match: {
|
|
@@ -1036,6 +1054,7 @@ var fsAgentSelfConfig = {
|
|
|
1036
1054
|
category: "file-scope",
|
|
1037
1055
|
severity: "high",
|
|
1038
1056
|
defaultAction: "require_approval",
|
|
1057
|
+
owasp: ["ASI02", "LLM03"],
|
|
1039
1058
|
title: "The agent editing its own configuration",
|
|
1040
1059
|
description: "Holds a file tool opening the files that define what the agent itself is allowed to do \u2014 Claude Code settings and hooks, an MCP server list, a plugin manifest, Cursor rules, a Codex config, and the guard's own config.json and guardrails.json. An agent that can edit these can widen its own reach with nobody reviewing the change. Reading is excluded \u2014 the `Read` and `Grep` tools never match \u2014 so opening one of these files to read it is not held; every other file tool is, including one this corpus does not know. Does NOT match ordinary project files, or `.claude/commands/*.md`, which are prompts rather than permissions. Bounded to WELL-KNOWN paths: no working directory or project root reaches the guard, so it can only match names it already knows.",
|
|
1041
1060
|
match: {
|
|
@@ -1079,6 +1098,7 @@ var fsCiDefinition = {
|
|
|
1079
1098
|
category: "file-scope",
|
|
1080
1099
|
severity: "medium",
|
|
1081
1100
|
defaultAction: "require_approval",
|
|
1101
|
+
owasp: ["ASI02", "LLM03"],
|
|
1082
1102
|
title: "Editing the CI pipeline definition",
|
|
1083
1103
|
description: "Holds a file tool opening a CI definition \u2014 GitHub Actions workflows and composite actions, .gitlab-ci.yml, a Jenkinsfile, CircleCI, Azure Pipelines, Buildkite or Bitbucket pipelines. This is where the checks that gate every merge are written down, and where a new step would run with the repository's secrets; both edits look like an ordinary diff. Reading is excluded \u2014 the Read and Grep tools never match \u2014 so opening a CI definition to read it is not held; every other file tool is, including one this corpus does not know. Does NOT match other files under .github/ (CODEOWNERS, issue templates), which gate nothing. It MISSES a CI system whose definition lives outside the repository.",
|
|
1084
1104
|
match: {
|
|
@@ -1122,8 +1142,9 @@ var fsSystemPaths = {
|
|
|
1122
1142
|
category: "file-scope",
|
|
1123
1143
|
severity: "high",
|
|
1124
1144
|
defaultAction: "require_approval",
|
|
1145
|
+
owasp: ["ASI02", "LLM03"],
|
|
1125
1146
|
title: "Writing to a system directory",
|
|
1126
|
-
description: "Holds a file tool writing to a path under a system directory \u2014 /etc, /bin, /sbin, /usr/bin, /usr/local/bin, /boot, /System, /Library/LaunchDaemons, or Windows/System32. Reading is excluded \u2014 the Read and Grep tools never match \u2014 so reading /etc/hosts is not held; every other file tool is, including one this corpus does not know. HONEST CEILING: this is a list of well-known ABSOLUTE paths and it cannot be anything else. No working directory and no project root reaches the guard, so the
|
|
1147
|
+
description: "Holds a file tool writing to a path under a system directory \u2014 /etc, /bin, /sbin, /usr/bin, /usr/local/bin, /boot, /System, /Library/LaunchDaemons, or Windows/System32. Reading is excluded \u2014 the Read and Grep tools never match \u2014 so reading /etc/hosts is not held; every other file tool is, including one this corpus does not know. HONEST CEILING: this is a list of well-known ABSOLUTE paths and it cannot be anything else. No working directory and no project root reaches the guard, so the check you would actually want \u2014 'the agent wrote outside the project' \u2014 is inexpressible, and would match everything or nothing. It therefore MISSES a write anywhere else outside your repository, including another project on the same machine.",
|
|
1127
1148
|
match: {
|
|
1128
1149
|
any_of: [
|
|
1129
1150
|
{ kind: "execute_tool", file_glob: "/etc/**" },
|
|
@@ -1166,8 +1187,9 @@ var fsVcsInternals = {
|
|
|
1166
1187
|
category: "file-scope",
|
|
1167
1188
|
severity: "high",
|
|
1168
1189
|
defaultAction: "require_approval",
|
|
1190
|
+
owasp: ["ASI02", "LLM03"],
|
|
1169
1191
|
title: "Editing git's internals directly",
|
|
1170
|
-
description: "Holds a file tool opening git's own bookkeeping \u2014 .git/config, .git/hooks/, .git/refs/, .git/HEAD, .git/info/exclude \u2014 where a change alters what future git commands do rather than what the repository contains. Deliberately NARROW: all of .git/** would include COMMIT_EDITMSG and the index, which change during every ordinary commit, so
|
|
1192
|
+
description: "Holds a file tool opening git's own bookkeeping \u2014 .git/config, .git/hooks/, .git/refs/, .git/HEAD, .git/info/exclude \u2014 where a change alters what future git commands do rather than what the repository contains. Deliberately NARROW: all of .git/** would include COMMIT_EDITMSG and the index, which change during every ordinary commit, so it would fire constantly and be switched off. Reading is excluded \u2014 the Read and Grep tools never match \u2014 so opening .git/config to read it is not held; every other file tool is, including one this corpus does not know. It does NOT match .gitignore, .gitattributes or anything under .github/, which are tracked project files.",
|
|
1171
1193
|
match: {
|
|
1172
1194
|
any_of: [
|
|
1173
1195
|
{ kind: "execute_tool", file_glob: "**/.git/config" },
|
|
@@ -1214,6 +1236,7 @@ var flagDependencyInstall = {
|
|
|
1214
1236
|
category: "privilege-supply-chain",
|
|
1215
1237
|
severity: "low",
|
|
1216
1238
|
defaultAction: "warn",
|
|
1239
|
+
owasp: ["ASI04", "LLM04", "LLM07"],
|
|
1217
1240
|
title: "Flag new dependency installs",
|
|
1218
1241
|
description: 'Surfaces a new third-party dependency being added \u2014 npm/pnpm/yarn/bun, pip/pipx/poetry/uv, gem, cargo, go get, composer, bundle, dotnet and mix. Non-blocking. Each form requires a PACKAGE ARGUMENT, so a lockfile restore that adds nothing \u2014 `npm ci`, `pnpm install`, `pnpm install --frozen-lockfile` \u2014 is deliberately not flagged. A global flag between the tool and its subcommand is tolerated (`npm --silent install pkg`, `pnpm -C apps/web add react`). MISSES a package named after more than one flag between the subcommand and the package, an install run through a wrapper, a dependency added by hand-editing a manifest, and the system package managers (apt, brew, apk), which install machine software rather than project dependencies. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
1219
1242
|
match: {
|
|
@@ -1273,6 +1296,7 @@ var psIamGrant = {
|
|
|
1273
1296
|
category: "privilege-supply-chain",
|
|
1274
1297
|
severity: "high",
|
|
1275
1298
|
defaultAction: "require_approval",
|
|
1299
|
+
owasp: ["ASI03", "LLM03"],
|
|
1276
1300
|
title: "Granting permissions to an identity",
|
|
1277
1301
|
description: 'Holds a command that attaches a policy, creates an access key, adds an IAM binding or creates a Kubernetes role binding. Nothing breaks at the moment it runs \u2014 the consequence is what some other identity can do afterwards, which is exactly why a person should see it. The read verbs are deliberately NOT matched (`iam list-users`, `get-iam-policy`, `get clusterrolebindings`). It cannot judge whether the grant is narrow or wide, only that one is being made. Global flags between a cloud CLI or `kubectl` and its subcommand are tolerated (`aws --profile <p> iam \u2026`, `kubectl --context <ctx> create \u2026`), and an absolute tool path still matches; a flag that itself runs a program is not read. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
1278
1302
|
match: {
|
|
@@ -1324,6 +1348,7 @@ var psPermissionWiden = {
|
|
|
1324
1348
|
category: "privilege-supply-chain",
|
|
1325
1349
|
severity: "high",
|
|
1326
1350
|
defaultAction: "require_approval",
|
|
1351
|
+
owasp: ["ASI03"],
|
|
1327
1352
|
title: "Making a file writable by everyone",
|
|
1328
1353
|
description: 'Holds a permission change that opens a file or directory to every account on the machine \u2014 `chmod 777`, `chmod a+rwx`, a setuid bit, or an icacls grant of full control to Everyone. It is the reflex fix for a permissions error and almost never the right one. The ordinary chmods that sit beside it are deliberately NOT matched: `chmod +x`, `chmod 644`, `chmod 755`. It cannot see WHAT is being widened, only that it is. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
1329
1354
|
match: {
|
|
@@ -1364,6 +1389,7 @@ var psPersistence = {
|
|
|
1364
1389
|
category: "privilege-supply-chain",
|
|
1365
1390
|
severity: "high",
|
|
1366
1391
|
defaultAction: "require_approval",
|
|
1392
|
+
owasp: ["ASI03"],
|
|
1367
1393
|
title: "Arranging to run again after the session ends",
|
|
1368
1394
|
description: 'Holds a command that installs something which outlives the session \u2014 editing a crontab, loading a launch agent, creating a scheduled task, enabling a systemd unit, appending to a shell profile, or writing a Windows Run key. Reading the same things is deliberately NOT matched (`crontab -l`, `launchctl list`, `systemctl status`, `cat ~/.zshrc`). It cannot see WHAT is being scheduled, only that something is; and it MISSES persistence installed by writing a file with a file tool rather than by a shell command. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
1369
1395
|
match: {
|
|
@@ -1408,6 +1434,7 @@ var psPublishArtifact = {
|
|
|
1408
1434
|
category: "privilege-supply-chain",
|
|
1409
1435
|
severity: "high",
|
|
1410
1436
|
defaultAction: "require_approval",
|
|
1437
|
+
owasp: ["ASI04", "LLM04"],
|
|
1411
1438
|
title: "Publishing an artifact to a public registry",
|
|
1412
1439
|
description: 'Holds a publish \u2014 npm, PyPI via twine or poetry, crates.io, RubyGems, a Docker registry, a GitHub release, or a Maven deploy. Once a version is out it is effectively permanent and other people\'s builds will fetch it, which makes this the one action in the pack whose blast radius is outside the machine. The dry runs and local builds are deliberately NOT matched (`npm pack`, `cargo package`, `docker build`, `gh release list`). It cannot tell a private registry from a public one. Global flags between `npm`/`docker` and the subcommand are tolerated (`npm --silent publish`, `docker --context <name> push \u2026`), and an absolute tool path still matches; a flag that itself runs a program is not read. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
1413
1440
|
match: {
|
|
@@ -1454,6 +1481,7 @@ var psSudoWrite = {
|
|
|
1454
1481
|
category: "privilege-supply-chain",
|
|
1455
1482
|
severity: "high",
|
|
1456
1483
|
defaultAction: "require_approval",
|
|
1484
|
+
owasp: ["ASI03"],
|
|
1457
1485
|
title: "sudo used to write or to run a shell",
|
|
1458
1486
|
description: 'Holds a `sudo` that writes or spawns a shell \u2014 `sudo tee`, `sudo dd`, `sudo cp/mv/rm/ln/install`, `sudo chown`, `sudo sh -c` \u2014 as opposed to a `sudo` that reads or queries. The read/query forms are deliberately NOT matched: `sudo apt-get update`, `sudo -l` and `sudo systemctl status` are ordinary. It reads the command\'s own words, so it MISSES a write performed by a script invoked with sudo, and it cannot tell which path is being written to. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
1459
1487
|
match: {
|
|
@@ -1505,6 +1533,7 @@ var blockProdConfigEdit = {
|
|
|
1505
1533
|
category: "prod-infra",
|
|
1506
1534
|
severity: "high",
|
|
1507
1535
|
defaultAction: "require_approval",
|
|
1536
|
+
owasp: ["ASI02", "LLM03"],
|
|
1508
1537
|
title: "Approve production config edits",
|
|
1509
1538
|
description: "Routes edits to production configuration files to human approval. Matched by path: `*.prod.*` and `*.production.*`, the bare `prod.*` / `production.*` spellings, and any file under a `prod/` or `production/` directory. Reading is excluded \u2014 the `Read` and `Grep` tools never match \u2014 so opening a production config to look at it does not ask for approval; every other file tool does, including one this corpus does not know. Prose is excluded too \u2014 `.md`, `.mdx` and `.txt` never match \u2014 so writing a runbook under `docs/production/` does not ask for approval to change production. It matches the PATH only: it cannot tell a real production config from a file that merely spells prod in its name, and it MISSES a production config named something else entirely, such as `values-live.yaml`.",
|
|
1510
1539
|
match: {
|
|
@@ -1550,8 +1579,9 @@ var piCloudResourceDelete = {
|
|
|
1550
1579
|
category: "prod-infra",
|
|
1551
1580
|
severity: "high",
|
|
1552
1581
|
defaultAction: "require_approval",
|
|
1582
|
+
owasp: ["ASI02", "LLM03"],
|
|
1553
1583
|
title: "Deleting a cloud resource from a vendor CLI",
|
|
1554
|
-
description: 'Deletes or terminates a cloud resource through the AWS, gcloud or Azure CLI, including emptying an S3 bucket. The read verbs that sit right beside them \u2014 describe, list, get \u2014 are deliberately NOT matched. This
|
|
1584
|
+
description: 'Deletes or terminates a cloud resource through the AWS, gcloud or Azure CLI, including emptying an S3 bucket. The read verbs that sit right beside them \u2014 describe, list, get \u2014 are deliberately NOT matched. This reads the command\'s own words, so it cannot tell which account or project is configured, and it MISSES a delete performed through an SDK, a Terraform apply (see pi.terraform-auto-approve), or a vendor CLI other than these three. Global flags between a cloud CLI and its subcommand are tolerated (`aws --profile <p> \u2026`, `aws --region <r> \u2026`, `gcloud --project=<p> \u2026`), and an absolute tool path still matches; a flag that itself runs a program is not read. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
1555
1585
|
match: {
|
|
1556
1586
|
any_of: [
|
|
1557
1587
|
{
|
|
@@ -1594,8 +1624,9 @@ var piDeployToProd = {
|
|
|
1594
1624
|
category: "prod-infra",
|
|
1595
1625
|
severity: "high",
|
|
1596
1626
|
defaultAction: "require_approval",
|
|
1627
|
+
owasp: ["ASI02", "LLM03"],
|
|
1597
1628
|
title: "A deploy command that names production",
|
|
1598
|
-
description: 'Ships code to a production environment through a hosting CLI whose command text says so \u2014 `vercel --prod`, `netlify deploy --prod`, `serverless deploy --stage prod`, `fly deploy`, `eb deploy`, `wrangler deploy` and Capistrano\'s production task. The preview and staging siblings are deliberately NOT matched, because a
|
|
1629
|
+
description: 'Ships code to a production environment through a hosting CLI whose command text says so \u2014 `vercel --prod`, `netlify deploy --prod`, `serverless deploy --stage prod`, `fly deploy`, `eb deploy`, `wrangler deploy` and Capistrano\'s production task. The preview and staging siblings are deliberately NOT matched, because a check that asks on every preview deploy is switched off before it ever sees a real one. It MISSES a deploy triggered by a git push, by CI, or by any script whose own text does not name the environment. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
1599
1630
|
match: {
|
|
1600
1631
|
any_of: [
|
|
1601
1632
|
{
|
|
@@ -1637,8 +1668,9 @@ var piHelmRelease = {
|
|
|
1637
1668
|
category: "prod-infra",
|
|
1638
1669
|
severity: "high",
|
|
1639
1670
|
defaultAction: "require_approval",
|
|
1671
|
+
owasp: ["ASI02", "LLM03"],
|
|
1640
1672
|
title: "Helm uninstall / rollback / forced upgrade",
|
|
1641
|
-
description: 'Removes or rewinds a Helm release, or forces an upgrade past Helm\'s own safety checks \u2014 all of which change what is running in a cluster. Does NOT match the idempotent deploy everyone actually uses (`helm upgrade --install`), nor `helm list`, `helm template` or `helm diff`. Like
|
|
1673
|
+
description: 'Removes or rewinds a Helm release, or forces an upgrade past Helm\'s own safety checks \u2014 all of which change what is running in a cluster. Does NOT match the idempotent deploy everyone actually uses (`helm upgrade --install`), nor `helm list`, `helm template` or `helm diff`. Like everything in this pack it cannot see which cluster is selected, so it treats a local kind cluster and production identically. Global flags between `helm` and its subcommand are tolerated (`helm -n <ns> uninstall \u2026`, `--kube-context <ctx>`), and an absolute tool path still matches; a flag that itself runs a program is not read. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
1642
1674
|
match: {
|
|
1643
1675
|
any_of: [
|
|
1644
1676
|
{
|
|
@@ -1677,6 +1709,7 @@ var piKubectlDelete = {
|
|
|
1677
1709
|
category: "prod-infra",
|
|
1678
1710
|
severity: "high",
|
|
1679
1711
|
defaultAction: "require_approval",
|
|
1712
|
+
owasp: ["ASI02", "LLM03"],
|
|
1680
1713
|
title: "kubectl delete / drain removes running workloads",
|
|
1681
1714
|
description: 'Deletes Kubernetes objects or drains a node, both of which stop running workloads. Held for approval rather than blocked because deleting a test deployment is routine. The guard CANNOT tell which cluster is selected \u2014 no kubeconfig, context or environment variable reaches it \u2014 so this fires the same way against a kind cluster and against production; pi.prod-namespace covers the case where the command itself names the environment. Does NOT match the read verbs (`get`, `describe`, `logs`) or `kubectl apply`. Global flags between `kubectl` and its verb are tolerated (`kubectl -n <ns> delete \u2026`, `--context <ctx>`, `--kubeconfig <f>`), and an absolute tool path still matches; a flag that itself runs a program is not read. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
1682
1715
|
match: {
|
|
@@ -1720,8 +1753,9 @@ var piProdNamespace = {
|
|
|
1720
1753
|
category: "prod-infra",
|
|
1721
1754
|
severity: "high",
|
|
1722
1755
|
defaultAction: "require_approval",
|
|
1756
|
+
owasp: ["ASI02", "LLM03"],
|
|
1723
1757
|
title: "A mutating kubectl command that names production",
|
|
1724
|
-
description: 'A kubectl command that both MUTATES (delete, apply, scale, patch, replace, rollout, drain, exec, edit, set) and names a production namespace or context in its own text. Reads are deliberately NOT matched \u2014 `kubectl get pods -n production` and `kubectl logs -n production` are how you find out what is wrong. This is the only environment signal the guard has: no kubeconfig or current-context reaches it, so a mutating command against production that does not SAY production is invisible
|
|
1758
|
+
description: 'A kubectl command that both MUTATES (delete, apply, scale, patch, replace, rollout, drain, exec, edit, set) and names a production namespace or context in its own text. Reads are deliberately NOT matched \u2014 `kubectl get pods -n production` and `kubectl logs -n production` are how you find out what is wrong. This is the only environment signal the guard has: no kubeconfig or current-context reaches it, so a mutating command against production that does not SAY production is invisible here. The mutating verb and the production namespace or context may now appear in either order and after a global flag (`kubectl -n prod delete \u2026`, `kubectl --context=prod-cluster apply \u2026`), and an absolute tool path still matches; as a consequence a config write that names production (`kubectl config set-context \u2026 --namespace prod`) is also held, which is acceptable for a prompt rather than a block. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
1725
1759
|
match: {
|
|
1726
1760
|
any_of: [
|
|
1727
1761
|
{
|
|
@@ -1759,6 +1793,7 @@ var piTerraformAutoApprove = {
|
|
|
1759
1793
|
category: "prod-infra",
|
|
1760
1794
|
severity: "high",
|
|
1761
1795
|
defaultAction: "require_approval",
|
|
1796
|
+
owasp: ["ASI02", "LLM03"],
|
|
1762
1797
|
title: "Terraform apply/destroy without the confirmation prompt",
|
|
1763
1798
|
description: 'Applies or destroys infrastructure with `-auto-approve`, which removes the interactive confirmation Terraform puts there on purpose. Held for approval rather than blocked, because it is the correct flag inside CI. Does NOT match `terraform plan`, `terraform validate`, `terraform fmt`, or `terraform apply tf.plan` against a saved plan file \u2014 a saved plan was already reviewed, which is the whole point of saving it. It cannot tell which workspace or account is selected, because no environment reaches the guard. A global option between the tool and its subcommand is tolerated (`terraform -chdir=<dir> apply -auto-approve`, `--no-color`), and an absolute tool path still matches; a flag that itself runs a program is not read. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
1764
1799
|
match: {
|
|
@@ -1796,6 +1831,7 @@ var piTerraformStateMutate = {
|
|
|
1796
1831
|
category: "prod-infra",
|
|
1797
1832
|
severity: "high",
|
|
1798
1833
|
defaultAction: "require_approval",
|
|
1834
|
+
owasp: ["ASI02", "LLM03"],
|
|
1799
1835
|
title: "Hand-editing Terraform state",
|
|
1800
1836
|
description: 'Mutates the Terraform state file directly \u2014 `state rm`, `state mv`, `state push`, `taint`, `untaint`, `force-unlock`. None of these changes any infrastructure by itself; they change what the NEXT apply believes exists, which is how a `state rm` turns into a destroyed resource two commands later. The read-only commands are deliberately NOT matched (`state list`, `state show`, `state pull`, `show`). It cannot see which backend or workspace is selected. A global option between the tool and `state`/`taint`/`force-unlock` is tolerated (`terraform -chdir=<dir> state rm \u2026`, `--no-color`), and an absolute tool path still matches; a flag that itself runs a program is not read. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
1801
1837
|
match: {
|
|
@@ -1848,8 +1884,9 @@ var blockCurlPipeToShell = {
|
|
|
1848
1884
|
category: "rce-supply-chain",
|
|
1849
1885
|
severity: "critical",
|
|
1850
1886
|
defaultAction: "block",
|
|
1887
|
+
owasp: ["ASI04", "ASI05", "LLM04"],
|
|
1851
1888
|
title: "Block curl/wget piped to a shell",
|
|
1852
|
-
description: 'Blocks a downloaded script piped straight into a shell \u2014 remote code execution \u2014 so the id and the verdict agree. Catches the shell named directly, behind a path (`| /bin/bash`), or behind sudo with its own flags (`| sudo -E bash -`) \u2014 the canonical NodeSource installer \u2014 and covers sh, bash, zsh, ksh and dash. The downloader and the pipe must be on the SAME line and in that order, with no second pipe between them. Does NOT match `curl \u2026 | jq .` or `| shasum`. MISSES the command-substitution spelling (see rce.eval-dynamic), and a download followed by a separate later execution. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt. `curl --data` is NOT one of those carriers here, because
|
|
1889
|
+
description: 'Blocks a downloaded script piped straight into a shell \u2014 remote code execution \u2014 so the id and the verdict agree. Catches the shell named directly, behind a path (`| /bin/bash`), or behind sudo with its own flags (`| sudo -E bash -`) \u2014 the canonical NodeSource installer \u2014 and covers sh, bash, zsh, ksh and dash. The downloader and the pipe must be on the SAME line and in that order, with no second pipe between them. Does NOT match `curl \u2026 | jq .` or `| shasum`. MISSES the command-substitution spelling (see rce.eval-dynamic), and a download followed by a separate later execution. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt. `curl --data` is NOT one of those carriers here, because the trigger here is a `curl`/`wget` pipeline: a POST body quoting a pipe-to-shell one-liner still blocks.',
|
|
1853
1890
|
match: {
|
|
1854
1891
|
any_of: [
|
|
1855
1892
|
{
|
|
@@ -1886,8 +1923,9 @@ var rceEvalDynamic = {
|
|
|
1886
1923
|
category: "rce-supply-chain",
|
|
1887
1924
|
severity: "high",
|
|
1888
1925
|
defaultAction: "require_approval",
|
|
1926
|
+
owasp: ["ASI04", "ASI05", "LLM04"],
|
|
1889
1927
|
title: "Executing the output of a download",
|
|
1890
|
-
description: 'Holds the command-substitution spelling of remote code execution \u2014 `bash -c "$(curl \u2026)"`, `eval "$(wget \u2026)"`, and PowerShell\'s `iex (irm \u2026)`. This is the shape block-curl-pipe-to-shell cannot see, because there is no pipe. Deliberately NOT matched: `eval` of a local command, which is how direnv, ssh-agent and every shell init line work \u2014 a
|
|
1928
|
+
description: 'Holds the command-substitution spelling of remote code execution \u2014 `bash -c "$(curl \u2026)"`, `eval "$(wget \u2026)"`, and PowerShell\'s `iex (irm \u2026)`. This is the shape block-curl-pipe-to-shell cannot see, because there is no pipe. Deliberately NOT matched: `eval` of a local command, which is how direnv, ssh-agent and every shell init line work \u2014 a check that held those would be gone by the first morning. It therefore MISSES an eval of a variable that was filled by a download two commands earlier. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt. `curl --data` is NOT one of those carriers here, because the trigger here names `curl`/`wget`; and a `$(` inside double quotes is never exempt anywhere, because the shell expands it.',
|
|
1891
1929
|
match: {
|
|
1892
1930
|
any_of: [
|
|
1893
1931
|
{
|
|
@@ -1928,6 +1966,7 @@ var rceForeignRegistry = {
|
|
|
1928
1966
|
category: "rce-supply-chain",
|
|
1929
1967
|
severity: "high",
|
|
1930
1968
|
defaultAction: "require_approval",
|
|
1969
|
+
owasp: ["ASI04", "LLM04"],
|
|
1931
1970
|
title: "Redirecting a package manager to another registry",
|
|
1932
1971
|
description: "Holds a command that points npm, yarn, pip or poetry at a registry other than the default, whether for one install or by writing the config. The guard CANNOT tell a company's own Artifactory from an attacker's mirror: it has no allow-list, and nothing in a tool call would let it be given one \u2014 so it surfaces the redirection and leaves the judgement to a person. Does NOT match reading the config (`npm config get registry`) or an ordinary install. MISSES a registry set in a committed .npmrc, which is a file edit rather than a command. Global flags between the package manager and its subcommand are tolerated (`npm --silent config set registry \u2026`, `pip --no-cache-dir install \u2026`), and an absolute tool path still matches; a flag that itself runs a program is not read. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m \"x\" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.",
|
|
1933
1972
|
match: {
|
|
@@ -1970,8 +2009,9 @@ var rceRemoteRunner = {
|
|
|
1970
2009
|
category: "rce-supply-chain",
|
|
1971
2010
|
severity: "high",
|
|
1972
2011
|
defaultAction: "require_approval",
|
|
2012
|
+
owasp: ["ASI04", "ASI05", "LLM04"],
|
|
1973
2013
|
title: "Running code straight from a URL",
|
|
1974
|
-
description: 'Holds process substitution from a downloader (`bash <(curl \u2026)`) and a package runner handed a bare URL (`npx https://\u2026`, `bunx https://\u2026`). Both execute code that was never written to disk where a human could look at it. Deliberately NOT matched: `curl \u2026 | jq .`, `curl \u2026 -o setup.sh`, and `npx --yes prettier` \u2014 downloading data and running a named package are not this. MISSES a two-step download-then-execute, where each half is ordinary on its own. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt. `curl --data` is NOT one of those carriers here, because
|
|
2014
|
+
description: 'Holds process substitution from a downloader (`bash <(curl \u2026)`) and a package runner handed a bare URL (`npx https://\u2026`, `bunx https://\u2026`). Both execute code that was never written to disk where a human could look at it. Deliberately NOT matched: `curl \u2026 | jq .`, `curl \u2026 -o setup.sh`, and `npx --yes prettier` \u2014 downloading data and running a named package are not this. MISSES a two-step download-then-execute, where each half is ordinary on its own. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt. `curl --data` is NOT one of those carriers here, because the trigger here names `curl`/`wget`: a POST body quoting one still asks.',
|
|
1975
2015
|
match: {
|
|
1976
2016
|
any_of: [
|
|
1977
2017
|
{
|
|
@@ -2010,8 +2050,9 @@ var rceTlsVerifyOff = {
|
|
|
2010
2050
|
category: "rce-supply-chain",
|
|
2011
2051
|
severity: "high",
|
|
2012
2052
|
defaultAction: "require_approval",
|
|
2053
|
+
owasp: ["ASI04", "LLM04"],
|
|
2013
2054
|
title: "Disabling TLS certificate verification",
|
|
2014
|
-
description: "Holds a command that switches off certificate verification \u2014 curl's -k/--insecure, wget's --no-check-certificate, NODE_TLS_REJECT_UNAUTHORIZED=0, git's http.sslVerify=false, pip's --trusted-host, npm's --strict-ssl=false. Each turns an encrypted channel into one anyone on the path can rewrite, which is how a dependency download becomes an arbitrary payload. Does NOT match ordinary https requests. Known over-match: any curl short-flag cluster containing the letter k is treated as -k, since the guard parses no argv. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m \"x\" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt. `curl --data` is NOT one of those carriers here, because
|
|
2055
|
+
description: "Holds a command that switches off certificate verification \u2014 curl's -k/--insecure, wget's --no-check-certificate, NODE_TLS_REJECT_UNAUTHORIZED=0, git's http.sslVerify=false, pip's --trusted-host, npm's --strict-ssl=false. Each turns an encrypted channel into one anyone on the path can rewrite, which is how a dependency download becomes an arbitrary payload. Does NOT match ordinary https requests. Known over-match: any curl short-flag cluster containing the letter k is treated as -k, since the guard parses no argv. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m \"x\" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt. `curl --data` is NOT one of those carriers here, because the trigger here IS a `curl`/`wget` flag.",
|
|
2015
2056
|
match: {
|
|
2016
2057
|
any_of: [
|
|
2017
2058
|
{
|
|
@@ -2055,6 +2096,7 @@ var rceUnverifiedPackage = {
|
|
|
2055
2096
|
category: "rce-supply-chain",
|
|
2056
2097
|
severity: "medium",
|
|
2057
2098
|
defaultAction: "require_approval",
|
|
2099
|
+
owasp: ["ASI04", "ASI05", "LLM04", "LLM07"],
|
|
2058
2100
|
title: "Installing a package from a URL or a git ref",
|
|
2059
2101
|
description: 'Holds an install whose source is a URL, a git reference or a tarball rather than a registry name \u2014 `npm i git+https://\u2026`, `pip install git+\u2026`, `cargo install --git`, `go install \u2026@main`. A registry entry is at least a name a person recognises and a version a lockfile can pin; a moving git ref is neither. Does NOT match an ordinary registry install, which is flag-dependency-install\'s job. It MISSES a git dependency declared in a manifest file rather than typed as a command. Global flags between the package manager and its subcommand are tolerated (`npm --silent i git+\u2026`, `pip --no-cache-dir install \u2026`), and an absolute tool path still matches; `cargo` and `go` are matched by their own contiguous forms, and a flag that itself runs a program is not read. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
2060
2102
|
match: {
|
|
@@ -2107,6 +2149,7 @@ var gbAdminMerge = {
|
|
|
2107
2149
|
category: "safety-bypass",
|
|
2108
2150
|
severity: "high",
|
|
2109
2151
|
defaultAction: "require_approval",
|
|
2152
|
+
owasp: ["ASI09"],
|
|
2110
2153
|
title: "Merging past branch protection, or deleting it",
|
|
2111
2154
|
description: 'Holds `gh pr merge --admin` (which merges without the required reviews or checks), a `gh api` call that deletes or replaces a branch-protection rule, and `gh ruleset delete`. Does NOT match an ordinary merge (`gh pr merge --squash`) or a READ of the protection settings, which is how you find out what is configured. It only sees the GitHub CLI: the same change made in the web UI, or through another client, is invisible to it. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
2112
2155
|
match: {
|
|
@@ -2146,6 +2189,7 @@ var gbAnsiTerminalForgery = {
|
|
|
2146
2189
|
category: "safety-bypass",
|
|
2147
2190
|
severity: "medium",
|
|
2148
2191
|
defaultAction: "warn",
|
|
2192
|
+
owasp: ["ASI09", "LLM10"],
|
|
2149
2193
|
title: "Emitting raw terminal control sequences",
|
|
2150
2194
|
description: "Warns when `echo` or `printf` emits a raw terminal control sequence \u2014 the escape introducer `\\x1b`, `\\033` or `\\e` followed by `[` (a CSI: cursor moves, screen clears, colour) or `]` (an OSC: `]0;` sets the window title, `]8;;` plants a clickable hyperlink). Rendered into a terminal, log or IDE that does not neutralise them, these forge what a human reads back. This is a broad `warn` on purpose: a colourised build line trips it too, and that is an acceptable cost for a warning. Because its own trigger is an `echo`/`printf`, the `echo` quoted-MENTION carrier is NOT exempt here \u2014 an `echo` that prints an escape is exactly the case \u2014 while a search, a `git commit -m` message and a `curl --data` body that only name one are left alone. Matches the escape written as a backslash sequence in the command text. MISSES a raw ESC byte pasted literally, a sequence printed by a compiled program or a script file rather than an inline `echo`/`printf`, and `tput`, which reads terminfo and emits nothing literal in the command. The exemption holds only while every shell metacharacter stays inside the quotes.",
|
|
2151
2195
|
match: {
|
|
@@ -2185,6 +2229,7 @@ var gbAuditTrailPurge = {
|
|
|
2185
2229
|
category: "safety-bypass",
|
|
2186
2230
|
severity: "high",
|
|
2187
2231
|
defaultAction: "require_approval",
|
|
2232
|
+
owasp: ["ASI09"],
|
|
2188
2233
|
title: "Erasing shell history or system logs",
|
|
2189
2234
|
description: 'Holds a command that erases the record of what ran: `history -c` / `-w`, `unset HISTFILE`, `HISTFILE=/dev/null`, `HISTSIZE=0`, `set +o history`, PowerShell\'s `Clear-History`; deleting or truncating a `*_history` file (`rm`, `truncate`, `shred`, `: >`); `journalctl --vacuum-time` / `--vacuum-size` / `--vacuum-files` / `--rotate`; `rm -rf`, `truncate` or `shred` against `/var/log`; and `git reflog expire --expire=now` or `git gc --prune=now`, which drop the safety net a history rewrite would otherwise leave. A READ is not matched: `history` on its own, `history | tail`, `journalctl --since`, `git reflog`, `git reflog show`, and a plain `git gc`. MISSES `HISTFILE` unset in a shell profile rather than at the prompt, a log truncated with an editor or a file tool, and a purge run by a tool other than these. A global flag between `git` and `reflog`/`gc` is tolerated (`git -C <dir> reflog expire \u2026`, `--no-pager`, `-c k=v`), and an absolute tool path such as `/usr/bin/git` still matches; a flag that itself runs a program is not read. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
2190
2235
|
match: {
|
|
@@ -2247,6 +2292,7 @@ var gbExecutionPolicyBypass = {
|
|
|
2247
2292
|
category: "safety-bypass",
|
|
2248
2293
|
severity: "high",
|
|
2249
2294
|
defaultAction: "require_approval",
|
|
2295
|
+
owasp: ["ASI09"],
|
|
2250
2296
|
title: "Bypassing the PowerShell execution policy",
|
|
2251
2297
|
description: 'Holds `Set-ExecutionPolicy Bypass/Unrestricted` and the `-ExecutionPolicy Bypass` launch flag, which together are the opening line of essentially every PowerShell-based loader. It is also occasionally what a developer legitimately needs, which is why it holds rather than blocks. Does NOT match reading the policy (`Get-ExecutionPolicy`), setting it to RemoteSigned, or an ordinary `powershell -Command`. Windows-only by nature. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
2252
2298
|
match: {
|
|
@@ -2284,8 +2330,9 @@ var gbGitNoVerify = {
|
|
|
2284
2330
|
category: "safety-bypass",
|
|
2285
2331
|
severity: "medium",
|
|
2286
2332
|
defaultAction: "require_approval",
|
|
2333
|
+
owasp: ["ASI09"],
|
|
2287
2334
|
title: "git --no-verify skips the hooks the team installed",
|
|
2288
|
-
description: 'Commits, pushes or merges with `--no-verify`, which skips the pre-commit and pre-push hooks a team installed on purpose \u2014 the formatter, the type check, the secret scanner. It is the most common way a check everyone believes is running turns out not to be. Deliberately does NOT widen to skipping tests in general: `mvn -DskipTests package` is ordinary work and is asserted as a negative. Known over-match: a `-n` anywhere in a `git commit` line, including inside a message. Global flags between `git` and its subcommand are tolerated (`git -C <dir> commit --no-verify`, `--no-pager`, `-c k=v`), and an absolute tool path such as `/usr/bin/git` still matches; a flag that itself runs a program is not read. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt. `git commit` is NOT one of those carriers here, because
|
|
2335
|
+
description: 'Commits, pushes or merges with `--no-verify`, which skips the pre-commit and pre-push hooks a team installed on purpose \u2014 the formatter, the type check, the secret scanner. It is the most common way a check everyone believes is running turns out not to be. Deliberately does NOT widen to skipping tests in general: `mvn -DskipTests package` is ordinary work and is asserted as a negative. Known over-match: a `-n` anywhere in a `git commit` line, including inside a message. Global flags between `git` and its subcommand are tolerated (`git -C <dir> commit --no-verify`, `--no-pager`, `-c k=v`), and an absolute tool path such as `/usr/bin/git` still matches; a flag that itself runs a program is not read. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt. `git commit` is NOT one of those carriers here, because the trigger here is a flag of `git commit`: a commit message that quotes `--no-verify` still asks.',
|
|
2289
2336
|
match: {
|
|
2290
2337
|
any_of: [
|
|
2291
2338
|
{
|
|
@@ -2326,6 +2373,7 @@ var gbHooksDisable = {
|
|
|
2326
2373
|
category: "safety-bypass",
|
|
2327
2374
|
severity: "medium",
|
|
2328
2375
|
defaultAction: "require_approval",
|
|
2376
|
+
owasp: ["ASI09"],
|
|
2329
2377
|
title: "Disabling git hooks at the source",
|
|
2330
2378
|
description: 'Holds a command that turns git hooks off permanently rather than for one commit \u2014 repointing `core.hooksPath`, setting HUSKY=0 or HUSKY_SKIP_HOOKS, or deleting/unsetting the executable bit on files in `.git/hooks/`. A READ of the setting (`git config core.hooksPath` with no value) is not matched. Nothing about the next commit looks any different afterwards, which is what makes it worth a prompt. Does NOT match other `git config` writes (`user.email`, `core.pager`) or installing hooks (`husky install`). It MISSES a hooksPath set through an environment variable in a shell profile. A global flag between `git` and `config` is tolerated (`git -C <dir> config \u2026`, `--no-pager`, `-c k=v`), and an absolute tool path such as `/usr/bin/git` still matches; a flag that itself runs a program is not read. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
2331
2379
|
match: {
|
|
@@ -2367,6 +2415,7 @@ var gbHostKeyBypass = {
|
|
|
2367
2415
|
category: "safety-bypass",
|
|
2368
2416
|
severity: "high",
|
|
2369
2417
|
defaultAction: "require_approval",
|
|
2418
|
+
owasp: ["ASI09"],
|
|
2370
2419
|
title: "Accepting any SSH host key",
|
|
2371
2420
|
description: 'Holds `StrictHostKeyChecking=no`, a `UserKnownHostsFile` pointed at /dev/null, or a blind `ssh-keyscan` appended to known_hosts. Host-key checking exists to notice one thing \u2014 that the machine you reached is the machine you meant \u2014 and each of these is how it stops noticing. Does NOT match ordinary ssh, git-over-ssh or key generation. It cannot tell a CI runner (where this is sometimes the pragmatic answer) from a developer laptop, because no environment reaches the guard. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
2372
2421
|
match: {
|
|
@@ -2417,6 +2466,7 @@ var blockEnvFileRead = {
|
|
|
2417
2466
|
category: "secret-exposure",
|
|
2418
2467
|
severity: "high",
|
|
2419
2468
|
defaultAction: "warn",
|
|
2469
|
+
owasp: ["ASI02", "ASI03", "LLM02"],
|
|
2420
2470
|
title: "Flag reading a .env file",
|
|
2421
2471
|
description: "Warns when a file tool READS a dotenv file \u2014 the `Read` and `Grep` tools \u2014 at both the `.env*` spelling at any depth and the `<name>.env` spelling (production.env, secrets.env). A WRITE is deliberately NOT flagged (`Edit`, `Write`, `MultiEdit`, `NotebookEdit`, and Cursor's `Delete`), because creating or editing config is ordinary work and the exposure this catches is an agent reading an existing secret, so the id names the read. A committed placeholder is NOT flagged either (.env.example, .env.sample, .env.template), because warning on a file that holds no secret teaches the reader to ignore the warning. Matches file-tool access by path: reading a .env through a shell command such as `cat .env` is a command span and is covered by se.env-print instead. It also cannot tell whether the file actually contains a secret.",
|
|
2422
2472
|
match: {
|
|
@@ -2456,8 +2506,9 @@ var blockHardcodedSecrets = {
|
|
|
2456
2506
|
category: "secret-exposure",
|
|
2457
2507
|
severity: "critical",
|
|
2458
2508
|
defaultAction: "block",
|
|
2509
|
+
owasp: ["ASI02", "ASI03", "LLM02"],
|
|
2459
2510
|
title: "Block hard-coded secrets in commands",
|
|
2460
|
-
description: "Blocks a shell command carrying a credential with the right SHAPE \u2014 an AWS access-key id (AKIA/ASIA plus 16 more characters), a GitHub token (gh?_ with a body of at least 36 characters, or github_pat_ with a long one), a Stripe live key, or PEM PRIVATE key material. Three arms are CASE-SENSITIVE and use detail_contains deliberately: these prefixes are upper- or lower-case by specification, so case IS the signal, and the length check in the same condition is what makes the difference between a mention and a key. Requiring the body is why auditing your own repo for a leak (`grep -rn AKIA .`) is not itself blocked, and requiring PRIVATE KEY beside -----BEGIN is why a public certificate is not. MISSES formats not listed (Slack, OpenAI, Google) and any secret that is not self-identifying, such as a bare password; and it sees command text only, never the contents of a file edit. A quoted MENTION is exempt on only TWO of the four carriers this corpus recognises, and this is the
|
|
2511
|
+
description: "Blocks a shell command carrying a credential with the right SHAPE \u2014 an AWS access-key id (AKIA/ASIA plus 16 more characters), a GitHub token (gh?_ with a body of at least 36 characters, or github_pat_ with a long one), a Stripe live key, or PEM PRIVATE key material. Three arms are CASE-SENSITIVE and use detail_contains deliberately: these prefixes are upper- or lower-case by specification, so case IS the signal, and the length check in the same condition is what makes the difference between a mention and a key. Requiring the body is why auditing your own repo for a leak (`grep -rn AKIA .`) is not itself blocked, and requiring PRIVATE KEY beside -----BEGIN is why a public certificate is not. MISSES formats not listed (Slack, OpenAI, Google) and any secret that is not self-identifying, such as a bare password; and it sees command text only, never the contents of a file edit. A quoted MENTION is exempt on only TWO of the four carriers this corpus recognises, and this is the only case where they are not equivalent \u2014 because here the carrier IS the exposure rather than a mention of it. A search (`grep -rn AKIA .`) and an `echo` are exempt: the key goes nowhere, and searching for one is how you find it to rotate. A `git commit -m` message and a `curl --data` body are NOT: a key in a commit message is written into history and then pushed, and a key in a POST body has already left the machine. The cost of that, stated in the other direction: documenting a REAL-looking key in a commit message is still blocked, and the only ways through are to redact the body of the key or to use a placeholder that fails the length check. Exemption also holds only while every shell metacharacter stays inside the quotes, and a single leading `sudo` aside, the carrier must be the first word.",
|
|
2461
2512
|
match: {
|
|
2462
2513
|
any_of: [
|
|
2463
2514
|
{ kind: "execute_tool", detail_contains: ["AKIA"], detail_matches: ["AKIA[0-9A-Z]{16}"] },
|
|
@@ -2473,8 +2524,8 @@ var blockHardcodedSecrets = {
|
|
|
2473
2524
|
},
|
|
2474
2525
|
{ kind: "execute_tool", detail_contains: ["-----BEGIN ", "PRIVATE KEY"] }
|
|
2475
2526
|
],
|
|
2476
|
-
// Only TWO of the four carriers are exempt here, and this is the one
|
|
2477
|
-
// that is true. For every other
|
|
2527
|
+
// Only TWO of the four carriers are exempt here, and this is the one guardrail where
|
|
2528
|
+
// that is true. For every other guardrail a carrier is inert — a commit message naming
|
|
2478
2529
|
// `rm -rf /` deletes nothing. Here the carrier IS the exposure: a live key in a
|
|
2479
2530
|
// commit message is written into history and pushed, and a live key in a POST
|
|
2480
2531
|
// body has already left the machine. Searching for a key is how you find one to
|
|
@@ -2487,7 +2538,7 @@ var blockHardcodedSecrets = {
|
|
|
2487
2538
|
bash(`export AWS_ACCESS_KEY_ID=ASIA${"EXAMPLE".repeat(3).slice(0, 16)}`),
|
|
2488
2539
|
bash(`export GH_TOKEN=ghp_${"EXAMPLE".repeat(6)}`),
|
|
2489
2540
|
bash("ssh-add - <<< '-----BEGIN OPENSSH PRIVATE KEY-----'"),
|
|
2490
|
-
// The carrier
|
|
2541
|
+
// The carrier exemption above, as fixtures. These two are `block` — MUST
|
|
2491
2542
|
// match — precisely because they are quoted mentions, which everywhere else
|
|
2492
2543
|
// in this corpus means "leave it alone".
|
|
2493
2544
|
mentionInCommit("export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE"),
|
|
@@ -2511,6 +2562,7 @@ var requireAuthOnPiiEndpoints = {
|
|
|
2511
2562
|
category: "secret-exposure",
|
|
2512
2563
|
severity: "medium",
|
|
2513
2564
|
defaultAction: "require_approval",
|
|
2565
|
+
owasp: ["ASI02", "ASI03", "LLM02"],
|
|
2514
2566
|
title: "Review API endpoint changes for auth",
|
|
2515
2567
|
description: "Routes edits to API route/handler SOURCE files to human approval so a reviewer can confirm authentication is present on new or changed endpoints. Matched by path: a source file under routes/, handlers/ or controllers/; an api/ directory nested inside a source tree (src/api/, app/api/, pages/api/); Next's route.ts convention; and the <name>.controller.* / <name>.routes.* spellings. Reading is excluded \u2014 the Read and Grep tools never match \u2014 so opening an endpoint's source to read it does not ask for approval; every other file tool does, including one this corpus does not know. HEURISTIC: a path signal only \u2014 it cannot inspect the edit for a missing auth check or exposed PII, so treat a match as confirm auth on this endpoint, not as a finding. It deliberately does NOT match every file in a package merely NAMED api, nor a client-side router table such as routes.tsx, which defines no endpoint; and it MISSES endpoints declared inline in a server file or by a framework convention not listed above.",
|
|
2516
2568
|
match: {
|
|
@@ -2550,13 +2602,16 @@ var requireAuthOnPiiEndpoints = {
|
|
|
2550
2602
|
};
|
|
2551
2603
|
|
|
2552
2604
|
// src/packs/secret-exposure/se-credential-file.ts
|
|
2605
|
+
var NOT_VENDORED = "*(@(!(node_modules|dist|vendor)|@(node_modules|dist|vendor)[^/]*)/)";
|
|
2606
|
+
var PROD_CONFIG = "@(yml|yaml|json|toml|env|ini|conf|properties|tf|tfvars)";
|
|
2553
2607
|
var seCredentialFile = {
|
|
2554
2608
|
id: "se.credential-file",
|
|
2555
2609
|
category: "secret-exposure",
|
|
2556
2610
|
severity: "high",
|
|
2557
2611
|
defaultAction: "require_approval",
|
|
2612
|
+
owasp: ["ASI02", "ASI03", "LLM02"],
|
|
2558
2613
|
title: "Opening a file that holds credentials",
|
|
2559
|
-
description: "Holds a file tool opening a path where credentials live \u2014 an SSH private key, an AWS credentials file, a PEM/P12/PFX/JKS keystore, `.npmrc` or `.pypirc` (which hold registry tokens), a Docker config, or a kubeconfig. Public keys are excluded (`*.pub`). It matches the PATH ONLY: it cannot tell whether the file actually holds a secret, so a `.pem` that is a public certificate is held too, and a credential in a file named something else is missed entirely. `.env` files are covered separately by block-env-file-read.",
|
|
2614
|
+
description: "Holds a file tool opening a path where credentials live \u2014 an SSH private key, an AWS credentials file, a PEM/P12/PFX/JKS keystore, `.npmrc` or `.pypirc` (which hold registry tokens), a Docker config, or a kubeconfig. Public keys are excluded (`*.pub`). It matches the PATH ONLY: it cannot tell whether the file actually holds a secret, so a `.pem` that is a public certificate is held too, and a credential in a file named something else is missed entirely. `.env` files are covered separately by block-env-file-read. It also holds READING \u2014 the `Read` and `Grep` tools, nothing else \u2014 of files whose edit another guardrail already holds and which commonly carry a secret: `/etc/shadow`, `/etc/gshadow`, their `-` backups, `/etc/sudoers` and `/etc/sudoers.d/`; SSH host private keys (`/etc/ssh/ssh_host_*_key` and the legacy `/etc/ssh/ssh_host_key`); `/etc/ssl/private/` and `/etc/pki/tls/private/`; Kubernetes admin configs (`/etc/kubernetes/*.conf`) and private keys (`/etc/kubernetes/pki/**/*.key`); the k3s kubeconfig (`/etc/rancher/k3s/k3s.yaml`); a repository's `.git/config`, where a remote URL or extra header can carry a token; agent configuration that often holds API keys \u2014 `.mcp.json`, `.claude/settings.local.json`, `.claude.json`, `.cursor/mcp.json` and `.codex/config.toml`; and production configuration: a `.yml`, `.yaml`, `.json`, `.toml`, `.env`, `.ini`, `.conf`, `.properties`, `.tf` or `.tfvars` file named `*.prod.*`, `prod.*`, `*.production.*` or `production.*`, or under a `prod/` or `production/` folder, unless any folder in the path, an absolute path's leading folders included, is named exactly `node_modules`, `dist` or `vendor` (so `/srv/vendor/app/config/database.prod.yml` is not held). A Grep anywhere under `/etc`, including a search of the folder itself or with a wildcard, is held too; a Read of an `/etc` file not named here is not. Editing those files is held by the guardrail that owns the path, not by this one. NOT held on read by this guardrail: a shell command such as `cat`, on any agent (Codex has no read tool, so its reads are always shell commands); a file tool other than Read and Grep, such as Claude Code's Glob or another Cursor tool, which the guardrail that owns the path still holds under its own title, except on `.claude.json`, which no other guardrail names; `.claude/settings.json`, at project or user level; other secrets under `/etc` such as Kerberos keytabs and VPN or Wi-Fi connection files, which are held on Grep only; a Grep of a production folder with no file pattern, or with a pattern whose extension is a wildcard; production files of other types, such as `.key`, `.tfstate`, `.hcl`, `.cfg`, `.xml`, `.config` or Angular's `environment.prod.ts`; and production code or prose, such as `webpack.prod.js` or a runbook in `docs/production/`.",
|
|
2560
2615
|
match: {
|
|
2561
2616
|
any_of: [
|
|
2562
2617
|
{ kind: "execute_tool", file_glob: "**/.ssh/id_*" },
|
|
@@ -2568,7 +2623,63 @@ var seCredentialFile = {
|
|
|
2568
2623
|
{ kind: "execute_tool", file_glob: "**/.npmrc" },
|
|
2569
2624
|
{ kind: "execute_tool", file_glob: "**/.pypirc" },
|
|
2570
2625
|
{ kind: "execute_tool", file_glob: "**/.docker/config.json" },
|
|
2571
|
-
{ kind: "execute_tool", file_glob: "**/.kube/config" }
|
|
2626
|
+
{ kind: "execute_tool", file_glob: "**/.kube/config" },
|
|
2627
|
+
// Read only (see the header): system account and privilege files, host and TLS keys,
|
|
2628
|
+
// cluster admin configs and keys.
|
|
2629
|
+
{
|
|
2630
|
+
kind: "execute_tool",
|
|
2631
|
+
label: "{Read,Grep}",
|
|
2632
|
+
file_glob: "/etc/{shadow,shadow-,gshadow,gshadow-,sudoers}"
|
|
2633
|
+
},
|
|
2634
|
+
{ kind: "execute_tool", label: "{Read,Grep}", file_glob: "/etc/sudoers.d/**" },
|
|
2635
|
+
{ kind: "execute_tool", label: "{Read,Grep}", file_glob: "/etc/ssh/ssh_host_*_key" },
|
|
2636
|
+
{ kind: "execute_tool", label: "{Read,Grep}", file_glob: "/etc/ssh/ssh_host_key" },
|
|
2637
|
+
{ kind: "execute_tool", label: "{Read,Grep}", file_glob: "/etc/ssl/private/**" },
|
|
2638
|
+
{ kind: "execute_tool", label: "{Read,Grep}", file_glob: "/etc/pki/tls/private/**" },
|
|
2639
|
+
{ kind: "execute_tool", label: "{Read,Grep}", file_glob: "/etc/kubernetes/*.conf" },
|
|
2640
|
+
{ kind: "execute_tool", label: "{Read,Grep}", file_glob: "/etc/kubernetes/pki/**/*.key" },
|
|
2641
|
+
{ kind: "execute_tool", label: "{Read,Grep}", file_glob: "/etc/rancher/k3s/k3s.yaml" },
|
|
2642
|
+
// Grep only: a search anywhere under `/etc`, including the folder itself.
|
|
2643
|
+
{ kind: "execute_tool", label: "Grep", file_glob: "/etc/**" },
|
|
2644
|
+
// Read only: a remote URL or `http.extraheader` can carry a token.
|
|
2645
|
+
{ kind: "execute_tool", label: "{Read,Grep}", file_glob: "**/.git/config" },
|
|
2646
|
+
// Read only: MCP server definitions and agent settings often carry API keys in `env`.
|
|
2647
|
+
{ kind: "execute_tool", label: "{Read,Grep}", file_glob: "**/.mcp.json" },
|
|
2648
|
+
{ kind: "execute_tool", label: "{Read,Grep}", file_glob: "**/.claude/settings.local.json" },
|
|
2649
|
+
{ kind: "execute_tool", label: "{Read,Grep}", file_glob: "**/.claude.json" },
|
|
2650
|
+
{ kind: "execute_tool", label: "{Read,Grep}", file_glob: "**/.cursor/mcp.json" },
|
|
2651
|
+
{ kind: "execute_tool", label: "{Read,Grep}", file_glob: "**/.codex/config.toml" },
|
|
2652
|
+
// Read only: production configuration and secret files (see the header).
|
|
2653
|
+
{
|
|
2654
|
+
kind: "execute_tool",
|
|
2655
|
+
label: "{Read,Grep}",
|
|
2656
|
+
file_glob: `${NOT_VENDORED}*.prod.?(*.)${PROD_CONFIG}`
|
|
2657
|
+
},
|
|
2658
|
+
{
|
|
2659
|
+
kind: "execute_tool",
|
|
2660
|
+
label: "{Read,Grep}",
|
|
2661
|
+
file_glob: `${NOT_VENDORED}prod.?(*.)${PROD_CONFIG}`
|
|
2662
|
+
},
|
|
2663
|
+
{
|
|
2664
|
+
kind: "execute_tool",
|
|
2665
|
+
label: "{Read,Grep}",
|
|
2666
|
+
file_glob: `${NOT_VENDORED}*.production.?(*.)${PROD_CONFIG}`
|
|
2667
|
+
},
|
|
2668
|
+
{
|
|
2669
|
+
kind: "execute_tool",
|
|
2670
|
+
label: "{Read,Grep}",
|
|
2671
|
+
file_glob: `${NOT_VENDORED}production.?(*.)${PROD_CONFIG}`
|
|
2672
|
+
},
|
|
2673
|
+
{
|
|
2674
|
+
kind: "execute_tool",
|
|
2675
|
+
label: "{Read,Grep}",
|
|
2676
|
+
file_glob: `${NOT_VENDORED}prod/${NOT_VENDORED}*.${PROD_CONFIG}`
|
|
2677
|
+
},
|
|
2678
|
+
{
|
|
2679
|
+
kind: "execute_tool",
|
|
2680
|
+
label: "{Read,Grep}",
|
|
2681
|
+
file_glob: `${NOT_VENDORED}production/${NOT_VENDORED}*.${PROD_CONFIG}`
|
|
2682
|
+
}
|
|
2572
2683
|
],
|
|
2573
2684
|
none_of: [{ kind: "execute_tool", file_glob: "**/*.pub" }]
|
|
2574
2685
|
},
|
|
@@ -2577,13 +2688,154 @@ var seCredentialFile = {
|
|
|
2577
2688
|
file("/home/dev/.ssh/id_rsa", "Read"),
|
|
2578
2689
|
file("/Users/dev/.aws/credentials", "Read"),
|
|
2579
2690
|
file("certs/server.pem", "Read"),
|
|
2580
|
-
file(".npmrc", "Write")
|
|
2691
|
+
file(".npmrc", "Write"),
|
|
2692
|
+
// The other arms hold every tool, under a production or vendored path too: the
|
|
2693
|
+
// production arms' limits do not reach them.
|
|
2694
|
+
file("/home/prod/.ssh/id_rsa.txt", "Edit"),
|
|
2695
|
+
file("/home/prod/.ssh/id_rsa.txt", "Read"),
|
|
2696
|
+
file("/srv/production/.ssh/id_ed25519.md", "Write"),
|
|
2697
|
+
file("vendor/certs/server.pem", "Read"),
|
|
2698
|
+
// The original arms, each with a path only that arm matches.
|
|
2699
|
+
file("/home/dev/keys/id_rsa", "Read"),
|
|
2700
|
+
file("backup/id_ed25519", "Write"),
|
|
2701
|
+
file("certs/client.p12", "Read"),
|
|
2702
|
+
file("android/app/release.jks", "Edit"),
|
|
2703
|
+
file("/home/dev/.pypirc", "Read"),
|
|
2704
|
+
file("/home/dev/.docker/config.json", "Read"),
|
|
2705
|
+
file("/home/dev/.kube/config", "Grep"),
|
|
2706
|
+
// Each read-only arm, once through Read and once through Grep.
|
|
2707
|
+
file("/etc/shadow", "Read"),
|
|
2708
|
+
file("/etc/gshadow", "Grep"),
|
|
2709
|
+
file("/etc/sudoers", "Read"),
|
|
2710
|
+
file("/etc/shadow-", "Read"),
|
|
2711
|
+
file("/etc/gshadow-", "Read"),
|
|
2712
|
+
file("/etc/sudoers.d/90-cloud-init-users", "Read"),
|
|
2713
|
+
file("/etc/sudoers.d/admins", "Grep"),
|
|
2714
|
+
file("/etc/ssh/ssh_host_ed25519_key", "Read"),
|
|
2715
|
+
file("/etc/ssh/ssh_host_rsa_key", "Grep"),
|
|
2716
|
+
file("/etc/ssh/ssh_host_key", "Read"),
|
|
2717
|
+
file("/etc/ssh/ssh_host_key", "Grep"),
|
|
2718
|
+
file("/etc/ssl/private/server.key", "Read"),
|
|
2719
|
+
file("/etc/ssl/private/ca.key", "Grep"),
|
|
2720
|
+
file("/etc/pki/tls/private/server.key", "Read"),
|
|
2721
|
+
file("/etc/pki/tls/private/localhost.key", "Grep"),
|
|
2722
|
+
file("/etc/kubernetes/admin.conf", "Read"),
|
|
2723
|
+
file("/etc/kubernetes/controller-manager.conf", "Grep"),
|
|
2724
|
+
file("/etc/kubernetes/pki/ca.key", "Read"),
|
|
2725
|
+
file("/etc/kubernetes/pki/etcd/ca.key", "Grep"),
|
|
2726
|
+
file("/etc/rancher/k3s/k3s.yaml", "Read"),
|
|
2727
|
+
file("/etc/rancher/k3s/k3s.yaml", "Grep"),
|
|
2728
|
+
// The Grep-only arm: a folder, a wildcard joined to a folder, and the root of `/etc`.
|
|
2729
|
+
file("/etc", "Grep"),
|
|
2730
|
+
file("/etc/ssh", "Grep"),
|
|
2731
|
+
file("/etc/kubernetes", "Grep"),
|
|
2732
|
+
file("/etc/ssh/*_key", "Grep"),
|
|
2733
|
+
file("/etc/shadow*", "Grep"),
|
|
2734
|
+
file("/etc/hosts", "Grep"),
|
|
2735
|
+
file("/repo/.git/config", "Read"),
|
|
2736
|
+
file("/repo/.git/config", "Grep"),
|
|
2737
|
+
file(".mcp.json", "Read"),
|
|
2738
|
+
file(".mcp.json", "Grep"),
|
|
2739
|
+
file("/repo/.claude/settings.local.json", "Read"),
|
|
2740
|
+
file("/repo/.claude/settings.local.json", "Grep"),
|
|
2741
|
+
file("/Users/dev/.claude.json", "Read"),
|
|
2742
|
+
file("/Users/dev/.claude.json", "Grep"),
|
|
2743
|
+
file("/repo/.cursor/mcp.json", "Read"),
|
|
2744
|
+
file("/Users/dev/.cursor/mcp.json", "Grep"),
|
|
2745
|
+
file("/Users/dev/.codex/config.toml", "Read"),
|
|
2746
|
+
file("/Users/dev/.codex/config.toml", "Grep"),
|
|
2747
|
+
file("config/database.prod.yml", "Read"),
|
|
2748
|
+
file("docker-compose.prod.yml", "Grep"),
|
|
2749
|
+
file("config/prod.json", "Read"),
|
|
2750
|
+
file("config/prod.env", "Grep"),
|
|
2751
|
+
file("config/app.production.json", "Read"),
|
|
2752
|
+
file("config/app.production.toml", "Grep"),
|
|
2753
|
+
file("config/production.yaml", "Read"),
|
|
2754
|
+
file("config/production.env", "Grep"),
|
|
2755
|
+
file("deploy/prod/values.yaml", "Read"),
|
|
2756
|
+
file("infra/envs/prod/main.tfvars", "Grep"),
|
|
2757
|
+
file("deploy/prod/app.properties", "Read"),
|
|
2758
|
+
file("k8s/production/secrets.yaml", "Read"),
|
|
2759
|
+
file("k8s/production/configmap.yml", "Grep"),
|
|
2760
|
+
// Folders that only start with a skipped name are still held.
|
|
2761
|
+
file("distribution/prod.json", "Read"),
|
|
2762
|
+
file("vendors/config/production.yml", "Grep"),
|
|
2763
|
+
// One fixture per file type not used above.
|
|
2764
|
+
file("infra/prod/main.tf", "Read"),
|
|
2765
|
+
file("config/nginx.prod.conf", "Read"),
|
|
2766
|
+
file("config/app.prod.ini", "Grep")
|
|
2581
2767
|
],
|
|
2582
2768
|
allow: [
|
|
2583
2769
|
file("/home/dev/.ssh/id_rsa.pub", "Read"),
|
|
2584
2770
|
file("certs/server.crt", "Read"),
|
|
2585
2771
|
file("src/index.ts"),
|
|
2586
|
-
file("package.json")
|
|
2772
|
+
file("package.json"),
|
|
2773
|
+
// Near-misses of the read-only arms.
|
|
2774
|
+
file("/etc/passwd", "Read"),
|
|
2775
|
+
file("/etc/passwd-", "Read"),
|
|
2776
|
+
file("/etc/group", "Read"),
|
|
2777
|
+
file("/etc/hosts", "Read"),
|
|
2778
|
+
file("/etc/sudo.conf", "Read"),
|
|
2779
|
+
file("/etc/ssh/ssh_host_ed25519_key.pub", "Read"),
|
|
2780
|
+
file("/etc/ssh/ssh_host_key.pub", "Read"),
|
|
2781
|
+
file("/etc/ssh/sshd_config", "Read"),
|
|
2782
|
+
file("/etc/ssl/certs/ca-certificates.crt", "Read"),
|
|
2783
|
+
file("/etc/pki/tls/certs/server.crt", "Read"),
|
|
2784
|
+
file("/etc/kubernetes/manifests/kube-apiserver.yaml", "Read"),
|
|
2785
|
+
file("/etc/kubernetes/pki/ca.crt", "Read"),
|
|
2786
|
+
file("/etc/rancher/k3s/config.yaml", "Read"),
|
|
2787
|
+
file("/opt/etc/app.conf", "Grep"),
|
|
2788
|
+
file("/repo/.git/HEAD", "Read"),
|
|
2789
|
+
file("/repo/.gitconfig.example", "Read"),
|
|
2790
|
+
file("mcp.json.example", "Read"),
|
|
2791
|
+
file("/repo/.claude/settings.json", "Read"),
|
|
2792
|
+
file("/repo/claude.json", "Read"),
|
|
2793
|
+
file("/repo/.cursor/rules/style.mdc", "Read"),
|
|
2794
|
+
file("/repo/codex/config.toml", "Read"),
|
|
2795
|
+
file("config/database.staging.yml", "Read"),
|
|
2796
|
+
// Production code, prose and vendored files are not production configuration.
|
|
2797
|
+
file("node_modules/react/cjs/react.production.min.js", "Read"),
|
|
2798
|
+
file("node_modules/react-router/dist/production/index.d.ts", "Grep"),
|
|
2799
|
+
// One vendored configuration file per production arm.
|
|
2800
|
+
file("node_modules/some-lib/config/app.prod.json", "Read"),
|
|
2801
|
+
file("dist/prod.json", "Read"),
|
|
2802
|
+
file("node_modules/some-lib/config/app.production.json", "Grep"),
|
|
2803
|
+
file("vendor/config/production.yml", "Read"),
|
|
2804
|
+
file("dist/prod/app.json", "Read"),
|
|
2805
|
+
file("vendor/production/config.yml", "Grep"),
|
|
2806
|
+
file("src/Settings.prod.test.tsx", "Read"),
|
|
2807
|
+
file("infra/bin/prod.ts", "Read"),
|
|
2808
|
+
file("webpack.prod.js", "Grep"),
|
|
2809
|
+
file("config/database.prod.md", "Read"),
|
|
2810
|
+
file("config/prod.md", "Read"),
|
|
2811
|
+
file("config/app.production.mdx", "Read"),
|
|
2812
|
+
file("config/production.txt", "Read"),
|
|
2813
|
+
file("deploy/prod/RUNBOOK.txt", "Grep"),
|
|
2814
|
+
file("docs/production/README.md", "Read"),
|
|
2815
|
+
// The read-only arms do not hold an edit: the guardrail that owns each path does.
|
|
2816
|
+
file("/etc/shadow", "Edit"),
|
|
2817
|
+
file("/etc/shadow-", "Write"),
|
|
2818
|
+
file("/etc/sudoers.d/admins", "Write"),
|
|
2819
|
+
file("/etc/ssh/ssh_host_ed25519_key", "Write"),
|
|
2820
|
+
file("/etc/ssh/ssh_host_key", "Edit"),
|
|
2821
|
+
file("/etc/ssl/private/server.key", "Edit"),
|
|
2822
|
+
file("/etc/pki/tls/private/server.key", "Write"),
|
|
2823
|
+
file("/etc/kubernetes/admin.conf", "Write"),
|
|
2824
|
+
file("/etc/kubernetes/pki/sa.key", "Write"),
|
|
2825
|
+
file("/etc/rancher/k3s/k3s.yaml", "Edit"),
|
|
2826
|
+
file("/etc/hosts", "Edit"),
|
|
2827
|
+
file("/repo/.git/config", "Edit"),
|
|
2828
|
+
file(".mcp.json", "Edit"),
|
|
2829
|
+
file("/repo/.claude/settings.local.json", "Write"),
|
|
2830
|
+
file("/Users/dev/.claude.json", "Write"),
|
|
2831
|
+
file("/repo/.cursor/mcp.json", "Edit"),
|
|
2832
|
+
file("/Users/dev/.codex/config.toml", "Edit"),
|
|
2833
|
+
file("config/database.prod.yml", "Edit"),
|
|
2834
|
+
file("config/prod.json", "Write"),
|
|
2835
|
+
file("config/app.production.json", "Edit"),
|
|
2836
|
+
file("config/production.yaml", "Write"),
|
|
2837
|
+
file("deploy/prod/values.yaml", "Edit"),
|
|
2838
|
+
file("k8s/production/secrets.yaml", "Write")
|
|
2587
2839
|
]
|
|
2588
2840
|
}
|
|
2589
2841
|
};
|
|
@@ -2594,6 +2846,7 @@ var seEnvPrint = {
|
|
|
2594
2846
|
category: "secret-exposure",
|
|
2595
2847
|
severity: "medium",
|
|
2596
2848
|
defaultAction: "warn",
|
|
2849
|
+
owasp: ["ASI02", "ASI03", "LLM02"],
|
|
2597
2850
|
title: "Printing the environment or a dotenv file",
|
|
2598
2851
|
description: 'Surfaces the environment or a dotenv file being printed into the terminal, where it lands in scrollback and in the session transcript. Committed placeholder files are excluded (`.env.example`, `.env.sample`, `.env.template`). Does NOT match the POSIX `env VAR=value <command>` form, which sets a variable rather than printing one, and does NOT match a `.env` opened by a file tool \u2014 that travels the file channel and is covered by block-env-file-read. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
2599
2852
|
match: {
|
|
@@ -2643,6 +2896,7 @@ var sePublicAcl = {
|
|
|
2643
2896
|
category: "secret-exposure",
|
|
2644
2897
|
severity: "high",
|
|
2645
2898
|
defaultAction: "require_approval",
|
|
2899
|
+
owasp: ["ASI02", "ASI03", "LLM02"],
|
|
2646
2900
|
title: "Making cloud storage publicly readable",
|
|
2647
2901
|
description: 'Holds a command that opens object storage to the public \u2014 an S3 `--acl public-read`, a GCS binding to allUsers, an Azure container set to blob or container access, or turning off S3 public-access blocking. The private spellings of the same commands are deliberately NOT matched. It reads the command\'s own words, so a bucket made public through a console, a Terraform apply, or a bucket policy JSON file is invisible to it. Global flags between a storage CLI and its subcommand are tolerated (`aws --profile <p> s3api \u2026`, `gcloud --project=<p> storage \u2026`), and an absolute tool path still matches; a flag that itself runs a program is not read. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
2648
2902
|
match: {
|
|
@@ -2686,8 +2940,9 @@ var seSecretEgress = {
|
|
|
2686
2940
|
category: "secret-exposure",
|
|
2687
2941
|
severity: "high",
|
|
2688
2942
|
defaultAction: "require_approval",
|
|
2943
|
+
owasp: ["ASI02", "ASI03", "LLM02"],
|
|
2689
2944
|
title: "Sending a credential file off the machine",
|
|
2690
|
-
description: 'Holds a command that both names a credential-shaped file (.env, .pem, id_rsa, a credentials file) and hands it to a transport (curl, wget, nc, scp, rsync) in the same pipeline segment. Either half alone is ordinary, which is why both are required. It cannot read the file, so it judges by the PATH: a secret copied into a differently-named file first, or sent by application code, is invisible to it. It also does not cover an upload through a browser or an SDK. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt. `curl --data` is NOT one of those carriers here: POSTing the quoted text off the box is precisely the harm this
|
|
2945
|
+
description: 'Holds a command that both names a credential-shaped file (.env, .pem, id_rsa, a credentials file) and hands it to a transport (curl, wget, nc, scp, rsync) in the same pipeline segment. Either half alone is ordinary, which is why both are required. It cannot read the file, so it judges by the PATH: a secret copied into a differently-named file first, or sent by application code, is invisible to it. It also does not cover an upload through a browser or an SDK. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt. `curl --data` is NOT one of those carriers here: POSTing the quoted text off the box is precisely the harm this exists to catch.',
|
|
2691
2946
|
match: {
|
|
2692
2947
|
any_of: [
|
|
2693
2948
|
{
|
|
@@ -2726,6 +2981,7 @@ var seSecretManagerRead = {
|
|
|
2726
2981
|
category: "secret-exposure",
|
|
2727
2982
|
severity: "medium",
|
|
2728
2983
|
defaultAction: "warn",
|
|
2984
|
+
owasp: ["ASI02", "ASI03", "LLM02"],
|
|
2729
2985
|
title: "Reading a secret out of a secrets manager",
|
|
2730
2986
|
description: 'Surfaces a secret being read from AWS Secrets Manager or SSM, HashiCorp Vault, Google Secret Manager, Azure Key Vault, a Kubernetes secret dumped as yaml or json, or Doppler. Non-blocking: this is a normal step in a normal day, and the value is that it is visible afterwards. The listing commands are deliberately NOT matched (`list-secrets`, `vault status`, `kubectl get secrets` without an output flag). It does NOT see a secret read by application code, by an SDK, or from an environment variable already in the process. Global flags between a secrets CLI and its subcommand are tolerated (`aws --profile <p> secretsmanager \u2026`, `kubectl -n <ns> get secret \u2026`, `--region <r>`), and an absolute tool path still matches; a flag that itself runs a program is not read. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
2731
2987
|
match: {
|
|
@@ -2771,8 +3027,9 @@ var seTokenPrint = {
|
|
|
2771
3027
|
category: "secret-exposure",
|
|
2772
3028
|
severity: "medium",
|
|
2773
3029
|
defaultAction: "warn",
|
|
3030
|
+
owasp: ["ASI02", "ASI03", "LLM02"],
|
|
2774
3031
|
title: "Printing an access token into the terminal",
|
|
2775
|
-
description: 'Surfaces a command that prints a live credential \u2014 `gh auth token`, `npm token list`, an `echo` of a token-shaped variable, a `docker login` with the password on the command line, or a `.netrc` dump. Non-blocking, because seeing your own token is sometimes exactly what you need. The status siblings are deliberately NOT matched (`gh auth status`, `npm whoami`). It cannot tell whether the output is redirected, and it does NOT match a variable whose name does not contain token, secret, key or password. Global flags between `npm`/`docker` and the subcommand are tolerated (`npm --silent token list`, `docker --context <name> login \u2026`), and an absolute tool path still matches; `gh` has no global flag before its subcommand, and a flag that itself runs a program is not read. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt. `echo` is NOT one of those carriers here, because
|
|
3032
|
+
description: 'Surfaces a command that prints a live credential \u2014 `gh auth token`, `npm token list`, an `echo` of a token-shaped variable, a `docker login` with the password on the command line, or a `.netrc` dump. Non-blocking, because seeing your own token is sometimes exactly what you need. The status siblings are deliberately NOT matched (`gh auth status`, `npm whoami`). It cannot tell whether the output is redirected, and it does NOT match a variable whose name does not contain token, secret, key or password. Global flags between `npm`/`docker` and the subcommand are tolerated (`npm --silent token list`, `docker --context <name> login \u2026`), and an absolute tool path still matches; `gh` has no global flag before its subcommand, and a flag that itself runs a program is not read. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt. `echo` is NOT one of those carriers here, because the trigger here IS an `echo`: printing a quoted `$TOKEN` still warns.',
|
|
2776
3033
|
match: {
|
|
2777
3034
|
any_of: [
|
|
2778
3035
|
{
|
|
@@ -2816,6 +3073,7 @@ var warnOpReadSecret = {
|
|
|
2816
3073
|
category: "secret-exposure",
|
|
2817
3074
|
severity: "info",
|
|
2818
3075
|
defaultAction: "warn",
|
|
3076
|
+
owasp: ["ASI02", "ASI03", "LLM02"],
|
|
2819
3077
|
title: "Flag `op read` secret access",
|
|
2820
3078
|
description: 'Surfaces a secret read through the 1Password CLI (op read, op item get, op document get, op inject) so secret access gets a second look without breaking routine dev flow. Severity is `info` rather than `low` deliberately: it is warn-only over one narrow path, and `low` would overstate it. The words are matched on WORD BOUNDARIES, so a commit message containing `stop reading from cache` no longer trips it. MISSES secrets read via another CLI (aws, vault, gcloud \u2014 see se.secret-manager-read), a .env opened by a file tool, and an `op` wrapper script whose own text does not name the subcommand. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
2821
3079
|
match: {
|
|
@@ -2865,6 +3123,7 @@ var tiCiSkipMarker = {
|
|
|
2865
3123
|
category: "test-integrity",
|
|
2866
3124
|
severity: "medium",
|
|
2867
3125
|
defaultAction: "warn",
|
|
3126
|
+
owasp: ["ASI09"],
|
|
2868
3127
|
title: "Telling CI to skip a commit or push",
|
|
2869
3128
|
description: "Warns on a commit or push that tells CI not to run: a `git commit` whose message carries `[skip ci]`, `[ci skip]`, `[no ci]`, `[skip actions]`, `[actions skip]`, Azure Pipelines' `[skip azp]` family or `***NO_CI***`, or a `skip-checks: true` trailer, and `git push -o ci.skip` / `--push-option=ci.skip`. GitHub Actions, GitLab, Azure Pipelines, CircleCI and Bitbucket each honour some of these, in any letter case, so the change lands with no check run against it. Deliberately NOT matched: `skip-checks: false`, near misses such as `[ci-skip]` or `[skip deploy]`, other push options, and a commit message that only names `git push -o ci.skip`. Misses a message read from a file (`git commit -F msg.txt`), a marker added when a pull request is merged on the hosting site, and a push option set in git config. A global flag between `git` and `commit`/`push` is tolerated (`git -C <dir> commit \u2026`, `--no-pager`, `-c k=v`), and an absolute tool path such as `/usr/bin/git` still matches; a flag that itself runs a program is not read. A quoted MENTION is not a use: a search, an `echo` or a `curl --data` body that only names this command is left alone, as long as every shell metacharacter stays inside the quotes. `git commit` is NOT one of those carriers here: the marker is read from the commit message, so a message that quotes `[skip ci]` does skip CI and still warns.",
|
|
2870
3129
|
match: {
|
|
@@ -2924,6 +3183,7 @@ var tiCoverageBypass = {
|
|
|
2924
3183
|
category: "test-integrity",
|
|
2925
3184
|
severity: "medium",
|
|
2926
3185
|
defaultAction: "warn",
|
|
3186
|
+
owasp: ["ASI09"],
|
|
2927
3187
|
title: "Passing a test run with no tests or no coverage gate",
|
|
2928
3188
|
description: "Warns on a test run told to pass with nothing to check, or with its coverage gate off: `--passWithNoTests` (Jest, Vitest), pytest-cov's `--no-cov` and `--cov-fail-under=0`, `--coverage=false`, `--collectCoverage=false`, `--coverage.enabled=false` and `--no-coverage`, nyc's and c8's `--check-coverage=false` and `--no-check-coverage`, and a Vitest coverage threshold set to 0 on the command line. Each turns a check that would fail into one that reports success. A warning, not a hold: running without coverage locally is common. Deliberately NOT matched: `--no-cov-on-fail`, `--check-coverage` on its own, which makes the gate stricter, and a non-zero threshold. Misses a threshold lowered to any other number, a gate switched off in a config file (`ti.test-config-edit` holds the dedicated ones), and a coverage step removed from a CI workflow (`fs.ci-definition` holds those files). A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m \"x\" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.",
|
|
2929
3189
|
match: {
|
|
@@ -2990,6 +3250,7 @@ var tiInlineSuppressBulk = {
|
|
|
2990
3250
|
category: "test-integrity",
|
|
2991
3251
|
severity: "medium",
|
|
2992
3252
|
defaultAction: "warn",
|
|
3253
|
+
owasp: ["ASI09"],
|
|
2993
3254
|
title: "Inserting suppressions or test skips with sed or perl",
|
|
2994
3255
|
description: "Warns on an in-place `sed` or `perl` edit whose script contains a suppression or skip marker: `@ts-ignore`, `@ts-expect-error`, `@ts-nocheck`, `eslint-disable`, `# type: ignore`, `# noqa`, `# pragma: no cover`, `it.skip` / `test.skip` / `describe.skip`, `xit` / `xdescribe` / `xtest`, `@pytest.mark.skip`, Rust's `#[ignore]` and Go's `t.Skip`. One such command can silence a type error, a lint rule or a failing test across many files at once. It matches the in-place flag (`-i`, `-i.bak`, `-Ei`, `--in-place`, `perl -pi`) followed by a script naming a marker. It cannot parse the script, so it does not tell a replacement that inserts a marker from one that removes it, except the `/\u2026/d` delete-line form, which is deliberately NOT matched; neither are `sed -n` and `perl -ne`, which only print. Misses a marker added with a file tool \u2014 the Edit tool carries no content \u2014 an in-place flag written after the script, and a marker assembled from pieces. Over-matches `perl -I<dir>`, which the case-insensitive match reads as `-i`. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m \"x\" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.",
|
|
2995
3256
|
match: {
|
|
@@ -3040,6 +3301,7 @@ var tiSnapshotBlanketUpdate = {
|
|
|
3040
3301
|
category: "test-integrity",
|
|
3041
3302
|
severity: "medium",
|
|
3042
3303
|
defaultAction: "warn",
|
|
3304
|
+
owasp: ["ASI09"],
|
|
3043
3305
|
title: "Overwriting every stored snapshot with current output",
|
|
3044
3306
|
description: "Warns on a test run told to overwrite stored snapshots with whatever the code produces now: Jest's `-u` / `--updateSnapshot`, Vitest's `-u` / `--update`, Playwright's and Bun's `--update-snapshots`, the same flags passed through `npm test`, `pnpm test` or `yarn test`, pytest's `--snapshot-update` (syrupy and pytest-snapshot), `cargo insta accept`, `cargo insta test --accept`, and `INSTA_UPDATE=always`. A snapshot that no longer matches is a failing test, and accepting every difference at once makes it pass without anyone reading the diff. A warning, not a hold: regenerating snapshots after an intended change is ordinary work. Deliberately NOT matched: writing only NEW snapshots (`--update=new`, `--update-snapshots=missing`, `--snapshot-update-new-only`, `INSTA_UPDATE=new`), `cargo insta review`, and Jest's `--ci`. Misses a runner started through any other script name or wrapper, and snapshot files rewritten with a file tool. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m \"x\" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.",
|
|
3045
3307
|
match: {
|
|
@@ -3100,6 +3362,7 @@ var tiTestConfigEdit = {
|
|
|
3100
3362
|
category: "test-integrity",
|
|
3101
3363
|
severity: "medium",
|
|
3102
3364
|
defaultAction: "require_approval",
|
|
3365
|
+
owasp: ["ASI09", "ASI10"],
|
|
3103
3366
|
title: "Editing a test runner or coverage configuration",
|
|
3104
3367
|
description: "Holds a file tool opening a test runner's or coverage tool's own configuration: Jest's `jest.config.*`, Vitest's `vitest.config.*` and legacy `vitest.workspace.*`, `pytest.ini`, `pytest.toml` and their dotted forms, `tox.ini`, Mocha's `.mocharc.*`, PHPUnit's `phpunit.xml`, `phpunit.xml.dist` and `phpunit.dist.xml`, `codecov.yml`, nyc's `.nycrc*` and `nyc.config.*`, `.c8rc`, coverage.py's `.coveragerc`, `karma.conf.*`, and the Playwright and Cypress configs. One line in any of these can exclude a failing file, lower a coverage threshold or retry a flaky test until it passes. Reading is excluded \u2014 the `Read` and `Grep` tools never match \u2014 so opening one of these configs to read it is not held; every other file tool is, including one this corpus does not know. File tools carry a path and no content, so it still cannot tell a harmless edit from a weakening one. Deliberately NOT matched: general files that can also hold test settings \u2014 `pyproject.toml`, `setup.cfg`, `package.json`, `vite.config.*` \u2014 and test files themselves, since editing a test is how a test gets fixed. Misses test settings kept in those general files, and a config at a path passed with `--config`.",
|
|
3105
3368
|
match: {
|
|
@@ -3178,6 +3441,7 @@ var tiTestFileDelete = {
|
|
|
3178
3441
|
category: "test-integrity",
|
|
3179
3442
|
severity: "high",
|
|
3180
3443
|
defaultAction: "require_approval",
|
|
3444
|
+
owasp: ["ASI09", "ASI10"],
|
|
3181
3445
|
title: "Deleting a test file or test directory",
|
|
3182
3446
|
description: "Holds a command that deletes a test: `rm`, `unlink`, `git rm` or PowerShell's `Remove-Item` naming a file that follows a test runner's naming convention \u2014 `*.test.*`, `*.spec.*`, `*_test.go`, `*_test.py`, `test_*.py` \u2014 or a `__tests__/`, `test/`, `tests/` or `spec/` directory, or a file inside one. Deleting the failing test instead of fixing the code leaves a suite that still passes. Deliberately NOT matched: build, report and dependency output \u2014 anything under `dist/`, `build/`, `out/`, `coverage/` or `node_modules/`, and `test-results/`, `playwright-report/` and `.pytest_cache` \u2014 and moving or staging a test (`mv`, `git add`). Misses a test deleted with `find \u2026 -delete`, moved out of the tree, emptied or disabled with a file tool, and a test directory with any other name. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m \"x\" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.",
|
|
3183
3447
|
match: {
|
|
@@ -3241,6 +3505,7 @@ var blockForcePush = {
|
|
|
3241
3505
|
category: "working-tree",
|
|
3242
3506
|
severity: "high",
|
|
3243
3507
|
defaultAction: "block",
|
|
3508
|
+
owasp: ["ASI02", "LLM03"],
|
|
3244
3509
|
title: "Block git force-push",
|
|
3245
3510
|
description: 'Overwrites a remote branch\'s history, destroying commits other people may already have pulled. The command must contain `git push` and the force flag must sit in the same pipeline segment, so searching for the phrase is not blocked. A global flag between `git` and `push` is tolerated (`git -C <dir> push --force`, `git --no-pager push \u2026`), and an absolute tool path such as `/usr/bin/git` still matches. The safer `--force-with-lease` form IS still blocked; exempting it needs a negative lookahead this corpus does not use. MISSES an alias such as `git pf`, and a force-push issued by a wrapper script whose own text does not say `git push`. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
3246
3511
|
match: {
|
|
@@ -3281,8 +3546,9 @@ var requireApprovalRmRf = {
|
|
|
3281
3546
|
category: "working-tree",
|
|
3282
3547
|
severity: "high",
|
|
3283
3548
|
defaultAction: "require_approval",
|
|
3549
|
+
owasp: ["ASI02", "LLM03"],
|
|
3284
3550
|
title: "Hold `rm -rf` for approval",
|
|
3285
|
-
description: 'Recursive-force delete: held for approval rather than blocked, which is the honest strength for an operation that is destructive but often legitimate. Catches -rf, -Rf, -rvf and the reversed -fr spelling in any case, `rm --recursive`, and PowerShell\'s `Remove-Item -Recurse`. Clearing a build directory is EXEMPT (node_modules, dist, build, out, coverage, target, .next, .turbo, .cache, .vite, .parcel-cache): that shape appears about 220 times in real Claude Code traces against about 3 for a dangerous delete, and a
|
|
3551
|
+
description: 'Recursive-force delete: held for approval rather than blocked, which is the honest strength for an operation that is destructive but often legitimate. Catches -rf, -Rf, -rvf and the reversed -fr spelling in any case, `rm --recursive`, and PowerShell\'s `Remove-Item -Recurse`. Clearing a build directory is EXEMPT (node_modules, dist, build, out, coverage, target, .next, .turbo, .cache, .vite, .parcel-cache): that shape appears about 220 times in real Claude Code traces against about 3 for a dangerous delete, and a check that asks every time is one people switch off. An absolute path, a $VARIABLE, a ~ path or a source directory still asks. Does NOT match a delete via a file tool, or flags split across arguments such as `rm -r -f x`. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
3286
3552
|
match: {
|
|
3287
3553
|
any_of: [
|
|
3288
3554
|
{
|
|
@@ -3332,8 +3598,9 @@ var wtBranchForceDelete = {
|
|
|
3332
3598
|
category: "working-tree",
|
|
3333
3599
|
severity: "medium",
|
|
3334
3600
|
defaultAction: "require_approval",
|
|
3601
|
+
owasp: ["ASI02", "LLM03"],
|
|
3335
3602
|
title: "git branch -D force-deletes an unmerged branch",
|
|
3336
|
-
description: 'Deletes a branch even when its commits are not merged anywhere, so the work becomes unreachable. This
|
|
3603
|
+
description: 'Deletes a branch even when its commits are not merged anywhere, so the work becomes unreachable. This match is CASE-SENSITIVE on purpose, which is why it uses detail_contains: `-D` force-deletes while `-d` refuses to delete unmerged work, and the engine\'s regex matcher is case-insensitive, so a regex here would fire on the safe spelling every time a developer cleans up after a merge. Known miss: the flags written separately as `--delete --force` in the reverse order, and any alias. The `git branch` anchor tolerates repeated or tab whitespace and a global flag in between (`git branch -D \u2026`, `git -C <dir> branch -D \u2026`), and an absolute tool path such as `/usr/bin/git` still matches, while `-D` stays a case-sensitive substring so the safe `-d` is not caught. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
3337
3604
|
match: {
|
|
3338
3605
|
any_of: [
|
|
3339
3606
|
{
|
|
@@ -3376,6 +3643,7 @@ var wtCheckoutDiscard = {
|
|
|
3376
3643
|
category: "working-tree",
|
|
3377
3644
|
severity: "high",
|
|
3378
3645
|
defaultAction: "block",
|
|
3646
|
+
owasp: ["ASI02", "LLM03"],
|
|
3379
3647
|
title: "git checkout used to discard working-tree changes",
|
|
3380
3648
|
description: 'Overwrites files in the working tree from the index or from another commit, discarding uncommitted edits. Matches the discard spellings only \u2014 `git checkout -- <path>`, a bare `git checkout .`, and the `-f`/`--force` forms. It deliberately does NOT match an ordinary branch switch (`git checkout main`, `git checkout -b feature/x`), which is the same command doing something else entirely. It also MISSES `git checkout <commit> <path>` written without the `--` separator. Global flags between `git` and `checkout` are tolerated (`git -C <dir> checkout -- .`, `--no-pager`, `-c k=v`), and an absolute tool path such as `/usr/bin/git` still matches; a flag that itself runs a program is not read. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
3381
3649
|
match: {
|
|
@@ -3418,6 +3686,7 @@ var wtCleanFdx = {
|
|
|
3418
3686
|
category: "working-tree",
|
|
3419
3687
|
severity: "high",
|
|
3420
3688
|
defaultAction: "block",
|
|
3689
|
+
owasp: ["ASI02", "LLM03"],
|
|
3421
3690
|
title: "git clean -fd deletes untracked files",
|
|
3422
3691
|
description: 'Deletes untracked files and directories, and with `-x` the git-ignored ones too \u2014 which on a working checkout means local `.env` files, certificates and scratch work that exist nowhere else. Git holds no copy of any of it. The dry-run forms (`git clean -nd`, `--dry-run`) are deliberately NOT matched, since that is what a careful person runs first. Known miss: `git clean` driven from a wrapper script whose own text does not name it. Global flags between `git` and `clean` are tolerated on both the block and the dry-run exemption (`git -C <dir> clean -fd`, `--no-pager`, `-c k=v`), and an absolute tool path such as `/usr/bin/git` still matches; a flag that itself runs a program is not read. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
3423
3692
|
match: {
|
|
@@ -3467,6 +3736,7 @@ var wtResetHard = {
|
|
|
3467
3736
|
category: "working-tree",
|
|
3468
3737
|
severity: "high",
|
|
3469
3738
|
defaultAction: "block",
|
|
3739
|
+
owasp: ["ASI02", "LLM03"],
|
|
3470
3740
|
title: "git reset --hard discards uncommitted work",
|
|
3471
3741
|
description: 'Discards every uncommitted change in the working tree, irrecoverably \u2014 there is no reflog for work that was never committed. Does NOT match `git restore` (see wt.restore-path), `git checkout -- .` (see wt.checkout-discard), or a reset spelled `--hard=...`; and it cannot tell a scratch clone from your only copy of the work, so a deliberate reset in a throwaway checkout is blocked too. A global flag between `git` and `reset` is tolerated (`git -C <dir> reset --hard`, `git --no-pager \u2026`, `git -c k=v \u2026`), and an absolute tool path such as `/usr/bin/git` still matches; a flag that itself runs a program is not read. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
3472
3742
|
match: {
|
|
@@ -3508,6 +3778,7 @@ var wtResetMerge = {
|
|
|
3508
3778
|
category: "working-tree",
|
|
3509
3779
|
severity: "medium",
|
|
3510
3780
|
defaultAction: "require_approval",
|
|
3781
|
+
owasp: ["ASI02", "LLM03"],
|
|
3511
3782
|
title: "git reset --merge / --keep can discard local changes",
|
|
3512
3783
|
description: 'Resets with `--merge` or `--keep`, both of which can silently drop uncommitted changes to files that differ between HEAD and the target commit. They read as the cautious options, which is why they are worth a prompt rather than a block. Does NOT match `git reset --soft` or a bare `git reset`, neither of which touches the working tree, and it does not cover `git merge --abort`. Global flags between `git` and `reset` are tolerated (`git -C <dir> reset --merge`, `--no-pager`, `-c k=v`), and an absolute tool path such as `/usr/bin/git` still matches; a flag that itself runs a program is not read. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
3513
3784
|
match: {
|
|
@@ -3547,6 +3818,7 @@ var wtRestorePath = {
|
|
|
3547
3818
|
category: "working-tree",
|
|
3548
3819
|
severity: "high",
|
|
3549
3820
|
defaultAction: "block",
|
|
3821
|
+
owasp: ["ASI02", "LLM03"],
|
|
3550
3822
|
title: "git restore discards uncommitted changes to a path",
|
|
3551
3823
|
description: 'Overwrites files in the working tree from the index, discarding uncommitted edits to them. `git restore --staged` is deliberately NOT matched: it only unstages, and the file on disk is untouched. The cost of that exclusion is a known miss \u2014 `git restore --staged --worktree <path>` DOES discard and is exempted here, because expressing the distinction needs a negative lookahead this corpus does not use. Global flags between `git` and `restore` are tolerated on both the block and the `--staged` exemption (`git -C <dir> restore .`, `--no-pager`, `-c k=v`), and an absolute tool path such as `/usr/bin/git` still matches; a flag that itself runs a program is not read. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
3552
3824
|
match: {
|
|
@@ -3590,6 +3862,7 @@ var wtStashDrop = {
|
|
|
3590
3862
|
category: "working-tree",
|
|
3591
3863
|
severity: "medium",
|
|
3592
3864
|
defaultAction: "require_approval",
|
|
3865
|
+
owasp: ["ASI02", "LLM03"],
|
|
3593
3866
|
title: "git stash drop / clear deletes stashed work",
|
|
3594
3867
|
description: 'Deletes stashed work, which has no undo \u2014 the stash commit becomes unreachable and there is no `git stash undrop`. Held for approval rather than blocked, because clearing an old stash is a normal deliberate act. Does NOT match `git stash pop` (which applies and then drops, and whose failure mode is a conflict rather than a loss) or `git stash push`. Global flags between `git` and `stash` are tolerated (`git -C <dir> stash drop`, `--no-pager`, `-c k=v`), and an absolute tool path such as `/usr/bin/git` still matches; a flag that itself runs a program is not read. A quoted MENTION is not a use: a search, a `git commit -m` message, an `echo` or a `curl --data` body that only names this command is left alone. That holds only while every shell metacharacter stays inside the quotes, so `git commit -m "x" && \u2026` is still caught; and the carrier must be the first word, so `sudo grep \u2026` is not exempt.',
|
|
3595
3868
|
match: {
|
|
@@ -3651,8 +3924,8 @@ function isPack(value) {
|
|
|
3651
3924
|
}
|
|
3652
3925
|
|
|
3653
3926
|
// src/stamp.ts
|
|
3654
|
-
var CATALOG_VERSION = "0.2.
|
|
3655
|
-
var CATALOG_PUBLISHED_AT = "2026-10-
|
|
3927
|
+
var CATALOG_VERSION = "0.2.5";
|
|
3928
|
+
var CATALOG_PUBLISHED_AT = "2026-10-22T11:20:35Z";
|
|
3656
3929
|
|
|
3657
3930
|
// src/rules.ts
|
|
3658
3931
|
var RULES_BY_PACK = {
|
|
@@ -3702,4 +3975,4 @@ export {
|
|
|
3702
3975
|
getRule,
|
|
3703
3976
|
rulesForPack
|
|
3704
3977
|
};
|
|
3705
|
-
//# sourceMappingURL=chunk-
|
|
3978
|
+
//# sourceMappingURL=chunk-SLJLCAZK.js.map
|