typescript-virtual-container 1.2.8 → 1.3.0

package/dist/commands/help.js

@@ -1,70 +1,123 @@
-import { getCommandModulesPublic } from "./index";
-const CATEGORY_ORDER = ["navigation", "files", "text", "archive", "system", "network", "shell", "users", "misc"];
+import { getCommandModulesPublic } from "./registry";
+// ─── category config ──────────────────────────────────────────────────────────
+const CATEGORY_ORDER = [
+    "navigation",
+    "files",
+    "text",
+    "archive",
+    "system",
+    "package",
+    "network",
+    "shell",
+    "users",
+    "misc",
+];
 const CATEGORY_LABELS = {
     navigation: "Navigation",
     files: "Files & Filesystem",
     text: "Text Processing",
     archive: "Archive & Compression",
     system: "System",
+    package: "Package Management",
     network: "Network",
-    shell: "Shell",
+    shell: "Shell & Scripting",
     users: "Users & Permissions",
     misc: "Miscellaneous",
 };
-function padRight(s, n) {
+// ─── formatting helpers ───────────────────────────────────────────────────────
+const BOLD = "\x1b[1m";
+const RESET = "\x1b[0m";
+const CYAN = "\x1b[36m";
+const YLW = "\x1b[33m";
+const DIM = "\x1b[2m";
+const GREEN = "\x1b[32m";
+function pad(s, n) {
     return s.length >= n ? s : s + " ".repeat(n - s.length);
 }
+function formatCmdLine(mod) {
+    const aliases = mod.aliases?.length
+        ? ` ${DIM}(${mod.aliases.join(", ")})${RESET}`
+        : "";
+    return `  ${CYAN}${pad(mod.name, 16)}${RESET}${aliases}${pad("", mod.aliases?.length ? 0 : 0)} ${mod.description ?? ""}`;
+}
+// ─── full grouped listing ─────────────────────────────────────────────────────
+function renderFull(modules) {
+    const grouped = {};
+    for (const mod of modules) {
+        const cat = mod.category ?? "misc";
+        if (!grouped[cat])
+            grouped[cat] = [];
+        grouped[cat].push(mod);
+    }
+    const lines = [
+        `${BOLD}Available commands${RESET}`,
+        `${DIM}Type 'help <command>' for detailed usage.${RESET}`,
+        "",
+    ];
+    const cats = [
+        ...CATEGORY_ORDER.filter((c) => grouped[c]),
+        ...Object.keys(grouped)
+            .filter((c) => !CATEGORY_ORDER.includes(c))
+            .sort(),
+    ];
+    for (const cat of cats) {
+        const mods = grouped[cat];
+        if (!mods?.length)
+            continue;
+        lines.push(`${YLW}${CATEGORY_LABELS[cat] ?? cat}${RESET}`);
+        const sorted = [...mods].sort((a, b) => a.name.localeCompare(b.name));
+        for (const mod of sorted) {
+            lines.push(formatCmdLine(mod));
+        }
+        lines.push("");
+    }
+    const total = modules.length;
+    lines.push(`${DIM}${total} commands available.${RESET}`);
+    return lines.join("\n");
+}
+// ─── single-command detail ────────────────────────────────────────────────────
+function renderDetail(mod) {
+    const lines = [];
+    lines.push(`${BOLD}${mod.name}${RESET} — ${mod.description ?? "no description"}`);
+    if (mod.aliases?.length) {
+        lines.push(`${DIM}Aliases: ${mod.aliases.join(", ")}${RESET}`);
+    }
+    lines.push("");
+    lines.push(`${GREEN}Usage:${RESET}`);
+    if (mod.params.length) {
+        for (const p of mod.params) {
+            lines.push(`  ${mod.name} ${p}`);
+        }
+    }
+    else {
+        lines.push(`  ${mod.name}`);
+    }
+    const catLabel = CATEGORY_LABELS[mod.category ?? "misc"] ?? mod.category ?? "misc";
+    lines.push("");
+    lines.push(`${DIM}Category: ${catLabel}${RESET}`);
+    return lines.join("\n");
+}
+// ─── export ───────────────────────────────────────────────────────────────────
 export function createHelpCommand(_getNames) {
     return {
         name: "help",
-        description: "Display this help message",
+        description: "List all commands, or show usage for a specific command",
         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 ?? ""}`);
+                const target = args[0].toLowerCase();
+                const mod = modules.find((m) => m.name === target || m.aliases?.includes(target));
+                if (!mod) {
+                    return {
+                        stderr: `help: no help entry for '${args[0]}'`,
+                        exitCode: 1,
+                    };
                 }
+                return { stdout: renderDetail(mod), exitCode: 0 };
             }
-            return { stdout: lines.join("\n"), exitCode: 0 };
+            return { stdout: renderFull(modules), exitCode: 0 };
         },
     };
 }

package/dist/commands/helpers.d.ts

@@ -1,4 +1,6 @@
 import type VirtualFileSystem from "../VirtualFileSystem";
+import type { VirtualPackageManager } from "../VirtualPackageManager";
+import type { VirtualShell } from "../VirtualShell";
 export declare function normalizeTerminalOutput(text: string): string;
 export declare function resolvePath(cwd: string, inputPath: string): string;
 export declare function assertPathAccess(authUser: string, targetPath: string, operation: string): void;
@@ -23,4 +25,5 @@ export declare function resolveReadablePath(vfs: VirtualFileSystem, cwd: string,
 export declare function joinListWithType(cwd: string, items: string[], statAt: (p: string) => {
     type: "file" | "directory";
 }): string;
+export declare function getPackageManager(shell: VirtualShell): VirtualPackageManager | undefined;
 //# sourceMappingURL=helpers.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/commands/helpers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,iBAAiB,MAAM,sBAAsB,CAAC;AAY1D,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAY5D;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAOlE;AAYD,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GACf,IAAI,CAQN;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIpD;AAED,wBAAsB,aAAa,CAClC,GAAG,EAAE,MAAM,GACT,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAQvE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC7B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EAAE,GACZ,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA8D/D;AA4BD,wBAAgB,mBAAmB,CAClC,GAAG,EAAE,iBAAiB,EACtB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GACf,MAAM,CAyBR;AAED,wBAAgB,gBAAgB,CAC/B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EAAE,EACf,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK;IAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;CAAE,GACnD,MAAM,CAQR"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/commands/helpers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,iBAAiB,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAYpD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAY5D;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAOlE;AAYD,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GACf,IAAI,CAQN;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIpD;AAED,wBAAsB,aAAa,CAClC,GAAG,EAAE,MAAM,GACT,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAQvE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC7B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EAAE,GACZ,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA8D/D;AA4BD,wBAAgB,mBAAmB,CAClC,GAAG,EAAE,iBAAiB,EACtB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GACf,MAAM,CAyBR;AAED,wBAAgB,gBAAgB,CAC/B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EAAE,EACf,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK;IAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;CAAE,GACnD,MAAM,CAQR;AAED,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,YAAY,GACjB,qBAAqB,GAAG,SAAS,CAEnC"}

package/dist/commands/helpers.js

@@ -158,3 +158,6 @@ export function joinListWithType(cwd, items, statAt) {
     })
         .join("  ");
 }
+export function getPackageManager(shell) {
+    return shell.packageManager;
+}

package/dist/commands/history.d.ts

@@ -0,0 +1,8 @@
+import type { ShellModule } from "../types/commands";
+/**
+ * Display persisted command history for the session (from VFS).
+ * @category shell
+ * @params ["[n]"]
+ */
+export declare const historyCommand: ShellModule;
+//# sourceMappingURL=history.d.ts.map

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

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

package/dist/commands/history.js

@@ -0,0 +1,26 @@
+/**
+ * Display persisted command history for the session (from VFS).
+ * @category shell
+ * @params ["[n]"]
+ */
+export const historyCommand = {
+    name: "history",
+    description: "Display command history",
+    category: "shell",
+    params: ["[n]"],
+    run: ({ args, shell }) => {
+        // History is persisted in the VFS by the interactive shell
+        const histPath = "/virtual-env-js/.bash_history";
+        if (!shell.vfs.exists(histPath)) {
+            return { stdout: "", exitCode: 0 };
+        }
+        const raw = shell.vfs.readFile(histPath);
+        const lines = raw.split("\n").filter(Boolean);
+        const nArg = args[0];
+        const n = nArg ? parseInt(nArg, 10) : null;
+        const slice = n && !Number.isNaN(n) ? lines.slice(-n) : lines;
+        const offset = lines.length - slice.length + 1;
+        const numbered = slice.map((line, i) => `${String(offset + i).padStart(5)}  ${line}`);
+        return { stdout: numbered.join("\n"), exitCode: 0 };
+    },
+};

package/dist/commands/hostname.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Print the configured hostname for the virtual shell.
+ * @category system
+ * @params []
+ */
 export declare const hostnameCommand: ShellModule;
 //# sourceMappingURL=hostname.d.ts.map

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,WAM7B,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;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,WAM7B,CAAC"}

package/dist/commands/hostname.js

@@ -1,3 +1,8 @@
+/**
+ * Print the configured hostname for the virtual shell.
+ * @category system
+ * @params []
+ */
 export const hostnameCommand = {
     name: "hostname",
     description: "Print hostname",

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

@@ -1 +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"}
+{"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,WAgBvB,CAAC"}

package/dist/commands/id.js

@@ -9,6 +9,9 @@ export const idCommand = {
         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 };
+        return {
+            stdout: `uid=${uid}(${target}) gid=${gid}(${target}) groups=${groups}`,
+            exitCode: 0,
+        };
     },
 };

package/dist/commands/index.d.ts

@@ -1,11 +1,3 @@
-/** biome-ignore-all lint/style/useNamingConvention: ENV VARIABLES */
-import type { VirtualShell } from "../VirtualShell";
-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 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>;
+export { createCustomCommand, getCommandModulesPublic, getCommandNames, registerCommand, resolveModule } from "./registry";
+export { makeDefaultEnv, runCommand, runCommandDirect } from "./runtime";
 //# 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,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,EACf,eAAe,EACf,aAAa,EACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC"}

package/dist/commands/index.js

@@ -1,231 +1,2 @@
-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";
-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 = [
-    // 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,
-];
-const customCommands = [];
-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 ?? [])
-            commandRegistry.set(alias, mod);
-    }
-    cachedCommandNames = Array.from(commandRegistry.keys()).sort();
-}
-function getCommandModules() {
-    return [...BASE_COMMANDS, ...customCommands, helpCommand];
-}
-export function registerCommand(module) {
-    const normalized = {
-        ...module,
-        name: module.name.trim().toLowerCase(),
-        aliases: module.aliases?.map((a) => a.trim().toLowerCase()),
-    };
-    const names = [normalized.name, ...(normalized.aliases ?? [])];
-    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();
-}
-export function createCustomCommand(name, params, run) {
-    return { name, params, run };
-}
-export function getCommandNames() {
-    if (!cachedCommandNames)
-        buildCache();
-    return cachedCommandNames;
-}
-export function getCommandModulesPublic() {
-    return getCommandModules();
-}
-export function resolveModule(name) {
-    if (!cachedCommandNames)
-        buildCache();
-    return commandRegistry.get(name.toLowerCase());
-}
-function splitArgsRespectingQuotes(input) {
-    const tokens = [];
-    let current = "";
-    let inQuotes = false;
-    let quoteChar = "";
-    for (let i = 0; i < input.length; i++) {
-        const ch = input[i] || "";
-        const prev = i > 0 ? input[i - 1] : "";
-        if ((ch === '"' || ch === "'") && prev !== "\\") {
-            if (!inQuotes) {
-                inQuotes = true;
-                quoteChar = ch;
-                continue;
-            }
-            if (ch === quoteChar) {
-                inQuotes = false;
-                quoteChar = "";
-                continue;
-            }
-        }
-        if (/\s/.test(ch) && !inQuotes) {
-            if (current.length > 0) {
-                tokens.push(current);
-                current = "";
-            }
-            continue;
-        }
-        current += ch;
-    }
-    if (current.length > 0)
-        tokens.push(current);
-    return tokens;
-}
-function parseInput(rawInput) {
-    const parts = splitArgsRespectingQuotes(rawInput.trim());
-    return { commandName: parts[0]?.toLowerCase() ?? "", args: parts.slice(1) };
-}
-export function makeDefaultEnv(authUser, hostname) {
-    return {
-        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, env) {
-    const trimmed = rawInput.trim();
-    if (trimmed.length === 0)
-        return { exitCode: 0 };
-    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 executeStatements(script.statements, authUser, hostname, mode, cwd, shell, shellEnv);
-        }
-        catch (error) {
-            return { stderr: error instanceof Error ? error.message : "Execution failed", exitCode: 1 };
-        }
-    }
-    const { commandName, args } = parseInput(trimmed);
-    const mod = resolveModule(commandName);
-    if (!mod)
-        return { stderr: `${commandName}: command not found`, exitCode: 127 };
-    try {
-        return await mod.run({
-            authUser,
-            hostname,
-            activeSessions: shell.users.listActiveSessions(),
-            rawInput: trimmed,
-            mode,
-            args,
-            stdin,
-            cwd,
-            shell,
-            env: shellEnv,
-        });
-    }
-    catch (error) {
-        return { stderr: error instanceof Error ? error.message : "Command failed", exitCode: 1 };
-    }
-}
+export { createCustomCommand, getCommandModulesPublic, getCommandNames, registerCommand, resolveModule } from "./registry";
+export { makeDefaultEnv, runCommand, runCommandDirect } from "./runtime";

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,WAyBvB,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,WA4BvB,CAAC"}

package/dist/commands/ls.js

@@ -25,15 +25,18 @@ export const lsCommand = {
     name: "ls",
     description: "List directory contents",
     category: "navigation",
-    params: ["[path]"],
+    params: ["[-la] [path]"],
     run: ({ authUser, shell, cwd, args }) => {
         const longFormat = ifFlag(args, ["-l", "--long"]);
-        const targetArg = getArg(args, 0, { flags: ["-l", "--long"] });
+        const showHidden = ifFlag(args, ["-a", "--all"]);
+        const targetArg = getArg(args, 0, {
+            flags: ["-l", "--long", "-a", "--all", "-la", "-al"],
+        });
         const target = resolvePath(cwd, targetArg ?? cwd);
         assertPathAccess(authUser, target, "ls");
         const items = shell.vfs
             .list(target)
-            .filter((name) => !name.startsWith("."));
+            .filter((name) => showHidden || !name.startsWith("."));
         const rendered = longFormat
             ? items
                 .map((name) => {

package/dist/commands/lsb-release.d.ts

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

package/dist/commands/lsb-release.d.ts.map

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

package/dist/commands/lsb-release.js

@@ -0,0 +1,56 @@
+import { ifFlag } from "./command-helpers";
+export const lsbReleaseCommand = {
+    name: "lsb_release",
+    description: "Print distribution-specific information",
+    category: "system",
+    params: ["[-a] [-i] [-d] [-r] [-c]"],
+    run: ({ args, shell }) => {
+        let osName = shell.properties?.os ?? "Fortune GNU/Linux x64";
+        let codename = "aurora";
+        let version = "1.0";
+        try {
+            const content = shell.vfs.readFile("/etc/os-release");
+            for (const line of content.split("\n")) {
+                if (line.startsWith("PRETTY_NAME="))
+                    osName = line
+                        .slice("PRETTY_NAME=".length)
+                        .replace(/^"|"$/g, "")
+                        .trim();
+                if (line.startsWith("VERSION_CODENAME="))
+                    codename = line.slice("VERSION_CODENAME=".length).trim();
+                if (line.startsWith("VERSION_ID="))
+                    version = line
+                        .slice("VERSION_ID=".length)
+                        .replace(/^"|"$/g, "")
+                        .trim();
+            }
+        }
+        catch { }
+        const all = ifFlag(args, ["-a", "--all"]);
+        const showId = ifFlag(args, ["-i", "--id"]);
+        const showDesc = ifFlag(args, ["-d", "--description"]);
+        const showRelease = ifFlag(args, ["-r", "--release"]);
+        const showCodename = ifFlag(args, ["-c", "--codename"]);
+        if (all || args.length === 0) {
+            return {
+                stdout: [
+                    `Distributor ID:\tFortune`,
+                    `Description:\t${osName}`,
+                    `Release:\t${version}`,
+                    `Codename:\t${codename}`,
+                ].join("\n"),
+                exitCode: 0,
+            };
+        }
+        const lines = [];
+        if (showId)
+            lines.push(`Distributor ID:\tFortune`);
+        if (showDesc)
+            lines.push(`Description:\t${osName}`);
+        if (showRelease)
+            lines.push(`Release:\t${version}`);
+        if (showCodename)
+            lines.push(`Codename:\t${codename}`);
+        return { stdout: lines.join("\n"), exitCode: 0 };
+    },
+};

package/dist/commands/man.d.ts

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

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

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