self-evolving-workflow 0.0.0-stage → 0.1.4

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 (375) hide show
  1. package/LICENSE +27 -0
  2. package/README.md +195 -2
  3. package/dist/agent-memory-prompts.d.ts +13 -0
  4. package/dist/agent-memory-prompts.js +55 -0
  5. package/dist/cli.d.ts +2 -0
  6. package/dist/cli.js +6 -0
  7. package/dist/closeout.d.ts +105 -0
  8. package/dist/closeout.js +473 -0
  9. package/dist/code.d.ts +39 -0
  10. package/dist/code.js +124 -0
  11. package/dist/codex-memory.d.ts +24 -0
  12. package/dist/codex-memory.js +217 -0
  13. package/dist/common.d.ts +16 -0
  14. package/dist/common.js +52 -0
  15. package/dist/context-envelope.d.ts +59 -0
  16. package/dist/context-envelope.js +23 -0
  17. package/dist/host-adapters.d.ts +34 -0
  18. package/dist/host-adapters.js +151 -0
  19. package/dist/http.d.ts +3 -0
  20. package/dist/http.js +90 -0
  21. package/dist/index.d.ts +16 -0
  22. package/dist/index.js +13 -0
  23. package/dist/knowledge-cli.d.ts +198 -0
  24. package/dist/knowledge-cli.js +761 -0
  25. package/dist/knowledge-reads.d.ts +72 -0
  26. package/dist/knowledge-reads.js +201 -0
  27. package/dist/memory-config.d.ts +44 -0
  28. package/dist/memory-config.js +204 -0
  29. package/dist/memory-evidence.d.ts +13 -0
  30. package/dist/memory-evidence.js +40 -0
  31. package/dist/memory-history.d.ts +46 -0
  32. package/dist/memory-history.js +432 -0
  33. package/dist/memory.d.ts +96 -0
  34. package/dist/memory.js +362 -0
  35. package/dist/retrospective.d.ts +57 -0
  36. package/dist/retrospective.js +240 -0
  37. package/dist/search.d.ts +36 -0
  38. package/dist/search.js +112 -0
  39. package/dist/skill-addition.d.ts +25 -0
  40. package/dist/skill-addition.js +89 -0
  41. package/dist/skill-design.d.ts +96 -0
  42. package/dist/skill-design.js +226 -0
  43. package/dist/skill-replay.d.ts +55 -0
  44. package/dist/skill-replay.js +448 -0
  45. package/dist/skill-route.d.ts +30 -0
  46. package/dist/skill-route.js +75 -0
  47. package/dist/transcript-evidence.d.ts +3 -0
  48. package/dist/transcript-evidence.js +58 -0
  49. package/dist/upstream/chunker.d.ts +24 -0
  50. package/dist/upstream/chunker.js +96 -0
  51. package/dist/upstream/file-protocol.d.ts +45 -0
  52. package/dist/upstream/file-protocol.js +117 -0
  53. package/dist/upstream/frontmatter.d.ts +47 -0
  54. package/dist/upstream/frontmatter.js +86 -0
  55. package/dist/upstream/graph-search.d.ts +33 -0
  56. package/dist/upstream/graph-search.js +67 -0
  57. package/dist/upstream/l1-extraction.d.ts +26 -0
  58. package/dist/upstream/l1-extraction.js +405 -0
  59. package/dist/upstream/llm.d.ts +8 -0
  60. package/dist/upstream/llm.js +1 -0
  61. package/dist/upstream/merge.d.ts +50 -0
  62. package/dist/upstream/merge.js +153 -0
  63. package/dist/upstream/prompts.d.ts +53 -0
  64. package/dist/upstream/prompts.js +181 -0
  65. package/dist/upstream/search-utils.d.ts +34 -0
  66. package/dist/upstream/search-utils.js +55 -0
  67. package/dist/upstream/slug.d.ts +26 -0
  68. package/dist/upstream/slug.js +103 -0
  69. package/dist/upstream/template.d.ts +29 -0
  70. package/dist/upstream/template.js +80 -0
  71. package/dist/upstream/tokenize.d.ts +4 -0
  72. package/dist/upstream/tokenize.js +29 -0
  73. package/dist/wiki-change.d.ts +76 -0
  74. package/dist/wiki-change.js +299 -0
  75. package/dist/wiki-entry.d.ts +26 -0
  76. package/dist/wiki-entry.js +93 -0
  77. package/dist/wiki-ingest.d.ts +12 -0
  78. package/dist/wiki-ingest.js +126 -0
  79. package/dist/wiki-migration.d.ts +16 -0
  80. package/dist/wiki-migration.js +268 -0
  81. package/dist/wiki-tokens.d.ts +1 -0
  82. package/dist/wiki-tokens.js +46 -0
  83. package/dist/wiki.d.ts +103 -0
  84. package/dist/wiki.js +330 -0
  85. package/dist/workflow-cli.d.ts +2 -0
  86. package/dist/workflow-cli.js +319 -0
  87. package/dist/workflow-install.d.ts +37 -0
  88. package/dist/workflow-install.js +148 -0
  89. package/dist/workflow-knowledge.d.ts +18 -0
  90. package/dist/workflow-knowledge.js +32 -0
  91. package/dist/workflow-mcp.d.ts +2 -0
  92. package/dist/workflow-mcp.js +137 -0
  93. package/dist/workflow-names.d.ts +4 -0
  94. package/dist/workflow-names.js +31 -0
  95. package/dist/workflow-runtime.d.ts +735 -0
  96. package/dist/workflow-runtime.js +747 -0
  97. package/dist/workflow-skills.d.ts +48 -0
  98. package/dist/workflow-skills.js +141 -0
  99. package/docs/images/impeccable-skill.png +0 -0
  100. package/docs/images/workflow-overview.png +0 -0
  101. package/docs/images/workflow-skills.png +0 -0
  102. package/package.json +77 -4
  103. package/skills/ew-impeccable/LICENSE +191 -0
  104. package/skills/ew-impeccable/NOTICE.md +19 -0
  105. package/skills/ew-impeccable/SKILL.md +91 -0
  106. package/skills/ew-impeccable/UPSTREAM.md +23 -0
  107. package/skills/ew-impeccable/reference/adapt.md +314 -0
  108. package/skills/ew-impeccable/reference/adapt.native.md +60 -0
  109. package/skills/ew-impeccable/reference/android.md +46 -0
  110. package/skills/ew-impeccable/reference/animate.md +91 -0
  111. package/skills/ew-impeccable/reference/audit.md +138 -0
  112. package/skills/ew-impeccable/reference/audit.native.md +141 -0
  113. package/skills/ew-impeccable/reference/bolder.md +35 -0
  114. package/skills/ew-impeccable/reference/clarify.md +96 -0
  115. package/skills/ew-impeccable/reference/colorize.md +88 -0
  116. package/skills/ew-impeccable/reference/craft-floor.md +44 -0
  117. package/skills/ew-impeccable/reference/craft.md +5 -0
  118. package/skills/ew-impeccable/reference/critique.md +808 -0
  119. package/skills/ew-impeccable/reference/degraded/asset-producer.md +36 -0
  120. package/skills/ew-impeccable/reference/degraded/documenter.md +23 -0
  121. package/skills/ew-impeccable/reference/degraded/finish-reviewer.md +72 -0
  122. package/skills/ew-impeccable/reference/degraded/manual-edit-applier.md +91 -0
  123. package/skills/ew-impeccable/reference/delight.md +72 -0
  124. package/skills/ew-impeccable/reference/distill.md +113 -0
  125. package/skills/ew-impeccable/reference/doctor.md +56 -0
  126. package/skills/ew-impeccable/reference/document.md +418 -0
  127. package/skills/ew-impeccable/reference/extract.md +68 -0
  128. package/skills/ew-impeccable/reference/harden.md +338 -0
  129. package/skills/ew-impeccable/reference/hooks.md +113 -0
  130. package/skills/ew-impeccable/reference/init.md +133 -0
  131. package/skills/ew-impeccable/reference/ios.md +51 -0
  132. package/skills/ew-impeccable/reference/layout.md +86 -0
  133. package/skills/ew-impeccable/reference/live-setup.md +102 -0
  134. package/skills/ew-impeccable/reference/live.md +326 -0
  135. package/skills/ew-impeccable/reference/new-work.md +209 -0
  136. package/skills/ew-impeccable/reference/onboard.md +236 -0
  137. package/skills/ew-impeccable/reference/operate.md +61 -0
  138. package/skills/ew-impeccable/reference/optimize.md +260 -0
  139. package/skills/ew-impeccable/reference/overdrive.md +127 -0
  140. package/skills/ew-impeccable/reference/polish.md +105 -0
  141. package/skills/ew-impeccable/reference/quieter.md +101 -0
  142. package/skills/ew-impeccable/reference/routing.md +20 -0
  143. package/skills/ew-impeccable/reference/shape.md +59 -0
  144. package/skills/ew-impeccable/reference/typeset.md +82 -0
  145. package/skills/ew-impeccable/reference/visualize.md +46 -0
  146. package/skills/ew-impeccable/scripts/build-phase.mjs +1022 -0
  147. package/skills/ew-impeccable/scripts/command-metadata.json +94 -0
  148. package/skills/ew-impeccable/scripts/comp-diff.mjs +391 -0
  149. package/skills/ew-impeccable/scripts/comp-spec.mjs +513 -0
  150. package/skills/ew-impeccable/scripts/concept-seed.mjs +814 -0
  151. package/skills/ew-impeccable/scripts/context-signals.mjs +325 -0
  152. package/skills/ew-impeccable/scripts/context.mjs +1521 -0
  153. package/skills/ew-impeccable/scripts/critique-storage.mjs +473 -0
  154. package/skills/ew-impeccable/scripts/data/font-index-failures.json +121 -0
  155. package/skills/ew-impeccable/scripts/data/font-index.json +1 -0
  156. package/skills/ew-impeccable/scripts/detect-csp.mjs +246 -0
  157. package/skills/ew-impeccable/scripts/detect.mjs +30 -0
  158. package/skills/ew-impeccable/scripts/detector/browser/injected/index.mjs +2580 -0
  159. package/skills/ew-impeccable/scripts/detector/cli/main.mjs +498 -0
  160. package/skills/ew-impeccable/scripts/detector/design-system.mjs +1311 -0
  161. package/skills/ew-impeccable/scripts/detector/detect-antipatterns-browser.js +9486 -0
  162. package/skills/ew-impeccable/scripts/detector/detect-antipatterns.mjs +51 -0
  163. package/skills/ew-impeccable/scripts/detector/engines/browser/detect-url.mjs +434 -0
  164. package/skills/ew-impeccable/scripts/detector/engines/regex/detect-text.mjs +1439 -0
  165. package/skills/ew-impeccable/scripts/detector/engines/static-html/css-cascade.mjs +1242 -0
  166. package/skills/ew-impeccable/scripts/detector/engines/static-html/detect-html.mjs +263 -0
  167. package/skills/ew-impeccable/scripts/detector/engines/visual/screenshot-contrast.mjs +189 -0
  168. package/skills/ew-impeccable/scripts/detector/findings.mjs +23 -0
  169. package/skills/ew-impeccable/scripts/detector/node/file-system.mjs +225 -0
  170. package/skills/ew-impeccable/scripts/detector/profile/profiler.mjs +166 -0
  171. package/skills/ew-impeccable/scripts/detector/registry/antipatterns.mjs +636 -0
  172. package/skills/ew-impeccable/scripts/detector/rules/checks.mjs +5750 -0
  173. package/skills/ew-impeccable/scripts/detector/shared/color.mjs +596 -0
  174. package/skills/ew-impeccable/scripts/detector/shared/constants.mjs +127 -0
  175. package/skills/ew-impeccable/scripts/detector/shared/fonts.mjs +30 -0
  176. package/skills/ew-impeccable/scripts/detector/shared/inline-ignores.mjs +148 -0
  177. package/skills/ew-impeccable/scripts/detector/shared/page.mjs +7 -0
  178. package/skills/ew-impeccable/scripts/detector/vendor/MDN-DATA-LICENSE +116 -0
  179. package/skills/ew-impeccable/scripts/detector/vendor/THIRD_PARTY_LICENSES.md +227 -0
  180. package/skills/ew-impeccable/scripts/detector/vendor/static-html-parser.build-entry.txt +11 -0
  181. package/skills/ew-impeccable/scripts/detector/vendor/static-html-parser.bundle.mjs +9121 -0
  182. package/skills/ew-impeccable/scripts/doctor.mjs +330 -0
  183. package/skills/ew-impeccable/scripts/embed-prompt.mjs +166 -0
  184. package/skills/ew-impeccable/scripts/font-match.mjs +457 -0
  185. package/skills/ew-impeccable/scripts/generate-image.mjs +447 -0
  186. package/skills/ew-impeccable/scripts/hook-admin.mjs +829 -0
  187. package/skills/ew-impeccable/scripts/hook-before-edit.mjs +538 -0
  188. package/skills/ew-impeccable/scripts/hook-lib.mjs +2493 -0
  189. package/skills/ew-impeccable/scripts/hook.mjs +79 -0
  190. package/skills/ew-impeccable/scripts/lib/artifact-schema.mjs +93 -0
  191. package/skills/ew-impeccable/scripts/lib/composition-catalog.mjs +200 -0
  192. package/skills/ew-impeccable/scripts/lib/concept-catalog.mjs +395 -0
  193. package/skills/ew-impeccable/scripts/lib/design-parser.mjs +880 -0
  194. package/skills/ew-impeccable/scripts/lib/font-fingerprint.mjs +564 -0
  195. package/skills/ew-impeccable/scripts/lib/font-index.mjs +130 -0
  196. package/skills/ew-impeccable/scripts/lib/hero-checks.mjs +246 -0
  197. package/skills/ew-impeccable/scripts/lib/image-metrics.mjs +306 -0
  198. package/skills/ew-impeccable/scripts/lib/impeccable-config.mjs +640 -0
  199. package/skills/ew-impeccable/scripts/lib/impeccable-paths.mjs +137 -0
  200. package/skills/ew-impeccable/scripts/lib/is-generated.mjs +72 -0
  201. package/skills/ew-impeccable/scripts/lib/live-path-globs.mjs +37 -0
  202. package/skills/ew-impeccable/scripts/lib/open-system-browser.mjs +26 -0
  203. package/skills/ew-impeccable/scripts/lib/png.mjs +281 -0
  204. package/skills/ew-impeccable/scripts/lib/provider.mjs +5 -0
  205. package/skills/ew-impeccable/scripts/lib/raster.mjs +194 -0
  206. package/skills/ew-impeccable/scripts/lib/roll-selection.mjs +369 -0
  207. package/skills/ew-impeccable/scripts/lib/staleness-deep.mjs +491 -0
  208. package/skills/ew-impeccable/scripts/lib/staleness-notice.mjs +169 -0
  209. package/skills/ew-impeccable/scripts/lib/staleness.mjs +532 -0
  210. package/skills/ew-impeccable/scripts/lib/surface-briefs.mjs +149 -0
  211. package/skills/ew-impeccable/scripts/lib/target-args.mjs +42 -0
  212. package/skills/ew-impeccable/scripts/lib/target-slug.mjs +33 -0
  213. package/skills/ew-impeccable/scripts/lib/template-extensions.mjs +146 -0
  214. package/skills/ew-impeccable/scripts/live/accept-css.mjs +617 -0
  215. package/skills/ew-impeccable/scripts/live/accept-verify.mjs +60 -0
  216. package/skills/ew-impeccable/scripts/live/browser-script-parts.mjs +84 -0
  217. package/skills/ew-impeccable/scripts/live/completion.mjs +28 -0
  218. package/skills/ew-impeccable/scripts/live/event-validation.mjs +199 -0
  219. package/skills/ew-impeccable/scripts/live/frameworks/astro.mjs +47 -0
  220. package/skills/ew-impeccable/scripts/live/frameworks/detect-utils.mjs +73 -0
  221. package/skills/ew-impeccable/scripts/live/frameworks/index.mjs +143 -0
  222. package/skills/ew-impeccable/scripts/live/frameworks/journal.mjs +197 -0
  223. package/skills/ew-impeccable/scripts/live/frameworks/nextjs.mjs +49 -0
  224. package/skills/ew-impeccable/scripts/live/frameworks/nuxt.mjs +161 -0
  225. package/skills/ew-impeccable/scripts/live/frameworks/script-src.mjs +17 -0
  226. package/skills/ew-impeccable/scripts/live/frameworks/static-html.mjs +26 -0
  227. package/skills/ew-impeccable/scripts/live/frameworks/sveltekit.mjs +71 -0
  228. package/skills/ew-impeccable/scripts/live/frameworks/tag-strategy.mjs +247 -0
  229. package/skills/ew-impeccable/scripts/live/frameworks/tanstack-start.mjs +70 -0
  230. package/skills/ew-impeccable/scripts/live/frameworks/vite-generic.mjs +42 -0
  231. package/skills/ew-impeccable/scripts/live/generation-preflight.mjs +149 -0
  232. package/skills/ew-impeccable/scripts/live/insert-ui.mjs +458 -0
  233. package/skills/ew-impeccable/scripts/live/instructions.mjs +142 -0
  234. package/skills/ew-impeccable/scripts/live/manual-apply.mjs +939 -0
  235. package/skills/ew-impeccable/scripts/live/manual-edit-routes.mjs +357 -0
  236. package/skills/ew-impeccable/scripts/live/manual-edits-buffer.mjs +152 -0
  237. package/skills/ew-impeccable/scripts/live/poll-lanes.mjs +14 -0
  238. package/skills/ew-impeccable/scripts/live/project-ignores.mjs +139 -0
  239. package/skills/ew-impeccable/scripts/live/roots.mjs +508 -0
  240. package/skills/ew-impeccable/scripts/live/session-store.mjs +563 -0
  241. package/skills/ew-impeccable/scripts/live/source-lock.mjs +105 -0
  242. package/skills/ew-impeccable/scripts/live/source-search.mjs +105 -0
  243. package/skills/ew-impeccable/scripts/live/svelte-ast.mjs +969 -0
  244. package/skills/ew-impeccable/scripts/live/svelte-component.mjs +1366 -0
  245. package/skills/ew-impeccable/scripts/live/sveltekit-adapter.mjs +304 -0
  246. package/skills/ew-impeccable/scripts/live/tanstack-adapter.mjs +259 -0
  247. package/skills/ew-impeccable/scripts/live/ui-surfaces.mjs +75 -0
  248. package/skills/ew-impeccable/scripts/live/vocabulary.mjs +171 -0
  249. package/skills/ew-impeccable/scripts/live-accept.mjs +938 -0
  250. package/skills/ew-impeccable/scripts/live-browser-dom.js +167 -0
  251. package/skills/ew-impeccable/scripts/live-browser-ignores.js +242 -0
  252. package/skills/ew-impeccable/scripts/live-browser-session.js +144 -0
  253. package/skills/ew-impeccable/scripts/live-browser.js +12851 -0
  254. package/skills/ew-impeccable/scripts/live-commit-manual-edits.mjs +1200 -0
  255. package/skills/ew-impeccable/scripts/live-complete.mjs +107 -0
  256. package/skills/ew-impeccable/scripts/live-copy-edit-agent.mjs +800 -0
  257. package/skills/ew-impeccable/scripts/live-discard-manual-edits.mjs +51 -0
  258. package/skills/ew-impeccable/scripts/live-inject.mjs +463 -0
  259. package/skills/ew-impeccable/scripts/live-insert.mjs +292 -0
  260. package/skills/ew-impeccable/scripts/live-manual-edit-evidence.mjs +368 -0
  261. package/skills/ew-impeccable/scripts/live-poll.mjs +430 -0
  262. package/skills/ew-impeccable/scripts/live-resume.mjs +123 -0
  263. package/skills/ew-impeccable/scripts/live-server.mjs +1698 -0
  264. package/skills/ew-impeccable/scripts/live-status.mjs +71 -0
  265. package/skills/ew-impeccable/scripts/live-target.mjs +30 -0
  266. package/skills/ew-impeccable/scripts/live-wrap.mjs +927 -0
  267. package/skills/ew-impeccable/scripts/live.mjs +334 -0
  268. package/skills/ew-impeccable/scripts/modern-screenshot.umd.js +14 -0
  269. package/skills/ew-impeccable/scripts/palette.mjs +628 -0
  270. package/skills/ew-impeccable/scripts/pin.mjs +352 -0
  271. package/skills/ew-impeccable/scripts/serve-question.mjs +1783 -0
  272. package/skills/ew-impeccable/scripts/surface-brief.mjs +74 -0
  273. package/skills/ew-knowledge/SKILL.md +35 -0
  274. package/skills/ew-knowledge/references/closeout-protocol.md +68 -0
  275. package/skills/ew-knowledge/references/knowledge-route.md +73 -0
  276. package/skills/ew-knowledge/references/wiki-maintenance.md +27 -0
  277. package/skills/ew-odyssey/SKILL.md +106 -0
  278. package/skills/ew-odyssey/references/audit-artifacts.md +7 -0
  279. package/skills/ew-odyssey/references/odyssey-base.md +104 -0
  280. package/skills/ew-odyssey/references/odyssey-debug.md +264 -0
  281. package/skills/ew-odyssey/references/odyssey-defensive.md +351 -0
  282. package/skills/ew-odyssey/references/odyssey-improve.md +230 -0
  283. package/skills/ew-odyssey/references/odyssey-planex.md +294 -0
  284. package/skills/ew-odyssey/references/odyssey-review.md +233 -0
  285. package/skills/ew-odyssey/references/odyssey-security.md +231 -0
  286. package/skills/ew-odyssey/references/odyssey-ui.md +232 -0
  287. package/skills/ew-odyssey/references/prepare/odyssey-debug.md +102 -0
  288. package/skills/ew-odyssey/references/prepare/odyssey-defensive.md +117 -0
  289. package/skills/ew-odyssey/references/prepare/odyssey-improve.md +95 -0
  290. package/skills/ew-odyssey/references/prepare/odyssey-planex.md +105 -0
  291. package/skills/ew-odyssey/references/prepare/odyssey-review.md +105 -0
  292. package/skills/ew-odyssey/references/prepare/odyssey-security.md +91 -0
  293. package/skills/ew-odyssey/references/prepare/odyssey-ui.md +88 -0
  294. package/skills/ew-odyssey/references/runtime-adapters.md +31 -0
  295. package/skills/ew-orchestrate/SKILL.md +89 -0
  296. package/skills/ew-orchestrate/references/auto-policy.md +66 -0
  297. package/skills/ew-orchestrate/references/boundary-grill.md +51 -0
  298. package/skills/ew-orchestrate/references/companion-route.md +40 -0
  299. package/skills/ew-orchestrate/references/ew-orchestrate.md +44 -0
  300. package/skills/ew-orchestrate/references/goal.md +51 -0
  301. package/skills/ew-orchestrate/references/orchestrator-run-loop.md +33 -0
  302. package/skills/ew-orchestrate/references/planning.md +54 -0
  303. package/skills/ew-orchestrate/steps/ew-analyze/SKILL.md +70 -0
  304. package/skills/ew-orchestrate/steps/ew-analyze/references/issue-gaps-analyze.md +24 -0
  305. package/skills/ew-orchestrate/steps/ew-analyze/references/prepare.md +8 -0
  306. package/skills/ew-orchestrate/steps/ew-analyze/references/workflow.md +138 -0
  307. package/skills/ew-orchestrate/steps/ew-auto-test/SKILL.md +80 -0
  308. package/skills/ew-orchestrate/steps/ew-auto-test/references/prepare.md +23 -0
  309. package/skills/ew-orchestrate/steps/ew-auto-test/references/workflow.md +31 -0
  310. package/skills/ew-orchestrate/steps/ew-blueprint/SKILL.md +122 -0
  311. package/skills/ew-orchestrate/steps/ew-blueprint/references/prepare.md +21 -0
  312. package/skills/ew-orchestrate/steps/ew-blueprint/references/workflow.md +28 -0
  313. package/skills/ew-orchestrate/steps/ew-brainstorm/SKILL.md +49 -0
  314. package/skills/ew-orchestrate/steps/ew-companion/SKILL.md +50 -0
  315. package/skills/ew-orchestrate/steps/ew-debug/SKILL.md +85 -0
  316. package/skills/ew-orchestrate/steps/ew-debug/references/prepare.md +27 -0
  317. package/skills/ew-orchestrate/steps/ew-debug/references/workflow.md +31 -0
  318. package/skills/ew-orchestrate/steps/ew-execute/SKILL.md +74 -0
  319. package/skills/ew-orchestrate/steps/ew-execute/references/prepare.md +27 -0
  320. package/skills/ew-orchestrate/steps/ew-execute/references/workflow.md +87 -0
  321. package/skills/ew-orchestrate/steps/ew-grill/SKILL.md +62 -0
  322. package/skills/ew-orchestrate/steps/ew-grill/references/prepare.md +26 -0
  323. package/skills/ew-orchestrate/steps/ew-grill/references/workflow.md +31 -0
  324. package/skills/ew-orchestrate/steps/ew-init/SKILL.md +56 -0
  325. package/skills/ew-orchestrate/steps/ew-init/references/prepare.md +25 -0
  326. package/skills/ew-orchestrate/steps/ew-init/references/workflow.md +28 -0
  327. package/skills/ew-orchestrate/steps/ew-plan/SKILL.md +131 -0
  328. package/skills/ew-orchestrate/steps/ew-plan/references/prepare.md +8 -0
  329. package/skills/ew-orchestrate/steps/ew-plan/references/tdd.md +53 -0
  330. package/skills/ew-orchestrate/steps/ew-plan/references/workflow.md +100 -0
  331. package/skills/ew-orchestrate/steps/ew-retrospective/SKILL.md +68 -0
  332. package/skills/ew-orchestrate/steps/ew-retrospective/references/prepare.md +18 -0
  333. package/skills/ew-orchestrate/steps/ew-retrospective/references/workflow.md +34 -0
  334. package/skills/ew-orchestrate/steps/ew-review/SKILL.md +45 -0
  335. package/skills/ew-orchestrate/steps/ew-review/references/prepare.md +17 -0
  336. package/skills/ew-orchestrate/steps/ew-review/references/workflow.md +116 -0
  337. package/skills/ew-orchestrate/steps/ew-roadmap/SKILL.md +62 -0
  338. package/skills/ew-orchestrate/steps/ew-roadmap/references/prepare.md +27 -0
  339. package/skills/ew-orchestrate/steps/ew-roadmap/references/workflow.md +28 -0
  340. package/skills/ew-orchestrate/steps/ew-test/SKILL.md +99 -0
  341. package/skills/ew-orchestrate/steps/ew-test/references/prepare.md +23 -0
  342. package/skills/ew-orchestrate/steps/ew-test/references/workflow.md +23 -0
  343. package/skills/ew-orchestrate/steps/ew-verify/SKILL.md +73 -0
  344. package/skills/ew-orchestrate/steps/ew-verify/references/prepare.md +21 -0
  345. package/skills/ew-orchestrate/steps/ew-verify/references/workflow.md +29 -0
  346. package/skills/ew-skill-design/SKILL.md +30 -0
  347. package/skills/ew-skill-design/references/package-contract.md +40 -0
  348. package/skills/ew-skill-design/references/validation.md +21 -0
  349. package/skills/team-swarm/SKILL.md +68 -0
  350. package/skills/team-swarm/references/mcp-coordination.md +14 -0
  351. package/skills/team-swarm/roles/analyst/role.md +181 -0
  352. package/skills/team-swarm/roles/ant/role.md +149 -0
  353. package/skills/team-swarm/roles/coordinator/commands/converge.md +112 -0
  354. package/skills/team-swarm/roles/coordinator/commands/init-swarm.md +136 -0
  355. package/skills/team-swarm/roles/coordinator/commands/iterate.md +171 -0
  356. package/skills/team-swarm/roles/coordinator/role.md +170 -0
  357. package/skills/team-swarm/roles/scorer/role.md +150 -0
  358. package/skills/team-swarm/scripts/aco.py +646 -0
  359. package/skills/team-swarm/scripts/pheromone.py +144 -0
  360. package/skills/team-swarm/scripts/scoring.py +111 -0
  361. package/skills/team-swarm/scripts/test_aco.py +606 -0
  362. package/skills/team-swarm/specs/ant-output-schema.md +127 -0
  363. package/skills/team-swarm/specs/convergence-criteria.md +108 -0
  364. package/skills/team-swarm/specs/pheromone-schema.md +125 -0
  365. package/skills/team-swarm/specs/swarm-config-template.json +71 -0
  366. package/skills/team-swarm/specs/swarm-protocol.md +119 -0
  367. package/skills/workflow-evolve/SKILL.md +64 -0
  368. package/skills/workflow-evolve/references/agy-gate.md +27 -0
  369. package/skills/workflow-evolve/references/auto-loop.md +23 -0
  370. package/skills/workflow-evolve/references/history-review.md +15 -0
  371. package/skills/workflow-evolve/scripts/codex-memory-replay.mjs +86 -0
  372. package/skills/workflow-evolve/scripts/codex-replay.mjs +1 -0
  373. package/skills/workflow-evolve/scripts/evolve-loop.mjs +260 -0
  374. package/skills/workflow-evolve/scripts/memory-codex-mcp.mjs +124 -0
  375. package/workflows/index.json +33 -0
package/dist/memory.js ADDED
@@ -0,0 +1,362 @@
1
+ import { randomUUID } from 'node:crypto';
2
+ import { mkdirSync } from 'node:fs';
3
+ import { dirname, resolve } from 'node:path';
4
+ import { InputError, openDb, pageOffset, pagination, requireText, searchLimit, transaction } from './common.js';
5
+ import { exactMemoryValues, extractedMemoryId, groundMemories } from './memory-evidence.js';
6
+ import { formatExtractionPrompt, getExtractMemoriesAgentPrompt } from './upstream/l1-extraction.js';
7
+ import { rrfMerge } from './upstream/search-utils.js';
8
+ import { bm25RankToScore, buildFtsQuery, tokenizeForFts } from './upstream/tokenize.js';
9
+ const recordFields = `m.id, m.content, m.type, m.scene, m.session, m.priority,
10
+ m.source_ids AS sourceMessageIds, m.created_at AS createdAt, m.updated_at AS updatedAt, m.version,
11
+ (SELECT json_group_array(value) FROM (SELECT value FROM memory_literals WHERE memory_key = m.key ORDER BY value)) AS exactValues,
12
+ (SELECT scope FROM memory_sources WHERE memory_key = m.key) AS sourceMessageScope`;
13
+ function record(row) {
14
+ const { vector, sourceMessageIds, exactValues, sourceMessageScope, ...fields } = row;
15
+ const values = JSON.parse(exactValues);
16
+ return { ...fields, sourceMessageIds: JSON.parse(sourceMessageIds),
17
+ ...(values.length ? { exactValues: values } : {}), ...(sourceMessageScope ? { sourceMessageScope } : {}),
18
+ };
19
+ }
20
+ function normalized(values) {
21
+ const vector = Array.from(values);
22
+ let scale = 0;
23
+ for (const value of vector) {
24
+ if (!Number.isFinite(value))
25
+ throw new InputError('embedding must contain finite numbers');
26
+ scale = Math.max(scale, Math.abs(value));
27
+ }
28
+ if (scale === 0) {
29
+ throw new InputError('embedding must be a non-zero vector of finite numbers');
30
+ }
31
+ const scaled = vector.map(value => value / scale);
32
+ const norm = Math.sqrt(scaled.reduce((sum, value) => sum + value ** 2, 0));
33
+ return scaled.map(value => value / norm);
34
+ }
35
+ export class MemoryStore {
36
+ db;
37
+ namespace;
38
+ embed;
39
+ constructor(path, options = {}) {
40
+ this.namespace = requireText(options.namespace ?? 'default', 'namespace');
41
+ this.embed = options.embed;
42
+ const file = path === ':memory:' ? path : resolve(path);
43
+ if (file !== ':memory:')
44
+ mkdirSync(dirname(file), { recursive: true });
45
+ this.db = openDb(file);
46
+ try {
47
+ this.db.exec(`
48
+ PRAGMA foreign_keys = ON;
49
+ CREATE TABLE IF NOT EXISTS memory_records (
50
+ key INTEGER PRIMARY KEY,
51
+ namespace TEXT NOT NULL,
52
+ id TEXT NOT NULL,
53
+ content TEXT NOT NULL,
54
+ type TEXT NOT NULL,
55
+ scene TEXT NOT NULL,
56
+ session TEXT NOT NULL,
57
+ priority INTEGER NOT NULL,
58
+ source_ids TEXT NOT NULL,
59
+ created_at TEXT NOT NULL,
60
+ updated_at TEXT NOT NULL,
61
+ version INTEGER NOT NULL,
62
+ vector TEXT,
63
+ dimensions INTEGER,
64
+ UNIQUE (namespace, id)
65
+ );
66
+ CREATE VIRTUAL TABLE IF NOT EXISTS memory_fts USING fts5(tokens, tokenize='unicode61');
67
+ CREATE TABLE IF NOT EXISTS memory_sources (
68
+ memory_key INTEGER PRIMARY KEY REFERENCES memory_records(key) ON DELETE CASCADE,
69
+ messages TEXT NOT NULL,
70
+ scope TEXT NOT NULL
71
+ );
72
+ CREATE TABLE IF NOT EXISTS memory_literals (
73
+ memory_key INTEGER NOT NULL REFERENCES memory_records(key) ON DELETE CASCADE,
74
+ value TEXT NOT NULL,
75
+ PRIMARY KEY (memory_key, value)
76
+ );
77
+ CREATE INDEX IF NOT EXISTS memory_literals_value ON memory_literals (value, memory_key);
78
+ CREATE TABLE IF NOT EXISTS memory_extraction_offsets (
79
+ namespace TEXT NOT NULL,
80
+ source TEXT NOT NULL,
81
+ session TEXT NOT NULL,
82
+ offset INTEGER NOT NULL,
83
+ PRIMARY KEY (namespace, source, session)
84
+ );
85
+ `);
86
+ }
87
+ catch (error) {
88
+ this.db.close();
89
+ throw error;
90
+ }
91
+ }
92
+ close() {
93
+ this.db.close();
94
+ }
95
+ async put(input) {
96
+ return (await this.putMany([input]))[0];
97
+ }
98
+ async putMany(inputs) {
99
+ return (await this.writeMany(inputs));
100
+ }
101
+ async writeMany(inputs, advance) {
102
+ const prepared = await Promise.all(inputs.map(async (input) => {
103
+ const content = requireText(input.content, 'content');
104
+ const priority = input.priority ?? 50;
105
+ if (!Number.isInteger(priority) || priority < -1 || priority > 100) {
106
+ throw new InputError('priority must be an integer between -1 and 100');
107
+ }
108
+ const embedding = input.embedding ?? await this.embed?.(content);
109
+ return {
110
+ id: requireText(input.id ?? randomUUID(), 'id'), content, priority,
111
+ type: requireText(input.type ?? 'episodic', 'type'),
112
+ scene: input.scene ?? '', session: input.session ?? '',
113
+ sourceIds: JSON.stringify(input.sourceMessageIds ?? []),
114
+ evidence: input.evidence,
115
+ exactValues: new Set((input.evidence?.messages ?? [{ content }]).flatMap(message => exactMemoryValues(message.content))),
116
+ vector: embedding === undefined ? null : normalized(embedding),
117
+ };
118
+ }));
119
+ const now = new Date().toISOString();
120
+ return transaction(this.db, () => advance && !advance() ? undefined : prepared.map(input => {
121
+ const row = this.db.prepare(`
122
+ INSERT INTO memory_records (
123
+ namespace, id, content, type, scene, session, priority, source_ids, created_at, updated_at, version, vector, dimensions
124
+ ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 1, ?, ?)
125
+ ON CONFLICT (namespace, id) DO UPDATE SET
126
+ content=excluded.content, type=excluded.type, scene=excluded.scene, session=excluded.session,
127
+ priority=excluded.priority, source_ids=excluded.source_ids, updated_at=excluded.updated_at,
128
+ version=memory_records.version+1, vector=excluded.vector, dimensions=excluded.dimensions
129
+ WHERE (memory_records.content, memory_records.type, memory_records.scene, memory_records.session,
130
+ memory_records.priority, memory_records.source_ids, memory_records.vector)
131
+ IS NOT (excluded.content, excluded.type, excluded.scene, excluded.session,
132
+ excluded.priority, excluded.source_ids, excluded.vector)
133
+ RETURNING key
134
+ `).get(this.namespace, input.id, input.content, input.type, input.scene, input.session, input.priority, input.sourceIds, now, now, input.vector && JSON.stringify(input.vector), input.vector?.length ?? null);
135
+ const key = row?.key ?? (input.evidence && this.db.prepare('SELECT key FROM memory_records WHERE namespace = ? AND id = ?')
136
+ .get(this.namespace, input.id)?.key);
137
+ if (typeof key === 'number' && input.evidence) {
138
+ const snapshots = input.evidence.messages.map(({ id, role, timestamp, content, location }) => ({
139
+ id, role, timestamp, content, ...(location && { location }),
140
+ }));
141
+ this.db.prepare(`INSERT INTO memory_sources (memory_key, messages, scope) VALUES (?, ?, ?)
142
+ ON CONFLICT (memory_key) DO UPDATE SET messages = excluded.messages, scope = excluded.scope`)
143
+ .run(key, JSON.stringify(snapshots), input.evidence.scope);
144
+ }
145
+ else if (row) {
146
+ this.db.prepare('DELETE FROM memory_sources WHERE memory_key = ?').run(Number(row.key));
147
+ }
148
+ if (typeof key === 'number') {
149
+ this.db.prepare('DELETE FROM memory_literals WHERE memory_key = ?').run(key);
150
+ const insert = this.db.prepare('INSERT INTO memory_literals (memory_key, value) VALUES (?, ?)');
151
+ for (const value of input.exactValues)
152
+ insert.run(key, value);
153
+ this.db.prepare('DELETE FROM memory_fts WHERE rowid = ?').run(key);
154
+ this.db.prepare('INSERT INTO memory_fts(rowid, tokens) VALUES (?, ?)').run(key, tokenizeForFts(input.content));
155
+ }
156
+ return this.get(input.id);
157
+ }));
158
+ }
159
+ get(id, options = {}) {
160
+ const row = this.db.prepare(`SELECT ${recordFields} FROM memory_records m WHERE namespace = ? AND id = ?`)
161
+ .get(this.namespace, id);
162
+ const result = row && record(row);
163
+ if (result && options.knowledgeReads) {
164
+ options.knowledgeReads.recordRead({
165
+ kind: 'memory', id: result.id, fromSearchId: options.fromSearchId,
166
+ content: result.content, version: result.version,
167
+ });
168
+ }
169
+ return result;
170
+ }
171
+ sources(id) {
172
+ const row = this.db.prepare(`SELECT m.session, s.messages FROM memory_records m
173
+ JOIN memory_sources s ON m.key = s.memory_key WHERE m.namespace = ? AND m.id = ?`).get(this.namespace, id);
174
+ if (!row)
175
+ return [];
176
+ return JSON.parse(String(row.messages)).map(message => ({ ...message, session: String(row.session) }));
177
+ }
178
+ delete(id) {
179
+ return transaction(this.db, () => {
180
+ const row = this.db.prepare('DELETE FROM memory_records WHERE namespace = ? AND id = ? RETURNING key')
181
+ .get(this.namespace, id);
182
+ if (!row)
183
+ return false;
184
+ this.db.prepare('DELETE FROM memory_fts WHERE rowid = ?').run(Number(row.key));
185
+ return true;
186
+ });
187
+ }
188
+ async search(query, options = {}) {
189
+ const text = requireText(query, 'query');
190
+ const limit = searchLimit(options.limit);
191
+ const page = options.page ?? 1;
192
+ const offset = pageOffset(page, limit);
193
+ const take = options.page === undefined ? limit : limit + 1;
194
+ const result = (strategy, hits) => ({
195
+ strategy, results: hits.slice(0, limit),
196
+ ...(options.page !== undefined && { pagination: pagination(page, limit, hits.length > limit) }),
197
+ });
198
+ const clauses = ['m.namespace = ?'];
199
+ const args = [this.namespace];
200
+ for (const field of ['type', 'scene', 'session']) {
201
+ if (options[field] !== undefined) {
202
+ clauses.push(`m.${field} = ?`);
203
+ args.push(options[field]);
204
+ }
205
+ }
206
+ const where = clauses.join(' AND ');
207
+ if (exactMemoryValues(text).includes(text)) {
208
+ const indexed = `FROM memory_literals l JOIN memory_records m ON m.key = l.memory_key WHERE l.value = ? AND ${where}`;
209
+ const rows = this.db.prepare(`SELECT ${recordFields} ${indexed} ORDER BY m.id LIMIT ? OFFSET ?`)
210
+ .all(text, ...args, take, offset);
211
+ const results = rows.map(row => ({ ...record(row), score: 1 }));
212
+ // 旧条目仍可按其实际存储内容精确检索。
213
+ if (results.length < take) {
214
+ const indexedCount = offset && !rows.length
215
+ ? Number(this.db.prepare(`SELECT count(*) AS count ${indexed}`).get(text, ...args)?.count) : offset;
216
+ let skip = Math.max(0, offset - indexedCount);
217
+ const legacy = this.db.prepare(`SELECT ${recordFields} FROM memory_records m
218
+ WHERE ${where} AND instr(m.content, ?) > 0 AND NOT EXISTS
219
+ (SELECT 1 FROM memory_sources WHERE memory_key = m.key) AND NOT EXISTS
220
+ (SELECT 1 FROM memory_literals WHERE memory_key = m.key AND value = ?) ORDER BY m.id`).iterate(...args, text, text);
221
+ for (const row of legacy) {
222
+ if (!exactMemoryValues(row.content).includes(text))
223
+ continue;
224
+ if (skip) {
225
+ skip--;
226
+ continue;
227
+ }
228
+ results.push({ ...record(row), score: 1 });
229
+ if (results.length === take)
230
+ break;
231
+ }
232
+ }
233
+ return result('exact', results);
234
+ }
235
+ const embedding = options.embedding ?? await this.embed?.(text);
236
+ const vector = embedding === undefined ? undefined : normalized(embedding);
237
+ const expression = buildFtsQuery(text);
238
+ // 分页时用完整候选集融合排名,页码改变时保持相同顺序。
239
+ const candidates = vector ? options.page === undefined ? limit * 3 : -1 : take;
240
+ const keyword = expression ? this.db.prepare(`
241
+ SELECT ${recordFields}, bm25(memory_fts) AS rank FROM memory_fts
242
+ JOIN memory_records m ON m.key = memory_fts.rowid
243
+ WHERE memory_fts MATCH ? AND ${where} ORDER BY rank, m.id LIMIT ? OFFSET ?
244
+ `).all(expression, ...args, candidates, vector ? 0 : offset).map(({ rank, ...row }) => ({
245
+ ...record(row), score: bm25RankToScore(rank),
246
+ })) : [];
247
+ const semantic = [];
248
+ if (vector) {
249
+ const statement = this.db.prepare(`
250
+ SELECT ${recordFields}, m.vector FROM memory_records m WHERE ${where} AND m.dimensions = ? ORDER BY m.id
251
+ `);
252
+ for (const row of statement.iterate(...args, vector.length)) {
253
+ const other = JSON.parse(row.vector);
254
+ const score = vector.reduce((sum, value, i) => sum + value * other[i], 0);
255
+ if (score > 0)
256
+ semantic.push({ ...record(row), score });
257
+ }
258
+ semantic.sort((a, b) => b.score - a.score);
259
+ if (candidates >= 0)
260
+ semantic.length = Math.min(candidates, semantic.length);
261
+ }
262
+ if (keyword.length && semantic.length) {
263
+ return result('hybrid', rrfMerge([keyword, semantic], item => item.id)
264
+ .slice(offset, offset + take).map(({ rrfScore, ...item }) => ({ ...item, score: rrfScore })));
265
+ }
266
+ if (semantic.length)
267
+ return result('embedding', semantic.slice(offset, offset + take));
268
+ return result('fts', vector ? keyword.slice(offset, offset + take) : keyword);
269
+ }
270
+ async extract(messages, options) {
271
+ return (await this.writeMany(groundMemories(await extractMemoryInputs(messages, options), messages)));
272
+ }
273
+ extractionOffset(source, session) {
274
+ const row = this.db.prepare(`SELECT offset FROM memory_extraction_offsets
275
+ WHERE namespace = ? AND source = ? AND session = ?`).get(this.namespace, source, session);
276
+ return Number(row?.offset ?? 0);
277
+ }
278
+ async extractIncremental(messages, options) {
279
+ const { source, session, from, to } = options;
280
+ if (!Number.isSafeInteger(from) || !Number.isSafeInteger(to) || from < 0 || to <= from) {
281
+ throw new InputError('Invalid memory extraction offsets');
282
+ }
283
+ if (this.extractionOffset(source, session) !== from)
284
+ return;
285
+ const inputs = groundMemories(await extractMemoryInputs(messages, options), messages);
286
+ return this.writeMany(inputs, () => {
287
+ if (this.extractionOffset(source, session) !== from)
288
+ return false;
289
+ this.db.prepare(`INSERT INTO memory_extraction_offsets (namespace, source, session, offset) VALUES (?, ?, ?, ?)
290
+ ON CONFLICT (namespace, source, session) DO UPDATE SET offset = excluded.offset`)
291
+ .run(this.namespace, source, session, to);
292
+ return true;
293
+ });
294
+ }
295
+ }
296
+ export async function extractMemoryInputs(messages, options) {
297
+ const session = requireText(options.session, 'session');
298
+ if (!messages.length)
299
+ return [];
300
+ const ids = validateConversationMessages(messages);
301
+ const agentMemoryPrompt = options.agentMemoryPrompt ?? getExtractMemoriesAgentPrompt(options.mode);
302
+ const raw = await options.llm.chat({
303
+ system: options.systemPrompt ?? agentMemoryPrompt.system,
304
+ prompt: formatExtractionPrompt({ newMessages: messages }),
305
+ label: agentMemoryPrompt.label,
306
+ });
307
+ return parseExtraction(raw, session, ids);
308
+ }
309
+ export function validateConversationMessages(messages) {
310
+ const ids = new Set();
311
+ for (const message of messages) {
312
+ const id = requireText(message?.id, 'message id');
313
+ if (ids.has(id))
314
+ throw new InputError(`Duplicate message id: ${id}`);
315
+ if (!['user', 'assistant', 'system', 'tool'].includes(message.role) ||
316
+ (typeof message.timestamp !== 'number' && typeof message.timestamp !== 'string') ||
317
+ !Number.isFinite(new Date(message.timestamp).getTime())) {
318
+ throw new InputError(`Invalid role or timestamp for message: ${id}`);
319
+ }
320
+ requireText(message.content, 'message content');
321
+ if (id !== message.id)
322
+ throw new InputError('message id cannot have surrounding whitespace');
323
+ ids.add(id);
324
+ }
325
+ return ids;
326
+ }
327
+ function object(value, label) {
328
+ if (!value || typeof value !== 'object' || Array.isArray(value)) {
329
+ throw new Error(`Invalid ${label} in memory extraction response`);
330
+ }
331
+ return value;
332
+ }
333
+ function parseExtraction(raw, session, messageIds) {
334
+ const text = raw.replace(/<think>[\s\S]*?<\/think>\s*/g, '').trim();
335
+ const json = text.match(/\[[\s\S]*\]/)?.[0];
336
+ if (!json)
337
+ throw new Error('Memory extraction response must contain a JSON array');
338
+ const scenes = JSON.parse(json);
339
+ if (!Array.isArray(scenes))
340
+ throw new Error('Memory extraction response must be an array');
341
+ const knownIds = (ids) => Array.isArray(ids)
342
+ ? [...new Set(ids.map(String).filter(id => messageIds.has(id)))].sort()
343
+ : [];
344
+ return scenes.flatMap(value => {
345
+ const scene = object(value, 'scene');
346
+ if (!Array.isArray(scene.memories))
347
+ throw new Error('Memory extraction scene requires a memories array');
348
+ return scene.memories.map(value => {
349
+ const memory = object(value, 'memory');
350
+ const content = requireText(memory.content, 'memory content');
351
+ const type = requireText(memory.type ?? 'episodic', 'memory type');
352
+ const cited = knownIds(memory.source_message_ids);
353
+ const sourceMessageIds = cited.length ? cited : knownIds(scene.message_ids);
354
+ const id = extractedMemoryId(session, type, content, sourceMessageIds);
355
+ return {
356
+ id, content, type, session, sourceMessageIds,
357
+ scene: typeof scene.scene_name === 'string' ? scene.scene_name : '',
358
+ priority: typeof memory.priority === 'number' ? memory.priority : undefined,
359
+ };
360
+ });
361
+ });
362
+ }
@@ -0,0 +1,57 @@
1
+ import { type ConversationMessage } from './memory.js';
2
+ import type { LlmClient } from './upstream/llm.js';
3
+ import type { Wiki } from './wiki.js';
4
+ import { type KnowledgeReadsReceipt } from './knowledge-reads.js';
5
+ export interface SkillSignal {
6
+ id: string;
7
+ kind: 'correction' | 'error' | 'retry' | 'aborted' | 'verified_fix' | 'workflow_issue' | 'unclassified';
8
+ summary: string;
9
+ sources: string[];
10
+ runIds: string[];
11
+ }
12
+ export interface ReviewedRun {
13
+ id: string;
14
+ command: string;
15
+ skillRef?: ReviewedSkillReference;
16
+ skillReads?: {
17
+ source: string;
18
+ files: Array<{
19
+ path: string;
20
+ sha256: string;
21
+ }>;
22
+ };
23
+ knowledgeReads?: {
24
+ source: string;
25
+ receipt: KnowledgeReadsReceipt;
26
+ };
27
+ retryOf?: string;
28
+ source: string;
29
+ }
30
+ interface ReviewedSkillReference {
31
+ skill_id: string;
32
+ commit: string;
33
+ tree: string;
34
+ package_path: string;
35
+ entry: string;
36
+ }
37
+ export declare function reviewSkillExecution(wiki: Wiki, project: string, execution: string, model: () => LlmClient): Promise<{
38
+ execution: string;
39
+ receipt: string;
40
+ skill: {
41
+ id: string;
42
+ version: string;
43
+ status: "failed" | "succeeded" | "cancelled";
44
+ };
45
+ evidence: number;
46
+ signals: SkillSignal[];
47
+ }>;
48
+ export declare function reviewSession(root: string, session: string, options: {
49
+ model: () => LlmClient;
50
+ transcript?: ConversationMessage[];
51
+ }): Promise<{
52
+ session: string;
53
+ evidence: number;
54
+ runs: ReviewedRun[];
55
+ signals: SkillSignal[];
56
+ }>;
57
+ export {};
@@ -0,0 +1,240 @@
1
+ import { lstatSync } from 'node:fs';
2
+ import { join } from 'node:path';
3
+ import { buildSessionSignalPrompt } from './agent-memory-prompts.js';
4
+ import { parseReceipt, readSessionTransitions, readSkillExecution } from './closeout.js';
5
+ import { InputError, requireText } from './common.js';
6
+ import { extractMemoryInputs, validateConversationMessages } from './memory.js';
7
+ import { readCompletionTranscriptRefs, readTranscriptSnapshots } from './transcript-evidence.js';
8
+ import { formatKnowledgeReadsMessage, validateKnowledgeReads } from './knowledge-reads.js';
9
+ import { readEvolveSessions } from './workflow-runtime.js';
10
+ function signalKind(value) {
11
+ switch (value) {
12
+ case 'correction':
13
+ case 'error':
14
+ case 'retry':
15
+ case 'aborted':
16
+ case 'verified_fix':
17
+ case 'workflow_issue':
18
+ return value;
19
+ default:
20
+ return 'unclassified';
21
+ }
22
+ }
23
+ async function extractSignals(messages, session, model, evidenceRuns = new Map()) {
24
+ if (!messages.length)
25
+ return [];
26
+ const extracted = await extractMemoryInputs(messages, {
27
+ llm: model(), session, agentMemoryPrompt: buildSessionSignalPrompt(),
28
+ });
29
+ const signals = extracted.flatMap(item => item.id && item.sourceMessageIds?.length
30
+ ? [{
31
+ id: item.id, kind: signalKind(item.type), summary: item.content, sources: item.sourceMessageIds,
32
+ runIds: [...new Set(item.sourceMessageIds.flatMap(id => evidenceRuns.get(id) ?? []))].sort(),
33
+ }]
34
+ : []);
35
+ return [...new Map(signals.map(signal => [signal.id, signal])).values()];
36
+ }
37
+ export async function reviewSkillExecution(wiki, project, execution, model) {
38
+ project = requireText(project, 'source project ID');
39
+ execution = requireText(execution, 'Skill execution ID');
40
+ const completion = readSkillExecution(wiki, project, execution);
41
+ validateConversationMessages(completion.messages);
42
+ const messages = completion.messages.map(message => ({ ...message, id: `receipt:${project}:${completion.id}#${message.id}` }));
43
+ if (completion.knowledgeReads) {
44
+ messages.push({
45
+ id: `receipt:${project}:${completion.id}#knowledge-reads`, role: 'tool',
46
+ timestamp: completion.timestamp, content: formatKnowledgeReadsMessage(completion.knowledgeReads),
47
+ });
48
+ }
49
+ return {
50
+ execution, receipt: completion.id, skill: completion.skill, evidence: messages.length,
51
+ signals: await extractSignals(messages, completion.id, model),
52
+ };
53
+ }
54
+ function readSkillReference(value) {
55
+ if (value === undefined)
56
+ return undefined;
57
+ if (!value || typeof value !== 'object')
58
+ throw new InputError('Invalid Run Skill reference');
59
+ const source = value;
60
+ const commit = requireText(source.commit, 'Skill commit');
61
+ const tree = requireText(source.tree, 'Skill tree');
62
+ const objectId = /^(?:[a-f0-9]{40}|[a-f0-9]{64})$/;
63
+ if (!objectId.test(commit) || !objectId.test(tree))
64
+ throw new InputError('Invalid Skill Git object ID');
65
+ return {
66
+ skill_id: requireText(source.skill_id, 'Skill ID'), commit, tree,
67
+ package_path: requireText(source.package_path, 'Skill package path'), entry: requireText(source.entry, 'Skill entry'),
68
+ };
69
+ }
70
+ function readSkillFiles(value, run) {
71
+ if (!value || typeof value !== 'object')
72
+ throw new InputError(`Invalid Skill reads for Run ${run.id}`);
73
+ const reads = value;
74
+ const reference = readSkillReference(reads.reference);
75
+ if (!run.skillRef || !reference || JSON.stringify(reference) !== JSON.stringify(run.skillRef) ||
76
+ !Array.isArray(reads.reads) || !Array.isArray(reads.missing) || reads.missing.length !== 0) {
77
+ throw new InputError(`Skill reads do not match the sealed Run ${run.id}`);
78
+ }
79
+ const files = new Map();
80
+ for (const entry of reads.reads) {
81
+ if (!entry || typeof entry !== 'object')
82
+ throw new InputError(`Invalid Skill read for Run ${run.id}`);
83
+ const path = requireText(entry.path, 'Skill read path');
84
+ const sha256 = requireText(entry.sha256, 'Skill read hash');
85
+ if (path.includes('\\') || path.split('/').some(part => !part || part === '.' || part === '..') ||
86
+ !/\.md$/i.test(path) || !/^sha256:[a-f0-9]{64}$/.test(sha256) ||
87
+ (files.has(path) && files.get(path) !== sha256)) {
88
+ throw new InputError(`Invalid Skill read for Run ${run.id}: ${path}`);
89
+ }
90
+ files.set(path, sha256);
91
+ }
92
+ if (!files.has(reference.entry))
93
+ throw new InputError(`Missing Skill entry read for Run ${run.id}`);
94
+ return [...files].map(([path, sha256]) => ({ path, sha256 }));
95
+ }
96
+ export async function reviewSession(root, session, options) {
97
+ session = requireText(session, 'Session ID');
98
+ if (!/^[a-z0-9][a-z0-9_-]*$/i.test(session))
99
+ throw new InputError('Invalid Session ID');
100
+ const [native] = readEvolveSessions(root, session);
101
+ if (native) {
102
+ const evidenceRuns = new Map();
103
+ const messages = [];
104
+ const runs = native.runs.map(run => {
105
+ const timestamp = run.finished_at ?? native.created_at;
106
+ const source = `evolve:${session}#${run.id}`;
107
+ const record = (id, content, related = [run.id]) => {
108
+ messages.push({ id, timestamp, role: 'tool', content });
109
+ evidenceRuns.set(id, related);
110
+ };
111
+ if (run.summary)
112
+ record(source, `${run.task.command} ${run.status}. ${run.summary}`);
113
+ if (run.retry_of_run_id)
114
+ record(source + ':retry', `Run ${run.id} retries ${run.retry_of_run_id}.`, [run.id, run.retry_of_run_id]);
115
+ const files = Object.entries(run.reads).map(([path, sha256]) => ({ path, sha256 }));
116
+ const readSource = source + ':skill-reads';
117
+ if (files.length)
118
+ record(readSource, 'Opened Skill documents: ' + files.map(file => file.path).join(', '));
119
+ const knowledgeSource = source + ':knowledge-reads';
120
+ if (run.knowledge_reads)
121
+ record(knowledgeSource, formatKnowledgeReadsMessage(run.knowledge_reads));
122
+ const { skill_id, commit, tree, package_path, entry } = run.skill;
123
+ return {
124
+ id: run.id, command: run.task.command, source, retryOf: run.retry_of_run_id,
125
+ skillRef: { skill_id, commit, tree, package_path, entry },
126
+ ...(files.length ? { skillReads: { source: readSource, files } } : {}),
127
+ ...(run.knowledge_reads ? { knowledgeReads: { source: knowledgeSource, receipt: run.knowledge_reads } } : {}),
128
+ };
129
+ });
130
+ for (const message of options.transcript ?? []) {
131
+ messages.push({ ...message, id: `conversation:${session}#${message.id}` });
132
+ }
133
+ validateConversationMessages(messages);
134
+ return { session, evidence: messages.length, runs, signals: await extractSignals(messages, session, options.model, evidenceRuns) };
135
+ }
136
+ const directory = join(root, '.workflow', 'sessions', session);
137
+ if (!lstatSync(directory, { throwIfNoEntry: false })?.isDirectory()) {
138
+ throw new InputError(`Session not found: ${session}`);
139
+ }
140
+ const evidence = new Map();
141
+ const evidenceRuns = new Map();
142
+ const runs = new Map();
143
+ const blocked = new Set();
144
+ const summarizedRuns = new Set();
145
+ let completedRefs;
146
+ for (const { receipt, result, id } of readSessionTransitions(directory)) {
147
+ if (receipt.target_type === 'orchestration' && receipt.target_id === session && result.status === 'completed') {
148
+ if (result.evolve_transcript_refs !== undefined || Array.isArray(result.evolve_evidence)) {
149
+ completedRefs = readCompletionTranscriptRefs(result.evolve_transcript_refs);
150
+ }
151
+ for (const message of parseReceipt(receipt).messages) {
152
+ const run = /^run:(.+):summary$/.exec(message.id)?.[1];
153
+ if (run && summarizedRuns.has(run))
154
+ continue;
155
+ const source = `receipt:${id}#${message.id}`;
156
+ evidence.set(source, { ...message, id: source });
157
+ if (run)
158
+ evidenceRuns.set(source, [run]);
159
+ }
160
+ continue;
161
+ }
162
+ if (typeof result.run_id !== 'string')
163
+ continue;
164
+ const run = result.run_id;
165
+ if ((receipt.target_type === 'run' && receipt.target_id === run) ||
166
+ (receipt.target_type === 'orchestration' && receipt.target_id === session)) {
167
+ if (Array.isArray(receipt.evidence_refs)) {
168
+ for (const ref of receipt.evidence_refs) {
169
+ if (typeof ref !== 'string' || !ref.startsWith('transcript:'))
170
+ continue;
171
+ const linked = evidenceRuns.get(ref) ?? [];
172
+ if (!linked.includes(run))
173
+ evidenceRuns.set(ref, [...linked, run]);
174
+ }
175
+ }
176
+ }
177
+ const source = `receipt:${id}#run:${run}`;
178
+ const timestamp = requireText(receipt.recorded_at, 'Run transition time');
179
+ const sealed = result.status === 'sealed' && ((receipt.target_type === 'orchestration' && receipt.target_id === session && result.operation === 'run-complete-and-seal') ||
180
+ (receipt.target_type === 'run' && receipt.target_id === run && result.operation === 'run-recovery-seal'));
181
+ const reviewedRun = runs.get(run);
182
+ if (sealed && reviewedRun?.skillRef && result.skill_reads !== undefined) {
183
+ const files = readSkillFiles(result.skill_reads, reviewedRun);
184
+ const readSource = `receipt:${id}#skill-reads:${run}`;
185
+ reviewedRun.skillReads = { source: readSource, files };
186
+ evidence.set(readSource, {
187
+ id: readSource, role: 'tool', timestamp,
188
+ content: `Run ${run} opened Skill documents: ${files.map(file => file.path).join(', ')}.`,
189
+ });
190
+ evidenceRuns.set(readSource, [run]);
191
+ }
192
+ if (sealed && reviewedRun && result.knowledge_reads !== undefined) {
193
+ const receipt = validateKnowledgeReads(result.knowledge_reads);
194
+ const knowledgeSource = `receipt:${id}#knowledge-reads:${run}`;
195
+ reviewedRun.knowledgeReads = { source: knowledgeSource, receipt };
196
+ evidence.set(knowledgeSource, {
197
+ id: knowledgeSource, role: 'tool', timestamp, content: formatKnowledgeReadsMessage(receipt),
198
+ });
199
+ evidenceRuns.set(knowledgeSource, [run]);
200
+ }
201
+ const record = (content, runIds = [run]) => {
202
+ evidence.set(source, { id: source, content, timestamp, role: 'tool' });
203
+ evidenceRuns.set(source, runIds);
204
+ };
205
+ if (receipt.target_type === 'orchestration' && receipt.target_id === session &&
206
+ result.run_already_created === true && result.task && typeof result.task === 'object') {
207
+ const command = requireText(result.task.command, 'Run command');
208
+ const retryOf = result.retry_of_run_id === undefined ? undefined : requireText(result.retry_of_run_id, 'prior Run ID');
209
+ const skillRef = readSkillReference(result.skill_ref);
210
+ runs.set(run, { id: run, command, skillRef, retryOf, source });
211
+ if (retryOf)
212
+ record(`Run ${run} (${command}) retries ${retryOf}.`, [run, retryOf]);
213
+ }
214
+ else if (receipt.target_type === 'run' && receipt.target_id === run) {
215
+ const status = result.status;
216
+ const recovered = status === 'running' && blocked.delete(run);
217
+ if (status === 'blocked')
218
+ blocked.add(run);
219
+ if (status === 'blocked' || status === 'failed' || status === 'cancelled' || recovered) {
220
+ record(`Run ${run} ${recovered ? 'resumed after a block' : `became ${status}`}. Reason: ${requireText(receipt.reason, 'Run transition reason')}`);
221
+ }
222
+ }
223
+ else if (receipt.target_type === 'orchestration' && receipt.target_id === session &&
224
+ result.operation === 'run-complete-and-seal' && result.status === 'sealed' && typeof result.summary === 'string') {
225
+ record(`Run ${run} completed. Summary: ${requireText(result.summary, 'Run summary')}`);
226
+ summarizedRuns.add(run);
227
+ }
228
+ }
229
+ for (const message of readTranscriptSnapshots(directory, completedRefs))
230
+ evidence.set(message.id, message);
231
+ for (const message of options.transcript ?? []) {
232
+ const id = `conversation:${session}#${requireText(message.id, 'message ID')}`;
233
+ if (evidence.has(id))
234
+ throw new InputError(`Duplicate conversation message: ${message.id}`);
235
+ evidence.set(id, { ...message, id });
236
+ }
237
+ const messages = [...evidence.values()].sort((left, right) => new Date(left.timestamp).getTime() - new Date(right.timestamp).getTime());
238
+ return { session, evidence: messages.length, runs: [...runs.values()],
239
+ signals: await extractSignals(messages, session, options.model, evidenceRuns) };
240
+ }