Skip to content

CLI

repo-standards capabilities

Describe the stable machine capabilities without inspecting a repository.

repo-standards catalog

Export the deterministic public product, rule, command, and schema catalog.

repo-standards check

Analyze one repository manifest.

root
Path · optional
--manifest
str · optional
--baseline
str · optional
--mode
Mode · optional · report | ratchet | strict
--format
OutputFormat · optional · json | pretty-json | text
--as-of
str · optional

Deterministic YYYY-MM-DD

--staged
bool · optional

Analyze the exact staged Git index; ignore unstaged and untracked bytes.

--enable-rule
list · optional

Activate a current rule ID for this run.

repo-standards commit-message

Enforce `[(i/n) ][TICKET] type(scope)!: description` and safely normalize spacing/case.

message_file
Path · required

Git commit-message file to validate.

--fix-safe/--no-fix-safe
bool · optional

Apply only verified mechanical header normalization.

--format
OutputFormat · optional · json | pretty-json | text

repo-standards explain

Explain one immutable rule.

rule_id
str · required

repo-standards inspect

Inventory tracked inert repository metadata without requiring a manifest.

root
Path · optional
--kind
str · optional

Filter: all, project, workflow, cloudbuild, dockerfile, terraform, openapi.

--path-prefix
str · optional

Filter by repository path prefix.

--limit
str · optional

Page size from 1 through 500.

--cursor
str · optional

Opaque cursor returned by the prior page.

repo-standards pull-request commits

Require concise PR history or one complete explicitly numbered series.

root
Path · optional
--base
str · optional

Exact pull-request base revision.

--head
str · optional

Exact pull-request head revision.

--base-ref
str · optional

Pull-request base ref name.

--head-ref
str · optional

Pull-request head ref name.

--repository-id
str · optional

Exact PR head owner/name identity used by transition exemptions.

--max-commits
int · optional

Maximum unnumbered non-merge commits.

--transition-exemption
list · optional

Trusted JSON transition exemption; repeat for multiple transitions.

--github-event
Path · optional

GitHub Actions event payload containing exact pull-request evidence.

--advisory
bool · optional

Report policy findings without a nonzero policy exit.

--quiet
bool · optional

Suppress output only when analysis completes successfully.

--format
OutputFormat · optional · json | pretty-json | text

repo-standards pull-request documentation

Reject new README/docs content and enforce the trusted Markdown page budget.

root
Path · optional
--base
str · optional

Trusted base revision used for policy.

--head
str · optional

Head revision to compare with the base.

--format
OutputFormat · optional · json | pretty-json | text

repo-standards pull-request review-policy

Evaluate the configured review tier from exact Git and provider evidence.

root
Path · optional
--base
str · optional

Exact trusted base commit SHA.

--head
str · optional

Exact evaluated pull-request head commit SHA.

--evidence
Path · optional

Strict, complete provider evidence JSON.

--manifest
Path · optional

Trusted repository manifest.

--generated-attribute
str · optional

Git attribute that marks repository-specific excluded artifacts.

repo-standards pull-request size

Calculate review-sized churn while excluding tests and declared generated artifacts.

root
Path · optional
--base
str · optional

Trusted base revision used for diff and policy.

--head
str · optional

Head revision to compare with the base.

--generated-attribute
str · optional

Git attribute that marks repository-specific excluded artifacts.

--report-path
Path · optional

Write the complete canonical JSON report to this path.

--format
OutputFormat · optional · json | pretty-json | text

repo-standards report

Analyze one manifest without blocking on completed policy findings.

root
Path · optional
--manifest
str · optional
--format
OutputFormat · optional · json | pretty-json | text
--as-of
str · optional

Deterministic YYYY-MM-DD

--enable-rule
list · optional

Activate a current rule ID for this run.

repo-standards rest discover

Discover committed OpenAPI entry candidates without importing application code.

root
Path · optional

repo-standards rest doctor

Return the installed capability handshake and inert repository detection.

root
Path · optional

repo-standards rules

List installed policy rules as bounded deterministic JSON.

--rule-prefix
str · optional

Filter rule IDs by prefix.

--severity
str · optional

Filter by warning or error.

--limit
str · optional

Page size from 1 through 500.

--cursor
str · optional

Opaque cursor returned by the prior page.

repo-standards schema

Print repository report or catalog JSON Schema.

document
str · optional