@rpamis/comet 0.4.0-beta.8 → 0.4.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 (1536) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +207 -101
  3. package/assets/eval-reports/comet-native-vs-beta16-beta17-20260810/native-benchmark-report.html +8 -0
  4. package/assets/eval-reports/comet-native-vs-beta16-beta17-20260810/native-benchmark-report.json +286 -0
  5. package/assets/manifest.json +41 -12
  6. package/assets/skills/comet/SKILL.md +14 -13
  7. package/assets/skills/comet/agents/openai.yaml +3 -0
  8. package/assets/skills/comet/rules/comet-phase-guard.en.md +15 -13
  9. package/assets/skills/comet/rules/comet-phase-guard.md +15 -13
  10. package/assets/skills/comet/rules/comet-workflow-guard.en.md +23 -7
  11. package/assets/skills/comet/rules/comet-workflow-guard.md +23 -7
  12. package/assets/skills/comet/scripts/comet-archive.mjs +165 -2
  13. package/assets/skills/comet/scripts/comet-entry-runtime.mjs +146 -7852
  14. package/assets/skills/comet/scripts/comet-guard.mjs +206 -2
  15. package/assets/skills/comet/scripts/comet-handoff.mjs +165 -2
  16. package/assets/skills/comet/scripts/comet-hook-guard.mjs +153 -2
  17. package/assets/skills/comet/scripts/comet-hook-router.mjs +285 -10333
  18. package/assets/skills/comet/scripts/comet-intent.mjs +10 -2
  19. package/assets/skills/comet/scripts/comet-resume-probe.mjs +148 -2
  20. package/assets/skills/comet/scripts/comet-runtime.mjs +295 -14571
  21. package/assets/skills/comet/scripts/comet-state.mjs +165 -2
  22. package/assets/skills/comet/scripts/comet-yaml-validate.mjs +149 -2
  23. package/assets/skills/comet-any/SKILL.md +4 -3
  24. package/assets/skills/comet-any/agents/openai.yaml +5 -0
  25. package/assets/skills/comet-any/reference/authoring-subagents.md +3 -11
  26. package/assets/skills/comet-any/reference/bundle-authoring.md +1 -1
  27. package/assets/skills/comet-any/reference/subagents/pause-points-author.md +1 -4
  28. package/assets/skills/comet-any/reference/subagents/reference-author.md +1 -4
  29. package/assets/skills/comet-any/reference/subagents/script-author.md +2 -5
  30. package/assets/skills/comet-any/reference/subagents/skill-core-author.md +1 -4
  31. package/assets/skills/comet-any/reference/subagents/skill-reviewer.md +1 -4
  32. package/assets/skills/comet-any/reference/subagents/workflow-entry-author.md +1 -4
  33. package/assets/skills/comet-archive/SKILL.md +45 -29
  34. package/assets/skills/comet-archive/agents/openai.yaml +5 -0
  35. package/assets/skills/comet-build/SKILL.md +84 -127
  36. package/assets/skills/comet-build/agents/openai.yaml +5 -0
  37. package/assets/skills/comet-classic/SKILL.md +45 -35
  38. package/assets/skills/comet-classic/agents/openai.yaml +3 -0
  39. package/assets/skills/{comet → comet-classic}/reference/auto-transition.md +1 -1
  40. package/assets/skills/comet-classic/reference/classic-layout.md +34 -0
  41. package/assets/skills/{comet → comet-classic}/reference/comet-yaml-fields.md +6 -6
  42. package/assets/skills/{comet → comet-classic}/reference/context-recovery.md +7 -7
  43. package/assets/skills/{comet → comet-classic}/reference/debug-gate.md +2 -2
  44. package/assets/skills/{comet → comet-classic}/reference/decision-point.md +5 -6
  45. package/assets/skills/{comet → comet-classic}/reference/dirty-worktree.md +1 -1
  46. package/assets/skills/{comet → comet-classic}/reference/file-structure.md +3 -3
  47. package/assets/skills/{comet → comet-classic}/reference/intent-frame.md +2 -2
  48. package/assets/skills/comet-classic/reference/scripts.md +73 -0
  49. package/assets/skills/{comet → comet-classic}/reference/subagent-dispatch.md +27 -31
  50. package/assets/skills/comet-classic/reference/workspace.md +23 -0
  51. package/assets/skills/comet-design/SKILL.md +26 -24
  52. package/assets/skills/comet-design/agents/openai.yaml +5 -0
  53. package/assets/skills/comet-hotfix/SKILL.md +20 -13
  54. package/assets/skills/comet-hotfix/agents/openai.yaml +5 -0
  55. package/assets/skills/comet-memory/SKILL.md +67 -0
  56. package/assets/skills/comet-memory/agents/openai.yaml +5 -0
  57. package/assets/skills/comet-native/SKILL.md +86 -231
  58. package/assets/skills/comet-native/agents/openai.yaml +3 -0
  59. package/assets/skills/comet-native/reference/artifacts.md +48 -166
  60. package/assets/skills/comet-native/reference/clarification.md +77 -0
  61. package/assets/skills/comet-native/reference/commands.md +34 -101
  62. package/assets/skills/comet-native/reference/recovery.md +37 -113
  63. package/assets/skills/comet-native/reference/workspace.md +23 -0
  64. package/assets/skills/comet-native/scripts/comet-native-archive.mjs +228 -0
  65. package/assets/skills/comet-native/scripts/comet-native-doctor.mjs +280 -0
  66. package/assets/skills/comet-native/scripts/comet-native-hook-guard.mjs +166 -2
  67. package/assets/skills/comet-native/scripts/comet-native-init.mjs +188 -0
  68. package/assets/skills/comet-native/scripts/comet-native-new.mjs +199 -0
  69. package/assets/skills/comet-native/scripts/comet-native-next.mjs +254 -0
  70. package/assets/skills/comet-native/scripts/comet-native-root.mjs +197 -0
  71. package/assets/skills/comet-native/scripts/comet-native-runtime.mjs +302 -28966
  72. package/assets/skills/comet-native/scripts/comet-native-select.mjs +187 -0
  73. package/assets/skills/comet-native/scripts/comet-native-show.mjs +160 -0
  74. package/assets/skills/comet-native/scripts/comet-native-spec.mjs +164 -0
  75. package/assets/skills/comet-native/scripts/comet-native-status.mjs +184 -0
  76. package/assets/skills/comet-open/SKILL.md +50 -20
  77. package/assets/skills/comet-open/agents/openai.yaml +5 -0
  78. package/assets/skills/comet-review/SKILL.md +121 -0
  79. package/assets/skills/comet-review/agents/openai.yaml +5 -0
  80. package/assets/skills/comet-tweak/SKILL.md +23 -13
  81. package/assets/skills/comet-tweak/agents/openai.yaml +5 -0
  82. package/assets/skills/comet-verify/SKILL.md +25 -30
  83. package/assets/skills/comet-verify/agents/openai.yaml +5 -0
  84. package/assets/skills-zh/comet/SKILL.md +14 -12
  85. package/assets/skills-zh/comet/agents/openai.yaml +3 -0
  86. package/assets/skills-zh/comet-any/SKILL.md +4 -3
  87. package/assets/skills-zh/comet-any/agents/openai.yaml +5 -0
  88. package/assets/skills-zh/comet-any/reference/authoring-subagents.md +3 -14
  89. package/assets/skills-zh/comet-any/reference/bundle-authoring.md +1 -1
  90. package/assets/skills-zh/comet-any/reference/subagents/pause-points-author.md +1 -4
  91. package/assets/skills-zh/comet-any/reference/subagents/reference-author.md +1 -4
  92. package/assets/skills-zh/comet-any/reference/subagents/script-author.md +2 -5
  93. package/assets/skills-zh/comet-any/reference/subagents/skill-core-author.md +1 -4
  94. package/assets/skills-zh/comet-any/reference/subagents/skill-reviewer.md +1 -4
  95. package/assets/skills-zh/comet-any/reference/subagents/workflow-entry-author.md +1 -4
  96. package/assets/skills-zh/comet-archive/SKILL.md +45 -29
  97. package/assets/skills-zh/comet-archive/agents/openai.yaml +5 -0
  98. package/assets/skills-zh/comet-build/SKILL.md +62 -105
  99. package/assets/skills-zh/comet-build/agents/openai.yaml +5 -0
  100. package/assets/skills-zh/comet-classic/SKILL.md +44 -34
  101. package/assets/skills-zh/comet-classic/agents/openai.yaml +3 -0
  102. package/assets/skills-zh/{comet → comet-classic}/reference/auto-transition.md +1 -1
  103. package/assets/skills-zh/comet-classic/reference/classic-layout.md +34 -0
  104. package/assets/skills-zh/{comet → comet-classic}/reference/comet-yaml-fields.md +6 -6
  105. package/assets/skills-zh/{comet → comet-classic}/reference/context-recovery.md +7 -7
  106. package/assets/skills-zh/{comet → comet-classic}/reference/debug-gate.md +2 -2
  107. package/assets/skills-zh/{comet → comet-classic}/reference/decision-point.md +5 -6
  108. package/assets/skills-zh/{comet → comet-classic}/reference/dirty-worktree.md +1 -1
  109. package/assets/skills-zh/{comet → comet-classic}/reference/file-structure.md +3 -3
  110. package/assets/skills-zh/{comet → comet-classic}/reference/intent-frame.md +2 -2
  111. package/assets/skills-zh/comet-classic/reference/scripts.md +73 -0
  112. package/assets/skills-zh/{comet → comet-classic}/reference/subagent-dispatch.md +27 -31
  113. package/assets/skills-zh/comet-classic/reference/workspace.md +23 -0
  114. package/assets/skills-zh/comet-design/SKILL.md +26 -24
  115. package/assets/skills-zh/comet-design/agents/openai.yaml +5 -0
  116. package/assets/skills-zh/comet-hotfix/SKILL.md +21 -14
  117. package/assets/skills-zh/comet-hotfix/agents/openai.yaml +5 -0
  118. package/assets/skills-zh/comet-memory/SKILL.md +67 -0
  119. package/assets/skills-zh/comet-memory/agents/openai.yaml +5 -0
  120. package/assets/skills-zh/comet-native/SKILL.md +85 -230
  121. package/assets/skills-zh/comet-native/agents/openai.yaml +3 -0
  122. package/assets/skills-zh/comet-native/reference/artifacts.md +48 -168
  123. package/assets/skills-zh/comet-native/reference/clarification.md +77 -0
  124. package/assets/skills-zh/comet-native/reference/commands.md +34 -101
  125. package/assets/skills-zh/comet-native/reference/recovery.md +37 -113
  126. package/assets/skills-zh/comet-native/reference/workspace.md +23 -0
  127. package/assets/skills-zh/comet-open/SKILL.md +55 -25
  128. package/assets/skills-zh/comet-open/agents/openai.yaml +5 -0
  129. package/assets/skills-zh/comet-review/SKILL.md +121 -0
  130. package/assets/skills-zh/comet-review/agents/openai.yaml +5 -0
  131. package/assets/skills-zh/comet-tweak/SKILL.md +23 -13
  132. package/assets/skills-zh/comet-tweak/agents/openai.yaml +5 -0
  133. package/assets/skills-zh/comet-verify/SKILL.md +25 -30
  134. package/assets/skills-zh/comet-verify/agents/openai.yaml +5 -0
  135. package/bin/comet.js +5 -1
  136. package/bin/fast-runtime-router.js +79 -0
  137. package/dist/app/cli/index.js +346 -19
  138. package/dist/app/cli/index.js.map +1 -1
  139. package/dist/app/commands/classic.d.ts +1 -0
  140. package/dist/app/commands/classic.d.ts.map +1 -1
  141. package/dist/app/commands/classic.js +127 -1
  142. package/dist/app/commands/classic.js.map +1 -1
  143. package/dist/app/commands/comet-task.d.ts +29 -0
  144. package/dist/app/commands/comet-task.d.ts.map +1 -0
  145. package/dist/app/commands/comet-task.js +96 -0
  146. package/dist/app/commands/comet-task.js.map +1 -0
  147. package/dist/app/commands/dashboard.d.ts.map +1 -1
  148. package/dist/app/commands/dashboard.js +8 -2
  149. package/dist/app/commands/dashboard.js.map +1 -1
  150. package/dist/app/commands/doctor.d.ts +2 -0
  151. package/dist/app/commands/doctor.d.ts.map +1 -1
  152. package/dist/app/commands/doctor.js +787 -94
  153. package/dist/app/commands/doctor.js.map +1 -1
  154. package/dist/app/commands/eval.d.ts +9 -2
  155. package/dist/app/commands/eval.d.ts.map +1 -1
  156. package/dist/app/commands/eval.js +303 -47
  157. package/dist/app/commands/eval.js.map +1 -1
  158. package/dist/app/commands/i18n.d.ts +1 -1
  159. package/dist/app/commands/i18n.d.ts.map +1 -1
  160. package/dist/app/commands/i18n.js +100 -0
  161. package/dist/app/commands/i18n.js.map +1 -1
  162. package/dist/app/commands/init.d.ts +2 -0
  163. package/dist/app/commands/init.d.ts.map +1 -1
  164. package/dist/app/commands/init.js +305 -75
  165. package/dist/app/commands/init.js.map +1 -1
  166. package/dist/app/commands/native.d.ts.map +1 -1
  167. package/dist/app/commands/native.js +126 -1
  168. package/dist/app/commands/native.js.map +1 -1
  169. package/dist/app/commands/personal-memory.d.ts +42 -0
  170. package/dist/app/commands/personal-memory.d.ts.map +1 -0
  171. package/dist/app/commands/personal-memory.js +330 -0
  172. package/dist/app/commands/personal-memory.js.map +1 -0
  173. package/dist/app/commands/project-knowledge.d.ts +23 -0
  174. package/dist/app/commands/project-knowledge.d.ts.map +1 -0
  175. package/dist/app/commands/project-knowledge.js +198 -0
  176. package/dist/app/commands/project-knowledge.js.map +1 -0
  177. package/dist/app/commands/project-scope-selection.d.ts +2 -1
  178. package/dist/app/commands/project-scope-selection.d.ts.map +1 -1
  179. package/dist/app/commands/project-scope-selection.js +5 -7
  180. package/dist/app/commands/project-scope-selection.js.map +1 -1
  181. package/dist/app/commands/resume-probe.d.ts +1 -0
  182. package/dist/app/commands/resume-probe.d.ts.map +1 -1
  183. package/dist/app/commands/resume-probe.js +9 -10
  184. package/dist/app/commands/resume-probe.js.map +1 -1
  185. package/dist/app/commands/status.d.ts.map +1 -1
  186. package/dist/app/commands/status.js +20 -0
  187. package/dist/app/commands/status.js.map +1 -1
  188. package/dist/app/commands/uninstall.d.ts +6 -0
  189. package/dist/app/commands/uninstall.d.ts.map +1 -1
  190. package/dist/app/commands/uninstall.js +298 -69
  191. package/dist/app/commands/uninstall.js.map +1 -1
  192. package/dist/app/commands/update.d.ts +4 -1
  193. package/dist/app/commands/update.d.ts.map +1 -1
  194. package/dist/app/commands/update.js +484 -35
  195. package/dist/app/commands/update.js.map +1 -1
  196. package/dist/app/commands/workflow.d.ts +4 -0
  197. package/dist/app/commands/workflow.d.ts.map +1 -1
  198. package/dist/app/commands/workflow.js +25 -2
  199. package/dist/app/commands/workflow.js.map +1 -1
  200. package/dist/config/repository-layout.json +30 -3
  201. package/dist/domains/agent-learning/context-director.d.ts +135 -0
  202. package/dist/domains/agent-learning/context-director.d.ts.map +1 -0
  203. package/dist/domains/agent-learning/context-director.js +639 -0
  204. package/dist/domains/agent-learning/context-director.js.map +1 -0
  205. package/dist/domains/agent-learning/coordinator.d.ts +71 -0
  206. package/dist/domains/agent-learning/coordinator.d.ts.map +1 -0
  207. package/dist/domains/agent-learning/coordinator.js +321 -0
  208. package/dist/domains/agent-learning/coordinator.js.map +1 -0
  209. package/dist/domains/agent-learning/experience-journal.d.ts +88 -0
  210. package/dist/domains/agent-learning/experience-journal.d.ts.map +1 -0
  211. package/dist/domains/agent-learning/experience-journal.js +330 -0
  212. package/dist/domains/agent-learning/experience-journal.js.map +1 -0
  213. package/dist/domains/agent-learning/index.d.ts +6 -0
  214. package/dist/domains/agent-learning/index.d.ts.map +1 -0
  215. package/dist/domains/agent-learning/index.js +6 -0
  216. package/dist/domains/agent-learning/index.js.map +1 -0
  217. package/dist/domains/agent-learning/policy-compiler.d.ts +22 -0
  218. package/dist/domains/agent-learning/policy-compiler.d.ts.map +1 -0
  219. package/dist/domains/agent-learning/policy-compiler.js +20 -0
  220. package/dist/domains/agent-learning/policy-compiler.js.map +1 -0
  221. package/dist/domains/agent-learning/types.d.ts +137 -0
  222. package/dist/domains/agent-learning/types.d.ts.map +1 -0
  223. package/dist/domains/agent-learning/types.js +319 -0
  224. package/dist/domains/agent-learning/types.js.map +1 -0
  225. package/dist/domains/bundle/bundle-platform.d.ts.map +1 -1
  226. package/dist/domains/bundle/bundle-platform.js +79 -10
  227. package/dist/domains/bundle/bundle-platform.js.map +1 -1
  228. package/dist/domains/bundle/compatibility-benchmark.d.ts.map +1 -1
  229. package/dist/domains/bundle/compatibility-benchmark.js +9 -1
  230. package/dist/domains/bundle/compatibility-benchmark.js.map +1 -1
  231. package/dist/domains/bundle/eval-manifest-runtime.d.ts +2 -0
  232. package/dist/domains/bundle/eval-manifest-runtime.d.ts.map +1 -1
  233. package/dist/domains/bundle/eval-manifest-runtime.js +67 -7
  234. package/dist/domains/bundle/eval-manifest-runtime.js.map +1 -1
  235. package/dist/domains/bundle/eval-run-result.d.ts +22 -0
  236. package/dist/domains/bundle/eval-run-result.d.ts.map +1 -0
  237. package/dist/domains/bundle/eval-run-result.js +207 -0
  238. package/dist/domains/bundle/eval-run-result.js.map +1 -0
  239. package/dist/domains/bundle/eval.d.ts.map +1 -1
  240. package/dist/domains/bundle/eval.js +21 -24
  241. package/dist/domains/bundle/eval.js.map +1 -1
  242. package/dist/domains/bundle/factory.d.ts.map +1 -1
  243. package/dist/domains/bundle/factory.js +2 -9
  244. package/dist/domains/bundle/factory.js.map +1 -1
  245. package/dist/domains/bundle/review-summary.js +1 -1
  246. package/dist/domains/bundle/review-summary.js.map +1 -1
  247. package/dist/domains/bundle/state.d.ts.map +1 -1
  248. package/dist/domains/bundle/state.js +117 -2
  249. package/dist/domains/bundle/state.js.map +1 -1
  250. package/dist/domains/bundle/types.d.ts +2 -2
  251. package/dist/domains/bundle/types.d.ts.map +1 -1
  252. package/dist/domains/comet-classic/classic-archive-entry.js +1 -1
  253. package/dist/domains/comet-classic/classic-archive-entry.js.map +1 -1
  254. package/dist/domains/comet-classic/classic-archive-pointer.d.ts +8 -0
  255. package/dist/domains/comet-classic/classic-archive-pointer.d.ts.map +1 -0
  256. package/dist/domains/comet-classic/classic-archive-pointer.js +66 -0
  257. package/dist/domains/comet-classic/classic-archive-pointer.js.map +1 -0
  258. package/dist/domains/comet-classic/classic-archive.d.ts.map +1 -1
  259. package/dist/domains/comet-classic/classic-archive.js +171 -80
  260. package/dist/domains/comet-classic/classic-archive.js.map +1 -1
  261. package/dist/domains/comet-classic/classic-branch-binding.d.ts.map +1 -1
  262. package/dist/domains/comet-classic/classic-branch-binding.js +10 -2
  263. package/dist/domains/comet-classic/classic-branch-binding.js.map +1 -1
  264. package/dist/domains/comet-classic/classic-cli.d.ts +3 -1
  265. package/dist/domains/comet-classic/classic-cli.d.ts.map +1 -1
  266. package/dist/domains/comet-classic/classic-cli.js +12 -3
  267. package/dist/domains/comet-classic/classic-cli.js.map +1 -1
  268. package/dist/domains/comet-classic/classic-command-checks.d.ts +2 -2
  269. package/dist/domains/comet-classic/classic-command-checks.d.ts.map +1 -1
  270. package/dist/domains/comet-classic/classic-command-checks.js +8 -11
  271. package/dist/domains/comet-classic/classic-command-checks.js.map +1 -1
  272. package/dist/domains/comet-classic/classic-command-context.d.ts +21 -0
  273. package/dist/domains/comet-classic/classic-command-context.d.ts.map +1 -0
  274. package/dist/domains/comet-classic/classic-command-context.js +52 -0
  275. package/dist/domains/comet-classic/classic-command-context.js.map +1 -0
  276. package/dist/domains/comet-classic/classic-current-change.d.ts.map +1 -1
  277. package/dist/domains/comet-classic/classic-current-change.js +45 -25
  278. package/dist/domains/comet-classic/classic-current-change.js.map +1 -1
  279. package/dist/domains/comet-classic/classic-evidence.d.ts +1 -0
  280. package/dist/domains/comet-classic/classic-evidence.d.ts.map +1 -1
  281. package/dist/domains/comet-classic/classic-evidence.js +136 -40
  282. package/dist/domains/comet-classic/classic-evidence.js.map +1 -1
  283. package/dist/domains/comet-classic/classic-experience.d.ts +8 -0
  284. package/dist/domains/comet-classic/classic-experience.d.ts.map +1 -0
  285. package/dist/domains/comet-classic/classic-experience.js +46 -0
  286. package/dist/domains/comet-classic/classic-experience.js.map +1 -0
  287. package/dist/domains/comet-classic/classic-guard-entry.js +1 -1
  288. package/dist/domains/comet-classic/classic-guard-entry.js.map +1 -1
  289. package/dist/domains/comet-classic/classic-guard.d.ts.map +1 -1
  290. package/dist/domains/comet-classic/classic-guard.js +102 -76
  291. package/dist/domains/comet-classic/classic-guard.js.map +1 -1
  292. package/dist/domains/comet-classic/classic-handoff-entry.js +1 -1
  293. package/dist/domains/comet-classic/classic-handoff-entry.js.map +1 -1
  294. package/dist/domains/comet-classic/classic-handoff.d.ts.map +1 -1
  295. package/dist/domains/comet-classic/classic-handoff.js +195 -109
  296. package/dist/domains/comet-classic/classic-handoff.js.map +1 -1
  297. package/dist/domains/comet-classic/classic-hook-guard-entry.js +1 -1
  298. package/dist/domains/comet-classic/classic-hook-guard-entry.js.map +1 -1
  299. package/dist/domains/comet-classic/classic-hook-guard.d.ts +5 -1
  300. package/dist/domains/comet-classic/classic-hook-guard.d.ts.map +1 -1
  301. package/dist/domains/comet-classic/classic-hook-guard.js +234 -83
  302. package/dist/domains/comet-classic/classic-hook-guard.js.map +1 -1
  303. package/dist/domains/comet-classic/classic-intent-command.d.ts.map +1 -1
  304. package/dist/domains/comet-classic/classic-intent-command.js +2 -1
  305. package/dist/domains/comet-classic/classic-intent-command.js.map +1 -1
  306. package/dist/domains/comet-classic/classic-intent-entry.js +1 -1
  307. package/dist/domains/comet-classic/classic-intent-entry.js.map +1 -1
  308. package/dist/domains/comet-classic/classic-layout-initialization.d.ts +87 -0
  309. package/dist/domains/comet-classic/classic-layout-initialization.d.ts.map +1 -0
  310. package/dist/domains/comet-classic/classic-layout-initialization.js +828 -0
  311. package/dist/domains/comet-classic/classic-layout-initialization.js.map +1 -0
  312. package/dist/domains/comet-classic/classic-layout.d.ts +41 -0
  313. package/dist/domains/comet-classic/classic-layout.d.ts.map +1 -0
  314. package/dist/domains/comet-classic/classic-layout.js +222 -0
  315. package/dist/domains/comet-classic/classic-layout.js.map +1 -0
  316. package/dist/domains/comet-classic/classic-migrate.d.ts +4 -0
  317. package/dist/domains/comet-classic/classic-migrate.d.ts.map +1 -1
  318. package/dist/domains/comet-classic/classic-migrate.js +8 -12
  319. package/dist/domains/comet-classic/classic-migrate.js.map +1 -1
  320. package/dist/domains/comet-classic/classic-openspec-command.d.ts +4 -0
  321. package/dist/domains/comet-classic/classic-openspec-command.d.ts.map +1 -0
  322. package/dist/domains/comet-classic/classic-openspec-command.js +45 -0
  323. package/dist/domains/comet-classic/classic-openspec-command.js.map +1 -0
  324. package/dist/domains/comet-classic/classic-openspec-root.d.ts +13 -0
  325. package/dist/domains/comet-classic/classic-openspec-root.d.ts.map +1 -0
  326. package/dist/domains/comet-classic/classic-openspec-root.js +47 -0
  327. package/dist/domains/comet-classic/classic-openspec-root.js.map +1 -0
  328. package/dist/domains/comet-classic/classic-paths.d.ts +11 -1
  329. package/dist/domains/comet-classic/classic-paths.d.ts.map +1 -1
  330. package/dist/domains/comet-classic/classic-paths.js +87 -35
  331. package/dist/domains/comet-classic/classic-paths.js.map +1 -1
  332. package/dist/domains/comet-classic/classic-plan-readiness.d.ts +12 -0
  333. package/dist/domains/comet-classic/classic-plan-readiness.d.ts.map +1 -0
  334. package/dist/domains/comet-classic/classic-plan-readiness.js +26 -0
  335. package/dist/domains/comet-classic/classic-plan-readiness.js.map +1 -0
  336. package/dist/domains/comet-classic/classic-project-config.d.ts +1 -0
  337. package/dist/domains/comet-classic/classic-project-config.d.ts.map +1 -1
  338. package/dist/domains/comet-classic/classic-project-config.js +16 -18
  339. package/dist/domains/comet-classic/classic-project-config.js.map +1 -1
  340. package/dist/domains/comet-classic/classic-protected-path.d.ts +39 -0
  341. package/dist/domains/comet-classic/classic-protected-path.d.ts.map +1 -0
  342. package/dist/domains/comet-classic/classic-protected-path.js +69 -0
  343. package/dist/domains/comet-classic/classic-protected-path.js.map +1 -0
  344. package/dist/domains/comet-classic/classic-resume-probe-command.d.ts.map +1 -1
  345. package/dist/domains/comet-classic/classic-resume-probe-command.js +6 -4
  346. package/dist/domains/comet-classic/classic-resume-probe-command.js.map +1 -1
  347. package/dist/domains/comet-classic/classic-resume-probe-entry.js +1 -1
  348. package/dist/domains/comet-classic/classic-resume-probe-entry.js.map +1 -1
  349. package/dist/domains/comet-classic/classic-resume-probe.d.ts.map +1 -1
  350. package/dist/domains/comet-classic/classic-resume-probe.js +41 -21
  351. package/dist/domains/comet-classic/classic-resume-probe.js.map +1 -1
  352. package/dist/domains/comet-classic/classic-root-command.d.ts +8 -0
  353. package/dist/domains/comet-classic/classic-root-command.d.ts.map +1 -0
  354. package/dist/domains/comet-classic/classic-root-command.js +199 -0
  355. package/dist/domains/comet-classic/classic-root-command.js.map +1 -0
  356. package/dist/domains/comet-classic/classic-root-move.d.ts +118 -0
  357. package/dist/domains/comet-classic/classic-root-move.d.ts.map +1 -0
  358. package/dist/domains/comet-classic/classic-root-move.js +1640 -0
  359. package/dist/domains/comet-classic/classic-root-move.js.map +1 -0
  360. package/dist/domains/comet-classic/classic-runtime-run.d.ts +6 -0
  361. package/dist/domains/comet-classic/classic-runtime-run.d.ts.map +1 -1
  362. package/dist/domains/comet-classic/classic-runtime-run.js +58 -9
  363. package/dist/domains/comet-classic/classic-runtime-run.js.map +1 -1
  364. package/dist/domains/comet-classic/classic-script-entry.d.ts +2 -2
  365. package/dist/domains/comet-classic/classic-script-entry.d.ts.map +1 -1
  366. package/dist/domains/comet-classic/classic-script-entry.js +4 -3
  367. package/dist/domains/comet-classic/classic-script-entry.js.map +1 -1
  368. package/dist/domains/comet-classic/classic-state-command.d.ts.map +1 -1
  369. package/dist/domains/comet-classic/classic-state-command.js +229 -105
  370. package/dist/domains/comet-classic/classic-state-command.js.map +1 -1
  371. package/dist/domains/comet-classic/classic-state-entry.js +1 -1
  372. package/dist/domains/comet-classic/classic-state-entry.js.map +1 -1
  373. package/dist/domains/comet-classic/classic-state-events.d.ts.map +1 -1
  374. package/dist/domains/comet-classic/classic-state-events.js +3 -4
  375. package/dist/domains/comet-classic/classic-state-events.js.map +1 -1
  376. package/dist/domains/comet-classic/classic-store.d.ts +2 -0
  377. package/dist/domains/comet-classic/classic-store.d.ts.map +1 -1
  378. package/dist/domains/comet-classic/classic-store.js +12 -17
  379. package/dist/domains/comet-classic/classic-store.js.map +1 -1
  380. package/dist/domains/comet-classic/classic-validate-command.d.ts.map +1 -1
  381. package/dist/domains/comet-classic/classic-validate-command.js +26 -19
  382. package/dist/domains/comet-classic/classic-validate-command.js.map +1 -1
  383. package/dist/domains/comet-classic/classic-validate-entry.js +1 -1
  384. package/dist/domains/comet-classic/classic-validate-entry.js.map +1 -1
  385. package/dist/domains/comet-classic/classic-workspace-command.d.ts +3 -0
  386. package/dist/domains/comet-classic/classic-workspace-command.d.ts.map +1 -0
  387. package/dist/domains/comet-classic/classic-workspace-command.js +45 -0
  388. package/dist/domains/comet-classic/classic-workspace-command.js.map +1 -0
  389. package/dist/domains/comet-classic/classic-workspace.d.ts +38 -0
  390. package/dist/domains/comet-classic/classic-workspace.d.ts.map +1 -0
  391. package/dist/domains/comet-classic/classic-workspace.js +315 -0
  392. package/dist/domains/comet-classic/classic-workspace.js.map +1 -0
  393. package/dist/domains/comet-classic/index.d.ts +1 -0
  394. package/dist/domains/comet-classic/index.d.ts.map +1 -1
  395. package/dist/domains/comet-classic/index.js +1 -0
  396. package/dist/domains/comet-classic/index.js.map +1 -1
  397. package/dist/domains/comet-entry/current-selection-repair.js +1 -1
  398. package/dist/domains/comet-entry/current-selection-repair.js.map +1 -1
  399. package/dist/domains/comet-entry/current-selection.d.ts.map +1 -1
  400. package/dist/domains/comet-entry/current-selection.js +6 -8
  401. package/dist/domains/comet-entry/current-selection.js.map +1 -1
  402. package/dist/domains/comet-entry/entry-reads.d.ts +17 -0
  403. package/dist/domains/comet-entry/entry-reads.d.ts.map +1 -0
  404. package/dist/domains/comet-entry/entry-reads.js +20 -0
  405. package/dist/domains/comet-entry/entry-reads.js.map +1 -0
  406. package/dist/domains/comet-entry/hook-adapter.d.ts.map +1 -1
  407. package/dist/domains/comet-entry/hook-adapter.js +90 -4
  408. package/dist/domains/comet-entry/hook-adapter.js.map +1 -1
  409. package/dist/domains/comet-entry/hook-project-root.d.ts +3 -0
  410. package/dist/domains/comet-entry/hook-project-root.d.ts.map +1 -0
  411. package/dist/domains/comet-entry/hook-project-root.js +62 -0
  412. package/dist/domains/comet-entry/hook-project-root.js.map +1 -0
  413. package/dist/domains/comet-entry/hook-router-entry.d.ts +4 -1
  414. package/dist/domains/comet-entry/hook-router-entry.d.ts.map +1 -1
  415. package/dist/domains/comet-entry/hook-router-entry.js +47 -33
  416. package/dist/domains/comet-entry/hook-router-entry.js.map +1 -1
  417. package/dist/domains/comet-entry/hook-router.d.ts +16 -2
  418. package/dist/domains/comet-entry/hook-router.d.ts.map +1 -1
  419. package/dist/domains/comet-entry/hook-router.js +118 -20
  420. package/dist/domains/comet-entry/hook-router.js.map +1 -1
  421. package/dist/domains/comet-entry/hook-types.d.ts +5 -1
  422. package/dist/domains/comet-entry/hook-types.d.ts.map +1 -1
  423. package/dist/domains/comet-entry/init-workflow.d.ts +4 -1
  424. package/dist/domains/comet-entry/init-workflow.d.ts.map +1 -1
  425. package/dist/domains/comet-entry/init-workflow.js +65 -30
  426. package/dist/domains/comet-entry/init-workflow.js.map +1 -1
  427. package/dist/domains/comet-entry/plugin-context.d.ts +26 -0
  428. package/dist/domains/comet-entry/plugin-context.d.ts.map +1 -0
  429. package/dist/domains/comet-entry/plugin-context.js +127 -0
  430. package/dist/domains/comet-entry/plugin-context.js.map +1 -0
  431. package/dist/domains/comet-entry/project-activation.d.ts +12 -0
  432. package/dist/domains/comet-entry/project-activation.d.ts.map +1 -0
  433. package/dist/domains/comet-entry/project-activation.js +114 -0
  434. package/dist/domains/comet-entry/project-activation.js.map +1 -0
  435. package/dist/domains/comet-entry/project-status.d.ts.map +1 -1
  436. package/dist/domains/comet-entry/project-status.js +125 -48
  437. package/dist/domains/comet-entry/project-status.js.map +1 -1
  438. package/dist/domains/comet-entry/resolve-entry.d.ts.map +1 -1
  439. package/dist/domains/comet-entry/resolve-entry.js +4 -9
  440. package/dist/domains/comet-entry/resolve-entry.js.map +1 -1
  441. package/dist/domains/comet-entry/resume-probe.d.ts.map +1 -1
  442. package/dist/domains/comet-entry/resume-probe.js +115 -35
  443. package/dist/domains/comet-entry/resume-probe.js.map +1 -1
  444. package/dist/domains/comet-entry/types.d.ts +4 -2
  445. package/dist/domains/comet-entry/types.d.ts.map +1 -1
  446. package/dist/domains/comet-memory/index.d.ts +10 -0
  447. package/dist/domains/comet-memory/index.d.ts.map +1 -0
  448. package/dist/domains/comet-memory/index.js +10 -0
  449. package/dist/domains/comet-memory/index.js.map +1 -0
  450. package/dist/domains/comet-memory/personal-memory.d.ts +57 -0
  451. package/dist/domains/comet-memory/personal-memory.d.ts.map +1 -0
  452. package/dist/domains/comet-memory/personal-memory.js +2142 -0
  453. package/dist/domains/comet-memory/personal-memory.js.map +1 -0
  454. package/dist/domains/comet-memory/plugin.d.ts +5 -0
  455. package/dist/domains/comet-memory/plugin.d.ts.map +1 -0
  456. package/dist/domains/comet-memory/plugin.js +957 -0
  457. package/dist/domains/comet-memory/plugin.js.map +1 -0
  458. package/dist/domains/comet-memory/provider-config.d.ts +4 -0
  459. package/dist/domains/comet-memory/provider-config.d.ts.map +1 -0
  460. package/dist/domains/comet-memory/provider-config.js +127 -0
  461. package/dist/domains/comet-memory/provider-config.js.map +1 -0
  462. package/dist/domains/comet-memory/remote-provider.d.ts +47 -0
  463. package/dist/domains/comet-memory/remote-provider.d.ts.map +1 -0
  464. package/dist/domains/comet-memory/remote-provider.js +562 -0
  465. package/dist/domains/comet-memory/remote-provider.js.map +1 -0
  466. package/dist/domains/comet-memory/repository.d.ts +38 -0
  467. package/dist/domains/comet-memory/repository.d.ts.map +1 -0
  468. package/dist/domains/comet-memory/repository.js +341 -0
  469. package/dist/domains/comet-memory/repository.js.map +1 -0
  470. package/dist/domains/comet-memory/review-contract.d.ts +16 -0
  471. package/dist/domains/comet-memory/review-contract.d.ts.map +1 -0
  472. package/dist/domains/comet-memory/review-contract.js +642 -0
  473. package/dist/domains/comet-memory/review-contract.js.map +1 -0
  474. package/dist/domains/comet-memory/semantic-review.d.ts +3 -0
  475. package/dist/domains/comet-memory/semantic-review.d.ts.map +1 -0
  476. package/dist/domains/comet-memory/semantic-review.js +204 -0
  477. package/dist/domains/comet-memory/semantic-review.js.map +1 -0
  478. package/dist/domains/comet-memory/skill-runtime.d.ts +11 -0
  479. package/dist/domains/comet-memory/skill-runtime.d.ts.map +1 -0
  480. package/dist/domains/comet-memory/skill-runtime.js +13 -0
  481. package/dist/domains/comet-memory/skill-runtime.js.map +1 -0
  482. package/dist/domains/comet-memory/types.d.ts +580 -0
  483. package/dist/domains/comet-memory/types.d.ts.map +1 -0
  484. package/dist/domains/comet-memory/types.js +7 -0
  485. package/dist/domains/comet-memory/types.js.map +1 -0
  486. package/dist/domains/comet-native/index.d.ts +4 -0
  487. package/dist/domains/comet-native/index.d.ts.map +1 -1
  488. package/dist/domains/comet-native/index.js +4 -0
  489. package/dist/domains/comet-native/index.js.map +1 -1
  490. package/dist/domains/comet-native/native-acceptance.d.ts +15 -4
  491. package/dist/domains/comet-native/native-acceptance.d.ts.map +1 -1
  492. package/dist/domains/comet-native/native-acceptance.js +168 -31
  493. package/dist/domains/comet-native/native-acceptance.js.map +1 -1
  494. package/dist/domains/comet-native/native-archive-command.d.ts +3 -0
  495. package/dist/domains/comet-native/native-archive-command.d.ts.map +1 -0
  496. package/dist/domains/comet-native/native-archive-command.js +244 -0
  497. package/dist/domains/comet-native/native-archive-command.js.map +1 -0
  498. package/dist/domains/comet-native/native-archive-entry.d.ts +2 -0
  499. package/dist/domains/comet-native/native-archive-entry.d.ts.map +1 -0
  500. package/dist/domains/comet-native/native-archive-entry.js +4 -0
  501. package/dist/domains/comet-native/native-archive-entry.js.map +1 -0
  502. package/dist/domains/comet-native/native-archive-inspection.d.ts.map +1 -1
  503. package/dist/domains/comet-native/native-archive-inspection.js +14 -0
  504. package/dist/domains/comet-native/native-archive-inspection.js.map +1 -1
  505. package/dist/domains/comet-native/native-archive-preflight.d.ts +13 -1
  506. package/dist/domains/comet-native/native-archive-preflight.d.ts.map +1 -1
  507. package/dist/domains/comet-native/native-archive-preflight.js +52 -0
  508. package/dist/domains/comet-native/native-archive-preflight.js.map +1 -1
  509. package/dist/domains/comet-native/native-archive-transaction.d.ts +1 -0
  510. package/dist/domains/comet-native/native-archive-transaction.d.ts.map +1 -1
  511. package/dist/domains/comet-native/native-archive-transaction.js +31 -23
  512. package/dist/domains/comet-native/native-archive-transaction.js.map +1 -1
  513. package/dist/domains/comet-native/native-archive.d.ts +1 -0
  514. package/dist/domains/comet-native/native-archive.d.ts.map +1 -1
  515. package/dist/domains/comet-native/native-archive.js +76 -13
  516. package/dist/domains/comet-native/native-archive.js.map +1 -1
  517. package/dist/domains/comet-native/native-artifact-language.d.ts +10 -0
  518. package/dist/domains/comet-native/native-artifact-language.d.ts.map +1 -0
  519. package/dist/domains/comet-native/native-artifact-language.js +105 -0
  520. package/dist/domains/comet-native/native-artifact-language.js.map +1 -0
  521. package/dist/domains/comet-native/native-artifacts.d.ts.map +1 -1
  522. package/dist/domains/comet-native/native-artifacts.js +21 -14
  523. package/dist/domains/comet-native/native-artifacts.js.map +1 -1
  524. package/dist/domains/comet-native/native-atomic-file.d.ts.map +1 -1
  525. package/dist/domains/comet-native/native-atomic-file.js +17 -10
  526. package/dist/domains/comet-native/native-atomic-file.js.map +1 -1
  527. package/dist/domains/comet-native/native-bounded-file.d.ts +32 -2
  528. package/dist/domains/comet-native/native-bounded-file.d.ts.map +1 -1
  529. package/dist/domains/comet-native/native-bounded-file.js +87 -6
  530. package/dist/domains/comet-native/native-bounded-file.js.map +1 -1
  531. package/dist/domains/comet-native/native-build-evidence.d.ts.map +1 -1
  532. package/dist/domains/comet-native/native-build-evidence.js +25 -3
  533. package/dist/domains/comet-native/native-build-evidence.js.map +1 -1
  534. package/dist/domains/comet-native/native-change.d.ts +23 -3
  535. package/dist/domains/comet-native/native-change.d.ts.map +1 -1
  536. package/dist/domains/comet-native/native-change.js +218 -35
  537. package/dist/domains/comet-native/native-change.js.map +1 -1
  538. package/dist/domains/comet-native/native-check-command.d.ts +3 -0
  539. package/dist/domains/comet-native/native-check-command.d.ts.map +1 -0
  540. package/dist/domains/comet-native/native-check-command.js +30 -0
  541. package/dist/domains/comet-native/native-check-command.js.map +1 -0
  542. package/dist/domains/comet-native/native-check-executor.d.ts +36 -0
  543. package/dist/domains/comet-native/native-check-executor.d.ts.map +1 -0
  544. package/dist/domains/comet-native/native-check-executor.js +132 -0
  545. package/dist/domains/comet-native/native-check-executor.js.map +1 -0
  546. package/dist/domains/comet-native/native-check-receipt-model.d.ts +10 -1
  547. package/dist/domains/comet-native/native-check-receipt-model.d.ts.map +1 -1
  548. package/dist/domains/comet-native/native-check-receipt-model.js +76 -9
  549. package/dist/domains/comet-native/native-check-receipt-model.js.map +1 -1
  550. package/dist/domains/comet-native/native-check-receipt-storage.d.ts.map +1 -1
  551. package/dist/domains/comet-native/native-check-receipt-storage.js +9 -8
  552. package/dist/domains/comet-native/native-check-receipt-storage.js.map +1 -1
  553. package/dist/domains/comet-native/native-check-receipt.d.ts.map +1 -1
  554. package/dist/domains/comet-native/native-check-receipt.js +130 -63
  555. package/dist/domains/comet-native/native-check-receipt.js.map +1 -1
  556. package/dist/domains/comet-native/native-check.d.ts +6 -0
  557. package/dist/domains/comet-native/native-check.d.ts.map +1 -1
  558. package/dist/domains/comet-native/native-check.js +36 -15
  559. package/dist/domains/comet-native/native-check.js.map +1 -1
  560. package/dist/domains/comet-native/native-checkpoint-command.d.ts +3 -0
  561. package/dist/domains/comet-native/native-checkpoint-command.d.ts.map +1 -0
  562. package/dist/domains/comet-native/native-checkpoint-command.js +33 -0
  563. package/dist/domains/comet-native/native-checkpoint-command.js.map +1 -0
  564. package/dist/domains/comet-native/native-checkpoint-storage.d.ts.map +1 -1
  565. package/dist/domains/comet-native/native-checkpoint-storage.js +27 -19
  566. package/dist/domains/comet-native/native-checkpoint-storage.js.map +1 -1
  567. package/dist/domains/comet-native/native-children.d.ts +98 -0
  568. package/dist/domains/comet-native/native-children.d.ts.map +1 -0
  569. package/dist/domains/comet-native/native-children.js +720 -0
  570. package/dist/domains/comet-native/native-children.js.map +1 -0
  571. package/dist/domains/comet-native/native-cli-help.d.ts +6 -0
  572. package/dist/domains/comet-native/native-cli-help.d.ts.map +1 -0
  573. package/dist/domains/comet-native/native-cli-help.js +202 -0
  574. package/dist/domains/comet-native/native-cli-help.js.map +1 -0
  575. package/dist/domains/comet-native/native-cli-shared.d.ts +40 -0
  576. package/dist/domains/comet-native/native-cli-shared.d.ts.map +1 -0
  577. package/dist/domains/comet-native/native-cli-shared.js +328 -0
  578. package/dist/domains/comet-native/native-cli-shared.js.map +1 -0
  579. package/dist/domains/comet-native/native-cli.d.ts +2 -5
  580. package/dist/domains/comet-native/native-cli.d.ts.map +1 -1
  581. package/dist/domains/comet-native/native-cli.js +56 -624
  582. package/dist/domains/comet-native/native-cli.js.map +1 -1
  583. package/dist/domains/comet-native/native-config.d.ts +11 -2
  584. package/dist/domains/comet-native/native-config.d.ts.map +1 -1
  585. package/dist/domains/comet-native/native-config.js +24 -244
  586. package/dist/domains/comet-native/native-config.js.map +1 -1
  587. package/dist/domains/comet-native/native-conflict-inspection.d.ts +3 -1
  588. package/dist/domains/comet-native/native-conflict-inspection.d.ts.map +1 -1
  589. package/dist/domains/comet-native/native-conflict-inspection.js +20 -10
  590. package/dist/domains/comet-native/native-conflict-inspection.js.map +1 -1
  591. package/dist/domains/comet-native/native-continuation.d.ts +4 -1
  592. package/dist/domains/comet-native/native-continuation.d.ts.map +1 -1
  593. package/dist/domains/comet-native/native-continuation.js +219 -91
  594. package/dist/domains/comet-native/native-continuation.js.map +1 -1
  595. package/dist/domains/comet-native/native-contract.d.ts.map +1 -1
  596. package/dist/domains/comet-native/native-contract.js +2 -1
  597. package/dist/domains/comet-native/native-contract.js.map +1 -1
  598. package/dist/domains/comet-native/native-diagnostics.d.ts +12 -3
  599. package/dist/domains/comet-native/native-diagnostics.d.ts.map +1 -1
  600. package/dist/domains/comet-native/native-diagnostics.js +199 -76
  601. package/dist/domains/comet-native/native-diagnostics.js.map +1 -1
  602. package/dist/domains/comet-native/native-doctor-command.d.ts +3 -0
  603. package/dist/domains/comet-native/native-doctor-command.d.ts.map +1 -0
  604. package/dist/domains/comet-native/native-doctor-command.js +361 -0
  605. package/dist/domains/comet-native/native-doctor-command.js.map +1 -0
  606. package/dist/domains/comet-native/native-doctor-entry.d.ts +2 -0
  607. package/dist/domains/comet-native/native-doctor-entry.d.ts.map +1 -0
  608. package/dist/domains/comet-native/native-doctor-entry.js +4 -0
  609. package/dist/domains/comet-native/native-doctor-entry.js.map +1 -0
  610. package/dist/domains/comet-native/native-doctor.d.ts +1 -0
  611. package/dist/domains/comet-native/native-doctor.d.ts.map +1 -1
  612. package/dist/domains/comet-native/native-doctor.js +123 -26
  613. package/dist/domains/comet-native/native-doctor.js.map +1 -1
  614. package/dist/domains/comet-native/native-evidence-command.d.ts +3 -0
  615. package/dist/domains/comet-native/native-evidence-command.d.ts.map +1 -0
  616. package/dist/domains/comet-native/native-evidence-command.js +35 -0
  617. package/dist/domains/comet-native/native-evidence-command.js.map +1 -0
  618. package/dist/domains/comet-native/native-evidence-projection.d.ts +52 -0
  619. package/dist/domains/comet-native/native-evidence-projection.d.ts.map +1 -0
  620. package/dist/domains/comet-native/native-evidence-projection.js +291 -0
  621. package/dist/domains/comet-native/native-evidence-projection.js.map +1 -0
  622. package/dist/domains/comet-native/native-evidence-retention.d.ts.map +1 -1
  623. package/dist/domains/comet-native/native-evidence-retention.js +29 -14
  624. package/dist/domains/comet-native/native-evidence-retention.js.map +1 -1
  625. package/dist/domains/comet-native/native-evidence-storage.d.ts +31 -7
  626. package/dist/domains/comet-native/native-evidence-storage.d.ts.map +1 -1
  627. package/dist/domains/comet-native/native-evidence-storage.js +145 -27
  628. package/dist/domains/comet-native/native-evidence-storage.js.map +1 -1
  629. package/dist/domains/comet-native/native-experience.d.ts +12 -0
  630. package/dist/domains/comet-native/native-experience.d.ts.map +1 -0
  631. package/dist/domains/comet-native/native-experience.js +71 -0
  632. package/dist/domains/comet-native/native-experience.js.map +1 -0
  633. package/dist/domains/comet-native/native-file-identity.d.ts +2 -8
  634. package/dist/domains/comet-native/native-file-identity.d.ts.map +1 -1
  635. package/dist/domains/comet-native/native-file-identity.js +1 -20
  636. package/dist/domains/comet-native/native-file-identity.js.map +1 -1
  637. package/dist/domains/comet-native/native-findings.d.ts.map +1 -1
  638. package/dist/domains/comet-native/native-findings.js +95 -5
  639. package/dist/domains/comet-native/native-findings.js.map +1 -1
  640. package/dist/domains/comet-native/native-git-provenance.d.ts +16 -0
  641. package/dist/domains/comet-native/native-git-provenance.d.ts.map +1 -0
  642. package/dist/domains/comet-native/native-git-provenance.js +171 -0
  643. package/dist/domains/comet-native/native-git-provenance.js.map +1 -0
  644. package/dist/domains/comet-native/native-guards.d.ts +2 -1
  645. package/dist/domains/comet-native/native-guards.d.ts.map +1 -1
  646. package/dist/domains/comet-native/native-guards.js +14 -0
  647. package/dist/domains/comet-native/native-guards.js.map +1 -1
  648. package/dist/domains/comet-native/native-hook-guard-command.d.ts +3 -0
  649. package/dist/domains/comet-native/native-hook-guard-command.d.ts.map +1 -0
  650. package/dist/domains/comet-native/native-hook-guard-command.js +32 -0
  651. package/dist/domains/comet-native/native-hook-guard-command.js.map +1 -0
  652. package/dist/domains/comet-native/native-hook-guard-entry.d.ts +2 -0
  653. package/dist/domains/comet-native/native-hook-guard-entry.d.ts.map +1 -0
  654. package/dist/domains/comet-native/native-hook-guard-entry.js +4 -0
  655. package/dist/domains/comet-native/native-hook-guard-entry.js.map +1 -0
  656. package/dist/domains/comet-native/native-hook-guard.d.ts.map +1 -1
  657. package/dist/domains/comet-native/native-hook-guard.js +221 -22
  658. package/dist/domains/comet-native/native-hook-guard.js.map +1 -1
  659. package/dist/domains/comet-native/native-init-command.d.ts +3 -0
  660. package/dist/domains/comet-native/native-init-command.d.ts.map +1 -0
  661. package/dist/domains/comet-native/native-init-command.js +41 -0
  662. package/dist/domains/comet-native/native-init-command.js.map +1 -0
  663. package/dist/domains/comet-native/native-init-entry.d.ts +2 -0
  664. package/dist/domains/comet-native/native-init-entry.d.ts.map +1 -0
  665. package/dist/domains/comet-native/native-init-entry.js +4 -0
  666. package/dist/domains/comet-native/native-init-entry.js.map +1 -0
  667. package/dist/domains/comet-native/native-local-execution.d.ts +25 -0
  668. package/dist/domains/comet-native/native-local-execution.d.ts.map +1 -0
  669. package/dist/domains/comet-native/native-local-execution.js +241 -0
  670. package/dist/domains/comet-native/native-local-execution.js.map +1 -0
  671. package/dist/domains/comet-native/native-lock.d.ts +1 -1
  672. package/dist/domains/comet-native/native-lock.d.ts.map +1 -1
  673. package/dist/domains/comet-native/native-lock.js +33 -41
  674. package/dist/domains/comet-native/native-lock.js.map +1 -1
  675. package/dist/domains/comet-native/native-loop-runtime.d.ts +68 -0
  676. package/dist/domains/comet-native/native-loop-runtime.d.ts.map +1 -0
  677. package/dist/domains/comet-native/native-loop-runtime.js +648 -0
  678. package/dist/domains/comet-native/native-loop-runtime.js.map +1 -0
  679. package/dist/domains/comet-native/native-mutation-lock.d.ts +2 -0
  680. package/dist/domains/comet-native/native-mutation-lock.d.ts.map +1 -1
  681. package/dist/domains/comet-native/native-mutation-lock.js +23 -2
  682. package/dist/domains/comet-native/native-mutation-lock.js.map +1 -1
  683. package/dist/domains/comet-native/native-new-command.d.ts +3 -0
  684. package/dist/domains/comet-native/native-new-command.d.ts.map +1 -0
  685. package/dist/domains/comet-native/native-new-command.js +57 -0
  686. package/dist/domains/comet-native/native-new-command.js.map +1 -0
  687. package/dist/domains/comet-native/native-new-entry.d.ts +2 -0
  688. package/dist/domains/comet-native/native-new-entry.d.ts.map +1 -0
  689. package/dist/domains/comet-native/native-new-entry.js +4 -0
  690. package/dist/domains/comet-native/native-new-entry.js.map +1 -0
  691. package/dist/domains/comet-native/native-next-command.d.ts +3 -0
  692. package/dist/domains/comet-native/native-next-command.d.ts.map +1 -0
  693. package/dist/domains/comet-native/native-next-command.js +357 -0
  694. package/dist/domains/comet-native/native-next-command.js.map +1 -0
  695. package/dist/domains/comet-native/native-next-entry.d.ts +2 -0
  696. package/dist/domains/comet-native/native-next-entry.d.ts.map +1 -0
  697. package/dist/domains/comet-native/native-next-entry.js +4 -0
  698. package/dist/domains/comet-native/native-next-entry.js.map +1 -0
  699. package/dist/domains/comet-native/native-paths.d.ts +18 -0
  700. package/dist/domains/comet-native/native-paths.d.ts.map +1 -1
  701. package/dist/domains/comet-native/native-paths.js +127 -26
  702. package/dist/domains/comet-native/native-paths.js.map +1 -1
  703. package/dist/domains/comet-native/native-portable-acceptance.d.ts +28 -0
  704. package/dist/domains/comet-native/native-portable-acceptance.d.ts.map +1 -0
  705. package/dist/domains/comet-native/native-portable-acceptance.js +73 -0
  706. package/dist/domains/comet-native/native-portable-acceptance.js.map +1 -0
  707. package/dist/domains/comet-native/native-portable-archive.d.ts +37 -0
  708. package/dist/domains/comet-native/native-portable-archive.d.ts.map +1 -0
  709. package/dist/domains/comet-native/native-portable-archive.js +530 -0
  710. package/dist/domains/comet-native/native-portable-archive.js.map +1 -0
  711. package/dist/domains/comet-native/native-portable-continuation.d.ts +50 -0
  712. package/dist/domains/comet-native/native-portable-continuation.d.ts.map +1 -0
  713. package/dist/domains/comet-native/native-portable-continuation.js +589 -0
  714. package/dist/domains/comet-native/native-portable-continuation.js.map +1 -0
  715. package/dist/domains/comet-native/native-portable-migration-runtime.d.ts +9 -0
  716. package/dist/domains/comet-native/native-portable-migration-runtime.d.ts.map +1 -0
  717. package/dist/domains/comet-native/native-portable-migration-runtime.js +218 -0
  718. package/dist/domains/comet-native/native-portable-migration-runtime.js.map +1 -0
  719. package/dist/domains/comet-native/native-portable-migration.d.ts +42 -0
  720. package/dist/domains/comet-native/native-portable-migration.d.ts.map +1 -0
  721. package/dist/domains/comet-native/native-portable-migration.js +212 -0
  722. package/dist/domains/comet-native/native-portable-migration.js.map +1 -0
  723. package/dist/domains/comet-native/native-portable-recovery.d.ts +15 -0
  724. package/dist/domains/comet-native/native-portable-recovery.d.ts.map +1 -0
  725. package/dist/domains/comet-native/native-portable-recovery.js +203 -0
  726. package/dist/domains/comet-native/native-portable-recovery.js.map +1 -0
  727. package/dist/domains/comet-native/native-portable-runtime.d.ts +194 -0
  728. package/dist/domains/comet-native/native-portable-runtime.d.ts.map +1 -0
  729. package/dist/domains/comet-native/native-portable-runtime.js +1710 -0
  730. package/dist/domains/comet-native/native-portable-runtime.js.map +1 -0
  731. package/dist/domains/comet-native/native-portable-state.d.ts +30 -0
  732. package/dist/domains/comet-native/native-portable-state.d.ts.map +1 -0
  733. package/dist/domains/comet-native/native-portable-state.js +725 -0
  734. package/dist/domains/comet-native/native-portable-state.js.map +1 -0
  735. package/dist/domains/comet-native/native-portable-status.d.ts +97 -0
  736. package/dist/domains/comet-native/native-portable-status.d.ts.map +1 -0
  737. package/dist/domains/comet-native/native-portable-status.js +333 -0
  738. package/dist/domains/comet-native/native-portable-status.js.map +1 -0
  739. package/dist/domains/comet-native/native-portable-summary.d.ts +29 -0
  740. package/dist/domains/comet-native/native-portable-summary.d.ts.map +1 -0
  741. package/dist/domains/comet-native/native-portable-summary.js +37 -0
  742. package/dist/domains/comet-native/native-portable-summary.js.map +1 -0
  743. package/dist/domains/comet-native/native-portable-text.d.ts +8 -0
  744. package/dist/domains/comet-native/native-portable-text.d.ts.map +1 -0
  745. package/dist/domains/comet-native/native-portable-text.js +28 -0
  746. package/dist/domains/comet-native/native-portable-text.js.map +1 -0
  747. package/dist/domains/comet-native/native-portable-transactions.d.ts +41 -0
  748. package/dist/domains/comet-native/native-portable-transactions.d.ts.map +1 -0
  749. package/dist/domains/comet-native/native-portable-transactions.js +204 -0
  750. package/dist/domains/comet-native/native-portable-transactions.js.map +1 -0
  751. package/dist/domains/comet-native/native-portable-types.d.ts +174 -0
  752. package/dist/domains/comet-native/native-portable-types.d.ts.map +1 -0
  753. package/dist/domains/comet-native/native-portable-types.js +19 -0
  754. package/dist/domains/comet-native/native-portable-types.js.map +1 -0
  755. package/dist/domains/comet-native/native-pull-request-finish.d.ts +35 -0
  756. package/dist/domains/comet-native/native-pull-request-finish.d.ts.map +1 -0
  757. package/dist/domains/comet-native/native-pull-request-finish.js +282 -0
  758. package/dist/domains/comet-native/native-pull-request-finish.js.map +1 -0
  759. package/dist/domains/comet-native/native-receipt-command.d.ts +3 -0
  760. package/dist/domains/comet-native/native-receipt-command.d.ts.map +1 -0
  761. package/dist/domains/comet-native/native-receipt-command.js +120 -0
  762. package/dist/domains/comet-native/native-receipt-command.js.map +1 -0
  763. package/dist/domains/comet-native/native-receipt-errors.d.ts +23 -0
  764. package/dist/domains/comet-native/native-receipt-errors.d.ts.map +1 -0
  765. package/dist/domains/comet-native/native-receipt-errors.js +9 -0
  766. package/dist/domains/comet-native/native-receipt-errors.js.map +1 -0
  767. package/dist/domains/comet-native/native-receipt-refresh.d.ts +89 -0
  768. package/dist/domains/comet-native/native-receipt-refresh.d.ts.map +1 -0
  769. package/dist/domains/comet-native/native-receipt-refresh.js +243 -0
  770. package/dist/domains/comet-native/native-receipt-refresh.js.map +1 -0
  771. package/dist/domains/comet-native/native-repair-integration.d.ts +7 -5
  772. package/dist/domains/comet-native/native-repair-integration.d.ts.map +1 -1
  773. package/dist/domains/comet-native/native-repair-integration.js +77 -29
  774. package/dist/domains/comet-native/native-repair-integration.js.map +1 -1
  775. package/dist/domains/comet-native/native-repair-runtime.d.ts +5 -1
  776. package/dist/domains/comet-native/native-repair-runtime.d.ts.map +1 -1
  777. package/dist/domains/comet-native/native-repair-runtime.js +114 -37
  778. package/dist/domains/comet-native/native-repair-runtime.js.map +1 -1
  779. package/dist/domains/comet-native/native-repair-stagnation.d.ts +9 -13
  780. package/dist/domains/comet-native/native-repair-stagnation.d.ts.map +1 -1
  781. package/dist/domains/comet-native/native-repair-stagnation.js +76 -34
  782. package/dist/domains/comet-native/native-repair-stagnation.js.map +1 -1
  783. package/dist/domains/comet-native/native-resume-view.d.ts.map +1 -1
  784. package/dist/domains/comet-native/native-resume-view.js +1 -5
  785. package/dist/domains/comet-native/native-resume-view.js.map +1 -1
  786. package/dist/domains/comet-native/native-root-command.d.ts +3 -0
  787. package/dist/domains/comet-native/native-root-command.d.ts.map +1 -0
  788. package/dist/domains/comet-native/native-root-command.js +29 -0
  789. package/dist/domains/comet-native/native-root-command.js.map +1 -0
  790. package/dist/domains/comet-native/native-root-entry.d.ts +2 -0
  791. package/dist/domains/comet-native/native-root-entry.d.ts.map +1 -0
  792. package/dist/domains/comet-native/native-root-entry.js +4 -0
  793. package/dist/domains/comet-native/native-root-entry.js.map +1 -0
  794. package/dist/domains/comet-native/native-root-move.d.ts.map +1 -1
  795. package/dist/domains/comet-native/native-root-move.js +60 -17
  796. package/dist/domains/comet-native/native-root-move.js.map +1 -1
  797. package/dist/domains/comet-native/native-run-consistency.d.ts.map +1 -1
  798. package/dist/domains/comet-native/native-run-consistency.js +8 -12
  799. package/dist/domains/comet-native/native-run-consistency.js.map +1 -1
  800. package/dist/domains/comet-native/native-run-store.js +4 -4
  801. package/dist/domains/comet-native/native-run-store.js.map +1 -1
  802. package/dist/domains/comet-native/native-runner-input.d.ts +222 -0
  803. package/dist/domains/comet-native/native-runner-input.d.ts.map +1 -0
  804. package/dist/domains/comet-native/native-runner-input.js +801 -0
  805. package/dist/domains/comet-native/native-runner-input.js.map +1 -0
  806. package/dist/domains/comet-native/native-runner-protocol.d.ts +40 -0
  807. package/dist/domains/comet-native/native-runner-protocol.d.ts.map +1 -0
  808. package/dist/domains/comet-native/native-runner-protocol.js +55 -0
  809. package/dist/domains/comet-native/native-runner-protocol.js.map +1 -0
  810. package/dist/domains/comet-native/native-runtime-package.d.ts +3 -0
  811. package/dist/domains/comet-native/native-runtime-package.d.ts.map +1 -1
  812. package/dist/domains/comet-native/native-runtime-package.js +5 -1
  813. package/dist/domains/comet-native/native-runtime-package.js.map +1 -1
  814. package/dist/domains/comet-native/native-schema-migration.d.ts.map +1 -1
  815. package/dist/domains/comet-native/native-schema-migration.js +31 -27
  816. package/dist/domains/comet-native/native-schema-migration.js.map +1 -1
  817. package/dist/domains/comet-native/native-script-entry.d.ts +12 -0
  818. package/dist/domains/comet-native/native-script-entry.d.ts.map +1 -0
  819. package/dist/domains/comet-native/native-script-entry.js +44 -0
  820. package/dist/domains/comet-native/native-script-entry.js.map +1 -0
  821. package/dist/domains/comet-native/native-select-command.d.ts +3 -0
  822. package/dist/domains/comet-native/native-select-command.d.ts.map +1 -0
  823. package/dist/domains/comet-native/native-select-command.js +19 -0
  824. package/dist/domains/comet-native/native-select-command.js.map +1 -0
  825. package/dist/domains/comet-native/native-select-entry.d.ts +2 -0
  826. package/dist/domains/comet-native/native-select-entry.d.ts.map +1 -0
  827. package/dist/domains/comet-native/native-select-entry.js +4 -0
  828. package/dist/domains/comet-native/native-select-entry.js.map +1 -0
  829. package/dist/domains/comet-native/native-selection.d.ts.map +1 -1
  830. package/dist/domains/comet-native/native-selection.js +11 -2
  831. package/dist/domains/comet-native/native-selection.js.map +1 -1
  832. package/dist/domains/comet-native/native-show-command.d.ts +3 -0
  833. package/dist/domains/comet-native/native-show-command.d.ts.map +1 -0
  834. package/dist/domains/comet-native/native-show-command.js +78 -0
  835. package/dist/domains/comet-native/native-show-command.js.map +1 -0
  836. package/dist/domains/comet-native/native-show-entry.d.ts +2 -0
  837. package/dist/domains/comet-native/native-show-entry.d.ts.map +1 -0
  838. package/dist/domains/comet-native/native-show-entry.js +4 -0
  839. package/dist/domains/comet-native/native-show-entry.js.map +1 -0
  840. package/dist/domains/comet-native/native-snapshot.d.ts +14 -1
  841. package/dist/domains/comet-native/native-snapshot.d.ts.map +1 -1
  842. package/dist/domains/comet-native/native-snapshot.js +447 -28
  843. package/dist/domains/comet-native/native-snapshot.js.map +1 -1
  844. package/dist/domains/comet-native/native-spec-command.d.ts +3 -0
  845. package/dist/domains/comet-native/native-spec-command.d.ts.map +1 -0
  846. package/dist/domains/comet-native/native-spec-command.js +20 -0
  847. package/dist/domains/comet-native/native-spec-command.js.map +1 -0
  848. package/dist/domains/comet-native/native-spec-entry.d.ts +2 -0
  849. package/dist/domains/comet-native/native-spec-entry.d.ts.map +1 -0
  850. package/dist/domains/comet-native/native-spec-entry.js +4 -0
  851. package/dist/domains/comet-native/native-spec-entry.js.map +1 -0
  852. package/dist/domains/comet-native/native-specs.js +3 -3
  853. package/dist/domains/comet-native/native-specs.js.map +1 -1
  854. package/dist/domains/comet-native/native-status-command.d.ts +3 -0
  855. package/dist/domains/comet-native/native-status-command.d.ts.map +1 -0
  856. package/dist/domains/comet-native/native-status-command.js +26 -0
  857. package/dist/domains/comet-native/native-status-command.js.map +1 -0
  858. package/dist/domains/comet-native/native-status-discovery.d.ts +52 -0
  859. package/dist/domains/comet-native/native-status-discovery.d.ts.map +1 -0
  860. package/dist/domains/comet-native/native-status-discovery.js +318 -0
  861. package/dist/domains/comet-native/native-status-discovery.js.map +1 -0
  862. package/dist/domains/comet-native/native-status-entry.d.ts +2 -0
  863. package/dist/domains/comet-native/native-status-entry.d.ts.map +1 -0
  864. package/dist/domains/comet-native/native-status-entry.js +4 -0
  865. package/dist/domains/comet-native/native-status-entry.js.map +1 -0
  866. package/dist/domains/comet-native/native-supervisor.d.ts +220 -0
  867. package/dist/domains/comet-native/native-supervisor.d.ts.map +1 -0
  868. package/dist/domains/comet-native/native-supervisor.js +1210 -0
  869. package/dist/domains/comet-native/native-supervisor.js.map +1 -0
  870. package/dist/domains/comet-native/native-trajectory-recovery.d.ts.map +1 -1
  871. package/dist/domains/comet-native/native-trajectory-recovery.js +6 -9
  872. package/dist/domains/comet-native/native-trajectory-recovery.js.map +1 -1
  873. package/dist/domains/comet-native/native-transaction.d.ts.map +1 -1
  874. package/dist/domains/comet-native/native-transaction.js +31 -20
  875. package/dist/domains/comet-native/native-transaction.js.map +1 -1
  876. package/dist/domains/comet-native/native-transition-evidence.d.ts.map +1 -1
  877. package/dist/domains/comet-native/native-transition-evidence.js +1 -3
  878. package/dist/domains/comet-native/native-transition-evidence.js.map +1 -1
  879. package/dist/domains/comet-native/native-transition-journal.d.ts.map +1 -1
  880. package/dist/domains/comet-native/native-transition-journal.js +71 -22
  881. package/dist/domains/comet-native/native-transition-journal.js.map +1 -1
  882. package/dist/domains/comet-native/native-transitions.d.ts +7 -1
  883. package/dist/domains/comet-native/native-transitions.d.ts.map +1 -1
  884. package/dist/domains/comet-native/native-transitions.js +315 -84
  885. package/dist/domains/comet-native/native-transitions.js.map +1 -1
  886. package/dist/domains/comet-native/native-types.d.ts +73 -36
  887. package/dist/domains/comet-native/native-types.d.ts.map +1 -1
  888. package/dist/domains/comet-native/native-types.js.map +1 -1
  889. package/dist/domains/comet-native/native-verification-evidence.d.ts +9 -5
  890. package/dist/domains/comet-native/native-verification-evidence.d.ts.map +1 -1
  891. package/dist/domains/comet-native/native-verification-evidence.js +85 -29
  892. package/dist/domains/comet-native/native-verification-evidence.js.map +1 -1
  893. package/dist/domains/comet-native/native-verification-receipt-runtime.d.ts +99 -0
  894. package/dist/domains/comet-native/native-verification-receipt-runtime.d.ts.map +1 -0
  895. package/dist/domains/comet-native/native-verification-receipt-runtime.js +597 -0
  896. package/dist/domains/comet-native/native-verification-receipt-runtime.js.map +1 -0
  897. package/dist/domains/comet-native/native-verification-receipt.d.ts +79 -0
  898. package/dist/domains/comet-native/native-verification-receipt.d.ts.map +1 -0
  899. package/dist/domains/comet-native/native-verification-receipt.js +305 -0
  900. package/dist/domains/comet-native/native-verification-receipt.js.map +1 -0
  901. package/dist/domains/comet-native/native-verification-report-v2.d.ts +14 -0
  902. package/dist/domains/comet-native/native-verification-report-v2.d.ts.map +1 -0
  903. package/dist/domains/comet-native/native-verification-report-v2.js +188 -0
  904. package/dist/domains/comet-native/native-verification-report-v2.js.map +1 -0
  905. package/dist/domains/comet-native/native-verification-runtime.d.ts +55 -2
  906. package/dist/domains/comet-native/native-verification-runtime.d.ts.map +1 -1
  907. package/dist/domains/comet-native/native-verification-runtime.js +240 -41
  908. package/dist/domains/comet-native/native-verification-runtime.js.map +1 -1
  909. package/dist/domains/comet-native/native-verification-scope.d.ts +25 -1
  910. package/dist/domains/comet-native/native-verification-scope.d.ts.map +1 -1
  911. package/dist/domains/comet-native/native-verification-scope.js +112 -20
  912. package/dist/domains/comet-native/native-verification-scope.js.map +1 -1
  913. package/dist/domains/comet-native/native-verifier-protocol.d.ts +49 -0
  914. package/dist/domains/comet-native/native-verifier-protocol.d.ts.map +1 -0
  915. package/dist/domains/comet-native/native-verifier-protocol.js +157 -0
  916. package/dist/domains/comet-native/native-verifier-protocol.js.map +1 -0
  917. package/dist/domains/comet-native/native-workspace-finish.d.ts +67 -0
  918. package/dist/domains/comet-native/native-workspace-finish.d.ts.map +1 -0
  919. package/dist/domains/comet-native/native-workspace-finish.js +400 -0
  920. package/dist/domains/comet-native/native-workspace-finish.js.map +1 -0
  921. package/dist/domains/comet-native/native-workspace-preparation.d.ts +32 -0
  922. package/dist/domains/comet-native/native-workspace-preparation.d.ts.map +1 -0
  923. package/dist/domains/comet-native/native-workspace-preparation.js +324 -0
  924. package/dist/domains/comet-native/native-workspace-preparation.js.map +1 -0
  925. package/dist/domains/comet-native/native-workspace.d.ts +48 -4
  926. package/dist/domains/comet-native/native-workspace.d.ts.map +1 -1
  927. package/dist/domains/comet-native/native-workspace.js +306 -16
  928. package/dist/domains/comet-native/native-workspace.js.map +1 -1
  929. package/dist/domains/comet-plugin/index.d.ts +4 -0
  930. package/dist/domains/comet-plugin/index.d.ts.map +1 -0
  931. package/dist/domains/comet-plugin/index.js +4 -0
  932. package/dist/domains/comet-plugin/index.js.map +1 -0
  933. package/dist/domains/comet-plugin/integration.d.ts +73 -0
  934. package/dist/domains/comet-plugin/integration.d.ts.map +1 -0
  935. package/dist/domains/comet-plugin/integration.js +385 -0
  936. package/dist/domains/comet-plugin/integration.js.map +1 -0
  937. package/dist/domains/comet-plugin/plugin-runtime.d.ts +90 -0
  938. package/dist/domains/comet-plugin/plugin-runtime.d.ts.map +1 -0
  939. package/dist/domains/comet-plugin/plugin-runtime.js +611 -0
  940. package/dist/domains/comet-plugin/plugin-runtime.js.map +1 -0
  941. package/dist/domains/comet-plugin/types.d.ts +101 -0
  942. package/dist/domains/comet-plugin/types.d.ts.map +1 -0
  943. package/dist/domains/comet-plugin/types.js +2 -0
  944. package/dist/domains/comet-plugin/types.js.map +1 -0
  945. package/dist/domains/dashboard/collector.d.ts +26 -1
  946. package/dist/domains/dashboard/collector.d.ts.map +1 -1
  947. package/dist/domains/dashboard/collector.js +602 -104
  948. package/dist/domains/dashboard/collector.js.map +1 -1
  949. package/dist/domains/dashboard/default-plugin-host.d.ts +8 -0
  950. package/dist/domains/dashboard/default-plugin-host.d.ts.map +1 -0
  951. package/dist/domains/dashboard/default-plugin-host.js +34 -0
  952. package/dist/domains/dashboard/default-plugin-host.js.map +1 -0
  953. package/dist/domains/dashboard/index-reconciler.d.ts +18 -0
  954. package/dist/domains/dashboard/index-reconciler.d.ts.map +1 -0
  955. package/dist/domains/dashboard/index-reconciler.js +38 -0
  956. package/dist/domains/dashboard/index-reconciler.js.map +1 -0
  957. package/dist/domains/dashboard/index-store.d.ts +75 -0
  958. package/dist/domains/dashboard/index-store.d.ts.map +1 -0
  959. package/dist/domains/dashboard/index-store.js +274 -0
  960. package/dist/domains/dashboard/index-store.js.map +1 -0
  961. package/dist/domains/dashboard/native-adapter.d.ts +159 -114
  962. package/dist/domains/dashboard/native-adapter.d.ts.map +1 -1
  963. package/dist/domains/dashboard/native-adapter.js +165 -268
  964. package/dist/domains/dashboard/native-adapter.js.map +1 -1
  965. package/dist/domains/dashboard/native-collector.d.ts +29 -2
  966. package/dist/domains/dashboard/native-collector.d.ts.map +1 -1
  967. package/dist/domains/dashboard/native-collector.js +747 -220
  968. package/dist/domains/dashboard/native-collector.js.map +1 -1
  969. package/dist/domains/dashboard/native-legacy-adapter.d.ts +37 -0
  970. package/dist/domains/dashboard/native-legacy-adapter.d.ts.map +1 -0
  971. package/dist/domains/dashboard/native-legacy-adapter.js +127 -0
  972. package/dist/domains/dashboard/native-legacy-adapter.js.map +1 -0
  973. package/dist/domains/dashboard/plugin-host.d.ts +49 -0
  974. package/dist/domains/dashboard/plugin-host.d.ts.map +1 -0
  975. package/dist/domains/dashboard/plugin-host.js +168 -0
  976. package/dist/domains/dashboard/plugin-host.js.map +1 -0
  977. package/dist/domains/dashboard/project-config-settings.d.ts +39 -0
  978. package/dist/domains/dashboard/project-config-settings.d.ts.map +1 -0
  979. package/dist/domains/dashboard/project-config-settings.js +243 -0
  980. package/dist/domains/dashboard/project-config-settings.js.map +1 -0
  981. package/dist/domains/dashboard/project-directory.d.ts +20 -0
  982. package/dist/domains/dashboard/project-directory.d.ts.map +1 -0
  983. package/dist/domains/dashboard/project-directory.js +92 -0
  984. package/dist/domains/dashboard/project-directory.js.map +1 -0
  985. package/dist/domains/dashboard/project-root.d.ts +8 -0
  986. package/dist/domains/dashboard/project-root.d.ts.map +1 -0
  987. package/dist/domains/dashboard/project-root.js +68 -0
  988. package/dist/domains/dashboard/project-root.js.map +1 -0
  989. package/dist/domains/dashboard/server.d.ts +3 -0
  990. package/dist/domains/dashboard/server.d.ts.map +1 -1
  991. package/dist/domains/dashboard/server.js +307 -14
  992. package/dist/domains/dashboard/server.js.map +1 -1
  993. package/dist/domains/dashboard/types.d.ts +51 -1
  994. package/dist/domains/dashboard/types.d.ts.map +1 -1
  995. package/dist/domains/dashboard/verify-parser.d.ts +1 -0
  996. package/dist/domains/dashboard/verify-parser.d.ts.map +1 -1
  997. package/dist/domains/dashboard/verify-parser.js +41 -31
  998. package/dist/domains/dashboard/verify-parser.js.map +1 -1
  999. package/dist/domains/dashboard/web/assets/abnfDiagram-N423BO3Z-BkUJc7LK.js +1 -0
  1000. package/dist/domains/dashboard/web/assets/arc-DY4Y9tSO.js +1 -0
  1001. package/dist/domains/dashboard/web/assets/architectureDiagram-T3A2C74G-7wC9YZS-.js +36 -0
  1002. package/dist/domains/dashboard/web/assets/blockDiagram-VBNYF7ZC-Biqe-SaL.js +132 -0
  1003. package/dist/domains/dashboard/web/assets/{c4Diagram-AAUBKEIU-B3cFnNT7.js → c4Diagram-5PPSVZJV-CccUFD1S.js} +2 -2
  1004. package/dist/domains/dashboard/web/assets/channel-DnRvSkOm.js +1 -0
  1005. package/dist/domains/dashboard/web/assets/{chunk-ND2GUHAM-fMaIDDI2.js → chunk-2GRJ4B5K-BUL4dDxo.js} +1 -1
  1006. package/dist/domains/dashboard/web/assets/{chunk-QZHKN3VN-C9rhF6Hm.js → chunk-2Q5K7J3B-BnKtDH9O.js} +1 -1
  1007. package/dist/domains/dashboard/web/assets/chunk-5RXB4S5H-C9pHQ1n3.js +231 -0
  1008. package/dist/domains/dashboard/web/assets/{chunk-FMBD7UC4-eYFEZimP.js → chunk-5VM5RSS4-CopXcnFA.js} +1 -1
  1009. package/dist/domains/dashboard/web/assets/chunk-6Q2QTUOP-CxrbngCi.js +88 -0
  1010. package/dist/domains/dashboard/web/assets/{chunk-727SXJPM-D02UjGND.js → chunk-GF5L2VYU-01mzgCUh.js} +5 -5
  1011. package/dist/domains/dashboard/web/assets/{chunk-4BX2VUAB-vWyemRBr.js → chunk-JWPE2WC7-wTiZVDvw.js} +1 -1
  1012. package/dist/domains/dashboard/web/assets/{chunk-2J33WTMH-CBNfW-Dr.js → chunk-KBJHAD2P-Bxdv5bl-.js} +1 -1
  1013. package/dist/domains/dashboard/web/assets/chunk-RYQCIY6F-B5vF9l9A.js +1 -0
  1014. package/dist/domains/dashboard/web/assets/{chunk-55IACEB6-H6haOo2C.js → chunk-XXDRQBXY-Dra3NnDp.js} +1 -1
  1015. package/dist/domains/dashboard/web/assets/classDiagram-JCYQIIEL-D3E-rgaQ.js +1 -0
  1016. package/dist/domains/dashboard/web/assets/classDiagram-v2-OCEON4UE-D3E-rgaQ.js +1 -0
  1017. package/dist/domains/dashboard/web/assets/cose-bilkent-JH36ORCC-DC96ge-n.js +1 -0
  1018. package/dist/domains/dashboard/web/assets/{cynefin-VYW2F7L2-DN4emAQv.js → cynefin-VYW2F7L2-Tt_NiopT.js} +2 -2
  1019. package/dist/domains/dashboard/web/assets/cynefinDiagram-MW4NZA55-BQ5__1hv.js +62 -0
  1020. package/dist/domains/dashboard/web/assets/dagre-VZM6K2ZE-Cr2zq3ro.js +4 -0
  1021. package/dist/domains/dashboard/web/assets/demo-lxXhgJ9-.js +456 -0
  1022. package/dist/domains/dashboard/web/assets/diagram-7IWD3JNH-BRpYDwPl.js +30 -0
  1023. package/dist/domains/dashboard/web/assets/{diagram-KO2AKTUF-C7ZvofsM.js → diagram-B4RE2ZJO-D7u-VBxW.js} +3 -3
  1024. package/dist/domains/dashboard/web/assets/diagram-LBJQPF4R-CHYuv2JD.js +24 -0
  1025. package/dist/domains/dashboard/web/assets/diagram-Q27KOJAE-CV3ZE8Q3.js +24 -0
  1026. package/dist/domains/dashboard/web/assets/diagram-UB23O5K3-co_OsTiQ.js +41 -0
  1027. package/dist/domains/dashboard/web/assets/ebnfDiagram-BXEA7PRR-CETcWswS.js +1 -0
  1028. package/dist/domains/dashboard/web/assets/erDiagram-JOGREHBK-edkItb7Z.js +85 -0
  1029. package/dist/domains/dashboard/web/assets/flowDiagram-UKHOOZJN-D_oFJtSf.js +156 -0
  1030. package/dist/domains/dashboard/web/assets/ganttDiagram-PKOTCBZU-CFjLVoA1.js +292 -0
  1031. package/dist/domains/dashboard/web/assets/gitGraphDiagram-DS77QQ5N-BfD0tiKH.js +106 -0
  1032. package/dist/domains/dashboard/web/assets/{graph--OzhPTMs.js → graph-DOmOIIwC.js} +1 -1
  1033. package/dist/domains/dashboard/web/assets/index-BzyqCfMb.css +1 -0
  1034. package/dist/domains/dashboard/web/assets/{index-QO0z6F4w.js → index-CCKHH_A9.js} +1 -1
  1035. package/dist/domains/dashboard/web/assets/index-D8dxsTJY.js +271 -0
  1036. package/dist/domains/dashboard/web/assets/infoDiagram-6WML65LV-Cx6xa9DS.js +2 -0
  1037. package/dist/domains/dashboard/web/assets/{ishikawaDiagram-YF4QCWOH-COCMcjBM.js → ishikawaDiagram-WSZJBQD7-BjNLyyv_.js} +5 -5
  1038. package/dist/domains/dashboard/web/assets/{journeyDiagram-JHISSGLW-DGcpcWny.js → journeyDiagram-NVQOT4AX-D2n9vrhx.js} +2 -2
  1039. package/dist/domains/dashboard/web/assets/{kanban-definition-UN3LZRKU-QSBNsWMP.js → kanban-definition-27J2QSJJ-kJL7v018.js} +7 -7
  1040. package/dist/domains/dashboard/web/assets/layout-D-LzfAck.js +1 -0
  1041. package/dist/domains/dashboard/web/assets/{linear-9uyeeBZf.js → linear-CeHtd5-l.js} +1 -1
  1042. package/dist/domains/dashboard/web/assets/map-DxJ2ADlA.js +1 -0
  1043. package/dist/domains/dashboard/web/assets/mermaid.core-B0EPSHs2.js +306 -0
  1044. package/dist/domains/dashboard/web/assets/{mindmap-definition-RKZ34NQL-CiNxI0gP.js → mindmap-definition-FAOFIHXS-bQQWINF4.js} +2 -2
  1045. package/dist/domains/dashboard/web/assets/pegDiagram-VL7TDLO6-LxLY1W7W.js +1 -0
  1046. package/dist/domains/dashboard/web/assets/pieDiagram-7S7Q4E2Y-BMDQqvuT.js +39 -0
  1047. package/dist/domains/dashboard/web/assets/purify.es-Cz4mVeUR.js +3 -0
  1048. package/dist/domains/dashboard/web/assets/{quadrantDiagram-W4KKPZXB-CflW-eFH.js → quadrantDiagram-CIZ2JOQS-XWYjcuZN.js} +3 -3
  1049. package/dist/domains/dashboard/web/assets/railroadDiagram-AXF67PYL-p-OlQTa7.js +1 -0
  1050. package/dist/domains/dashboard/web/assets/{requirementDiagram-4Y6WPE33-B9HLmRWH.js → requirementDiagram-LRYGKXZP-BL4N8Vsl.js} +2 -2
  1051. package/dist/domains/dashboard/web/assets/sankeyDiagram-W5VNT64P-Btu-o6LN.js +40 -0
  1052. package/dist/domains/dashboard/web/assets/sequenceDiagram-SI44F4Z6-9HpdQQ47.js +162 -0
  1053. package/dist/domains/dashboard/web/assets/sizeCapture-X5ZJPWSS-5AnBiBHD.js +1 -0
  1054. package/dist/domains/dashboard/web/assets/stateDiagram-OKZ733FA-Dv8IDsai.js +1 -0
  1055. package/dist/domains/dashboard/web/assets/stateDiagram-v2-UEYNNEHI-DxOMyFOm.js +1 -0
  1056. package/dist/domains/dashboard/web/assets/swimlanes-SLNWSIFB-BfJcN7dK.js +2 -0
  1057. package/dist/domains/dashboard/web/assets/swimlanesDiagram-ULZ7WXOC-BnHRSbDk.js +8 -0
  1058. package/dist/domains/dashboard/web/assets/{timeline-definition-PNZ67QCA-g9s-m5Z4.js → timeline-definition-Z64GVDOM-DEOuEHi5.js} +5 -5
  1059. package/dist/domains/dashboard/web/assets/vennDiagram-T6HMQDX7-BqsGpwgo.js +34 -0
  1060. package/dist/domains/dashboard/web/assets/{wardleyDiagram-YWT4CUSO-CJLrWGXc.js → wardleyDiagram-T6FBY63Y-CXlOp9so.js} +4 -4
  1061. package/dist/domains/dashboard/web/assets/xychartDiagram-ELKLHX3M-DyqqtC9X.js +7 -0
  1062. package/dist/domains/dashboard/web/index.html +16 -16
  1063. package/dist/domains/dashboard/workspace.d.ts +28 -0
  1064. package/dist/domains/dashboard/workspace.d.ts.map +1 -0
  1065. package/dist/domains/dashboard/workspace.js +134 -0
  1066. package/dist/domains/dashboard/workspace.js.map +1 -0
  1067. package/dist/domains/engine/protected-run-file.d.ts +15 -0
  1068. package/dist/domains/engine/protected-run-file.d.ts.map +1 -0
  1069. package/dist/domains/engine/protected-run-file.js +76 -0
  1070. package/dist/domains/engine/protected-run-file.js.map +1 -0
  1071. package/dist/domains/engine/run-store.d.ts +12 -11
  1072. package/dist/domains/engine/run-store.d.ts.map +1 -1
  1073. package/dist/domains/engine/run-store.js +46 -65
  1074. package/dist/domains/engine/run-store.js.map +1 -1
  1075. package/dist/domains/engine/state.d.ts +4 -3
  1076. package/dist/domains/engine/state.d.ts.map +1 -1
  1077. package/dist/domains/engine/state.js +10 -21
  1078. package/dist/domains/engine/state.js.map +1 -1
  1079. package/dist/domains/eval/agent-learning-eval.d.ts +32 -0
  1080. package/dist/domains/eval/agent-learning-eval.d.ts.map +1 -0
  1081. package/dist/domains/eval/agent-learning-eval.js +338 -0
  1082. package/dist/domains/eval/agent-learning-eval.js.map +1 -0
  1083. package/dist/domains/eval/index.d.ts +6 -0
  1084. package/dist/domains/eval/index.d.ts.map +1 -1
  1085. package/dist/domains/eval/index.js +6 -0
  1086. package/dist/domains/eval/index.js.map +1 -1
  1087. package/dist/domains/eval/semantic-memory-eval-config.d.ts +20 -0
  1088. package/dist/domains/eval/semantic-memory-eval-config.d.ts.map +1 -0
  1089. package/dist/domains/eval/semantic-memory-eval-config.js +26 -0
  1090. package/dist/domains/eval/semantic-memory-eval-config.js.map +1 -0
  1091. package/dist/domains/eval/semantic-memory-eval.d.ts +218 -0
  1092. package/dist/domains/eval/semantic-memory-eval.d.ts.map +1 -0
  1093. package/dist/domains/eval/semantic-memory-eval.js +1451 -0
  1094. package/dist/domains/eval/semantic-memory-eval.js.map +1 -0
  1095. package/dist/domains/eval/semantic-memory-judge.d.ts +34 -0
  1096. package/dist/domains/eval/semantic-memory-judge.d.ts.map +1 -0
  1097. package/dist/domains/eval/semantic-memory-judge.js +51 -0
  1098. package/dist/domains/eval/semantic-memory-judge.js.map +1 -0
  1099. package/dist/domains/eval/standalone-context.d.ts +19 -0
  1100. package/dist/domains/eval/standalone-context.d.ts.map +1 -0
  1101. package/dist/domains/eval/standalone-context.js +107 -0
  1102. package/dist/domains/eval/standalone-context.js.map +1 -0
  1103. package/dist/domains/eval/standalone-static-collect.d.ts +22 -0
  1104. package/dist/domains/eval/standalone-static-collect.d.ts.map +1 -0
  1105. package/dist/domains/eval/standalone-static-collect.js +779 -0
  1106. package/dist/domains/eval/standalone-static-collect.js.map +1 -0
  1107. package/dist/domains/eval/user-environment.d.ts +6 -0
  1108. package/dist/domains/eval/user-environment.d.ts.map +1 -0
  1109. package/dist/domains/eval/user-environment.js +73 -0
  1110. package/dist/domains/eval/user-environment.js.map +1 -0
  1111. package/dist/domains/factory/package.d.ts.map +1 -1
  1112. package/dist/domains/factory/package.js +522 -82
  1113. package/dist/domains/factory/package.js.map +1 -1
  1114. package/dist/domains/integrations/codegraph.d.ts +35 -2
  1115. package/dist/domains/integrations/codegraph.d.ts.map +1 -1
  1116. package/dist/domains/integrations/codegraph.js +466 -12
  1117. package/dist/domains/integrations/codegraph.js.map +1 -1
  1118. package/dist/domains/integrations/openspec.d.ts +22 -4
  1119. package/dist/domains/integrations/openspec.d.ts.map +1 -1
  1120. package/dist/domains/integrations/openspec.js +304 -51
  1121. package/dist/domains/integrations/openspec.js.map +1 -1
  1122. package/dist/domains/integrations/superpowers.d.ts +23 -1
  1123. package/dist/domains/integrations/superpowers.d.ts.map +1 -1
  1124. package/dist/domains/integrations/superpowers.js +196 -10
  1125. package/dist/domains/integrations/superpowers.js.map +1 -1
  1126. package/dist/domains/project-knowledge/corpus.d.ts +4 -0
  1127. package/dist/domains/project-knowledge/corpus.d.ts.map +1 -0
  1128. package/dist/domains/project-knowledge/corpus.js +332 -0
  1129. package/dist/domains/project-knowledge/corpus.js.map +1 -0
  1130. package/dist/domains/project-knowledge/dashboard.d.ts +3 -0
  1131. package/dist/domains/project-knowledge/dashboard.d.ts.map +1 -0
  1132. package/dist/domains/project-knowledge/dashboard.js +73 -0
  1133. package/dist/domains/project-knowledge/dashboard.js.map +1 -0
  1134. package/dist/domains/project-knowledge/deterministic-extractors.d.ts +10 -0
  1135. package/dist/domains/project-knowledge/deterministic-extractors.d.ts.map +1 -0
  1136. package/dist/domains/project-knowledge/deterministic-extractors.js +397 -0
  1137. package/dist/domains/project-knowledge/deterministic-extractors.js.map +1 -0
  1138. package/dist/domains/project-knowledge/index-store.d.ts +68 -0
  1139. package/dist/domains/project-knowledge/index-store.d.ts.map +1 -0
  1140. package/dist/domains/project-knowledge/index-store.js +573 -0
  1141. package/dist/domains/project-knowledge/index-store.js.map +1 -0
  1142. package/dist/domains/project-knowledge/index.d.ts +14 -0
  1143. package/dist/domains/project-knowledge/index.d.ts.map +1 -0
  1144. package/dist/domains/project-knowledge/index.js +14 -0
  1145. package/dist/domains/project-knowledge/index.js.map +1 -0
  1146. package/dist/domains/project-knowledge/learning.d.ts +94 -0
  1147. package/dist/domains/project-knowledge/learning.d.ts.map +1 -0
  1148. package/dist/domains/project-knowledge/learning.js +639 -0
  1149. package/dist/domains/project-knowledge/learning.js.map +1 -0
  1150. package/dist/domains/project-knowledge/local-provider.d.ts +32 -0
  1151. package/dist/domains/project-knowledge/local-provider.d.ts.map +1 -0
  1152. package/dist/domains/project-knowledge/local-provider.js +638 -0
  1153. package/dist/domains/project-knowledge/local-provider.js.map +1 -0
  1154. package/dist/domains/project-knowledge/local-store.d.ts +49 -0
  1155. package/dist/domains/project-knowledge/local-store.d.ts.map +1 -0
  1156. package/dist/domains/project-knowledge/local-store.js +816 -0
  1157. package/dist/domains/project-knowledge/local-store.js.map +1 -0
  1158. package/dist/domains/project-knowledge/plugin.d.ts +8 -0
  1159. package/dist/domains/project-knowledge/plugin.d.ts.map +1 -0
  1160. package/dist/domains/project-knowledge/plugin.js +822 -0
  1161. package/dist/domains/project-knowledge/plugin.js.map +1 -0
  1162. package/dist/domains/project-knowledge/query.d.ts +15 -0
  1163. package/dist/domains/project-knowledge/query.d.ts.map +1 -0
  1164. package/dist/domains/project-knowledge/query.js +154 -0
  1165. package/dist/domains/project-knowledge/query.js.map +1 -0
  1166. package/dist/domains/project-knowledge/records.d.ts +67 -0
  1167. package/dist/domains/project-knowledge/records.d.ts.map +1 -0
  1168. package/dist/domains/project-knowledge/records.js +291 -0
  1169. package/dist/domains/project-knowledge/records.js.map +1 -0
  1170. package/dist/domains/project-knowledge/remote-provider.d.ts +28 -0
  1171. package/dist/domains/project-knowledge/remote-provider.d.ts.map +1 -0
  1172. package/dist/domains/project-knowledge/remote-provider.js +671 -0
  1173. package/dist/domains/project-knowledge/remote-provider.js.map +1 -0
  1174. package/dist/domains/project-knowledge/renderer.d.ts +5 -0
  1175. package/dist/domains/project-knowledge/renderer.d.ts.map +1 -0
  1176. package/dist/domains/project-knowledge/renderer.js +88 -0
  1177. package/dist/domains/project-knowledge/renderer.js.map +1 -0
  1178. package/dist/domains/project-knowledge/source-validity.d.ts +3 -0
  1179. package/dist/domains/project-knowledge/source-validity.d.ts.map +1 -0
  1180. package/dist/domains/project-knowledge/source-validity.js +32 -0
  1181. package/dist/domains/project-knowledge/source-validity.js.map +1 -0
  1182. package/dist/domains/project-knowledge/sqlite.d.ts +4 -0
  1183. package/dist/domains/project-knowledge/sqlite.d.ts.map +1 -0
  1184. package/dist/domains/project-knowledge/sqlite.js +27 -0
  1185. package/dist/domains/project-knowledge/sqlite.js.map +1 -0
  1186. package/dist/domains/project-knowledge/types.d.ts +282 -0
  1187. package/dist/domains/project-knowledge/types.d.ts.map +1 -0
  1188. package/dist/domains/project-knowledge/types.js +2 -0
  1189. package/dist/domains/project-knowledge/types.js.map +1 -0
  1190. package/dist/domains/skill/dsh-adapter.d.ts +31 -0
  1191. package/dist/domains/skill/dsh-adapter.d.ts.map +1 -0
  1192. package/dist/domains/skill/dsh-adapter.js +257 -0
  1193. package/dist/domains/skill/dsh-adapter.js.map +1 -0
  1194. package/dist/domains/skill/hook-lifecycle.d.ts +9 -0
  1195. package/dist/domains/skill/hook-lifecycle.d.ts.map +1 -0
  1196. package/dist/domains/skill/hook-lifecycle.js +51 -0
  1197. package/dist/domains/skill/hook-lifecycle.js.map +1 -0
  1198. package/dist/domains/skill/languages.d.ts +2 -1
  1199. package/dist/domains/skill/languages.d.ts.map +1 -1
  1200. package/dist/domains/skill/languages.js +4 -1
  1201. package/dist/domains/skill/languages.js.map +1 -1
  1202. package/dist/domains/skill/platform-inspect.d.ts +4 -0
  1203. package/dist/domains/skill/platform-inspect.d.ts.map +1 -1
  1204. package/dist/domains/skill/platform-inspect.js +272 -40
  1205. package/dist/domains/skill/platform-inspect.js.map +1 -1
  1206. package/dist/domains/skill/platform-install.d.ts +45 -5
  1207. package/dist/domains/skill/platform-install.d.ts.map +1 -1
  1208. package/dist/domains/skill/platform-install.js +583 -108
  1209. package/dist/domains/skill/platform-install.js.map +1 -1
  1210. package/dist/domains/skill/project-hook-projection.d.ts +14 -0
  1211. package/dist/domains/skill/project-hook-projection.d.ts.map +1 -0
  1212. package/dist/domains/skill/project-hook-projection.js +41 -0
  1213. package/dist/domains/skill/project-hook-projection.js.map +1 -0
  1214. package/dist/domains/skill/project-instructions.d.ts +3 -0
  1215. package/dist/domains/skill/project-instructions.d.ts.map +1 -1
  1216. package/dist/domains/skill/project-instructions.js +23 -5
  1217. package/dist/domains/skill/project-instructions.js.map +1 -1
  1218. package/dist/domains/skill/uninstall.d.ts +16 -3
  1219. package/dist/domains/skill/uninstall.d.ts.map +1 -1
  1220. package/dist/domains/skill/uninstall.js +951 -65
  1221. package/dist/domains/skill/uninstall.js.map +1 -1
  1222. package/dist/domains/workflow-contract/builtins.d.ts.map +1 -1
  1223. package/dist/domains/workflow-contract/builtins.js +12 -6
  1224. package/dist/domains/workflow-contract/builtins.js.map +1 -1
  1225. package/dist/domains/workflow-contract/contained-atomic-write.d.ts +24 -0
  1226. package/dist/domains/workflow-contract/contained-atomic-write.d.ts.map +1 -0
  1227. package/dist/domains/workflow-contract/contained-atomic-write.js +256 -0
  1228. package/dist/domains/workflow-contract/contained-atomic-write.js.map +1 -0
  1229. package/dist/domains/workflow-contract/global-config.d.ts +10 -0
  1230. package/dist/domains/workflow-contract/global-config.d.ts.map +1 -0
  1231. package/dist/domains/workflow-contract/global-config.js +117 -0
  1232. package/dist/domains/workflow-contract/global-config.js.map +1 -0
  1233. package/dist/domains/workflow-contract/hook-target-scope.d.ts +6 -0
  1234. package/dist/domains/workflow-contract/hook-target-scope.d.ts.map +1 -0
  1235. package/dist/domains/workflow-contract/hook-target-scope.js +51 -0
  1236. package/dist/domains/workflow-contract/hook-target-scope.js.map +1 -0
  1237. package/dist/domains/workflow-contract/hook-write-policy.d.ts +9 -0
  1238. package/dist/domains/workflow-contract/hook-write-policy.d.ts.map +1 -0
  1239. package/dist/domains/workflow-contract/hook-write-policy.js +52 -0
  1240. package/dist/domains/workflow-contract/hook-write-policy.js.map +1 -0
  1241. package/dist/domains/workflow-contract/index.d.ts +13 -1
  1242. package/dist/domains/workflow-contract/index.d.ts.map +1 -1
  1243. package/dist/domains/workflow-contract/index.js +9 -1
  1244. package/dist/domains/workflow-contract/index.js.map +1 -1
  1245. package/dist/domains/workflow-contract/normalize.d.ts.map +1 -1
  1246. package/dist/domains/workflow-contract/normalize.js +2 -1
  1247. package/dist/domains/workflow-contract/normalize.js.map +1 -1
  1248. package/dist/domains/workflow-contract/project-config-reader.d.ts +26 -0
  1249. package/dist/domains/workflow-contract/project-config-reader.d.ts.map +1 -0
  1250. package/dist/domains/workflow-contract/project-config-reader.js +54 -0
  1251. package/dist/domains/workflow-contract/project-config-reader.js.map +1 -0
  1252. package/dist/domains/workflow-contract/project-config-transaction.d.ts +20 -0
  1253. package/dist/domains/workflow-contract/project-config-transaction.d.ts.map +1 -0
  1254. package/dist/domains/workflow-contract/project-config-transaction.js +293 -0
  1255. package/dist/domains/workflow-contract/project-config-transaction.js.map +1 -0
  1256. package/dist/domains/workflow-contract/project-config-writer.d.ts +13 -0
  1257. package/dist/domains/workflow-contract/project-config-writer.d.ts.map +1 -0
  1258. package/dist/domains/workflow-contract/project-config-writer.js +143 -0
  1259. package/dist/domains/workflow-contract/project-config-writer.js.map +1 -0
  1260. package/dist/domains/workflow-contract/project-config.d.ts +37 -2
  1261. package/dist/domains/workflow-contract/project-config.d.ts.map +1 -1
  1262. package/dist/domains/workflow-contract/project-config.js +2139 -27
  1263. package/dist/domains/workflow-contract/project-config.js.map +1 -1
  1264. package/dist/domains/workflow-contract/project-gitignore.d.ts +9 -0
  1265. package/dist/domains/workflow-contract/project-gitignore.d.ts.map +1 -0
  1266. package/dist/domains/workflow-contract/project-gitignore.js +108 -0
  1267. package/dist/domains/workflow-contract/project-gitignore.js.map +1 -0
  1268. package/dist/domains/workflow-contract/protected-project-path.d.ts +47 -0
  1269. package/dist/domains/workflow-contract/protected-project-path.d.ts.map +1 -0
  1270. package/dist/domains/workflow-contract/protected-project-path.js +245 -0
  1271. package/dist/domains/workflow-contract/protected-project-path.js.map +1 -0
  1272. package/dist/domains/workflow-contract/types.d.ts +104 -2
  1273. package/dist/domains/workflow-contract/types.d.ts.map +1 -1
  1274. package/dist/platform/fs/file-identity.d.ts +9 -0
  1275. package/dist/platform/fs/file-identity.d.ts.map +1 -0
  1276. package/dist/platform/fs/file-identity.js +21 -0
  1277. package/dist/platform/fs/file-identity.js.map +1 -0
  1278. package/dist/platform/fs/file-system.d.ts.map +1 -1
  1279. package/dist/platform/fs/file-system.js +13 -9
  1280. package/dist/platform/fs/file-system.js.map +1 -1
  1281. package/dist/platform/fs/plugin-store.d.ts +31 -0
  1282. package/dist/platform/fs/plugin-store.d.ts.map +1 -0
  1283. package/dist/platform/fs/plugin-store.js +171 -0
  1284. package/dist/platform/fs/plugin-store.js.map +1 -0
  1285. package/dist/platform/fs/race-safe-read.d.ts +47 -0
  1286. package/dist/platform/fs/race-safe-read.d.ts.map +1 -0
  1287. package/dist/platform/fs/race-safe-read.js +132 -0
  1288. package/dist/platform/fs/race-safe-read.js.map +1 -0
  1289. package/dist/platform/fs/strip-bom.d.ts +10 -0
  1290. package/dist/platform/fs/strip-bom.d.ts.map +1 -0
  1291. package/dist/platform/fs/strip-bom.js +12 -0
  1292. package/dist/platform/fs/strip-bom.js.map +1 -0
  1293. package/dist/platform/fs/trusted-readonly-file.d.ts +31 -0
  1294. package/dist/platform/fs/trusted-readonly-file.d.ts.map +1 -0
  1295. package/dist/platform/fs/trusted-readonly-file.js +107 -0
  1296. package/dist/platform/fs/trusted-readonly-file.js.map +1 -0
  1297. package/dist/platform/http/bounded-request.d.ts +18 -0
  1298. package/dist/platform/http/bounded-request.d.ts.map +1 -0
  1299. package/dist/platform/http/bounded-request.js +69 -0
  1300. package/dist/platform/http/bounded-request.js.map +1 -0
  1301. package/dist/platform/install/detect.d.ts +1 -0
  1302. package/dist/platform/install/detect.d.ts.map +1 -1
  1303. package/dist/platform/install/detect.js +2 -0
  1304. package/dist/platform/install/detect.js.map +1 -1
  1305. package/dist/platform/install/platform-targets.d.ts +8 -0
  1306. package/dist/platform/install/platform-targets.d.ts.map +1 -0
  1307. package/dist/platform/install/platform-targets.js +35 -0
  1308. package/dist/platform/install/platform-targets.js.map +1 -0
  1309. package/dist/platform/install/platforms.d.ts +22 -3
  1310. package/dist/platform/install/platforms.d.ts.map +1 -1
  1311. package/dist/platform/install/platforms.js +101 -1
  1312. package/dist/platform/install/platforms.js.map +1 -1
  1313. package/dist/platform/paths/git-worktree.d.ts +20 -0
  1314. package/dist/platform/paths/git-worktree.d.ts.map +1 -0
  1315. package/dist/platform/paths/git-worktree.js +110 -0
  1316. package/dist/platform/paths/git-worktree.js.map +1 -0
  1317. package/dist/platform/paths/portable-path.d.ts +6 -0
  1318. package/dist/platform/paths/portable-path.d.ts.map +1 -0
  1319. package/dist/platform/paths/portable-path.js +15 -0
  1320. package/dist/platform/paths/portable-path.js.map +1 -0
  1321. package/dist/platform/paths/project-identity.d.ts +13 -0
  1322. package/dist/platform/paths/project-identity.d.ts.map +1 -0
  1323. package/dist/platform/paths/project-identity.js +81 -0
  1324. package/dist/platform/paths/project-identity.js.map +1 -0
  1325. package/dist/platform/paths/project-knowledge-storage.d.ts +8 -0
  1326. package/dist/platform/paths/project-knowledge-storage.d.ts.map +1 -0
  1327. package/dist/platform/paths/project-knowledge-storage.js +23 -0
  1328. package/dist/platform/paths/project-knowledge-storage.js.map +1 -0
  1329. package/dist/platform/process/external-command.d.ts +15 -0
  1330. package/dist/platform/process/external-command.d.ts.map +1 -0
  1331. package/dist/platform/process/external-command.js +57 -0
  1332. package/dist/platform/process/external-command.js.map +1 -0
  1333. package/dist/platform/process/git.d.ts +12 -0
  1334. package/dist/platform/process/git.d.ts.map +1 -0
  1335. package/dist/platform/process/git.js +86 -0
  1336. package/dist/platform/process/git.js.map +1 -0
  1337. package/dist/platform/process/hook-read-cache.d.ts +45 -0
  1338. package/dist/platform/process/hook-read-cache.d.ts.map +1 -0
  1339. package/dist/platform/process/hook-read-cache.js +102 -0
  1340. package/dist/platform/process/hook-read-cache.js.map +1 -0
  1341. package/dist/platform/process/ripgrep.d.ts +24 -0
  1342. package/dist/platform/process/ripgrep.d.ts.map +1 -0
  1343. package/dist/platform/process/ripgrep.js +140 -0
  1344. package/dist/platform/process/ripgrep.js.map +1 -0
  1345. package/dist/platform/process/spawn-command.d.ts +10 -0
  1346. package/dist/platform/process/spawn-command.d.ts.map +1 -0
  1347. package/dist/platform/process/spawn-command.js +113 -0
  1348. package/dist/platform/process/spawn-command.js.map +1 -0
  1349. package/dist/platform/process/terminate-process-tree.d.ts +3 -0
  1350. package/dist/platform/process/terminate-process-tree.d.ts.map +1 -0
  1351. package/dist/platform/process/terminate-process-tree.js +65 -0
  1352. package/dist/platform/process/terminate-process-tree.js.map +1 -0
  1353. package/dist/platform/version/version.d.ts.map +1 -1
  1354. package/dist/platform/version/version.js +9 -2
  1355. package/dist/platform/version/version.js.map +1 -1
  1356. package/eval/.env.example +115 -0
  1357. package/eval/README.md +238 -15
  1358. package/eval/langfuse/.env.example +9 -0
  1359. package/eval/langfuse/tests/conftest.py +146 -0
  1360. package/eval/langfuse/tests/tasks/test_tasks.py +109 -0
  1361. package/eval/langfuse/tests/test_adapter.py +272 -0
  1362. package/eval/langsmith/.env.example +16 -0
  1363. package/eval/langsmith/tests/conftest.py +10 -1
  1364. package/eval/local/tasks/authoring-skill-smoke/environment/Dockerfile +12 -0
  1365. package/eval/local/tasks/comet-agent-memory-routing/environment/Dockerfile +2 -4
  1366. package/eval/local/tasks/comet-api-cache-ttl/environment/Dockerfile +2 -6
  1367. package/eval/local/tasks/comet-classic-layout-lifecycle/environment/.include-current-comet-cli +1 -0
  1368. package/eval/local/tasks/comet-classic-layout-lifecycle/environment/Dockerfile +45 -0
  1369. package/eval/local/tasks/comet-classic-layout-lifecycle/environment/current-comet-package.json +23 -0
  1370. package/eval/local/tasks/comet-classic-layout-lifecycle/environment/current-comet.sh +14 -0
  1371. package/eval/local/tasks/comet-classic-layout-lifecycle/environment/test_wordcount.py +29 -0
  1372. package/eval/local/tasks/comet-classic-layout-lifecycle/environment/wordcount.py +40 -0
  1373. package/eval/local/tasks/comet-classic-layout-lifecycle/instruction.md +18 -0
  1374. package/eval/local/tasks/comet-classic-layout-lifecycle/task.toml +23 -0
  1375. package/eval/local/tasks/comet-classic-layout-lifecycle/validation/test_classic_layout_lifecycle.py +604 -0
  1376. package/eval/local/tasks/comet-cross-file-refactor/environment/Dockerfile +1 -1
  1377. package/eval/local/tasks/comet-dependency-confusion/environment/Dockerfile +1 -4
  1378. package/eval/local/tasks/comet-fix-median/environment/Dockerfile +2 -6
  1379. package/eval/local/tasks/comet-framework-selection/environment/Dockerfile +1 -4
  1380. package/eval/local/tasks/comet-full-workflow/environment/Dockerfile +2 -6
  1381. package/eval/local/tasks/comet-graph-execution-review/environment/Dockerfile +1 -4
  1382. package/eval/local/tasks/comet-human-approval-flow/environment/Dockerfile +1 -1
  1383. package/eval/local/tasks/comet-layered-streaming-fix/environment/Dockerfile +1 -4
  1384. package/eval/local/tasks/comet-native-clarification/environment/Dockerfile +1 -3
  1385. package/eval/local/tasks/comet-native-clarification/validation/test_native_clarification.py +9 -21
  1386. package/eval/local/tasks/comet-native-clarification-depth/environment/Dockerfile +25 -0
  1387. package/eval/local/tasks/comet-native-clarification-depth/environment/test_wordcount.py +25 -0
  1388. package/eval/local/tasks/comet-native-clarification-depth/environment/wordcount.py +36 -0
  1389. package/eval/local/tasks/comet-native-clarification-depth/instruction.md +17 -0
  1390. package/eval/local/tasks/comet-native-clarification-depth/task.toml +47 -0
  1391. package/eval/local/tasks/comet-native-clarification-depth/validation/test_native_clarification_depth.py +615 -0
  1392. package/eval/local/tasks/comet-native-clarification-modes/environment/Dockerfile +1 -3
  1393. package/eval/local/tasks/comet-native-clarification-modes/validation/test_native_clarification_modes.py +5 -11
  1394. package/eval/local/tasks/comet-native-interrupted-transition/environment/Dockerfile +1 -3
  1395. package/eval/local/tasks/comet-native-interrupted-transition/instruction.md +1 -1
  1396. package/eval/local/tasks/comet-native-interrupted-transition/validation/test_native_interrupted_transition.py +15 -16
  1397. package/eval/local/tasks/comet-native-repository-fact/environment/Dockerfile +1 -3
  1398. package/eval/local/tasks/comet-native-repository-fact/instruction.md +2 -2
  1399. package/eval/local/tasks/comet-native-repository-fact/validation/test_native_repository_fact.py +8 -2
  1400. package/eval/local/tasks/comet-native-wave-b-decision-resume/environment/Dockerfile +1 -3
  1401. package/eval/local/tasks/comet-native-wave-b-decision-resume/instruction.md +8 -4
  1402. package/eval/local/tasks/comet-native-wave-b-decision-resume/task.toml +6 -6
  1403. package/eval/local/tasks/comet-native-wave-b-decision-resume/validation/test_native_wave_b_decision_resume.py +126 -135
  1404. package/eval/local/tasks/comet-native-wave-c-verification-integrity/environment/Dockerfile +1 -3
  1405. package/eval/local/tasks/comet-native-wave-c-verification-integrity/instruction.md +6 -6
  1406. package/eval/local/tasks/comet-native-wave-c-verification-integrity/task.toml +8 -8
  1407. package/eval/local/tasks/comet-native-wave-c-verification-integrity/validation/test_native_wave_c_verification_integrity.py +97 -317
  1408. package/eval/local/tasks/comet-native-wave-d-stagnation-stop/environment/Dockerfile +1 -3
  1409. package/eval/local/tasks/comet-native-wave-d-stagnation-stop/instruction.md +7 -7
  1410. package/eval/local/tasks/comet-native-wave-d-stagnation-stop/task.toml +4 -4
  1411. package/eval/local/tasks/comet-native-wave-d-stagnation-stop/validation/test_native_wave_d_stagnation_stop.py +130 -199
  1412. package/eval/local/tasks/comet-native-wave-e-parallel-safety/environment/Dockerfile +1 -3
  1413. package/eval/local/tasks/comet-native-wave-e-parallel-safety/instruction.md +5 -5
  1414. package/eval/local/tasks/comet-native-wave-e-parallel-safety/task.toml +8 -8
  1415. package/eval/local/tasks/comet-native-wave-e-parallel-safety/validation/test_native_wave_e_parallel_safety.py +135 -239
  1416. package/eval/local/tasks/comet-native-wave-f-dashboard-readonly/environment/Dockerfile +1 -3
  1417. package/eval/local/tasks/comet-native-wave-f-dashboard-readonly/environment/current-comet-package.json +8 -3
  1418. package/eval/local/tasks/comet-native-wave-f-dashboard-readonly/instruction.md +3 -3
  1419. package/eval/local/tasks/comet-native-wave-f-dashboard-readonly/task.toml +6 -6
  1420. package/eval/local/tasks/comet-native-wave-f-dashboard-readonly/validation/test_native_wave_f_dashboard_readonly.py +81 -425
  1421. package/eval/local/tasks/comet-native-workflow/environment/.include-trusted-native-runtime +1 -0
  1422. package/eval/local/tasks/comet-native-workflow/environment/Dockerfile +3 -4
  1423. package/eval/local/tasks/comet-native-workflow/instruction.md +13 -3
  1424. package/eval/local/tasks/comet-native-workflow/task.toml +4 -2
  1425. package/eval/local/tasks/comet-native-workflow/validation/test_native_workflow.py +150 -49
  1426. package/eval/local/tasks/comet-noise-distractor/environment/Dockerfile +1 -1
  1427. package/eval/local/tasks/comet-observability-env-template/environment/Dockerfile +1 -1
  1428. package/eval/local/tasks/comet-perf-dedupe/environment/Dockerfile +2 -6
  1429. package/eval/local/tasks/comet-persistence-threading/environment/Dockerfile +1 -1
  1430. package/eval/local/tasks/comet-refactor-counter/environment/Dockerfile +2 -6
  1431. package/eval/local/tasks/comet-robust-config/environment/Dockerfile +2 -6
  1432. package/eval/local/tasks/generic-skill-smoke/environment/Dockerfile +12 -0
  1433. package/eval/local/tasks/generic-skill-smoke/validation/test_generic_skill_smoke.py +6 -1
  1434. package/eval/local/tasks/index.yaml +18 -5
  1435. package/eval/local/tasks/workflow-overlay-contract/environment/Dockerfile +11 -0
  1436. package/eval/local/tasks/workflow-route-conformance/environment/Dockerfile +12 -0
  1437. package/eval/local/tests/conftest.py +905 -74
  1438. package/eval/local/tests/scaffold/fixtures/custom-agent/adapter.yaml +19 -0
  1439. package/eval/local/tests/scaffold/test_agents.py +76 -0
  1440. package/eval/local/tests/scaffold/test_aligned_comparison.py +70 -0
  1441. package/eval/local/tests/scaffold/test_auto_tasks.py +350 -0
  1442. package/eval/local/tests/scaffold/test_conftest_helpers.py +573 -1
  1443. package/eval/local/tests/scaffold/test_custom_agents.py +174 -0
  1444. package/eval/local/tests/scaffold/test_eval_context.py +217 -0
  1445. package/eval/local/tests/scaffold/test_execution.py +364 -0
  1446. package/eval/local/tests/scaffold/test_inline_tasks.py +56 -0
  1447. package/eval/local/tests/scaffold/test_langfuse_trajectory.py +263 -0
  1448. package/eval/local/tests/scaffold/test_langsmith_conftest.py +63 -0
  1449. package/eval/local/tests/scaffold/test_logging.py +231 -0
  1450. package/eval/local/tests/scaffold/test_manifest_tasks.py +76 -0
  1451. package/eval/local/tests/scaffold/test_manifests.py +396 -0
  1452. package/eval/local/tests/scaffold/test_native_aligned_eval.py +170 -35
  1453. package/eval/local/tests/scaffold/test_native_wave_evaluations.py +75 -1848
  1454. package/eval/local/tests/scaffold/test_profiles.py +317 -9
  1455. package/eval/local/tests/scaffold/test_task_resolution.py +212 -0
  1456. package/eval/local/tests/scaffold/test_tasks.py +511 -59
  1457. package/eval/local/tests/scaffold/test_treatments.py +64 -1
  1458. package/eval/local/tests/scaffold/test_utils.py +700 -4
  1459. package/eval/local/tests/tasks/test_tasks.py +222 -17
  1460. package/eval/local/tests/tasks/test_validation_scripts.py +608 -1
  1461. package/eval/local/treatments/comet/comet_classic_docs_layout.yaml +121 -0
  1462. package/eval/local/treatments/comet/comet_native_phase1.yaml +7 -4
  1463. package/eval/pyproject.toml +9 -4
  1464. package/eval/scaffold/__init__.py +6 -0
  1465. package/eval/scaffold/docker/agent-overlay.Dockerfile +41 -0
  1466. package/eval/scaffold/python/__init__.py +128 -20
  1467. package/eval/scaffold/python/agents.py +239 -0
  1468. package/eval/scaffold/python/aligned_comparison.py +157 -27
  1469. package/eval/scaffold/python/auto_tasks.py +700 -0
  1470. package/eval/scaffold/python/custom_agents.py +172 -0
  1471. package/eval/scaffold/python/eval_context.py +236 -0
  1472. package/eval/scaffold/python/eval_schema.py +135 -0
  1473. package/eval/scaffold/python/execution.py +544 -0
  1474. package/eval/scaffold/python/generated_task_cache.py +230 -0
  1475. package/eval/scaffold/python/generic_llm_judge.py +41 -14
  1476. package/eval/scaffold/python/inline_tasks.py +118 -0
  1477. package/eval/scaffold/python/judge_config.py +158 -37
  1478. package/eval/scaffold/python/langfuse_adapter.py +1023 -0
  1479. package/eval/scaffold/python/llm_judge.py +68 -11
  1480. package/eval/scaffold/python/logging.py +160 -17
  1481. package/eval/scaffold/python/manifest_tasks.py +69 -0
  1482. package/eval/scaffold/python/manifests.py +443 -22
  1483. package/eval/scaffold/python/native_eval.py +16 -6
  1484. package/eval/scaffold/python/paths.py +11 -1
  1485. package/eval/scaffold/python/task_resolution.py +176 -0
  1486. package/eval/scaffold/python/tasks.py +19 -4
  1487. package/eval/scaffold/python/utils.py +193 -31
  1488. package/eval/scaffold/python/validation/authoring_rubric.py +6 -4
  1489. package/eval/scaffold/python/validation/comet_workflow.py +46 -11
  1490. package/eval/scaffold/python/validation/core.py +48 -2
  1491. package/eval/scaffold/python/validation/generic_rubric.py +44 -5
  1492. package/eval/scaffold/python/validation/native_v4.py +249 -0
  1493. package/eval/scaffold/python/validation/native_wave.py +4 -5
  1494. package/eval/scaffold/python/validation/native_workflow.py +199 -98
  1495. package/eval/scaffold/python/validation/rubric.py +242 -72
  1496. package/eval/scaffold/shell/agent-runtime-config.sh +88 -0
  1497. package/eval/scaffold/shell/docker.sh +540 -34
  1498. package/eval/scaffold/shell/run-agent-runtime.sh +49 -0
  1499. package/eval/scaffold/shell/run-claude-loop.sh +178 -16
  1500. package/eval/schemas/comet.eval/v1alpha1.schema.json +244 -0
  1501. package/package.json +43 -34
  1502. package/assets/skills/comet/reference/scripts.md +0 -101
  1503. package/assets/skills-zh/comet/reference/scripts.md +0 -101
  1504. package/dist/domains/dashboard/web/assets/_commonjsHelpers-CqkleIqs.js +0 -1
  1505. package/dist/domains/dashboard/web/assets/arc-CxdiLJ50.js +0 -1
  1506. package/dist/domains/dashboard/web/assets/architectureDiagram-3BPJPVTR-D5YCQu4e.js +0 -36
  1507. package/dist/domains/dashboard/web/assets/blockDiagram-GPEHLZMM-8NfdCOQ8.js +0 -132
  1508. package/dist/domains/dashboard/web/assets/channel-B6AFly29.js +0 -1
  1509. package/dist/domains/dashboard/web/assets/chunk-AQP2D5EJ-wKsbOw_T.js +0 -231
  1510. package/dist/domains/dashboard/web/assets/classDiagram-4FO5ZUOK-BcnrxOTt.js +0 -1
  1511. package/dist/domains/dashboard/web/assets/classDiagram-v2-Q7XG4LA2-BcnrxOTt.js +0 -1
  1512. package/dist/domains/dashboard/web/assets/cose-bilkent-S5V4N54A-CbaShPub.js +0 -1
  1513. package/dist/domains/dashboard/web/assets/dagre-BM42HDAG-BpSzbk_V.js +0 -4
  1514. package/dist/domains/dashboard/web/assets/demo-BuVau32v.js +0 -25
  1515. package/dist/domains/dashboard/web/assets/diagram-2AECGRRQ-CfXwGGpQ.js +0 -43
  1516. package/dist/domains/dashboard/web/assets/diagram-5GNKFQAL-DMp0Zmot.js +0 -10
  1517. package/dist/domains/dashboard/web/assets/diagram-LMA3HP47-BjmxFnap.js +0 -24
  1518. package/dist/domains/dashboard/web/assets/diagram-OG6HWLK6-DFBG1Iqy.js +0 -24
  1519. package/dist/domains/dashboard/web/assets/erDiagram-TEJ5UH35-MpNT7dzt.js +0 -85
  1520. package/dist/domains/dashboard/web/assets/flowDiagram-I6XJVG4X-_1wAR6c1.js +0 -162
  1521. package/dist/domains/dashboard/web/assets/ganttDiagram-6RSMTGT7-DJKjDeWl.js +0 -292
  1522. package/dist/domains/dashboard/web/assets/gitGraphDiagram-PVQCEYII-BL7yUEn-.js +0 -106
  1523. package/dist/domains/dashboard/web/assets/index-CjE9mHGb.js +0 -24
  1524. package/dist/domains/dashboard/web/assets/index-D-AGxvI4.css +0 -1
  1525. package/dist/domains/dashboard/web/assets/infoDiagram-5YYISTIA-Bt5fqrOd.js +0 -2
  1526. package/dist/domains/dashboard/web/assets/layout-SsrduOYp.js +0 -1
  1527. package/dist/domains/dashboard/web/assets/mermaid.core-CkNdB471.js +0 -301
  1528. package/dist/domains/dashboard/web/assets/pieDiagram-4H26LBE5-BLJ6QnRO.js +0 -30
  1529. package/dist/domains/dashboard/web/assets/purify.es-VaSPOPhr.js +0 -3
  1530. package/dist/domains/dashboard/web/assets/sankeyDiagram-5OEKKPKP-6xnco5k5.js +0 -40
  1531. package/dist/domains/dashboard/web/assets/sequenceDiagram-3UESZ5HK-Dp1rujNZ.js +0 -162
  1532. package/dist/domains/dashboard/web/assets/stateDiagram-AJRCARHV-C1Xc90ek.js +0 -1
  1533. package/dist/domains/dashboard/web/assets/stateDiagram-v2-BHNVJYJU-p-qmzXyE.js +0 -1
  1534. package/dist/domains/dashboard/web/assets/vennDiagram-CIIHVFJN-rkEyhyCc.js +0 -34
  1535. package/dist/domains/dashboard/web/assets/xychartDiagram-2RQKCTM6-BxJvPNqo.js +0 -7
  1536. package/eval/local/tasks/comet-native-interrupted-transition/environment/.comet/config.yaml +0 -6
@@ -1,17 +1,167 @@
1
- import { promises as fs } from 'fs';
2
1
  import path from 'path';
3
2
  import { stringify, parseDocument } from 'yaml';
3
+ export const WORKFLOW_PROJECT_CONFIG_MAX_BYTES = 64 * 1024;
4
+ export const MAX_WORKFLOW_SNAPSHOT_PATTERN_LENGTH = 1024;
5
+ export const MAX_WORKFLOW_SNAPSHOT_PATTERN_WILDCARDS = 64;
6
+ export const MAX_WORKFLOW_KNOWLEDGE_INCLUDE_PATTERN_LENGTH = 1024;
7
+ export const MAX_WORKFLOW_KNOWLEDGE_INCLUDE_PATTERN_WILDCARDS = 64;
8
+ export const DEFAULT_WORKFLOW_NATIVE_MAX_VERIFY_FAILURES = 5;
9
+ export const DEFAULT_WORKFLOW_MEMORY_PROJECT_CONFIG = {
10
+ learning: true,
11
+ retrieval: true,
12
+ };
13
+ export const DEFAULT_WORKFLOW_KNOWLEDGE_PROJECT_CONFIG = {
14
+ provider: 'local',
15
+ };
16
+ export const DEFAULT_WORKFLOW_NATIVE_PULL_REQUEST_FINISH_TIMEOUT_MS = 120_000;
17
+ export const MAX_WORKFLOW_NATIVE_PULL_REQUEST_FINISH_TIMEOUT_MS = 600_000;
18
+ // `comet init` installs the built-in Skills into every supported platform's
19
+ // project-local Skill directory. A Native baseline describes the project being
20
+ // changed, not these replicated, tool-managed copies. Keeping them outside the
21
+ // default scope also keeps a newly initialized, non-Git project within the
22
+ // bounded physical snapshot budget.
23
+ const DEFAULT_WORKFLOW_NATIVE_MANAGED_SKILL_EXCLUDES = [
24
+ '.agents/skills/**',
25
+ '.amazonq/skills/**',
26
+ '.augment/skills/**',
27
+ '.bob/skills/**',
28
+ '.claude/skills/**',
29
+ '.cline/skills/**',
30
+ '.codebuddy/skills/**',
31
+ '.workbuddy/skills/**',
32
+ '.continue/skills/**',
33
+ '.cospec/skills/**',
34
+ '.crush/skills/**',
35
+ '.cursor/skills/**',
36
+ '.dsh/skills/**',
37
+ '.factory/skills/**',
38
+ '.forge/skills/**',
39
+ '.gemini/skills/**',
40
+ '.github/skills/**',
41
+ '.grok/skills/**',
42
+ '.iflow/skills/**',
43
+ '.junie/skills/**',
44
+ '.kilocode/skills/**',
45
+ '.kimi-code/skills/**',
46
+ '.kiro/skills/**',
47
+ '.lingma/skills/**',
48
+ '.mimocode/skills/**',
49
+ '.opencode/skills/**',
50
+ '.omp/skills/**',
51
+ '.pi/skills/**',
52
+ '.qoder/skills/**',
53
+ '.qwen/skills/**',
54
+ '.roo/skills/**',
55
+ '.trae-cn/skills/**',
56
+ '.trae/skills/**',
57
+ '.windsurf/skills/**',
58
+ '.zcode/skills/**',
59
+ ];
60
+ // Native snapshots describe source and project intent, not dependency trees,
61
+ // IDE metadata, caches, test output, or compiler output. The generated-path
62
+ // defaults below apply at every directory depth so monorepos do not pull
63
+ // generated folders into a baseline just because they are nested below the
64
+ // project root.
65
+ const DEFAULT_WORKFLOW_NATIVE_GENERATED_EXCLUDES = [
66
+ '**/.idea/**',
67
+ '**/.vscode/**',
68
+ '.codex/skills/**',
69
+ '**/node_modules/**',
70
+ '**/.next/**',
71
+ '**/.nuxt/**',
72
+ '**/.output/**',
73
+ '**/.svelte-kit/**',
74
+ '**/.vite/**',
75
+ '**/.parcel-cache/**',
76
+ '**/.turbo/**',
77
+ '**/.nx/cache/**',
78
+ '**/dist/**',
79
+ '**/build/**',
80
+ '**/out/**',
81
+ '**/coverage/**',
82
+ '**/.nyc_output/**',
83
+ '**/target/**',
84
+ '**/.gradle/**',
85
+ '**/.cxx/**',
86
+ '**/.externalNativeBuild/**',
87
+ '**/captures/**',
88
+ '**/__pycache__/**',
89
+ '**/.pytest_cache/**',
90
+ '**/.mypy_cache/**',
91
+ '**/.ruff_cache/**',
92
+ '**/.tox/**',
93
+ '**/.nox/**',
94
+ '**/.venv/**',
95
+ '**/venv/**',
96
+ '**/obj/**',
97
+ '**/CMakeFiles/**',
98
+ '**/cmake-build-*/**',
99
+ '**/.cache/**',
100
+ '**/tmp/**',
101
+ '**/temp/**',
102
+ '**/logs/**',
103
+ '**/*.tsbuildinfo',
104
+ '**/*.log',
105
+ '**/.DS_Store',
106
+ '**/Thumbs.db',
107
+ ];
108
+ export const DEFAULT_WORKFLOW_NATIVE_SNAPSHOT_EXCLUDES = [
109
+ ...DEFAULT_WORKFLOW_NATIVE_MANAGED_SKILL_EXCLUDES,
110
+ ...DEFAULT_WORKFLOW_NATIVE_GENERATED_EXCLUDES,
111
+ ].sort((left, right) => left.localeCompare(right, 'en'));
112
+ export function mergeWorkflowNativeSnapshotExcludes(exclude) {
113
+ const merged = [...exclude];
114
+ const seen = new Set(exclude);
115
+ for (const pattern of DEFAULT_WORKFLOW_NATIVE_SNAPSHOT_EXCLUDES) {
116
+ if (seen.has(pattern))
117
+ continue;
118
+ seen.add(pattern);
119
+ merged.push(pattern);
120
+ }
121
+ return merged;
122
+ }
123
+ export const DEFAULT_WORKFLOW_NATIVE_SNAPSHOT_CONFIG = {
124
+ include: ['**/*'],
125
+ exclude: [...DEFAULT_WORKFLOW_NATIVE_SNAPSHOT_EXCLUDES],
126
+ max_files: 10_000,
127
+ max_total_bytes: 256 * 1024 * 1024,
128
+ max_duration_ms: 60_000,
129
+ };
4
130
  const COMMENTS = {
5
131
  en: {
6
132
  schema: '# Configuration schema used by Comet. Do not edit this value.',
7
133
  default_workflow: '# Default workflow entered by /comet. Must also appear in workflows.',
8
134
  workflows: '# Workflows enabled in this project: native, classic, or both.',
9
135
  ambient_resume: '# Enables automatic recovery through the read-only Ambient Resume probe for both Native and Classic. Set false to disable it.\n# ambient_resume: true | false',
136
+ memory: '# Project policy for automatic personal-memory learning and retrieval.',
137
+ 'memory.learning': '# Allows workflow events in this project to form new personal memories automatically.\n# learning: true | false',
138
+ 'memory.retrieval': '# Allows personal memories to be injected into Agent context for this project.\n# retrieval: true | false',
139
+ knowledge: '# Project knowledge retrieval provider used by ordinary Comet tasks.',
140
+ 'knowledge.provider': '# Provider for project knowledge.\n# provider: local | remote',
141
+ 'knowledge.local': '# Additional project-relative Markdown globs used by the local provider.',
142
+ 'knowledge.local.include': '# One project-relative Markdown glob per list item; appended to the built-in corpus.',
143
+ 'knowledge.remote': '# Fixed Comet Retrieval API v1 settings used when provider is remote.',
144
+ 'knowledge.remote.endpoint': '# HTTPS endpoint; loopback HTTP is allowed.',
145
+ 'knowledge.remote.token_env': '# Optional environment variable containing the bearer token.',
146
+ 'knowledge.remote.scope': '# Optional opaque remote knowledge scope.',
147
+ 'knowledge.remote.timeout_ms': '# Remote request timeout in milliseconds (100-30000).',
148
+ hook: '# Hook write policy shared by Native and Classic. Paths are project-relative.',
149
+ 'hook.allow_paths': '# Project-relative directories allowed during guarded phases. Use one path per list item; empty by default.',
10
150
  native: '# Native workflow settings. They do not change Classic state or behavior.',
11
- 'native.artifact_root': '# Root directory where Native stores Comet specs, changes, and runtime data.',
151
+ 'native.artifact_root': '# Root directory where Native stores Comet specs and changes. Runtime data stays under .comet.',
12
152
  'native.language': '# Artifact language used by Native workflow documents.\n# language: en | zh-CN',
13
- 'native.clarification_mode': '# Controls whether Native asks one clarification at a time or every currently answerable question in a round.\n# clarification_mode: sequential | batch',
153
+ 'native.clarification_mode': '# Controls how Native asks clarifying questions: batch asks every currently answerable question per round (default), sequential asks one at a time.\n# clarification_mode: batch | sequential',
154
+ 'native.archive_confirmation': '# Controls whether Native archives automatically after a successful preview or waits for explicit user confirmation.\n# archive_confirmation: automatic | required',
155
+ 'native.max_verify_failures': '# Maximum failed Verify outcomes allowed for one confirmed acceptance target before Native stops the completion loop.',
156
+ 'native.finish': '# Optional repository-owned finish providers. Native keeps commit, push, generic remote verification, and recovery ownership.',
157
+ 'native.snapshot': '# Controls the auditable project scope and bounded work used by Native content snapshots.',
158
+ 'native.snapshot.include': '# Selects the project-relative paths included in Native snapshots. Patterns use / and support *, **, and ?.',
159
+ 'native.snapshot.exclude': '# Removes paths from the included scope. Exclusions are bound into each new change baseline.',
160
+ 'native.snapshot.max_files': '# Bounds the number of files captured by one snapshot. Increase it for large monorepos.',
161
+ 'native.snapshot.max_total_bytes': '# Bounds the total file content hashed by one snapshot. Content is streamed and does not depend on Git hashes.',
162
+ 'native.snapshot.max_duration_ms': '# Bounds snapshot capture time in milliseconds. Increase it together with the byte budget on slower or larger repositories.',
14
163
  classic: '# Classic workflow settings. They do not change Native state or behavior.',
164
+ 'classic.artifact_layout': '# Selects the Classic artifact layout. The default is docs; update preserves detected root-level legacy artifacts.\n# artifact_layout: legacy | docs',
15
165
  'classic.language': '# Artifact language used by Classic workflow documents.\n# language: en | zh-CN',
16
166
  'classic.context_compression': '# Controls beta context compression for new Classic changes.\n# context_compression: off | beta',
17
167
  'classic.review_mode': '# Sets the default review depth for new Classic changes.\n# review_mode: off | standard | thorough',
@@ -22,11 +172,35 @@ const COMMENTS = {
22
172
  default_workflow: '# `/comet` 默认进入的工作流;该值也必须出现在 workflows 中。',
23
173
  workflows: '# 此项目启用的工作流,可填写 native、classic 或同时启用两者。',
24
174
  ambient_resume: '# 是否启用只读的环境感知恢复探针,同时作用于 Native 和 Classic;设为 false 可关闭自动工作流恢复。\n# ambient_resume: true | false',
175
+ memory: '# 当前项目的个人记忆自动学习与注入策略。',
176
+ 'memory.learning': '# 是否允许当前项目通过工作流事件自动沉淀新的个人记忆。\n# 可选值:true | false',
177
+ 'memory.retrieval': '# 是否允许当前项目把个人记忆自动注入 Agent 上下文。\n# 可选值:true | false',
178
+ knowledge: '# 普通 Comet 任务使用的项目知识检索 Provider。',
179
+ 'knowledge.provider': '# 项目知识 Provider。\n# 可选值:local | remote',
180
+ 'knowledge.local': '# Local Provider 额外加载的项目相对 Markdown 路径。',
181
+ 'knowledge.local.include': '# 每项填写一个项目相对 Markdown glob;会追加到内置语料。',
182
+ 'knowledge.remote': '# provider 为 remote 时使用的固定 Comet Retrieval API v1 配置。',
183
+ 'knowledge.remote.endpoint': '# HTTPS 地址;loopback 地址允许使用 HTTP。',
184
+ 'knowledge.remote.token_env': '# 可选的 Bearer Token 环境变量名。',
185
+ 'knowledge.remote.scope': '# 可选的不透明远端知识库范围。',
186
+ 'knowledge.remote.timeout_ms': '# 远端请求超时时间(毫秒,100-30000)。',
187
+ hook: '# Native 和 Classic 共享的 Hook 写入策略;路径必须是项目相对路径。',
188
+ 'hook.allow_paths': '# 在受保护阶段允许写入的项目相对目录;每项填写一个目录,默认为空。',
25
189
  native: '# Native 工作流配置,不会改变 Classic 的状态或行为。',
26
- 'native.artifact_root': '# Native 产物的存放根目录,包括规格、change 和运行时数据。',
190
+ 'native.artifact_root': '# Native 规格和 change 的存放根目录;运行时数据始终位于 .comet。',
27
191
  'native.language': '# Native 工作流文档使用的产物语言。\n# 可选值:en | zh-CN',
28
- 'native.clarification_mode': '# Native 每轮询问一个问题,或一次提出当前所有可回答的问题。\n# 可选值:sequential | batch',
192
+ 'native.clarification_mode': '# Native 提问澄清问题的方式:batch 每轮一次提出当前所有可回答的问题(默认),sequential 每轮只问一个。\n# 可选值:batch | sequential',
193
+ 'native.archive_confirmation': '# Native 归档检查成功后自动归档,或等待用户明确确认。\n# 可选值:automatic | required',
194
+ 'native.max_verify_failures': '# 同一个已确认验收目标最多允许的 Verify 失败次数;达到上限后停止完成循环。',
195
+ 'native.finish': '# 可选的仓库自有收尾 provider;提交、推送、通用远端核验和恢复仍由 Native 负责。',
196
+ 'native.snapshot': '# Native 内容快照使用的可审计项目范围与有界工作预算。',
197
+ 'native.snapshot.include': '# Native 快照纳入的项目相对路径;模式使用 /,支持 *、** 和 ?。',
198
+ 'native.snapshot.exclude': '# 从纳入范围中排除路径;新 change 会把排除策略绑定到 baseline。',
199
+ 'native.snapshot.max_files': '# 单次快照最多捕获的文件数;大型 monorepo 可按需提高。',
200
+ 'native.snapshot.max_total_bytes': '# 单次快照最多哈希的文件内容总字节数;内容采用流式读取,不依赖 Git hash。',
201
+ 'native.snapshot.max_duration_ms': '# 单次快照的最长执行时间(毫秒);较慢或更大的仓库应与字节预算一并提高。',
29
202
  classic: '# Classic 工作流配置,不会改变 Native 的状态或行为。',
203
+ 'classic.artifact_layout': '# Classic 产物布局;默认使用 docs,update 检测到根目录 legacy 产物时予以保留。\n# 可选值:legacy | docs',
30
204
  'classic.language': '# Classic 工作流文档使用的产物语言。\n# 可选值:en | zh-CN',
31
205
  'classic.context_compression': '# 新建 Classic change 是否启用 beta 上下文压缩。\n# 可选值:off | beta',
32
206
  'classic.review_mode': '# 新建 Classic change 默认使用的审查深度。\n# 可选值:off | standard | thorough',
@@ -36,7 +210,7 @@ const COMMENTS = {
36
210
  export function projectConfigComment(key, language) {
37
211
  return COMMENTS[language][key];
38
212
  }
39
- function commentKey(line, block) {
213
+ function commentKey(line, block, nativeNested, knowledgeNested) {
40
214
  const match = /^(\s*)([a-z_]+):/u.exec(line);
41
215
  if (!match)
42
216
  return null;
@@ -49,13 +223,35 @@ function commentKey(line, block) {
49
223
  if (blockKey in COMMENTS.en)
50
224
  return blockKey;
51
225
  }
226
+ if (indent === 4 && block === 'knowledge' && knowledgeNested === 'remote') {
227
+ const nestedKey = `knowledge.remote.${key}`;
228
+ if (nestedKey in COMMENTS.en)
229
+ return nestedKey;
230
+ }
231
+ if (indent === 4 && block === 'knowledge' && knowledgeNested === 'local') {
232
+ const nestedKey = `knowledge.local.${key}`;
233
+ if (nestedKey in COMMENTS.en)
234
+ return nestedKey;
235
+ }
236
+ if (indent === 2 && block === null && key === 'hook')
237
+ return 'hook';
238
+ if (indent === 2 && block === 'hook' && key === 'allow_paths') {
239
+ return 'hook.allow_paths';
240
+ }
241
+ if (indent === 4 && block === 'native' && nativeNested === 'snapshot') {
242
+ const nestedKey = `native.snapshot.${key}`;
243
+ if (nestedKey in COMMENTS.en)
244
+ return nestedKey;
245
+ }
52
246
  return null;
53
247
  }
54
248
  export function renderStructuredProjectConfig(value, language) {
55
249
  const output = [];
56
250
  let block = null;
251
+ let nativeNested = null;
252
+ let knowledgeNested = null;
57
253
  for (const line of stringify(value).trimEnd().split('\n')) {
58
- const key = commentKey(line, block);
254
+ const key = commentKey(line, block, nativeNested, knowledgeNested);
59
255
  if (key) {
60
256
  const indent = line.match(/^\s*/u)?.[0] ?? '';
61
257
  for (const comment of projectConfigComment(key, language).split('\n')) {
@@ -68,43 +264,1959 @@ export function renderStructuredProjectConfig(value, language) {
68
264
  block = 'native';
69
265
  else if (line.startsWith('classic:'))
70
266
  block = 'classic';
267
+ else if (line.startsWith('hook:'))
268
+ block = 'hook';
269
+ else if (line.startsWith('memory:'))
270
+ block = 'memory';
271
+ else if (line.startsWith('knowledge:'))
272
+ block = 'knowledge';
71
273
  else
72
274
  block = null;
275
+ nativeNested = null;
276
+ knowledgeNested = null;
277
+ }
278
+ else if (/^ {2}[a-z_]+:/u.test(line)) {
279
+ if (block === 'native')
280
+ nativeNested = line.startsWith(' snapshot:') ? 'snapshot' : null;
281
+ if (block === 'knowledge') {
282
+ knowledgeNested = line.startsWith(' local:')
283
+ ? 'local'
284
+ : line.startsWith(' remote:')
285
+ ? 'remote'
286
+ : null;
287
+ }
73
288
  }
74
289
  }
75
290
  output.push('');
76
291
  return output.join('\n');
77
292
  }
78
- export async function readAmbientResumeEnabled(projectRoot) {
79
- const file = path.join(projectRoot, '.comet', 'config.yaml');
80
- let source;
293
+ function projectRelativeSegments(value, label) {
294
+ if (typeof value !== 'string')
295
+ throw new Error(`${label} must be a string`);
296
+ const trimmed = value.trim();
297
+ if (trimmed.length === 0 ||
298
+ path.posix.isAbsolute(trimmed) ||
299
+ path.win32.isAbsolute(trimmed) ||
300
+ /^(?:~|[\\/])/u.test(trimmed)) {
301
+ throw new Error(`${label} must be a project-relative path`);
302
+ }
303
+ if (trimmed === '.')
304
+ return [];
305
+ const segments = trimmed.replaceAll('\\', '/').split('/');
306
+ if (segments.some((segment) => segment === '..')) {
307
+ throw new Error(`${label} must stay inside the project root`);
308
+ }
309
+ if (segments.some((segment) => segment === '' || segment === '.')) {
310
+ throw new Error(`${label} must not contain empty or dot path segments`);
311
+ }
312
+ return segments;
313
+ }
314
+ export function normalizeWorkflowArtifactRoot(value) {
315
+ const segments = projectRelativeSegments(value, 'native.artifact_root');
316
+ return segments.length === 0 ? '.' : segments.join('/');
317
+ }
318
+ export function normalizeClassicArtifactLayout(value, fallback = 'docs') {
319
+ const resolved = value ?? fallback;
320
+ if (resolved !== 'legacy' && resolved !== 'docs') {
321
+ throw new Error('classic.artifact_layout must be legacy or docs');
322
+ }
323
+ return resolved;
324
+ }
325
+ export function hasExplicitClassicArtifactLayout(value) {
326
+ return (value !== null &&
327
+ typeof value === 'object' &&
328
+ !Array.isArray(value) &&
329
+ value.artifact_layout !== undefined);
330
+ }
331
+ export function normalizeWorkflowRelativePath(value, label, allowWildcards = false) {
332
+ if (typeof value !== 'string')
333
+ throw new Error(`${label} must be a string`);
334
+ const trimmed = value.trim().replaceAll('\\', '/');
335
+ if (trimmed.length === 0 ||
336
+ path.posix.isAbsolute(trimmed) ||
337
+ path.win32.isAbsolute(trimmed) ||
338
+ /^(?:~|[\\/])/u.test(trimmed)) {
339
+ throw new Error(`${label} must be relative to its declared path base`);
340
+ }
341
+ const segments = trimmed.split('/');
342
+ if (segments.some((segment) => segment === '..')) {
343
+ throw new Error(`${label} must stay inside its declared path base`);
344
+ }
345
+ if (segments.some((segment) => segment === '' || segment === '.')) {
346
+ throw new Error(`${label} must not contain empty or dot path segments`);
347
+ }
348
+ if (!allowWildcards && /[*?]/u.test(trimmed)) {
349
+ throw new Error(`${label} cannot contain wildcards`);
350
+ }
351
+ return segments.join('/');
352
+ }
353
+ function projectConfigRecord(value, label) {
354
+ if (!value || typeof value !== 'object' || Array.isArray(value)) {
355
+ throw new Error(`${label} must be a mapping`);
356
+ }
357
+ return value;
358
+ }
359
+ function projectConfigLanguage(value, fallback, label) {
360
+ const resolved = value ?? fallback;
361
+ if (resolved !== 'en' && resolved !== 'zh-CN') {
362
+ throw new Error(`${label} must be en or zh-CN`);
363
+ }
364
+ return resolved;
365
+ }
366
+ export function normalizeWorkflowSnapshotPattern(value, label) {
367
+ if (typeof value !== 'string' ||
368
+ value.length === 0 ||
369
+ value.includes('\\') ||
370
+ value.includes('\0') ||
371
+ value.startsWith('/') ||
372
+ value.split('/').includes('..')) {
373
+ throw new Error(`${label} contains an unsafe pattern`);
374
+ }
375
+ if (value.length > MAX_WORKFLOW_SNAPSHOT_PATTERN_LENGTH) {
376
+ throw new Error(`${label} exceeds ${MAX_WORKFLOW_SNAPSHOT_PATTERN_LENGTH} characters`);
377
+ }
378
+ let wildcardTokens = 0;
379
+ for (let index = 0; index < value.length; index += 1) {
380
+ if (value[index] === '?') {
381
+ wildcardTokens += 1;
382
+ }
383
+ else if (value[index] === '*') {
384
+ wildcardTokens += 1;
385
+ if (value[index + 1] === '*')
386
+ index += 1;
387
+ }
388
+ }
389
+ if (wildcardTokens > MAX_WORKFLOW_SNAPSHOT_PATTERN_WILDCARDS) {
390
+ throw new Error(`${label} contains more than ${MAX_WORKFLOW_SNAPSHOT_PATTERN_WILDCARDS} wildcard tokens`);
391
+ }
392
+ return value;
393
+ }
394
+ function workflowSnapshotPatterns(value, label, fallback) {
395
+ if (value === undefined)
396
+ return [...fallback];
397
+ if (!Array.isArray(value))
398
+ throw new Error(`${label} contains an unsafe pattern`);
399
+ return [
400
+ ...new Set(value.map((pattern) => normalizeWorkflowSnapshotPattern(pattern, label))),
401
+ ].sort((left, right) => left.localeCompare(right, 'en'));
402
+ }
403
+ function positiveWorkflowSnapshotInteger(value, fallback, label) {
404
+ const resolved = value ?? fallback;
405
+ if (!Number.isSafeInteger(resolved) || resolved < 1) {
406
+ throw new Error(`${label} must be a positive integer`);
407
+ }
408
+ return resolved;
409
+ }
410
+ function normalizeWorkflowSnapshot(value) {
411
+ if (value === undefined) {
412
+ return {
413
+ ...DEFAULT_WORKFLOW_NATIVE_SNAPSHOT_CONFIG,
414
+ include: [...DEFAULT_WORKFLOW_NATIVE_SNAPSHOT_CONFIG.include],
415
+ exclude: [...DEFAULT_WORKFLOW_NATIVE_SNAPSHOT_CONFIG.exclude],
416
+ };
417
+ }
418
+ const snapshot = projectConfigRecord(value, 'native.snapshot');
419
+ return {
420
+ include: workflowSnapshotPatterns(snapshot.include, 'native.snapshot.include', DEFAULT_WORKFLOW_NATIVE_SNAPSHOT_CONFIG.include),
421
+ exclude: workflowSnapshotPatterns(snapshot.exclude, 'native.snapshot.exclude', DEFAULT_WORKFLOW_NATIVE_SNAPSHOT_CONFIG.exclude),
422
+ max_files: positiveWorkflowSnapshotInteger(snapshot.max_files, DEFAULT_WORKFLOW_NATIVE_SNAPSHOT_CONFIG.max_files, 'native.snapshot.max_files'),
423
+ max_total_bytes: positiveWorkflowSnapshotInteger(snapshot.max_total_bytes, DEFAULT_WORKFLOW_NATIVE_SNAPSHOT_CONFIG.max_total_bytes, 'native.snapshot.max_total_bytes'),
424
+ max_duration_ms: positiveWorkflowSnapshotInteger(snapshot.max_duration_ms, DEFAULT_WORKFLOW_NATIVE_SNAPSHOT_CONFIG.max_duration_ms, 'native.snapshot.max_duration_ms'),
425
+ };
426
+ }
427
+ function normalizeWorkflowPendingRootMove(value) {
428
+ if (value === undefined)
429
+ return undefined;
430
+ const pending = projectConfigRecord(value, 'native.pending_root_move');
431
+ const id = pending.id;
432
+ const from = pending.from_artifact_root;
433
+ const to = pending.to_artifact_root;
434
+ const stage = pending.stage;
435
+ if (typeof id !== 'string' || !/^[a-f0-9-]{8,}$/u.test(id)) {
436
+ throw new Error('native.pending_root_move.id is invalid');
437
+ }
438
+ if (typeof from !== 'string' || typeof to !== 'string') {
439
+ throw new Error('native.pending_root_move roots must be strings');
440
+ }
441
+ if (stage !== 'copying' && stage !== 'ready' && stage !== 'switched') {
442
+ throw new Error('native.pending_root_move.stage is invalid');
443
+ }
444
+ let cleanup;
445
+ if (pending.cleanup !== undefined) {
446
+ const rawCleanup = projectConfigRecord(pending.cleanup, 'native.pending_root_move.cleanup');
447
+ const kind = rawCleanup.kind;
448
+ const state = rawCleanup.state;
449
+ const manifestHash = rawCleanup.manifest_hash;
450
+ if (kind !== 'forward-source' &&
451
+ kind !== 'restart-staging' &&
452
+ kind !== 'rollback-destination' &&
453
+ kind !== 'rollback-staging') {
454
+ throw new Error('native.pending_root_move.cleanup.kind is invalid');
455
+ }
456
+ if (state !== 'prepared' && state !== 'quarantined' && state !== 'deleting') {
457
+ throw new Error('native.pending_root_move.cleanup.state is invalid');
458
+ }
459
+ if (typeof manifestHash !== 'string' || !/^[a-f0-9]{64}$/u.test(manifestHash)) {
460
+ throw new Error('native.pending_root_move.cleanup.manifest_hash is invalid');
461
+ }
462
+ cleanup = { kind, state, manifestHash };
463
+ }
464
+ return {
465
+ id,
466
+ fromArtifactRoot: normalizeWorkflowArtifactRoot(from),
467
+ toArtifactRoot: normalizeWorkflowArtifactRoot(to),
468
+ stage,
469
+ ...(cleanup ? { cleanup } : {}),
470
+ };
471
+ }
472
+ function normalizeWorkflowNativeFinish(value) {
473
+ if (value === undefined)
474
+ return undefined;
475
+ const finish = projectConfigRecord(value, 'native.finish');
476
+ if (finish.pull_request === undefined)
477
+ return {};
478
+ const pullRequest = projectConfigRecord(finish.pull_request, 'native.finish.pull_request');
479
+ if (pullRequest.provider !== 'repository-command') {
480
+ throw new Error('native.finish.pull_request.provider must be repository-command');
481
+ }
482
+ if (!Array.isArray(pullRequest.command) || pullRequest.command.length === 0) {
483
+ throw new Error('native.finish.pull_request.command must be a non-empty array');
484
+ }
485
+ if (pullRequest.command.length > 64) {
486
+ throw new Error('native.finish.pull_request.command must contain at most 64 arguments');
487
+ }
488
+ const command = pullRequest.command.map((argument, index) => {
489
+ if (typeof argument !== 'string' ||
490
+ argument.trim().length === 0 ||
491
+ argument.length > 4096 ||
492
+ /[\0\r\n]/u.test(argument)) {
493
+ throw new Error(`native.finish.pull_request.command[${index}] must be a non-empty single-line string of at most 4096 characters`);
494
+ }
495
+ return argument;
496
+ });
497
+ if (path.posix.isAbsolute(command[0]) || path.win32.isAbsolute(command[0])) {
498
+ throw new Error('native.finish.pull_request.command[0] must be a bare executable name or a project-relative path');
499
+ }
500
+ const timeoutMs = pullRequest.timeout_ms ?? DEFAULT_WORKFLOW_NATIVE_PULL_REQUEST_FINISH_TIMEOUT_MS;
501
+ if (!Number.isSafeInteger(timeoutMs) ||
502
+ timeoutMs < 1 ||
503
+ timeoutMs > MAX_WORKFLOW_NATIVE_PULL_REQUEST_FINISH_TIMEOUT_MS) {
504
+ throw new Error(`native.finish.pull_request.timeout_ms must be an integer between 1 and ${MAX_WORKFLOW_NATIVE_PULL_REQUEST_FINISH_TIMEOUT_MS}`);
505
+ }
506
+ return {
507
+ pull_request: {
508
+ provider: 'repository-command',
509
+ command,
510
+ timeout_ms: timeoutMs,
511
+ },
512
+ };
513
+ }
514
+ function normalizeWorkflowNativeProjectConfig(value, options = {}) {
515
+ const native = projectConfigRecord(value, 'native');
516
+ const artifactRoot = native.artifact_root ?? (options.allowMissingArtifactRoot ? 'docs' : undefined);
517
+ if (typeof artifactRoot !== 'string') {
518
+ throw new Error('native.artifact_root must be a string');
519
+ }
520
+ const clarificationMode = native.clarification_mode ?? 'batch';
521
+ if (clarificationMode !== 'sequential' && clarificationMode !== 'batch') {
522
+ throw new Error('native.clarification_mode must be sequential or batch');
523
+ }
524
+ const archiveConfirmation = native.archive_confirmation ?? 'automatic';
525
+ if (archiveConfirmation !== 'automatic' && archiveConfirmation !== 'required') {
526
+ throw new Error('native.archive_confirmation must be automatic or required');
527
+ }
528
+ const maxVerifyFailures = native.max_verify_failures ?? DEFAULT_WORKFLOW_NATIVE_MAX_VERIFY_FAILURES;
529
+ if (!Number.isSafeInteger(maxVerifyFailures) || maxVerifyFailures < 1) {
530
+ throw new Error('native.max_verify_failures must be a positive integer');
531
+ }
532
+ const pending = normalizeWorkflowPendingRootMove(native.pending_root_move);
533
+ const finish = normalizeWorkflowNativeFinish(native.finish);
534
+ return {
535
+ artifact_root: normalizeWorkflowArtifactRoot(artifactRoot),
536
+ language: projectConfigLanguage(native.language, 'en', 'native.language'),
537
+ clarification_mode: clarificationMode,
538
+ archive_confirmation: archiveConfirmation,
539
+ max_verify_failures: maxVerifyFailures,
540
+ snapshot: normalizeWorkflowSnapshot(native.snapshot),
541
+ ...(finish ? { finish } : {}),
542
+ ...(pending ? { pending_root_move: pending } : {}),
543
+ };
544
+ }
545
+ function normalizeWorkflowClassicProjectConfig(value) {
546
+ const classic = projectConfigRecord(value, 'classic');
547
+ const contextCompression = classic.context_compression ?? 'off';
548
+ if (contextCompression !== 'off' && contextCompression !== 'beta') {
549
+ throw new Error('classic.context_compression must be off or beta');
550
+ }
551
+ const reviewMode = classic.review_mode ?? 'standard';
552
+ if (reviewMode !== 'off' && reviewMode !== 'standard' && reviewMode !== 'thorough') {
553
+ throw new Error('classic.review_mode must be off, standard, or thorough');
554
+ }
555
+ const autoTransition = classic.auto_transition ?? true;
556
+ if (typeof autoTransition !== 'boolean') {
557
+ throw new Error('classic.auto_transition must be true or false');
558
+ }
559
+ return {
560
+ artifact_layout: normalizeClassicArtifactLayout(classic.artifact_layout),
561
+ language: projectConfigLanguage(classic.language, 'zh-CN', 'classic.language'),
562
+ context_compression: contextCompression,
563
+ review_mode: reviewMode,
564
+ auto_transition: autoTransition,
565
+ };
566
+ }
567
+ function normalizeWorkflowHookProjectConfig(value) {
568
+ const hook = projectConfigRecord(value, 'hook');
569
+ const allowPaths = hook.allow_paths ?? [];
570
+ if (!Array.isArray(allowPaths)) {
571
+ throw new Error('hook.allow_paths must be an array');
572
+ }
573
+ return {
574
+ allow_paths: [
575
+ ...new Set(allowPaths.map((allowPath, index) => normalizeWorkflowRelativePath(allowPath, `hook.allow_paths[${index}]`))),
576
+ ],
577
+ };
578
+ }
579
+ function normalizeWorkflowMemoryProjectConfig(value) {
580
+ if (value === undefined) {
581
+ return { ...DEFAULT_WORKFLOW_MEMORY_PROJECT_CONFIG };
582
+ }
583
+ const memory = projectConfigRecord(value, 'memory');
584
+ const learning = memory.learning ?? DEFAULT_WORKFLOW_MEMORY_PROJECT_CONFIG.learning;
585
+ const retrieval = memory.retrieval ?? DEFAULT_WORKFLOW_MEMORY_PROJECT_CONFIG.retrieval;
586
+ if (typeof learning !== 'boolean') {
587
+ throw new Error('memory.learning must be true or false');
588
+ }
589
+ if (typeof retrieval !== 'boolean') {
590
+ throw new Error('memory.retrieval must be true or false');
591
+ }
592
+ return { learning, retrieval };
593
+ }
594
+ function projectKnowledgeRecord(value, label) {
595
+ if (value === null || typeof value !== 'object' || Array.isArray(value)) {
596
+ throw new Error(`${label} must be a mapping`);
597
+ }
598
+ return value;
599
+ }
600
+ function normalizeKnowledgeIncludePattern(value, label) {
601
+ if (typeof value !== 'string')
602
+ throw new Error(`${label} must be a string`);
603
+ const pattern = value.trim();
604
+ if (pattern.length === 0 ||
605
+ pattern.includes('\\') ||
606
+ pattern.includes('\0') ||
607
+ path.posix.isAbsolute(pattern) ||
608
+ path.win32.isAbsolute(pattern) ||
609
+ pattern.startsWith('~') ||
610
+ pattern.split('/').some((segment) => segment === '' || segment === '.' || segment === '..')) {
611
+ throw new Error(`${label} must be a safe project-relative glob`);
612
+ }
613
+ if (!pattern.toLowerCase().endsWith('.md')) {
614
+ throw new Error(`${label} must target a Markdown file ending in .md`);
615
+ }
616
+ if (pattern.length > MAX_WORKFLOW_KNOWLEDGE_INCLUDE_PATTERN_LENGTH) {
617
+ throw new Error(`${label} exceeds ${MAX_WORKFLOW_KNOWLEDGE_INCLUDE_PATTERN_LENGTH} characters`);
618
+ }
619
+ let wildcardTokens = 0;
620
+ for (let index = 0; index < pattern.length; index += 1) {
621
+ if (pattern[index] === '?') {
622
+ wildcardTokens += 1;
623
+ }
624
+ else if (pattern[index] === '*') {
625
+ wildcardTokens += 1;
626
+ if (pattern[index + 1] === '*')
627
+ index += 1;
628
+ }
629
+ }
630
+ if (wildcardTokens > MAX_WORKFLOW_KNOWLEDGE_INCLUDE_PATTERN_WILDCARDS) {
631
+ throw new Error(`${label} contains more than ${MAX_WORKFLOW_KNOWLEDGE_INCLUDE_PATTERN_WILDCARDS} wildcard tokens`);
632
+ }
633
+ return pattern;
634
+ }
635
+ function normalizeKnowledgeLocal(value) {
636
+ const local = projectKnowledgeRecord(value, 'knowledge.local');
637
+ const include = local.include ?? [];
638
+ if (!Array.isArray(include))
639
+ throw new Error('knowledge.local.include must be an array');
640
+ return {
641
+ include: [
642
+ ...new Set(include.map((pattern, index) => normalizeKnowledgeIncludePattern(pattern, `knowledge.local.include[${index}]`))),
643
+ ],
644
+ };
645
+ }
646
+ function normalizeKnowledgeEndpoint(value) {
647
+ if (typeof value !== 'string' || value.trim().length === 0) {
648
+ throw new Error('knowledge.remote.endpoint must be a non-empty URL');
649
+ }
650
+ let url;
81
651
  try {
82
- source = await fs.readFile(file, 'utf8');
652
+ url = new URL(value);
83
653
  }
84
- catch (error) {
85
- if (error.code === 'ENOENT')
86
- return true;
87
- throw error;
654
+ catch {
655
+ throw new Error('knowledge.remote.endpoint must be a valid URL');
88
656
  }
89
- if (Buffer.byteLength(source) > 64 * 1024) {
90
- throw new Error('.comet/config.yaml exceeds 65536 bytes');
657
+ const hostname = url.hostname.toLowerCase().replace(/^\[|\]$/gu, '');
658
+ const loopback = hostname === 'localhost' || hostname === '127.0.0.1' || hostname === '::1';
659
+ if (url.protocol !== 'https:' && !(url.protocol === 'http:' && loopback)) {
660
+ throw new Error('knowledge.remote.endpoint must use HTTPS (HTTP is allowed for loopback)');
661
+ }
662
+ return url.toString();
663
+ }
664
+ function normalizeKnowledgeRemote(value) {
665
+ const remote = projectKnowledgeRecord(value, 'knowledge.remote');
666
+ const endpoint = normalizeKnowledgeEndpoint(remote.endpoint);
667
+ const tokenEnv = remote.token_env;
668
+ if (tokenEnv !== undefined &&
669
+ (typeof tokenEnv !== 'string' || !/^[A-Za-z_][A-Za-z0-9_]*$/u.test(tokenEnv))) {
670
+ throw new Error('knowledge.remote.token_env must be an environment variable name');
91
671
  }
672
+ const scope = remote.scope;
673
+ if (scope !== undefined && (typeof scope !== 'string' || scope.length > 512)) {
674
+ throw new Error('knowledge.remote.scope must be a string of at most 512 characters');
675
+ }
676
+ const timeout = remote.timeout_ms ?? 5000;
677
+ if (typeof timeout !== 'number' ||
678
+ !Number.isSafeInteger(timeout) ||
679
+ timeout < 100 ||
680
+ timeout > 30000) {
681
+ throw new Error('knowledge.remote.timeout_ms must be an integer between 100 and 30000');
682
+ }
683
+ return {
684
+ endpoint,
685
+ ...(tokenEnv === undefined ? {} : { token_env: tokenEnv }),
686
+ ...(scope === undefined ? {} : { scope }),
687
+ timeout_ms: timeout,
688
+ };
689
+ }
690
+ function normalizeWorkflowKnowledgeProjectConfig(value) {
691
+ if (value === undefined)
692
+ return { ...DEFAULT_WORKFLOW_KNOWLEDGE_PROJECT_CONFIG };
693
+ const knowledge = projectKnowledgeRecord(value, 'knowledge');
694
+ const provider = knowledge.provider ?? 'local';
695
+ if (provider !== 'local' && provider !== 'remote') {
696
+ throw new Error('knowledge.provider must be local or remote');
697
+ }
698
+ const local = knowledge.local === undefined ? undefined : normalizeKnowledgeLocal(knowledge.local);
699
+ if (provider === 'local')
700
+ return { provider, ...(local ? { local } : {}) };
701
+ const remote = knowledge.remote === undefined ? undefined : normalizeKnowledgeRemote(knowledge.remote);
702
+ if (remote === undefined) {
703
+ throw new Error('knowledge.remote must be configured when knowledge.provider is remote');
704
+ }
705
+ return { provider, ...(local ? { local } : {}), remote };
706
+ }
707
+ function normalizeAmbientResume(value) {
708
+ const resolved = value ?? true;
709
+ if (typeof resolved !== 'boolean') {
710
+ throw new Error('ambient_resume must be true or false');
711
+ }
712
+ return resolved;
713
+ }
714
+ function normalizeWorkflowProjectConfig(root, hook, memory, knowledge, native, classic, ambientResume, options) {
715
+ const hasSchema = root.schema !== undefined;
716
+ const hasProjectMarker = hasSchema ||
717
+ root.default_workflow !== undefined ||
718
+ root.workflows !== undefined ||
719
+ (!options.allowPartialProject && root.native !== undefined);
720
+ if (!hasProjectMarker)
721
+ return null;
722
+ if (options.allowPartialProject && !hasSchema)
723
+ return null;
724
+ if (root.schema !== 'comet.project.v1') {
725
+ throw new Error('Unsupported Comet project schema');
726
+ }
727
+ if (root.default_workflow !== 'native' && root.default_workflow !== 'classic') {
728
+ throw new Error('default_workflow must be native or classic');
729
+ }
730
+ const configuredWorkflows = root.workflows ?? [root.default_workflow];
731
+ if (!Array.isArray(configuredWorkflows) ||
732
+ configuredWorkflows.length === 0 ||
733
+ configuredWorkflows.some((workflow) => workflow !== 'native' && workflow !== 'classic')) {
734
+ throw new Error('workflows must contain native and/or classic');
735
+ }
736
+ const workflows = [...new Set(configuredWorkflows)];
737
+ if (!workflows.includes(root.default_workflow)) {
738
+ throw new Error('workflows must include default_workflow');
739
+ }
740
+ if (workflows.includes('native') && !native) {
741
+ throw new Error('native must be a mapping');
742
+ }
743
+ return {
744
+ schema: 'comet.project.v1',
745
+ default_workflow: root.default_workflow,
746
+ workflows,
747
+ ambient_resume: ambientResume,
748
+ ...(hook ? { hook } : {}),
749
+ memory,
750
+ knowledge,
751
+ ...(native ? { native } : {}),
752
+ ...(classic ? { classic } : {}),
753
+ };
754
+ }
755
+ /**
756
+ * Parse one project-config YAML document exactly once. Missing fields may use
757
+ * their runtime defaults, but malformed YAML, duplicate keys, and invalid
758
+ * managed values fail closed. Unknown fields remain in `value` for round trips.
759
+ */
760
+ export function parseWorkflowProjectConfigDocument(source, options = {}) {
92
761
  const document = parseDocument(source, { uniqueKeys: true });
93
762
  if (document.errors.length > 0) {
94
763
  throw new Error(`Invalid .comet/config.yaml: ${document.errors[0].message}`);
95
764
  }
96
- const value = document.toJS();
97
- if (value === null || value === undefined)
98
- return true;
99
- if (typeof value !== 'object' || Array.isArray(value)) {
765
+ const parsed = document.toJS();
766
+ if (parsed === null || parsed === undefined) {
767
+ return { value: {}, config: null, ambient_resume: true };
768
+ }
769
+ if (typeof parsed !== 'object' || Array.isArray(parsed)) {
100
770
  throw new Error('Invalid .comet/config.yaml: root must be a mapping');
101
771
  }
102
- const configured = value.ambient_resume;
103
- if (configured === undefined)
104
- return true;
105
- if (typeof configured !== 'boolean') {
106
- throw new Error('ambient_resume must be true or false');
772
+ const value = parsed;
773
+ const ambientResume = normalizeAmbientResume(value.ambient_resume);
774
+ const hook = value.hook === undefined ? undefined : normalizeWorkflowHookProjectConfig(value.hook);
775
+ const memory = normalizeWorkflowMemoryProjectConfig(value.memory);
776
+ const knowledge = normalizeWorkflowKnowledgeProjectConfig(value.knowledge);
777
+ const native = value.native === undefined
778
+ ? undefined
779
+ : normalizeWorkflowNativeProjectConfig(value.native, {
780
+ allowMissingArtifactRoot: options.allowMissingNativeFields,
781
+ });
782
+ const classic = value.classic === undefined ? undefined : normalizeWorkflowClassicProjectConfig(value.classic);
783
+ const config = normalizeWorkflowProjectConfig(value, hook, memory, knowledge, native, classic, ambientResume, {
784
+ allowPartialProject: options.allowPartialProject ?? false,
785
+ });
786
+ return {
787
+ value,
788
+ config,
789
+ ambient_resume: ambientResume,
790
+ memory,
791
+ knowledge,
792
+ ...(hook ? { hook } : {}),
793
+ ...(native ? { native } : {}),
794
+ ...(classic ? { classic } : {}),
795
+ };
796
+ }
797
+ function workflowPendingRootMoveValue(pending) {
798
+ return {
799
+ id: pending.id,
800
+ from_artifact_root: pending.fromArtifactRoot,
801
+ to_artifact_root: pending.toArtifactRoot,
802
+ stage: pending.stage,
803
+ ...(pending.cleanup
804
+ ? {
805
+ cleanup: {
806
+ kind: pending.cleanup.kind,
807
+ state: pending.cleanup.state,
808
+ manifest_hash: pending.cleanup.manifestHash,
809
+ },
810
+ }
811
+ : {}),
812
+ };
813
+ }
814
+ export function workflowProjectConfigManagedValue(config) {
815
+ const knowledge = config.knowledge ?? { ...DEFAULT_WORKFLOW_KNOWLEDGE_PROJECT_CONFIG };
816
+ return {
817
+ schema: config.schema,
818
+ default_workflow: config.default_workflow,
819
+ workflows: config.workflows ?? [config.default_workflow],
820
+ ambient_resume: config.ambient_resume,
821
+ memory: config.memory ?? { ...DEFAULT_WORKFLOW_MEMORY_PROJECT_CONFIG },
822
+ knowledge: {
823
+ provider: knowledge.provider,
824
+ ...(knowledge.local && knowledge.local.include.length > 0
825
+ ? { local: { include: [...knowledge.local.include] } }
826
+ : {}),
827
+ ...(knowledge.remote
828
+ ? {
829
+ remote: {
830
+ endpoint: knowledge.remote.endpoint,
831
+ timeout_ms: knowledge.remote.timeout_ms,
832
+ ...(knowledge.remote.token_env === undefined
833
+ ? {}
834
+ : { token_env: knowledge.remote.token_env }),
835
+ ...(knowledge.remote.scope === undefined ? {} : { scope: knowledge.remote.scope }),
836
+ },
837
+ }
838
+ : {}),
839
+ },
840
+ ...(config.hook
841
+ ? {
842
+ hook: {
843
+ allow_paths: [...config.hook.allow_paths],
844
+ },
845
+ }
846
+ : {}),
847
+ ...(config.native
848
+ ? {
849
+ native: {
850
+ artifact_root: config.native.artifact_root,
851
+ language: config.native.language,
852
+ clarification_mode: config.native.clarification_mode,
853
+ archive_confirmation: config.native.archive_confirmation,
854
+ max_verify_failures: config.native.max_verify_failures,
855
+ ...(config.native.finish?.pull_request
856
+ ? {
857
+ finish: {
858
+ pull_request: {
859
+ provider: config.native.finish.pull_request.provider,
860
+ command: [...config.native.finish.pull_request.command],
861
+ timeout_ms: config.native.finish.pull_request.timeout_ms,
862
+ },
863
+ },
864
+ }
865
+ : {}),
866
+ ...(config.native.pending_root_move
867
+ ? {
868
+ pending_root_move: workflowPendingRootMoveValue(config.native.pending_root_move),
869
+ }
870
+ : {}),
871
+ },
872
+ }
873
+ : {}),
874
+ ...(config.classic
875
+ ? {
876
+ classic: {
877
+ artifact_layout: config.classic.artifact_layout,
878
+ language: config.classic.language,
879
+ context_compression: config.classic.context_compression,
880
+ review_mode: config.classic.review_mode,
881
+ auto_transition: config.classic.auto_transition,
882
+ },
883
+ }
884
+ : {}),
885
+ };
886
+ }
887
+ function optionalRecord(value) {
888
+ return value && typeof value === 'object' && !Array.isArray(value)
889
+ ? value
890
+ : {};
891
+ }
892
+ export function mergeWorkflowProjectConfigDocument(existing, config) {
893
+ const managed = workflowProjectConfigManagedValue(config);
894
+ const validated = parseWorkflowProjectConfigDocument(stringify(managed)).config;
895
+ if (!validated)
896
+ throw new Error('Unsupported Comet project schema');
897
+ const output = {
898
+ ...existing,
899
+ schema: validated.schema,
900
+ default_workflow: validated.default_workflow,
901
+ workflows: validated.workflows,
902
+ ambient_resume: validated.ambient_resume,
903
+ };
904
+ if (validated.hook) {
905
+ output.hook = {
906
+ ...optionalRecord(existing.hook),
907
+ allow_paths: [...validated.hook.allow_paths],
908
+ };
909
+ }
910
+ if (validated.memory) {
911
+ const existingMemory = optionalRecord(existing.memory);
912
+ output.memory = {
913
+ ...existingMemory,
914
+ learning: validated.memory.learning,
915
+ retrieval: validated.memory.retrieval,
916
+ };
917
+ }
918
+ if (validated.knowledge) {
919
+ const existingKnowledge = optionalRecord(existing.knowledge);
920
+ const knowledge = {
921
+ ...existingKnowledge,
922
+ provider: validated.knowledge.provider,
923
+ };
924
+ if (validated.knowledge.local && validated.knowledge.local.include.length > 0) {
925
+ knowledge.local = {
926
+ ...optionalRecord(existingKnowledge.local),
927
+ include: [...validated.knowledge.local.include],
928
+ };
929
+ }
930
+ else {
931
+ delete knowledge.local;
932
+ }
933
+ if (validated.knowledge.remote) {
934
+ const existingRemote = optionalRecord(existingKnowledge.remote);
935
+ const remote = {
936
+ ...existingRemote,
937
+ endpoint: validated.knowledge.remote.endpoint,
938
+ timeout_ms: validated.knowledge.remote.timeout_ms,
939
+ ...(validated.knowledge.remote.token_env === undefined
940
+ ? {}
941
+ : { token_env: validated.knowledge.remote.token_env }),
942
+ ...(validated.knowledge.remote.scope === undefined
943
+ ? {}
944
+ : { scope: validated.knowledge.remote.scope }),
945
+ };
946
+ if (validated.knowledge.remote.token_env === undefined)
947
+ delete remote.token_env;
948
+ if (validated.knowledge.remote.scope === undefined)
949
+ delete remote.scope;
950
+ knowledge.remote = remote;
951
+ }
952
+ else {
953
+ delete knowledge.remote;
954
+ }
955
+ output.knowledge = knowledge;
956
+ }
957
+ if (validated.native) {
958
+ const existingNative = optionalRecord(existing.native);
959
+ const native = {
960
+ ...existingNative,
961
+ artifact_root: validated.native.artifact_root,
962
+ language: validated.native.language,
963
+ clarification_mode: validated.native.clarification_mode,
964
+ archive_confirmation: validated.native.archive_confirmation,
965
+ max_verify_failures: validated.native.max_verify_failures,
966
+ };
967
+ if (validated.native.finish?.pull_request) {
968
+ const existingFinish = optionalRecord(existingNative.finish);
969
+ native.finish = {
970
+ ...existingFinish,
971
+ pull_request: {
972
+ ...optionalRecord(existingFinish.pull_request),
973
+ provider: validated.native.finish.pull_request.provider,
974
+ command: [...validated.native.finish.pull_request.command],
975
+ timeout_ms: validated.native.finish.pull_request.timeout_ms,
976
+ },
977
+ };
978
+ }
979
+ else {
980
+ const remainingFinish = { ...optionalRecord(existingNative.finish) };
981
+ delete remainingFinish.pull_request;
982
+ if (Object.keys(remainingFinish).length > 0)
983
+ native.finish = remainingFinish;
984
+ else
985
+ delete native.finish;
986
+ }
987
+ // Snapshot settings are retained by the parser as a legacy v1-v3 runtime
988
+ // default, but Native v4 no longer persists them in user configuration.
989
+ delete native.snapshot;
990
+ if (validated.native.pending_root_move) {
991
+ const existingPending = optionalRecord(existingNative.pending_root_move);
992
+ const pending = workflowPendingRootMoveValue(validated.native.pending_root_move);
993
+ const existingCleanup = optionalRecord(existingPending.cleanup);
994
+ const managedCleanup = optionalRecord(pending.cleanup);
995
+ native.pending_root_move = {
996
+ ...existingPending,
997
+ ...pending,
998
+ ...(pending.cleanup ? { cleanup: { ...existingCleanup, ...managedCleanup } } : {}),
999
+ };
1000
+ }
1001
+ else {
1002
+ delete native.pending_root_move;
1003
+ }
1004
+ output.native = native;
1005
+ }
1006
+ if (validated.classic) {
1007
+ output.classic = {
1008
+ ...optionalRecord(existing.classic),
1009
+ artifact_layout: validated.classic.artifact_layout,
1010
+ language: validated.classic.language,
1011
+ context_compression: validated.classic.context_compression,
1012
+ review_mode: validated.classic.review_mode,
1013
+ auto_transition: validated.classic.auto_transition,
1014
+ };
1015
+ }
1016
+ return output;
1017
+ }
1018
+ export function defaultWorkflowProjectConfig(artifactRoot = 'docs', language = 'en') {
1019
+ return {
1020
+ schema: 'comet.project.v1',
1021
+ default_workflow: 'native',
1022
+ ambient_resume: true,
1023
+ memory: { ...DEFAULT_WORKFLOW_MEMORY_PROJECT_CONFIG },
1024
+ knowledge: { ...DEFAULT_WORKFLOW_KNOWLEDGE_PROJECT_CONFIG },
1025
+ native: {
1026
+ artifact_root: normalizeWorkflowArtifactRoot(artifactRoot),
1027
+ language,
1028
+ clarification_mode: 'batch',
1029
+ archive_confirmation: 'automatic',
1030
+ max_verify_failures: DEFAULT_WORKFLOW_NATIVE_MAX_VERIFY_FAILURES,
1031
+ snapshot: {
1032
+ ...DEFAULT_WORKFLOW_NATIVE_SNAPSHOT_CONFIG,
1033
+ include: [...DEFAULT_WORKFLOW_NATIVE_SNAPSHOT_CONFIG.include],
1034
+ exclude: [...DEFAULT_WORKFLOW_NATIVE_SNAPSHOT_CONFIG.exclude],
1035
+ },
1036
+ },
1037
+ };
1038
+ }
1039
+ /**
1040
+ * Dependency-free counterpart used by generated workflow runtimes. Keep its
1041
+ * path and enum checks behaviorally aligned with the typed helpers above.
1042
+ */
1043
+ export function workflowProjectConfigRuntimeHelperScript() {
1044
+ return String.raw `
1045
+ const WORKFLOW_PROJECT_CONFIG_MAX_BYTES = 64 * 1024;
1046
+ const WORKFLOW_PROJECT_FILE_MAX_BYTES = 2 * 1024 * 1024;
1047
+
1048
+ function workflowProjectRelativeSegments(value, label) {
1049
+ if (typeof value !== 'string') throw new Error(label + ' must be a string');
1050
+ const trimmed = value.trim();
1051
+ if (
1052
+ trimmed.length === 0 ||
1053
+ path.posix.isAbsolute(trimmed) ||
1054
+ path.win32.isAbsolute(trimmed) ||
1055
+ trimmed.startsWith('~') ||
1056
+ trimmed.startsWith('/') ||
1057
+ trimmed.startsWith('\\')
1058
+ ) {
1059
+ throw new Error(label + ' must be a project-relative path');
1060
+ }
1061
+ if (trimmed === '.') return [];
1062
+ const segments = trimmed.replaceAll('\\', '/').split('/');
1063
+ if (segments.some((segment) => segment === '..')) {
1064
+ throw new Error(label + ' must stay inside the project root');
1065
+ }
1066
+ if (segments.some((segment) => segment === '' || segment === '.')) {
1067
+ throw new Error(label + ' must not contain empty or dot path segments');
1068
+ }
1069
+ return segments;
1070
+ }
1071
+
1072
+ function normalizeWorkflowArtifactRoot(value) {
1073
+ const segments = workflowProjectRelativeSegments(value, 'native.artifact_root');
1074
+ return segments.length === 0 ? '.' : segments.join('/');
1075
+ }
1076
+
1077
+ function normalizeClassicArtifactLayout(value, fallback = 'docs') {
1078
+ const resolved = value ?? fallback;
1079
+ if (resolved !== 'legacy' && resolved !== 'docs') {
1080
+ throw new Error('classic.artifact_layout must be legacy or docs');
1081
+ }
1082
+ return resolved;
1083
+ }
1084
+
1085
+ function normalizeWorkflowMemoryProjectConfig(value) {
1086
+ const memory = value === undefined ? {} : workflowConfigRecord(value, 'memory');
1087
+ const learning = memory.learning ?? true;
1088
+ const retrieval = memory.retrieval ?? true;
1089
+ if (typeof learning !== 'boolean') {
1090
+ throw new Error('memory.learning must be true or false');
1091
+ }
1092
+ if (typeof retrieval !== 'boolean') {
1093
+ throw new Error('memory.retrieval must be true or false');
1094
+ }
1095
+ return { learning, retrieval };
1096
+ }
1097
+
1098
+ function normalizeWorkflowKnowledgeIncludePattern(value, label) {
1099
+ if (typeof value !== 'string') throw new Error(label + ' must be a string');
1100
+ const pattern = value.trim();
1101
+ if (
1102
+ pattern.length === 0 ||
1103
+ pattern.includes('\\') ||
1104
+ pattern.includes('\0') ||
1105
+ path.posix.isAbsolute(pattern) ||
1106
+ path.win32.isAbsolute(pattern) ||
1107
+ pattern.startsWith('~') ||
1108
+ pattern.split('/').some((segment) => segment === '' || segment === '.' || segment === '..')
1109
+ ) {
1110
+ throw new Error(label + ' must be a safe project-relative glob');
1111
+ }
1112
+ if (!pattern.toLowerCase().endsWith('.md')) {
1113
+ throw new Error(label + ' must target a Markdown file ending in .md');
1114
+ }
1115
+ if (pattern.length > 1024) throw new Error(label + ' exceeds 1024 characters');
1116
+ let wildcardTokens = 0;
1117
+ for (let index = 0; index < pattern.length; index += 1) {
1118
+ if (pattern[index] === '?') wildcardTokens += 1;
1119
+ else if (pattern[index] === '*') {
1120
+ wildcardTokens += 1;
1121
+ if (pattern[index + 1] === '*') index += 1;
1122
+ }
1123
+ }
1124
+ if (wildcardTokens > 64) throw new Error(label + ' contains more than 64 wildcard tokens');
1125
+ return pattern;
1126
+ }
1127
+
1128
+ function normalizeWorkflowKnowledgeLocal(value) {
1129
+ const local = workflowConfigRecord(value, 'knowledge.local');
1130
+ const include = local.include ?? [];
1131
+ if (!Array.isArray(include)) throw new Error('knowledge.local.include must be an array');
1132
+ return {
1133
+ include: [...new Set(include.map((pattern, index) => normalizeWorkflowKnowledgeIncludePattern(pattern, 'knowledge.local.include[' + index + ']')))],
1134
+ };
1135
+ }
1136
+
1137
+ function normalizeWorkflowKnowledgeProjectConfig(value) {
1138
+ if (value === undefined) return { provider: 'local' };
1139
+ const knowledge = workflowConfigRecord(value, 'knowledge');
1140
+ const provider = knowledge.provider ?? 'local';
1141
+ if (provider !== 'local' && provider !== 'remote') {
1142
+ throw new Error('knowledge.provider must be local or remote');
1143
+ }
1144
+ const local = knowledge.local === undefined ? undefined : normalizeWorkflowKnowledgeLocal(knowledge.local);
1145
+ if (provider === 'local') return { provider, ...(local === undefined ? {} : { local }) };
1146
+ if (knowledge.remote === undefined) throw new Error('knowledge.remote must be configured when knowledge.provider is remote');
1147
+ const remote = workflowConfigRecord(knowledge.remote, 'knowledge.remote');
1148
+ if (typeof remote.endpoint !== 'string' || remote.endpoint.trim().length === 0) {
1149
+ throw new Error('knowledge.remote.endpoint must be a non-empty URL');
1150
+ }
1151
+ let endpoint;
1152
+ try { endpoint = new URL(remote.endpoint); } catch { throw new Error('knowledge.remote.endpoint must be a valid URL'); }
1153
+ const loopback = ['localhost', '127.0.0.1', '::1'].includes(endpoint.hostname.toLowerCase().replace(/^\[|\]$/gu, ''));
1154
+ if (endpoint.protocol !== 'https:' && !(endpoint.protocol === 'http:' && loopback)) {
1155
+ throw new Error('knowledge.remote.endpoint must use HTTPS (HTTP is allowed for loopback)');
1156
+ }
1157
+ const timeout = remote.timeout_ms ?? 5000;
1158
+ if (!Number.isSafeInteger(timeout) || timeout < 100 || timeout > 30000) {
1159
+ throw new Error('knowledge.remote.timeout_ms must be an integer between 100 and 30000');
1160
+ }
1161
+ if (remote.token_env !== undefined && (typeof remote.token_env !== 'string' || !/^[A-Za-z_][A-Za-z0-9_]*$/u.test(remote.token_env))) {
1162
+ throw new Error('knowledge.remote.token_env must be an environment variable name');
1163
+ }
1164
+ if (remote.scope !== undefined && (typeof remote.scope !== 'string' || remote.scope.length > 512)) {
1165
+ throw new Error('knowledge.remote.scope must be a string of at most 512 characters');
1166
+ }
1167
+ return {
1168
+ provider,
1169
+ ...(local === undefined ? {} : { local }),
1170
+ remote: {
1171
+ endpoint: endpoint.toString(),
1172
+ timeout_ms: timeout,
1173
+ ...(remote.token_env === undefined ? {} : { token_env: remote.token_env }),
1174
+ ...(remote.scope === undefined ? {} : { scope: remote.scope }),
1175
+ },
1176
+ };
1177
+ }
1178
+
1179
+ function workflowPathInside(root, target) {
1180
+ const relative = path.relative(root, target);
1181
+ return (
1182
+ relative === '' ||
1183
+ (!path.isAbsolute(relative) &&
1184
+ relative !== '..' &&
1185
+ !relative.startsWith('..' + path.sep))
1186
+ );
1187
+ }
1188
+
1189
+ async function inspectWorkflowProtectedPath(
1190
+ projectRoot,
1191
+ target,
1192
+ label,
1193
+ expected = 'any',
1194
+ ) {
1195
+ const lexicalRoot = path.resolve(projectRoot);
1196
+ const lexicalTarget = path.resolve(target);
1197
+ if (!workflowPathInside(lexicalRoot, lexicalTarget)) {
1198
+ throw new Error(label + ' must stay inside the project root');
1199
+ }
1200
+ const rootStat = await fs.lstat(lexicalRoot);
1201
+ if (!rootStat.isDirectory() || rootStat.isSymbolicLink()) {
1202
+ throw new Error(label + ' project root must be a real directory');
1203
+ }
1204
+ const realRoot = await fs.realpath(lexicalRoot);
1205
+ const relative = path.relative(lexicalRoot, lexicalTarget);
1206
+ const segments = relative === '' ? [] : relative.split(path.sep);
1207
+ let cursor = lexicalRoot;
1208
+ for (let index = 0; index < segments.length; index++) {
1209
+ cursor = path.join(cursor, segments[index]);
1210
+ let stat;
1211
+ try {
1212
+ stat = await fs.lstat(cursor);
1213
+ } catch (error) {
1214
+ if (
1215
+ error &&
1216
+ typeof error === 'object' &&
1217
+ (error.code === 'ENOENT' || error.code === 'ENOTDIR')
1218
+ ) {
1219
+ return { target: lexicalTarget, exists: false };
1220
+ }
1221
+ throw error;
1222
+ }
1223
+ const display = path.relative(lexicalRoot, cursor).replaceAll('\\', '/');
1224
+ if (stat.isSymbolicLink()) {
1225
+ throw new Error(label + ' crosses a symbolic link or junction at ' + display);
1226
+ }
1227
+ const final = index === segments.length - 1;
1228
+ if (!final && !stat.isDirectory()) {
1229
+ throw new Error(label + ' ancestor ' + display + ' must be a real directory');
1230
+ }
1231
+ if (
1232
+ final &&
1233
+ ((expected === 'file' && !stat.isFile()) ||
1234
+ (expected === 'directory' && !stat.isDirectory()) ||
1235
+ (expected === 'any' && !stat.isFile() && !stat.isDirectory()))
1236
+ ) {
1237
+ throw new Error(label + ' must be a real ' + expected);
1238
+ }
1239
+ const physical = await fs.realpath(cursor);
1240
+ if (!workflowPathInside(realRoot, physical)) {
1241
+ throw new Error(label + ' resolves outside the project root');
1242
+ }
1243
+ }
1244
+ return { target: lexicalTarget, exists: true };
1245
+ }
1246
+
1247
+ function workflowFileObjectIdentity(stat) {
1248
+ return {
1249
+ dev: stat.dev,
1250
+ ino: stat.ino,
1251
+ birthtime: typeof stat.birthtimeNs === 'bigint' ? stat.birthtimeNs : stat.birthtimeMs,
1252
+ };
1253
+ }
1254
+
1255
+ function workflowHasIdentity(value) {
1256
+ return value !== 0 && value !== 0n && value !== '0';
1257
+ }
1258
+
1259
+ function workflowSameFileObject(left, right) {
1260
+ const comparableDevice = workflowHasIdentity(left.dev) && workflowHasIdentity(right.dev);
1261
+ const comparableInode = workflowHasIdentity(left.ino) && workflowHasIdentity(right.ino);
1262
+ if (comparableDevice && left.dev !== right.dev) return false;
1263
+ if (comparableInode && left.ino !== right.ino) return false;
1264
+ if (comparableDevice && comparableInode) return true;
1265
+ return left.birthtime === right.birthtime;
1266
+ }
1267
+
1268
+ function workflowSameFileStat(left, right) {
1269
+ return (
1270
+ workflowSameFileObject(
1271
+ workflowFileObjectIdentity(left),
1272
+ workflowFileObjectIdentity(right),
1273
+ ) &&
1274
+ left.size === right.size &&
1275
+ left.ctimeNs === right.ctimeNs
1276
+ );
1277
+ }
1278
+
1279
+ async function readWorkflowProtectedFile(
1280
+ projectRoot,
1281
+ file,
1282
+ label,
1283
+ maxBytes,
1284
+ hooks = {},
1285
+ ) {
1286
+ if (!Number.isSafeInteger(maxBytes) || maxBytes < 1) {
1287
+ throw new Error(label + ' byte limit must be a positive integer');
1288
+ }
1289
+ const inspection = await inspectWorkflowProtectedPath(
1290
+ projectRoot,
1291
+ file,
1292
+ label,
1293
+ 'file',
1294
+ );
1295
+ if (!inspection.exists) {
1296
+ const error = new Error(label + ' does not exist');
1297
+ error.code = 'ENOENT';
1298
+ throw error;
1299
+ }
1300
+ const before = await fs.lstat(file, { bigint: true });
1301
+ if (!before.isFile() || before.isSymbolicLink()) {
1302
+ throw new Error(label + ' must be a real file');
1303
+ }
1304
+ if (before.size > BigInt(maxBytes)) {
1305
+ throw new Error(label + ' exceeds ' + String(maxBytes) + ' bytes');
1306
+ }
1307
+ const beforeRealPath = await fs.realpath(file);
1308
+ await hooks.afterLstat?.();
1309
+ const flags =
1310
+ process.platform === 'win32'
1311
+ ? fsConstants.O_RDONLY
1312
+ : fsConstants.O_RDONLY | fsConstants.O_NOFOLLOW | fsConstants.O_NONBLOCK;
1313
+ let handle;
1314
+ try {
1315
+ handle = await fs.open(file, flags);
1316
+ } catch (error) {
1317
+ if (error && typeof error === 'object' && error.code === 'ELOOP') {
1318
+ throw new Error(label + ' must be a real file');
1319
+ }
1320
+ throw error;
1321
+ }
1322
+ try {
1323
+ const [opened, afterOpen, afterOpenRealPath] = await Promise.all([
1324
+ handle.stat({ bigint: true }),
1325
+ fs.lstat(file, { bigint: true }),
1326
+ fs.realpath(file),
1327
+ ]);
1328
+ if (
1329
+ !opened.isFile() ||
1330
+ !afterOpen.isFile() ||
1331
+ afterOpen.isSymbolicLink() ||
1332
+ afterOpenRealPath !== beforeRealPath ||
1333
+ !workflowSameFileStat(before, opened) ||
1334
+ !workflowSameFileStat(before, afterOpen)
1335
+ ) {
1336
+ throw new Error(label + ' changed while opening');
1337
+ }
1338
+ await inspectWorkflowProtectedPath(projectRoot, file, label, 'file');
1339
+ await hooks.afterOpen?.();
1340
+ const chunks = [];
1341
+ let total = 0;
1342
+ const buffer = Buffer.allocUnsafe(Math.min(64 * 1024, maxBytes + 1));
1343
+ for (;;) {
1344
+ const remaining = maxBytes + 1 - total;
1345
+ const { bytesRead } = await handle.read(
1346
+ buffer,
1347
+ 0,
1348
+ Math.min(buffer.length, remaining),
1349
+ null,
1350
+ );
1351
+ if (bytesRead === 0) break;
1352
+ total += bytesRead;
1353
+ if (total > maxBytes) {
1354
+ throw new Error(label + ' exceeds ' + String(maxBytes) + ' bytes');
1355
+ }
1356
+ chunks.push(Buffer.from(buffer.subarray(0, bytesRead)));
1357
+ }
1358
+ await hooks.beforeFinalCheck?.();
1359
+ const [afterHandle, afterPath, afterRealPath] = await Promise.all([
1360
+ handle.stat({ bigint: true }),
1361
+ fs.lstat(file, { bigint: true }),
1362
+ fs.realpath(file),
1363
+ ]);
1364
+ if (
1365
+ !afterPath.isFile() ||
1366
+ afterPath.isSymbolicLink() ||
1367
+ afterRealPath !== beforeRealPath ||
1368
+ !workflowSameFileStat(before, afterHandle) ||
1369
+ !workflowSameFileStat(before, afterPath)
1370
+ ) {
1371
+ throw new Error(label + ' changed while reading');
1372
+ }
1373
+ await inspectWorkflowProtectedPath(projectRoot, file, label, 'file');
1374
+ return Buffer.concat(chunks, total);
1375
+ } finally {
1376
+ await handle.close();
1377
+ }
1378
+ }
1379
+
1380
+ function workflowRelativeSegments(value, label, allowWildcards = false) {
1381
+ if (typeof value !== 'string') throw new Error(label + ' must be a string');
1382
+ const trimmed = value.trim().replaceAll('\\', '/');
1383
+ if (
1384
+ trimmed.length === 0 ||
1385
+ path.posix.isAbsolute(trimmed) ||
1386
+ path.win32.isAbsolute(trimmed) ||
1387
+ trimmed.startsWith('~') ||
1388
+ trimmed.startsWith('/') ||
1389
+ trimmed.startsWith('\\')
1390
+ ) {
1391
+ throw new Error(label + ' must be relative to its declared path base');
1392
+ }
1393
+ const segments = trimmed.split('/');
1394
+ if (segments.some((segment) => segment === '..')) {
1395
+ const boundary = label === 'workflow-run statePath' ? 'the project root' : 'its declared path base';
1396
+ throw new Error(label + ' must stay inside ' + boundary);
1397
+ }
1398
+ if (segments.some((segment) => segment === '' || segment === '.')) {
1399
+ throw new Error(label + ' must not contain empty or dot path segments');
1400
+ }
1401
+ if (!allowWildcards && (trimmed.includes('*') || trimmed.includes('?'))) {
1402
+ throw new Error(label + ' cannot contain wildcards');
1403
+ }
1404
+ return segments;
1405
+ }
1406
+
1407
+ function workflowYamlError(message, line) {
1408
+ const suffix = Number.isInteger(line) ? ' at line ' + String(line) : '';
1409
+ throw new Error('Invalid .comet/config.yaml: ' + message + suffix);
1410
+ }
1411
+
1412
+ function workflowYamlStripComment(value) {
1413
+ let quote = null;
1414
+ for (let index = 0; index < value.length; index++) {
1415
+ const character = value[index];
1416
+ if (quote) {
1417
+ if (quote === "'" && character === "'" && value[index + 1] === "'") {
1418
+ index++;
1419
+ continue;
1420
+ }
1421
+ if (character === quote) {
1422
+ quote = null;
1423
+ } else if (quote === '"' && character === '\\') {
1424
+ index++;
1425
+ }
1426
+ continue;
1427
+ }
1428
+ if (character === '"' || character === "'") {
1429
+ quote = character;
1430
+ continue;
1431
+ }
1432
+ if (character === '#' && (index === 0 || /\s/u.test(value[index - 1]))) {
1433
+ return value.slice(0, index);
1434
+ }
1435
+ }
1436
+ return value;
1437
+ }
1438
+
1439
+ function workflowYamlMappingColon(value) {
1440
+ let quote = null;
1441
+ let flowDepth = 0;
1442
+ for (let index = 0; index < value.length; index++) {
1443
+ const character = value[index];
1444
+ if (quote) {
1445
+ if (quote === "'" && character === "'" && value[index + 1] === "'") {
1446
+ index++;
1447
+ continue;
1448
+ }
1449
+ if (character === quote) {
1450
+ quote = null;
1451
+ } else if (quote === '"' && character === '\\') {
1452
+ index++;
1453
+ }
1454
+ continue;
107
1455
  }
108
- return configured;
1456
+ if (character === '"' || character === "'") {
1457
+ quote = character;
1458
+ continue;
1459
+ }
1460
+ if (character === '[' || character === '{') {
1461
+ flowDepth++;
1462
+ continue;
1463
+ }
1464
+ if (character === ']' || character === '}') {
1465
+ flowDepth--;
1466
+ if (flowDepth < 0) workflowYamlError('unexpected flow collection terminator');
1467
+ continue;
1468
+ }
1469
+ if (
1470
+ character === ':' &&
1471
+ flowDepth === 0 &&
1472
+ (index + 1 === value.length || /\s/u.test(value[index + 1]))
1473
+ ) {
1474
+ return index;
1475
+ }
1476
+ }
1477
+ return -1;
1478
+ }
1479
+
1480
+ function workflowYamlDoubleQuoted(value, line) {
1481
+ let output = '';
1482
+ const escapes = {
1483
+ '0': '\0',
1484
+ a: '\u0007',
1485
+ b: '\b',
1486
+ t: '\t',
1487
+ n: '\n',
1488
+ v: '\u000b',
1489
+ f: '\f',
1490
+ r: '\r',
1491
+ e: '\u001b',
1492
+ ' ': ' ',
1493
+ '"': '"',
1494
+ '/': '/',
1495
+ '\\': '\\',
1496
+ N: '\u0085',
1497
+ _: '\u00a0',
1498
+ L: '\u2028',
1499
+ P: '\u2029',
1500
+ };
1501
+ for (let index = 1; index < value.length; index++) {
1502
+ const character = value[index];
1503
+ if (character === '"') {
1504
+ if (value.slice(index + 1).trim() !== '') {
1505
+ workflowYamlError('unexpected content after quoted scalar', line);
1506
+ }
1507
+ return output;
1508
+ }
1509
+ if (character !== '\\') {
1510
+ output += character;
1511
+ continue;
1512
+ }
1513
+ index++;
1514
+ const escape = value[index];
1515
+ if (escape === undefined) workflowYamlError('unterminated quoted scalar', line);
1516
+ if (Object.prototype.hasOwnProperty.call(escapes, escape)) {
1517
+ output += escapes[escape];
1518
+ continue;
1519
+ }
1520
+ const widths = { x: 2, u: 4, U: 8 };
1521
+ const width = widths[escape];
1522
+ if (width) {
1523
+ const digits = value.slice(index + 1, index + 1 + width);
1524
+ if (!new RegExp('^[a-fA-F0-9]{' + String(width) + '}$', 'u').test(digits)) {
1525
+ workflowYamlError('invalid Unicode escape', line);
1526
+ }
1527
+ const point = Number.parseInt(digits, 16);
1528
+ try {
1529
+ output += String.fromCodePoint(point);
1530
+ } catch {
1531
+ workflowYamlError('invalid Unicode code point', line);
1532
+ }
1533
+ index += width;
1534
+ continue;
1535
+ }
1536
+ workflowYamlError('unsupported quoted-scalar escape', line);
1537
+ }
1538
+ workflowYamlError('unterminated quoted scalar', line);
1539
+ }
1540
+
1541
+ function workflowYamlSingleQuoted(value, line) {
1542
+ let output = '';
1543
+ for (let index = 1; index < value.length; index++) {
1544
+ const character = value[index];
1545
+ if (character !== "'") {
1546
+ output += character;
1547
+ continue;
1548
+ }
1549
+ if (value[index + 1] === "'") {
1550
+ output += "'";
1551
+ index++;
1552
+ continue;
1553
+ }
1554
+ if (value.slice(index + 1).trim() !== '') {
1555
+ workflowYamlError('unexpected content after quoted scalar', line);
1556
+ }
1557
+ return output;
1558
+ }
1559
+ workflowYamlError('unterminated quoted scalar', line);
1560
+ }
1561
+
1562
+ function workflowYamlPlainScalar(value) {
1563
+ if (/^(?:null|Null|NULL|~)$/u.test(value)) return null;
1564
+ if (/^(?:true|True|TRUE)$/u.test(value)) return true;
1565
+ if (/^(?:false|False|FALSE)$/u.test(value)) return false;
1566
+ if (/^[-+]?(?:0|[1-9][0-9_]*)$/u.test(value)) {
1567
+ const parsed = Number(value.replaceAll('_', ''));
1568
+ if (Number.isSafeInteger(parsed)) return parsed;
1569
+ }
1570
+ if (
1571
+ /^[-+]?(?:(?:0|[1-9][0-9_]*)\.[0-9_]+|(?:0|[1-9][0-9_]*)(?:[eE][-+]?[0-9]+))$/u.test(
1572
+ value,
1573
+ )
1574
+ ) {
1575
+ const parsed = Number(value.replaceAll('_', ''));
1576
+ if (Number.isFinite(parsed)) return parsed;
1577
+ }
1578
+ if (/^[&*!]/u.test(value)) {
1579
+ workflowYamlError('anchors, aliases, and tags are not supported in project config');
1580
+ }
1581
+ return value;
1582
+ }
1583
+
1584
+ function workflowYamlFlowParser(source, line) {
1585
+ let cursor = 0;
1586
+ const skip = () => {
1587
+ while (/\s/u.test(source[cursor] ?? '')) cursor++;
1588
+ };
1589
+ const quoted = () => {
1590
+ const start = cursor;
1591
+ const quote = source[cursor++];
1592
+ while (cursor < source.length) {
1593
+ if (quote === "'" && source[cursor] === "'" && source[cursor + 1] === "'") {
1594
+ cursor += 2;
1595
+ continue;
1596
+ }
1597
+ if (source[cursor] === quote) {
1598
+ cursor++;
1599
+ const token = source.slice(start, cursor);
1600
+ return quote === '"'
1601
+ ? workflowYamlDoubleQuoted(token, line)
1602
+ : workflowYamlSingleQuoted(token, line);
1603
+ }
1604
+ if (quote === '"' && source[cursor] === '\\') cursor++;
1605
+ cursor++;
1606
+ }
1607
+ workflowYamlError('unterminated quoted scalar', line);
1608
+ };
1609
+ const value = (stops) => {
1610
+ skip();
1611
+ const character = source[cursor];
1612
+ if (character === '[') return sequence();
1613
+ if (character === '{') return mapping();
1614
+ if (character === '"' || character === "'") return quoted();
1615
+ const start = cursor;
1616
+ while (cursor < source.length && !stops.includes(source[cursor])) cursor++;
1617
+ const token = source.slice(start, cursor).trim();
1618
+ if (!token) workflowYamlError('missing flow collection value', line);
1619
+ return workflowYamlPlainScalar(token);
1620
+ };
1621
+ const sequence = () => {
1622
+ cursor++;
1623
+ const output = [];
1624
+ skip();
1625
+ if (source[cursor] === ']') {
1626
+ cursor++;
1627
+ return output;
1628
+ }
1629
+ for (;;) {
1630
+ output.push(value([',', ']']));
1631
+ skip();
1632
+ if (source[cursor] === ']') {
1633
+ cursor++;
1634
+ return output;
1635
+ }
1636
+ if (source[cursor] !== ',') workflowYamlError('expected , or ] in flow sequence', line);
1637
+ cursor++;
1638
+ }
1639
+ };
1640
+ const mapping = () => {
1641
+ cursor++;
1642
+ const output = {};
1643
+ skip();
1644
+ if (source[cursor] === '}') {
1645
+ cursor++;
1646
+ return output;
1647
+ }
1648
+ for (;;) {
1649
+ skip();
1650
+ let key;
1651
+ if (source[cursor] === '"' || source[cursor] === "'") {
1652
+ key = String(quoted());
1653
+ } else {
1654
+ const start = cursor;
1655
+ while (cursor < source.length && source[cursor] !== ':') cursor++;
1656
+ key = source.slice(start, cursor).trim();
1657
+ }
1658
+ if (!key || source[cursor] !== ':') {
1659
+ workflowYamlError('expected mapping key and : in flow mapping', line);
1660
+ }
1661
+ if (Object.prototype.hasOwnProperty.call(output, key)) {
1662
+ workflowYamlError('duplicate key ' + key, line);
1663
+ }
1664
+ cursor++;
1665
+ output[key] = value([',', '}']);
1666
+ skip();
1667
+ if (source[cursor] === '}') {
1668
+ cursor++;
1669
+ return output;
1670
+ }
1671
+ if (source[cursor] !== ',') workflowYamlError('expected , or } in flow mapping', line);
1672
+ cursor++;
1673
+ }
1674
+ };
1675
+ const parsed = value([]);
1676
+ skip();
1677
+ if (cursor !== source.length) workflowYamlError('unexpected flow collection content', line);
1678
+ return parsed;
1679
+ }
1680
+
1681
+ function workflowYamlFlowDepth(value, line) {
1682
+ const stack = [];
1683
+ let quote = null;
1684
+ for (let index = 0; index < value.length; index++) {
1685
+ const character = value[index];
1686
+ if (quote) {
1687
+ if (quote === "'" && character === "'" && value[index + 1] === "'") {
1688
+ index++;
1689
+ continue;
1690
+ }
1691
+ if (character === quote) {
1692
+ quote = null;
1693
+ } else if (quote === '"' && character === '\\') {
1694
+ index++;
1695
+ }
1696
+ continue;
1697
+ }
1698
+ if (character === '"' || character === "'") {
1699
+ quote = character;
1700
+ continue;
1701
+ }
1702
+ if (character === '[' || character === '{') {
1703
+ stack.push(character);
1704
+ continue;
1705
+ }
1706
+ if (character === ']' || character === '}') {
1707
+ const expected = character === ']' ? '[' : '{';
1708
+ if (stack.pop() !== expected) workflowYamlError('mismatched flow collection', line);
1709
+ }
1710
+ }
1711
+ return stack.length;
1712
+ }
1713
+
1714
+ function workflowYamlScalar(value, line) {
1715
+ const trimmed = value.trim();
1716
+ if (trimmed.startsWith('[') || trimmed.startsWith('{')) {
1717
+ return workflowYamlFlowParser(trimmed, line);
1718
+ }
1719
+ if (trimmed.startsWith('"')) return workflowYamlDoubleQuoted(trimmed, line);
1720
+ if (trimmed.startsWith("'")) return workflowYamlSingleQuoted(trimmed, line);
1721
+ if (/[\[\]{}]/u.test(trimmed)) {
1722
+ workflowYamlError('malformed flow collection', line);
1723
+ }
1724
+ return workflowYamlPlainScalar(trimmed);
1725
+ }
1726
+
1727
+ function parseWorkflowProjectYaml(source) {
1728
+ const lines = String(source).replace(/^\uFEFF/u, '').split(/\r?\n/u);
1729
+ let cursor = 0;
1730
+ const info = (index) => {
1731
+ const raw = lines[index] ?? '';
1732
+ if (raw.includes('\t')) workflowYamlError('tabs are not supported', index + 1);
1733
+ let indent = 0;
1734
+ while (raw[indent] === ' ') indent++;
1735
+ return {
1736
+ raw,
1737
+ indent,
1738
+ content: workflowYamlStripComment(raw.slice(indent)).trimEnd(),
1739
+ line: index + 1,
1740
+ };
1741
+ };
1742
+ const skipEmpty = () => {
1743
+ while (cursor < lines.length && info(cursor).content.trim() === '') cursor++;
1744
+ };
1745
+ const nextContent = () => {
1746
+ let index = cursor;
1747
+ while (index < lines.length && info(index).content.trim() === '') index++;
1748
+ return index < lines.length ? info(index) : null;
1749
+ };
1750
+ const flowValue = (initial, line) => {
1751
+ let combined = initial;
1752
+ let depth = workflowYamlFlowDepth(combined, line);
1753
+ while (depth > 0) {
1754
+ if (cursor >= lines.length) workflowYamlError('unterminated flow collection', line);
1755
+ const current = info(cursor);
1756
+ cursor++;
1757
+ combined += ' ' + current.content.trim();
1758
+ depth = workflowYamlFlowDepth(combined, line);
1759
+ }
1760
+ return workflowYamlScalar(combined, line);
1761
+ };
1762
+ const blockScalar = (style, parentIndent) => {
1763
+ const output = [];
1764
+ let contentIndent = null;
1765
+ while (cursor < lines.length) {
1766
+ const raw = lines[cursor];
1767
+ if (raw.trim() === '') {
1768
+ output.push('');
1769
+ cursor++;
1770
+ continue;
1771
+ }
1772
+ const current = info(cursor);
1773
+ if (current.indent <= parentIndent) break;
1774
+ contentIndent ??= current.indent;
1775
+ if (current.indent < contentIndent) break;
1776
+ output.push(raw.slice(contentIndent));
1777
+ cursor++;
1778
+ }
1779
+ const text = style === '>' ? output.join('\n').replace(/([^\n])\n([^\n])/gu, '$1 $2') : output.join('\n');
1780
+ return text + '\n';
1781
+ };
1782
+ const parseKey = (value, line) => {
1783
+ const trimmed = value.trim();
1784
+ if (!trimmed) workflowYamlError('mapping key is empty', line);
1785
+ if (trimmed.startsWith('"')) return workflowYamlDoubleQuoted(trimmed, line);
1786
+ if (trimmed.startsWith("'")) return workflowYamlSingleQuoted(trimmed, line);
1787
+ if (/^[?[\]{}&,*!|>@\x60]/u.test(trimmed)) {
1788
+ workflowYamlError('unsupported complex mapping key', line);
1789
+ }
1790
+ return trimmed;
1791
+ };
1792
+ const parseFollowingValue = (rawValue, keyIndent, line) => {
1793
+ const trimmed = rawValue.trim();
1794
+ if (/^[|>][+-]?[0-9]?$/u.test(trimmed)) {
1795
+ return blockScalar(trimmed[0], keyIndent);
1796
+ }
1797
+ if (trimmed !== '') {
1798
+ return trimmed.startsWith('[') || trimmed.startsWith('{')
1799
+ ? flowValue(trimmed, line)
1800
+ : workflowYamlScalar(trimmed, line);
1801
+ }
1802
+ const next = nextContent();
1803
+ if (!next || next.indent <= keyIndent || next.content === '...') return null;
1804
+ return parseBlock(next.indent);
1805
+ };
1806
+ const mapEntry = (output, content, keyIndent, line) => {
1807
+ const colon = workflowYamlMappingColon(content);
1808
+ if (colon < 0) workflowYamlError('expected mapping key followed by :', line);
1809
+ const key = String(parseKey(content.slice(0, colon), line));
1810
+ if (Object.prototype.hasOwnProperty.call(output, key)) {
1811
+ workflowYamlError('duplicate key ' + key, line);
1812
+ }
1813
+ output[key] = parseFollowingValue(content.slice(colon + 1), keyIndent, line);
1814
+ };
1815
+ const parseMapping = (indent) => {
1816
+ const output = {};
1817
+ for (;;) {
1818
+ skipEmpty();
1819
+ if (cursor >= lines.length) return output;
1820
+ const current = info(cursor);
1821
+ if (current.content === '...') return output;
1822
+ if (current.indent < indent) return output;
1823
+ if (current.indent > indent) workflowYamlError('unexpected indentation', current.line);
1824
+ if (current.content === '-' || current.content.startsWith('- ')) return output;
1825
+ cursor++;
1826
+ mapEntry(output, current.content, indent, current.line);
1827
+ }
1828
+ };
1829
+ const parseSequence = (indent) => {
1830
+ const output = [];
1831
+ for (;;) {
1832
+ skipEmpty();
1833
+ if (cursor >= lines.length) return output;
1834
+ const current = info(cursor);
1835
+ if (current.content === '...') return output;
1836
+ if (current.indent < indent) return output;
1837
+ if (current.indent > indent) workflowYamlError('unexpected indentation', current.line);
1838
+ if (current.content !== '-' && !current.content.startsWith('- ')) return output;
1839
+ const item = current.content === '-' ? '' : current.content.slice(2);
1840
+ cursor++;
1841
+ if (item === '') {
1842
+ const next = nextContent();
1843
+ output.push(!next || next.indent <= indent ? null : parseBlock(next.indent));
1844
+ continue;
1845
+ }
1846
+ const colon = workflowYamlMappingColon(item);
1847
+ if (colon >= 0) {
1848
+ const mapping = {};
1849
+ mapEntry(mapping, item, indent + 2, current.line);
1850
+ const next = nextContent();
1851
+ if (next && next.indent > indent) {
1852
+ const remainder = parseMapping(next.indent);
1853
+ for (const [key, value] of Object.entries(remainder)) {
1854
+ if (Object.prototype.hasOwnProperty.call(mapping, key)) {
1855
+ workflowYamlError('duplicate key ' + key, next.line);
1856
+ }
1857
+ mapping[key] = value;
1858
+ }
1859
+ }
1860
+ output.push(mapping);
1861
+ } else {
1862
+ output.push(
1863
+ item.startsWith('[') || item.startsWith('{')
1864
+ ? flowValue(item, current.line)
1865
+ : workflowYamlScalar(item, current.line),
1866
+ );
1867
+ }
1868
+ }
1869
+ };
1870
+ const parseBlock = (indent) => {
1871
+ skipEmpty();
1872
+ const current = info(cursor);
1873
+ if (current.indent !== indent) workflowYamlError('unexpected indentation', current.line);
1874
+ return current.content === '-' || current.content.startsWith('- ')
1875
+ ? parseSequence(indent)
1876
+ : parseMapping(indent);
1877
+ };
1878
+
1879
+ skipEmpty();
1880
+ if (cursor < lines.length && info(cursor).content === '---') {
1881
+ cursor++;
1882
+ skipEmpty();
1883
+ }
1884
+ if (cursor >= lines.length || info(cursor).content === '...') return {};
1885
+ if (info(cursor).indent !== 0) workflowYamlError('root must start at indentation 0', info(cursor).line);
1886
+ const value = parseBlock(0);
1887
+ skipEmpty();
1888
+ if (cursor < lines.length && info(cursor).content === '...') {
1889
+ cursor++;
1890
+ skipEmpty();
1891
+ }
1892
+ if (cursor < lines.length) workflowYamlError('multiple YAML documents are not supported', info(cursor).line);
1893
+ return value;
1894
+ }
1895
+
1896
+ function workflowConfigRecord(value, label) {
1897
+ if (!value || typeof value !== 'object' || Array.isArray(value)) {
1898
+ throw new Error(label + ' must be a mapping');
1899
+ }
1900
+ return value;
1901
+ }
1902
+
1903
+ function workflowConfigLanguage(value, fallback, label) {
1904
+ const resolved = value ?? fallback;
1905
+ if (resolved !== 'en' && resolved !== 'zh-CN') {
1906
+ throw new Error(label + ' must be en or zh-CN');
1907
+ }
1908
+ return resolved;
1909
+ }
1910
+
1911
+ function workflowSnapshotPattern(value, label) {
1912
+ if (
1913
+ typeof value !== 'string' ||
1914
+ value.length === 0 ||
1915
+ value.includes('\\') ||
1916
+ value.includes('\0') ||
1917
+ value.startsWith('/') ||
1918
+ value.split('/').includes('..')
1919
+ ) {
1920
+ throw new Error(label + ' contains an unsafe pattern');
1921
+ }
1922
+ if (value.length > 1024) throw new Error(label + ' exceeds 1024 characters');
1923
+ let wildcardTokens = 0;
1924
+ for (let index = 0; index < value.length; index++) {
1925
+ if (value[index] === '?') {
1926
+ wildcardTokens++;
1927
+ } else if (value[index] === '*') {
1928
+ wildcardTokens++;
1929
+ if (value[index + 1] === '*') index++;
1930
+ }
1931
+ }
1932
+ if (wildcardTokens > 64) {
1933
+ throw new Error(label + ' contains more than 64 wildcard tokens');
1934
+ }
1935
+ }
1936
+
1937
+ function validateWorkflowSnapshot(value) {
1938
+ if (value === undefined) return;
1939
+ const snapshot = workflowConfigRecord(value, 'native.snapshot');
1940
+ for (const key of ['include', 'exclude']) {
1941
+ if (snapshot[key] === undefined) continue;
1942
+ if (!Array.isArray(snapshot[key])) {
1943
+ throw new Error('native.snapshot.' + key + ' contains an unsafe pattern');
1944
+ }
1945
+ for (const pattern of snapshot[key]) {
1946
+ workflowSnapshotPattern(pattern, 'native.snapshot.' + key);
1947
+ }
1948
+ }
1949
+ for (const key of ['max_files', 'max_total_bytes', 'max_duration_ms']) {
1950
+ if (
1951
+ snapshot[key] !== undefined &&
1952
+ (!Number.isSafeInteger(snapshot[key]) || snapshot[key] < 1)
1953
+ ) {
1954
+ throw new Error('native.snapshot.' + key + ' must be a positive integer');
1955
+ }
1956
+ }
1957
+ }
1958
+
1959
+ function validateWorkflowPendingRootMove(value) {
1960
+ if (value === undefined) return;
1961
+ const pending = workflowConfigRecord(value, 'native.pending_root_move');
1962
+ if (typeof pending.id !== 'string' || !/^[a-f0-9-]{8,}$/u.test(pending.id)) {
1963
+ throw new Error('native.pending_root_move.id is invalid');
1964
+ }
1965
+ if (
1966
+ typeof pending.from_artifact_root !== 'string' ||
1967
+ typeof pending.to_artifact_root !== 'string'
1968
+ ) {
1969
+ throw new Error('native.pending_root_move roots must be strings');
1970
+ }
1971
+ normalizeWorkflowArtifactRoot(pending.from_artifact_root);
1972
+ normalizeWorkflowArtifactRoot(pending.to_artifact_root);
1973
+ if (!['copying', 'ready', 'switched'].includes(pending.stage)) {
1974
+ throw new Error('native.pending_root_move.stage is invalid');
1975
+ }
1976
+ if (pending.cleanup !== undefined) {
1977
+ const cleanup = workflowConfigRecord(
1978
+ pending.cleanup,
1979
+ 'native.pending_root_move.cleanup',
1980
+ );
1981
+ if (
1982
+ ![
1983
+ 'forward-source',
1984
+ 'restart-staging',
1985
+ 'rollback-destination',
1986
+ 'rollback-staging',
1987
+ ].includes(cleanup.kind)
1988
+ ) {
1989
+ throw new Error('native.pending_root_move.cleanup.kind is invalid');
1990
+ }
1991
+ if (!['prepared', 'quarantined', 'deleting'].includes(cleanup.state)) {
1992
+ throw new Error('native.pending_root_move.cleanup.state is invalid');
1993
+ }
1994
+ if (
1995
+ typeof cleanup.manifest_hash !== 'string' ||
1996
+ !/^[a-f0-9]{64}$/u.test(cleanup.manifest_hash)
1997
+ ) {
1998
+ throw new Error('native.pending_root_move.cleanup.manifest_hash is invalid');
1999
+ }
2000
+ }
2001
+ }
2002
+
2003
+ function managedWorkflowConfigFields(source) {
2004
+ const root = workflowConfigRecord(parseWorkflowProjectYaml(source), '.comet/config.yaml');
2005
+ const hasProjectMarker =
2006
+ root.schema !== undefined ||
2007
+ root.default_workflow !== undefined ||
2008
+ root.workflows !== undefined ||
2009
+ root.native !== undefined;
2010
+ if (hasProjectMarker && root.schema !== 'comet.project.v1') {
2011
+ throw new Error('Unsupported Comet project schema');
2012
+ }
2013
+ if (
2014
+ root.schema === 'comet.project.v1' &&
2015
+ root.default_workflow !== 'native' &&
2016
+ root.default_workflow !== 'classic'
2017
+ ) {
2018
+ throw new Error('default_workflow must be native or classic');
2019
+ }
2020
+ const workflows =
2021
+ root.workflows ?? (root.default_workflow === undefined ? undefined : [root.default_workflow]);
2022
+ if (
2023
+ workflows !== undefined &&
2024
+ (!Array.isArray(workflows) ||
2025
+ workflows.length === 0 ||
2026
+ workflows.some((workflow) => workflow !== 'native' && workflow !== 'classic'))
2027
+ ) {
2028
+ throw new Error('workflows must contain native and/or classic');
2029
+ }
2030
+ if (
2031
+ workflows !== undefined &&
2032
+ root.default_workflow !== undefined &&
2033
+ !workflows.includes(root.default_workflow)
2034
+ ) {
2035
+ throw new Error('workflows must include default_workflow');
2036
+ }
2037
+ if (root.ambient_resume !== undefined && typeof root.ambient_resume !== 'boolean') {
2038
+ throw new Error('ambient_resume must be true or false');
2039
+ }
2040
+ const memory = normalizeWorkflowMemoryProjectConfig(root.memory);
2041
+ const knowledge = normalizeWorkflowKnowledgeProjectConfig(root.knowledge);
2042
+
2043
+ let nativeArtifactRoot = null;
2044
+ if (root.native !== undefined) {
2045
+ const native = workflowConfigRecord(root.native, 'native');
2046
+ if (typeof native.artifact_root !== 'string') {
2047
+ throw new Error('native.artifact_root must be a string');
2048
+ }
2049
+ nativeArtifactRoot = normalizeWorkflowArtifactRoot(native.artifact_root);
2050
+ workflowConfigLanguage(native.language, 'en', 'native.language');
2051
+ const clarificationMode = native.clarification_mode ?? 'batch';
2052
+ if (clarificationMode !== 'sequential' && clarificationMode !== 'batch') {
2053
+ throw new Error('native.clarification_mode must be sequential or batch');
2054
+ }
2055
+ const archiveConfirmation = native.archive_confirmation ?? 'automatic';
2056
+ if (archiveConfirmation !== 'automatic' && archiveConfirmation !== 'required') {
2057
+ throw new Error('native.archive_confirmation must be automatic or required');
2058
+ }
2059
+ const maxVerifyFailures = native.max_verify_failures ?? 5;
2060
+ if (!Number.isSafeInteger(maxVerifyFailures) || maxVerifyFailures < 1) {
2061
+ throw new Error('native.max_verify_failures must be a positive integer');
2062
+ }
2063
+ if (native.finish !== undefined) {
2064
+ const finish = workflowConfigRecord(native.finish, 'native.finish');
2065
+ if (finish.pull_request !== undefined) {
2066
+ const pullRequest = workflowConfigRecord(
2067
+ finish.pull_request,
2068
+ 'native.finish.pull_request',
2069
+ );
2070
+ if (pullRequest.provider !== 'repository-command') {
2071
+ throw new Error('native.finish.pull_request.provider must be repository-command');
2072
+ }
2073
+ if (!Array.isArray(pullRequest.command) || pullRequest.command.length === 0) {
2074
+ throw new Error('native.finish.pull_request.command must be a non-empty array');
2075
+ }
2076
+ if (pullRequest.command.length > 64) {
2077
+ throw new Error('native.finish.pull_request.command must contain at most 64 arguments');
2078
+ }
2079
+ for (let index = 0; index < pullRequest.command.length; index += 1) {
2080
+ const argument = pullRequest.command[index];
2081
+ if (
2082
+ typeof argument !== 'string' ||
2083
+ argument.trim().length === 0 ||
2084
+ argument.length > 4096 ||
2085
+ /[\0\r\n]/u.test(argument)
2086
+ ) {
2087
+ throw new Error(
2088
+ 'native.finish.pull_request.command[' +
2089
+ index +
2090
+ '] must be a non-empty single-line string of at most 4096 characters',
2091
+ );
2092
+ }
2093
+ }
2094
+ if (
2095
+ path.posix.isAbsolute(pullRequest.command[0]) ||
2096
+ path.win32.isAbsolute(pullRequest.command[0])
2097
+ ) {
2098
+ throw new Error(
2099
+ 'native.finish.pull_request.command[0] must be a bare executable name or a project-relative path',
2100
+ );
2101
+ }
2102
+ const timeoutMs =
2103
+ pullRequest.timeout_ms ?? ${DEFAULT_WORKFLOW_NATIVE_PULL_REQUEST_FINISH_TIMEOUT_MS};
2104
+ if (
2105
+ !Number.isSafeInteger(timeoutMs) ||
2106
+ timeoutMs < 1 ||
2107
+ timeoutMs > ${MAX_WORKFLOW_NATIVE_PULL_REQUEST_FINISH_TIMEOUT_MS}
2108
+ ) {
2109
+ throw new Error(
2110
+ 'native.finish.pull_request.timeout_ms must be an integer between 1 and ${MAX_WORKFLOW_NATIVE_PULL_REQUEST_FINISH_TIMEOUT_MS}',
2111
+ );
2112
+ }
2113
+ }
2114
+ }
2115
+ validateWorkflowSnapshot(native.snapshot);
2116
+ validateWorkflowPendingRootMove(native.pending_root_move);
2117
+ }
2118
+
2119
+ let classicArtifactLayout = null;
2120
+ if (root.classic !== undefined) {
2121
+ const classic = workflowConfigRecord(root.classic, 'classic');
2122
+ classicArtifactLayout = normalizeClassicArtifactLayout(
2123
+ classic.artifact_layout,
2124
+ 'legacy',
2125
+ );
2126
+ workflowConfigLanguage(classic.language, 'zh-CN', 'classic.language');
2127
+ const compression = classic.context_compression ?? 'off';
2128
+ if (compression !== 'off' && compression !== 'beta') {
2129
+ throw new Error('classic.context_compression must be off or beta');
2130
+ }
2131
+ const reviewMode = classic.review_mode ?? 'standard';
2132
+ if (!['off', 'standard', 'thorough'].includes(reviewMode)) {
2133
+ throw new Error('classic.review_mode must be off, standard, or thorough');
2134
+ }
2135
+ const autoTransition = classic.auto_transition ?? true;
2136
+ if (typeof autoTransition !== 'boolean') {
2137
+ throw new Error('classic.auto_transition must be true or false');
2138
+ }
2139
+ }
2140
+ const nativeEnabled = Array.isArray(workflows) && workflows.includes('native');
2141
+ const classicEnabled = Array.isArray(workflows) && workflows.includes('classic');
2142
+ if (nativeEnabled && root.native === undefined) {
2143
+ throw new Error('native must be a mapping');
2144
+ }
2145
+ if (classicEnabled && classicArtifactLayout === null) {
2146
+ classicArtifactLayout = 'legacy';
2147
+ }
2148
+ return {
2149
+ nativeArtifactRoot,
2150
+ classicArtifactLayout,
2151
+ nativeEnabled,
2152
+ classicEnabled,
2153
+ memoryLearning: memory.learning,
2154
+ memoryRetrieval: memory.retrieval,
2155
+ knowledgeProvider: knowledge.provider,
2156
+ knowledgeRemote: knowledge.remote ?? null,
2157
+ };
2158
+ }
2159
+
2160
+ async function readWorkflowProjectPathConfig(projectRoot) {
2161
+ const file = path.join(projectRoot, '.comet', 'config.yaml');
2162
+ let inspection;
2163
+ try {
2164
+ inspection = await inspectWorkflowProtectedPath(
2165
+ projectRoot,
2166
+ file,
2167
+ '.comet/config.yaml',
2168
+ 'file',
2169
+ );
2170
+ } catch (error) {
2171
+ if (error && typeof error === 'object' && error.code === 'ENOENT') {
2172
+ return {
2173
+ nativeArtifactRoot: null,
2174
+ classicArtifactLayout: null,
2175
+ nativeEnabled: false,
2176
+ classicEnabled: false,
2177
+ memoryLearning: true,
2178
+ memoryRetrieval: true,
2179
+ knowledgeProvider: 'local',
2180
+ knowledgeRemote: null,
2181
+ };
2182
+ }
2183
+ throw error;
2184
+ }
2185
+ if (!inspection.exists) {
2186
+ return {
2187
+ nativeArtifactRoot: null,
2188
+ classicArtifactLayout: null,
2189
+ nativeEnabled: false,
2190
+ classicEnabled: false,
2191
+ memoryLearning: true,
2192
+ memoryRetrieval: true,
2193
+ knowledgeProvider: 'local',
2194
+ knowledgeRemote: null,
2195
+ };
2196
+ }
2197
+ const source = await readWorkflowProtectedFile(
2198
+ projectRoot,
2199
+ file,
2200
+ '.comet/config.yaml',
2201
+ WORKFLOW_PROJECT_CONFIG_MAX_BYTES,
2202
+ );
2203
+ return managedWorkflowConfigFields(source.toString('utf8'));
2204
+ }
2205
+
2206
+ function resolveWorkflowRelativePath(base, value, label, allowWildcards = false) {
2207
+ const segments = workflowRelativeSegments(value, label, allowWildcards);
2208
+ const target = path.resolve(base, ...segments);
2209
+ const relative = path.relative(path.resolve(base), target);
2210
+ if (
2211
+ path.isAbsolute(relative) ||
2212
+ relative === '..' ||
2213
+ relative.startsWith('..' + path.sep)
2214
+ ) {
2215
+ const boundary = label === 'workflow-run statePath' ? 'the project root' : 'its declared path base';
2216
+ throw new Error(label + ' must stay inside ' + boundary);
2217
+ }
2218
+ return { target, segments };
2219
+ }
2220
+ `;
109
2221
  }
110
2222
  //# sourceMappingURL=project-config.js.map