Skip to content

docs(#3229): add scripts/ directory threat model guidance to AGENTS.md - #3230

Open
fullsend-ai-coder[bot] wants to merge 1 commit into
mainfrom
agent/3229-scripts-threat-model
Open

docs(#3229): add scripts/ directory threat model guidance to AGENTS.md#3230
fullsend-ai-coder[bot] wants to merge 1 commit into
mainfrom
agent/3229-scripts-threat-model

Conversation

@fullsend-ai-coder

Copy link
Copy Markdown
Contributor

Add a new "Scripts Directory" section to AGENTS.md documenting the deployment context, threat model, and review calibration guidance for the repo-root scripts/ directory. This addresses repeated false-positive security findings (path injection, command injection, TOCTOU races) on local-only developer CLI tools and CI pipeline scripts that were evaluated against server-side heuristics.

The new section covers:


Closes #3229

Post-script verification

  • Branch is not main/master (agent/3229-scripts-threat-model)
  • Secret scan passed (gitleaks — e5bd585038a454243dd2a1fe17b4a0d7b42b7b5f..HEAD)
  • Pre-commit hooks passed (authoritative run on runner)
  • Tests ran inside sandbox

Add a new "Scripts Directory" section to AGENTS.md documenting
the deployment context, threat model, and review calibration
guidance for the repo-root scripts/ directory. This addresses
repeated false-positive security findings (path injection,
command injection, TOCTOU races) on local-only developer CLI
tools and CI pipeline scripts that were evaluated against
server-side heuristics.

The new section covers:
- Purpose: scripts/ contains developer-facing CLI tools and CI
  pipeline scripts, not deployed application code
- Threat model: all scripts run locally by engineers or in
  trusted CI; operators are trusted users providing intentional
  input
- Contents: categorized table of build infrastructure, coverage
  tooling, developer CLI tools, and CI helpers
- Review calibration: which security findings to downgrade
  (path/command injection, TOCTOU on local tools) vs. which
  remain relevant (correctness, data integrity, CI reliability,
  actual secret exposure)
- Cross-references to complementary open issues #3182
  (upstream/midstream architecture) and #2893 (build
  infrastructure review priorities)

Closes #3229
@fullsend-ai-coder
fullsend-ai-coder Bot requested review from a team, gashcrumb and kadel as code owners August 10, 2026 19:13
@openshift-ci

openshift-ci Bot commented Aug 10, 2026

Copy link
Copy Markdown

Hi @fullsend-ai-coder[bot]. Thanks for your PR.

I'm waiting for a redhat-developer member to verify that this patch is reasonable to test. If it is, they should reply with /ok-to-test on its own line. Until that is done, I will not automatically test new commits in this PR, but the usual testing commands by org members will still work.

Regular contributors should join the org to skip this step.

Once the patch is verified, the new status will be reflected by the ok-to-test label.

I understand the commands that are listed here.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

@sonarqubecloud

Copy link
Copy Markdown

@github-actions github-actions Bot added the non-workspace-changes PR changes files outside workspace directories label Aug 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

needs-ok-to-test non-workspace-changes PR changes files outside workspace directories

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add AGENTS.md review guidance for scripts/ directory threat model

0 participants