Repository navigation
Releases
Releases · ga-ut/mermaid-spec
v1.1.0 — GA-UT npm CLI release
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 --helpOr install a command for use across projects:
bun add --global @ga-ut/mermaid-spec
mermaid-spec --versionChanges
- 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
bunxinstallation were verified against the README workflow.
mermaid-spec v1.0.0
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