luca 3.0.0 → 3.0.2

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 (372) 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 +220 -322
  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/try-all-challenges.ts +3 -3
  18. package/commands/try-challenge.ts +3 -3
  19. package/dist/agi/container.server.d.ts +2 -2
  20. package/dist/agi/features/assistant.d.ts +2 -2
  21. package/dist/agi/features/assistants-manager.d.ts +1 -1
  22. package/dist/agi/features/autonomous-assistant.d.ts +1 -1
  23. package/dist/agi/features/browser-use.d.ts +1 -1
  24. package/dist/agi/features/claude-code.d.ts +1 -1
  25. package/dist/agi/features/conversation-history.d.ts +2 -2
  26. package/dist/agi/features/conversation.d.ts +1 -1
  27. package/dist/agi/features/docs-reader.d.ts +1 -1
  28. package/dist/agi/features/file-tools.d.ts +1 -1
  29. package/dist/agi/features/luca-coder.d.ts +1 -1
  30. package/dist/agi/features/openai-codex.d.ts +1 -1
  31. package/dist/agi/features/skills-library.d.ts +1 -1
  32. package/dist/clients/civitai/index.d.ts +4 -4
  33. package/dist/clients/client-template.d.ts +4 -4
  34. package/dist/clients/comfyui/index.d.ts +2 -2
  35. package/dist/clients/elevenlabs/index.d.ts +2 -2
  36. package/dist/clients/openai/index.d.ts +2 -2
  37. package/dist/clients/supabase/index.d.ts +3 -3
  38. package/dist/command.d.ts +1 -1
  39. package/dist/node/container.d.ts +1 -1
  40. package/dist/node/features/helpers.d.ts +3 -3
  41. package/dist/node/features/semantic-search.d.ts +1 -1
  42. package/dist/node/features/vm.d.ts +3 -3
  43. package/dist/node.d.ts +1 -1
  44. package/dist/scaffolds/generated.d.ts +1 -1
  45. package/dist/selector.d.ts +1 -1
  46. package/index.html +217 -190
  47. package/luca.console.ts +1 -1
  48. package/package.json +2 -2
  49. package/public/index.html +217 -190
  50. package/public/slides-ai-native.html +1 -1
  51. package/public/slides-intro.html +2 -2
  52. package/scripts/examples/ask-luca-expert.ts +1 -1
  53. package/scripts/examples/assistant-questions.ts +1 -1
  54. package/scripts/examples/excalidraw-expert.ts +1 -1
  55. package/scripts/examples/file-manager.ts +1 -1
  56. package/scripts/examples/ideas.ts +1 -1
  57. package/scripts/examples/interactive-chat.ts +1 -1
  58. package/scripts/examples/opening-a-web-browser.ts +1 -1
  59. package/scripts/examples/telegram-bot.ts +1 -1
  60. package/scripts/examples/using-assistant-with-mcp.ts +1 -1
  61. package/scripts/examples/using-claude-code.ts +1 -1
  62. package/scripts/examples/using-contentdb.ts +2 -2
  63. package/scripts/examples/using-conversations.ts +1 -1
  64. package/scripts/examples/using-disk-cache.ts +1 -1
  65. package/scripts/examples/using-docker-shell.ts +1 -1
  66. package/scripts/examples/using-elevenlabs.ts +1 -1
  67. package/scripts/examples/using-google-calendar.ts +1 -1
  68. package/scripts/examples/using-google-docs.ts +1 -1
  69. package/scripts/examples/using-google-drive.ts +1 -1
  70. package/scripts/examples/using-google-sheets.ts +1 -1
  71. package/scripts/examples/using-nlp.ts +1 -1
  72. package/scripts/examples/using-ollama.ts +1 -1
  73. package/scripts/examples/using-postgres.ts +1 -1
  74. package/scripts/examples/using-runpod.ts +1 -1
  75. package/scripts/examples/using-tts.ts +1 -1
  76. package/scripts/scaffold.ts +5 -5
  77. package/scripts/scratch.ts +1 -1
  78. package/scripts/test-assistant-hooks.ts +1 -1
  79. package/scripts/test-docs-reader.ts +1 -1
  80. package/src/agi/container.server.ts +6 -2
  81. package/src/agi/features/agent-memory.ts +25 -25
  82. package/src/agi/features/assistant.ts +34 -5
  83. package/src/agi/features/assistants-manager.ts +122 -6
  84. package/src/agi/features/autonomous-assistant.ts +1 -1
  85. package/src/agi/features/browser-use.ts +20 -1
  86. package/src/agi/features/claude-code.ts +51 -5
  87. package/src/agi/features/coding-tools.ts +1 -1
  88. package/src/agi/features/conversation-history.ts +181 -4
  89. package/src/agi/features/conversation.ts +186 -15
  90. package/src/agi/features/docs-reader.ts +2 -2
  91. package/src/agi/features/file-tools.ts +49 -2
  92. package/src/agi/features/luca-coder.ts +7 -5
  93. package/src/agi/features/mcp-bridge.ts +532 -0
  94. package/src/agi/features/openai-codex.ts +2 -2
  95. package/src/agi/features/skills-library.ts +131 -52
  96. package/src/agi/lib/token-counter.ts +80 -0
  97. package/src/bootstrap/generated.ts +56 -57
  98. package/src/browser.ts +1 -1
  99. package/src/cli/build-info.ts +2 -2
  100. package/src/cli/cli.ts +2 -2
  101. package/src/clients/civitai/index.ts +5 -5
  102. package/src/clients/client-template.ts +4 -4
  103. package/src/clients/comfyui/index.ts +4 -4
  104. package/src/clients/elevenlabs/index.ts +4 -4
  105. package/src/clients/openai/index.ts +7 -7
  106. package/src/clients/supabase/index.ts +4 -4
  107. package/src/clients/voicebox/index.ts +4 -4
  108. package/src/command.ts +2 -1
  109. package/src/commands/chat.ts +1 -0
  110. package/src/commands/eval.ts +2 -56
  111. package/src/commands/introspect.ts +1 -1
  112. package/src/commands/prompt.ts +41 -9
  113. package/src/container-describer.ts +8 -1
  114. package/src/container.ts +13 -0
  115. package/src/entity.ts +2 -2
  116. package/src/helper.ts +1 -1
  117. package/src/introspection/generated.agi.ts +28563 -27571
  118. package/src/introspection/generated.node.ts +20281 -20194
  119. package/src/introspection/generated.web.ts +605 -584
  120. package/src/introspection/scan.ts +11 -6
  121. package/src/node/container.ts +1 -1
  122. package/src/node/features/content-db.ts +39 -2
  123. package/src/node/features/display-result.ts +57 -0
  124. package/src/node/features/helpers.ts +42 -15
  125. package/src/node/features/python.ts +25 -19
  126. package/src/node/features/repl.ts +1 -1
  127. package/src/node/features/secure-shell.ts +11 -17
  128. package/src/node/features/semantic-search.ts +2 -2
  129. package/src/node/features/transpiler.ts +2 -3
  130. package/src/node/features/ui.ts +5 -0
  131. package/src/node/features/vm.ts +3 -3
  132. package/src/node.ts +3 -3
  133. package/src/python/generated.ts +0 -1
  134. package/src/scaffolds/generated.ts +82 -83
  135. package/src/selector.ts +1 -1
  136. package/src/servers/express.ts +1 -1
  137. package/src/web/features/helpers.ts +22 -0
  138. package/tsconfig.json +12 -12
  139. package/docs/CLI.md +0 -335
  140. package/docs/CNAME +0 -1
  141. package/docs/README.md +0 -60
  142. package/docs/TABLE-OF-CONTENTS.md +0 -183
  143. package/docs/apis/clients/elevenlabs.md +0 -308
  144. package/docs/apis/clients/graph.md +0 -107
  145. package/docs/apis/clients/openai.md +0 -429
  146. package/docs/apis/clients/rest.md +0 -161
  147. package/docs/apis/clients/websocket.md +0 -174
  148. package/docs/apis/features/agi/assistant.md +0 -625
  149. package/docs/apis/features/agi/assistants-manager.md +0 -282
  150. package/docs/apis/features/agi/auto-assistant.md +0 -279
  151. package/docs/apis/features/agi/browser-use.md +0 -802
  152. package/docs/apis/features/agi/claude-code.md +0 -884
  153. package/docs/apis/features/agi/conversation-history.md +0 -364
  154. package/docs/apis/features/agi/conversation.md +0 -548
  155. package/docs/apis/features/agi/docs-reader.md +0 -99
  156. package/docs/apis/features/agi/file-tools.md +0 -163
  157. package/docs/apis/features/agi/luca-coder.md +0 -407
  158. package/docs/apis/features/agi/openai-codex.md +0 -396
  159. package/docs/apis/features/agi/openapi.md +0 -138
  160. package/docs/apis/features/agi/semantic-search.md +0 -387
  161. package/docs/apis/features/agi/skills-library.md +0 -239
  162. package/docs/apis/features/node/container-link.md +0 -192
  163. package/docs/apis/features/node/content-db.md +0 -450
  164. package/docs/apis/features/node/disk-cache.md +0 -379
  165. package/docs/apis/features/node/dns.md +0 -652
  166. package/docs/apis/features/node/docker.md +0 -706
  167. package/docs/apis/features/node/downloader.md +0 -81
  168. package/docs/apis/features/node/esbuild.md +0 -60
  169. package/docs/apis/features/node/file-manager.md +0 -191
  170. package/docs/apis/features/node/fs.md +0 -1217
  171. package/docs/apis/features/node/git.md +0 -371
  172. package/docs/apis/features/node/google-auth.md +0 -193
  173. package/docs/apis/features/node/google-calendar.md +0 -202
  174. package/docs/apis/features/node/google-docs.md +0 -173
  175. package/docs/apis/features/node/google-drive.md +0 -246
  176. package/docs/apis/features/node/google-mail.md +0 -214
  177. package/docs/apis/features/node/google-sheets.md +0 -194
  178. package/docs/apis/features/node/grep.md +0 -292
  179. package/docs/apis/features/node/helpers.md +0 -164
  180. package/docs/apis/features/node/ink.md +0 -334
  181. package/docs/apis/features/node/ipc-socket.md +0 -249
  182. package/docs/apis/features/node/json-tree.md +0 -86
  183. package/docs/apis/features/node/networking.md +0 -316
  184. package/docs/apis/features/node/nlp.md +0 -133
  185. package/docs/apis/features/node/opener.md +0 -97
  186. package/docs/apis/features/node/os.md +0 -146
  187. package/docs/apis/features/node/package-finder.md +0 -392
  188. package/docs/apis/features/node/postgres.md +0 -234
  189. package/docs/apis/features/node/proc.md +0 -399
  190. package/docs/apis/features/node/process-manager.md +0 -305
  191. package/docs/apis/features/node/python.md +0 -604
  192. package/docs/apis/features/node/redis.md +0 -380
  193. package/docs/apis/features/node/repl.md +0 -88
  194. package/docs/apis/features/node/runpod.md +0 -674
  195. package/docs/apis/features/node/secure-shell.md +0 -176
  196. package/docs/apis/features/node/semantic-search.md +0 -408
  197. package/docs/apis/features/node/sqlite.md +0 -233
  198. package/docs/apis/features/node/telegram.md +0 -279
  199. package/docs/apis/features/node/transpiler.md +0 -74
  200. package/docs/apis/features/node/tts.md +0 -133
  201. package/docs/apis/features/node/ui.md +0 -701
  202. package/docs/apis/features/node/vault.md +0 -59
  203. package/docs/apis/features/node/vm.md +0 -75
  204. package/docs/apis/features/node/yaml-tree.md +0 -85
  205. package/docs/apis/features/node/yaml.md +0 -176
  206. package/docs/apis/features/web/asset-loader.md +0 -59
  207. package/docs/apis/features/web/container-link.md +0 -192
  208. package/docs/apis/features/web/esbuild.md +0 -54
  209. package/docs/apis/features/web/helpers.md +0 -164
  210. package/docs/apis/features/web/network.md +0 -44
  211. package/docs/apis/features/web/speech.md +0 -69
  212. package/docs/apis/features/web/vault.md +0 -59
  213. package/docs/apis/features/web/vm.md +0 -75
  214. package/docs/apis/features/web/voice.md +0 -84
  215. package/docs/apis/servers/express.md +0 -171
  216. package/docs/apis/servers/mcp.md +0 -238
  217. package/docs/apis/servers/websocket.md +0 -170
  218. package/docs/bootstrap/CLAUDE.md +0 -101
  219. package/docs/bootstrap/SKILL.md +0 -341
  220. package/docs/bootstrap/templates/about-command.ts +0 -41
  221. package/docs/bootstrap/templates/docs-models.ts +0 -22
  222. package/docs/bootstrap/templates/docs-readme.md +0 -43
  223. package/docs/bootstrap/templates/example-feature.ts +0 -53
  224. package/docs/bootstrap/templates/health-endpoint.ts +0 -15
  225. package/docs/bootstrap/templates/luca-cli.ts +0 -30
  226. package/docs/bootstrap/templates/runme.md +0 -54
  227. package/docs/challenges/caching-proxy.md +0 -16
  228. package/docs/challenges/content-db-round-trip.md +0 -14
  229. package/docs/challenges/custom-command.md +0 -9
  230. package/docs/challenges/file-watcher-pipeline.md +0 -11
  231. package/docs/challenges/grep-audit-report.md +0 -15
  232. package/docs/challenges/multi-feature-dashboard.md +0 -14
  233. package/docs/challenges/process-orchestrator.md +0 -17
  234. package/docs/challenges/rest-api-server-with-client.md +0 -12
  235. package/docs/challenges/script-runner-with-vm.md +0 -11
  236. package/docs/challenges/simple-rest-api.md +0 -15
  237. package/docs/challenges/websocket-serve-and-client.md +0 -11
  238. package/docs/challenges/yaml-config-system.md +0 -14
  239. package/docs/command-system-overhaul.md +0 -94
  240. package/docs/documentation-audit.md +0 -134
  241. package/docs/examples/assistant/CORE.md +0 -18
  242. package/docs/examples/assistant/hooks.ts +0 -3
  243. package/docs/examples/assistant/tools.ts +0 -10
  244. package/docs/examples/assistant-hooks-reference.ts +0 -171
  245. package/docs/examples/assistant-with-process-manager.md +0 -84
  246. package/docs/examples/content-db.md +0 -77
  247. package/docs/examples/disk-cache.md +0 -83
  248. package/docs/examples/docker.md +0 -101
  249. package/docs/examples/downloader.md +0 -70
  250. package/docs/examples/entity.md +0 -124
  251. package/docs/examples/esbuild.md +0 -80
  252. package/docs/examples/feature-as-tool-provider.md +0 -143
  253. package/docs/examples/file-manager.md +0 -82
  254. package/docs/examples/fs.md +0 -83
  255. package/docs/examples/git.md +0 -85
  256. package/docs/examples/google-auth.md +0 -88
  257. package/docs/examples/google-calendar.md +0 -94
  258. package/docs/examples/google-docs.md +0 -82
  259. package/docs/examples/google-drive.md +0 -96
  260. package/docs/examples/google-sheets.md +0 -95
  261. package/docs/examples/grep.md +0 -85
  262. package/docs/examples/ink-blocks.md +0 -75
  263. package/docs/examples/ink-renderer.md +0 -41
  264. package/docs/examples/ink.md +0 -103
  265. package/docs/examples/ipc-socket.md +0 -103
  266. package/docs/examples/json-tree.md +0 -91
  267. package/docs/examples/networking.md +0 -58
  268. package/docs/examples/nlp.md +0 -91
  269. package/docs/examples/opener.md +0 -78
  270. package/docs/examples/os.md +0 -72
  271. package/docs/examples/package-finder.md +0 -89
  272. package/docs/examples/postgres.md +0 -91
  273. package/docs/examples/proc.md +0 -81
  274. package/docs/examples/process-manager.md +0 -79
  275. package/docs/examples/python.md +0 -132
  276. package/docs/examples/repl.md +0 -93
  277. package/docs/examples/runpod.md +0 -119
  278. package/docs/examples/secure-shell.md +0 -92
  279. package/docs/examples/sqlite.md +0 -86
  280. package/docs/examples/structured-output-with-assistants.md +0 -144
  281. package/docs/examples/telegram.md +0 -77
  282. package/docs/examples/tts.md +0 -86
  283. package/docs/examples/ui.md +0 -80
  284. package/docs/examples/vault.md +0 -70
  285. package/docs/examples/vm.md +0 -86
  286. package/docs/examples/websocket-ask-and-reply-example.md +0 -128
  287. package/docs/examples/yaml-tree.md +0 -93
  288. package/docs/examples/yaml.md +0 -104
  289. package/docs/ideas/assistant-factory-pattern.md +0 -142
  290. package/docs/in-memory-fs.md +0 -4
  291. package/docs/introspection-audit.md +0 -49
  292. package/docs/introspection.md +0 -164
  293. package/docs/mcp/readme.md +0 -162
  294. package/docs/models.ts +0 -41
  295. package/docs/philosophy.md +0 -86
  296. package/docs/principles.md +0 -7
  297. package/docs/prompts/audit-codebase-for-failures-to-use-the-container.md +0 -34
  298. package/docs/prompts/check-for-undocumented-features.md +0 -27
  299. package/docs/prompts/mcp-test-easy-command.md +0 -27
  300. package/docs/scaffolds/client.md +0 -149
  301. package/docs/scaffolds/command.md +0 -120
  302. package/docs/scaffolds/endpoint.md +0 -171
  303. package/docs/scaffolds/feature.md +0 -158
  304. package/docs/scaffolds/selector.md +0 -91
  305. package/docs/scaffolds/server.md +0 -196
  306. package/docs/selectors.md +0 -115
  307. package/docs/sessions/custom-command/attempt-log-2.md +0 -195
  308. package/docs/sessions/file-watcher-pipeline/attempt-log-1.md +0 -728
  309. package/docs/sessions/file-watcher-pipeline/attempt-log-2.md +0 -555
  310. package/docs/sessions/grep-audit-report/attempt-log-1.md +0 -289
  311. package/docs/sessions/multi-feature-dashboard/attempt-log-2.md +0 -679
  312. package/docs/sessions/rest-api-server-with-client/attempt-log-1.md +0 -1
  313. package/docs/sessions/rest-api-server-with-client/attempt-log-3.md +0 -920
  314. package/docs/sessions/simple-rest-api/attempt-log-1.md +0 -593
  315. package/docs/sessions/websocket-serve-and-client/attempt-log-2.md +0 -995
  316. package/docs/tutorials/00-bootstrap.md +0 -166
  317. package/docs/tutorials/01-getting-started.md +0 -106
  318. package/docs/tutorials/02-container.md +0 -210
  319. package/docs/tutorials/03-scripts.md +0 -194
  320. package/docs/tutorials/04-features-overview.md +0 -196
  321. package/docs/tutorials/05-state-and-events.md +0 -171
  322. package/docs/tutorials/06-servers.md +0 -157
  323. package/docs/tutorials/07-endpoints.md +0 -198
  324. package/docs/tutorials/08-commands.md +0 -252
  325. package/docs/tutorials/09-clients.md +0 -162
  326. package/docs/tutorials/10-creating-features.md +0 -203
  327. package/docs/tutorials/11-contentbase.md +0 -191
  328. package/docs/tutorials/12-assistants.md +0 -215
  329. package/docs/tutorials/13-introspection.md +0 -157
  330. package/docs/tutorials/14-type-system.md +0 -174
  331. package/docs/tutorials/15-project-patterns.md +0 -222
  332. package/docs/tutorials/16-google-features.md +0 -534
  333. package/docs/tutorials/17-tui-blocks.md +0 -530
  334. package/docs/tutorials/18-semantic-search.md +0 -334
  335. package/docs/tutorials/19-python-sessions.md +0 -401
  336. package/docs/tutorials/20-browser-esm.md +0 -234
  337. package/src/agi/endpoints/ask.ts +0 -60
  338. package/src/agi/endpoints/conversations/[id].ts +0 -45
  339. package/src/agi/endpoints/conversations.ts +0 -31
  340. package/src/agi/endpoints/experts.ts +0 -37
  341. package/test/assistant-hooks.test.ts +0 -306
  342. package/test/assistant.test.ts +0 -81
  343. package/test/bus.test.ts +0 -134
  344. package/test/clients-servers.test.ts +0 -217
  345. package/test/command.test.ts +0 -267
  346. package/test/container-link.test.ts +0 -274
  347. package/test/conversation.test.ts +0 -220
  348. package/test/features.test.ts +0 -160
  349. package/test/fork-and-research.test.ts +0 -450
  350. package/test/integration.test.ts +0 -787
  351. package/test/interceptor-chain.test.ts +0 -61
  352. package/test/node-container.test.ts +0 -121
  353. package/test/python-session.test.ts +0 -105
  354. package/test/rate-limit.test.ts +0 -272
  355. package/test/semantic-search.test.ts +0 -550
  356. package/test/state.test.ts +0 -121
  357. package/test/vm-context.test.ts +0 -146
  358. package/test/vm-loadmodule.test.ts +0 -213
  359. package/test/websocket-ask.test.ts +0 -101
  360. package/test-integration/assistant.test.ts +0 -138
  361. package/test-integration/assistants-manager.test.ts +0 -113
  362. package/test-integration/claude-code.test.ts +0 -98
  363. package/test-integration/conversation-history.test.ts +0 -205
  364. package/test-integration/conversation.test.ts +0 -137
  365. package/test-integration/elevenlabs.test.ts +0 -55
  366. package/test-integration/google-services.test.ts +0 -80
  367. package/test-integration/helpers.ts +0 -89
  368. package/test-integration/memory.test.ts +0 -204
  369. package/test-integration/openai-codex.test.ts +0 -93
  370. package/test-integration/runpod.test.ts +0 -58
  371. package/test-integration/server-endpoints.test.ts +0 -97
  372. 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
- })