saeeol 1.3.0 → 1.4.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 (545) hide show
  1. package/AGENTS.md +72 -0
  2. package/BUN_SHELL_MIGRATION_PLAN.md +136 -0
  3. package/Dockerfile +18 -0
  4. package/assets/saeeol.ico +0 -0
  5. package/bin/saeeol.cjs +3 -1
  6. package/bunfig.toml +7 -0
  7. package/database.db +0 -0
  8. package/drizzle.config.ts +10 -0
  9. package/git +0 -0
  10. package/migration/20260127222353_familiar_lady_ursula/migration.sql +90 -0
  11. package/migration/20260127222353_familiar_lady_ursula/snapshot.json +796 -0
  12. package/migration/20260211171708_add_project_commands/migration.sql +1 -0
  13. package/migration/20260211171708_add_project_commands/snapshot.json +806 -0
  14. package/migration/20260213144116_wakeful_the_professor/migration.sql +11 -0
  15. package/migration/20260213144116_wakeful_the_professor/snapshot.json +897 -0
  16. package/migration/20260225215848_workspace/migration.sql +7 -0
  17. package/migration/20260225215848_workspace/snapshot.json +959 -0
  18. package/migration/20260227213759_add_session_workspace_id/migration.sql +2 -0
  19. package/migration/20260227213759_add_session_workspace_id/snapshot.json +983 -0
  20. package/migration/20260228203230_blue_harpoon/migration.sql +17 -0
  21. package/migration/20260228203230_blue_harpoon/snapshot.json +1102 -0
  22. package/migration/20260303231226_add_workspace_fields/migration.sql +5 -0
  23. package/migration/20260303231226_add_workspace_fields/snapshot.json +1013 -0
  24. package/migration/20260309230000_move_org_to_state/migration.sql +3 -0
  25. package/migration/20260309230000_move_org_to_state/snapshot.json +1156 -0
  26. package/migration/20260312043431_session_message_cursor/migration.sql +4 -0
  27. package/migration/20260312043431_session_message_cursor/snapshot.json +1168 -0
  28. package/migration/20260323234822_events/migration.sql +13 -0
  29. package/migration/20260323234822_events/snapshot.json +1271 -0
  30. package/migration/20260410174513_workspace-name/migration.sql +16 -0
  31. package/migration/20260410174513_workspace-name/snapshot.json +1271 -0
  32. package/migration/20260413175956_chief_energizer/migration.sql +13 -0
  33. package/migration/20260413175956_chief_energizer/snapshot.json +1399 -0
  34. package/migration/20260423070820_add_icon_url_override/migration.sql +2 -0
  35. package/migration/20260423070820_add_icon_url_override/snapshot.json +1409 -0
  36. package/migration/20260428004200_add_session_path/migration.sql +1 -0
  37. package/migration/20260428004200_add_session_path/snapshot.json +1419 -0
  38. package/npm/bin/saeeol +42 -0
  39. package/npm/package.json +39 -0
  40. package/npm/postinstall.js +162 -0
  41. package/package.json +201 -207
  42. package/parsers-config.ts +289 -0
  43. package/script/build.ts +393 -0
  44. package/script/check-migrations.ts +16 -0
  45. package/script/fix-node-pty.ts +34 -0
  46. package/script/generate.ts +23 -0
  47. package/script/postinstall.mjs +189 -0
  48. package/script/publish.ts +200 -0
  49. package/script/run-workspace-server +106 -0
  50. package/script/schema.ts +63 -0
  51. package/script/test-runner.ts +420 -0
  52. package/script/time.ts +6 -0
  53. package/script/trace-imports.ts +153 -0
  54. package/script/upgrade-opentui.ts +64 -0
  55. package/scripts/diff-sdk-types.sh +52 -0
  56. package/specs/effect/facades.md +221 -0
  57. package/specs/effect/http-api.md +401 -0
  58. package/specs/effect/instance-context.md +309 -0
  59. package/specs/effect/loose-ends.md +34 -0
  60. package/specs/effect/migration.md +299 -0
  61. package/specs/effect/routes.md +64 -0
  62. package/specs/effect/schema.md +399 -0
  63. package/specs/effect/server-package.md +668 -0
  64. package/specs/effect/tools.md +90 -0
  65. package/specs/tui-plugins.md +433 -0
  66. package/specs/v2/api.ts +67 -0
  67. package/specs/v2/keymappings.md +10 -0
  68. package/specs/v2/message-shape.md +136 -0
  69. package/src/acp/agent-message.ts +1 -1
  70. package/src/acp/agent-utils.ts +1 -1
  71. package/src/boxes/ansi.ts +17 -0
  72. package/src/boxes/atomic-write.ts +35 -0
  73. package/src/boxes/b64.ts +58 -0
  74. package/src/boxes/bash-security.ts +129 -0
  75. package/src/boxes/bom.ts +18 -0
  76. package/src/boxes/cancel.ts +16 -0
  77. package/src/boxes/chop.ts +12 -0
  78. package/src/boxes/clamp.ts +3 -0
  79. package/src/boxes/compact.ts +9 -0
  80. package/src/boxes/cost-tracker.ts +116 -0
  81. package/src/boxes/dataurl.ts +29 -0
  82. package/src/boxes/delay.ts +27 -0
  83. package/src/boxes/diff-apply.ts +53 -0
  84. package/src/boxes/disposable.ts +13 -0
  85. package/src/boxes/err.ts +34 -0
  86. package/src/boxes/human.ts +47 -0
  87. package/src/boxes/iife.ts +9 -0
  88. package/src/boxes/latch.ts +8 -0
  89. package/src/boxes/memory.ts +198 -0
  90. package/src/boxes/net.ts +16 -0
  91. package/src/boxes/plural.ts +4 -0
  92. package/src/boxes/puny.ts +21 -0
  93. package/src/boxes/retry.ts +49 -0
  94. package/src/boxes/rwlock.ts +41 -0
  95. package/src/boxes/schedule.ts +71 -0
  96. package/src/boxes/scope.ts +21 -0
  97. package/src/boxes/tokens.ts +9 -0
  98. package/src/boxes/ttl-cache.ts +63 -0
  99. package/src/boxes/typed-event.ts +51 -0
  100. package/src/boxes/uid.ts +50 -0
  101. package/src/boxes/wave6.test.ts +296 -0
  102. package/src/boxes/wildcard.ts +58 -0
  103. package/src/bus/global.ts +1 -1
  104. package/src/cli/cmd/github-run-api.ts +2 -2
  105. package/src/cli/cmd/run-events.ts +2 -2
  106. package/src/cli/cmd/tui/component/logo.tsx +1 -1
  107. package/src/cli/cmd/tui/component/prompt/use-prompt-memos.ts +2 -2
  108. package/src/cli/cmd/tui/context/app/editor-zed.ts +1 -1
  109. package/src/cli/cmd/tui/context/app/editor.ts +1 -1
  110. package/src/cli/cmd/tui/context/app/theme.tsx +1 -1
  111. package/src/cli/cmd/tui/preflight.ts +138 -0
  112. package/src/cli/cmd/tui/thread.ts +20 -0
  113. package/src/cli/cmd/tui/util/revert-diff.ts +1 -1
  114. package/src/overlay/cli/cmd/roll-call-call.ts +1 -1
  115. package/src/overlay/cost-tracker/format.ts +1 -1
  116. package/src/overlay/cost-tracker/index.ts +4 -4
  117. package/src/overlay/cost-tracker/state.ts +2 -2
  118. package/src/overlay/cost-tracker/types.ts +2 -2
  119. package/src/overlay/memory/age.ts +1 -1
  120. package/src/overlay/memory/index.ts +4 -4
  121. package/src/overlay/memory/paths.ts +2 -2
  122. package/src/overlay/memory/scan.ts +1 -1
  123. package/src/overlay/memory/types.ts +2 -2
  124. package/src/overlay/tool/bash-security.ts +3 -3
  125. package/src/overlay/util/url.ts +1 -1
  126. package/src/plugin/codex-auth.ts +1 -1
  127. package/src/provider/model-cache.ts +2 -2
  128. package/src/provider/provider-resolve.ts +3 -3
  129. package/src/provider/transform-message.ts +1 -1
  130. package/src/server/routes/game.ts +284 -0
  131. package/src/server/server.ts +2 -0
  132. package/src/session/core/compaction/compaction-helpers.ts +1 -1
  133. package/src/session/core/compaction/compaction.ts +1 -1
  134. package/src/session/core/session.ts +2 -0
  135. package/src/sessions/ingest-queue.ts +2 -2
  136. package/src/sessions/remote-ws.ts +1 -1
  137. package/src/tool/workflow/question.ts +1 -1
  138. package/src/util/abort.ts +1 -1
  139. package/src/util/bom.ts +2 -2
  140. package/src/util/color.ts +1 -1
  141. package/src/util/data-url.ts +1 -1
  142. package/src/util/defer.ts +1 -1
  143. package/src/util/error.ts +2 -2
  144. package/src/util/filesystem.ts +2 -2
  145. package/src/util/format.ts +1 -1
  146. package/src/util/iife.ts +1 -1
  147. package/src/util/local-context.ts +1 -1
  148. package/src/util/locale.ts +2 -2
  149. package/src/util/lock.ts +1 -1
  150. package/src/util/network.ts +1 -1
  151. package/src/util/signal.ts +1 -1
  152. package/src/util/token.ts +1 -1
  153. package/src/util/wildcard.ts +1 -1
  154. package/sst-env.d.ts +10 -0
  155. package/test/AGENTS.md +133 -0
  156. package/test/account/repo.test.ts +352 -0
  157. package/test/account/service.test.ts +456 -0
  158. package/test/acp/agent-interface.test.ts +51 -0
  159. package/test/acp/event-subscription.test.ts +725 -0
  160. package/test/agent/agent.test.ts +890 -0
  161. package/test/auth/auth.test.ts +86 -0
  162. package/test/bun/registry.test.ts +75 -0
  163. package/test/bus/bus-effect.test.ts +161 -0
  164. package/test/bus/bus-integration.test.ts +87 -0
  165. package/test/bus/bus.test.ts +219 -0
  166. package/test/cli/account.test.ts +26 -0
  167. package/test/cli/auto-mode.test.ts +75 -0
  168. package/test/cli/bin-saeeol.test.ts +8 -0
  169. package/test/cli/cmd/tui/prompt-part.test.ts +47 -0
  170. package/test/cli/cmd/tui/prompt-traits.test.ts +38 -0
  171. package/test/cli/cmd/tui/sync.test.tsx +159 -0
  172. package/test/cli/error.test.ts +18 -0
  173. package/test/cli/github-action.test.ts +198 -0
  174. package/test/cli/github-remote.test.ts +85 -0
  175. package/test/cli/import.test.ts +97 -0
  176. package/test/cli/install-artifact.test.ts +72 -0
  177. package/test/cli/plugin-auth-picker.test.ts +120 -0
  178. package/test/cli/pr.test.ts +59 -0
  179. package/test/cli/tui/editor-context-zed.test.ts +356 -0
  180. package/test/cli/tui/editor-context.test.tsx +228 -0
  181. package/test/cli/tui/keybind-plugin.test.ts +90 -0
  182. package/test/cli/tui/markdown.test.ts +161 -0
  183. package/test/cli/tui/plugin-add.test.ts +111 -0
  184. package/test/cli/tui/plugin-install.test.ts +87 -0
  185. package/test/cli/tui/plugin-lifecycle.test.ts +224 -0
  186. package/test/cli/tui/plugin-loader-entrypoint.test.ts +484 -0
  187. package/test/cli/tui/plugin-loader-pure.test.ts +71 -0
  188. package/test/cli/tui/plugin-loader.test.ts +816 -0
  189. package/test/cli/tui/plugin-toggle.test.ts +157 -0
  190. package/test/cli/tui/revert-diff.test.ts +35 -0
  191. package/test/cli/tui/slot-replace.test.tsx +47 -0
  192. package/test/cli/tui/theme-store.test.ts +54 -0
  193. package/test/cli/tui/thread.test.ts +28 -0
  194. package/test/cli/tui/transcript.test.ts +426 -0
  195. package/test/cli/tui/usage.test.ts +60 -0
  196. package/test/cli/tui/use-event.test.tsx +175 -0
  197. package/test/config/agent-color.test.ts +67 -0
  198. package/test/config/config.test.ts +2544 -0
  199. package/test/config/fixtures/empty-frontmatter.md +4 -0
  200. package/test/config/fixtures/frontmatter.md +28 -0
  201. package/test/config/fixtures/markdown-header.md +11 -0
  202. package/test/config/fixtures/no-frontmatter.md +1 -0
  203. package/test/config/fixtures/weird-model-id.md +13 -0
  204. package/test/config/lsp.test.ts +87 -0
  205. package/test/config/markdown.test.ts +228 -0
  206. package/test/config/plugin.test.ts +0 -0
  207. package/test/config/tui.test.ts +624 -0
  208. package/test/control-plane/adapters.test.ts +71 -0
  209. package/test/control-plane/workspace.test.ts +1526 -0
  210. package/test/effect/app-runtime-logger.test.ts +98 -0
  211. package/test/effect/config-service.test.ts +65 -0
  212. package/test/effect/instance-state.test.ts +394 -0
  213. package/test/effect/run-service.test.ts +89 -0
  214. package/test/effect/runner.test.ts +523 -0
  215. package/test/fake/provider.ts +82 -0
  216. package/test/file/fsmonitor.test.ts +68 -0
  217. package/test/file/ignore.test.ts +10 -0
  218. package/test/file/index.test.ts +954 -0
  219. package/test/file/path-traversal.test.ts +205 -0
  220. package/test/file/ripgrep.test.ts +226 -0
  221. package/test/file/watcher.test.ts +249 -0
  222. package/test/filesystem/filesystem.test.ts +319 -0
  223. package/test/fixture/db.ts +11 -0
  224. package/test/fixture/fixture.test.ts +26 -0
  225. package/test/fixture/fixture.ts +175 -0
  226. package/test/fixture/flock-worker.ts +72 -0
  227. package/test/fixture/log-init-worker.ts +62 -0
  228. package/test/fixture/lsp/fake-lsp-server.js +249 -0
  229. package/test/fixture/plug-worker.ts +93 -0
  230. package/test/fixture/plugin-meta-worker.ts +19 -0
  231. package/test/fixture/skills/agents-sdk/SKILL.md +152 -0
  232. package/test/fixture/skills/cloudflare/SKILL.md +211 -0
  233. package/test/fixture/skills/index.json +6 -0
  234. package/test/fixture/tui-plugin.ts +323 -0
  235. package/test/fixture/tui-runtime.ts +31 -0
  236. package/test/format/format.test.ts +272 -0
  237. package/test/git/git.test.ts +128 -0
  238. package/test/ide/ide.test.ts +82 -0
  239. package/test/installation/installation.test.ts +168 -0
  240. package/test/keybind.test.ts +421 -0
  241. package/test/lib/effect.ts +53 -0
  242. package/test/lib/filesystem.ts +10 -0
  243. package/test/lib/llm-server.ts +778 -0
  244. package/test/lib/websocket.ts +46 -0
  245. package/test/lsp/client.test.ts +482 -0
  246. package/test/lsp/index.test.ts +160 -0
  247. package/test/lsp/launch.test.ts +22 -0
  248. package/test/lsp/lifecycle.test.ts +184 -0
  249. package/test/ltm/ltm.test.ts +230 -0
  250. package/test/mcp/headers.test.ts +178 -0
  251. package/test/mcp/lifecycle.test.ts +787 -0
  252. package/test/mcp/oauth-auto-connect.test.ts +311 -0
  253. package/test/mcp/oauth-browser.test.ts +276 -0
  254. package/test/mcp/oauth-callback.test.ts +34 -0
  255. package/test/memory/abort-leak-webfetch.ts +49 -0
  256. package/test/memory/abort-leak.test.ts +128 -0
  257. package/test/patch/patch.test.ts +348 -0
  258. package/test/permission/arity.test.ts +33 -0
  259. package/test/permission/next.test.ts +1227 -0
  260. package/test/permission/next.toConfig.test.ts +110 -0
  261. package/test/permission-task.test.ts +326 -0
  262. package/test/plugin/auth-override.test.ts +79 -0
  263. package/test/plugin/cloudflare.test.ts +68 -0
  264. package/test/plugin/codex.test.ts +123 -0
  265. package/test/plugin/github-copilot-models.test.ts +261 -0
  266. package/test/plugin/install-concurrency.test.ts +140 -0
  267. package/test/plugin/install.test.ts +570 -0
  268. package/test/plugin/loader-shared.test.ts +1169 -0
  269. package/test/plugin/meta.test.ts +137 -0
  270. package/test/plugin/plugin-contract.test.ts +291 -0
  271. package/test/plugin/shared.test.ts +88 -0
  272. package/test/plugin/trigger.test.ts +102 -0
  273. package/test/plugin/workspace-adapter.test.ts +109 -0
  274. package/test/preload.ts +77 -0
  275. package/test/project/instance.test.ts +276 -0
  276. package/test/project/migrate-global.test.ts +152 -0
  277. package/test/project/project.test.ts +600 -0
  278. package/test/project/vcs.test.ts +286 -0
  279. package/test/project/worktree-remove.test.ts +126 -0
  280. package/test/project/worktree.test.ts +223 -0
  281. package/test/provider/amazon-bedrock.test.ts +462 -0
  282. package/test/provider/copilot/convert-to-copilot-messages.test.ts +523 -0
  283. package/test/provider/copilot/copilot-chat-model.test.ts +592 -0
  284. package/test/provider/gitlab-duo.test.ts +413 -0
  285. package/test/provider/local.test.ts +208 -0
  286. package/test/provider/models.test.ts +261 -0
  287. package/test/provider/provider-category.test.ts +190 -0
  288. package/test/provider/provider.test.ts +2758 -0
  289. package/test/provider/transform.test.ts +3681 -0
  290. package/test/pty/pty-output-isolation.test.ts +147 -0
  291. package/test/pty/pty-session.test.ts +102 -0
  292. package/test/pty/pty-shell.test.ts +104 -0
  293. package/test/question/question.test.ts +490 -0
  294. package/test/saeeol/agent-global-config-dirs.test.ts +24 -0
  295. package/test/saeeol/agent-manager-tool.test.ts +71 -0
  296. package/test/saeeol/agent-permission-overrides.test.ts +75 -0
  297. package/test/saeeol/agent-skill-permissions.test.ts +37 -0
  298. package/test/saeeol/ask-agent-permissions.test.ts +303 -0
  299. package/test/saeeol/bash-hierarchy.test.ts +64 -0
  300. package/test/saeeol/bash-permission-metadata.test.ts +66 -0
  301. package/test/saeeol/bash-security-extended.test.ts +243 -0
  302. package/test/saeeol/bedrock-claude-empty-content.test.ts +138 -0
  303. package/test/saeeol/boxes-integration.test.ts +415 -0
  304. package/test/saeeol/builtin-skills.test.ts +75 -0
  305. package/test/saeeol/cleanup.ts +28 -0
  306. package/test/saeeol/cli/dev-setup.test.ts +74 -0
  307. package/test/saeeol/cli/roll-call.test.ts +161 -0
  308. package/test/saeeol/cli-run-auto-helper.test.ts +58 -0
  309. package/test/saeeol/codex-auth-refresh.test.ts +124 -0
  310. package/test/saeeol/commit-message/generate.test.ts +188 -0
  311. package/test/saeeol/commit-message/git-context.test.ts +303 -0
  312. package/test/saeeol/commit-message-windows.test.ts +38 -0
  313. package/test/saeeol/compaction-payload-recovery.test.ts +406 -0
  314. package/test/saeeol/compaction-preservation-audit.test.ts +122 -0
  315. package/test/saeeol/compaction-skip-guard.test.ts +224 -0
  316. package/test/saeeol/compaction-smart-select.test.ts +100 -0
  317. package/test/saeeol/config/config.test.ts +166 -0
  318. package/test/saeeol/config/indexing-default-plugin.test.ts +82 -0
  319. package/test/saeeol/config/opentelemetry-default.test.ts +29 -0
  320. package/test/saeeol/config-gitignore.test.ts +70 -0
  321. package/test/saeeol/config-injector.test.ts +305 -0
  322. package/test/saeeol/config-resilience.test.ts +234 -0
  323. package/test/saeeol/config-validation.test.ts +183 -0
  324. package/test/saeeol/cost-propagation.test.ts +94 -0
  325. package/test/saeeol/cost-tracker-extended.test.ts +141 -0
  326. package/test/saeeol/cost-tracker.test.ts +64 -0
  327. package/test/saeeol/custom-provider-delete.test.ts +149 -0
  328. package/test/saeeol/diff-full.test.ts +226 -0
  329. package/test/saeeol/edit-permission-filediff.test.ts +223 -0
  330. package/test/saeeol/encoding.test.ts +364 -0
  331. package/test/saeeol/enhance-prompt.test.ts +61 -0
  332. package/test/saeeol/ensure-plan-dir.test.ts +32 -0
  333. package/test/saeeol/errors.test.ts +144 -0
  334. package/test/saeeol/external-directory-boundary.test.ts +96 -0
  335. package/test/saeeol/gateway-headers.test.ts +88 -0
  336. package/test/saeeol/help.test.ts +191 -0
  337. package/test/saeeol/ignore-migrator.test.ts +308 -0
  338. package/test/saeeol/indexing-auth.test.ts +45 -0
  339. package/test/saeeol/indexing-feature.test.ts +44 -0
  340. package/test/saeeol/indexing-label.test.ts +70 -0
  341. package/test/saeeol/indexing-startup.test.ts +381 -0
  342. package/test/saeeol/indexing-worktree.test.ts +73 -0
  343. package/test/saeeol/instruction.test.ts +136 -0
  344. package/test/saeeol/lancedb-runtime.test.ts +116 -0
  345. package/test/saeeol/loader-auth.test.ts +168 -0
  346. package/test/saeeol/local-model.test.ts +621 -0
  347. package/test/saeeol/logo.test.ts +31 -0
  348. package/test/saeeol/lsp-typescript-lightweight.test.ts +89 -0
  349. package/test/saeeol/mcp-branding.test.ts +33 -0
  350. package/test/saeeol/mcp-docker-rm.test.ts +32 -0
  351. package/test/saeeol/mcp-migrator.test.ts +736 -0
  352. package/test/saeeol/mcp-oauth-callback.test.ts +33 -0
  353. package/test/saeeol/memory-io.test.ts +198 -0
  354. package/test/saeeol/memory-paths.test.ts +87 -0
  355. package/test/saeeol/memory-security.test.ts +166 -0
  356. package/test/saeeol/model-cache-org.test.ts +164 -0
  357. package/test/saeeol/model-info-panel-utils.test.ts +52 -0
  358. package/test/saeeol/model-info-panel.types.test.ts +7 -0
  359. package/test/saeeol/models-401-fallback.test.ts +52 -0
  360. package/test/saeeol/modes-migrator.test.ts +320 -0
  361. package/test/saeeol/nvidia-headers.test.ts +74 -0
  362. package/test/saeeol/patch-jsonc.test.ts +73 -0
  363. package/test/saeeol/patch.test.ts +172 -0
  364. package/test/saeeol/paths.test.ts +265 -0
  365. package/test/saeeol/permission/config-paths.test.ts +174 -0
  366. package/test/saeeol/permission/env-read.test.ts +149 -0
  367. package/test/saeeol/permission/external-directory-allow.test.ts +327 -0
  368. package/test/saeeol/permission/next.always-rules.test.ts +882 -0
  369. package/test/saeeol/permission/next.reply-http.test.ts +205 -0
  370. package/test/saeeol/permission/next.reply-routing.test.ts +184 -0
  371. package/test/saeeol/plan-exit-detection.test.ts +494 -0
  372. package/test/saeeol/plan-followup.test.ts +1376 -0
  373. package/test/saeeol/project-config-update.test.ts +120 -0
  374. package/test/saeeol/project-id.test.ts +455 -0
  375. package/test/saeeol/provider-cost.test.ts +171 -0
  376. package/test/saeeol/provider-list-failed-state.test.ts +100 -0
  377. package/test/saeeol/question-dismiss-all.test.ts +174 -0
  378. package/test/saeeol/read-directory.test.ts +116 -0
  379. package/test/saeeol/rules-migrator.test.ts +257 -0
  380. package/test/saeeol/run-auto.test.ts +176 -0
  381. package/test/saeeol/run-network.test.ts +224 -0
  382. package/test/saeeol/semantic-search.test.ts +186 -0
  383. package/test/saeeol/server/permission-allow-everything.test.ts +125 -0
  384. package/test/saeeol/session/instruction-substitution.test.ts +72 -0
  385. package/test/saeeol/session/platform-attribution.test.ts +118 -0
  386. package/test/saeeol/session/session.test.ts +105 -0
  387. package/test/saeeol/session-compaction-cap.test.ts +399 -0
  388. package/test/saeeol/session-compaction-chunks.test.ts +501 -0
  389. package/test/saeeol/session-compaction-safety.test.ts +481 -0
  390. package/test/saeeol/session-fork-remap.test.ts +251 -0
  391. package/test/saeeol/session-import-service.test.ts +114 -0
  392. package/test/saeeol/session-list.test.ts +47 -0
  393. package/test/saeeol/session-message-metadata.test.ts +128 -0
  394. package/test/saeeol/session-overflow.test.ts +78 -0
  395. package/test/saeeol/session-processor-empty-tool-calls.test.ts +571 -0
  396. package/test/saeeol/session-processor-network-offline.test.ts +204 -0
  397. package/test/saeeol/session-processor-retry-limit.test.ts +238 -0
  398. package/test/saeeol/session-processor-review-telemetry.test.ts +82 -0
  399. package/test/saeeol/session-prompt-compaction-safety.test.ts +517 -0
  400. package/test/saeeol/session-prompt-queue.test.ts +815 -0
  401. package/test/saeeol/sessions/inflight-cache.test.ts +157 -0
  402. package/test/saeeol/sessions/ingest-queue.test.ts +402 -0
  403. package/test/saeeol/sessions/remote-protocol.test.ts +258 -0
  404. package/test/saeeol/sessions/remote-sender.test.ts +1036 -0
  405. package/test/saeeol/sessions/remote-ws.test.ts +367 -0
  406. package/test/saeeol/sessions/sessions-enable-remote.test.disable +181 -0
  407. package/test/saeeol/slot-prop-reactivity.test.ts +142 -0
  408. package/test/saeeol/snapshot-cache.test.ts +84 -0
  409. package/test/saeeol/snapshot-freeze-repro.test.ts +100 -0
  410. package/test/saeeol/snapshot-track-timeout.test.ts +519 -0
  411. package/test/saeeol/stats-subagent-cost.test.ts +123 -0
  412. package/test/saeeol/suggestion/auto-dismiss.test.ts +65 -0
  413. package/test/saeeol/suggestion/suggestion.test.ts +145 -0
  414. package/test/saeeol/suggestion/tool.test.ts +298 -0
  415. package/test/saeeol/summary-file-diff.test.ts +28 -0
  416. package/test/saeeol/system-prompt.test.ts +142 -0
  417. package/test/saeeol/task-nesting.test.ts +193 -0
  418. package/test/saeeol/telemetry/feedback.test.ts +8 -0
  419. package/test/saeeol/todo-view.test.ts +57 -0
  420. package/test/saeeol/tool-encoding.test.ts +455 -0
  421. package/test/saeeol/tool-registry-indexing-import-failure.test.ts +49 -0
  422. package/test/saeeol/tool-registry-indexing.test.ts +236 -0
  423. package/test/saeeol/tool-registry-semantic-import-failure.test.ts +55 -0
  424. package/test/saeeol/tool-task-model.test.ts +352 -0
  425. package/test/saeeol/transform-opus-4.7.test.ts +89 -0
  426. package/test/saeeol/tui-diff.test.ts +91 -0
  427. package/test/saeeol/tui-sync.test.ts +80 -0
  428. package/test/saeeol/util/url.test.ts +141 -0
  429. package/test/saeeol/workflows-migrator.test.ts +261 -0
  430. package/test/saeeol/worktree-diff-summary.test.ts +64 -0
  431. package/test/saeeol/worktree-diff.test.ts +223 -0
  432. package/test/saeeol/worktree-remove-lock.test.ts +82 -0
  433. package/test/server/AGENTS.md +15 -0
  434. package/test/server/contract.test.ts +357 -0
  435. package/test/server/experimental-session-list.test.ts +157 -0
  436. package/test/server/global-session-list.test.ts +155 -0
  437. package/test/server/httpapi-authorization.test.ts +103 -0
  438. package/test/server/httpapi-bridge.test.ts +440 -0
  439. package/test/server/httpapi-config.test.ts +67 -0
  440. package/test/server/httpapi-cors.test.ts +89 -0
  441. package/test/server/httpapi-event.test.ts +57 -0
  442. package/test/server/httpapi-experimental.test.ts +219 -0
  443. package/test/server/httpapi-file.test.ts +79 -0
  444. package/test/server/httpapi-instance-context.test.ts +237 -0
  445. package/test/server/httpapi-instance.legacy.test.ts +140 -0
  446. package/test/server/httpapi-instance.test.ts +83 -0
  447. package/test/server/httpapi-json-parity.test.ts +263 -0
  448. package/test/server/httpapi-mcp-oauth.test.ts +76 -0
  449. package/test/server/httpapi-mcp.test.ts +189 -0
  450. package/test/server/httpapi-provider.test.ts +153 -0
  451. package/test/server/httpapi-pty-websocket.test.ts +16 -0
  452. package/test/server/httpapi-pty.test.ts +175 -0
  453. package/test/server/httpapi-raw-route-auth.test.ts +89 -0
  454. package/test/server/httpapi-sdk.test.ts +681 -0
  455. package/test/server/httpapi-session.test.ts +464 -0
  456. package/test/server/httpapi-sync.test.ts +130 -0
  457. package/test/server/httpapi-tui.test.ts +121 -0
  458. package/test/server/httpapi-workspace-routing.test.ts +471 -0
  459. package/test/server/httpapi-workspace.test.ts +427 -0
  460. package/test/server/lib/conformance.ts +88 -0
  461. package/test/server/lib/stateful.ts +112 -0
  462. package/test/server/project-init-git.test.ts +113 -0
  463. package/test/server/proxy-util.test.ts +113 -0
  464. package/test/server/session-actions.test.ts +49 -0
  465. package/test/server/session-list.test.ts +238 -0
  466. package/test/server/session-messages.test.ts +167 -0
  467. package/test/server/session-select.test.ts +100 -0
  468. package/test/server/trace-attributes.test.ts +76 -0
  469. package/test/server/workspace-proxy.test.ts +165 -0
  470. package/test/server/workspace-routing.test.ts +85 -0
  471. package/test/session/compaction.test.ts +2420 -0
  472. package/test/session/instruction.test.ts +247 -0
  473. package/test/session/llm.test.ts +1273 -0
  474. package/test/session/message-v2.test.ts +1291 -0
  475. package/test/session/messages-pagination.test.ts +1173 -0
  476. package/test/session/network.test.ts +249 -0
  477. package/test/session/processor-effect.test.ts +847 -0
  478. package/test/session/prompt.test.ts +2131 -0
  479. package/test/session/retry.test.ts +340 -0
  480. package/test/session/revert-compact.test.ts +639 -0
  481. package/test/session/schema-decoding.test.ts +311 -0
  482. package/test/session/session-entry-stepper.test.ts +917 -0
  483. package/test/session/session-schema.test.ts +76 -0
  484. package/test/session/snapshot-tool-race.test.ts +257 -0
  485. package/test/session/structured-output-integration.test.ts +265 -0
  486. package/test/session/structured-output.test.ts +381 -0
  487. package/test/session/system.test.ts +73 -0
  488. package/test/share/share-next.test.ts +333 -0
  489. package/test/shell/shell.test.ts +99 -0
  490. package/test/skill/discovery.test.ts +116 -0
  491. package/test/skill/skill.test.ts +393 -0
  492. package/test/smoke/.tui-debug-output.txt +1 -0
  493. package/test/smoke/.tui-debug-plain.txt +1 -0
  494. package/test/smoke/.tui-walkthrough-report.txt +122 -0
  495. package/test/smoke/smoke-tui-pty.test.ts +123 -0
  496. package/test/smoke/smoke-tui.mjs +83 -0
  497. package/test/smoke/tui-walkthrough.test.ts +520 -0
  498. package/test/snapshot/snapshot.test.ts +1531 -0
  499. package/test/storage/db.test.ts +23 -0
  500. package/test/storage/json-migration.test.ts +832 -0
  501. package/test/storage/storage.test.ts +293 -0
  502. package/test/suggestion/suggestion.test.ts +1 -0
  503. package/test/sync/index.test.ts +256 -0
  504. package/test/tool/__snapshots__/parameters.test.ts.snap +500 -0
  505. package/test/tool/__snapshots__/tool.test.ts.snap +9 -0
  506. package/test/tool/apply_patch.test.ts +614 -0
  507. package/test/tool/bash.test.ts +1225 -0
  508. package/test/tool/diagnostics-filter.test.ts +55 -0
  509. package/test/tool/edit.test.ts +754 -0
  510. package/test/tool/external-directory.test.ts +169 -0
  511. package/test/tool/fixtures/large-image.png +0 -0
  512. package/test/tool/fixtures/models-api.json +65179 -0
  513. package/test/tool/glob.test.ts +107 -0
  514. package/test/tool/grep.test.ts +114 -0
  515. package/test/tool/lsp.test.ts +187 -0
  516. package/test/tool/parameters.test.ts +243 -0
  517. package/test/tool/question.test.ts +129 -0
  518. package/test/tool/read.test.ts +500 -0
  519. package/test/tool/recall.test.ts +151 -0
  520. package/test/tool/registry.test.ts +203 -0
  521. package/test/tool/skill.test.ts +135 -0
  522. package/test/tool/suggest.test.ts +1 -0
  523. package/test/tool/task.test.ts +612 -0
  524. package/test/tool/tool-define.test.ts +99 -0
  525. package/test/tool/truncation.test.ts +260 -0
  526. package/test/tool/webfetch.test.ts +103 -0
  527. package/test/tool/write.test.ts +291 -0
  528. package/test/util/data-url.test.ts +14 -0
  529. package/test/util/effect-zod.test.ts +754 -0
  530. package/test/util/error.test.ts +38 -0
  531. package/test/util/filesystem.test.ts +656 -0
  532. package/test/util/format.test.ts +59 -0
  533. package/test/util/glob.test.ts +164 -0
  534. package/test/util/iife.test.ts +36 -0
  535. package/test/util/lazy.test.ts +50 -0
  536. package/test/util/lock.test.ts +72 -0
  537. package/test/util/log.test.ts +86 -0
  538. package/test/util/module.test.ts +59 -0
  539. package/test/util/process.test.ts +128 -0
  540. package/test/util/timeout.test.ts +21 -0
  541. package/test/util/which.test.ts +100 -0
  542. package/test/util/wildcard.test.ts +90 -0
  543. package/test/workspace/workspace-restore.test.ts +296 -0
  544. package/src/provider/models-snapshot.d.ts +0 -2
  545. package/src/provider/models-snapshot.js +0 -3
@@ -0,0 +1,120 @@
1
+
2
+ import { expect, test } from "bun:test"
3
+ import fs from "fs/promises"
4
+ import path from "path"
5
+ import { Effect, Layer, Option } from "effect"
6
+ import { NodeFileSystem, NodePath } from "@effect/platform-node"
7
+ import { AppFileSystem } from "@saeeol/core/filesystem"
8
+ import { EffectFlock } from "@saeeol/core/util/effect-flock"
9
+ import { Config } from "../../src/config/config"
10
+ import { Auth } from "../../src/auth"
11
+ import { Account } from "../../src/account/account"
12
+ import { Env } from "../../src/env"
13
+ import { Npm } from "@saeeol/core/npm"
14
+ import { Instance } from "../../src/project/instance"
15
+ import { Filesystem } from "../../src/util/filesystem"
16
+ import { CrossSpawnSpawner } from "@saeeol/core/cross-spawn-spawner"
17
+ import { tmpdir } from "../fixture/fixture"
18
+
19
+ const infra = CrossSpawnSpawner.defaultLayer.pipe(
20
+ Layer.provideMerge(Layer.mergeAll(NodeFileSystem.layer, NodePath.layer)),
21
+ )
22
+
23
+ const emptyAccount = Layer.mock(Account.Service)({
24
+ active: () => Effect.succeed(Option.none()),
25
+ activeOrg: () => Effect.succeed(Option.none()),
26
+ })
27
+
28
+ const emptyAuth = Layer.mock(Auth.Service)({
29
+ all: () => Effect.succeed({}),
30
+ })
31
+
32
+ const noopNpm = Layer.mock(Npm.Service)({
33
+ install: () => Effect.void,
34
+ add: () => Effect.die("not implemented"),
35
+ which: () => Effect.succeed(Option.none()),
36
+ })
37
+
38
+ const layer = Config.layer.pipe(
39
+ Layer.provide(EffectFlock.defaultLayer),
40
+ Layer.provide(AppFileSystem.defaultLayer),
41
+ Layer.provide(Env.defaultLayer),
42
+ Layer.provide(emptyAuth),
43
+ Layer.provide(emptyAccount),
44
+ Layer.provideMerge(infra),
45
+ Layer.provide(noopNpm),
46
+ )
47
+
48
+ const load = () => Effect.runPromise(Config.Service.use((svc) => svc.get()).pipe(Effect.scoped, Effect.provide(layer)))
49
+ const save = (config: Config.Info) =>
50
+ Effect.runPromise(Config.Service.use((svc) => svc.update(config)).pipe(Effect.scoped, Effect.provide(layer)))
51
+
52
+ async function writeConfig(dir: string, config: unknown) {
53
+ await Filesystem.write(path.join(dir, "saeeol.json"), JSON.stringify(config, null, 2))
54
+ }
55
+
56
+ test("project config update creates .saeeol/saeeol.json and reloads it", async () => {
57
+ await using tmp = await tmpdir()
58
+ await Instance.provide({
59
+ directory: tmp.path,
60
+ fn: async () => {
61
+ await save({ model: "updated/model" } as any)
62
+
63
+ const written = await Filesystem.readJson<{ model: string }>(path.join(tmp.path, ".saeeol", "saeeol.json"))
64
+ expect(written.model).toBe("updated/model")
65
+
66
+ const loaded = await load()
67
+ expect(loaded.model).toBe("updated/model")
68
+ },
69
+ })
70
+ })
71
+
72
+ test("project config update skips empty delete-only writes when no config exists", async () => {
73
+ await using tmp = await tmpdir()
74
+ await Instance.provide({
75
+ directory: tmp.path,
76
+ fn: async () => {
77
+ await save({ provider: { missing: null } } as any)
78
+
79
+ await expect(fs.access(path.join(tmp.path, ".saeeol", "saeeol.json"))).rejects.toThrow()
80
+ },
81
+ })
82
+ })
83
+
84
+ test("project config update prefers existing root saeeol.json", async () => {
85
+ await using tmp = await tmpdir()
86
+ await writeConfig(tmp.path, { username: "alice" })
87
+
88
+ await Instance.provide({
89
+ directory: tmp.path,
90
+ fn: async () => {
91
+ await save({ model: "updated/model" } as any)
92
+
93
+ const merged = await Filesystem.readJson<{ model: string; username: string }>(path.join(tmp.path, "saeeol.json"))
94
+ expect(merged.model).toBe("updated/model")
95
+ expect(merged.username).toBe("alice")
96
+ },
97
+ })
98
+ })
99
+
100
+ test("project config update patches ancestor .saeeol/saeeol.json from nested directory", async () => {
101
+ await using tmp = await tmpdir()
102
+ const child = path.join(tmp.path, "nested", "workspace")
103
+ await fs.mkdir(child, { recursive: true })
104
+ await fs.mkdir(path.join(tmp.path, ".saeeol"), { recursive: true })
105
+ await writeConfig(path.join(tmp.path, ".saeeol"), { username: "alice" })
106
+
107
+ await Instance.provide({
108
+ directory: child,
109
+ fn: async () => {
110
+ await save({ model: "updated/model" } as any)
111
+
112
+ const merged = await Filesystem.readJson<{ model: string; username: string }>(
113
+ path.join(tmp.path, ".saeeol", "saeeol.json"),
114
+ )
115
+ expect(merged.model).toBe("updated/model")
116
+ expect(merged.username).toBe("alice")
117
+ await expect(fs.access(path.join(child, ".saeeol", "saeeol.json"))).rejects.toThrow()
118
+ },
119
+ })
120
+ })
@@ -0,0 +1,455 @@
1
+ import { test, expect, describe } from "bun:test"
2
+ import { tmpdir } from "../fixture/fixture"
3
+ import path from "path"
4
+ import fs from "fs/promises"
5
+ import { Instance } from "../../src/project/instance"
6
+ import { getSaeeolProjectId } from "../../src/overlay/project-id"
7
+
8
+ describe("project-id", () => {
9
+ describe("normalization", () => {
10
+ test("extracts repo name from HTTPS git URL", async () => {
11
+ await using tmp = await tmpdir({
12
+ git: true,
13
+ init: async (dir) => {
14
+ // Set git origin to HTTPS URL
15
+ await Bun.$`git remote add origin https://github.com/SAEEOL/handbook.git`.cwd(dir).quiet()
16
+ },
17
+ })
18
+
19
+ const id = await Instance.provide({
20
+ directory: tmp.path,
21
+ fn: () => getSaeeolProjectId(),
22
+ })
23
+
24
+ expect(id).toBe("handbook")
25
+ })
26
+
27
+ test("extracts repo name from SSH git URL", async () => {
28
+ await using tmp = await tmpdir({
29
+ git: true,
30
+ init: async (dir) => {
31
+ // Set git origin to SSH URL
32
+ await Bun.$`git remote add origin git@github.com:SAEEOL/handbook.git`.cwd(dir).quiet()
33
+ },
34
+ })
35
+
36
+ const id = await Instance.provide({
37
+ directory: tmp.path,
38
+ fn: () => getSaeeolProjectId(),
39
+ })
40
+
41
+ expect(id).toBe("handbook")
42
+ })
43
+
44
+ test("extracts repo name from HTTPS URL without .git extension", async () => {
45
+ await using tmp = await tmpdir({
46
+ git: true,
47
+ init: async (dir) => {
48
+ await Bun.$`git remote add origin https://github.com/SAEEOL/handbook`.cwd(dir).quiet()
49
+ },
50
+ })
51
+
52
+ const id = await Instance.provide({
53
+ directory: tmp.path,
54
+ fn: () => getSaeeolProjectId(),
55
+ })
56
+
57
+ expect(id).toBe("handbook")
58
+ })
59
+
60
+ test("extracts repo name from ssh:// URL", async () => {
61
+ await using tmp = await tmpdir({
62
+ git: true,
63
+ init: async (dir) => {
64
+ await Bun.$`git remote add origin ssh://git@github.com/SAEEOL/handbook.git`.cwd(dir).quiet()
65
+ },
66
+ })
67
+
68
+ const id = await Instance.provide({
69
+ directory: tmp.path,
70
+ fn: () => getSaeeolProjectId(),
71
+ })
72
+
73
+ expect(id).toBe("handbook")
74
+ })
75
+
76
+ test("truncates long repo names to 100 characters", async () => {
77
+ const longName = "a".repeat(150)
78
+ await using tmp = await tmpdir({
79
+ git: true,
80
+ init: async (dir) => {
81
+ await Bun.$`git remote add origin https://github.com/SAEEOL/${longName}.git`.cwd(dir).quiet()
82
+ },
83
+ })
84
+
85
+ const id = await Instance.provide({
86
+ directory: tmp.path,
87
+ fn: () => getSaeeolProjectId(),
88
+ })
89
+
90
+ expect(id).toBe(longName.slice(-100))
91
+ })
92
+ })
93
+
94
+ describe("config file priority", () => {
95
+ test("uses project.id from .saeeol/config.json", async () => {
96
+ await using tmp = await tmpdir({
97
+ git: true,
98
+ init: async (dir) => {
99
+ // Create config with project ID
100
+ await fs.mkdir(path.join(dir, ".saeeol"), { recursive: true })
101
+ await Bun.write(
102
+ path.join(dir, ".saeeol", "config.json"),
103
+ JSON.stringify({
104
+ project: {
105
+ id: "my-custom-project",
106
+ },
107
+ }),
108
+ )
109
+
110
+ // Also set git origin - config should take priority
111
+ await Bun.$`git remote add origin https://github.com/SAEEOL/handbook.git`.cwd(dir).quiet()
112
+ },
113
+ })
114
+
115
+ const id = await Instance.provide({
116
+ directory: tmp.path,
117
+ fn: () => getSaeeolProjectId(),
118
+ })
119
+
120
+ expect(id).toBe("my-custom-project")
121
+ })
122
+
123
+ test("reads .saeeol/config.json", async () => {
124
+ await using tmp = await tmpdir({
125
+ git: true,
126
+ init: async (dir) => {
127
+ await fs.mkdir(path.join(dir, ".saeeol"), { recursive: true })
128
+ await Bun.write(
129
+ path.join(dir, ".saeeol", "config.json"),
130
+ JSON.stringify({
131
+ project: {
132
+ id: "legacy-project",
133
+ },
134
+ }),
135
+ )
136
+ },
137
+ })
138
+
139
+ const id = await Instance.provide({
140
+ directory: tmp.path,
141
+ fn: () => getSaeeolProjectId(),
142
+ })
143
+
144
+ expect(id).toBe("legacy-project")
145
+ })
146
+
147
+ test("reads .saeeol/config.json", async () => {
148
+ await using tmp = await tmpdir({
149
+ git: true,
150
+ init: async (dir) => {
151
+ await fs.mkdir(path.join(dir, ".saeeol"), { recursive: true })
152
+ await Bun.write(path.join(dir, ".saeeol", "config.json"), JSON.stringify({ project: { id: "new-project" } }))
153
+ await fs.mkdir(path.join(dir, ".saeeol"), { recursive: true })
154
+ await Bun.write(
155
+ path.join(dir, ".saeeol", "config.json"),
156
+ JSON.stringify({ project: { id: "old-project" } }),
157
+ )
158
+ },
159
+ })
160
+
161
+ const id = await Instance.provide({
162
+ directory: tmp.path,
163
+ fn: () => getSaeeolProjectId(),
164
+ })
165
+
166
+ expect(id).toBe("new-project")
167
+ })
168
+
169
+ test("normalizes git URL in config file project.id", async () => {
170
+ await using tmp = await tmpdir({
171
+ git: true,
172
+ init: async (dir) => {
173
+ await fs.mkdir(path.join(dir, ".saeeol"), { recursive: true })
174
+ await Bun.write(
175
+ path.join(dir, ".saeeol", "config.json"),
176
+ JSON.stringify({
177
+ project: {
178
+ id: "https://github.com/SAEEOL/another-repo.git",
179
+ },
180
+ }),
181
+ )
182
+ },
183
+ })
184
+
185
+ const id = await Instance.provide({
186
+ directory: tmp.path,
187
+ fn: () => getSaeeolProjectId(),
188
+ })
189
+
190
+ expect(id).toBe("another-repo")
191
+ })
192
+
193
+ test("falls back to git origin when config file has no project.id", async () => {
194
+ await using tmp = await tmpdir({
195
+ git: true,
196
+ init: async (dir) => {
197
+ await fs.mkdir(path.join(dir, ".saeeol"), { recursive: true })
198
+ await Bun.write(
199
+ path.join(dir, ".saeeol", "config.json"),
200
+ JSON.stringify({
201
+ project: {
202
+ managedIndexingEnabled: true,
203
+ },
204
+ }),
205
+ )
206
+
207
+ await Bun.$`git remote add origin https://github.com/SAEEOL/handbook.git`.cwd(dir).quiet()
208
+ },
209
+ })
210
+
211
+ const id = await Instance.provide({
212
+ directory: tmp.path,
213
+ fn: () => getSaeeolProjectId(),
214
+ })
215
+
216
+ expect(id).toBe("handbook")
217
+ })
218
+
219
+ test("falls back to git origin when config has empty project.id", async () => {
220
+ await using tmp = await tmpdir({
221
+ git: true,
222
+ init: async (dir) => {
223
+ await fs.mkdir(path.join(dir, ".saeeol"), { recursive: true })
224
+ await Bun.write(
225
+ path.join(dir, ".saeeol", "config.json"),
226
+ JSON.stringify({
227
+ project: {
228
+ id: "",
229
+ },
230
+ }),
231
+ )
232
+
233
+ await Bun.$`git remote add origin https://github.com/SAEEOL/handbook.git`.cwd(dir).quiet()
234
+ },
235
+ })
236
+
237
+ const id = await Instance.provide({
238
+ directory: tmp.path,
239
+ fn: () => getSaeeolProjectId(),
240
+ })
241
+
242
+ expect(id).toBe("handbook")
243
+ })
244
+
245
+ test("trims whitespace from config file project.id", async () => {
246
+ await using tmp = await tmpdir({
247
+ git: true,
248
+ init: async (dir) => {
249
+ await fs.mkdir(path.join(dir, ".saeeol"), { recursive: true })
250
+ await Bun.write(
251
+ path.join(dir, ".saeeol", "config.json"),
252
+ JSON.stringify({
253
+ project: {
254
+ id: " my-project\n",
255
+ },
256
+ }),
257
+ )
258
+ },
259
+ })
260
+
261
+ const id = await Instance.provide({
262
+ directory: tmp.path,
263
+ fn: () => getSaeeolProjectId(),
264
+ })
265
+
266
+ expect(id).toBe("my-project")
267
+ })
268
+
269
+ test("falls back to git when config has whitespace-only project.id", async () => {
270
+ await using tmp = await tmpdir({
271
+ git: true,
272
+ init: async (dir) => {
273
+ await fs.mkdir(path.join(dir, ".saeeol"), { recursive: true })
274
+ await Bun.write(
275
+ path.join(dir, ".saeeol", "config.json"),
276
+ JSON.stringify({
277
+ project: {
278
+ id: " \n\t ",
279
+ },
280
+ }),
281
+ )
282
+
283
+ await Bun.$`git remote add origin https://github.com/SAEEOL/handbook.git`.cwd(dir).quiet()
284
+ },
285
+ })
286
+
287
+ const id = await Instance.provide({
288
+ directory: tmp.path,
289
+ fn: () => getSaeeolProjectId(),
290
+ })
291
+
292
+ expect(id).toBe("handbook")
293
+ })
294
+ })
295
+
296
+ describe("fallback behavior", () => {
297
+ test("returns undefined when no config and no git origin", async () => {
298
+ await using tmp = await tmpdir({ git: true })
299
+
300
+ const id = await Instance.provide({
301
+ directory: tmp.path,
302
+ fn: () => getSaeeolProjectId(),
303
+ })
304
+
305
+ expect(id).toBeUndefined()
306
+ })
307
+
308
+ test("returns undefined for non-git directory", async () => {
309
+ await using tmp = await tmpdir()
310
+
311
+ const id = await Instance.provide({
312
+ directory: tmp.path,
313
+ fn: () => getSaeeolProjectId(),
314
+ })
315
+
316
+ expect(id).toBeUndefined()
317
+ })
318
+
319
+ test("handles malformed JSON in config file gracefully", async () => {
320
+ await using tmp = await tmpdir({
321
+ git: true,
322
+ init: async (dir) => {
323
+ await fs.mkdir(path.join(dir, ".saeeol"), { recursive: true })
324
+ await Bun.write(path.join(dir, ".saeeol", "config.json"), "{ invalid json")
325
+
326
+ await Bun.$`git remote add origin https://github.com/SAEEOL/handbook.git`.cwd(dir).quiet()
327
+ },
328
+ })
329
+
330
+ const id = await Instance.provide({
331
+ directory: tmp.path,
332
+ fn: () => getSaeeolProjectId(),
333
+ })
334
+
335
+ // Should fall back to git origin
336
+ expect(id).toBe("handbook")
337
+ })
338
+
339
+ test("handles config file with non-string project.id", async () => {
340
+ await using tmp = await tmpdir({
341
+ git: true,
342
+ init: async (dir) => {
343
+ await fs.mkdir(path.join(dir, ".saeeol"), { recursive: true })
344
+ await Bun.write(
345
+ path.join(dir, ".saeeol", "config.json"),
346
+ JSON.stringify({
347
+ project: {
348
+ id: 12345,
349
+ },
350
+ }),
351
+ )
352
+
353
+ await Bun.$`git remote add origin https://github.com/SAEEOL/handbook.git`.cwd(dir).quiet()
354
+ },
355
+ })
356
+
357
+ const id = await Instance.provide({
358
+ directory: tmp.path,
359
+ fn: () => getSaeeolProjectId(),
360
+ })
361
+
362
+ // Should fall back to git origin
363
+ expect(id).toBe("handbook")
364
+ })
365
+ })
366
+
367
+ describe("caching", () => {
368
+ test("caches project ID per Instance", async () => {
369
+ await using tmp = await tmpdir({
370
+ git: true,
371
+ init: async (dir) => {
372
+ await Bun.$`git remote add origin https://github.com/SAEEOL/handbook.git`.cwd(dir).quiet()
373
+ },
374
+ })
375
+
376
+ const id1 = await Instance.provide({
377
+ directory: tmp.path,
378
+ fn: () => getSaeeolProjectId(),
379
+ })
380
+
381
+ const id2 = await Instance.provide({
382
+ directory: tmp.path,
383
+ fn: () => getSaeeolProjectId(),
384
+ })
385
+
386
+ expect(id1).toBe(id2)
387
+ expect(id1).toBe("handbook")
388
+ })
389
+ })
390
+
391
+ describe("edge cases", () => {
392
+ test("handles git URLs with port numbers", async () => {
393
+ await using tmp = await tmpdir({
394
+ git: true,
395
+ init: async (dir) => {
396
+ await Bun.$`git remote add origin https://github.com:443/SAEEOL/handbook.git`.cwd(dir).quiet()
397
+ },
398
+ })
399
+
400
+ const id = await Instance.provide({
401
+ directory: tmp.path,
402
+ fn: () => getSaeeolProjectId(),
403
+ })
404
+
405
+ expect(id).toBe("handbook")
406
+ })
407
+
408
+ test("handles plain string project IDs from config", async () => {
409
+ await using tmp = await tmpdir({
410
+ init: async (dir) => {
411
+ await fs.mkdir(path.join(dir, ".saeeol"), { recursive: true })
412
+ await Bun.write(
413
+ path.join(dir, ".saeeol", "config.json"),
414
+ JSON.stringify({
415
+ project: {
416
+ id: "simple-name",
417
+ },
418
+ }),
419
+ )
420
+ },
421
+ })
422
+
423
+ const id = await Instance.provide({
424
+ directory: tmp.path,
425
+ fn: () => getSaeeolProjectId(),
426
+ })
427
+
428
+ expect(id).toBe("simple-name")
429
+ })
430
+
431
+ test("truncates plain string project IDs to 100 chars", async () => {
432
+ const longId = "x".repeat(150)
433
+ await using tmp = await tmpdir({
434
+ init: async (dir) => {
435
+ await fs.mkdir(path.join(dir, ".saeeol"), { recursive: true })
436
+ await Bun.write(
437
+ path.join(dir, ".saeeol", "config.json"),
438
+ JSON.stringify({
439
+ project: {
440
+ id: longId,
441
+ },
442
+ }),
443
+ )
444
+ },
445
+ })
446
+
447
+ const id = await Instance.provide({
448
+ directory: tmp.path,
449
+ fn: () => getSaeeolProjectId(),
450
+ })
451
+
452
+ expect(id).toBe(longId.slice(-100))
453
+ })
454
+ })
455
+ })