Skip to content

*integrations, artifacts, and showcase**

Choose a tag to compare

View all tags
@DKFuH DKFuH released this 29 Mar 11:17
· 55 commits to main since this release
v0.6.0
a954068

OrgScript v0.6.0

OrgScript v0.6.0 is the first integrations, artifacts, and showcase release.

This release marks a major step forward in making OrgScript’s value proposition visible. Instead of just modeling and checking logic, you can now generate compelling visual and structured outputs for stakeholders, documentation, and external systems.

Highlights

HTML Documentation Export

  • Introduced orgscript export html <file>.
  • Generates a modern, static HTML documentation page.
  • Features embedded logic summaries and live-rendered Mermaid diagrams via CDN-based mermaid.js.

Mermaid Export Polish

  • Semantic Shapes: Triggers are now represented as parallelograms for better flowchart clarity.
  • Improved Styling: Added a consistent and premium styling layer (color-coded nodes for decision, action, trigger, success, and stop).
  • Stateflow Markers: State diagrams now include proper [*] --> (start) and --> [*] (end) markers based on transition flow.
  • Readability: Switched to single quotes for internal strings to improve the raw output's legibility.

Markdown Summary v2

  • TOC and Anchors: Multi-block files now include a Table of Contents with jump-links.
  • Structured Sections: Blocks are now separated by horizontal rules and use a clearer header hierarchy (H2/H3).
  • Business Language: Phrasing has been tuned to be less technical and more accessible for non-technical reviewers.

Showcase Upgrade

  • Updated docs/demos/ to include HTML, Markdown, and Mermaid artifacts.
  • Included the "Hero" example (craft-business-lead-to-order.orgs) in the demo build.
  • Refined the "Strategic Artifact Flow" described in the root README.md.

Integration and Governance

  • Canonical Model v0.2: Stabilized the JSON schema for tokens, expressions, and block nodes.
  • Reference Spec: Updated spec/canonical-model.md to match the real-world implementation.
  • Stability Policy: Clarified policy for breaking changes in machine-readable outputs.

Verification

Verified on the current release state with:

  • npm test
  • npm run check:all
  • node ./bin/orgscript.js export html ./examples/craft-business-lead-to-order.orgs
  • node ./bin/orgscript.js demo:generate

Project Status

v0.6.0 transforms OrgScript from a stable specification into a useful documentation engine. By providing high-quality, zero-config exporters for the Web (HTML) and for prose (Markdown), we are establishing OrgScript as a credible layer for organizational knowledge and process governance.

Assets 2
Loading