CLI Design

The CLI demonstrates the standard command layout: a thin entry point, one file per public command, split subcommand modules when a command grows, command-level help, and version reporting. The primary executable is dev-std; wn-dev-std remains a compatibility alias.

audit

Runs repository audit checks for release signoff. The default scope is all; callers may request narrower scopes such as docs.plans. Text and JSON output are supported.

check

Compatibility alias for audit. Existing repositories and CI jobs may keep using this command while new signoff wiring should call audit.

plan

Helpers for compliant plan documents. plan list lists plans from the discovered project root, plan show renders one plan by id, plan create writes a new canonical plan, plan status updates the plan status, and plan step adds or updates structured step state. The command discovers the package root by walking upward to wn-dev-std.toml, a configured pyproject.toml, or a .git fallback boundary.

log

Helpers for compliant plan work logs. log list lists logs attached to a plan id, log show renders one log by globally unique log id, and log create writes a new attached log entry after the same root discovery and catalog validation used by plan.

standard

Prints a standard profile summary as text or JSON. The default profile is python-package; --profile cpp-library renders the C++ native profile, --profile csharp-app renders the C# profile, --profile javascript-web-app renders the no-build browser JavaScript/CSS profile, and --profile python-js-app renders the Python-served browser app profile. --profile zephyr-firmware renders the Zephyr firmware profile.

version

Reports the package version, Python version, and major Wavenumber dependency versions.