Skip to content

Packaging, Distribution, and Trust

Choose a tag to compare

@DKFuH DKFuH released this 29 Mar 11:36
· 53 commits to main since this release

OrgScript v0.7.0

OrgScript v0.7.0 focuses on Packaging, Distribution, and Trust.

This release transitions OrgScript from a local developer experiment into a ready-to-distribute toolset. By maturing our CLI, preparing the VS Code extension for publication, and building a live documentation showcase, we are making OrgScript significantly easier to adopt.

Highlights

Professional CLI Experience

  • Global Installation: You can now install OrgScript globally via npm install -g . (or from the upcoming npm package) and call it directly as orgscript from any directory.
  • Improved Tooling UX: Added --version / -v support and a more detailed, stakeholder-friendly help text via --help.
  • Bin Path Stability: Refined the internal binary execution to be safe for global deployment.

VS Code Extension Readiness

  • Marketplace Alignment: Updated the extension manifest with required metadata, repository links, and bug tracking.
  • Modern Standards: Addressed VS Code manifest warnings and set the version to match the core project (v0.7.0).

Automated Documentation Showcase

  • GitHub Pages Ready: Developed a new site builder (scripts/build-docs.js) that automatically compiles all example files into a unified documentation portal using the HTML exporter.
  • Integrated Artifacts: The site includes live-rendered diagrams and concise logic summaries.

Trust Improvements

  • Hiring Process Hero Example: Added a realistic, multi-department Hiring Process example (examples/hiring-process.orgs) to demonstrate advanced features such as role-based permissions, GDPR policies, and complex process branching.
  • Full Verification: All examples are now validated against golden snapshots, ensuring zero regressions across AST, model, and formatter outputs.

Project Status

With v0.7.0, OrgScript is "Packaging Ready". The jump from v0.6.0 was focused on hardening the distribution path to ensure that OrgScript can be used reliable in real workflows.

Verification

  • npm install -g . -> orgscript --version reports 0.7.0.
  • All tests passed via npm test.
  • Documentation site built successfully via node ./scripts/build-docs.js.