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,64 @@
1
+ // The guard chain of the tools Orkeon Code defines (run_validation, run_tests, run_build). The host
2
+ // gate is asked once, for the tool call itself; the shell commands the tool's body then runs are
3
+ // not asked again (toolBuilder, orkeon.d.ts), so the body applies the rules it is given before each
4
+ // one, with the gate's own reading (matchesRule). A guard returns a refusal or null; the first
5
+ // refusal is terminal and a guard that throws refuses (fail-closed). Pure.
6
+ import type { PermissionRule } from "../agent-policy/permission.ts";
7
+ import { ruleDecision, shellCommandForms } from "../agent-policy/permission.ts";
8
+ import { gitConfigSets, holdsGitReadonly } from "../agent-policy/rule-sets.ts";
9
+ import { WORKSPACE } from "../vfs.ts";
10
+
11
+ /** One check of a call: the reason it is refused, or null when it passes. */
12
+ export type Guard<T> = (call: T) => string | null;
13
+
14
+ /** The first refusal of `guards`, in order; a guard that throws refuses with its message. */
15
+ export function runGuards<T>(guards: ReadonlyArray<Guard<T>>, call: T): string | null {
16
+ for (const guard of guards) {
17
+ let refusal: string | null;
18
+ try {
19
+ refusal = guard(call);
20
+ } catch (error) {
21
+ refusal = `a guard failed: ${error instanceof Error ? error.message : String(error)}`;
22
+ }
23
+ if (refusal !== null) return refusal;
24
+ }
25
+ return null;
26
+ }
27
+
28
+ /** Refuses a shell command a deny rule covers, as the gate would refuse the model's own shell_command, in any of
29
+ * the forms the program receives it in (shellCommandForms). */
30
+ export function shellRuleGuard(rules: readonly PermissionRule[]): Guard<string> {
31
+ const gitConfig = holdsGitReadonly(rules);
32
+ return (command) =>
33
+ shellCommandForms(command).some((form) =>
34
+ ruleDecision(rules, "shell_command", { command: form, working_directory: WORKSPACE }) === "deny")
35
+ || (gitConfig && gitConfigSets(command))
36
+ ? `the rules of this step deny the shell command '${command}'`
37
+ : null;
38
+ }
39
+
40
+ /** The longest text a tool's string argument may be. */
41
+ export const MAX_ARGUMENT_CHARS = 400;
42
+
43
+ /** The string `key` of a tool's input, or the reason it is not one line of at most 400 characters. */
44
+ export function stringArgument(input: unknown, key: string, required: boolean): { value?: string } | { refused: string } {
45
+ const value = input !== null && typeof input === "object" ? (input as Record<string, unknown>)[key] : undefined;
46
+ if (value === undefined || value === null || value === "") {
47
+ return required ? { refused: `'${key}' is required` } : {};
48
+ }
49
+ if (typeof value !== "string") return { refused: `'${key}' is not a string` };
50
+ if (/[\r\n]/.test(value) || value.length > MAX_ARGUMENT_CHARS) {
51
+ return { refused: `'${key}' is not one line of at most ${MAX_ARGUMENT_CHARS} characters` };
52
+ }
53
+ return { value: value.trim() };
54
+ }
55
+
56
+ const TAIL_LINES = 15;
57
+ const TAIL_CHARS = 1_500;
58
+
59
+ /** At most 15 lines and 1 500 characters of the output, stderr after stdout: what a tool hands back. */
60
+ export function outputTail(stdout: string, stderr: string): string {
61
+ const joined = [stdout.trimEnd(), stderr.trimEnd()].filter((t) => t !== "").join("\n");
62
+ const text = joined === "" ? "" : joined.split(/\r?\n/).slice(-TAIL_LINES).join("\n");
63
+ return text.length <= TAIL_CHARS ? text : text.slice(-TAIL_CHARS);
64
+ }
@@ -0,0 +1,83 @@
1
+ // The trait marker: how a test says which sheet id it covers. The repository pack gives
2
+ // a trait name (tests.rule_trait) and, optionally, a one-line pattern (tests.trait_pattern)
3
+ // holding <id> once and <name> at most once; the pattern compiles to the POSIX ERE that
4
+ // git grep -E runs over the test roots. Pure.
5
+
6
+ export const DEFAULT_TRAIT_PATTERN = '[Trait("<name>", "<id>")]';
7
+ /** The sheet ids the gate checks (AC:166). */
8
+ export const SHEET_ID_SOURCE = "\\b(BR|UC|CH)-[0-9]+\\b";
9
+
10
+ // No alternation: the runtime's shell tool refuses a '|' even quoted, so the ERE
11
+ // over-matches (BH-1, UR-2) and idsInMatch keeps the sheet ids alone.
12
+ const ID_ERE = "[BCU][CHR]-[0-9]+";
13
+ const ID_TOKEN = "<id>";
14
+ const NAME_TOKEN = "<name>";
15
+ const ERE_SPECIALS = new Set([..."\\.[]()*+?{}|^$"]);
16
+
17
+ export interface TraitMarker {
18
+ pattern: string; // the pattern used (trait_pattern, else the default)
19
+ name: string | null; // tests.rule_trait
20
+ ere: string; // the POSIX ERE handed to git grep -E
21
+ shown: string; // the pattern with <name> replaced, <id> kept: [Trait("BR", "<id>")]
22
+ }
23
+
24
+ function count(text: string, token: string): number {
25
+ return text.split(token).length - 1;
26
+ }
27
+
28
+ export function ruleTraitProblem(name: string): string | undefined {
29
+ return /^[A-Za-z0-9_-]+$/.test(name) ? undefined : "a trait name takes letters, digits, '_' and '-'";
30
+ }
31
+
32
+ export function traitPatternProblem(pattern: string): string | undefined {
33
+ if (pattern.trim() === "") return "the pattern is empty";
34
+ if (pattern.length > 80) return "the pattern is longer than 80 characters";
35
+ if (/[\t\r\n]/.test(pattern)) return "a tab or a line break is not allowed";
36
+ if (pattern.includes("'")) return "a single quote is not allowed";
37
+ if (pattern.includes("|")) return "a '|' is not allowed: the runtime's shell refuses it";
38
+ if (count(pattern, ID_TOKEN) !== 1) return "the pattern must hold <id> exactly once";
39
+ if (count(pattern, NAME_TOKEN) > 1) return "the pattern may hold <name> once at most";
40
+ const rest = pattern.split(ID_TOKEN).join("").split(NAME_TOKEN).join("");
41
+ if (/[<>]/.test(rest)) return "'<' and '>' may only enclose <id> and <name>";
42
+ if (rest.replace(/\s/g, "").length < 2) return "the pattern needs at least two characters around <id>";
43
+ return undefined;
44
+ }
45
+
46
+ function compile(pattern: string, name: string | null): string {
47
+ let ere = "";
48
+ let i = 0;
49
+ while (i < pattern.length) {
50
+ if (pattern.startsWith(ID_TOKEN, i)) { ere += ID_ERE; i += ID_TOKEN.length; continue; }
51
+ if (pattern.startsWith(NAME_TOKEN, i)) { ere += name ?? ""; i += NAME_TOKEN.length; continue; }
52
+ const c = pattern[i];
53
+ if (c === " ") {
54
+ while (pattern[i] === " ") i++;
55
+ ere += " *";
56
+ continue;
57
+ }
58
+ ere += ERE_SPECIALS.has(c) ? `\\${c}` : c;
59
+ i++;
60
+ }
61
+ return ere;
62
+ }
63
+
64
+ /** null when no marker applies: no rule_trait and no trait_pattern, or <name> in the pattern without rule_trait. */
65
+ export function traitMarker(ruleTrait: string | undefined, traitPattern: string | undefined): TraitMarker | null {
66
+ const pattern = traitPattern ?? (ruleTrait !== undefined ? DEFAULT_TRAIT_PATTERN : undefined);
67
+ if (pattern === undefined) return null;
68
+ if (pattern.includes(NAME_TOKEN) && ruleTrait === undefined) return null;
69
+ const name = ruleTrait ?? null;
70
+ return { pattern, name, ere: compile(pattern, name), shown: pattern.split(NAME_TOKEN).join(name ?? "") };
71
+ }
72
+
73
+ /** Ids carried by one git grep hit `path:line:match`: whole-token ids of the match part. */
74
+ export function idsInMatch(hit: string): string[] {
75
+ const first = hit.indexOf(":");
76
+ const second = first < 0 ? -1 : hit.indexOf(":", first + 1);
77
+ if (second < 0) return [];
78
+ const ids: string[] = [];
79
+ for (const m of hit.slice(second + 1).matchAll(/(^|[^0-9A-Za-z])((BR|UC|CH)-[0-9]+)(?![0-9])/g)) {
80
+ if (!ids.includes(m[2])) ids.push(m[2]);
81
+ }
82
+ return ids;
83
+ }
@@ -0,0 +1,169 @@
1
+ // Dev workflow verdicts: `<CODE>-VERIFY-F<n>.md`, one dated section per audit (a
2
+ // resume appends one). Pure, no IO, never throws. Gap rows are cut as the harness's
3
+ // learning script cuts them, so both read the same rows from the same file.
4
+ import type { FormatProblem } from "./plan-format.ts";
5
+
6
+ export type Verdict = "VALID" | "GAPS";
7
+
8
+ /** The gap of the row dev-verify writes when the step's budget stopped the audit: not a finding of the code, so
9
+ * neither the learning harvest nor a resumed audit takes it as one. Its reason goes in the evidence. */
10
+ export const AUDIT_UNFINISHED_GAP = "the audit did not finish: the step's budget ran out";
11
+
12
+ export function isAuditUnfinishedGap(gap: string): boolean {
13
+ return gap.trim() === AUDIT_UNFINISHED_GAP;
14
+ }
15
+ export type Severity = "Blocking" | "Major" | "Minor";
16
+ /** The axes, as the verdict files spell them (LC:34-35). Moved here from crews/dev-verify/domain/audit-answer.ts. */
17
+ export const AXES = [
18
+ "Correctness", "Reuse", "Simplification", "Cost", "Placement", "Conventions", "Test", "Plan", "Scope",
19
+ ] as const;
20
+ export type Axis = (typeof AXES)[number];
21
+ export interface GapRow { severity: Severity; axis: string; gap: string; evidence: string; expectedFix: string; line: number }
22
+ export interface VerdictSection {
23
+ prefix?: string; batch?: string; when?: string; mode?: string;
24
+ verdict: Verdict | null; rows: GapRow[]; none: boolean;
25
+ validations: string[]; notRun: string[]; measure?: string; line: number;
26
+ }
27
+ export interface VerdictFile { sections: VerdictSection[]; problems: FormatProblem[] }
28
+
29
+ const TITLE = /^# (\S+)-VERIFY-(F\d+) — (\d{4}-\d{2}-\d{2} \d{2}:\d{2}) — (\S+)$/;
30
+ const VERDICT = /^##\s+Verdict\s+—\s+(VALID|GAPS)\s*$/;
31
+ const VALIDATIONS = /^Validations: (.+)$/;
32
+ const NOT_RUN = /^Not run: (.+)$/;
33
+ const MEASURE = /^Measure: (.+)$/;
34
+ const SEVERITIES: ReadonlySet<string> = new Set(["Blocking", "Major", "Minor"]);
35
+
36
+ function emptySection(line: number): VerdictSection {
37
+ return { verdict: null, rows: [], none: false, validations: [], notRun: [], line };
38
+ }
39
+
40
+ export function parseVerdictFile(text: string): VerdictFile {
41
+ const file: VerdictFile = { sections: [], problems: [] };
42
+ let section: VerdictSection | null = null;
43
+ let inside = false;
44
+ text.split(/\r?\n/).forEach((raw, i) => {
45
+ const t = raw.trimEnd();
46
+ const line = i + 1;
47
+ if (t.startsWith("#")) {
48
+ inside = false;
49
+ const title = TITLE.exec(t);
50
+ if (title) {
51
+ section = { ...emptySection(line), prefix: title[1], batch: title[2], when: title[3], mode: title[4] };
52
+ file.sections.push(section);
53
+ return;
54
+ }
55
+ const v = VERDICT.exec(t);
56
+ if (v) {
57
+ if (!section || section.verdict !== null) { section = emptySection(line); file.sections.push(section); }
58
+ section.verdict = v[1] as Verdict;
59
+ inside = true;
60
+ return;
61
+ }
62
+ if (/-VERIFY-/.test(t) && t.startsWith("# ")) file.problems.push({ line, message: `unknown verdict title '${t}'` });
63
+ else if (/^##\s+Verdict\b/.test(t)) file.problems.push({ line, message: `unknown verdict line '${t}'` });
64
+ return;
65
+ }
66
+ if (!section) return;
67
+ const current: VerdictSection = section;
68
+ let m: RegExpExecArray | null;
69
+ if ((m = VALIDATIONS.exec(t))) { current.validations.push(m[1]); return; }
70
+ if ((m = NOT_RUN.exec(t))) { current.notRun.push(m[1]); return; }
71
+ if ((m = MEASURE.exec(t))) { current.measure = m[1]; return; }
72
+ if (!inside) return;
73
+ if (t.trim() === "None.") { current.none = true; return; }
74
+ const s = t.trim();
75
+ // A row may omit its edge pipes, as the harness reads it: then its first cell must
76
+ // be a severity, so prose holding a pipe stays silent.
77
+ if (!s.startsWith("|") && !(s.includes("|") && SEVERITIES.has(s.slice(0, s.indexOf("|")).trim()))) return;
78
+ const cells = s.replace(/^\|+/, "").replace(/\|+$/, "").split("|").map((c) => c.trim());
79
+ if (cells[0] === "Severity" || /^-+$/.test(cells[0].replace(/:/g, ""))) return;
80
+ if (!SEVERITIES.has(cells[0])) { file.problems.push({ line, message: `unknown severity '${cells[0]}'` }); return; }
81
+ if (cells.length < 5) { file.problems.push({ line, message: `malformed gap row '${s}'` }); return; }
82
+ current.rows.push({
83
+ severity: cells[0] as Severity, axis: cells[1], gap: cells.slice(2, -2).join(" | "),
84
+ evidence: cells[cells.length - 2], expectedFix: cells[cells.length - 1], line,
85
+ });
86
+ });
87
+ return file;
88
+ }
89
+
90
+ /** The last section that carries a verdict heading; null when none. */
91
+ export function lastVerdict(file: VerdictFile): VerdictSection | null {
92
+ for (let i = file.sections.length - 1; i >= 0; i--) if (file.sections[i].verdict !== null) return file.sections[i];
93
+ return null;
94
+ }
95
+
96
+ /** A section an audit the step's budget stopped wrote: its row judges nothing of the code. */
97
+ export function isUnfinishedSection(section: VerdictSection): boolean {
98
+ return section.rows.some((r) => isAuditUnfinishedGap(r.gap));
99
+ }
100
+
101
+ /** The last verdict a finished audit wrote, skipping the sections of audits the budget stopped; null when none. */
102
+ export function lastFinishedVerdict(file: VerdictFile): VerdictSection | null {
103
+ for (let i = file.sections.length - 1; i >= 0; i--) {
104
+ const s = file.sections[i];
105
+ if (s.verdict !== null && !isUnfinishedSection(s)) return s;
106
+ }
107
+ return null;
108
+ }
109
+
110
+ /** The audit rounds in GAPS a batch is relaunched through by itself: the third still GAPS goes to a human. */
111
+ export const GAPS_ROUNDS_MAX = 3;
112
+
113
+ /** The audit rounds in GAPS since the last VALID: every trailing GAPS section, an audit the budget stopped included
114
+ * (three audits that cannot finish hand the batch over too). */
115
+ export function gapsRoundsOf(text: string): number {
116
+ const sections = parseVerdictFile(text).sections.filter((s) => s.verdict !== null);
117
+ let rounds = 0;
118
+ for (let i = sections.length - 1; i >= 0 && sections[i].verdict === "GAPS"; i--) rounds++;
119
+ return rounds;
120
+ }
121
+
122
+ /** The correction a GAPS verdict hands its batch's relaunch: the Blocking and Major rows of its last section, one
123
+ * `<severity> — <gap> (<evidence>)` each, joined on one line; undefined when the last verdict is not GAPS, when the
124
+ * budget stopped that audit (its resume runs, no correction) or when it holds no such row. */
125
+ export function gapsFinding(text: string): string | undefined {
126
+ const last = lastVerdict(parseVerdictFile(text));
127
+ if (last === null || last.verdict !== "GAPS" || isUnfinishedSection(last)) return undefined;
128
+ const rows = last.rows.filter((r) => r.severity === "Blocking" || r.severity === "Major");
129
+ if (rows.length === 0) return undefined;
130
+ return rows.map((r) => `${r.severity} — ${r.gap} (${r.evidence})`.replace(/\s+/g, " ").trim()).join("; ");
131
+ }
132
+
133
+ export function severityCounts(section: VerdictSection): Record<Severity, number> {
134
+ const counts: Record<Severity, number> = { Blocking: 0, Major: 0, Minor: 0 };
135
+ for (const r of section.rows) counts[r.severity]++;
136
+ return counts;
137
+ }
138
+
139
+ // The next step a verdict hands on, one shape per line: the audit prints them, the chain of /dev-batches and its
140
+ // waves read them back with the parsers below, so the printer and the readers cannot drift. `code` is the plan's
141
+ // code, or its `<path>/<CODE>-PLAN.md` when the line comes from a chain that holds the path.
142
+
143
+ /** The command that runs a batch again with an audit's gap appended to its sheet as a new step. */
144
+ export const correctionCommand = (code: string, batch: string, finding: string): string =>
145
+ `/dev-batches ${code} ${batch} — correction: ${finding}`;
146
+ /** The command that closes a VALID batch: its commit. */
147
+ export const closeCommand = (code: string, batch: string): string => `/dev-batches ${code} ${batch} --close`;
148
+ /** The command that audits a batch, `resume` adding one section to its verdict file. */
149
+ export const auditCommand = (code: string, batch: string, mode?: "fast" | "full" | "resume"): string =>
150
+ `/dev-batches ${code} ${batch} --audit${mode === undefined || mode === "fast" ? "" : ` ${mode}`}`;
151
+
152
+ /** The line a GAPS verdict ends on: the correction to run. */
153
+ export const correctionLine = (code: string, batch: string, finding: string): string => `→ ${correctionCommand(code, batch, finding)}`;
154
+ /** The line a VALID verdict ends on: the close to run. */
155
+ export const closeLine = (code: string, batch: string): string => `→ ${closeCommand(code, batch)}`;
156
+
157
+ const CORRECTION_LINE = /^\s*→ \/dev-batches (\S+) (F\d+) — correction: (.+)$/m;
158
+ const CLOSE_LINE = /^\s*→ \/dev-batches (\S+) (F\d+) --close\s*$/;
159
+
160
+ /** The first correction line of `text`: its code, batch and finding; null when it holds none. */
161
+ export function parseCorrectionLine(text: string): { code: string; batch: string; finding: string } | null {
162
+ const m = CORRECTION_LINE.exec(text);
163
+ return m === null ? null : { code: m[1], batch: m[2], finding: m[3].trim() };
164
+ }
165
+
166
+ /** True for a line that names a batch's next step: its correction or its close. */
167
+ export function isNextStepLine(line: string): boolean {
168
+ return CORRECTION_LINE.test(line.split("\n")[0]) || CLOSE_LINE.test(line);
169
+ }
@@ -0,0 +1,34 @@
1
+ // The whitespace `git diff --check` refuses, put right by code in a file a role wrote: trailing
2
+ // spaces or tabs at the end of a line, blank lines at the end of the file. A node insert at the end
3
+ // of a module leaves a blank line after the last member; the gate would stop the batch for it. Pure.
4
+
5
+ export interface TidyResult {
6
+ text: string;
7
+ /** What changed, one phrase each ("trailing whitespace on 2 lines", "a blank line at EOF removed"); empty: nothing. */
8
+ fixed: string[];
9
+ }
10
+
11
+ /** `text` without trailing whitespace on its lines nor blank lines at its end (its final newline kept as it was). */
12
+ export function tidyWhitespace(text: string): TidyResult {
13
+ const fixed: string[] = [];
14
+ const lines = text.split("\n");
15
+ let trailing = 0;
16
+ const stripped = lines.map((line) => {
17
+ const clean = line.replace(/[ \t]+$/u, "");
18
+ if (clean !== line) trailing += 1;
19
+ return clean;
20
+ });
21
+ if (trailing > 0) fixed.push(`trailing whitespace on ${trailing} line${trailing === 1 ? "" : "s"}`);
22
+ const endsWithNewline = text.endsWith("\n");
23
+ // The split's last element is "" when the text ends with a newline: the blank lines at EOF are the empty
24
+ // elements before it.
25
+ let end = stripped.length - (endsWithNewline ? 1 : 0);
26
+ let blank = 0;
27
+ while (end > 1 && stripped[end - 1] === "") {
28
+ end -= 1;
29
+ blank += 1;
30
+ }
31
+ if (blank > 0) fixed.push(blank === 1 ? "a blank line at EOF removed" : `${blank} blank lines at EOF removed`);
32
+ const body = stripped.slice(0, end).join("\n");
33
+ return { text: endsWithNewline ? `${body}\n` : body, fixed };
34
+ }
@@ -0,0 +1,67 @@
1
+ // The work folder of a checkout: where a dev workflow keeps `<work>/<code>/`.
2
+ // Pure rules only: how a requested folder is normalised and refused, which
3
+ // request applies (the config key before the pack's layout.work), and the two
4
+ // readings of git output the resolution needs. Nothing here touches a file or
5
+ // runs a command; resolve-work-folder.ts does, through the ports.
6
+
7
+ export const DEFAULT_WORK_FOLDER = "workbench";
8
+ export const DEV_WORK_DIR_CONFIG_KEY = "dev.workDir";
9
+
10
+ export type WorkDirCheck = { ok: true; folder: string } | { ok: false; reason: string };
11
+
12
+ // Python's str.isprintable() refuses the Other categories and every separator but the space.
13
+ const NON_PRINTABLE = /[\p{C}\p{Zl}\p{Zp}]|(?! )\p{Zs}/u;
14
+
15
+ /** Normalised as learn-candidates.py:61-63; folder "" when the value is empty. */
16
+ export function normalizeWorkDir(raw: string): WorkDirCheck {
17
+ let w = raw.replace(/[\t\r\n]/g, "").trim();
18
+ for (;;) {
19
+ if (w.startsWith("./")) w = w.slice(2);
20
+ else if (w.endsWith("/") && w !== "/") w = w.slice(0, -1);
21
+ else break;
22
+ }
23
+ if (w === "") return { ok: true, folder: "" };
24
+ const parts = w.split("/");
25
+ if (w.startsWith("/")) return { ok: false, reason: "an absolute path" };
26
+ if (w.includes("//")) return { ok: false, reason: "an empty segment" };
27
+ if (parts.includes("..") || parts.includes(".")) return { ok: false, reason: "a '..' or '.' segment" };
28
+ if (parts[0] === ".claude" || parts[0] === ".git") return { ok: false, reason: "under .claude/ or .git/" };
29
+ if (NON_PRINTABLE.test(w)) return { ok: false, reason: "a non-printable character" };
30
+ return { ok: true, folder: w };
31
+ }
32
+
33
+ /** For CONFIG_KEYS.problem: undefined when valid, else the reason. */
34
+ export function workFolderProblem(value: string): string | undefined {
35
+ const check = normalizeWorkDir(value);
36
+ return check.ok ? undefined : `'${value}' is not a relative folder of the checkout: ${check.reason}`;
37
+ }
38
+
39
+ export type WorkDirSource = "dev.workDir" | "layout.work";
40
+
41
+ export interface WorkDirRequest {
42
+ value: string;
43
+ source: WorkDirSource;
44
+ }
45
+
46
+ /** The first of (config, pack) whose trimmed value is non-empty; null when neither. */
47
+ export function pickWorkDirRequest(
48
+ configValue: string | undefined,
49
+ packValue: string | undefined,
50
+ ): WorkDirRequest | null {
51
+ if (configValue !== undefined && configValue.trim() !== "") return { value: configValue, source: "dev.workDir" };
52
+ if (packValue !== undefined && packValue.trim() !== "") return { value: packValue, source: "layout.work" };
53
+ return null;
54
+ }
55
+
56
+ /** The path after "worktree " on the first line of `git worktree list --porcelain`; null otherwise. */
57
+ export function mainWorktreeOf(porcelain: string): string | null {
58
+ const first = porcelain.split("\n", 1)[0].replace(/\r$/, "");
59
+ if (!first.startsWith("worktree ")) return null;
60
+ const path = first.slice("worktree ".length);
61
+ return path === "" ? null : path;
62
+ }
63
+
64
+ /** Equal once trailing "/" are removed. */
65
+ export function isSamePath(a: string, b: string): boolean {
66
+ return a.replace(/\/+$/, "") === b.replace(/\/+$/, "");
67
+ }