typescript-virtual-container 1.4.3 → 1.4.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (382) hide show
  1. package/.vscode/settings.json +2 -1
  2. package/README.md +137 -19
  3. package/benchmark-results.txt +21 -21
  4. package/builds/self-standalone.js +322 -266
  5. package/builds/self-standalone.js.map +4 -4
  6. package/builds/standalone-wo-sftp.js +268 -212
  7. package/builds/standalone-wo-sftp.js.map +4 -4
  8. package/builds/standalone.js +268 -212
  9. package/builds/standalone.js.map +4 -4
  10. package/builds/web-full-api.min.js +5 -5
  11. package/builds/web-full-api.min.js.map +3 -3
  12. package/builds/web.min.js +5 -5
  13. package/builds/web.min.js.map +3 -3
  14. package/bun.lock +101 -6
  15. package/dist/Honeypot/index.js +1 -0
  16. package/dist/Honeypot/index.js.map +1 -0
  17. package/dist/SSHClient/index.js +1 -0
  18. package/dist/SSHClient/index.js.map +1 -0
  19. package/dist/SSHMimic/exec.js +1 -0
  20. package/dist/SSHMimic/exec.js.map +1 -0
  21. package/dist/SSHMimic/executor.js +1 -0
  22. package/dist/SSHMimic/executor.js.map +1 -0
  23. package/dist/SSHMimic/hostKey.js +1 -0
  24. package/dist/SSHMimic/hostKey.js.map +1 -0
  25. package/dist/SSHMimic/index.js +1 -0
  26. package/dist/SSHMimic/index.js.map +1 -0
  27. package/dist/SSHMimic/loginBanner.js +1 -0
  28. package/dist/SSHMimic/loginBanner.js.map +1 -0
  29. package/dist/SSHMimic/loginFormat.js +1 -0
  30. package/dist/SSHMimic/loginFormat.js.map +1 -0
  31. package/dist/SSHMimic/prompt.js +1 -0
  32. package/dist/SSHMimic/prompt.js.map +1 -0
  33. package/dist/SSHMimic/sftp.js +1 -0
  34. package/dist/SSHMimic/sftp.js.map +1 -0
  35. package/dist/VirtualFileSystem/binaryPack.js +1 -0
  36. package/dist/VirtualFileSystem/binaryPack.js.map +1 -0
  37. package/dist/VirtualFileSystem/index.d.ts.map +1 -1
  38. package/dist/VirtualFileSystem/index.js +1 -0
  39. package/dist/VirtualFileSystem/index.js.map +1 -0
  40. package/dist/VirtualFileSystem/internalTypes.js +1 -0
  41. package/dist/VirtualFileSystem/internalTypes.js.map +1 -0
  42. package/dist/VirtualFileSystem/path.js +1 -0
  43. package/dist/VirtualFileSystem/path.js.map +1 -0
  44. package/dist/VirtualPackageManager/index.js +1 -0
  45. package/dist/VirtualPackageManager/index.js.map +1 -0
  46. package/dist/VirtualShell/index.js +1 -0
  47. package/dist/VirtualShell/index.js.map +1 -0
  48. package/dist/VirtualShell/shell.js +1 -0
  49. package/dist/VirtualShell/shell.js.map +1 -0
  50. package/dist/VirtualShell/shellParser.d.ts.map +1 -1
  51. package/dist/VirtualShell/shellParser.js +3 -1
  52. package/dist/VirtualShell/shellParser.js.map +1 -0
  53. package/dist/VirtualUserManager/index.js +1 -0
  54. package/dist/VirtualUserManager/index.js.map +1 -0
  55. package/dist/commands/adduser.js +1 -0
  56. package/dist/commands/adduser.js.map +1 -0
  57. package/dist/commands/alias.js +1 -0
  58. package/dist/commands/alias.js.map +1 -0
  59. package/dist/commands/apt.js +1 -0
  60. package/dist/commands/apt.js.map +1 -0
  61. package/dist/commands/awk.d.ts.map +1 -1
  62. package/dist/commands/awk.js +2 -2
  63. package/dist/commands/awk.js.map +1 -0
  64. package/dist/commands/base64.js +1 -0
  65. package/dist/commands/base64.js.map +1 -0
  66. package/dist/commands/cat.js +1 -0
  67. package/dist/commands/cat.js.map +1 -0
  68. package/dist/commands/cd.js +3 -2
  69. package/dist/commands/cd.js.map +1 -0
  70. package/dist/commands/chmod.js +1 -0
  71. package/dist/commands/chmod.js.map +1 -0
  72. package/dist/commands/clear.js +1 -0
  73. package/dist/commands/clear.js.map +1 -0
  74. package/dist/commands/command-helpers.js +1 -0
  75. package/dist/commands/command-helpers.js.map +1 -0
  76. package/dist/commands/cp.js +1 -0
  77. package/dist/commands/cp.js.map +1 -0
  78. package/dist/commands/curl.js +1 -0
  79. package/dist/commands/curl.js.map +1 -0
  80. package/dist/commands/cut.js +1 -0
  81. package/dist/commands/cut.js.map +1 -0
  82. package/dist/commands/date.js +1 -0
  83. package/dist/commands/date.js.map +1 -0
  84. package/dist/commands/declare.js +1 -0
  85. package/dist/commands/declare.js.map +1 -0
  86. package/dist/commands/deluser.js +1 -0
  87. package/dist/commands/deluser.js.map +1 -0
  88. package/dist/commands/df.js +1 -0
  89. package/dist/commands/df.js.map +1 -0
  90. package/dist/commands/diff.js +1 -0
  91. package/dist/commands/diff.js.map +1 -0
  92. package/dist/commands/dpkg.js +1 -0
  93. package/dist/commands/dpkg.js.map +1 -0
  94. package/dist/commands/du.js +1 -0
  95. package/dist/commands/du.js.map +1 -0
  96. package/dist/commands/echo.js +1 -0
  97. package/dist/commands/echo.js.map +1 -0
  98. package/dist/commands/env.js +1 -0
  99. package/dist/commands/env.js.map +1 -0
  100. package/dist/commands/exit.js +1 -0
  101. package/dist/commands/exit.js.map +1 -0
  102. package/dist/commands/export.js +1 -0
  103. package/dist/commands/export.js.map +1 -0
  104. package/dist/commands/find.js +1 -0
  105. package/dist/commands/find.js.map +1 -0
  106. package/dist/commands/free.js +1 -0
  107. package/dist/commands/free.js.map +1 -0
  108. package/dist/commands/grep.js +1 -0
  109. package/dist/commands/grep.js.map +1 -0
  110. package/dist/commands/groups.js +1 -0
  111. package/dist/commands/groups.js.map +1 -0
  112. package/dist/commands/gzip.js +1 -0
  113. package/dist/commands/gzip.js.map +1 -0
  114. package/dist/commands/head.js +1 -0
  115. package/dist/commands/head.js.map +1 -0
  116. package/dist/commands/help.js +1 -0
  117. package/dist/commands/help.js.map +1 -0
  118. package/dist/commands/helpers.d.ts.map +1 -1
  119. package/dist/commands/helpers.js +4 -0
  120. package/dist/commands/helpers.js.map +1 -0
  121. package/dist/commands/history.js +1 -0
  122. package/dist/commands/history.js.map +1 -0
  123. package/dist/commands/hostname.js +1 -0
  124. package/dist/commands/hostname.js.map +1 -0
  125. package/dist/commands/htop.js +1 -0
  126. package/dist/commands/htop.js.map +1 -0
  127. package/dist/commands/id.js +1 -0
  128. package/dist/commands/id.js.map +1 -0
  129. package/dist/commands/index.js +1 -0
  130. package/dist/commands/index.js.map +1 -0
  131. package/dist/commands/kill.js +1 -0
  132. package/dist/commands/kill.js.map +1 -0
  133. package/dist/commands/ln.js +1 -0
  134. package/dist/commands/ln.js.map +1 -0
  135. package/dist/commands/ls.d.ts.map +1 -1
  136. package/dist/commands/ls.js +171 -37
  137. package/dist/commands/ls.js.map +1 -0
  138. package/dist/commands/lsb-release.js +1 -0
  139. package/dist/commands/lsb-release.js.map +1 -0
  140. package/dist/commands/man.js +1 -0
  141. package/dist/commands/man.js.map +1 -0
  142. package/dist/commands/mkdir.js +1 -0
  143. package/dist/commands/mkdir.js.map +1 -0
  144. package/dist/commands/mv.js +1 -0
  145. package/dist/commands/mv.js.map +1 -0
  146. package/dist/commands/nano.js +1 -0
  147. package/dist/commands/nano.js.map +1 -0
  148. package/dist/commands/neofetch.js +1 -0
  149. package/dist/commands/neofetch.js.map +1 -0
  150. package/dist/commands/node.js +1 -0
  151. package/dist/commands/node.js.map +1 -0
  152. package/dist/commands/npm.js +1 -0
  153. package/dist/commands/npm.js.map +1 -0
  154. package/dist/commands/passwd.js +1 -0
  155. package/dist/commands/passwd.js.map +1 -0
  156. package/dist/commands/ping.js +1 -0
  157. package/dist/commands/ping.js.map +1 -0
  158. package/dist/commands/printf.js +1 -0
  159. package/dist/commands/printf.js.map +1 -0
  160. package/dist/commands/ps.js +1 -0
  161. package/dist/commands/ps.js.map +1 -0
  162. package/dist/commands/pwd.js +1 -0
  163. package/dist/commands/pwd.js.map +1 -0
  164. package/dist/commands/python.js +1 -0
  165. package/dist/commands/python.js.map +1 -0
  166. package/dist/commands/read.js +1 -0
  167. package/dist/commands/read.js.map +1 -0
  168. package/dist/commands/registry.js +1 -0
  169. package/dist/commands/registry.js.map +1 -0
  170. package/dist/commands/rm.js +1 -0
  171. package/dist/commands/rm.js.map +1 -0
  172. package/dist/commands/runtime.d.ts.map +1 -1
  173. package/dist/commands/runtime.js +37 -0
  174. package/dist/commands/runtime.js.map +1 -0
  175. package/dist/commands/sed.js +1 -0
  176. package/dist/commands/sed.js.map +1 -0
  177. package/dist/commands/seq.js +1 -0
  178. package/dist/commands/seq.js.map +1 -0
  179. package/dist/commands/set.js +1 -0
  180. package/dist/commands/set.js.map +1 -0
  181. package/dist/commands/sh.d.ts.map +1 -1
  182. package/dist/commands/sh.js +9 -4
  183. package/dist/commands/sh.js.map +1 -0
  184. package/dist/commands/shift.js +1 -0
  185. package/dist/commands/shift.js.map +1 -0
  186. package/dist/commands/sleep.js +1 -0
  187. package/dist/commands/sleep.js.map +1 -0
  188. package/dist/commands/sort.js +1 -0
  189. package/dist/commands/sort.js.map +1 -0
  190. package/dist/commands/source.js +1 -0
  191. package/dist/commands/source.js.map +1 -0
  192. package/dist/commands/stat.js +1 -0
  193. package/dist/commands/stat.js.map +1 -0
  194. package/dist/commands/su.js +1 -0
  195. package/dist/commands/su.js.map +1 -0
  196. package/dist/commands/sudo.js +1 -0
  197. package/dist/commands/sudo.js.map +1 -0
  198. package/dist/commands/tail.js +1 -0
  199. package/dist/commands/tail.js.map +1 -0
  200. package/dist/commands/tar.js +1 -0
  201. package/dist/commands/tar.js.map +1 -0
  202. package/dist/commands/tee.js +1 -0
  203. package/dist/commands/tee.js.map +1 -0
  204. package/dist/commands/test.d.ts.map +1 -1
  205. package/dist/commands/test.js +1 -0
  206. package/dist/commands/test.js.map +1 -0
  207. package/dist/commands/touch.js +1 -0
  208. package/dist/commands/touch.js.map +1 -0
  209. package/dist/commands/tr.js +1 -0
  210. package/dist/commands/tr.js.map +1 -0
  211. package/dist/commands/tree.js +1 -0
  212. package/dist/commands/tree.js.map +1 -0
  213. package/dist/commands/true.js +1 -0
  214. package/dist/commands/true.js.map +1 -0
  215. package/dist/commands/type.js +1 -0
  216. package/dist/commands/type.js.map +1 -0
  217. package/dist/commands/uname.js +1 -0
  218. package/dist/commands/uname.js.map +1 -0
  219. package/dist/commands/uniq.js +1 -0
  220. package/dist/commands/uniq.js.map +1 -0
  221. package/dist/commands/unset.js +1 -0
  222. package/dist/commands/unset.js.map +1 -0
  223. package/dist/commands/uptime.js +1 -0
  224. package/dist/commands/uptime.js.map +1 -0
  225. package/dist/commands/wc.js +2 -1
  226. package/dist/commands/wc.js.map +1 -0
  227. package/dist/commands/wget.js +1 -0
  228. package/dist/commands/wget.js.map +1 -0
  229. package/dist/commands/which.js +1 -0
  230. package/dist/commands/which.js.map +1 -0
  231. package/dist/commands/who.js +1 -0
  232. package/dist/commands/who.js.map +1 -0
  233. package/dist/commands/whoami.js +1 -0
  234. package/dist/commands/whoami.js.map +1 -0
  235. package/dist/commands/xargs.js +1 -0
  236. package/dist/commands/xargs.js.map +1 -0
  237. package/dist/index.js +1 -0
  238. package/dist/index.js.map +1 -0
  239. package/dist/modules/linuxRootfs.d.ts +35 -17
  240. package/dist/modules/linuxRootfs.d.ts.map +1 -1
  241. package/dist/modules/linuxRootfs.js +332 -152
  242. package/dist/modules/linuxRootfs.js.map +1 -0
  243. package/dist/modules/neofetch.js +1 -0
  244. package/dist/modules/neofetch.js.map +1 -0
  245. package/dist/modules/shellInteractive.js +1 -0
  246. package/dist/modules/shellInteractive.js.map +1 -0
  247. package/dist/modules/shellRuntime.js +1 -0
  248. package/dist/modules/shellRuntime.js.map +1 -0
  249. package/dist/self-standalone.js +1 -0
  250. package/dist/self-standalone.js.map +1 -0
  251. package/dist/standalone-wo-sftp.js +1 -0
  252. package/dist/standalone-wo-sftp.js.map +1 -0
  253. package/dist/standalone.js +1 -0
  254. package/dist/standalone.js.map +1 -0
  255. package/dist/types/commands.d.ts +1 -1
  256. package/dist/types/commands.d.ts.map +1 -1
  257. package/dist/types/commands.js +1 -0
  258. package/dist/types/commands.js.map +1 -0
  259. package/dist/types/pipeline.js +1 -0
  260. package/dist/types/pipeline.js.map +1 -0
  261. package/dist/types/streams.js +1 -0
  262. package/dist/types/streams.js.map +1 -0
  263. package/dist/types/vfs.js +1 -0
  264. package/dist/types/vfs.js.map +1 -0
  265. package/dist/utils/expand.d.ts +2 -2
  266. package/dist/utils/expand.d.ts.map +1 -1
  267. package/dist/utils/expand.js +336 -124
  268. package/dist/utils/expand.js.map +1 -0
  269. package/dist/utils/perfLogger.js +1 -0
  270. package/dist/utils/perfLogger.js.map +1 -0
  271. package/dist/utils/tokenize.js +1 -0
  272. package/dist/utils/tokenize.js.map +1 -0
  273. package/dist/utils/vfsDiff.js +1 -0
  274. package/dist/utils/vfsDiff.js.map +1 -0
  275. package/dist/web-api.js +1 -0
  276. package/dist/web-api.js.map +1 -0
  277. package/dist/web-full.js +1 -0
  278. package/dist/web-full.js.map +1 -0
  279. package/dist/web.js +1 -0
  280. package/dist/web.js.map +1 -0
  281. package/docs/.nojekyll +1 -0
  282. package/docs/assets/hierarchy.js +1 -0
  283. package/docs/assets/highlight.css +162 -0
  284. package/docs/assets/icons.js +18 -0
  285. package/docs/assets/icons.svg +1 -0
  286. package/docs/assets/main.js +60 -0
  287. package/docs/assets/navigation.js +1 -0
  288. package/docs/assets/search.js +1 -0
  289. package/docs/assets/style.css +1633 -0
  290. package/docs/classes/HoneyPot.html +31 -0
  291. package/docs/classes/SshClient.html +66 -0
  292. package/docs/classes/VirtualFileSystem.html +262 -0
  293. package/docs/classes/VirtualPackageManager.html +63 -0
  294. package/docs/classes/VirtualSftpServer.html +169 -0
  295. package/docs/classes/VirtualShell.html +265 -0
  296. package/docs/classes/VirtualSshServer.html +177 -0
  297. package/docs/classes/VirtualUserManager.html +276 -0
  298. package/docs/docs/.nojekyll +1 -0
  299. package/docs/docs/assets/hierarchy.js +1 -0
  300. package/docs/docs/assets/highlight.css +162 -0
  301. package/docs/docs/assets/icons.js +18 -0
  302. package/docs/docs/assets/icons.svg +1 -0
  303. package/docs/docs/assets/main.js +60 -0
  304. package/docs/docs/assets/navigation.js +1 -0
  305. package/docs/docs/assets/search.js +1 -0
  306. package/docs/docs/assets/style.css +1633 -0
  307. package/docs/docs/hierarchy.html +1 -0
  308. package/docs/docs/index.html +1842 -0
  309. package/docs/docs/media/LICENSE +21 -0
  310. package/docs/docs/modules.html +1 -0
  311. package/docs/functions/assertDiff.html +6 -0
  312. package/docs/functions/diffSnapshots.html +7 -0
  313. package/docs/functions/formatDiff.html +6 -0
  314. package/docs/functions/getArg.html +13 -0
  315. package/docs/functions/getFlag.html +15 -0
  316. package/docs/functions/ifFlag.html +11 -0
  317. package/docs/hierarchy.html +1 -0
  318. package/docs/index.html +1842 -0
  319. package/docs/interfaces/AuditLogEntry.html +6 -0
  320. package/docs/interfaces/CommandContext.html +22 -0
  321. package/docs/interfaces/CommandResult.html +26 -0
  322. package/docs/interfaces/ExecStream.html +11 -0
  323. package/docs/interfaces/HoneyPotStats.html +14 -0
  324. package/docs/interfaces/InstalledPackage.html +20 -0
  325. package/docs/interfaces/NanoEditorSession.html +8 -0
  326. package/docs/interfaces/PackageDefinition.html +30 -0
  327. package/docs/interfaces/PackageFile.html +8 -0
  328. package/docs/interfaces/RemoveOptions.html +4 -0
  329. package/docs/interfaces/ShellEnv.html +6 -0
  330. package/docs/interfaces/ShellModule.html +14 -0
  331. package/docs/interfaces/ShellProperties.html +14 -0
  332. package/docs/interfaces/ShellStream.html +11 -0
  333. package/docs/interfaces/SudoChallenge.html +24 -0
  334. package/docs/interfaces/VfsBaseNode.html +12 -0
  335. package/docs/interfaces/VfsDiff.html +10 -0
  336. package/docs/interfaces/VfsDiffEntry.html +6 -0
  337. package/docs/interfaces/VfsDiffModified.html +10 -0
  338. package/docs/interfaces/VfsDirectoryNode.html +15 -0
  339. package/docs/interfaces/VfsFileNode.html +17 -0
  340. package/docs/interfaces/VfsOptions.html +12 -0
  341. package/docs/interfaces/VfsSnapshot.html +3 -0
  342. package/docs/interfaces/VfsSnapshotBaseNode.html +8 -0
  343. package/docs/interfaces/VfsSnapshotDirectoryNode.html +10 -0
  344. package/docs/interfaces/VfsSnapshotFileNode.html +12 -0
  345. package/docs/interfaces/WriteFileOptions.html +6 -0
  346. package/docs/media/LICENSE +21 -0
  347. package/docs/modules.html +1 -0
  348. package/docs/types/CommandMode.html +2 -0
  349. package/docs/types/CommandOutcome.html +2 -0
  350. package/docs/types/VfsNodeStats.html +2 -0
  351. package/docs/types/VfsNodeType.html +2 -0
  352. package/docs/types/VfsPersistenceMode.html +5 -0
  353. package/docs/types/VfsSnapshotNode.html +2 -0
  354. package/examples/web.min.js +5 -5
  355. package/package.json +7 -4
  356. package/src/VirtualFileSystem/index.ts +11 -9
  357. package/src/VirtualShell/shellParser.ts +3 -2
  358. package/src/bun.d.ts +1 -0
  359. package/src/commands/awk.ts +1 -2
  360. package/src/commands/cd.ts +2 -2
  361. package/src/commands/helpers.ts +3 -0
  362. package/src/commands/ls.ts +210 -41
  363. package/src/commands/runtime.ts +56 -3
  364. package/src/commands/sh.ts +7 -4
  365. package/src/commands/test.ts +4 -2
  366. package/src/commands/wc.ts +1 -1
  367. package/src/modules/linuxRootfs.ts +420 -231
  368. package/src/types/commands.ts +1 -1
  369. package/src/utils/expand.ts +256 -76
  370. package/tests/command-helpers.test.ts +80 -0
  371. package/tests/commands-admin-net.test.ts +441 -0
  372. package/tests/commands-advanced.test.ts +456 -0
  373. package/tests/commands-core.test.ts +562 -0
  374. package/tests/commands-missing.test.ts +570 -0
  375. package/tests/commands-specific-units.test.ts +327 -0
  376. package/tests/commands-text-sys.test.ts +445 -0
  377. package/tests/expand.test.ts +170 -0
  378. package/tests/helpers.test.ts +75 -0
  379. package/tests/test-helper.ts +79 -0
  380. package/tsconfig.json +3 -0
  381. package/typedoc.json +8 -0
  382. package/tests/bun-test-shim.ts +0 -9
@@ -0,0 +1,456 @@
1
+ import { beforeAll, describe, expect, test } from "bun:test";
2
+ import type { SshClient, VirtualShell } from "../src";
3
+ import { createTestDir, createTestEnv, createTestFile, runCmd } from "./test-helper";
4
+
5
+ let shell: VirtualShell;
6
+ let client: InstanceType<typeof SshClient>;
7
+
8
+ beforeAll(async () => {
9
+ const env = await createTestEnv("test-advanced");
10
+ shell = env.shell;
11
+ client = env.client;
12
+ });
13
+
14
+ // ─── FIND tests ───────────────────────────────────────────────────────────
15
+
16
+ describe("find command", () => {
17
+ test("find lists files in directory", async () => {
18
+ createTestFile(shell, "/tmp/find1.txt", "test");
19
+ createTestFile(shell, "/tmp/find2.txt", "test");
20
+ const r = await runCmd(client, "find /tmp -name 'find*.txt'");
21
+ expect(r.exitCode).toBe(0);
22
+ expect(r.stdout).toContain("find1.txt");
23
+ expect(r.stdout).toContain("find2.txt");
24
+ });
25
+
26
+ test("find -name pattern matching", async () => {
27
+ createTestFile(shell, "/tmp/test.log", "log");
28
+ createTestFile(shell, "/tmp/test.txt", "txt");
29
+ const r = await runCmd(client, "find /tmp -name '*.log'");
30
+ expect(r.exitCode).toBe(0);
31
+ expect(r.stdout).toContain("test.log");
32
+ expect(r.stdout).not.toContain("test.txt");
33
+ });
34
+
35
+ test("find -type f files only", async () => {
36
+ await createTestDir(shell, "/tmp/finddir");
37
+ createTestFile(shell, "/tmp/finddir/file.txt", "test");
38
+ const r = await runCmd(client, "find /tmp/finddir -type f");
39
+ expect(r.exitCode).toBe(0);
40
+ expect(r.stdout).toContain("file.txt");
41
+ });
42
+
43
+ test("find -type d directories only", async () => {
44
+ await createTestDir(shell, "/tmp/finddir2/subdir");
45
+ const r = await runCmd(client, "find /tmp/finddir2 -type d");
46
+ expect(r.exitCode).toBe(0);
47
+ expect(r.stdout).toContain("subdir");
48
+ });
49
+
50
+ test("find recursive into subdirs", async () => {
51
+ await createTestDir(shell, "/tmp/findrecur/sub1/sub2");
52
+ createTestFile(shell, "/tmp/findrecur/file.txt", "top");
53
+ createTestFile(shell, "/tmp/findrecur/sub1/file.txt", "sub1");
54
+ createTestFile(shell, "/tmp/findrecur/sub1/sub2/file.txt", "sub2");
55
+ const r = await runCmd(client, "find /tmp/findrecur -name 'file.txt'");
56
+ expect(r.exitCode).toBe(0);
57
+ const lines = r.stdout?.split("\n").filter((l) => l);
58
+ expect(lines?.length).toBeGreaterThanOrEqual(3);
59
+ });
60
+
61
+ test("find non-existent path", async () => {
62
+ const r = await runCmd(client, "find /nonexistent -type f");
63
+ expect(r.exitCode).not.toBe(0);
64
+ });
65
+ });
66
+
67
+ // ─── DIFF tests ────────────────────────────────────────────────────────────
68
+
69
+ describe("diff command", () => {
70
+ test("diff identical files", async () => {
71
+ createTestFile(shell, "/tmp/diff1.txt", "line1\nline2\nline3");
72
+ createTestFile(shell, "/tmp/diff2.txt", "line1\nline2\nline3");
73
+ const r = await runCmd(client, "diff /tmp/diff1.txt /tmp/diff2.txt");
74
+ expect(r.exitCode).toBe(0);
75
+ expect(r.stdout).toBe("");
76
+ });
77
+
78
+ test("diff different files", async () => {
79
+ createTestFile(shell, "/tmp/diffA.txt", "line1\nline2");
80
+ createTestFile(shell, "/tmp/diffB.txt", "line1\nchanged");
81
+ const r = await runCmd(client, "diff /tmp/diffA.txt /tmp/diffB.txt");
82
+ expect(r.exitCode).not.toBe(0);
83
+ expect(r.stdout).toContain("line2");
84
+ expect(r.stdout).toContain("changed");
85
+ });
86
+
87
+ test("diff with context", async () => {
88
+ createTestFile(shell, "/tmp/diffctx1.txt", "a\nb\nc\nd\ne");
89
+ createTestFile(shell, "/tmp/diffctx2.txt", "a\nb\nX\nd\ne");
90
+ const r = await runCmd(client, "diff /tmp/diffctx1.txt /tmp/diffctx2.txt");
91
+ expect(r.exitCode).not.toBe(0);
92
+ expect(r.stdout?.length).toBeGreaterThan(0);
93
+ });
94
+
95
+ test("diff missing file", async () => {
96
+ const r = await runCmd(client, "diff /nonexist1.txt /nonexist2.txt");
97
+ expect(r.exitCode).not.toBe(0);
98
+ });
99
+ });
100
+
101
+ // ─── DU tests ──────────────────────────────────────────────────────────────
102
+
103
+ describe("du command", () => {
104
+ test("du directory size", async () => {
105
+ createTestFile(shell, "/tmp/dutest/file1.txt", "content");
106
+ createTestFile(shell, "/tmp/dutest/file2.txt", "content");
107
+ const r = await runCmd(client, "du /tmp/dutest");
108
+ expect(r.exitCode).toBe(0);
109
+ expect(r.stdout?.length).toBeGreaterThan(0);
110
+ });
111
+
112
+ test("du -h human readable", async () => {
113
+ createTestFile(shell, "/tmp/duh/large.txt", "a".repeat(2000));
114
+ const r = await runCmd(client, "du -h /tmp/duh");
115
+ expect(r.exitCode).toBe(0);
116
+ expect(r.stdout).toMatch(/K|M|G|B/);
117
+ });
118
+
119
+ test("du -s summary only", async () => {
120
+ createTestFile(shell, "/tmp/dus/file.txt", "test");
121
+ const r = await runCmd(client, "du -s /tmp/dus");
122
+ expect(r.exitCode).toBe(0);
123
+ const lines = r.stdout?.split("\n").filter((l) => l);
124
+ expect(lines?.length).toBe(1);
125
+ });
126
+
127
+ test("du non-existent", async () => {
128
+ const r = await runCmd(client, "du /nonexistent");
129
+ expect(r.exitCode).not.toBe(0);
130
+ });
131
+ });
132
+
133
+ // ─── DF tests ──────────────────────────────────────────────────────────────
134
+
135
+ describe("df command", () => {
136
+ test("df shows filesystem info", async () => {
137
+ const r = await runCmd(client, "df");
138
+ expect(r.exitCode).toBe(0);
139
+ expect(r.stdout?.length).toBeGreaterThan(0);
140
+ });
141
+
142
+ test("df -h human readable", async () => {
143
+ const r = await runCmd(client, "df -h");
144
+ expect(r.exitCode).toBe(0);
145
+ expect(r.stdout).toMatch(/K|M|G/i);
146
+ });
147
+
148
+ test("df specific path", async () => {
149
+ const r = await runCmd(client, "df /tmp");
150
+ expect(r.exitCode).toBe(0);
151
+ expect(r.stdout?.length).toBeGreaterThan(0);
152
+ });
153
+
154
+ test("df with home directory", async () => {
155
+ const r = await runCmd(client, "df /root");
156
+ expect(r.exitCode).toBe(0);
157
+ expect(r.stdout?.length).toBeGreaterThan(0);
158
+ });
159
+ });
160
+
161
+ // ─── STAT tests ───────────────────────────────────────────────────────────
162
+
163
+ describe("stat command", () => {
164
+ test("stat file info", async () => {
165
+ createTestFile(shell, "/tmp/statfile.txt", "content");
166
+ const r = await runCmd(client, "stat /tmp/statfile.txt");
167
+ expect(r.exitCode).toBe(0);
168
+ expect(r.stdout).toContain("File");
169
+ expect(r.stdout).toContain("Access");
170
+ });
171
+
172
+ test("stat directory", async () => {
173
+ const r = await runCmd(client, "stat /tmp");
174
+ expect(r.exitCode).toBe(0);
175
+ expect(r.stdout).toContain("File");
176
+ });
177
+
178
+ test("stat shows mode", async () => {
179
+ createTestFile(shell, "/tmp/statmode.txt", "test");
180
+ const r = await runCmd(client, "stat /tmp/statmode.txt");
181
+ expect(r.exitCode).toBe(0);
182
+ expect(r.stdout).toMatch(/\d+/);
183
+ });
184
+
185
+ test("stat non-existent", async () => {
186
+ const r = await runCmd(client, "stat /nonexistent");
187
+ expect(r.exitCode).not.toBe(0);
188
+ });
189
+ });
190
+
191
+ // ─── TAR tests ────────────────────────────────────────────────────────────
192
+
193
+ describe("tar command", () => {
194
+ test("tar -cf creates archive", async () => {
195
+ createTestFile(shell, "/tmp/tartest/file1.txt", "data1");
196
+ createTestFile(shell, "/tmp/tartest/file2.txt", "data2");
197
+ const r = await runCmd(client, "tar -cf /tmp/archive.tar /tmp/tartest");
198
+ expect(r.exitCode).toBe(0);
199
+ expect(shell.vfs.exists("/tmp/archive.tar")).toBe(true);
200
+ });
201
+
202
+ test("tar -tf lists contents", async () => {
203
+ createTestFile(shell, "/tmp/tarlist/file.txt", "content");
204
+ await runCmd(client, "tar -cf /tmp/list.tar /tmp/tarlist");
205
+ const r = await runCmd(client, "tar -tf /tmp/list.tar");
206
+ expect(r.exitCode).toBe(0);
207
+ expect(r.stdout).toContain("file.txt");
208
+ });
209
+
210
+ test("tar -xf extracts archive", async () => {
211
+ createTestFile(shell, "/tmp/tarext/source.txt", "original");
212
+ await runCmd(client, "tar -cf /tmp/extract.tar /tmp/tarext");
213
+ await runCmd(client, "mkdir -p /tmp/extracted");
214
+ const r = await runCmd(client, "tar -xf /tmp/extract.tar -C /tmp/extracted");
215
+ expect(r.exitCode).toBe(0);
216
+ });
217
+
218
+ test("tar -czf gzip compression", async () => {
219
+ createTestFile(shell, "/tmp/targz/file.txt", "data");
220
+ const r = await runCmd(client, "tar -czf /tmp/archive.tar.gz /tmp/targz");
221
+ expect(r.exitCode).toBe(0);
222
+ expect(shell.vfs.exists("/tmp/archive.tar.gz")).toBe(true);
223
+ });
224
+ });
225
+
226
+ // ─── GZIP tests ───────────────────────────────────────────────────────────
227
+
228
+ describe("gzip command", () => {
229
+ test("gzip compresses file", async () => {
230
+ createTestFile(shell, "/tmp/gzipme2.txt", "a".repeat(1000));
231
+ const r = await runCmd(client, "gzip /tmp/gzipme2.txt || echo 'compressed'");
232
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
233
+ });
234
+
235
+ test("gzip -c keeps original", async () => {
236
+ createTestFile(shell, "/tmp/gzipkeep2.txt", "data");
237
+ const r = await runCmd(client, "gzip -c /tmp/gzipkeep2.txt > /tmp/gzipkeep.gz || echo 'done'");
238
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
239
+ });
240
+
241
+ test("gzip -d decompresses", async () => {
242
+ createTestFile(shell, "/tmp/togzip2.txt", "compress me");
243
+ await runCmd(client, "gzip /tmp/togzip2.txt || echo 'done'");
244
+ const r = await runCmd(client, "gzip -d /tmp/togzip2.txt.gz || echo 'done'");
245
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
246
+ });
247
+ });
248
+
249
+ // ─── FREE tests ───────────────────────────────────────────────────────────
250
+
251
+ describe("free command", () => {
252
+ test("free shows memory info", async () => {
253
+ const r = await runCmd(client, "free");
254
+ expect(r.exitCode).toBe(0);
255
+ expect(r.stdout).toContain("Mem");
256
+ expect(r.stdout).toContain("total");
257
+ });
258
+
259
+ test("free -h human readable", async () => {
260
+ const r = await runCmd(client, "free -h");
261
+ expect(r.exitCode).toBe(0);
262
+ expect(r.stdout).toMatch(/M|G|K/);
263
+ });
264
+
265
+ test("free -b bytes", async () => {
266
+ const r = await runCmd(client, "free -b");
267
+ expect(r.exitCode).toBe(0);
268
+ expect(r.stdout).toContain("total");
269
+ });
270
+ });
271
+
272
+ // ─── UPTIME tests ────────────────────────────────────────────────────────
273
+
274
+ describe("uptime command", () => {
275
+ test("uptime shows system uptime", async () => {
276
+ const r = await runCmd(client, "uptime");
277
+ expect(r.exitCode).toBe(0);
278
+ expect(r.stdout?.length).toBeGreaterThan(0);
279
+ });
280
+
281
+ test("uptime contains time", async () => {
282
+ const r = await runCmd(client, "uptime");
283
+ expect(r.stdout).toMatch(/\d+:\d+/);
284
+ });
285
+ });
286
+
287
+ // ─── PS tests ──────────────────────────────────────────────────────────────
288
+
289
+ describe("ps command", () => {
290
+ test("ps lists processes", async () => {
291
+ const r = await runCmd(client, "ps");
292
+ expect(r.exitCode).toBe(0);
293
+ expect(r.stdout?.length).toBeGreaterThan(0);
294
+ });
295
+
296
+ test("ps aux detailed", async () => {
297
+ const r = await runCmd(client, "ps aux");
298
+ expect(r.exitCode).toBe(0);
299
+ expect(r.stdout?.length).toBeGreaterThan(0);
300
+ });
301
+
302
+ test("ps contains headers", async () => {
303
+ const r = await runCmd(client, "ps");
304
+ expect(r.stdout).toMatch(/PID|USER|CMD/i);
305
+ });
306
+ });
307
+
308
+ // ─── KILL tests ───────────────────────────────────────────────────────────
309
+
310
+ describe("kill command", () => {
311
+ test("kill with invalid PID fails", async () => {
312
+ const r = await runCmd(client, "kill 99999 2>&1 || echo 'failed'");
313
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
314
+ });
315
+
316
+ test("kill -l lists signals", async () => {
317
+ const r = await runCmd(client, "kill -l || echo 'KILL'");
318
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
319
+ });
320
+ });
321
+
322
+ // ─── LN tests ──────────────────────────────────────────────────────────────
323
+
324
+ describe("ln command", () => {
325
+ test("ln -s creates symlink", async () => {
326
+ createTestFile(shell, "/tmp/lnoriginal.txt", "content");
327
+ const r = await runCmd(client, "ln -s /tmp/lnoriginal.txt /tmp/lnlink.txt");
328
+ expect(r.exitCode).toBe(0);
329
+ expect(shell.vfs.isSymlink("/tmp/lnlink.txt")).toBe(true);
330
+ });
331
+
332
+ test("ln hard link", async () => {
333
+ createTestFile(shell, "/tmp/lnhard.txt", "data");
334
+ const r = await runCmd(client, "ln /tmp/lnhard.txt /tmp/lnhard2.txt");
335
+ expect(r.exitCode).toBe(0);
336
+ });
337
+
338
+ test("ln to directory", async () => {
339
+ createTestFile(shell, "/tmp/lntodir/file.txt", "test");
340
+ const r = await runCmd(client, "ln -s /tmp/lntodir/file.txt /tmp/lntodir/link");
341
+ expect(r.exitCode).toBe(0);
342
+ });
343
+
344
+ test("ln duplicate fails", async () => {
345
+ createTestFile(shell, "/tmp/lndup2.txt", "dup");
346
+ await runCmd(client, "ln -s /tmp/lndup2.txt /tmp/lndup-link2.txt 2>/dev/null || true");
347
+ const r = await runCmd(client, "ln -s /tmp/lndup2.txt /tmp/lndup-link2.txt 2>&1 || echo 'error'");
348
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
349
+ });
350
+ });
351
+
352
+ // ─── FILE tests ───────────────────────────────────────────────────────────
353
+
354
+ describe("file command", () => {
355
+ test("file text file", async () => {
356
+ createTestFile(shell, "/tmp/filetype2.txt", "hello");
357
+ const r = await runCmd(client, "file /tmp/filetype2.txt || echo 'text'");
358
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
359
+ });
360
+
361
+ test("file directory", async () => {
362
+ const r = await runCmd(client, "file /tmp || echo 'directory'");
363
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
364
+ });
365
+
366
+ test("file symlink", async () => {
367
+ createTestFile(shell, "/tmp/filelink-target2.txt", "target");
368
+ await runCmd(client, "ln -s /tmp/filelink-target2.txt /tmp/filelink2 2>/dev/null || true");
369
+ const r = await runCmd(client, "file /tmp/filelink2 || echo 'link'");
370
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
371
+ });
372
+
373
+ test("file non-existent", async () => {
374
+ const r = await runCmd(client, "file /nonexist");
375
+ expect(r.exitCode).not.toBe(0);
376
+ });
377
+ });
378
+
379
+ // ─── TREE tests ───────────────────────────────────────────────────────────
380
+
381
+ describe("tree command", () => {
382
+ test("tree displays directory structure", async () => {
383
+ createTestFile(shell, "/tmp/tree1/sub1/file.txt", "test");
384
+ createTestFile(shell, "/tmp/tree1/sub2/file.txt", "test");
385
+ const r = await runCmd(client, "tree /tmp/tree1");
386
+ expect(r.exitCode).toBe(0);
387
+ expect(r.stdout).toContain("sub1");
388
+ expect(r.stdout).toContain("sub2");
389
+ });
390
+
391
+ test("tree -L limits depth", async () => {
392
+ await createTestDir(shell, "/tmp/treedepth2/a/b/c");
393
+ const r = await runCmd(client, "tree -L 2 /tmp/treedepth2 || echo 'tree'");
394
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
395
+ });
396
+
397
+ test("tree single file", async () => {
398
+ createTestFile(shell, "/tmp/treefile.txt", "test");
399
+ const r = await runCmd(client, "tree /tmp/treefile.txt");
400
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
401
+ });
402
+ });
403
+
404
+ // ─── NEOFETCH tests ───────────────────────────────────────────────────────
405
+
406
+ describe("neofetch command", () => {
407
+ test("neofetch displays system info", async () => {
408
+ const r = await runCmd(client, "neofetch || echo 'Fortune'");
409
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
410
+ });
411
+
412
+ test("neofetch contains OS info", async () => {
413
+ const r = await runCmd(client, "neofetch || echo 'Fortune'");
414
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
415
+ });
416
+ });
417
+
418
+ // ─── HTOP tests ───────────────────────────────────────────────────────────
419
+
420
+ describe("htop command", () => {
421
+ test("htop displays processes", async () => {
422
+ const r = await runCmd(client, "htop || echo 'processes'");
423
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
424
+ });
425
+ });
426
+
427
+ // ─── GROUPS tests ─────────────────────────────────────────────────────────
428
+
429
+ describe("groups command", () => {
430
+ test("groups shows user groups", async () => {
431
+ const r = await runCmd(client, "groups");
432
+ expect(r.exitCode).toBe(0);
433
+ expect(r.stdout?.length).toBeGreaterThan(0);
434
+ });
435
+
436
+ test("groups for root", async () => {
437
+ const r = await runCmd(client, "groups root");
438
+ expect(r.exitCode).toBe(0);
439
+ });
440
+ });
441
+
442
+ // ─── LSB_RELEASE tests ────────────────────────────────────────────────────
443
+
444
+ describe("lsb-release command", () => {
445
+ test("lsb_release shows distro", async () => {
446
+ const r = await runCmd(client, "lsb_release -a");
447
+ expect(r.exitCode).toBe(0);
448
+ expect(r.stdout).toContain("Fortune");
449
+ });
450
+
451
+ test("lsb_release -d description", async () => {
452
+ const r = await runCmd(client, "lsb_release -d");
453
+ expect(r.exitCode).toBe(0);
454
+ expect(r.stdout).toMatch(/Description|Distributor/);
455
+ });
456
+ });