Skip to content

v0.3.0 — Evidence-Based Governance & Self-Governance

Choose a tag to compare

@SmartBrandStrategies SmartBrandStrategies released this 25 Feb 15:50
· 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 typekey: 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-measure counts 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_METRIC patch op: update metric values while ceiling/unit stay immutable
  • Token budgets: global MAX_TOKENS and per-module [budget: N] limits
  • charter adf sync: verify/update .adf.lock hashes (--check / --write)
  • Cadence scheduling: manifest CADENCE section 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 init includes entry_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
  • nextActions in JSON output: agent-friendly follow-up suggestions
  • 178 tests across 12 test files (up from 48 in v0.2.0)

Changed

  • bundleModules() accepts optional taskKeywords for 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@latest

Full Changelog: v0.2.0...v0.3.0