dsh-pstack 0.1.0 → 0.2.0-beta.1

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 (312) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +92 -117
  3. package/assets/agents/comment-sicko.md +1 -1
  4. package/assets/agents/poteto-agent.md +2 -2
  5. package/assets/docs/guide/01-setup.md +9 -9
  6. package/assets/docs/guide/02-poteto-mode.md +4 -4
  7. package/assets/docs/guide/05-build-and-clean.md +3 -3
  8. package/assets/docs/guide/06-verify-and-ship.md +2 -2
  9. package/assets/docs/guide/07-overnight.md +10 -12
  10. package/assets/docs/guide/09-make-it-yours.md +2 -6
  11. package/assets/docs/guide/10-recipes-and-pitfalls.md +3 -3
  12. package/assets/docs/guide/README.md +1 -1
  13. package/assets/docs/guide/images/design.jpg +0 -0
  14. package/assets/docs/guide/images/overnight.jpg +0 -0
  15. package/assets/docs/guide/images/recipes.jpg +0 -0
  16. package/assets/docs/guide/images/router.jpg +0 -0
  17. package/assets/docs/guide/images/understanding.jpg +0 -0
  18. package/assets/docs/guide/images/verification.jpg +0 -0
  19. package/assets/docs/harness/dsh.md +60 -65
  20. package/assets/docs/pstack-models.example.md +40 -9
  21. package/assets/skills/architect/SKILL.md +12 -12
  22. package/assets/skills/arena/SKILL.md +11 -11
  23. package/assets/skills/automate-me/SKILL.md +15 -14
  24. package/assets/skills/benchmark-checklist/SKILL.md +0 -2
  25. package/assets/skills/blast-radius/SKILL.md +5 -5
  26. package/assets/skills/bro/SKILL.md +0 -2
  27. package/assets/skills/correct/SKILL.md +0 -2
  28. package/assets/skills/create-formal-verification-skill/SKILL.md +2 -2
  29. package/assets/skills/create-verification-skill/SKILL.md +2 -2
  30. package/assets/skills/figure-it-out/SKILL.md +13 -13
  31. package/assets/skills/how/SKILL.md +6 -6
  32. package/assets/skills/how/references/explainer-prompt.md +1 -1
  33. package/assets/skills/in-your-own-words/SKILL.md +0 -2
  34. package/assets/skills/interrogate/SKILL.md +9 -7
  35. package/assets/skills/interrogate/references/rubric.md +1 -1
  36. package/assets/skills/ketchup/SKILL.md +4 -4
  37. package/assets/skills/maintain-formal-verification-skill/SKILL.md +2 -2
  38. package/assets/skills/maintain-verification-skill/SKILL.md +3 -3
  39. package/assets/skills/no-comments/SKILL.md +7 -7
  40. package/assets/skills/poteto-help/SKILL.md +32 -31
  41. package/assets/skills/poteto-help/references/prompting.md +1 -1
  42. package/assets/skills/poteto-help/references/recipes.md +1 -1
  43. package/assets/skills/poteto-mode/SKILL.md +17 -19
  44. package/assets/skills/poteto-mode/playbooks/authoring-a-skill.md +3 -3
  45. package/assets/skills/poteto-mode/playbooks/autonomous-run.md +6 -4
  46. package/assets/skills/poteto-mode/playbooks/autopilot-full.md +6 -6
  47. package/assets/skills/poteto-mode/playbooks/autopilot-stack.md +2 -2
  48. package/assets/skills/poteto-mode/playbooks/babysit.md +3 -3
  49. package/assets/skills/poteto-mode/playbooks/bug-fix.md +7 -7
  50. package/assets/skills/poteto-mode/playbooks/eval.md +3 -3
  51. package/assets/skills/poteto-mode/playbooks/feature.md +8 -8
  52. package/assets/skills/poteto-mode/playbooks/hillclimb.md +3 -3
  53. package/assets/skills/poteto-mode/playbooks/investigation.md +2 -2
  54. package/assets/skills/poteto-mode/playbooks/multi-phase-plan.md +21 -21
  55. package/assets/skills/poteto-mode/playbooks/opening-a-pr.md +6 -6
  56. package/assets/skills/poteto-mode/playbooks/orchestrate.md +13 -13
  57. package/assets/skills/poteto-mode/playbooks/pause-safely.md +2 -2
  58. package/assets/skills/poteto-mode/playbooks/perf-issue.md +6 -6
  59. package/assets/skills/poteto-mode/playbooks/prototype.md +4 -4
  60. package/assets/skills/poteto-mode/playbooks/refactoring.md +9 -9
  61. package/assets/skills/poteto-mode/playbooks/runtime-forensics.md +3 -3
  62. package/assets/skills/poteto-mode/playbooks/session-pickup.md +2 -2
  63. package/assets/skills/poteto-mode/playbooks/shipping.md +2 -2
  64. package/assets/skills/poteto-mode/playbooks/trace-forensics.md +2 -2
  65. package/assets/skills/poteto-mode/playbooks/visual-parity.md +5 -5
  66. package/assets/skills/poteto-mode/playbooks/worktree-cleanup.md +14 -6
  67. package/assets/skills/poteto-mode/scripts/check-plan.mjs +85 -70
  68. package/assets/skills/poteto-mode/scripts/check-plan.test.mjs +343 -0
  69. package/assets/skills/poteto-mode/scripts/orch/orch.mjs +4282 -0
  70. package/assets/skills/poteto-mode/scripts/orch/orch.test.mjs +2042 -0
  71. package/assets/skills/poteto-mode/scripts/watch-pr/cli.test.mjs +5101 -0
  72. package/assets/skills/poteto-mode/scripts/watch-pr/github.test.mjs +1177 -0
  73. package/assets/skills/poteto-mode/scripts/watch-pr/policy.test.mjs +1441 -0
  74. package/assets/skills/poteto-mode/scripts/watch-pr/watch-pr.mjs +4601 -0
  75. package/assets/skills/poteto-mode/scripts/worktree-audit.mjs +675 -0
  76. package/assets/skills/principle-attack-the-premise/SKILL.md +0 -2
  77. package/assets/skills/principle-boundary-discipline/SKILL.md +0 -2
  78. package/assets/skills/principle-build-the-lever/SKILL.md +0 -3
  79. package/assets/skills/principle-encode-lessons-in-structure/SKILL.md +0 -2
  80. package/assets/skills/principle-exhaust-the-design-space/SKILL.md +0 -2
  81. package/assets/skills/principle-experience-first/SKILL.md +0 -2
  82. package/assets/skills/principle-explain-the-number/SKILL.md +0 -2
  83. package/assets/skills/principle-fix-root-causes/SKILL.md +0 -2
  84. package/assets/skills/principle-foundational-thinking/SKILL.md +0 -2
  85. package/assets/skills/principle-guard-the-context-window/SKILL.md +0 -2
  86. package/assets/skills/principle-laziness-protocol/SKILL.md +0 -2
  87. package/assets/skills/principle-make-operations-idempotent/SKILL.md +0 -2
  88. package/assets/skills/principle-migrate-callers-then-delete-legacy-apis/SKILL.md +0 -2
  89. package/assets/skills/principle-minimize-reader-load/SKILL.md +0 -2
  90. package/assets/skills/principle-model-the-domain/SKILL.md +0 -2
  91. package/assets/skills/principle-never-block-on-the-human/SKILL.md +0 -2
  92. package/assets/skills/principle-outcome-oriented-execution/SKILL.md +0 -2
  93. package/assets/skills/principle-prove-it-works/SKILL.md +2 -2
  94. package/assets/skills/principle-redesign-from-first-principles/SKILL.md +0 -2
  95. package/assets/skills/principle-separate-before-serializing-shared-state/SKILL.md +0 -2
  96. package/assets/skills/principle-sequence-verifiable-units/SKILL.md +0 -2
  97. package/assets/skills/principle-subtract-before-you-add/SKILL.md +0 -2
  98. package/assets/skills/principle-test-behavior-not-implementation/SKILL.md +0 -2
  99. package/assets/skills/principle-type-system-discipline/SKILL.md +0 -2
  100. package/assets/skills/recall/SKILL.md +9 -9
  101. package/assets/skills/reflect/SKILL.md +20 -21
  102. package/assets/skills/reflect/references/divergent-reviewer.md +4 -4
  103. package/assets/skills/reflect/references/judgment-reviewer.md +2 -2
  104. package/assets/skills/reflect/references/synthesizer.md +6 -6
  105. package/assets/skills/reflect/references/tooling-reviewer.md +2 -2
  106. package/assets/skills/setup-pstack/SKILL.md +28 -37
  107. package/assets/skills/sharpen/SKILL.md +0 -2
  108. package/assets/skills/show-me-your-work/SKILL.md +9 -9
  109. package/assets/skills/show-me-your-work/scripts/log.mjs +108 -0
  110. package/assets/skills/swarm/SKILL.md +8 -6
  111. package/assets/skills/tdd/SKILL.md +0 -2
  112. package/assets/skills/teach/SKILL.md +2 -2
  113. package/assets/skills/technical-writing/SKILL.md +2 -2
  114. package/assets/skills/typescript-best-practices/SKILL.md +6 -4
  115. package/assets/skills/unslop/SKILL.md +0 -2
  116. package/assets/skills/why/SKILL.md +9 -9
  117. package/cordis.patch.yml +33 -14
  118. package/dist/frontmatter-BQX3ekwP.mjs +229 -0
  119. package/dist/frontmatter-BQX3ekwP.mjs.map +1 -0
  120. package/dist/history.d.mts +429 -0
  121. package/dist/history.mjs +1129 -0
  122. package/dist/history.mjs.map +1 -0
  123. package/dist/host-contract-o47JH_r8.d.mts +527 -0
  124. package/dist/index.d.mts +273 -11
  125. package/dist/index.mjs +248 -148
  126. package/dist/index.mjs.map +1 -1
  127. package/dist/paths-D_JlVmBk.mjs +42 -0
  128. package/dist/paths-D_JlVmBk.mjs.map +1 -0
  129. package/dist/script.d.mts +193 -0
  130. package/dist/script.mjs +782 -0
  131. package/dist/script.mjs.map +1 -0
  132. package/dist/subagent.d.mts +306 -100
  133. package/dist/subagent.mjs +1309 -343
  134. package/dist/subagent.mjs.map +1 -1
  135. package/locale/en.json +6 -0
  136. package/locale/zh.json +6 -0
  137. package/package.json +55 -41
  138. package/static/icon.png +0 -0
  139. package/assets/skills/poteto-mode/scripts/bootstrap.ts +0 -62
  140. package/assets/skills/poteto-mode/scripts/bun.lock +0 -67
  141. package/assets/skills/poteto-mode/scripts/check-plan.test.ts +0 -96
  142. package/assets/skills/poteto-mode/scripts/orch/orch.test.ts +0 -761
  143. package/assets/skills/poteto-mode/scripts/orch/orch.ts +0 -590
  144. package/assets/skills/poteto-mode/scripts/orch/store.ts +0 -1677
  145. package/assets/skills/poteto-mode/scripts/package.json +0 -16
  146. package/assets/skills/poteto-mode/scripts/watch-pr/cli.test.ts +0 -224
  147. package/assets/skills/poteto-mode/scripts/watch-pr/cli.ts +0 -223
  148. package/assets/skills/poteto-mode/scripts/watch-pr/fakes.test-helper.ts +0 -129
  149. package/assets/skills/poteto-mode/scripts/watch-pr/github.test.ts +0 -436
  150. package/assets/skills/poteto-mode/scripts/watch-pr/github.ts +0 -718
  151. package/assets/skills/poteto-mode/scripts/watch-pr/policy.test.ts +0 -420
  152. package/assets/skills/poteto-mode/scripts/watch-pr/policy.ts +0 -836
  153. package/assets/skills/poteto-mode/scripts/watch-pr/render.ts +0 -169
  154. package/assets/skills/poteto-mode/scripts/watch-pr/tsconfig.json +0 -13
  155. package/assets/skills/poteto-mode/scripts/watch-pr/types.compile.ts +0 -93
  156. package/assets/skills/poteto-mode/scripts/watch-pr/types.ts +0 -413
  157. package/assets/skills/poteto-mode/scripts/watch-pr/watch-pr +0 -6
  158. package/assets/skills/poteto-mode/scripts/worktree-audit.sh +0 -127
  159. package/assets/skills/show-me-your-work/scripts/log.sh +0 -42
  160. package/dist/LICENSE +0 -22
  161. package/dist/README.md +0 -159
  162. package/dist/assets/agents/comment-sicko.md +0 -32
  163. package/dist/assets/agents/poteto-agent.md +0 -8
  164. package/dist/assets/docs/guide/01-setup.md +0 -64
  165. package/dist/assets/docs/guide/02-poteto-mode.md +0 -139
  166. package/dist/assets/docs/guide/03-understand.md +0 -79
  167. package/dist/assets/docs/guide/04-design.md +0 -133
  168. package/dist/assets/docs/guide/05-build-and-clean.md +0 -83
  169. package/dist/assets/docs/guide/06-verify-and-ship.md +0 -152
  170. package/dist/assets/docs/guide/07-overnight.md +0 -122
  171. package/dist/assets/docs/guide/08-principles.md +0 -72
  172. package/dist/assets/docs/guide/09-make-it-yours.md +0 -100
  173. package/dist/assets/docs/guide/10-recipes-and-pitfalls.md +0 -180
  174. package/dist/assets/docs/guide/README.md +0 -38
  175. package/dist/assets/docs/harness/dsh.md +0 -65
  176. package/dist/assets/docs/pstack-models.example.md +0 -23
  177. package/dist/assets/skills/architect/SKILL.md +0 -81
  178. package/dist/assets/skills/architect/references/design-red-flags.md +0 -57
  179. package/dist/assets/skills/architect/references/rationale-template.md +0 -35
  180. package/dist/assets/skills/architect/references/runner-prompt.md +0 -20
  181. package/dist/assets/skills/arena/SKILL.md +0 -50
  182. package/dist/assets/skills/automate-me/SKILL.md +0 -105
  183. package/dist/assets/skills/benchmark-checklist/SKILL.md +0 -41
  184. package/dist/assets/skills/blast-radius/SKILL.md +0 -52
  185. package/dist/assets/skills/bro/SKILL.md +0 -9
  186. package/dist/assets/skills/correct/SKILL.md +0 -34
  187. package/dist/assets/skills/create-formal-verification-skill/SKILL.md +0 -43
  188. package/dist/assets/skills/create-verification-skill/SKILL.md +0 -46
  189. package/dist/assets/skills/create-verification-skill/references/feature-map-example/README.md +0 -47
  190. package/dist/assets/skills/create-verification-skill/references/feature-map-example/create-note.md +0 -39
  191. package/dist/assets/skills/create-verification-skill/references/feature-map-example/search.md +0 -45
  192. package/dist/assets/skills/figure-it-out/SKILL.md +0 -54
  193. package/dist/assets/skills/how/SKILL.md +0 -38
  194. package/dist/assets/skills/how/references/explainer-prompt.md +0 -55
  195. package/dist/assets/skills/how/references/explorer-prompt.md +0 -35
  196. package/dist/assets/skills/in-your-own-words/SKILL.md +0 -9
  197. package/dist/assets/skills/interrogate/SKILL.md +0 -69
  198. package/dist/assets/skills/interrogate/references/code-quality-review.md +0 -47
  199. package/dist/assets/skills/interrogate/references/lead-judgment.md +0 -39
  200. package/dist/assets/skills/interrogate/references/reviewer-prompt.md +0 -62
  201. package/dist/assets/skills/interrogate/references/rubric.md +0 -77
  202. package/dist/assets/skills/ketchup/SKILL.md +0 -45
  203. package/dist/assets/skills/maintain-formal-verification-skill/SKILL.md +0 -60
  204. package/dist/assets/skills/maintain-verification-skill/SKILL.md +0 -41
  205. package/dist/assets/skills/no-comments/SKILL.md +0 -26
  206. package/dist/assets/skills/poteto-help/SKILL.md +0 -161
  207. package/dist/assets/skills/poteto-help/references/prompting.md +0 -51
  208. package/dist/assets/skills/poteto-help/references/recipes.md +0 -51
  209. package/dist/assets/skills/poteto-mode/SKILL.md +0 -153
  210. package/dist/assets/skills/poteto-mode/playbooks/authoring-a-skill.md +0 -12
  211. package/dist/assets/skills/poteto-mode/playbooks/autonomous-run.md +0 -13
  212. package/dist/assets/skills/poteto-mode/playbooks/autopilot-full.md +0 -25
  213. package/dist/assets/skills/poteto-mode/playbooks/autopilot-stack.md +0 -12
  214. package/dist/assets/skills/poteto-mode/playbooks/babysit.md +0 -23
  215. package/dist/assets/skills/poteto-mode/playbooks/bug-fix.md +0 -15
  216. package/dist/assets/skills/poteto-mode/playbooks/eval.md +0 -25
  217. package/dist/assets/skills/poteto-mode/playbooks/feature.md +0 -21
  218. package/dist/assets/skills/poteto-mode/playbooks/hillclimb.md +0 -21
  219. package/dist/assets/skills/poteto-mode/playbooks/investigation.md +0 -14
  220. package/dist/assets/skills/poteto-mode/playbooks/multi-phase-plan.md +0 -155
  221. package/dist/assets/skills/poteto-mode/playbooks/opening-a-pr.md +0 -34
  222. package/dist/assets/skills/poteto-mode/playbooks/orchestrate.md +0 -112
  223. package/dist/assets/skills/poteto-mode/playbooks/pause-safely.md +0 -10
  224. package/dist/assets/skills/poteto-mode/playbooks/perf-issue.md +0 -25
  225. package/dist/assets/skills/poteto-mode/playbooks/prototype.md +0 -14
  226. package/dist/assets/skills/poteto-mode/playbooks/refactoring.md +0 -16
  227. package/dist/assets/skills/poteto-mode/playbooks/runtime-forensics.md +0 -11
  228. package/dist/assets/skills/poteto-mode/playbooks/session-pickup.md +0 -11
  229. package/dist/assets/skills/poteto-mode/playbooks/shipping.md +0 -12
  230. package/dist/assets/skills/poteto-mode/playbooks/trace-forensics.md +0 -14
  231. package/dist/assets/skills/poteto-mode/playbooks/visual-parity.md +0 -11
  232. package/dist/assets/skills/poteto-mode/playbooks/worktree-cleanup.md +0 -12
  233. package/dist/assets/skills/poteto-mode/references/bugbot-triage.md +0 -142
  234. package/dist/assets/skills/poteto-mode/scripts/bootstrap.ts +0 -62
  235. package/dist/assets/skills/poteto-mode/scripts/bun.lock +0 -67
  236. package/dist/assets/skills/poteto-mode/scripts/check-plan.mjs +0 -205
  237. package/dist/assets/skills/poteto-mode/scripts/check-plan.test.ts +0 -96
  238. package/dist/assets/skills/poteto-mode/scripts/orch/orch.test.ts +0 -761
  239. package/dist/assets/skills/poteto-mode/scripts/orch/orch.ts +0 -590
  240. package/dist/assets/skills/poteto-mode/scripts/orch/store.ts +0 -1677
  241. package/dist/assets/skills/poteto-mode/scripts/package.json +0 -16
  242. package/dist/assets/skills/poteto-mode/scripts/watch-pr/cli.test.ts +0 -224
  243. package/dist/assets/skills/poteto-mode/scripts/watch-pr/cli.ts +0 -223
  244. package/dist/assets/skills/poteto-mode/scripts/watch-pr/fakes.test-helper.ts +0 -129
  245. package/dist/assets/skills/poteto-mode/scripts/watch-pr/github.test.ts +0 -436
  246. package/dist/assets/skills/poteto-mode/scripts/watch-pr/github.ts +0 -718
  247. package/dist/assets/skills/poteto-mode/scripts/watch-pr/policy.test.ts +0 -420
  248. package/dist/assets/skills/poteto-mode/scripts/watch-pr/policy.ts +0 -836
  249. package/dist/assets/skills/poteto-mode/scripts/watch-pr/render.ts +0 -169
  250. package/dist/assets/skills/poteto-mode/scripts/watch-pr/tsconfig.json +0 -13
  251. package/dist/assets/skills/poteto-mode/scripts/watch-pr/types.compile.ts +0 -93
  252. package/dist/assets/skills/poteto-mode/scripts/watch-pr/types.ts +0 -413
  253. package/dist/assets/skills/poteto-mode/scripts/watch-pr/watch-pr +0 -6
  254. package/dist/assets/skills/poteto-mode/scripts/worktree-audit.sh +0 -127
  255. package/dist/assets/skills/principle-attack-the-premise/SKILL.md +0 -23
  256. package/dist/assets/skills/principle-boundary-discipline/SKILL.md +0 -36
  257. package/dist/assets/skills/principle-build-the-lever/SKILL.md +0 -26
  258. package/dist/assets/skills/principle-encode-lessons-in-structure/SKILL.md +0 -13
  259. package/dist/assets/skills/principle-exhaust-the-design-space/SKILL.md +0 -11
  260. package/dist/assets/skills/principle-experience-first/SKILL.md +0 -21
  261. package/dist/assets/skills/principle-explain-the-number/SKILL.md +0 -19
  262. package/dist/assets/skills/principle-fix-root-causes/SKILL.md +0 -23
  263. package/dist/assets/skills/principle-foundational-thinking/SKILL.md +0 -23
  264. package/dist/assets/skills/principle-guard-the-context-window/SKILL.md +0 -14
  265. package/dist/assets/skills/principle-laziness-protocol/SKILL.md +0 -12
  266. package/dist/assets/skills/principle-make-operations-idempotent/SKILL.md +0 -24
  267. package/dist/assets/skills/principle-migrate-callers-then-delete-legacy-apis/SKILL.md +0 -16
  268. package/dist/assets/skills/principle-minimize-reader-load/SKILL.md +0 -20
  269. package/dist/assets/skills/principle-model-the-domain/SKILL.md +0 -26
  270. package/dist/assets/skills/principle-never-block-on-the-human/SKILL.md +0 -17
  271. package/dist/assets/skills/principle-outcome-oriented-execution/SKILL.md +0 -23
  272. package/dist/assets/skills/principle-prove-it-works/SKILL.md +0 -24
  273. package/dist/assets/skills/principle-redesign-from-first-principles/SKILL.md +0 -18
  274. package/dist/assets/skills/principle-separate-before-serializing-shared-state/SKILL.md +0 -18
  275. package/dist/assets/skills/principle-sequence-verifiable-units/SKILL.md +0 -19
  276. package/dist/assets/skills/principle-subtract-before-you-add/SKILL.md +0 -20
  277. package/dist/assets/skills/principle-test-behavior-not-implementation/SKILL.md +0 -22
  278. package/dist/assets/skills/principle-type-system-discipline/SKILL.md +0 -15
  279. package/dist/assets/skills/recall/SKILL.md +0 -37
  280. package/dist/assets/skills/reflect/SKILL.md +0 -70
  281. package/dist/assets/skills/reflect/references/divergent-reviewer.md +0 -38
  282. package/dist/assets/skills/reflect/references/judgment-reviewer.md +0 -37
  283. package/dist/assets/skills/reflect/references/synthesizer.md +0 -56
  284. package/dist/assets/skills/reflect/references/tooling-reviewer.md +0 -48
  285. package/dist/assets/skills/setup-pstack/SKILL.md +0 -76
  286. package/dist/assets/skills/sharpen/SKILL.md +0 -18
  287. package/dist/assets/skills/show-me-your-work/SKILL.md +0 -84
  288. package/dist/assets/skills/show-me-your-work/references/decision-log-template.tsv +0 -1
  289. package/dist/assets/skills/show-me-your-work/scripts/log.sh +0 -42
  290. package/dist/assets/skills/swarm/SKILL.md +0 -41
  291. package/dist/assets/skills/tdd/SKILL.md +0 -44
  292. package/dist/assets/skills/teach/SKILL.md +0 -23
  293. package/dist/assets/skills/technical-writing/SKILL.md +0 -108
  294. package/dist/assets/skills/typescript-best-practices/SKILL.md +0 -32
  295. package/dist/assets/skills/typescript-best-practices/references/patterns.md +0 -328
  296. package/dist/assets/skills/unslop/SKILL.md +0 -64
  297. package/dist/assets/skills/why/SKILL.md +0 -100
  298. package/dist/assets/skills/why/references/epistemics.md +0 -71
  299. package/dist/assets/skills/why/references/investigator-prompt.md +0 -84
  300. package/dist/assets/skills/why/references/source-playbook.md +0 -17
  301. package/dist/assets/skills/why/references/sources/code-archaeology.md +0 -51
  302. package/dist/assets/skills/why/references/sources/databricks.md +0 -70
  303. package/dist/assets/skills/why/references/sources/datadog.md +0 -97
  304. package/dist/assets/skills/why/references/sources/incident-postmortem.md +0 -5
  305. package/dist/assets/skills/why/references/sources/linear.md +0 -48
  306. package/dist/assets/skills/why/references/sources/notion.md +0 -55
  307. package/dist/assets/skills/why/references/sources/sentry.md +0 -66
  308. package/dist/assets/skills/why/references/sources/slack.md +0 -17
  309. package/dist/assets/skills/why/references/synthesizer-prompt.md +0 -129
  310. package/dist/cordis.patch.yml +0 -20
  311. package/dist/paths-Bbai4CaT.mjs +0 -16
  312. package/dist/paths-Bbai4CaT.mjs.map +0 -1
@@ -1,436 +0,0 @@
1
- import { describe, expect, it } from "bun:test";
2
- import {
3
- ChecksUnavailable,
4
- WatcherQueryError,
5
- buildReviewThreads,
6
- mapRollupNode,
7
- orderStack,
8
- parseFastCheck,
9
- parsePullRequest,
10
- parseReviewThreadPage,
11
- resolveChecks,
12
- resolveContext,
13
- resolveReviewThreads,
14
- } from "./github.ts";
15
- import {
16
- fakeReader,
17
- failedCheck,
18
- passingCheck,
19
- pendingCheck,
20
- } from "./fakes.test-helper.ts";
21
- import { parsePrNumber } from "./types.ts";
22
-
23
- const context = {
24
- owner: "owner",
25
- repo: "repo",
26
- number: parsePrNumber(42),
27
- };
28
-
29
- describe("checks fallback chain", () => {
30
- it("uses a non-empty fast-path result without a rollup query", async () => {
31
- const reader = fakeReader({
32
- fastPath: { kind: "checks", checks: [passingCheck("fast")] },
33
- });
34
- const read = await resolveChecks(reader, context);
35
- expect(read.source).toBe("gh-pr-checks");
36
- expect(read.checks.map((check) => check.name)).toEqual(["fast"]);
37
- expect(reader.calls).toEqual(["checksFastPath"]);
38
- });
39
-
40
- it("paginates GraphQL when the fast path is unusable", async () => {
41
- const reader = fakeReader({
42
- fastPath: { kind: "unusable", exitCode: 8, stderr: "" },
43
- rollupPages: [
44
- { checks: [passingCheck("first")], endCursor: "next" },
45
- { checks: [failedCheck("second")], endCursor: null },
46
- ],
47
- });
48
- const read = await resolveChecks(reader, context);
49
- expect(read.source).toBe("graphql-rollup");
50
- expect(read.checks.map((check) => check.name)).toEqual(["first", "second"]);
51
- expect(reader.calls).toEqual([
52
- "checksFastPath",
53
- "checkRollupPage:null",
54
- "checkRollupPage:next",
55
- ]);
56
- });
57
-
58
- it("falls back when valid fast-path JSON represented an empty list", async () => {
59
- const reader = fakeReader({
60
- fastPath: { kind: "checks", checks: [] },
61
- rollupPages: [{ checks: [pendingCheck("fallback")], endCursor: null }],
62
- });
63
- expect((await resolveChecks(reader, context)).checks[0].name).toBe(
64
- "fallback"
65
- );
66
- expect(reader.calls).toEqual(["checksFastPath", "checkRollupPage:null"]);
67
- });
68
-
69
- it("fails closed when both paths are empty", async () => {
70
- const reader = fakeReader({
71
- fastPath: {
72
- kind: "unusable",
73
- exitCode: 8,
74
- stderr: "credential cannot read checks",
75
- },
76
- });
77
- await expect(resolveChecks(reader, context)).rejects.toBeInstanceOf(
78
- ChecksUnavailable
79
- );
80
- expect(reader.calls).toEqual(["checksFastPath", "checkRollupPage:null"]);
81
- });
82
- });
83
-
84
- describe("rollup node mapping", () => {
85
- it("maps terminal and non-terminal CheckRun states fail closed", () => {
86
- const cases = [
87
- ["IN_PROGRESS", null, "pending", "PENDING"],
88
- ["COMPLETED", "SUCCESS", "passed", "SUCCESS"],
89
- ["COMPLETED", "NEUTRAL", "skipped", "NEUTRAL"],
90
- ["COMPLETED", "SKIPPED", "skipped", "SKIPPED"],
91
- ["COMPLETED", "ACTION_REQUIRED", "failed", "ACTION_REQUIRED"],
92
- ["COMPLETED", "TIMED_OUT", "failed", "FAILURE"],
93
- ["COMPLETED", "FUTURE_VALUE", "failed", "FAILURE"],
94
- ] as const;
95
- for (const [status, conclusion, kind, reportedState] of cases) {
96
- expect(
97
- mapRollupNode({
98
- __typename: "CheckRun",
99
- name: "ci",
100
- status,
101
- conclusion,
102
- })
103
- ).toMatchObject({ kind, reportedState });
104
- }
105
- });
106
-
107
- it("classifies an in-progress Code Review Gate from the rollup as the gate", () => {
108
- expect(
109
- mapRollupNode({
110
- __typename: "CheckRun",
111
- name: "Code Review Gate",
112
- status: "IN_PROGRESS",
113
- conclusion: null,
114
- })
115
- ).toMatchObject({ kind: "code-review-gate" });
116
- expect(
117
- mapRollupNode({
118
- __typename: "StatusContext",
119
- context: "Code Review Gate",
120
- state: "PENDING",
121
- })
122
- ).toMatchObject({ kind: "code-review-gate" });
123
- });
124
-
125
- it("classifies a Code Review Gate waiting on an owner approval as the gate", () => {
126
- expect(
127
- mapRollupNode({
128
- __typename: "CheckRun",
129
- name: "Code Review Gate",
130
- status: "COMPLETED",
131
- conclusion: "ACTION_REQUIRED",
132
- description: "1 of 2 policies",
133
- })
134
- ).toMatchObject({
135
- kind: "code-review-gate",
136
- reportedState: "ACTION_REQUIRED",
137
- });
138
- });
139
-
140
- it("classifies a fast-path Code Review Gate waiting on an owner approval as the gate", () => {
141
- expect(
142
- parseFastCheck({
143
- name: "Code Review Gate",
144
- state: "ACTION_REQUIRED",
145
- bucket: "fail",
146
- })
147
- ).toMatchObject({
148
- kind: "code-review-gate",
149
- reportedState: "ACTION_REQUIRED",
150
- });
151
- expect(
152
- parseFastCheck({ name: "ci", state: "ACTION_REQUIRED", bucket: "fail" })
153
- ).toMatchObject({ kind: "failed", reportedState: "ACTION_REQUIRED" });
154
- });
155
-
156
- it("maps StatusContext states and drops unknown typenames", () => {
157
- expect(
158
- mapRollupNode({
159
- __typename: "StatusContext",
160
- context: "ci",
161
- state: "EXPECTED",
162
- })
163
- ).toMatchObject({ kind: "pending", reportedState: "PENDING" });
164
- expect(
165
- mapRollupNode({
166
- __typename: "StatusContext",
167
- context: "ci",
168
- state: "FUTURE_VALUE",
169
- })
170
- ).toMatchObject({ kind: "failed", reportedState: "FUTURE_VALUE" });
171
- expect(mapRollupNode({ __typename: "FutureNode" })).toBeNull();
172
- });
173
- });
174
-
175
- describe("closed enum parsing", () => {
176
- const rawPullRequest = {
177
- mergeable: "MERGEABLE",
178
- mergeStateStatus: "CLEAN",
179
- reviewDecision: "APPROVED",
180
- headRefOid: "head",
181
- headRefName: "feature",
182
- baseRefName: "main",
183
- state: "OPEN",
184
- mergedAt: null,
185
- isDraft: false,
186
- };
187
-
188
- it("accepts mergeStateStatus CONFLICTING", () => {
189
- expect(
190
- parsePullRequest(
191
- { ...rawPullRequest, mergeStateStatus: "CONFLICTING" },
192
- context
193
- ).mergeStateStatus
194
- ).toBe("CONFLICTING");
195
- });
196
-
197
- it("reads gh's empty reviewDecision as no decision rather than a parse failure", () => {
198
- expect(
199
- parsePullRequest({ ...rawPullRequest, reviewDecision: "" }, context)
200
- .reviewDecision
201
- ).toBeNull();
202
- });
203
-
204
- it("still rejects an unknown reviewDecision", () => {
205
- expect(() =>
206
- parsePullRequest({ ...rawPullRequest, reviewDecision: "MAYBE" }, context)
207
- ).toThrow(WatcherQueryError);
208
- });
209
-
210
- it("rejects unknown enum values as retryable errors carrying the raw value", () => {
211
- try {
212
- parsePullRequest(
213
- { ...rawPullRequest, mergeStateStatus: "FUTURE_STATE" },
214
- context
215
- );
216
- throw new Error("expected parser to throw");
217
- } catch (error) {
218
- expect(error).toBeInstanceOf(WatcherQueryError);
219
- if (!(error instanceof WatcherQueryError)) throw error;
220
- expect(error.failure).toMatchObject({
221
- kind: "missing-key",
222
- retryable: true,
223
- rawValue: '"FUTURE_STATE"',
224
- });
225
- }
226
- });
227
- });
228
-
229
- it("annotates Bugbot threads with distinct review-pass counts", () => {
230
- const response = {
231
- data: {
232
- repository: {
233
- pullRequest: {
234
- reviewThreads: {
235
- pageInfo: { hasNextPage: false, endCursor: null },
236
- nodes: [
237
- {
238
- id: "one",
239
- isResolved: false,
240
- comments: {
241
- nodes: [
242
- {
243
- body: "RUN_ID: run-1",
244
- createdAt: "now",
245
- path: "a.ts",
246
- line: 1,
247
- author: { login: "bugbot" },
248
- },
249
- ],
250
- },
251
- },
252
- {
253
- id: "two",
254
- isResolved: false,
255
- comments: {
256
- nodes: [
257
- {
258
- body: "CURSOR_AUTOMATION_ID: run-2 severity high",
259
- createdAt: "now",
260
- path: null,
261
- line: null,
262
- author: { login: "cursor" },
263
- },
264
- ],
265
- },
266
- },
267
- {
268
- id: "resolved",
269
- isResolved: true,
270
- comments: {
271
- nodes: [
272
- {
273
- body: "RUN_ID: run-3",
274
- createdAt: "now",
275
- path: null,
276
- line: null,
277
- author: { login: "bugbot" },
278
- },
279
- ],
280
- },
281
- },
282
- ],
283
- },
284
- },
285
- },
286
- },
287
- };
288
- const threads = buildReviewThreads(parseReviewThreadPage(response).threads);
289
- expect(threads).toHaveLength(2);
290
- expect(threads.map((thread) => thread.isBugbot)).toEqual([true, true]);
291
- expect(threads.map((thread) => thread.bugbotReviewPasses)).toEqual([3, 3]);
292
- });
293
-
294
- describe("review thread pagination", () => {
295
- const thread = (id: string, resolved = false) => ({
296
- id,
297
- firstComment: {
298
- authorLogin: "someone",
299
- body: "please fix",
300
- path: "a.ts",
301
- line: 1,
302
- createdAt: "now",
303
- },
304
- resolved,
305
- });
306
-
307
- it("keeps walking pages until the cursor is exhausted", async () => {
308
- const reader = fakeReader({
309
- threadPages: [
310
- { threads: [thread("one")], endCursor: "next" },
311
- { threads: [thread("two")], endCursor: "last" },
312
- { threads: [thread("three")], endCursor: null },
313
- ],
314
- });
315
- const threads = await resolveReviewThreads(reader, context);
316
- expect(threads.map((item) => item.id)).toEqual(["one", "two", "three"]);
317
- expect(reader.calls).toEqual([
318
- "reviewThreadPage:null",
319
- "reviewThreadPage:next",
320
- "reviewThreadPage:last",
321
- ]);
322
- });
323
-
324
- it("sees an unresolved thread that sits past the first page", async () => {
325
- const reader = fakeReader({
326
- threadPages: [
327
- { threads: [thread("early", true)], endCursor: "next" },
328
- { threads: [thread("late")], endCursor: null },
329
- ],
330
- });
331
- const threads = await resolveReviewThreads(reader, context);
332
- expect(threads.map((item) => item.id)).toEqual(["late"]);
333
- });
334
-
335
- it("stops after a single page when the cursor is exhausted", async () => {
336
- const reader = fakeReader({
337
- threadPages: [{ threads: [thread("only")], endCursor: null }],
338
- });
339
- expect((await resolveReviewThreads(reader, context)).length).toBe(1);
340
- expect(reader.calls).toEqual(["reviewThreadPage:null"]);
341
- });
342
-
343
- it("counts Bugbot review passes across every page", async () => {
344
- const bugbot = (id: string, runId: string) => ({
345
- id,
346
- firstComment: {
347
- authorLogin: "bugbot",
348
- body: `RUN_ID: ${runId}`,
349
- path: "a.ts",
350
- line: 1,
351
- createdAt: "now",
352
- },
353
- resolved: false,
354
- });
355
- const reader = fakeReader({
356
- threadPages: [
357
- { threads: [bugbot("one", "run-1")], endCursor: "next" },
358
- { threads: [bugbot("two", "run-2")], endCursor: null },
359
- ],
360
- });
361
- const threads = await resolveReviewThreads(reader, context);
362
- expect(threads.map((item) => item.bugbotReviewPasses)).toEqual([2, 2]);
363
- });
364
-
365
- it("drops resolved threads from later pages too", async () => {
366
- const reader = fakeReader({
367
- threadPages: [
368
- { threads: [thread("one")], endCursor: "next" },
369
- { threads: [thread("two", true)], endCursor: null },
370
- ],
371
- });
372
- expect(
373
- (await resolveReviewThreads(reader, context)).map((item) => item.id)
374
- ).toEqual(["one"]);
375
- });
376
-
377
- it("rejects a page that omits pageInfo instead of assuming one page", async () => {
378
- const response = {
379
- data: {
380
- repository: {
381
- pullRequest: { reviewThreads: { nodes: [] } },
382
- },
383
- },
384
- };
385
- expect(() => parseReviewThreadPage(response)).toThrow(WatcherQueryError);
386
- });
387
- });
388
-
389
- describe("context and stack discovery", () => {
390
- it("returns a fully explicit context without any reader call", async () => {
391
- const reader = fakeReader();
392
- expect(
393
- await resolveContext({
394
- reader,
395
- owner: "explicit",
396
- repo: "repo",
397
- pr: context.number,
398
- })
399
- ).toEqual({ owner: "explicit", repo: "repo", number: context.number });
400
- expect(reader.calls).toEqual([]);
401
- });
402
-
403
- it("uses the local origin before currentPr for an explicit number", async () => {
404
- const reader = fakeReader({ origin: { owner: "local", repo: "checkout" } });
405
- expect(
406
- await resolveContext({
407
- reader,
408
- owner: null,
409
- repo: null,
410
- pr: context.number,
411
- })
412
- ).toEqual({ owner: "local", repo: "checkout", number: context.number });
413
- expect(reader.calls).toEqual(["originRepo"]);
414
- });
415
-
416
- it("orders the connected stack bottom-to-top", () => {
417
- const ordered = orderStack(context, [
418
- {
419
- number: parsePrNumber(41),
420
- headRefName: "base-feature",
421
- baseRefName: "main",
422
- },
423
- {
424
- number: context.number,
425
- headRefName: "feature",
426
- baseRefName: "base-feature",
427
- },
428
- {
429
- number: parsePrNumber(43),
430
- headRefName: "upstack",
431
- baseRefName: "feature",
432
- },
433
- ]);
434
- expect(ordered.map((item) => Number(item.number))).toEqual([41, 42, 43]);
435
- });
436
- });