typescript-virtual-container 1.2.5 → 1.2.7

package/dist/commands/awk.js

@@ -0,0 +1,29 @@
+import { getFlag } from "./command-helpers";
+export const awkCommand = {
+    name: "awk",
+    description: "Pattern scanning and processing language (minimal)",
+    category: "text",
+    params: ["[-F <sep>] '<program>' [file]"],
+    run: ({ args, stdin }) => {
+        const sep = getFlag(args, ["-F"]) ?? " ";
+        const prog = args.find((a) => !a.startsWith("-") && a !== sep);
+        if (!prog)
+            return { stderr: "awk: no program", exitCode: 1 };
+        // Only support print $N and {print $N} patterns
+        const printMatch = prog.match(/^\{?\s*print\s+([^}]+)\s*\}?$/);
+        if (!printMatch)
+            return { stderr: `awk: unsupported program: ${prog}`, exitCode: 1 };
+        const fields = printMatch[1].split(/\s*,\s*/).map((f) => f.trim());
+        const lines = (stdin ?? "").split("\n").filter(Boolean);
+        const out = lines.map((line) => {
+            const parts = line.split(sep === " " ? /\s+/ : sep);
+            return fields.map((f) => {
+                if (f === "$0")
+                    return line;
+                const n = parseInt(f.replace("$", ""), 10);
+                return Number.isNaN(n) ? f.replace(/"/g, "") : (parts[n - 1] ?? "");
+            }).join(sep === " " ? "\t" : sep);
+        });
+        return { stdout: out.join("\n"), exitCode: 0 };
+    },
+};

package/dist/commands/base64.d.ts

@@ -0,0 +1,3 @@
+import type { ShellModule } from "../types/commands";
+export declare const base64Command: ShellModule;
+//# sourceMappingURL=base64.d.ts.map

package/dist/commands/base64.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.d.ts","sourceRoot":"","sources":["../../src/commands/base64.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,eAAO,MAAM,aAAa,EAAE,WAc3B,CAAC"}

package/dist/commands/base64.js

@@ -0,0 +1,20 @@
+import { ifFlag } from "./command-helpers";
+export const base64Command = {
+    name: "base64",
+    description: "Encode/decode base64",
+    category: "text",
+    params: ["[-d] [file]"],
+    run: ({ args, stdin }) => {
+        const decode = ifFlag(args, ["-d", "--decode"]);
+        const input = stdin ?? "";
+        if (decode) {
+            try {
+                return { stdout: Buffer.from(input.trim(), "base64").toString("utf8"), exitCode: 0 };
+            }
+            catch {
+                return { stderr: "base64: invalid input", exitCode: 1 };
+            }
+        }
+        return { stdout: Buffer.from(input).toString("base64"), exitCode: 0 };
+    },
+};

package/dist/commands/cat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cat.d.ts","sourceRoot":"","sources":["../../src/commands/cat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,eAAO,MAAM,UAAU,EAAE,WAaxB,CAAC"}
+{"version":3,"file":"cat.d.ts","sourceRoot":"","sources":["../../src/commands/cat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,eAAO,MAAM,UAAU,EAAE,WAexB,CAAC"}

package/dist/commands/cat.js

@@ -2,6 +2,8 @@ import { getArg } from "./command-helpers";
 import { assertPathAccess, resolveReadablePath } from "./helpers";
 export const catCommand = {
     name: "cat",
+    description: "Concatenate and print files",
+    category: "files",
     params: ["<file>"],
     run: ({ authUser, shell, cwd, args }) => {
         const fileArg = getArg(args, 0);

package/dist/commands/cd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cd.d.ts","sourceRoot":"","sources":["../../src/commands/cd.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,eAAO,MAAM,SAAS,EAAE,WAiBvB,CAAC"}
+{"version":3,"file":"cd.d.ts","sourceRoot":"","sources":["../../src/commands/cd.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,eAAO,MAAM,SAAS,EAAE,WAmBvB,CAAC"}

package/dist/commands/cd.js

@@ -1,6 +1,8 @@
 import { assertPathAccess, resolvePath } from "./helpers";
 export const cdCommand = {
     name: "cd",
+    description: "Change directory",
+    category: "navigation",
     params: ["[path]"],
     run: ({ authUser, shell, cwd, args, mode }) => {
         const target = resolvePath(cwd, args[0] ?? "/virtual-env-js");

package/dist/commands/chmod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chmod.d.ts","sourceRoot":"","sources":["../../src/commands/chmod.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,eAAO,MAAM,YAAY,EAAE,WA6B1B,CAAC"}
+{"version":3,"file":"chmod.d.ts","sourceRoot":"","sources":["../../src/commands/chmod.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,eAAO,MAAM,YAAY,EAAE,WA+B1B,CAAC"}

package/dist/commands/chmod.js

@@ -1,6 +1,8 @@
 import { assertPathAccess, resolvePath } from "./helpers";
 export const chmodCommand = {
     name: "chmod",
+    description: "Change file permissions",
+    category: "files",
     params: ["<mode> <file>"],
     run: ({ authUser, shell, cwd, args }) => {
         const [modeArg, fileArg] = args;

package/dist/commands/clear.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clear.d.ts","sourceRoot":"","sources":["../../src/commands/clear.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,eAAO,MAAM,YAAY,EAAE,WAI1B,CAAC"}
+{"version":3,"file":"clear.d.ts","sourceRoot":"","sources":["../../src/commands/clear.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,eAAO,MAAM,YAAY,EAAE,WAO1B,CAAC"}

package/dist/commands/clear.js

@@ -1,5 +1,8 @@
 export const clearCommand = {
     name: "clear",
+    description: "Clear the terminal screen",
+    category: "shell",
     params: [],
-    run: () => ({ clearScreen: true, exitCode: 0 }),
+    // clearScreen flag triggers \x1b[2J\x1b[H in the shell layer
+    run: () => ({ clearScreen: true, stdout: "", exitCode: 0 }),
 };

package/dist/commands/cp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cp.d.ts","sourceRoot":"","sources":["../../src/commands/cp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,eAAO,MAAM,SAAS,EAAE,WAuEvB,CAAC"}
+{"version":3,"file":"cp.d.ts","sourceRoot":"","sources":["../../src/commands/cp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,eAAO,MAAM,SAAS,EAAE,WAyEvB,CAAC"}

package/dist/commands/cp.js

@@ -2,6 +2,8 @@ import { ifFlag } from "./command-helpers";
 import { assertPathAccess, resolvePath } from "./helpers";
 export const cpCommand = {
     name: "cp",
+    description: "Copy files or directories",
+    category: "files",
     params: ["[-r] <source> <dest>"],
     run: ({ authUser, shell, cwd, args }) => {
         const recursive = ifFlag(args, ["-r", "-R", "--recursive"]);

package/dist/commands/curl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"curl.d.ts","sourceRoot":"","sources":["../../src/commands/curl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AASrD,eAAO,MAAM,WAAW,EAAE,WAiDzB,CAAC"}
+{"version":3,"file":"curl.d.ts","sourceRoot":"","sources":["../../src/commands/curl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AASrD,eAAO,MAAM,WAAW,EAAE,WAmDzB,CAAC"}

package/dist/commands/curl.js

@@ -2,6 +2,8 @@ import { parseArgs } from "./command-helpers";
 import { assertPathAccess, normalizeTerminalOutput, resolvePath, runHostCommand, } from "./helpers";
 export const curlCommand = {
     name: "curl",
+    description: "HTTP client",
+    category: "network",
     params: ["[-o file] <url>"],
     run: async ({ authUser, cwd, args, shell }) => {
         const { flagsWithValues, positionals } = parseArgs(args, {

package/dist/commands/cut.d.ts

@@ -0,0 +1,3 @@
+import type { ShellModule } from "../types/commands";
+export declare const cutCommand: ShellModule;
+//# sourceMappingURL=cut.d.ts.map

package/dist/commands/cut.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cut.d.ts","sourceRoot":"","sources":["../../src/commands/cut.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,eAAO,MAAM,UAAU,EAAE,WAyBxB,CAAC"}

package/dist/commands/cut.js

@@ -0,0 +1,27 @@
+import { getFlag } from "./command-helpers";
+export const cutCommand = {
+    name: "cut",
+    description: "Remove sections from lines",
+    category: "text",
+    params: ["-d <delim> -f <fields> [file]"],
+    run: ({ args, stdin }) => {
+        const delim = getFlag(args, ["-d"]) ?? "\t";
+        const fields = getFlag(args, ["-f"]) ?? "1";
+        const cols = fields.split(",").map((f) => {
+            const [a, b] = f.split("-").map(Number);
+            return b !== undefined ? { from: (a ?? 1) - 1, to: b - 1 } : { from: (a ?? 1) - 1, to: (a ?? 1) - 1 };
+        });
+        const lines = (stdin ?? "").split("\n");
+        const out = lines.map((line) => {
+            const parts = line.split(delim);
+            const selected = [];
+            for (const col of cols) {
+                for (let i = col.from; i <= Math.min(col.to, parts.length - 1); i++) {
+                    selected.push(parts[i] ?? "");
+                }
+            }
+            return selected.join(delim);
+        });
+        return { stdout: out.join("\n"), exitCode: 0 };
+    },
+};

package/dist/commands/date.d.ts

@@ -0,0 +1,3 @@
+import type { ShellModule } from "../types/commands";
+export declare const dateCommand: ShellModule;
+//# sourceMappingURL=date.d.ts.map

package/dist/commands/date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../src/commands/date.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,eAAO,MAAM,WAAW,EAAE,WAqBzB,CAAC"}

package/dist/commands/date.js

@@ -0,0 +1,22 @@
+export const dateCommand = {
+    name: "date",
+    description: "Print current date and time",
+    category: "system",
+    params: ["[+format]"],
+    run: ({ args }) => {
+        const now = new Date();
+        const fmt = args[0];
+        if (fmt?.startsWith("+")) {
+            const f = fmt.slice(1)
+                .replace("%Y", String(now.getFullYear()))
+                .replace("%m", String(now.getMonth() + 1).padStart(2, "0"))
+                .replace("%d", String(now.getDate()).padStart(2, "0"))
+                .replace("%H", String(now.getHours()).padStart(2, "0"))
+                .replace("%M", String(now.getMinutes()).padStart(2, "0"))
+                .replace("%S", String(now.getSeconds()).padStart(2, "0"))
+                .replace("%s", String(Math.floor(now.getTime() / 1000)));
+            return { stdout: f, exitCode: 0 };
+        }
+        return { stdout: now.toString(), exitCode: 0 };
+    },
+};

package/dist/commands/deluser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deluser.d.ts","sourceRoot":"","sources":["../../src/commands/deluser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,eAAO,MAAM,cAAc,EAAE,WAgB5B,CAAC"}
+{"version":3,"file":"deluser.d.ts","sourceRoot":"","sources":["../../src/commands/deluser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,eAAO,MAAM,cAAc,EAAE,WAkB5B,CAAC"}

package/dist/commands/deluser.js

@@ -1,5 +1,7 @@
 export const deluserCommand = {
     name: "deluser",
+    description: "Delete a user",
+    category: "users",
     params: ["<username>"],
     run: async ({ authUser, args, shell }) => {
         if (authUser !== "root") {

package/dist/commands/df.d.ts

@@ -0,0 +1,3 @@
+import type { ShellModule } from "../types/commands";
+export declare const dfCommand: ShellModule;
+//# sourceMappingURL=df.d.ts.map

package/dist/commands/df.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"df.d.ts","sourceRoot":"","sources":["../../src/commands/df.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,eAAO,MAAM,SAAS,EAAE,WAevB,CAAC"}

package/dist/commands/df.js

@@ -0,0 +1,16 @@
+export const dfCommand = {
+    name: "df",
+    description: "Report filesystem disk space usage",
+    category: "system",
+    params: ["[-h]"],
+    run: ({ shell }) => {
+        const bytes = shell.vfs.getUsageBytes();
+        const used = (bytes / 1024).toFixed(0);
+        const total = "1048576"; // 1GB virtual
+        const avail = String(Number(total) - Number(used));
+        const pct = Math.round((Number(used) / Number(total)) * 100);
+        const hdr = "Filesystem     1K-blocks    Used Available Use% Mounted on";
+        const row = `virtual-fs     ${total.padStart(9)} ${used.padStart(7)} ${avail.padStart(9)} ${pct}% /`;
+        return { stdout: `${hdr}\n${row}`, exitCode: 0 };
+    },
+};

package/dist/commands/diff.d.ts

@@ -0,0 +1,3 @@
+import type { ShellModule } from "../types/commands";
+export declare const diffCommand: ShellModule;
+//# sourceMappingURL=diff.d.ts.map

package/dist/commands/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/commands/diff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,eAAO,MAAM,WAAW,EAAE,WAyBzB,CAAC"}

package/dist/commands/diff.js

@@ -0,0 +1,40 @@
+import { resolvePath } from "./helpers";
+export const diffCommand = {
+    name: "diff",
+    description: "Compare files line by line",
+    category: "text",
+    params: ["<file1> <file2>"],
+    run: ({ shell, cwd, args }) => {
+        const [f1, f2] = args;
+        if (!f1 || !f2)
+            return { stderr: "diff: missing operand", exitCode: 1 };
+        const p1 = resolvePath(cwd, f1);
+        const p2 = resolvePath(cwd, f2);
+        let a, b;
+        try {
+            a = shell.vfs.readFile(p1).split("\n");
+        }
+        catch {
+            return { stderr: `diff: ${f1}: No such file or directory`, exitCode: 2 };
+        }
+        try {
+            b = shell.vfs.readFile(p2).split("\n");
+        }
+        catch {
+            return { stderr: `diff: ${f2}: No such file or directory`, exitCode: 2 };
+        }
+        const out = [];
+        const max = Math.max(a.length, b.length);
+        for (let i = 0; i < max; i++) {
+            const la = a[i];
+            const lb = b[i];
+            if (la !== lb) {
+                if (la !== undefined)
+                    out.push(`< ${la}`);
+                if (lb !== undefined)
+                    out.push(`> ${lb}`);
+            }
+        }
+        return { stdout: out.join("\n"), exitCode: out.length > 0 ? 1 : 0 };
+    },
+};

package/dist/commands/du.d.ts

@@ -0,0 +1,3 @@
+import type { ShellModule } from "../types/commands";
+export declare const duCommand: ShellModule;
+//# sourceMappingURL=du.d.ts.map

package/dist/commands/du.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"du.d.ts","sourceRoot":"","sources":["../../src/commands/du.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,eAAO,MAAM,SAAS,EAAE,WAkCvB,CAAC"}

package/dist/commands/du.js

@@ -0,0 +1,39 @@
+import { ifFlag } from "./command-helpers";
+import { resolvePath } from "./helpers";
+export const duCommand = {
+    name: "du",
+    description: "Estimate file space usage",
+    category: "system",
+    params: ["[-h] [-s] [path]"],
+    run: ({ shell, cwd, args }) => {
+        const human = ifFlag(args, ["-h"]);
+        const summary = ifFlag(args, ["-s"]);
+        const target = args.find((a) => !a.startsWith("-")) ?? ".";
+        const p = resolvePath(cwd, target);
+        const fmt = (b) => human ? `${(b / 1024).toFixed(1)}K` : String(Math.ceil(b / 1024));
+        if (!shell.vfs.exists(p))
+            return { stderr: `du: ${target}: No such file or directory`, exitCode: 1 };
+        if (summary || shell.vfs.stat(p).type === "file") {
+            return { stdout: `${fmt(shell.vfs.getUsageBytes(p))}\t${target}`, exitCode: 0 };
+        }
+        const lines = [];
+        const walk = (dir, rel) => {
+            let total = 0;
+            for (const e of shell.vfs.list(dir)) {
+                const full = `${dir}/${e}`, r = `${rel}/${e}`;
+                const st = shell.vfs.stat(full);
+                if (st.type === "directory")
+                    total += walk(full, r);
+                else {
+                    total += st.size;
+                    if (!summary)
+                        lines.push(`${fmt(st.size)}\t${r}`);
+                }
+            }
+            lines.push(`${fmt(total)}\t${rel}`);
+            return total;
+        };
+        walk(p, target);
+        return { stdout: lines.join("\n"), exitCode: 0 };
+    },
+};

package/dist/commands/echo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"echo.d.ts","sourceRoot":"","sources":["../../src/commands/echo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAUrD,eAAO,MAAM,WAAW,EAAE,WAgBzB,CAAC"}
+{"version":3,"file":"echo.d.ts","sourceRoot":"","sources":["../../src/commands/echo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAUrD,eAAO,MAAM,WAAW,EAAE,WAkBzB,CAAC"}

package/dist/commands/echo.js

@@ -7,6 +7,8 @@ function expandEnvVars(input, env) {
 }
 export const echoCommand = {
     name: "echo",
+    description: "Display text",
+    category: "shell",
     params: ["[options] [text...]"],
     run: ({ args, authUser, stdin }) => {
         const { flags, positionals } = parseArgs(args, { flags: ["-n"] });

package/dist/commands/env.d.ts

@@ -1,3 +1,4 @@
+/** biome-ignore-all lint/style/useNamingConvention: ENV VARS */
 import type { ShellModule } from "../types/commands";
 export declare const envCommand: ShellModule;
 //# sourceMappingURL=env.d.ts.map

package/dist/commands/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/commands/env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,eAAO,MAAM,UAAU,EAAE,WAkBxB,CAAC"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/commands/env.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,eAAO,MAAM,UAAU,EAAE,WASxB,CAAC"}

package/dist/commands/env.js

@@ -1,18 +1,10 @@
-import { getAllEnvVars } from "./set";
 export const envCommand = {
     name: "env",
-    params: ["[VAR=value...] [command]"],
-    run: ({ authUser }) => {
-        // For now, just display all environment variables
-        // In a full implementation, this would also handle running commands with modified env
-        const allVars = getAllEnvVars(authUser);
-        const envVarsOutput = Object.entries(allVars)
-            .map(([key, value]) => `${key}=${value}`)
-            .sort()
-            .join("\n");
-        return {
-            stdout: envVarsOutput,
-            exitCode: 0,
-        };
+    description: "Print environment variables",
+    category: "shell",
+    params: [],
+    run: ({ env, authUser }) => {
+        const vars = { ...env.vars, USER: authUser, HOME: `/home/${authUser}` };
+        return { stdout: Object.entries(vars).map(([k, v]) => `${k}=${v}`).join("\n"), exitCode: 0 };
     },
 };

package/dist/commands/export.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,eAAO,MAAM,aAAa,EAAE,WAiC3B,CAAC"}
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,eAAO,MAAM,aAAa,EAAE,WAsB3B,CAAC"}

package/dist/commands/export.js

@@ -1,32 +1,22 @@
-import { getArg } from "./command-helpers";
-import { getEnvVar, setEnvVar } from "./set";
 export const exportCommand = {
     name: "export",
+    description: "Set shell environment variable",
+    category: "shell",
     params: ["[VAR=value]"],
-    run: ({ args }) => {
-        // export VAR=value or export VAR (to make it available to child processes)
+    run: ({ args, env }) => {
         if (args.length === 0) {
-            // List all exported variables
-            return {
-                stdout: "# export command - sets variables for child processes",
-                exitCode: 0,
-            };
+            const out = Object.entries(env.vars).map(([k, v]) => `declare -x ${k}="${v}"`).join("\n");
+            return { stdout: out, exitCode: 0 };
         }
-        // Parse VAR=value format
-        for (let index = 0;; index += 1) {
-            const arg = getArg(args, index);
-            if (!arg) {
-                break;
-            }
+        for (const arg of args) {
             if (arg.includes("=")) {
-                const [varName, varValue] = arg.split("=", 2);
-                if (varName && varValue !== undefined) {
-                    setEnvVar(varName, varValue);
-                }
+                const eq = arg.indexOf("=");
+                const name = arg.slice(0, eq);
+                const value = arg.slice(eq + 1);
+                env.vars[name] = value;
             }
             else {
-                // export VAR_NAME makes it available but we just set it
-                setEnvVar(arg, getEnvVar(arg) || "");
+                // mark existing as exported (already is)
             }
         }
         return { exitCode: 0 };

package/dist/commands/find.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../src/commands/find.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,eAAO,MAAM,WAAW,EAAE,WAwDzB,CAAC"}
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../src/commands/find.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,eAAO,MAAM,WAAW,EAAE,WA0DzB,CAAC"}

package/dist/commands/find.js

@@ -2,6 +2,8 @@ import { getFlag } from "./command-helpers";
 import { assertPathAccess, resolvePath } from "./helpers";
 export const findCommand = {
     name: "find",
+    description: "Search for files",
+    category: "files",
     params: ["[path] [-name <pattern>] [-type f|d]"],
     run: ({ authUser, shell, cwd, args }) => {
         const namePattern = getFlag(args, ["-name"]);

package/dist/commands/grep.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grep.d.ts","sourceRoot":"","sources":["../../src/commands/grep.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,eAAO,MAAM,WAAW,EAAE,WA2FzB,CAAC"}
+{"version":3,"file":"grep.d.ts","sourceRoot":"","sources":["../../src/commands/grep.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,eAAO,MAAM,WAAW,EAAE,WAwFzB,CAAC"}

package/dist/commands/grep.js

@@ -2,11 +2,11 @@ import { parseArgs } from "./command-helpers";
 import { assertPathAccess, resolvePath } from "./helpers";
 export const grepCommand = {
     name: "grep",
+    description: "Search text patterns",
+    category: "text",
     params: ["[-i] [-v] [-n] [-r] <pattern> [file...]"],
     run: ({ authUser, shell, cwd, args, stdin }) => {
-        const { flags, positionals } = parseArgs(args, {
-            flags: ["-i", "-v", "-n", "-r"],
-        });
+        const { flags, positionals } = parseArgs(args, { flags: ["-i", "-v", "-n", "-r"] });
         const caseInsensitive = flags.has("-i");
         const invertMatch = flags.has("-v");
         const showLineNumbers = flags.has("-n");
@@ -80,10 +80,7 @@ export const grepCommand = {
                     results.push(...matchLines(content, prefix));
                 }
                 catch {
-                    return {
-                        stderr: `grep: ${file}: No such file or directory`,
-                        exitCode: 1,
-                    };
+                    return { stderr: `grep: ${file}: No such file or directory`, exitCode: 1 };
                 }
             }
         }

package/dist/commands/groups.d.ts

@@ -0,0 +1,3 @@
+import type { ShellModule } from "../types/commands";
+export declare const groupsCommand: ShellModule;
+//# sourceMappingURL=groups.d.ts.map

package/dist/commands/groups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"groups.d.ts","sourceRoot":"","sources":["../../src/commands/groups.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,eAAO,MAAM,aAAa,EAAE,WAW3B,CAAC"}

package/dist/commands/groups.js

@@ -0,0 +1,12 @@
+export const groupsCommand = {
+    name: "groups",
+    description: "Print group memberships",
+    category: "system",
+    params: ["[user]"],
+    run: ({ authUser, shell, args }) => {
+        const target = args[0] ?? authUser;
+        const isSudo = shell.users.isSudoer(target);
+        const grps = isSudo ? `${target} sudo root` : target;
+        return { stdout: grps, exitCode: 0 };
+    },
+};

package/dist/commands/gzip.d.ts

@@ -0,0 +1,4 @@
+import type { ShellModule } from "../types/commands";
+export declare const gzipCommand: ShellModule;
+export declare const gunzipCommand: ShellModule;
+//# sourceMappingURL=gzip.d.ts.map

package/dist/commands/gzip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gzip.d.ts","sourceRoot":"","sources":["../../src/commands/gzip.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,eAAO,MAAM,WAAW,EAAE,WAYzB,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,WAa3B,CAAC"}

package/dist/commands/gzip.js

@@ -0,0 +1,40 @@
+import { resolvePath } from "./helpers";
+export const gzipCommand = {
+    name: "gzip",
+    description: "Compress files",
+    category: "archive",
+    params: ["<file>"],
+    run: ({ shell, cwd, args }) => {
+        const file = args[0];
+        if (!file)
+            return { stderr: "gzip: no file specified", exitCode: 1 };
+        const p = resolvePath(cwd, file);
+        try {
+            shell.vfs.compressFile(p);
+            return { exitCode: 0 };
+        }
+        catch {
+            return { stderr: `gzip: ${file}: No such file or directory`, exitCode: 1 };
+        }
+    },
+};
+export const gunzipCommand = {
+    name: "gunzip",
+    description: "Decompress files",
+    category: "archive",
+    params: ["<file>"],
+    aliases: ["zcat"],
+    run: ({ shell, cwd, args }) => {
+        const file = args[0];
+        if (!file)
+            return { stderr: "gunzip: no file specified", exitCode: 1 };
+        const p = resolvePath(cwd, file);
+        try {
+            shell.vfs.decompressFile(p);
+            return { exitCode: 0 };
+        }
+        catch {
+            return { stderr: `gunzip: ${file}: No such file or directory`, exitCode: 1 };
+        }
+    },
+};

package/dist/commands/head.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"head.d.ts","sourceRoot":"","sources":["../../src/commands/head.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,eAAO,MAAM,WAAW,EAAE,WA8BzB,CAAC"}
+{"version":3,"file":"head.d.ts","sourceRoot":"","sources":["../../src/commands/head.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,eAAO,MAAM,WAAW,EAAE,WAgCzB,CAAC"}

package/dist/commands/head.js

@@ -2,6 +2,8 @@ import { getFlag } from "./command-helpers";
 import { assertPathAccess, resolvePath } from "./helpers";
 export const headCommand = {
     name: "head",
+    description: "Output first lines",
+    category: "text",
     params: ["[-n <lines>] [file...]"],
     run: ({ authUser, shell, cwd, args, stdin }) => {
         const nArg = getFlag(args, ["-n"]);

package/dist/commands/help.d.ts

@@ -1,3 +1,3 @@
 import type { ShellModule } from "../types/commands";
-export declare function createHelpCommand(getNames: () => string[]): ShellModule;
+export declare function createHelpCommand(_getNames: () => string[]): ShellModule;
 //# sourceMappingURL=help.d.ts.map

package/dist/commands/help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,MAAM,EAAE,GAAG,WAAW,CAMvE"}
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAoBrD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,MAAM,EAAE,GAAG,WAAW,CAyDxE"}