@mifune/agro 0.15.0 → 0.15.1

package/dist/agro.js

@@ -7,8 +7,8 @@ var __export = (target, all) => {
 
 // src/cli.ts
 import { fileURLToPath } from "node:url";
-import { dirname as dirname10, join as join17, resolve as resolve11 } from "node:path";
-import { existsSync as existsSync21, mkdtempSync as mkdtempSync5, readFileSync as readFileSync12, rmSync as rmSync6 } from "node:fs";
+import { dirname as dirname10, join as join18, resolve as resolve11 } from "node:path";
+import { existsSync as existsSync22, mkdtempSync as mkdtempSync5, readFileSync as readFileSync12, rmSync as rmSync6 } from "node:fs";
 import { tmpdir as tmpdir4 } from "node:os";
 
 // src/commands/update.ts
@@ -2222,7 +2222,7 @@ function resolveExecutionTarget(opts) {
 }
 
 // src/lib/version.ts
-var AGRO_VERSION = true ? "0.15.0" : "0.0.0-dev";
+var AGRO_VERSION = true ? "0.15.1" : "0.0.0-dev";
 var OFFICIAL_IMAGE = "ghcr.io/mifunedev/agro";
 var RELEASE_VERSION = /^[0-9]+\.[0-9]+\.[0-9]+(?:-[a-z][a-z0-9]*\.[0-9]+)?$/;
 function parseReleaseVersion(value) {
@@ -3732,9 +3732,9 @@ async function runLangfuseSetup(opts, io) {
 }
 
 // src/commands/sandbox.ts
-import { existsSync as existsSync15, mkdirSync as mkdirSync7, mkdtempSync as mkdtempSync3, rmSync as rmSync3, statSync as statSync4 } from "node:fs";
+import { existsSync as existsSync16, mkdirSync as mkdirSync8, mkdtempSync as mkdtempSync3, rmSync as rmSync3, statSync as statSync4 } from "node:fs";
 import { tmpdir as tmpdir3 } from "node:os";
-import { join as join11, resolve as resolve7 } from "node:path";
+import { join as join12, resolve as resolve7 } from "node:path";
 
 // src/lib/runtimes/catalog.ts
 var RUNTIME_CATALOG = Object.freeze([
@@ -3763,6 +3763,27 @@ function runtimeIds() {
   return RUNTIME_CATALOG.map((r) => r.id);
 }
 
+// src/lib/star-prompt.ts
+import { existsSync as existsSync15, mkdirSync as mkdirSync7, writeFileSync as writeFileSync8 } from "node:fs";
+import { join as join11 } from "node:path";
+var STAR_PROMPT_LINE = "\u2B50 If AGRO helps, star https://github.com/mifunedev/agro";
+var MARKER = "star-prompt-shown";
+function maybePrintStarPrompt(io, env = process.env, isTTY = process.stdout.isTTY === true, stateHome = resolveUserStateHome(env)) {
+  if (env.AGRO_NO_STAR_PROMPT === "1") return;
+  if (env.CI !== void 0 && env.CI !== "") return;
+  if (!isTTY) return;
+  const marker = join11(stateHome, MARKER);
+  if (existsSync15(marker)) return;
+  io.stdout(`${STAR_PROMPT_LINE}
+`);
+  try {
+    mkdirSync7(stateHome, { recursive: true });
+    writeFileSync8(marker, "");
+  } catch {
+    return;
+  }
+}
+
 // src/commands/sandbox.ts
 function hostTimezone() {
   const tz = process.env.TZ;
@@ -3779,27 +3800,27 @@ function gitIdentity(run, key) {
   return (result.stdout ?? "").trim();
 }
 function isBuildCapable(repo) {
-  return repo !== void 0 && existsSync15(join11(repo, ".devcontainer", "Dockerfile"));
+  return repo !== void 0 && existsSync16(join12(repo, ".devcontainer", "Dockerfile"));
 }
 function prepareHomeMount(value) {
   const path4 = resolve7(value);
-  if (existsSync15(path4)) {
+  if (existsSync16(path4)) {
     if (!statSync4(path4).isDirectory()) {
       throw new Error(`--home-mount path exists and is not a directory: ${path4}`);
     }
     return path4;
   }
-  mkdirSync7(path4, { recursive: true });
+  mkdirSync8(path4, { recursive: true });
   return path4;
 }
 function readSeedConfig(repo) {
   if (repo === void 0) return void 0;
   const file = agroConfigPath(repo);
-  return existsSync15(file) ? readAgroConfig(file) : void 0;
+  return existsSync16(file) ? readAgroConfig(file) : void 0;
 }
 function readEntryConfig(name) {
   const file = agroConfigPath(entryRoot(name));
-  return existsSync15(file) ? readAgroConfig(file) : void 0;
+  return existsSync16(file) ? readAgroConfig(file) : void 0;
 }
 function assignSetting(target, path4, value) {
   const segments = path4.split(".");
@@ -3896,7 +3917,7 @@ async function runSandboxInstall(opts, io) {
     return 1;
   }
   const checkout = opts.checkout === void 0 ? void 0 : resolve7(opts.checkout);
-  if (checkout !== void 0 && !existsSync15(checkout)) {
+  if (checkout !== void 0 && !existsSync16(checkout)) {
     io.stderr(`${opts.bin} sandbox install: --checkout directory does not exist: ${checkout}
 `);
     return 1;
@@ -3915,7 +3936,7 @@ async function runSandboxInstall(opts, io) {
   if (buildRequested && !isBuildCapable(configCheckout(config))) {
     const target = configCheckout(config) ?? resolve7(opts.checkout ?? ".");
     io.stderr(
-      `${opts.bin} sandbox install: image.mode is "build" but ${join11(target, ".devcontainer", "Dockerfile")} does not exist \u2014 point --checkout <dir> at a harness checkout that has .devcontainer/Dockerfile, or set image.mode to "image" to run the prebuilt image
+      `${opts.bin} sandbox install: image.mode is "build" but ${join12(target, ".devcontainer", "Dockerfile")} does not exist \u2014 point --checkout <dir> at a harness checkout that has .devcontainer/Dockerfile, or set image.mode to "image" to run the prebuilt image
 `
     );
     return 1;
@@ -3959,7 +3980,7 @@ async function runSandboxInstall(opts, io) {
     ...useNoBuild ? { noBuild: true } : {}
   };
   if (opts.printArgv === true) {
-    const preview = mkdtempSync3(join11(tmpdir3(), "oh-sandbox-preview-"));
+    const preview = mkdtempSync3(join12(tmpdir3(), "oh-sandbox-preview-"));
     try {
       writeAgroConfig(preview, config);
       materialize(preview, { ...configCheckout(config) !== void 0 ? { checkout: configCheckout(config) } : {} });
@@ -3969,12 +3990,15 @@ async function runSandboxInstall(opts, io) {
     }
   }
   const root = entryRoot(config.name);
-  mkdirSync7(root, { recursive: true });
+  mkdirSync8(root, { recursive: true });
   writeAgroConfig(root, config);
   materialize(root, { ...configCheckout(config) !== void 0 ? { checkout: configCheckout(config) } : {} });
   const code = await runSandbox({ ...sandboxOpts, cwd: root }, io);
-  if (code === 0) io.stdout(`next: ${opts.bin} shell ${config.name}
+  if (code === 0) {
+    io.stdout(`next: ${opts.bin} shell ${config.name}
 `);
+    maybePrintStarPrompt(io);
+  }
   return code;
 }
 async function entryStatus(root, name, run) {
@@ -4026,9 +4050,9 @@ async function runSandboxList(opts, io) {
 }
 
 // src/commands/harness.ts
-import { existsSync as existsSync18 } from "node:fs";
+import { existsSync as existsSync19 } from "node:fs";
 import { homedir as homedir3 } from "node:os";
-import { delimiter as delimiter2, join as join14 } from "node:path";
+import { delimiter as delimiter2, join as join15 } from "node:path";
 
 // src/lib/docs.ts
 var SOURCE_DOCS_BASE = "https://github.com/mifunedev/agro/blob/main/";
@@ -4041,17 +4065,17 @@ function sourceDocsUrl(docsPath) {
 }
 
 // src/lib/host-config.ts
-import { existsSync as existsSync16, mkdirSync as mkdirSync8, readFileSync as readFileSync11, renameSync as renameSync4, unlinkSync as unlinkSync5, writeFileSync as writeFileSync8 } from "node:fs";
-import { basename as basename5, dirname as dirname8, isAbsolute, join as join12, resolve as resolve8 } from "node:path";
+import { existsSync as existsSync17, mkdirSync as mkdirSync9, readFileSync as readFileSync11, renameSync as renameSync4, unlinkSync as unlinkSync5, writeFileSync as writeFileSync9 } from "node:fs";
+import { basename as basename5, dirname as dirname8, isAbsolute, join as join13, resolve as resolve8 } from "node:path";
 var HOST_CONFIG_MODE = 420;
 var HOST_CONFIG_FILE = "config.json";
 var WORKSPACES_SUBDIR = "workspaces";
-var DEFAULT_WORKSPACE_NAME = "default";
+var DEFAULT_WORKSPACE_NAME = "harness";
 function hostStateHome(env, home) {
   return resolveUserStateHome(env, home);
 }
 function hostConfigPath(env, home) {
-  return join12(hostStateHome(env, home), HOST_CONFIG_FILE);
+  return join13(hostStateHome(env, home), HOST_CONFIG_FILE);
 }
 function assertWorkspaceName(name) {
   if (!SANDBOX_NAME_PATTERN.test(name)) {
@@ -4061,14 +4085,14 @@ function assertWorkspaceName(name) {
   }
 }
 function workspacesRoot(env, home) {
-  return join12(hostStateHome(env, home), WORKSPACES_SUBDIR);
+  return join13(hostStateHome(env, home), WORKSPACES_SUBDIR);
 }
 function workspaceRoot(name, env, home) {
   assertWorkspaceName(name);
-  return join12(workspacesRoot(env, home), name);
+  return join13(workspacesRoot(env, home), name);
 }
 function defaultHarnessRoot(env, home) {
-  return join12(workspacesRoot(env, home), DEFAULT_WORKSPACE_NAME);
+  return join13(workspacesRoot(env, home), DEFAULT_WORKSPACE_NAME);
 }
 function validateHostConfig(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {
@@ -4126,7 +4150,7 @@ function validateReceipts(value, field, noun) {
 }
 function readHostConfig(env, home) {
   const path4 = hostConfigPath(env, home);
-  if (!existsSync16(path4)) return { version: 1 };
+  if (!existsSync17(path4)) return { version: 1 };
   let raw;
   try {
     raw = readFileSync11(path4, "utf8");
@@ -4148,9 +4172,9 @@ function writeHostConfig(config, env, home) {
   const body = `${JSON.stringify(validated, null, 2)}
 `;
   const tmp = `${path4}.tmp.${process.pid}`;
-  mkdirSync8(dirname8(path4), { recursive: true });
+  mkdirSync9(dirname8(path4), { recursive: true });
   try {
-    writeFileSync8(tmp, body, { mode: HOST_CONFIG_MODE, encoding: "utf8" });
+    writeFileSync9(tmp, body, { mode: HOST_CONFIG_MODE, encoding: "utf8" });
     renameSync4(tmp, path4);
   } catch (error) {
     try {
@@ -4177,8 +4201,8 @@ function fieldError2(path4, requirement) {
 }
 
 // src/lib/host-workspace.ts
-import { existsSync as existsSync17, mkdirSync as mkdirSync9, mkdtempSync as mkdtempSync4, readdirSync as readdirSync3, renameSync as renameSync5, rmSync as rmSync4, statSync as statSync5 } from "node:fs";
-import { dirname as dirname9, join as join13, resolve as resolve9 } from "node:path";
+import { existsSync as existsSync18, mkdirSync as mkdirSync10, mkdtempSync as mkdtempSync4, readdirSync as readdirSync3, renameSync as renameSync5, rmSync as rmSync4, statSync as statSync5 } from "node:fs";
+import { dirname as dirname9, join as join14, resolve as resolve9 } from "node:path";
 var AGRO_REPO_URL = "https://github.com/mifunedev/agro.git";
 var IGNORABLE_ENTRIES = [
   REGISTRY_SUBDIR,
@@ -4190,7 +4214,7 @@ function isDirectory3(path4) {
   return statSync5(path4, { throwIfNoEntry: false })?.isDirectory() === true;
 }
 function stateHomes(home) {
-  return STATE_HOME_DIRS.map((name) => join13(home, name));
+  return STATE_HOME_DIRS.map((name) => join14(home, name));
 }
 function stateHomeRootRefusal(bin, root, home, verb = "harness") {
   const target = resolve9(root);
@@ -4198,7 +4222,7 @@ function stateHomeRootRefusal(bin, root, home, verb = "harness") {
   if (enclosing === void 0) return void 0;
   return `${bin} ${verb}: the ${verb} root ${target} is the state home ${enclosing} itself.
 A workspace there collides with AGRO state and blocks every command run from ${home}.
-Move it out \u2014 for example \`mv ${enclosing} ${join13(home, "agro")}\` \u2014 then re-run this command.
+Move it out \u2014 for example \`mv ${enclosing} ${join14(home, "agro")}\` \u2014 then re-run this command.
 `;
 }
 function isIgnorableEntry(name) {
@@ -4215,16 +4239,16 @@ function cloneInto(target, run, root, ref) {
   assertCloned(run("git", ["clone", ...branch, AGRO_REPO_URL, target], { stdio: "inherit" }), root);
 }
 function cloneThroughStaging(root, run, ref) {
-  const staging = mkdtempSync4(join13(dirname9(root), "agro-clone-"));
+  const staging = mkdtempSync4(join14(dirname9(root), "agro-clone-"));
   try {
-    const checkout = join13(staging, "agro");
+    const checkout = join14(staging, "agro");
     cloneInto(checkout, run, root, ref);
     for (const name of readdirSync3(checkout)) {
-      const destination = join13(root, name);
-      if (existsSync17(destination)) {
+      const destination = join14(root, name);
+      if (existsSync18(destination)) {
         throw new Error(`could not move ${name} into ${root} \u2014 the path already exists`);
       }
-      renameSync5(join13(checkout, name), destination);
+      renameSync5(join14(checkout, name), destination);
     }
   } finally {
     rmSync4(staging, { recursive: true, force: true });
@@ -4232,10 +4256,10 @@ function cloneThroughStaging(root, run, ref) {
 }
 function ensureHostWorkspace(path4, run = spawnRunner, ref) {
   const root = resolve9(path4);
-  if (existsSync17(join13(root, ".git"))) return { root, action: "reused" };
+  if (existsSync18(join14(root, ".git"))) return { root, action: "reused" };
   const stats = statSync5(root, { throwIfNoEntry: false });
   if (stats === void 0) {
-    mkdirSync9(dirname9(root), { recursive: true });
+    mkdirSync10(dirname9(root), { recursive: true });
     cloneInto(root, run, root, ref);
     return { root, action: "cloned" };
   }
@@ -4254,11 +4278,11 @@ function ensureHostWorkspace(path4, run = spawnRunner, ref) {
 function listHostWorkspaces(env, home) {
   const root = workspacesRoot(env, home);
   if (!isDirectory3(root)) return [];
-  return readdirSync3(root, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name).filter((name) => SANDBOX_NAME_PATTERN.test(name)).filter((name) => existsSync17(join13(root, name, ".git"))).sort();
+  return readdirSync3(root, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name).filter((name) => SANDBOX_NAME_PATTERN.test(name)).filter((name) => existsSync18(join14(root, name, ".git"))).sort();
 }
 function resolveExistingWorkspace(bin, verb, path4, env, home) {
   const root = resolve9(path4);
-  if (existsSync17(join13(root, ".git"))) return { ok: true, root };
+  if (existsSync18(join14(root, ".git"))) return { ok: true, root };
   const existing = listHostWorkspaces(env, home);
   const inventory = existing.length === 0 ? "No host workspace exists yet.\n" : `Workspaces that exist: ${existing.join(", ")}
 `;
@@ -4288,7 +4312,7 @@ function targetFor(root, run, env) {
   });
 }
 function hostPrefix(home) {
-  return join14(home, ".local");
+  return join15(home, ".local");
 }
 function pathEntries(env) {
   return (env.PATH ?? "").split(delimiter2).filter((part) => part !== "");
@@ -4341,7 +4365,7 @@ function probeableHost(env, home) {
     return void 0;
   }
   const prefix = hostPrefix(home);
-  if (!existsSync18(join14(root, ".git")) && !existsSync18(prefix)) return void 0;
+  if (!existsSync19(join15(root, ".git")) && !existsSync19(prefix)) return void 0;
   return { root, prefix };
 }
 async function collectStates(root, run, home, env, only) {
@@ -4774,9 +4798,9 @@ async function runHarnessInstall(name, opts, io) {
 }
 
 // src/commands/workspace.ts
-import { existsSync as existsSync19, rmSync as rmSync5 } from "node:fs";
+import { existsSync as existsSync20, rmSync as rmSync5 } from "node:fs";
 import { homedir as homedir4 } from "node:os";
-import { join as join15, resolve as resolve10 } from "node:path";
+import { join as join16, resolve as resolve10 } from "node:path";
 function homeOf2(opts) {
   return (opts.homedir ?? homedir4)();
 }
@@ -4822,9 +4846,9 @@ async function runWorkspaceCreate(name, opts, io) {
     return 1;
   }
   let action;
-  const preexisting = existsSync19(root);
+  const preexisting = existsSync20(root);
   try {
-    if (!opts.json && !existsSync19(join15(root, ".git"))) {
+    if (!opts.json && !existsSync20(join16(root, ".git"))) {
       const at = opts.ref !== void 0 ? ` at ${opts.ref}` : "";
       io.stdout(`cloning ${AGRO_REPO_URL}${at} into ${root}\u2026
 `);
@@ -4869,7 +4893,7 @@ async function runWorkspaceList(opts, io) {
     const recorded = recordedRoot(env, home);
     const registry = workspacesRoot(env, home);
     rows = listHostWorkspaces(env, home).map((name) => {
-      const root = join15(registry, name);
+      const root = join16(registry, name);
       return { name, root, default: recorded === root };
     });
   } catch (err) {
@@ -4894,9 +4918,9 @@ async function runWorkspaceList(opts, io) {
 }
 
 // src/commands/tool.ts
-import { existsSync as existsSync20 } from "node:fs";
+import { existsSync as existsSync21 } from "node:fs";
 import { homedir as homedir5, userInfo as userInfo2 } from "node:os";
-import { delimiter as delimiter3, join as join16 } from "node:path";
+import { delimiter as delimiter3, join as join17 } from "node:path";
 
 // src/lib/tools/catalog.ts
 var TOOLS_DOC = "docs/installation.md";
@@ -5326,7 +5350,7 @@ function targetFor2(root, run, env) {
   });
 }
 function hostPrefix2(home) {
-  return join16(home, ".local");
+  return join17(home, ".local");
 }
 function pathEntries2(env) {
   return (env.PATH ?? "").split(delimiter3).filter((part) => part !== "");
@@ -5406,7 +5430,7 @@ function probeableHost2(env, home) {
     return void 0;
   }
   const prefix = hostPrefix2(home);
-  if (!existsSync20(join16(root, ".git")) && !existsSync20(prefix)) return void 0;
+  if (!existsSync21(join17(root, ".git")) && !existsSync21(prefix)) return void 0;
   return { root, prefix };
 }
 async function collectRows(root, run, home, env, only) {
@@ -6171,8 +6195,8 @@ Usage:
 
 \`install\` and \`uninstall\` act on the running sandbox. When no sandbox is
 reachable they act on the host. A host install needs an existing AGRO workspace
-and creates none \u2014 run \`${bin} workspace create <name>\` first. The default root is
-the workspace registry entry \`~/.agro/workspaces/default\`. \`--workspace <name>\`
+and creates none \u2014 run \`${bin} workspace create\` first. The fallback root is
+the workspace registry entry \`~/.agro/workspaces/harness\`. \`--workspace <name>\`
 chooses another entry and \`--path <dir>\` a directory outside the registry. A
 successful install records the root as \`harnessRoot\` in \`~/.agro/config.json\`. The
 install prefix is always \`~/.local\`.
@@ -6202,8 +6226,8 @@ Usage:
 
 A host workspace is an AGRO checkout under \`~/.agro/workspaces/<name>\`. \`create\`
 clones ${AGRO_REPO_URL} into that entry, and reuses an existing checkout. The
-default name is \`default\`. \`--path <dir>\` creates the workspace outside the
-registry instead.
+implicit name is \`harness\`. Pass \`default\` to create that named workspace.
+\`--path <dir>\` creates the workspace outside the registry instead.
 
 \`create\` records no default. A host install selects its root with
 \`${bin} harness install <harness> --workspace <name>\`, and that install records the
@@ -6266,8 +6290,8 @@ only on these tools:
 ${hostCapableToolIds().map((t) => `  ${t}`).join("\n")}
 
 A host install needs an existing AGRO workspace \u2014 \`--path <dir>\`, then
-\`harnessRoot\` in \`~/.agro/config.json\`, then \`~/.agro/workspaces/default\`. It creates
-no workspace: run \`${bin} workspace create <name>\` first. It installs into
+\`harnessRoot\` in \`~/.agro/config.json\`, then \`~/.agro/workspaces/harness\`. It creates
+no workspace: run \`${bin} workspace create\` first. It installs into
 \`~/.local\` and records the install as \`hostTools\` in that same file. On the host,
 \`uninstall\` removes only what \`install\` recorded, from the prefix in that record.
 Without a record it refuses, and \`--force\` overrides.
@@ -6924,11 +6948,11 @@ function parseGatewayArgs(rest) {
   }
   return { ok: true, args: { help: false, passthrough: [...rest] } };
 }
-function bundledPayloadExists(bundled, exists = existsSync21) {
-  return exists(join17(bundled.sourceControlDir, "manifest.json"));
+function bundledPayloadExists(bundled, exists = existsSync22) {
+  return exists(join18(bundled.sourceControlDir, "manifest.json"));
 }
 function resolveVendorSource(args, bundled, bin = AGRO_PRODUCT.bin) {
-  const exists = bundled.exists ?? existsSync21;
+  const exists = bundled.exists ?? existsSync22;
   if (args.fromDir !== void 0) {
     return { kind: "local", fromDir: resolve11(args.fromDir) };
   }
@@ -6948,7 +6972,7 @@ function resolveVendorSource(args, bundled, bin = AGRO_PRODUCT.bin) {
 function readPayloadVersion(checkoutDir) {
   try {
     const parsed = JSON.parse(
-      readFileSync12(join17(resolveControlDir(checkoutDir), "cli", "package.json"), "utf8")
+      readFileSync12(join18(resolveControlDir(checkoutDir), "cli", "package.json"), "utf8")
     );
     if (parsed && typeof parsed.version === "string") return parsed.version;
   } catch {
@@ -6957,7 +6981,7 @@ function readPayloadVersion(checkoutDir) {
 }
 async function runWithRemoteSource(hooks, fn) {
   const fetch2 = hooks.fetch ?? fetchRemoteSource;
-  const mkdtemp = hooks.mkdtemp ?? (() => mkdtempSync5(join17(tmpdir4(), "oh-remote-")));
+  const mkdtemp = hooks.mkdtemp ?? (() => mkdtempSync5(join18(tmpdir4(), "oh-remote-")));
   const rm = hooks.rm ?? ((dir) => rmSync6(dir, { recursive: true, force: true }));
   const out = hooks.stdout ?? ((s) => process.stdout.write(s));
   const checkoutDir = mkdtemp();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mifune/agro",
-  "version": "0.15.0",
+  "version": "0.15.1",
   "description": "AGRO CLI — create and manage sandboxes for coding agents.",
   "license": "Apache-2.0",
   "homepage": "https://github.com/mifunedev/agro#readme",