v0.3.0 — Formatter, linter, diagnostics, and CI readiness
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
validateandlint - First GitHub Actions CI workflow
Added
orgscript format <file>orgscript lint <file>orgscript validate <file> --jsonorgscript lint <file> --jsonscripts/lint-all.js.github/workflows/ci.ymldocs/orgscript-for-humans.mddocs/orgscript-for-ai.mdspec/diagnostics.md
Changed
- Lint exit codes are now CI-friendly:
0when findings contain onlywarningandinfo1when findings contain at least oneerror
- 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 testnpm run validate:allnpm 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.