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,340 @@
1
+ import { type SlugNamespace } from './slug-namespace.js';
2
+ import { type LedgerReadStrategy } from './ledger-read.js';
3
+ import { type SidecarModel, type SidecarType } from './sidecar.js';
4
+ import { type TickClassification } from './advance-classify.js';
5
+ import { type AcquireAdvancingLockResult, type ReleaseAdvancingLockResult } from './advancing-lock.js';
6
+ import { type DoOptions, type DoResult } from './do.js';
7
+ import { type SurfaceGate } from './surface-gate.js';
8
+ import { type TriageGate } from './triage-gate.js';
9
+ import type { ObservationTriage } from './config.js';
10
+ import { type AutoDispositionOptions, type AutoDispositionResult, type PromoteObservationOptions, type PromoteObservationResult } from './triage-persist.js';
11
+ import { type MintAdrOptions, type MintAdrResult } from './mint-adr.js';
12
+ import { type ApplyDecider } from './apply-decide.js';
13
+ import { type SurfacePersistOptions, type SurfacePersistResult } from './surface-persist.js';
14
+ import { type ApplyAnsweredQuestionsOptions, type ApplyAnsweredQuestionsResult } from './apply-persist.js';
15
+ import { type MergeActionHandler } from './apply-merge-action.js';
16
+ import type { VerifyConfig } from './verify.js';
17
+ import type { NewQuestion } from './sidecar.js';
18
+ /**
19
+ * The terminal condition of one `advance` tick (mirrors `DoOutcome`'s shape).
20
+ *
21
+ * `vanished` (task `observation-identity-is-its-filename-not-a-foreign-slug`):
22
+ * a BENIGN SKIP when the item's file was enumerated into the lifecycle pool but
23
+ * has since been moved/triaged/deleted by a sibling leg (the cross-tick window
24
+ * under parallel CI). It is `exitCode: 0` so the matrix tolerates it, but it is
25
+ * DISTINGUISHABLE from `no-op` (which is a calm classify result, e.g. a pending
26
+ * sidecar) so reviewers can grep these out. NOT used for a human-typed bare slug
27
+ * that names nothing — that is a malformed invocation; today the two are not
28
+ * distinguished at this seam (a human typo also skips benignly) and the matrix
29
+ * scale of the calm condition justifies the trade.
30
+ */
31
+ export type AdvanceOutcome = 'advanced' | 'no-op' | 'vanished' | 'usage-error' | 'lost' | 'contended' | 'not-implemented' | 'invariant-violation';
32
+ /** Maps onto the claim-CAS exit codes (identical semantics). */
33
+ export type AdvanceExitCode = 0 | 1 | 2 | 3;
34
+ /**
35
+ * The injectable rung-executor SEAM — WHAT happens once the tick has classified a
36
+ * rung AND won the `advancing` lock. It is the boundary between the skeleton (this
37
+ * task) and the rung bodies (later tasks): the surface/apply/triage rungs are
38
+ * filled by their own tasks; the build/task rungs ORCHESTRATE `do`/`do prd:`.
39
+ *
40
+ * Production wires {@link defaultRungExecutor}; tests inject a spy to assert the
41
+ * classify→lock→dispatch ORDER (and that a CAS loser never reaches the executor).
42
+ */
43
+ export interface RungExecutor {
44
+ /** A ready task → build it by ORCHESTRATING `do <slug>` (NOT a re-implementation). */
45
+ buildTask(input: RungExecInput): Promise<RungExecResult>;
46
+ /** A ready spec → task it by ORCHESTRATING `do spec:<slug>` (NOT a re-implementation). */
47
+ taskSpec(input: RungExecInput): Promise<RungExecResult>;
48
+ /** An untriaged observation → triage it (LATER task fills this body). */
49
+ triageObservation(input: RungExecInput): Promise<RungExecResult>;
50
+ /** `needsAnswers` but no sidecar → surface the questions (LATER task fills this). */
51
+ surface(input: RungExecInput): Promise<RungExecResult>;
52
+ /** Every entry answered → apply the answers + advance (LATER task fills this). */
53
+ apply(input: RungExecInput): Promise<RungExecResult>;
54
+ }
55
+ /** What a rung executor is handed: the resolved identity + the run context. */
56
+ export interface RungExecInput {
57
+ /** The canonical namespaced identity (`task:<slug>` / `prd:<slug>` / `observation:<slug>`). */
58
+ item: string;
59
+ /** The resolved namespace (`task` / `prd` / `observation`). */
60
+ namespace: SlugNamespace;
61
+ /** The bare slug. */
62
+ slug: string;
63
+ /** The classification that selected this rung (the two signals are visible). */
64
+ classification: TickClassification;
65
+ /** The tick's run context (cwd, arbiter, …) — threaded to `do`/`do prd:`. */
66
+ context: AdvanceContext;
67
+ }
68
+ /** A rung executor's result (the outcome the tick reports). */
69
+ export interface RungExecResult {
70
+ exitCode: AdvanceExitCode;
71
+ outcome: AdvanceOutcome;
72
+ message: string;
73
+ }
74
+ /** The run context threaded from the CLI into the tick + the rung executor. */
75
+ export interface AdvanceContext {
76
+ /** The working clone/checkout to run in-place in. */
77
+ cwd: string;
78
+ /** Name of the arbiter git remote. Defaults to `origin`. */
79
+ arbiter?: string;
80
+ /** The base `do` options the build/task rungs orchestrate `performDo` with. */
81
+ doOptions?: Omit<DoOptions, 'arg'>;
82
+ /**
83
+ * The build/task ORCHESTRATION DRIVER seam (task
84
+ * `advance-loop-driver-registry-set-job-worktrees`). The build-task / task-spec
85
+ * rungs ORCHESTRATE `do` by handing the resolved arg + the threaded
86
+ * {@link doOptions} to THIS driver. `undefined` ⇒ {@link performDo} (the IN-PLACE
87
+ * substrate — the human-local one-shot `advance` command + today's
88
+ * single-mirror `run --advance`, which build in the cwd checkout). The
89
+ * registry-set advance driver injects a PER-MIRROR JOB-WORKTREE driver
90
+ * ({@link jobWorktreeDoDriver}) so the daemon/CI path builds isolated off each
91
+ * mirror's arbiter (the SAME isolation `run`'s build tick gives `runOneItem`),
92
+ * NOT in `process.cwd()`. This is the parameterised isolation strategy the
93
+ * task's `## Decisions` records: in-place and worktree COEXIST behind one seam,
94
+ * reusing the EXISTING `selectIsolationStrategy`/`jobWorktreeStrategy` (no second
95
+ * isolation mechanism). The DEFAULT keeps in-place behaviour byte-for-byte.
96
+ */
97
+ doDriver?: (options: DoOptions) => Promise<DoResult>;
98
+ /**
99
+ * The SURFACE gate seam — the fresh-context `surface-questions` spawn the
100
+ * surface rung uses (task `advance-rung-surface`). The skill JUDGES (emits
101
+ * questions); the engine PERSISTS. Production wires {@link harnessSurfaceGate};
102
+ * tests inject a stub emit. `undefined` ⇒ the surface rung defaults to
103
+ * {@link harnessSurfaceGate} (a NullHarness, no real model) so the seam is never
104
+ * a crash — but the CLI threads the real harness-backed gate.
105
+ */
106
+ surfaceGate?: SurfaceGate;
107
+ /**
108
+ * The model the SURFACE agent runs on (de-correlated from the builder, like
109
+ * `reviewModel`). Flows to the gate's launch through `LaunchInput.model`.
110
+ */
111
+ surfaceModel?: string;
112
+ /**
113
+ * Persist the surfaced questions ATOMICALLY (append-or-create the sidecar + set
114
+ * `needsAnswers:true` in ONE commit). Tests inject a spy; production uses
115
+ * {@link persistSurfacedQuestions}. The ENGINE owns ALL persistence — the skill
116
+ * writes nothing.
117
+ */
118
+ surfacePersist?: (options: SurfacePersistOptions) => SurfacePersistResult;
119
+ /**
120
+ * Apply the HUMAN's answered sidecar ATOMICALLY (item body + sidecar in ONE
121
+ * commit, via the sidecar contract's atomic-apply), then resolve / re-pause /
122
+ * disposition to a terminal. Tests inject a spy; production uses
123
+ * {@link applyAnsweredQuestions}. The engine applies ONLY human-authored answers
124
+ * — it NEVER invents one.
125
+ */
126
+ applyPersist?: (options: ApplyAnsweredQuestionsOptions) => ApplyAnsweredQuestionsResult;
127
+ /**
128
+ * Supply the NEW follow-up questions an apply discovered (so it APPENDS them and
129
+ * re-pauses rather than resolving). `undefined`/empty ⇒ the apply resolves (or
130
+ * dispositions) the item. The follow-up GENERATION is the surface skill's job;
131
+ * this seam lets the apply rung append already-formulated follow-ups (and lets
132
+ * tests drive the append-re-pause path) WITHOUT inventing an ANSWER.
133
+ */
134
+ applyFollowups?: NewQuestion[];
135
+ /**
136
+ * The AGENTIC apply DECISION seam (task
137
+ * `agentic-apply-retire-disposition-vocabulary`): the fresh-context decision
138
+ * agent the apply rung runs on a fully-answered OBSERVATION to choose what to DO
139
+ * with the signal (`mint-task | mint-prd | mint-adr | delete-source |
140
+ * ask-follow-up`),
141
+ * grounded in the source's full context. It is the injected
142
+ * {@link ApplyDecider} the shared `decide(input, allowedOutcomes)` engine runs;
143
+ * tests inject a CANNED verdict (no model). `undefined` ⇒ the apply rung defaults
144
+ * to {@link harnessApplyDecider} (a NullHarness, no real model) so the seam is
145
+ * never a crash — but the CLI threads the real harness-backed decider. The
146
+ * verdict's type SELECTION (task vs prd vs adr) replaces the retired `promote-*`
147
+ * disposition token; `adr` is now WIRED (task `agentic-apply-mint-adr-route`).
148
+ */
149
+ applyDecide?: ApplyDecider;
150
+ /** The model the apply-DECISION agent runs on (de-correlated, like `surfaceModel`). */
151
+ applyModel?: string;
152
+ /**
153
+ * The 3-state `observationTriage` policy (ADR `ci-config-policy-and-gate-
154
+ * family` §2) read at the triage rung. It governs the rung-internal
155
+ * ask-vs-auto distinction (the SELECTION-layer `off` gate is applied EARLIER, in
156
+ * the driver, by dropping the observation pool — so a rung that runs was either
157
+ * `ask`/`auto`-selected OR explicitly named, which BYPASSES the selection gate):
158
+ * - `'auto'` ⇒ the conservative auto-disposition EXCEPTION is live (ask the
159
+ * {@link TriageGate}; auto-dispose ONLY the no-question cases);
160
+ * - `'ask'` / `'off'` / `undefined` ⇒ surface the promote/keep/delete question
161
+ * and WAIT (the question-gated path). Under `off` + an EXPLICIT `obs:<slug>`
162
+ * (which bypasses the selection gate) the rung runs in `ask`-mode — the
163
+ * conservative, question-surfacing default (task `## Decisions`). SURFACE +
164
+ * APPLY stay ALWAYS allowed; this gate ONLY governs the auto-disposition
165
+ * exception, never the always-allowed question loop.
166
+ */
167
+ observationTriage?: ObservationTriage;
168
+ /**
169
+ * The TRIAGE auto-disposition gate seam — the fresh-context spawn the triage
170
+ * rung asks (ONLY when `observationTriage` is `'auto'`) whether an observation
171
+ * is a no-question case. The skill JUDGES; the engine ACTS. Production wires
172
+ * {@link harnessTriageGate}; tests inject a stub decision. `undefined` ⇒ the
173
+ * triage rung defaults to {@link harnessTriageGate} (a NullHarness, no real
174
+ * model) so the seam is never a crash.
175
+ */
176
+ triageGate?: TriageGate;
177
+ /** The model the TRIAGE agent runs on (de-correlated, like `surfaceModel`). */
178
+ triageModel?: string;
179
+ /**
180
+ * Execute the conservative auto-disposition ATOMICALLY (record + marker, one
181
+ * commit). Tests inject a spy; production uses {@link autoDispositionObservation}.
182
+ */
183
+ autoDisposition?: (options: AutoDispositionOptions) => AutoDispositionResult;
184
+ /**
185
+ * Promote an answered observation: CAS-create a new backlog stub keyed on the
186
+ * NEW item's identity, then record + resolve the observation. Tests inject a
187
+ * spy; production uses {@link promoteObservation}.
188
+ */
189
+ promote?: (options: PromoteObservationOptions) => Promise<PromoteObservationResult>;
190
+ /**
191
+ * Mint an ADR from an answered observation (the agentic `mint-adr` verdict, task
192
+ * `agentic-apply-mint-adr-route`): CAS-create `docs/adr/<slug>.md` keyed on the
193
+ * NEW ADR's identity, with the source + sidecar deleted in the SAME commit. The
194
+ * SIBLING of {@link promote} for the `docs/adr/` target (an ADR lands OUTSIDE the
195
+ * work board, so it is a distinct route, not a `promoteObservation` artifact
196
+ * type). Tests inject a spy; production uses {@link mintAdr}.
197
+ */
198
+ mintAdr?: (options: MintAdrOptions) => Promise<MintAdrResult>;
199
+ /**
200
+ * The NEW backlog slug an answered promote drafts. `undefined` ⇒ the promote
201
+ * defaults to the observation's own slug. Lets a test (or a future driver) steer
202
+ * the promoted item's identity WITHOUT inventing the answer.
203
+ */
204
+ promoteSlug?: string;
205
+ /**
206
+ * The execution working area (`workspacesDir`, default `~/.dorfl`) the
207
+ * answered-merge LAND uses to cut a per-job worktree from the hub mirror
208
+ * (via `workspace.ts` `createJob`). Unset ⇒ no `workspacesDir` is available
209
+ * to the dispatcher, so an answered `kind: merge` entry is REFUSED (clean
210
+ * surfacing); the answer stays for a follow-up. The registry-set advance
211
+ * driver threads the resolved `workspacesDir` here.
212
+ * (prd `land-time-reverify-and-parallel-merge-ceiling`, task
213
+ * `apply-rung-merge-disposition`)
214
+ */
215
+ workspacesDir?: string;
216
+ /**
217
+ * The arbiter URL the answered-merge LAND mirrors from. Optional: when
218
+ * unset the dispatcher resolves it via `git remote get-url <arbiter>` in the
219
+ * apply rung's `cwd` (the in-place / one-shot caller). The registry-set
220
+ * advance driver threads the per-mirror origin URL here directly so the
221
+ * per-mirror tree-less clone (whose `origin` points at the LOCAL mirror
222
+ * path, not the real arbiter URL) is bypassed.
223
+ */
224
+ arbiterUrl?: string;
225
+ /**
226
+ * Per-repo env-prep config (`prepare`) the answered-merge LAND threads into
227
+ * `performIntegration` so the fresh-worktree gate runs `prepare` then
228
+ * `verify` on the rebased tip — the SAME config the build path uses.
229
+ */
230
+ prepare?: VerifyConfig;
231
+ /**
232
+ * Per-repo acceptance gate (`verify`) the answered-merge LAND threads into
233
+ * `performIntegration` so the fresh-worktree gate re-verifies the rebased
234
+ * tip before integrating.
235
+ */
236
+ verify?: VerifyConfig;
237
+ /**
238
+ * Resolved `strictMergeApproval` boolean (sibling task
239
+ * `strict-merge-approval-gate`). Default OFF ⇒ honour the prior approval +
240
+ * land on a green re-verify (cheap, the PRD-applied OQ6 default). ON ⇒
241
+ * re-surface the merge-question when the merge-base moved between the
242
+ * surfacer's question and this apply (the host-agnostic analogue of
243
+ * GitHub's "dismiss stale approvals when the base changes").
244
+ */
245
+ strictMergeApproval?: boolean;
246
+ /**
247
+ * The merge-action dispatch SEAM (task `apply-rung-merge-disposition`):
248
+ * the deterministic answer-driven runner-action handler the apply rung
249
+ * invokes BEFORE the agentic decider when an answered `kind: merge` entry
250
+ * is detected. Production wires {@link performMergeAction} (checks out via
251
+ * `createJob` + lands via `performIntegration` with `committedRecovery:
252
+ * true` + `freshWorktreeGate: true`); tests inject a stub so they assert on
253
+ * the apply-rung's `landed | refused | restale | hold | drop` routing
254
+ * WITHOUT spinning up a hub mirror or running real verify.
255
+ */
256
+ mergeAction?: MergeActionHandler;
257
+ /** Sink for human-readable progress notes. */
258
+ note?: (message: string) => void;
259
+ }
260
+ /** The options one `advance` tick consumes. */
261
+ export interface AdvanceOptions extends AdvanceContext {
262
+ /**
263
+ * The raw CLI slug argument: bare (= task), `task:<slug>`, `prd:<slug>`, or
264
+ * `obs:<slug>` / `observation:<slug>`. Omit/empty ⇒ the bare eligible-SET form,
265
+ * which needs the driver task (a clear error here — see `## Decisions`).
266
+ */
267
+ arg?: string;
268
+ /** The repo working-tree root whose `work/` to read (defaults to `cwd`). */
269
+ repoPath?: string;
270
+ /** The read seam for the resolver's cross-namespace existence check. */
271
+ read?: LedgerReadStrategy;
272
+ /** The rung executor seam (defaults to {@link defaultRungExecutor}). */
273
+ executor?: RungExecutor;
274
+ /** Inject the classify signals (tests); production reads them from disk. */
275
+ readSignals?: (input: ReadSignalsInput) => ItemSignals;
276
+ /** Inject the lock acquire (tests); production uses {@link acquireAdvancingLock}. */
277
+ acquireLock?: (item: string) => Promise<AcquireAdvancingLockResult>;
278
+ /** Inject the lock release (tests); production uses {@link releaseAdvancingLock}. */
279
+ releaseLock?: (item: string) => Promise<ReleaseAdvancingLockResult>;
280
+ }
281
+ /** The tick's terminal result. */
282
+ export interface AdvanceResult {
283
+ exitCode: AdvanceExitCode;
284
+ outcome: AdvanceOutcome;
285
+ /** The classified rung kind, when the tick got far enough to classify. */
286
+ rung?: TickClassification['kind'];
287
+ /** The resolved bare slug acted on, when one was resolved. */
288
+ slug?: string;
289
+ /** Human-readable summary of the terminal condition. */
290
+ message: string;
291
+ }
292
+ /** The two classify SIGNALS read off the item (the only state the classifier needs). */
293
+ export interface ItemSignals {
294
+ /** The item-body `needsAnswers` flag. */
295
+ needsAnswers: boolean | undefined;
296
+ /** The parsed ACTIVE sidecar, or `undefined` when none exists. */
297
+ sidecar: SidecarModel | undefined;
298
+ }
299
+ /** What {@link readItemSignals} needs to read an item's two signals off disk. */
300
+ export interface ReadSignalsInput {
301
+ /** The repo working-tree root. */
302
+ repoPath: string;
303
+ /** The item type (task / prd / observation). */
304
+ type: SidecarType;
305
+ /** The bare slug. */
306
+ slug: string;
307
+ /** The canonical namespaced identity (`<namespace>:<slug>`). */
308
+ item: string;
309
+ }
310
+ /**
311
+ * Read an item's two CLASSIFY signals off disk (read-only, NO model, NO lock):
312
+ * - `needsAnswers` from the item-body frontmatter (searching the lifecycle
313
+ * folders the type may rest in), and
314
+ * - the ACTIVE sidecar (`work/questions/<type>-<slug>.md`) parsed when present.
315
+ *
316
+ * Identity-keyed: the sidecar path derives PURELY from `<type>-<slug>` (it
317
+ * survives the item's `git mv`s with no lock-step move). Returns
318
+ * `needsAnswers:undefined` when no item file is found (the classifier treats it
319
+ * as "not gated", an ANALYSE rung) — the verb's job here is to wire the two
320
+ * signals, not to assert the item exists (that is the rung's concern).
321
+ */
322
+ export declare function readItemSignals(input: ReadSignalsInput): ItemSignals;
323
+ /**
324
+ * The PRODUCTION rung executor: build/task rungs ORCHESTRATE the existing
325
+ * `do`/`do prd:` machinery ({@link performDo}); the `surface`/`apply`/
326
+ * `triage-observation` rung bodies are filled by their own tasks
327
+ * ({@link surfaceRung} / {@link applyRung} / {@link triageRung}). It NEVER
328
+ * re-implements the build/task path — it hands the resolved arg to `performDo`,
329
+ * which spans both namespaces (the task path is the `do prd:` rung the prd's
330
+ * 2026-06-09 UPDATE confirms routes through `performIntegration`).
331
+ */
332
+ export declare const defaultRungExecutor: RungExecutor;
333
+ /**
334
+ * Run ONE `advance` tick over a SINGLE named item: classify → lock → dispatch →
335
+ * release. The pure tick the drivers (later tasks) wrap. The expensive phase is
336
+ * ALWAYS post-lock — a CAS loser backs off having done ONLY the free
337
+ * classification (it never reaches the executor).
338
+ */
339
+ export declare function performAdvance(options: AdvanceOptions): Promise<AdvanceResult>;
340
+ //# sourceMappingURL=advance.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"advance.d.ts","sourceRoot":"","sources":["../src/advance.ts"],"names":[],"mappings":"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"}