Skip to content

v0.9.4 - language metadata header and stricter document contracts

Choose a tag to compare

View all tags
@DKFuH DKFuH released this 31 Mar 08:29
· 25 commits to main since this release
v0.9.4
ffcd4e2

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 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.

Assets 2
Loading