chore(release): bump version to 0.6.0 and finalize release notes

Author: DKFuH

CHANGELOG.md

@@ -6,6 +6,16 @@ The format is based on Keep a Changelog, and this project follows Semantic Versi
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-03-29
+
+- Added first HTML documentation exporter via `orgscript export html <file>`.
+- Refined Mermaid export with improved styling, parallelogram shapes for triggers, and semantic markers for state diagrams.
+- Upgraded Markdown summary export (v2) with Table of Contents (TOC), inter-block separators, and better header hierarchy.
+- Reorganized and expanded the demo suite under `docs/demos/` to include HTML, Markdown, and Mermaid artifacts for all hero examples.
+- Stabilized the canonical JSON model (v0.2) and updated its specification in `spec/canonical-model.md`.
+- Improved business-level phrasing in all summary exporters for better stakeholder readability.
+- Consolidated "Artiflow Flow" in documentation to show the path from `.orgs` to visual/structured outputs.
+
 ## [0.5.0] - 2026-03-29
 
 - Refined VS Code TextMate grammar to support inline keywords and dotted properties correctly.

docs/releases/v0.6.0.md

@@ -0,0 +1,46 @@
+# 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.

package.json

@@ -1,6 +1,6 @@
 {
   "name": "orgscript",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "A human-readable, AI-friendly description language for business logic and operational systems.",
   "license": "Apache-2.0",
   "private": true,