v0.9.0 — stackbilt run

What's New

stackbilt run command

One command to architect and scaffold a Cloudflare Worker project:

npx @stackbilt/cli run "Multi-tenant SaaS API with auth and billing"

Animated 6-mode output (PRODUCT, UX, RISK, ARCHITECT, TDD, SPRINT) with real-time progress. Files written to disk immediately.

stackbilt binary alias

The CLI is now accessible as both charter and stackbilt:

# These are equivalent:
stackbilt run "My API"
charter run "My API"
npx @stackbilt/cli run "My API"

Full Changelog

See CHANGELOG.md for details.

v0.6.0

v0.6.0 — ADF Architecture & Bootstrap Stabilization

10 issues, 10 PRs, 251 tests across 4 phases.

Phase 1 — Fix Blocking Bugs

• fix(bootstrap): on-demand ADF modules missing after bootstrap (#4, #14)
• fix(adf): adf init --module additive when .ai/ exists (#5, #13)

Phase 2 — Bootstrap/Migrate Features

• feat(adf): migrate classifies rules into on-demand modules (#6, #15)
• feat(setup): --preset docs for non-code workspaces (#3, #16)
• feat(bootstrap): integrate adf migrate into bootstrap flow (#7, #17)

Phase 3 — ADF Architecture (P0)

• refactor(adf): split bundler into manifest.ts, merger.ts, bundler.ts (#8, #18)
• feat(adf): unified evaluateEvidence() pipeline (#9, #19)

Phase 4 — ADF Architecture (P1/P2)

• refactor(adf): patcher handler map + shared helpers (#12, #20)
• feat(adf): configurable ClassifierConfig and StrengthConfig (#11, #21)
• refactor(adf): types.ts split into 6 domain-owned modules (#10, #22)

Full details in CHANGELOG.md.

v0.5.0

Highlights

• Cross-platform parity: Unified git-helpers.ts module with shell: true resolves WSL/CMD/PowerShell PATH issues — hook install, audit, validate, and why commands now work consistently across all platforms.
• charter adf metrics recalibrate: New subcommand to re-measure LOC, propose ceilings with headroom, and update baselines with required rationale trail.
• ADX-005 bug fixes: 5 findings resolved (hook install git detection, migrate prose sections, doctor thin pointer false positive, EPERM hint, audit no-HEAD guard).

What's Changed

Added

• Cross-platform git helpers module replacing ~6 duplicated implementations
• charter adf metrics recalibrate with budget rationale trail
• EPERM/EACCES retry hint in bootstrap install step
• No-HEAD guard in audit command
• ADX-005 feedback paper and papers directory restructure
• Papers lint script for frontmatter validation
• Custom /commit Claude Code skill

Fixed

• Hook install "not inside git repo" on WSL/PowerShell (F2)
• adf migrate ADD_BULLET on prose/text sections (F3)
• Doctor false positive on .cursorrules thin pointers (F4)

Changed

• Stale baseline detection in adf evidence with structured warnings
• README updated with cross-platform support section and bootstrap docs
• All packages bumped 0.4.2 → 0.5.0

Full Changelog: v0.4.2...v0.5.0

---

Published packages: @stackbilt/cli, @stackbilt/adf, @stackbilt/core, @stackbilt/types, @stackbilt/git, @stackbilt/validate, @stackbilt/classify, @stackbilt/drift, @stackbilt/ci — all at 0.5.0

v0.4.2

[0.4.2] - 2026-02-27

Added

• charter doctor --adf-only mode: New mode runs strict ADF wiring validation only (manifest, required default-load wiring, module parseability, thin pointer integrity, sync lock status) for clean CI/pre-commit gating in repos that may not use .charter/ policy artifacts.
• ADF governance workflow hardening: setup --ci github workflow template now includes ADF Wiring & Pointer Integrity (doctor --adf-only --ci) and ADF Evidence (adf evidence --auto-measure --ci) steps when .ai/manifest.adf is present.
• Setup script sync expanded: setup now also syncs verify:adf, charter:doctor, and charter:adf:bundle scripts (in addition to detect/setup), so post-setup agent loops have first-class commands for ongoing governance.
• Repository adoption guardrails: setup docs/templates now include PR validation guidance (verify:adf) and .ai/* CODEOWNERS review ownership for explicit policy-change review.

Changed

• Pre-commit gate upgraded: charter hook install --pre-commit now prefers pnpm run verify:adf when available and otherwise enforces doctor --adf-only --ci + adf evidence --auto-measure --ci. This shifts enforcement from ceiling-only to full ADF routing + ceiling integrity.
• adf init scaffolding upgraded: now creates starter frontend.adf and backend.adf module stubs to avoid fatal missing-module experiences on first bundle.
• adf bundle missing on-demand behavior: missing ON_DEMAND module files are now reported as warnings (missingModules in JSON) instead of hard failures; missing DEFAULT_LOAD modules remain hard errors.
• adf sync --write empty-sync behavior clarified: when manifest has no SYNC entries, --write now writes an empty .adf.lock and reports tracked source semantics explicitly.

v0.4.1

[0.4.1] - 2026-02-27

Added

• charter doctor agent config pointer check: When .ai/manifest.adf exists, doctor now scans for agent config files (CLAUDE.md, .cursorrules, agents.md, AGENTS.md, GEMINI.md, copilot-instructions.md) that contain stack rules instead of thin pointers. Flags them with [warn] and suggests charter adf migrate --dry-run. Recognizes both pointer marker phrasings.

v0.4.0

[0.4.0] - 2026-02-26

Added

• charter hook install --pre-commit: New flag installs a git pre-commit hook that runs charter adf evidence --auto-measure --ci before each commit. Only gates when .ai/manifest.adf exists -- no-op otherwise. Uses npx charter for consuming repos. Both --commit-msg and --pre-commit can be passed together. Same skip/overwrite pattern with independent markers per hook type.
• Evidence pre-commit gate (this repo): .githooks/pre-commit now runs ADF evidence checks after typecheck, preventing LOC ceiling breaches from being committed. This is the self-regulating mechanism for unattended agent builds.

Changed

• adf.ts split into 4 files: adf.ts (966 LOC) refactored into adf.ts (412), adf-bundle.ts (153), adf-sync.ts (203), and adf-evidence.ts (262). Each file is independently tracked by its own METRICS ceiling. No behavioral changes -- purely structural.
• METRICS expanded from 4 to 8 entries: manifest.adf and core.adf now track adf_commands_loc, adf_bundle_loc, adf_sync_loc, adf_evidence_loc, adf_migrate_loc, bundler_loc, parser_loc, cli_entry_loc with appropriately sized ceilings.
• hook install error message updated: Now accepts --commit-msg and/or --pre-commit (previously required --commit-msg only).
• 178 tests across 12 test files (unchanged).

v0.3.3

[0.3.3] - 2026-02-26

Added

• charter bootstrap command: One-command repo onboarding that orchestrates detect → setup → ADF init → install → doctor in a single frictionless flow. Supports --ci github, --preset, --skip-install, --skip-doctor, and --format json for full machine-readable output including next-step plans.
• Thin pointer generation: charter adf init --emit-pointers (and bootstrap) generates thin CLAUDE.md, .cursorrules, and agents.md files that redirect to .ai/ — preventing rule duplication across agent config files.
• Rule-routing decision tree: adf init scaffold now includes a commented decision tree in core.adf guiding agents on where rules belong (CLAUDE.md vs core.adf vs domain modules), derived from ADX-002 agent DX feedback.
• Section taxonomy documentation: Generated core.adf template documents the open section taxonomy (CONTEXT, CONSTRAINTS, ADVISORY, METRICS), weight tags ([load-bearing], [advisory]), and custom section rules.
• charter adf sync --explain: New flag outputs the .adf.lock schema documentation (format, hash algorithm, commands, purpose) in both text and JSON, eliminating lockfile archaeology friction reported in ADX-001.
• Agent DX feedback papers: ADX-002 (rule routing friction), ADX-003 (install automation friction), and RM-001 (vNext roadmap draft) added to papers/.
• GitHub Actions governance workflow: Bootstrap and setup now generate .github/workflows/charter-governance.yml for PR governance checks.

Changed

• Scaffold templates shared: ADF scaffold constants (MANIFEST_SCAFFOLD, CORE_SCAFFOLD, STATE_SCAFFOLD) and pointer templates are now exported from the adf command module and shared with bootstrap, eliminating template drift.
• Setup functions exported: detectStack(), loadPackageContexts(), detectPackageManager(), and other setup utilities are now exported for reuse by the bootstrap command.

v0.3.2

[0.3.2] - 2026-02-26

Added

• Lockfile types exported: AdfLockfile and AdfSyncStatus interfaces now exported from @stackbilt/adf public API, giving agents .d.ts visibility into the .adf.lock schema without reverse-engineering compiled output.
• Lockfile schema documented: .adf.lock format (flat JSON map of filename → sha256-prefix-16) documented in the @stackbilt/adf README.
• pnpm run dev watch script: New tsc --build --watch dev script for incremental rebuilds during local development via tsconfig.build.json.
• Research papers directory: papers/ with versioned white papers (CSA-001: Context-as-Code v1.1, CSA-002: Greenfield measurement rubric draft) and Architect v2 integration brief.

Changed

• Build uses tsconfig.build.json: Root build script replaced hardcoded 9-path tsc --build invocation with a tsconfig.build.json reference file. TypeScript resolves build order from project references automatically.
• Publish workflow simplified: PUBLISHING.md no longer instructs manual workspace:^ replacement — PNPM handles this at publish time. Publish commands no longer need --access public flag.
• publishConfig.access: "public" declared in all 9 packages (previously only cli and adf).
• sideEffects: false declared in all 9 packages for bundler tree-shaking.

v0.3.1

What's New

• CI evidence gating: Governance workflow template now runs charter adf evidence --auto-measure --ci on PRs when .ai/manifest.adf is present, automatically validating metric ceilings before merge.
• Scorecard evidence: Charter's own governance scorecard pipeline now includes ADF evidence output alongside validate and drift results.

This closes the governance loop — every PR gets LOC ceiling checks automatically.

Full changelog: v0.3.0...v0.3.1

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

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-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