# krab_cli
The `krab` command-line tool for the
[Krab](https://github.com/ManirajKatuwal/krab-pub) full-stack Rust web framework.
## Install
```sh
cargo install krab_cli
```
## Commands
### Project and dev workflow
| `krab new <name> --template <t>` | Scaffold a new project from a template |
| `krab bootstrap` | One-command local stack: build + orchestrator |
| `krab docs` | Regenerate the dev-workflow guide |
| `krab doctor --diagnostics --strict` | Aggregated workspace health checks |
| `krab env-check --strict` | Validate required and conditional environment settings |
### Governance
| `krab contract check` | REST/GraphQL contract conformance |
| `krab contract protocol-check` | Protocol parity across services |
| `krab db lifecycle` | Migration lifecycle validation |
| `krab db rollback` | Rollback simulation |
| `krab db drift` | Schema drift detection |
| `krab db rehearsal` | Rollback rehearsal, writes evidence |
| `krab topology doctor` | Topology hygiene checks |
| `krab topology split <domain>` | Extract a domain into a split service |
| `krab security dependency-gate` | Dependency policy gate |
| `krab release check` | Release pre-flight |
| `krab release certify [--out <dir>]` | Generate a release evidence bundle (default `<artifact root>/release-certify/local`; the root is `KRAB_ARTIFACT_DIR`, else `.krab`) |
`contract`, `db` and `release` validate the Krab framework's own reference
services: they refuse to run outside a Krab framework checkout, and `db
lifecycle`, `db rollback` and `db drift` need a reachable Postgres. `doctor`,
`env-check`, `topology doctor` and `security dependency-gate` work in any
project; `doctor` and `env-check` load `./.env` first (variables already set in
the process win).
Most commands accept `--diagnostics` for verbose output and `--json` for
machine-readable results. The `contract`, `db`, `release certify` and
`security dependency-gate` commands are the ones the CI workflows run.
## Documentation
- [Dev workflow](https://github.com/ManirajKatuwal/krab-pub/blob/main/docs/guides/dev_workflow.md)
- [Production readiness](https://github.com/ManirajKatuwal/krab-pub/blob/main/docs/operations/production_readiness.md)
- [Release policy](https://github.com/ManirajKatuwal/krab-pub/blob/main/RELEASE_POLICY.md)
## License
MIT