typescript-virtual-container 1.2.5 → 1.2.7

package/dist/commands/help.js

@@ -1,7 +1,70 @@
-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`);
+                const sorted = [...mods].sort((a, b) => a.name.localeCompare(b.name));
+                for (const mod of sorted) {
+                    lines.push(`  \x1b[36m${padRight(mod.name, 14)}\x1b[0m ${mod.description ?? ""}`);
+                }
+            }
+            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"}

package/dist/commands/index.js

@@ -1,21 +1,32 @@
 import { adduserCommand } from "./adduser";
+import { awkCommand } from "./awk";
+import { base64Command } from "./base64";
 import { catCommand } from "./cat";
 import { cdCommand } from "./cd";
 import { chmodCommand } from "./chmod";
 import { clearCommand } from "./clear";
 import { cpCommand } from "./cp";
 import { curlCommand } from "./curl";
+import { cutCommand } from "./cut";
+import { dateCommand } from "./date";
 import { deluserCommand } from "./deluser";
+import { dfCommand } from "./df";
+import { diffCommand } from "./diff";
+import { duCommand } from "./du";
 import { echoCommand } from "./echo";
 import { envCommand } from "./env";
 import { exitCommand } from "./exit";
 import { exportCommand } from "./export";
 import { findCommand } from "./find";
 import { grepCommand } from "./grep";
+import { groupsCommand } from "./groups";
+import { gunzipCommand, gzipCommand } from "./gzip";
 import { headCommand } from "./head";
 import { createHelpCommand } from "./help";
 import { hostnameCommand } from "./hostname";
 import { htopCommand } from "./htop";
+import { idCommand } from "./id";
+import { killCommand } from "./kill";
 import { lnCommand } from "./ln";
 import { lsCommand } from "./ls";
 import { mkdirCommand } from "./mkdir";
@@ -23,71 +34,68 @@ import { mvCommand } from "./mv";
 import { nanoCommand } from "./nano";
 import { neofetchCommand } from "./neofetch";
 import { passwdCommand } from "./passwd";
+import { pingCommand } from "./ping";
+import { psCommand } from "./ps";
 import { pwdCommand } from "./pwd";
 import { rmCommand } from "./rm";
+import { sedCommand } from "./sed";
 import { setCommand } from "./set";
 import { shCommand } from "./sh";
+import { sleepCommand } from "./sleep";
+import { sortCommand } from "./sort";
 import { suCommand } from "./su";
 import { sudoCommand } from "./sudo";
 import { tailCommand } from "./tail";
+import { tarCommand } from "./tar";
+import { teeCommand } from "./tee";
 import { touchCommand } from "./touch";
+import { trCommand } from "./tr";
 import { treeCommand } from "./tree";
+import { unameCommand } from "./uname";
+import { uniqCommand } from "./uniq";
 import { unsetCommand } from "./unset";
 import { wcCommand } from "./wc";
 import { wgetCommand } from "./wget";
 import { whoCommand } from "./who";
 import { whoamiCommand } from "./whoami";
+import { xargsCommand } from "./xargs";
 const BASE_COMMANDS = [
-    pwdCommand,
-    whoamiCommand,
-    whoCommand,
-    hostnameCommand,
-    lsCommand,
-    cdCommand,
-    catCommand,
-    echoCommand,
-    mkdirCommand,
-    touchCommand,
-    rmCommand,
-    treeCommand,
-    nanoCommand,
+    // Navigation
+    pwdCommand, cdCommand, lsCommand, treeCommand,
+    // Files
+    catCommand, touchCommand, rmCommand, mkdirCommand, cpCommand, mvCommand, lnCommand,
+    chmodCommand, findCommand,
+    // Text processing
+    grepCommand, sedCommand, awkCommand, sortCommand, uniqCommand, wcCommand,
+    headCommand, tailCommand, cutCommand, trCommand, teeCommand, xargsCommand,
+    diffCommand,
+    // Archives
+    tarCommand, gzipCommand, gunzipCommand, base64Command,
+    // System info
+    whoamiCommand, whoCommand, hostnameCommand, idCommand, groupsCommand, unameCommand,
+    psCommand, killCommand, dfCommand, duCommand, dateCommand, sleepCommand, pingCommand,
+    // Shell
+    echoCommand, envCommand, exportCommand, setCommand, unsetCommand, shCommand,
+    clearCommand, exitCommand,
+    // Editors
+    nanoCommand, htopCommand,
+    // Network
+    curlCommand, wgetCommand,
+    // Users
+    adduserCommand, passwdCommand, deluserCommand, sudoCommand, suCommand,
+    // Misc
     neofetchCommand,
-    htopCommand,
-    adduserCommand,
-    passwdCommand,
-    deluserCommand,
-    sudoCommand,
-    suCommand,
-    curlCommand,
-    envCommand,
-    wgetCommand,
-    grepCommand,
-    exportCommand,
-    setCommand,
-    unsetCommand,
-    shCommand,
-    clearCommand,
-    exitCommand,
-    cpCommand,
-    mvCommand,
-    lnCommand,
-    findCommand,
-    wcCommand,
-    headCommand,
-    tailCommand,
-    chmodCommand,
 ];
 const customCommands = [];
-const helpCommand = createHelpCommand(() => getCommandModules().map((cmd) => cmd.name));
 const commandRegistry = new Map();
 let cachedCommandNames = null;
+const helpCommand = createHelpCommand(() => getCommandModules().map((cmd) => cmd.name));
 function buildCache() {
     commandRegistry.clear();
     for (const mod of getCommandModules()) {
         commandRegistry.set(mod.name, mod);
-        for (const alias of mod.aliases ?? []) {
+        for (const alias of mod.aliases ?? [])
             commandRegistry.set(alias, mod);
-        }
     }
     cachedCommandNames = Array.from(commandRegistry.keys()).sort();
 }
@@ -98,11 +106,11 @@ export function registerCommand(module) {
     const normalized = {
         ...module,
         name: module.name.trim().toLowerCase(),
-        aliases: module.aliases?.map((alias) => alias.trim().toLowerCase()),
+        aliases: module.aliases?.map((a) => a.trim().toLowerCase()),
     };
     const names = [normalized.name, ...(normalized.aliases ?? [])];
-    if (names.some((name) => name.length === 0 || /\s/.test(name))) {
-        throw new Error("Command names and aliases must be non-empty and contain no spaces");
+    if (names.some((n) => n.length === 0 || /\s/.test(n))) {
+        throw new Error("Command names must be non-empty and contain no spaces");
     }
     customCommands.push(normalized);
     buildCache();
@@ -115,6 +123,9 @@ export function getCommandNames() {
         buildCache();
     return cachedCommandNames;
 }
+export function getCommandModulesPublic() {
+    return getCommandModules();
+}
 export function resolveModule(name) {
     if (!cachedCommandNames)
         buildCache();
@@ -125,7 +136,7 @@ function splitArgsRespectingQuotes(input) {
     let current = "";
     let inQuotes = false;
     let quoteChar = "";
-    for (let i = 0; i < input.length; i += 1) {
+    for (let i = 0; i < input.length; i++) {
         const ch = input[i] || "";
         const prev = i > 0 ? input[i - 1] : "";
         if ((ch === '"' || ch === "'") && prev !== "\\") {
@@ -155,35 +166,51 @@ function splitArgsRespectingQuotes(input) {
 }
 function parseInput(rawInput) {
     const parts = splitArgsRespectingQuotes(rawInput.trim());
+    return { commandName: parts[0]?.toLowerCase() ?? "", args: parts.slice(1) };
+}
+export function makeDefaultEnv(authUser, hostname) {
     return {
-        commandName: parts[0]?.toLowerCase() ?? "",
-        args: parts.slice(1),
+        vars: {
+            PATH: "/usr/local/bin:/usr/bin:/bin",
+            HOME: `/home/${authUser}`,
+            USER: authUser,
+            LOGNAME: authUser,
+            SHELL: "/bin/sh",
+            TERM: "xterm-256color",
+            HOSTNAME: hostname,
+            PS1: "\\u@\\h:\\w\\$ ",
+        },
+        lastExitCode: 0,
     };
 }
-export async function runCommand(rawInput, authUser, hostname, mode, cwd, shell, stdin) {
+export async function runCommand(rawInput, authUser, hostname, mode, cwd, shell, stdin, env) {
     const trimmed = rawInput.trim();
     if (trimmed.length === 0)
         return { exitCode: 0 };
-    if (trimmed.includes("|") || trimmed.includes(">") || trimmed.includes("<")) {
-        const { parseShellPipeline } = await import("../VirtualShell/shellParser");
-        const { executePipeline } = await import("../SSHMimic/executor");
-        const pipeline = parseShellPipeline(trimmed);
-        if (!pipeline.isValid) {
-            return { stderr: pipeline.error || "Syntax error", exitCode: 1 };
-        }
+    const shellEnv = env ?? makeDefaultEnv(authUser, hostname);
+    // Detect shell operators
+    if (/(?<![|&])[|](?![|])/.test(trimmed) ||
+        trimmed.includes(">") ||
+        trimmed.includes("<") ||
+        trimmed.includes("&&") ||
+        trimmed.includes("||") ||
+        trimmed.includes(";")) {
+        const { parseScript } = await import("../VirtualShell/shellParser");
+        const { executeStatements } = await import("../SSHMimic/executor");
+        const script = parseScript(trimmed);
+        if (!script.isValid)
+            return { stderr: script.error || "Syntax error", exitCode: 1 };
         try {
-            return await executePipeline(pipeline, authUser, hostname, mode, cwd, shell);
+            return await executeStatements(script.statements, authUser, hostname, mode, cwd, shell, shellEnv);
         }
         catch (error) {
-            const message = error instanceof Error ? error.message : "Pipeline execution failed";
-            return { stderr: message, exitCode: 1 };
+            return { stderr: error instanceof Error ? error.message : "Execution failed", exitCode: 1 };
         }
     }
     const { commandName, args } = parseInput(trimmed);
     const mod = resolveModule(commandName);
-    if (!mod) {
-        return { stderr: `Command '${trimmed}' not found`, exitCode: 127 };
-    }
+    if (!mod)
+        return { stderr: `${commandName}: command not found`, exitCode: 127 };
     try {
         return await mod.run({
             authUser,
@@ -195,10 +222,10 @@ export async function runCommand(rawInput, authUser, hostname, mode, cwd, shell,
             stdin,
             cwd,
             shell,
+            env: shellEnv,
         });
     }
     catch (error) {
-        const message = error instanceof Error ? error.message : "Command failed";
-        return { stderr: message, exitCode: 1 };
+        return { stderr: error instanceof Error ? error.message : "Command failed", exitCode: 1 };
     }
 }

package/dist/commands/kill.d.ts

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

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

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

package/dist/commands/kill.js

@@ -0,0 +1,13 @@
+export const killCommand = {
+    name: "kill",
+    description: "Send signal to process",
+    category: "system",
+    params: ["[-9] <pid>"],
+    run: ({ args }) => {
+        const pid = args.find((a) => !a.startsWith("-"));
+        if (!pid)
+            return { stderr: "kill: no pid specified", exitCode: 1 };
+        // In virtual env, we just acknowledge the kill
+        return { stdout: ``, exitCode: 0 };
+    },
+};

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

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

package/dist/commands/ln.js

@@ -2,6 +2,8 @@ import { ifFlag } from "./command-helpers";
 import { assertPathAccess, resolvePath } from "./helpers";
 export const lnCommand = {
     name: "ln",
+    description: "Create links",
+    category: "files",
     params: ["[-s] <target> <link_name>"],
     run: ({ authUser, shell, cwd, args }) => {
         const symbolic = ifFlag(args, ["-s", "--symbolic"]);

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

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

package/dist/commands/ls.js

@@ -23,6 +23,8 @@ function formatDate(date) {
 }
 export const lsCommand = {
     name: "ls",
+    description: "List directory contents",
+    category: "navigation",
     params: ["[path]"],
     run: ({ authUser, shell, cwd, args }) => {
         const longFormat = ifFlag(args, ["-l", "--long"]);

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

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

package/dist/commands/mkdir.js

@@ -2,6 +2,8 @@ import { getArg } from "./command-helpers";
 import { assertPathAccess, resolvePath } from "./helpers";
 export const mkdirCommand = {
     name: "mkdir",
+    description: "Make directories",
+    category: "files",
     params: ["<dir>"],
     run: ({ authUser, shell, cwd, args }) => {
         if (args.length === 0) {

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

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

package/dist/commands/mv.js

@@ -1,6 +1,8 @@
 import { assertPathAccess, resolvePath } from "./helpers";
 export const mvCommand = {
     name: "mv",
+    description: "Move or rename files",
+    category: "files",
     params: ["<source> <dest>"],
     run: ({ authUser, shell, cwd, args }) => {
         const positionals = args.filter((a) => !a.startsWith("-"));

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

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

package/dist/commands/nano.js

@@ -2,6 +2,8 @@ import * as path from "node:path";
 import { assertPathAccess, resolvePath } from "./helpers";
 export const nanoCommand = {
     name: "nano",
+    description: "Text editor",
+    category: "shell",
     params: ["<file>"],
     run: ({ authUser, shell, cwd, args }) => {
         const fileArg = args[0];

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

@@ -1 +1 @@
-{"version":3,"file":"neofetch.d.ts","sourceRoot":"","sources":["../../src/commands/neofetch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,eAAO,MAAM,eAAe,EAAE,WA+B7B,CAAC"}
+{"version":3,"file":"neofetch.d.ts","sourceRoot":"","sources":["../../src/commands/neofetch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,eAAO,MAAM,eAAe,EAAE,WAiC7B,CAAC"}

package/dist/commands/neofetch.js

@@ -3,6 +3,8 @@ import { ifFlag } from "./command-helpers";
 import { getAllEnvVars } from "./set";
 export const neofetchCommand = {
     name: "neofetch",
+    description: "System info display",
+    category: "misc",
     params: ["[--off]"],
     run: ({ args, authUser, hostname, shell }) => {
         const env = getAllEnvVars(authUser);

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

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

package/dist/commands/passwd.js

@@ -1,5 +1,7 @@
 export const passwdCommand = {
     name: "passwd",
+    description: "Change user password",
+    category: "users",
     params: ["<username> <password>"],
     run: async ({ authUser, args, shell }) => {
         const [username, password] = args;

package/dist/commands/ping.d.ts

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

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

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

package/dist/commands/ping.js

@@ -0,0 +1,18 @@
+export const pingCommand = {
+    name: "ping",
+    description: "Send ICMP ECHO_REQUEST (mock)",
+    category: "network",
+    params: ["[-c <count>] <host>"],
+    run: ({ args }) => {
+        const host = args.find((a) => !a.startsWith("-")) ?? "localhost";
+        const count = 4;
+        const lines = [`PING ${host}: 56 data bytes`];
+        for (let i = 0; i < count; i++) {
+            const ms = (Math.random() * 10 + 1).toFixed(3);
+            lines.push(`64 bytes from ${host}: icmp_seq=${i} ttl=64 time=${ms} ms`);
+        }
+        lines.push(`--- ${host} ping statistics ---`);
+        lines.push(`${count} packets transmitted, ${count} received, 0% packet loss`);
+        return { stdout: lines.join("\n"), exitCode: 0 };
+    },
+};

package/dist/commands/ps.d.ts

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

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

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

package/dist/commands/ps.js

@@ -0,0 +1,17 @@
+export const psCommand = {
+    name: "ps",
+    description: "Report process status",
+    category: "system",
+    params: ["[-a] [-u] [-x]"],
+    run: ({ authUser, shell }) => {
+        const sessions = shell.users.listActiveSessions();
+        const lines = ["  PID TTY          TIME CMD"];
+        let pid = 1000;
+        for (const s of sessions) {
+            lines.push(`${String(pid).padStart(5)} ${s.tty.padEnd(12)} 00:00:00 ${s.username === authUser ? "bash" : `bash (${s.username})`}`);
+            pid++;
+        }
+        lines.push(`${String(pid).padStart(5)} pts/0        00:00:00 ps`);
+        return { stdout: lines.join("\n"), exitCode: 0 };
+    },
+};

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

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

package/dist/commands/pwd.js

@@ -1,5 +1,7 @@
 export const pwdCommand = {
     name: "pwd",
+    description: "Print working directory",
+    category: "navigation",
     params: [],
     run: ({ cwd }) => ({ stdout: cwd, exitCode: 0 }),
 };

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

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

package/dist/commands/rm.js

@@ -2,6 +2,8 @@ import { getArg, ifFlag } from "./command-helpers";
 import { assertPathAccess, resolvePath } from "./helpers";
 export const rmCommand = {
     name: "rm",
+    description: "Remove files or directories",
+    category: "files",
     params: ["[-r|-rf] <path>"],
     run: ({ authUser, shell, cwd, args }) => {
         if (args.length === 0) {

package/dist/commands/sed.d.ts

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

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

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