Skip to content

Releases

Semantic Authority v0.2.0-alpha

Choose a tag to compare

@adeinnovates adeinnovates released this 03 May 02:00

First alpha release of the meaning review / meaning drift surface.

This release turns Semantic Authority from schema validation only into a real review-and-gate workflow for code changes against MEANING.yaml.

Highlights

  • added meaning review and meaning drift for semantic drift detection on diffs
  • added GitHub Action review mode with SARIF output and merge-gating support
  • action now builds the CLI directly from this repo instead of depending on npm
  • added full changed-file context to judge prompts, not just diff hunks
  • added support for both Anthropic and OpenAI providers
  • added cross-run caching keyed by (diff_hash, meaning_hash, model_id, provider)
  • added seeded invoice-processor scenarios for concrete review demos
  • improved public docs to separate shipped behavior from roadmap

Current status

This is an alpha release:

  • the review/gating surface is real and tested in-source
  • local CLI and GitHub Action workflows are usable now
  • npm publication for @semantic-authority/cli is still planned
  • live model performance should still be calibrated on real repos over time

Included surfaces

  • meaning init
  • meaning validate
  • meaning context
  • meaning review
  • meaning drift
  • composite GitHub Action for validation + review

Notes

meaning review is probabilistic constraint-risk detection, not formal proof. It should be used alongside tests, type-checking, and human review.

Semantic Authority v0.1.0

Choose a tag to compare

@adeinnovates adeinnovates released this 27 Mar 09:41

First public release of Semantic Authority.

Semantic Authority makes system meaning explicit, machine-legible, and enforceable for humans, agents, and CI. The core artifact is MEANING.yaml: a structured declaration of goals, non-goals, constraints, trade-offs, and drift policy that gives AI-assisted development a semantic boundary.

Included in this release:

  • MEANING.yaml framework and example artifact
  • @semantic-authority/cli source with commands for:
    • meaning init
    • meaning validate
    • meaning context
  • automated CLI test coverage for scaffolding, validation, strict mode, and context generation
  • GitHub Action scaffold for CI-based meaning validation
  • documentation for PMs, architects, engineers, and agent builders
  • system prompt and prompt-based generation path for creating a draft MEANING.yaml
  • public pitch materials and executive brief for explaining the framework

Highlights:

  • meaning init now scaffolds both MEANING.yaml and .claude/meaning-context.md
  • meaning validate enforces schema and semantic hygiene checks
  • meaning context generates agent-readable context from a canonical meaning artifact
  • the repo is now structured for public open-source use with contribution, security, and PR guidance

Current release notes:

  • This release is available on GitHub first.
  • npm publication for @semantic-authority/cli will follow in a later step.
  • Until npm is published, use the CLI from source via the instructions in packages/cli/README.md.

Semantic Authority is part of the AI Native PM Stack, alongside Proof of Production and the umbrella operating model for AI-native product management.