lintai docs

Appearance

Rule Reference

SEC499lintai-ai-securitypreviewmarkdownwarn

AI markdown: shared pipx run tool grant

AI-native markdown frontmatter grants `Bash(pipx run:*)` tool access

Provider
lintai-ai-security
Surface
markdown
Scope
per_file
Tier
preview
Severity
warn
Confidence
high
Detection
structural
Remediation
message_only

Activation Model

Preset Membership

This rule is part of the builtin activation graph through these preset memberships.

governancemembership

Lifecycle

Stable Lifecycle Contract

State

stable_gated

Graduation rationale

Checks AI-native markdown frontmatter for exact mutable `pipx run` authority through `allowed-tools`.

Deterministic signal basis

MarkdownSignals exact frontmatter string detection for `Bash(pipx run:*)` in allowed-tools entries.

Malicious corpus
skill-uvx-dlx-pipx-allowed-tools
Benign corpus
skill-uvx-dlx-pipx-specific-safe
structured evidence required remediation reviewed
Canonical note

Structural preview rule; deterministic today, but the preview contract may still evolve.

Nearby Signals

Related Rules

SEC390AI markdown: shared git push tool grantAI-native markdown frontmatter grants `Bash(git push)` tool accessmarkdownpreview
SEC391AI markdown: shared git checkout tool grantAI-native markdown frontmatter grants `Bash(git checkout:*)` tool accessmarkdownpreview
SEC392AI markdown: shared git commit tool grantAI-native markdown frontmatter grants `Bash(git commit:*)` tool accessmarkdownpreview
SEC393AI markdown: shared git stash tool grantAI-native markdown frontmatter grants `Bash(git stash:*)` tool accessmarkdownpreview
SEC474AI markdown: shared gh pr tool grantAI-native markdown frontmatter grants `Bash(gh pr:*)` tool accessmarkdownpreview
SEC494AI markdown: shared npm exec tool grantAI-native markdown frontmatter grants `Bash(npm exec:*)` tool accessmarkdownpreview

SEC499 / MD-PIPX-RUN-ALLOWED-TOOLS ​

SEC499 flags AI-native markdown frontmatter when allowed-tools grants the exact token Bash(pipx run:*).

Why It Matters ​

pipx run executes packages through a mutable runner path. Shared frontmatter should not quietly normalize that as default execution authority.

Trigger Shape ​

The rule triggers only when all of these are true:

  • the file is an AI-native markdown instruction surface
  • the path is not fixture-like
  • allowed-tools or allowed_tools contains the exact token Bash(pipx run:*)

Clean Cases ​

These stay clean:

  • more specific project commands such as Bash(python -m black)
  • frontmatter without Bash(pipx run:*)
  • fixture-like examples under test or fixture paths

Example Trigger ​

yaml
allowed-tools:
  - Bash(pipx run:*)
  - Read

Safer Example ​

yaml
allowed-tools:
  - Bash(python -m black)
  - Read

How To Fix ​

Replace Bash(pipx run:*) with a narrower reviewed command, or remove shared mutable package-execution authority from the frontmatter entirely.