Skip to content

v0.3.0 — Formatter, linter, diagnostics, and CI readiness

Choose a tag to compare

@DKFuH DKFuH released this 29 Mar 07:53
· 85 commits to main since this release

OrgScript v0.3.0

OrgScript v0.3.0 is the first quality-tooling release.

This release rounds out the initial implementation baseline with deterministic formatting, stable golden snapshots, an AST-based linter, machine-readable diagnostics, and CI-ready CLI behavior.

Highlights

  • AST-backed canonical formatter
  • Golden snapshot freeze for AST, canonical model, and formatted output
  • AST-based linter with stable severities and deterministic reporting
  • Human and AI usage guides
  • JSON diagnostics for validate and lint
  • First GitHub Actions CI workflow

Added

  • orgscript format <file>
  • orgscript lint <file>
  • orgscript validate <file> --json
  • orgscript lint <file> --json
  • scripts/lint-all.js
  • .github/workflows/ci.yml
  • docs/orgscript-for-humans.md
  • docs/orgscript-for-ai.md
  • spec/diagnostics.md

Changed

  • Lint exit codes are now CI-friendly:
    • 0 when findings contain only warning and info
    • 1 when findings contain at least one error
  • Validation and lint diagnostics now have a machine-readable JSON contract
  • Formatter, AST, and canonical model output are frozen through golden snapshots
  • Lint output is stable and sorted deterministically

Verification

Verified with:

  • npm test
  • npm run validate:all
  • npm run lint:all

Project status

OrgScript is not a programming language.
It is a human-readable, AI-interpretable description language for business logic, processes, rules, roles, policies, events, and operational systems.

v0.3.0 is the first release that makes OrgScript feel stable as tooling, not only as a language implementation.