@mindees/cli 0.13.0 → 0.14.0

package/README.md

@@ -4,10 +4,12 @@
 build them with the Mindees Compiler, and diagnose your environment. Zero
 third-party dependencies (built on `node:util` `parseArgs`).
 
-> **Status: 🧪 Experimental (Phase 5).** `create`, `build`, `doctor`, `info`,
-> and the dev **rebuild orchestrator** are implemented and tested. The live
-> dev-server **HTTP/HMR transport** is a developer preview. On-device NL→app
-> generation is Phase 11 (Synapse) — today `--prompt` maps to a template deterministically.
+> **Status: 🧪 Experimental (pre-1.0).** `create` (three templates), `build`,
+> `dev` (build + watch + a real **live-reload HTTP server**), `doctor`, `info`,
+> and `ai explain` are implemented and tested. The live dev-server HTTP/HMR
+> transport works today; it stays a developer-preview layer (long-poll reload,
+> not yet module-level HMR). On-device NL→app generation is Phase 10 (Synapse) —
+> today `--prompt` maps to a template deterministically (offline keyword mapping).
 
 ## Install
 
@@ -20,14 +22,19 @@ npm create mindees@latest
 ## Commands
 
 ```bash
-mindees create <name-or-path> [--template blank|counter] [--prompt "..."] [--force]
+mindees create <name-or-path> [--template blank|counter|app] [--prompt "..."] [--force]
 mindees build [--out-dir <dir>] [--no-source-map]
+mindees dev             # build + watch src/ + live-reload HTTP server (MINDEES_DEV_PORT, default 3000)
 mindees doctor          # diagnose Node / package manager / project / deps
 mindees info            # CLI + environment info
-mindees dev             # rebuild-on-change (developer preview)
+mindees ai explain <error message...>   # explain an error with AI (needs MINDEES_AI_* env)
 mindees help
 ```
 
+Templates: **`blank`** (one minimal screen), **`counter`** (signals + fine-grained
+reactivity), and **`app`** (a polished starter wired to Atlas components, a hook,
+and theming — batteries included).
+
 ```text
 $ mindees create my-app --template counter
 Created "my-app" from the counter template (6 files).
@@ -36,6 +43,10 @@ Next: cd "my-app" && pnpm install && mindees dev
 $ mindees build
 Built 3 module(s); flattened 4/9 elements.
 
+$ mindees dev
+mindees dev — serving http://localhost:3000 (live reload on)
+rebuilt: 3 file(s) ok
+
 $ mindees doctor
 ✓ Node.js: v24.7.0
 ✓ Package manager: pnpm 11.5.0
@@ -64,14 +75,25 @@ an `EnvProbe`, and a `Writer` — so the entire CLI is deterministic in tests. T
   `EnvProbe`.
 - **`startDev`** — the rebuild orchestrator: builds once, rebuilds on each
   `Watcher` change, tracks build count + last result. The watcher and HMR
-  transport are injected (the live server is the preview layer).
+  transport are injected, so the orchestrator stays deterministic in tests.
+- **`createDevServer` / `createNodeWatcher`** — the live-reload transport behind
+  `mindees dev`: a pure request handler that serves the app HTML with a tiny
+  injected poll-and-reload client plus a `/__mindees/version` endpoint, and a
+  debounced `node:fs.watch` adapter (one rebuild per save). The thin `bin` glue
+  wires them into a real `http.createServer`; the behavior (debounced change →
+  rebuild → version bump → browser reload) is unit-tested.
+- **`runAiCommand`** — `mindees ai explain <error>` runs Synapse's `explainError`
+  (`@mindees/ai/devtools`) over a backend built from `MINDEES_AI_*` env
+  (`openai` or `anthropic` adapter). The backend is injected, so it's
+  deterministically testable with a mock.
 
 ## Library API
 
 Forge's internals are exported so other tooling (and `create-mindees`) can reuse
-them: `runCli`, `scaffold`, `buildProject`, `startDev`, `runDoctor`,
-`resolveCreateTarget`, `createMemoryFileSystem`, `TEMPLATES`,
-`naturalLanguageToTemplate`, and their types.
+them: `runCli` / `runCliAsync`, `scaffold`, `buildProject`, `startDev`,
+`createDevServer` / `createNodeWatcher` / `renderDevPage`, `runDoctor`,
+`runAiCommand`, `resolveCreateTarget`, `createMemoryFileSystem`, `TEMPLATES` /
+`getTemplate` / `materialize`, `naturalLanguageToTemplate`, and their types.
 
 ## License
 

package/dist/version.d.ts

@@ -11,7 +11,7 @@
  * @module
  */
 /** The package version. All `@mindees/*` packages share one locked version line. */
-declare const VERSION = "0.13.0";
+declare const VERSION = "0.14.0";
 //#endregion
 export { VERSION };
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -11,7 +11,7 @@
 * @module
 */
 /** The package version. All `@mindees/*` packages share one locked version line. */
-const VERSION = "0.13.0";
+const VERSION = "0.14.0";
 //#endregion
 export { VERSION };
 

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","names":[],"sources":["../src/version.ts"],"sourcesContent":["/**\n * Single source of truth for the `@mindees/cli` package version.\n *\n * All `@mindees/*` packages share one locked version line (Changesets, fixed\n * group). Keeping it in its own dependency-free module lets both the public\n * package metadata ({@link index}) and the scaffolder's generated\n * `package.json` ({@link templates}) pin to the same value without a circular\n * import.\n *\n * @module\n */\n\n/** The package version. All `@mindees/*` packages share one locked version line. */\nexport const VERSION = '0.13.0'\n"],"mappings":";;;;;;;;;;;;;AAaA,MAAa,UAAU"}
+{"version":3,"file":"version.js","names":[],"sources":["../src/version.ts"],"sourcesContent":["/**\n * Single source of truth for the `@mindees/cli` package version.\n *\n * All `@mindees/*` packages share one locked version line (Changesets, fixed\n * group). Keeping it in its own dependency-free module lets both the public\n * package metadata ({@link index}) and the scaffolder's generated\n * `package.json` ({@link templates}) pin to the same value without a circular\n * import.\n *\n * @module\n */\n\n/** The package version. All `@mindees/*` packages share one locked version line. */\nexport const VERSION = '0.14.0'\n"],"mappings":";;;;;;;;;;;;;AAaA,MAAa,UAAU"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindees/cli",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "MindeesNative Forge — the `mindees` CLI: create, build (via the compiler), dev (rebuild orchestrator), doctor, info.",
   "license": "MIT OR Apache-2.0",
   "type": "module",
@@ -27,9 +27,9 @@
     "directory": "packages/cli"
   },
   "dependencies": {
-    "@mindees/core": "0.13.0",
-    "@mindees/compiler": "0.13.0",
-    "@mindees/ai": "0.13.0"
+    "@mindees/core": "0.14.0",
+    "@mindees/compiler": "0.14.0",
+    "@mindees/ai": "0.14.0"
   },
   "scripts": {
     "build": "tsdown",