Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Oct 24, 2025

Summary

Improves discoverability of the existing skip configuration feature by adding comprehensive documentation to README.md. This addresses #40 where users wanted a way to acknowledge findings that are not relevant in their context.

Background

Users need to suppress findings that are false positives or accepted risks (e.g., pr_runs_on_self_hosted when runners are hardened). This functionality already exists via the skip option in .poutine.yml but was only documented in .poutine.sample.yml, making it hard to discover.

Changes

Added "Acknowledging Findings" section to README.md with:

  • Use cases: When and why to skip findings (false positives, mitigated risks, etc.)

  • Filter options: Complete documentation of all available filters:

    • job: Filter by job name
    • level: Filter by severity (note, warning, error)
    • path: Filter by workflow file path
    • rule: Filter by rule name
    • purl: Filter by package URL
    • osv_id: Filter by OSV ID
  • Examples:

skip:
  # Skip all note-level findings
  - level: note
  
  # Skip findings in specific workflow
  - path: .github/workflows/safe.yml
  
  # Skip a specific rule everywhere
  - rule: unpinnable_action
  
  # Skip a rule for specific workflows
  - rule: pr_runs_on_self_hosted
    path:
      - .github/workflows/pr.yml
      - .github/workflows/deploy.yml

Fixes #40

🤖 Generated with Claude Code

Copilot AI changed the title [WIP] Add functionality to acknowledge findings in Poutine docs: Document skip configuration for acknowledging findings in README Oct 24, 2025
@fproulx-boostsecurity
Copy link
Contributor

Closes #364

@fproulx-boostsecurity fproulx-boostsecurity marked this pull request as ready for review October 24, 2025 16:33
@fproulx-boostsecurity fproulx-boostsecurity requested a review from a team as a code owner October 24, 2025 16:33
@fproulx-boostsecurity fproulx-boostsecurity changed the title docs: Document skip configuration for acknowledging findings in README Document skip configuration for acknowledging findings Oct 24, 2025
@fproulx-boostsecurity fproulx-boostsecurity force-pushed the copilot/acknowledge-findings-feature branch from 2a39585 to bc61c36 Compare October 24, 2025 17:03
Copy link
Collaborator

@Talgarr Talgarr left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It can also be added using the flag: --skip

fproulx-boostsecurity and others added 2 commits October 24, 2025 14:25
Add "Acknowledging Findings" section to README.md to improve
discoverability of the existing skip configuration feature.
This allows users to suppress false positives or accepted risks.

Includes:
- Use case explanations for when to skip findings
- Complete documentation of all filter options (job, level, path,
  rule, purl, osv_id)
- Practical examples showing how to skip by severity level,
  workflow path, and rule name

Fixes #40

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
Add documentation for the --skip command-line flag in both the Configuration
Options section and the Acknowledging Findings section. Clarify that the
command-line flag only supports skipping rules globally by name, while the
configuration file supports granular filtering by job, path, level, etc.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
@fproulx-boostsecurity fproulx-boostsecurity force-pushed the copilot/acknowledge-findings-feature branch from bc61c36 to 770dd9e Compare October 24, 2025 18:29
@SUSTAPLE117 SUSTAPLE117 merged commit 7bdfec0 into main Oct 27, 2025
10 checks passed
@SUSTAPLE117 SUSTAPLE117 deleted the copilot/acknowledge-findings-feature branch October 27, 2025 18:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Acknowledge findings

4 participants