@cat-factory/cli 0.10.1 → 0.10.2

package/README.md

@@ -3,8 +3,8 @@
 The bootstrap CLI for [cat-factory](https://github.com/kibertoad/cat-factory), the Agent
 Architecture Board. One command scaffolds a **local-mode deployment** you can run on your own
 machine: a Node/local backend (`@cat-factory/local-server`) and the frontend SPA
-(`@cat-factory/app`), mirroring the [`deploy/local`](../../../deploy/local) and
-[`deploy/frontend`](../../../deploy/frontend) example deployments in this repo, but depending on
+(`@cat-factory/app`), mirroring the [`deploy/local`](https://github.com/kibertoad/cat-factory/tree/main/deploy/local) and
+[`deploy/frontend`](https://github.com/kibertoad/cat-factory/tree/main/deploy/frontend) example deployments in this repo, but depending on
 the **published** libraries, so the generated project stands alone outside the monorepo.
 
 It does the fiddly setup for you:
@@ -38,7 +38,7 @@ It does the fiddly setup for you:
   described above.
 - **`cat-factory env`**: generates **only** a ready-to-run local-mode `.env` in the current
   directory (or `--dir`), using the same secret generation, PAT flow, and pool-vs-native choice.
-  Use it when the deployment already exists (e.g. inside [`deploy/local`](../../../deploy/local),
+  Use it when the deployment already exists (e.g. inside [`deploy/local`](https://github.com/kibertoad/cat-factory/tree/main/deploy/local),
   or an already-scaffolded project) and you just need a fresh, complete `.env`. It refuses to
   overwrite an existing `.env` unless you pass `--force`, and (like `init`) it creates or merges
   the target dir's `.gitignore` so the secret `.env` can never be committed. A model-provider key
@@ -194,15 +194,20 @@ cd local && npm install && npm run db:up && npm start     # serves :8787
 cd ../frontend && npm install && npm run dev              # Nuxt dev on :3000
 ```
 
-You still need to:
+Expect the first `npm start` to sit there a while: before it serves anything, the backend pulls
+the executor-harness image your agent jobs will run in, matched to the version it was built
+against. Later starts reuse it. The generated `.env` leaves `LOCAL_HARNESS_IMAGE` commented out
+so you stay on that matched pin; set it (or pass `--harness-image` at scaffold time) only when
+you want to lock a specific version or run your own build.
 
-- **Pull the executor image** the agent jobs run as: `docker pull ghcr.io/kibertoad/cat-factory-executor:latest`.
-- **Configure at least one model provider** in `local/.env` (the simplest is Cloudflare Workers
-  AI over REST: `CLOUDFLARE_ACCOUNT_ID` + `CLOUDFLARE_API_TOKEN`; or a direct vendor key like
-  `ANTHROPIC_API_KEY`). Without one, no model is selectable and pipelines can't start.
+The last thing to add is a **model provider**, without which the board comes up but no model is
+selectable, so no pipeline can start. The quickest is Cloudflare Workers AI over REST
+(`CLOUDFLARE_ACCOUNT_ID` + `CLOUDFLARE_API_TOKEN`); any direct vendor key works too, such as
+`ANTHROPIC_API_KEY`. Put it in `local/.env` before you start, or sign in and add it through the
+UI, whichever you prefer.
 
 The generated `README.md` repeats these steps with your chosen values, and links to the full
-[local-mode docs](../../../deploy/local/README.md) (container-runtime matrix, repo linking, the
+[local-mode docs](https://github.com/kibertoad/cat-factory/blob/main/deploy/local/README.md) (container-runtime matrix, repo linking, the
 Tester's Docker-in-Docker / ephemeral environments, the warm container pool, etc.).
 
 ## Security notes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/cli",
-  "version": "0.10.1",
+  "version": "0.10.2",
   "description": "Bootstrap CLI for the Agent Architecture Board: scaffold a local-mode deployment (Node/local backend + frontend SPA) on your own machine — generates the crypto secrets, populates and gitignores the .env files, and mints a GitHub/GitLab personal access token by opening the browser at the right pre-scoped URL.",
   "keywords": [
     "bootstrap",
@@ -37,12 +37,12 @@
     "@clack/prompts": "^1.7.0"
   },
   "devDependencies": {
-    "@types/node": "^26.1.2",
+    "@types/node": "^26.2.0",
     "typescript": "7.0.2",
     "valibot": "^1.4.2",
     "vitest": "^4.1.10",
-    "@cat-factory/contracts": "0.231.0",
-    "@cat-factory/kernel": "0.233.0"
+    "@cat-factory/contracts": "0.283.1",
+    "@cat-factory/kernel": "0.279.2"
   },
   "scripts": {
     "build": "tsc -b tsconfig.build.json",