Skip to content

v0.5.4

Latest

Choose a tag to compare

@github-actions github-actions released this 16 Jul 22:04
Immutable release. Only release title and notes can be modified.
292c923

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 --help now shows its --schema flag (#29 by @replygirl) — the templates command forwards a real --schema <name> flag (default spec-driven), but PR #25's per-command help work left this one entry without an options block, so --help silently 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.md and the npm-shipped apps/cli/README.md, and the mise 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 the minimum_release_age cooldown 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