kaizen-agent 1.34.5 → 1.34.7

package/README.md

@@ -70,6 +70,20 @@ kaizen web
 
 The board opens in your browser. The side menu holds the board, notes, the icebox of gathered requests and settings, with a light and dark switch. From there you can start a run, approve or revise its plan, pick which review findings to fix, then commit and push.
 
+Right after installing, `kaizen setup` walks you through your project, settings, this board and the phone app (it prints a QR code to scan).
+
+### Phone app
+
+The board is a PWA: installed from the browser, it opens full screen with the kaizen icon. It needs [Tailscale](https://tailscale.com/download) on this PC and on your phone, both signed in to the same account.
+
+```bash
+kaizen setup        # guided: starts the board, runs tailscale serve, prints a QR code
+```
+
+Scan the QR code with your phone camera, then **Add to Home screen** (iOS: Share menu; Android: browser menu, *Install app*).
+
+By hand: run `kaizen web`, then `tailscale serve --bg 127.0.0.1:7420`, add `<pc>.<tailnet>.ts.net` to `~/.kaizen/web-hosts`, and open `https://<pc>.<tailnet>.ts.net` on the phone. Details in [docs/guide.md](docs/guide.md#from-your-phone-tailscale). Never use `tailscale funnel` — it publishes the board to the internet.
+
 To add a launcher (Spotlight on macOS, the app menu on Linux, a Desktop shortcut on Windows), run `kaizen web --shortcut` once.
 
 ## Development

package/cli/install.ts

@@ -340,6 +340,17 @@ async function openUrl(url: string) {
   try { await Bun.$`${opener} ${url}`.quiet(); return true; } catch { return false; }
 }
 
+if (args.has("setup")) {
+  await runSetup();
+  process.exit(0);
+}
+
+async function runSetup() {
+  const s = await import("./setup.ts");
+  if (!process.stdin.isTTY) { console.log(s.manual()); return; }
+  await s.setup({ select, c, ask: (q) => prompt(q) });
+}
+
 if (wantSettings) {
   const { settings } = await import("./settings.ts");
   await settings(await resolveRepoQuietly());
@@ -908,7 +919,7 @@ function kaizenAbove() {
 }
 
 if (inProject && !kaizenAbove()) {
-  const now = root === process.cwd()
+  const now = root === process.cwd() || args.has("--init-project")
     ? true
     : interactive
       ? await select(`Set up ${basename(process.cwd())}/ for kaizen now`, [
@@ -976,9 +987,14 @@ function writePointer() {
   ${c.bold("Next")}
     1  restart Claude Code ${c.dim("— skills load live, slash commands only at session start")}
     2  ${c.cyan("/kaizen <what you want done>")} ${c.dim("in any project — it sets itself up on first run")}
+    3  ${c.cyan("kaizen setup")} ${c.dim("— settings, the board, and the phone app, any time")}
 
   ${c.dim("/kaizen-help lists every command.  kaizen upgrade updates all of this.")}
 `);
+  if (interactive && !blocked && await select("Run setup now?", [
+    { label: "Not now", hint: "kaizen setup runs it later", value: false },
+    { label: "Yes", hint: "a project folder, settings, the board, the phone", value: true },
+  ])) await runSetup();
 }
 if (blocked) process.exit(1);
 

package/cli/qr.ts

@@ -0,0 +1,243 @@
+// A QR code for a short URL, drawn with terminal half-blocks. Zero dependencies, so
+// this is the small encoder: byte mode, error correction L, versions 1-6 (up to 134
+// bytes), which is far more than a tailnet address needs.
+
+// [codewords in all, error-correction codewords per block, blocks] for ECC L.
+const VERSIONS = [[26, 7, 1], [44, 10, 1], [70, 15, 1], [100, 20, 1], [134, 26, 1], [172, 18, 2]] as const;
+const ALIGN = [[], [6, 18], [6, 22], [6, 26], [6, 30], [6, 34]];
+
+function gfMul(a: number, b: number) {
+  let r = 0;
+  for (; b; b >>= 1) { if (b & 1) r ^= a; a <<= 1; if (a & 0x100) a ^= 0x11d; }
+  return r;
+}
+
+function rsRemainder(data: number[], degree: number) {
+  const div = Array(degree).fill(0); div[degree - 1] = 1;
+  let root = 1;
+  for (let i = 0; i < degree; i++) {
+    for (let j = 0; j < degree; j++) { div[j] = gfMul(div[j], root); if (j + 1 < degree) div[j] ^= div[j + 1]; }
+    root = gfMul(root, 2);
+  }
+  const out: number[] = Array(degree).fill(0);
+  for (const b of data) {
+    const f = b ^ out.shift()!; out.push(0);
+    div.forEach((c, i) => { out[i] ^= gfMul(c, f); });
+  }
+  return out;
+}
+
+export function qrMatrix(text: string): boolean[][] {
+  const bytes = [...new TextEncoder().encode(text)];
+  const v = VERSIONS.findIndex(([total, ec, n]) => total - ec * n >= bytes.length + 2);
+  if (v < 0) throw new Error("text too long for qr()");
+  const [total, ecLen, nBlocks] = VERSIONS[v]!;
+  const dataLen = total - ecLen * nBlocks;
+  const size = 17 + 4 * (v + 1);
+
+  const bits: number[] = [];
+  const put = (val: number, n: number) => { for (let i = n - 1; i >= 0; i--) bits.push((val >>> i) & 1); };
+  put(4, 4); put(bytes.length, 8); bytes.forEach((b) => put(b, 8));
+  put(0, Math.min(4, dataLen * 8 - bits.length));
+  while (bits.length % 8) bits.push(0);
+  const data: number[] = [];
+  for (let i = 0; i < bits.length; i += 8) data.push(parseInt(bits.slice(i, i + 8).join(""), 2));
+  for (let pad = 0xec; data.length < dataLen; pad ^= 0xec ^ 0x11) data.push(pad);
+
+  const per = dataLen / nBlocks;
+  const blocks = Array.from({ length: nBlocks }, (_, i) => data.slice(i * per, (i + 1) * per));
+  const ecs = blocks.map((b) => rsRemainder(b, ecLen));
+  const words: number[] = [];
+  for (let i = 0; i < per; i++) blocks.forEach((b) => words.push(b[i]!));
+  for (let i = 0; i < ecLen; i++) ecs.forEach((e) => words.push(e[i]!));
+
+  const m: boolean[][] = Array.from({ length: size }, () => Array(size).fill(false));
+  const fn: boolean[][] = Array.from({ length: size }, () => Array(size).fill(false));
+  const set = (x: number, y: number, dark: boolean) => { m[y]![x] = dark; fn[y]![x] = true; };
+
+  for (let i = 0; i < size; i++) { set(6, i, i % 2 === 0); set(i, 6, i % 2 === 0); }
+  for (const [cx, cy] of [[3, 3], [size - 4, 3], [3, size - 4]] as const) {
+    for (let dy = -4; dy <= 4; dy++) for (let dx = -4; dx <= 4; dx++) {
+      const x = cx + dx, y = cy + dy, d = Math.max(Math.abs(dx), Math.abs(dy));
+      if (x >= 0 && x < size && y >= 0 && y < size) set(x, y, d !== 2 && d !== 4);
+    }
+  }
+  const al = ALIGN[v]!;
+  for (const cy of al) for (const cx of al) {
+    if ((cx === 6 && cy === 6) || (cx === 6 && cy === al.at(-1)) || (cx === al.at(-1) && cy === 6)) continue;
+    for (let dy = -2; dy <= 2; dy++) for (let dx = -2; dx <= 2; dx++) set(cx + dx, cy + dy, Math.max(Math.abs(dx), Math.abs(dy)) !== 1);
+  }
+
+  const format = (mask: number) => {
+    const d = (1 << 3) | mask;                       // ECC L is 01
+    let rem = d;
+    for (let i = 0; i < 10; i++) rem = (rem << 1) ^ ((rem >>> 9) * 0x537);
+    const f = ((d << 10) | rem) ^ 0x5412;
+    const bit = (i: number) => ((f >>> i) & 1) === 1;
+    for (let i = 0; i <= 5; i++) set(8, i, bit(i));
+    set(8, 7, bit(6)); set(8, 8, bit(7)); set(7, 8, bit(8));
+    for (let i = 9; i < 15; i++) set(14 - i, 8, bit(i));
+    for (let i = 0; i < 8; i++) set(size - 1 - i, 8, bit(i));
+    for (let i = 8; i < 15; i++) set(8, size - 15 + i, bit(i));
+    set(8, size - 8, true);
+  };
+  format(0);
+
+  let i = 0;
+  for (let right = size - 1; right >= 1; right -= 2) {
+    if (right === 6) right = 5;
+    for (let vert = 0; vert < size; vert++) for (let j = 0; j < 2; j++) {
+      const x = right - j, y = ((right + 1) & 2) === 0 ? size - 1 - vert : vert;
+      if (!fn[y]![x] && i < words.length * 8) { m[y]![x] = ((words[i >> 3]! >>> (7 - (i & 7))) & 1) === 1; i++; }
+    }
+  }
+
+  const MASKS = [
+    (x: number, y: number) => (x + y) % 2 === 0, (_: number, y: number) => y % 2 === 0,
+    (x: number) => x % 3 === 0, (x: number, y: number) => (x + y) % 3 === 0,
+    (x: number, y: number) => (Math.floor(x / 3) + Math.floor(y / 2)) % 2 === 0,
+    (x: number, y: number) => ((x * y) % 2) + ((x * y) % 3) === 0,
+    (x: number, y: number) => (((x * y) % 2) + ((x * y) % 3)) % 2 === 0,
+    (x: number, y: number) => (((x + y) % 2) + ((x * y) % 3)) % 2 === 0,
+  ];
+  // ponytail: penalty counts only runs and 2x2 blocks (rules 1-2 of 4); every mask
+  // decodes, this just picks a calmer one. Add the other two rules if scans fail.
+  const penalty = (g: boolean[][]) => {
+    let p = 0;
+    for (let a = 0; a < size; a++) for (const row of [true, false]) {
+      let run = 1;
+      for (let b = 1; b < size; b++) {
+        const same = row ? g[a]![b] === g[a]![b - 1] : g[b]![a] === g[b - 1]![a];
+        run = same ? run + 1 : 1;
+        if (run === 5) p += 3; else if (run > 5) p++;
+      }
+    }
+    for (let y = 0; y < size - 1; y++) for (let x = 0; x < size - 1; x++) {
+      if (g[y]![x] === g[y]![x + 1] && g[y]![x] === g[y + 1]![x] && g[y]![x] === g[y + 1]![x + 1]) p += 3;
+    }
+    return p;
+  };
+  const masked = (k: number) => m.map((row, y) => row.map((d, x) => (!fn[y]![x] && MASKS[k]!(x, y) ? !d : d)));
+  let best = 0, bestP = Infinity;
+  for (let k = 0; k < 8; k++) { const p = penalty(masked(k)); if (p < bestP) { bestP = p; best = k; } }
+  format(best);
+  return masked(best);
+}
+
+export function qrMatrix(text: string): boolean[][] {
+  const bytes = [...new TextEncoder().encode(text)];
+  const v = VERSIONS.findIndex(([total, ec, n]) => total - ec * n >= bytes.length + 2);
+  if (v < 0) throw new Error("text too long for qr()");
+  const [total, ecLen, nBlocks] = VERSIONS[v]!;
+  const dataLen = total - ecLen * nBlocks;
+  const size = 17 + 4 * (v + 1);
+
+  const bits: number[] = [];
+  const put = (val: number, n: number) => { for (let i = n - 1; i >= 0; i--) bits.push((val >>> i) & 1); };
+  put(4, 4); put(bytes.length, 8); bytes.forEach((b) => put(b, 8));
+  put(0, Math.min(4, dataLen * 8 - bits.length));
+  while (bits.length % 8) bits.push(0);
+  const data: number[] = [];
+  for (let i = 0; i < bits.length; i += 8) data.push(parseInt(bits.slice(i, i + 8).join(""), 2));
+  for (let pad = 0xec; data.length < dataLen; pad ^= 0xec ^ 0x11) data.push(pad);
+
+  const per = dataLen / nBlocks;
+  const blocks = Array.from({ length: nBlocks }, (_, i) => data.slice(i * per, (i + 1) * per));
+  const ecs = blocks.map((b) => rsRemainder(b, ecLen));
+  const words: number[] = [];
+  for (let i = 0; i < per; i++) blocks.forEach((b) => words.push(b[i]!));
+  for (let i = 0; i < ecLen; i++) ecs.forEach((e) => words.push(e[i]!));
+
+  const m: boolean[][] = Array.from({ length: size }, () => Array(size).fill(false));
+  const fn: boolean[][] = Array.from({ length: size }, () => Array(size).fill(false));
+  const set = (x: number, y: number, dark: boolean) => { m[y]![x] = dark; fn[y]![x] = true; };
+
+  for (let i = 0; i < size; i++) { set(6, i, i % 2 === 0); set(i, 6, i % 2 === 0); }
+  for (const [cx, cy] of [[3, 3], [size - 4, 3], [3, size - 4]] as const) {
+    for (let dy = -4; dy <= 4; dy++) for (let dx = -4; dx <= 4; dx++) {
+      const x = cx + dx, y = cy + dy, d = Math.max(Math.abs(dx), Math.abs(dy));
+      if (x >= 0 && x < size && y >= 0 && y < size) set(x, y, d !== 2 && d !== 4);
+    }
+  }
+  const al = ALIGN[v]!;
+  for (const cy of al) for (const cx of al) {
+    if ((cx === 6 && cy === 6) || (cx === 6 && cy === al.at(-1)) || (cx === al.at(-1) && cy === 6)) continue;
+    for (let dy = -2; dy <= 2; dy++) for (let dx = -2; dx <= 2; dx++) set(cx + dx, cy + dy, Math.max(Math.abs(dx), Math.abs(dy)) !== 1);
+  }
+
+  const format = (mask: number) => {
+    const d = (1 << 3) | mask;                       // ECC L is 01
+    let rem = d;
+    for (let i = 0; i < 10; i++) rem = (rem << 1) ^ ((rem >>> 9) * 0x537);
+    const f = ((d << 10) | rem) ^ 0x5412;
+    const bit = (i: number) => ((f >>> i) & 1) === 1;
+    for (let i = 0; i <= 5; i++) set(8, i, bit(i));
+    set(8, 7, bit(6)); set(8, 8, bit(7)); set(7, 8, bit(8));
+    for (let i = 9; i < 15; i++) set(14 - i, 8, bit(i));
+    for (let i = 0; i < 8; i++) set(size - 1 - i, 8, bit(i));
+    for (let i = 8; i < 15; i++) set(8, size - 15 + i, bit(i));
+    set(8, size - 8, true);
+  };
+  format(0);
+
+  let i = 0;
+  for (let right = size - 1; right >= 1; right -= 2) {
+    if (right === 6) right = 5;
+    for (let vert = 0; vert < size; vert++) for (let j = 0; j < 2; j++) {
+      const x = right - j, y = ((right + 1) & 2) === 0 ? size - 1 - vert : vert;
+      if (!fn[y]![x] && i < words.length * 8) { m[y]![x] = ((words[i >> 3]! >>> (7 - (i & 7))) & 1) === 1; i++; }
+    }
+  }
+
+  const MASKS = [
+    (x: number, y: number) => (x + y) % 2 === 0, (_: number, y: number) => y % 2 === 0,
+    (x: number) => x % 3 === 0, (x: number, y: number) => (x + y) % 3 === 0,
+    (x: number, y: number) => (Math.floor(x / 3) + Math.floor(y / 2)) % 2 === 0,
+    (x: number, y: number) => ((x * y) % 2) + ((x * y) % 3) === 0,
+    (x: number, y: number) => (((x * y) % 2) + ((x * y) % 3)) % 2 === 0,
+    (x: number, y: number) => (((x + y) % 2) + ((x * y) % 3)) % 2 === 0,
+  ];
+  // ponytail: penalty counts only runs and 2x2 blocks (rules 1-2 of 4); every mask
+  // decodes, this just picks a calmer one. Add the other two rules if scans fail.
+  const penalty = (g: boolean[][]) => {
+    let p = 0;
+    for (let a = 0; a < size; a++) for (const row of [true, false]) {
+      let run = 1;
+      for (let b = 1; b < size; b++) {
+        const same = row ? g[a]![b] === g[a]![b - 1] : g[b]![a] === g[b - 1]![a];
+        run = same ? run + 1 : 1;
+        if (run === 5) p += 3; else if (run > 5) p++;
+      }
+    }
+    for (let y = 0; y < size - 1; y++) for (let x = 0; x < size - 1; x++) {
+      if (g[y]![x] === g[y]![x + 1] && g[y]![x] === g[y + 1]![x] && g[y]![x] === g[y + 1]![x + 1]) p += 3;
+    }
+    return p;
+  };
+  const masked = (k: number) => m.map((row, y) => row.map((d, x) => (!fn[y]![x] && MASKS[k]!(x, y) ? !d : d)));
+  let best = 0, bestP = Infinity;
+  for (let k = 0; k < 8; k++) { const p = penalty(masked(k)); if (p < bestP) { bestP = p; best = k; } }
+  format(best);
+  const out = masked(best);
+  // masked() copied the format bits drawn for mask 0; redraw them into the result.
+  const fm = m;
+  for (let y = 0; y < size; y++) for (let x = 0; x < size; x++) if (fn[y]![x]) out[y]![x] = fm[y]![x]!;
+  return out;
+}
+
+// Light modules are the filled blocks, so a dark terminal shows dark modules on a
+// white field with a two-module quiet zone, which is what phone cameras expect.
+export function qr(text: string): string {
+  const g = qrMatrix(text), q = 2, n = g.length + 2 * q;
+  const dark = (x: number, y: number) => g[y - q]?.[x - q] === true;
+  const lines: string[] = [];
+  for (let y = 0; y < n; y += 2) {
+    let line = "";
+    for (let x = 0; x < n; x++) {
+      const t = dark(x, y), b = y + 1 < n && dark(x, y + 1);
+      line += t ? (b ? " " : "▄") : (b ? "▀" : "█");
+    }
+    lines.push(line);
+  }
+  return lines.join("\n");
+}

package/cli/setup.test.ts

@@ -0,0 +1,57 @@
+import { test, expect } from "bun:test";
+import { mkdtempSync, rmSync, existsSync, readdirSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { qrMatrix, qr } from "./qr.ts";
+import { tailnetName } from "./setup.ts";
+
+test("qr: right size per version, finder squares in three corners, deterministic", () => {
+  const a = qrMatrix("https://pc.tail1234.ts.net");        // 26 bytes: version 2, 25 modules
+  expect(a.length).toBe(25);
+  for (const [x, y] of [[0, 0], [18, 0], [0, 18]] as const) {
+    expect(a[y]![x]).toBe(true); expect(a[y + 3]![x + 3]).toBe(true); expect(a[y + 1]![x + 1]).toBe(false);
+  }
+  expect(qr("https://pc.tail1234.ts.net")).toBe(qr("https://pc.tail1234.ts.net"));
+  expect(qrMatrix("https://a.b").length).toBe(21);          // version 1
+  expect(qrMatrix("x".repeat(130)).length).toBe(41);        // version 6
+  expect(() => qrMatrix("x".repeat(200))).toThrow();
+  const lines = qr("https://a.b").split("\n");
+  expect(lines.length).toBe(13);                            // (21 + 4 quiet) / 2 rows, rounded up
+  expect(new Set(lines.map((l) => l.length))).toEqual(new Set([25]));
+});
+
+test("tailnetName: the machine's DNS name only when Tailscale is running", () => {
+  const up = JSON.stringify({ BackendState: "Running", Self: { DNSName: "PC.tail1234.ts.net." } });
+  expect(tailnetName(up)).toBe("pc.tail1234.ts.net");
+  expect(tailnetName(JSON.stringify({ BackendState: "NeedsLogin", Self: { DNSName: "pc.x.ts.net." } }))).toBeNull();
+  expect(tailnetName(JSON.stringify({ BackendState: "Running" }))).toBeNull();
+  expect(tailnetName("not json")).toBeNull();
+});
+
+// Scratch HOME only: setup must never touch the real ~/.kaizen.
+test("kaizen setup without a terminal prints the manual steps and writes nothing", async () => {
+  const homeDir = mkdtempSync(join(tmpdir(), "kaizen-setup-"));
+  try {
+    const p = Bun.spawn([process.execPath, join(import.meta.dir, "install.ts"), "setup"], {
+      cwd: homeDir, env: { ...process.env, HOME: homeDir, USERPROFILE: homeDir }, stdin: "ignore", stdout: "pipe", stderr: "pipe",
+    });
+    const out = await new Response(p.stdout).text();
+    expect(await p.exited).toBe(0);
+    expect(out).toContain("tailscale serve --bg 127.0.0.1:7420");
+    expect(readdirSync(homeDir)).toEqual([]);
+    expect(existsSync(join(homeDir, ".kaizen"))).toBe(false);
+  } finally { rmSync(homeDir, { recursive: true, force: true }); }
+});
+
+test("web-hosts: names are normalized, deduped and merged with the env var", async () => {
+  const homeDir = mkdtempSync(join(tmpdir(), "kaizen-hosts2-"));
+  try {
+    const p = Bun.spawn([process.execPath, "-e", `
+      const s = await import(${JSON.stringify(join(import.meta.dir, "state.ts"))});
+      s.addWebHost("PC.Tail1.ts.net"); s.addWebHost("pc.tail1.ts.net");
+      console.log(JSON.stringify([...s.webHosts()].sort()));`], {
+      env: { ...process.env, HOME: homeDir, USERPROFILE: homeDir, KAIZEN_WEB_HOSTS: "Env.ts.net:443" }, stdout: "pipe",
+    });
+    expect(JSON.parse(await new Response(p.stdout).text())).toEqual(["env.ts.net", "pc.tail1.ts.net"]);
+  } finally { rmSync(homeDir, { recursive: true, force: true }); }
+});

package/cli/setup.ts

@@ -0,0 +1,108 @@
+// `kaizen setup`: the walk after install — a project, the settings, the board, the
+// phone. Every step can be skipped, and nothing changes without an answer.
+import { existsSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { addWebHost, home, remember } from "./state.ts";
+import { applyPreset, detectPreset } from "./settings.ts";
+import { qr } from "./qr.ts";
+
+const PORT = 7420;
+const INSTALL = join(import.meta.dir, "install.ts");
+
+export type Ui = {
+  select: <T>(q: string, o: { label: string; hint: string; value: T }[]) => Promise<T>;
+  ask: (q: string) => string | null;
+  c: Record<"dim" | "bold" | "cyan" | "green", (s: string) => string>;
+};
+
+// The DNS name `tailscale status --json` reports for this machine, or null when
+// Tailscale is not running or not logged in.
+export function tailnetName(json: string): string | null {
+  try {
+    const s = JSON.parse(json);
+    const name = String(s?.Self?.DNSName ?? "").replace(/\.$/, "").toLowerCase();
+    return s?.BackendState === "Running" && name ? name : null;
+  } catch { return null; }
+}
+
+// A folder already inside a project (.git or .kaizen on the way up to home).
+function inProject(dir: string) {
+  for (let d = dir; d !== home; ) {
+    if (existsSync(join(d, ".git")) || existsSync(join(d, ".kaizen"))) return true;
+    const up = resolve(d, "..");
+    if (up === d) return false;
+    d = up;
+  }
+  return false;
+}
+
+export function manual() {
+  return `
+  kaizen setup needs a terminal. By hand:
+    kaizen settings                         pick a preset
+    kaizen web                              the board
+    tailscale serve --bg 127.0.0.1:${PORT}      phone, then add the name it prints to ~/.kaizen/web-hosts
+`;
+}
+
+export async function setup(ui: Ui) {
+  const { c, select } = ui;
+  const out = (s = "") => console.log(s);
+  const run = (cmd: string[], cwd?: string) => Bun.spawnSync(cmd, { cwd, stdin: "inherit", stdout: "inherit", stderr: "inherit" }).exitCode === 0;
+
+  out(`\n  ${c.bold("kaizen setup")}  ${c.dim("three short steps, each can be skipped")}`);
+
+  // 1 -- project
+  if (!inProject(process.cwd())) {
+    out(`\n  ${c.bold("1  Project")}  ${c.dim("kaizen keeps its runs in a .kaizen/ folder inside your project")}`);
+    for (let tries = 0; tries < 2; tries++) {
+      const typed = ui.ask("  Project folder (Enter to skip): ")?.trim();
+      if (!typed) break;
+      const dir = resolve(typed.replace(/^~(?=$|[\\/])/, home));
+      if (dir === home || !existsSync(dir) || !statSync(dir).isDirectory()) { out(`  ${c.dim(`${typed}: not a folder`)}`); continue; }
+      const r = Bun.spawnSync([process.execPath, INSTALL, "--yes", "--init-project"], { cwd: dir });
+      if (r.exitCode === 0 && existsSync(join(dir, ".kaizen"))) { remember(dir); out(`  ${c.green("+")} set up ${dir}`); }
+      else out(`  ${c.dim(`could not set up ${dir}`)}`);
+      break;
+    }
+  }
+
+  // 2 -- settings
+  const defaults = readFileSync(join(import.meta.dir, "..", "skills/kaizen/config.default.yml"), "utf8");
+  const file = join(home, ".kaizen", "config.yml");
+  const current = existsSync(file) ? readFileSync(file, "utf8") : defaults;
+  const now = detectPreset(current, defaults);
+  const preset = await select(`2  Settings  (now: ${now})`, [
+    { label: "Keep", hint: "leave them as they are", value: null },
+    { label: "Medium", hint: "balanced — subagents, plan approval, auto-fix high/critical", value: "medium" as const },
+    { label: "Low", hint: "inline and manual — lite runner, manual approvals, no auto-fix", value: "low" as const },
+    { label: "Ultra", hint: "autonomous — auto mode, auto-fix all findings", value: "ultra" as const },
+  ]);
+  if (preset) { writeFileSync(file, applyPreset(current, preset, defaults)); out(`  ${c.green("+")} ${preset} preset in ~/.kaizen/config.yml`); }
+  out(`  ${c.dim("every setting: kaizen settings, or the gear on the board")}`);
+
+  // 3 -- board
+  out(`\n  ${c.bold("3  Board")}`);
+  run([process.execPath, INSTALL, "web", "--daemon"]);
+
+  // 4 -- phone
+  out(`\n  ${c.bold("4  Phone")}  ${c.dim("the board on your phone, over Tailscale")}`);
+  let name: string | null = null;
+  try { name = tailnetName(Bun.spawnSync(["tailscale", "status", "--json"]).stdout.toString()); } catch { /* not installed */ }
+  if (!name) {
+    out(`  Tailscale is not running here. Install it on this PC and your phone (${c.cyan("https://tailscale.com/download")}),`);
+    out(`  sign in on both, then run ${c.cyan("kaizen setup")} again.\n`);
+    return;
+  }
+  const yes = await select(`Run tailscale serve so your phone can reach the board?`, [
+    { label: "Not now", hint: "nothing changes", value: false },
+    { label: "Yes", hint: `tailscale serve --bg 127.0.0.1:${PORT} — private to your tailnet`, value: true },
+  ]);
+  if (!yes) { out(); return; }
+  if (!run(["tailscale", "serve", "--bg", `127.0.0.1:${PORT}`])) { out(`  ${c.dim("tailscale serve failed — see its message above")}\n`); return; }
+  addWebHost(name);
+  const url = `https://${name}`;
+  out(`\n${qr(url)}\n\n  Scan with your phone camera, or open ${c.cyan(url)}`);
+  out(`  Then choose Add to Home screen: it opens full screen with the kaizen icon.`);
+  out(`  ${c.dim("Anyone on your tailnet who can reach this PC can drive your agents; restrict it with Tailscale ACLs.")}\n`);
+}

package/cli/state.test.ts

@@ -1019,7 +1019,7 @@ test("the board refuses an upgrade from another origin", async () => {
 });
 
 // KAIZEN_WEB_HOSTS (tailscale serve): the listed host gets in, any other is still refused.
-test("the board answers only the hosts listed in KAIZEN_WEB_HOSTS", async () => {
+test("the board answers only the hosts listed in KAIZEN_WEB_HOSTS or web-hosts", async () => {
   const homeDir = mkdtempSync(join(tmpdir(), "kaizen-hosts-"));
   for (const d of [join(homeDir, ".kaizen"), join(homeDir, ".claude")]) mkdirSync(d, { recursive: true });
   const port = 20000 + Math.floor(Math.random() * 20000), repo = join(import.meta.dir, "..");
@@ -1032,6 +1032,10 @@ test("the board answers only the hosts listed in KAIZEN_WEB_HOSTS", async () =>
     expect((await fetch(at + "/state", { headers: { host: "pc.tail1234.ts.net" } })).status).toBe(200);
     expect((await fetch(at + "/state", { headers: { host: "evil.example" } })).status).toBe(403);
     expect((await fetch(at + "/state", { headers: { host: "other.tail1234.ts.net" } })).status).toBe(403);
+    // ~/.kaizen/web-hosts (written by `kaizen setup`) is read per request: no restart.
+    writeFileSync(join(homeDir, ".kaizen", "web-hosts"), "# phone\nOther.tail1234.ts.net\n");
+    expect((await fetch(at + "/state", { headers: { host: "other.tail1234.ts.net" } })).status).toBe(200);
+    expect((await fetch(at + "/state", { headers: { host: "evil.example" } })).status).toBe(403);
     expect((await fetch(at + "/upgrade", { method: "POST", headers: { origin: "https://evil.example" } })).status).toBe(403);
     const m = await fetch(at + "/manifest.webmanifest");
     expect(m.status).toBe(200);

package/cli/state.ts

@@ -277,6 +277,22 @@ if ($o -match '"pane_id":"([^"]*)"') { & ${q(herdr)} pane run $Matches[1] ${q(ty
 // read and corrected in an editor; blanks and # lines ignored.
 export const REGISTRY = join(home, ".kaizen", "projects");
 
+// Names the board answers to besides loopback: KAIZEN_WEB_HOSTS and ~/.kaizen/web-hosts
+// (one per line, written by `kaizen setup`). Read on every call, so a name added while
+// the board runs works at once. Exact match only; a port or case is ignored.
+export const WEB_HOSTS = join(home, ".kaizen", "web-hosts");
+export function webHosts(): Set<string> {
+  const raw = (process.env.KAIZEN_WEB_HOSTS ?? "").split(",");
+  try { raw.push(...readFileSync(WEB_HOSTS, "utf8").split("\n")); } catch { /* none yet */ }
+  return new Set(raw.map((s) => s.trim().toLowerCase().replace(/:\d+$/, "")).filter((l) => l && !l.startsWith("#")));
+}
+export function addWebHost(name: string) {
+  name = name.trim().toLowerCase();
+  if (!name || webHosts().has(name)) return;
+  mkdirSync(dirname(WEB_HOSTS), { recursive: true });
+  appendFileSync(WEB_HOSTS, name + "\n");
+}
+
 // Windows spreads work across drives -- the profile on C:, the projects on D: or E: --
 // and a search that only knows $HOME finds none of them. Every letter that answers is
 // a root worth walking; elsewhere there is one filesystem and $HOME is where work

package/cli/web.ts

@@ -7,7 +7,7 @@ import {
   readInbox, writeInbox, replaceIdea, moveIdea, abandonRun, launchRun, parseItem, agentChoices, projectOf, KNOWN_AGENTS, plainModel, short, setArchived, writeNotes,
   appendNote, saveAttachment, pidOnPort, readText, cmdExe, sysExe, powershellExe, runGit, cardsGit, readCommit, commitPush, notice, notifier, LOGO,
   reviewFindings, pickFindings, fixPrompt, approvalPrompt, canApproveAwaiting, nativePath, closeSessions, sweepSessions, issueUrl,
-  launchMode, readSessions, ownerOf, resumePrompt, runAgent, firstSession,
+  launchMode, readSessions, ownerOf, resumePrompt, runAgent, firstSession, webHosts,
 } from "./state.ts";
 import { attachPty, writePty, resizePty, ptyState, ptyKeys, adoptLoginEnv } from "./pty.ts";
 import { readSources, addSource, removeSource, moveSource, setCategory, setWriteback, readIcebox, promote, dismiss, restore, markDone, markReplied, gatherSource, freshImages, gatherAll, gatherDirs, due, socialUrl, socialOf } from "./sources.ts";
@@ -132,10 +132,9 @@ export async function web(repoDir: string, opts: Opts = {}) {
     : [cur]
   ).filter((d, i, arr) => arr.indexOf(d) === i && existsSync(d));
 
-  // Hostnames the user put in KAIZEN_WEB_HOSTS (e.g. a `tailscale serve` name):
-  // their explicit opt-in, matched exactly, empty when unset.
-  const extraHosts = new Set((process.env.KAIZEN_WEB_HOSTS ?? "").split(",")
-    .map((s) => s.trim().toLowerCase().replace(/:\d+$/, "")).filter(Boolean));
+  // Hostnames the user opted into (KAIZEN_WEB_HOSTS or ~/.kaizen/web-hosts, e.g. a
+  // `tailscale serve` name): matched exactly, empty when neither is set.
+  const extraHosts = { has: (h: string) => webHosts().has(h) };
 
   // Any tab on this machine can reach loopback. GET only reads the user's own
   // files, but a POST from a page on the wider web must not write them.

package/package.json

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

package/web/board.html

@@ -24,6 +24,8 @@
 @media(prefers-color-scheme:dark){:root:not([data-theme=light]){--shade:rgb(0 0 0/.45);--canvas:color-mix(in srgb,var(--bg) 70%,black)}}
 :root[data-theme=dark]{--shade:rgb(0 0 0/.45);--canvas:color-mix(in srgb,var(--bg) 70%,black)}
 body{margin:0;background:var(--canvas);color:var(--ink);font:13px/1.5 var(--font);-webkit-font-smoothing:antialiased;height:100vh;height:100dvh;overflow:hidden;display:flex}
+html{background:var(--canvas)}
+@media(display-mode:standalone){body{position:fixed;inset:0;height:auto}}
 button,input,select{font:inherit;color:inherit;background:none;border:0;padding:0}
 button{cursor:pointer}
 :focus-visible{outline:2px solid var(--accent);outline-offset:2px}
@@ -189,7 +191,7 @@ section h2 .clear{margin-left:auto;min-height:22px;padding:0 8px}
 .notes{display:flex;flex-direction:column;gap:8px}
 #pbody img{max-width:100%;border-radius:var(--r-s)}
 /* the in-card agent: a wider panel, and the terminal filling its body */
-aside.wide{width:100%;border-left:0}#pbody:has(.term){display:flex;flex-direction:column}#pbody .term{flex:1;min-height:0;min-height:320px;background:var(--bg);border-radius:var(--r-s)}#pbody .term .xterm{height:100%;padding:4px}#pbody .term .xterm-viewport{background:transparent!important}.termkeys{padding:6px 0}.termkeys button{height:52px;padding:0;border:1px solid var(--line);border-bottom-width:4px;border-radius:10px;background:var(--bg-2);color:var(--ink-hi);font:600 17px var(--mono);touch-action:manipulation}.termkeys button:active{transform:translateY(2px);border-bottom-width:2px;background:var(--hover)}.termkeys button.on{color:var(--on-accent);background:var(--accent);border-color:var(--accent)}.keygrid{display:grid;grid-template-columns:repeat(6,1fr);gap:8px}.ctrlpad{margin-bottom:8px}.ctrlpad div{display:flex;gap:4px;margin-bottom:5px}.ctrlpad div:nth-child(2){padding:0 5%}.ctrlpad div:nth-child(3){padding:0 10%}.ctrlpad button{flex:1;min-width:0;height:44px;font-size:15px}.termkeys [hidden]{display:none}.termkeys .keyhide{display:block;width:100%;height:30px;margin-bottom:6px;border-bottom-width:1px;font-size:14px}
+aside.wide{width:100%;border-left:0}#pbody:has(.term){display:flex;flex-direction:column}#pbody .term{flex:1;min-height:0;min-height:320px;background:var(--bg);border-radius:var(--r-s)}#pbody .term .xterm{height:100%;padding:4px}#pbody .term .xterm-viewport{background:transparent!important}.termkeys{padding:6px 0}.termkeys button{height:52px;padding:0;border:1px solid var(--line);border-bottom-width:4px;border-radius:10px;background:var(--bg-2);color:var(--ink-hi);font:600 17px var(--mono);touch-action:manipulation}.termkeys button:active{transform:translateY(2px);border-bottom-width:2px;background:var(--hover)}.termkeys button.on{color:var(--on-accent);background:var(--accent);border-color:var(--accent)}.keygrid{display:grid;grid-template-columns:repeat(6,1fr);gap:8px}.ctrlpad{margin-bottom:8px}.ctrlpad div{display:flex;gap:4px;margin-bottom:5px}.ctrlpad div:nth-child(2){padding:0 5%}.ctrlpad div:nth-child(3){padding:0 10%}.ctrlpad button{flex:1;min-width:0;height:44px;font-size:15px}.termkeys [hidden]{display:none}.keytop{display:flex;gap:8px;margin-bottom:6px}.keytop button{flex:1;height:30px;border-bottom-width:1px;font-size:14px}
 .desc{border-bottom:1px solid var(--line);padding-bottom:6px;margin-bottom:14px}.desc h3{margin-top:14px}
 .chat{display:flex;flex-direction:column;gap:10px;margin:0 0 14px}.msg{border:1px solid var(--line);border-radius:var(--r);padding:10px 12px;background:var(--bg)}.msg time{display:block;font-size:11px;color:var(--dim);margin-bottom:4px}.msg p:last-child{margin-bottom:0}.msg img{max-width:100%;max-height:260px;border-radius:var(--r-s);display:block;margin:4px 0}
 .notes .tools{display:flex;gap:6px;align-items:center}.notes .tools span{flex:1;font-size:11px;color:var(--dim)}.notes .att{font-size:11px;color:var(--dim)}

package/web/board.js

@@ -1,4 +1,4 @@
-/* kaizen board 1188e8a22cfa1a37 -- generated by bun run build:web from web/board/main.ts; do not edit */
+/* kaizen board 15a573a6194b8517 -- generated by bun run build:web from web/board/main.ts; do not edit */
 (()=>{var a={S:{project:null,projects:[],cards:[],now:Date.now(),all:!1},all:new URLSearchParams(location.search).get("all")!=="0",dir:null,openKey:null,mode:null,modeKey:null,menuKey:null,tab:"request",lastTab:"request",runDoc:null,clearMenu:!1,wantTerm:null,setQ:"",pageGen:0,PL:[],shown:new Set((()=>{try{return JSON.parse(localStorage.getItem("kz-show"))||[]}catch(e){return[]}})())};var t=(e)=>document.getElementById(e),p=(e)=>String(e).replace(/[&<>"]/g,(n)=>({"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;"})[n]),T=(e)=>`<svg><use href="#i-${e}"/></svg>`;var en;function S(e,n){let s=t("toast");if(s.textContent=e,s.classList.toggle("rep",!!n),n){let l=document.createElement("a");l.href="/issue?"+new URLSearchParams(n),l.target="_blank",l.rel="noopener",l.textContent="Report",s.append(" ",l)}s.classList.add("on"),clearTimeout(en),en=setTimeout(()=>s.classList.remove("on"),n?8000:4000)}function me(){try{if(typeof Notification<"u"&&Notification.permission==="default")Notification.requestPermission()}catch(e){}}function tn(e){try{if(typeof Notification<"u"&&Notification.permission==="granted")new Notification("kaizen",{body:e,icon:"/logo.png"})}catch(n){}}var Vn="https://cdn.jsdelivr.net/npm/@huggingface/transformers@4.3.0",nn={tiny:"onnx-community/whisper-tiny",base:"onnx-community/whisper-base",small:"onnx-community/whisper-small","large-v3-turbo":"onnx-community/whisper-large-v3-turbo"},$t=null,Jn=`import{pipeline}from"${Vn}";let asr=null;
 onmessage=async e=>{const m=e.data;try{
  if(m.type==="load"){const prog=p=>{if(p.status==="progress")postMessage({type:"progress",file:p.file,pct:p.progress||0})};

package/web/notebook.js

@@ -1,4 +1,4 @@
-/* kaizen notebook 1188e8a22cfa1a37 -- generated by bun run build:web from web/notebook.ts; do not edit */
+/* kaizen notebook 15a573a6194b8517 -- generated by bun run build:web from web/notebook.ts; do not edit */
 var Ss=[],ua=[];(()=>{let e="lc,34,7n,7,7b,19,,,,2,,2,,,20,b,1c,l,g,,2t,7,2,6,2,2,,4,z,,u,r,2j,b,1m,9,9,,o,4,,9,,3,,5,17,3,1n,9,16,o,,x,1i,3,,i,,7,a,2,t,3,1k,,,7,2,2,2,3,9,,a,2,q,,2,3,1k,,,5,4,2,2,3,3,,u,2,3,,b,3,1k,,,8,,3,,3,k,2,m,6,,3,1k,,,7,2,2,2,3,7,3,a,2,u,,1n,5,3,3,,4,9,,14,5,1j,,,7,,3,,4,7,2,b,2,t,3,1k,,,7,,3,,4,7,2,b,2,f,,c,4,1j,2,,7,,3,,4,9,,a,2,t,3,1y,,4,6,,,,8,i,2,1p,,,8,c,8,2q,,,a,b,7,21,2,r,,,,,,4,2,1d,k,,2,5,b,,10,9,,2u,b,,6,n,4,4,3,g,4,d,,,3,6,,f,,jj,3,qa,4,s,3,t,2,u,2,1s,w,9,,19,3,,,39,2,y,,3a,c,4,c,63,5,1l,a,,,,,2,o,2,,1c,1a,2,c,k,5,1b,h,12,9,c,3,u,d,1k,e,1c,k,48,3,,l,4,,6,,2,3,5i,1s,ek,,5f,x,2da,3,3x,,2o,w,fe,6,2x,2,n9w,4,,a,w,2,28,2,7k,,3,,4,,n,5,4,,2b,2,1e,i,q,i,d,,12,8,p,d,18,4,1b,e,10,,1v,e,c,,8,2,1a,,1f,,,3,2,2,5,2,,,15,5,5,2,6k,8,,2,fn4,,kh,g,g,g,a6,2,gt,,6a,,45,5,1ae,3,,2,5,4,14,3,4,,4l,2,fx,4,1t,5,8t,2,25,6,1y,b,1d,4,3e,3,1h,f,15,,2,2,a,4,19,b,7,,1p,3,10,e,g,2,18,,c,3,1c,e,8,4,,2,2k,c,6,,2,,4d,c,l,4,1j,2,,7,2,2,2,3,9,,a,2,2,7,3,5,1v,9,,,2,,,4,,5,,,e,2,2a,i,n,,29,k,6j,7,2,9,r,2,2a,h,2y,d,2t,3,2,a,74,f,6t,6,,2,2,4,,,,2,3x,7,2,7,3,,s,a,14,7,,4,8,,9,b,1a,g,5i,8,5j,8,,8,2a,m,,e,3e,6,3,,,2,,7,,,1u,5,,2,,5,9n,4,9,2,,,1c,7,3,5,n,,44l,,6,f,8ug,i,1xc,5,1n,7,t4,,,1j,7,4,29,,b,2,f57,2,3mp,1a,2,n,f2,5,3,6,8,8,2,7,u,4,44,3,1iz,1j,4,1e,8,,e,,m,5,,f,11s,7,,h,2,7,,2,,5,2s,,4g,7,af,,1p,4,e4,4,72,2,6r,,2,,7,2,5,,d6,7,31,7,240,5".split(",").map((t)=>t?parseInt(t,36):1);for(let t=0,i=0;t<e.length;t++)(t%2?ua:Ss).push(i=i+e[t])})();function op(e){if(e<768)return!1;for(let t=0,i=Ss.length;;){let n=t+i>>1;if(e<Ss[n])i=n;else if(e>=ua[n])t=n+1;else return!0;if(t==i)return!1}}function ha(e){return e>=127462&&e<=127487}var fa=8205;function da(e,t,i=!0,n=!0){return(i?Oa:lp)(e,t,n)}function Oa(e,t,i){if(t==e.length)return t;if(t&&pa(e.charCodeAt(t))&&ma(e.charCodeAt(t-1)))t--;let n=bs(e,t);t+=ca(n);while(t<e.length){let r=bs(e,t);if(n==fa||r==fa||i&&op(r))t+=ca(r),n=r;else if(ha(r)){let s=0,o=t-2;while(o>=0&&ha(bs(e,o)))s++,o-=2;if(s%2==0)break;else t+=2}else break}return t}function lp(e,t,i){while(t>1){let n=Oa(e,t-2,i);if(n<t)return n;t--}return 0}function bs(e,t){let i=e.charCodeAt(t);if(!ma(i)||t+1==e.length)return i;let n=e.charCodeAt(t+1);if(!pa(n))return i;return(i-55296<<10)+(n-56320)+65536}function pa(e){return e>=56320&&e<57344}function ma(e){return e>=55296&&e<56320}function ca(e){return e<65536?1:2}class _{lineAt(e){if(e<0||e>this.length)throw RangeError(`Invalid position ${e} in document of length ${this.length}`);return this.lineInner(e,!1,1,0)}line(e){if(e<1||e>this.lines)throw RangeError(`Invalid line number ${e} in ${this.lines}-line document`);return this.lineInner(e,!0,1,0)}replace(e,t,i){[e,t]=vi(this,e,t);let n=[];if(this.decompose(0,e,n,2),i.length)i.decompose(0,i.length,n,3);return this.decompose(t,this.length,n,1),ft.from(n,this.length-(t-e)+i.length)}append(e){return this.replace(this.length,this.length,e)}slice(e,t=this.length){[e,t]=vi(this,e,t);let i=[];return this.decompose(e,t,i,0),ft.from(i,t-e)}eq(e){if(e==this)return!0;if(e.length!=this.length||e.lines!=this.lines)return!1;let t=this.scanIdentical(e,1),i=this.length-this.scanIdentical(e,-1),n=new wi(this),r=new wi(e);for(let s=t,o=t;;){if(n.next(s),r.next(s),s=0,n.lineBreak!=r.lineBreak||n.done!=r.done||n.value!=r.value)return!1;if(o+=n.value.length,n.done||o>=i)return!0}}iter(e=1){return new wi(this,e)}iterRange(e,t=this.length){return new Ts(this,e,t)}iterLines(e,t){let i;if(e==null)i=this.iter();else{if(t==null)t=this.lines+1;let n=this.line(e).from;i=this.iterRange(n,Math.max(n,t==this.lines+1?this.length:t<=1?0:this.line(t-1).to))}return new As(i)}toString(){return this.sliceString(0)}toJSON(){let e=[];return this.flatten(e),e}constructor(){}static of(e){if(e.length==0)throw RangeError("A document must have at least one line");if(e.length==1&&!e[0])return _.empty;return e.length<=32?new oe(e):ft.from(oe.split(e,[]))}}class oe extends _{constructor(e,t=ap(e)){super();this.text=e,this.length=t}get lines(){return this.text.length}get children(){return null}lineInner(e,t,i,n){for(let r=0;;r++){let s=this.text[r],o=n+s.length;if((t?i:o)>=e)return new ka(n,o,i,s);n=o+1,i++}}decompose(e,t,i,n){let r=e<=0&&t>=this.length?this:new oe(ga(this.text,e,t),Math.min(t,this.length)-Math.max(0,e));if(n&1){let s=i.pop(),o=cr(r.text,s.text.slice(),0,r.length);if(o.length<=32)i.push(new oe(o,s.length+r.length));else{let l=o.length>>1;i.push(new oe(o.slice(0,l)),new oe(o.slice(l)))}}else i.push(r)}replace(e,t,i){if(!(i instanceof oe))return super.replace(e,t,i);[e,t]=vi(this,e,t);let n=cr(this.text,cr(i.text,ga(this.text,0,e)),t),r=this.length+i.length-(t-e);if(n.length<=32)return new oe(n,r);return ft.from(oe.split(n,[]),r)}sliceString(e,t=this.length,i=`
 `){[e,t]=vi(this,e,t);let n="";for(let r=0,s=0;r<=t&&s<this.text.length;s++){let o=this.text[s],l=r+o.length;if(r>e&&s)n+=i;if(e<l&&t>r)n+=o.slice(Math.max(0,e-r),t-r);r=l+1}return n}flatten(e){for(let t of this.text)e.push(t)}scanIdentical(){return 0}static split(e,t){let i=[],n=-1;for(let r of e)if(i.push(r),n+=r.length+1,i.length==32)t.push(new oe(i,n)),i=[],n=-1;if(n>-1)t.push(new oe(i,n));return t}}class ft extends _{constructor(e,t){super();this.children=e,this.length=t,this.lines=0;for(let i of e)this.lines+=i.lines}lineInner(e,t,i,n){for(let r=0;;r++){let s=this.children[r],o=n+s.length,l=i+s.lines-1;if((t?l:o)>=e)return s.lineInner(e,t,i,n);n=o+1,i=l+1}}decompose(e,t,i,n){for(let r=0,s=0;s<=t&&r<this.children.length;r++){let o=this.children[r],l=s+o.length;if(e<=l&&t>=s){let a=n&((s<=e?1:0)|(l>=t?2:0));if(s>=e&&l<=t&&!a)i.push(o);else o.decompose(e-s,t-s,i,a)}s=l+1}}replace(e,t,i){if([e,t]=vi(this,e,t),i.lines<this.lines)for(let n=0,r=0;n<this.children.length;n++){let s=this.children[n],o=r+s.length;if(e>=r&&t<=o){let l=s.replace(e-r,t-r,i),a=this.lines-s.lines+l.lines;if(l.lines<a>>4&&l.lines>a>>6){let h=this.children.slice();return h[n]=l,new ft(h,this.length-(t-e)+i.length)}return super.replace(r,o,l)}r=o+1}return super.replace(e,t,i)}sliceString(e,t=this.length,i=`
 `){[e,t]=vi(this,e,t);let n="";for(let r=0,s=0;r<this.children.length&&s<=t;r++){let o=this.children[r],l=s+o.length;if(s>e&&r)n+=i;if(e<l&&t>s)n+=o.sliceString(e-s,t-s,i);s=l+1}return n}flatten(e){for(let t of this.children)t.flatten(e)}scanIdentical(e,t){if(!(e instanceof ft))return 0;let i=0,[n,r,s,o]=t>0?[0,0,this.children.length,e.children.length]:[this.children.length-1,e.children.length-1,-1,-1];for(;;n+=t,r+=t){if(n==s||r==o)return i;let l=this.children[n],a=e.children[r];if(l!=a)return i+l.scanIdentical(a,t);i+=l.length+1}}static from(e,t=e.reduce((i,n)=>i+n.length+1,-1)){let i=0;for(let u of e)i+=u.lines;if(i<32){let u=[];for(let d of e)d.flatten(u);return new oe(u,t)}let n=Math.max(32,i>>5),r=n<<1,s=n>>1,o=[],l=0,a=-1,h=[];function f(u){let d;if(u.lines>r&&u instanceof ft)for(let O of u.children)f(O);else if(u.lines>s&&(l>s||!l))c(),o.push(u);else if(u instanceof oe&&l&&(d=h[h.length-1])instanceof oe&&u.lines+d.lines<=32)l+=u.lines,a+=u.length+1,h[h.length-1]=new oe(d.text.concat(u.text),d.length+1+u.length);else{if(l+u.lines>n)c();l+=u.lines,a+=u.length+1,h.push(u)}}function c(){if(l==0)return;o.push(h.length==1?h[0]:ft.from(h,a)),a=-1,l=h.length=0}for(let u of e)f(u);return c(),o.length==1?o[0]:new ft(o,t)}}_.empty=new oe([""],0);function ap(e){let t=-1;for(let i of e)t+=i.length+1;return t}function cr(e,t,i=0,n=1e9){for(let r=0,s=0,o=!0;s<e.length&&r<=n;s++){let l=e[s],a=r+l.length;if(a>=i){if(a>n)l=l.slice(0,n-r);if(r<i)l=l.slice(i-r);if(o)t[t.length-1]+=l,o=!1;else t.push(l)}r=a+1}return t}function ga(e,t,i){return cr(e,[""],t,i)}class wi{constructor(e,t=1){this.dir=t,this.done=!1,this.lineBreak=!1,this.value="",this.nodes=[e],this.offsets=[t>0?1:(e instanceof oe?e.text.length:e.children.length)<<1]}nextInner(e,t){this.done=this.lineBreak=!1;for(;;){let i=this.nodes.length-1,n=this.nodes[i],r=this.offsets[i],s=r>>1,o=n instanceof oe?n.text.length:n.children.length;if(s==(t>0?o:0)){if(i==0)return this.done=!0,this.value="",this;if(t>0)this.offsets[i-1]++;this.nodes.pop(),this.offsets.pop()}else if((r&1)==(t>0?0:1)){if(this.offsets[i]+=t,e==0)return this.lineBreak=!0,this.value=`

package/web/notes.html

@@ -2,7 +2,7 @@
 <html lang="en">
 <head>
 <meta charset="utf-8">
-<meta name="viewport" content="width=device-width,initial-scale=1">
+<meta name="viewport" content="width=device-width,initial-scale=1,viewport-fit=cover">
 <title>kaizen notebook</title>
 <link rel="icon" href="/favicon.ico" sizes="any">
 <link rel="icon" type="image/png" href="/logo.png">
@@ -18,6 +18,8 @@
 @media(prefers-color-scheme:dark){:root:not([data-theme=light]){--shade:rgb(0 0 0/.45);--canvas:color-mix(in srgb,var(--bg) 70%,black)}}
 :root[data-theme=dark]{--shade:rgb(0 0 0/.45);--canvas:color-mix(in srgb,var(--bg) 70%,black)}
 body{margin:0;background:var(--canvas);color:var(--ink);font:14px/1.5 var(--font);-webkit-font-smoothing:antialiased;height:100vh;height:100dvh;overflow:hidden;display:flex}
+html{background:var(--canvas)}
+@media(display-mode:standalone){body{position:fixed;inset:0;height:auto}}
 button,input,select{font:inherit;color:inherit;background:none;border:0;padding:0}
 button{cursor:pointer}
 a{color:inherit;text-decoration:none}
@@ -52,7 +54,7 @@ svg{width:18px;height:18px;stroke:currentColor;fill:none;stroke-width:1.6;stroke
 /* end side menu */
 /* the work area: an inset rounded panel on the canvas the side menu sits on */
 .app{flex:1;min-width:0;display:flex;flex-direction:column;margin:8px 8px 8px 0;background:var(--bg);border:1px solid var(--line);border-radius:var(--r);overflow:hidden}
-@media(max-width:640px){.app{margin:0;border:0;border-radius:0}}
+@media(max-width:640px){.app{margin:0;border:0;border-radius:0}body{padding:env(safe-area-inset-top) env(safe-area-inset-right) env(safe-area-inset-bottom) env(safe-area-inset-left)}}
 /* header: the board's */
 .hdr{display:flex;align-items:center;gap:12px;padding:10px 20px 10px 28px;border-bottom:1px solid color-mix(in srgb,var(--line) 60%,transparent);flex-wrap:wrap}
 pre.mark{margin:0;font:700 8px/1 var(--mono)}