feat(cli)!: Charter 1.0 — remove commercial surface from @stackbilt/cli (#127)

.gitignore

@@ -12,23 +12,26 @@ coverage/
 plans/
 governance/
 
+# npm lockfile — this repo uses pnpm (pnpm-lock.yaml); ignore npm-generated lockfile
+package-lock.json
+
 # local telemetry artifacts
 .charter/telemetry/
 
 # scenario harness results
 harness/results/
-# cc-taskrunner worktree protection
-C:*
-node_modules/
-.pnpm-store/
-__pycache__/
-# cc-taskrunner worktree protection
-C:*
-node_modules/
-.pnpm-store/
-__pycache__/
-# cc-taskrunner worktree protection
-C:*
-node_modules/
-.pnpm-store/
-__pycache__/
+# cc-taskrunner worktree protection
+C:*
+node_modules/
+.pnpm-store/
+__pycache__/
+# cc-taskrunner worktree protection
+C:*
+node_modules/
+.pnpm-store/
+__pycache__/
+# cc-taskrunner worktree protection
+C:*
+node_modules/
+.pnpm-store/
+__pycache__/

CHANGELOG.md

@@ -8,6 +8,20 @@ The format is based on Keep a Changelog and follows Semantic Versioning.
 
 ### Added
 
+## [1.0.0] - 2026-05-23
+
+**Breaking:** `run`, `architect`, `scaffold`, and `login` commands removed from `@stackbilt/cli`. The `stackbilt` binary alias is also removed. These commands have moved to [`@stackbilt/build`](https://www.npmjs.com/package/@stackbilt/build) — install it with `npm install -g @stackbilt/build`. Migration tracked in [RFC #112](https://github.com/Stackbilt-dev/charter/issues/112).
+
+### Removed
+
+- `charter run`, `charter architect`, `charter scaffold`, `charter login` — removed after four minor release cycles of deprecation warnings (0.13–0.17). All four commands live in `@stackbilt/build@0.1.0+`.
+- `stackbilt` bin alias — `@stackbilt/cli` now ships only the `charter` binary. Run `npm install -g @stackbilt/build` to get the `stackbilt` bin.
+- `credentials.ts`, `http-client.ts`, `types/scaffold-contract-types.ts` — removed with the commands. `@stackbilt/cli` now has zero network calls, no bearer-token handling, and no references to `stackbilt.dev`.
+
+### Changed
+
+- Package description updated: "Charter CLI — repo-level governance toolkit" (drops scaffolding claim).
+
 ## [0.17.0] - 2026-05-23
 
 Minor release closing issue #155 — session continuity is now first-class in the charter toolchain.

README.md

@@ -177,17 +177,6 @@ Deterministic codebase analysis — no LLM calls, zero runtime dependencies. `bl
 
 All commands support `--format json` with `nextActions` hints for agent workflows.
 
-### Build (deprecated — moving to `@stackbilt/build`)
-
-> These four commands reach external Stackbilt endpoints and are being extracted into a separate `@stackbilt/build` npm package. Governance-only users don't need them. Migration tracked in [RFC #112](https://github.com/Stackbilt-dev/charter/issues/112).
-
-```bash
-stackbilt run "description"              # Architect + scaffold in one step
-charter architect "description"          # Generate stack selection
-charter scaffold --output ./my-project   # Write files from last build
-charter login --key sb_live_xxx          # Store API key (deprecated — prefer STACKBILT_API_KEY env var)
-```
-
 ### Exit codes
 
 - `0`: success

docs/cli-reference.md

@@ -484,12 +484,13 @@ Seeds for hotspot analysis are chosen by resolved preset (from `.charter/config.
 
 Generates a live session snapshot and writes it to `.ai/context.adf` plus `.ai/context.snapshot.json`.
 
-Phase 2 supports `git` and `github` sources with fail-closed behavior for missing GitHub credentials.
+Supports `git`, `github`, and `repo-intel` sources with fail-closed behavior for missing GitHub credentials and graceful skip when the `gh` CLI is unavailable.
 
 ```bash
 npx charter context-refresh
 npx charter context-refresh --sources git
 npx charter context-refresh --sources git,github
+npx charter context-refresh --sources repo-intel
 npx charter context-refresh --output CONTEXT.md
 npx charter context-refresh --ai-dir .ai
 npx charter context-refresh --once --ttl-minutes 30
@@ -498,7 +499,7 @@ npx charter context-refresh --format json
 
 #### Flags
 
-- `--sources <csv>` — context sources to include. Supported: `git`, `github`.
+- `--sources <csv>` — context sources to include. Supported: `git`, `github`, `repo-intel`.
 - `--output <path>` — optionally mirror a markdown snapshot to a file (for session briefs/docs).
 - `--ai-dir <dir>` — target ADF directory (default: `.ai`), output file is `<dir>/context.adf`.
 - `--once` — skip refresh when an existing snapshot is newer than TTL.
@@ -528,6 +529,16 @@ Optional config path: `.charter/context-sources.json`
 
 If `github` is enabled but `GITHUB_TOKEN` is missing, refresh continues without hard failure and records `sources.github.available = false` plus warnings.
 
+If `repo-intel` is enabled but the `gh` CLI is not installed or has no GitHub remote, refresh continues without hard failure and records a warning. When available, `repo-intel` writes a full payload to `.charter/repo-intel/snapshot.json`.
+
+#### Sources reference
+
+| Source | Description |
+|--------|-------------|
+| `git` | Local git branch, working tree, and recent commit log. |
+| `github` | Open issues from the GitHub API (requires `GITHUB_TOKEN`). |
+| `repo-intel` | GitHub history via the `gh` CLI — open/closed issues, PRs, releases, and a computed summary (`openIssueCount`, `mergeVelocity`, `stalledIssues`, `recurringLabels`, `releaseCadence`). Writes `.charter/repo-intel/snapshot.json`. Skips gracefully when `gh` is unavailable. |
+
 For active implementation status and next-session handoff details, see [Context Refresh Resume Guide](/context-refresh-resume).
 
 ### charter surface

packages/cli/package.json

@@ -1,11 +1,10 @@
 {
   "name": "@stackbilt/cli",
   "sideEffects": false,
-  "version": "0.17.0",
-  "description": "Charter CLI — repo-level governance checks + architecture scaffolding",
+  "version": "1.0.0",
+  "description": "Charter CLI — repo-level governance toolkit",
   "bin": {
-    "charter": "./dist/bin.js",
-    "stackbilt": "./dist/bin.js"
+    "charter": "./dist/bin.js"
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",