gentle-pi 3.7.0 → 4.1.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 (590) hide show
  1. package/README.md +155 -10
  2. package/assets/agents/gentle-ai-explore.md +13 -6
  3. package/assets/agents/gentle-ai-verify.md +27 -6
  4. package/assets/agents/gentle-ai-worker.md +13 -15
  5. package/assets/install-wizard/index.html +47 -0
  6. package/assets/install-wizard/wizard.css +1279 -0
  7. package/assets/install-wizard/wizard.js +951 -0
  8. package/assets/orchestrator-delegation.md +75 -169
  9. package/assets/orchestrator-memory.md +12 -26
  10. package/assets/orchestrator-prompts.md +48 -0
  11. package/assets/orchestrator-skills.md +1 -1
  12. package/assets/orchestrator-tracking.md +53 -0
  13. package/assets/orchestrator-verification.md +28 -0
  14. package/assets/orchestrator-writer.md +38 -0
  15. package/assets/orchestrator.md +30 -38
  16. package/assets/sounds/LICENSE.md +52 -0
  17. package/assets/sounds/attention.wav +0 -0
  18. package/assets/sounds/error.wav +0 -0
  19. package/assets/sounds/success.wav +0 -0
  20. package/assets/support/strict-tdd-verify.md +4 -266
  21. package/assets/support/strict-tdd.md +8 -360
  22. package/bin/engram-guard +9 -0
  23. package/bin/gentle-shell-install.mjs +302 -0
  24. package/bin/gentle-shell.mjs +956 -50
  25. package/contracts/review-provider-contract-mirror/provider-contract.lock.json +7 -7
  26. package/contracts/review-provider-contract-mirror/{v1.2.0 → v1.3.0}/bundle/manifest.json +2 -2
  27. package/contracts/review-provider-contract-mirror/{v1.2.0 → v1.3.0}/bundle/orchestration/pi.md +16 -4
  28. package/contracts/review-provider-contract-mirror/{v1.2.0 → v1.3.0}/generated/provider-capabilities.baseline.json +2 -2
  29. package/contracts/review-provider-contract-mirror/{v1.2.0 → v1.3.0}/generated/provider-roles.baseline.json +1 -1
  30. package/docs/bundled-install.md +397 -0
  31. package/docs/delegated-verification.md +27 -4
  32. package/docs/gentle-agents-activity.md +537 -0
  33. package/docs/gentle-shell-uninstall.md +136 -0
  34. package/docs/gentle-shell.md +165 -51
  35. package/docs/install-wizard.md +2040 -0
  36. package/docs/native-authority-architecture.md +3 -3
  37. package/docs/permission-modes.md +82 -0
  38. package/docs/prompt-history.md +280 -0
  39. package/docs/readme-reference.md +364 -231
  40. package/docs/render-cache-performance.md +28 -0
  41. package/docs/sound-notifications-proposal.md +191 -0
  42. package/docs/sound-notifications.md +114 -0
  43. package/docs/telemetry.md +1 -1
  44. package/docs/yolo-mode.md +86 -0
  45. package/extensions/child-context.ts +35 -0
  46. package/extensions/child-safety.ts +25 -0
  47. package/extensions/codegraph-tools.ts +18 -5
  48. package/extensions/gentle-agents.ts +1093 -326
  49. package/extensions/gentle-ai.ts +1636 -890
  50. package/extensions/gentle-herdr-activity.ts +81 -0
  51. package/extensions/gentle-notifications.ts +104 -0
  52. package/extensions/gentle-shell.ts +1619 -136
  53. package/extensions/gentle-stats.ts +101 -0
  54. package/extensions/gentle-todo.ts +126 -20
  55. package/extensions/history/atomic-write.ts +38 -0
  56. package/extensions/history/hide-prompts.ts +183 -0
  57. package/extensions/history/index.ts +1424 -0
  58. package/extensions/history/load-shared-history.ts +39 -0
  59. package/extensions/history/selector-helpers.ts +538 -0
  60. package/extensions/history/session-scan.ts +233 -0
  61. package/extensions/history/store.ts +1119 -0
  62. package/extensions/nan-provider.ts +6 -0
  63. package/extensions/pi-pretty.ts +39 -3
  64. package/extensions/quiet-tools.ts +254 -92
  65. package/extensions/resume-hint.ts +60 -0
  66. package/extensions/skill-registry.ts +191 -58
  67. package/extensions/startup-banner.ts +71 -33
  68. package/lib/agent-assets.ts +604 -0
  69. package/lib/agent-home.ts +10 -1
  70. package/lib/agent-model-resolution.ts +80 -0
  71. package/lib/agent-profile-pin.ts +12 -0
  72. package/lib/agent-profiles.ts +13 -3
  73. package/lib/agents-completion-delivery.ts +11 -3
  74. package/lib/agents-message-delivery.ts +181 -0
  75. package/lib/agents-messaging.ts +1 -1
  76. package/lib/agents-protocol.ts +99 -0
  77. package/lib/agents-runner.ts +180 -107
  78. package/lib/agents-view.ts +26 -3
  79. package/lib/agents-widget.ts +16 -9
  80. package/lib/append-system-prompt.ts +21 -0
  81. package/lib/auto-permission-classifier.ts +280 -0
  82. package/lib/auto-permission-runtime.ts +268 -0
  83. package/lib/background-jobs-tools.ts +202 -0
  84. package/lib/background-jobs.ts +253 -0
  85. package/lib/background-monitor.ts +154 -0
  86. package/lib/bounded-writer-admission.ts +220 -0
  87. package/lib/builtin-codemode-optout.ts +166 -0
  88. package/lib/card-content-policy.ts +85 -0
  89. package/lib/card-style-policy.ts +60 -0
  90. package/lib/child-context-files.ts +166 -0
  91. package/lib/child-package-injection.ts +62 -0
  92. package/lib/codemode-renderer.ts +195 -0
  93. package/lib/command-palette-catalog.ts +5 -10
  94. package/lib/command-palette.ts +25 -14
  95. package/lib/context-threshold.ts +26 -0
  96. package/lib/destructive-command-guard.ts +144 -0
  97. package/lib/gentle-ai-binary.ts +109 -4
  98. package/lib/gentle-ai-elapsed-store.ts +87 -0
  99. package/lib/gentle-ai-renderer.ts +196 -39
  100. package/lib/gentle-shell-bundled.ts +517 -0
  101. package/lib/gentle-shell-launcher.ts +89 -27
  102. package/lib/gentle-shell-resume-hint.ts +176 -0
  103. package/lib/gentle-shell-startup-flow.ts +54 -0
  104. package/lib/gentle-shell-startup-update.ts +92 -0
  105. package/lib/gentle-shell-uninstall.ts +840 -0
  106. package/lib/gentle-shell-update-panel.ts +231 -0
  107. package/lib/herdr-activity.ts +183 -0
  108. package/lib/history-capture-policy.ts +95 -0
  109. package/lib/inprocess-reviewer.ts +3 -0
  110. package/lib/jobs-sidebar-state.ts +20 -0
  111. package/lib/jobs-view.ts +161 -0
  112. package/lib/model-price-ratio.ts +83 -0
  113. package/lib/model-routing-authority.ts +5 -1
  114. package/lib/nan-provider.ts +249 -0
  115. package/lib/native-review-cli.ts +242 -180
  116. package/lib/notification-audio-native.ts +162 -0
  117. package/lib/notification-audio-windows.ts +399 -0
  118. package/lib/notification-audio.ts +332 -0
  119. package/lib/notification-customize.ts +241 -0
  120. package/lib/notification-events.ts +113 -0
  121. package/lib/notification-policy.ts +148 -0
  122. package/lib/notification-pulse-client.ts +367 -0
  123. package/lib/notification-pulse-protocol.ts +305 -0
  124. package/lib/notification-pulse-stream.ts +213 -0
  125. package/lib/notification-pulse-worker.ts +66 -0
  126. package/lib/notification-scheduler.ts +173 -0
  127. package/lib/notification-service.ts +202 -0
  128. package/lib/notification-ui.ts +87 -0
  129. package/lib/odd-phase-inference.ts +231 -0
  130. package/lib/odd-phase.ts +141 -0
  131. package/lib/orchestrator-alias.ts +20 -0
  132. package/lib/orchestrator-catalog.ts +79 -0
  133. package/lib/orchestrator-consultation.ts +61 -0
  134. package/lib/orchestrator-discovery.ts +49 -0
  135. package/lib/orchestrator-helper-consent.ts +122 -0
  136. package/lib/orchestrator-helper.ts +167 -0
  137. package/lib/orchestrator-message-card.ts +105 -0
  138. package/lib/orchestrator-presence.ts +115 -14
  139. package/lib/orchestrator-scope.ts +80 -0
  140. package/lib/orchestrator-state.ts +107 -0
  141. package/lib/orchestrator-tool-card.ts +280 -0
  142. package/lib/orchestrator-work-search.ts +218 -0
  143. package/lib/orchestrator-work.ts +79 -0
  144. package/lib/overlay-repaint.ts +26 -0
  145. package/lib/permission-mode-policy.ts +59 -0
  146. package/lib/pi-tui-keys.ts +53 -0
  147. package/lib/review-candidate-view-owner.ts +73 -21
  148. package/lib/review-candidate-view.ts +115 -27
  149. package/lib/review-compact-contract.ts +2 -2
  150. package/lib/review-host-relay.ts +7 -2
  151. package/lib/review-integration-v2.ts +100 -22
  152. package/lib/review-publication-gate.ts +1 -1
  153. package/lib/review-reminder-receipt.ts +48 -8
  154. package/lib/review-risk-assessment.ts +227 -56
  155. package/lib/review-sidebar-state.ts +224 -0
  156. package/lib/review-transaction.ts +72 -3
  157. package/lib/runtime-metrics-children.ts +1 -1
  158. package/lib/runtime-metrics-native.ts +3 -2
  159. package/lib/selection-engine.ts +527 -0
  160. package/lib/session-change-capture.ts +5 -4
  161. package/lib/session-changes.ts +27 -22
  162. package/lib/session-messaging-grants.ts +135 -0
  163. package/lib/session-profile-binding.ts +83 -0
  164. package/lib/session-profile-freeze.ts +266 -0
  165. package/lib/session-worktree-registry.ts +87 -9
  166. package/lib/shell-bar.ts +215 -30
  167. package/lib/shell-card.ts +287 -18
  168. package/lib/shell-changes-view.ts +42 -14
  169. package/lib/shell-changes.ts +86 -71
  170. package/lib/shell-prompt.ts +102 -6
  171. package/lib/shell-sidebar-layout.ts +83 -15
  172. package/lib/shell-sidebar.ts +15 -1
  173. package/lib/shell-todo.ts +84 -31
  174. package/lib/shell-usage-view.ts +9 -4
  175. package/lib/shell-usage.ts +70 -13
  176. package/lib/stats-collector.ts +381 -0
  177. package/lib/stats-view.ts +431 -0
  178. package/lib/status-timing-diagnostics.ts +201 -0
  179. package/lib/telemetry-trigger.ts +3 -1
  180. package/lib/theme-customization.ts +52 -0
  181. package/lib/vim-editor-adapter.ts +383 -0
  182. package/lib/vim-normal-engine.ts +154 -0
  183. package/lib/vim-operator-engine.ts +416 -0
  184. package/lib/vim-policy.ts +49 -0
  185. package/lib/vim-visual-engine.ts +107 -0
  186. package/lib/visual-customization-policy.ts +119 -0
  187. package/lib/visual-customize-view.ts +481 -0
  188. package/lib/visual-profiles.ts +228 -0
  189. package/lib/writer-surfaces.ts +162 -0
  190. package/lib/yolo-session-policy.ts +317 -0
  191. package/package.json +20 -8
  192. package/runtime/child-package-injection.mjs +63 -0
  193. package/runtime/gentle-ai-binary.mjs +109 -4
  194. package/runtime/gentle-shell-bundled.mjs +518 -0
  195. package/runtime/gentle-shell-launcher.mjs +87 -25
  196. package/runtime/gentle-shell-resume-hint.mjs +177 -0
  197. package/runtime/gentle-shell-startup-flow.mjs +55 -0
  198. package/runtime/gentle-shell-startup-update.mjs +93 -0
  199. package/runtime/gentle-shell-uninstall.mjs +841 -0
  200. package/runtime/gentle-shell-update-panel.mjs +232 -0
  201. package/runtime/native-review-cli.mjs +239 -177
  202. package/runtime/review-integration-v2.mjs +100 -22
  203. package/runtime/review-risk-assessment.mjs +225 -54
  204. package/runtime/status-timing-diagnostics.mjs +202 -0
  205. package/runtime/telemetry-trigger.mjs +3 -1
  206. package/scripts/bootstrap.cmd +255 -0
  207. package/scripts/bootstrap.sh +168 -0
  208. package/scripts/build-distribution.mjs +157 -0
  209. package/scripts/build-installer-bundles.mjs +136 -0
  210. package/scripts/build-runtime-modules.mjs +8 -0
  211. package/scripts/bundled-install.mjs +1308 -0
  212. package/scripts/bundled-wizard.mjs +399 -0
  213. package/scripts/check-types.mjs +4 -6
  214. package/scripts/gentle-ai-installer.mjs +83 -35
  215. package/scripts/install-gentle-ai.mjs +48 -1
  216. package/scripts/install-tui-mode-setting.mjs +10 -1
  217. package/scripts/install-wizard-preview.mjs +154 -0
  218. package/scripts/installer-downloads.mjs +648 -0
  219. package/scripts/installer-preflight.mjs +387 -0
  220. package/scripts/installer-probes.mjs +564 -0
  221. package/scripts/installer-runner.mjs +1102 -0
  222. package/scripts/installer-server.mjs +881 -0
  223. package/scripts/installer-windows-artifacts.json +15 -0
  224. package/scripts/installer-windows.mjs +752 -0
  225. package/scripts/main-channel.mjs +452 -0
  226. package/scripts/mirror-odd-routing.mjs +2 -2
  227. package/scripts/npm-pack-result.mjs +31 -0
  228. package/scripts/render-cache-performance-worker.mjs +205 -0
  229. package/scripts/render-cache-performance.mjs +115 -0
  230. package/scripts/run-test-suite.mjs +90 -0
  231. package/scripts/test-installer-acceptance.sh +161 -0
  232. package/scripts/test-packed-runner.mjs +54 -19
  233. package/scripts/types-baseline.json +2 -92
  234. package/scripts/verify-package-files.mjs +91 -38
  235. package/skills/branch-pr/SKILL.md +24 -52
  236. package/skills/chained-pr/SKILL.md +31 -15
  237. package/skills/chained-pr/references/chaining-details.md +31 -20
  238. package/skills/gentle-ai/SKILL.md +16 -21
  239. package/skills/issue-creation/SKILL.md +8 -2
  240. package/skills/issue-creation/references/delegated-workflow-actions.md +19 -0
  241. package/skills/work-unit-commits/SKILL.md +4 -3
  242. package/tests/agent-home.test.ts +56 -3
  243. package/tests/agent-model-resolution.test.ts +113 -0
  244. package/tests/agent-profiles.test.ts +30 -0
  245. package/tests/agent-risk-escalation.test.ts +123 -0
  246. package/tests/agents-completion-delivery.test.ts +17 -0
  247. package/tests/agents-fake-child.ts +2 -2
  248. package/tests/agents-message-delivery.test.ts +106 -0
  249. package/tests/agents-protocol.test.ts +97 -0
  250. package/tests/agents-queries.test.ts +9 -9
  251. package/tests/agents-runner-process.test.ts +31 -0
  252. package/tests/agents-runner.test.ts +467 -93
  253. package/tests/agents-view-thread-identity.test.ts +169 -0
  254. package/tests/agents-view.test.ts +8 -2
  255. package/tests/agents-widget.test.ts +154 -15
  256. package/tests/append-system-prompt-route.test.ts +160 -0
  257. package/tests/append-system-prompt.test.ts +46 -0
  258. package/tests/artifact-language.test.ts +19 -213
  259. package/tests/ask-user-question.test.ts +44 -1
  260. package/tests/asset-installation-runtime.test.ts +5 -16
  261. package/tests/auto-mode-invariants.test.ts +258 -0
  262. package/tests/auto-mode-sdk.test.ts +57 -0
  263. package/tests/auto-mode.test.ts +49 -0
  264. package/tests/auto-permission-classifier.test.ts +283 -0
  265. package/tests/auto-permission-runtime.test.ts +196 -0
  266. package/tests/autonomous-guard.test.ts +69 -1
  267. package/tests/background-cache-warming.test.ts +2 -1
  268. package/tests/background-jobs.test.ts +227 -0
  269. package/tests/background-monitor.test.ts +195 -0
  270. package/tests/background-subagents-default-mode.test.ts +28 -5
  271. package/tests/bounded-stop-contract.test.ts +85 -0
  272. package/tests/bounded-writer-admission.test.ts +146 -0
  273. package/tests/branch-pr-skill.test.ts +43 -0
  274. package/tests/bridge-wake-lifecycle.test.ts +129 -0
  275. package/tests/bridge-wake-rendering.test.ts +56 -0
  276. package/tests/build-distribution.test.ts +269 -0
  277. package/tests/builtin-codemode-optout.test.ts +242 -0
  278. package/tests/bundled-install.test.ts +1319 -0
  279. package/tests/bundled-wizard.test.ts +505 -0
  280. package/tests/card-content-policy.test.ts +68 -0
  281. package/tests/card-style-policy.test.ts +87 -0
  282. package/tests/chained-pr-skill.test.ts +124 -0
  283. package/tests/child-codegraph-bootstrap.test.ts +74 -0
  284. package/tests/child-context-files.test.ts +255 -0
  285. package/tests/child-package-entrypoints.test.ts +65 -0
  286. package/tests/child-package-injection.test.ts +74 -0
  287. package/tests/child-safety.test.ts +94 -0
  288. package/tests/child-web-package.test.ts +224 -0
  289. package/tests/codegraph-tools.test.ts +35 -0
  290. package/tests/codemode-rendering.test.ts +596 -0
  291. package/tests/command-palette.test.ts +43 -7
  292. package/tests/context-threshold.test.ts +31 -0
  293. package/tests/delegate-for-reason-contract.test.ts +327 -0
  294. package/tests/delegated-key-learnings-contract.test.ts +3 -78
  295. package/tests/destructive-command-guard.test.ts +84 -0
  296. package/tests/devbinary/native-review-parity.devtest.ts +171 -3
  297. package/tests/devbinary/non-git-subagent-bootstrap.devtest.ts +193 -0
  298. package/tests/devbinary/pi-host-relay.devtest.ts +173 -3
  299. package/tests/engram-safety.test.ts +288 -0
  300. package/tests/fixtures/stats/sessions/--work-alpha--/2026-09-28T10-00-00-000Z_aaa.jsonl +7 -0
  301. package/tests/fixtures/stats/sessions/--work-alpha--/2026-09-29T23-00-00-000Z_bbb.jsonl +3 -0
  302. package/tests/fixtures/stats/sessions/--work-alpha--/2026-09-30T08-00-00-000Z_ddd.jsonl +2 -0
  303. package/tests/fixtures/stats/sessions/--work-alpha--/2026-09-30T09-00-00-000Z_eee.jsonl +3 -0
  304. package/tests/fixtures/stats/sessions/--work-alpha--/run-1/session.jsonl +2 -0
  305. package/tests/fixtures/stats/sessions/--work-beta--/2026-09-01T12-00-00-000Z_ccc.jsonl +2 -0
  306. package/tests/fixtures/stats/user-pi/sessions/--work-alpha--/2026-09-28T10-00-00-000Z_aaa.jsonl +2 -0
  307. package/tests/fixtures/stats/user-pi/sessions/--work-alpha--/2026-09-29T23-00-00-000Z_bbb.jsonl +4 -0
  308. package/tests/fixtures/stats/user-pi/sessions/--work-gamma--/2026-09-20T09-00-00-000Z_fff.jsonl +3 -0
  309. package/tests/generic-agent-tools.test.ts +69 -0
  310. package/tests/gentle-agents.test.ts +2804 -346
  311. package/tests/gentle-ai-binary-isolation.test.ts +135 -0
  312. package/tests/gentle-ai-binary.test.ts +21 -4
  313. package/tests/gentle-ai-child-guards.test.ts +202 -0
  314. package/tests/gentle-ai-dev-binary-surfacing.test.ts +125 -15
  315. package/tests/gentle-ai-elapsed-store.test.ts +68 -0
  316. package/tests/gentle-ai-installer.test.ts +566 -62
  317. package/tests/gentle-ai-prompt-model-routing.test.ts +123 -0
  318. package/tests/gentle-ai-renderer.test.ts +493 -14
  319. package/tests/gentle-ai.test.ts +1427 -236
  320. package/tests/gentle-card-text.ts +2 -1
  321. package/tests/gentle-herdr-activity.test.ts +100 -0
  322. package/tests/gentle-notifications.test.ts +427 -0
  323. package/tests/gentle-shell-bin.test.ts +896 -115
  324. package/tests/gentle-shell-bundled.test.ts +1002 -0
  325. package/tests/gentle-shell-launcher.test.ts +333 -65
  326. package/tests/gentle-shell-resume-hint.test.ts +270 -0
  327. package/tests/gentle-shell-startup-flow.test.ts +75 -0
  328. package/tests/gentle-shell-startup-update.test.ts +85 -0
  329. package/tests/gentle-shell-uninstall.test.ts +978 -0
  330. package/tests/gentle-shell-update-panel.test.ts +158 -0
  331. package/tests/gentle-shell.test.ts +4216 -119
  332. package/tests/gentle-stats.test.ts +152 -0
  333. package/tests/gentle-theme.test.ts +4 -1
  334. package/tests/gentle-todo.test.ts +333 -10
  335. package/tests/herdr-activity.test.ts +243 -0
  336. package/tests/history-agent-home.test.ts +81 -0
  337. package/tests/history-atomic-write.test.ts +57 -0
  338. package/tests/history-capture-policy.test.ts +102 -0
  339. package/tests/history-child-guard.test.ts +70 -0
  340. package/tests/history-command-registration.test.ts +164 -0
  341. package/tests/history-dedupe-entries.test.ts +123 -0
  342. package/tests/history-delete-backfill.test.ts +190 -0
  343. package/tests/history-delete-confirm.test.ts +460 -0
  344. package/tests/history-dispatch.test.ts +180 -0
  345. package/tests/history-drain-hidden.test.ts +110 -0
  346. package/tests/history-drain-order.test.ts +98 -0
  347. package/tests/history-expanded-globals.test.ts +62 -0
  348. package/tests/history-gc.test.ts +832 -0
  349. package/tests/history-header-layout.test.ts +265 -0
  350. package/tests/history-hide-prompts.test.ts +275 -0
  351. package/tests/history-lazy-windowing.test.ts +508 -0
  352. package/tests/history-legacy-migrate-v2.test.ts +297 -0
  353. package/tests/history-load-shared-history.test.ts +53 -0
  354. package/tests/history-max-results-cap.test.ts +76 -0
  355. package/tests/history-multi-reader.test.ts +203 -0
  356. package/tests/history-off-path.test.ts +170 -0
  357. package/tests/history-openflow-integration.test.ts +173 -0
  358. package/tests/history-overlay-margin.test.ts +326 -0
  359. package/tests/history-preview-layout.test.ts +93 -0
  360. package/tests/history-registry.test.ts +143 -0
  361. package/tests/history-scope-delete.test.ts +411 -0
  362. package/tests/history-search-caret-keys.test.ts +142 -0
  363. package/tests/history-seed-bootstrap.test.ts +170 -0
  364. package/tests/history-seed-regen.test.ts +129 -0
  365. package/tests/history-selector-windowing.test.ts +94 -0
  366. package/tests/history-session-scan-directory.test.ts +87 -0
  367. package/tests/history-session-scan-extract.test.ts +583 -0
  368. package/tests/history-session-writer.test.ts +351 -0
  369. package/tests/history-store-paths.test.ts +79 -0
  370. package/tests/history-tombstone-exact.test.ts +139 -0
  371. package/tests/history-wheel-mouse.test.ts +242 -0
  372. package/tests/inprocess-reviewer.test.ts +49 -19
  373. package/tests/install-gentle-ai-failure.test.ts +69 -0
  374. package/tests/install-tui-mode-setting.test.ts +15 -0
  375. package/tests/install-wizard.test.ts +1223 -0
  376. package/tests/installer-bundles.test.ts +122 -0
  377. package/tests/installer-posix-bootstrap.test.ts +1201 -0
  378. package/tests/installer-preflight.test.ts +750 -0
  379. package/tests/installer-probes.test.ts +1106 -0
  380. package/tests/installer-runner.test.ts +2158 -0
  381. package/tests/installer-server.test.ts +1567 -0
  382. package/tests/installer-windows-bootstrap.test.ts +2410 -0
  383. package/tests/issue-creation-skill.test.ts +61 -0
  384. package/tests/jobs-view.test.ts +160 -0
  385. package/tests/main-channel-upgrade.test.ts +389 -0
  386. package/tests/main-channel.test.ts +344 -0
  387. package/tests/maintainer/provider-relay.maintest.ts +13 -12
  388. package/tests/model-price-ratio.test.ts +116 -0
  389. package/tests/model-profiles-preservation.test.ts +153 -0
  390. package/tests/model-routing-authority.test.ts +16 -0
  391. package/tests/model-routing-package.test.ts +10 -0
  392. package/tests/nan-provider-runtime.test.ts +156 -0
  393. package/tests/nan-provider.test.ts +481 -0
  394. package/tests/native-binary-gate.test.ts +2 -0
  395. package/tests/native-review-capability-contract.test.ts +13 -1
  396. package/tests/native-review-cli.test.ts +239 -118
  397. package/tests/native-review-consent.test.ts +2 -2
  398. package/tests/native-review-parity-runtime.test.ts +101 -4
  399. package/tests/native-review-parity.test.ts +12 -48
  400. package/tests/native-risk-evidence-parity.test.ts +21 -0
  401. package/tests/no-self-pause-contract.test.ts +87 -0
  402. package/tests/notification-audio-native.test.ts +281 -0
  403. package/tests/notification-audio-windows.test.ts +581 -0
  404. package/tests/notification-audio.test.ts +548 -0
  405. package/tests/notification-customize.test.ts +655 -0
  406. package/tests/notification-events.test.ts +115 -0
  407. package/tests/notification-policy.test.ts +201 -0
  408. package/tests/notification-pulse-client.test.ts +356 -0
  409. package/tests/notification-pulse-protocol.test.ts +213 -0
  410. package/tests/notification-pulse-stream.test.ts +320 -0
  411. package/tests/notification-scheduler.test.ts +258 -0
  412. package/tests/notification-ui.test.ts +157 -0
  413. package/tests/npm-pack-result.test.ts +41 -0
  414. package/tests/odd-integration.test.ts +76 -0
  415. package/tests/odd-phase-inference.test.ts +213 -0
  416. package/tests/odd-phase-loader.test.ts +253 -0
  417. package/tests/odd-phase.test.ts +307 -0
  418. package/tests/odd-routing-canonical-ratchet.test.ts +60 -14
  419. package/tests/odd-routing-contract.test.ts +158 -50
  420. package/tests/orchestrator-budget.test.ts +43 -45
  421. package/tests/orchestrator-catalog.test.ts +146 -0
  422. package/tests/orchestrator-consultation-sdk.test.ts +614 -0
  423. package/tests/orchestrator-consultation.test.ts +111 -0
  424. package/tests/orchestrator-discovery.test.ts +241 -0
  425. package/tests/orchestrator-helper-consent.test.ts +171 -0
  426. package/tests/orchestrator-helper.test.ts +297 -0
  427. package/tests/orchestrator-message-card.test.ts +190 -0
  428. package/tests/orchestrator-presence.test.ts +23 -0
  429. package/tests/orchestrator-rdd-ownership.test.ts +8 -7
  430. package/tests/orchestrator-scope.test.ts +107 -0
  431. package/tests/orchestrator-state.test.ts +114 -0
  432. package/tests/orchestrator-status-publication-contract.test.ts +34 -0
  433. package/tests/orchestrator-tool-card.test.ts +398 -0
  434. package/tests/orchestrator-work-search.test.ts +318 -0
  435. package/tests/orchestrator-work.test.ts +147 -0
  436. package/tests/overlay-repaint.test.ts +74 -0
  437. package/tests/package-manifest.test.ts +344 -123
  438. package/tests/packed-runner-owned-path.test.ts +80 -0
  439. package/tests/parallel-reason-contract.test.ts +21 -0
  440. package/tests/parallel-writer-admission.test.ts +210 -0
  441. package/tests/permission-mode-policy.test.ts +194 -0
  442. package/tests/persona-single-channel.test.ts +10 -18
  443. package/tests/pi-pretty.test.ts +56 -0
  444. package/tests/provider-defect-handoff.test.ts +7 -14
  445. package/tests/quiet-bash-runtime.test.ts +76 -0
  446. package/tests/quiet-tool-rendering.test.ts +569 -187
  447. package/tests/rdd-aware-verification-contract.test.ts +103 -40
  448. package/tests/rdd-status-line.test.ts +9 -4
  449. package/tests/render-cache-performance.test.ts +48 -0
  450. package/tests/resume-hint-extension.test.ts +122 -0
  451. package/tests/review-agent-end-preflight.test.ts +237 -21
  452. package/tests/review-candidate-owner-retry.test.ts +22 -1
  453. package/tests/review-candidate-view.test.ts +399 -12
  454. package/tests/review-contract-prompt.test.ts +138 -44
  455. package/tests/review-controller-lock-status.test.ts +0 -1
  456. package/tests/review-controller-native-recovery.test.ts +327 -17
  457. package/tests/review-controller-native-routing.test.ts +866 -6
  458. package/tests/review-controller-workspace-root.test.ts +206 -6
  459. package/tests/review-controller.test.ts +2 -2
  460. package/tests/review-correction-lifecycle.test.ts +2 -1
  461. package/tests/review-gate.test.ts +7 -4
  462. package/tests/review-graph-schema.test.ts +2 -2
  463. package/tests/review-host-relay-routing.test.ts +342 -4
  464. package/tests/review-host-relay.test.ts +49 -2
  465. package/tests/review-integration-v2-forward.test.ts +221 -1
  466. package/tests/review-json-arguments.test.ts +167 -0
  467. package/tests/review-last-event-closure.test.ts +157 -8
  468. package/tests/review-ledger-contract.test.ts +14 -37
  469. package/tests/review-policy-judgment-day.test.ts +1 -1
  470. package/tests/review-policy-ordinary.test.ts +2 -2
  471. package/tests/review-relay-transport-agent.test.ts +66 -1
  472. package/tests/review-reminder-receipt.test.ts +47 -1
  473. package/tests/review-risk-assessment.test.ts +594 -26
  474. package/tests/review-session-standing-permission-controller.test.ts +16 -17
  475. package/tests/review-session-standing-permission-ipc.test.ts +6 -5
  476. package/tests/review-sidebar-state.test.ts +402 -0
  477. package/tests/review-test-fixtures.ts +7 -1
  478. package/tests/review-transaction.test.ts +18 -1
  479. package/tests/run-test-suite.test.ts +202 -0
  480. package/tests/runtime-harness.mjs +186 -800
  481. package/tests/runtime-metrics-children.test.ts +16 -23
  482. package/tests/runtime-metrics-extension.test.ts +1 -1
  483. package/tests/runtime-metrics-native.test.ts +31 -1
  484. package/tests/selection-engine.test.ts +451 -0
  485. package/tests/session-change-capture.test.ts +10 -10
  486. package/tests/session-changes-shell.test.ts +242 -48
  487. package/tests/session-changes.test.ts +17 -24
  488. package/tests/session-messaging-grants.test.ts +255 -0
  489. package/tests/session-profile-binding.test.ts +163 -0
  490. package/tests/session-profile-freeze.test.ts +381 -0
  491. package/tests/session-subject-routing-contract.test.ts +34 -0
  492. package/tests/session-worktree-registry.test.ts +134 -2
  493. package/tests/shell-bar.test.ts +422 -1
  494. package/tests/shell-card.test.ts +353 -1
  495. package/tests/shell-changes-view.test.ts +135 -32
  496. package/tests/shell-changes.test.ts +61 -62
  497. package/tests/shell-prompt.test.ts +94 -2
  498. package/tests/shell-render-cache-runtime.test.ts +69 -0
  499. package/tests/shell-render-cache.test.ts +129 -0
  500. package/tests/shell-sidebar-layout.test.ts +351 -22
  501. package/tests/shell-sidebar-scroll-benchmark.test.ts +255 -0
  502. package/tests/shell-todo.test.ts +207 -3
  503. package/tests/shell-usage-view.test.ts +28 -1
  504. package/tests/shell-usage.test.ts +108 -0
  505. package/tests/short-check-routing-contract.test.ts +49 -0
  506. package/tests/skill-registry-watcher.test.ts +119 -0
  507. package/tests/skill-registry.test.ts +357 -2
  508. package/tests/startup-banner.test.ts +246 -4
  509. package/tests/startup-home-repo.test.ts +170 -0
  510. package/tests/stats-collector.test.ts +195 -0
  511. package/tests/stats-view.test.ts +202 -0
  512. package/tests/status-timing-diagnostics.test.ts +283 -0
  513. package/tests/support/orchestrator-modules.ts +19 -0
  514. package/tests/task-size-routing-contract.test.ts +241 -0
  515. package/tests/telemetry-trigger.test.ts +107 -20
  516. package/tests/test-strength-contract.test.ts +124 -0
  517. package/tests/theme-customization.test.ts +72 -0
  518. package/tests/verify-agent-contract.test.ts +90 -0
  519. package/tests/verify-first-launch-contract.test.ts +139 -0
  520. package/tests/verify-package-files.test.ts +56 -0
  521. package/tests/vim-editor-adapter-host-resolution.test.ts +37 -0
  522. package/tests/vim-editor-adapter.test.ts +804 -0
  523. package/tests/vim-normal-engine.test.ts +101 -0
  524. package/tests/vim-operator-engine.test.ts +215 -0
  525. package/tests/vim-policy.test.ts +19 -0
  526. package/tests/vim-visual-engine.test.ts +52 -0
  527. package/tests/visual-customization-policy.test.ts +139 -0
  528. package/tests/visual-customize-view.test.ts +696 -0
  529. package/tests/visual-profiles.test.ts +87 -0
  530. package/tests/writer-edit-surface-scope.test.ts +59 -2
  531. package/tests/writer-surfaces.test.ts +199 -0
  532. package/tests/yolo-customize.test.ts +271 -0
  533. package/tests/yolo-mode-runtime.test.ts +188 -0
  534. package/tests/yolo-mode.test.ts +289 -0
  535. package/tests/yolo-session-policy.test.ts +59 -0
  536. package/themes/Gentle.json +2 -1
  537. package/themes/Gentleman-Cute.json +2 -1
  538. package/themes/Gentleman-Sexy.json +2 -1
  539. package/assets/agents/sdd-apply.md +0 -159
  540. package/assets/agents/sdd-archive.md +0 -228
  541. package/assets/agents/sdd-design.md +0 -49
  542. package/assets/agents/sdd-explore.md +0 -48
  543. package/assets/agents/sdd-init.md +0 -56
  544. package/assets/agents/sdd-onboard.md +0 -52
  545. package/assets/agents/sdd-proposal.md +0 -64
  546. package/assets/agents/sdd-remediate.md +0 -37
  547. package/assets/agents/sdd-research.md +0 -49
  548. package/assets/agents/sdd-spec.md +0 -192
  549. package/assets/agents/sdd-status.md +0 -54
  550. package/assets/agents/sdd-tasks.md +0 -108
  551. package/assets/agents/sdd-verify.md +0 -124
  552. package/assets/chains/sdd-full.chain.md +0 -83
  553. package/assets/chains/sdd-plan.chain.md +0 -56
  554. package/assets/chains/sdd-verify.chain.md +0 -43
  555. package/assets/sdd-orchestrator-workflow.md +0 -319
  556. package/assets/support/sdd-status-contract.md +0 -77
  557. package/docs/assets/diagrams/sdd-cycle.svg +0 -14
  558. package/extensions/sdd-init.ts +0 -816
  559. package/lib/openspec-deltas.ts +0 -156
  560. package/lib/sdd-preflight.ts +0 -1066
  561. package/lib/sdd-research-capabilities.ts +0 -94
  562. package/lib/sdd-status.ts +0 -26
  563. package/tests/fixtures/legacy/sdd-research-v2.5.0.md +0 -54
  564. package/tests/fixtures/native-review-cli/v2.1.3/bind-sdd.json +0 -25
  565. package/tests/fixtures/v0.10.7/assets/agents/sdd-apply.md +0 -132
  566. package/tests/openspec-deltas.test.ts +0 -209
  567. package/tests/sdd-agent-tools.test.ts +0 -156
  568. package/tests/sdd-archive-replay.test.ts +0 -82
  569. package/tests/sdd-classical-continuation.test.ts +0 -74
  570. package/tests/sdd-execution-routing-contract.test.ts +0 -44
  571. package/tests/sdd-managed-runtime-settlement.test.ts +0 -155
  572. package/tests/sdd-native-managed-uptake.test.ts +0 -243
  573. package/tests/sdd-no-attempts-contract.test.ts +0 -15
  574. package/tests/sdd-odd-integration.test.ts +0 -33
  575. package/tests/sdd-optional-research.test.ts +0 -124
  576. package/tests/sdd-planning-routing-contract.test.ts +0 -45
  577. package/tests/sdd-preflight-rpc-input.test.ts +0 -125
  578. package/tests/sdd-preflight.test.ts +0 -541
  579. package/tests/sdd-research-capabilities.test.ts +0 -114
  580. package/tests/sdd-research-live.test.ts +0 -241
  581. package/tests/sdd-selection-transport.test.ts +0 -653
  582. package/tests/sdd-status.test.ts +0 -9
  583. package/tests/sdd-task-truth.test.ts +0 -43
  584. /package/contracts/review-provider-contract-mirror/{v1.2.0 → v1.3.0}/bundle/README.md +0 -0
  585. /package/contracts/review-provider-contract-mirror/{v1.2.0 → v1.3.0}/bundle/schemas/lens.schema.json +0 -0
  586. /package/contracts/review-provider-contract-mirror/{v1.2.0 → v1.3.0}/bundle/schemas/refuter.schema.json +0 -0
  587. /package/contracts/review-provider-contract-mirror/{v1.2.0 → v1.3.0}/bundle/schemas/targeted-validator.schema.json +0 -0
  588. /package/contracts/review-provider-contract-mirror/{v1.2.0 → v1.3.0}/bundle/vectors/lens.json +0 -0
  589. /package/contracts/review-provider-contract-mirror/{v1.2.0 → v1.3.0}/bundle/vectors/refuter.json +0 -0
  590. /package/contracts/review-provider-contract-mirror/{v1.2.0 → v1.3.0}/bundle/vectors/targeted-validator.json +0 -0
@@ -0,0 +1,166 @@
1
+ // gentle-shell#1587: delegated children (GENTLE_PI_AGENTS_CHILD=1) load the
2
+ // same context files as the orchestrator, including gentle-ai managed blocks
3
+ // that bind themselves to the orchestrator only. Those blocks cost ~37k prefix
4
+ // tokens per child and give a worker orchestration rules it must not follow.
5
+ // This module removes exactly those blocks and keeps everything else.
6
+
7
+ export const ORCHESTRATOR_ONLY_MANAGED_BLOCKS = [
8
+ "orchestrator",
9
+ "sdd-orchestrator",
10
+ "sdd-model-assignments",
11
+ "agent-routing",
12
+ ] as const;
13
+
14
+ export type OrchestratorOnlyManagedBlock = (typeof ORCHESTRATOR_ONLY_MANAGED_BLOCKS)[number];
15
+
16
+ export interface ContextFile {
17
+ path: string;
18
+ content: string;
19
+ }
20
+
21
+ export interface ManagedBlockFilterResult {
22
+ content: string;
23
+ removedBlocks: number;
24
+ // True when markers were unbalanced, mismatched, or ambiguous and the
25
+ // content was returned unchanged.
26
+ failSafe: boolean;
27
+ }
28
+
29
+ export interface ChildContextFilesResult<T extends ContextFile> {
30
+ files: T[];
31
+ removedBlocks: number;
32
+ removedBytes: number;
33
+ failSafePaths: string[];
34
+ }
35
+
36
+ export interface ContextFileOptions {
37
+ contextFiles?: ContextFile[];
38
+ }
39
+
40
+ const REMOVED_NAMES: ReadonlySet<string> = new Set(ORCHESTRATOR_ONLY_MANAGED_BLOCKS);
41
+
42
+ // A managed marker counts only when it is alone on its line. Inline mentions
43
+ // (prose, inline code) and markers inside fenced code are plain text.
44
+ const MARKER_LINE = /^[ \t]*<!--[ \t]*(\/?)gentle-ai:([A-Za-z0-9][A-Za-z0-9._-]*)[ \t]*-->[ \t]*$/;
45
+ const FENCE_LINE = /^ {0,3}(`{3,}|~{3,})(.*)$/;
46
+ const BLANK_LINE = /^[ \t]*\r?\n?$/;
47
+
48
+ interface Line {
49
+ text: string;
50
+ // Name of the innermost managed block owning this line (marker lines are
51
+ // owned by the block they delimit), or null for unmanaged text.
52
+ owner: string | null;
53
+ }
54
+
55
+ function splitLines(content: string): string[] {
56
+ return content.match(/[^\n]*\n|[^\n]+$/g) ?? [];
57
+ }
58
+
59
+ function unchanged(content: string): ManagedBlockFilterResult {
60
+ return { content, removedBlocks: 0, failSafe: true };
61
+ }
62
+
63
+ export function filterOrchestratorOnlyBlocks(content: string): ManagedBlockFilterResult {
64
+ const lines: Line[] = [];
65
+ const stack: string[] = [];
66
+ let fence: { char: string; length: number } | null = null;
67
+ let removedBlocks = 0;
68
+ let sawMarker = false;
69
+
70
+ for (const text of splitLines(content)) {
71
+ const bare = text.replace(/\r?\n$/, "");
72
+ const owner = stack.length > 0 ? stack[stack.length - 1] : null;
73
+ const fenceMatch = FENCE_LINE.exec(bare);
74
+ if (fence !== null) {
75
+ if (fenceMatch !== null && fenceMatch[1][0] === fence.char && fenceMatch[1].length >= fence.length && fenceMatch[2].trim() === "") {
76
+ fence = null;
77
+ }
78
+ lines.push({ text, owner });
79
+ continue;
80
+ }
81
+ if (fenceMatch !== null && !(fenceMatch[1][0] === "`" && fenceMatch[2].includes("`"))) {
82
+ fence = { char: fenceMatch[1][0], length: fenceMatch[1].length };
83
+ lines.push({ text, owner });
84
+ continue;
85
+ }
86
+ const marker = MARKER_LINE.exec(bare);
87
+ if (marker === null) {
88
+ lines.push({ text, owner });
89
+ continue;
90
+ }
91
+ sawMarker = true;
92
+ const [, closing, name] = marker;
93
+ if (closing === "") {
94
+ // A block reopened inside itself is ambiguous: fail safe.
95
+ if (stack.includes(name)) return unchanged(content);
96
+ stack.push(name);
97
+ if (REMOVED_NAMES.has(name)) removedBlocks += 1;
98
+ lines.push({ text, owner: name });
99
+ continue;
100
+ }
101
+ if (stack.length === 0 || stack[stack.length - 1] !== name) return unchanged(content);
102
+ stack.pop();
103
+ lines.push({ text, owner: name });
104
+ }
105
+ if (stack.length > 0) return unchanged(content);
106
+ if (!sawMarker || removedBlocks === 0) return { content, removedBlocks: 0, failSafe: false };
107
+
108
+ // Drop lines owned by a removed block. Blank lines that directly follow a
109
+ // removal collapse so at most one empty line remains at that seam; a
110
+ // removal at the start or end of the file leaves no blank edge behind.
111
+ const output: string[] = [];
112
+ let trailingBlanks = 0;
113
+ let afterRemoval = false;
114
+ for (const line of lines) {
115
+ if (line.owner !== null && REMOVED_NAMES.has(line.owner)) {
116
+ afterRemoval = true;
117
+ continue;
118
+ }
119
+ const blank = BLANK_LINE.test(line.text);
120
+ if (afterRemoval && blank && (output.length === 0 || trailingBlanks >= 1)) continue;
121
+ if (!blank) afterRemoval = false;
122
+ output.push(line.text);
123
+ trailingBlanks = blank ? trailingBlanks + 1 : 0;
124
+ }
125
+ if (afterRemoval) {
126
+ while (output.length > 0 && BLANK_LINE.test(output[output.length - 1])) output.pop();
127
+ }
128
+ return { content: output.join(""), removedBlocks, failSafe: false };
129
+ }
130
+
131
+ export function stripOrchestratorOnlyBlocks(content: string): string {
132
+ return filterOrchestratorOnlyBlocks(content).content;
133
+ }
134
+
135
+ const encoder = new TextEncoder();
136
+
137
+ // Returns filtered copies; the input array and its entries are never mutated.
138
+ export function filterChildContextFiles<T extends ContextFile>(files: readonly T[]): ChildContextFilesResult<T> {
139
+ const result: ChildContextFilesResult<T> = { files: [], removedBlocks: 0, removedBytes: 0, failSafePaths: [] };
140
+ for (const file of files) {
141
+ const filtered = filterOrchestratorOnlyBlocks(file.content);
142
+ if (filtered.failSafe) result.failSafePaths.push(file.path);
143
+ if (filtered.removedBlocks === 0) {
144
+ result.files.push({ ...file });
145
+ continue;
146
+ }
147
+ result.removedBlocks += filtered.removedBlocks;
148
+ result.removedBytes += encoder.encode(file.content).length - encoder.encode(filtered.content).length;
149
+ result.files.push({ ...file, content: filtered.content });
150
+ }
151
+ return result;
152
+ }
153
+
154
+ // Replaces contextFiles on the SAME options object: pi-claude-bridge keeps a
155
+ // reference to it and rebuilds its prompt from its contextFiles. Never
156
+ // throws; on any error the original context files stay in place.
157
+ export function filterChildSessionContextFiles(options: ContextFileOptions | null | undefined): ChildContextFilesResult<ContextFile> | null {
158
+ try {
159
+ if (!options || !Array.isArray(options.contextFiles)) return null;
160
+ const result = filterChildContextFiles(options.contextFiles);
161
+ if (result.removedBlocks > 0) options.contextFiles = result.files;
162
+ return result;
163
+ } catch {
164
+ return null;
165
+ }
166
+ }
@@ -0,0 +1,62 @@
1
+ import { isAbsolute } from "node:path";
2
+
3
+ // #1690: the gentle-shell launcher injects the gentle-pi package into the
4
+ // parent pi with `-e` instead of a settings declaration, so delegated children
5
+ // would otherwise start without it. The launcher records the exact extension
6
+ // set it injected in this variable; the subagent runner forwards that set to
7
+ // every child. Kept free of launcher imports so the runner can load it cheaply.
8
+ export const CHILD_PACKAGE_INJECTION_ENV = "GENTLE_SHELL_CHILD_PACKAGE_INJECTION";
9
+
10
+ const CHILD_PACKAGE_INJECTION_VERSION = 1;
11
+
12
+ export interface ChildPackageInjection {
13
+ // True for a launcher takeover: the parent ran with --no-extensions, so the
14
+ // child must too, or settings discovery would load a second gentle-pi.
15
+ noExtensions: boolean;
16
+ // Absolute extension paths, in the order the launcher passed them to `-e`.
17
+ extensionPaths: string[];
18
+ }
19
+
20
+ export function encodeChildPackageInjection(value: ChildPackageInjection): string {
21
+ return JSON.stringify({
22
+ version: CHILD_PACKAGE_INJECTION_VERSION,
23
+ noExtensions: value.noExtensions,
24
+ extensionPaths: value.extensionPaths,
25
+ });
26
+ }
27
+
28
+ // Returns undefined for an absent or invalid value and never throws: a bad
29
+ // signal must degrade to "no forwarding", not break a child launch. The path
30
+ // flavor is injectable so tests can check Windows paths on any platform.
31
+ export function parseChildPackageInjection(
32
+ env: Record<string, string | undefined>,
33
+ pathFlavor: { isAbsolute(path: string): boolean } = { isAbsolute },
34
+ ): ChildPackageInjection | undefined {
35
+ const raw = env[CHILD_PACKAGE_INJECTION_ENV];
36
+ if (raw === undefined || raw.length === 0) return undefined;
37
+ let parsed: unknown;
38
+ try {
39
+ parsed = JSON.parse(raw);
40
+ } catch {
41
+ return undefined;
42
+ }
43
+ if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) return undefined;
44
+ const record = parsed as Record<string, unknown>;
45
+ if (record.version !== CHILD_PACKAGE_INJECTION_VERSION) return undefined;
46
+ if (typeof record.noExtensions !== "boolean") return undefined;
47
+ const paths = record.extensionPaths;
48
+ if (!Array.isArray(paths) || paths.length === 0) return undefined;
49
+ const extensionPaths: string[] = [];
50
+ for (const path of paths) {
51
+ if (typeof path !== "string" || path.length === 0 || !pathFlavor.isAbsolute(path)) return undefined;
52
+ extensionPaths.push(path);
53
+ }
54
+ return { noExtensions: record.noExtensions, extensionPaths };
55
+ }
56
+
57
+ // Plain argv elements for a child pi: spawned without a shell, so no quoting.
58
+ export function childPackageExtensionArgs(injection: ChildPackageInjection): string[] {
59
+ const args = injection.noExtensions ? ["--no-extensions"] : [];
60
+ for (const path of injection.extensionPaths) args.push("--extension", path);
61
+ return args;
62
+ }
@@ -0,0 +1,195 @@
1
+ import {
2
+ createCodemodeExtension,
3
+ keyHint,
4
+ type AgentToolResult,
5
+ type CodemodeToolDetails,
6
+ type ExtensionAPI,
7
+ type ExtensionFactory,
8
+ type ToolDefinition,
9
+ } from "@earendil-works/pi-coding-agent";
10
+ import { getCapabilities, imageFallback, type Component } from "@earendil-works/pi-tui";
11
+ import {
12
+ CARD_TONE, cardAwaitingResult, cardBodyRows, cardBottom, cardLine, cardRunningLine, cardStyle, cardTop, floatRows, markCardResult,
13
+ type CardRowContext, type CardStyle, type CardTheme, type CardTone,
14
+ } from "./shell-card.ts";
15
+ import { sanitizeTerminalText, stripAnsi } from "./terminal-theme.ts";
16
+
17
+ const CALL_STATUS = {
18
+ RUNNING: "running",
19
+ OK: "ok",
20
+ ERROR: "error",
21
+ CANCELLED: "cancelled",
22
+ } as const satisfies Record<string, CodemodeToolDetails["calls"][number]["status"]>;
23
+ const COLLAPSED_CALL_LIMIT = 8;
24
+
25
+ interface ObservedCall {
26
+ name?: string;
27
+ status?: CodemodeToolDetails["calls"][number]["status"];
28
+ durationMs?: number;
29
+ error?: string;
30
+ }
31
+
32
+ function record(value: unknown): Record<string, unknown> {
33
+ return value !== null && typeof value === "object" && !Array.isArray(value)
34
+ ? value as Record<string, unknown> : {};
35
+ }
36
+
37
+ function safe(value: string): string {
38
+ return sanitizeTerminalText(value)
39
+ .replace(/[\u061c\u200e\u200f\u202a-\u202e\u2066-\u2069]/g, "")
40
+ .replace(/\t/g, " ");
41
+ }
42
+
43
+ function singleLine(value: string): string {
44
+ return safe(value).replace(/[\r\n\t]/g, " ");
45
+ }
46
+
47
+ function observedCalls(details: unknown): ObservedCall[] {
48
+ const calls = record(details).calls;
49
+ if (!Array.isArray(calls)) return [];
50
+ return calls.map((value) => {
51
+ const call = record(value);
52
+ return {
53
+ name: typeof call.name === "string" ? singleLine(call.name) : undefined,
54
+ status: Object.values(CALL_STATUS).includes(call.status as ObservedCall["status"] & string)
55
+ ? call.status as ObservedCall["status"] : undefined,
56
+ durationMs: typeof call.durationMs === "number" && Number.isFinite(call.durationMs) && call.durationMs >= 0
57
+ ? call.durationMs : undefined,
58
+ error: typeof call.error === "string" ? safe(call.error) : undefined,
59
+ };
60
+ });
61
+ }
62
+
63
+ function duration(ms: number | undefined): string {
64
+ if (ms === undefined) return "";
65
+ return ms < 1000 ? `${Math.round(ms)}ms` : `${(ms / 1000).toFixed(1)}s`;
66
+ }
67
+
68
+ function failed(call: ObservedCall): boolean {
69
+ return call.status === CALL_STATUS.ERROR || call.status === CALL_STATUS.CANCELLED || Boolean(call.error);
70
+ }
71
+
72
+ function childLine(call: ObservedCall, theme: CardTheme): string {
73
+ const status = call.status ?? "status unavailable";
74
+ const tone = failed(call) ? CARD_TONE.ERROR : call.status === CALL_STATUS.OK ? CARD_TONE.SUCCESS : CARD_TONE.WARNING;
75
+ const time = duration(call.durationMs);
76
+ // Arguments are deliberately never read; error payloads have their own bounded preview.
77
+ return `${theme.fg(tone, status)} · ${call.name || "name unavailable"}${time ? ` · ${time}` : ""}${call.error && call.status !== CALL_STATUS.ERROR ? " · error reported" : ""}`;
78
+ }
79
+
80
+ class CodemodeCard implements Component {
81
+ private readonly theme: CardTheme;
82
+ private readonly tone: CardTone;
83
+ private readonly body: (width: number) => string[];
84
+ private readonly top: boolean;
85
+ private readonly hint?: string;
86
+ // Whether the call card above this result already drew body rows (the script).
87
+ private readonly afterBody: boolean;
88
+ // The call card's render context: until a result exists, the call closes the frame.
89
+ private readonly row?: CardRowContext;
90
+ // Content and expansion belong to this component; only layout and row state can change.
91
+ private cachedFrame?: { width: number; style: CardStyle; running: boolean; lines: string[] };
92
+
93
+ constructor(theme: CardTheme, tone: CardTone, body: (width: number) => string[], top: boolean, hint?: string, afterBody = false, row?: CardRowContext) {
94
+ this.theme = theme;
95
+ this.tone = tone;
96
+ this.body = body;
97
+ this.top = top;
98
+ this.hint = hint;
99
+ this.afterBody = afterBody;
100
+ this.row = row;
101
+ }
102
+
103
+ render(width: number): string[] {
104
+ const target = Math.max(0, Math.floor(width));
105
+ if (target === 0) return [];
106
+ const running = this.top && this.row !== undefined && cardAwaitingResult(this.row);
107
+ const style = cardStyle();
108
+ if (this.cachedFrame?.width === target && this.cachedFrame.style === style && this.cachedFrame.running === running) {
109
+ return this.cachedFrame.lines;
110
+ }
111
+ const lines = floatRows(this.tone, this.theme, target, (inner) => ({
112
+ head: this.top ? [cardTop({ title: "Code", glyph: "λ", body: [], tone: this.tone }, this.theme, inner, this.hint)] : [],
113
+ body: running ? [...this.body(inner), cardRunningLine(this.tone, this.theme, inner)] : this.body(inner),
114
+ bottom: this.top && !running ? undefined : cardBottom(this.tone, this.theme, inner),
115
+ afterHeading: !this.top && !this.afterBody,
116
+ }));
117
+ this.cachedFrame = { width: target, style, running, lines };
118
+ return lines;
119
+ }
120
+
121
+ invalidate(): void {
122
+ this.cachedFrame = undefined;
123
+ }
124
+ }
125
+
126
+ /** Replace presentation only: execute, schema and every loadout/exposure field retain their references. */
127
+ export function decorateCodemodeTool(tool: ToolDefinition): ToolDefinition {
128
+ return {
129
+ ...tool,
130
+ renderShell: "self",
131
+ renderCall(args, theme, context) {
132
+ const tone = context.isError ? CARD_TONE.ERROR : context.isPartial ? CARD_TONE.WARNING : CARD_TONE.INFO;
133
+ const code = record(args).code;
134
+ const rows = context.expanded && typeof code === "string" ? [safe(code)] : [];
135
+ const hint = stripAnsi(keyHint("app.tools.expand", context.expanded ? "to collapse" : "to expand"));
136
+ return new CodemodeCard(theme, tone, (width) => cardBodyRows(rows, tone, theme, width, { expanded: true }), true, hint, false, context);
137
+ },
138
+ renderResult(result, options, theme, context) {
139
+ markCardResult(context?.state);
140
+ const calls = observedCalls(result.details);
141
+ const isError = context.isError || record(result).isError === true;
142
+ const failures = calls.filter(failed).length;
143
+ const tone = isError || failures > 0 ? CARD_TONE.ERROR : options.isPartial ? CARD_TONE.WARNING : CARD_TONE.INFO;
144
+ const shown = options.expanded ? calls : calls.slice(0, COLLAPSED_CALL_LIMIT);
145
+ const output = textOutput(result, context.showImages).flatMap((text) => {
146
+ const rows = text.split("\n");
147
+ // Pi prefixes final script output with status/wall-time bookkeeping.
148
+ // Keep it in expansion, but spend the collapsed budget on the payload.
149
+ const marker = rows.indexOf("Output:");
150
+ return !options.expanded && /^Script (?:completed|failed)/.test(rows[0] ?? "") && marker >= 0
151
+ ? rows.slice(marker + 1) : rows;
152
+ });
153
+ const path = record(result.details).fullOutputPath;
154
+ // Mirrors renderCall: an expanded call shows the script as its body.
155
+ const callHasBody = options.expanded && typeof record(context?.args).code === "string";
156
+ return new CodemodeCard(theme, tone, (width) => {
157
+ const rows = shown.flatMap((call) => [
158
+ childLine(call, theme),
159
+ ...(options.expanded && call.error ? [theme.fg("error", call.error)] : []),
160
+ ]);
161
+ if (shown.length < calls.length) rows.push(theme.fg("muted", `${failures} errors/cancellations reported · ${calls.length - shown.length} more calls · expand to inspect`));
162
+ if (isError) rows.push(theme.fg("error", "Script failed"));
163
+ if (calls.length === 0) rows.push(theme.fg("muted", "No observed child calls"));
164
+ // Each child gets one collapsed physical row, preserving the observed order.
165
+ const body = options.expanded
166
+ ? cardBodyRows(rows, tone, theme, width, { expanded: true })
167
+ : rows.map((row) => cardLine(row, tone, theme, width));
168
+ if (!options.expanded) {
169
+ const errors = calls.filter((call) => call.error).map((call) => `${call.name || "name unavailable"}: ${call.error}`);
170
+ body.push(...cardBodyRows(errors.map((error) => theme.fg("error", error)), tone, theme, width, { expanded: false, previewRows: 2 }));
171
+ }
172
+ body.push(...cardBodyRows(output.filter((row) => options.expanded || row.trim().length > 0).map((row) => theme.fg(isError ? "error" : "toolOutput", row)), tone, theme, width, { expanded: options.expanded, previewRows: 3 }));
173
+ if (typeof path === "string") body.push(...cardBodyRows([theme.fg("muted", `Full output: ${safe(path)}`)], tone, theme, width, { expanded: options.expanded, previewRows: 1 }));
174
+ return body;
175
+ }, false, undefined, callHasBody);
176
+ },
177
+ };
178
+ }
179
+
180
+ function textOutput(result: AgentToolResult<unknown>, showImages: boolean): string[] {
181
+ const showImageFallback = !getCapabilities().images || !showImages;
182
+ return result.content.flatMap((item) => item.type === "text" ? [safe(item.text)]
183
+ : item.type === "image" && showImageFallback ? [imageFallback(safe(item.mimeType))] : []);
184
+ }
185
+
186
+ /** Run the public factory once, intercepting only its registration; all other API access passes through. */
187
+ export function registerCompactCodemode(pi: ExtensionAPI, factory: ExtensionFactory = createCodemodeExtension()): ReturnType<ExtensionFactory> {
188
+ const decoratedAPI = new Proxy(pi, {
189
+ get(target, property, receiver) {
190
+ if (property === "registerTool") return (tool: ToolDefinition) => pi.registerTool(tool.name === "codemode" ? decorateCodemodeTool(tool) : tool);
191
+ return Reflect.get(target, property, receiver);
192
+ },
193
+ });
194
+ return factory(decoratedAPI);
195
+ }
@@ -26,7 +26,9 @@ export const COMMAND_PALETTE_CATALOG: readonly CommandPaletteCatalogGroup[] = [
26
26
  { command: "gentle:review-mode", label: "Review mode (receipt-driven development)" },
27
27
  { command: "gentle:background-subagents", label: "Background subagents" },
28
28
  { command: "gentle:double-esc-cancel", label: "Require double Esc to cancel" },
29
+ { command: "gentle:customize", label: "Customization · appearance + audio notifications" },
29
30
  { command: "gentle:animations", label: "Animation mode" },
31
+ { command: "gentle:vim", label: "Vim opt-in · Pi slash commands" },
30
32
  { command: "gentle:telemetry", label: "Telemetry" },
31
33
  { command: "gentle:banner", label: "Startup banner" },
32
34
  { command: "gentle:banner-color", label: "Banner color" },
@@ -38,8 +40,10 @@ export const COMMAND_PALETTE_CATALOG: readonly CommandPaletteCatalogGroup[] = [
38
40
  {
39
41
  title: "Session",
40
42
  items: [
41
- { command: "gentle:changes", label: "Browse captured changes" },
43
+ { command: "gentle:yolo", label: "🚀 YOLO 🔥 session permission" },
44
+ { command: "gentle:changes", label: "Browse changes" },
42
45
  { command: "gentle:agents", label: "Subagents" },
46
+ { command: "gentle:jobs", label: "Background jobs" },
43
47
  { command: "gentle:usage", label: "Subscription usage" },
44
48
  { command: "gentle:review-session-permission", label: "Review session permission" },
45
49
  ],
@@ -51,15 +55,6 @@ export const COMMAND_PALETTE_CATALOG: readonly CommandPaletteCatalogGroup[] = [
51
55
  { command: "gentle:doctor", label: "Doctor" },
52
56
  ],
53
57
  },
54
- {
55
- title: "SDD",
56
- items: [
57
- { command: "gentle:sdd-preflight", label: "SDD preflight" },
58
- { command: "gentle-sdd-status", label: "SDD status" },
59
- { command: "gentle-sdd-continue", label: "SDD continue" },
60
- { command: "gentle-sdd-init", label: "SDD init" },
61
- ],
62
- },
63
58
  {
64
59
  title: "Skills",
65
60
  items: [{ command: "skill-registry:refresh", label: "Refresh skill registry" }],
@@ -97,7 +97,30 @@ const TONE_COLOR: Record<Tone, string> = {
97
97
  };
98
98
 
99
99
  // Two border glyphs ("│ " and " │") plus the padding space on each side.
100
- const CARD_PADDING = 4;
100
+ export const CARD_PADDING = 4;
101
+
102
+ /** Commands card chrome shared with other fullscreen overlay panels. */
103
+ export function renderPaletteCard(lines: string[], width: number, theme?: CommandPaletteTheme): string[] {
104
+ const innerWidth = Math.max(1, width - CARD_PADDING);
105
+ const border = (text: string) => theme ? theme.fg("border", text) : text;
106
+ const horizontal = "─".repeat(innerWidth + 2);
107
+ return [border(`╭${horizontal}╮`), ...lines.map((content) => {
108
+ const visible = visibleWidth(stripAnsi(content));
109
+ const fitted = visible > innerWidth ? truncateToWidth(content, innerWidth, "…", true) : content + " ".repeat(innerWidth - visible);
110
+ return `${border("│")} ${fitted} ${border("│")}`;
111
+ }), border(`╰${horizontal}╯`)];
112
+ }
113
+
114
+ export function renderPaletteSelection(label: string, width: number, focused: boolean, theme?: CommandPaletteTheme): string {
115
+ const safe = sanitizeTerminalText(label);
116
+ if (focused && theme?.bg) {
117
+ const row = truncateToWidth(` ${safe}`, width, "…", true);
118
+ return theme.bg("selectedBg", row + " ".repeat(Math.max(0, width - visibleWidth(stripAnsi(row)))));
119
+ }
120
+ const prefix = focused ? (theme ? theme.fg("accent", "▸ ") : "▸ ") : " ";
121
+ const text = truncateToWidth(safe, Math.max(0, width - 2), "…", true);
122
+ return prefix + (theme ? theme.fg("text", text) : text);
123
+ }
101
124
  const CARD_BORDER_ROWS = 2;
102
125
  // Fixed content rows outside the grouped match list: header, query/search,
103
126
  // a blank row, a blank row before the footer, and the footer itself.
@@ -194,7 +217,7 @@ export class CommandPalette {
194
217
  render(width: number): string[] {
195
218
  const innerWidth = Math.max(1, width - CARD_PADDING);
196
219
  const maxTotalLines = Math.max(MIN_TOTAL_ROWS, Math.floor(this.rowsFn() * HEIGHT_RATIO));
197
- return this.renderCard(this.renderBody(innerWidth, maxTotalLines), innerWidth);
220
+ return renderPaletteCard(this.renderBody(innerWidth, maxTotalLines), width, this.theme);
198
221
  }
199
222
 
200
223
  /**
@@ -307,18 +330,6 @@ export class CommandPalette {
307
330
  return `${left}${" ".repeat(gap)}${right}${" ".repeat(trailingPad)}`;
308
331
  }
309
332
 
310
- private renderCard(lines: string[], innerWidth: number): string[] {
311
- const horizontal = "─".repeat(innerWidth + 2);
312
- const border = (text: string) => this.renderText(text, "border");
313
- return [border(`╭${horizontal}╮`), ...lines.map((content) => `${border("│")} ${this.fitStyledLine(content, innerWidth)} ${border("│")}`), border(`╰${horizontal}╯`)];
314
- }
315
-
316
- private fitStyledLine(content: string, width: number): string {
317
- const visible = visibleWidth(stripAnsi(content));
318
- if (visible > width) return truncateToWidth(content, Math.max(1, width), "…", true);
319
- return `${content}${" ".repeat(Math.max(0, width - visible))}`;
320
- }
321
-
322
333
  private renderLine(text = "", width: number, tone?: Tone): string {
323
334
  const safe = truncateToWidth(sanitizeTerminalText(text), Math.max(1, width), "…", true);
324
335
  return tone ? this.renderText(safe, tone) : safe;
@@ -0,0 +1,26 @@
1
+ /**
2
+ * Fixed product threshold for the high-context warning. The latch lives outside
3
+ * the notification and visual stores so both warnings share one episode.
4
+ */
5
+ export const CONTEXT_HIGH_PERCENT = 90;
6
+
7
+ /**
8
+ * One warning per high episode. `observe` returns true exactly once while usage
9
+ * stays at or above the threshold; a finite reading below it rearms the latch.
10
+ * An unknown reading (`null`, which Pi reports right after a successful
11
+ * compaction until the next assistant response) preserves the latch so the same
12
+ * episode cannot warn twice. A successful compaction or a new session calls
13
+ * `rearm` explicitly; a canceled or failed compaction must not, because the
14
+ * context was never reduced.
15
+ */
16
+ export class ContextHighLatch {
17
+ private high = false;
18
+ observe(percent: number | null | undefined): boolean {
19
+ if (typeof percent !== "number" || !Number.isFinite(percent)) return false;
20
+ if (percent < CONTEXT_HIGH_PERCENT) { this.high = false; return false; }
21
+ if (this.high) return false;
22
+ this.high = true;
23
+ return true;
24
+ }
25
+ rearm(): void { this.high = false; }
26
+ }