v0.3.0 — Evidence-Based Governance & Self-Governance
·
210 commits
to main
since this release
Charter v0.3.0 closes the loop on ADF governance. Metric ceilings are now checkable constraints, charter adf evidence produces structured pass/fail reports, and Charter dogfoods itself — enforcing LOC limits on its own source files.
Highlights
charter adf evidence— validate metric ceilings and produce structured evidence reports with--auto-measure,--context, and CI gating- Metric content type —
key: value / ceiling [unit]syntax for numeric constraints with hard ceilings - Weight annotations —
[load-bearing]vs[advisory]on sections to distinguish measurable constraints from preferences - Auto-measurement —
--auto-measurecounts lines in files referenced by manifest METRICS section - Self-governance — Charter's own
.ai/directory enforces LOC ceilings on its key source files (adf_commands_loc: 835/900)
Added
- Metric content type:
key: value / ceiling [unit]syntax with auto-detection - Weight annotations:
[load-bearing]and[advisory]on section headers UPDATE_METRICpatch op: update metric values while ceiling/unit stay immutable- Token budgets: global
MAX_TOKENSand per-module[budget: N]limits charter adf sync: verify/update.adf.lockhashes (--check/--write)- Cadence scheduling: manifest
CADENCEsection for check frequency - Constraint validation:
validateConstraints()API — pass/warn/fail per metric charter adf evidence: structured reports with--task,--context,--context-file,--auto-measure- Scaffold LOC guardrail:
adf initincludesentry_loc: 0 / 500 [lines]by default - Advisory-only warnings: flags on-demand modules with no load-bearing sections
--ops-file/--context-file: file-based alternatives to inline JSON flags- Doctor ADF checks: manifest existence, parse, module presence, sync lock
- Trigger observability:
matchedKeywords,loadReason,unmatchedModules nextActionsin JSON output: agent-friendly follow-up suggestions- 178 tests across 12 test files (up from 48 in v0.2.0)
Changed
bundleModules()accepts optionaltaskKeywordsfor richer trigger reporting- Comprehensive documentation updates across root, CLI, and ADF package READMEs
- Charter's own
.ai/directory uses ADF metric ceilings for self-governance
Install / Upgrade
npm install --save-dev @stackbilt/cli@latestFull Changelog: v0.2.0...v0.3.0