@xingular/harness 1.0.0 → 1.2.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 (397) hide show
  1. package/CHANGELOG.md +46 -5
  2. package/README.md +75 -21
  3. package/dist/cli.js +17421 -8711
  4. package/dist/sdk/accounts/accounts.d.ts +27 -3
  5. package/dist/sdk/accounts/accounts.js +78 -24
  6. package/dist/sdk/accounts/secrets.d.ts +12 -0
  7. package/dist/sdk/accounts/secrets.js +114 -7
  8. package/dist/sdk/accounts/store.d.ts +26 -1
  9. package/dist/sdk/accounts/store.js +1 -1
  10. package/dist/sdk/agents/builtin.d.ts +2 -0
  11. package/dist/sdk/agents/builtin.js +48 -0
  12. package/dist/sdk/agents/narrow.d.ts +13 -0
  13. package/dist/sdk/agents/narrow.js +29 -0
  14. package/dist/sdk/agents/planResearch.d.ts +5 -0
  15. package/dist/sdk/agents/planResearch.js +19 -0
  16. package/dist/sdk/agents/profiles.d.ts +81 -0
  17. package/dist/sdk/agents/profiles.js +226 -0
  18. package/dist/sdk/annotations/bridge.d.ts +42 -0
  19. package/dist/sdk/annotations/bridge.js +264 -0
  20. package/dist/sdk/annotations/capture.d.ts +116 -0
  21. package/dist/sdk/annotations/capture.js +308 -0
  22. package/dist/sdk/annotations/delivery.d.ts +72 -0
  23. package/dist/sdk/annotations/delivery.js +130 -0
  24. package/dist/sdk/annotations/inspect.d.ts +10 -0
  25. package/dist/sdk/annotations/inspect.js +33 -0
  26. package/dist/sdk/annotations/isolated.d.ts +6 -0
  27. package/dist/sdk/annotations/isolated.js +51 -0
  28. package/dist/sdk/annotations/pageScript.d.ts +28 -0
  29. package/dist/sdk/annotations/pageScript.js +871 -0
  30. package/dist/sdk/annotations/part.d.ts +10 -0
  31. package/dist/sdk/annotations/part.js +155 -0
  32. package/dist/sdk/annotations/queue.d.ts +4 -0
  33. package/dist/sdk/annotations/queue.js +40 -0
  34. package/dist/sdk/annotations/serverMethods.d.ts +3 -0
  35. package/dist/sdk/annotations/serverMethods.js +62 -0
  36. package/dist/sdk/annotations/store.d.ts +167 -0
  37. package/dist/sdk/annotations/store.js +394 -0
  38. package/dist/sdk/browser/backend.d.ts +16 -0
  39. package/dist/sdk/browser/backend.js +17 -0
  40. package/dist/sdk/browser/contracts.d.ts +19 -0
  41. package/dist/sdk/browser/contracts.js +116 -0
  42. package/dist/sdk/browser/index.d.ts +14 -3
  43. package/dist/sdk/browser/index.js +11 -4
  44. package/dist/sdk/browser/serverMethods.d.ts +3 -0
  45. package/dist/sdk/browser/serverMethods.js +7 -0
  46. package/dist/sdk/browser/session.d.ts +1 -0
  47. package/dist/sdk/browser/session.js +45 -9
  48. package/dist/sdk/browser/tools.d.ts +1 -4
  49. package/dist/sdk/browser/tools.js +14 -91
  50. package/dist/sdk/cli.js +24 -15
  51. package/dist/sdk/commands/list.d.ts +3 -0
  52. package/dist/sdk/commands/list.js +75 -0
  53. package/dist/sdk/commands/registry.d.ts +250 -0
  54. package/dist/sdk/commands/registry.js +47 -0
  55. package/dist/sdk/commands/routes.d.ts +16 -0
  56. package/dist/sdk/commands/routes.js +33 -0
  57. package/dist/sdk/core/bus.js +1 -1
  58. package/dist/sdk/core/commandBudget.d.ts +23 -0
  59. package/dist/sdk/core/commandBudget.js +57 -0
  60. package/dist/sdk/core/env.d.ts +1 -1
  61. package/dist/sdk/core/env.js +1 -1
  62. package/dist/sdk/core/index.js +17 -1
  63. package/dist/sdk/core/interactiveProfile.d.ts +46 -0
  64. package/dist/sdk/core/interactiveProfile.js +143 -0
  65. package/dist/sdk/core/workspace.d.ts +13 -0
  66. package/dist/sdk/core/workspace.js +88 -0
  67. package/dist/sdk/core/workspaceBashTool.d.ts +4 -0
  68. package/dist/sdk/core/workspaceBashTool.js +36 -0
  69. package/dist/sdk/core/workspaceSandbox.d.ts +31 -0
  70. package/dist/sdk/core/workspaceSandbox.js +320 -0
  71. package/dist/sdk/core/workspaceWriteOperations.d.ts +22 -0
  72. package/dist/sdk/core/workspaceWriteOperations.js +206 -0
  73. package/dist/sdk/doctor/serverMethods.d.ts +3 -0
  74. package/dist/sdk/doctor/serverMethods.js +8 -0
  75. package/dist/sdk/doctor/types.d.ts +2 -2
  76. package/dist/sdk/harness.d.ts +22 -0
  77. package/dist/sdk/harness.js +84 -5
  78. package/dist/sdk/history/recall.js +8 -8
  79. package/dist/sdk/history/serverMethods.d.ts +3 -0
  80. package/dist/sdk/history/serverMethods.js +8 -0
  81. package/dist/sdk/hub/cli.d.ts +1 -1
  82. package/dist/sdk/hub/cli.js +1 -1
  83. package/dist/sdk/hub/schema.d.ts +1 -1
  84. package/dist/sdk/hub/serverMethods.d.ts +3 -0
  85. package/dist/sdk/hub/serverMethods.js +11 -0
  86. package/dist/sdk/index.d.ts +16 -1
  87. package/dist/sdk/index.js +10 -0
  88. package/dist/sdk/mcp/connections.js +14 -7
  89. package/dist/sdk/mcp/serverMethods.d.ts +3 -0
  90. package/dist/sdk/mcp/serverMethods.js +22 -0
  91. package/dist/sdk/pi/runtime.d.ts +2 -1
  92. package/dist/sdk/pi/runtime.js +2 -2
  93. package/dist/sdk/plugins/builtin.d.ts +1 -0
  94. package/dist/sdk/plugins/builtin.js +145 -33
  95. package/dist/sdk/plugins/builtinRegistry.d.ts +60 -0
  96. package/dist/sdk/plugins/builtinRegistry.js +71 -0
  97. package/dist/sdk/plugins/catalogue.js +2 -1
  98. package/dist/sdk/plugins/cli.d.ts +1 -1
  99. package/dist/sdk/plugins/cli.js +4 -3
  100. package/dist/sdk/plugins/commandPrefix.d.ts +8 -0
  101. package/dist/sdk/plugins/commandPrefix.js +21 -0
  102. package/dist/sdk/plugins/firstParty.d.ts +1 -1
  103. package/dist/sdk/plugins/firstParty.js +8 -2
  104. package/dist/sdk/plugins/inventory.js +4 -3
  105. package/dist/sdk/plugins/manifest.d.ts +2 -0
  106. package/dist/sdk/plugins/manifest.js +2 -1
  107. package/dist/sdk/plugins/surfaces.d.ts +5 -0
  108. package/dist/sdk/plugins/surfaces.js +11 -0
  109. package/dist/sdk/plugins/types.d.ts +15 -0
  110. package/dist/sdk/prompt/compile.d.ts +19 -2
  111. package/dist/sdk/prompt/compile.js +79 -26
  112. package/dist/sdk/prompt/standard.d.ts +17 -0
  113. package/dist/sdk/prompt/standard.js +21 -0
  114. package/dist/sdk/refine/cli.d.ts +1 -1
  115. package/dist/sdk/refine/cli.js +2 -2
  116. package/dist/sdk/refine/serverMethods.d.ts +3 -0
  117. package/dist/sdk/refine/serverMethods.js +20 -0
  118. package/dist/sdk/server/methods.js +27 -86
  119. package/dist/sdk/server/params.d.ts +4 -0
  120. package/dist/sdk/server/params.js +11 -0
  121. package/dist/sdk/server/remote.js +36 -11
  122. package/dist/sdk/sessions/compactionCheckpoint.d.ts +11 -0
  123. package/dist/sdk/sessions/compactionCheckpoint.js +79 -0
  124. package/dist/sdk/sessions/continuation.d.ts +3 -0
  125. package/dist/sdk/sessions/continuation.js +5 -1
  126. package/dist/sdk/sessions/contracts.d.ts +185 -0
  127. package/dist/sdk/sessions/contracts.js +101 -4
  128. package/dist/sdk/sessions/control.d.ts +72 -0
  129. package/dist/sdk/sessions/control.js +158 -0
  130. package/dist/sdk/sessions/initialBash.d.ts +7 -0
  131. package/dist/sdk/sessions/initialBash.js +7 -0
  132. package/dist/sdk/sessions/planMode.d.ts +18 -4
  133. package/dist/sdk/sessions/planMode.js +82 -16
  134. package/dist/sdk/sessions/reasoningSummaries.d.ts +2 -2
  135. package/dist/sdk/sessions/reasoningSummaries.js +3 -3
  136. package/dist/sdk/sessions/registry.d.ts +2 -1
  137. package/dist/sdk/sessions/registry.js +6 -3
  138. package/dist/sdk/sessions/runIndex.js +7 -7
  139. package/dist/sdk/sessions/runStore.d.ts +14 -0
  140. package/dist/sdk/sessions/runStore.js +38 -1
  141. package/dist/sdk/sessions/runner.d.ts +40 -2
  142. package/dist/sdk/sessions/runner.js +163 -15
  143. package/dist/sdk/sessions/sessions.d.ts +40 -8
  144. package/dist/sdk/sessions/sessions.js +279 -27
  145. package/dist/sdk/sessions/sideQuestionServerMethods.d.ts +3 -0
  146. package/dist/sdk/sessions/sideQuestionServerMethods.js +19 -0
  147. package/dist/sdk/sessions/sideQuestions.d.ts +66 -0
  148. package/dist/sdk/sessions/sideQuestions.js +290 -0
  149. package/dist/sdk/sessions/subagentServerMethods.d.ts +3 -0
  150. package/dist/sdk/sessions/subagentServerMethods.js +41 -0
  151. package/dist/sdk/sessions/subagentService.d.ts +22 -2
  152. package/dist/sdk/sessions/subagentService.js +93 -16
  153. package/dist/sdk/sessions/subagents.d.ts +9 -1
  154. package/dist/sdk/sessions/subagents.js +19 -0
  155. package/dist/sdk/sessions/workSlice.d.ts +103 -0
  156. package/dist/sdk/sessions/workSlice.js +297 -0
  157. package/dist/sdk/sessions/workspaceBoundary.d.ts +15 -0
  158. package/dist/sdk/sessions/workspaceBoundary.js +46 -0
  159. package/dist/sdk/terminal/browser.d.ts +62 -0
  160. package/dist/sdk/terminal/browser.js +41 -0
  161. package/dist/sdk/terminal/browserControl.d.ts +29 -0
  162. package/dist/sdk/terminal/browserControl.js +187 -0
  163. package/dist/sdk/terminal/commandHelp.d.ts +17 -0
  164. package/dist/sdk/terminal/commandHelp.js +20 -0
  165. package/dist/sdk/terminal/controller.d.ts +15 -1
  166. package/dist/sdk/terminal/controller.js +67 -8
  167. package/dist/sdk/terminal/opentui/subagentsWidget.d.ts +28 -0
  168. package/dist/sdk/terminal/opentui/subagentsWidget.js +52 -0
  169. package/dist/sdk/terminal/opentui/theme.d.ts +43 -0
  170. package/dist/sdk/terminal/opentui/theme.js +87 -0
  171. package/dist/sdk/terminal/piExtension.d.ts +6 -1
  172. package/dist/sdk/terminal/piExtension.js +169 -84
  173. package/dist/sdk/terminal/socket.d.ts +6 -3
  174. package/dist/sdk/terminal/socket.js +40 -9
  175. package/dist/sdk/terminal/standalone.d.ts +9 -0
  176. package/dist/sdk/terminal/standalone.js +118 -19
  177. package/dist/sdk/terminal/subagentMonitor.d.ts +47 -0
  178. package/dist/sdk/terminal/subagentMonitor.js +152 -0
  179. package/dist/sdk/terminal/terminals.d.ts +60 -7
  180. package/dist/sdk/terminal/terminals.js +598 -47
  181. package/dist/sdk/terminal/trajectory.js +2 -2
  182. package/dist/sdk/terminal/tui/annotateCommand.d.ts +3 -0
  183. package/dist/sdk/terminal/tui/annotateCommand.js +22 -0
  184. package/dist/sdk/terminal/tui/commandPages.d.ts +7 -1
  185. package/dist/sdk/terminal/tui/commandPages.js +57 -6
  186. package/dist/sdk/terminal/tui/commands.d.ts +10 -4
  187. package/dist/sdk/terminal/tui/commands.js +269 -65
  188. package/dist/sdk/terminal/tui/dialogGeometry.d.ts +2 -2
  189. package/dist/sdk/terminal/tui/dialogGeometry.js +4 -2
  190. package/dist/sdk/terminal/tui/dialogs.d.ts +6 -1
  191. package/dist/sdk/terminal/tui/dialogs.js +9 -2
  192. package/dist/sdk/terminal/tui/list.d.ts +14 -1
  193. package/dist/sdk/terminal/tui/list.js +96 -14
  194. package/dist/sdk/terminal/tui/modelPicker.js +1 -6
  195. package/dist/sdk/terminal/tui/page.d.ts +3 -0
  196. package/dist/sdk/terminal/tui/pageOverlay.js +27 -7
  197. package/dist/sdk/terminal/tui/pages/accountsPage.d.ts +26 -4
  198. package/dist/sdk/terminal/tui/pages/accountsPage.js +264 -36
  199. package/dist/sdk/terminal/tui/pages/agentsPage.d.ts +74 -0
  200. package/dist/sdk/terminal/tui/pages/agentsPage.js +190 -0
  201. package/dist/sdk/terminal/tui/pages/annotatePage.d.ts +94 -0
  202. package/dist/sdk/terminal/tui/pages/annotatePage.js +341 -0
  203. package/dist/sdk/terminal/tui/pages/browserPage.d.ts +87 -0
  204. package/dist/sdk/terminal/tui/pages/browserPage.js +738 -0
  205. package/dist/sdk/terminal/tui/pages/doctorPage.d.ts +2 -0
  206. package/dist/sdk/terminal/tui/pages/doctorPage.js +103 -15
  207. package/dist/sdk/terminal/tui/pages/notesPage.d.ts +75 -0
  208. package/dist/sdk/terminal/tui/pages/notesPage.js +201 -0
  209. package/dist/sdk/terminal/tui/pages/pluginsPage.d.ts +0 -5
  210. package/dist/sdk/terminal/tui/pages/pluginsPage.js +9 -3
  211. package/dist/sdk/terminal/tui/pages/settingsPage.d.ts +8 -0
  212. package/dist/sdk/terminal/tui/pages/settingsPage.js +16 -1
  213. package/dist/sdk/terminal/tui/pages/subagentsPage.d.ts +24 -0
  214. package/dist/sdk/terminal/tui/pages/subagentsPage.js +152 -0
  215. package/dist/sdk/terminal/tui/pages/trajectoryPage.d.ts +12 -5
  216. package/dist/sdk/terminal/tui/pages/trajectoryPage.js +156 -83
  217. package/dist/sdk/terminal/tui/pages/usagePage.d.ts +43 -0
  218. package/dist/sdk/terminal/tui/pages/usagePage.js +370 -0
  219. package/dist/sdk/terminal/tui/pages/worktreesPage.d.ts +72 -0
  220. package/dist/sdk/terminal/tui/pages/worktreesPage.js +203 -0
  221. package/dist/sdk/terminal/tui/piAdapter.d.ts +1 -2
  222. package/dist/sdk/terminal/tui/piAdapter.js +3 -5
  223. package/dist/sdk/terminal/tui/planMode.d.ts +1 -1
  224. package/dist/sdk/terminal/tui/planMode.js +1 -1
  225. package/dist/sdk/terminal/tui/pluginCommands.d.ts +16 -0
  226. package/dist/sdk/terminal/tui/pluginCommands.js +31 -0
  227. package/dist/sdk/terminal/tui/questions.d.ts +2 -0
  228. package/dist/sdk/terminal/tui/runtime.js +27 -5
  229. package/dist/sdk/terminal/tui/sessionPicker.d.ts +40 -0
  230. package/dist/sdk/terminal/tui/sessionPicker.js +141 -0
  231. package/dist/sdk/terminal/tui/settingsModel.d.ts +2 -0
  232. package/dist/sdk/terminal/tui/settingsModel.js +32 -2
  233. package/dist/sdk/terminal/tui/sideQuestion.d.ts +26 -26
  234. package/dist/sdk/terminal/tui/sideQuestion.js +131 -98
  235. package/dist/sdk/terminal/tui/ui.d.ts +2 -0
  236. package/dist/sdk/terminal/tui/ui.js +1 -0
  237. package/dist/sdk/tools/askUser.js +26 -8
  238. package/dist/sdk/tools/checklist.js +3 -2
  239. package/dist/sdk/tools/checkpoint.d.ts +27 -0
  240. package/dist/sdk/tools/checkpoint.js +154 -0
  241. package/dist/sdk/tools/getCapabilities.d.ts +31 -0
  242. package/dist/sdk/tools/getCapabilities.js +34 -0
  243. package/dist/sdk/tools/harnessTools.d.ts +2 -0
  244. package/dist/sdk/tools/harnessTools.js +1 -1
  245. package/dist/sdk/tools/spawnSubagent.js +14 -4
  246. package/dist/sdk/usage/analytics.d.ts +20 -0
  247. package/dist/sdk/usage/analytics.js +151 -0
  248. package/dist/sdk/usage/ledger.d.ts +38 -0
  249. package/dist/sdk/usage/ledger.js +142 -0
  250. package/dist/sdk/usage/limits/adapters.d.ts +11 -0
  251. package/dist/sdk/usage/limits/adapters.js +349 -0
  252. package/dist/sdk/usage/limits/capture.d.ts +8 -0
  253. package/dist/sdk/usage/limits/capture.js +47 -0
  254. package/dist/sdk/usage/limits/http.d.ts +12 -0
  255. package/dist/sdk/usage/limits/http.js +51 -0
  256. package/dist/sdk/usage/limits/normalize.d.ts +15 -0
  257. package/dist/sdk/usage/limits/normalize.js +211 -0
  258. package/dist/sdk/usage/limits/service.d.ts +30 -0
  259. package/dist/sdk/usage/limits/service.js +176 -0
  260. package/dist/sdk/usage/limits/types.d.ts +65 -0
  261. package/dist/sdk/usage/limits/types.js +1 -0
  262. package/dist/sdk/usage/serverMethods.d.ts +3 -0
  263. package/dist/sdk/usage/serverMethods.js +22 -0
  264. package/dist/sdk/usage/service.d.ts +32 -0
  265. package/dist/sdk/usage/service.js +66 -0
  266. package/dist/sdk/usage/settings.d.ts +7 -0
  267. package/dist/sdk/usage/settings.js +28 -0
  268. package/dist/sdk/usage/types.d.ts +60 -0
  269. package/dist/sdk/usage/types.js +4 -0
  270. package/dist/sdk/web/part.d.ts +10 -0
  271. package/dist/sdk/web/part.js +6 -0
  272. package/dist/sdk/web/serverMethods.d.ts +3 -0
  273. package/dist/sdk/web/serverMethods.js +7 -0
  274. package/dist/sdk/wiki/serverMethods.d.ts +3 -0
  275. package/dist/sdk/wiki/serverMethods.js +26 -0
  276. package/dist/sdk/worktrees/cli.d.ts +11 -0
  277. package/dist/sdk/worktrees/cli.js +146 -0
  278. package/dist/sdk/worktrees/copy.d.ts +9 -0
  279. package/dist/sdk/worktrees/copy.js +111 -0
  280. package/dist/sdk/worktrees/git.d.ts +16 -0
  281. package/dist/sdk/worktrees/git.js +81 -0
  282. package/dist/sdk/worktrees/serverMethods.d.ts +3 -0
  283. package/dist/sdk/worktrees/serverMethods.js +30 -0
  284. package/dist/sdk/worktrees/service.d.ts +73 -0
  285. package/dist/sdk/worktrees/service.js +483 -0
  286. package/dist/sdk/worktrees/setup.d.ts +23 -0
  287. package/dist/sdk/worktrees/setup.js +65 -0
  288. package/dist/sdk/worktrees/types.d.ts +91 -0
  289. package/dist/sdk/worktrees/types.js +1 -0
  290. package/dist/sdk/world/cli.d.ts +2 -2
  291. package/dist/sdk/world/cli.js +6 -6
  292. package/dist/sdk/world/world.d.ts +3 -1
  293. package/dist/sdk/world/world.js +8 -9
  294. package/dist/terminal-opentui.js +16456 -5966
  295. package/dist/terminal-pi.js +1579 -573
  296. package/docs/README.md +22 -2
  297. package/docs/architecture/00-overview.md +28 -16
  298. package/docs/architecture/02-sessions-and-runs.md +184 -25
  299. package/docs/architecture/03-variants.md +10 -2
  300. package/docs/architecture/04-prompt.md +65 -7
  301. package/docs/architecture/06-plugins-and-capabilities.md +57 -4
  302. package/docs/architecture/07-tools-and-gate.md +112 -17
  303. package/docs/architecture/08-memory-and-history.md +4 -2
  304. package/docs/architecture/09-accounts-and-connectors.md +39 -1
  305. package/docs/architecture/10-server-protocol.md +168 -4
  306. package/docs/architecture/11-terminal.md +251 -8
  307. package/docs/architecture/12-storage.md +45 -3
  308. package/docs/architecture/13-world-tools.md +49 -6
  309. package/docs/architecture/14-surfaces-and-parity.md +136 -0
  310. package/docs/architecture/README.md +17 -4
  311. package/docs/architecture/proposals/PROP-0006-run-checklist.md +4 -2
  312. package/docs/architecture/proposals/PROP-0013-resource-browser.md +58 -0
  313. package/docs/architecture/proposals/PROP-0014-fullscreen-browser-tabs.md +58 -0
  314. package/docs/architecture/proposals/PROP-0015-one-capability-surface.md +88 -0
  315. package/docs/architecture/proposals/PROP-0016-managed-worktrees.md +156 -0
  316. package/docs/architecture/proposals/PROP-0017-page-annotations.md +131 -0
  317. package/docs/architecture/proposals/PROP-0018-annotation-queue-and-app-targets.md +179 -0
  318. package/docs/architecture/proposals/PROP-0019-contextual-side-questions.md +122 -0
  319. package/docs/architecture/proposals/PROP-0020-builtin-feature-plugins.md +105 -0
  320. package/docs/architecture/proposals/PROP-0021-command-namespaces-and-duplicates.md +99 -0
  321. package/docs/architecture/proposals/PROP-0022-plan-only-questions.md +102 -0
  322. package/docs/architecture/proposals/PROP-0023-xagent-cli-name.md +61 -0
  323. package/docs/architecture/proposals/PROP-0024-question-sketch-previews.md +130 -0
  324. package/docs/architecture/proposals/PROP-0025-contextual-question-wireframes.md +49 -0
  325. package/docs/architecture/proposals/PROP-0026-connected-sketch-display.md +94 -0
  326. package/docs/architecture/proposals/PROP-0027-xingular-agent-product-identity.md +60 -0
  327. package/docs/architecture/proposals/PROP-0028-normalize-question-wireframes.md +55 -0
  328. package/docs/architecture/proposals/PROP-0029-agent-profiles.md +124 -0
  329. package/docs/architecture/proposals/PROP-0030-subagent-title.md +86 -0
  330. package/docs/architecture/proposals/PROP-0031-plugin-command-owner-namespaces.md +54 -0
  331. package/docs/architecture/proposals/PROP-0032-planning-quality.md +196 -0
  332. package/docs/architecture/proposals/PROP-0033-compaction-plan-checkpoints.md +75 -0
  333. package/docs/architecture/proposals/PROP-0034-conversation-fast-mode.md +120 -0
  334. package/docs/architecture/proposals/PROP-0035-retain-subagent-status.md +47 -0
  335. package/docs/architecture/proposals/PROP-0036-first-class-harness-commands.md +59 -0
  336. package/docs/architecture/proposals/PROP-0037-workspace-write-boundary.md +63 -0
  337. package/docs/architecture/proposals/PROP-0038-annotate-open-shadow-roots.md +73 -0
  338. package/docs/architecture/proposals/PROP-0039-workspace-boundary-hardening.md +139 -0
  339. package/docs/architecture/proposals/PROP-0040-one-launch-path.md +87 -0
  340. package/docs/architecture/proposals/PROP-0041-bounded-work-slices.md +247 -0
  341. package/docs/architecture/proposals/PROP-0042-usage-and-provider-limits.md +127 -0
  342. package/docs/architecture/proposals/PROP-0043-read-only-plan-bash.md +74 -0
  343. package/docs/architecture/proposals/README.md +39 -0
  344. package/docs/decisions/ADR-0001-owned-terminal.md +1 -1
  345. package/docs/decisions/ADR-0009-xharness-command.md +6 -5
  346. package/docs/decisions/ADR-0014-public-release-baseline.md +3 -2
  347. package/docs/decisions/ADR-0015-resource-browser.md +28 -0
  348. package/docs/decisions/ADR-0016-fullscreen-browser-tabs.md +31 -0
  349. package/docs/decisions/ADR-0017-one-capability-surface.md +34 -0
  350. package/docs/decisions/ADR-0018-builtin-feature-plugins.md +35 -0
  351. package/docs/decisions/ADR-0019-managed-git-worktrees.md +31 -0
  352. package/docs/decisions/ADR-0020-page-annotations.md +37 -0
  353. package/docs/decisions/ADR-0021-required-command-namespaces.md +40 -0
  354. package/docs/decisions/ADR-0022-plan-only-question-tools.md +34 -0
  355. package/docs/decisions/ADR-0023-contextual-side-question-runs.md +35 -0
  356. package/docs/decisions/ADR-0024-xagent-command.md +40 -0
  357. package/docs/decisions/ADR-0025-question-choice-sketches.md +49 -0
  358. package/docs/decisions/ADR-0026-contextual-question-wireframes.md +58 -0
  359. package/docs/decisions/ADR-0027-connected-sketch-display.md +60 -0
  360. package/docs/decisions/ADR-0028-xingular-agent-product-identity.md +56 -0
  361. package/docs/decisions/ADR-0029-normalized-question-wireframe-borders.md +33 -0
  362. package/docs/decisions/ADR-0030-agent-profiles.md +43 -0
  363. package/docs/decisions/ADR-0031-plugin-command-owner-namespaces.md +37 -0
  364. package/docs/decisions/ADR-0032-compaction-run-checkpoints.md +33 -0
  365. package/docs/decisions/ADR-0033-plan-mode-research-delegation.md +47 -0
  366. package/docs/decisions/ADR-0034-first-class-harness-terminal-commands.md +25 -0
  367. package/docs/decisions/ADR-0035-one-launch-path.md +40 -0
  368. package/docs/decisions/ADR-0036-workspace-write-operation-boundary.md +54 -0
  369. package/docs/decisions/ADR-0037-usage-ledger-and-provider-limits.md +44 -0
  370. package/docs/decisions/ADR-0038-plan-bash-os-read-only.md +29 -0
  371. package/docs/doctor.md +10 -4
  372. package/docs/experiments/EXP-0003-performance-audit/data/session-runtime-replication.json +420 -0
  373. package/docs/experiments/EXP-0003-performance-audit/data/session-runtime.json +420 -0
  374. package/docs/experiments/EXP-0003-performance-audit/data/terminal-compact.json +376 -0
  375. package/docs/experiments/EXP-0003-performance-audit/data/terminal-history.json +422 -0
  376. package/docs/experiments/EXP-0003-performance-audit/data/terminal-question.json +95 -0
  377. package/docs/experiments/EXP-0003-performance-audit/data/terminal-wide.json +1036 -0
  378. package/docs/experiments/EXP-0003-performance-audit/plan.md +109 -0
  379. package/docs/experiments/EXP-0003-performance-audit/results.md +151 -0
  380. package/docs/features/README.md +26 -0
  381. package/docs/features/interfaces/README.md +1 -1
  382. package/docs/future-work.md +48 -0
  383. package/docs/handoff-2026-10-25-app-parity-and-solo-tabs.md +202 -0
  384. package/docs/parity.md +134 -0
  385. package/docs/releases/1.0.0.md +2 -2
  386. package/docs/releases/1.1.1.md +28 -0
  387. package/docs/releases/1.2.0.md +49 -0
  388. package/docs/releases/4.0.0.md +47 -0
  389. package/docs/releases/README.md +37 -27
  390. package/docs/study/00-index.md +8 -0
  391. package/docs/study/STUDY-0003-long-horizon-runs.md +210 -0
  392. package/docs/study/autonomous-engineering-sources.md +277 -0
  393. package/docs/study/autonomy-sources.md +147 -0
  394. package/docs/study/proactive-autonomy.md +408 -0
  395. package/docs/study/tui-resource-browser.md +78 -0
  396. package/docs/terminal-tui.md +386 -113
  397. package/package.json +6 -5
package/docs/experiments/EXP-0003-performance-audit/data/terminal-history.json ADDED
@@ -0,0 +1,422 @@
1
+ {
2
+ "metadata": {
3
+ "commit": "6f72a07",
4
+ "workingTreeDirty": true,
5
+ "dirtyPathCount": 81,
6
+ "platform": "macOS-27.0-arm64-arm-64bit",
7
+ "machine": "arm64",
8
+ "cpuCount": 8,
9
+ "python": "3.12.12",
10
+ "node": "v26.8.2",
11
+ "bun": "1.4.2",
12
+ "harnessVersion": "1.1.1",
13
+ "piVersion": "1.2.0",
14
+ "opencodeVersion": "opencode v2.1.4"
15
+ },
16
+ "interval": 0.035,
17
+ "length": 30,
18
+ "rounds": 2,
19
+ "repeats": 3,
20
+ "size": "160x45",
21
+ "warmIdleSeconds": 1.0,
22
+ "idleSeconds": 1.0,
23
+ "streamSeconds": 2.0,
24
+ "scenarios": [
25
+ "history"
26
+ ],
27
+ "real": false,
28
+ "results": [
29
+ {
30
+ "target": "xingular",
31
+ "repeat": 1,
32
+ "command": "node",
33
+ "scenarios": {
34
+ "history": {
35
+ "keys": 44,
36
+ "missed": 0,
37
+ "p50": 5.27,
38
+ "p95": 10.1,
39
+ "p99": 10.64,
40
+ "max": 10.64,
41
+ "cpuPercent": 8.9,
42
+ "rssBeforeKb": 544304,
43
+ "rssAfterKb": 517792,
44
+ "bytesPerKey": 83,
45
+ "historySetupSeconds": 7.6
46
+ }
47
+ },
48
+ "startup": {
49
+ "launchToFirstOutputMs": 2470.47,
50
+ "launchToFirstVisibleMs": 2473.48,
51
+ "launchToQuietScreenMs": 3418.9,
52
+ "rssKb": 399408
53
+ },
54
+ "idleResourceUsage": {
55
+ "durationSeconds": 1.0,
56
+ "cpuPercent": 2.0,
57
+ "rssBeforeKb": 398960,
58
+ "rssAfterKb": 391600
59
+ }
60
+ },
61
+ {
62
+ "target": "pi",
63
+ "repeat": 1,
64
+ "command": "node",
65
+ "scenarios": {
66
+ "history": {
67
+ "keys": 44,
68
+ "missed": 0,
69
+ "p50": 5.44,
70
+ "p95": 10.59,
71
+ "p99": 10.91,
72
+ "max": 10.91,
73
+ "cpuPercent": 4.3,
74
+ "rssBeforeKb": 223280,
75
+ "rssAfterKb": 213488,
76
+ "bytesPerKey": 227,
77
+ "historySetupSeconds": 6.5
78
+ }
79
+ },
80
+ "startup": {
81
+ "launchToFirstOutputMs": 225.65,
82
+ "launchToFirstVisibleMs": 258.52,
83
+ "launchToQuietScreenMs": 1018.19,
84
+ "rssKb": 138832
85
+ },
86
+ "idleResourceUsage": {
87
+ "durationSeconds": 1.0,
88
+ "cpuPercent": 8.0,
89
+ "rssBeforeKb": 141792,
90
+ "rssAfterKb": 146352
91
+ }
92
+ },
93
+ {
94
+ "target": "opencode",
95
+ "repeat": 1,
96
+ "command": "opencode",
97
+ "scenarios": {
98
+ "history": {
99
+ "keys": 44,
100
+ "missed": 0,
101
+ "p50": 9.57,
102
+ "p95": 13.42,
103
+ "p99": 23.48,
104
+ "max": 23.48,
105
+ "cpuPercent": 31.9,
106
+ "rssBeforeKb": 658960,
107
+ "rssAfterKb": 697872,
108
+ "bytesPerKey": 92,
109
+ "historySetupSeconds": 9.7
110
+ }
111
+ },
112
+ "startup": {
113
+ "launchToFirstOutputMs": 300.63,
114
+ "launchToFirstVisibleMs": 303.96,
115
+ "launchToQuietScreenMs": 1074.24,
116
+ "rssKb": 538208
117
+ },
118
+ "idleResourceUsage": {
119
+ "durationSeconds": 1.0,
120
+ "cpuPercent": 7.0,
121
+ "rssBeforeKb": 578800,
122
+ "rssAfterKb": 571120
123
+ }
124
+ },
125
+ {
126
+ "target": "pi",
127
+ "repeat": 2,
128
+ "command": "node",
129
+ "scenarios": {
130
+ "history": {
131
+ "keys": 44,
132
+ "missed": 0,
133
+ "p50": 5.5,
134
+ "p95": 10.34,
135
+ "p99": 10.98,
136
+ "max": 10.98,
137
+ "cpuPercent": 4.9,
138
+ "rssBeforeKb": 229376,
139
+ "rssAfterKb": 217536,
140
+ "bytesPerKey": 227,
141
+ "historySetupSeconds": 6.5
142
+ }
143
+ },
144
+ "startup": {
145
+ "launchToFirstOutputMs": 238.26,
146
+ "launchToFirstVisibleMs": 269.65,
147
+ "launchToQuietScreenMs": 1024.96,
148
+ "rssKb": 138256
149
+ },
150
+ "idleResourceUsage": {
151
+ "durationSeconds": 1.0,
152
+ "cpuPercent": 0.0,
153
+ "rssBeforeKb": 149808,
154
+ "rssAfterKb": 149808
155
+ }
156
+ },
157
+ {
158
+ "target": "opencode",
159
+ "repeat": 2,
160
+ "command": "opencode",
161
+ "scenarios": {
162
+ "history": {
163
+ "keys": 44,
164
+ "missed": 0,
165
+ "p50": 9.35,
166
+ "p95": 12.44,
167
+ "p99": 12.57,
168
+ "max": 12.57,
169
+ "cpuPercent": 32.6,
170
+ "rssBeforeKb": 654416,
171
+ "rssAfterKb": 551520,
172
+ "bytesPerKey": 92,
173
+ "historySetupSeconds": 9.8
174
+ }
175
+ },
176
+ "startup": {
177
+ "launchToFirstOutputMs": 296.64,
178
+ "launchToFirstVisibleMs": 299.99,
179
+ "launchToQuietScreenMs": 1061.07,
180
+ "rssKb": 538576
181
+ },
182
+ "idleResourceUsage": {
183
+ "durationSeconds": 1.0,
184
+ "cpuPercent": 8.0,
185
+ "rssBeforeKb": 547504,
186
+ "rssAfterKb": 534864
187
+ }
188
+ },
189
+ {
190
+ "target": "xingular",
191
+ "repeat": 2,
192
+ "command": "node",
193
+ "scenarios": {
194
+ "history": {
195
+ "keys": 44,
196
+ "missed": 0,
197
+ "p50": 5.09,
198
+ "p95": 10.05,
199
+ "p99": 10.26,
200
+ "max": 10.26,
201
+ "cpuPercent": 9.2,
202
+ "rssBeforeKb": 419248,
203
+ "rssAfterKb": 302352,
204
+ "bytesPerKey": 83,
205
+ "historySetupSeconds": 7.5
206
+ }
207
+ },
208
+ "startup": {
209
+ "launchToFirstOutputMs": 2403.07,
210
+ "launchToFirstVisibleMs": 2405.4,
211
+ "launchToQuietScreenMs": 3391.33,
212
+ "rssKb": 456944
213
+ },
214
+ "idleResourceUsage": {
215
+ "durationSeconds": 1.0,
216
+ "cpuPercent": 3.0,
217
+ "rssBeforeKb": 457136,
218
+ "rssAfterKb": 457136
219
+ }
220
+ },
221
+ {
222
+ "target": "opencode",
223
+ "repeat": 3,
224
+ "command": "opencode",
225
+ "scenarios": {
226
+ "history": {
227
+ "keys": 44,
228
+ "missed": 0,
229
+ "p50": 9.47,
230
+ "p95": 12.7,
231
+ "p99": 13.17,
232
+ "max": 13.17,
233
+ "cpuPercent": 33.8,
234
+ "rssBeforeKb": 618384,
235
+ "rssAfterKb": 654448,
236
+ "bytesPerKey": 92,
237
+ "historySetupSeconds": 9.8
238
+ }
239
+ },
240
+ "startup": {
241
+ "launchToFirstOutputMs": 303.6,
242
+ "launchToFirstVisibleMs": 306.75,
243
+ "launchToQuietScreenMs": 1072.94,
244
+ "rssKb": 512736
245
+ },
246
+ "idleResourceUsage": {
247
+ "durationSeconds": 1.0,
248
+ "cpuPercent": 8.0,
249
+ "rssBeforeKb": 477600,
250
+ "rssAfterKb": 437280
251
+ }
252
+ },
253
+ {
254
+ "target": "xingular",
255
+ "repeat": 3,
256
+ "command": "node",
257
+ "scenarios": {
258
+ "history": {
259
+ "keys": 44,
260
+ "missed": 0,
261
+ "p50": 4.15,
262
+ "p95": 8.93,
263
+ "p99": 10.63,
264
+ "max": 10.63,
265
+ "cpuPercent": 8.3,
266
+ "rssBeforeKb": 456656,
267
+ "rssAfterKb": 439776,
268
+ "bytesPerKey": 83,
269
+ "historySetupSeconds": 7.3
270
+ }
271
+ },
272
+ "startup": {
273
+ "launchToFirstOutputMs": 2337.31,
274
+ "launchToFirstVisibleMs": 2340.57,
275
+ "launchToQuietScreenMs": 3293.34,
276
+ "rssKb": 455792
277
+ },
278
+ "idleResourceUsage": {
279
+ "durationSeconds": 1.0,
280
+ "cpuPercent": 1.0,
281
+ "rssBeforeKb": 455952,
282
+ "rssAfterKb": 430096
283
+ }
284
+ },
285
+ {
286
+ "target": "pi",
287
+ "repeat": 3,
288
+ "command": "node",
289
+ "scenarios": {
290
+ "history": {
291
+ "keys": 44,
292
+ "missed": 0,
293
+ "p50": 5.14,
294
+ "p95": 10.13,
295
+ "p99": 11.02,
296
+ "max": 11.02,
297
+ "cpuPercent": 4.3,
298
+ "rssBeforeKb": 219696,
299
+ "rssAfterKb": 209648,
300
+ "bytesPerKey": 227,
301
+ "historySetupSeconds": 6.5
302
+ }
303
+ },
304
+ "startup": {
305
+ "launchToFirstOutputMs": 227.51,
306
+ "launchToFirstVisibleMs": 259.86,
307
+ "launchToQuietScreenMs": 1013.32,
308
+ "rssKb": 137200
309
+ },
310
+ "idleResourceUsage": {
311
+ "durationSeconds": 1.0,
312
+ "cpuPercent": 0.0,
313
+ "rssBeforeKb": 144368,
314
+ "rssAfterKb": 144368
315
+ }
316
+ }
317
+ ],
318
+ "summary": [
319
+ {
320
+ "target": "opencode",
321
+ "runs": 3,
322
+ "startup": {
323
+ "runs": 3,
324
+ "launchToFirstOutputMs": 300.63,
325
+ "launchToFirstVisibleMs": 303.96,
326
+ "launchToQuietScreenMs": 1072.94,
327
+ "rssKb": 538208
328
+ },
329
+ "idleResourceUsage": {
330
+ "runs": 3,
331
+ "cpuPercent": 8.0,
332
+ "durationSeconds": 1.0,
333
+ "rssAfterKb": 534864,
334
+ "rssBeforeKb": 547504
335
+ },
336
+ "scenarios": {
337
+ "history": {
338
+ "runs": 3,
339
+ "bytesPerKey": 92,
340
+ "cpuPercent": 32.6,
341
+ "historySetupSeconds": 9.8,
342
+ "keys": 44,
343
+ "max": 13.17,
344
+ "missed": 0,
345
+ "p50": 9.47,
346
+ "p95": 12.7,
347
+ "p99": 13.17,
348
+ "rssAfterKb": 654448,
349
+ "rssBeforeKb": 654416
350
+ }
351
+ }
352
+ },
353
+ {
354
+ "target": "pi",
355
+ "runs": 3,
356
+ "startup": {
357
+ "runs": 3,
358
+ "launchToFirstOutputMs": 227.51,
359
+ "launchToFirstVisibleMs": 259.86,
360
+ "launchToQuietScreenMs": 1018.19,
361
+ "rssKb": 138256
362
+ },
363
+ "idleResourceUsage": {
364
+ "runs": 3,
365
+ "cpuPercent": 0.0,
366
+ "durationSeconds": 1.0,
367
+ "rssAfterKb": 146352,
368
+ "rssBeforeKb": 144368
369
+ },
370
+ "scenarios": {
371
+ "history": {
372
+ "runs": 3,
373
+ "bytesPerKey": 227,
374
+ "cpuPercent": 4.3,
375
+ "historySetupSeconds": 6.5,
376
+ "keys": 44,
377
+ "max": 10.98,
378
+ "missed": 0,
379
+ "p50": 5.44,
380
+ "p95": 10.34,
381
+ "p99": 10.98,
382
+ "rssAfterKb": 213488,
383
+ "rssBeforeKb": 223280
384
+ }
385
+ }
386
+ },
387
+ {
388
+ "target": "xingular",
389
+ "runs": 3,
390
+ "startup": {
391
+ "runs": 3,
392
+ "launchToFirstOutputMs": 2403.07,
393
+ "launchToFirstVisibleMs": 2405.4,
394
+ "launchToQuietScreenMs": 3391.33,
395
+ "rssKb": 455792
396
+ },
397
+ "idleResourceUsage": {
398
+ "runs": 3,
399
+ "cpuPercent": 2.0,
400
+ "durationSeconds": 1.0,
401
+ "rssAfterKb": 430096,
402
+ "rssBeforeKb": 455952
403
+ },
404
+ "scenarios": {
405
+ "history": {
406
+ "runs": 3,
407
+ "bytesPerKey": 83,
408
+ "cpuPercent": 8.9,
409
+ "historySetupSeconds": 7.5,
410
+ "keys": 44,
411
+ "max": 10.63,
412
+ "missed": 0,
413
+ "p50": 5.09,
414
+ "p95": 10.05,
415
+ "p99": 10.63,
416
+ "rssAfterKb": 439776,
417
+ "rssBeforeKb": 456656
418
+ }
419
+ }
420
+ }
421
+ ]
422
+ }
package/docs/experiments/EXP-0003-performance-audit/data/terminal-question.json ADDED
@@ -0,0 +1,95 @@
1
+ {
2
+ "metadata": {
3
+ "commit": "6f72a07",
4
+ "workingTreeDirty": true,
5
+ "dirtyPathCount": 81,
6
+ "platform": "macOS-27.0-arm64-arm-64bit",
7
+ "machine": "arm64",
8
+ "cpuCount": 8,
9
+ "python": "3.12.12",
10
+ "node": "v26.8.2",
11
+ "bun": "1.4.2",
12
+ "harnessVersion": "1.1.1",
13
+ "piVersion": "1.2.0",
14
+ "opencodeVersion": "opencode v2.1.4"
15
+ },
16
+ "interval": 0.035,
17
+ "length": 30,
18
+ "rounds": 2,
19
+ "repeats": 1,
20
+ "size": "160x45",
21
+ "idleSeconds": 1.0,
22
+ "streamSeconds": 3.0,
23
+ "scenarios": [
24
+ "question"
25
+ ],
26
+ "real": false,
27
+ "results": [
28
+ {
29
+ "target": "xingular",
30
+ "repeat": 1,
31
+ "command": "node",
32
+ "scenarios": {
33
+ "question": {
34
+ "keys": 44,
35
+ "missed": 0,
36
+ "p50": 5.03,
37
+ "p95": 9.53,
38
+ "p99": 9.78,
39
+ "max": 9.78,
40
+ "cpuPercent": 10.8,
41
+ "rssBeforeKb": 413232,
42
+ "rssAfterKb": 405024,
43
+ "bytesPerKey": 83
44
+ }
45
+ },
46
+ "startup": {
47
+ "launchToFirstOutputMs": 2472.05,
48
+ "launchToFirstVisibleMs": 2474.64,
49
+ "launchToQuietScreenMs": 3483.83,
50
+ "rssKb": 358272
51
+ },
52
+ "idleResourceUsage": {
53
+ "durationSeconds": 1.0,
54
+ "cpuPercent": 3.0,
55
+ "rssBeforeKb": 358272,
56
+ "rssAfterKb": 358576
57
+ }
58
+ }
59
+ ],
60
+ "summary": [
61
+ {
62
+ "target": "xingular",
63
+ "runs": 1,
64
+ "startup": {
65
+ "runs": 1,
66
+ "launchToFirstOutputMs": 2472.05,
67
+ "launchToFirstVisibleMs": 2474.64,
68
+ "launchToQuietScreenMs": 3483.83,
69
+ "rssKb": 358272
70
+ },
71
+ "idleResourceUsage": {
72
+ "runs": 1,
73
+ "cpuPercent": 3.0,
74
+ "durationSeconds": 1.0,
75
+ "rssAfterKb": 358576,
76
+ "rssBeforeKb": 358272
77
+ },
78
+ "scenarios": {
79
+ "question": {
80
+ "runs": 1,
81
+ "bytesPerKey": 83,
82
+ "cpuPercent": 10.8,
83
+ "keys": 44,
84
+ "max": 9.78,
85
+ "missed": 0,
86
+ "p50": 5.03,
87
+ "p95": 9.53,
88
+ "p99": 9.78,
89
+ "rssAfterKb": 405024,
90
+ "rssBeforeKb": 413232
91
+ }
92
+ }
93
+ }
94
+ ]
95
+ }