typescript-virtual-container 1.4.4 → 1.4.6

package/dist/commands/env.js

@@ -0,0 +1,21 @@
+/**
+ * Print environment variables for the current session.
+ * @category shell
+ * @params []
+ */
+export const envCommand = {
+    name: "env",
+    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,
+        };
+    },
+};
+//# sourceMappingURL=env.js.map

package/dist/commands/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/commands/env.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAgB;IACtC,IAAI,EAAE,KAAK;IACX,WAAW,EAAE,6BAA6B;IAC1C,QAAQ,EAAE,OAAO;IACjB,MAAM,EAAE,EAAE;IACV,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC1B,MAAM,IAAI,GAAG,EAAE,GAAG,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,QAAQ,EAAE,EAAE,CAAC;QACxE,OAAO;YACN,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;iBAC1B,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;iBAC5B,IAAI,CAAC,IAAI,CAAC;YACZ,QAAQ,EAAE,CAAC;SACX,CAAC;IACH,CAAC;CACD,CAAC"}

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

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

package/dist/commands/exit.js

@@ -0,0 +1,17 @@
+/**
+ * Exit the current shell session (closeSession flag).
+ * @category shell
+ * @params ["[code]"]
+ */
+export const exitCommand = {
+    name: "exit",
+    aliases: ["bye"],
+    description: "Exit the shell session",
+    category: "shell",
+    params: ["[code]"],
+    run: ({ args }) => ({
+        closeSession: true,
+        exitCode: parseInt(args[0] ?? "0", 10) || 0,
+    }),
+};
+//# sourceMappingURL=exit.js.map

package/dist/commands/exit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit.js","sourceRoot":"","sources":["../../src/commands/exit.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAgB;IACvC,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,CAAC,KAAK,CAAC;IAChB,WAAW,EAAE,wBAAwB;IACrC,QAAQ,EAAE,OAAO;IACjB,MAAM,EAAE,CAAC,QAAQ,CAAC;IAClB,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACnB,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC;KAC3C,CAAC;CACF,CAAC"}

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

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

package/dist/commands/export.js

@@ -0,0 +1,34 @@
+/**
+ * Set or display shell environment variables for child processes.
+ * @category shell
+ * @params ["[VAR=value]"]
+ */
+export const exportCommand = {
+    name: "export",
+    description: "Set shell environment variable",
+    category: "shell",
+    params: ["[VAR=value]"],
+    run: ({ args, env }) => {
+        // export -p or export with no args — list all exported vars
+        if (args.length === 0 || (args.length === 1 && args[0] === "-p")) {
+            const out = Object.entries(env.vars)
+                .filter(([k]) => k && /^[A-Za-z_][A-Za-z0-9_]*$/.test(k))
+                .map(([k, v]) => `declare -x ${k}="${v}"`)
+                .join("\n");
+            return { stdout: out ? `${out}\n` : "", exitCode: 0 };
+        }
+        for (const arg of args.filter((a) => a !== "-p")) {
+            if (arg.includes("=")) {
+                const eq = arg.indexOf("=");
+                const name = arg.slice(0, eq);
+                const value = arg.slice(eq + 1);
+                env.vars[name] = value;
+            }
+            else {
+                // mark existing as exported (already is)
+            }
+        }
+        return { exitCode: 0 };
+    },
+};
+//# sourceMappingURL=export.js.map

package/dist/commands/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAgB;IACzC,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,gCAAgC;IAC7C,QAAQ,EAAE,OAAO;IACjB,MAAM,EAAE,CAAC,aAAa,CAAC;IACvB,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE;QACtB,4DAA4D;QAC5D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;YAClE,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;iBAClC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,0BAA0B,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;iBACxD,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC;iBACzC,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QACvD,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;YAClD,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC5B,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC9B,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;gBAChC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;YACxB,CAAC;iBAAM,CAAC;gBACP,yCAAyC;YAC1C,CAAC;QACF,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACxB,CAAC;CACD,CAAC"}

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

@@ -0,0 +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;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,WA0DzB,CAAC"}

package/dist/commands/find.js

@@ -0,0 +1,56 @@
+import { getFlag } from "./command-helpers";
+import { assertPathAccess, resolvePath } from "./helpers";
+/**
+ * Find files and directories by name and type with minimal pattern support.
+ * @category files
+ * @params ["[path] [-name <pattern>] [-type f|d]"]
+ */
+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"]);
+        const typeFilter = getFlag(args, ["-type"]);
+        const positionals = args.filter((a) => !a.startsWith("-") && a !== namePattern && a !== typeFilter);
+        const rootArg = positionals[0] ?? ".";
+        const rootPath = resolvePath(cwd, rootArg);
+        try {
+            assertPathAccess(authUser, rootPath, "find");
+            if (!shell.vfs.exists(rootPath)) {
+                return {
+                    stderr: `find: ${rootArg}: No such file or directory`,
+                    exitCode: 1,
+                };
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { stderr: `find: ${msg}`, exitCode: 1 };
+        }
+        const nameRegex = namePattern
+            ? new RegExp(`^${namePattern.replace(/\./g, "\\.").replace(/\*/g, ".*").replace(/\?/g, ".")}$`)
+            : null;
+        const results = [];
+        const walk = (currentPath, display) => {
+            const stat = shell.vfs.stat(currentPath);
+            const matchesType = !typeFilter ||
+                (typeFilter === "f" && stat.type === "file") ||
+                (typeFilter === "d" && stat.type === "directory");
+            const matchesName = !nameRegex || nameRegex.test(currentPath.split("/").pop() ?? "");
+            if (matchesType && matchesName)
+                results.push(display);
+            if (stat.type === "directory") {
+                for (const entry of shell.vfs.list(currentPath)) {
+                    const full = `${currentPath}/${entry}`;
+                    const disp = `${display}/${entry}`;
+                    walk(full, disp);
+                }
+            }
+        };
+        walk(rootPath, rootArg);
+        return { stdout: results.join("\n"), exitCode: 0 };
+    },
+};
+//# sourceMappingURL=find.js.map

package/dist/commands/find.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.js","sourceRoot":"","sources":["../../src/commands/find.ts"],"names":[],"mappings":"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"}

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

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

package/dist/commands/free.js

@@ -0,0 +1,44 @@
+import * as os from "node:os";
+import { ifFlag } from "./command-helpers";
+/**
+ * Display memory usage information (human / MB / GB options).
+ * @category system
+ * @params ["[-h] [-m] [-g]"]
+ */
+export const freeCommand = {
+    name: "free",
+    description: "Display amount of free and used memory",
+    category: "system",
+    params: ["[-h] [-m] [-g]"],
+    run: ({ args }) => {
+        const human = ifFlag(args, ["-h", "--human"]);
+        const mb = ifFlag(args, ["-m"]);
+        const gb = ifFlag(args, ["-g"]);
+        const osTotalB = os.totalmem();
+        const osFreeB = os.freemem();
+        const usedB = osTotalB - osFreeB;
+        const sharedB = Math.floor(osTotalB * 0.02);
+        const buffersB = Math.floor(osTotalB * 0.05);
+        const availableB = Math.floor(osFreeB * 0.95);
+        const swapB = Math.floor(osTotalB * 0.5);
+        const fmt = (bytes) => {
+            if (human) {
+                if (bytes >= 1024 * 1024 * 1024)
+                    return `${(bytes / (1024 * 1024 * 1024)).toFixed(1)}G`;
+                if (bytes >= 1024 * 1024)
+                    return `${(bytes / (1024 * 1024)).toFixed(1)}M`;
+                return `${(bytes / 1024).toFixed(1)}K`;
+            }
+            if (gb)
+                return String(Math.floor(bytes / (1024 * 1024 * 1024)));
+            if (mb)
+                return String(Math.floor(bytes / (1024 * 1024)));
+            return String(Math.floor(bytes / 1024));
+        };
+        const header = `               total        used        free      shared  buff/cache   available`;
+        const memRow = `Mem:  ${fmt(osTotalB).padStart(12)} ${fmt(usedB).padStart(11)} ${fmt(osFreeB).padStart(11)} ${fmt(sharedB).padStart(11)} ${fmt(buffersB).padStart(11)} ${fmt(availableB).padStart(11)}`;
+        const swapRow = `Swap: ${fmt(swapB).padStart(12)} ${fmt(0).padStart(11)} ${fmt(swapB).padStart(11)}`;
+        return { stdout: [header, memRow, swapRow].join("\n"), exitCode: 0 };
+    },
+};
+//# sourceMappingURL=free.js.map

package/dist/commands/free.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"free.js","sourceRoot":"","sources":["../../src/commands/free.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +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;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,WA0GzB,CAAC"}

package/dist/commands/grep.js

@@ -0,0 +1,121 @@
+import { parseArgs } from "./command-helpers";
+import { assertPathAccess, resolvePath } from "./helpers";
+/**
+ * Search for a regex pattern in files or stdin with common flags.
+ * @category text
+ * @params ["[-i] [-v] [-n] [-r] <pattern> [file...]"]
+ */
+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", "-c", "-l", "-L", "-q", "--quiet", "--silent"],
+        });
+        const caseInsensitive = flags.has("-i");
+        const invertMatch = flags.has("-v");
+        const showLineNumbers = flags.has("-n");
+        const recursive = flags.has("-r");
+        const countOnly = flags.has("-c");
+        const filesWithMatches = flags.has("-l");
+        const quiet = flags.has("-q") || flags.has("--quiet") || flags.has("--silent");
+        const pattern = positionals[0];
+        const files = positionals.slice(1);
+        if (!pattern) {
+            return { stderr: "grep: no pattern specified", exitCode: 1 };
+        }
+        let regex;
+        try {
+            // No "g" flag — avoids the stateful lastIndex problem with regex.test()
+            const regexFlags = caseInsensitive ? "mi" : "m";
+            regex = new RegExp(pattern, regexFlags);
+        }
+        catch {
+            return { stderr: `grep: invalid regex: ${pattern}`, exitCode: 1 };
+        }
+        const matchLines = (content, prefix = "") => {
+            const lines = content.split("\n");
+            const out = [];
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i] ?? "";
+                const matches = regex.test(line);
+                const shouldInclude = invertMatch ? !matches : matches;
+                if (shouldInclude) {
+                    const lineLabel = showLineNumbers ? `${i + 1}:` : "";
+                    out.push(`${prefix}${lineLabel}${line}`);
+                }
+            }
+            return out;
+        };
+        const readPaths = (base) => {
+            if (!shell.vfs.exists(base))
+                return [];
+            const stat = shell.vfs.stat(base);
+            if (stat.type === "file")
+                return [base];
+            if (!recursive)
+                return [];
+            const paths = [];
+            const walk = (dir) => {
+                for (const entry of shell.vfs.list(dir)) {
+                    const full = `${dir}/${entry}`;
+                    const s = shell.vfs.stat(full);
+                    if (s.type === "file")
+                        paths.push(full);
+                    else
+                        walk(full);
+                }
+            };
+            walk(base);
+            return paths;
+        };
+        const results = [];
+        if (files.length === 0) {
+            if (!stdin)
+                return { stdout: "", exitCode: 1 };
+            const matched = matchLines(stdin);
+            if (countOnly)
+                return { stdout: `${matched.length}\n`, exitCode: matched.length > 0 ? 0 : 1 };
+            if (quiet)
+                return { exitCode: matched.length > 0 ? 0 : 1 };
+            results.push(...matched);
+        }
+        else {
+            const resolvedPaths = files.flatMap((f) => {
+                const target = resolvePath(cwd, f);
+                return readPaths(target).map((p) => ({ file: f, path: p }));
+            });
+            for (const { file, path: filePath } of resolvedPaths) {
+                try {
+                    assertPathAccess(authUser, filePath, "grep");
+                    const content = shell.vfs.readFile(filePath);
+                    const prefix = resolvedPaths.length > 1 ? `${file}:` : "";
+                    const matched = matchLines(content, prefix);
+                    if (countOnly) {
+                        results.push(resolvedPaths.length > 1 ? `${file}:${matched.length}` : String(matched.length));
+                    }
+                    else if (filesWithMatches) {
+                        if (matched.length > 0)
+                            results.push(file);
+                    }
+                    else {
+                        results.push(...matched);
+                    }
+                }
+                catch {
+                    return {
+                        stderr: `grep: ${file}: No such file or directory`,
+                        exitCode: 1,
+                    };
+                }
+            }
+        }
+        return {
+            stdout: results.length > 0 ? `${results.join("\n")}\n` : "",
+            exitCode: results.length > 0 ? 0 : 1,
+        };
+    },
+};
+//# sourceMappingURL=grep.js.map

package/dist/commands/grep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grep.js","sourceRoot":"","sources":["../../src/commands/grep.ts"],"names":[],"mappings":"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"}

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

package/dist/commands/groups.js

@@ -0,0 +1,18 @@
+/**
+ * Print group memberships for a user.
+ * @category system
+ * @params ["[user]"]
+ */
+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 };
+    },
+};
+//# sourceMappingURL=groups.js.map

package/dist/commands/groups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"groups.js","sourceRoot":"","sources":["../../src/commands/groups.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAgB;IACzC,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,yBAAyB;IACtC,QAAQ,EAAE,QAAQ;IAClB,MAAM,EAAE,CAAC,QAAQ,CAAC;IAClB,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE;QAClC,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC;QACnC,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC;QACrD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACtC,CAAC;CACD,CAAC"}

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;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,WAgDzB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,WA0B3B,CAAC"}

package/dist/commands/gzip.js

@@ -0,0 +1,83 @@
+import { resolvePath } from "./helpers";
+/**
+ * Compress files using gzip — renames file to `<file>.gz`, removes original.
+ * @category archive
+ */
+export const gzipCommand = {
+    name: "gzip",
+    description: "Compress files",
+    category: "archive",
+    params: ["[-k] [-d] <file>"],
+    run: ({ shell, cwd, args }) => {
+        if (!shell.packageManager.isInstalled("gzip")) {
+            return {
+                stderr: "bash: gzip: command not found\nHint: install it with: apt install gzip\n",
+                exitCode: 127,
+            };
+        }
+        const keepOrig = args.includes("-k") || args.includes("--keep");
+        const decompress = args.includes("-d");
+        const file = args.find((a) => !a.startsWith("-"));
+        if (!file)
+            return { stderr: "gzip: no file specified\n", exitCode: 1 };
+        const p = resolvePath(cwd, file);
+        if (decompress) {
+            // gzip -d = gunzip
+            if (!file.endsWith(".gz")) {
+                return { stderr: `gzip: ${file}: unknown suffix -- ignored\n`, exitCode: 1 };
+            }
+            if (!shell.vfs.exists(p)) {
+                return { stderr: `gzip: ${file}: No such file or directory\n`, exitCode: 1 };
+            }
+            const content = shell.vfs.readFile(p);
+            const dest = p.slice(0, -3);
+            shell.vfs.writeFile(dest, content);
+            if (!keepOrig)
+                shell.vfs.remove(p);
+            return { exitCode: 0 };
+        }
+        if (!shell.vfs.exists(p)) {
+            return { stderr: `gzip: ${file}: No such file or directory\n`, exitCode: 1 };
+        }
+        if (file.endsWith(".gz")) {
+            return { stderr: `gzip: ${file}: already has .gz suffix -- unchanged\n`, exitCode: 1 };
+        }
+        const rawContent = shell.vfs.readFileRaw(p);
+        const gzPath = `${p}.gz`;
+        shell.vfs.writeFile(gzPath, rawContent, { compress: true });
+        if (!keepOrig)
+            shell.vfs.remove(p);
+        return { exitCode: 0 };
+    },
+};
+/**
+ * Decompress gzip files — renames `<file>.gz` to `<file>`, removes original.
+ * @category archive
+ */
+export const gunzipCommand = {
+    name: "gunzip",
+    description: "Decompress files",
+    category: "archive",
+    aliases: ["zcat"],
+    params: ["[-k] <file>"],
+    run: ({ shell, cwd, args }) => {
+        const keepOrig = args.includes("-k") || args.includes("--keep");
+        const file = args.find((a) => !a.startsWith("-"));
+        if (!file)
+            return { stderr: "gunzip: no file specified\n", exitCode: 1 };
+        const p = resolvePath(cwd, file);
+        if (!shell.vfs.exists(p)) {
+            return { stderr: `gunzip: ${file}: No such file or directory\n`, exitCode: 1 };
+        }
+        if (!file.endsWith(".gz")) {
+            return { stderr: `gunzip: ${file}: unknown suffix -- ignored\n`, exitCode: 1 };
+        }
+        const content = shell.vfs.readFile(p);
+        const dest = p.slice(0, -3);
+        shell.vfs.writeFile(dest, content);
+        if (!keepOrig)
+            shell.vfs.remove(p);
+        return { exitCode: 0 };
+    },
+};
+//# sourceMappingURL=gzip.js.map

package/dist/commands/gzip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gzip.js","sourceRoot":"","sources":["../../src/commands/gzip.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +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;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,WA0CzB,CAAC"}

package/dist/commands/head.js

@@ -0,0 +1,47 @@
+import { getFlag } from "./command-helpers";
+import { assertPathAccess, resolvePath } from "./helpers";
+/**
+ * Output the first part of files or stdin (head).
+ * @category text
+ * @params ["[-n <lines>] [file...]"]
+ */
+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"]);
+        // Support both -n N and -N shorthand (head -2, head -10)
+        const shortN = args.find((a) => /^-\d+$/.test(a));
+        const n = typeof nArg === "string"
+            ? parseInt(nArg, 10)
+            : shortN ? parseInt(shortN.slice(1), 10) : 10;
+        const positionals = args.filter((a) => !a.startsWith("-") && a !== nArg && a !== String(n));
+        const take = (content) => {
+            const lines = content.split("\n");
+            // Preserve trailing newline
+            const sliced = lines.slice(0, n);
+            return sliced.join("\n") + (content.endsWith("\n") && sliced.length === lines.slice(0, n).length ? "\n" : "");
+        };
+        if (positionals.length === 0) {
+            return { stdout: take(stdin ?? ""), exitCode: 0 };
+        }
+        const results = [];
+        for (const file of positionals) {
+            const filePath = resolvePath(cwd, file);
+            try {
+                assertPathAccess(authUser, filePath, "head");
+                results.push(take(shell.vfs.readFile(filePath)));
+            }
+            catch {
+                return {
+                    stderr: `head: ${file}: No such file or directory`,
+                    exitCode: 1,
+                };
+            }
+        }
+        return { stdout: results.join("\n"), exitCode: 0 };
+    },
+};
+//# sourceMappingURL=head.js.map

package/dist/commands/head.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"head.js","sourceRoot":"","sources":["../../src/commands/head.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE1D;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAgB;IACvC,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,oBAAoB;IACjC,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE,CAAC,wBAAwB,CAAC;IAClC,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;QAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QACnC,yDAAyD;QACzD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAClD,MAAM,CAAC,GAAG,OAAO,IAAI,KAAK,QAAQ;YACjC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;YACpB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAC9B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,CAC1D,CAAC;QAEF,MAAM,IAAI,GAAG,CAAC,OAAe,EAAE,EAAE;YAChC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAClC,4BAA4B;YAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACjC,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC/G,CAAC,CAAC;QAEF,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QACnD,CAAC;QAED,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAChC,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACxC,IAAI,CAAC;gBACJ,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;gBAC7C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAClD,CAAC;YAAC,MAAM,CAAC;gBACR,OAAO;oBACN,MAAM,EAAE,SAAS,IAAI,6BAA6B;oBAClD,QAAQ,EAAE,CAAC;iBACX,CAAC;YACH,CAAC;QACF,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACpD,CAAC;CACD,CAAC"}

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

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