Skip to content

v0.8.0 Analysis, Integrations, and AI-Ready Interfaces

Choose a tag to compare

@DKFuH DKFuH released this 29 Mar 11:44
· 51 commits to main since this release

OrgScript v0.8.0

OrgScript v0.8.0 is the Analysis, Integrations, and AI-Ready Interfaces release.

This release matures OrgScript’s capability to be used as a structured source of truth for downstream systems. By introducing deterministic analysis and stable context exports, we make OrgScript documents significantly more useful for both automated CI/CD pipelines and modern AI/Agent workflows.

Highlights

Deterministic Analysis

  • orgscript analyze <file>: A new command for structural inspection without LLM dependency.
  • Structural Metrics: Reports block counts, trigger inventories, state/transition counts, and role capabilities.
  • Complexity Hints: Provides insights into the branching and statement volume of your logic.

AI-Ready Context

  • orgscript export context <file>: Packages the entire logic model, diagnostics, and summaries into a single machine-friendly JSON format.
  • Ingest Optimization: Designed to be the standard context bundle for feeding OrgScript logic into LLM agents or vector indexes.

Integration Recipes

  • GitHub Actions: Added production-ready workflow templates for CI quality gates.
  • Post-Commit Hooks: Provide examples for Husky and native git hooks to ensure logic consistency.
  • Repository Hooks: Documentation on how to integrate OrgScript into existing engineering workflows.

Showcase Upgrade

  • Doc Site Builder v2: Upgraded scripts/build-docs.js to create a more comprehensive preview of all artifacts (Source, Analysis, Summary, Diagram).
  • Incident Escalation SLA: A new high-quality example demonstrating time-based policies and operational handling in high-trust environments.

Verification

Confirmed on the current release state:

  • All tests passed (npm test).
  • Analyzed hero examples with success.
  • Exported AI-ready context for cross-system verification.

Project Evolution

v0.8.0 establishes OrgScript as a reliable, machine-readable interface. While v0.7.0 was about packaging, v0.8.0 is about utility—ensuring that every line of OrgScript code provides immediate, structured value for both human stakeholders and automated agents.