@specferret/cli
v0.4.2
Published
SpecFerret keeps your specs honest.
Downloads
1,394
Readme
@specferret/cli
Spec drift detection CLI for contract-driven teams.
@specferret/cli catches breaking contract drift before merge by scanning markdown contracts, classifying impact, and enforcing safe resolution paths.
Install
bun install -g @specferret/cliQuickstart
ferret init
ferret lintIf drift is detected:
ferret reviewCore commands
ferret init
ferret scan
ferret lint
ferret extract
ferret reviewCI usage
ferret lint --ciReusable GitHub Action:
- name: SpecFerret CI
uses: BenGardiner123/action@v1
with:
baseline-mode: committedSupports CI baseline modes:
--ci-baseline committed(default)--ci-baseline rebuild
Starter templates:
docs/ci-templates/ferret-action-single-package.ymldocs/ci-templates/ferret-action-monorepo.ymldocs/ci-templates/ferret-action-pr-only.yml
Validation status
Sprint 5 branch-matrix validation (spec-kit + BMAD) is green with explicit S40/S41/S42 assertions:
- spec-kit: https://github.com/BenGardiner123/spec-ferret-validation-spec-kit/actions/runs/23962649755
- BMAD: https://github.com/BenGardiner123/specferret-validation-bmad/actions/runs/23962652352
Runtime requirements
- Bun 1.0+
The CLI is Bun-first and designed for low-latency local and CI runs.
Links
- Source: https://github.com/BenGardiner123/spec-ferret
- Docs: https://specferret.dev
- Core package: https://www.npmjs.com/package/@specferret/core
