@pugi/cli 0.1.0-beta.7 → 0.1.0-beta.87

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 (402) hide show
  1. package/CHANGELOG.md +96 -0
  2. package/THIRD_PARTY_NOTICES.md +40 -0
  3. package/assets/pugi-prozr2-mascot.ansi +9 -0
  4. package/bin/run.js +33 -1
  5. package/dist/commands/deploy.js +40 -40
  6. package/dist/commands/flatten.js +191 -0
  7. package/dist/commands/jobs-watch.js +201 -0
  8. package/dist/commands/jobs.js +42 -27
  9. package/dist/commands/smoke.js +133 -0
  10. package/dist/core/agent-progress/cleanup.js +134 -0
  11. package/dist/core/agent-progress/schema.js +144 -0
  12. package/dist/core/agent-progress/writer.js +101 -0
  13. package/dist/core/agents/adaptive-router.js +330 -0
  14. package/dist/core/agents/query-decomposer.js +297 -0
  15. package/dist/core/agents/registry.js +2 -2
  16. package/dist/core/approvals/shortcut-resolver.js +98 -0
  17. package/dist/core/artifact-chain/dispatcher.js +148 -0
  18. package/dist/core/artifact-chain/exporter.js +164 -0
  19. package/dist/core/artifact-chain/state.js +243 -0
  20. package/dist/core/artifact-chain/steps.js +169 -0
  21. package/dist/core/ask-user/question.js +92 -0
  22. package/dist/core/audit/audit-trail.js +275 -0
  23. package/dist/core/auth/ensure-authenticated.js +129 -0
  24. package/dist/core/auth/env-provider.js +238 -0
  25. package/dist/core/auto-open-browser.js +4 -4
  26. package/dist/core/auto-update/channels.js +122 -0
  27. package/dist/core/auto-update/checker.js +241 -0
  28. package/dist/core/auto-update/state.js +235 -0
  29. package/dist/core/bare-mode/index.js +107 -0
  30. package/dist/core/bash/redirect.js +281 -0
  31. package/dist/core/bash-classifier.js +436 -40
  32. package/dist/core/checkpoint/resumer.js +149 -0
  33. package/dist/core/checkpoint/rewinder.js +291 -0
  34. package/dist/core/checkpoints/shadow-git.js +670 -0
  35. package/dist/core/citations/parser.js +109 -0
  36. package/dist/core/classifier/yolo-classifier.js +88 -0
  37. package/dist/core/codegraph/decision-store.js +248 -0
  38. package/dist/core/codegraph/detect-repo.js +459 -0
  39. package/dist/core/codegraph/install.js +134 -0
  40. package/dist/core/codegraph/offer-hook.js +220 -0
  41. package/dist/core/compact/auto-trigger.js +96 -0
  42. package/dist/core/compact/buffer-rewriter.js +115 -0
  43. package/dist/core/compact/summarizer.js +208 -0
  44. package/dist/core/compact/token-counter.js +108 -0
  45. package/dist/core/consensus/anvil-fanout.js +25 -25
  46. package/dist/core/consensus/diff-capture.js +121 -12
  47. package/dist/core/consensus/rubric.js +21 -21
  48. package/dist/core/context/builder.js +6 -6
  49. package/dist/core/context/compaction-events.js +8 -8
  50. package/dist/core/context/compaction.js +31 -31
  51. package/dist/core/context/index.js +15 -8
  52. package/dist/core/context/invariants.js +51 -51
  53. package/dist/core/context/markdown-loader.js +28 -10
  54. package/dist/core/context/markdown-traverse.js +255 -0
  55. package/dist/core/context/pugiignore.js +41 -41
  56. package/dist/core/context/repo-skeleton.js +37 -37
  57. package/dist/core/context/tool-eviction.js +55 -0
  58. package/dist/core/context/watcher.js +32 -32
  59. package/dist/core/context/working-set.js +23 -23
  60. package/dist/core/coordinator/agent-tools.js +77 -0
  61. package/dist/core/coordinator/agent-toolset.js +65 -0
  62. package/dist/core/coordinator/fsm.js +73 -0
  63. package/dist/core/coordinator/mode-fsm.js +70 -0
  64. package/dist/core/cost/rate-card.js +129 -0
  65. package/dist/core/cost/tracker.js +221 -0
  66. package/dist/core/credentials.js +12 -12
  67. package/dist/core/cron/scheduler.js +138 -0
  68. package/dist/core/denial-tracking/index.js +8 -0
  69. package/dist/core/denial-tracking/state.js +264 -0
  70. package/dist/core/diagnostics/probe-runner.js +93 -0
  71. package/dist/core/diagnostics/probes/api.js +46 -0
  72. package/dist/core/diagnostics/probes/auth.js +93 -0
  73. package/dist/core/diagnostics/probes/bare-mode.js +42 -0
  74. package/dist/core/diagnostics/probes/cli-version.js +127 -0
  75. package/dist/core/diagnostics/probes/config.js +72 -0
  76. package/dist/core/diagnostics/probes/denial-tracking.js +57 -0
  77. package/dist/core/diagnostics/probes/disk.js +81 -0
  78. package/dist/core/diagnostics/probes/engine-live.js +46 -0
  79. package/dist/core/diagnostics/probes/git.js +65 -0
  80. package/dist/core/diagnostics/probes/hooks.js +118 -0
  81. package/dist/core/diagnostics/probes/mcp.js +75 -0
  82. package/dist/core/diagnostics/probes/node.js +59 -0
  83. package/dist/core/diagnostics/probes/pnpm.js +36 -0
  84. package/dist/core/diagnostics/probes/pugi-md.js +89 -0
  85. package/dist/core/diagnostics/probes/sandbox.js +40 -0
  86. package/dist/core/diagnostics/probes/session.js +74 -0
  87. package/dist/core/diagnostics/probes/status-snapshot.js +488 -0
  88. package/dist/core/diagnostics/probes/workspace.js +63 -0
  89. package/dist/core/diagnostics/types.js +70 -0
  90. package/dist/core/dispatch/cache-cleanup.js +197 -0
  91. package/dist/core/dispatch/cache-handoff.js +295 -0
  92. package/dist/core/edits/apply-patch-layer-e.js +189 -0
  93. package/dist/core/edits/dispatch.js +293 -7
  94. package/dist/core/edits/format-matrix.js +26 -0
  95. package/dist/core/edits/fuzzy-ladder.js +650 -0
  96. package/dist/core/edits/index.js +3 -1
  97. package/dist/core/edits/journal.js +199 -0
  98. package/dist/core/edits/layer-a-apply.js +15 -15
  99. package/dist/core/edits/layer-a-fuzzy-apply.js +198 -0
  100. package/dist/core/edits/layer-b-apply.js +9 -9
  101. package/dist/core/edits/layer-c-apply.js +6 -6
  102. package/dist/core/edits/layer-d-ast.js +557 -14
  103. package/dist/core/edits/marker-parser.js +12 -12
  104. package/dist/core/edits/security-gate.js +27 -27
  105. package/dist/core/edits/verify-hook.js +273 -0
  106. package/dist/core/edits/worktree.js +322 -0
  107. package/dist/core/engine/anvil-client.js +140 -26
  108. package/dist/core/engine/auto-compact.js +179 -0
  109. package/dist/core/engine/budgets.js +186 -0
  110. package/dist/core/engine/context-prefix.js +155 -0
  111. package/dist/core/engine/index.js +1 -1
  112. package/dist/core/engine/intensity.js +158 -0
  113. package/dist/core/engine/intent.js +260 -0
  114. package/dist/core/engine/native-pugi.js +1295 -227
  115. package/dist/core/engine/prompts.js +134 -16
  116. package/dist/core/engine/strip-internal-fields.js +124 -0
  117. package/dist/core/engine/tool-bridge.js +1295 -59
  118. package/dist/core/evaluation/golden-dataset.js +293 -0
  119. package/dist/core/feedback/queue.js +177 -0
  120. package/dist/core/feedback/submitter.js +145 -0
  121. package/dist/core/file-cache.js +113 -1
  122. package/dist/core/flatten/flatten-repo.js +439 -0
  123. package/dist/core/format/osc8-link.js +28 -0
  124. package/dist/core/hook-chains.js +392 -0
  125. package/dist/core/hooks/citation-verify-hook.js +138 -0
  126. package/dist/core/hooks/citation-verify.js +112 -0
  127. package/dist/core/hooks/events.js +44 -0
  128. package/dist/core/hooks/index.js +15 -0
  129. package/dist/core/hooks/registry.js +213 -0
  130. package/dist/core/hooks/runner.js +236 -0
  131. package/dist/core/hooks/v2/event-emitter.js +115 -0
  132. package/dist/core/hooks/v2/executor.js +282 -0
  133. package/dist/core/hooks/v2/index.js +25 -0
  134. package/dist/core/hooks/v2/lifecycle.js +104 -0
  135. package/dist/core/hooks/v2/loader.js +216 -0
  136. package/dist/core/hooks/v2/matcher.js +125 -0
  137. package/dist/core/hooks/v2/trust.js +143 -0
  138. package/dist/core/hooks/v2/types.js +86 -0
  139. package/dist/core/image/renderer.js +71 -0
  140. package/dist/core/init/detector.js +582 -0
  141. package/dist/core/init/template-renderer.js +242 -0
  142. package/dist/core/jobs/registry.js +18 -18
  143. package/dist/core/ledger/results-tsv.js +142 -0
  144. package/dist/core/log-discipline/stdout-redirect.js +51 -0
  145. package/dist/core/lsp/cache.js +105 -0
  146. package/dist/core/lsp/client.js +776 -0
  147. package/dist/core/lsp/language-detect.js +66 -0
  148. package/dist/core/lsp/post-edit-diagnostics.js +171 -0
  149. package/dist/core/lsp/symbol-tools.js +372 -0
  150. package/dist/core/mcp/client.js +97 -28
  151. package/dist/core/mcp/http-server.js +553 -0
  152. package/dist/core/mcp/orchestrator-tools.js +662 -0
  153. package/dist/core/mcp/permission.js +190 -0
  154. package/dist/core/mcp/registry.js +39 -17
  155. package/dist/core/mcp/server-tools.js +219 -0
  156. package/dist/core/mcp/server.js +397 -0
  157. package/dist/core/mcp/trust.js +10 -10
  158. package/dist/core/memory/dual-write.js +416 -0
  159. package/dist/core/memory/passive-extract.js +130 -0
  160. package/dist/core/memory/phase1-kinds.js +20 -0
  161. package/dist/core/memory/secret-scanner.js +304 -0
  162. package/dist/core/memory-sync/queue.js +170 -0
  163. package/dist/core/metrics/extract.js +113 -0
  164. package/dist/core/modes/roo-modes.js +68 -0
  165. package/dist/core/onboarding/ensure-initialized.js +133 -0
  166. package/dist/core/onboarding/marker.js +111 -0
  167. package/dist/core/onboarding/telemetry-state.js +108 -0
  168. package/dist/core/output-style/presets.js +176 -0
  169. package/dist/core/output-style/state.js +185 -0
  170. package/dist/core/path-security.js +287 -5
  171. package/dist/core/permission.js +82 -22
  172. package/dist/core/permissions/auto-classifier.js +124 -0
  173. package/dist/core/permissions/bash-parser.js +371 -0
  174. package/dist/core/permissions/circuit-breaker.js +83 -0
  175. package/dist/core/permissions/constrained-edit.js +91 -0
  176. package/dist/core/permissions/gate.js +278 -0
  177. package/dist/core/permissions/index.js +20 -0
  178. package/dist/core/permissions/mode.js +174 -0
  179. package/dist/core/permissions/network-egress.js +137 -0
  180. package/dist/core/permissions/state.js +241 -0
  181. package/dist/core/permissions/tool-class.js +93 -0
  182. package/dist/core/plan-mode/ui-state.js +51 -0
  183. package/dist/core/plans/plan-artifact.js +721 -0
  184. package/dist/core/policy-limits/etag-store.js +122 -0
  185. package/dist/core/prd-check/parser.js +215 -0
  186. package/dist/core/prd-check/reporter.js +127 -0
  187. package/dist/core/prd-check/session-review.js +557 -0
  188. package/dist/core/prd-check/verifiers.js +223 -0
  189. package/dist/core/prompt-cache/client-cache.js +99 -0
  190. package/dist/core/prompts/assembly.js +29 -0
  191. package/dist/core/prompts/registry.js +364 -0
  192. package/dist/core/pugi-md/cc-compat-rules.js +735 -0
  193. package/dist/core/pugi-md/context-injector.js +76 -0
  194. package/dist/core/pugi-md/walk-up.js +207 -0
  195. package/dist/core/python/uv-installer.js +270 -0
  196. package/dist/core/python/uv-resolver.js +83 -0
  197. package/dist/core/rate-limit/narrator.js +146 -0
  198. package/dist/core/recipes/cli-types.js +20 -0
  199. package/dist/core/recipes/loader.js +103 -0
  200. package/dist/core/recipes/runner.js +345 -0
  201. package/dist/core/recipes/schema.js +587 -0
  202. package/dist/core/release-notes/parser.js +241 -0
  203. package/dist/core/release-notes/state.js +116 -0
  204. package/dist/core/repl/ask.js +37 -37
  205. package/dist/core/repl/cancellation.js +26 -26
  206. package/dist/core/repl/cap-warning.js +4 -4
  207. package/dist/core/repl/clipboard-read.js +11 -11
  208. package/dist/core/repl/dispatch-fsm.js +12 -12
  209. package/dist/core/repl/history-search.js +15 -15
  210. package/dist/core/repl/history.js +28 -18
  211. package/dist/core/repl/kill-ring.js +5 -5
  212. package/dist/core/repl/model-pricing.js +135 -0
  213. package/dist/core/repl/privacy-banner.js +22 -22
  214. package/dist/core/repl/session.js +2157 -214
  215. package/dist/core/repl/slash-commands.js +533 -40
  216. package/dist/core/repl/store/index.js +1 -1
  217. package/dist/core/repl/store/jsonl-log.js +22 -22
  218. package/dist/core/repl/store/lockfile.js +10 -10
  219. package/dist/core/repl/store/session-store.js +136 -107
  220. package/dist/core/repl/store/types.js +15 -15
  221. package/dist/core/repl/store/uuid-v7.js +12 -12
  222. package/dist/core/repl/workspace-context.js +43 -21
  223. package/dist/core/repo-map/build.js +125 -0
  224. package/dist/core/repo-map/cache.js +185 -0
  225. package/dist/core/repo-map/extractor.js +254 -0
  226. package/dist/core/repo-map/formatter.js +145 -0
  227. package/dist/core/repo-map/page-rank.js +105 -0
  228. package/dist/core/repo-map/scanner.js +211 -0
  229. package/dist/core/retry-budget/budget.js +284 -0
  230. package/dist/core/retry-budget/index.js +5 -0
  231. package/dist/core/retry-budget/retry-cap.js +74 -0
  232. package/dist/core/routing/lead-worker.js +43 -0
  233. package/dist/core/routing/pre-flight-estimator.js +108 -0
  234. package/dist/core/runs/run-tree.js +103 -0
  235. package/dist/core/security/injection-scanner.js +367 -0
  236. package/dist/core/security/output-filter.js +418 -0
  237. package/dist/core/session/env-file.js +105 -0
  238. package/dist/core/session/section-budgets.js +140 -0
  239. package/dist/core/session.js +92 -0
  240. package/dist/core/settings.js +286 -5
  241. package/dist/core/share/formatter.js +271 -0
  242. package/dist/core/share/redactor.js +221 -0
  243. package/dist/core/share/uploader.js +267 -0
  244. package/dist/core/skills/defaults.js +457 -0
  245. package/dist/core/skills/loader.js +22 -22
  246. package/dist/core/skills/sources.js +27 -27
  247. package/dist/core/smoke/headless-driver.js +174 -0
  248. package/dist/core/smoke/orchestrator.js +194 -0
  249. package/dist/core/smoke/runner.js +238 -0
  250. package/dist/core/smoke/scenario-parser.js +316 -0
  251. package/dist/core/statusline.js +99 -0
  252. package/dist/core/subagents/dispatcher-real.js +600 -0
  253. package/dist/core/subagents/dispatcher.js +132 -43
  254. package/dist/core/subagents/index.js +19 -6
  255. package/dist/core/subagents/isolation-matrix.js +213 -0
  256. package/dist/core/subagents/spawn.js +19 -4
  257. package/dist/core/telemetry/emitter.js +229 -0
  258. package/dist/core/telemetry/queue.js +251 -0
  259. package/dist/core/theme/context.js +91 -0
  260. package/dist/core/theme/presets.js +228 -0
  261. package/dist/core/theme/state.js +181 -0
  262. package/dist/core/todos/invariant.js +10 -0
  263. package/dist/core/todos/state.js +177 -0
  264. package/dist/core/tool-schema/compressor.js +89 -0
  265. package/dist/core/transport/version-interceptor.js +166 -0
  266. package/dist/core/trust.js +2 -2
  267. package/dist/core/tui/thinking-block.js +64 -0
  268. package/dist/core/vim/keymap.js +288 -0
  269. package/dist/core/vim/state.js +92 -0
  270. package/dist/core/watch-markers/marker-watcher.js +133 -0
  271. package/dist/core/worktree-manager/cleanup.js +123 -0
  272. package/dist/core/worktree-manager/manager.js +303 -0
  273. package/dist/index.js +28 -0
  274. package/dist/runtime/bootstrap.js +190 -0
  275. package/dist/runtime/cli.js +4162 -488
  276. package/dist/runtime/commands/agents.js +30 -30
  277. package/dist/runtime/commands/budget.js +5 -5
  278. package/dist/runtime/commands/cancel.js +231 -0
  279. package/dist/runtime/commands/chain.js +489 -0
  280. package/dist/runtime/commands/codegraph-status.js +227 -0
  281. package/dist/runtime/commands/compact.js +297 -0
  282. package/dist/runtime/commands/config.js +32 -32
  283. package/dist/runtime/commands/cost.js +199 -0
  284. package/dist/runtime/commands/delegate.js +244 -13
  285. package/dist/runtime/commands/dispatch.js +126 -0
  286. package/dist/runtime/commands/doctor.js +579 -0
  287. package/dist/runtime/commands/feedback.js +184 -0
  288. package/dist/runtime/commands/hooks.js +184 -0
  289. package/dist/runtime/commands/init.js +254 -0
  290. package/dist/runtime/commands/lsp.js +368 -0
  291. package/dist/runtime/commands/mcp.js +879 -0
  292. package/dist/runtime/commands/memory.js +582 -0
  293. package/dist/runtime/commands/model.js +237 -0
  294. package/dist/runtime/commands/onboarding.js +275 -0
  295. package/dist/runtime/commands/patch.js +128 -0
  296. package/dist/runtime/commands/permissions.js +112 -0
  297. package/dist/runtime/commands/plan.js +143 -0
  298. package/dist/runtime/commands/prd-check.js +285 -0
  299. package/dist/runtime/commands/privacy.js +17 -17
  300. package/dist/runtime/commands/recipe.js +325 -0
  301. package/dist/runtime/commands/redo-blob-store.js +92 -0
  302. package/dist/runtime/commands/redo.js +361 -0
  303. package/dist/runtime/commands/release-notes.js +229 -0
  304. package/dist/runtime/commands/repo-map.js +95 -0
  305. package/dist/runtime/commands/report.js +299 -0
  306. package/dist/runtime/commands/resume.js +118 -0
  307. package/dist/runtime/commands/review-consensus.js +68 -53
  308. package/dist/runtime/commands/rewind.js +333 -0
  309. package/dist/runtime/commands/roster.js +14 -14
  310. package/dist/runtime/commands/sessions.js +163 -0
  311. package/dist/runtime/commands/share.js +316 -0
  312. package/dist/runtime/commands/skills.js +31 -31
  313. package/dist/runtime/commands/status.js +186 -0
  314. package/dist/runtime/commands/stickers.js +82 -0
  315. package/dist/runtime/commands/style.js +194 -0
  316. package/dist/runtime/commands/theme.js +196 -0
  317. package/dist/runtime/commands/undo.js +54 -22
  318. package/dist/runtime/commands/update.js +289 -0
  319. package/dist/runtime/commands/vim.js +140 -0
  320. package/dist/runtime/commands/worktree.js +177 -0
  321. package/dist/runtime/commands/worktrees.js +155 -0
  322. package/dist/runtime/headless-repl.js +195 -0
  323. package/dist/runtime/headless.js +543 -0
  324. package/dist/runtime/load-hooks-or-exit.js +71 -0
  325. package/dist/runtime/plan-decompose.js +531 -0
  326. package/dist/runtime/update-check.js +28 -28
  327. package/dist/runtime/version.js +65 -0
  328. package/dist/skills/bundled/batch.js +617 -0
  329. package/dist/skills/bundled/index.js +45 -0
  330. package/dist/skills/bundled/loop.js +358 -0
  331. package/dist/skills/bundled/remember.js +383 -0
  332. package/dist/skills/bundled/simplify.js +289 -0
  333. package/dist/skills/bundled/skillify.js +373 -0
  334. package/dist/skills/bundled/stuck.js +558 -0
  335. package/dist/skills/bundled/verify.js +439 -0
  336. package/dist/testing/vcr.js +486 -0
  337. package/dist/tools/agent-tool.js +229 -0
  338. package/dist/tools/apply-patch.js +556 -0
  339. package/dist/tools/ask-user-question.js +222 -0
  340. package/dist/tools/ask-user.js +115 -0
  341. package/dist/tools/bash.js +623 -45
  342. package/dist/tools/brief.js +224 -0
  343. package/dist/tools/enter-worktree.js +250 -0
  344. package/dist/tools/exit-worktree.js +147 -0
  345. package/dist/tools/file-tools.js +161 -44
  346. package/dist/tools/lsp-tools.js +189 -0
  347. package/dist/tools/mcp-tool.js +260 -0
  348. package/dist/tools/multi-edit.js +361 -0
  349. package/dist/tools/powershell.js +268 -0
  350. package/dist/tools/registry.js +85 -0
  351. package/dist/tools/skill-tool.js +96 -0
  352. package/dist/tools/sleep.js +99 -0
  353. package/dist/tools/synthetic-output.js +133 -0
  354. package/dist/tools/tasks.js +208 -0
  355. package/dist/tools/todo-write.js +184 -0
  356. package/dist/tools/verify-plan-execution.js +295 -0
  357. package/dist/tools/web-fetch-injection-scanner.js +207 -0
  358. package/dist/tools/web-fetch.js +195 -10
  359. package/dist/tools/web-search.js +458 -0
  360. package/dist/tui/agent-progress-card.js +111 -0
  361. package/dist/tui/agent-tree.js +11 -1
  362. package/dist/tui/ask-modal.js +14 -14
  363. package/dist/tui/ask-user-question-prompt.js +203 -0
  364. package/dist/tui/compact-banner.js +81 -0
  365. package/dist/tui/conversation-pane.js +85 -11
  366. package/dist/tui/cost-table.js +111 -0
  367. package/dist/tui/device-flow.js +2 -2
  368. package/dist/tui/doctor-table.js +46 -0
  369. package/dist/tui/feedback-prompt.js +156 -0
  370. package/dist/tui/input-box.js +247 -32
  371. package/dist/tui/login-picker.js +3 -3
  372. package/dist/tui/markdown-render.js +6 -6
  373. package/dist/tui/onboarding-wizard.js +240 -0
  374. package/dist/tui/permissions-picker.js +86 -0
  375. package/dist/tui/render.js +35 -0
  376. package/dist/tui/repl-render.js +332 -54
  377. package/dist/tui/repl-splash-art.js +16 -16
  378. package/dist/tui/repl-splash-mascot.js +48 -24
  379. package/dist/tui/repl-splash.js +22 -22
  380. package/dist/tui/repl.js +124 -44
  381. package/dist/tui/slash-palette.js +6 -6
  382. package/dist/tui/splash.js +2 -2
  383. package/dist/tui/status-bar.js +109 -31
  384. package/dist/tui/status-table.js +7 -0
  385. package/dist/tui/stickers-art.js +136 -0
  386. package/dist/tui/style-table.js +28 -0
  387. package/dist/tui/theme-table.js +29 -0
  388. package/dist/tui/thinking-spinner.js +123 -0
  389. package/dist/tui/tool-stream-pane.js +53 -4
  390. package/dist/tui/update-banner.js +27 -2
  391. package/dist/tui/vim-input.js +267 -0
  392. package/dist/tui/welcome-banner.js +107 -0
  393. package/dist/tui/welcome-data.js +293 -0
  394. package/dist/tui/workspace-context.js +2 -2
  395. package/docs/examples/codegraph.mcp.json +10 -0
  396. package/package.json +23 -6
  397. package/test/scenarios/codegen-create-file.scenario.txt +13 -0
  398. package/test/scenarios/compact-force.scenario.txt +11 -0
  399. package/test/scenarios/identity.scenario.txt +11 -0
  400. package/test/scenarios/persona-handoff.scenario.txt +11 -0
  401. package/test/scenarios/walkback.scenario.txt +12 -0
  402. package/dist/core/engine/compaction-hook.js +0 -154
@@ -0,0 +1,293 @@
1
+ /**
2
+ * Golden dataset primitive — pugi-eval-v1 foundation (task).
3
+ *
4
+ * Formalizes a frozen set of representative CLI tasks that we replay
5
+ * against the agent loop to detect quality regressions. This module is
6
+ * the pure data layer:
7
+ *
8
+ * 1. `GoldenTask` — typed contract for one evaluation case (id, query,
9
+ * expected file touches, expected output substrings, exit-code
10
+ * gate, soft budgets, tags).
11
+ * 2. `loadGoldenDataset(path)` — reads a JSON file from disk, asserts
12
+ * it is a non-empty array, and runs `validateGoldenTask` on every
13
+ * element. Throws on the first malformed entry so the eval harness
14
+ * cannot silently drop a task.
15
+ * 3. `validateGoldenTask(raw)` — schema validator. Enforces kebab-case
16
+ * ids, non-empty query, optional arrays whose elements are
17
+ * well-formed, and rejects parent-traversal `..` segments inside
18
+ * `expectedFiles`. Throws `TypeError` with a specific field message.
19
+ * 4. `diffAgainstBaseline(current, baseline)` — turns two `TaskResult`
20
+ * maps into a `DriftReport` that lists regressed / improved / new /
21
+ * removed tasks. A regression is a task that PASSED in baseline and
22
+ * FAILED in current; an improvement is the inverse. The report is
23
+ * what the future CI gate consumes — a positive `regressed.length`
24
+ * blocks the merge.
25
+ *
26
+ * Out of scope here: actually running tasks against the engine. The
27
+ * follow-up `runOfflineEval()` consumer reads a dataset via
28
+ * `loadGoldenDataset`, executes each task through `pugi code/explain/
29
+ * plan/fix/build`, collects pass/fail/latency/tokens into a
30
+ * `TaskResult[]`, and feeds the previous run's results into
31
+ * `diffAgainstBaseline` for the drift gate.
32
+ *
33
+ * Pure functions only. No file I/O beyond `fs/promises.readFile` inside
34
+ * `loadGoldenDataset` so the module composes cleanly with in-memory test
35
+ * fixtures and engine-side consumers that already hold dataset bytes.
36
+ */
37
+ import { readFile } from 'node:fs/promises';
38
+ const ID_PATTERN = /^[a-z][a-z0-9-]*$/;
39
+ /**
40
+ * Validate one raw value as a `GoldenTask`. Throws `TypeError` with a
41
+ * field-specific message on any violation. Returns the typed task on
42
+ * success.
43
+ *
44
+ * The validator is intentionally hand-rolled — the shape is small, and
45
+ * adding zod here would obscure the per-field error contract that the
46
+ * eval harness logs at load time.
47
+ */
48
+ export function validateGoldenTask(raw) {
49
+ if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
50
+ throw new TypeError('golden task must be a JSON object');
51
+ }
52
+ const r = raw;
53
+ // id — required, kebab-case.
54
+ if (typeof r.id !== 'string' || r.id.length === 0) {
55
+ throw new TypeError('golden task: `id` required (non-empty string)');
56
+ }
57
+ if (!ID_PATTERN.test(r.id)) {
58
+ throw new TypeError(`golden task ${JSON.stringify(r.id)}: \`id\` must match ${ID_PATTERN.source} (kebab-case, leading letter)`);
59
+ }
60
+ const id = r.id;
61
+ // query — required.
62
+ if (typeof r.query !== 'string' || r.query.length === 0) {
63
+ throw new TypeError(`golden task ${id}: \`query\` required (non-empty string)`);
64
+ }
65
+ const query = r.query;
66
+ // expectedFiles — optional, when present must be non-empty array of
67
+ // relative paths without traversal.
68
+ let expectedFiles;
69
+ if (r.expectedFiles !== undefined) {
70
+ if (!Array.isArray(r.expectedFiles)) {
71
+ throw new TypeError(`golden task ${id}: \`expectedFiles\` must be an array`);
72
+ }
73
+ if (r.expectedFiles.length === 0) {
74
+ throw new TypeError(`golden task ${id}: \`expectedFiles\` must be non-empty (omit field instead of passing [])`);
75
+ }
76
+ expectedFiles = r.expectedFiles.map((entry, idx) => {
77
+ if (typeof entry !== 'string' || entry.length === 0) {
78
+ throw new TypeError(`golden task ${id}: \`expectedFiles[${idx}]\` must be a non-empty string`);
79
+ }
80
+ if (entry.startsWith('/')) {
81
+ throw new TypeError(`golden task ${id}: \`expectedFiles[${idx}]\` must be relative (no leading /)`);
82
+ }
83
+ const segments = entry.split('/');
84
+ if (segments.some((s) => s === '..')) {
85
+ throw new TypeError(`golden task ${id}: \`expectedFiles[${idx}]\` contains \`..\` traversal`);
86
+ }
87
+ return entry;
88
+ });
89
+ }
90
+ // expectedSubstrings — optional array of non-empty strings.
91
+ let expectedSubstrings;
92
+ if (r.expectedSubstrings !== undefined) {
93
+ if (!Array.isArray(r.expectedSubstrings)) {
94
+ throw new TypeError(`golden task ${id}: \`expectedSubstrings\` must be an array`);
95
+ }
96
+ if (r.expectedSubstrings.length === 0) {
97
+ throw new TypeError(`golden task ${id}: \`expectedSubstrings\` must be non-empty (omit field instead of passing [])`);
98
+ }
99
+ expectedSubstrings = r.expectedSubstrings.map((entry, idx) => {
100
+ if (typeof entry !== 'string' || entry.length === 0) {
101
+ throw new TypeError(`golden task ${id}: \`expectedSubstrings[${idx}]\` must be a non-empty string`);
102
+ }
103
+ return entry;
104
+ });
105
+ }
106
+ // expectedExitCode — optional integer.
107
+ let expectedExitCode;
108
+ if (r.expectedExitCode !== undefined) {
109
+ if (typeof r.expectedExitCode !== 'number' ||
110
+ !Number.isInteger(r.expectedExitCode)) {
111
+ throw new TypeError(`golden task ${id}: \`expectedExitCode\` must be an integer`);
112
+ }
113
+ expectedExitCode = r.expectedExitCode;
114
+ }
115
+ // maxTokens — optional positive integer.
116
+ let maxTokens;
117
+ if (r.maxTokens !== undefined) {
118
+ if (typeof r.maxTokens !== 'number' ||
119
+ !Number.isInteger(r.maxTokens) ||
120
+ r.maxTokens <= 0) {
121
+ throw new TypeError(`golden task ${id}: \`maxTokens\` must be a positive integer`);
122
+ }
123
+ maxTokens = r.maxTokens;
124
+ }
125
+ // maxLatencyMs — optional positive integer.
126
+ let maxLatencyMs;
127
+ if (r.maxLatencyMs !== undefined) {
128
+ if (typeof r.maxLatencyMs !== 'number' ||
129
+ !Number.isInteger(r.maxLatencyMs) ||
130
+ r.maxLatencyMs <= 0) {
131
+ throw new TypeError(`golden task ${id}: \`maxLatencyMs\` must be a positive integer`);
132
+ }
133
+ maxLatencyMs = r.maxLatencyMs;
134
+ }
135
+ // tags — optional array of non-empty strings.
136
+ let tags;
137
+ if (r.tags !== undefined) {
138
+ if (!Array.isArray(r.tags)) {
139
+ throw new TypeError(`golden task ${id}: \`tags\` must be an array`);
140
+ }
141
+ tags = r.tags.map((entry, idx) => {
142
+ if (typeof entry !== 'string' || entry.length === 0) {
143
+ throw new TypeError(`golden task ${id}: \`tags[${idx}]\` must be a non-empty string`);
144
+ }
145
+ return entry;
146
+ });
147
+ }
148
+ const task = { id, query };
149
+ if (expectedFiles !== undefined)
150
+ task.expectedFiles = expectedFiles;
151
+ if (expectedSubstrings !== undefined)
152
+ task.expectedSubstrings = expectedSubstrings;
153
+ if (expectedExitCode !== undefined)
154
+ task.expectedExitCode = expectedExitCode;
155
+ if (maxTokens !== undefined)
156
+ task.maxTokens = maxTokens;
157
+ if (maxLatencyMs !== undefined)
158
+ task.maxLatencyMs = maxLatencyMs;
159
+ if (tags !== undefined)
160
+ task.tags = tags;
161
+ return task;
162
+ }
163
+ /**
164
+ * Load and validate a golden dataset JSON file. The file must parse as
165
+ * a JSON array of objects, each one a valid `GoldenTask`. Duplicate
166
+ * ids are rejected — drift comparisons key by id and a duplicate would
167
+ * silently mask one row.
168
+ */
169
+ export async function loadGoldenDataset(filePath) {
170
+ let raw;
171
+ try {
172
+ raw = await readFile(filePath, 'utf8');
173
+ }
174
+ catch (err) {
175
+ const message = err instanceof Error ? err.message : String(err);
176
+ throw new TypeError(`golden dataset: cannot read ${filePath}: ${message}`);
177
+ }
178
+ let parsed;
179
+ try {
180
+ parsed = JSON.parse(raw);
181
+ }
182
+ catch (err) {
183
+ const message = err instanceof Error ? err.message : String(err);
184
+ throw new TypeError(`golden dataset ${filePath}: invalid JSON (${message})`);
185
+ }
186
+ if (!Array.isArray(parsed)) {
187
+ throw new TypeError(`golden dataset ${filePath}: top-level value must be a JSON array`);
188
+ }
189
+ const tasks = [];
190
+ const seen = new Set();
191
+ for (let i = 0; i < parsed.length; i += 1) {
192
+ let task;
193
+ try {
194
+ task = validateGoldenTask(parsed[i]);
195
+ }
196
+ catch (err) {
197
+ const message = err instanceof Error ? err.message : String(err);
198
+ throw new TypeError(`golden dataset ${filePath}: entry [${i}]: ${message}`);
199
+ }
200
+ if (seen.has(task.id)) {
201
+ throw new TypeError(`golden dataset ${filePath}: duplicate task id ${JSON.stringify(task.id)} at entry [${i}]`);
202
+ }
203
+ seen.add(task.id);
204
+ tasks.push(task);
205
+ }
206
+ return tasks;
207
+ }
208
+ /**
209
+ * Compare a current run against a baseline run and return a drift
210
+ * report. Pure function — no I/O, no clock, deterministic ordering
211
+ * (regressed/improved sorted by id).
212
+ *
213
+ * Either input may be empty. An empty baseline produces an
214
+ * all-newTasks report without crashing — useful for the very first
215
+ * eval run when no previous artifact exists yet.
216
+ */
217
+ export function diffAgainstBaseline(currentResults, baselineResults, options) {
218
+ const includeReason = options?.includeReason ?? true;
219
+ const currentById = new Map();
220
+ for (const r of currentResults) {
221
+ if (typeof r.id !== 'string' || r.id.length === 0)
222
+ continue;
223
+ currentById.set(r.id, r);
224
+ }
225
+ const baselineById = new Map();
226
+ for (const r of baselineResults) {
227
+ if (typeof r.id !== 'string' || r.id.length === 0)
228
+ continue;
229
+ baselineById.set(r.id, r);
230
+ }
231
+ const regressed = [];
232
+ const improved = [];
233
+ const newTasks = [];
234
+ const removedTasks = [];
235
+ for (const [id, currentRow] of currentById) {
236
+ const baselineRow = baselineById.get(id);
237
+ if (!baselineRow) {
238
+ newTasks.push(id);
239
+ continue;
240
+ }
241
+ if (baselineRow.passed && !currentRow.passed) {
242
+ const diff = {
243
+ id,
244
+ baselinePassed: true,
245
+ currentPassed: false,
246
+ };
247
+ if (includeReason && currentRow.reason !== undefined) {
248
+ diff.reason = currentRow.reason;
249
+ }
250
+ regressed.push(diff);
251
+ }
252
+ else if (!baselineRow.passed && currentRow.passed) {
253
+ const diff = {
254
+ id,
255
+ baselinePassed: false,
256
+ currentPassed: true,
257
+ };
258
+ if (includeReason && currentRow.reason !== undefined) {
259
+ diff.reason = currentRow.reason;
260
+ }
261
+ improved.push(diff);
262
+ }
263
+ }
264
+ for (const id of baselineById.keys()) {
265
+ if (!currentById.has(id)) {
266
+ removedTasks.push(id);
267
+ }
268
+ }
269
+ regressed.sort((a, b) => a.id.localeCompare(b.id));
270
+ improved.sort((a, b) => a.id.localeCompare(b.id));
271
+ newTasks.sort();
272
+ removedTasks.sort();
273
+ let passedNow = 0;
274
+ for (const r of currentById.values()) {
275
+ if (r.passed)
276
+ passedNow += 1;
277
+ }
278
+ let passedBaseline = 0;
279
+ for (const r of baselineById.values()) {
280
+ if (r.passed)
281
+ passedBaseline += 1;
282
+ }
283
+ return {
284
+ totalTasks: currentById.size,
285
+ passedNow,
286
+ passedBaseline,
287
+ regressed,
288
+ improved,
289
+ newTasks,
290
+ removedTasks,
291
+ };
292
+ }
293
+ //# sourceMappingURL=golden-dataset.js.map
@@ -0,0 +1,177 @@
1
+ /**
2
+ * Local feedback queue — .
3
+ *
4
+ * `pugi feedback` POSTs collected operator feedback to the admin-api
5
+ * `/api/pugi/feedback` route. When that round-trip fails (endpoint
6
+ * missing, network down, server 5xx), the submitter falls back to
7
+ * appending the envelope to `<cwd>/.pugi/feedback-queue.jsonl`. On the
8
+ * next online session the flusher drains the queue silently in the
9
+ * background.
10
+ *
11
+ * # Module contract
12
+ *
13
+ * - Per-workspace storage. The queue file lives at
14
+ * `<cwd>/.pugi/feedback-queue.jsonl` so the operator-visible state
15
+ * stays alongside the project's other Pugi metadata. Multi-repo
16
+ * operators get one queue per repo — matches the rest of `.pugi/`.
17
+ *
18
+ * - JSONL append-only format. One envelope per line. Newlines inside
19
+ * the comment field are escaped as `\n` by `JSON.stringify`. The
20
+ * enqueue path uses an atomic `O_APPEND` write so concurrent
21
+ * `pugi feedback` invocations from a split-screen REPL + shell do
22
+ * not interleave half-records.
23
+ *
24
+ * - The flusher is best-effort. It returns counts but never throws —
25
+ * a failed flush leaves the queue untouched and a successful flush
26
+ * atomically rewrites the file with the remaining (unsubmitted)
27
+ * envelopes. Partial-success is the normal path when the server
28
+ * accepts the first N but 5xx's the (N+1)th.
29
+ *
30
+ * - The queue file is intentionally NOT readable by anything beyond
31
+ * the flusher. The operator's free-text comments are confidential
32
+ * — we do not surface them in `/status` / `/doctor` / telemetry.
33
+ *
34
+ * - All filesystem writes go through `mkdirSync({recursive: true})`
35
+ * so the first-ever enqueue on a fresh workspace lazily creates
36
+ * `.pugi/` without depending on an earlier `pugi init`.
37
+ */
38
+ import { appendFileSync, existsSync, mkdirSync, readFileSync, renameSync, writeFileSync, } from 'node:fs';
39
+ import { dirname, resolve } from 'node:path';
40
+ /**
41
+ * Resolve the queue file path for a workspace. Centralised so the
42
+ * submitter + flusher + tests agree on a single canonical location.
43
+ */
44
+ export function feedbackQueuePath(cwd) {
45
+ return resolve(cwd, '.pugi', 'feedback-queue.jsonl');
46
+ }
47
+ /**
48
+ * Append one envelope atomically. Uses `O_APPEND` semantics via
49
+ * `appendFileSync` so concurrent invocations from a split-screen
50
+ * REPL + shell cannot interleave bytes mid-line.
51
+ *
52
+ * Returns the absolute path written so callers can surface it in the
53
+ * "Feedback queued locally" toast.
54
+ */
55
+ export function enqueueFeedback(env, cwd) {
56
+ const path = feedbackQueuePath(cwd);
57
+ mkdirSync(dirname(path), { recursive: true });
58
+ // JSON.stringify of an object never emits raw newlines; the trailing
59
+ // '\n' is the line separator. JSONL parsers split on '\n' so the
60
+ // separator survives round-trips.
61
+ const line = `${JSON.stringify(env)}\n`;
62
+ appendFileSync(path, line, { encoding: 'utf8' });
63
+ return path;
64
+ }
65
+ export function readFeedbackQueue(cwd) {
66
+ const path = feedbackQueuePath(cwd);
67
+ if (!existsSync(path)) {
68
+ return { envelopes: [], parseErrors: [] };
69
+ }
70
+ const contents = readFileSync(path, 'utf8');
71
+ const lines = contents.split('\n');
72
+ const envelopes = [];
73
+ const parseErrors = [];
74
+ for (let i = 0; i < lines.length; i += 1) {
75
+ const raw = lines[i]?.trim();
76
+ if (!raw)
77
+ continue;
78
+ try {
79
+ const parsed = JSON.parse(raw);
80
+ // Minimal shape check — we don't full-validate here because the
81
+ // server is the trust boundary. Just guard against obvious
82
+ // corruption that would make the line un-submittable.
83
+ if (typeof parsed.category === 'string'
84
+ && typeof parsed.rating === 'number'
85
+ && typeof parsed.comment === 'string'
86
+ && typeof parsed.ts === 'string'
87
+ && typeof parsed.cliVersion === 'string') {
88
+ envelopes.push(parsed);
89
+ }
90
+ else {
91
+ parseErrors.push(i + 1);
92
+ }
93
+ }
94
+ catch {
95
+ parseErrors.push(i + 1);
96
+ }
97
+ }
98
+ return { envelopes, parseErrors };
99
+ }
100
+ /**
101
+ * Rewrite the queue file atomically with the remaining (unsubmitted)
102
+ * envelopes. Called by the flusher after a partial-success drain.
103
+ *
104
+ * Atomicity: write to a sibling `.tmp` then rename. On a crash mid-
105
+ * rewrite the original file is preserved (rename is atomic on POSIX
106
+ * + on NTFS via `MoveFileEx`).
107
+ */
108
+ export function rewriteFeedbackQueue(remaining, cwd) {
109
+ const path = feedbackQueuePath(cwd);
110
+ if (remaining.length === 0) {
111
+ // Clear the file by truncating to empty. Done in-place — we still
112
+ // want the file to exist (presence signals an active workspace)
113
+ // but with zero bytes so the next read returns no envelopes.
114
+ if (existsSync(path)) {
115
+ writeFileSync(path, '', { encoding: 'utf8' });
116
+ }
117
+ return;
118
+ }
119
+ mkdirSync(dirname(path), { recursive: true });
120
+ const tmp = `${path}.tmp`;
121
+ const body = remaining.map((env) => JSON.stringify(env)).join('\n') + '\n';
122
+ writeFileSync(tmp, body, { encoding: 'utf8' });
123
+ // Use writeFileSync's atomic-replace semantics by going through
124
+ // tmp + rename. Node's `fs.renameSync` is the atomic primitive
125
+ // on POSIX. We avoid `fs.writeFileSync` directly on `path`
126
+ // because writeFileSync truncates first which leaves a brief
127
+ // window of zero-byte state if the process is killed mid-write.
128
+ renameSync(tmp, path);
129
+ }
130
+ /**
131
+ * Drain the queue. Best-effort: each envelope is submitted in order;
132
+ * a `false` return keeps it in the queue for the next attempt; a
133
+ * `true` return removes it. After all envelopes are processed the
134
+ * queue file is rewritten with the unsubmitted ones.
135
+ *
136
+ * The function NEVER throws — it returns a structured result and
137
+ * the caller decides whether to log / surface failures. This keeps
138
+ * the silent-background-drain path on session-start safe.
139
+ */
140
+ export async function flushFeedbackQueue(cwd, submit) {
141
+ const { envelopes, parseErrors } = readFeedbackQueue(cwd);
142
+ if (envelopes.length === 0) {
143
+ return {
144
+ attempted: 0,
145
+ succeeded: 0,
146
+ failed: 0,
147
+ failedEnvelopes: [],
148
+ parseErrors,
149
+ };
150
+ }
151
+ let succeeded = 0;
152
+ const failedEnvelopes = [];
153
+ for (const env of envelopes) {
154
+ let ok = false;
155
+ try {
156
+ ok = await submit(env);
157
+ }
158
+ catch {
159
+ ok = false;
160
+ }
161
+ if (ok) {
162
+ succeeded += 1;
163
+ }
164
+ else {
165
+ failedEnvelopes.push(env);
166
+ }
167
+ }
168
+ rewriteFeedbackQueue(failedEnvelopes, cwd);
169
+ return {
170
+ attempted: envelopes.length,
171
+ succeeded,
172
+ failed: failedEnvelopes.length,
173
+ failedEnvelopes,
174
+ parseErrors,
175
+ };
176
+ }
177
+ //# sourceMappingURL=queue.js.map
@@ -0,0 +1,145 @@
1
+ /**
2
+ * Feedback POST submitter — .
3
+ *
4
+ * Submits one `FeedbackEnvelope` to the admin-api `/api/pugi/feedback`
5
+ * route. Designed for graceful degradation:
6
+ *
7
+ * - 200/201/204 → success
8
+ * - 404 / route not found → "endpoint missing, fall back to queue"
9
+ * - 4xx (other) → permanent — discard (do NOT requeue)
10
+ * - 5xx / network error / abort → transient — caller should enqueue
11
+ *
12
+ * The submitter does NOT touch the local queue. The caller wires the
13
+ * submitter to `enqueueFeedback` on a `transient` result, and to a
14
+ * silent log on a `permanent` failure. This split keeps the submitter
15
+ * a pure HTTP wrapper that the flusher (`flushFeedbackQueue`) can
16
+ * reuse without filesystem side effects.
17
+ */
18
+ const DEFAULT_TIMEOUT_MS = 8000;
19
+ /**
20
+ * Build the absolute submit URL from the base API URL. Centralised so
21
+ * the spec can reference one canonical place when asserting the
22
+ * outgoing path. The leading slash is normalised so a base URL with
23
+ * or without trailing slash both produce a well-formed URL.
24
+ */
25
+ export function feedbackSubmitUrl(apiUrl) {
26
+ const base = apiUrl.replace(/\/+$/u, '');
27
+ return `${base}/api/pugi/feedback`;
28
+ }
29
+ /**
30
+ * Submit one envelope. See `FeedbackSubmitResult` for the contract.
31
+ *
32
+ * Never throws — every failure path is mapped to a result variant so
33
+ * callers do not need a try/catch boundary.
34
+ */
35
+ export async function submitFeedback(env, config) {
36
+ const url = feedbackSubmitUrl(config.apiUrl);
37
+ const fetchImpl = config.fetchImpl ?? fetch;
38
+ const timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
39
+ const controller = new AbortController();
40
+ const timer = setTimeout(() => controller.abort(), timeoutMs);
41
+ try {
42
+ const headers = {
43
+ 'content-type': 'application/json',
44
+ 'user-agent': `pugi-cli/${env.cliVersion}`,
45
+ };
46
+ if (config.apiKey) {
47
+ headers['authorization'] = `Bearer ${config.apiKey}`;
48
+ }
49
+ const res = await fetchImpl(url, {
50
+ method: 'POST',
51
+ headers,
52
+ body: JSON.stringify(env),
53
+ signal: controller.signal,
54
+ });
55
+ const status = res.status;
56
+ if (status >= 200 && status < 300) {
57
+ return { kind: 'ok', httpStatus: status };
58
+ }
59
+ if (status === 404) {
60
+ // The most common transient cause: admin-api hasn't shipped the
61
+ // route yet. Treat as retry-worthy so once the controller lands
62
+ // a future flush picks it up.
63
+ return {
64
+ kind: 'transient',
65
+ reason: 'admin-api /api/pugi/feedback not deployed yet',
66
+ httpStatus: status,
67
+ };
68
+ }
69
+ if (status >= 500) {
70
+ return {
71
+ kind: 'transient',
72
+ reason: `server error ${status}`,
73
+ httpStatus: status,
74
+ };
75
+ }
76
+ // Any other 4xx — auth failure, payload rejected, rate-limit
77
+ // exceeded. None of those will fix themselves on a silent retry,
78
+ // so we mark them permanent. The operator sees a one-line error
79
+ // and the envelope is dropped (not queued).
80
+ return {
81
+ kind: 'permanent',
82
+ reason: `client error ${status}`,
83
+ httpStatus: status,
84
+ };
85
+ }
86
+ catch (err) {
87
+ const message = err instanceof Error ? err.message : String(err);
88
+ // AbortController.abort fires when the timeout elapses. We treat
89
+ // it as transient so the queue picks it up on the next online
90
+ // session. Same for plain network errors (`fetch failed`, ECONNREFUSED).
91
+ return { kind: 'transient', reason: `network: ${message}` };
92
+ }
93
+ finally {
94
+ clearTimeout(timer);
95
+ }
96
+ }
97
+ /**
98
+ * Bundle the last N turns of the conversation into a redacted
99
+ * `FeedbackSessionContext`. The redactor:
100
+ *
101
+ * - Caps at 5 turns (most recent). Older context is dropped — the
102
+ * submitter never sees it.
103
+ * - Truncates each turn to 240 chars + ellipsis. Operator comments
104
+ * are the primary signal; raw transcript is just disambiguation.
105
+ * - Strips bearer tokens, JWT-like blobs, and `PUGI_API_KEY=`-style
106
+ * env-var prefixes. Conservative — we'd rather drop a few
107
+ * non-secret characters than leak a key.
108
+ *
109
+ * The function is pure + sync so tests can pin its output without a
110
+ * worktree harness.
111
+ */
112
+ export function redactSessionContext(turns, options = {}) {
113
+ const lastFive = turns.slice(-5);
114
+ const previewed = lastFive.map((turn) => ({
115
+ role: turn.role,
116
+ preview: redactPreview(truncate(turn.text, 240)),
117
+ }));
118
+ return {
119
+ turnCount: previewed.length,
120
+ turns: previewed,
121
+ ...(options.gitBranch ? { gitBranch: options.gitBranch } : {}),
122
+ };
123
+ }
124
+ function truncate(s, max) {
125
+ if (s.length <= max)
126
+ return s;
127
+ return `${s.slice(0, max - 1)}…`;
128
+ }
129
+ /**
130
+ * Conservative secret-blanking. The rules:
131
+ * - Bearer tokens: `Bearer <token>` → `Bearer ***REDACTED***`
132
+ * - Long base64/JWT-ish blobs (≥ 40 chars of [A-Za-z0-9_-/=+]):
133
+ * replace the inner middle with `***`. Keeps a head + tail so the
134
+ * operator can still spot which kind of secret it was.
135
+ * - `PUGI_API_KEY=...` and similar `*_KEY=`/`*_TOKEN=` lookalikes:
136
+ * replace the value with `***REDACTED***`.
137
+ */
138
+ function redactPreview(s) {
139
+ let out = s;
140
+ out = out.replace(/bearer\s+[A-Za-z0-9._-]{20,}/giu, 'Bearer ***REDACTED***');
141
+ out = out.replace(/([A-Z][A-Z0-9_]*?(?:KEY|TOKEN|SECRET|PASSWORD))\s*=\s*\S+/gu, '$1=***REDACTED***');
142
+ out = out.replace(/\b([A-Za-z0-9_-]{6})[A-Za-z0-9_/+=-]{30,}([A-Za-z0-9_-]{4})\b/gu, '$1***$2');
143
+ return out;
144
+ }
145
+ //# sourceMappingURL=submitter.js.map