kaizen-agent 1.7.8 → 1.8.0

package/cli/install.ts

@@ -2,13 +2,16 @@
 import {
   symlinkSync, mkdirSync, readdirSync, lstatSync, readlinkSync, unlinkSync,
   existsSync, copyFileSync, readFileSync, appendFileSync, rmSync, writeFileSync, renameSync,
-  statSync, cpSync,
+  statSync, cpSync, realpathSync,
 } from "node:fs";
 import { join, dirname, basename } from "node:path";
 import { homedir, tmpdir } from "node:os";
 import { applyPreset, detectPreset, PRESETS, type PresetName } from "./settings.ts";
 
-const home = homedir();
+// The real path: process.cwd() is always physical, so a raw $HOME that crosses a
+// symlink (/home -> var/home) would never compare equal to it, and the home
+// directory would be offered set-up as if it were a project.
+const home = (() => { try { return realpathSync(homedir()); } catch { return homedir(); } })();
 const REPO_URL = "https://github.com/hfadhlullah/kaizen.git";
 const args = new Set(Bun.argv.slice(2));
 const upgrade = args.has("upgrade") || args.has("--upgrade");
@@ -70,6 +73,48 @@ const onPath = new Set(
 const found = (r: string) =>
   AGENTS.filter((a) => existsSync(join(r, a.dir)) || onPath.has(a.dir));
 
+// Request sources. Dispatched on the first word alone and ahead of every flag
+// check below, so a label or a link that happens to read `web` or `uninstall` is
+// only ever a label.
+if (Bun.argv[2] === "sources" || Bun.argv[2] === "gather") {
+  const { locate, label } = await import("./state.ts");
+  const src = await import("./sources.ts");
+  const state = locate() ?? join(home, ".kaizen");
+  // A source belongs to the project the command is run in; every answer names it.
+  const where = c.dim(`project  ${label(state)}`);
+  const [, , cmd, op, url = "", ...rest] = Bun.argv;
+  const line = (r: { url: string; ok: boolean; note: string }) => `  ${r.ok ? c.green("ok  ") : "fail"}  ${r.url}  ${c.dim(r.note)}`;
+  try {
+    if (cmd === "gather" && op === "--stdin") {
+      // What an agent read from a link kaizen could not: one request per line, an
+      // optional tab, then notes. Only for a link already listed.
+      if (!src.readSources(state).some((s) => s.url === url)) { console.log(`
+  not a listed source: ${url || "(no link given)"}
+`); process.exit(1); }
+      const items = (await Bun.stdin.text()).split("\n").filter((l) => l.trim()).map((l) => {
+        const [text = "", ...notes] = l.split("\t");
+        return { text, notes: notes.join(" ") };
+      });
+      console.log(line(src.record(state, url, src.ingest(state, url, items))));
+    } else if (cmd === "gather") {
+      const results = await src.gatherAll(state);
+      console.log(results.length ? results.map(line).join("\n") : `\n  no sources yet ${c.dim("— kaizen sources add <link>")}\n`);
+      if (results.some((r) => !r.ok)) process.exit(1);
+    } else if (op === "add" || op === "rm") {
+      const why = op === "add" ? src.addSource(state, url, rest.join(" ")) : src.removeSource(state, url);
+      if (why) { console.log(`\n  ${why}\n`); process.exit(1); }
+      console.log(`\n  ${op === "add" ? "added" : "removed"} ${url}\n  ${where}\n`);
+    } else {
+      const list = src.readSources(state);
+      console.log(`\n  ${where}`);
+      console.log(list.length
+        ? "\n" + list.map((s) => `  ${s.url}${s.label ? `  ${s.label}` : ""}\n    ${c.dim(s.last ? `${s.last.at.slice(0, 16).replace("T", " ")}  ${s.last.note}` : "not gathered yet")}`).join("\n") + "\n"
+        : `\n  no sources yet ${c.dim("— kaizen sources add <link>")}\n`);
+    }
+  } catch (e) { console.log(`\n  ${(e as Error).message}\n`); process.exit(1); }
+  process.exit(0);
+}
+
 if (args.has("--version") || args.has("-v") || args.has("version")) {
   console.log(versionOf(dirname(import.meta.dir)));
   process.exit(0);
@@ -212,6 +257,22 @@ if (wantSettings) {
   process.exit(0);
 }
 
+// Deleting runs is a job for code with a test, not for an agent with `rm`. Lists by
+// default; --yes is what deletes.
+if (args.has("prune")) {
+  const { locate, pruneRuns } = await import("./state.ts");
+  const { listSettings } = await import("./settings.ts");
+  const state = locate();
+  if (!state) { console.log("\n  no .kaizen here\n"); process.exit(1); }
+  const keep = Number(listSettings(await resolveRepoQuietly()).rows.find((r) => r.key === "state.keep_runs")?.value) || 20;
+  const apply = args.has("--yes");
+  const gone = pruneRuns(state, keep, apply);
+  console.log(gone.length
+    ? `\n  ${apply ? "pruned" : "would prune"} ${gone.length} finished run(s), keeping the newest ${keep}:\n${gone.map((g) => `    ${g.id}${g.rescued ? c.dim(`  ${g.rescued} open item(s) ${apply ? "moved" : "to move"} to backlog.md`) : ""}`).join("\n")}\n${apply ? "" : `\n  ${c.dim("nothing deleted — run:")} ${c.cyan("kaizen prune --yes")}\n`}`
+    : `\n  nothing to prune ${c.dim(`(${keep} finished runs are kept)`)}\n`);
+  process.exit(0);
+}
+
 if (wantWeb) {
   if (args.has("--shortcut")) { const { shortcut } = await import("./web.ts"); console.log(`\n  kaizen web shortcut  ${await shortcut()}\n`); process.exit(0); }
   const at = Bun.argv.indexOf("--port");
@@ -629,7 +690,17 @@ for (const [src, sub] of links) {
   if (verbose) console.log(c.dim(`  link  ${name}`));
 }
 
+// A project's spec copies are what a run there reads, and they are copied once.
+function specDrift() {
+  const dir = join(process.cwd(), ".kaizen");
+  return readdirSync(join(repo, "skills/kaizen"))
+    .filter((f) => f.startsWith("spec") && existsSync(join(dir, f)) && !sameFile(join(repo, "skills/kaizen", f), join(dir, f)));
+}
+
 if (check) {
+  const drift = specDrift();
+  for (const f of drift) console.log(`DRIFT .kaizen/${f} (behind the skill's copy)`);
+  if (drift.length) { console.log(`\n${drift.length} spec file(s) behind — run: kaizen --yes`); if (!blocked) process.exit(1); }
   console.log(blocked ? `\n${blocked} link(s) missing — run: bunx kaizen-agent` : "\nall linked");
   process.exit(blocked ? 1 : 0);
 }
@@ -734,7 +805,9 @@ if (inProject && !kaizenAbove()) {
       : false;
   if (now) initProject();
 } else if (existsSync(kaizenDir)) {
-  step(`${basename(process.cwd())}/.kaizen already set up`);
+  const drift = specDrift();
+  for (const f of drift) copyFileSync(join(repo, "skills/kaizen", f), join(kaizenDir, f));
+  step(`${basename(process.cwd())}/.kaizen already set up${drift.length ? ` — refreshed ${drift.join(", ")}` : ""}`);
 }
 
 function initProject() {

package/cli/publish-gh.sh

@@ -1,27 +1,27 @@
-#!/bin/sh
-# Publish the same tarball to GitHub Packages, so the repo's "Packages" box lists
-# it. GitHub only accepts names scoped to the repo owner, so the package goes there
-# as @hfadhlullah/kaizen-agent while npm keeps kaizen-agent. Run after `bun publish`.
-set -eu
-cd "$(dirname "$0")/.."
-token="${GITHUB_TOKEN:-$(gh auth token 2>/dev/null || true)}"
-[ -n "$token" ] || { echo "publish-gh: no GitHub token (gh auth login, scope write:packages)"; exit 1; }
-
-tmp="$(mktemp -d)"
-trap 'rm -rf "$tmp"' EXIT
-cp package.json "$tmp/package.json.orig"
-bun -e '
-  const p = JSON.parse(await Bun.file("package.json").text());
-  p.name = "@hfadhlullah/kaizen-agent";
-  p.publishConfig = { registry: "https://npm.pkg.github.com" };
-  await Bun.write("package.json", JSON.stringify(p, null, 2) + "\n");
-'
-# Bun reads the project's own .npmrc; a temporary one carries the token and never
-# lands in git (it is removed on exit, and .gitignore refuses it besides).
-[ -e .npmrc ] && cp .npmrc "$tmp/npmrc.orig"
-printf '//npm.pkg.github.com/:_authToken=%s\n@hfadhlullah:registry=https://npm.pkg.github.com\n' "$token" > .npmrc
-# The scoped copy must not run postpublish: the tag and release already exist.
-bun publish --ignore-scripts "$@" || status=$?
-cp "$tmp/package.json.orig" package.json
-if [ -e "$tmp/npmrc.orig" ]; then cp "$tmp/npmrc.orig" .npmrc; else rm -f .npmrc; fi
-exit "${status:-0}"
+#!/bin/sh
+# Publish the same tarball to GitHub Packages, so the repo's "Packages" box lists
+# it. GitHub only accepts names scoped to the repo owner, so the package goes there
+# as @hfadhlullah/kaizen-agent while npm keeps kaizen-agent. Run after `bun publish`.
+set -eu
+cd "$(dirname "$0")/.."
+token="${GITHUB_TOKEN:-$(gh auth token 2>/dev/null || true)}"
+[ -n "$token" ] || { echo "publish-gh: no GitHub token (gh auth login, scope write:packages)"; exit 1; }
+
+tmp="$(mktemp -d)"
+trap 'rm -rf "$tmp"' EXIT
+cp package.json "$tmp/package.json.orig"
+bun -e '
+  const p = JSON.parse(await Bun.file("package.json").text());
+  p.name = "@hfadhlullah/kaizen-agent";
+  p.publishConfig = { registry: "https://npm.pkg.github.com" };
+  await Bun.write("package.json", JSON.stringify(p, null, 2) + "\n");
+'
+# Bun reads the project's own .npmrc; a temporary one carries the token and never
+# lands in git (it is removed on exit, and .gitignore refuses it besides).
+[ -e .npmrc ] && cp .npmrc "$tmp/npmrc.orig"
+printf '//npm.pkg.github.com/:_authToken=%s\n@hfadhlullah:registry=https://npm.pkg.github.com\n' "$token" > .npmrc
+# The scoped copy must not run postpublish: the tag and release already exist.
+bun publish --ignore-scripts "$@" || status=$?
+cp "$tmp/package.json.orig" package.json
+if [ -e "$tmp/npmrc.orig" ]; then cp "$tmp/npmrc.orig" .npmrc; else rm -f .npmrc; fi
+exit "${status:-0}"

package/cli/release.sh

@@ -1,45 +1,45 @@
-#!/bin/sh
-# Runs after `bun publish`: tag the published version and open a GitHub release
-# for it, so a version can never exist on npm with nothing to read on GitHub.
-#
-# Never fails the publish. The package is already public by the time this runs;
-# exiting non-zero here would report a failure that did not happen.
-set -u
-v="${npm_package_version:-$(bun -p "require('./package.json').version" 2>/dev/null)}"
-[ -n "$v" ] || { echo "release: no version, skipping"; exit 0; }
-tag="v$v"
-
-git rev-parse --git-dir >/dev/null 2>&1 || { echo "release: not a git checkout, skipping"; exit 0; }
-
-if git rev-parse "$tag" >/dev/null 2>&1; then
-  echo "release: $tag already tagged"
-else
-  git tag -a "$tag" -m "kaizen-agent $tag" || { echo "release: could not tag"; exit 0; }
-  git push origin "$tag" >/dev/null 2>&1 || echo "release: tag made but not pushed"
-fi
-
-command -v gh >/dev/null 2>&1 || { echo "release: gh not installed — tag pushed, write the release by hand"; exit 0; }
-gh auth status >/dev/null 2>&1 || { echo "release: gh not logged in — tag pushed, write the release by hand"; exit 0; }
-
-if gh release view "$tag" >/dev/null 2>&1; then
-  echo "release: $tag already released"
-  exit 0
-fi
-
-# --generate-notes only lists pull requests, and this repo merges none, so the
-# notes are built here: the title from the release commit's subject, the body from
-# every commit since the previous tag with its message, oldest first.
-prev="$(git describe --tags --abbrev=0 "$tag^" 2>/dev/null || true)"
-subject="$(git log -1 --format=%s "$tag" | sed -n 's/^Release [0-9.]*: //p')"
-title="$tag${subject:+: $subject}"
-notes="$(mktemp)"
-git log --reverse --format='### %s%n%n%b' ${prev:+"$prev.."}"$tag" \
-  | grep -vE '^(Co-Authored-By|Claude-Session):' \
-  | grep -vE '^### Release [0-9.]+:' \
-  | cat -s > "$notes"
-[ -n "$prev" ] && printf '\n**Full Changelog**: https://github.com/hfadhlullah/kaizen/compare/%s...%s\n' "$prev" "$tag" >> "$notes"
-gh release create "$tag" --title "$title" --notes-file "$notes" >/dev/null 2>&1 \
-  && echo "release: published $tag  https://github.com/hfadhlullah/kaizen/releases/tag/$tag" \
-  || echo "release: tag pushed, release not created"
-rm -f "$notes"
-exit 0
+#!/bin/sh
+# Runs after `bun publish`: tag the published version and open a GitHub release
+# for it, so a version can never exist on npm with nothing to read on GitHub.
+#
+# Never fails the publish. The package is already public by the time this runs;
+# exiting non-zero here would report a failure that did not happen.
+set -u
+v="${npm_package_version:-$(bun -p "require('./package.json').version" 2>/dev/null)}"
+[ -n "$v" ] || { echo "release: no version, skipping"; exit 0; }
+tag="v$v"
+
+git rev-parse --git-dir >/dev/null 2>&1 || { echo "release: not a git checkout, skipping"; exit 0; }
+
+if git rev-parse "$tag" >/dev/null 2>&1; then
+  echo "release: $tag already tagged"
+else
+  git tag -a "$tag" -m "kaizen-agent $tag" || { echo "release: could not tag"; exit 0; }
+  git push origin "$tag" >/dev/null 2>&1 || echo "release: tag made but not pushed"
+fi
+
+command -v gh >/dev/null 2>&1 || { echo "release: gh not installed — tag pushed, write the release by hand"; exit 0; }
+gh auth status >/dev/null 2>&1 || { echo "release: gh not logged in — tag pushed, write the release by hand"; exit 0; }
+
+if gh release view "$tag" >/dev/null 2>&1; then
+  echo "release: $tag already released"
+  exit 0
+fi
+
+# --generate-notes only lists pull requests, and this repo merges none, so the
+# notes are built here: the title from the release commit's subject, the body from
+# every commit since the previous tag with its message, oldest first.
+prev="$(git describe --tags --abbrev=0 "$tag^" 2>/dev/null || true)"
+subject="$(git log -1 --format=%s "$tag" | sed -n 's/^Release [0-9.]*: //p')"
+title="$tag${subject:+: $subject}"
+notes="$(mktemp)"
+git log --reverse --format='### %s%n%n%b' ${prev:+"$prev.."}"$tag" \
+  | grep -vE '^(Co-Authored-By|Claude-Session):' \
+  | grep -vE '^### Release [0-9.]+:' \
+  | cat -s > "$notes"
+[ -n "$prev" ] && printf '\n**Full Changelog**: https://github.com/hfadhlullah/kaizen/compare/%s...%s\n' "$prev" "$tag" >> "$notes"
+gh release create "$tag" --title "$title" --notes-file "$notes" >/dev/null 2>&1 \
+  && echo "release: published $tag  https://github.com/hfadhlullah/kaizen/releases/tag/$tag" \
+  || echo "release: tag pushed, release not created"
+rm -f "$notes"
+exit 0

package/cli/settings.ts

@@ -4,7 +4,8 @@ import { existsSync, readFileSync, writeFileSync, copyFileSync, mkdirSync } from
 import { join, dirname } from "node:path";
 import { homedir } from "node:os";
 
-type Setting = { key: string; label: string; group: string; values: string[]; help: string };
+// `text` is a value typed rather than chosen: a path. It has no values to cycle.
+type Setting = { key: string; label: string; group: string; values: string[]; help: string; text?: boolean };
 
 export type PresetName = "low" | "medium" | "ultra";
 
@@ -114,6 +115,8 @@ const SETTINGS: Setting[] = [
   { key: "subagents.effort", label: "Effort for stage agents", group: "Agents", values: ["inherit", "low", "medium", "high"], help: "How hard the stage agents think. low is faster and cheaper; high finds more. Claude Code only" },
   { key: "agent.default", label: "Tool the board launches", group: "Agents", values: ["auto", "claude", "codex", "agy", "opencode", "gemini"], help: "Coding tool opened when you start a run from the board. auto: Claude Code if installed, else the first one found" },
   { key: "dictation.model", label: "Dictation model", group: "Board", values: ["tiny", "base", "small", "large-v3-turbo"], help: "Whisper model the web board dictates with, in the browser. tiny ~60 MB rough; base ~165 MB English-leaning; small ~410 MB accurate across languages; large-v3-turbo ~1.5 GB best, needs a capable GPU. Downloaded once on the next mic press" },
+  { key: "sources.every", label: "Gather requests", group: "Board", values: ["off", "1h", "6h", "24h"], help: "How often the board checks your request sources for new ideas while it is running. off: only when you press Gather now" },
+  { key: "board.projects_dir", label: "Projects folder", group: "Board", values: [], text: true, help: "A folder your projects live in, e.g. ~/Projects. Every folder inside it appears in the board's project list, ready to choose; choosing one sets it up. Empty: only projects kaizen already knows" },
 ];
 
 // The same rows and the same write the TUI uses, for `kaizen web`'s settings panel:
@@ -127,14 +130,14 @@ export function listSettings(repoRoot: string) {
     file: tilde(file),
     rows: SETTINGS.map((s) => ({
       ...s,
-      value: s.key === "preset" ? preset : (read(text, s.key) || read(defaults, s.key)) ?? s.values[0]!,
+      value: s.key === "preset" ? preset : (read(text, s.key) || read(defaults, s.key)) ?? s.values[0] ?? "",
     })),
   };
 }
 
 export function setSetting(repoRoot: string, key: string, value: string) {
   const s = SETTINGS.find((x) => x.key === key);
-  if (!s || !s.values.includes(value)) return { error: "unknown setting or value" };
+  if (!s || !(s.text || s.values.includes(value))) return { error: "unknown setting or value" };
   const file = locate();
   const defaultsPath = join(repoRoot, "skills/kaizen/config.default.yml");
   if (!existsSync(file)) { mkdirSync(dirname(file), { recursive: true }); copyFileSync(defaultsPath, file); }
@@ -234,6 +237,7 @@ export async function settings(repoRoot: string, standalone = true) {
   function cycle(step: number) {
     const s = SETTINGS[active]!;
     const wasMouse = s.key === "ui.mouse";
+    if (s.text) { saved = c.dim(`type ${s.key} in the board's settings, or in ${tilde(file)}`); return; }
     const text = readFileSync(file, "utf8");
     if (s.key === "preset") {
       const current = detectPreset(text, defaults);