kaizen-agent 0.5.0 → 0.6.0

package/README.md

@@ -239,9 +239,14 @@ Agent Skills standard, so the same workflow runs under any of them:
 | Antigravity | Skills | Parallel agents where available, else sequentially |
 | OpenCode, Cursor, Gemini CLI | Skills | Sequentially, one session |
 
-Only directories that already exist are touched — installing does not create
-`~/.opencode` for someone who does not use OpenCode. Install again after adding an
-agent and it picks the new one up.
+An agent counts as present if it has a config directory or a command on your PATH.
+Only what is already there is touched — installing does not create `~/.opencode` for
+someone who does not use OpenCode. Install again after adding an agent and it picks
+the new one up.
+
+**No agent yet?** kaizen does nothing on its own — it is a workflow an agent runs.
+If none is found, the installer says so and offers the list above, opening the
+install page for whichever you pick. Install it, run `kaizen` again, and carry on.
 
 The stage agents and slash commands are Claude Code's own formats and are not copied
 elsewhere; under the others you invoke the skill by name. `.kaizen/` is plain files

package/cli/install.ts

@@ -27,18 +27,75 @@ const c = {
 // Skills standard, so every one of these can run the workflow; agents/ and
 // commands/ are Claude Code's own formats and go nowhere else.
 const AGENTS = [
-  { name: "Claude Code", dir: ".claude", full: true },
-  { name: "Codex", dir: ".codex", full: false },
-  { name: "Antigravity", dir: ".agents", full: false },
-  { name: "OpenCode", dir: ".opencode", full: false },
-  { name: "Cursor", dir: ".cursor", full: false },
-  { name: "Gemini CLI", dir: ".gemini", full: false },
+  { name: "Claude Code", dir: ".claude", cmd: "claude", full: true,
+    docs: "https://docs.claude.com/en/docs/claude-code" },
+  { name: "Codex", dir: ".codex", cmd: "codex", full: false,
+    docs: "https://github.com/openai/codex" },
+  { name: "Antigravity", dir: ".agents", cmd: "agy", full: false,
+    docs: "https://antigravity.google" },
+  { name: "OpenCode", dir: ".opencode", cmd: "opencode", full: false,
+    docs: "https://opencode.ai" },
+  { name: "Cursor", dir: ".cursor", cmd: "cursor", full: false,
+    docs: "https://cursor.com" },
+  { name: "Gemini CLI", dir: ".gemini", cmd: "gemini", full: false,
+    docs: "https://github.com/google-gemini/gemini-cli" },
 ];
 
-// Install into an agent that is actually present. Creating ~/.opencode for someone
-// who does not use OpenCode leaves litter that looks like configuration. Claude Code
-// is always a target: it is the one this is installed from.
-const found = (r: string) => AGENTS.filter((a) => a.dir === ".claude" || existsSync(join(r, a.dir)));
+// An agent counts as present if it has a directory or a command. The directory
+// alone misses someone who installed the agent and has not run it yet; the command
+// alone misses one that is not on this shell's PATH.
+const onPath = new Set(
+  AGENTS.filter((a) => Bun.which(a.cmd)).map((a) => a.dir),
+);
+const found = (r: string) =>
+  AGENTS.filter((a) => existsSync(join(r, a.dir)) || onPath.has(a.dir));
+
+// Nothing to install into. kaizen is a workflow an agent runs; on its own it does
+// nothing, so send them to the agent first rather than laying out files no reader
+// will ever load.
+if (!found(home).length && !args.has("--force")) {
+  await noAgent();
+  process.exit(0);
+}
+
+async function noAgent() {
+  console.log(`  ${c.bold("No AI coding agent found on this machine.")}\n`);
+  console.log(`  ${c.dim("kaizen is a workflow that an agent runs — it plans, you approve, it builds,")}`);
+  console.log(`  ${c.dim("and a second agent reviews. So an agent has to be installed first.")}\n`);
+
+  if (!interactive) {
+    for (const a of AGENTS) console.log(`    ${a.name.padEnd(14)} ${a.docs}`);
+    console.log(`\n  ${c.dim("Install one, then run this again.")}`);
+    return;
+  }
+
+  const pick = await select("Which one would you like to install?", [
+    ...AGENTS.map((a) => ({ label: a.name, hint: a.docs, value: a as (typeof AGENTS)[number] | null })),
+    { label: "None of these — just show me the list", hint: "", value: null },
+  ]);
+
+  if (!pick) {
+    for (const a of AGENTS) console.log(`    ${a.name.padEnd(14)} ${a.docs}`);
+    console.log(`\n  ${c.dim("Install one, then run this again.")}`);
+    return;
+  }
+
+  console.log(`  ${c.bold(pick.name)}`);
+  console.log(`  ${c.cyan(pick.docs)}\n`);
+  const opened = await openUrl(pick.docs);
+  console.log(opened
+    ? `  ${c.dim("Opened in your browser. Install it, then run")} ${c.cyan("kaizen")} ${c.dim("again.")}`
+    : `  ${c.dim("Open that page to install it, then run")} ${c.cyan("kaizen")} ${c.dim("again.")}`);
+}
+
+// Best effort: a headless box or a locked-down desktop has no opener, and the URL
+// is printed either way.
+async function openUrl(url: string) {
+  const opener = process.platform === "darwin" ? "open"
+    : process.platform === "win32" ? "start" : "xdg-open";
+  if (!Bun.which(opener)) return false;
+  try { await Bun.$`${opener} ${url}`.quiet(); return true; } catch { return false; }
+}
 
 if (wantSettings) {
   const { settings } = await import("./settings.ts");
@@ -52,7 +109,7 @@ if (wantSettings) {
 if (interactive && !upgrade && Bun.argv.length === 2) {
   const repoDir = await resolveRepoQuietly();
   const here = found(home);
-  const linked = here.every((a) =>
+  const linked = here.length > 0 && here.every((a) =>
     ["kaizen", "kaizen-help"].every((n) => existsSync(join(home, a.dir, "skills", n))));
   if (linked) {
     const { dashboard } = await import("./dashboard.ts");

package/cli/release.sh

@@ -0,0 +1,34 @@
+#!/bin/sh
+# Runs after `npm 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:-$(node -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 lists the commits since the last tag. Good enough to never be
+# empty; rewrite it with what actually changed when the release matters.
+gh release create "$tag" --title "$tag" --generate-notes >/dev/null 2>&1 \
+  && echo "release: published $tag  https://github.com/hfadhlullah/kaizen/releases/tag/$tag" \
+  || echo "release: tag pushed, release not created"
+exit 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kaizen-agent",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Staged workflow for AI agents \u2014 code, writing, research, operations: plan, human approval, build, independent review, bounded fix loop.",
   "type": "module",
   "bin": {
@@ -17,7 +17,8 @@
   ],
   "scripts": {
     "install-links": "bun run cli/install.ts",
-    "check": "bun run cli/install.ts --check"
+    "check": "bun run cli/install.ts --check",
+    "postpublish": "sh cli/release.sh"
   },
   "repository": {
     "type": "git",