orkeon-code 0.0.0-stage → 1.0.0-rc.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (423) hide show
  1. package/.orkeon-version +1 -0
  2. package/LICENSE.md +21 -0
  3. package/NOTICE.md +17 -0
  4. package/README.fr.md +169 -0
  5. package/README.md +162 -2
  6. package/config/appsettings.anthropic.example.json +77 -0
  7. package/config/appsettings.example.json +71 -0
  8. package/config/appsettings.jev.example.json +128 -0
  9. package/config/appsettings.kev.example.json +130 -0
  10. package/config/appsettings.liquid.example.json +129 -0
  11. package/config/appsettings.ollama-whisper.example.json +92 -0
  12. package/config/appsettings.ollama.example.json +70 -0
  13. package/config/appsettings.whisper.example.json +31 -0
  14. package/mcp/whisper/README.md +293 -0
  15. package/mcp/whisper/pyproject.toml +32 -0
  16. package/mcp/whisper/uv.lock +1641 -0
  17. package/mcp/whisper/whisper_mcp.py +1053 -0
  18. package/orkeon-code +897 -0
  19. package/orkeon-code.mjs +71 -0
  20. package/orkeon-code.ps1 +837 -0
  21. package/package.json +57 -4
  22. package/scripts/install.ps1 +156 -0
  23. package/scripts/install.sh +148 -0
  24. package/scripts/session-start.ork.ts +90 -0
  25. package/scripts/session-start.sh +74 -0
  26. package/scripts/setup-fixture.sh +88 -0
  27. package/src/commands/.orkeon/orkeon-cli.d.ts +562 -0
  28. package/src/commands/_lib/args.ts +193 -0
  29. package/src/commands/_lib/dev/dev-batches.ts +368 -0
  30. package/src/commands/_lib/dev/dev-implement.ts +188 -0
  31. package/src/commands/_lib/dev/dev-source.ts +65 -0
  32. package/src/commands/_lib/dev/dev.ts +344 -0
  33. package/src/commands/_lib/dev-step.ts +142 -0
  34. package/src/commands/_lib/dispatch.ts +231 -0
  35. package/src/commands/_lib/effort.ts +15 -0
  36. package/src/commands/_lib/git/branch.ts +95 -0
  37. package/src/commands/_lib/git/commit.ts +94 -0
  38. package/src/commands/_lib/git/diff.ts +97 -0
  39. package/src/commands/_lib/git/review.ts +109 -0
  40. package/src/commands/_lib/memory/memory-admit.ts +150 -0
  41. package/src/commands/_lib/memory/memory.ts +51 -0
  42. package/src/commands/_lib/pr-context.ts +32 -0
  43. package/src/commands/_lib/project/analyze.ts +24 -0
  44. package/src/commands/_lib/session/export.ts +104 -0
  45. package/src/commands/_lib/session/resume.ts +160 -0
  46. package/src/commands/_lib/session/tasks.ts +184 -0
  47. package/src/commands/_lib/settings/advisor.ts +80 -0
  48. package/src/commands/_lib/settings/agents.ts +147 -0
  49. package/src/commands/_lib/settings/config.ts +141 -0
  50. package/src/commands/_lib/settings/hooks.ts +58 -0
  51. package/src/commands/_lib/settings/mode.ts +91 -0
  52. package/src/commands/_lib/settings/model.ts +146 -0
  53. package/src/commands/_lib/settings/permissions.ts +309 -0
  54. package/src/commands/_lib/settings/session-config.ts +49 -0
  55. package/src/commands/_lib/settings/skills.ts +51 -0
  56. package/src/commands/_lib/speech/say.ts +96 -0
  57. package/src/commands/_lib/speech/transcribe.ts +130 -0
  58. package/src/commands/_lib/speech/voice.ts +146 -0
  59. package/src/commands/_lib/status/cache.ts +31 -0
  60. package/src/commands/_lib/status/context.ts +57 -0
  61. package/src/commands/_lib/status/doctor.ts +186 -0
  62. package/src/commands/_lib/status/meta.ts +45 -0
  63. package/src/commands/_lib/status/status.ts +129 -0
  64. package/src/commands/_lib/status/usage-tools.ts +49 -0
  65. package/src/commands/_lib/status/usage.ts +139 -0
  66. package/src/commands/_lib/view.ts +29 -0
  67. package/src/commands/dev/dev-batches.cmd.ts +108 -0
  68. package/src/commands/dev/dev-learn.cmd.ts +29 -0
  69. package/src/commands/dev/dev-plan.cmd.ts +52 -0
  70. package/src/commands/dev/dev-spec.cmd.ts +55 -0
  71. package/src/commands/dev/dev-status.cmd.ts +16 -0
  72. package/src/commands/git/branch.cmd.ts +27 -0
  73. package/src/commands/git/commit.cmd.ts +48 -0
  74. package/src/commands/git/diff.cmd.ts +26 -0
  75. package/src/commands/git/review.cmd.ts +36 -0
  76. package/src/commands/memory/memory.cmd.ts +48 -0
  77. package/src/commands/project/analyze.cmd.ts +32 -0
  78. package/src/commands/project/debug-tool-call.cmd.ts +67 -0
  79. package/src/commands/project/files.cmd.ts +22 -0
  80. package/src/commands/project/init-verifiers.cmd.ts +14 -0
  81. package/src/commands/project/init.cmd.ts +14 -0
  82. package/src/commands/project/verify.cmd.ts +27 -0
  83. package/src/commands/session/assistant.cmd.ts +40 -0
  84. package/src/commands/session/btw.cmd.ts +18 -0
  85. package/src/commands/session/clear.cmd.ts +19 -0
  86. package/src/commands/session/compact.cmd.ts +16 -0
  87. package/src/commands/session/copy.cmd.ts +44 -0
  88. package/src/commands/session/exit.cmd.ts +9 -0
  89. package/src/commands/session/export.cmd.ts +28 -0
  90. package/src/commands/session/rename.cmd.ts +17 -0
  91. package/src/commands/session/resume.cmd.ts +19 -0
  92. package/src/commands/session/rewind.cmd.ts +26 -0
  93. package/src/commands/session/summary.cmd.ts +27 -0
  94. package/src/commands/session/tasks.cmd.ts +44 -0
  95. package/src/commands/settings/advisor.cmd.ts +38 -0
  96. package/src/commands/settings/agents.cmd.ts +19 -0
  97. package/src/commands/settings/config.cmd.ts +17 -0
  98. package/src/commands/settings/effort.cmd.ts +40 -0
  99. package/src/commands/settings/fast.cmd.ts +17 -0
  100. package/src/commands/settings/hooks.cmd.ts +17 -0
  101. package/src/commands/settings/mode.cmd.ts +20 -0
  102. package/src/commands/settings/model.cmd.ts +20 -0
  103. package/src/commands/settings/output-style.cmd.ts +48 -0
  104. package/src/commands/settings/permissions.cmd.ts +25 -0
  105. package/src/commands/settings/proactive.cmd.ts +15 -0
  106. package/src/commands/settings/skills.cmd.ts +17 -0
  107. package/src/commands/speech/say.cmd.ts +24 -0
  108. package/src/commands/speech/transcribe.cmd.ts +29 -0
  109. package/src/commands/speech/voice.cmd.ts +30 -0
  110. package/src/commands/status/context.cmd.ts +18 -0
  111. package/src/commands/status/doctor.cmd.ts +27 -0
  112. package/src/commands/status/release-notes.cmd.ts +9 -0
  113. package/src/commands/status/status.cmd.ts +25 -0
  114. package/src/commands/status/usage.cmd.ts +21 -0
  115. package/src/crews/.orkeon/orkeon.d.ts +3946 -0
  116. package/src/crews/_probe-shared-memory/domain/probe-verdict.ts +183 -0
  117. package/src/crews/_probe-shared-memory/probe.ork.ts +98 -0
  118. package/src/crews/advisor/application/run-advisor.ts +40 -0
  119. package/src/crews/advisor/crew.ork.ts +43 -0
  120. package/src/crews/advisor/domain/advice.ts +135 -0
  121. package/src/crews/agent-run/application/run-agent-run.ts +42 -0
  122. package/src/crews/agent-run/crew.ork.ts +67 -0
  123. package/src/crews/analyze/application/run-analyze.ts +118 -0
  124. package/src/crews/analyze/crew.ork.ts +40 -0
  125. package/src/crews/analyze/domain/harvest.ts +301 -0
  126. package/src/crews/code-review/application/prompts.ts +133 -0
  127. package/src/crews/code-review/application/review.ts +71 -0
  128. package/src/crews/code-review/application/run-code-review.ts +123 -0
  129. package/src/crews/code-review/crew.ork.ts +51 -0
  130. package/src/crews/code-review/domain/lenses.ts +193 -0
  131. package/src/crews/code-review/domain/report.ts +59 -0
  132. package/src/crews/code-review/domain/scope.ts +112 -0
  133. package/src/crews/dev-batches/application/plan-close.ts +181 -0
  134. package/src/crews/dev-batches/application/run-dev-batches.ts +669 -0
  135. package/src/crews/dev-batches/application/run-wave.ts +450 -0
  136. package/src/crews/dev-batches/application/seed-harvest.ts +162 -0
  137. package/src/crews/dev-batches/crew.ork.ts +143 -0
  138. package/src/crews/dev-batches/domain/batch-waves.ts +70 -0
  139. package/src/crews/dev-batches/domain/batches-budget.ts +52 -0
  140. package/src/crews/dev-batches/domain/batches-log.ts +54 -0
  141. package/src/crews/dev-batches/domain/wave-order.ts +43 -0
  142. package/src/crews/dev-change/application/change-prompt.ts +104 -0
  143. package/src/crews/dev-change/application/evidence.ts +169 -0
  144. package/src/crews/dev-change/application/run-dev-change.ts +315 -0
  145. package/src/crews/dev-change/crew.ork.ts +112 -0
  146. package/src/crews/dev-change/domain/change-answer.ts +159 -0
  147. package/src/crews/dev-change/domain/change-render.ts +79 -0
  148. package/src/crews/dev-implement/application/close.ts +183 -0
  149. package/src/crews/dev-implement/application/count-open-steps.ts +24 -0
  150. package/src/crews/dev-implement/application/locate-sheet.ts +80 -0
  151. package/src/crews/dev-implement/application/observe.ts +50 -0
  152. package/src/crews/dev-implement/application/report-writes.ts +41 -0
  153. package/src/crews/dev-implement/application/run-dev-implement.ts +811 -0
  154. package/src/crews/dev-implement/application/run-role.ts +27 -0
  155. package/src/crews/dev-implement/application/suite-job.ts +118 -0
  156. package/src/crews/dev-implement/application/touched.ts +74 -0
  157. package/src/crews/dev-implement/crew.ork.ts +68 -0
  158. package/src/crews/dev-implement/domain/contracts.ts +256 -0
  159. package/src/crews/dev-implement/domain/correction.ts +102 -0
  160. package/src/crews/dev-implement/domain/cycles.ts +35 -0
  161. package/src/crews/dev-implement/domain/implement-budget.ts +29 -0
  162. package/src/crews/dev-implement/domain/roles.ts +53 -0
  163. package/src/crews/dev-implement/domain/sheet-edits.ts +75 -0
  164. package/src/crews/dev-implement/domain/sheet-ticks.ts +22 -0
  165. package/src/crews/dev-implement/domain/step-checks.ts +136 -0
  166. package/src/crews/dev-implement/domain/step-section.ts +127 -0
  167. package/src/crews/dev-learn/application/learn-backlog.ts +58 -0
  168. package/src/crews/dev-learn/application/learn-prompt.ts +140 -0
  169. package/src/crews/dev-learn/application/run-dev-learn.ts +553 -0
  170. package/src/crews/dev-learn/crew.ork.ts +52 -0
  171. package/src/crews/dev-learn/domain/learn-answer.ts +235 -0
  172. package/src/crews/dev-learn/domain/owner-lines.ts +86 -0
  173. package/src/crews/dev-learn/domain/proposals-render.ts +96 -0
  174. package/src/crews/dev-plan/application/anchor-paths.ts +76 -0
  175. package/src/crews/dev-plan/application/inventory.ts +170 -0
  176. package/src/crews/dev-plan/application/plan-prompt.ts +159 -0
  177. package/src/crews/dev-plan/application/run-dev-plan.ts +455 -0
  178. package/src/crews/dev-plan/crew.ork.ts +109 -0
  179. package/src/crews/dev-plan/domain/inventory-model.ts +95 -0
  180. package/src/crews/dev-plan/domain/plan-answer.ts +738 -0
  181. package/src/crews/dev-plan/domain/plan-render.ts +307 -0
  182. package/src/crews/dev-spec/application/run-dev-spec.ts +206 -0
  183. package/src/crews/dev-spec/application/spec-prompt.ts +98 -0
  184. package/src/crews/dev-spec/crew.ork.ts +108 -0
  185. package/src/crews/dev-spec/domain/spec-answer.ts +253 -0
  186. package/src/crews/dev-spec/domain/spec-render.ts +76 -0
  187. package/src/crews/dev-verify/application/audit.ts +259 -0
  188. package/src/crews/dev-verify/application/auditor-prompt.ts +323 -0
  189. package/src/crews/dev-verify/application/capture.ts +303 -0
  190. package/src/crews/dev-verify/application/run-dev-verify.ts +409 -0
  191. package/src/crews/dev-verify/application/run-gate.ts +202 -0
  192. package/src/crews/dev-verify/crew.ork.ts +103 -0
  193. package/src/crews/dev-verify/domain/audit-answer.ts +150 -0
  194. package/src/crews/dev-verify/domain/auditor-charter.ts +21 -0
  195. package/src/crews/dev-verify/domain/capture-sections.ts +137 -0
  196. package/src/crews/dev-verify/domain/commands.ts +103 -0
  197. package/src/crews/dev-verify/domain/gate.ts +126 -0
  198. package/src/crews/dev-verify/domain/mechanical-table.ts +163 -0
  199. package/src/crews/dev-verify/domain/runtime-cut.ts +13 -0
  200. package/src/crews/dev-verify/domain/sheet-facts.ts +4 -0
  201. package/src/crews/dev-verify/domain/text.ts +20 -0
  202. package/src/crews/dev-verify/domain/verdict.ts +127 -0
  203. package/src/crews/git-commit/application/draft.ts +154 -0
  204. package/src/crews/git-commit/application/run-git-commit.ts +116 -0
  205. package/src/crews/git-commit/crew.ork.ts +52 -0
  206. package/src/crews/git-commit/domain/commit.ts +220 -0
  207. package/src/crews/init-verifiers/application/authoring.ts +89 -0
  208. package/src/crews/init-verifiers/application/prompts.ts +103 -0
  209. package/src/crews/init-verifiers/application/run-init-verifiers.ts +25 -0
  210. package/src/crews/init-verifiers/crew.ork.ts +34 -0
  211. package/src/crews/init-verifiers/domain/commands-section.ts +36 -0
  212. package/src/crews/init-verifiers/domain/readiness.ts +23 -0
  213. package/src/crews/main-loop/application/auto-compact.ts +77 -0
  214. package/src/crews/main-loop/application/context-gather.ts +133 -0
  215. package/src/crews/main-loop/application/run-main-loop.ts +350 -0
  216. package/src/crews/main-loop/application/turn-prompt.ts +112 -0
  217. package/src/crews/main-loop/crew.ork.ts +119 -0
  218. package/src/crews/main-loop/domain/autocompact.ts +27 -0
  219. package/src/crews/main-loop/domain/prompt-assembly.ts +521 -0
  220. package/src/crews/main-loop/domain/turn-chains.ts +129 -0
  221. package/src/crews/project-init/application/detect.ts +122 -0
  222. package/src/crews/project-init/application/prompts.ts +101 -0
  223. package/src/crews/project-init/application/run-project-init.ts +31 -0
  224. package/src/crews/project-init/crew.ork.ts +35 -0
  225. package/src/crews/project-init/domain/conventions.ts +36 -0
  226. package/src/crews/project-init/domain/existing-files.ts +63 -0
  227. package/src/crews/project-init/domain/package-map.ts +73 -0
  228. package/src/crews/session-compact/crew.ork.ts +55 -0
  229. package/src/crews/shared-memory-admit/crew.ork.ts +48 -0
  230. package/src/crews/speech/application/run-speech.ts +25 -0
  231. package/src/crews/speech/crew.ork.ts +37 -0
  232. package/src/shared/application/agents/child-agent.ts +255 -0
  233. package/src/shared/application/agents/run-sub-agent.ts +96 -0
  234. package/src/shared/application/answer-language.ts +14 -0
  235. package/src/shared/application/attached-skills.ts +36 -0
  236. package/src/shared/application/compaction/compact-session.ts +237 -0
  237. package/src/shared/application/compaction/extract-memories.ts +38 -0
  238. package/src/shared/application/compaction/restore-context.ts +78 -0
  239. package/src/shared/application/config-store.ts +123 -0
  240. package/src/shared/application/dev/brief-inventory.ts +113 -0
  241. package/src/shared/application/dev/close-batch.ts +83 -0
  242. package/src/shared/application/dev/find-repo-pack.ts +77 -0
  243. package/src/shared/application/dev/learn-decision.ts +252 -0
  244. package/src/shared/application/dev/load-dev-context.ts +266 -0
  245. package/src/shared/application/dev/measure-access-cost.ts +68 -0
  246. package/src/shared/application/dev/plan-source.ts +112 -0
  247. package/src/shared/application/dev/preflight.ts +71 -0
  248. package/src/shared/application/dev/project-files.ts +17 -0
  249. package/src/shared/application/dev/question-round.ts +52 -0
  250. package/src/shared/application/dev/resolve-work-folder.ts +133 -0
  251. package/src/shared/application/dev/script-tool-slot.ts +27 -0
  252. package/src/shared/application/dev/settle-questions.ts +55 -0
  253. package/src/shared/application/dev/source-review.ts +63 -0
  254. package/src/shared/application/dev/source-step.ts +150 -0
  255. package/src/shared/application/dev/spend.ts +42 -0
  256. package/src/shared/application/dev/step-precedents.ts +89 -0
  257. package/src/shared/application/dev/tool-call-policy.ts +89 -0
  258. package/src/shared/application/dev/tool-callbacks.ts +215 -0
  259. package/src/shared/application/dev/tool-trace-recorder.ts +45 -0
  260. package/src/shared/application/dev/verdict-sources.ts +48 -0
  261. package/src/shared/application/dev/wrapped-tools.ts +145 -0
  262. package/src/shared/application/extra-tools.ts +70 -0
  263. package/src/shared/application/git/batch-worktree.ts +97 -0
  264. package/src/shared/application/git/commit-files.ts +186 -0
  265. package/src/shared/application/git/merge-batch.ts +63 -0
  266. package/src/shared/application/git/open-pull-request.ts +51 -0
  267. package/src/shared/application/instructions-file.ts +19 -0
  268. package/src/shared/application/json-file.ts +34 -0
  269. package/src/shared/application/llm-profile.ts +35 -0
  270. package/src/shared/application/permission-rules.ts +159 -0
  271. package/src/shared/application/ports/approvals.ts +20 -0
  272. package/src/shared/application/ports/clock.ts +5 -0
  273. package/src/shared/application/ports/code-index.ts +93 -0
  274. package/src/shared/application/ports/crew.ts +60 -0
  275. package/src/shared/application/ports/files.ts +21 -0
  276. package/src/shared/application/ports/human.ts +13 -0
  277. package/src/shared/application/ports/llm.ts +54 -0
  278. package/src/shared/application/ports/memory.ts +30 -0
  279. package/src/shared/application/ports/progress.ts +23 -0
  280. package/src/shared/application/ports/runtime.ts +15 -0
  281. package/src/shared/application/ports/session.ts +74 -0
  282. package/src/shared/application/ports/shared-memory.ts +26 -0
  283. package/src/shared/application/ports/shell.ts +40 -0
  284. package/src/shared/application/ports/telemetry.ts +45 -0
  285. package/src/shared/application/ports/tools.ts +46 -0
  286. package/src/shared/application/ports/usage.ts +45 -0
  287. package/src/shared/application/ports.ts +27 -0
  288. package/src/shared/application/project-manifests.ts +106 -0
  289. package/src/shared/application/session-io.ts +84 -0
  290. package/src/shared/application/session-state.ts +36 -0
  291. package/src/shared/application/shared-memory/admit-entries.ts +177 -0
  292. package/src/shared/application/shared-memory/harvest-after-gaps.ts +72 -0
  293. package/src/shared/application/shared-memory/harvest-mistakes.ts +44 -0
  294. package/src/shared/application/shared-memory/import-agent-memory.ts +117 -0
  295. package/src/shared/application/shared-memory/memory-files.ts +110 -0
  296. package/src/shared/application/shared-memory/memory-settings.ts +93 -0
  297. package/src/shared/application/shared-memory/push-candidate.ts +146 -0
  298. package/src/shared/application/shared-memory/recall-precedents.ts +69 -0
  299. package/src/shared/application/state-snapshot.ts +38 -0
  300. package/src/shared/application/workflow/workflow-state.ts +135 -0
  301. package/src/shared/domain/agent-policy/behavior-flags.ts +168 -0
  302. package/src/shared/domain/agent-policy/extra-tools.ts +69 -0
  303. package/src/shared/domain/agent-policy/memory-categories.ts +6 -0
  304. package/src/shared/domain/agent-policy/mode-policy.ts +51 -0
  305. package/src/shared/domain/agent-policy/output-styles.ts +11 -0
  306. package/src/shared/domain/agent-policy/permission.ts +623 -0
  307. package/src/shared/domain/agent-policy/rule-sets.ts +412 -0
  308. package/src/shared/domain/agent-policy/tool-access.ts +77 -0
  309. package/src/shared/domain/agent-registry.ts +142 -0
  310. package/src/shared/domain/agents/built-in-charters.ts +43 -0
  311. package/src/shared/domain/agents/chain.ts +30 -0
  312. package/src/shared/domain/agents/charter.ts +61 -0
  313. package/src/shared/domain/agents/exclusive.ts +24 -0
  314. package/src/shared/domain/agents/instances.ts +249 -0
  315. package/src/shared/domain/code-intel-contract.ts +356 -0
  316. package/src/shared/domain/code-intel-routing.ts +113 -0
  317. package/src/shared/domain/compact-outcome.ts +44 -0
  318. package/src/shared/domain/compaction-thresholds.ts +161 -0
  319. package/src/shared/domain/compaction.ts +379 -0
  320. package/src/shared/domain/config-schema.ts +421 -0
  321. package/src/shared/domain/dev/access-cost.ts +226 -0
  322. package/src/shared/domain/dev/artefacts.ts +50 -0
  323. package/src/shared/domain/dev/batches-concurrency.ts +36 -0
  324. package/src/shared/domain/dev/batches-state.ts +49 -0
  325. package/src/shared/domain/dev/build-commands.ts +44 -0
  326. package/src/shared/domain/dev/call-guard.ts +341 -0
  327. package/src/shared/domain/dev/carried-text.ts +49 -0
  328. package/src/shared/domain/dev/design-rules.ts +100 -0
  329. package/src/shared/domain/dev/learn-proposals.ts +175 -0
  330. package/src/shared/domain/dev/learn-state.ts +93 -0
  331. package/src/shared/domain/dev/path-args.ts +42 -0
  332. package/src/shared/domain/dev/path-rebase.ts +93 -0
  333. package/src/shared/domain/dev/plan-checks.ts +190 -0
  334. package/src/shared/domain/dev/plan-format.ts +180 -0
  335. package/src/shared/domain/dev/project-files.ts +43 -0
  336. package/src/shared/domain/dev/questions.ts +249 -0
  337. package/src/shared/domain/dev/reading-rule.ts +41 -0
  338. package/src/shared/domain/dev/repo-pack.ts +237 -0
  339. package/src/shared/domain/dev/review-answer.ts +150 -0
  340. package/src/shared/domain/dev/review-prompt.ts +221 -0
  341. package/src/shared/domain/dev/reviewer-charter.ts +31 -0
  342. package/src/shared/domain/dev/sheet-facts.ts +83 -0
  343. package/src/shared/domain/dev/spec-format.ts +183 -0
  344. package/src/shared/domain/dev/step-budget.ts +72 -0
  345. package/src/shared/domain/dev/step-rules.ts +110 -0
  346. package/src/shared/domain/dev/test-commands.ts +90 -0
  347. package/src/shared/domain/dev/test-output.ts +33 -0
  348. package/src/shared/domain/dev/test-paths.ts +40 -0
  349. package/src/shared/domain/dev/tool-guards.ts +64 -0
  350. package/src/shared/domain/dev/trait-pattern.ts +83 -0
  351. package/src/shared/domain/dev/verdict-format.ts +169 -0
  352. package/src/shared/domain/dev/whitespace.ts +34 -0
  353. package/src/shared/domain/dev/work-folder.ts +67 -0
  354. package/src/shared/domain/dev/yaml-subset.ts +403 -0
  355. package/src/shared/domain/git/close.ts +273 -0
  356. package/src/shared/domain/git/pull-request.ts +96 -0
  357. package/src/shared/domain/git/worktree.ts +46 -0
  358. package/src/shared/domain/index-languages.ts +16 -0
  359. package/src/shared/domain/instructions-file.ts +18 -0
  360. package/src/shared/domain/iso-day.ts +4 -0
  361. package/src/shared/domain/llm-failure.ts +106 -0
  362. package/src/shared/domain/llm-profile.ts +25 -0
  363. package/src/shared/domain/marked-message.ts +33 -0
  364. package/src/shared/domain/model-catalog.ts +86 -0
  365. package/src/shared/domain/permission-modes.ts +103 -0
  366. package/src/shared/domain/prelude.ts +92 -0
  367. package/src/shared/domain/project-manifests.ts +83 -0
  368. package/src/shared/domain/search-routing.ts +85 -0
  369. package/src/shared/domain/secret-patterns.ts +45 -0
  370. package/src/shared/domain/session-keys.ts +85 -0
  371. package/src/shared/domain/session-start.ts +60 -0
  372. package/src/shared/domain/session-summary.ts +13 -0
  373. package/src/shared/domain/severity.ts +72 -0
  374. package/src/shared/domain/sha1.ts +61 -0
  375. package/src/shared/domain/shared-memory/agent-memory-import.ts +143 -0
  376. package/src/shared/domain/shared-memory/candidates.ts +41 -0
  377. package/src/shared/domain/shared-memory/entry.ts +145 -0
  378. package/src/shared/domain/shared-memory/front-matter.ts +183 -0
  379. package/src/shared/domain/shared-memory/gate.ts +44 -0
  380. package/src/shared/domain/shared-memory/harvest.ts +61 -0
  381. package/src/shared/domain/shared-memory/layout.ts +187 -0
  382. package/src/shared/domain/shared-memory/precedents-block.ts +93 -0
  383. package/src/shared/domain/shared-memory/refused.ts +84 -0
  384. package/src/shared/domain/shared-memory/verdict-rows.ts +134 -0
  385. package/src/shared/domain/snip-turns.ts +45 -0
  386. package/src/shared/domain/speech.ts +20 -0
  387. package/src/shared/domain/strip.ts +88 -0
  388. package/src/shared/domain/tool-trace.ts +122 -0
  389. package/src/shared/domain/types.ts +67 -0
  390. package/src/shared/domain/verifiers.ts +37 -0
  391. package/src/shared/domain/vfs.ts +9 -0
  392. package/src/shared/domain/workflow/state-file.ts +140 -0
  393. package/src/shared/infrastructure/globals.ts +52 -0
  394. package/src/shared/infrastructure/orkeon/approvals.ts +24 -0
  395. package/src/shared/infrastructure/orkeon/child-agents.ts +127 -0
  396. package/src/shared/infrastructure/orkeon/code-index.ts +120 -0
  397. package/src/shared/infrastructure/orkeon/crew-host.ts +27 -0
  398. package/src/shared/infrastructure/orkeon/crew-memory.ts +12 -0
  399. package/src/shared/infrastructure/orkeon/dev-deps.ts +172 -0
  400. package/src/shared/infrastructure/orkeon/files.ts +40 -0
  401. package/src/shared/infrastructure/orkeon/github-pull-requests.ts +29 -0
  402. package/src/shared/infrastructure/orkeon/host-provider.ts +22 -0
  403. package/src/shared/infrastructure/orkeon/human-input.ts +59 -0
  404. package/src/shared/infrastructure/orkeon/llm-profile.ts +38 -0
  405. package/src/shared/infrastructure/orkeon/llm.ts +109 -0
  406. package/src/shared/infrastructure/orkeon/memory-store.ts +41 -0
  407. package/src/shared/infrastructure/orkeon/memory-tools.ts +131 -0
  408. package/src/shared/infrastructure/orkeon/permission-rules.ts +42 -0
  409. package/src/shared/infrastructure/orkeon/progress.ts +24 -0
  410. package/src/shared/infrastructure/orkeon/run-state.ts +17 -0
  411. package/src/shared/infrastructure/orkeon/runtime-info.ts +30 -0
  412. package/src/shared/infrastructure/orkeon/runtime-tools.ts +60 -0
  413. package/src/shared/infrastructure/orkeon/script-tools.ts +134 -0
  414. package/src/shared/infrastructure/orkeon/session-store.ts +138 -0
  415. package/src/shared/infrastructure/orkeon/session-switch.ts +23 -0
  416. package/src/shared/infrastructure/orkeon/shared-memory.ts +61 -0
  417. package/src/shared/infrastructure/orkeon/shell-jobs.ts +75 -0
  418. package/src/shared/infrastructure/orkeon/shell.ts +31 -0
  419. package/src/shared/infrastructure/orkeon/telemetry.ts +63 -0
  420. package/src/shared/infrastructure/orkeon/tool-catalogue.ts +75 -0
  421. package/src/shared/infrastructure/orkeon/tool-results.ts +120 -0
  422. package/src/shared/infrastructure/orkeon/usage.ts +74 -0
  423. package/src/shared/infrastructure/orkeon/wiring.ts +118 -0
@@ -0,0 +1,403 @@
1
+ // A reader for the small block-style YAML a repository pack is written in. It gives the
2
+ // value PyYAML's safe_load gives on the same text, for the constructs it accepts, and
3
+ // refuses everything else with the first offending line: a wrong value is worse than a
4
+ // stop. Accepted: block maps and sequences at any depth, one-line flow sequences of
5
+ // scalars, single- and double-quoted scalars on one line, plain scalars on one line,
6
+ // comments, the folded block `>-`, and the YAML 1.1 scalar types (null, boolean,
7
+ // decimal integer, float). Pure: no runtime global, never throws.
8
+
9
+ export type YamlScalar = string | number | boolean | null;
10
+ export type YamlValue = YamlScalar | YamlValue[] | YamlMap;
11
+ export interface YamlMap { [key: string]: YamlValue }
12
+ export interface YamlError { line: number; message: string }
13
+ export type YamlParse = { ok: true; value: YamlValue } | { ok: false; error: YamlError };
14
+
15
+ /** `<path>:<line>: <message>` */
16
+ export function formatYamlError(path: string, error: YamlError): string {
17
+ return `${path}:${error.line}: ${error.message}`;
18
+ }
19
+
20
+ const MSG = {
21
+ tab: "a tab in the indentation",
22
+ tabInLine: "a tab outside quotes and comments",
23
+ marker: "a document marker is not supported",
24
+ anchor: "anchors, aliases and tags are not supported",
25
+ flowMap: "a flow mapping is not supported",
26
+ flowOpen: "a flow sequence must close on its line",
27
+ flowNested: "a nested flow sequence is not supported",
28
+ flowAfter: "text after a closing bracket",
29
+ flowEmpty: "an empty item in a flow sequence",
30
+ moreIndented: "a more-indented line inside a folded block is not supported",
31
+ quoteOpen: "a quoted scalar must close on its line",
32
+ quoteAfter: "text after a closing quote",
33
+ colon: "': ' inside a plain value: quote it",
34
+ key: "a mapping key must be a plain name",
35
+ indent: "bad indentation (a value continued on the next line is not supported)",
36
+ itemForKey: "a sequence item where a mapping key was expected",
37
+ keyForItem: "a mapping key where a sequence item was expected",
38
+ nestedItem: "a nested sequence item on one line is not supported",
39
+ } as const;
40
+
41
+ class YamlStop {
42
+ readonly line: number;
43
+ readonly message: string;
44
+ constructor(line: number, message: string) {
45
+ this.line = line;
46
+ this.message = message;
47
+ }
48
+ }
49
+
50
+ interface Line { no: number; indent: number; text: string }
51
+
52
+ const KEY_NAME = /^[A-Za-z0-9_][A-Za-z0-9_.-]*$/;
53
+ const NULLS = new Set(["~", "null", "Null", "NULL", ""]);
54
+ const TRUES = new Set(["true", "True", "TRUE", "yes", "Yes", "YES", "on", "On", "ON"]);
55
+ const FALSES = new Set(["false", "False", "FALSE", "no", "No", "NO", "off", "Off", "OFF"]);
56
+ const DECIMAL = /^[-+]?(0|[1-9][0-9_]*)$/;
57
+ const FLOAT = /^(?:[-+]?[0-9][0-9_]*\.[0-9_]*(?:[eE][-+][0-9]+)?|[-+]?\.[0-9_]+(?:[eE][-+][0-9]+)?)$/;
58
+ const INF = /^[-+]?\.(?:inf|Inf|INF)$/;
59
+ const NAN = /^\.(?:nan|NaN|NAN)$/;
60
+ const AMBIGUOUS = [
61
+ /^[-+]?0[0-7_]+$/, // octal
62
+ /^[-+]?0x[0-9a-fA-F_]+$/, // hexadecimal
63
+ /^[-+]?0o[0-7_]+$/, // YAML 1.2 octal
64
+ /^[-+]?0b[01_]+$/, // binary
65
+ /^[-+]?[0-9][0-9_]*(?::[0-5]?[0-9])+(?:\.[0-9_]*)?$/, // sexagesimal
66
+ ];
67
+ // PyYAML reads these as a date or a datetime, which JSON has no form for.
68
+ const DATE = /^[0-9]{4}-[0-9]{2}-[0-9]{2}$|^[0-9]{4}-[0-9]{1,2}-[0-9]{1,2}(?:[Tt]|[ \t]+)[0-9]{1,2}:[0-9]{2}:[0-9]{2}/;
69
+
70
+ /** The type PyYAML's resolver gives a plain scalar, or a stop for a form it reads otherwise. */
71
+ function typePlain(v: string, no: number): YamlScalar {
72
+ if (NULLS.has(v)) return null;
73
+ if (TRUES.has(v)) return true;
74
+ if (FALSES.has(v)) return false;
75
+ if (DECIMAL.test(v)) return Number(v.replace(/_/g, "")) || 0;
76
+ if (FLOAT.test(v)) return Number(v.replace(/_/g, "")) || 0;
77
+ if (INF.test(v)) return v.startsWith("-") ? -Infinity : Infinity;
78
+ if (NAN.test(v)) return Number.NaN;
79
+ if (AMBIGUOUS.some((re) => re.test(v))) throw new YamlStop(no, `an ambiguous number '${v}': quote it`);
80
+ if (DATE.test(v)) throw new YamlStop(no, `an ambiguous date '${v}': quote it`);
81
+ return v;
82
+ }
83
+
84
+ /** Whether what follows a closing quote or bracket is only blanks or a ` # comment`. */
85
+ function onlyComment(rest: string): boolean {
86
+ return rest.trim() === "" || /^\s+#/.test(rest);
87
+ }
88
+
89
+ /** Reads a quoted scalar opening at text[0]; returns its value and the index after the closing quote. */
90
+ function readQuoted(text: string, no: number): { value: string; end: number } {
91
+ const q = text[0];
92
+ let out = "";
93
+ let i = 1;
94
+ while (i < text.length) {
95
+ const c = text[i];
96
+ if (q === "'") {
97
+ if (c === "'") {
98
+ if (text[i + 1] === "'") { out += "'"; i += 2; continue; }
99
+ return { value: out, end: i + 1 };
100
+ }
101
+ } else {
102
+ if (c === "\\") {
103
+ const e = text[i + 1];
104
+ const map: Record<string, string> = { '"': '"', "\\": "\\", "/": "/", n: "\n", t: "\t" };
105
+ if (e === undefined || !(e in map)) {
106
+ throw new YamlStop(no, `an unknown escape '\\${e ?? ""}' in a double-quoted scalar`);
107
+ }
108
+ out += map[e];
109
+ i += 2;
110
+ continue;
111
+ }
112
+ if (c === '"') return { value: out, end: i + 1 };
113
+ }
114
+ out += c;
115
+ i++;
116
+ }
117
+ throw new YamlStop(no, MSG.quoteOpen);
118
+ }
119
+
120
+ /**
121
+ * Stops on a tab that sits outside a quoted scalar and before any comment: PyYAML's
122
+ * scanner refuses one there, in the separator after `:` or `-` as inside a plain value.
123
+ * A quote opens a scalar only at the start or after a blank, `[` or `,`.
124
+ */
125
+ function refuseTabs(text: string, no: number): void {
126
+ let quote = "";
127
+ for (let i = 0; i < text.length; i++) {
128
+ const c = text[i];
129
+ const prev = i === 0 ? " " : text[i - 1];
130
+ if (quote === "'") {
131
+ if (c === "'") { if (text[i + 1] === "'") i++; else quote = ""; }
132
+ continue;
133
+ }
134
+ if (quote === '"') {
135
+ if (c === "\\") i++;
136
+ else if (c === '"') quote = "";
137
+ continue;
138
+ }
139
+ if (c === "\t") throw new YamlStop(no, MSG.tabInLine);
140
+ if (c === "#" && prev === " ") return;
141
+ if ((c === "'" || c === '"') && (prev === " " || prev === "[" || prev === ",")) quote = c;
142
+ }
143
+ }
144
+
145
+ // PyYAML refuses a plain scalar opening with one of these (the indicators it reserves).
146
+ const RESERVED_START = /^(?:[%@`|>]|\?(?:\s|$))/;
147
+
148
+ function plainScalar(raw: string, no: number): YamlScalar {
149
+ const cut = raw.search(/\s#/);
150
+ const v = (cut < 0 ? raw : raw.slice(0, cut)).trimEnd();
151
+ if (RESERVED_START.test(v)) throw new YamlStop(no, `a plain value cannot start with '${v[0]}': quote it`);
152
+ if (/:(\s|$)/.test(v)) throw new YamlStop(no, MSG.colon);
153
+ return typePlain(v, no);
154
+ }
155
+
156
+ function flowSequence(text: string, no: number): YamlValue[] {
157
+ const items: string[] = [];
158
+ const quoted: boolean[] = [];
159
+ let cur = "";
160
+ let curQuoted = false;
161
+ let i = 1;
162
+ for (;;) {
163
+ if (i >= text.length) throw new YamlStop(no, MSG.flowOpen);
164
+ const c = text[i];
165
+ if (c === "[") throw new YamlStop(no, MSG.flowNested);
166
+ if (c === "{") throw new YamlStop(no, MSG.flowMap);
167
+ if ((c === '"' || c === "'") && cur.trim() === "") {
168
+ const q = readQuoted(text.slice(i), no);
169
+ cur = q.value;
170
+ curQuoted = true;
171
+ i += q.end;
172
+ const after = /^\s*/.exec(text.slice(i));
173
+ i += after ? after[0].length : 0;
174
+ if (text[i] !== "," && text[i] !== "]") {
175
+ if (i >= text.length) throw new YamlStop(no, MSG.flowOpen);
176
+ throw new YamlStop(no, MSG.quoteAfter);
177
+ }
178
+ continue;
179
+ }
180
+ if (c === "," || c === "]") {
181
+ items.push(curQuoted ? cur : cur.trim());
182
+ quoted.push(curQuoted);
183
+ cur = "";
184
+ curQuoted = false;
185
+ i++;
186
+ if (c === "]") break;
187
+ continue;
188
+ }
189
+ cur += c;
190
+ i++;
191
+ }
192
+ if (!onlyComment(text.slice(i))) throw new YamlStop(no, MSG.flowAfter);
193
+ // `[]` and a trailing comma leave one empty, unquoted last item: PyYAML drops it.
194
+ const last = items.length - 1;
195
+ if (last >= 0 && !quoted[last] && items[last] === "") { items.pop(); quoted.pop(); }
196
+ return items.map((item, k) => {
197
+ if (quoted[k]) return item;
198
+ if (item === "") throw new YamlStop(no, MSG.flowEmpty);
199
+ if (/^[&*!]/.test(item)) throw new YamlStop(no, MSG.anchor);
200
+ return plainScalar(item, no);
201
+ });
202
+ }
203
+
204
+ /** A value written on the line of its key or dash (never empty, never a block indicator). */
205
+ function inlineValue(text: string, no: number): YamlValue {
206
+ const c = text[0];
207
+ if (c === "&" || c === "*" || c === "!") throw new YamlStop(no, MSG.anchor);
208
+ if (c === "{") throw new YamlStop(no, MSG.flowMap);
209
+ if (c === "[") return flowSequence(text, no);
210
+ if (c === '"' || c === "'") {
211
+ const q = readQuoted(text, no);
212
+ if (!onlyComment(text.slice(q.end))) throw new YamlStop(no, MSG.quoteAfter);
213
+ return q.value;
214
+ }
215
+ if (/^-(\s|$)/.test(text)) throw new YamlStop(no, MSG.nestedItem);
216
+ return plainScalar(text, no);
217
+ }
218
+
219
+ const isItem = (text: string): boolean => /^-(\s|$)/.test(text);
220
+ const isComment = (text: string): boolean => text.startsWith("#");
221
+
222
+ /** The key of a `key: value` line and the text after `:`, or null when the line is not one. */
223
+ function splitKey(text: string, no: number): { key: string; rest: string } | null {
224
+ if (text[0] === "[" || text[0] === "{") return null;
225
+ if (text.startsWith("? ") || text === "?") throw new YamlStop(no, MSG.key);
226
+ if (text[0] === '"' || text[0] === "'") {
227
+ let end: number;
228
+ try { end = readQuoted(text, no).end; } catch { return null; }
229
+ if (/^\s*:(\s|$)/.test(text.slice(end))) throw new YamlStop(no, MSG.key);
230
+ return null;
231
+ }
232
+ const cut = text.search(/\s#/);
233
+ const head = cut < 0 ? text : text.slice(0, cut);
234
+ const m = /:(\s|$)/.exec(head);
235
+ if (!m) return null;
236
+ const key = head.slice(0, m.index);
237
+ if (!KEY_NAME.test(key) || typeof typePlain(key, no) !== "string") throw new YamlStop(no, MSG.key);
238
+ return { key, rest: text.slice(m.index + 1).trim() };
239
+ }
240
+
241
+ function blockIndicator(rest: string): string | null {
242
+ const m = /^([|>][0-9+-]*)(\s+#.*)?$/.exec(rest);
243
+ return m ? m[1] : null;
244
+ }
245
+
246
+ class Parser {
247
+ private readonly raw: string[];
248
+ private readonly lines: Line[] = [];
249
+ private readonly rawIndex: number[] = [];
250
+ private pos = 0;
251
+
252
+ constructor(text: string) {
253
+ this.raw = text.replace(/^\uFEFF/, "").split(/\r?\n/);
254
+ }
255
+
256
+ run(): YamlValue {
257
+ this.raw.forEach((r, k) => {
258
+ const lead = /^[ \t]*/.exec(r)?.[0] ?? "";
259
+ const text = r.slice(lead.length);
260
+ if (/^(---|\.\.\.)(\s|$)/.test(r)) throw new YamlStop(k + 1, MSG.marker);
261
+ if (text === "" || isComment(text)) return;
262
+ if (lead.includes("\t")) throw new YamlStop(k + 1, MSG.tab);
263
+ this.lines.push({ no: k + 1, indent: lead.length, text: text.trimEnd() });
264
+ this.rawIndex.push(k);
265
+ });
266
+ if (this.lines.length === 0) return null;
267
+ const first = this.lines[0];
268
+ refuseTabs(first.text, first.no);
269
+ let value: YamlValue;
270
+ if (isItem(first.text) || splitKey(first.text, first.no)) value = this.block(first.indent, false);
271
+ else {
272
+ value = this.scalarOrFolded(first.text, -1, first.no);
273
+ this.pos = Math.max(this.pos, 1);
274
+ }
275
+ const next = this.peek();
276
+ if (next) throw new YamlStop(next.no, MSG.indent);
277
+ return value;
278
+ }
279
+
280
+ private peek(): Line | undefined {
281
+ return this.lines[this.pos];
282
+ }
283
+
284
+ private block(indent: number, underKey: boolean): YamlValue {
285
+ const line = this.peek() as Line;
286
+ return isItem(line.text) ? this.sequence(indent, underKey) : this.mapping(indent);
287
+ }
288
+
289
+ private mapping(indent: number): YamlMap {
290
+ const out: YamlMap = {};
291
+ for (let line = this.peek(); line && line.indent >= indent; line = this.peek()) {
292
+ if (line.indent > indent) throw new YamlStop(line.no, MSG.indent);
293
+ refuseTabs(line.text, line.no);
294
+ if (isItem(line.text)) throw new YamlStop(line.no, MSG.itemForKey);
295
+ const kv = splitKey(line.text, line.no);
296
+ if (!kv) throw new YamlStop(line.no, MSG.indent);
297
+ if (Object.hasOwn(out, kv.key)) throw new YamlStop(line.no, `a duplicate key '${kv.key}'`);
298
+ this.pos++;
299
+ const value = this.valueAfter(kv.rest, indent, line.no, true);
300
+ Object.defineProperty(out, kv.key, { value, enumerable: true, writable: true, configurable: true });
301
+ }
302
+ return out;
303
+ }
304
+
305
+ private sequence(indent: number, underKey: boolean): YamlValue[] {
306
+ const out: YamlValue[] = [];
307
+ for (let line = this.peek(); line && line.indent >= indent; line = this.peek()) {
308
+ if (line.indent > indent) throw new YamlStop(line.no, MSG.indent);
309
+ if (!isItem(line.text)) {
310
+ if (underKey) break;
311
+ throw new YamlStop(line.no, MSG.keyForItem);
312
+ }
313
+ refuseTabs(line.text, line.no);
314
+ const rest = line.text.slice(1).replace(/^\s+/, "");
315
+ if (rest === "" || isComment(rest)) {
316
+ this.pos++;
317
+ out.push(this.valueAfter("", indent, line.no, false));
318
+ continue;
319
+ }
320
+ if (isItem(rest)) throw new YamlStop(line.no, MSG.nestedItem);
321
+ if (splitKey(rest, line.no)) {
322
+ // `- key: value` opens a map whose keys align on the column after the dash.
323
+ const col = line.indent + (line.text.length - rest.length);
324
+ this.lines[this.pos] = { no: line.no, indent: col, text: rest };
325
+ out.push(this.mapping(col));
326
+ continue;
327
+ }
328
+ this.pos++;
329
+ out.push(this.scalarOrFolded(rest, indent, line.no));
330
+ }
331
+ return out;
332
+ }
333
+
334
+ /** The value after `key:` (or a bare dash): inline, folded, or the block on the next lines. */
335
+ private valueAfter(rest: string, indent: number, no: number, isKey: boolean): YamlValue {
336
+ if (rest !== "" && !isComment(rest)) return this.scalarOrFolded(rest, indent, no);
337
+ const next = this.peek();
338
+ if (next && next.indent > indent) return this.block(next.indent, false);
339
+ if (isKey && next && next.indent === indent && isItem(next.text)) return this.block(indent, true);
340
+ return null;
341
+ }
342
+
343
+ private scalarOrFolded(rest: string, parentIndent: number, no: number): YamlValue {
344
+ const indicator = blockIndicator(rest);
345
+ if (indicator !== null) {
346
+ if (indicator !== ">-") {
347
+ throw new YamlStop(no, `only the folded block '>-' is supported, not '${indicator}'`);
348
+ }
349
+ return this.folded(parentIndent, no);
350
+ }
351
+ const value = inlineValue(rest, no);
352
+ const next = this.peek();
353
+ if (next && next.indent > parentIndent && next.no > no) throw new YamlStop(next.no, MSG.indent);
354
+ return value;
355
+ }
356
+
357
+ /** A `>-` block: the raw lines after the header that are deeper than the parent. */
358
+ private folded(parentIndent: number, headerNo: number): string {
359
+ let k = headerNo; // 0-based index of the first raw line after the header
360
+ let contentIndent = -1;
361
+ const parts: Array<string | null> = []; // null = a blank line
362
+ for (; k < this.raw.length; k++) {
363
+ const r = this.raw[k];
364
+ if (r.trim() === "") { parts.push(null); continue; }
365
+ const lead = (/^[ \t]*/.exec(r)?.[0] ?? "");
366
+ if (lead.includes("\t")) throw new YamlStop(k + 1, MSG.tab);
367
+ const ind = lead.length;
368
+ if (ind <= parentIndent) break;
369
+ if (contentIndent < 0) contentIndent = ind;
370
+ if (ind > contentIndent) throw new YamlStop(k + 1, MSG.moreIndented);
371
+ if (ind < contentIndent) {
372
+ // A comment line shallower than the content but deeper than the parent ends the block.
373
+ if (r.slice(ind).startsWith("#")) break;
374
+ throw new YamlStop(k + 1, MSG.indent);
375
+ }
376
+ parts.push(r.slice(ind));
377
+ }
378
+ while (this.pos < this.lines.length && this.rawIndex[this.pos] < k) this.pos++;
379
+ while (parts.length > 0 && parts[parts.length - 1] === null) parts.pop();
380
+ let out = "";
381
+ let prevText = false;
382
+ let breaks = 0;
383
+ for (const p of parts) {
384
+ if (p === null) { breaks++; continue; }
385
+ if (prevText) out += breaks > 0 ? "\n".repeat(breaks) : " ";
386
+ else out += "\n".repeat(breaks);
387
+ out += p;
388
+ prevText = true;
389
+ breaks = 0;
390
+ }
391
+ return out;
392
+ }
393
+ }
394
+
395
+ export function parseYamlSubset(text: string): YamlParse {
396
+ try {
397
+ return { ok: true, value: new Parser(text).run() };
398
+ } catch (e) {
399
+ if (e instanceof YamlStop) return { ok: false, error: { line: e.line, message: e.message } };
400
+ const message = e instanceof Error ? e.message : String(e);
401
+ return { ok: false, error: { line: 1, message } };
402
+ }
403
+ }
@@ -0,0 +1,273 @@
1
+ // The git close of a change: who commits (git's own identity), which files (an
2
+ // explicit list, never the work folder), the command lines that commit, push and
3
+ // merge them, and the pull request body and command handed over. Pure: nothing
4
+ // here runs a command; shared/application/git runs these lines through the Shell port.
5
+
6
+ /** Q-10's switch: `true` asks the close to open the pull request itself. Omitted = false. */
7
+ export const DEV_PR_AUTO_CONFIG_KEY = "dev.prAuto";
8
+
9
+ /** Where the message goes for `git commit -F` (relative to /workspace; never tracked). */
10
+ export const COMMIT_MESSAGE_FILE = ".git/ORKEON_COMMITMSG";
11
+ /** In a linked worktree `.git` is a file: the message goes there instead, and is removed after the commit. */
12
+ export const COMMIT_MESSAGE_FALLBACK = ".orkeon/ORKEON_COMMITMSG";
13
+ export const GIT_IDENT_COMMAND = "git var GIT_AUTHOR_IDENT";
14
+ /** A commit needs the committer too: with only GIT_AUTHOR_* set it would fail after the draft was paid for. */
15
+ export const GIT_COMMITTER_IDENT_COMMAND = "git var GIT_COMMITTER_IDENT";
16
+ /** Names as they are (an accented name is not C-quoted); untracked files one by one. */
17
+ export const GIT_STATUS_COMMAND = "git -c core.quotePath=false status --short --untracked-files=all";
18
+ export const GIT_HEAD_COMMAND = "git rev-parse --short HEAD";
19
+ export const GIT_DEFAULT_BRANCH_COMMAND = "git symbolic-ref --short refs/remotes/origin/HEAD";
20
+ export const GIT_CURRENT_BRANCH_COMMAND = "git branch --show-current";
21
+ /** A merge or a cherry-pick in progress refuses a partial commit: each probe exits 0 while one is. */
22
+ export const GIT_IN_PROGRESS_PROBES: readonly string[] = [
23
+ "git rev-parse -q --verify MERGE_HEAD", "git rev-parse -q --verify CHERRY_PICK_HEAD",
24
+ ];
25
+ /** What git says when a merge is refused only for not being a fast-forward. */
26
+ export function isNotFastForward(stderr: string): boolean {
27
+ return /fast-forward/i.test(String(stderr ?? ""));
28
+ }
29
+
30
+ export interface GitIdent { name: string; email: string }
31
+
32
+ /** The identity of `git var GIT_AUTHOR_IDENT` (`Name <email> <time> <tz>`), null when it holds no usable email. */
33
+ export function parseGitIdent(stdout: string): GitIdent | null {
34
+ const line = String(stdout ?? "").split("\n")[0].trim();
35
+ const m = /^(.*?)\s*<([^<>\s]+)>/.exec(line);
36
+ if (m === null || m[2].endsWith(".(none)")) return null;
37
+ return { name: m[1].trim(), email: m[2] };
38
+ }
39
+
40
+ /** The two commands that give git an identity; the user types them with their own name and email. */
41
+ export const IDENTITY_HANDOVER: readonly string[] = [
42
+ "git config --global user.name \"<your name>\"",
43
+ "git config --global user.email <your email>",
44
+ ];
45
+
46
+ /** The stop when git has no identity: git's reason, then the two commands, one per line. Never an invented identity. */
47
+ export function identityStop(detail: string, rerun: string): string {
48
+ return [
49
+ `✗ stopped: git has no identity for the commit (${detail}). Set one in a terminal, then re-run ${rerun}:`,
50
+ ...IDENTITY_HANDOVER.map((c) => ` ${c}`),
51
+ ].join("\n");
52
+ }
53
+
54
+ /** A `git status --short` path with its quotes removed (an escaped name keeps its backslashes, so it reads unsafe). */
55
+ function unquote(path: string): string {
56
+ return path.trim().replace(/^"(.*)"$/, "$1");
57
+ }
58
+
59
+ /** Every path a `git status --short` lists, once, in order: both sides of a rename. */
60
+ export function changedPaths(status: string): string[] {
61
+ const out: string[] = [];
62
+ for (const line of String(status ?? "").split("\n")) {
63
+ // `AD`: added, then deleted from the worktree; neither HEAD nor the worktree holds it, so there is nothing to commit.
64
+ if (line.length <= 3 || line.startsWith("AD ")) continue;
65
+ const rest = line.slice(3);
66
+ const arrow = rest.indexOf(" -> ");
67
+ const paths = arrow >= 0 ? [rest.slice(0, arrow), rest.slice(arrow + 4)] : [rest];
68
+ for (const p of paths.map(unquote)) if (p.length > 0 && !out.includes(p)) out.push(p);
69
+ }
70
+ return out;
71
+ }
72
+
73
+ /**
74
+ * The paths already gone from the index (a staged deletion, the old side of a
75
+ * staged rename): `git add` refuses them ("did not match any files"), while the
76
+ * commit's own path list takes them from HEAD.
77
+ */
78
+ export function indexDeletedPaths(status: string): string[] {
79
+ const out: string[] = [];
80
+ for (const line of String(status ?? "").split("\n")) {
81
+ if (line.length <= 3) continue;
82
+ const rest = line.slice(3);
83
+ if (line[0] === "D") out.push(unquote(rest));
84
+ else if (line[0] === "R" && rest.includes(" -> ")) out.push(unquote(rest.slice(0, rest.indexOf(" -> "))));
85
+ }
86
+ return out;
87
+ }
88
+
89
+ /** True when the runtime's shell (no shell: quote-aware split, no escape, forbidden operators) cannot carry `s`. */
90
+ export function shellUnsafe(s: string): boolean {
91
+ return s.length === 0 || /['"\\\r\n`;|]/.test(s) || s.includes("$(") || s.includes("&&");
92
+ }
93
+
94
+ /** `s` single-quoted for a POSIX shell (a quote inside becomes `'\''`). */
95
+ export function shellQuote(s: string): string {
96
+ return `'${s.replace(/'/g, "'\\''")}'`;
97
+ }
98
+
99
+ function under(path: string, folder: string): boolean {
100
+ return folder.length > 0 && (path === folder || path.startsWith(folder + "/"));
101
+ }
102
+
103
+ function bare(path: string): string {
104
+ let p = path.trim();
105
+ while (p.startsWith("./")) p = p.slice(2);
106
+ return p.replace(/\/+$/, "");
107
+ }
108
+
109
+ export interface CommitSelection {
110
+ /** The files the commit holds, in the status's order. */
111
+ files: string[];
112
+ /** Changed files of the work folder, left out. */
113
+ leftOut: string[];
114
+ /** Named paths inside the work folder: refused. */
115
+ inWorkFolder: string[];
116
+ /** Named paths with no change: refused. */
117
+ unchanged: string[];
118
+ /** Selected paths the shell cannot carry: refused. */
119
+ unsafe: string[];
120
+ }
121
+
122
+ /**
123
+ * The files a commit holds: the changed paths of `status` (or those equal to or
124
+ * under a `named` path), never one of the work folder unless `namedWorkFolder`
125
+ * lets a path named inside it through (/commit: the user's explicit choice, for a
126
+ * work folder the repository tracks; the dev close never). A work folder given as
127
+ * an absolute path lies outside the checkout and excludes nothing.
128
+ */
129
+ export function selectCommitFiles(req: {
130
+ status: string; workFolder: string; named?: readonly string[]; namedWorkFolder?: boolean;
131
+ }): CommitSelection {
132
+ const work = req.workFolder.startsWith("/") ? "" : bare(req.workFolder);
133
+ const changed = changedPaths(req.status);
134
+ const inWorkFolder: string[] = [];
135
+ const unchanged: string[] = [];
136
+ let picked: string[] = [];
137
+ const allowed: string[] = [];
138
+ const named = (req.named ?? []).map(String).filter((n) => n.trim().length > 0);
139
+ if (named.length === 0) {
140
+ picked = changed;
141
+ } else {
142
+ for (const raw of named) {
143
+ const n = bare(raw);
144
+ if (n === "" || n === ".") { picked.push(...changed); continue; }
145
+ if (under(n, work) && req.namedWorkFolder !== true) { inWorkFolder.push(n); continue; }
146
+ const hits = changed.filter((p) => p === n || p.startsWith(n + "/"));
147
+ if (hits.length === 0) unchanged.push(n);
148
+ picked.push(...hits);
149
+ if (under(n, work)) allowed.push(...hits);
150
+ }
151
+ picked = changed.filter((p) => picked.includes(p));
152
+ }
153
+ const out = (p: string): boolean => under(p, work) && !allowed.includes(p);
154
+ const files = picked.filter((p) => !out(p));
155
+ return {
156
+ files,
157
+ leftOut: picked.filter(out),
158
+ inWorkFolder,
159
+ unchanged,
160
+ unsafe: files.filter(shellUnsafe),
161
+ };
162
+ }
163
+
164
+ const quoted = (paths: readonly string[]): string => paths.map(shellQuote).join(" ");
165
+
166
+ // Every path list is literal: `a[1].ts` names that file, never a glob matching `a1.ts`.
167
+ export function gitAddCommand(files: readonly string[]): string {
168
+ return `git --literal-pathspecs add -- ${quoted(files)}`;
169
+ }
170
+
171
+ const BRANCH_WORD = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
172
+
173
+ /** A work branch from the pack's `contrib.branch` pattern: its first alternative before `/`, then `slug`
174
+ * (`<code>` for a /dev-batches run, `<code>-f<n>` for a typed close of one batch). Null when no prefix can be read. */
175
+ export function workBranchFromPattern(pattern: string, slug: string): string | null {
176
+ const slash = pattern.indexOf("/");
177
+ if (slash <= 0) return null;
178
+ const prefix = pattern.slice(0, slash).split("|")[0].trim();
179
+ return BRANCH_WORD.test(prefix) ? `${prefix}/${slug}` : null;
180
+ }
181
+
182
+ /** A path list on the commit itself: changes staged elsewhere stay staged and out of it. */
183
+ export function gitCommitCommand(files: readonly string[], messageFile: string = COMMIT_MESSAGE_FILE): string {
184
+ return `git --literal-pathspecs commit -F ${messageFile} -- ${quoted(files)}`;
185
+ }
186
+
187
+ export function gitDiffCommand(files: readonly string[]): string {
188
+ return `git --literal-pathspecs diff HEAD -- ${quoted(files)}`;
189
+ }
190
+
191
+ export function gitPushCommand(branch: string): string {
192
+ return `git push -u origin ${shellQuote(branch)}`;
193
+ }
194
+
195
+ /** HEAD and the remote-tracking ref of `branch`, one hash per line: equal, the branch is on origin already. */
196
+ export function gitPushedCheckCommand(branch: string): string {
197
+ return `git rev-parse HEAD ${shellQuote(`refs/remotes/origin/${branch}`)}`;
198
+ }
199
+
200
+ /** Whether the two hashes `gitPushedCheckCommand` printed are one: the push was made, by hand or by a run. */
201
+ export function isPushed(stdout: string): boolean {
202
+ const [head, remote] = String(stdout ?? "").trim().split("\n").map((l) => l.trim());
203
+ return head !== undefined && head.length > 0 && head === remote;
204
+ }
205
+
206
+ export function gitMergeFfOnly(ref: string): string {
207
+ return `git merge --ff-only ${shellQuote(ref)}`;
208
+ }
209
+
210
+ export function gitRebaseIn(worktree: string, onto: string): string {
211
+ return `git -C ${shellQuote(worktree)} rebase ${shellQuote(onto)}`;
212
+ }
213
+
214
+ export function gitRebaseAbortIn(worktree: string): string {
215
+ return `git -C ${shellQuote(worktree)} rebase --abort`;
216
+ }
217
+
218
+ /** `origin/main` -> `main`; null when origin/HEAD is unset. */
219
+ export function parseDefaultBranch(stdout: string): string | null {
220
+ const b = String(stdout ?? "").trim().replace(/^origin\//, "");
221
+ return b.length > 0 ? b : null;
222
+ }
223
+
224
+ /** A folder name from a branch name: anything but letters, digits, `.`, `_`, `-` becomes `-`. */
225
+ export function prSlug(branch: string): string {
226
+ const s = String(branch ?? "").replace(/[^A-Za-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "");
227
+ return s.length > 0 ? s : "change";
228
+ }
229
+
230
+ /** `<work>/pr-<slug>/PR.md`, the body file the harness writes too. */
231
+ export function prBodyPath(workFolder: string, slug: string): string {
232
+ return `${workFolder.replace(/\/+$/, "")}/pr-${slug}/PR.md`;
233
+ }
234
+
235
+ export interface PrSummary {
236
+ /** The `## Batch` paragraph. */
237
+ batch: string;
238
+ layers: Array<{ layer: string; paths: string[] }>;
239
+ validations?: string[];
240
+ assumptions?: Array<{ id: string; assumption: string; by: string }>;
241
+ audit?: string;
242
+ notRun?: string;
243
+ }
244
+
245
+ const NONE = "None.";
246
+
247
+ /** The body of the pull request, under the template's headings, none removed or added; `None.` where nothing is said. */
248
+ export function renderPrBody(s: PrSummary): string {
249
+ const layers = s.layers.filter((l) => l.paths.length > 0)
250
+ .map((l) => `- ${l.layer}: ${l.paths.map((p) => `\`${p}\``).join(", ")}`);
251
+ const validations = (s.validations ?? []).map((v) => `- ${v}`);
252
+ const assumptions = (s.assumptions ?? []).length === 0 ? [NONE] : [
253
+ "| Id | Assumption | To be validated by |",
254
+ "|----|------------|--------------------|",
255
+ ...(s.assumptions ?? []).map((a) => `| ${a.id} | ${a.assumption} | ${a.by} |`),
256
+ ];
257
+ const text = (v: string | undefined): string => (v ?? "").trim() || NONE;
258
+ return [
259
+ "## Batch", "", text(s.batch), "",
260
+ "## Files, per layer", "", ...(layers.length > 0 ? layers : [NONE]), "",
261
+ "## Validations", "", ...(validations.length > 0 ? validations : [NONE]), "",
262
+ "## Assumptions to validate", "", ...assumptions, "",
263
+ "## Audit", "", text(s.audit), "",
264
+ "## Not run", "", text(s.notRun), "",
265
+ ].join("\n");
266
+ }
267
+
268
+ /** The `gh pr create` line handed over, for the user's own shell; `--base` left out when unknown (gh's default). */
269
+ export function ghPrCreateCommand(req: { base: string | null; head: string; title: string; bodyFile: string }): string {
270
+ const arg = (s: string): string => (/^[A-Za-z0-9._/@:+-]+$/.test(s) ? s : shellQuote(s));
271
+ const base = req.base === null ? "" : ` --base ${arg(req.base)}`;
272
+ return `gh pr create${base} --head ${arg(req.head)} --title ${shellQuote(req.title)} --body-file ${arg(req.bodyFile)}`;
273
+ }