@sonde-sh/sonde
v0.2.1
Published
Reference CLI for generating, validating, and scoring Sonde manifest workflows.
Readme
@sonde-sh/sonde
Sonde CLI for evaluating and improving AI-native/AI-friendly CLI behavior through manifest generation, deterministic runtime checks, and scoring.
Primary goals:
- Generate a manifest contract for target CLIs from help output.
- Evaluate target CLIs and produce report payloads.
- Expose Sonde's own manifest contract as a self-compliant reference.
Canonical docs
Use apps/web/content/docs as the source of truth:
Install
npm install -g @sonde-sh/sondeUsage
sonde --help
sonde --versionCommands:
sonde generate <cli> [--json]
sonde score <cli> [--json]
sonde manifest [--json]
sonde run <cli> [--json]
sonde publish <cli> [--json]
sonde serve [--json]Output modes
- Default: human-readable logs
--json: machine-readable JSON payloads for automation and CI
Notes:
publishis an optional submit step for evaluation reports.serveis an optional JSON-line integration protocol.
Manifest file
Commands that depend on a manifest (run, score, serve) read:
sondage.manifest.jsonin the current working directory
sonde manifest prints Sonde's own Sondage manifest contract and does not require a local manifest file.
