dorfl 0.0.0 → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (619) hide show
  1. package/dist/advance-ci-template.d.ts +73 -0
  2. package/dist/advance-ci-template.d.ts.map +1 -0
  3. package/dist/advance-ci-template.js +104 -0
  4. package/dist/advance-ci-template.js.map +1 -0
  5. package/dist/advance-classify.d.ts +132 -0
  6. package/dist/advance-classify.d.ts.map +1 -0
  7. package/dist/advance-classify.js +120 -0
  8. package/dist/advance-classify.js.map +1 -0
  9. package/dist/advance-drivers.d.ts +182 -0
  10. package/dist/advance-drivers.d.ts.map +1 -0
  11. package/dist/advance-drivers.js +231 -0
  12. package/dist/advance-drivers.js.map +1 -0
  13. package/dist/advance-isolated.d.ts +156 -0
  14. package/dist/advance-isolated.d.ts.map +1 -0
  15. package/dist/advance-isolated.js +256 -0
  16. package/dist/advance-isolated.js.map +1 -0
  17. package/dist/advance-lifecycle-template.d.ts +107 -0
  18. package/dist/advance-lifecycle-template.d.ts.map +1 -0
  19. package/dist/advance-lifecycle-template.js +668 -0
  20. package/dist/advance-lifecycle-template.js.map +1 -0
  21. package/dist/advance-loop-driver.d.ts +325 -0
  22. package/dist/advance-loop-driver.d.ts.map +1 -0
  23. package/dist/advance-loop-driver.js +437 -0
  24. package/dist/advance-loop-driver.js.map +1 -0
  25. package/dist/advance-treeless-publish.d.ts +108 -0
  26. package/dist/advance-treeless-publish.d.ts.map +1 -0
  27. package/dist/advance-treeless-publish.js +71 -0
  28. package/dist/advance-treeless-publish.js.map +1 -0
  29. package/dist/advance.d.ts +340 -0
  30. package/dist/advance.d.ts.map +1 -0
  31. package/dist/advance.js +1122 -0
  32. package/dist/advance.js.map +1 -0
  33. package/dist/advancing-lock.d.ts +294 -0
  34. package/dist/advancing-lock.d.ts.map +1 -0
  35. package/dist/advancing-lock.js +594 -0
  36. package/dist/advancing-lock.js.map +1 -0
  37. package/dist/agent-launch.d.ts +79 -0
  38. package/dist/agent-launch.d.ts.map +1 -0
  39. package/dist/agent-launch.js +61 -0
  40. package/dist/agent-launch.js.map +1 -0
  41. package/dist/agent-stop.d.ts +149 -0
  42. package/dist/agent-stop.d.ts.map +1 -0
  43. package/dist/agent-stop.js +307 -0
  44. package/dist/agent-stop.js.map +1 -0
  45. package/dist/apply-decide.d.ts +127 -0
  46. package/dist/apply-decide.d.ts.map +1 -0
  47. package/dist/apply-decide.js +176 -0
  48. package/dist/apply-decide.js.map +1 -0
  49. package/dist/apply-merge-action.d.ts +206 -0
  50. package/dist/apply-merge-action.d.ts.map +1 -0
  51. package/dist/apply-merge-action.js +307 -0
  52. package/dist/apply-merge-action.js.map +1 -0
  53. package/dist/apply-persist.d.ts +174 -0
  54. package/dist/apply-persist.d.ts.map +1 -0
  55. package/dist/apply-persist.js +359 -0
  56. package/dist/apply-persist.js.map +1 -0
  57. package/dist/arbiter.d.ts +120 -0
  58. package/dist/arbiter.d.ts.map +1 -0
  59. package/dist/arbiter.js +255 -0
  60. package/dist/arbiter.js.map +1 -0
  61. package/dist/brand.d.ts +70 -0
  62. package/dist/brand.d.ts.map +1 -0
  63. package/dist/brand.js +84 -0
  64. package/dist/brand.js.map +1 -0
  65. package/dist/buildable-body.d.ts +132 -0
  66. package/dist/buildable-body.d.ts.map +1 -0
  67. package/dist/buildable-body.js +131 -0
  68. package/dist/buildable-body.js.map +1 -0
  69. package/dist/categorise.d.ts +66 -0
  70. package/dist/categorise.d.ts.map +1 -0
  71. package/dist/categorise.js +106 -0
  72. package/dist/categorise.js.map +1 -0
  73. package/dist/claim-cas.d.ts +117 -0
  74. package/dist/claim-cas.d.ts.map +1 -0
  75. package/dist/claim-cas.js +312 -0
  76. package/dist/claim-cas.js.map +1 -0
  77. package/dist/cli-spinner.d.ts +112 -0
  78. package/dist/cli-spinner.d.ts.map +1 -0
  79. package/dist/cli-spinner.js +157 -0
  80. package/dist/cli-spinner.js.map +1 -0
  81. package/dist/cli.d.ts +11 -0
  82. package/dist/cli.d.ts.map +1 -0
  83. package/dist/cli.js +3094 -0
  84. package/dist/cli.js.map +1 -0
  85. package/dist/close-job-template.d.ts +70 -0
  86. package/dist/close-job-template.d.ts.map +1 -0
  87. package/dist/close-job-template.js +180 -0
  88. package/dist/close-job-template.js.map +1 -0
  89. package/dist/close-job.d.ts +95 -0
  90. package/dist/close-job.d.ts.map +1 -0
  91. package/dist/close-job.js +226 -0
  92. package/dist/close-job.js.map +1 -0
  93. package/dist/complete.d.ts +361 -0
  94. package/dist/complete.d.ts.map +1 -0
  95. package/dist/complete.js +885 -0
  96. package/dist/complete.js.map +1 -0
  97. package/dist/concurrency.d.ts +68 -0
  98. package/dist/concurrency.d.ts.map +1 -0
  99. package/dist/concurrency.js +112 -0
  100. package/dist/concurrency.js.map +1 -0
  101. package/dist/config-override.d.ts +76 -0
  102. package/dist/config-override.d.ts.map +1 -0
  103. package/dist/config-override.js +50 -0
  104. package/dist/config-override.js.map +1 -0
  105. package/dist/config.d.ts +668 -0
  106. package/dist/config.d.ts.map +1 -0
  107. package/dist/config.js +241 -0
  108. package/dist/config.js.map +1 -0
  109. package/dist/continue-branch.d.ts +249 -0
  110. package/dist/continue-branch.d.ts.map +1 -0
  111. package/dist/continue-branch.js +389 -0
  112. package/dist/continue-branch.js.map +1 -0
  113. package/dist/cwd-section.d.ts +186 -0
  114. package/dist/cwd-section.d.ts.map +1 -0
  115. package/dist/cwd-section.js +209 -0
  116. package/dist/cwd-section.js.map +1 -0
  117. package/dist/decision-engine.d.ts +170 -0
  118. package/dist/decision-engine.d.ts.map +1 -0
  119. package/dist/decision-engine.js +136 -0
  120. package/dist/decision-engine.js.map +1 -0
  121. package/dist/detect.d.ts +17 -0
  122. package/dist/detect.d.ts.map +1 -0
  123. package/dist/detect.js +118 -0
  124. package/dist/detect.js.map +1 -0
  125. package/dist/do-autopick.d.ts +85 -0
  126. package/dist/do-autopick.d.ts.map +1 -0
  127. package/dist/do-autopick.js +112 -0
  128. package/dist/do-autopick.js.map +1 -0
  129. package/dist/do-config.d.ts +312 -0
  130. package/dist/do-config.d.ts.map +1 -0
  131. package/dist/do-config.js +358 -0
  132. package/dist/do-config.js.map +1 -0
  133. package/dist/do-remote-auto.d.ts +75 -0
  134. package/dist/do-remote-auto.d.ts.map +1 -0
  135. package/dist/do-remote-auto.js +111 -0
  136. package/dist/do-remote-auto.js.map +1 -0
  137. package/dist/do.d.ts +621 -0
  138. package/dist/do.d.ts.map +1 -0
  139. package/dist/do.js +1882 -0
  140. package/dist/do.js.map +1 -0
  141. package/dist/drop-source.d.ts +96 -0
  142. package/dist/drop-source.d.ts.map +1 -0
  143. package/dist/drop-source.js +91 -0
  144. package/dist/drop-source.js.map +1 -0
  145. package/dist/eligibility.d.ts +46 -0
  146. package/dist/eligibility.d.ts.map +1 -0
  147. package/dist/eligibility.js +34 -0
  148. package/dist/eligibility.js.map +1 -0
  149. package/dist/env-config.d.ts +51 -0
  150. package/dist/env-config.d.ts.map +1 -0
  151. package/dist/env-config.js +272 -0
  152. package/dist/env-config.js.map +1 -0
  153. package/dist/failure-cause.d.ts +70 -0
  154. package/dist/failure-cause.d.ts.map +1 -0
  155. package/dist/failure-cause.js +126 -0
  156. package/dist/failure-cause.js.map +1 -0
  157. package/dist/format.d.ts +43 -0
  158. package/dist/format.d.ts.map +1 -0
  159. package/dist/format.js +256 -0
  160. package/dist/format.js.map +1 -0
  161. package/dist/frontmatter.d.ts +215 -0
  162. package/dist/frontmatter.d.ts.map +1 -0
  163. package/dist/frontmatter.js +345 -0
  164. package/dist/frontmatter.js.map +1 -0
  165. package/dist/gate-readiness.d.ts +84 -0
  166. package/dist/gate-readiness.d.ts.map +1 -0
  167. package/dist/gate-readiness.js +103 -0
  168. package/dist/gate-readiness.js.map +1 -0
  169. package/dist/gc.d.ts +165 -0
  170. package/dist/gc.d.ts.map +1 -0
  171. package/dist/gc.js +313 -0
  172. package/dist/gc.js.map +1 -0
  173. package/dist/gh-failure.d.ts +42 -0
  174. package/dist/gh-failure.d.ts.map +1 -0
  175. package/dist/gh-failure.js +49 -0
  176. package/dist/gh-failure.js.map +1 -0
  177. package/dist/git.d.ts +75 -0
  178. package/dist/git.d.ts.map +1 -0
  179. package/dist/git.js +130 -0
  180. package/dist/git.js.map +1 -0
  181. package/dist/github.d.ts +187 -0
  182. package/dist/github.d.ts.map +1 -0
  183. package/dist/github.js +343 -0
  184. package/dist/github.js.map +1 -0
  185. package/dist/harness.d.ts +242 -0
  186. package/dist/harness.d.ts.map +1 -0
  187. package/dist/harness.js +157 -0
  188. package/dist/harness.js.map +1 -0
  189. package/dist/identity.d.ts +167 -0
  190. package/dist/identity.d.ts.map +1 -0
  191. package/dist/identity.js +231 -0
  192. package/dist/identity.js.map +1 -0
  193. package/dist/index.d.ts +147 -0
  194. package/dist/index.d.ts.map +1 -0
  195. package/dist/index.js +76 -0
  196. package/dist/index.js.map +1 -0
  197. package/dist/install-ci-branch-protection.d.ts +147 -0
  198. package/dist/install-ci-branch-protection.d.ts.map +1 -0
  199. package/dist/install-ci-branch-protection.js +166 -0
  200. package/dist/install-ci-branch-protection.js.map +1 -0
  201. package/dist/install-ci-capabilities/advance-lifecycle.d.ts +15 -0
  202. package/dist/install-ci-capabilities/advance-lifecycle.d.ts.map +1 -0
  203. package/dist/install-ci-capabilities/advance-lifecycle.js +28 -0
  204. package/dist/install-ci-capabilities/advance-lifecycle.js.map +1 -0
  205. package/dist/install-ci-capabilities/close-job.d.ts +13 -0
  206. package/dist/install-ci-capabilities/close-job.d.ts.map +1 -0
  207. package/dist/install-ci-capabilities/close-job.js +26 -0
  208. package/dist/install-ci-capabilities/close-job.js.map +1 -0
  209. package/dist/install-ci-capabilities/example-noop.d.ts +16 -0
  210. package/dist/install-ci-capabilities/example-noop.d.ts.map +1 -0
  211. package/dist/install-ci-capabilities/example-noop.js +23 -0
  212. package/dist/install-ci-capabilities/example-noop.js.map +1 -0
  213. package/dist/install-ci-capabilities/intake.d.ts +15 -0
  214. package/dist/install-ci-capabilities/intake.d.ts.map +1 -0
  215. package/dist/install-ci-capabilities/intake.js +28 -0
  216. package/dist/install-ci-capabilities/intake.js.map +1 -0
  217. package/dist/install-ci-capabilities/verify.d.ts +14 -0
  218. package/dist/install-ci-capabilities/verify.d.ts.map +1 -0
  219. package/dist/install-ci-capabilities/verify.js +27 -0
  220. package/dist/install-ci-capabilities/verify.js.map +1 -0
  221. package/dist/install-ci-core.d.ts +446 -0
  222. package/dist/install-ci-core.d.ts.map +1 -0
  223. package/dist/install-ci-core.js +760 -0
  224. package/dist/install-ci-core.js.map +1 -0
  225. package/dist/install-ci-github.d.ts +167 -0
  226. package/dist/install-ci-github.d.ts.map +1 -0
  227. package/dist/install-ci-github.js +315 -0
  228. package/dist/install-ci-github.js.map +1 -0
  229. package/dist/install-ci.d.ts +105 -0
  230. package/dist/install-ci.d.ts.map +1 -0
  231. package/dist/install-ci.js +363 -0
  232. package/dist/install-ci.js.map +1 -0
  233. package/dist/intake-event.d.ts +88 -0
  234. package/dist/intake-event.d.ts.map +1 -0
  235. package/dist/intake-event.js +66 -0
  236. package/dist/intake-event.js.map +1 -0
  237. package/dist/intake-marker.d.ts +95 -0
  238. package/dist/intake-marker.d.ts.map +1 -0
  239. package/dist/intake-marker.js +127 -0
  240. package/dist/intake-marker.js.map +1 -0
  241. package/dist/intake-triage.d.ts +48 -0
  242. package/dist/intake-triage.d.ts.map +1 -0
  243. package/dist/intake-triage.js +95 -0
  244. package/dist/intake-triage.js.map +1 -0
  245. package/dist/intake-trigger-template.d.ts +185 -0
  246. package/dist/intake-trigger-template.d.ts.map +1 -0
  247. package/dist/intake-trigger-template.js +449 -0
  248. package/dist/intake-trigger-template.js.map +1 -0
  249. package/dist/intake.d.ts +569 -0
  250. package/dist/intake.d.ts.map +1 -0
  251. package/dist/intake.js +1628 -0
  252. package/dist/intake.js.map +1 -0
  253. package/dist/integration-core.d.ts +539 -0
  254. package/dist/integration-core.d.ts.map +1 -0
  255. package/dist/integration-core.js +2195 -0
  256. package/dist/integration-core.js.map +1 -0
  257. package/dist/integrator.d.ts +343 -0
  258. package/dist/integrator.d.ts.map +1 -0
  259. package/dist/integrator.js +400 -0
  260. package/dist/integrator.js.map +1 -0
  261. package/dist/isolation.d.ts +219 -0
  262. package/dist/isolation.d.ts.map +1 -0
  263. package/dist/isolation.js +261 -0
  264. package/dist/isolation.js.map +1 -0
  265. package/dist/issue-provider.d.ts +349 -0
  266. package/dist/issue-provider.d.ts.map +1 -0
  267. package/dist/issue-provider.js +360 -0
  268. package/dist/issue-provider.js.map +1 -0
  269. package/dist/item-lock.d.ts +626 -0
  270. package/dist/item-lock.d.ts.map +1 -0
  271. package/dist/item-lock.js +1381 -0
  272. package/dist/item-lock.js.map +1 -0
  273. package/dist/item-path.d.ts +49 -0
  274. package/dist/item-path.d.ts.map +1 -0
  275. package/dist/item-path.js +66 -0
  276. package/dist/item-path.js.map +1 -0
  277. package/dist/ledger-lint.d.ts +129 -0
  278. package/dist/ledger-lint.d.ts.map +1 -0
  279. package/dist/ledger-lint.js +249 -0
  280. package/dist/ledger-lint.js.map +1 -0
  281. package/dist/ledger-read.d.ts +357 -0
  282. package/dist/ledger-read.d.ts.map +1 -0
  283. package/dist/ledger-read.js +442 -0
  284. package/dist/ledger-read.js.map +1 -0
  285. package/dist/ledger-write.d.ts +330 -0
  286. package/dist/ledger-write.d.ts.map +1 -0
  287. package/dist/ledger-write.js +411 -0
  288. package/dist/ledger-write.js.map +1 -0
  289. package/dist/lifecycle-gather.d.ts +30 -0
  290. package/dist/lifecycle-gather.d.ts.map +1 -0
  291. package/dist/lifecycle-gather.js +205 -0
  292. package/dist/lifecycle-gather.js.map +1 -0
  293. package/dist/lifecycle-pools.d.ts +180 -0
  294. package/dist/lifecycle-pools.d.ts.map +1 -0
  295. package/dist/lifecycle-pools.js +78 -0
  296. package/dist/lifecycle-pools.js.map +1 -0
  297. package/dist/merge-question-surfacer.d.ts +166 -0
  298. package/dist/merge-question-surfacer.d.ts.map +1 -0
  299. package/dist/merge-question-surfacer.js +297 -0
  300. package/dist/merge-question-surfacer.js.map +1 -0
  301. package/dist/mint-adr.d.ts +126 -0
  302. package/dist/mint-adr.d.ts.map +1 -0
  303. package/dist/mint-adr.js +257 -0
  304. package/dist/mint-adr.js.map +1 -0
  305. package/dist/mirror-pool-scan.d.ts +125 -0
  306. package/dist/mirror-pool-scan.d.ts.map +1 -0
  307. package/dist/mirror-pool-scan.js +104 -0
  308. package/dist/mirror-pool-scan.js.map +1 -0
  309. package/dist/needs-attention.d.ts +341 -0
  310. package/dist/needs-attention.d.ts.map +1 -0
  311. package/dist/needs-attention.js +900 -0
  312. package/dist/needs-attention.js.map +1 -0
  313. package/dist/orphan-sidecar.d.ts +79 -0
  314. package/dist/orphan-sidecar.d.ts.map +1 -0
  315. package/dist/orphan-sidecar.js +71 -0
  316. package/dist/orphan-sidecar.js.map +1 -0
  317. package/dist/output.d.ts +48 -0
  318. package/dist/output.d.ts.map +1 -0
  319. package/dist/output.js +66 -0
  320. package/dist/output.js.map +1 -0
  321. package/dist/pi-harness.d.ts +179 -0
  322. package/dist/pi-harness.d.ts.map +1 -0
  323. package/dist/pi-harness.js +342 -0
  324. package/dist/pi-harness.js.map +1 -0
  325. package/dist/placement.d.ts +99 -0
  326. package/dist/placement.d.ts.map +1 -0
  327. package/dist/placement.js +67 -0
  328. package/dist/placement.js.map +1 -0
  329. package/dist/prd-to-spec.d.ts +315 -0
  330. package/dist/prd-to-spec.d.ts.map +1 -0
  331. package/dist/prd-to-spec.js +684 -0
  332. package/dist/prd-to-spec.js.map +1 -0
  333. package/dist/prepare.d.ts +121 -0
  334. package/dist/prepare.d.ts.map +1 -0
  335. package/dist/prepare.js +140 -0
  336. package/dist/prepare.js.map +1 -0
  337. package/dist/prompt.d.ts +360 -0
  338. package/dist/prompt.d.ts.map +1 -0
  339. package/dist/prompt.js +499 -0
  340. package/dist/prompt.js.map +1 -0
  341. package/dist/protocol/ADR-FORMAT.md +47 -0
  342. package/dist/protocol/CLAIM-PROTOCOL.md +217 -0
  343. package/dist/protocol/REVIEW-PROTOCOL.md +119 -0
  344. package/dist/protocol/SURFACE-PROTOCOL.md +121 -0
  345. package/dist/protocol/TASKING-PROTOCOL.md +122 -0
  346. package/dist/protocol/WORK-CONTRACT.md +276 -0
  347. package/dist/protocol/spec-template.md +71 -0
  348. package/dist/protocol/task-template.md +65 -0
  349. package/dist/readiness.d.ts +66 -0
  350. package/dist/readiness.d.ts.map +1 -0
  351. package/dist/readiness.js +36 -0
  352. package/dist/readiness.js.map +1 -0
  353. package/dist/reap-branches.d.ts +102 -0
  354. package/dist/reap-branches.d.ts.map +1 -0
  355. package/dist/reap-branches.js +149 -0
  356. package/dist/reap-branches.js.map +1 -0
  357. package/dist/recover-isolated.d.ts +72 -0
  358. package/dist/recover-isolated.d.ts.map +1 -0
  359. package/dist/recover-isolated.js +188 -0
  360. package/dist/recover-isolated.js.map +1 -0
  361. package/dist/registry.d.ts +172 -0
  362. package/dist/registry.d.ts.map +1 -0
  363. package/dist/registry.js +296 -0
  364. package/dist/registry.js.map +1 -0
  365. package/dist/repo-config.d.ts +201 -0
  366. package/dist/repo-config.d.ts.map +1 -0
  367. package/dist/repo-config.js +414 -0
  368. package/dist/repo-config.js.map +1 -0
  369. package/dist/repo-key.d.ts +20 -0
  370. package/dist/repo-key.d.ts.map +1 -0
  371. package/dist/repo-key.js +68 -0
  372. package/dist/repo-key.js.map +1 -0
  373. package/dist/repo-mirror.d.ts +177 -0
  374. package/dist/repo-mirror.d.ts.map +1 -0
  375. package/dist/repo-mirror.js +271 -0
  376. package/dist/repo-mirror.js.map +1 -0
  377. package/dist/retry-backoff.d.ts +90 -0
  378. package/dist/retry-backoff.d.ts.map +1 -0
  379. package/dist/retry-backoff.js +98 -0
  380. package/dist/retry-backoff.js.map +1 -0
  381. package/dist/review-gate.d.ts +173 -0
  382. package/dist/review-gate.d.ts.map +1 -0
  383. package/dist/review-gate.js +261 -0
  384. package/dist/review-gate.js.map +1 -0
  385. package/dist/review-verdict.d.ts +149 -0
  386. package/dist/review-verdict.d.ts.map +1 -0
  387. package/dist/review-verdict.js +332 -0
  388. package/dist/review-verdict.js.map +1 -0
  389. package/dist/run.d.ts +221 -0
  390. package/dist/run.d.ts.map +1 -0
  391. package/dist/run.js +963 -0
  392. package/dist/run.js.map +1 -0
  393. package/dist/scan.d.ts +308 -0
  394. package/dist/scan.d.ts.map +1 -0
  395. package/dist/scan.js +374 -0
  396. package/dist/scan.js.map +1 -0
  397. package/dist/select-order.d.ts +75 -0
  398. package/dist/select-order.d.ts.map +1 -0
  399. package/dist/select-order.js +108 -0
  400. package/dist/select-order.js.map +1 -0
  401. package/dist/select-priority.d.ts +188 -0
  402. package/dist/select-priority.d.ts.map +1 -0
  403. package/dist/select-priority.js +80 -0
  404. package/dist/select-priority.js.map +1 -0
  405. package/dist/select.d.ts +25 -0
  406. package/dist/select.d.ts.map +1 -0
  407. package/dist/select.js +43 -0
  408. package/dist/select.js.map +1 -0
  409. package/dist/session-path.d.ts +36 -0
  410. package/dist/session-path.d.ts.map +1 -0
  411. package/dist/session-path.js +129 -0
  412. package/dist/session-path.js.map +1 -0
  413. package/dist/sidecar-apply.d.ts +83 -0
  414. package/dist/sidecar-apply.d.ts.map +1 -0
  415. package/dist/sidecar-apply.js +111 -0
  416. package/dist/sidecar-apply.js.map +1 -0
  417. package/dist/sidecar.d.ts +245 -0
  418. package/dist/sidecar.d.ts.map +1 -0
  419. package/dist/sidecar.js +481 -0
  420. package/dist/sidecar.js.map +1 -0
  421. package/dist/slug-namespace.d.ts +204 -0
  422. package/dist/slug-namespace.d.ts.map +1 -0
  423. package/dist/slug-namespace.js +229 -0
  424. package/dist/slug-namespace.js.map +1 -0
  425. package/dist/spec-complete.d.ts +44 -0
  426. package/dist/spec-complete.d.ts.map +1 -0
  427. package/dist/spec-complete.js +69 -0
  428. package/dist/spec-complete.js.map +1 -0
  429. package/dist/start.d.ts +97 -0
  430. package/dist/start.d.ts.map +1 -0
  431. package/dist/start.js +633 -0
  432. package/dist/start.js.map +1 -0
  433. package/dist/status.d.ts +199 -0
  434. package/dist/status.d.ts.map +1 -0
  435. package/dist/status.js +228 -0
  436. package/dist/status.js.map +1 -0
  437. package/dist/surface-gate.d.ts +162 -0
  438. package/dist/surface-gate.d.ts.map +1 -0
  439. package/dist/surface-gate.js +206 -0
  440. package/dist/surface-gate.js.map +1 -0
  441. package/dist/surface-persist.d.ts +86 -0
  442. package/dist/surface-persist.d.ts.map +1 -0
  443. package/dist/surface-persist.js +129 -0
  444. package/dist/surface-persist.js.map +1 -0
  445. package/dist/tasker-review-loop.d.ts +249 -0
  446. package/dist/tasker-review-loop.d.ts.map +1 -0
  447. package/dist/tasker-review-loop.js +369 -0
  448. package/dist/tasker-review-loop.js.map +1 -0
  449. package/dist/tasking-eligibility.d.ts +74 -0
  450. package/dist/tasking-eligibility.d.ts.map +1 -0
  451. package/dist/tasking-eligibility.js +52 -0
  452. package/dist/tasking-eligibility.js.map +1 -0
  453. package/dist/tasking-lock.d.ts +111 -0
  454. package/dist/tasking-lock.d.ts.map +1 -0
  455. package/dist/tasking-lock.js +256 -0
  456. package/dist/tasking-lock.js.map +1 -0
  457. package/dist/tasking.d.ts +275 -0
  458. package/dist/tasking.d.ts.map +1 -0
  459. package/dist/tasking.js +952 -0
  460. package/dist/tasking.js.map +1 -0
  461. package/dist/triage-gate.d.ts +127 -0
  462. package/dist/triage-gate.d.ts.map +1 -0
  463. package/dist/triage-gate.js +139 -0
  464. package/dist/triage-gate.js.map +1 -0
  465. package/dist/triage-persist.d.ts +163 -0
  466. package/dist/triage-persist.d.ts.map +1 -0
  467. package/dist/triage-persist.js +387 -0
  468. package/dist/triage-persist.js.map +1 -0
  469. package/dist/verdict-json.d.ts +32 -0
  470. package/dist/verdict-json.d.ts.map +1 -0
  471. package/dist/verdict-json.js +74 -0
  472. package/dist/verdict-json.js.map +1 -0
  473. package/dist/verify-workflow-template.d.ts +60 -0
  474. package/dist/verify-workflow-template.d.ts.map +1 -0
  475. package/dist/verify-workflow-template.js +126 -0
  476. package/dist/verify-workflow-template.js.map +1 -0
  477. package/dist/verify.d.ts +60 -0
  478. package/dist/verify.d.ts.map +1 -0
  479. package/dist/verify.js +62 -0
  480. package/dist/verify.js.map +1 -0
  481. package/dist/watch-session.d.ts +112 -0
  482. package/dist/watch-session.d.ts.map +1 -0
  483. package/dist/watch-session.js +347 -0
  484. package/dist/watch-session.js.map +1 -0
  485. package/dist/work-layout.d.ts +198 -0
  486. package/dist/work-layout.d.ts.map +1 -0
  487. package/dist/work-layout.js +217 -0
  488. package/dist/work-layout.js.map +1 -0
  489. package/dist/work-on.d.ts +154 -0
  490. package/dist/work-on.d.ts.map +1 -0
  491. package/dist/work-on.js +387 -0
  492. package/dist/work-on.js.map +1 -0
  493. package/dist/workspace.d.ts +224 -0
  494. package/dist/workspace.d.ts.map +1 -0
  495. package/dist/workspace.js +325 -0
  496. package/dist/workspace.js.map +1 -0
  497. package/package.json +46 -2
  498. package/src/advance-ci-template.ts +203 -0
  499. package/src/advance-classify.ts +197 -0
  500. package/src/advance-drivers.ts +414 -0
  501. package/src/advance-isolated.ts +432 -0
  502. package/src/advance-lifecycle-template.ts +791 -0
  503. package/src/advance-loop-driver.ts +745 -0
  504. package/src/advance-treeless-publish.ts +177 -0
  505. package/src/advance.ts +1564 -0
  506. package/src/advancing-lock.ts +988 -0
  507. package/src/agent-launch.ts +137 -0
  508. package/src/agent-stop.ts +361 -0
  509. package/src/apply-decide.ts +242 -0
  510. package/src/apply-merge-action.ts +502 -0
  511. package/src/apply-persist.ts +518 -0
  512. package/src/arbiter.ts +372 -0
  513. package/src/brand.ts +111 -0
  514. package/src/buildable-body.ts +196 -0
  515. package/src/categorise.ts +158 -0
  516. package/src/claim-cas.ts +513 -0
  517. package/src/cli-spinner.ts +225 -0
  518. package/src/cli.ts +4369 -0
  519. package/src/close-job-template.ts +236 -0
  520. package/src/close-job.ts +319 -0
  521. package/src/complete.ts +1379 -0
  522. package/src/concurrency.ts +151 -0
  523. package/src/config-override.ts +116 -0
  524. package/src/config.ts +883 -0
  525. package/src/continue-branch.ts +542 -0
  526. package/src/cwd-section.ts +392 -0
  527. package/src/decision-engine.ts +272 -0
  528. package/src/detect.ts +124 -0
  529. package/src/do-autopick.ts +223 -0
  530. package/src/do-config.ts +589 -0
  531. package/src/do-remote-auto.ts +197 -0
  532. package/src/do.ts +2623 -0
  533. package/src/drop-source.ts +194 -0
  534. package/src/eligibility.ts +79 -0
  535. package/src/env-config.ts +305 -0
  536. package/src/failure-cause.ts +142 -0
  537. package/src/format.ts +313 -0
  538. package/src/frontmatter.ts +485 -0
  539. package/src/gate-readiness.ts +147 -0
  540. package/src/gc.ts +510 -0
  541. package/src/gh-failure.ts +53 -0
  542. package/src/git.ts +186 -0
  543. package/src/github.ts +468 -0
  544. package/src/harness.ts +355 -0
  545. package/src/identity.ts +322 -0
  546. package/src/index.ts +785 -0
  547. package/src/install-ci-branch-protection.ts +255 -0
  548. package/src/install-ci-capabilities/advance-lifecycle.ts +34 -0
  549. package/src/install-ci-capabilities/close-job.ts +32 -0
  550. package/src/install-ci-capabilities/example-noop.ts +24 -0
  551. package/src/install-ci-capabilities/intake.ts +34 -0
  552. package/src/install-ci-capabilities/verify.ts +33 -0
  553. package/src/install-ci-core.ts +1088 -0
  554. package/src/install-ci-github.ts +376 -0
  555. package/src/install-ci.ts +552 -0
  556. package/src/intake-event.ts +102 -0
  557. package/src/intake-marker.ts +195 -0
  558. package/src/intake-triage.ts +138 -0
  559. package/src/intake-trigger-template.ts +591 -0
  560. package/src/intake.ts +2445 -0
  561. package/src/integration-core.ts +3065 -0
  562. package/src/integrator.ts +771 -0
  563. package/src/isolation.ts +484 -0
  564. package/src/issue-provider.ts +733 -0
  565. package/src/item-lock.ts +1858 -0
  566. package/src/item-path.ts +75 -0
  567. package/src/ledger-lint.ts +332 -0
  568. package/src/ledger-read.ts +924 -0
  569. package/src/ledger-write.ts +865 -0
  570. package/src/lifecycle-gather.ts +298 -0
  571. package/src/lifecycle-pools.ts +250 -0
  572. package/src/merge-question-surfacer.ts +496 -0
  573. package/src/mint-adr.ts +362 -0
  574. package/src/mirror-pool-scan.ts +240 -0
  575. package/src/needs-attention.ts +1506 -0
  576. package/src/orphan-sidecar.ts +150 -0
  577. package/src/output.ts +89 -0
  578. package/src/pi-harness.ts +403 -0
  579. package/src/placement.ts +131 -0
  580. package/src/prd-to-spec.ts +1023 -0
  581. package/src/prepare.ts +230 -0
  582. package/src/prompt.ts +760 -0
  583. package/src/readiness.ts +98 -0
  584. package/src/reap-branches.ts +278 -0
  585. package/src/recover-isolated.ts +276 -0
  586. package/src/registry.ts +475 -0
  587. package/src/repo-config.ts +550 -0
  588. package/src/repo-key.ts +74 -0
  589. package/src/repo-mirror.ts +367 -0
  590. package/src/retry-backoff.ts +130 -0
  591. package/src/review-gate.ts +389 -0
  592. package/src/review-verdict.ts +422 -0
  593. package/src/run.ts +1430 -0
  594. package/src/scan.ts +611 -0
  595. package/src/select-order.ts +143 -0
  596. package/src/select-priority.ts +266 -0
  597. package/src/select.ts +62 -0
  598. package/src/session-path.ts +153 -0
  599. package/src/sidecar-apply.ts +216 -0
  600. package/src/sidecar.ts +700 -0
  601. package/src/slug-namespace.ts +367 -0
  602. package/src/spec-complete.ts +118 -0
  603. package/src/start.ts +974 -0
  604. package/src/status.ts +441 -0
  605. package/src/surface-gate.ts +337 -0
  606. package/src/surface-persist.ts +241 -0
  607. package/src/tasker-review-loop.ts +671 -0
  608. package/src/tasking-eligibility.ts +114 -0
  609. package/src/tasking-lock.ts +416 -0
  610. package/src/tasking.ts +1438 -0
  611. package/src/triage-gate.ts +248 -0
  612. package/src/triage-persist.ts +570 -0
  613. package/src/verdict-json.ts +73 -0
  614. package/src/verify-workflow-template.ts +159 -0
  615. package/src/verify.ts +123 -0
  616. package/src/watch-session.ts +397 -0
  617. package/src/work-layout.ts +262 -0
  618. package/src/work-on.ts +660 -0
  619. package/src/workspace.ts +502 -0
@@ -0,0 +1,341 @@
1
+ import { type BackoffOptions, type Sleep } from './retry-backoff.js';
2
+ export interface RouteToNeedsAttentionOptions {
3
+ /** The working clone / job worktree the `work/<slug>` branch lives in. */
4
+ cwd: string;
5
+ /** The slug of the in-progress item to bounce. */
6
+ slug: string;
7
+ /** Why the item is stuck (red gate, rebase conflict, ambiguity, timeout, …). */
8
+ reason: string;
9
+ /** Any questions the agent surfaced for the human, recorded under the reason. */
10
+ questions?: string[];
11
+ /**
12
+ * The arbiter remote to push the transition to (like the done-move). When
13
+ * omitted, the move is committed locally only (the caller pushes the branch as
14
+ * part of its own flow, e.g. the runner's integration step).
15
+ */
16
+ arbiter?: string;
17
+ /**
18
+ * The work branch to push to the arbiter (the RECOVERABLE half — see the seam
19
+ * docstring). DEFAULT `work/<slug>`: the build-bounce branch the wip/move
20
+ * commits landed on. A tasking bounce passes its own branch (`work/prds/
21
+ * ready-<slug>`). The supplied branch MUST be the one HEAD is on (the branch the
22
+ * wip/move commits landed on) — NEVER a default that differs from HEAD; a
23
+ * caller NOT checked out on the work branch (e.g. a temp branch off main) must
24
+ * be SURFACE-ONLY ({@link pushBranch} `false`) so no wrong-branch ref is
25
+ * pushed. Only consulted when {@link arbiter} is given and {@link pushBranch}
26
+ * is not `false`.
27
+ */
28
+ branch?: string;
29
+ /**
30
+ * SURFACE-ONLY when `false`: publish the ledger surface (when an `arbiter` is
31
+ * given) but push NO work branch. For a caller that is NOT checked out on the
32
+ * work branch (a throwaway temp branch off main — e.g. `start.ts`'s
33
+ * `routeContinueConflict`, whose real `work/<slug>` is already on the arbiter
34
+ * from the prior requeue). Defaults to pushing (the build-bounce common case).
35
+ */
36
+ pushBranch?: boolean;
37
+ /** Environment for child git processes (identity etc.). */
38
+ env?: NodeJS.ProcessEnv;
39
+ /** Sink for human-readable progress notes. */
40
+ note?: (message: string) => void;
41
+ /**
42
+ * Bounded-backoff bounds for the RECOVERABLE branch push (the OUTAGE-retry,
43
+ * NOT the instant-contention loop). Defaults to {@link DEFAULT_BACKOFF}.
44
+ */
45
+ backoff?: BackoffOptions;
46
+ /**
47
+ * Injectable sleep for the backoff (tests drive the retry timeline with NO
48
+ * real waits — the `run.ts` `sleep`/`realSleep` seam). Defaults to a real
49
+ * `setTimeout`. Threaded into {@link backoff} when the latter omits its own.
50
+ */
51
+ sleep?: Sleep;
52
+ }
53
+ /** The outcome of the RECOVERABLE branch push (the per-op honest report). */
54
+ export type BranchPushOutcome =
55
+ /** Pushed to the arbiter (cross-machine recoverable). */
56
+ 'pushed'
57
+ /** Skipped by the emptiness guard — nothing beyond main to recover YET. */
58
+ | 'skipped-empty'
59
+ /** Retried with backoff, then gave up — saved LOCALLY only. */
60
+ | 'failed'
61
+ /** No arbiter / surface-only — no push was attempted. */
62
+ | 'not-attempted';
63
+ export interface RouteToNeedsAttentionResult {
64
+ /** True iff the item was moved + committed. */
65
+ moved: boolean;
66
+ /** When `moved`, the committed transition message (of the MOVE-ONLY commit). */
67
+ commitMessage?: string;
68
+ /**
69
+ * The per-op outcome of the RECOVERABLE branch push (honest reporting — the
70
+ * message reads THIS, never assumes "pushed" off the local move). Absent when
71
+ * the item did not move.
72
+ */
73
+ branchPush?: BranchPushOutcome;
74
+ /** When the branch push FAILED after retries, the last git error (for the report). */
75
+ pushError?: string;
76
+ /**
77
+ * When `moved`, the sha of the **move-only** commit — the tip of `work/<slug>`
78
+ * that carries PURELY the `git mv → needs-attention/` + the reason (the wip
79
+ * commit holding the aborted agent work sits BELOW it). A surfacing strategy
80
+ * cherry-picks THIS commit to make the stuck state observable, so the wip never
81
+ * reaches the ledger.
82
+ */
83
+ moveCommit?: string;
84
+ /** When NOT moved, why (e.g. the slug was not in-progress). */
85
+ reasonNotMoved?: string;
86
+ }
87
+ export interface ReturnToBacklogOptions {
88
+ /** The working clone the `work/` tree lives in. */
89
+ cwd: string;
90
+ /**
91
+ * The slug of the stuck item to re-queue — recovered from `needs-attention/`
92
+ * OR `in-progress/` (the actual current folder is resolved on the arbiter).
93
+ */
94
+ slug: string;
95
+ /** The arbiter remote to push the transition to. Optional (see above). */
96
+ arbiter?: string;
97
+ /**
98
+ * `requeue --reset` (the destructive opt-out): DISCARD the kept work, so the
99
+ * NEXT claim starts FRESH. At requeue-time — BEFORE the backlog move — delete
100
+ * the remote `work/<slug>` branch on `arbiter`
101
+ * (`git push <arbiter> --delete work/<slug>`, plain provider-agnostic git that
102
+ * works against a local `--bare` arbiter) and drop any stale LOCAL `work/<slug>`.
103
+ * Delete-before-move closes the claim-race window (no backlog item exists while
104
+ * the to-be-discarded branch still does). A FAILED delete ABORTS the requeue
105
+ * (no backlog move) — the item stays in needs-attention rather than become
106
+ * claimable while continuing from a branch you meant to throw away. Requires
107
+ * `arbiter`. Explicit/guarded — a deliberate departure from the loud "never
108
+ * delete the remote branch" invariant; never on the default (keep+continue)
109
+ * path.
110
+ */
111
+ reset?: boolean;
112
+ /**
113
+ * `requeue -m "<note>"` (the handoff note): an optional human steer for the
114
+ * NEXT agent. APPENDED (never overwritten) as a dated `## Requeue YYYY-MM-DD`
115
+ * section to the item BODY before the move — the ledger file is the durable,
116
+ * conflict-safe, cross-machine home (same place the needs-attention reason
117
+ * lives). Repeated requeues ACCUMULATE a handoff log. Applies to BOTH modes
118
+ * (a steer is relevant even on `--reset`).
119
+ */
120
+ message?: string;
121
+ /** Environment for child git processes. */
122
+ env?: NodeJS.ProcessEnv;
123
+ /** Sink for human-readable progress notes. */
124
+ note?: (message: string) => void;
125
+ }
126
+ export interface ReturnToBacklogResult {
127
+ /** True iff the item was moved back + committed. */
128
+ moved: boolean;
129
+ /** When `moved`, the committed transition message. */
130
+ commitMessage?: string;
131
+ /** True iff `--reset` deleted the remote `work/<slug>` branch on the arbiter. */
132
+ deletedRemoteBranch?: boolean;
133
+ /** When NOT moved, why (e.g. the slug was in neither needs-attention/ nor in-progress/, or a failed --reset delete). */
134
+ reasonNotMoved?: string;
135
+ }
136
+ export interface SurfaceToNeedsAttentionOptions {
137
+ /**
138
+ * The working clone the move is ORIGINATED from — purely the ORIGIN SOURCE
139
+ * (it resolves the arbiter remote + holds the object store the plumbing writes
140
+ * into), NEVER a write TARGET. Tree-less: the cwd index/HEAD/working tree are
141
+ * never touched (parity with {@link returnToBacklog}).
142
+ */
143
+ cwd: string;
144
+ /** The slug of the in-progress item to surface to needs-attention. */
145
+ slug: string;
146
+ /** Why the item is stuck (terminal continue-push failure, rebase conflict, …). */
147
+ reason: string;
148
+ /** Any questions the agent surfaced for the human, recorded under the reason. */
149
+ questions?: string[];
150
+ /**
151
+ * The arbiter remote the surface move is CAS-published to. REQUIRED — like
152
+ * {@link returnToBacklog}, the move is a tree-less compare-and-swap to the
153
+ * arbiter ref, so there is no local-only mode.
154
+ */
155
+ arbiter: string;
156
+ /** Environment for child git processes (identity etc.). */
157
+ env?: NodeJS.ProcessEnv;
158
+ /** Sink for human-readable progress notes. */
159
+ note?: (message: string) => void;
160
+ }
161
+ export interface SurfaceToNeedsAttentionResult {
162
+ /** True iff the item was surfaced (moved + CAS-published) on the arbiter. */
163
+ moved: boolean;
164
+ /** When `moved`, the committed transition message. */
165
+ commitMessage?: string;
166
+ /** When NOT moved, why (no arbiter, item not on the arbiter, contention exhausted). */
167
+ reasonNotMoved?: string;
168
+ }
169
+ /**
170
+ * Save the RECOVERABLE half of a stuck-item bounce (ADR §12). The RUNNER calls
171
+ * this; the build agent never does.
172
+ *
173
+ * **Post `ledger-status-per-item-lock-refs` cut-over (tasks 9a–9d, decision i+):**
174
+ * a bounce is now a PURE LOCK AMEND — the seam (`bounceToStuckLock` →
175
+ * `markStuckItemLock`) marks the per-item lock `state: stuck` and records the
176
+ * reason/questions ON THE LOCK ENTRY. There is NO `git mv` to a
177
+ * `needs-attention/` folder and NO on-`main` surface commit. The item body never
178
+ * moves (it rests in `backlog/` since claim stopped moving it, task 9a). So what
179
+ * REMAINS here is purely the never-lose-work half:
180
+ *
181
+ * 1. A **wip** commit on the `work/<slug>` branch tip holding whatever the agent
182
+ * left uncommitted (`git add -A`). Skipped when the tree is already clean
183
+ * (no aborted work to save). No bookkeeping trailer — after the cut-over NO
184
+ * transient-status move-only commit lands on a branch, so a branch rebases
185
+ * PLAINLY with nothing to drop (`drop-bookkeeping-rebase` is deleted, 9d).
186
+ * 2. Optionally PUSH the work branch to the arbiter so the saved wip travels
187
+ * cross-machine and a `requeue` continues from the branch tip. BEST-EFFORT
188
+ * (an unreachable arbiter leaves the local branch standing — recovery
189
+ * degrades, never crashes the bounce; retried with bounded backoff on an
190
+ * outage), BRANCH-PARAMETERISED (default `work/<slug>`; an explicit `branch`
191
+ * overrides — the tasking bounce passes `work/prds/ready-<slug>`; `pushBranch: false`
192
+ * ⇒ push NOTHING), and EMPTINESS-GUARDED (a branch with no commits beyond
193
+ * main, or an absent branch, is skipped). The branch MUST be the one HEAD is
194
+ * on. The work-branch push is NOT a `main` write.
195
+ *
196
+ * The stuck STATE itself (the `state: stuck` + reason/questions) is owned by the
197
+ * lock amend in the seam, not by this function. NEVER throws for the expected
198
+ * case — returns `{moved, ...}` so consumers can branch cleanly; genuine git
199
+ * plumbing failures still throw (they are unexpected).
200
+ */
201
+ export declare function routeToNeedsAttention(options: RouteToNeedsAttentionOptions): Promise<RouteToNeedsAttentionResult>;
202
+ export declare function returnToBacklog(options: ReturnToBacklogOptions): Promise<ReturnToBacklogResult>;
203
+ /**
204
+ * **Promote a STAGED task into the agent-eligible pool** (prd
205
+ * `staging-pool-position-gate-and-trust-model`, task
206
+ * `pre-backlog-staging-folder-and-promote-step-a`, governing ADR
207
+ * `placement-is-runner-deterministic-humanonly-is-agent-judgement`). Moves
208
+ * `work/pre-backlog/<slug>.md → work/backlog/<slug>.md` as a durable `main`
209
+ * move, the same category as {@link returnToBacklog} (tree-less CAS via
210
+ * {@link runTreelessLedgerMove}). After this transition the task is in the
211
+ * pool and claimable.
212
+ *
213
+ * **RUNNER/human-owned.** There is no agent-facing path that performs this:
214
+ * the agent's tasking output lands STAGED in `work/pre-backlog/` (the runner's
215
+ * deterministic placement decision), and only a runner/human invocation moves
216
+ * it into the pool. The agent does no git here, as everywhere.
217
+ *
218
+ * Storage-agnostic: it names the slug + the arbiter, NOT *where* the move
219
+ * lands; the sole strategy publishes to `<arbiter>/main`. Like
220
+ * {@link returnToBacklog} the tree-less CAS needs a ref to push to, so an
221
+ * `arbiter` is REQUIRED. NEVER throws for the expected
222
+ * "not in pre-backlog/" / contention-exhausted cases — it returns
223
+ * `{moved: false, reasonNotMoved}` so callers can branch cleanly.
224
+ */
225
+ export interface PromoteFromPreBacklogOptions {
226
+ /**
227
+ * The working clone the move is ORIGINATED from — purely the ORIGIN SOURCE
228
+ * (it resolves the arbiter remote + holds the object store the plumbing
229
+ * writes into), NEVER a write TARGET. Tree-less: the cwd index/HEAD/working
230
+ * tree are never touched (parity with {@link returnToBacklog}).
231
+ */
232
+ cwd: string;
233
+ /** The slug of the staged task to promote into the pool. */
234
+ slug: string;
235
+ /**
236
+ * The arbiter remote the promotion is CAS-published to. REQUIRED — the
237
+ * tree-less CAS needs a ref to push to (parity with `requeue`/`claim`).
238
+ */
239
+ arbiter: string;
240
+ /** Environment for child git processes (identity etc.). */
241
+ env?: NodeJS.ProcessEnv;
242
+ /** Sink for human-readable progress notes. */
243
+ note?: (message: string) => void;
244
+ }
245
+ export interface PromoteFromPreBacklogResult {
246
+ /** True iff the staged task was moved into the pool + committed. */
247
+ moved: boolean;
248
+ /** When `moved`, the committed transition message. */
249
+ commitMessage?: string;
250
+ /** When NOT moved, why (no such pre-backlog item, already in backlog, contention). */
251
+ reasonNotMoved?: string;
252
+ }
253
+ export declare function promoteFromPreBacklog(options: PromoteFromPreBacklogOptions): Promise<PromoteFromPreBacklogResult>;
254
+ /**
255
+ * **Promote a STAGED prd into the auto-task pool** (prd
256
+ * `staging-pool-position-gate-and-trust-model`, task
257
+ * `pre-prd-staging-pool-split-and-untrusted-prd-placement`, governing ADR
258
+ * `placement-is-runner-deterministic-humanonly-is-agent-judgement`). The prd
259
+ * twin of {@link promoteFromPreBacklog}: moves
260
+ * `work/prds/proposed/<slug>.md → work/prds/ready/<slug>.md` as a durable `main` move
261
+ * (tree-less CAS via {@link runTreelessLedgerMove}). After this transition
262
+ * the prd is in the auto-task POOL and eligible to be auto-tasked (subject
263
+ * to the existing `autoTask`/`humanOnly`/`needsAnswers`/`taskedAfter` gates,
264
+ * which are UNCHANGED — the staging/pool split changes only WHICH folder is
265
+ * the auto-task pool, not the gates).
266
+ *
267
+ * **RUNNER/human-owned.** There is no agent-facing path that performs this:
268
+ * `intake`'s `prd` dispatch lands the prd STAGED in `work/prds/proposed/` (the
269
+ * runner's deterministic placement decision), and only a runner/human
270
+ * invocation moves it into the pool. The agent does no git here, as
271
+ * everywhere; this function is not reachable from any agent surface.
272
+ *
273
+ * Storage-agnostic + tree-less, exactly like {@link promoteFromPreBacklog}:
274
+ * cwd index/HEAD/working tree are never touched, an arbiter remote is
275
+ * REQUIRED, and "not in prds/proposed/" / contention-exhausted cases are returned
276
+ * (NEVER thrown) via `{moved: false, reasonNotMoved}` so callers branch
277
+ * cleanly. Idempotent: re-running after the move LANDED is a no-op success.
278
+ */
279
+ export interface PromoteFromPreSpecOptions {
280
+ /** The working clone the move is originated from (origin source only; never written). */
281
+ cwd: string;
282
+ /** The slug of the staged prd to promote into the pool. */
283
+ slug: string;
284
+ /** The arbiter remote the promotion is CAS-published to. REQUIRED. */
285
+ arbiter: string;
286
+ /** Environment for child git processes (identity etc.). */
287
+ env?: NodeJS.ProcessEnv;
288
+ /** Sink for human-readable progress notes. */
289
+ note?: (message: string) => void;
290
+ }
291
+ export interface PromoteFromPreSpecResult {
292
+ /** True iff the staged prd was moved into the pool + committed. */
293
+ moved: boolean;
294
+ /** When `moved`, the committed transition message. */
295
+ commitMessage?: string;
296
+ /** When NOT moved, why (no such prds/proposed item, already in prds/ready/, contention). */
297
+ reasonNotMoved?: string;
298
+ }
299
+ export declare function promoteFromPreSpec(options: PromoteFromPreSpecOptions): Promise<PromoteFromPreSpecResult>;
300
+ /** One staged item awaiting promotion (a task in `pre-backlog/` or a spec in `specs/proposed/`). */
301
+ export interface PromotableItem {
302
+ /** `'task'` (staged in `work/pre-backlog/`) or `'spec'` (staged in `work/specs/proposed/`). */
303
+ namespace: 'task' | 'spec';
304
+ /** The slug (filename minus `.md`). */
305
+ slug: string;
306
+ }
307
+ export interface ListPromotableOptions {
308
+ /** The working clone the arbiter remote is resolved FROM (origin source only). */
309
+ cwd: string;
310
+ /** The arbiter remote whose `main` the staging folders are read from. REQUIRED. */
311
+ arbiter: string;
312
+ /** Environment for child git processes. */
313
+ env?: NodeJS.ProcessEnv;
314
+ }
315
+ export interface ListPromotableResult {
316
+ /** Every staged item awaiting promotion, tasks then prds, each sorted by slug. */
317
+ items: PromotableItem[];
318
+ /** When the listing could not run (no such remote), why. */
319
+ error?: string;
320
+ }
321
+ /**
322
+ * LIST every staged item awaiting a runner/human promotion — the tasks in
323
+ * `work/pre-backlog/` and the prds in `work/prds/proposed/` on `<arbiter>/main` (the
324
+ * discovery half of the `promote` verb, so `promote` with no argument answers
325
+ * "what is staged waiting for me?"). It reads the ARBITER's truth (a fetch + a
326
+ * tree read), NOT the local working tree (which may be stale) — the same source
327
+ * the promotion functions act against, so the list and the move never disagree.
328
+ * Read-only: it never fetches a checkout, never moves anything.
329
+ */
330
+ export declare function listPromotable(options: ListPromotableOptions): Promise<ListPromotableResult>;
331
+ /**
332
+ * Extract the prose written under the `## Needs attention` heading from an item
333
+ * body. Returns the first non-empty line(s) of the block as a single line
334
+ * (stops at the next `## ` heading); '' when no block is present. The
335
+ * needs-attention REASON is now recorded on the per-item lock entry (task
336
+ * `cutover-needs-attention-becomes-lock-stuck-recovery-surface`, decision i+),
337
+ * NOT in the body, but this extractor stays for any historical body text that
338
+ * still carries the heading (a tolerant best-effort read).
339
+ */
340
+ export declare function extractReason(content: string): string;
341
+ //# sourceMappingURL=needs-attention.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"needs-attention.d.ts","sourceRoot":"","sources":["../src/needs-attention.ts"],"names":[],"mappings":"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"}