luca 3.0.0 → 3.1.0

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 (388) hide show
  1. package/.github/workflows/release.yaml +1 -0
  2. package/CLAUDE.md +10 -2
  3. package/README.md +130 -112
  4. package/assistants/codingAssistant/CORE.md +6 -1
  5. package/assistants/codingAssistant/hooks.ts +1 -1
  6. package/assistants/inkbot/hooks.ts +1 -1
  7. package/assistants/inkbot/tools.ts +1 -1
  8. package/bun.lock +264 -321
  9. package/commands/audit-docs.ts +2 -2
  10. package/commands/build-bootstrap.ts +2 -3
  11. package/commands/build-python-bridge.ts +2 -3
  12. package/commands/build-scaffolds.ts +2 -3
  13. package/commands/bundle-consumer-project.ts +521 -0
  14. package/commands/generate-api-docs.ts +2 -2
  15. package/commands/inkbot.ts +2 -2
  16. package/commands/release.ts +2 -2
  17. package/commands/social.ts +137 -0
  18. package/commands/try-all-challenges.ts +3 -3
  19. package/commands/try-challenge.ts +3 -3
  20. package/datasets/lora/agentic-loop-session-candidates.jsonl +91 -0
  21. package/datasets/lora/agentic-loop-session-curation-summary.json +123 -0
  22. package/datasets/lora/luca-session-candidates.jsonl +29 -0
  23. package/datasets/lora/luca-session-curation-summary.json +121 -0
  24. package/datasets/lora/review-batch-1.jsonl +30 -0
  25. package/datasets/lora/review-manifest.json +41 -0
  26. package/datasets/lora/review-queue.jsonl +120 -0
  27. package/datasets/lora/review-schema.json +134 -0
  28. package/datasets/lora/review-template.jsonl +2 -0
  29. package/datasets/lora/review-ui.html +725 -0
  30. package/dist/agi/container.server.d.ts +2 -2
  31. package/dist/agi/features/assistant.d.ts +2 -2
  32. package/dist/agi/features/assistants-manager.d.ts +1 -1
  33. package/dist/agi/features/autonomous-assistant.d.ts +1 -1
  34. package/dist/agi/features/browser-use.d.ts +1 -1
  35. package/dist/agi/features/claude-code.d.ts +1 -1
  36. package/dist/agi/features/conversation-history.d.ts +2 -2
  37. package/dist/agi/features/conversation.d.ts +1 -1
  38. package/dist/agi/features/docs-reader.d.ts +1 -1
  39. package/dist/agi/features/file-tools.d.ts +1 -1
  40. package/dist/agi/features/luca-coder.d.ts +1 -1
  41. package/dist/agi/features/openai-codex.d.ts +1 -1
  42. package/dist/agi/features/skills-library.d.ts +1 -1
  43. package/dist/clients/civitai/index.d.ts +4 -4
  44. package/dist/clients/client-template.d.ts +4 -4
  45. package/dist/clients/comfyui/index.d.ts +2 -2
  46. package/dist/clients/elevenlabs/index.d.ts +2 -2
  47. package/dist/clients/openai/index.d.ts +2 -2
  48. package/dist/clients/supabase/index.d.ts +3 -3
  49. package/dist/command.d.ts +1 -1
  50. package/dist/node/container.d.ts +1 -1
  51. package/dist/node/features/helpers.d.ts +3 -3
  52. package/dist/node/features/semantic-search.d.ts +1 -1
  53. package/dist/node/features/vm.d.ts +3 -3
  54. package/dist/node.d.ts +1 -1
  55. package/dist/scaffolds/generated.d.ts +1 -1
  56. package/dist/selector.d.ts +1 -1
  57. package/features/cipher-social.ts +493 -0
  58. package/index.html +217 -190
  59. package/luca.console.ts +1 -1
  60. package/package.json +7 -2
  61. package/public/index.html +217 -190
  62. package/public/slides-ai-native.html +1 -1
  63. package/public/slides-intro.html +2 -2
  64. package/scripts/curate-claude-sessions.ts +561 -0
  65. package/scripts/examples/ask-luca-expert.ts +1 -1
  66. package/scripts/examples/assistant-questions.ts +1 -1
  67. package/scripts/examples/excalidraw-expert.ts +1 -1
  68. package/scripts/examples/file-manager.ts +1 -1
  69. package/scripts/examples/ideas.ts +1 -1
  70. package/scripts/examples/interactive-chat.ts +1 -1
  71. package/scripts/examples/opening-a-web-browser.ts +1 -1
  72. package/scripts/examples/telegram-bot.ts +1 -1
  73. package/scripts/examples/using-assistant-with-mcp.ts +1 -1
  74. package/scripts/examples/using-claude-code.ts +1 -1
  75. package/scripts/examples/using-contentdb.ts +2 -2
  76. package/scripts/examples/using-conversations.ts +1 -1
  77. package/scripts/examples/using-disk-cache.ts +1 -1
  78. package/scripts/examples/using-docker-shell.ts +1 -1
  79. package/scripts/examples/using-elevenlabs.ts +1 -1
  80. package/scripts/examples/using-google-calendar.ts +1 -1
  81. package/scripts/examples/using-google-docs.ts +1 -1
  82. package/scripts/examples/using-google-drive.ts +1 -1
  83. package/scripts/examples/using-google-sheets.ts +1 -1
  84. package/scripts/examples/using-nlp.ts +1 -1
  85. package/scripts/examples/using-ollama.ts +1 -1
  86. package/scripts/examples/using-postgres.ts +1 -1
  87. package/scripts/examples/using-runpod.ts +1 -1
  88. package/scripts/examples/using-tts.ts +1 -1
  89. package/scripts/scaffold.ts +5 -5
  90. package/scripts/scratch.ts +1 -1
  91. package/scripts/test-assistant-hooks.ts +1 -1
  92. package/scripts/test-docs-reader.ts +1 -1
  93. package/src/agi/container.server.ts +6 -2
  94. package/src/agi/features/agent-memory.ts +25 -25
  95. package/src/agi/features/assistant.ts +34 -5
  96. package/src/agi/features/assistants-manager.ts +122 -6
  97. package/src/agi/features/autonomous-assistant.ts +1 -1
  98. package/src/agi/features/browser-use.ts +20 -1
  99. package/src/agi/features/claude-code.ts +51 -5
  100. package/src/agi/features/coding-tools.ts +1 -1
  101. package/src/agi/features/conversation-history.ts +181 -4
  102. package/src/agi/features/conversation.ts +186 -15
  103. package/src/agi/features/docs-reader.ts +2 -2
  104. package/src/agi/features/file-tools.ts +49 -2
  105. package/src/agi/features/luca-coder.ts +7 -5
  106. package/src/agi/features/mcp-bridge.ts +532 -0
  107. package/src/agi/features/openai-codex.ts +2 -2
  108. package/src/agi/features/skills-library.ts +131 -52
  109. package/src/agi/lib/token-counter.ts +80 -0
  110. package/src/bootstrap/generated.ts +56 -57
  111. package/src/browser.ts +1 -1
  112. package/src/cli/build-info.ts +2 -2
  113. package/src/cli/cli.ts +2 -2
  114. package/src/clients/civitai/index.ts +5 -5
  115. package/src/clients/client-template.ts +4 -4
  116. package/src/clients/comfyui/index.ts +4 -4
  117. package/src/clients/elevenlabs/index.ts +4 -4
  118. package/src/clients/openai/index.ts +7 -7
  119. package/src/clients/supabase/index.ts +4 -4
  120. package/src/clients/voicebox/index.ts +4 -4
  121. package/src/command.ts +2 -1
  122. package/src/commands/chat.ts +1 -0
  123. package/src/commands/eval.ts +2 -56
  124. package/src/commands/introspect.ts +1 -1
  125. package/src/commands/prompt.ts +41 -9
  126. package/src/container-describer.ts +8 -1
  127. package/src/container.ts +13 -0
  128. package/src/entity.ts +2 -2
  129. package/src/helper.ts +1 -1
  130. package/src/introspection/generated.agi.ts +29596 -27654
  131. package/src/introspection/generated.node.ts +20284 -19247
  132. package/src/introspection/generated.web.ts +605 -584
  133. package/src/introspection/scan.ts +11 -6
  134. package/src/node/container.ts +9 -1
  135. package/src/node/features/content-db.ts +39 -2
  136. package/src/node/features/display-result.ts +57 -0
  137. package/src/node/features/helpers.ts +46 -7
  138. package/src/node/features/python.ts +25 -19
  139. package/src/node/features/repl.ts +1 -1
  140. package/src/node/features/secure-shell.ts +11 -17
  141. package/src/node/features/semantic-search.ts +2 -2
  142. package/src/node/features/socket-repl.ts +336 -0
  143. package/src/node/features/telnyx-assistant-connector.ts +1206 -0
  144. package/src/node/features/transpiler.ts +2 -3
  145. package/src/node/features/ui.ts +5 -0
  146. package/src/node/features/vm.ts +20 -3
  147. package/src/node.ts +3 -3
  148. package/src/python/generated.ts +0 -1
  149. package/src/scaffolds/generated.ts +82 -83
  150. package/src/selector.ts +1 -1
  151. package/src/servers/express.ts +1 -1
  152. package/src/web/features/helpers.ts +22 -0
  153. package/tsconfig.json +12 -12
  154. package/docs/CLI.md +0 -335
  155. package/docs/CNAME +0 -1
  156. package/docs/README.md +0 -60
  157. package/docs/TABLE-OF-CONTENTS.md +0 -183
  158. package/docs/apis/clients/elevenlabs.md +0 -308
  159. package/docs/apis/clients/graph.md +0 -107
  160. package/docs/apis/clients/openai.md +0 -429
  161. package/docs/apis/clients/rest.md +0 -161
  162. package/docs/apis/clients/websocket.md +0 -174
  163. package/docs/apis/features/agi/assistant.md +0 -625
  164. package/docs/apis/features/agi/assistants-manager.md +0 -282
  165. package/docs/apis/features/agi/auto-assistant.md +0 -279
  166. package/docs/apis/features/agi/browser-use.md +0 -802
  167. package/docs/apis/features/agi/claude-code.md +0 -884
  168. package/docs/apis/features/agi/conversation-history.md +0 -364
  169. package/docs/apis/features/agi/conversation.md +0 -548
  170. package/docs/apis/features/agi/docs-reader.md +0 -99
  171. package/docs/apis/features/agi/file-tools.md +0 -163
  172. package/docs/apis/features/agi/luca-coder.md +0 -407
  173. package/docs/apis/features/agi/openai-codex.md +0 -396
  174. package/docs/apis/features/agi/openapi.md +0 -138
  175. package/docs/apis/features/agi/semantic-search.md +0 -387
  176. package/docs/apis/features/agi/skills-library.md +0 -239
  177. package/docs/apis/features/node/container-link.md +0 -192
  178. package/docs/apis/features/node/content-db.md +0 -450
  179. package/docs/apis/features/node/disk-cache.md +0 -379
  180. package/docs/apis/features/node/dns.md +0 -652
  181. package/docs/apis/features/node/docker.md +0 -706
  182. package/docs/apis/features/node/downloader.md +0 -81
  183. package/docs/apis/features/node/esbuild.md +0 -60
  184. package/docs/apis/features/node/file-manager.md +0 -191
  185. package/docs/apis/features/node/fs.md +0 -1217
  186. package/docs/apis/features/node/git.md +0 -371
  187. package/docs/apis/features/node/google-auth.md +0 -193
  188. package/docs/apis/features/node/google-calendar.md +0 -202
  189. package/docs/apis/features/node/google-docs.md +0 -173
  190. package/docs/apis/features/node/google-drive.md +0 -246
  191. package/docs/apis/features/node/google-mail.md +0 -214
  192. package/docs/apis/features/node/google-sheets.md +0 -194
  193. package/docs/apis/features/node/grep.md +0 -292
  194. package/docs/apis/features/node/helpers.md +0 -164
  195. package/docs/apis/features/node/ink.md +0 -334
  196. package/docs/apis/features/node/ipc-socket.md +0 -249
  197. package/docs/apis/features/node/json-tree.md +0 -86
  198. package/docs/apis/features/node/networking.md +0 -316
  199. package/docs/apis/features/node/nlp.md +0 -133
  200. package/docs/apis/features/node/opener.md +0 -97
  201. package/docs/apis/features/node/os.md +0 -146
  202. package/docs/apis/features/node/package-finder.md +0 -392
  203. package/docs/apis/features/node/postgres.md +0 -234
  204. package/docs/apis/features/node/proc.md +0 -399
  205. package/docs/apis/features/node/process-manager.md +0 -305
  206. package/docs/apis/features/node/python.md +0 -604
  207. package/docs/apis/features/node/redis.md +0 -380
  208. package/docs/apis/features/node/repl.md +0 -88
  209. package/docs/apis/features/node/runpod.md +0 -674
  210. package/docs/apis/features/node/secure-shell.md +0 -176
  211. package/docs/apis/features/node/semantic-search.md +0 -408
  212. package/docs/apis/features/node/sqlite.md +0 -233
  213. package/docs/apis/features/node/telegram.md +0 -279
  214. package/docs/apis/features/node/transpiler.md +0 -74
  215. package/docs/apis/features/node/tts.md +0 -133
  216. package/docs/apis/features/node/ui.md +0 -701
  217. package/docs/apis/features/node/vault.md +0 -59
  218. package/docs/apis/features/node/vm.md +0 -75
  219. package/docs/apis/features/node/yaml-tree.md +0 -85
  220. package/docs/apis/features/node/yaml.md +0 -176
  221. package/docs/apis/features/web/asset-loader.md +0 -59
  222. package/docs/apis/features/web/container-link.md +0 -192
  223. package/docs/apis/features/web/esbuild.md +0 -54
  224. package/docs/apis/features/web/helpers.md +0 -164
  225. package/docs/apis/features/web/network.md +0 -44
  226. package/docs/apis/features/web/speech.md +0 -69
  227. package/docs/apis/features/web/vault.md +0 -59
  228. package/docs/apis/features/web/vm.md +0 -75
  229. package/docs/apis/features/web/voice.md +0 -84
  230. package/docs/apis/servers/express.md +0 -171
  231. package/docs/apis/servers/mcp.md +0 -238
  232. package/docs/apis/servers/websocket.md +0 -170
  233. package/docs/bootstrap/CLAUDE.md +0 -101
  234. package/docs/bootstrap/SKILL.md +0 -341
  235. package/docs/bootstrap/templates/about-command.ts +0 -41
  236. package/docs/bootstrap/templates/docs-models.ts +0 -22
  237. package/docs/bootstrap/templates/docs-readme.md +0 -43
  238. package/docs/bootstrap/templates/example-feature.ts +0 -53
  239. package/docs/bootstrap/templates/health-endpoint.ts +0 -15
  240. package/docs/bootstrap/templates/luca-cli.ts +0 -30
  241. package/docs/bootstrap/templates/runme.md +0 -54
  242. package/docs/challenges/caching-proxy.md +0 -16
  243. package/docs/challenges/content-db-round-trip.md +0 -14
  244. package/docs/challenges/custom-command.md +0 -9
  245. package/docs/challenges/file-watcher-pipeline.md +0 -11
  246. package/docs/challenges/grep-audit-report.md +0 -15
  247. package/docs/challenges/multi-feature-dashboard.md +0 -14
  248. package/docs/challenges/process-orchestrator.md +0 -17
  249. package/docs/challenges/rest-api-server-with-client.md +0 -12
  250. package/docs/challenges/script-runner-with-vm.md +0 -11
  251. package/docs/challenges/simple-rest-api.md +0 -15
  252. package/docs/challenges/websocket-serve-and-client.md +0 -11
  253. package/docs/challenges/yaml-config-system.md +0 -14
  254. package/docs/command-system-overhaul.md +0 -94
  255. package/docs/documentation-audit.md +0 -134
  256. package/docs/examples/assistant/CORE.md +0 -18
  257. package/docs/examples/assistant/hooks.ts +0 -3
  258. package/docs/examples/assistant/tools.ts +0 -10
  259. package/docs/examples/assistant-hooks-reference.ts +0 -171
  260. package/docs/examples/assistant-with-process-manager.md +0 -84
  261. package/docs/examples/content-db.md +0 -77
  262. package/docs/examples/disk-cache.md +0 -83
  263. package/docs/examples/docker.md +0 -101
  264. package/docs/examples/downloader.md +0 -70
  265. package/docs/examples/entity.md +0 -124
  266. package/docs/examples/esbuild.md +0 -80
  267. package/docs/examples/feature-as-tool-provider.md +0 -143
  268. package/docs/examples/file-manager.md +0 -82
  269. package/docs/examples/fs.md +0 -83
  270. package/docs/examples/git.md +0 -85
  271. package/docs/examples/google-auth.md +0 -88
  272. package/docs/examples/google-calendar.md +0 -94
  273. package/docs/examples/google-docs.md +0 -82
  274. package/docs/examples/google-drive.md +0 -96
  275. package/docs/examples/google-sheets.md +0 -95
  276. package/docs/examples/grep.md +0 -85
  277. package/docs/examples/ink-blocks.md +0 -75
  278. package/docs/examples/ink-renderer.md +0 -41
  279. package/docs/examples/ink.md +0 -103
  280. package/docs/examples/ipc-socket.md +0 -103
  281. package/docs/examples/json-tree.md +0 -91
  282. package/docs/examples/networking.md +0 -58
  283. package/docs/examples/nlp.md +0 -91
  284. package/docs/examples/opener.md +0 -78
  285. package/docs/examples/os.md +0 -72
  286. package/docs/examples/package-finder.md +0 -89
  287. package/docs/examples/postgres.md +0 -91
  288. package/docs/examples/proc.md +0 -81
  289. package/docs/examples/process-manager.md +0 -79
  290. package/docs/examples/python.md +0 -132
  291. package/docs/examples/repl.md +0 -93
  292. package/docs/examples/runpod.md +0 -119
  293. package/docs/examples/secure-shell.md +0 -92
  294. package/docs/examples/sqlite.md +0 -86
  295. package/docs/examples/structured-output-with-assistants.md +0 -144
  296. package/docs/examples/telegram.md +0 -77
  297. package/docs/examples/tts.md +0 -86
  298. package/docs/examples/ui.md +0 -80
  299. package/docs/examples/vault.md +0 -70
  300. package/docs/examples/vm.md +0 -86
  301. package/docs/examples/websocket-ask-and-reply-example.md +0 -128
  302. package/docs/examples/yaml-tree.md +0 -93
  303. package/docs/examples/yaml.md +0 -104
  304. package/docs/ideas/assistant-factory-pattern.md +0 -142
  305. package/docs/in-memory-fs.md +0 -4
  306. package/docs/introspection-audit.md +0 -49
  307. package/docs/introspection.md +0 -164
  308. package/docs/mcp/readme.md +0 -162
  309. package/docs/models.ts +0 -41
  310. package/docs/philosophy.md +0 -86
  311. package/docs/principles.md +0 -7
  312. package/docs/prompts/audit-codebase-for-failures-to-use-the-container.md +0 -34
  313. package/docs/prompts/check-for-undocumented-features.md +0 -27
  314. package/docs/prompts/mcp-test-easy-command.md +0 -27
  315. package/docs/scaffolds/client.md +0 -149
  316. package/docs/scaffolds/command.md +0 -120
  317. package/docs/scaffolds/endpoint.md +0 -171
  318. package/docs/scaffolds/feature.md +0 -158
  319. package/docs/scaffolds/selector.md +0 -91
  320. package/docs/scaffolds/server.md +0 -196
  321. package/docs/selectors.md +0 -115
  322. package/docs/sessions/custom-command/attempt-log-2.md +0 -195
  323. package/docs/sessions/file-watcher-pipeline/attempt-log-1.md +0 -728
  324. package/docs/sessions/file-watcher-pipeline/attempt-log-2.md +0 -555
  325. package/docs/sessions/grep-audit-report/attempt-log-1.md +0 -289
  326. package/docs/sessions/multi-feature-dashboard/attempt-log-2.md +0 -679
  327. package/docs/sessions/rest-api-server-with-client/attempt-log-1.md +0 -1
  328. package/docs/sessions/rest-api-server-with-client/attempt-log-3.md +0 -920
  329. package/docs/sessions/simple-rest-api/attempt-log-1.md +0 -593
  330. package/docs/sessions/websocket-serve-and-client/attempt-log-2.md +0 -995
  331. package/docs/tutorials/00-bootstrap.md +0 -166
  332. package/docs/tutorials/01-getting-started.md +0 -106
  333. package/docs/tutorials/02-container.md +0 -210
  334. package/docs/tutorials/03-scripts.md +0 -194
  335. package/docs/tutorials/04-features-overview.md +0 -196
  336. package/docs/tutorials/05-state-and-events.md +0 -171
  337. package/docs/tutorials/06-servers.md +0 -157
  338. package/docs/tutorials/07-endpoints.md +0 -198
  339. package/docs/tutorials/08-commands.md +0 -252
  340. package/docs/tutorials/09-clients.md +0 -162
  341. package/docs/tutorials/10-creating-features.md +0 -203
  342. package/docs/tutorials/11-contentbase.md +0 -191
  343. package/docs/tutorials/12-assistants.md +0 -215
  344. package/docs/tutorials/13-introspection.md +0 -157
  345. package/docs/tutorials/14-type-system.md +0 -174
  346. package/docs/tutorials/15-project-patterns.md +0 -222
  347. package/docs/tutorials/16-google-features.md +0 -534
  348. package/docs/tutorials/17-tui-blocks.md +0 -530
  349. package/docs/tutorials/18-semantic-search.md +0 -334
  350. package/docs/tutorials/19-python-sessions.md +0 -401
  351. package/docs/tutorials/20-browser-esm.md +0 -234
  352. package/index.ts +0 -1
  353. package/src/agi/endpoints/ask.ts +0 -60
  354. package/src/agi/endpoints/conversations/[id].ts +0 -45
  355. package/src/agi/endpoints/conversations.ts +0 -31
  356. package/src/agi/endpoints/experts.ts +0 -37
  357. package/test/assistant-hooks.test.ts +0 -306
  358. package/test/assistant.test.ts +0 -81
  359. package/test/bus.test.ts +0 -134
  360. package/test/clients-servers.test.ts +0 -217
  361. package/test/command.test.ts +0 -267
  362. package/test/container-link.test.ts +0 -274
  363. package/test/conversation.test.ts +0 -220
  364. package/test/features.test.ts +0 -160
  365. package/test/fork-and-research.test.ts +0 -450
  366. package/test/integration.test.ts +0 -787
  367. package/test/interceptor-chain.test.ts +0 -61
  368. package/test/node-container.test.ts +0 -121
  369. package/test/python-session.test.ts +0 -105
  370. package/test/rate-limit.test.ts +0 -272
  371. package/test/semantic-search.test.ts +0 -550
  372. package/test/state.test.ts +0 -121
  373. package/test/vm-context.test.ts +0 -146
  374. package/test/vm-loadmodule.test.ts +0 -213
  375. package/test/websocket-ask.test.ts +0 -101
  376. package/test-integration/assistant.test.ts +0 -138
  377. package/test-integration/assistants-manager.test.ts +0 -113
  378. package/test-integration/claude-code.test.ts +0 -98
  379. package/test-integration/conversation-history.test.ts +0 -205
  380. package/test-integration/conversation.test.ts +0 -137
  381. package/test-integration/elevenlabs.test.ts +0 -55
  382. package/test-integration/google-services.test.ts +0 -80
  383. package/test-integration/helpers.ts +0 -89
  384. package/test-integration/memory.test.ts +0 -204
  385. package/test-integration/openai-codex.test.ts +0 -93
  386. package/test-integration/runpod.test.ts +0 -58
  387. package/test-integration/server-endpoints.test.ts +0 -97
  388. package/test-integration/telegram.test.ts +0 -46
@@ -1,787 +0,0 @@
1
- import { describe, it, expect, mock, beforeAll, afterAll } from 'bun:test'
2
- import { NodeContainer } from '../src/node/container'
3
- import { mkdirSync, writeFileSync, rmSync, mkdtempSync, realpathSync } from 'fs'
4
- import { join } from 'path'
5
- import { tmpdir } from 'os'
6
- import crypto from 'node:crypto'
7
-
8
- /**
9
- * Integration tests that exercise multiple node features working together.
10
- * These use real filesystem operations in temp directories to test actual behavior.
11
- */
12
-
13
- let testDir: string
14
-
15
- beforeAll(() => {
16
- // realpathSync resolves macOS /var -> /private/var symlinks so paths match `pwd` output
17
- testDir = realpathSync(mkdtempSync(join(tmpdir(), 'luca-integration-')))
18
-
19
- // seed a small project structure
20
- mkdirSync(join(testDir, 'src'), { recursive: true })
21
- mkdirSync(join(testDir, 'config'), { recursive: true })
22
- mkdirSync(join(testDir, 'data'), { recursive: true })
23
-
24
- writeFileSync(join(testDir, 'package.json'), JSON.stringify({
25
- name: 'test-project',
26
- version: '1.0.0',
27
- scripts: {
28
- hello: 'echo hello world',
29
- greet: 'echo greetings',
30
- },
31
- }, null, 2))
32
-
33
- writeFileSync(join(testDir, 'src', 'index.ts'), `
34
- import { something } from './utils'
35
- // TODO: implement main entry point
36
- export const main = () => console.log('hello')
37
- `)
38
-
39
- writeFileSync(join(testDir, 'src', 'utils.ts'), `
40
- // TODO: add more utils
41
- export const something = (x: number) => x * 2
42
- export const another = (s: string) => s.toUpperCase()
43
- `)
44
-
45
- writeFileSync(join(testDir, 'config', 'settings.yaml'), `
46
- database:
47
- host: localhost
48
- port: 5432
49
- name: testdb
50
- app:
51
- debug: true
52
- logLevel: info
53
- `)
54
-
55
- writeFileSync(join(testDir, 'config', 'extra.yaml'), `
56
- cache:
57
- ttl: 3600
58
- maxSize: 1000
59
- `)
60
-
61
- writeFileSync(join(testDir, 'data', 'items.json'), JSON.stringify({
62
- items: [
63
- { id: 1, name: 'alpha' },
64
- { id: 2, name: 'beta' },
65
- ],
66
- }, null, 2))
67
-
68
- writeFileSync(join(testDir, 'data', 'meta.json'), JSON.stringify({
69
- version: '2.0',
70
- author: 'luca',
71
- }, null, 2))
72
- })
73
-
74
- afterAll(() => {
75
- rmSync(testDir, { recursive: true, force: true })
76
- })
77
-
78
- // generate a valid 32-byte AES-256 key as base64
79
- function makeSecret() {
80
- return crypto.randomBytes(32).toString('base64')
81
- }
82
-
83
- describe('Integration: FS + Proc + OS working together', () => {
84
- it('uses fs to write a file, proc to read it back, os for temp path', async () => {
85
- const c = new NodeContainer({ cwd: testDir })
86
- const tempFile = join(c.os.tmpdir, `luca-test-${c.utils.uuid()}.txt`)
87
- c.fs.ensureFile(tempFile, 'integration test content')
88
- expect(c.fs.exists(tempFile)).toBe(true)
89
-
90
- const content = c.proc.exec(`cat "${tempFile}"`)
91
- expect(content).toBe('integration test content')
92
-
93
- await c.fs.rm(tempFile)
94
- expect(c.fs.exists(tempFile)).toBe(false)
95
- })
96
-
97
- it('proc.exec runs in the container cwd by default', () => {
98
- const c = new NodeContainer({ cwd: testDir })
99
- const result = c.proc.exec('pwd')
100
- expect(result).toBe(testDir)
101
- })
102
-
103
- it('fs.readdir lists seeded files', async () => {
104
- const c = new NodeContainer({ cwd: testDir })
105
- const entries = await c.fs.readdir(testDir)
106
- expect(entries).toContain('src')
107
- expect(entries).toContain('config')
108
- expect(entries).toContain('data')
109
- expect(entries).toContain('package.json')
110
- })
111
- })
112
-
113
- describe('Integration: FS + YAML parsing pipeline', () => {
114
- it('reads a yaml file from disk and parses it', () => {
115
- const c = new NodeContainer({ cwd: testDir })
116
- const yaml = c.feature('yaml')
117
- const raw = c.fs.readFile(join(testDir, 'config', 'settings.yaml'))
118
- const parsed = yaml.parse<{ database: { host: string; port: number; name: string }; app: { debug: boolean } }>(raw)
119
-
120
- expect(parsed.database.host).toBe('localhost')
121
- expect(parsed.database.port).toBe(5432)
122
- expect(parsed.database.name).toBe('testdb')
123
- expect(parsed.app.debug).toBe(true)
124
- })
125
-
126
- it('round-trips yaml: parse -> modify -> stringify -> parse', () => {
127
- const c = new NodeContainer({ cwd: testDir })
128
- const yaml = c.feature('yaml')
129
- const raw = c.fs.readFile(join(testDir, 'config', 'settings.yaml'))
130
- const data = yaml.parse<any>(raw)
131
-
132
- data.database.port = 3306
133
- data.database.name = 'production'
134
- data.app.debug = false
135
-
136
- const modified = yaml.stringify(data)
137
- const reparsed = yaml.parse<any>(modified)
138
-
139
- expect(reparsed.database.port).toBe(3306)
140
- expect(reparsed.database.name).toBe('production')
141
- expect(reparsed.app.debug).toBe(false)
142
- })
143
- })
144
-
145
- describe('Integration: FS + JSON data pipeline', () => {
146
- it('reads and parses json files from disk', () => {
147
- const c = new NodeContainer({ cwd: testDir })
148
- const items = c.fs.readJson(join(testDir, 'data', 'items.json'))
149
- expect(items.items).toHaveLength(2)
150
- expect(items.items[0].name).toBe('alpha')
151
- expect(items.items[1].name).toBe('beta')
152
- })
153
-
154
- it('writes json, reads it back, verifies roundtrip', async () => {
155
- const c = new NodeContainer({ cwd: testDir })
156
- const outPath = join(testDir, 'data', 'output.json')
157
- const payload = { generated: true, timestamp: Date.now(), values: [1, 2, 3] }
158
-
159
- await c.fs.writeFileAsync(outPath, JSON.stringify(payload, null, 2))
160
- expect(c.fs.exists(outPath)).toBe(true)
161
-
162
- const readBack = c.fs.readJson(outPath)
163
- expect(readBack.generated).toBe(true)
164
- expect(readBack.values).toEqual([1, 2, 3])
165
- })
166
- })
167
-
168
- describe('Integration: VM + container context', () => {
169
- it('vm can access container properties through context', async () => {
170
- const c = new NodeContainer({ cwd: testDir })
171
- const result = await c.vm.run('cwd', { cwd: c.cwd })
172
- expect(result).toBe(testDir)
173
- })
174
-
175
- it('vm.perform returns both result and context mutations', async () => {
176
- const c = new NodeContainer({ cwd: testDir })
177
- const { result, context } = await c.vm.perform('x = x + 1; x', { x: 10 })
178
- expect(result).toBe(11)
179
- expect(context.x).toBe(11)
180
- })
181
-
182
- it('vm can process data read from the filesystem', async () => {
183
- const c = new NodeContainer({ cwd: testDir })
184
- const raw = c.fs.readFile(join(testDir, 'data', 'items.json'))
185
- const result = await c.vm.run(
186
- 'JSON.parse(jsonStr).items.map(i => i.name).join(", ")',
187
- { jsonStr: raw }
188
- )
189
- expect(result).toBe('alpha, beta')
190
- })
191
-
192
- it('vm scripts persist context across calls via createContext', async () => {
193
- const c = new NodeContainer({ cwd: testDir })
194
- const ctx = c.vm.createContext({ counter: 0 })
195
-
196
- await c.vm.run('counter += 1', ctx)
197
- await c.vm.run('counter += 5', ctx)
198
- const final = await c.vm.run('counter', ctx)
199
-
200
- expect(final).toBe(6)
201
- })
202
- })
203
-
204
- describe('Integration: Grep + FS + Proc for code search', () => {
205
- it('grep finds TODO comments across project files', async () => {
206
- const c = new NodeContainer({ cwd: testDir })
207
-
208
- if (!c.grep.hasRipgrep) {
209
- const results = await c.grep.search({ pattern: 'TODO', cwd: testDir })
210
- expect(results.length).toBeGreaterThanOrEqual(0)
211
- return
212
- }
213
-
214
- const results = await c.grep.todos({ cwd: testDir })
215
- expect(results.length).toBeGreaterThanOrEqual(2)
216
-
217
- const files = results.map((r: any) => r.file)
218
- const hasIndex = files.some((f: string) => f.includes('index.ts'))
219
- const hasUtils = files.some((f: string) => f.includes('utils.ts'))
220
- expect(hasIndex).toBe(true)
221
- expect(hasUtils).toBe(true)
222
- })
223
-
224
- it('grep finds import statements', async () => {
225
- const c = new NodeContainer({ cwd: testDir })
226
-
227
- if (!c.grep.hasRipgrep) return
228
-
229
- const results = await c.grep.imports('./utils', { cwd: testDir })
230
- expect(results.length).toBeGreaterThanOrEqual(1)
231
- })
232
-
233
- it('grep finds function definitions', async () => {
234
- const c = new NodeContainer({ cwd: testDir })
235
-
236
- if (!c.grep.hasRipgrep) return
237
-
238
- const results = await c.grep.definitions('something', { cwd: testDir })
239
- expect(results.length).toBeGreaterThanOrEqual(1)
240
- })
241
-
242
- it('grep.count returns match counts', async () => {
243
- const c = new NodeContainer({ cwd: testDir })
244
-
245
- if (!c.grep.hasRipgrep) return
246
-
247
- const count = await c.grep.count('export', { cwd: testDir })
248
- expect(count).toBeGreaterThanOrEqual(3)
249
- })
250
- })
251
-
252
- describe('Integration: DiskCache for persistent storage', () => {
253
- it('disk cache stores and retrieves values', async () => {
254
- const c = new NodeContainer({ cwd: testDir })
255
- const cache = c.feature('diskCache', { enable: true, path: join(testDir, '.cache') })
256
-
257
- await cache.set('greeting', 'hello world')
258
- expect(await cache.has('greeting')).toBe(true)
259
- expect(await cache.get('greeting')).toBe('hello world')
260
- })
261
-
262
- it('disk cache stores and retrieves json objects', async () => {
263
- const c = new NodeContainer({ cwd: testDir })
264
- const cache = c.feature('diskCache', { enable: true, path: join(testDir, '.cache-json') })
265
-
266
- const data = { users: ['alice', 'bob'], count: 2 }
267
- await cache.set('users', JSON.stringify(data))
268
- const retrieved = JSON.parse((await cache.get('users'))!)
269
- expect(retrieved).toEqual(data)
270
- })
271
-
272
- it('disk cache keys() lists stored keys', async () => {
273
- const c = new NodeContainer({ cwd: testDir })
274
- const cache = c.feature('diskCache', { enable: true, path: join(testDir, '.cache-keys') })
275
-
276
- await cache.set('a', '1')
277
- await cache.set('b', '2')
278
- await cache.set('c', '3')
279
-
280
- const keys = await cache.keys()
281
- expect(keys).toContain('a')
282
- expect(keys).toContain('b')
283
- expect(keys).toContain('c')
284
- })
285
-
286
- it('disk cache rm() removes a key', async () => {
287
- const c = new NodeContainer({ cwd: testDir })
288
- const cache = c.feature('diskCache', { enable: true, path: join(testDir, '.cache-rm') })
289
-
290
- await cache.set('temp', 'value')
291
- expect(await cache.has('temp')).toBe(true)
292
- await cache.rm('temp')
293
- expect(await cache.has('temp')).toBe(false)
294
- })
295
- })
296
-
297
- describe('Integration: Vault encryption', () => {
298
- it('encrypts and decrypts a string payload', () => {
299
- const c = new NodeContainer({ cwd: testDir })
300
- const vault = c.feature('vault', { enable: true, secret: makeSecret() })
301
-
302
- const original = 'sensitive data here'
303
- const encrypted = vault.encrypt(original)
304
- expect(encrypted).not.toBe(original)
305
-
306
- const decrypted = vault.decrypt(encrypted)
307
- expect(decrypted).toBe(original)
308
- })
309
-
310
- it('encrypts json payloads correctly', () => {
311
- const c = new NodeContainer({ cwd: testDir })
312
- const vault = c.feature('vault', { enable: true, secret: makeSecret() })
313
-
314
- const data = { secret: 'classified', code: 42 }
315
- const encrypted = vault.encrypt(JSON.stringify(data))
316
- const decrypted = JSON.parse(vault.decrypt(encrypted))
317
- expect(decrypted).toEqual(data)
318
- })
319
-
320
- it('different secrets produce different ciphertexts', () => {
321
- const c = new NodeContainer({ cwd: testDir })
322
- const vault1 = c.feature('vault', { enable: true, secret: makeSecret() })
323
- const vault2 = c.feature('vault', { enable: true, secret: makeSecret() })
324
-
325
- const encrypted1 = vault1.encrypt('same message')
326
- const encrypted2 = vault2.encrypt('same message')
327
- expect(encrypted1).not.toBe(encrypted2)
328
- })
329
- })
330
-
331
- describe('Integration: DiskCache + Vault encrypted caching', () => {
332
- it('stores and retrieves encrypted values', async () => {
333
- const c = new NodeContainer({ cwd: testDir })
334
- const secret = makeSecret()
335
- const cache = c.feature('diskCache', {
336
- enable: true,
337
- path: join(testDir, '.cache-encrypted'),
338
- encrypt: true,
339
- secret: Buffer.from(secret, 'base64'),
340
- })
341
-
342
- await cache.set('secret-key', 'classified information')
343
- const retrieved = await cache.get('secret-key')
344
- expect(retrieved).toBe('classified information')
345
- })
346
- })
347
-
348
- describe('Integration: Git + FS + Proc (in actual luca repo)', () => {
349
- it('git detects the luca repo', () => {
350
- const c = new NodeContainer()
351
- expect(c.git.isRepo).toBe(true)
352
- })
353
-
354
- it('git.branch returns current branch name', () => {
355
- const c = new NodeContainer()
356
- const branch = c.git.branch
357
- expect(typeof branch).toBe('string')
358
- expect(branch.length).toBeGreaterThan(0)
359
- })
360
-
361
- it('git.sha returns a commit hash', () => {
362
- const c = new NodeContainer()
363
- const sha = c.git.sha
364
- expect(typeof sha).toBe('string')
365
- expect(sha).toMatch(/^[a-f0-9]+$/)
366
- })
367
-
368
- it('git.lsFiles returns tracked files', async () => {
369
- const c = new NodeContainer()
370
- const files = await c.git.lsFiles()
371
- expect(files.length).toBeGreaterThan(0)
372
- expect(files.some((f: string) => f.includes('package.json'))).toBe(true)
373
- expect(files.some((f: string) => f.includes('src/'))).toBe(true)
374
- })
375
-
376
- it('git.getLatestChanges returns recent commits', async () => {
377
- const c = new NodeContainer()
378
- const changes = await c.git.getLatestChanges(5)
379
- expect(changes.length).toBeGreaterThan(0)
380
- expect(changes.length).toBeLessThanOrEqual(5)
381
- })
382
-
383
- it('git.getChangeHistoryForFiles returns history for specific files', () => {
384
- const c = new NodeContainer()
385
- const history = c.git.getChangeHistoryForFiles('package.json')
386
- expect(Array.isArray(history)).toBe(true)
387
- expect(history.length).toBeGreaterThan(0)
388
- })
389
- })
390
-
391
- describe('Integration: Networking + VM for dynamic port allocation', () => {
392
- it('finds multiple distinct open ports', async () => {
393
- const c = new NodeContainer()
394
- const port1 = await c.networking.findOpenPort(40000)
395
- const port2 = await c.networking.findOpenPort(port1 + 1)
396
- expect(port1).not.toBe(port2)
397
- expect(port1).toBeGreaterThanOrEqual(40000)
398
- expect(port2).toBeGreaterThan(port1)
399
- })
400
-
401
- it('verifies found port is actually open', async () => {
402
- const c = new NodeContainer()
403
- const port = await c.networking.findOpenPort(50000)
404
- const isOpen = await c.networking.isPortOpen(port)
405
- expect(isOpen).toBe(true)
406
- })
407
-
408
- it('vm can use allocated port info to build a url', async () => {
409
- const c = new NodeContainer()
410
- const port = await c.networking.findOpenPort(45000)
411
- const url = await c.vm.run(
412
- '"http://localhost:" + port + "/api"',
413
- { port }
414
- )
415
- expect(url).toBe(`http://localhost:${port}/api`)
416
- })
417
- })
418
-
419
- describe('Integration: State + Bus + Events across features', () => {
420
- it('container state changes are observable', () => {
421
- const c = new NodeContainer({ cwd: testDir })
422
- const changes: any[] = []
423
- c.state.observe((changeType, key, value) => changes.push({ changeType, key, value }))
424
-
425
- c.state.set('started', true)
426
- expect(changes.length).toBeGreaterThan(0)
427
- expect(changes[0].key).toBe('started')
428
- expect(changes[0].value).toBe(true)
429
- expect(c.currentState.started).toBe(true)
430
- })
431
-
432
- it('features can communicate through the container bus', () => {
433
- const c = new NodeContainer({ cwd: testDir })
434
- const messages: string[] = []
435
-
436
- c.on('integration:message', (msg: string) => messages.push(msg))
437
- c.emit('integration:message', 'from fs')
438
- c.emit('integration:message', 'from proc')
439
- c.emit('integration:message', 'from vm')
440
-
441
- expect(messages).toEqual(['from fs', 'from proc', 'from vm'])
442
- })
443
-
444
- it('waitFor resolves on first matching emit', async () => {
445
- const c = new NodeContainer({ cwd: testDir })
446
- const promise = c.waitFor('integration:done')
447
-
448
- setTimeout(() => c.emit('integration:done', { success: true }), 10)
449
- const result = await promise
450
- expect(result).toEqual({ success: true })
451
- })
452
-
453
- it('feature-level state is independent per feature', () => {
454
- const c = new NodeContainer({ cwd: testDir })
455
- const yaml = c.feature('yaml')
456
-
457
- yaml.state.set('enabled', true)
458
- expect(yaml.state.get('enabled')).toBe(true)
459
- expect(c.vm.state.get('enabled')).toBe(true) // vm is also auto-enabled
460
- })
461
-
462
- it('multiple bus instances are independent', () => {
463
- const c = new NodeContainer({ cwd: testDir })
464
- const bus1 = c.bus()
465
- const bus2 = c.bus()
466
- const fn1 = mock()
467
- const fn2 = mock()
468
-
469
- bus1.on('test', fn1)
470
- bus2.on('test', fn2)
471
-
472
- bus1.emit('test', 'only-bus1')
473
- expect(fn1).toHaveBeenCalledWith('only-bus1')
474
- expect(fn2).not.toHaveBeenCalled()
475
- })
476
- })
477
-
478
- describe('Integration: Container utilities across features', () => {
479
- it('utils.hashObject produces consistent hashes for feature configs', () => {
480
- const c = new NodeContainer({ cwd: testDir })
481
- const config1 = { host: 'localhost', port: 5432 }
482
- const config2 = { host: 'localhost', port: 5432 }
483
- const config3 = { host: 'localhost', port: 3306 }
484
-
485
- expect(c.utils.hashObject(config1)).toBe(c.utils.hashObject(config2))
486
- expect(c.utils.hashObject(config1)).not.toBe(c.utils.hashObject(config3))
487
- })
488
-
489
- it('utils.stringUtils transforms feature names', () => {
490
- const c = new NodeContainer()
491
- const { camelCase, kebabCase } = c.utils.stringUtils
492
- expect(camelCase('disk-cache')).toBe('diskCache')
493
- expect(kebabCase('fileManager')).toBe('file-manager')
494
- })
495
-
496
- it('paths resolve relative to container cwd', () => {
497
- const c = new NodeContainer({ cwd: testDir })
498
- const resolved = c.paths.resolve('src', 'index.ts')
499
- expect(resolved).toBe(join(testDir, 'src', 'index.ts'))
500
- expect(c.fs.exists(resolved)).toBe(true)
501
- })
502
-
503
- it('utils.uuid generates unique ids each call', () => {
504
- const c = new NodeContainer()
505
- const ids = new Set(Array.from({ length: 100 }, () => c.utils.uuid()))
506
- expect(ids.size).toBe(100)
507
- })
508
- })
509
-
510
- describe('Integration: FS walk + Grep for project analysis', () => {
511
- it('walks the test project and finds expected file types', async () => {
512
- const c = new NodeContainer({ cwd: testDir })
513
- const result = await c.fs.walkAsync(testDir, { })
514
- const filePaths = result.files || []
515
-
516
- const hasTs = filePaths.some((p: string) => p.endsWith('.ts'))
517
- const hasYaml = filePaths.some((p: string) => p.endsWith('.yaml'))
518
- const hasJson = filePaths.some((p: string) => p.endsWith('.json'))
519
-
520
- expect(hasTs).toBe(true)
521
- expect(hasYaml).toBe(true)
522
- expect(hasJson).toBe(true)
523
- })
524
-
525
- it('grep filesContaining finds ts files with exports', async () => {
526
- const c = new NodeContainer({ cwd: testDir })
527
-
528
- if (!c.grep.hasRipgrep) return
529
-
530
- const files = await c.grep.filesContaining('export', { cwd: testDir, include: '*.ts' })
531
- expect(files.length).toBeGreaterThanOrEqual(2)
532
- })
533
- })
534
-
535
- describe('Integration: Multi-feature data processing pipeline', () => {
536
- it('reads yaml config, transforms with vm, caches result', async () => {
537
- const c = new NodeContainer({ cwd: testDir })
538
- const yaml = c.feature('yaml')
539
- const cache = c.feature('diskCache', { enable: true, path: join(testDir, '.cache-pipeline') })
540
-
541
- // step 1: read yaml config from disk
542
- const raw = c.fs.readFile(join(testDir, 'config', 'settings.yaml'))
543
- const config = yaml.parse<any>(raw)
544
-
545
- // step 2: transform with vm (string concat instead of template literal to avoid vm backtick issues)
546
- const connectionString = await c.vm.run(
547
- '"postgres://" + db.host + ":" + db.port + "/" + db.name',
548
- { db: config.database }
549
- )
550
- expect(connectionString).toBe('postgres://localhost:5432/testdb')
551
-
552
- // step 3: cache the result
553
- await cache.set('connectionString', connectionString)
554
- expect(await cache.get('connectionString')).toBe('postgres://localhost:5432/testdb')
555
- })
556
-
557
- it('reads json data, processes with vm, writes output', async () => {
558
- const c = new NodeContainer({ cwd: testDir })
559
-
560
- // step 1: read json
561
- const items = c.fs.readJson(join(testDir, 'data', 'items.json'))
562
-
563
- // step 2: transform with vm
564
- const summary = await c.vm.run(
565
- 'items.map(function(i) { return i.id + ":" + i.name }).join("|")',
566
- { items: items.items }
567
- )
568
- expect(summary).toBe('1:alpha|2:beta')
569
-
570
- // step 3: write processed output
571
- const outPath = join(testDir, 'data', 'summary.txt')
572
- await c.fs.writeFileAsync(outPath, summary)
573
- expect(c.fs.readFile(outPath)).toBe(summary)
574
- })
575
-
576
- it('os info + proc exec + fs write: system report', async () => {
577
- const c = new NodeContainer({ cwd: testDir })
578
- const report = [
579
- `platform: ${c.os.platform}`,
580
- `arch: ${c.os.arch}`,
581
- `cpus: ${c.os.cpuCount}`,
582
- `hostname: ${c.os.hostname}`,
583
- `cwd: ${c.cwd}`,
584
- ].join('\n')
585
-
586
- const reportPath = join(testDir, 'system-report.txt')
587
- await c.fs.writeFileAsync(reportPath, report)
588
-
589
- const readBack = c.fs.readFile(reportPath)
590
- expect(readBack).toContain(`platform: ${process.platform}`)
591
- expect(readBack).toContain(`arch: ${process.arch}`)
592
- expect(readBack).toContain(`cwd: ${testDir}`)
593
- })
594
- })
595
-
596
- describe('Integration: Proc + FS for script execution', () => {
597
- it('proc.exec runs shell commands in the test dir', () => {
598
- const c = new NodeContainer({ cwd: testDir })
599
- const result = c.proc.exec('ls src', { cwd: testDir })
600
- expect(result).toContain('index.ts')
601
- expect(result).toContain('utils.ts')
602
- })
603
-
604
- it('proc.execAndCapture returns structured output', async () => {
605
- const c = new NodeContainer({ cwd: testDir })
606
- const result = await c.proc.execAndCapture('echo hello from proc', { cwd: testDir })
607
- expect(result.stdout.trim()).toBe('hello from proc')
608
- expect(result.exitCode).toBe(0)
609
- })
610
-
611
- it('proc.exec result can be written to file by fs', async () => {
612
- const c = new NodeContainer({ cwd: testDir })
613
- const listing = c.proc.exec('ls -la src', { cwd: testDir })
614
- const outPath = join(testDir, 'listing.txt')
615
- await c.fs.writeFileAsync(outPath, listing)
616
- expect(c.fs.exists(outPath)).toBe(true)
617
- expect(c.fs.readFile(outPath)).toContain('index.ts')
618
- })
619
- })
620
-
621
- describe('Integration: Transpiler + FS for code transformation', () => {
622
- it('transforms typescript to javascript', async () => {
623
- const c = new NodeContainer({ cwd: testDir })
624
- const transpiler = c.feature('transpiler', { enable: true })
625
-
626
- const tsCode = `
627
- const greet = (name: string): string => 'Hello, ' + name + '!'
628
- export default greet
629
- `
630
-
631
- const result = await transpiler.transform(tsCode, { loader: 'ts' })
632
- expect(result.code).toContain('greet')
633
- expect(result.code).not.toContain(': string')
634
- })
635
-
636
- it('reads ts file from disk, transforms it, writes js output', async () => {
637
- const c = new NodeContainer({ cwd: testDir })
638
- const transpiler = c.feature('transpiler', { enable: true })
639
-
640
- const tsSource = c.fs.readFile(join(testDir, 'src', 'utils.ts'))
641
- const result = await transpiler.transform(tsSource, { loader: 'ts' })
642
-
643
- const outPath = join(testDir, 'src', 'utils.js')
644
- await c.fs.writeFileAsync(outPath, result.code)
645
-
646
- const jsContent = c.fs.readFile(outPath)
647
- expect(jsContent).toContain('something')
648
- expect(jsContent).toContain('another')
649
- expect(jsContent).not.toContain(': number')
650
- expect(jsContent).not.toContain(': string')
651
- })
652
- })
653
-
654
- describe('Integration: FS findUp + paths resolution', () => {
655
- it('findUp locates package.json from nested dir', () => {
656
- const c = new NodeContainer({ cwd: join(testDir, 'src') })
657
- const found = c.fs.findUp('package.json', { cwd: join(testDir, 'src') })
658
- expect(found).toBeDefined()
659
- expect(found).toContain('package.json')
660
- })
661
-
662
- it('paths work together with fs for relative file access', () => {
663
- const c = new NodeContainer({ cwd: testDir })
664
- const configPath = c.paths.resolve('config', 'settings.yaml')
665
- expect(c.fs.exists(configPath)).toBe(true)
666
-
667
- const content = c.fs.readFile(configPath)
668
- expect(content).toContain('database')
669
- })
670
- })
671
-
672
- describe('Integration: Container lifecycle and feature coordination', () => {
673
- it('start() makes all auto-enabled features available', async () => {
674
- const c = new NodeContainer({ cwd: testDir })
675
- await c.start()
676
- expect(c.currentState.started).toBe(true)
677
-
678
- // all auto-enabled features should be accessible
679
- expect(c.fs).toBeDefined()
680
- expect(c.git).toBeDefined()
681
- expect(c.proc).toBeDefined()
682
- expect(c.os).toBeDefined()
683
- expect(c.networking).toBeDefined()
684
- expect(c.ui).toBeDefined()
685
- expect(c.vm).toBeDefined()
686
- expect(c.grep).toBeDefined()
687
- })
688
-
689
- it('features enabled via constructor options are available', () => {
690
- const c = new NodeContainer({
691
- cwd: testDir,
692
- enable: ['yaml', 'diskCache', 'vault'],
693
- })
694
-
695
- expect(c.features.available).toContain('yaml')
696
- expect(c.features.available).toContain('diskCache')
697
- expect(c.features.available).toContain('vault')
698
- })
699
-
700
- it('container exposes manifest from package.json', () => {
701
- // the luca project itself has a manifest
702
- const lucaContainer = new NodeContainer()
703
- expect(lucaContainer.manifest).toBeDefined()
704
- expect(lucaContainer.manifest.name).toBeDefined()
705
- })
706
-
707
- it('features share the same container reference', () => {
708
- const c = new NodeContainer({ cwd: testDir })
709
- const yaml = c.feature('yaml')
710
- const cache = c.feature('diskCache', { enable: true, path: join(testDir, '.cache-shared') })
711
-
712
- expect(yaml.container.uuid).toBe(c.uuid)
713
- expect(cache.container.uuid).toBe(c.uuid)
714
- expect(yaml.container.uuid).toBe(cache.container.uuid)
715
- })
716
- })
717
-
718
- describe('Integration: UI feature formatting', () => {
719
- it('ui.endent strips indentation from template literals', () => {
720
- const c = new NodeContainer()
721
- const result = c.ui.endent`
722
- hello
723
- world
724
- `
725
- expect(result).toBe('hello\n world')
726
- })
727
-
728
- it('ui.colors produces styled strings', () => {
729
- const c = new NodeContainer()
730
- const styled = c.ui.colors.red('error message')
731
- expect(typeof styled).toBe('string')
732
- expect(styled.length).toBeGreaterThanOrEqual('error message'.length)
733
- })
734
- })
735
-
736
- describe('Integration: Multiple containers are fully isolated', () => {
737
- it('state changes in one container do not affect another', () => {
738
- const c1 = new NodeContainer({ cwd: testDir })
739
- const c2 = new NodeContainer({ cwd: testDir })
740
-
741
- c1.state.set('started', true)
742
- expect(c1.currentState.started).toBe(true)
743
- expect(c2.currentState.started).toBe(false)
744
- })
745
-
746
- it('events in one container do not leak to another', () => {
747
- const c1 = new NodeContainer({ cwd: testDir })
748
- const c2 = new NodeContainer({ cwd: testDir })
749
- const fn1 = mock()
750
- const fn2 = mock()
751
-
752
- c1.on('isolated', fn1)
753
- c2.on('isolated', fn2)
754
-
755
- c1.emit('isolated', 'only-c1')
756
- expect(fn1).toHaveBeenCalledWith('only-c1')
757
- expect(fn2).not.toHaveBeenCalled()
758
- })
759
-
760
- it('feature instances are unique per container', () => {
761
- const c1 = new NodeContainer({ cwd: testDir })
762
- const c2 = new NodeContainer({ cwd: testDir })
763
- const y1 = c1.feature('yaml')
764
- const y2 = c2.feature('yaml')
765
- expect(y1.uuid).not.toBe(y2.uuid)
766
- })
767
- })
768
-
769
- describe('Integration: Zod schema access at runtime', () => {
770
- it('container provides zod instance', () => {
771
- const c = new NodeContainer()
772
- expect(c.z).toBeDefined()
773
- expect(typeof c.z.string).toBe('function')
774
- expect(typeof c.z.object).toBe('function')
775
- })
776
-
777
- it('newState validates through zod schemas', () => {
778
- const c = new NodeContainer()
779
- const state = c.newState({ count: 0, name: 'test' })
780
-
781
- state.set('count', 42)
782
- state.set('name', 'updated')
783
-
784
- expect(state.get('count')).toBe(42)
785
- expect(state.get('name')).toBe('updated')
786
- })
787
- })