@zeroxyz/cli 1.0.0 → 1.1.0

package/dist/index.js

@@ -76582,7 +76582,7 @@ init_esm_shims();
 
 // package.json
 var package_default = {
-  version: "1.0.0"};
+  version: "1.1.0"};
 
 // src/app.ts
 init_esm_shims();
@@ -147020,9 +147020,293 @@ var getCommand = (appContext) => new Command("get").description(
 
 // src/commands/init-command.ts
 init_esm_shims();
-var INIT_DEPRECATION_MESSAGE = "The recommended way to install Zero and initialize its skill and hooks is via Agent Plugins. See the Zero agent plugin at github.com/officialzeroxyz/zero-plugins. If you need to install Zero manually you can find the binary at https://releases.zero.xyz/latest/zero-<os>-<arch> (one of: zero-macos-arm64, zero-macos-x64, zero-linux-x64, zero-linux-arm64, zero-win-x64.exe) or use npm to install it globally `npm i -g @zeroxyz/cli@latest`. You can find the Zero skill at https://www.zero.xyz/SKILL.md where it can be manually configured with your agent.";
-var initCommand = (_appContext) => new Command("init").description("Deprecated \u2014 install Zero via Agent Plugins").allowExcessArguments(true).allowUnknownOption(true).action(() => {
-  console.log(INIT_DEPRECATION_MESSAGE);
+
+// src/util/install-banner.ts
+init_esm_shims();
+var colorsEnabled = () => {
+  if (process.env.NO_COLOR) return false;
+  if (process.env.FORCE_COLOR) return true;
+  return Boolean(process.stdout.isTTY);
+};
+var wrap5 = (code, text) => colorsEnabled() ? `\x1B[${code}m${text}\x1B[0m` : text;
+var color = {
+  bold: (s) => wrap5("1", s),
+  dim: (s) => wrap5("2", s),
+  cyan: (s) => wrap5("36", s),
+  magenta: (s) => wrap5("35", s),
+  green: (s) => wrap5("32", s),
+  yellow: (s) => wrap5("33", s),
+  red: (s) => wrap5("31", s),
+  gray: (s) => wrap5("90", s),
+  boldCyan: (s) => wrap5("1;36", s),
+  boldMagenta: (s) => wrap5("1;35", s),
+  boldGreen: (s) => wrap5("1;32", s),
+  boldRed: (s) => wrap5("1;31", s)
+};
+var supportsUnicode = () => {
+  if (process.platform !== "win32") return true;
+  return Boolean(
+    process.env.WT_SESSION || process.env.TERM_PROGRAM === "vscode"
+  );
+};
+var SYMBOLS = supportsUnicode() ? { check: "\u2713", arrow: "\u203A", warn: "!" } : { check: "OK", arrow: ">", warn: "!" };
+var stepSuccess = (label, detail) => {
+  const line = detail ? `  ${color.boldGreen(SYMBOLS.check)} ${label}  ${color.dim(detail)}` : `  ${color.boldGreen(SYMBOLS.check)} ${label}`;
+  console.log(line);
+};
+var stepWarn = (label, detail) => {
+  const line = detail ? `  ${color.yellow(SYMBOLS.warn)} ${label}  ${color.dim(detail)}` : `  ${color.yellow(SYMBOLS.warn)} ${label}`;
+  console.log(line);
+};
+var stepSkip = (label, detail) => {
+  const line = detail ? `  ${color.gray(SYMBOLS.arrow)} ${color.dim(`${label}  ${detail}`)}` : `  ${color.gray(SYMBOLS.arrow)} ${color.dim(label)}`;
+  console.log(line);
+};
+var stepInfo = (message2) => {
+  console.log(`      ${color.gray("\xB7")} ${color.dim(message2)}`);
+};
+var sectionDivider = () => {
+  console.log("");
+  console.log(color.gray("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  console.log("");
+};
+
+// src/commands/init-command.ts
+var SKILL_DIRS = [".claude/skills", ".agents/skills"];
+var ZERO_SANDBOX_DOMAIN = "*.zero.xyz";
+var PLUGIN_HOOKS_ROOT = "${CLAUDE_PLUGIN_ROOT}/hooks";
+var SCRIPT_NAME_PATTERN = /\$\{CLAUDE_PLUGIN_ROOT\}\/hooks\/([a-z0-9][a-z0-9-]*\.sh)/;
+var fetchText = async (url4) => {
+  const res = await fetch(url4);
+  if (!res.ok) {
+    throw new Error(`GET ${url4} failed with ${res.status}`);
+  }
+  return await res.text();
+};
+var entryScriptNames = (entry) => {
+  const names = [];
+  for (const hook of entry.hooks ?? []) {
+    if (typeof hook.command !== "string") continue;
+    const match = hook.command.match(SCRIPT_NAME_PATTERN);
+    if (match?.[1]) names.push(match[1]);
+  }
+  return names;
+};
+var expandHome = (path3, home) => {
+  if (path3 === "~") return home;
+  if (path3.startsWith("~/")) return join(home, path3.slice(2));
+  return path3;
+};
+var installSkill = (skillsDirs, skillMd, verbose) => {
+  const installed = [];
+  for (const dir of skillsDirs) {
+    const dest = join(dir, "zero");
+    try {
+      mkdirSync(dest, { recursive: true });
+      writeFileSync(join(dest, "SKILL.md"), skillMd);
+      installed.push(join(dest, "SKILL.md"));
+      if (verbose) stepInfo(`wrote ${join(dest, "SKILL.md")}`);
+    } catch (err) {
+      stepWarn(
+        `Could not write the skill under ${dir}`,
+        err instanceof Error ? err.message : String(err)
+      );
+    }
+  }
+  return installed;
+};
+var installHookScripts = async (home, hooksJson, webBase, verbose) => {
+  const names = /* @__PURE__ */ new Set();
+  for (const entries of Object.values(hooksJson.hooks)) {
+    for (const entry of entries ?? []) {
+      for (const name of entryScriptNames(entry)) names.add(name);
+    }
+  }
+  if (names.size === 0) {
+    throw new Error("hooks.json declared no recognizable hook scripts");
+  }
+  const hooksDir = join(home, ".zero", "hooks");
+  mkdirSync(hooksDir, { recursive: true });
+  return await Promise.all(
+    [...names].map(async (name) => {
+      const body = await fetchText(`${webBase}/hooks/${name}`);
+      const dest = join(hooksDir, name);
+      writeFileSync(dest, body);
+      chmodSync(dest, 493);
+      if (verbose) stepInfo(`wrote ${dest}`);
+      return name;
+    })
+  );
+};
+var registerHooksInClaudeSettings = (home, hooksJson, verbose) => {
+  const hooksDir = join(home, ".zero", "hooks");
+  const settingsPath = join(home, ".claude", "settings.json");
+  let settings = {};
+  if (existsSync(settingsPath)) {
+    try {
+      settings = JSON.parse(readFileSync(settingsPath, "utf-8"));
+    } catch {
+      stepWarn(
+        "Hooks not registered",
+        `${settingsPath} is not valid JSON \u2014 fix it and re-run \`zero init\``
+      );
+      return false;
+    }
+  }
+  if (!settings.hooks || typeof settings.hooks !== "object") {
+    settings.hooks = {};
+  }
+  const hooks = settings.hooks;
+  for (const [event, entries] of Object.entries(hooksJson.hooks)) {
+    for (const entry of entries ?? []) {
+      const scripts = entryScriptNames(entry);
+      if (scripts.length === 0) {
+        if (verbose) {
+          stepInfo(`${event}: entry has no plugin hook script \u2014 skipped`);
+        }
+        continue;
+      }
+      const rewritten = {
+        ...entry,
+        hooks: (entry.hooks ?? []).map((hook) => ({
+          ...hook,
+          command: typeof hook.command === "string" ? hook.command.replaceAll(PLUGIN_HOOKS_ROOT, hooksDir) : hook.command
+        }))
+      };
+      if (!Array.isArray(hooks[event])) hooks[event] = [];
+      const list2 = hooks[event];
+      const existingIdx = list2.findIndex((existing) => {
+        const existingHooks = existing?.hooks;
+        if (!Array.isArray(existingHooks)) return false;
+        return existingHooks.some(
+          (h2) => typeof h2.command === "string" && scripts.some((s) => h2.command.includes(s))
+        );
+      });
+      if (existingIdx >= 0) {
+        list2[existingIdx] = rewritten;
+        if (verbose) stepInfo(`${event}: ${scripts.join(", ")} entry replaced`);
+      } else {
+        list2.push(rewritten);
+        if (verbose) stepInfo(`${event}: ${scripts.join(", ")} entry appended`);
+      }
+    }
+  }
+  if (!settings.sandbox || typeof settings.sandbox !== "object") {
+    settings.sandbox = {};
+  }
+  const sandbox = settings.sandbox;
+  if (!sandbox.network || typeof sandbox.network !== "object") {
+    sandbox.network = {};
+  }
+  const network = sandbox.network;
+  if (!Array.isArray(network.allowedDomains)) {
+    network.allowedDomains = [];
+  }
+  const allowedDomains = network.allowedDomains;
+  if (!allowedDomains.includes(ZERO_SANDBOX_DOMAIN)) {
+    allowedDomains.push(ZERO_SANDBOX_DOMAIN);
+    if (verbose) {
+      stepInfo(`sandbox.network.allowedDomains += ${ZERO_SANDBOX_DOMAIN}`);
+    }
+  }
+  mkdirSync(join(home, ".claude"), { recursive: true });
+  writeFileSync(settingsPath, `${JSON.stringify(settings, null, 2)}
+`);
+  return true;
+};
+var runInit = async (appContext, options = {}) => {
+  const verbose = options.verbose ?? false;
+  appContext.services.analyticsService.capture("init_started", {});
+  let currentStep = "fetch";
+  try {
+    console.log("");
+    console.log(`  ${color.boldCyan("Installing Zero")}`);
+    console.log("");
+    console.log(color.gray("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+    console.log("");
+    const home = homedir();
+    const webBase = appContext.env.ZERO_WEB_URL;
+    const [skillMd, hooksJsonRaw] = await Promise.all([
+      fetchText(`${webBase}/SKILL.md`),
+      fetchText(`${webBase}/hooks.json`)
+    ]);
+    let hooksJson;
+    try {
+      hooksJson = JSON.parse(hooksJsonRaw);
+    } catch {
+      throw new Error(`${webBase}/hooks.json is not valid JSON`);
+    }
+    if (!hooksJson?.hooks || typeof hooksJson.hooks !== "object") {
+      throw new Error(`${webBase}/hooks.json has no "hooks" object`);
+    }
+    if (verbose) {
+      stepInfo(`fetched ${webBase}/SKILL.md and ${webBase}/hooks.json`);
+    }
+    currentStep = "skill";
+    const skillsDirs = [
+      .../* @__PURE__ */ new Set([
+        ...SKILL_DIRS.map((dir) => join(home, dir)),
+        ...(options.skillsDir ?? []).map((dir) => expandHome(dir, home))
+      ])
+    ];
+    const skillsInstalled = installSkill(skillsDirs, skillMd, verbose);
+    if (skillsInstalled.length === 0) {
+      throw new Error("could not write the Zero skill to any skills directory");
+    }
+    stepSuccess("Skill installed", `${skillsInstalled.length} locations`);
+    currentStep = "hooks";
+    const hookScriptsInstalled = await installHookScripts(
+      home,
+      hooksJson,
+      webBase,
+      verbose
+    );
+    stepSuccess("Hook scripts installed", "~/.zero/hooks");
+    currentStep = "settings";
+    const settingsRegistered = registerHooksInClaudeSettings(
+      home,
+      hooksJson,
+      verbose
+    );
+    if (settingsRegistered) {
+      stepSuccess("Hooks registered", "~/.claude/settings.json");
+    }
+    currentStep = "complete";
+    appContext.services.analyticsService.capture("init_completed", {
+      // biome-ignore lint/style/useNamingConvention: snake_case for analytics
+      skills_installed: skillsInstalled,
+      // biome-ignore lint/style/useNamingConvention: snake_case for analytics
+      skills_installed_count: skillsInstalled.length,
+      // biome-ignore lint/style/useNamingConvention: snake_case for analytics
+      hook_scripts_installed: hookScriptsInstalled,
+      // biome-ignore lint/style/useNamingConvention: snake_case for analytics
+      settings_registered: settingsRegistered
+    });
+    sectionDivider();
+    console.log(`  ${color.boldGreen("Zero is set up.")}`);
+    console.log(
+      `  ${color.dim("Next: sign in with `zero auth login` \u2014 it prints a URL to approve in your browser.")}`
+    );
+    console.log("");
+    return { skillsInstalled, hookScriptsInstalled, settingsRegistered };
+  } catch (err) {
+    appContext.services.analyticsService.capture("init_failed", {
+      step: currentStep,
+      error: truncateError(err instanceof Error ? err.message : String(err))
+    });
+    throw err;
+  }
+};
+var initCommand = (appContext) => new Command("init").description(
+  "Install the Zero skill and hooks for the agent harnesses on this machine"
+).option(
+  "-v, --verbose",
+  "Explain why each install step was taken or skipped"
+).option(
+  "--skills-dir <dir...>",
+  "Additional skills directories to install the skill into, for harnesses with bespoke locations (e.g. ~/.kiro/skills). ~/.claude/skills and ~/.agents/skills are always written. Note: `zero uninstall` only cleans the default locations."
+).action(async (options) => {
+  await runInit(appContext, options);
 });
 
 // src/commands/review-command.ts
@@ -147288,58 +147572,6 @@ Examples:
 
 // src/commands/search-command.ts
 init_esm_shims();
-
-// src/util/install-banner.ts
-init_esm_shims();
-var colorsEnabled = () => {
-  if (process.env.NO_COLOR) return false;
-  if (process.env.FORCE_COLOR) return true;
-  return Boolean(process.stdout.isTTY);
-};
-var wrap5 = (code, text) => colorsEnabled() ? `\x1B[${code}m${text}\x1B[0m` : text;
-var color = {
-  bold: (s) => wrap5("1", s),
-  dim: (s) => wrap5("2", s),
-  cyan: (s) => wrap5("36", s),
-  magenta: (s) => wrap5("35", s),
-  green: (s) => wrap5("32", s),
-  yellow: (s) => wrap5("33", s),
-  red: (s) => wrap5("31", s),
-  gray: (s) => wrap5("90", s),
-  boldCyan: (s) => wrap5("1;36", s),
-  boldMagenta: (s) => wrap5("1;35", s),
-  boldGreen: (s) => wrap5("1;32", s),
-  boldRed: (s) => wrap5("1;31", s)
-};
-var supportsUnicode = () => {
-  if (process.platform !== "win32") return true;
-  return Boolean(
-    process.env.WT_SESSION || process.env.TERM_PROGRAM === "vscode"
-  );
-};
-var SYMBOLS = supportsUnicode() ? { check: "\u2713", arrow: "\u203A", warn: "!" } : { check: "OK", arrow: ">", warn: "!" };
-var stepSuccess = (label, detail) => {
-  const line = detail ? `  ${color.boldGreen(SYMBOLS.check)} ${label}  ${color.dim(detail)}` : `  ${color.boldGreen(SYMBOLS.check)} ${label}`;
-  console.log(line);
-};
-var stepWarn = (label, detail) => {
-  const line = `  ${color.yellow(SYMBOLS.warn)} ${label}  ${color.dim(detail)}` ;
-  console.log(line);
-};
-var stepSkip = (label, detail) => {
-  const line = detail ? `  ${color.gray(SYMBOLS.arrow)} ${color.dim(`${label}  ${detail}`)}` : `  ${color.gray(SYMBOLS.arrow)} ${color.dim(label)}`;
-  console.log(line);
-};
-var stepInfo = (message2) => {
-  console.log(`      ${color.gray("\xB7")} ${color.dim(message2)}`);
-};
-var sectionDivider = () => {
-  console.log("");
-  console.log(color.gray("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
-  console.log("");
-};
-
-// src/commands/search-command.ts
 var DEFAULT_MAX_COST_USD = "30";
 var formatReviewCount2 = (count) => {
   if (count >= 1e3) return `${(count / 1e3).toFixed(1)}k`;
@@ -147528,8 +147760,12 @@ var AGENT_TOOLS = [
   },
   { name: "Cursor", detectDir: ".cursor", skillsDir: ".cursor/skills" }
 ];
-var HOOK_FILES = ["auto-approve-zero.sh", "zero-context.sh"];
-var ZERO_SANDBOX_DOMAIN = "*.zero.xyz";
+var HOOK_FILES = [
+  "auto-approve-zero.sh",
+  "zero-context.sh",
+  "ensure-runner.sh"
+];
+var ZERO_SANDBOX_DOMAIN2 = "*.zero.xyz";
 var LEGACY_SKILL_NAMES = ["zero"];
 var removeSkills = (home, verbose = false) => {
   const skillNames = LEGACY_SKILL_NAMES;
@@ -147604,7 +147840,8 @@ var stripZeroFromSettings = (settings, verbose) => {
   if (hooks) {
     changed = removeHookEntries(hooks, "PreToolUse", "auto-approve-zero", verbose) || changed;
     changed = removeHookEntries(hooks, "UserPromptSubmit", "zero-context", verbose) || changed;
-    for (const key of ["PreToolUse", "UserPromptSubmit"]) {
+    changed = removeHookEntries(hooks, "SessionStart", "ensure-runner", verbose) || changed;
+    for (const key of ["PreToolUse", "UserPromptSubmit", "SessionStart"]) {
       const arr = hooks[key];
       if (Array.isArray(arr) && arr.length === 0) delete hooks[key];
     }
@@ -147614,11 +147851,11 @@ var stripZeroFromSettings = (settings, verbose) => {
   const network = sandbox?.network && typeof sandbox.network === "object" ? sandbox.network : null;
   if (network && Array.isArray(network.allowedDomains)) {
     const domains = network.allowedDomains;
-    const next = domains.filter((d3) => d3 !== ZERO_SANDBOX_DOMAIN);
+    const next = domains.filter((d3) => d3 !== ZERO_SANDBOX_DOMAIN2);
     if (next.length !== domains.length) {
       changed = true;
       if (verbose) {
-        stepInfo(`sandbox.network.allowedDomains -= ${ZERO_SANDBOX_DOMAIN}`);
+        stepInfo(`sandbox.network.allowedDomains -= ${ZERO_SANDBOX_DOMAIN2}`);
       }
       if (next.length === 0) {
         delete network.allowedDomains;
@@ -148648,7 +148885,7 @@ var createApp = (appContext) => {
       command: actionCommand.name()
     });
   });
-  program2.addCommand(initCommand());
+  program2.addCommand(initCommand(appContext));
   program2.addCommand(uninstallCommand(appContext));
   program2.addCommand(searchCommand(appContext));
   program2.addCommand(getCommand(appContext));

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@zeroxyz/cli",
-	"version": "1.0.0",
+	"version": "1.1.0",
 	"type": "module",
 	"bin": {
 		"zero": "dist/index.js",