lintai docs

Appearance

Rule Reference

SEC500lintai-ai-securitypreviewmarkdownwarn

AI markdown: shared npx tool grant

AI-native markdown frontmatter grants `Bash(npx:*)` 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 `npx` authority through `allowed-tools`.

Deterministic signal basis

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

Malicious corpus
skill-npx-git-ls-remote-allowed-tools
Benign corpus
skill-npx-git-ls-remote-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

SEC500 / MD-NPX-ALLOWED-TOOLS ​

SEC500 flags AI-native markdown frontmatter when allowed-tools grants the exact token Bash(npx:*).

Why It Matters ​

npx resolves and executes packages through a mutable runner path. Shared frontmatter should not quietly make that a default capability for every agent that loads the file.

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(npx:*)

Clean Cases ​

These stay clean:

  • more specific project commands such as Bash(npm run lint)
  • frontmatter without Bash(npx:*)
  • fixture-like examples under test or fixture paths

Example Trigger ​

yaml
allowed-tools:
  - Bash(npx:*)
  - Read

Safer Example ​

yaml
allowed-tools:
  - Bash(npm run lint)
  - Read

How To Fix ​

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