caliber-conventions · diff
git:20260315.01353e4 to git:20260319.243527c
3 added, 0 removed. Audit A to A.
What this update changes in the checks
No check changed: every fixed check gives the same answer before and after this update.
A tripped check is a label, not a verdict: read the matched text and the lines below. This week's updates that newly trip a check.
---
description: Core conventions for the @rely-ai/caliber CLI — ES module imports, error handling, commit format
alwaysApply: true
---
- ES module imports require `.js` extension for `.ts` source files
- Prefer `unknown` over `any`; explicit types on params/returns
- Use `ora` spinners with `.fail()` before rethrowing async errors
- `throw new Error('__exit__')` for clean CLI exits (no stack trace)
- Build: `npm run build` (tsup) · Test: `npm run test` (vitest) · Type-check: `npx tsc --noEmit`
- Commit format: `<type>[(scope)]: <description>` — feat/fix/refactor/chore/docs/test/ci
- Do NOT include Co-Authored-By headers in commits
- Never commit API keys or credentials
- Key deps: commander, chalk, ora, diff, glob, tsup, @inquirer/confirm, @inquirer/select, @inquirer/checkbox
- LLM calls go through `src/llm/index.ts` (`llmCall`, `llmJsonCall`) — never import provider SDKs directly
+ - All commands in `src/commands/` must be registered in `src/cli.ts` wrapped with `tracked()`
+ - Backups written to `.caliber/backups/` · manifest at `.caliber/manifest.json`
+