chore(release): prepare v0.9.4 metadata

Author: DKFuH

CHANGELOG.md

@@ -6,6 +6,14 @@ The format is based on Keep a Changelog, and this project follows Semantic Versi
 
 ## [Unreleased]
 
+## [0.9.4] - 2026-03-31
+
+- Added an optional document language metadata header with `orgscript 1` plus `source-language`, `comment-language`, `annotation-language`, and `context-language`.
+- Treated declared language metadata as a stricter document contract while keeping the OrgScript core syntax canonical in English.
+- Added canonical JSON and context-export support for document metadata.
+- Added conservative lint checks for obvious comment and annotation language mismatches.
+- Updated the formatter, VS Code grammar/snippets, specs, examples, manuals, and tests for the new header.
+
 ## [0.9.3] - 2026-03-30
 
 - Renamed the npm package to `@dkfuh/orgscript` after npm rejected the unscoped `orgscript` name as too similar to an existing package.

docs/releases/v0.9.4.md

@@ -0,0 +1,61 @@
+# OrgScript v0.9.4
+
+OrgScript v0.9.4 adds a small but meaningful language-core v1 step: a document language metadata header.
+
+This release does not introduce free-form multilingual syntax. The core language remains canonical in English. Instead, OrgScript documents can now declare the intended language of comments, annotations, and generated human-facing context in a strict, parseable way.
+
+## Highlights
+
+- added an optional `orgscript 1` document header
+- added allowlisted document metadata keys:
+  - `source-language`
+  - `comment-language`
+  - `annotation-language`
+  - `context-language`
+- kept `source-language` strict in v1: only `en` is allowed
+- carried document metadata into the AST, canonical JSON model, and AI context export
+- added conservative lint findings for obvious language mismatches in comments and annotations
+
+## Why this matters
+
+The new header makes human-authored text safer and clearer in multilingual environments without weakening the OrgScript core.
+
+That helps with:
+
+- reviewability for teams working across multiple human languages
+- safer exporter and AI context behavior
+- clearer authorship expectations for comments and annotations
+- preserving English-first syntax while still declaring document language intent
+
+## Example
+
+```orgscript
+orgscript 1
+
+source-language "en"
+comment-language "de"
+annotation-language "de"
+context-language "de"
+```
+
+This header is non-semantic. It does not change execution behavior, validation meaning, or the canonical interpretation of OrgScript logic.
+
+## Verification
+
+Confirmed on the release preparation state:
+
+- `npm test`
+- `npm run check:all`
+- `node ./bin/orgscript.js validate ./examples/lead-qualification.orgs`
+- `node ./bin/orgscript.js lint ./tests/lint/language-mismatch.orgs --json`
+- `node ./bin/orgscript.js export json ./examples/lead-qualification.orgs`
+- `node ./bin/orgscript.js export context ./examples/lead-qualification.orgs`
+- `node ./bin/orgscript.js analyze ./examples/lead-qualification.orgs --json`
+- `node ./bin/orgscript.js export markdown ./examples/lead-qualification.orgs --with-annotations`
+- `node ./bin/orgscript.js export html ./examples/lead-qualification.orgs --with-annotations`
+
+## Project status
+
+OrgScript remains a human-readable, AI-friendly description language for business logic and operational systems.
+
+v0.9.4 strengthens document contracts and exporter clarity without turning the core language into a multilingual keyword system.

docs/site/demos/craft-business-lead-to-order.html

@@ -101,6 +101,7 @@
   <header>
     <h1>OrgScript Demo: Craft Business: Lead to Order</h1>
     <p>Generated by OrgScript</p>
+    
   </header>
 
   <nav>

docs/site/demos/hiring-process.html

@@ -101,6 +101,7 @@
   <header>
     <h1>OrgScript Demo: Hiring: Standard Candidate Process</h1>
     <p>Generated by OrgScript</p>
+    
   </header>
 
   <nav>

docs/site/demos/incident-escalation.html

@@ -101,6 +101,7 @@
   <header>
     <h1>OrgScript Demo: Incident Escalation SLA</h1>
     <p>Generated by OrgScript</p>
+    
   </header>
 
   <nav>

docs/site/demos/lead-qualification.html

@@ -101,6 +101,7 @@
   <header>
     <h1>OrgScript Demo: Lead qualification process</h1>
     <p>Generated by OrgScript</p>
+    
   </header>
 
   <nav>

docs/site/demos/order-approval.html

@@ -101,6 +101,7 @@
   <header>
     <h1>OrgScript Demo: Order approval stateflow</h1>
     <p>Generated by OrgScript</p>
+    
   </header>
 
   <nav>

docs/site/index.html

@@ -87,7 +87,7 @@ <h3>Service Escalation</h3>
 
   <footer>
     <hr>
-    <p>Generated by OrgScript v0.9.3 &bull; <a href="https://github.com/DKFuH/OrgScript">GitHub</a></p>
+    <p>Generated by OrgScript v0.9.4 &bull; <a href="https://github.com/DKFuH/OrgScript">GitHub</a></p>
   </footer>
 </body>
 </html>

editors/vscode/package.json

@@ -2,7 +2,7 @@
   "name": "orgscript-vscode",
   "displayName": "OrgScript",
   "description": "Minimal VS Code language support for OrgScript (.orgs) files.",
-  "version": "0.9.3",
+  "version": "0.9.4",
   "publisher": "dkfuh",
   "icon": "icon.png",
   "repository": {

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dkfuh/orgscript",
-  "version": "0.9.3",
+  "version": "0.9.4",
   "description": "A human-readable, AI-friendly description language for business logic and operational systems.",
   "license": "Apache-2.0",
   "main": "./src/index.js",