kaizen-agent 1.3.1 → 1.3.3

package/README.md

@@ -15,8 +15,9 @@
 ---
 
 ```bash
-# 1. Install Bun (prerequisite)
+# 1. Install Bun (prerequisite) — macOS, Linux, WSL
 curl -fsSL https://bun.sh/install | bash
+#    Windows PowerShell: powershell -c "irm bun.sh/install.ps1 | iex"
 
 # 2. Install Kaizen
 bunx kaizen-agent
@@ -284,28 +285,58 @@ leave. Hold **Shift** and drag to select text anyway.
 
 ## Install
 
-### Prerequisites: Bun
+Kaizen's installer and interactive dashboard require [Bun](https://bun.sh) — it is
+the only prerequisite. Pick your platform:
 
-Kaizen's installer and interactive dashboard require [Bun](https://bun.sh). If you don't have Bun installed yet:
+<details open>
+<summary><b>Windows</b></summary>
+
+In PowerShell:
+
+```powershell
+# 1. Install Bun
+powershell -c "irm bun.sh/install.ps1 | iex"
+
+# 2. Reopen PowerShell so bun is on your PATH, then:
+bunx kaizen-agent
+```
+
+Git is not required. Where it is missing, kaizen copies itself into `%USERPROFILE%\kaizen`
+instead of cloning, and `bunx kaizen-agent` is also how you update. Links are made as
+directory junctions and file copies, so no administrator rights or Developer Mode are
+needed. WSL users can follow the Linux instructions instead.
+
+</details>
+
+<details>
+<summary><b>macOS</b></summary>
 
 ```bash
-# macOS, Linux, WSL
+# 1. Install Bun
 curl -fsSL https://bun.sh/install | bash
+# or: brew install oven-sh/bun/bun
 
-# or via Homebrew
-brew install oven-sh/bun/bun
-
-# or via npm
-npm install -g bun
+# 2. Install Kaizen
+bunx kaizen-agent
 ```
 
-### Install Kaizen
+</details>
+
+<details>
+<summary><b>Linux</b></summary>
 
 ```bash
+# 1. Install Bun
+curl -fsSL https://bun.sh/install | bash
+# or: npm install -g bun
+
+# 2. Install Kaizen
 bunx kaizen-agent
 ```
 
-It walks you through where to install, prompts for your workflow preset (`medium`, `low`, or `ultra`), then tells you what to type next. Restart your editor afterwards.
+</details>
+
+The installer walks you through where to install, prompts for your workflow preset (`medium`, `low`, or `ultra`), then tells you what to type next. Restart your editor afterwards.
 
 Run from inside a project it asks whether to install globally or for that project
 alone; anywhere else — your home directory, a plain folder, a script — it installs

package/cli/dashboard.ts

@@ -140,8 +140,12 @@ function readMouse(rest: string): { ev: MouseEv; len: number } | null {
 const WHEEL_UP = 64, WHEEL_DOWN = 65;
 const isClick = (e: MouseEv) => e.press && e.button === 0;
 
+// Re-sent even when this module thinks it is already armed: settings runs as an
+// action, tracks arming with its own flag, and turns reporting off in the terminal
+// on the way out. Enabling twice costs nothing; trusting the stale flag costs the
+// mouse for the rest of the session.
 function mouseOn() {
-  if (!mouseWanted || mouseArmed) return;
+  if (!mouseWanted) return;
   process.stdout.write("\x1b[?1000h\x1b[?1006h");
   mouseArmed = true;
 }
@@ -208,7 +212,9 @@ export async function dashboard(
       { key: "backlog", label: "Backlog", hint: "what runs noticed and did not do" },
     ] : []),
     { key: "settings", label: "Settings", hint: "modes, approvals, who builds" },
-    ...(state && !existsSync(join(state, "spec.md"))
+    // ~/.kaizen is the global state, not a project: there is nothing to set up
+    // there, and it never holds the spec files a project copy does.
+    ...(state && state !== join(home, ".kaizen") && !existsSync(join(state, "spec.md"))
       ? [{ key: "init", label: "Set up this project", hint: "write .kaizen/ here" }] : []),
     ...(!state ? [{ key: "init", label: "Set up this project", hint: "write .kaizen/ here" }] : []),
     { key: "upgrade", label: "Upgrade", hint: "pull, relink, clear the installer cache" },

package/cli/install.ts

@@ -6,7 +6,7 @@ import {
 } from "node:fs";
 import { join, dirname, basename } from "node:path";
 import { homedir, tmpdir } from "node:os";
-import { applyPreset, PRESETS, type PresetName } from "./settings.ts";
+import { applyPreset, detectPreset, PRESETS, type PresetName } from "./settings.ts";
 
 const home = homedir();
 const REPO_URL = "https://github.com/hfadhlullah/kaizen.git";
@@ -271,9 +271,11 @@ const root = await chooseRoot();
 const presetChoice = await choosePreset();
 const targets = found(root);
 
-async function choosePreset(): Promise<PresetName> {
+// null means "leave the config alone": an upgrade or a --yes run never asked, and
+// answering "medium" for the user overwrote whatever preset they had chosen.
+async function choosePreset(): Promise<PresetName | null> {
   if (presetArg) return presetArg;
-  if (!interactive) return "medium";
+  if (!interactive) return null;
 
   return select("Choose workflow preset", [
     {
@@ -473,10 +475,16 @@ const globalConfig = join(globalKaizen, "config.yml");
   mkdirSync(globalKaizen, { recursive: true });
   const defPath = join(repo, "skills/kaizen/config.default.yml");
   const def = readFileSync(defPath, "utf8");
-  const base = existsSync(globalConfig) ? readFileSync(globalConfig, "utf8") : def;
-  const conf = applyPreset(base, presetChoice, def);
-  writeFileSync(globalConfig, conf);
-  step(`configured ${c.bold(presetChoice)} preset in ${tilde(globalConfig)}`);
+  const existing = existsSync(globalConfig) ? readFileSync(globalConfig, "utf8") : null;
+  if (presetChoice) {
+    writeFileSync(globalConfig, applyPreset(existing ?? def, presetChoice, def));
+    step(`configured ${c.bold(presetChoice)} preset in ${tilde(globalConfig)}`);
+  } else if (!existing) {
+    writeFileSync(globalConfig, def);
+    step(`wrote ${tilde(globalConfig)}`);
+  } else {
+    step(`kept your settings in ${tilde(globalConfig)} ${c.dim(`(${detectPreset(existing, def)})`)}`);
+  }
 }
 
 // A .kaizen/ in a parent already owns this folder's state, and setting up a child

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kaizen-agent",
-  "version": "1.3.1",
+  "version": "1.3.3",
   "description": "Staged workflow for AI agents — code, writing, research, operations: plan, human approval, build, independent review, bounded fix loop.",
   "type": "module",
   "bin": {