@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
@@ -0,0 +1,420 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "benchmark": "harness-session-runtime-overhead",
4
+ "status": "ok",
5
+ "metadata": {
6
+ "generatedAt": "2026-10-25T04:50:13.626Z",
7
+ "scriptVersion": 1,
8
+ "node": "v26.8.2",
9
+ "platform": "darwin",
10
+ "arch": "arm64",
11
+ "iterations": 5,
12
+ "warmups": 1,
13
+ "operationTimeoutMs": 5000,
14
+ "maxBenchmarkDurationMs": 120000,
15
+ "isolation": {
16
+ "dataAndStateRootsAreTemporary": true,
17
+ "homeIsRedirectedToTemporaryRoot": true,
18
+ "userPiCodexClaudeProfilesUsed": false,
19
+ "credentialsUsed": false,
20
+ "modelProvider": null,
21
+ "sessionImplementation": "injected deterministic fake session"
22
+ },
23
+ "outputPath": "/private/tmp/harness-session-runtime-audit.json",
24
+ "harnessVersion": "1.1.1",
25
+ "temporaryRootsRemoved": true,
26
+ "elapsedMs": 1966.283
27
+ },
28
+ "measurements": {
29
+ "sdkModuleImport": {
30
+ "ok": true,
31
+ "elapsedMs": 245.822,
32
+ "entrypoint": "dist/sdk/index.js"
33
+ },
34
+ "harnessInitialization": {
35
+ "ok": true,
36
+ "elapsedMs": 27.782
37
+ },
38
+ "terminalPreparation": {
39
+ "cold": {
40
+ "ok": true,
41
+ "prepareMs": 1157.73
42
+ },
43
+ "description": "First terminal.prepare call in this Harness process, including first socket-listener setup.",
44
+ "warmupErrors": [],
45
+ "samples": [
46
+ {
47
+ "index": 1,
48
+ "ok": true,
49
+ "prepareMs": 9.76
50
+ },
51
+ {
52
+ "index": 2,
53
+ "ok": true,
54
+ "prepareMs": 7.69
55
+ },
56
+ {
57
+ "index": 3,
58
+ "ok": true,
59
+ "prepareMs": 9.106
60
+ },
61
+ {
62
+ "index": 4,
63
+ "ok": true,
64
+ "prepareMs": 9.543
65
+ },
66
+ {
67
+ "index": 5,
68
+ "ok": true,
69
+ "prepareMs": 10.794
70
+ }
71
+ ],
72
+ "summary": {
73
+ "prepareMs": {
74
+ "count": 5,
75
+ "minMs": 7.69,
76
+ "medianMs": 9.543,
77
+ "meanMs": 9.379,
78
+ "p95Ms": 10.794,
79
+ "maxMs": 10.794
80
+ }
81
+ }
82
+ },
83
+ "sessionsRun": {
84
+ "description": "sessions.run invocation through first persisted message.delta and terminal completed event.",
85
+ "warmupErrors": [],
86
+ "samples": [
87
+ {
88
+ "index": 1,
89
+ "ok": true,
90
+ "runId": "profile-run-run-sample-1-2",
91
+ "metrics": {
92
+ "runReturnMs": 24.623,
93
+ "invocationToFirstDeltaMs": 24.331,
94
+ "invocationToCompletionMs": 32.75,
95
+ "persistence": {
96
+ "verified": true,
97
+ "eventCount": 6,
98
+ "eventLogBytes": 4295,
99
+ "eventTypes": [
100
+ "started",
101
+ "status.changed",
102
+ "context.snapshot",
103
+ "message.delta",
104
+ "message.completed",
105
+ "completed"
106
+ ]
107
+ }
108
+ }
109
+ },
110
+ {
111
+ "index": 2,
112
+ "ok": true,
113
+ "runId": "profile-run-run-sample-2-3",
114
+ "metrics": {
115
+ "runReturnMs": 22.063,
116
+ "invocationToFirstDeltaMs": 21.78,
117
+ "invocationToCompletionMs": 27.958,
118
+ "persistence": {
119
+ "verified": true,
120
+ "eventCount": 6,
121
+ "eventLogBytes": 4295,
122
+ "eventTypes": [
123
+ "started",
124
+ "status.changed",
125
+ "context.snapshot",
126
+ "message.delta",
127
+ "message.completed",
128
+ "completed"
129
+ ]
130
+ }
131
+ }
132
+ },
133
+ {
134
+ "index": 3,
135
+ "ok": true,
136
+ "runId": "profile-run-run-sample-3-4",
137
+ "metrics": {
138
+ "runReturnMs": 26.993,
139
+ "invocationToFirstDeltaMs": 26.705,
140
+ "invocationToCompletionMs": 33.742,
141
+ "persistence": {
142
+ "verified": true,
143
+ "eventCount": 6,
144
+ "eventLogBytes": 4295,
145
+ "eventTypes": [
146
+ "started",
147
+ "status.changed",
148
+ "context.snapshot",
149
+ "message.delta",
150
+ "message.completed",
151
+ "completed"
152
+ ]
153
+ }
154
+ }
155
+ },
156
+ {
157
+ "index": 4,
158
+ "ok": true,
159
+ "runId": "profile-run-run-sample-4-5",
160
+ "metrics": {
161
+ "runReturnMs": 29.684,
162
+ "invocationToFirstDeltaMs": 29.336,
163
+ "invocationToCompletionMs": 35.116,
164
+ "persistence": {
165
+ "verified": true,
166
+ "eventCount": 6,
167
+ "eventLogBytes": 4295,
168
+ "eventTypes": [
169
+ "started",
170
+ "status.changed",
171
+ "context.snapshot",
172
+ "message.delta",
173
+ "message.completed",
174
+ "completed"
175
+ ]
176
+ }
177
+ }
178
+ },
179
+ {
180
+ "index": 5,
181
+ "ok": true,
182
+ "runId": "profile-run-run-sample-5-6",
183
+ "metrics": {
184
+ "runReturnMs": 24.774,
185
+ "invocationToFirstDeltaMs": 24.484,
186
+ "invocationToCompletionMs": 32.473,
187
+ "persistence": {
188
+ "verified": true,
189
+ "eventCount": 6,
190
+ "eventLogBytes": 4295,
191
+ "eventTypes": [
192
+ "started",
193
+ "status.changed",
194
+ "context.snapshot",
195
+ "message.delta",
196
+ "message.completed",
197
+ "completed"
198
+ ]
199
+ }
200
+ }
201
+ }
202
+ ],
203
+ "summary": {
204
+ "runReturnMs": {
205
+ "count": 5,
206
+ "minMs": 22.063,
207
+ "medianMs": 24.774,
208
+ "meanMs": 25.627,
209
+ "p95Ms": 29.684,
210
+ "maxMs": 29.684
211
+ },
212
+ "invocationToFirstDeltaMs": {
213
+ "count": 5,
214
+ "minMs": 21.78,
215
+ "medianMs": 24.484,
216
+ "meanMs": 25.327,
217
+ "p95Ms": 29.336,
218
+ "maxMs": 29.336
219
+ },
220
+ "invocationToCompletionMs": {
221
+ "count": 5,
222
+ "minMs": 27.958,
223
+ "medianMs": 32.75,
224
+ "meanMs": 32.408,
225
+ "p95Ms": 35.116,
226
+ "maxMs": 35.116
227
+ }
228
+ }
229
+ },
230
+ "toolEventPersistence": {
231
+ "description": "One synthetic tool execution and the validated, persisted tool/event stream.",
232
+ "warmupErrors": [],
233
+ "samples": [
234
+ {
235
+ "index": 1,
236
+ "ok": true,
237
+ "runId": "profile-run-tool-sample-1-8",
238
+ "metrics": {
239
+ "runReturnMs": 28.263,
240
+ "invocationToFirstDeltaMs": 28.771,
241
+ "invocationToCompletionMs": 37.074,
242
+ "invocationToToolStartedMs": 28.26,
243
+ "invocationToToolCompletedMs": 28.573,
244
+ "persistence": {
245
+ "verified": true,
246
+ "eventCount": 8,
247
+ "eventLogBytes": 5060,
248
+ "eventTypes": [
249
+ "started",
250
+ "status.changed",
251
+ "context.snapshot",
252
+ "tool.started",
253
+ "tool.completed",
254
+ "message.delta",
255
+ "message.completed",
256
+ "completed"
257
+ ]
258
+ }
259
+ }
260
+ },
261
+ {
262
+ "index": 2,
263
+ "ok": true,
264
+ "runId": "profile-run-tool-sample-2-9",
265
+ "metrics": {
266
+ "runReturnMs": 27.771,
267
+ "invocationToFirstDeltaMs": 28.274,
268
+ "invocationToCompletionMs": 37.555,
269
+ "invocationToToolStartedMs": 27.768,
270
+ "invocationToToolCompletedMs": 28.069,
271
+ "persistence": {
272
+ "verified": true,
273
+ "eventCount": 8,
274
+ "eventLogBytes": 5060,
275
+ "eventTypes": [
276
+ "started",
277
+ "status.changed",
278
+ "context.snapshot",
279
+ "tool.started",
280
+ "tool.completed",
281
+ "message.delta",
282
+ "message.completed",
283
+ "completed"
284
+ ]
285
+ }
286
+ }
287
+ },
288
+ {
289
+ "index": 3,
290
+ "ok": true,
291
+ "runId": "profile-run-tool-sample-3-10",
292
+ "metrics": {
293
+ "runReturnMs": 29.133,
294
+ "invocationToFirstDeltaMs": 29.696,
295
+ "invocationToCompletionMs": 38.952,
296
+ "invocationToToolStartedMs": 29.129,
297
+ "invocationToToolCompletedMs": 29.471,
298
+ "persistence": {
299
+ "verified": true,
300
+ "eventCount": 8,
301
+ "eventLogBytes": 5080,
302
+ "eventTypes": [
303
+ "started",
304
+ "status.changed",
305
+ "context.snapshot",
306
+ "tool.started",
307
+ "tool.completed",
308
+ "message.delta",
309
+ "message.completed",
310
+ "completed"
311
+ ]
312
+ }
313
+ }
314
+ },
315
+ {
316
+ "index": 4,
317
+ "ok": true,
318
+ "runId": "profile-run-tool-sample-4-11",
319
+ "metrics": {
320
+ "runReturnMs": 29.109,
321
+ "invocationToFirstDeltaMs": 29.779,
322
+ "invocationToCompletionMs": 38.965,
323
+ "invocationToToolStartedMs": 29.105,
324
+ "invocationToToolCompletedMs": 29.527,
325
+ "persistence": {
326
+ "verified": true,
327
+ "eventCount": 8,
328
+ "eventLogBytes": 5080,
329
+ "eventTypes": [
330
+ "started",
331
+ "status.changed",
332
+ "context.snapshot",
333
+ "tool.started",
334
+ "tool.completed",
335
+ "message.delta",
336
+ "message.completed",
337
+ "completed"
338
+ ]
339
+ }
340
+ }
341
+ },
342
+ {
343
+ "index": 5,
344
+ "ok": true,
345
+ "runId": "profile-run-tool-sample-5-12",
346
+ "metrics": {
347
+ "runReturnMs": 29.194,
348
+ "invocationToFirstDeltaMs": 29.848,
349
+ "invocationToCompletionMs": 39.943,
350
+ "invocationToToolStartedMs": 29.19,
351
+ "invocationToToolCompletedMs": 29.584,
352
+ "persistence": {
353
+ "verified": true,
354
+ "eventCount": 8,
355
+ "eventLogBytes": 5080,
356
+ "eventTypes": [
357
+ "started",
358
+ "status.changed",
359
+ "context.snapshot",
360
+ "tool.started",
361
+ "tool.completed",
362
+ "message.delta",
363
+ "message.completed",
364
+ "completed"
365
+ ]
366
+ }
367
+ }
368
+ }
369
+ ],
370
+ "summary": {
371
+ "runReturnMs": {
372
+ "count": 5,
373
+ "minMs": 27.771,
374
+ "medianMs": 29.109,
375
+ "meanMs": 28.694,
376
+ "p95Ms": 29.194,
377
+ "maxMs": 29.194
378
+ },
379
+ "invocationToFirstDeltaMs": {
380
+ "count": 5,
381
+ "minMs": 28.274,
382
+ "medianMs": 29.696,
383
+ "meanMs": 29.274,
384
+ "p95Ms": 29.848,
385
+ "maxMs": 29.848
386
+ },
387
+ "invocationToToolStartedMs": {
388
+ "count": 5,
389
+ "minMs": 27.768,
390
+ "medianMs": 29.105,
391
+ "meanMs": 28.69,
392
+ "p95Ms": 29.19,
393
+ "maxMs": 29.19
394
+ },
395
+ "invocationToToolCompletedMs": {
396
+ "count": 5,
397
+ "minMs": 28.069,
398
+ "medianMs": 29.471,
399
+ "meanMs": 29.045,
400
+ "p95Ms": 29.584,
401
+ "maxMs": 29.584
402
+ },
403
+ "invocationToCompletionMs": {
404
+ "count": 5,
405
+ "minMs": 37.074,
406
+ "medianMs": 38.952,
407
+ "meanMs": 38.498,
408
+ "p95Ms": 39.943,
409
+ "maxMs": 39.943
410
+ }
411
+ }
412
+ }
413
+ },
414
+ "limitations": [
415
+ "Terminal timing covers Harness Terminals.prepare and its launch specification only; it does not spawn Bun/OpenTUI or measure interactive terminal process startup.",
416
+ "Session timings include Harness preparation, event validation, synchronous run-event persistence, and the injected fake-session seam; they exclude model/provider latency and real Pi initialization.",
417
+ "The tool case executes one deterministic local ToolSpec through the injected session, then verifies tool.started/tool.completed/message.delta/completed in the on-disk run event log."
418
+ ],
419
+ "errors": []
420
+ }