Skip to content

Releases

v1.1.0 — GA-UT npm CLI release

Choose a tag to compare

@ssj9685 ssj9685 released this 02 Sep 22:57

Mermaid Spec is available under the GA-UT organization on npm: @ga-ut/mermaid-spec.

Requires Bun 1.3.14 or newer. npm is the distribution registry; Node.js is not a supported runtime.

bunx @ga-ut/mermaid-spec@1.1.0 --help

Or install a command for use across projects:

bun add --global @ga-ut/mermaid-spec
mermaid-spec --version

Changes

  • Added help and installed-version commands, including help before a specification exists.
  • Reorganized the README around CLI execution, global installation, and optional team/CI version pinning.
  • Added a runnable first specification and a regression test for its change → failing checks → rebuild loop.
  • Expanded package checks to exercise the installed CLI, generated runtime imports, and all public exports; packages outside the GA-UT scope and local artifacts fail verification.
  • Documented the release procedure. Contract syntax and application runtime behavior are unchanged.

Migration

The briefly published unscoped mermaid-spec@1.1.0 is deprecated in favor of @ga-ut/mermaid-spec@1.1.0. The executable remains mermaid-spec.

Generated JavaScript now imports @ga-ut/mermaid-spec/runtime and @ga-ut/mermaid-spec/http. If migrating from the GitHub source release or the unscoped package, install the scoped dependency and rebuild the generated files. Remove the old dependency after updating any application imports.

Verification

  • 69 tests and 284 assertions; generated TypeScript and OpenAPI validation passed.
  • Linux, macOS, and Windows CI passed.
  • All 82 npm archive files match release commit 0087abff6ee81e3d7fc2d89a71fc0746380e3181.
  • The published archive and fresh-cache bunx installation were verified against the README workflow.

See the README for first use and the changelog for details.

mermaid-spec v1.0.0

Choose a tag to compare

@ssj9685 ssj9685 released this 02 Sep 15:11

The first GA-UT release of mermaid-spec.

Highlights:

  • Compile a strict Mermaid-compatible subset into TypeScript, JSON Schema, PostgreSQL DDL, OpenAPI, validating Fetch routing, and executable state machines.
  • Trace stable contract IDs to implementation, test, UI consumer, and documentation files.
  • Guide new-contract bootstrapping with structured coverage gaps while keeping final verification strict.
  • Propagate nested model changes through wrappers to affected APIs, code, consumers, and tests.
  • Classify compatibility and produce reviewable migration plans without executing destructive changes.
  • Exercise a persistent full-stack Workboard example with restart recovery and browser-consumer traceability.

Requires Bun 1.3.14 or newer.

Install:

bun add --dev github:ga-ut/mermaid-spec#v1.0.0