@booga/vcli 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -5,6 +5,22 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.1] - 2026-05-24
+
+### Added
+
+- `demo/` example consumer: a real one-page MDX site that exercises
+  `vcli ssg build` end to end. Build produces `out/index.html` in roughly
+  20 ms; browser render verified against the expected DOM. Lives in the
+  repo for review, not shipped to npm (`files` ships only `dist/`).
+
+### Changed
+
+- README rewritten in avatar voice, GTM-oriented. Adds a 10-second quick
+  start, a "what it does" surface, and an end-to-end verification section
+  citing the `demo/` evidence.
+- `package.json` description aligned to avatar voice.
+
 ## [0.1.0] - 2026-05-24
 
 ### Added

package/README.md

@@ -1,63 +1,44 @@
 # @booga/vcli
 
-Terminal CLI for the vsuite. Wraps `@booga/vregistry` and `@booga/vssg` so the
-catalog and the static-site pipeline are reachable from the shell — no host app
-required.
+My terminal handle on the vsuite. Registry browsing, vSsg static-site build,
+straight from the shell. No host project, no React wiring.
 
-## Install
+## Quick start, 10 seconds
 
 ```bash
-npm install -g @booga/vcli
-# or, ad-hoc:
-npx @booga/vcli --help
+npx @booga/vcli registry list
 ```
 
-## Commands
+Every vsuite component, id, category, name, off the live registry. No clone,
+no install, no project, no config. One command, instant catalog.
 
-### `vcli registry list`
+## What it does
 
-Enumerate every entry in `@booga/vregistry` — id, category, name.
+- `vcli registry list` — full catalog. `--json` for pipes, `-c <cat>` to
+  filter.
+- `vcli registry inspect <id>` — one entry, JSON, schema and example props
+  included. Exit 1 on miss.
+- `vcli ssg build <config>` — runs the vSsg pipeline. Dynamic-imports the
+  config file, walks routes, compiles MDX, emits HTML, prints page count,
+  asset count, duration. Exit 1 on failure, message attached.
+- Programmatic mount: `registerRegistryCmd(cmd)`, `registerSsgCmd(cmd)`.
+  Attaches the same subcommand trees to any host commander program.
 
-```bash
-vcli registry list                # human-readable
-vcli registry list --json         # JSON, pipe-friendly
-vcli registry list -c block       # filter by category
-```
-
-### `vcli registry inspect <id>`
-
-Print one entry as JSON (schema, default props, source, dependencies).
+## Install
 
 ```bash
-vcli registry inspect hero-split
+npm install -g @booga/vcli
+npx @booga/vcli --help
 ```
 
-Exits 1 if `<id>` isn't in the catalog.
-
-### `vcli ssg build <config>`
+## Verified end-to-end
 
-Run `@booga/vssg`'s `generate()` against a config file. The file is JS/TS/JSON
-with the config as its default export; the CLI imports it dynamically and
-prints a one-line summary on success.
+`demo/` ships a real consumer. One MDX page, real install of `@booga/vssg`,
+`vcli ssg build vssg.config.js` produces `out/index.html`. Renders in
+headless Chromium with the expected DOM, h1, p, 3 li, stylesheet link, 0
+page errors. No mocks, the published binary against the published pipeline.
 
 ```bash
-vcli ssg build vssg.config.js
-# built 42 pages, 17 assets in 312ms
-```
-
-Exits 1 with the error message if the pipeline throws.
-
-## Programmatic API
-
-`vCli` also exports its subcommand registrars, so a host program can compose
-the same commands into a larger `commander` tree:
-
-```ts
-import { Command } from "commander";
-import { registerRegistryCmd, registerSsgCmd } from "@booga/vcli";
-
-const app = new Command().name("mytool");
-registerRegistryCmd(app);
-registerSsgCmd(app);
-app.parseAsync();
+cd demo && npm install && npx vcli ssg build vssg.config.js
+# → built 1 pages, 2 assets in 22ms
 ```

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@booga/vcli",
-  "version": "0.1.0",
-  "description": "Terminal CLI for the vsuite — wraps @booga/vregistry and @booga/vssg.",
+  "version": "0.1.1",
+  "description": "My terminal handle on the vsuite. Registry browsing, vSsg static-site build, from the shell.",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",