v0.5.4: Honest install docs and a complete templates --help
A focused docs-and-help release: it fills in the last missing per-command flag in --help, corrects stale publishing/version claims in the READMEs, and cleans up documentation so facts live in exactly one place.
Fixed
-
cospec templates --helpnow shows its--schemaflag (#29 by @replygirl) — thetemplatescommand forwards a real--schema <name>flag (defaultspec-driven), but PR #25's per-command help work left this one entry without anoptionsblock, so--helpsilently omitted it. Users had no way to discover the flag short of reading the source or docs site. It now renders:$ cospec templates --help Command options: --schema <name> Schema whose templates to list (default: spec-driven)A regression test guards against the gap, and every other command's help was audited against its actually-parsed flags — no other omissions were found.
Changed
-
Honest publishing docs and current install examples (#28 by @replygirl) — the package is published, so the "Publishing soon" parentheticals were removed from
README.mdand the npm-shippedapps/cli/README.md, and themise use github:aligned-team/cospec@...examples were bumped off@0.4.0. The docs site's installation guide and quickstart now lead with a "Via mise" path (matching both READMEs), including the self-contained-binary note and theminimum_release_agecooldown caveat with its exact-pin workaround. -
Flat docs link to site-owned facts instead of restating them (#30 by @replygirl) — repo-internal docs (
apply-archive.md,validation.md,schemas.md,stores.md,blocking-changes.md,harness-integration.md,architecture.md) no longer duplicate the rule tables, exit-code tables, artifact matrices, and command semantics that the docs site (cospec.aligned.team) now owns. Each file keeps its contributor-facing content and links out to the canonical page, so there's a single source of truth per fact.
Full Changelog: v0.5.3...v0.5.4