@farhanic017/octocode 3.5.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 (716) hide show
  1. package/.swarm_lessons.json +85 -0
  2. package/AGENTS.md +151 -0
  3. package/BUN_SHELL_MIGRATION_PLAN.md +136 -0
  4. package/Dockerfile +18 -0
  5. package/README.md +15 -0
  6. package/bin/octocode +31 -0
  7. package/bunfig.toml +7 -0
  8. package/git +0 -0
  9. package/package.json +151 -0
  10. package/parsers-config.ts +1 -0
  11. package/script/bench-search.ts +115 -0
  12. package/script/bench-test-suite.ts +52 -0
  13. package/script/build.ts +243 -0
  14. package/script/generate.ts +14 -0
  15. package/script/httpapi-exercise.ts +1 -0
  16. package/script/octo-shim.mjs +34 -0
  17. package/script/postinstall.mjs +198 -0
  18. package/script/profile-test-files.ts +42 -0
  19. package/script/publish.ts +211 -0
  20. package/script/run-workspace-server +106 -0
  21. package/script/schema.ts +77 -0
  22. package/script/time.ts +6 -0
  23. package/script/trace-imports.ts +154 -0
  24. package/specs/effect/error-boundaries-plan.md +235 -0
  25. package/specs/effect/errors.md +207 -0
  26. package/specs/effect/facades.md +218 -0
  27. package/specs/effect/guide.md +247 -0
  28. package/specs/effect/instance-context.md +13 -0
  29. package/specs/effect/loose-ends.md +30 -0
  30. package/specs/effect/migration.md +62 -0
  31. package/specs/effect/routes.md +61 -0
  32. package/specs/effect/schema.md +88 -0
  33. package/specs/effect/server-package.md +58 -0
  34. package/specs/effect/todo.md +241 -0
  35. package/specs/effect/tools.md +88 -0
  36. package/specs/openapi-translation-cleanup.md +204 -0
  37. package/specs/tui-plugins.md +544 -0
  38. package/specs/v2/api.ts +67 -0
  39. package/specs/v2/message-shape.md +136 -0
  40. package/specs/v2/notifications.md +13 -0
  41. package/specs/v2/tui-command-shim.md +67 -0
  42. package/src/account/account.ts +459 -0
  43. package/src/account/repo.ts +170 -0
  44. package/src/account/schema.ts +99 -0
  45. package/src/account/url.ts +8 -0
  46. package/src/acp/agent.ts +95 -0
  47. package/src/acp/config-option.ts +203 -0
  48. package/src/acp/content.ts +250 -0
  49. package/src/acp/directory.ts +210 -0
  50. package/src/acp/error.ts +90 -0
  51. package/src/acp/event.ts +345 -0
  52. package/src/acp/permission.ts +145 -0
  53. package/src/acp/profile.ts +42 -0
  54. package/src/acp/service.ts +1062 -0
  55. package/src/acp/tool.ts +321 -0
  56. package/src/acp/usage.ts +239 -0
  57. package/src/agent/agent.ts +451 -0
  58. package/src/agent/generate.txt +75 -0
  59. package/src/agent/prompt/compaction.txt +30 -0
  60. package/src/agent/prompt/explore.txt +18 -0
  61. package/src/agent/prompt/summary.txt +11 -0
  62. package/src/agent/prompt/title.txt +50 -0
  63. package/src/agent/subagent-permissions.ts +35 -0
  64. package/src/audio.d.ts +14 -0
  65. package/src/auth/index.ts +96 -0
  66. package/src/background/job.ts +36 -0
  67. package/src/bus/global.ts +22 -0
  68. package/src/cli/bootstrap.ts +11 -0
  69. package/src/cli/cmd/account.ts +264 -0
  70. package/src/cli/cmd/acp.ts +76 -0
  71. package/src/cli/cmd/agent.ts +259 -0
  72. package/src/cli/cmd/attach.ts +97 -0
  73. package/src/cli/cmd/cmd.ts +7 -0
  74. package/src/cli/cmd/db.ts +62 -0
  75. package/src/cli/cmd/debug/agent.handler.ts +188 -0
  76. package/src/cli/cmd/debug/agent.ts +27 -0
  77. package/src/cli/cmd/debug/config.ts +14 -0
  78. package/src/cli/cmd/debug/file.ts +87 -0
  79. package/src/cli/cmd/debug/index.ts +87 -0
  80. package/src/cli/cmd/debug/lsp.ts +51 -0
  81. package/src/cli/cmd/debug/ripgrep.ts +99 -0
  82. package/src/cli/cmd/debug/scrap.ts +18 -0
  83. package/src/cli/cmd/debug/skill.ts +15 -0
  84. package/src/cli/cmd/debug/snapshot.ts +50 -0
  85. package/src/cli/cmd/debug/startup.ts +11 -0
  86. package/src/cli/cmd/debug/v2.ts +46 -0
  87. package/src/cli/cmd/export.ts +292 -0
  88. package/src/cli/cmd/generate.ts +54 -0
  89. package/src/cli/cmd/github.handler.ts +1594 -0
  90. package/src/cli/cmd/github.shared.ts +30 -0
  91. package/src/cli/cmd/github.ts +42 -0
  92. package/src/cli/cmd/import.ts +224 -0
  93. package/src/cli/cmd/mcp.ts +859 -0
  94. package/src/cli/cmd/models.ts +66 -0
  95. package/src/cli/cmd/plug.ts +230 -0
  96. package/src/cli/cmd/pr.ts +115 -0
  97. package/src/cli/cmd/prompt-display.ts +1 -0
  98. package/src/cli/cmd/providers.ts +550 -0
  99. package/src/cli/cmd/run/demo.ts +1274 -0
  100. package/src/cli/cmd/run/entry.body.ts +205 -0
  101. package/src/cli/cmd/run/footer.command.tsx +1088 -0
  102. package/src/cli/cmd/run/footer.menu.tsx +353 -0
  103. package/src/cli/cmd/run/footer.permission.tsx +482 -0
  104. package/src/cli/cmd/run/footer.prompt.tsx +1351 -0
  105. package/src/cli/cmd/run/footer.question.tsx +580 -0
  106. package/src/cli/cmd/run/footer.subagent.tsx +180 -0
  107. package/src/cli/cmd/run/footer.ts +1153 -0
  108. package/src/cli/cmd/run/footer.view.tsx +992 -0
  109. package/src/cli/cmd/run/footer.width.ts +27 -0
  110. package/src/cli/cmd/run/otel.ts +117 -0
  111. package/src/cli/cmd/run/permission.shared.ts +256 -0
  112. package/src/cli/cmd/run/prompt.editor.ts +157 -0
  113. package/src/cli/cmd/run/prompt.shared.ts +153 -0
  114. package/src/cli/cmd/run/question.shared.ts +340 -0
  115. package/src/cli/cmd/run/runtime.boot.ts +202 -0
  116. package/src/cli/cmd/run/runtime.lifecycle.ts +431 -0
  117. package/src/cli/cmd/run/runtime.queue.ts +349 -0
  118. package/src/cli/cmd/run/runtime.shared.ts +17 -0
  119. package/src/cli/cmd/run/runtime.stdin.ts +37 -0
  120. package/src/cli/cmd/run/runtime.ts +905 -0
  121. package/src/cli/cmd/run/scrollback.shared.ts +92 -0
  122. package/src/cli/cmd/run/scrollback.surface.ts +448 -0
  123. package/src/cli/cmd/run/scrollback.writer.tsx +353 -0
  124. package/src/cli/cmd/run/splash.ts +284 -0
  125. package/src/cli/cmd/run/stream.transport.ts +1465 -0
  126. package/src/cli/cmd/run/stream.ts +175 -0
  127. package/src/cli/cmd/run/subagent-data.ts +876 -0
  128. package/src/cli/cmd/run/theme.ts +690 -0
  129. package/src/cli/cmd/run/tool.ts +1489 -0
  130. package/src/cli/cmd/run/trace.ts +94 -0
  131. package/src/cli/cmd/run/turn-summary.ts +47 -0
  132. package/src/cli/cmd/run/types.ts +350 -0
  133. package/src/cli/cmd/run/variant.shared.ts +215 -0
  134. package/src/cli/cmd/run.ts +897 -0
  135. package/src/cli/cmd/serve.ts +24 -0
  136. package/src/cli/cmd/stats.ts +393 -0
  137. package/src/cli/cmd/tui.ts +264 -0
  138. package/src/cli/cmd/uninstall.ts +353 -0
  139. package/src/cli/cmd/upgrade.ts +74 -0
  140. package/src/cli/cmd/web.ts +84 -0
  141. package/src/cli/effect/prompt.ts +37 -0
  142. package/src/cli/effect-cmd.ts +96 -0
  143. package/src/cli/error.ts +118 -0
  144. package/src/cli/heap.ts +66 -0
  145. package/src/cli/logo.ts +1 -0
  146. package/src/cli/network.ts +64 -0
  147. package/src/cli/tui/layer.ts +7 -0
  148. package/src/cli/tui/photon_rs_bg-bq08arze.wasm +0 -0
  149. package/src/cli/tui/tree-sitter-3jzf13jk.wasm +0 -0
  150. package/src/cli/tui/tree-sitter-bash-hq5s6fxb.wasm +0 -0
  151. package/src/cli/tui/tree-sitter-powershell-ryb2ffqs.wasm +0 -0
  152. package/src/cli/tui/worker.ts +99 -0
  153. package/src/cli/ui.ts +144 -0
  154. package/src/cli/upgrade.ts +53 -0
  155. package/src/command/index.ts +189 -0
  156. package/src/command/template/initialize.txt +66 -0
  157. package/src/command/template/review.txt +101 -0
  158. package/src/command/terminal-ai-commands.ts +567 -0
  159. package/src/config/agent.ts +68 -0
  160. package/src/config/command.ts +45 -0
  161. package/src/config/config.ts +686 -0
  162. package/src/config/entry-name.ts +19 -0
  163. package/src/config/managed.ts +77 -0
  164. package/src/config/markdown.ts +36 -0
  165. package/src/config/parse.ts +79 -0
  166. package/src/config/paths.ts +47 -0
  167. package/src/config/plugin.ts +79 -0
  168. package/src/config/reference.ts +48 -0
  169. package/src/config/tui-cwd.ts +5 -0
  170. package/src/config/tui-host-attention.ts +21 -0
  171. package/src/config/tui-migrate.ts +156 -0
  172. package/src/config/tui.ts +294 -0
  173. package/src/config/variable.ts +91 -0
  174. package/src/control-plane/adapters/index.ts +41 -0
  175. package/src/control-plane/adapters/worktree.ts +96 -0
  176. package/src/control-plane/dev/README.md +19 -0
  177. package/src/control-plane/dev/debug-workspace-plugin.ts +73 -0
  178. package/src/control-plane/types.ts +59 -0
  179. package/src/control-plane/util.ts +39 -0
  180. package/src/control-plane/workspace-adapter-runtime.ts +51 -0
  181. package/src/control-plane/workspace-context.ts +26 -0
  182. package/src/control-plane/workspace.ts +1075 -0
  183. package/src/desktop/agent.ts +147 -0
  184. package/src/desktop/index.ts +247 -0
  185. package/src/desktop/platform.ts +97 -0
  186. package/src/desktop/stream.ts +64 -0
  187. package/src/desktop/vision.ts +52 -0
  188. package/src/desktop/websocket.ts +120 -0
  189. package/src/effect/app-runtime.ts +133 -0
  190. package/src/effect/bootstrap-runtime.ts +23 -0
  191. package/src/effect/bridge.ts +84 -0
  192. package/src/effect/config-service.ts +67 -0
  193. package/src/effect/instance-ref.ts +11 -0
  194. package/src/effect/instance-registry.ts +12 -0
  195. package/src/effect/instance-state.ts +72 -0
  196. package/src/effect/promise.ts +17 -0
  197. package/src/effect/run-service.ts +47 -0
  198. package/src/effect/runner.ts +217 -0
  199. package/src/effect/runtime-flags.ts +76 -0
  200. package/src/env/index.ts +40 -0
  201. package/src/event-v2-bridge.ts +76 -0
  202. package/src/format/formatter.ts +404 -0
  203. package/src/format/index.ts +212 -0
  204. package/src/git/index.ts +347 -0
  205. package/src/id/id.ts +80 -0
  206. package/src/ide/index.ts +70 -0
  207. package/src/image/image.ts +177 -0
  208. package/src/index.ts +208 -0
  209. package/src/installation/index.ts +350 -0
  210. package/src/lsp/client.ts +686 -0
  211. package/src/lsp/diagnostic.ts +29 -0
  212. package/src/lsp/language.ts +121 -0
  213. package/src/lsp/launch.ts +21 -0
  214. package/src/lsp/lsp.ts +517 -0
  215. package/src/lsp/server.ts +2116 -0
  216. package/src/markdown.d.ts +4 -0
  217. package/src/mcp/auth.ts +171 -0
  218. package/src/mcp/builtin.ts +92 -0
  219. package/src/mcp/index.ts +1000 -0
  220. package/src/mcp/oauth-callback.ts +232 -0
  221. package/src/mcp/oauth-provider.ts +217 -0
  222. package/src/node.ts +5 -0
  223. package/src/patch/index.ts +689 -0
  224. package/src/permission/arity.ts +163 -0
  225. package/src/permission/evaluate.ts +1 -0
  226. package/src/permission/index.ts +230 -0
  227. package/src/plugin/azure.ts +26 -0
  228. package/src/plugin/cloudflare.ts +76 -0
  229. package/src/plugin/digitalocean.ts +391 -0
  230. package/src/plugin/github-copilot/copilot.ts +417 -0
  231. package/src/plugin/github-copilot/models.ts +246 -0
  232. package/src/plugin/index.ts +320 -0
  233. package/src/plugin/install.ts +439 -0
  234. package/src/plugin/loader.ts +237 -0
  235. package/src/plugin/meta.ts +188 -0
  236. package/src/plugin/openai/README.md +31 -0
  237. package/src/plugin/openai/codex.ts +647 -0
  238. package/src/plugin/openai/ws-pool.ts +290 -0
  239. package/src/plugin/openai/ws.ts +381 -0
  240. package/src/plugin/shared.ts +323 -0
  241. package/src/plugin/tui/internal.ts +12 -0
  242. package/src/plugin/tui/runtime.ts +1174 -0
  243. package/src/plugin/xai.ts +742 -0
  244. package/src/project/bootstrap-service.ts +9 -0
  245. package/src/project/bootstrap.ts +80 -0
  246. package/src/project/instance-context.ts +24 -0
  247. package/src/project/instance-layer.ts +11 -0
  248. package/src/project/instance-runtime.ts +16 -0
  249. package/src/project/instance-store.ts +207 -0
  250. package/src/project/project.ts +520 -0
  251. package/src/project/vcs.ts +435 -0
  252. package/src/provider/auth.ts +230 -0
  253. package/src/provider/error.ts +188 -0
  254. package/src/provider/model-status.ts +8 -0
  255. package/src/provider/provider.ts +2037 -0
  256. package/src/provider/transform.ts +1367 -0
  257. package/src/pty-preparation.ts +30 -0
  258. package/src/question/index.ts +229 -0
  259. package/src/question/schema.ts +10 -0
  260. package/src/reference/reference.ts +239 -0
  261. package/src/reference/repository-cache.ts +320 -0
  262. package/src/server/auth.ts +48 -0
  263. package/src/server/cors.ts +34 -0
  264. package/src/server/event.ts +13 -0
  265. package/src/server/global-lifecycle.ts +37 -0
  266. package/src/server/init-projectors.ts +3 -0
  267. package/src/server/mdns.ts +60 -0
  268. package/src/server/projectors.ts +1 -0
  269. package/src/server/proxy-util.ts +48 -0
  270. package/src/server/routes/instance/httpapi/AGENTS.md +39 -0
  271. package/src/server/routes/instance/httpapi/api.ts +80 -0
  272. package/src/server/routes/instance/httpapi/errors.ts +193 -0
  273. package/src/server/routes/instance/httpapi/groups/config.ts +65 -0
  274. package/src/server/routes/instance/httpapi/groups/control-plane.ts +35 -0
  275. package/src/server/routes/instance/httpapi/groups/control.ts +76 -0
  276. package/src/server/routes/instance/httpapi/groups/event.ts +29 -0
  277. package/src/server/routes/instance/httpapi/groups/experimental.ts +260 -0
  278. package/src/server/routes/instance/httpapi/groups/file.ts +172 -0
  279. package/src/server/routes/instance/httpapi/groups/global.ts +138 -0
  280. package/src/server/routes/instance/httpapi/groups/instance.ts +206 -0
  281. package/src/server/routes/instance/httpapi/groups/mcp.ts +156 -0
  282. package/src/server/routes/instance/httpapi/groups/metadata.ts +18 -0
  283. package/src/server/routes/instance/httpapi/groups/permission.ts +61 -0
  284. package/src/server/routes/instance/httpapi/groups/project-copy.ts +88 -0
  285. package/src/server/routes/instance/httpapi/groups/project.ts +93 -0
  286. package/src/server/routes/instance/httpapi/groups/provider.ts +101 -0
  287. package/src/server/routes/instance/httpapi/groups/pty.ts +172 -0
  288. package/src/server/routes/instance/httpapi/groups/query.ts +12 -0
  289. package/src/server/routes/instance/httpapi/groups/question.ts +74 -0
  290. package/src/server/routes/instance/httpapi/groups/reference.ts +60 -0
  291. package/src/server/routes/instance/httpapi/groups/sync.ts +113 -0
  292. package/src/server/routes/instance/httpapi/groups/tui.ts +208 -0
  293. package/src/server/routes/instance/httpapi/groups/workspace.ts +141 -0
  294. package/src/server/routes/instance/httpapi/handlers/config.ts +34 -0
  295. package/src/server/routes/instance/httpapi/handlers/control-plane.ts +37 -0
  296. package/src/server/routes/instance/httpapi/handlers/control.ts +37 -0
  297. package/src/server/routes/instance/httpapi/handlers/event.ts +102 -0
  298. package/src/server/routes/instance/httpapi/handlers/experimental.ts +187 -0
  299. package/src/server/routes/instance/httpapi/handlers/file.ts +128 -0
  300. package/src/server/routes/instance/httpapi/handlers/global.ts +157 -0
  301. package/src/server/routes/instance/httpapi/handlers/instance.ts +110 -0
  302. package/src/server/routes/instance/httpapi/handlers/mcp.ts +111 -0
  303. package/src/server/routes/instance/httpapi/handlers/permission.ts +41 -0
  304. package/src/server/routes/instance/httpapi/handlers/project-copy.ts +157 -0
  305. package/src/server/routes/instance/httpapi/handlers/project.ts +63 -0
  306. package/src/server/routes/instance/httpapi/handlers/provider.ts +113 -0
  307. package/src/server/routes/instance/httpapi/handlers/pty.ts +258 -0
  308. package/src/server/routes/instance/httpapi/handlers/question.ts +54 -0
  309. package/src/server/routes/instance/httpapi/handlers/reference.ts +27 -0
  310. package/src/server/routes/instance/httpapi/handlers/sync.ts +95 -0
  311. package/src/server/routes/instance/httpapi/handlers/tui.ts +131 -0
  312. package/src/server/routes/instance/httpapi/handlers/workspace.ts +102 -0
  313. package/src/server/routes/instance/httpapi/lifecycle.ts +57 -0
  314. package/src/server/routes/instance/httpapi/middleware/authorization.ts +150 -0
  315. package/src/server/routes/instance/httpapi/middleware/compression.ts +64 -0
  316. package/src/server/routes/instance/httpapi/middleware/cors-vary.ts +29 -0
  317. package/src/server/routes/instance/httpapi/middleware/error.ts +36 -0
  318. package/src/server/routes/instance/httpapi/middleware/fence.ts +25 -0
  319. package/src/server/routes/instance/httpapi/middleware/instance-context.ts +43 -0
  320. package/src/server/routes/instance/httpapi/middleware/proxy.ts +108 -0
  321. package/src/server/routes/instance/httpapi/middleware/schema-error.ts +42 -0
  322. package/src/server/routes/instance/httpapi/middleware/workspace-routing.ts +250 -0
  323. package/src/server/routes/instance/httpapi/public.ts +535 -0
  324. package/src/server/routes/instance/httpapi/server.ts +281 -0
  325. package/src/server/routes/instance/httpapi/websocket-tracker.ts +57 -0
  326. package/src/server/server.ts +218 -0
  327. package/src/server/shared/fence.ts +68 -0
  328. package/src/server/shared/pty-ticket.ts +15 -0
  329. package/src/server/shared/public-ui.ts +12 -0
  330. package/src/server/shared/tui-control.ts +28 -0
  331. package/src/server/shared/ui.ts +108 -0
  332. package/src/server/shared/workspace-routing.ts +38 -0
  333. package/src/server/tui-event.ts +53 -0
  334. package/src/share/share-next.ts +379 -0
  335. package/src/shell/shell.ts +215 -0
  336. package/src/skill/discovery.ts +115 -0
  337. package/src/skill/index.ts +382 -0
  338. package/src/snapshot/index.ts +762 -0
  339. package/src/sql.d.ts +4 -0
  340. package/src/storage/schema.ts +5 -0
  341. package/src/storage/storage.ts +329 -0
  342. package/src/swarm/evolution.ts +304 -0
  343. package/src/swarm/index.ts +7 -0
  344. package/src/swarm/learning.ts +736 -0
  345. package/src/swarm/vision.ts +131 -0
  346. package/src/sync/README.md +179 -0
  347. package/src/sync/schema.ts +11 -0
  348. package/src/temporary.ts +33 -0
  349. package/src/tool/apply_patch.ts +313 -0
  350. package/src/tool/apply_patch.txt +33 -0
  351. package/src/tool/browser_click.ts +51 -0
  352. package/src/tool/browser_drag.ts +76 -0
  353. package/src/tool/browser_evaluate.ts +51 -0
  354. package/src/tool/browser_hover.ts +51 -0
  355. package/src/tool/browser_navigate.ts +45 -0
  356. package/src/tool/browser_screenshot.ts +66 -0
  357. package/src/tool/browser_select.ts +52 -0
  358. package/src/tool/browser_type.ts +52 -0
  359. package/src/tool/browser_wait.ts +60 -0
  360. package/src/tool/desktop_clipboard.ts +82 -0
  361. package/src/tool/desktop_control.ts +160 -0
  362. package/src/tool/desktop_record.ts +93 -0
  363. package/src/tool/desktop_replay.ts +99 -0
  364. package/src/tool/desktop_screen_record.ts +143 -0
  365. package/src/tool/desktop_window.ts +142 -0
  366. package/src/tool/desktop_workflow.ts +81 -0
  367. package/src/tool/edit.ts +737 -0
  368. package/src/tool/edit.txt +10 -0
  369. package/src/tool/external-directory.ts +49 -0
  370. package/src/tool/glob.ts +84 -0
  371. package/src/tool/glob.txt +6 -0
  372. package/src/tool/grep.ts +140 -0
  373. package/src/tool/grep.txt +8 -0
  374. package/src/tool/invalid.ts +21 -0
  375. package/src/tool/json-schema.ts +164 -0
  376. package/src/tool/lsp.ts +113 -0
  377. package/src/tool/lsp.txt +24 -0
  378. package/src/tool/mcp-websearch.ts +96 -0
  379. package/src/tool/open_app.ts +55 -0
  380. package/src/tool/open_terminal.ts +69 -0
  381. package/src/tool/plan-enter.txt +14 -0
  382. package/src/tool/plan-exit.txt +13 -0
  383. package/src/tool/plan.ts +79 -0
  384. package/src/tool/question.ts +44 -0
  385. package/src/tool/question.txt +10 -0
  386. package/src/tool/read.ts +392 -0
  387. package/src/tool/read.txt +14 -0
  388. package/src/tool/registry.ts +527 -0
  389. package/src/tool/schema.ts +14 -0
  390. package/src/tool/screenshot.ts +72 -0
  391. package/src/tool/shell/id.ts +19 -0
  392. package/src/tool/shell/prompt.ts +307 -0
  393. package/src/tool/shell/shell.txt +21 -0
  394. package/src/tool/shell.ts +669 -0
  395. package/src/tool/skill.ts +72 -0
  396. package/src/tool/skill.txt +5 -0
  397. package/src/tool/task.ts +339 -0
  398. package/src/tool/task.txt +19 -0
  399. package/src/tool/todo.ts +57 -0
  400. package/src/tool/todowrite.txt +44 -0
  401. package/src/tool/tool.ts +180 -0
  402. package/src/tool/truncate.ts +160 -0
  403. package/src/tool/truncation-dir.ts +4 -0
  404. package/src/tool/visual_qa.ts +77 -0
  405. package/src/tool/webfetch.ts +192 -0
  406. package/src/tool/webfetch.txt +13 -0
  407. package/src/tool/websearch.ts +143 -0
  408. package/src/tool/websearch.txt +14 -0
  409. package/src/tool/write.ts +104 -0
  410. package/src/tool/write.txt +8 -0
  411. package/src/util/archive.ts +17 -0
  412. package/src/util/bom.ts +27 -0
  413. package/src/util/data-url.ts +9 -0
  414. package/src/util/defer.ts +10 -0
  415. package/src/util/effect-http-client.ts +11 -0
  416. package/src/util/error.ts +1 -0
  417. package/src/util/filesystem.ts +251 -0
  418. package/src/util/iife.ts +3 -0
  419. package/src/util/lazy.ts +20 -0
  420. package/src/util/local-context.ts +25 -0
  421. package/src/util/locale.ts +2 -0
  422. package/src/util/media.ts +26 -0
  423. package/src/util/process.ts +177 -0
  424. package/src/util/proxy-env.ts +72 -0
  425. package/src/util/queue.ts +32 -0
  426. package/src/util/record.ts +1 -0
  427. package/src/util/repository.ts +232 -0
  428. package/src/util/rpc.ts +66 -0
  429. package/src/util/signal.ts +12 -0
  430. package/src/util/sys-monitor.ts +223 -0
  431. package/src/util/timeout.ts +13 -0
  432. package/src/util/wildcard.ts +59 -0
  433. package/src/worktree/index.ts +645 -0
  434. package/sst-env.d.ts +10 -0
  435. package/test/AGENTS.md +204 -0
  436. package/test/EFFECT_TEST_MIGRATION.md +169 -0
  437. package/test/account/repo.test.ts +353 -0
  438. package/test/account/service.test.ts +453 -0
  439. package/test/acp/config-option.test.ts +229 -0
  440. package/test/acp/content.test.ts +201 -0
  441. package/test/acp/directory.test.ts +186 -0
  442. package/test/acp/error.test.ts +67 -0
  443. package/test/acp/event.test.ts +743 -0
  444. package/test/acp/permission.test.ts +273 -0
  445. package/test/acp/tool.test.ts +210 -0
  446. package/test/acp/usage.test.ts +315 -0
  447. package/test/agent/agent.test.ts +711 -0
  448. package/test/agent/plan-mode-subagent-bypass.test.ts +213 -0
  449. package/test/agent/plugin-agent-regression.test.ts +62 -0
  450. package/test/auth/auth.test.ts +77 -0
  451. package/test/background/job.test.ts +243 -0
  452. package/test/cli/account.test.ts +30 -0
  453. package/test/cli/acp/acp-test-client.ts +97 -0
  454. package/test/cli/acp/config-options.test.ts +103 -0
  455. package/test/cli/acp/helpers.ts +96 -0
  456. package/test/cli/acp/initialize-auth.test.ts +61 -0
  457. package/test/cli/acp/lifecycle.test.ts +118 -0
  458. package/test/cli/acp/prompt-content.test.ts +97 -0
  459. package/test/cli/acp/skills.test.ts +38 -0
  460. package/test/cli/cmd/tui/attention.test.ts +484 -0
  461. package/test/cli/effect-cmd-instance-als.test.ts +39 -0
  462. package/test/cli/error.test.ts +95 -0
  463. package/test/cli/github-action.test.ts +199 -0
  464. package/test/cli/github-remote.test.ts +90 -0
  465. package/test/cli/help/__snapshots__/help-snapshots.test.ts.snap +631 -0
  466. package/test/cli/help/help-snapshots.test.ts +137 -0
  467. package/test/cli/import.test.ts +54 -0
  468. package/test/cli/mcp-add.test.ts +74 -0
  469. package/test/cli/plugin-auth-picker.test.ts +120 -0
  470. package/test/cli/run/entry.body.test.ts +536 -0
  471. package/test/cli/run/footer.menu.test.ts +43 -0
  472. package/test/cli/run/footer.view.test.tsx +1336 -0
  473. package/test/cli/run/footer.width.test.ts +35 -0
  474. package/test/cli/run/permission.shared.test.ts +144 -0
  475. package/test/cli/run/prompt.editor.test.ts +101 -0
  476. package/test/cli/run/prompt.shared.test.ts +101 -0
  477. package/test/cli/run/question.shared.test.ts +115 -0
  478. package/test/cli/run/run-process.test.ts +84 -0
  479. package/test/cli/run/runtime.boot.test.ts +283 -0
  480. package/test/cli/run/runtime.queue.test.ts +481 -0
  481. package/test/cli/run/runtime.stdin.test.ts +71 -0
  482. package/test/cli/run/runtime.test.ts +238 -0
  483. package/test/cli/run/scrollback.surface.test.ts +1065 -0
  484. package/test/cli/run/stream.test.ts +56 -0
  485. package/test/cli/run/stream.transport.test.ts +2363 -0
  486. package/test/cli/run/subagent-data.test.ts +547 -0
  487. package/test/cli/run/theme.test.ts +177 -0
  488. package/test/cli/run/variant.shared.test.ts +217 -0
  489. package/test/cli/serve/serve-process.test.ts +61 -0
  490. package/test/cli/smokes/read-only.test.ts +115 -0
  491. package/test/cli/tui/attach.test.ts +11 -0
  492. package/test/cli/tui/editor-context-zed.test.ts +379 -0
  493. package/test/cli/tui/editor-context.test.tsx +297 -0
  494. package/test/cli/tui/plugin-add.test.ts +110 -0
  495. package/test/cli/tui/plugin-install.test.ts +87 -0
  496. package/test/cli/tui/plugin-lifecycle.test.ts +224 -0
  497. package/test/cli/tui/plugin-loader-entrypoint.test.ts +485 -0
  498. package/test/cli/tui/plugin-loader-pure.test.ts +72 -0
  499. package/test/cli/tui/plugin-loader.test.ts +1332 -0
  500. package/test/cli/tui/plugin-toggle.test.ts +264 -0
  501. package/test/cli/tui/thread.test.ts +36 -0
  502. package/test/cli.test.ts +7 -0
  503. package/test/command/acp-slash-detect.test.ts +202 -0
  504. package/test/command/demo-slash.test.ts +213 -0
  505. package/test/command/slash-head.test.ts +232 -0
  506. package/test/command/slash-parsing.test.ts +193 -0
  507. package/test/command/terminal-ai-commands.test.ts +536 -0
  508. package/test/config/agent-color.test.ts +47 -0
  509. package/test/config/config.test.ts +1994 -0
  510. package/test/config/entry-name.test.ts +57 -0
  511. package/test/config/fixtures/empty-frontmatter.md +4 -0
  512. package/test/config/fixtures/frontmatter.md +28 -0
  513. package/test/config/fixtures/markdown-header.md +11 -0
  514. package/test/config/fixtures/no-frontmatter.md +1 -0
  515. package/test/config/fixtures/weird-model-id.md +13 -0
  516. package/test/config/lsp.test.ts +69 -0
  517. package/test/config/markdown.test.ts +228 -0
  518. package/test/config/plugin.test.ts +0 -0
  519. package/test/config/tui.test.ts +886 -0
  520. package/test/control-plane/adapters.test.ts +71 -0
  521. package/test/control-plane/workspace.test.ts +1704 -0
  522. package/test/effect/app-runtime-logger.test.ts +105 -0
  523. package/test/effect/config-service.test.ts +65 -0
  524. package/test/effect/instance-state.test.ts +391 -0
  525. package/test/effect/run-service.test.ts +89 -0
  526. package/test/effect/runner.test.ts +514 -0
  527. package/test/effect/runtime-flags.test.ts +373 -0
  528. package/test/fake/account.ts +9 -0
  529. package/test/fake/auth.ts +8 -0
  530. package/test/fake/npm.ts +8 -0
  531. package/test/fake/provider.ts +82 -0
  532. package/test/fake/skill.ts +8 -0
  533. package/test/filesystem/filesystem.test.ts +319 -0
  534. package/test/fixture/agent-plugin.constants.ts +6 -0
  535. package/test/fixture/agent-plugin.ts +12 -0
  536. package/test/fixture/config.ts +23 -0
  537. package/test/fixture/db.ts +11 -0
  538. package/test/fixture/fixture.test.ts +26 -0
  539. package/test/fixture/fixture.ts +224 -0
  540. package/test/fixture/flag.ts +20 -0
  541. package/test/fixture/flock-worker.ts +72 -0
  542. package/test/fixture/lsp/fake-lsp-server.js +249 -0
  543. package/test/fixture/plug-worker.ts +96 -0
  544. package/test/fixture/plugin-meta-worker.ts +19 -0
  545. package/test/fixture/plugin.ts +10 -0
  546. package/test/fixture/skills/agents-sdk/SKILL.md +152 -0
  547. package/test/fixture/skills/agents-sdk/references/callable.md +92 -0
  548. package/test/fixture/skills/cloudflare/SKILL.md +211 -0
  549. package/test/fixture/skills/index.json +6 -0
  550. package/test/fixture/tui-environment.tsx +32 -0
  551. package/test/fixture/tui-plugin.ts +357 -0
  552. package/test/fixture/tui-runtime.ts +56 -0
  553. package/test/fixture/tui-sdk.ts +82 -0
  554. package/test/fixture/workspace.ts +30 -0
  555. package/test/format/format.test.ts +228 -0
  556. package/test/git/git.test.ts +178 -0
  557. package/test/ide/ide.test.ts +82 -0
  558. package/test/image/fixtures/picture-5mb-base64.png +0 -0
  559. package/test/image/image.test.ts +123 -0
  560. package/test/installation/installation.test.ts +231 -0
  561. package/test/lib/cli-process.ts +459 -0
  562. package/test/lib/effect.ts +177 -0
  563. package/test/lib/filesystem.ts +10 -0
  564. package/test/lib/llm-server.ts +771 -0
  565. package/test/lib/snapshot.ts +73 -0
  566. package/test/lib/test-provider.ts +37 -0
  567. package/test/lib/websocket.ts +46 -0
  568. package/test/lsp/client.test.ts +493 -0
  569. package/test/lsp/index.test.ts +232 -0
  570. package/test/lsp/jdtls-root.test.ts +459 -0
  571. package/test/lsp/launch.test.ts +22 -0
  572. package/test/lsp/lifecycle.test.ts +160 -0
  573. package/test/mcp/auth.test.ts +78 -0
  574. package/test/mcp/builtin.test.ts +95 -0
  575. package/test/mcp/headers.test.ts +126 -0
  576. package/test/mcp/lifecycle.test.ts +999 -0
  577. package/test/mcp/oauth-auto-connect.test.ts +274 -0
  578. package/test/mcp/oauth-browser.test.ts +232 -0
  579. package/test/mcp/oauth-callback.test.ts +34 -0
  580. package/test/mcp/oauth-provider.test.ts +61 -0
  581. package/test/patch/patch.test.ts +383 -0
  582. package/test/permission/arity.test.ts +33 -0
  583. package/test/permission/next.test.ts +1176 -0
  584. package/test/permission-task.test.ts +318 -0
  585. package/test/plugin/auth-override.test.ts +105 -0
  586. package/test/plugin/cloudflare.test.ts +68 -0
  587. package/test/plugin/codex.test.ts +247 -0
  588. package/test/plugin/github-copilot-models.test.ts +332 -0
  589. package/test/plugin/install-concurrency.test.ts +140 -0
  590. package/test/plugin/install.test.ts +573 -0
  591. package/test/plugin/loader-shared.test.ts +1303 -0
  592. package/test/plugin/meta.test.ts +137 -0
  593. package/test/plugin/openai-rollout.test.ts +17 -0
  594. package/test/plugin/openai-ws.test.ts +877 -0
  595. package/test/plugin/shared.test.ts +88 -0
  596. package/test/plugin/trigger.test.ts +120 -0
  597. package/test/plugin/workspace-adapter.test.ts +137 -0
  598. package/test/plugin/xai.test.ts +634 -0
  599. package/test/preload.ts +99 -0
  600. package/test/project/instance-bootstrap.test.ts +110 -0
  601. package/test/project/instance.test.ts +245 -0
  602. package/test/project/migrate-global.test.ts +170 -0
  603. package/test/project/project-directory.test.ts +169 -0
  604. package/test/project/project.test.ts +818 -0
  605. package/test/project/vcs.test.ts +336 -0
  606. package/test/project/worktree-remove.test.ts +126 -0
  607. package/test/project/worktree.test.ts +320 -0
  608. package/test/provider/amazon-bedrock.test.ts +360 -0
  609. package/test/provider/cf-ai-gateway-e2e.test.ts +132 -0
  610. package/test/provider/digitalocean.test.ts +123 -0
  611. package/test/provider/gitlab-duo.test.ts +412 -0
  612. package/test/provider/header-timeout.test.ts +233 -0
  613. package/test/provider/model-status.test.ts +61 -0
  614. package/test/provider/provider.test.ts +1795 -0
  615. package/test/provider/transform.test.ts +3937 -0
  616. package/test/pty/pty-shell.test.ts +102 -0
  617. package/test/question/question.test.ts +465 -0
  618. package/test/reference/reference.test.ts +311 -0
  619. package/test/server/AGENTS.md +15 -0
  620. package/test/server/auth.test.ts +59 -0
  621. package/test/server/global-bus.ts +31 -0
  622. package/test/server/httpapi-authorization.test.ts +174 -0
  623. package/test/server/httpapi-compression.test.ts +154 -0
  624. package/test/server/httpapi-config.test.ts +113 -0
  625. package/test/server/httpapi-control-plane.test.ts +63 -0
  626. package/test/server/httpapi-cors-vary.test.ts +66 -0
  627. package/test/server/httpapi-cors.test.ts +122 -0
  628. package/test/server/httpapi-error-middleware.test.ts +96 -0
  629. package/test/server/httpapi-event.test.ts +97 -0
  630. package/test/server/httpapi-exercise/assertions.ts +64 -0
  631. package/test/server/httpapi-exercise/backend.ts +144 -0
  632. package/test/server/httpapi-exercise/dsl.ts +210 -0
  633. package/test/server/httpapi-exercise/environment.ts +40 -0
  634. package/test/server/httpapi-exercise/index.ts +1538 -0
  635. package/test/server/httpapi-exercise/report.ts +66 -0
  636. package/test/server/httpapi-exercise/routing.ts +96 -0
  637. package/test/server/httpapi-exercise/runner.ts +267 -0
  638. package/test/server/httpapi-exercise/runtime.ts +52 -0
  639. package/test/server/httpapi-exercise/types.ts +123 -0
  640. package/test/server/httpapi-experimental.test.ts +300 -0
  641. package/test/server/httpapi-file.test.ts +76 -0
  642. package/test/server/httpapi-global.test.ts +66 -0
  643. package/test/server/httpapi-instance-context.test.ts +347 -0
  644. package/test/server/httpapi-instance-route-auth.test.ts +84 -0
  645. package/test/server/httpapi-instance.test.ts +265 -0
  646. package/test/server/httpapi-layer.ts +33 -0
  647. package/test/server/httpapi-listen.test.ts +415 -0
  648. package/test/server/httpapi-mcp-oauth.test.ts +73 -0
  649. package/test/server/httpapi-mcp.test.ts +234 -0
  650. package/test/server/httpapi-mdns.test.ts +82 -0
  651. package/test/server/httpapi-promptasync-context.test.ts +222 -0
  652. package/test/server/httpapi-provider.test.ts +403 -0
  653. package/test/server/httpapi-pty.test.ts +275 -0
  654. package/test/server/httpapi-public-openapi.test.ts +297 -0
  655. package/test/server/httpapi-query-schema-drift.test.ts +330 -0
  656. package/test/server/httpapi-reference.test.ts +56 -0
  657. package/test/server/httpapi-schema-error-body.test.ts +165 -0
  658. package/test/server/httpapi-sdk.test.ts +909 -0
  659. package/test/server/httpapi-sync.test.ts +154 -0
  660. package/test/server/httpapi-ui.test.ts +456 -0
  661. package/test/server/httpapi-v2-location.test.ts +85 -0
  662. package/test/server/httpapi-workspace-routing.test.ts +554 -0
  663. package/test/server/httpapi-workspace.test.ts +515 -0
  664. package/test/server/project-copy.test.ts +101 -0
  665. package/test/server/project-init-git.test.ts +117 -0
  666. package/test/server/proxy-util.test.ts +113 -0
  667. package/test/server/sdk-error-shape.test.ts +84 -0
  668. package/test/server/sdk-v1-smoke.test.ts +60 -0
  669. package/test/server/workspace-proxy.test.ts +181 -0
  670. package/test/server/workspace-routing.test.ts +94 -0
  671. package/test/server/worktree-endpoint-repro.test.ts +307 -0
  672. package/test/share/share-next.test.ts +344 -0
  673. package/test/shell/shell.test.ts +99 -0
  674. package/test/skill/discovery.test.ts +139 -0
  675. package/test/skill/skill.test.ts +571 -0
  676. package/test/snapshot/snapshot.test.ts +1121 -0
  677. package/test/storage/storage.test.ts +296 -0
  678. package/test/storage/workspace-time-migration.test.ts +50 -0
  679. package/test/tool/__snapshots__/parameters.test.ts.snap +484 -0
  680. package/test/tool/__snapshots__/tool.test.ts.snap +9 -0
  681. package/test/tool/apply_patch.test.ts +533 -0
  682. package/test/tool/browser.integration.test.ts +141 -0
  683. package/test/tool/desktop.integration.test.ts +129 -0
  684. package/test/tool/desktop.test.ts +85 -0
  685. package/test/tool/edit.test.ts +578 -0
  686. package/test/tool/external-directory.test.ts +167 -0
  687. package/test/tool/fixtures/large-image.png +0 -0
  688. package/test/tool/fixtures/models-api.json +117299 -0
  689. package/test/tool/glob.test.ts +188 -0
  690. package/test/tool/grep.test.ts +266 -0
  691. package/test/tool/lsp.test.ts +181 -0
  692. package/test/tool/parameters.test.ts +293 -0
  693. package/test/tool/question.test.ts +138 -0
  694. package/test/tool/read.test.ts +659 -0
  695. package/test/tool/registry.test.ts +539 -0
  696. package/test/tool/shell.test.ts +1256 -0
  697. package/test/tool/skill.test.ts +135 -0
  698. package/test/tool/task.test.ts +901 -0
  699. package/test/tool/tool-define.test.ts +153 -0
  700. package/test/tool/truncation.test.ts +266 -0
  701. package/test/tool/webfetch.test.ts +113 -0
  702. package/test/tool/websearch.test.ts +99 -0
  703. package/test/tool/write.test.ts +276 -0
  704. package/test/util/data-url.test.ts +14 -0
  705. package/test/util/error.test.ts +16 -0
  706. package/test/util/filesystem.test.ts +656 -0
  707. package/test/util/glob.test.ts +164 -0
  708. package/test/util/iife.test.ts +36 -0
  709. package/test/util/lazy.test.ts +50 -0
  710. package/test/util/log.test.ts +77 -0
  711. package/test/util/module.test.ts +59 -0
  712. package/test/util/process.test.ts +128 -0
  713. package/test/util/repository.test.ts +93 -0
  714. package/test/util/timeout.test.ts +21 -0
  715. package/test/util/wildcard.test.ts +90 -0
  716. package/tsconfig.json +16 -0
@@ -0,0 +1,762 @@
1
+ import { Cause, Duration, Effect, Layer, Schedule, Schema, Semaphore, Context } from "effect"
2
+ import { ChildProcess, ChildProcessSpawner } from "effect/unstable/process"
3
+ import { formatPatch, structuredPatch } from "diff"
4
+ import path from "path"
5
+ import { AppProcess } from "@octocode-ai/core/process"
6
+ import { InstanceState } from "@/effect/instance-state"
7
+ import { FSUtil } from "@octocode-ai/core/fs-util"
8
+ import { Hash } from "@octocode-ai/core/util/hash"
9
+ import { Config } from "@/config/config"
10
+ import { Global } from "@octocode-ai/core/global"
11
+ import * as Log from "@octocode-ai/core/util/log"
12
+ import { RuntimeFlags } from "@/effect/runtime-flags"
13
+
14
+ export const Patch = Schema.Struct({
15
+ hash: Schema.String,
16
+ files: Schema.mutable(Schema.Array(Schema.String)),
17
+ })
18
+ export type Patch = typeof Patch.Type
19
+
20
+ export const FileDiff = Schema.Struct({
21
+ // Optional because legacy/imported `summary_diffs` on disk may omit
22
+ // file details and patch text. Required Schema rejected the whole
23
+ // session response and broke session loading on Desktop.
24
+ file: Schema.optional(Schema.String),
25
+ patch: Schema.optional(Schema.String),
26
+ additions: Schema.Finite,
27
+ deletions: Schema.Finite,
28
+ status: Schema.optional(Schema.Literals(["added", "deleted", "modified"])),
29
+ }).annotate({ identifier: "SnapshotFileDiff" })
30
+ export type FileDiff = typeof FileDiff.Type
31
+
32
+ const log = Log.create({ service: "snapshot" })
33
+ const prune = "7.days"
34
+ const limit = 2 * 1024 * 1024
35
+ const core = ["-c", "core.longpaths=true", "-c", "core.symlinks=true"]
36
+ const cfg = ["-c", "core.autocrlf=false", ...core]
37
+ const quote = [...cfg, "-c", "core.quotepath=false"]
38
+ interface GitResult {
39
+ readonly code: ChildProcessSpawner.ExitCode
40
+ readonly text: string
41
+ readonly stderr: string
42
+ }
43
+
44
+ type State = Omit<Interface, "init">
45
+
46
+ export interface Interface {
47
+ readonly init: () => Effect.Effect<void>
48
+ readonly cleanup: () => Effect.Effect<void>
49
+ readonly track: () => Effect.Effect<string | undefined>
50
+ readonly patch: (hash: string) => Effect.Effect<Patch>
51
+ readonly restore: (snapshot: string) => Effect.Effect<void>
52
+ readonly revert: (patches: Patch[]) => Effect.Effect<void>
53
+ readonly diff: (hash: string) => Effect.Effect<string>
54
+ readonly diffFull: (from: string, to: string) => Effect.Effect<FileDiff[]>
55
+ }
56
+
57
+ export class Service extends Context.Service<Service, Interface>()("@octocode/Snapshot") {}
58
+
59
+ export const layer: Layer.Layer<Service, never, FSUtil.Service | AppProcess.Service | Config.Service> = Layer.effect(
60
+ Service,
61
+ Effect.gen(function* () {
62
+ const fs = yield* FSUtil.Service
63
+ const appProcess = yield* AppProcess.Service
64
+ const config = yield* Config.Service
65
+ const locks = new Map<string, Semaphore.Semaphore>()
66
+
67
+ const lock = (key: string) => {
68
+ const hit = locks.get(key)
69
+ if (hit) return hit
70
+
71
+ const next = Semaphore.makeUnsafe(1)
72
+ locks.set(key, next)
73
+ return next
74
+ }
75
+
76
+ const state = yield* InstanceState.make<State>(
77
+ Effect.fn("Snapshot.state")(function* (ctx) {
78
+ const state = {
79
+ directory: ctx.directory,
80
+ worktree: ctx.worktree,
81
+ gitdir: path.join(Global.Path.data, "snapshot", ctx.project.id, Hash.fast(ctx.worktree)),
82
+ vcs: ctx.project.vcs,
83
+ }
84
+
85
+ const args = (cmd: string[]) => ["--git-dir", state.gitdir, "--work-tree", state.worktree, ...cmd]
86
+
87
+ const feed = (list: string[]) => list.join("\0") + "\0"
88
+
89
+ const git = Effect.fnUntraced(
90
+ function* (cmd: string[], opts?: { cwd?: string; env?: Record<string, string>; stdin?: string }) {
91
+ const result = yield* appProcess.run(
92
+ ChildProcess.make("git", cmd, { cwd: opts?.cwd, env: opts?.env, extendEnv: true }),
93
+ { stdin: opts?.stdin },
94
+ )
95
+ return {
96
+ code: ChildProcessSpawner.ExitCode(result.exitCode),
97
+ text: result.stdout.toString("utf8"),
98
+ stderr: result.stderr.toString("utf8"),
99
+ } satisfies GitResult
100
+ },
101
+ Effect.catch((err) =>
102
+ Effect.succeed({
103
+ code: ChildProcessSpawner.ExitCode(1),
104
+ text: "",
105
+ stderr: err instanceof Error ? err.message : String(err),
106
+ }),
107
+ ),
108
+ )
109
+
110
+ const ignore = Effect.fnUntraced(function* (files: string[]) {
111
+ if (!files.length) return new Set<string>()
112
+ const check = yield* git(
113
+ [
114
+ ...quote,
115
+ "--git-dir",
116
+ path.join(state.worktree, ".git"),
117
+ "--work-tree",
118
+ state.worktree,
119
+ "check-ignore",
120
+ "--no-index",
121
+ "--stdin",
122
+ "-z",
123
+ ],
124
+ {
125
+ cwd: state.directory,
126
+ stdin: feed(files),
127
+ },
128
+ )
129
+ if (check.code !== 0 && check.code !== 1) return new Set<string>()
130
+ return new Set(check.text.split("\0").filter(Boolean))
131
+ })
132
+
133
+ const drop = Effect.fnUntraced(function* (files: string[]) {
134
+ if (!files.length) return
135
+ yield* git(
136
+ [
137
+ ...cfg,
138
+ ...args(["rm", "--cached", "-f", "--ignore-unmatch", "--pathspec-from-file=-", "--pathspec-file-nul"]),
139
+ ],
140
+ {
141
+ cwd: state.directory,
142
+ stdin: feed(files),
143
+ },
144
+ )
145
+ })
146
+
147
+ const stage = Effect.fnUntraced(function* (files: string[]) {
148
+ if (!files.length) return
149
+ const result = yield* git(
150
+ [...cfg, ...args(["add", "--all", "--sparse", "--pathspec-from-file=-", "--pathspec-file-nul"])],
151
+ {
152
+ cwd: state.directory,
153
+ stdin: feed(files),
154
+ },
155
+ )
156
+ if (result.code === 0) return
157
+ log.warn("failed to add snapshot files", {
158
+ exitCode: result.code,
159
+ stderr: result.stderr,
160
+ })
161
+ })
162
+
163
+ const exists = (file: string) => fs.exists(file).pipe(Effect.orDie)
164
+ const read = (file: string) => fs.readFileString(file).pipe(Effect.catch(() => Effect.succeed("")))
165
+ const remove = (file: string) => fs.remove(file).pipe(Effect.catch(() => Effect.void))
166
+ const locked = <A, E, R>(fx: Effect.Effect<A, E, R>) => lock(state.gitdir).withPermits(1)(fx)
167
+
168
+ const enabled = Effect.fnUntraced(function* () {
169
+ if (state.vcs !== "git") return false
170
+ if (process.env.OCTOCODE_PURE === "1") return false
171
+ const cfg = yield* config.get()
172
+ return cfg.snapshot !== false
173
+ })
174
+
175
+ const excludes = Effect.fnUntraced(function* () {
176
+ const result = yield* git(["rev-parse", "--path-format=absolute", "--git-path", "info/exclude"], {
177
+ cwd: state.worktree,
178
+ })
179
+ const file = result.text.trim()
180
+ if (!file) return
181
+ if (!(yield* exists(file))) return
182
+ return file
183
+ })
184
+
185
+ const sync = Effect.fnUntraced(function* (list: string[] = []) {
186
+ const file = yield* excludes()
187
+ const target = path.join(state.gitdir, "info", "exclude")
188
+ const text = [
189
+ file ? (yield* read(file)).trimEnd() : "",
190
+ ...list.map((item) => `/${item.replaceAll("\\", "/")}`),
191
+ ]
192
+ .filter(Boolean)
193
+ .join("\n")
194
+ yield* fs.ensureDir(path.join(state.gitdir, "info")).pipe(Effect.orDie)
195
+ yield* fs.writeFileString(target, text ? `${text}\n` : "").pipe(Effect.orDie)
196
+ })
197
+
198
+ const add = Effect.fnUntraced(function* () {
199
+ yield* sync()
200
+ const [diff, other] = yield* Effect.all(
201
+ [
202
+ git([...quote, ...args(["diff-files", "--name-only", "-z", "--", "."])], {
203
+ cwd: state.directory,
204
+ }),
205
+ git([...quote, ...args(["ls-files", "--others", "--exclude-standard", "-z", "--", "."])], {
206
+ cwd: state.directory,
207
+ }),
208
+ ],
209
+ { concurrency: 2 },
210
+ )
211
+ if (diff.code !== 0 || other.code !== 0) {
212
+ log.warn("failed to list snapshot files", {
213
+ diffCode: diff.code,
214
+ diffStderr: diff.stderr,
215
+ otherCode: other.code,
216
+ otherStderr: other.stderr,
217
+ })
218
+ return
219
+ }
220
+
221
+ const tracked = diff.text.split("\0").filter(Boolean)
222
+ const untracked = other.text.split("\0").filter(Boolean)
223
+ const all = Array.from(new Set([...tracked, ...untracked]))
224
+ if (!all.length) return
225
+
226
+ // Resolve source-repo ignore rules against the exact candidate set.
227
+ // --no-index keeps this pattern-based even when a path is already tracked.
228
+ const ignored = yield* ignore(all)
229
+
230
+ // Remove newly-ignored files from snapshot index to prevent re-adding
231
+ if (ignored.size > 0) {
232
+ const ignoredFiles = Array.from(ignored)
233
+ log.info("removing gitignored files from snapshot", { count: ignoredFiles.length })
234
+ yield* drop(ignoredFiles)
235
+ }
236
+
237
+ const allow = all.filter((item) => !ignored.has(item))
238
+ if (!allow.length) return
239
+
240
+ const large = new Set(
241
+ (yield* Effect.all(
242
+ allow.map((item) =>
243
+ fs
244
+ .stat(path.join(state.directory, item))
245
+ .pipe(Effect.catch(() => Effect.void))
246
+ .pipe(
247
+ Effect.map((stat) => {
248
+ if (!stat || stat.type !== "File") return
249
+ const size = typeof stat.size === "bigint" ? Number(stat.size) : stat.size
250
+ return size > limit ? item : undefined
251
+ }),
252
+ ),
253
+ ),
254
+ { concurrency: 8 },
255
+ )).filter((item): item is string => Boolean(item)),
256
+ )
257
+ const block = new Set(untracked.filter((item) => large.has(item)))
258
+ yield* sync(Array.from(block))
259
+ // Stage only the allowed candidate paths so snapshot updates stay scoped.
260
+ yield* stage(allow.filter((item) => !block.has(item)))
261
+ })
262
+
263
+ const cleanup = Effect.fnUntraced(function* () {
264
+ return yield* locked(
265
+ Effect.gen(function* () {
266
+ if (!(yield* enabled())) return
267
+ if (!(yield* exists(state.gitdir))) return
268
+ const result = yield* git(args(["gc", `--prune=${prune}`]), { cwd: state.directory })
269
+ if (result.code !== 0) {
270
+ log.warn("cleanup failed", {
271
+ exitCode: result.code,
272
+ stderr: result.stderr,
273
+ })
274
+ return
275
+ }
276
+ log.info("cleanup", { prune })
277
+ }),
278
+ )
279
+ })
280
+
281
+ const track = Effect.fnUntraced(function* () {
282
+ return yield* locked(
283
+ Effect.gen(function* () {
284
+ if (!(yield* enabled())) return
285
+ const existed = yield* exists(state.gitdir)
286
+ yield* fs.ensureDir(state.gitdir).pipe(Effect.orDie)
287
+ if (!existed) {
288
+ yield* git(["init"], {
289
+ env: { GIT_DIR: state.gitdir, GIT_WORK_TREE: state.worktree },
290
+ })
291
+ yield* git(["--git-dir", state.gitdir, "config", "core.autocrlf", "false"])
292
+ yield* git(["--git-dir", state.gitdir, "config", "core.longpaths", "true"])
293
+ yield* git(["--git-dir", state.gitdir, "config", "core.symlinks", "true"])
294
+ yield* git(["--git-dir", state.gitdir, "config", "core.fsmonitor", "false"])
295
+ log.info("initialized")
296
+ }
297
+ yield* add()
298
+ const result = yield* git(args(["write-tree"]), { cwd: state.directory })
299
+ const hash = result.text.trim()
300
+ log.info("tracking", { hash, cwd: state.directory, git: state.gitdir })
301
+ return hash
302
+ }),
303
+ )
304
+ })
305
+
306
+ const patch = Effect.fnUntraced(function* (hash: string) {
307
+ return yield* locked(
308
+ Effect.gen(function* () {
309
+ yield* add()
310
+ const result = yield* git(
311
+ [...quote, ...args(["diff", "--cached", "--no-ext-diff", "--name-only", hash, "--", "."])],
312
+ {
313
+ cwd: state.directory,
314
+ },
315
+ )
316
+ if (result.code !== 0) {
317
+ log.warn("failed to get diff", { hash, exitCode: result.code })
318
+ return { hash, files: [] }
319
+ }
320
+ const files = result.text
321
+ .trim()
322
+ .split("\n")
323
+ .map((x) => x.trim())
324
+ .filter(Boolean)
325
+
326
+ // Hide ignored-file removals from the user-facing patch output.
327
+ const ignored = yield* ignore(files)
328
+
329
+ return {
330
+ hash,
331
+ files: files
332
+ .filter((item) => !ignored.has(item))
333
+ .map((x) => path.join(state.worktree, x).replaceAll("\\", "/")),
334
+ }
335
+ }),
336
+ )
337
+ })
338
+
339
+ const restore = Effect.fnUntraced(function* (snapshot: string) {
340
+ return yield* locked(
341
+ Effect.gen(function* () {
342
+ log.info("restore", { commit: snapshot })
343
+ const result = yield* git([...core, ...args(["read-tree", snapshot])], { cwd: state.worktree })
344
+ if (result.code === 0) {
345
+ const checkout = yield* git([...core, ...args(["checkout-index", "-a", "-f"])], {
346
+ cwd: state.worktree,
347
+ })
348
+ if (checkout.code === 0) return
349
+ log.error("failed to restore snapshot", {
350
+ snapshot,
351
+ exitCode: checkout.code,
352
+ stderr: checkout.stderr,
353
+ })
354
+ return
355
+ }
356
+ log.error("failed to restore snapshot", {
357
+ snapshot,
358
+ exitCode: result.code,
359
+ stderr: result.stderr,
360
+ })
361
+ }),
362
+ )
363
+ })
364
+
365
+ const revert = Effect.fnUntraced(function* (patches: Patch[]) {
366
+ return yield* locked(
367
+ Effect.gen(function* () {
368
+ const ops: { hash: string; file: string; rel: string }[] = []
369
+ const seen = new Set<string>()
370
+ for (const item of patches) {
371
+ for (const file of item.files) {
372
+ if (seen.has(file)) continue
373
+ seen.add(file)
374
+ ops.push({
375
+ hash: item.hash,
376
+ file,
377
+ rel: path.relative(state.worktree, file).replaceAll("\\", "/"),
378
+ })
379
+ }
380
+ }
381
+
382
+ const single = Effect.fnUntraced(function* (op: (typeof ops)[number]) {
383
+ log.info("reverting", { file: op.file, hash: op.hash })
384
+ const result = yield* git([...core, ...args(["checkout", op.hash, "--", op.file])], {
385
+ cwd: state.worktree,
386
+ })
387
+ if (result.code === 0) return
388
+ const tree = yield* git([...core, ...args(["ls-tree", op.hash, "--", op.rel])], {
389
+ cwd: state.worktree,
390
+ })
391
+ if (tree.code === 0 && tree.text.trim()) {
392
+ log.info("file existed in snapshot but checkout failed, keeping", { file: op.file, hash: op.hash })
393
+ return
394
+ }
395
+ log.info("file did not exist in snapshot, deleting", { file: op.file, hash: op.hash })
396
+ yield* remove(op.file)
397
+ })
398
+
399
+ const clash = (a: string, b: string) => a === b || a.startsWith(`${b}/`) || b.startsWith(`${a}/`)
400
+
401
+ for (let i = 0; i < ops.length; ) {
402
+ const first = ops[i]!
403
+ const run = [first]
404
+ let j = i + 1
405
+ // Only batch adjacent files when their paths cannot affect each other.
406
+ while (j < ops.length && run.length < 100) {
407
+ const next = ops[j]!
408
+ if (next.hash !== first.hash) break
409
+ if (run.some((item) => clash(item.rel, next.rel))) break
410
+ run.push(next)
411
+ j += 1
412
+ }
413
+
414
+ if (run.length === 1) {
415
+ yield* single(first)
416
+ i = j
417
+ continue
418
+ }
419
+
420
+ const tree = yield* git(
421
+ [...core, ...args(["ls-tree", "--name-only", first.hash, "--", ...run.map((item) => item.rel)])],
422
+ {
423
+ cwd: state.worktree,
424
+ },
425
+ )
426
+
427
+ if (tree.code !== 0) {
428
+ log.info("batched ls-tree failed, falling back to single-file revert", {
429
+ hash: first.hash,
430
+ files: run.length,
431
+ })
432
+ for (const op of run) {
433
+ yield* single(op)
434
+ }
435
+ i = j
436
+ continue
437
+ }
438
+
439
+ const have = new Set(
440
+ tree.text
441
+ .trim()
442
+ .split("\n")
443
+ .map((item) => item.trim())
444
+ .filter(Boolean),
445
+ )
446
+ const list = run.filter((item) => have.has(item.rel))
447
+ if (list.length) {
448
+ log.info("reverting", { hash: first.hash, files: list.length })
449
+ const result = yield* git(
450
+ [...core, ...args(["checkout", first.hash, "--", ...list.map((item) => item.file)])],
451
+ {
452
+ cwd: state.worktree,
453
+ },
454
+ )
455
+ if (result.code !== 0) {
456
+ log.info("batched checkout failed, falling back to single-file revert", {
457
+ hash: first.hash,
458
+ files: list.length,
459
+ })
460
+ for (const op of run) {
461
+ yield* single(op)
462
+ }
463
+ i = j
464
+ continue
465
+ }
466
+ }
467
+
468
+ for (const op of run) {
469
+ if (have.has(op.rel)) continue
470
+ log.info("file did not exist in snapshot, deleting", { file: op.file, hash: op.hash })
471
+ yield* remove(op.file)
472
+ }
473
+
474
+ i = j
475
+ }
476
+ }),
477
+ )
478
+ })
479
+
480
+ const diff = Effect.fnUntraced(function* (hash: string) {
481
+ return yield* locked(
482
+ Effect.gen(function* () {
483
+ yield* add()
484
+ const result = yield* git([...quote, ...args(["diff", "--cached", "--no-ext-diff", hash, "--", "."])], {
485
+ cwd: state.worktree,
486
+ })
487
+ if (result.code !== 0) {
488
+ log.warn("failed to get diff", {
489
+ hash,
490
+ exitCode: result.code,
491
+ stderr: result.stderr,
492
+ })
493
+ return ""
494
+ }
495
+ return result.text.trim()
496
+ }),
497
+ )
498
+ })
499
+
500
+ const diffFull = Effect.fnUntraced(function* (from: string, to: string) {
501
+ return yield* locked(
502
+ Effect.gen(function* () {
503
+ type Row = {
504
+ file: string
505
+ status: "added" | "deleted" | "modified"
506
+ binary: boolean
507
+ additions: number
508
+ deletions: number
509
+ }
510
+
511
+ type Ref = {
512
+ file: string
513
+ side: "before" | "after"
514
+ ref: string
515
+ }
516
+
517
+ const show = Effect.fnUntraced(function* (row: Row) {
518
+ if (row.binary) return ["", ""]
519
+ if (row.status === "added") {
520
+ return [
521
+ "",
522
+ yield* git([...cfg, ...args(["show", `${to}:${row.file}`])]).pipe(Effect.map((item) => item.text)),
523
+ ]
524
+ }
525
+ if (row.status === "deleted") {
526
+ return [
527
+ yield* git([...cfg, ...args(["show", `${from}:${row.file}`])]).pipe(
528
+ Effect.map((item) => item.text),
529
+ ),
530
+ "",
531
+ ]
532
+ }
533
+ return yield* Effect.all(
534
+ [
535
+ git([...cfg, ...args(["show", `${from}:${row.file}`])]).pipe(Effect.map((item) => item.text)),
536
+ git([...cfg, ...args(["show", `${to}:${row.file}`])]).pipe(Effect.map((item) => item.text)),
537
+ ],
538
+ { concurrency: 2 },
539
+ )
540
+ })
541
+
542
+ const load = Effect.fnUntraced(
543
+ function* (rows: Row[]) {
544
+ const refs = rows.flatMap((row) => {
545
+ if (row.binary) return []
546
+ if (row.status === "added")
547
+ return [{ file: row.file, side: "after", ref: `${to}:${row.file}` } satisfies Ref]
548
+ if (row.status === "deleted") {
549
+ return [{ file: row.file, side: "before", ref: `${from}:${row.file}` } satisfies Ref]
550
+ }
551
+ return [
552
+ { file: row.file, side: "before", ref: `${from}:${row.file}` } satisfies Ref,
553
+ { file: row.file, side: "after", ref: `${to}:${row.file}` } satisfies Ref,
554
+ ]
555
+ })
556
+ if (!refs.length) return new Map<string, { before: string; after: string }>()
557
+
558
+ const batch = yield* appProcess.run(
559
+ ChildProcess.make("git", [...cfg, ...args(["cat-file", "--batch"])], {
560
+ cwd: state.directory,
561
+ extendEnv: true,
562
+ }),
563
+ { stdin: refs.map((item) => item.ref).join("\n") + "\n" },
564
+ )
565
+ if (batch.exitCode !== 0) {
566
+ log.info("git cat-file --batch failed during snapshot diff, falling back to per-file git show", {
567
+ stderr: batch.stderr.toString("utf8"),
568
+ refs: refs.length,
569
+ })
570
+ return
571
+ }
572
+ const out = batch.stdout
573
+
574
+ const fail = (msg: string, extra?: Record<string, string>) => {
575
+ log.info(msg, { ...extra, refs: refs.length })
576
+ return undefined
577
+ }
578
+
579
+ const map = new Map<string, { before: string; after: string }>()
580
+ const dec = new TextDecoder()
581
+ let i = 0
582
+ for (const ref of refs) {
583
+ let end = i
584
+ while (end < out.length && out[end] !== 10) end += 1
585
+ if (end >= out.length) {
586
+ return fail(
587
+ "git cat-file --batch returned a truncated header during snapshot diff, falling back to per-file git show",
588
+ )
589
+ }
590
+
591
+ const head = dec.decode(out.slice(i, end))
592
+ i = end + 1
593
+ const hit = map.get(ref.file) ?? { before: "", after: "" }
594
+ if (head.endsWith(" missing")) {
595
+ map.set(ref.file, hit)
596
+ continue
597
+ }
598
+
599
+ const match = head.match(/^[0-9a-f]+ blob (\d+)$/)
600
+ if (!match) {
601
+ return fail(
602
+ "git cat-file --batch returned an unexpected header during snapshot diff, falling back to per-file git show",
603
+ { head },
604
+ )
605
+ }
606
+
607
+ const size = Number(match[1])
608
+ if (!Number.isInteger(size) || size < 0 || i + size >= out.length || out[i + size] !== 10) {
609
+ return fail(
610
+ "git cat-file --batch returned truncated content during snapshot diff, falling back to per-file git show",
611
+ { head },
612
+ )
613
+ }
614
+
615
+ const text = dec.decode(out.slice(i, i + size))
616
+ if (ref.side === "before") hit.before = text
617
+ if (ref.side === "after") hit.after = text
618
+ map.set(ref.file, hit)
619
+ i += size + 1
620
+ }
621
+
622
+ if (i !== out.length) {
623
+ return fail(
624
+ "git cat-file --batch returned trailing data during snapshot diff, falling back to per-file git show",
625
+ )
626
+ }
627
+
628
+ return map
629
+ },
630
+ Effect.scoped,
631
+ Effect.catch(() =>
632
+ Effect.succeed<Map<string, { before: string; after: string }> | undefined>(undefined),
633
+ ),
634
+ )
635
+
636
+ const result: FileDiff[] = []
637
+ const status = new Map<string, "added" | "deleted" | "modified">()
638
+
639
+ const statuses = yield* git(
640
+ [...quote, ...args(["diff", "--no-ext-diff", "--name-status", "--no-renames", from, to, "--", "."])],
641
+ { cwd: state.directory },
642
+ )
643
+
644
+ for (const line of statuses.text.trim().split("\n")) {
645
+ if (!line) continue
646
+ const [code, file] = line.split("\t")
647
+ if (!code || !file) continue
648
+ status.set(file, code.startsWith("A") ? "added" : code.startsWith("D") ? "deleted" : "modified")
649
+ }
650
+
651
+ const numstat = yield* git(
652
+ [...quote, ...args(["diff", "--no-ext-diff", "--no-renames", "--numstat", from, to, "--", "."])],
653
+ {
654
+ cwd: state.directory,
655
+ },
656
+ )
657
+
658
+ const rows = numstat.text
659
+ .trim()
660
+ .split("\n")
661
+ .filter(Boolean)
662
+ .flatMap((line) => {
663
+ const [adds, dels, file] = line.split("\t")
664
+ if (!file) return []
665
+ const binary = adds === "-" && dels === "-"
666
+ const additions = binary ? 0 : parseInt(adds)
667
+ const deletions = binary ? 0 : parseInt(dels)
668
+ return [
669
+ {
670
+ file,
671
+ status: status.get(file) ?? "modified",
672
+ binary,
673
+ additions: Number.isFinite(additions) ? additions : 0,
674
+ deletions: Number.isFinite(deletions) ? deletions : 0,
675
+ } satisfies Row,
676
+ ]
677
+ })
678
+
679
+ // Hide ignored-file removals from the user-facing diff output.
680
+ const ignored = yield* ignore(rows.map((r) => r.file))
681
+ if (ignored.size > 0) {
682
+ const filtered = rows.filter((r) => !ignored.has(r.file))
683
+ rows.length = 0
684
+ rows.push(...filtered)
685
+ }
686
+
687
+ const step = 100
688
+ const patch = (file: string, before: string, after: string) =>
689
+ formatPatch(structuredPatch(file, file, before, after, "", "", { context: Number.MAX_SAFE_INTEGER }))
690
+
691
+ for (let i = 0; i < rows.length; i += step) {
692
+ const run = rows.slice(i, i + step)
693
+ const text = yield* load(run)
694
+
695
+ for (const row of run) {
696
+ const hit = text?.get(row.file) ?? { before: "", after: "" }
697
+ const [before, after] = row.binary ? ["", ""] : text ? [hit.before, hit.after] : yield* show(row)
698
+ result.push({
699
+ file: row.file,
700
+ patch: row.binary ? "" : patch(row.file, before, after),
701
+ additions: row.additions,
702
+ deletions: row.deletions,
703
+ status: row.status,
704
+ })
705
+ }
706
+ }
707
+
708
+ return result
709
+ }),
710
+ )
711
+ })
712
+
713
+ yield* cleanup().pipe(
714
+ Effect.catchCause((cause) => {
715
+ log.error("cleanup loop failed", { cause: Cause.pretty(cause) })
716
+ return Effect.void
717
+ }),
718
+ Effect.repeat(Schedule.spaced(Duration.hours(1))),
719
+ Effect.delay(Duration.minutes(1)),
720
+ Effect.forkScoped,
721
+ )
722
+
723
+ return { cleanup, track, patch, restore, revert, diff, diffFull }
724
+ }),
725
+ )
726
+
727
+ return Service.of({
728
+ init: Effect.fn("Snapshot.init")(function* () {
729
+ yield* InstanceState.get(state)
730
+ }),
731
+ cleanup: Effect.fn("Snapshot.cleanup")(function* () {
732
+ return yield* InstanceState.useEffect(state, (s) => s.cleanup())
733
+ }),
734
+ track: Effect.fn("Snapshot.track")(function* () {
735
+ return yield* InstanceState.useEffect(state, (s) => s.track())
736
+ }),
737
+ patch: Effect.fn("Snapshot.patch")(function* (hash: string) {
738
+ return yield* InstanceState.useEffect(state, (s) => s.patch(hash))
739
+ }),
740
+ restore: Effect.fn("Snapshot.restore")(function* (snapshot: string) {
741
+ return yield* InstanceState.useEffect(state, (s) => s.restore(snapshot))
742
+ }),
743
+ revert: Effect.fn("Snapshot.revert")(function* (patches: Patch[]) {
744
+ return yield* InstanceState.useEffect(state, (s) => s.revert(patches))
745
+ }),
746
+ diff: Effect.fn("Snapshot.diff")(function* (hash: string) {
747
+ return yield* InstanceState.useEffect(state, (s) => s.diff(hash))
748
+ }),
749
+ diffFull: Effect.fn("Snapshot.diffFull")(function* (from: string, to: string) {
750
+ return yield* InstanceState.useEffect(state, (s) => s.diffFull(from, to))
751
+ }),
752
+ })
753
+ }),
754
+ )
755
+
756
+ export const defaultLayer = layer.pipe(
757
+ Layer.provide(AppProcess.defaultLayer),
758
+ Layer.provide(FSUtil.defaultLayer),
759
+ Layer.provide(Config.defaultLayer),
760
+ )
761
+
762
+ export * as Snapshot from "."