@mifune/agro 0.13.0 → 0.14.0

package/dist/agro.js

@@ -2221,6 +2221,18 @@ function resolveExecutionTarget(opts) {
   return new DockerComposeExecutionTarget(opts);
 }
 
+// src/lib/version.ts
+var AGRO_VERSION = true ? "0.14.0" : "0.0.0-dev";
+var OFFICIAL_IMAGE = "ghcr.io/mifunedev/agro";
+var RELEASE_VERSION = /^[0-9]+\.[0-9]+\.[0-9]+$/;
+function parseReleaseVersion(value) {
+  const bare = value.startsWith("v") ? value.slice(1) : value;
+  return RELEASE_VERSION.test(bare) ? bare : void 0;
+}
+function officialImageRef(version) {
+  return `${OFFICIAL_IMAGE}:${RELEASE_VERSION.test(version) ? version : "latest"}`;
+}
+
 // src/lib/config-render.ts
 var RETIRED_KEYS = [
   "WORKTREES_DIR",
@@ -2242,6 +2254,12 @@ var RETIRED_KEYS = [
   "LANGFUSE_BASE_URL",
   "LANGFUSE_PRIVACY_PRESET"
 ];
+function runsPrebuiltImage(config) {
+  return config.image?.mode === "image";
+}
+function sandboxImageRef(config) {
+  return config.image?.ref ?? (runsPrebuiltImage(config) ? officialImageRef(AGRO_VERSION) : void 0);
+}
 function renderComposeVars(config) {
   const out = [];
   const put = (key, value) => {
@@ -2257,7 +2275,7 @@ function renderComposeVars(config) {
   put("DOCKER_SOCKET", config.access?.dockerSocket);
   put("SANDBOX_SSH", config.access?.ssh);
   put("SANDBOX_SSH_PORT", config.access?.sshPort);
-  put("AGRO_SANDBOX_IMAGE", config.image?.ref);
+  put("AGRO_SANDBOX_IMAGE", sandboxImageRef(config));
   put("AGRO_PULL_POLICY", config.image?.pullPolicy);
   for (const { key, value } of out) {
     if (isSecretKey(key)) {
@@ -2318,7 +2336,6 @@ function sandboxRoot(opts) {
   return root;
 }
 var DEFAULT_CONTAINER_NAME = DEFAULT_SANDBOX_NAME;
-var DEFAULT_SANDBOX_IMAGE = "ghcr.io/mifunedev/agro:latest";
 function configuredField(root, path4) {
   const file = agroConfigPath(root);
   if (!existsSync10(file)) return void 0;
@@ -2363,7 +2380,7 @@ async function runSandbox(opts, io) {
   const root = resolveProjectRoot(opts.cwd);
   const useImage = opts.image === true || opts.imageRef !== void 0;
   const useNoBuild = useImage || opts.noBuild === true;
-  const imageRef = useImage ? opts.imageRef ?? configuredImage(root) ?? DEFAULT_SANDBOX_IMAGE : void 0;
+  const imageRef = useImage ? opts.imageRef ?? configuredImage(root) ?? officialImageRef(AGRO_VERSION) : void 0;
   const env = imageRef === void 0 ? void 0 : { ...process.env, ...agroEnvPair("SANDBOX_IMAGE", imageRef) };
   if (opts.printArgv === true) {
     const script = requireLifecycleScript(root, "docker-compose.sh");
@@ -3933,9 +3950,6 @@ async function runSandboxInstall(opts, io) {
   if (opts.imageRef !== void 0) {
     config.image = { ...config.image, ref: opts.imageRef, mode: "image" };
   }
-  if (configCheckout(config) !== void 0 && config.image?.mode === "image" && nonEmpty(config.image?.ref) === void 0) {
-    config.image = { ...config.image, ref: DEFAULT_SANDBOX_IMAGE };
-  }
   const useNoBuild = opts.noBuild === true || !(configCheckout(config) !== void 0 && config.image?.mode === "build");
   const sandboxOpts = {
     bin: opts.bin,
@@ -5678,7 +5692,6 @@ function fetchRemoteSource(opts) {
 }
 
 // src/cli.ts
-var VERSION = true ? "0.13.0" : "0.0.0-dev";
 var DEFAULT_SOURCE_CONTROL_DIR = resolve11(
   dirname10(fileURLToPath(import.meta.url)),
   "../.."
@@ -5706,7 +5719,7 @@ function integrationLines() {
 }
 function printAgroHelp(product = AGRO_PRODUCT) {
   const { bin, title } = product;
-  process.stdout.write(`${bin} \u2014 ${title} (v${VERSION})
+  process.stdout.write(`${bin} \u2014 ${title} (v${AGRO_VERSION})
 
 Usage:
   ${bin} sandbox <args...>      Create and list sandboxes (install|list)
@@ -5871,7 +5884,8 @@ function printSandboxHelp(bin = AGRO_PRODUCT.bin) {
 Usage:
   ${bin} sandbox install <runtime> [--name <name>] [--checkout <dir>]
                                [--home-mount <dir>] [--yes]
-                               [--image[=<ref>]] [--no-build] [--print-argv]
+                               [--version <X.Y.Z> | --image[=<ref>]]
+                               [--no-build] [--print-argv]
   ${bin} sandbox list [--json]
 
 \`install\` writes a sandbox entry under \${${stateNames(bin).envPrefix}HOME:-~/${stateNames(bin).userStateDir}}/sandboxes/<name>/,
@@ -5898,9 +5912,14 @@ Flags:
                    Docker-managed volume. Relative paths resolve against the
                    working directory. The directory is created when absent
   --yes            Non-interactive: keep every default and ask nothing
-  --image[=<ref>]  Run the prebuilt image instead of building (implies
-                   --no-build). Ref resolves last-wins: --image=<ref> >
-                   ${stateNames(bin).configFile} image.ref > ${DEFAULT_SANDBOX_IMAGE}.
+  --version <X.Y.Z>
+                   Run the official release image ghcr.io/mifunedev/agro:<X.Y.Z>
+                   (implies --image). A leading v is accepted
+  --image          Run the prebuilt image instead of building (implies
+                   --no-build). The ref resolves first-match: --version or
+                   --image=<ref> > ${stateNames(bin).envPrefix}SANDBOX_IMAGE >
+                   ${stateNames(bin).configFile} image.ref > ${officialImageRef(AGRO_VERSION)}
+  --image=<ref>    Run a custom image (implies --image); conflicts with --version
   --no-build       Suppress the local build and reuse an existing image
   --print-argv     Print the docker compose argv that would run, then exit
                    without writing an entry
@@ -6376,6 +6395,7 @@ function parseSandboxArgs(rest, bin = AGRO_PRODUCT.bin) {
   if (isHelpFlag(tail[0])) return { ok: true, args: { ...args, help: true } };
   const positionals = [];
   const checkoutSpellings = /* @__PURE__ */ new Set();
+  let version;
   for (let i = 0; i < tail.length; i++) {
     const token = tail[i];
     const valueFlag = SANDBOX_VALUE_FLAGS[token];
@@ -6402,6 +6422,18 @@ function parseSandboxArgs(rest, bin = AGRO_PRODUCT.bin) {
       }
       args.image = true;
       args.imageRef = ref;
+    } else if (token === "--version" || token.startsWith("--version=")) {
+      const value = token === "--version" ? tail[++i] : token.slice("--version=".length);
+      if (value === void 0 || value === "") {
+        return { ok: false, error: `${bin} sandbox ${head}: --version requires a value` };
+      }
+      version = parseReleaseVersion(value);
+      if (version === void 0) {
+        return {
+          ok: false,
+          error: `${bin} sandbox ${head}: --version "${value}" is not a release version \u2014 expected X.Y.Z`
+        };
+      }
     } else if (token === "--json") {
       args.json = true;
     } else if (token.startsWith("-")) {
@@ -6416,6 +6448,16 @@ function parseSandboxArgs(rest, bin = AGRO_PRODUCT.bin) {
       error: `${bin} sandbox ${head}: --checkout conflicts with --repo \u2014 pass exactly one, and prefer --checkout`
     };
   }
+  if (version !== void 0) {
+    if (args.imageRef !== void 0) {
+      return {
+        ok: false,
+        error: `${bin} sandbox ${head}: --version conflicts with --image=<ref> \u2014 pass --version for an official release or --image=<ref> for a custom image`
+      };
+    }
+    args.image = true;
+    args.imageRef = officialImageRef(version);
+  }
   if (head === "list") {
     if (positionals.length > 0) {
       return { ok: false, error: `${bin} sandbox list: unexpected argument "${positionals[0]}"` };
@@ -6687,7 +6729,7 @@ async function runWithRemoteSource(hooks, fn) {
   const checkoutDir = mkdtemp();
   try {
     fetch2({ destDir: checkoutDir, repoUrl: hooks.repoUrl, ref: hooks.ref });
-    out(`fetched payload v${readPayloadVersion(checkoutDir)} (installed CLI v${VERSION})
+    out(`fetched payload v${readPayloadVersion(checkoutDir)} (installed CLI v${AGRO_VERSION})
 `);
     return await fn(checkoutDir);
   } finally {
@@ -6703,7 +6745,7 @@ async function main(argv) {
     return 0;
   }
   if (isVersionFlag(first)) {
-    process.stdout.write(`${VERSION}
+    process.stdout.write(`${AGRO_VERSION}
 `);
     return 0;
   }
@@ -6809,7 +6851,7 @@ async function main(argv) {
     };
     return await runSelfUpgrade(
       { dryRun: parsed.args.dryRun, argv1: process.argv[1] },
-      defaultDeps(VERSION),
+      defaultDeps(AGRO_VERSION),
       io
     );
   }

package/package.json

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