buninu 0.2.2 → 0.2.3

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.2.3 - 2026-08-18
+
+### Added
+
+- Add `buninu.exitAfterCmd` package.json setting (default `false`). When
+  `true`, the shell/PTY exits with `buninu.command`'s status instead of
+  falling back to an interactive shell once the command finishes; `false`
+  keeps the existing fall-back-to-shell behavior.
+- Add `--export-config [output.json]`, which writes this entire `package.json`
+  to `buninu.json` in the current directory by default (like `--export`, the
+  output path can be overridden), instead of exporting the whole installation
+  like `--export` does. If the output path already exists, it now asks for
+  confirmation (`[y/N]`) before overwriting.
+
 ## 0.2.2 - 2026-08-17
 
 ### Added

package/README.md

@@ -142,8 +142,8 @@ rejects a syscall bin-linking uses), so `bunx` can't install anything there yet.
 Export the current Buninu installation as a gzip-compressed tar archive:
 
 ```sh
-npx buninu --export
-npx buninu --export /path/to/buninu.tgz
+npx buninu@latest --export
+npx buninu@latest --export /path/to/buninu.tgz
 ```
 
 The default output is `./buninu.tgz`. The archive contains exactly one
@@ -151,6 +151,17 @@ top-level directory so consumers can remove one component while extracting.
 Export requires `tar` in `PATH`; when replacing an existing output,
 Buninu restores the previous file if archive creation or replacement fails.
 
+Export this `package.json` on its own, instead of the whole installation:
+
+```sh
+npx buninu@latest --export-config
+npx buninu@latest --export-config /path/to/buninu.json
+```
+
+The default output is `./buninu.json`. This is the full `package.json` (not
+just the `buninu` section), so the output is ready to use as-is anywhere a
+complete replacement `package.json` is expected.
+
 ## Environment
 
 `BUNINU_HOME` is the absolute path to the installed Buninu package root.
@@ -263,6 +274,19 @@ Override it for one run with:
 bun ./bin/init.js --command "echo temporary command"
 ```
 
+Set `buninu.exitAfterCmd` to `true` to exit once `buninu.command` finishes
+instead of falling back to an interactive shell. It defaults to `false`,
+which is the current fall-back-to-shell behavior described above.
+
+```json
+{
+  "buninu": {
+    "command": { "default": "echo Welcome to Buninu" },
+    "exitAfterCmd": true
+  }
+}
+```
+
 ## Shell selection (optional)
 
 Set `buninu.shell.default` or a platform-specific value (`android`, `linux`,

package/bin/init.js

@@ -4,6 +4,7 @@ import pkg from "../package.json" with { type: "json" };
 import { existsSync, lstatSync, mkdirSync, mkdtempSync, rmSync, symlinkSync, unlinkSync } from "node:fs";
 import { tmpdir as systemTmpDir } from "node:os";
 import { basename, delimiter, dirname, isAbsolute, resolve } from "node:path";
+import { createInterface } from "node:readline/promises";
 import { fileURLToPath } from "node:url";
 
 const binDir = dirname(fileURLToPath(import.meta.url));
@@ -27,6 +28,7 @@ Init options:
   --readme               Render README.md in the terminal and exit
   --changelog            Render CHANGELOG.md in the terminal and exit
   --export [output.tgz]  Export this Buninu installation (default: ./buninu.tgz)
+  --export-config [output.json]  Export this package.json (default: ./buninu.json)
   --shell <path|name>    Override buninu.shell for this run
   --command <command>    Override buninu.command for this run
 
@@ -42,10 +44,13 @@ Package configuration:
   package.json contains a buninu section for default and platform settings.
   buninu.shell          Select the shell to start
   buninu.command        Run a startup command before entering the shell
+  buninu.exitAfterCmd   Exit after buninu.command instead of falling back to
+                         the shell (default: false)
 
 All other options are forwarded to jsgotty. Without buninu.command, the
 selected shell starts directly. With a command, it runs from the package.json
-directory and then returns to the interactive shell regardless of exit status.
+directory and then returns to the interactive shell regardless of exit status,
+unless buninu.exitAfterCmd is true, in which case it exits instead.
 `;
 }
 
@@ -69,6 +74,12 @@ async function handleInformationArguments(arguments_) {
     return true;
   }
 
+  const exportConfigOption = readExportConfigArgument(arguments_);
+  if (exportConfigOption) {
+    await exportConfig(exportConfigOption.output);
+    return true;
+  }
+
   if (arguments_.includes("--readme")) {
     const readmePath = resolve(REPO_ROOT, "README.md");
     if (!await pathExists(readmePath)) fail(`README not found: ${readmePath}`);
@@ -106,6 +117,22 @@ function readExportArgument(arguments_) {
   return null;
 }
 
+function readExportConfigArgument(arguments_) {
+  for (let index = 0; index < arguments_.length; index += 1) {
+    const argument = arguments_[index];
+    if (argument === "--export-config") {
+      const next = arguments_[index + 1];
+      return { output: next || "buninu.json" };
+    }
+    if (argument.startsWith("--export-config=")) {
+      const output = argument.slice("--export-config=".length);
+      if (!output) fail("--export-config= requires an output path");
+      return { output };
+    }
+  }
+  return null;
+}
+
 async function exportInstallation(output) {
   const outputPath = resolve(process.cwd(), output);
   const tar = Bun.which(process.platform === "win32" ? "tar.exe" : "tar") || Bun.which("tar");
@@ -145,6 +172,25 @@ async function exportInstallation(output) {
   console.log(outputPath);
 }
 
+async function exportConfig(output) {
+  const outputPath = resolve(process.cwd(), output);
+
+  if (existsSync(outputPath)) {
+    const rl = createInterface({ input: process.stdin, output: process.stderr });
+    let answer;
+    try {
+      answer = await rl.question(`${outputPath} already exists and may be overwritten. Continue? [y/N] `);
+    } finally {
+      rl.close();
+    }
+    if (!/^[yY]/.test(answer.trim())) fail("Cancelled: output file was not overwritten");
+  }
+
+  const packageJsonPath = resolve(REPO_ROOT, "package.json");
+  await Bun.write(outputPath, Bun.file(packageJsonPath));
+  console.log(outputPath);
+}
+
 function splitCommand(command) {
   const words = [];
   let word = "";
@@ -460,16 +506,25 @@ function readInitArguments(arguments_) {
   return { shell, command, forwarded };
 }
 
-function shellCommandArguments(shell, command) {
+function shellCommandArguments(shell, command, exitAfterCmd) {
   if (!command) return [shell];
 
   const shellName = basename(shell).toLowerCase();
   if (shellName === "cmd" || shellName === "cmd.exe") {
+    if (exitAfterCmd) return [shell, "/d", "/s", "/c", command];
     const quotedShell = `"${shell.replaceAll('"', '""')}"`;
     return [shell, "/d", "/s", "/c", `${command} & ${quotedShell}`];
   }
 
   if (["powershell", "powershell.exe", "pwsh", "pwsh.exe"].includes(shellName)) {
+    if (exitAfterCmd) {
+      return [
+        shell,
+        "-NoLogo",
+        "-Command",
+        `& { ${command}; if (-not $?) { Write-Error 'Startup command failed' } }`,
+      ];
+    }
     const escapedShell = shell.replaceAll("'", "''");
     return [
       shell,
@@ -483,7 +538,7 @@ function shellCommandArguments(shell, command) {
     `buninu_command=$1; shift; ( eval "$buninu_command" ); status=$?; ` +
     `if [ "$status" -ne 0 ]; then ` +
     `echo "buninu: startup command failed with exit $status" >&2; ` +
-    `fi; exec "$0"`;
+    (exitAfterCmd ? `fi; exit "$status"` : `fi; exec "$0"`);
   // Pass both the shell and startup command as argv instead of interpolating
   // them into the wrapper. This keeps the wrapper single-line and avoids LF
   // (Ctrl+J) characters in its process-list representation.
@@ -539,6 +594,7 @@ const configuredCommand =
       commandConfiguration?.default ??
       null;
 const startupCommand = initArguments.command ?? configuredCommand;
+const exitAfterCmd = Boolean(pkg.buninu?.exitAfterCmd);
 
 const forwardedArguments = initArguments.forwarded;
 const hasExplicitPort = forwardedArguments.some((argument) =>
@@ -559,7 +615,7 @@ const child = Bun.spawn(
     ...command,
     ...portArguments,
     ...forwardedArguments,
-    ...shellCommandArguments(environment.shell, startupCommand),
+    ...shellCommandArguments(environment.shell, startupCommand, exitAfterCmd),
   ],
   {
     cwd: rootDir,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "buninu",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Buninu is a portable, self-bootstrapping Unix-like userspace built on Bun that runs across operating systems",
   "type": "module",
   "main": "./bin/init.js",
@@ -22,7 +22,8 @@
       "linux": null,
       "macos": null,
       "windows": null
-    }
+    },
+    "exitAfterCmd": false
   },
   "scripts": {
     "start": "bun ./apps/jsgotty/gotty.js --reconnect -r -w --webgl -a 127.0.0.1",