typescript-virtual-container 1.2.5 → 1.2.6

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.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,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,CAkExE"}

package/dist/commands/help.js

@@ -1,7 +1,79 @@
-export function createHelpCommand(getNames) {
+import { getCommandModulesPublic } from "./index";
+const CATEGORY_ORDER = ["navigation", "files", "text", "archive", "system", "network", "shell", "users", "misc"];
+const CATEGORY_LABELS = {
+    navigation: "Navigation",
+    files: "Files & Filesystem",
+    text: "Text Processing",
+    archive: "Archive & Compression",
+    system: "System",
+    network: "Network",
+    shell: "Shell",
+    users: "Users & Permissions",
+    misc: "Miscellaneous",
+};
+function padRight(s, n) {
+    return s.length >= n ? s : s + " ".repeat(n - s.length);
+}
+export function createHelpCommand(_getNames) {
     return {
         name: "help",
-        params: [],
-        run: () => ({ stdout: `Builtins: ${getNames().join(" ")}`, exitCode: 0 }),
+        description: "Display this help message",
+        category: "shell",
+        params: ["[command]"],
+        run: ({ args }) => {
+            const modules = getCommandModulesPublic();
+            // help <command>
+            if (args[0]) {
+                const mod = modules.find((m) => m.name === args[0] || m.aliases?.includes(args[0]));
+                if (!mod)
+                    return { stderr: `help: no help for '${args[0]}'`, exitCode: 1 };
+                const aliases = mod.aliases?.length ? `  aliases: ${mod.aliases.join(", ")}\n` : "";
+                const params = mod.params.map((p) => `  ${mod.name} ${p}`).join("\n");
+                return {
+                    stdout: [
+                        `\x1b[1m${mod.name}\x1b[0m — ${mod.description ?? "no description"}`,
+                        aliases,
+                        "Usage:",
+                        params || `  ${mod.name}`,
+                    ].filter(Boolean).join("\n"),
+                    exitCode: 0,
+                };
+            }
+            // Full help — grouped by category
+            const grouped = {};
+            for (const mod of modules) {
+                const cat = mod.category ?? "misc";
+                if (!grouped[cat])
+                    grouped[cat] = [];
+                grouped[cat].push(mod);
+            }
+            const lines = [];
+            lines.push("\x1b[1mAvailable commands\x1b[0m");
+            lines.push("");
+            const cats = [
+                ...CATEGORY_ORDER.filter((c) => grouped[c]),
+                ...Object.keys(grouped).filter((c) => !CATEGORY_ORDER.includes(c)),
+            ];
+            for (const cat of cats) {
+                const mods = grouped[cat];
+                if (!mods || mods.length === 0)
+                    continue;
+                lines.push(`\x1b[33m${CATEGORY_LABELS[cat] ?? cat}\x1b[0m`);
+                // Two-column layout
+                const sorted = [...mods].sort((a, b) => a.name.localeCompare(b.name));
+                for (let i = 0; i < sorted.length; i += 2) {
+                    const left = sorted[i];
+                    const right = sorted[i + 1];
+                    const leftStr = `  \x1b[36m${padRight(left.name, 14)}\x1b[0m ${left.description ?? ""}`;
+                    const rightStr = right
+                        ? `  \x1b[36m${padRight(right.name, 14)}\x1b[0m ${right.description ?? ""}`
+                        : "";
+                    lines.push(rightStr ? `${leftStr.padEnd(44)}${rightStr}` : leftStr);
+                }
+                lines.push("");
+            }
+            lines.push("Type \x1b[1mhelp <command>\x1b[0m for usage details.");
+            return { stdout: lines.join("\n"), exitCode: 0 };
+        },
     };
 }

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

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

package/dist/commands/hostname.js

@@ -1,5 +1,7 @@
 export const hostnameCommand = {
     name: "hostname",
+    description: "Print hostname",
+    category: "system",
     params: [],
     run: ({ hostname }) => ({ stdout: hostname, exitCode: 0 }),
 };

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

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

package/dist/commands/htop.js

@@ -1,5 +1,7 @@
 export const htopCommand = {
     name: "htop",
+    description: "System monitor",
+    category: "system",
     params: [],
     run: ({ mode }) => {
         if (mode === "exec") {

package/dist/commands/id.d.ts

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

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

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

package/dist/commands/id.js

@@ -0,0 +1,14 @@
+export const idCommand = {
+    name: "id",
+    description: "Print user identity",
+    category: "system",
+    params: ["[user]"],
+    run: ({ authUser, shell, args }) => {
+        const target = args[0] ?? authUser;
+        const uid = target === "root" ? 0 : 1000;
+        const gid = uid;
+        const isSudo = shell.users.isSudoer(target);
+        const groups = isSudo ? `${gid}(${target}),0(root)` : `${gid}(${target})`;
+        return { stdout: `uid=${uid}(${target}) gid=${gid}(${target}) groups=${groups}`, exitCode: 0 };
+    },
+};

package/dist/commands/index.d.ts

@@ -1,8 +1,11 @@
+/** biome-ignore-all lint/style/useNamingConvention: ENV VARIABLES */
 import type { VirtualShell } from "../VirtualShell";
-import type { CommandContext, CommandMode, CommandResult, ShellModule } from "../types/commands";
+import type { CommandContext, CommandMode, CommandResult, ShellEnv, ShellModule } from "../types/commands";
 export declare function registerCommand(module: ShellModule): void;
 export declare function createCustomCommand(name: string, params: string[], run: (ctx: CommandContext) => CommandResult | Promise<CommandResult>): ShellModule;
 export declare function getCommandNames(): string[];
+export declare function getCommandModulesPublic(): ShellModule[];
 export declare function resolveModule(name: string): ShellModule | undefined;
-export declare function runCommand(rawInput: string, authUser: string, hostname: string, mode: CommandMode, cwd: string, shell: VirtualShell, stdin?: string): Promise<CommandResult>;
+export declare function makeDefaultEnv(authUser: string, hostname: string): ShellEnv;
+export declare function runCommand(rawInput: string, authUser: string, hostname: string, mode: CommandMode, cwd: string, shell: VirtualShell, stdin?: string, env?: ShellEnv): Promise<CommandResult>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EACX,cAAc,EACd,WAAW,EACX,aAAa,EACb,WAAW,EACX,MAAM,mBAAmB,CAAC;AA0G3B,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAgBzD;AAED,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EAAE,EAChB,GAAG,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,GAClE,WAAW,CAEb;AAED,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAG1C;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAGnE;AAgDD,wBAAsB,UAAU,CAC/B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,YAAY,EACnB,KAAK,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,aAAa,CAAC,CAqDxB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EACX,cAAc,EACd,WAAW,EACX,aAAa,EACb,QAAQ,EACR,WAAW,EACX,MAAM,mBAAmB,CAAC;AA8G3B,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAYzD;AAED,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EAAE,EAChB,GAAG,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,GAClE,WAAW,CAEb;AAED,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAG1C;AAED,wBAAgB,uBAAuB,IAAI,WAAW,EAAE,CAEvD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAGnE;AA8BD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAc3E;AAED,wBAAsB,UAAU,CAC/B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,YAAY,EACnB,KAAK,CAAC,EAAE,MAAM,EACd,GAAG,CAAC,EAAE,QAAQ,GACZ,OAAO,CAAC,aAAa,CAAC,CA+CxB"}