@pi-unipi/unipi 3.0.0-alpha.2 → 3.0.0-alpha.21

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 (359) hide show
  1. package/CHANGELOG.md +292 -0
  2. package/README.md +8 -11
  3. package/docs/prefix-cache-architecture.md +14 -0
  4. package/package.json +22 -24
  5. package/packages/ask-user/README.md +55 -107
  6. package/packages/ask-user/ask-ui.ts +306 -732
  7. package/packages/ask-user/clipboard.ts +50 -0
  8. package/packages/ask-user/config.ts +74 -78
  9. package/packages/ask-user/package.json +2 -2
  10. package/packages/ask-user/questions.ts +151 -0
  11. package/packages/ask-user/skills/ask-user/SKILL.md +59 -133
  12. package/packages/ask-user/tools.ts +198 -432
  13. package/packages/autocomplete/package.json +1 -1
  14. package/packages/autocomplete/src/constants.ts +38 -43
  15. package/packages/autocomplete/src/sorting.ts +8 -0
  16. package/packages/background-tasks/package.json +2 -2
  17. package/packages/background-tasks/src/config.ts +0 -73
  18. package/packages/background-tasks/src/index.ts +20 -16
  19. package/packages/background-tasks/src/registry.ts +1 -171
  20. package/packages/background-tasks/src/types.ts +0 -32
  21. package/packages/btw/README.md +13 -56
  22. package/packages/btw/extensions/btw.ts +403 -1796
  23. package/packages/btw/package.json +5 -2
  24. package/packages/btw/skills/btw/SKILL.md +7 -143
  25. package/packages/compactor/README.md +56 -287
  26. package/packages/compactor/package.json +5 -9
  27. package/packages/compactor/skills/compactor/SKILL.md +13 -20
  28. package/packages/compactor/src/card.ts +90 -0
  29. package/packages/compactor/src/commands/index.ts +73 -130
  30. package/packages/compactor/src/compaction/compact-args.ts +5 -3
  31. package/packages/compactor/src/compaction/filter-noise.ts +1 -1
  32. package/packages/compactor/src/compaction/hooks.ts +487 -311
  33. package/packages/compactor/src/compaction/source.ts +178 -0
  34. package/packages/compactor/src/compaction/summarize.ts +586 -52
  35. package/packages/compactor/src/config/manager.ts +130 -127
  36. package/packages/compactor/src/config/schema.ts +32 -48
  37. package/packages/compactor/src/index.ts +40 -431
  38. package/packages/compactor/src/info-screen.ts +44 -190
  39. package/packages/compactor/src/session/recall-blocks.ts +1 -1
  40. package/packages/compactor/src/stats.ts +76 -0
  41. package/packages/compactor/src/tools/context-budget.ts +17 -34
  42. package/packages/compactor/src/tools/ctx-doctor.ts +45 -36
  43. package/packages/compactor/src/tools/register.ts +29 -269
  44. package/packages/compactor/src/types.ts +47 -186
  45. package/packages/core/README.md +25 -0
  46. package/packages/core/child-agent.ts +1 -0
  47. package/packages/core/command-echo.ts +63 -0
  48. package/packages/core/compaction-context.ts +41 -0
  49. package/packages/core/constants.ts +8 -38
  50. package/packages/core/events.ts +0 -53
  51. package/packages/core/fusion-status.ts +4 -0
  52. package/packages/core/global.d.ts +10 -0
  53. package/packages/core/harness-messages.ts +392 -0
  54. package/packages/core/index.ts +14 -0
  55. package/packages/core/kanboard-status.ts +49 -0
  56. package/packages/core/long-horizon-owner-status.ts +46 -0
  57. package/packages/core/model-cache.ts +81 -7
  58. package/packages/core/package.json +6 -3
  59. package/packages/core/src/attach/detect.ts +163 -0
  60. package/packages/core/src/child-agent/child-args.ts +31 -0
  61. package/packages/core/src/child-agent/delivery.ts +41 -0
  62. package/packages/core/src/child-agent/index.ts +5 -0
  63. package/packages/core/src/child-agent/readers.ts +203 -0
  64. package/packages/core/src/child-agent/runtime.ts +584 -0
  65. package/packages/core/src/evidence.ts +78 -0
  66. package/packages/core/src/hints/browser.ts +278 -0
  67. package/packages/core/src/hints/crab-data.ts +19 -0
  68. package/packages/core/src/hints/index.ts +865 -0
  69. package/packages/core/src/hints/lines.ts +607 -0
  70. package/packages/core/src/hints/store.ts +120 -0
  71. package/packages/core/src/jev/chatter.ts +24 -0
  72. package/packages/core/src/jev/settings.ts +177 -14
  73. package/packages/core/src/package-colors.ts +2 -0
  74. package/packages/core/src/settings/catalog.ts +39 -15
  75. package/packages/core/src/settings/engine.ts +48 -2
  76. package/packages/core/src/settings/hub.ts +83 -20
  77. package/packages/core/src/settings/open.ts +49 -0
  78. package/packages/core/src/settings/schema.ts +27 -7
  79. package/packages/core/src/tui/hub-kit.ts +18 -5
  80. package/packages/core/src/tui/kit.ts +198 -0
  81. package/packages/core/src/tui/progress.ts +73 -0
  82. package/packages/core/src/turn/arbiter.ts +290 -0
  83. package/packages/footer/README.md +4 -6
  84. package/packages/footer/package.json +3 -3
  85. package/packages/footer/src/glance-editor.ts +19 -11
  86. package/packages/footer/src/help.ts +1 -1
  87. package/packages/footer/src/index.ts +36 -3
  88. package/packages/footer/src/presets.ts +3 -4
  89. package/packages/footer/src/rendering/icons.ts +0 -20
  90. package/packages/footer/src/segments/compactor.ts +52 -142
  91. package/packages/footer/src/segments/status-ext.ts +0 -1
  92. package/packages/fusion/README.md +14 -4
  93. package/packages/fusion/package.json +4 -3
  94. package/packages/fusion/src/child-args.ts +1 -0
  95. package/packages/fusion/src/index.ts +161 -8
  96. package/packages/fusion/src/pi-settings.ts +57 -0
  97. package/packages/fusion/src/picker.ts +186 -51
  98. package/packages/fusion/src/preset.ts +56 -2
  99. package/packages/fusion/src/prompts.ts +1 -1
  100. package/packages/fusion/src/sidekick-runtime.ts +1 -420
  101. package/packages/fusion/src/tools.ts +107 -128
  102. package/packages/fusion/src/transcript.ts +27 -85
  103. package/packages/info-screen/package.json +2 -2
  104. package/packages/input-shortcuts/README.md +18 -30
  105. package/packages/input-shortcuts/package.json +2 -2
  106. package/packages/input-shortcuts/src/burst.ts +88 -0
  107. package/packages/input-shortcuts/src/chord-overlay.ts +20 -70
  108. package/packages/input-shortcuts/src/cleared-input.ts +97 -0
  109. package/packages/input-shortcuts/src/index.ts +99 -193
  110. package/packages/input-shortcuts/src/last-response.ts +40 -0
  111. package/packages/input-shortcuts/src/registers.ts +8 -23
  112. package/packages/input-shortcuts/src/types.ts +4 -16
  113. package/packages/input-shortcuts/src/undo-redo.ts +59 -47
  114. package/packages/kanboard/README.md +51 -47
  115. package/packages/kanboard/index.ts +293 -55
  116. package/packages/kanboard/package.json +8 -8
  117. package/packages/kanboard/skills/kanboard/SKILL.md +61 -27
  118. package/packages/kanboard/src/badges.ts +93 -0
  119. package/packages/kanboard/src/bin.ts +4 -2
  120. package/packages/kanboard/src/commands.ts +218 -84
  121. package/packages/kanboard/src/debug.ts +20 -0
  122. package/packages/kanboard/src/guard.ts +267 -109
  123. package/packages/kanboard/src/monitor.ts +330 -0
  124. package/packages/kanboard/src/notice-buffer.ts +74 -0
  125. package/packages/kanboard/src/progress.ts +27 -0
  126. package/packages/kanboard/src/reminders.ts +234 -0
  127. package/packages/kanboard/src/settings.ts +69 -15
  128. package/packages/kanboard/src/shapes.ts +5 -0
  129. package/packages/long-horizon/index.ts +190 -13
  130. package/packages/long-horizon/package.json +3 -3
  131. package/packages/long-horizon/src/commands.ts +103 -7
  132. package/packages/long-horizon/src/compaction-brief.ts +35 -0
  133. package/packages/long-horizon/src/engine/continuation.ts +84 -15
  134. package/packages/long-horizon/src/engine/goal-state.ts +64 -13
  135. package/packages/long-horizon/src/engine/nudge-stash.ts +71 -0
  136. package/packages/long-horizon/src/engine/ralph.ts +3 -2
  137. package/packages/long-horizon/src/engine/runaway.ts +68 -11
  138. package/packages/long-horizon/src/engine/verifier.ts +19 -0
  139. package/packages/long-horizon/src/gate.ts +37 -12
  140. package/packages/long-horizon/src/judge/resolve.ts +1 -0
  141. package/packages/long-horizon/src/owner.ts +35 -2
  142. package/packages/long-horizon/src/progress.ts +87 -0
  143. package/packages/long-horizon/src/prompts/goal.ts +1 -1
  144. package/packages/long-horizon/src/runtime.ts +172 -18
  145. package/packages/long-horizon/src/settings.ts +54 -39
  146. package/packages/long-horizon/src/tools/goal.ts +6 -0
  147. package/packages/long-horizon/src/tools/graph.ts +1 -1
  148. package/packages/long-horizon/src/tools/swarm.ts +3 -3
  149. package/packages/mcp/package.json +2 -2
  150. package/packages/memory/commands.ts +7 -2
  151. package/packages/memory/index.ts +210 -32
  152. package/packages/memory/package.json +3 -3
  153. package/packages/memory/save-session.ts +264 -0
  154. package/packages/memory/settings.ts +17 -0
  155. package/packages/memory/tools.ts +253 -203
  156. package/packages/notify/package.json +2 -2
  157. package/packages/skill-registry/README.md +53 -16
  158. package/packages/skill-registry/index.ts +230 -0
  159. package/packages/skill-registry/package.json +19 -8
  160. package/packages/skill-registry/src/editor.ts +206 -0
  161. package/packages/skill-registry/src/judge.ts +289 -0
  162. package/packages/skill-registry/src/registry.ts +87 -0
  163. package/packages/skill-registry/src/settings.ts +259 -0
  164. package/packages/skill-registry/src/vault.ts +80 -0
  165. package/packages/subagents/README.md +39 -119
  166. package/packages/subagents/package.json +6 -13
  167. package/packages/subagents/skills/subagents/SKILL.md +18 -42
  168. package/packages/subagents/src/agents.ts +213 -0
  169. package/packages/subagents/src/cards.ts +182 -0
  170. package/packages/subagents/src/index.ts +609 -1084
  171. package/packages/subagents/src/manager.ts +429 -0
  172. package/packages/subagents/src/profiles.ts +130 -0
  173. package/packages/subagents/src/transcript.ts +154 -0
  174. package/packages/subagents/src/ui.ts +389 -0
  175. package/packages/unipi/bundled.js +39756 -45569
  176. package/packages/unipi/index.ts +55 -10
  177. package/packages/updater/package.json +2 -2
  178. package/packages/utility/README.md +76 -69
  179. package/packages/utility/package.json +2 -2
  180. package/packages/utility/skills/image/SKILL.md +37 -0
  181. package/packages/utility/skills/utility/SKILL.md +17 -60
  182. package/packages/utility/src/answer/extract.ts +128 -0
  183. package/packages/utility/src/answer/index.ts +213 -0
  184. package/packages/utility/src/answer/reply.ts +133 -0
  185. package/packages/utility/src/answer/web.ts +167 -0
  186. package/packages/utility/src/attach/index.ts +205 -0
  187. package/packages/utility/src/commands.ts +38 -142
  188. package/packages/utility/src/diagnostics/engine.ts +50 -5
  189. package/packages/utility/src/image/index.ts +33 -0
  190. package/packages/utility/src/image/models.ts +221 -0
  191. package/packages/{image/src → utility/src/image}/recognize.ts +2 -2
  192. package/packages/utility/src/image/settings.ts +178 -0
  193. package/packages/{image/src/image-source.ts → utility/src/image/source.ts} +1 -1
  194. package/packages/utility/src/image/tools.ts +168 -0
  195. package/packages/utility/src/image/transports.ts +186 -0
  196. package/packages/utility/src/index.ts +68 -389
  197. package/packages/utility/src/lifecycle/cleanup.ts +116 -311
  198. package/packages/utility/src/rename/gate.ts +102 -0
  199. package/packages/utility/src/rename/index.ts +191 -0
  200. package/packages/utility/src/rename/session.ts +170 -0
  201. package/packages/utility/src/render/delegated.ts +285 -0
  202. package/packages/utility/src/render/harness.ts +683 -0
  203. package/packages/utility/src/render/parse.ts +156 -0
  204. package/packages/utility/src/render/pi-settings.ts +38 -0
  205. package/packages/utility/src/render/reply-bg.ts +307 -0
  206. package/packages/utility/src/render/simple.ts +724 -0
  207. package/packages/utility/src/render/spacing.ts +235 -0
  208. package/packages/utility/src/render/styled.ts +251 -0
  209. package/packages/utility/src/render/tools.ts +353 -0
  210. package/packages/utility/src/settings.ts +166 -233
  211. package/packages/utility/src/types.ts +1 -222
  212. package/packages/watchdog/index.ts +17 -6
  213. package/packages/watchdog/package.json +3 -3
  214. package/packages/watchdog/src/config.ts +3 -2
  215. package/packages/web-api/package.json +2 -2
  216. package/packages/workflow/README.md +3 -0
  217. package/packages/workflow/index.ts +0 -2
  218. package/packages/workflow/package.json +2 -2
  219. package/packages/workflow/src/permission/decide.ts +6 -4
  220. package/packages/workflow/src/permission/index.ts +17 -7
  221. package/packages/workflow/src/permission/settings.ts +39 -4
  222. package/packages/workflow/src/plan/index.ts +19 -4
  223. package/packages/background-tasks/extensions/delegate-child.ts +0 -1
  224. package/packages/background-tasks/src/context-parent-snapshot.ts +0 -142
  225. package/packages/background-tasks/src/context-token-budget.ts +0 -903
  226. package/packages/background-tasks/src/context-visible-conversation-v2.ts +0 -551
  227. package/packages/background-tasks/src/delegate/artifacts.ts +0 -487
  228. package/packages/background-tasks/src/delegate/budget.ts +0 -415
  229. package/packages/background-tasks/src/delegate/hook-contract-evidence.json +0 -18
  230. package/packages/background-tasks/src/delegate/hook-contract.ts +0 -154
  231. package/packages/background-tasks/src/delegate/launch.ts +0 -484
  232. package/packages/background-tasks/src/delegate/result-package.ts +0 -459
  233. package/packages/background-tasks/src/delegate/runner.ts +0 -430
  234. package/packages/background-tasks/src/delegate/seed.ts +0 -423
  235. package/packages/background-tasks/src/delegate/types.ts +0 -323
  236. package/packages/background-tasks/src/delegate-child-extension.ts +0 -978
  237. package/packages/background-tasks/src/delegate-extension.ts +0 -654
  238. package/packages/background-tasks/src/fixtures/delegate-context-incident.json +0 -17
  239. package/packages/compactor/skills/compactor-detail/SKILL.md +0 -116
  240. package/packages/compactor/skills/compactor-doctor/SKILL.md +0 -71
  241. package/packages/compactor/skills/compactor-stats/SKILL.md +0 -51
  242. package/packages/compactor/src/compaction/build-sections.ts +0 -76
  243. package/packages/compactor/src/compaction/extract/goals.ts +0 -36
  244. package/packages/compactor/src/compaction/extract/preferences.ts +0 -40
  245. package/packages/compactor/src/compaction/format.ts +0 -53
  246. package/packages/compactor/src/compaction/merge.ts +0 -143
  247. package/packages/compactor/src/config/presets.ts +0 -160
  248. package/packages/compactor/src/executor/executor.ts +0 -233
  249. package/packages/compactor/src/executor/runtime.ts +0 -115
  250. package/packages/compactor/src/security/evaluator.ts +0 -89
  251. package/packages/compactor/src/security/policy.ts +0 -96
  252. package/packages/compactor/src/security/scanner.ts +0 -65
  253. package/packages/compactor/src/session/auto-inject.ts +0 -60
  254. package/packages/compactor/src/session/db.ts +0 -325
  255. package/packages/compactor/src/session/extract.ts +0 -144
  256. package/packages/compactor/src/session/resume-inject.ts +0 -64
  257. package/packages/compactor/src/session/snapshot.ts +0 -327
  258. package/packages/compactor/src/tools/ctx-batch-execute.ts +0 -41
  259. package/packages/compactor/src/tools/ctx-execute-file.ts +0 -23
  260. package/packages/compactor/src/tools/ctx-execute.ts +0 -23
  261. package/packages/compactor/src/tools/ctx-stats.ts +0 -96
  262. package/packages/image/README.md +0 -99
  263. package/packages/image/package.json +0 -61
  264. package/packages/image/skills/image/SKILL.md +0 -76
  265. package/packages/image/src/generate.ts +0 -256
  266. package/packages/image/src/index.ts +0 -135
  267. package/packages/image/src/models.ts +0 -519
  268. package/packages/image/src/openai-images-api.ts +0 -282
  269. package/packages/image/src/register-providers.ts +0 -209
  270. package/packages/image/src/settings.ts +0 -173
  271. package/packages/image/src/tools.ts +0 -326
  272. package/packages/input-shortcuts/src/clipboard.ts +0 -119
  273. package/packages/kanboard/src/runner.ts +0 -817
  274. package/packages/skill-registry/skills/auto/SKILL.md +0 -465
  275. package/packages/skill-registry/skills/brainstorm/SKILL.md +0 -219
  276. package/packages/skill-registry/skills/chore-create/SKILL.md +0 -315
  277. package/packages/skill-registry/skills/chore-execute/SKILL.md +0 -314
  278. package/packages/skill-registry/skills/consolidate/SKILL.md +0 -142
  279. package/packages/skill-registry/skills/consultant/SKILL.md +0 -97
  280. package/packages/skill-registry/skills/debug/SKILL.md +0 -228
  281. package/packages/skill-registry/skills/document/SKILL.md +0 -120
  282. package/packages/skill-registry/skills/fix/SKILL.md +0 -212
  283. package/packages/skill-registry/skills/gather-context/SKILL.md +0 -145
  284. package/packages/skill-registry/skills/plan/SKILL.md +0 -231
  285. package/packages/skill-registry/skills/quick-fix/SKILL.md +0 -135
  286. package/packages/skill-registry/skills/quick-work/SKILL.md +0 -110
  287. package/packages/skill-registry/skills/research/SKILL.md +0 -251
  288. package/packages/skill-registry/skills/review-work/SKILL.md +0 -187
  289. package/packages/skill-registry/skills/scan-issues/SKILL.md +0 -195
  290. package/packages/skill-registry/skills/work/SKILL.md +0 -218
  291. package/packages/skill-registry/skills/worktree-create/SKILL.md +0 -69
  292. package/packages/skill-registry/skills/worktree-list/SKILL.md +0 -78
  293. package/packages/skill-registry/skills/worktree-merge/SKILL.md +0 -89
  294. package/packages/subagents/agents/delegate.md +0 -14
  295. package/packages/subagents/agents/oracle.md +0 -78
  296. package/packages/subagents/agents/researcher.md +0 -52
  297. package/packages/subagents/agents/reviewer.md +0 -80
  298. package/packages/subagents/agents/scout.md +0 -50
  299. package/packages/subagents/agents/worker.md +0 -59
  300. package/packages/subagents/prompts/council.md +0 -48
  301. package/packages/subagents/prompts/gather-context-and-clarify.md +0 -13
  302. package/packages/subagents/prompts/parallel-cleanup.md +0 -59
  303. package/packages/subagents/prompts/parallel-research.md +0 -50
  304. package/packages/subagents/prompts/parallel-review.md +0 -54
  305. package/packages/subagents/prompts/review-loop.md +0 -43
  306. package/packages/subagents/skills/council-mode/SKILL.md +0 -230
  307. package/packages/subagents/skills/subagents/references/constraints-and-recipes.md +0 -259
  308. package/packages/subagents/skills/subagents/references/execution-controls.md +0 -454
  309. package/packages/subagents/skills/subagents/references/management-authoring-rpc.md +0 -161
  310. package/packages/subagents/skills/subagents/references/multi-lane-orchestration.md +0 -39
  311. package/packages/subagents/skills/subagents/references/prompting-and-roles.md +0 -267
  312. package/packages/subagents/src/acceptance.ts +0 -331
  313. package/packages/subagents/src/agent-manager.ts +0 -405
  314. package/packages/subagents/src/agent-memory.ts +0 -300
  315. package/packages/subagents/src/agent-overrides.ts +0 -183
  316. package/packages/subagents/src/agent-runner.ts +0 -271
  317. package/packages/subagents/src/async-runner.ts +0 -422
  318. package/packages/subagents/src/authority-policy.ts +0 -47
  319. package/packages/subagents/src/budgets.ts +0 -285
  320. package/packages/subagents/src/child-safety.ts +0 -140
  321. package/packages/subagents/src/config.ts +0 -249
  322. package/packages/subagents/src/conversation-viewer.ts +0 -281
  323. package/packages/subagents/src/core-compat.ts +0 -94
  324. package/packages/subagents/src/custom-agents.ts +0 -343
  325. package/packages/subagents/src/file-system-retry.ts +0 -50
  326. package/packages/subagents/src/fleet-data.ts +0 -105
  327. package/packages/subagents/src/fleet-view.ts +0 -322
  328. package/packages/subagents/src/foreground-detach.ts +0 -59
  329. package/packages/subagents/src/fork-context.ts +0 -285
  330. package/packages/subagents/src/global.d.ts +0 -7
  331. package/packages/subagents/src/guide.ts +0 -129
  332. package/packages/subagents/src/mission-state.ts +0 -133
  333. package/packages/subagents/src/mission-store.ts +0 -436
  334. package/packages/subagents/src/output-limits.ts +0 -142
  335. package/packages/subagents/src/parity-types.ts +0 -315
  336. package/packages/subagents/src/pi-args.ts +0 -167
  337. package/packages/subagents/src/result-files.ts +0 -232
  338. package/packages/subagents/src/result-watcher.ts +0 -221
  339. package/packages/subagents/src/retained-children.ts +0 -176
  340. package/packages/subagents/src/run-fanout-budget.ts +0 -356
  341. package/packages/subagents/src/scheduled-runs.ts +0 -349
  342. package/packages/subagents/src/schemas.ts +0 -263
  343. package/packages/subagents/src/slash-commands.ts +0 -80
  344. package/packages/subagents/src/supervisor-channel.ts +0 -249
  345. package/packages/subagents/src/tool-handler.ts +0 -1144
  346. package/packages/subagents/src/types.ts +0 -238
  347. package/packages/subagents/src/widget.ts +0 -457
  348. package/packages/subagents/src/workflow-script.ts +0 -737
  349. package/packages/subagents/src/workflow-worker.ts +0 -384
  350. package/packages/subagents/src/worktree.ts +0 -614
  351. package/packages/utility/src/analytics/collector.ts +0 -293
  352. package/packages/utility/src/info-screen.ts +0 -80
  353. package/packages/utility/src/lifecycle/process.ts +0 -162
  354. package/packages/utility/src/prefix-cache.ts +0 -263
  355. package/packages/utility/src/skill-discovery.ts +0 -542
  356. package/packages/utility/src/tools/env.ts +0 -113
  357. package/packages/utility/src/tui/name-badge-state.ts +0 -315
  358. package/packages/utility/src/tui/name-badge.ts +0 -109
  359. /package/packages/{subagents/src → core/src/child-agent}/pi-spawn.ts +0 -0
@@ -1,542 +0,0 @@
1
- /**
2
- * @pi-unipi/utility — Skill startup exposure
3
- *
4
- * Decides which discovered skills stay cataloged in the agent's system
5
- * prompt. Setting: `skills.mode` in the utility namespace:
6
- *
7
- * judged — jev (the long-horizon Decision model) picks the skills whose
8
- * descriptions look relevant to the session's first prompt; the
9
- * frozen set is reused for every later turn (byte-identical
10
- * system prompt, prefix-cache safe). With skills.recheck, later
11
- * prompts can ANNOUNCE newly relevant hidden skills via a
12
- * persisted custom message — the system prompt itself never
13
- * changes after the freeze.
14
- * all — every discovered skill stays (no judging).
15
- * off — bundled skills stripped (old "false" behavior).
16
- *
17
- * Skills stay invocable regardless of mode: /skill:name and direct
18
- * SKILL.md reads are independent of the prompt catalog.
19
- */
20
-
21
- import { basename, join } from "node:path";
22
- import * as path from "node:path";
23
- import { appendFileSync, mkdirSync } from "node:fs";
24
- import { homedir } from "node:os";
25
- import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
26
- import { askJev, getSettings, readJudgeJevSettings, type JevAnswer, type JevSettings } from "@pi-unipi/core";
27
- import { migrateSkillsDiscovery } from "./settings.js";
28
-
29
- export type SkillExposureMode = "judged" | "all" | "off";
30
-
31
- /** Skill exposure settings */
32
- export interface SkillDiscoverySettings {
33
- mode: SkillExposureMode;
34
- /** Minimum jev relevance (noul 0–1) for a skill to stay exposed. */
35
- threshold: number;
36
- /** Hard cap on exposed skills. */
37
- maxSkills: number;
38
- /** Suggest newly relevant hidden skills on later prompts. */
39
- recheck: boolean;
40
- }
41
-
42
- /** Default skill exposure settings */
43
- export const DEFAULT_SKILL_DISCOVERY_SETTINGS: SkillDiscoverySettings = {
44
- mode: "judged",
45
- threshold: 0.3,
46
- maxSkills: 12,
47
- recheck: true,
48
- };
49
-
50
- /** Session-persisted entry types (pi.appendEntry custom entries). */
51
- export const SKILLS_JUDGED_ENTRY = "unipi:skills-judged";
52
- export const SKILLS_REVEALED_ENTRY = "unipi:skills-revealed";
53
-
54
- /** System-prompt markers for the skills catalog (agentskills.io tags). */
55
- const SKILLS_OPEN_TAG = "<available_skills>";
56
- const SKILLS_CLOSE_TAG = "</available_skills>";
57
-
58
- /**
59
- * Load skill exposure settings from the engine (utility namespace). The
60
- * one-time migrations live in settings.ts; defaults apply when unset.
61
- */
62
- export function loadSkillDiscoverySettings(): SkillDiscoverySettings {
63
- try {
64
- migrateSkillsDiscovery(process.cwd());
65
- const parsed = getSettings("utility", process.cwd()) as {
66
- skills?: Record<string, unknown>;
67
- };
68
- const skills = parsed?.skills ?? {};
69
- return {
70
- mode:
71
- skills.mode === "judged" || skills.mode === "all" || skills.mode === "off"
72
- ? skills.mode
73
- : skills.discovery === false
74
- ? "off"
75
- : DEFAULT_SKILL_DISCOVERY_SETTINGS.mode,
76
- threshold:
77
- typeof skills.threshold === "number" && skills.threshold >= 0 && skills.threshold <= 1
78
- ? skills.threshold
79
- : DEFAULT_SKILL_DISCOVERY_SETTINGS.threshold,
80
- maxSkills:
81
- typeof skills.maxSkills === "number" && skills.maxSkills >= 1
82
- ? skills.maxSkills
83
- : DEFAULT_SKILL_DISCOVERY_SETTINGS.maxSkills,
84
- recheck: typeof skills.recheck === "boolean" ? skills.recheck : DEFAULT_SKILL_DISCOVERY_SETTINGS.recheck,
85
- };
86
- } catch {
87
- return { ...DEFAULT_SKILL_DISCOVERY_SETTINGS };
88
- }
89
- }
90
-
91
- /**
92
- * Whether skills are cataloged in the system prompt at startup.
93
- */
94
- export function isSkillDiscoveryEnabled(): boolean {
95
- return loadSkillDiscoverySettings().mode !== "off";
96
- }
97
-
98
- /**
99
- * Match a skill location that belongs to Unipi's own bundled skills.
100
- *
101
- * - Installed via npm: `…/node_modules/@pi-unipi/<pkg>/skills/…`
102
- * - Dev checkout (workspace/mise run): `…/unipi/packages/<pkg>/skills/…`
103
- *
104
- * Everything else (user global, project, settings-mounted, third-party
105
- * packages) is NOT considered bundled and stays discoverable.
106
- */
107
- export function isBundledSkillLocation(location: string): boolean {
108
- return location.includes("/@pi-unipi/") || /\/unipi\/packages\//.test(location);
109
- }
110
-
111
- /**
112
- * Remove Unipi's bundled skills from the `<available_skills>` catalog in a
113
- * system prompt, keeping every other skill discoverable. When no non-bundled
114
- * skills remain, the whole section (with its intro paragraph) is removed.
115
- *
116
- * Anchor-based: section tags are agentskills.io spec (stable), entry
117
- * splitting follows pi's `formatSkillsForPrompt` layout (` <skill>` entries
118
- * with `<name>`/`<description>`/`<location>` children).
119
- *
120
- * Returns undefined when there is nothing to change (no section, or no
121
- * bundled skills in it).
122
- */
123
- export function stripBundledSkills(systemPrompt: string): string | undefined {
124
- const open = systemPrompt.indexOf(SKILLS_OPEN_TAG);
125
- if (open === -1) return undefined;
126
- const close = systemPrompt.indexOf(SKILLS_CLOSE_TAG, open);
127
- if (close === -1) return undefined;
128
- const sectionStart = open + SKILLS_OPEN_TAG.length;
129
-
130
- const inner = systemPrompt.slice(sectionStart, close);
131
- const entries = inner.split(/(?= <skill>)/g);
132
- const kept: string[] = [];
133
- let bundledCount = 0;
134
- for (const entry of entries) {
135
- if (!entry.includes("<skill>")) continue; // Whitespace between tags.
136
- const locationMatch = entry.match(/<location>([^<]*)<\/location>/);
137
- if (locationMatch && isBundledSkillLocation(locationMatch[1])) {
138
- bundledCount++;
139
- continue;
140
- }
141
- kept.push(entry);
142
- }
143
-
144
- if (bundledCount === 0) return undefined; // No bundled skills — no-op.
145
-
146
- if (kept.length === 0) {
147
- // Nothing left to catalog — remove the entire section (intro included).
148
- // Layout: "<prev>\n\n<intro paragraph>\n\n<available_skills>…</available_skills>".
149
- const p1 = systemPrompt.lastIndexOf("\n\n", open);
150
- const prev = p1 === -1 ? -1 : systemPrompt.lastIndexOf("\n\n", p1 - 1);
151
- const start = prev === -1 ? 0 : prev;
152
- return systemPrompt.slice(0, start) + systemPrompt.slice(close + SKILLS_CLOSE_TAG.length);
153
- }
154
-
155
- // Rebuild the catalog with only the non-bundled entries.
156
- const rebuiltInner = "\n" + kept.join("").replace(/\n+$/, "") + "\n";
157
- return systemPrompt.slice(0, sectionStart) + rebuiltInner + systemPrompt.slice(close);
158
- }
159
-
160
- // ─── jev-judged skill exposure ───────────────────────────────────────────
161
-
162
- /** One `<skill>` entry from the `<available_skills>` catalog. */
163
- export interface ParsedSkill {
164
- name: string;
165
- description: string;
166
- location: string;
167
- /** The raw catalog block, reused verbatim when rebuilding the section. */
168
- raw: string;
169
- }
170
-
171
- export interface ParsedCatalog {
172
- entries: ParsedSkill[];
173
- /** Prompt text before `<available_skills>` (intro included). */
174
- before: string;
175
- /** Prompt text from `</available_skills>` on (exclusive of the tag). */
176
- after: string;
177
- }
178
-
179
- /** Extract the `<available_skills>` entries (name/description/location). */
180
- export function parseSkillsCatalog(systemPrompt: string): ParsedCatalog | null {
181
- const open = systemPrompt.indexOf(SKILLS_OPEN_TAG);
182
- if (open === -1) return null;
183
- const close = systemPrompt.indexOf(SKILLS_CLOSE_TAG, open);
184
- if (close === -1) return null;
185
- const sectionStart = open + SKILLS_OPEN_TAG.length;
186
- const inner = systemPrompt.slice(sectionStart, close);
187
- const entries: ParsedSkill[] = [];
188
- for (const block of inner.split(/(?= <skill>)/g)) {
189
- if (!block.includes("<skill>")) continue;
190
- const name = block.match(/<name>([^<]*)<\/name>/)?.[1] ?? "";
191
- const description = block.match(/<description>([^<]*)<\/description>/)?.[1] ?? "";
192
- const location = block.match(/<location>([^<]*)<\/location>/)?.[1] ?? "";
193
- entries.push({ name, description, location, raw: block });
194
- }
195
- return {
196
- entries,
197
- before: systemPrompt.slice(0, sectionStart),
198
- after: systemPrompt.slice(close),
199
- };
200
- }
201
-
202
- /** Rebuild the prompt with only `kept` entries, then the hidden-count line. */
203
- export function rebuildSkillsCatalog(
204
- prompt: string,
205
- kept: readonly ParsedSkill[],
206
- hiddenCount: number,
207
- ): string {
208
- const open = prompt.indexOf(SKILLS_OPEN_TAG);
209
- const close = prompt.indexOf(SKILLS_CLOSE_TAG, open);
210
- if (open === -1 || close === -1) return prompt;
211
- const sectionStart = open + SKILLS_OPEN_TAG.length;
212
- const rebuiltInner =
213
- "\n" + kept.map((e) => e.raw).join("").replace(/\n+$/, "") + (kept.length > 0 ? "\n" : "");
214
- const hiddenLine =
215
- hiddenCount > 0
216
- ? `\n${hiddenCount} other skills are installed but hidden for this session; any can still be loaded by reading its SKILL.md or via /skill:name.`
217
- : "";
218
- return prompt.slice(0, sectionStart) + rebuiltInner + SKILLS_CLOSE_TAG + hiddenLine + prompt.slice(close + SKILLS_CLOSE_TAG.length);
219
- }
220
-
221
- /** One Noul question per skill; state is the prompt (truncated) + cwd. */
222
- export function judgeRequest(
223
- entries: readonly ParsedSkill[],
224
- prompt: string,
225
- cwdBase: string,
226
- ): { state: string; questions: Record<string, { type: "noul"; instructions: string }> } {
227
- const state = `${prompt.slice(0, 4000)}\n[project: ${cwdBase}]`;
228
- const questions: Record<string, { type: "noul"; instructions: string }> = {};
229
- entries.forEach((entry, i) => {
230
- questions[`s${i}`] = {
231
- type: "noul",
232
- instructions: `Would the skill "${entry.name}" help handle this request? Skill: ${entry.description.slice(0, 300)}`,
233
- };
234
- });
235
- return { state, questions };
236
- }
237
-
238
- /**
239
- * Apply jev's answers: keep noul ≥ threshold, sort by score descending, cap
240
- * at maxSkills, and restore the original catalog order for the kept set.
241
- */
242
- export function applyJudgement(
243
- entries: readonly ParsedSkill[],
244
- answers: Record<string, JevAnswer>,
245
- threshold: number,
246
- maxSkills: number,
247
- ): { kept: ParsedSkill[]; hidden: ParsedSkill[] } {
248
- const scored = entries.map((entry, i) => ({
249
- entry,
250
- score: typeof answers[`s${i}`]?.noul === "number" ? (answers[`s${i}`].noul as number) : 0,
251
- }));
252
- const kept = scored
253
- .filter((s) => s.score >= threshold)
254
- .sort((a, b) => b.score - a.score)
255
- .slice(0, Math.max(1, maxSkills))
256
- .map((s) => s.entry);
257
- const keptKeys = new Set(kept);
258
- return { kept, hidden: entries.filter((e) => !keptKeys.has(e)) };
259
- }
260
-
261
- /** The Decision-model settings the skill judge shares with long-horizon. */
262
- function judgeSettings(): JevSettings {
263
- return readJudgeJevSettings(process.cwd());
264
- }
265
-
266
- /** Debug logging, gated by UNIPI_DEBUG_SKILLS=1 → ~/.unipi/logs/skills.log. */
267
- function debugLog(line: string): void {
268
- if (process.env.UNIPI_DEBUG_SKILLS !== "1") return;
269
- try {
270
- const dir = join(homedir(), ".unipi", "logs");
271
- mkdirSync(dir, { recursive: true });
272
- appendFileSync(path.join(dir, "skills.log"), `${new Date().toISOString()} ${line}\n`);
273
- } catch {
274
- // Debug logging is best-effort.
275
- }
276
- }
277
-
278
- // ─── per-session frozen state ────────────────────────────────────────────
279
-
280
- export interface SessionSkillsState {
281
- sessionId: string;
282
- /** Frozen on the session's first judged prompt. */
283
- judged: boolean;
284
- /** Hidden-skill count AT FREEZE — the prompt line must stay byte-identical. */
285
- hiddenCount: number;
286
- /** Frozen exposed skill names, in catalog order. */
287
- kept: string[];
288
- /** Skills hidden by the freeze (recheck candidates). */
289
- hidden: ParsedSkill[];
290
- revealed: Set<string>;
291
- }
292
-
293
- let sessionState: SessionSkillsState | null = null;
294
-
295
- /** Scan session entries for the frozen judged set + already-revealed names. */
296
- export function restoreSkillsSessionState(
297
- sessionId: string,
298
- entries: ReadonlyArray<object>,
299
- ): SessionSkillsState {
300
- sessionState = { sessionId, judged: false, hiddenCount: 0, kept: [], hidden: [], revealed: new Set() };
301
- for (const entry of entries) {
302
- const customType = (entry as { customType?: string }).customType;
303
- if (customType !== SKILLS_JUDGED_ENTRY && customType !== SKILLS_REVEALED_ENTRY) continue;
304
- const data = (entry as { data?: unknown }).data as
305
- | { kept?: unknown; hidden?: unknown; hiddenCount?: unknown; names?: unknown }
306
- | undefined;
307
- if (customType === SKILLS_JUDGED_ENTRY) {
308
- if (Array.isArray(data?.kept) && Array.isArray(data?.hidden)) {
309
- // The freeze is authoritative: later turns reuse it (never re-judge).
310
- sessionState.judged = true;
311
- sessionState.kept = data.kept.map(String);
312
- sessionState.hidden = (data.hidden as ParsedSkill[]).map((h) => ({
313
- name: String(h.name ?? ""),
314
- description: String(h.description ?? ""),
315
- location: String(h.location ?? ""),
316
- raw: "",
317
- }));
318
- sessionState.hiddenCount =
319
- typeof data.hiddenCount === "number" ? data.hiddenCount : sessionState.hidden.length;
320
- }
321
- } else if (Array.isArray(data?.names)) {
322
- for (const name of data.names) sessionState.revealed.add(String(name));
323
- // Announced skills are no longer recheck candidates.
324
- sessionState.hidden = sessionState.hidden.filter((h) => !sessionState!.revealed.has(h.name));
325
- }
326
- }
327
- if (sessionState.judged) {
328
- debugLog(
329
- `restored frozen set from session entry (kept=${sessionState.kept.length} hidden=${sessionState.hiddenCount})`,
330
- );
331
- }
332
- return sessionState;
333
- }
334
-
335
- /** Drop per-session state (new session). */
336
- export function resetSkillsSessionState(sessionId: string): void {
337
- sessionState = { sessionId, judged: false, hiddenCount: 0, kept: [], hidden: [], revealed: new Set() };
338
- }
339
-
340
- function currentState(ctx: ExtensionContext): SessionSkillsState {
341
- const sessionId = ctx.sessionManager.getSessionId();
342
- if (!sessionState || sessionState.sessionId !== sessionId) {
343
- resetSkillsSessionState(sessionId);
344
- }
345
- return sessionState!;
346
- }
347
-
348
- /**
349
- * Wire the skills pipeline into pi: session restore + the before_agent_start
350
- * system-prompt rewrite (bundled strip → freeze → judge → recheck).
351
- */
352
- /**
353
- * Wire the skills pipeline into pi: session restore + the before_agent_start
354
- * options mutation (bundled strip → freeze → judge → recheck).
355
- *
356
- * Integration note: pi renders the skills catalog from
357
- * `event.systemPromptOptions.skills` AFTER handlers run, so judging works by
358
- * MUTATING that array to the frozen exposed set — the system prompt stays
359
- * byte-identical on every later turn (prefix-cache safe).
360
- */
361
- /** Event another module emits to force-reveal a skill by name (append-only). */
362
- export const SKILL_REVEAL_EVENT = "unipi:skills:reveal";
363
-
364
- /**
365
- * Reveal skills on request from another module (kanboard's onboard/work).
366
- * Append-only: the agent gets a message naming the skill and where it lives —
367
- * the system prompt is never touched, so the prefix cache holds. Returns the
368
- * names that were newly revealed.
369
- */
370
- export function revealSkillsByName(
371
- pi: ExtensionAPI,
372
- names: readonly string[],
373
- location: string,
374
- description: string,
375
- ): string[] {
376
- const state = sessionState;
377
- const wanted = names.filter((name) => name.trim().length > 0);
378
- if (!state) return wanted;
379
- const reveal = (name: string): boolean => {
380
- if (state.revealed.has(name)) return false;
381
- state.revealed.add(name);
382
- state.hidden = state.hidden.filter((entry) => entry.name !== name);
383
- return true;
384
- };
385
- const newly = wanted.filter(reveal);
386
- if (newly.length === 0) return [];
387
- pi.appendEntry(SKILLS_REVEALED_ENTRY, { names: newly });
388
- pi.sendMessage(
389
- {
390
- customType: "unipi-skills-revealed",
391
- content:
392
- `Skills revealed for this session:\n` +
393
- newly.map((name) => `- ${name} \u2014 ${description} (${location})`).join("\n") +
394
- `\nRead a skill's SKILL.md before using it.`,
395
- display: true,
396
- },
397
- { triggerTurn: false },
398
- );
399
- return newly;
400
- }
401
-
402
- export function registerSkillJudging(pi: ExtensionAPI): void {
403
- // The fake pi in tests has no event bus; registration must still succeed.
404
- pi.events?.on?.(SKILL_REVEAL_EVENT, (payload: unknown) => {
405
- const data = payload as { names?: unknown; location?: unknown; description?: unknown } | undefined;
406
- if (!Array.isArray(data?.names)) return;
407
- revealSkillsByName(
408
- pi,
409
- data.names.map(String),
410
- typeof data.location === "string" ? data.location : "skills/",
411
- typeof data.description === "string" ? data.description : "revealed on request",
412
- );
413
- });
414
-
415
- pi.on("session_start", (_event, ctx) => {
416
- // resume/fork/new: re-derive state from the (possibly branched) entries.
417
- restoreSkillsSessionState(ctx.sessionManager.getSessionId(), ctx.sessionManager.getEntries());
418
- });
419
-
420
- pi.on("before_agent_start", async (event, ctx) => {
421
- const st = loadSkillDiscoverySettings();
422
- const optionSkills = event.systemPromptOptions?.skills ?? [];
423
- const skillDir = (s: { filePath?: string; baseDir?: string }): string =>
424
- s.baseDir ?? s.filePath ?? "";
425
- debugLog(
426
- `before_agent_start mode=${st.mode} skills=${optionSkills.length} ` +
427
- `promptChars=${event.systemPrompt.length}`,
428
- );
429
-
430
- // Bundled stripping runs first, exactly as it always has (mode off).
431
- if (st.mode === "off") {
432
- event.systemPromptOptions.skills = optionSkills.filter(
433
- (s) => !isBundledSkillLocation(skillDir(s)),
434
- );
435
- return undefined;
436
- }
437
- if (st.mode === "all") {
438
- return undefined; // every skill stays; nothing to judge
439
- }
440
-
441
- const state = currentState(ctx);
442
-
443
- // ── judged: freeze on the session's first prompt ──
444
- if (!state.judged) {
445
- if (optionSkills.length <= st.maxSkills) {
446
- // Small catalog: everyone stays; nothing hidden, nothing frozen.
447
- debugLog(`catalog ${optionSkills.length} <= maxSkills ${st.maxSkills} — not judged`);
448
- return undefined;
449
- }
450
- const entries: ParsedSkill[] = optionSkills.map((s) => ({
451
- name: s.name,
452
- description: s.description,
453
- location: skillDir(s),
454
- raw: "",
455
- }));
456
- const req = judgeRequest(entries, event.prompt, basename(process.cwd()));
457
- const startedAt = Date.now();
458
- const answers = await askJev({
459
- ...req,
460
- settings: judgeSettings(),
461
- fetchImpl: undefined,
462
- env: process.env,
463
- });
464
- let kept: ParsedSkill[];
465
- let hidden: ParsedSkill[];
466
- let failOpen = false;
467
- if (answers) {
468
- ({ kept, hidden } = applyJudgement(entries, answers, st.threshold, st.maxSkills));
469
- } else {
470
- kept = entries; // fail-open: expose everything
471
- hidden = [];
472
- failOpen = true;
473
- }
474
- state.judged = true;
475
- state.hiddenCount = hidden.length;
476
- state.kept = kept.map((e) => e.name);
477
- state.hidden = hidden;
478
- debugLog(
479
- `judged ${entries.length} -> ${kept.length} ` +
480
- `kept=[${kept.map((e) => e.name).join(", ")}] ` +
481
- `latency=${Date.now() - startedAt}ms failOpen=${failOpen}`,
482
- );
483
- pi.appendEntry(SKILLS_JUDGED_ENTRY, {
484
- kept: state.kept,
485
- hidden: hidden.map((h) => ({ name: h.name, description: h.description, location: h.location })),
486
- hiddenCount: hidden.length,
487
- ...(failOpen ? { failOpen: true } : {}),
488
- });
489
- event.systemPromptOptions.skills = optionSkills.filter((s) =>
490
- kept.some((e) => e.name === s.name),
491
- );
492
- if (ctx.hasUI) {
493
- ctx.ui.setStatus("skills", `skills: ${kept.length}/${entries.length} exposed`);
494
- }
495
- return undefined;
496
- }
497
-
498
- // ── frozen turns: re-apply the frozen exposed set. The system prompt pi
499
- // renders stays byte-identical every turn; recheck only ADDS a message.
500
- const keptSet = new Set(state.kept);
501
- event.systemPromptOptions.skills = optionSkills.filter((s) => keptSet.has(s.name));
502
- if (ctx.hasUI) {
503
- ctx.ui.setStatus("skills", `skills: ${state.kept.length}/${state.kept.length + state.hiddenCount} exposed`);
504
- }
505
-
506
- if (st.recheck && state.hidden.length > 0) {
507
- const entries: ParsedSkill[] = state.hidden;
508
- const req = judgeRequest(entries, event.prompt, basename(process.cwd()));
509
- const answers = await askJev({
510
- ...req,
511
- settings: judgeSettings(),
512
- fetchImpl: undefined,
513
- env: process.env,
514
- });
515
- if (answers) {
516
- const newly = entries
517
- .filter((h, i) => {
518
- const score = answers[`s${i}`]?.noul;
519
- return typeof score === "number" && score >= st.threshold && !state.revealed.has(h.name);
520
- })
521
- .slice(0, 5);
522
- if (newly.length > 0) {
523
- for (const skill of newly) state.revealed.add(skill.name);
524
- state.hidden = state.hidden.filter((h) => !newly.includes(h));
525
- pi.appendEntry(SKILLS_REVEALED_ENTRY, { names: newly.map((n) => n.name) });
526
- return {
527
- message: {
528
- customType: "unipi-skills-revealed",
529
- content:
530
- `Newly relevant skills for this request:\n` +
531
- newly.map((n) => `- ${n.name} \u2014 ${n.description} (${n.location})`).join("\n") +
532
- `\nRead a skill's SKILL.md before using it.`,
533
- display: true,
534
- },
535
- };
536
- }
537
- }
538
- }
539
-
540
- return undefined;
541
- });
542
- }
@@ -1,113 +0,0 @@
1
- /**
2
- * @pi-unipi/utility — Environment Info Tool
3
- *
4
- * Show environment information for debugging.
5
- */
6
-
7
- import { existsSync, readdirSync } from "node:fs";
8
- import { join, resolve } from "node:path";
9
- import { homedir } from "node:os";
10
- import { getPiVersion } from "@pi-unipi/core";
11
- import type { EnvironmentInfo } from "../types.js";
12
-
13
- /** Collect environment information */
14
- export function getEnvironmentInfo(): EnvironmentInfo {
15
- const unipiModules: string[] = [];
16
- const configPaths: string[] = [];
17
- const extensionPaths: string[] = [];
18
-
19
- // Try to discover unipi modules from node_modules
20
- try {
21
- const nodeModules = resolve(process.cwd(), "node_modules");
22
- if (existsSync(nodeModules)) {
23
- const scopePath = join(nodeModules, "@pi-unipi");
24
- if (existsSync(scopePath)) {
25
- for (const entry of readdirSync(scopePath)) {
26
- if (entry.startsWith(".")) continue;
27
- const pkgPath = join(scopePath, entry, "package.json");
28
- if (existsSync(pkgPath)) {
29
- unipiModules.push(`@pi-unipi/${entry}`);
30
- }
31
- }
32
- }
33
- }
34
- } catch {
35
- // Best effort
36
- }
37
-
38
- // Config paths
39
- const globalConfig = join(homedir(), ".unipi", "config");
40
- const projectConfig = resolve(process.cwd(), ".unipi", "config");
41
-
42
- if (existsSync(globalConfig)) {
43
- configPaths.push(globalConfig);
44
- }
45
- if (existsSync(projectConfig)) {
46
- configPaths.push(projectConfig);
47
- }
48
-
49
- // Extension paths (pi-specific)
50
- try {
51
- const piDir = join(homedir(), ".pi");
52
- if (existsSync(piDir)) {
53
- extensionPaths.push(piDir);
54
- }
55
- } catch {
56
- // Best effort
57
- }
58
-
59
- return {
60
- nodeVersion: process.version,
61
- piVersion: getPiVersion(),
62
- os: `${process.platform} ${process.arch}`,
63
- platform: process.platform,
64
- unipiModules,
65
- configPaths,
66
- extensionPaths,
67
- };
68
- }
69
-
70
- /** Format environment info as markdown */
71
- export function formatEnvironmentInfo(info: EnvironmentInfo): string {
72
- const lines = [
73
- "## 🖥️ Environment",
74
- "",
75
- `| Key | Value |`,
76
- `|-----|-------|`,
77
- `| Node.js | ${info.nodeVersion} |`,
78
- `| Pi | ${info.piVersion} |`,
79
- `| OS | ${info.os} |`,
80
- `| Platform | ${info.platform} |`,
81
- "",
82
- "### Unipi Modules",
83
- "",
84
- ];
85
-
86
- if (info.unipiModules.length === 0) {
87
- lines.push("*No @pi-unipi modules detected in node_modules.*");
88
- } else {
89
- for (const mod of info.unipiModules) {
90
- lines.push(`- ${mod}`);
91
- }
92
- }
93
-
94
- lines.push("", "### Config Paths", "");
95
- if (info.configPaths.length === 0) {
96
- lines.push("*No config paths found.*");
97
- } else {
98
- for (const path of info.configPaths) {
99
- lines.push(`- \`${path}\``);
100
- }
101
- }
102
-
103
- lines.push("", "### Extension Paths", "");
104
- if (info.extensionPaths.length === 0) {
105
- lines.push("*No extension paths found.*");
106
- } else {
107
- for (const path of info.extensionPaths) {
108
- lines.push(`- \`${path}\``);
109
- }
110
- }
111
-
112
- return lines.join("\n");
113
- }