Repository navigation
Releases
Semantic Authority v0.2.0-alpha
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 reviewandmeaning driftfor 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/cliis still planned - live model performance should still be calibrated on real repos over time
Included surfaces
meaning initmeaning validatemeaning contextmeaning reviewmeaning 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
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.yamlframework and example artifact@semantic-authority/clisource with commands for:meaning initmeaning validatemeaning 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 initnow scaffolds bothMEANING.yamland.claude/meaning-context.mdmeaning validateenforces schema and semantic hygiene checksmeaning contextgenerates 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/cliwill 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.