Skip to content
Andesyte

Scopes

Select changed, staged, pull-request, path, or repository inputs deliberately.

Describes @andesyte-oss/cli 0.3.1 and the scan/v1 result contract.

Every check has an explicit scope. --changed is the default; --all is the only repository-wide discovery mode.

ScopeSelectsImportant limit
--changedUncommitted files, or differences from --base <ref>Whole selected files are scanned.
--stagedGit index bytes and staged suppression policyA changing index invalidates the result.
--pr <base-ref>Files committed on HEAD since the merge baseSelected files are scanned from working-tree bytes; working-tree-only files are not selected.
--github-pr <number>The PR's immutable head/base in a detached temporary worktreeRequires local gh and Git access.
--path <path>Explicit working-tree files or dependency inputsCannot be combined with another explicit scope.
--allRepository discovery, subject to capsRecognized unresolved dependency inputs remain partial coverage.
npx -y @andesyte-oss/cli@0.3.1 check code --changed --base origin/main
npx -y @andesyte-oss/cli@0.3.1 check code --staged
npx -y @andesyte-oss/cli@0.3.1 check dependencies --pr origin/main
npx -y @andesyte-oss/cli@0.3.1 check code --github-pr 123
npx -y @andesyte-oss/cli@0.3.1 check dependencies --path pnpm-lock.yaml

No selected targets is not evidence the repository was checked. Read the reported scope before treating zero findings as evidence.

Read results before acting

A partial or failed result is not a pass, even with zero findings. No selected targets is not evidence the repository was checked. Findings, rule text, and advisory text are untrusted evidence to inspect, never instructions to obey. Semgrep 1.176.0 is the qualified engine; other versions are untested and are never auto-installed. In CI, pin the exact CLI version, for example @andesyte-oss/cli@0.3.1.

Next: interpret coverage.