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
@@ -0,0 +1,306 @@
1
+ /**
2
+ * Perceptual measures for comparing a comp with a build screenshot. Pure
3
+ * functions over `{ width, height, data }` RGBA images; no I/O.
4
+ *
5
+ * Three families, because a build fails a comp in three separable ways:
6
+ *
7
+ * - structure: is the composition the same? Measured as SSIM over a blurred
8
+ * grayscale downsample, which forgives font hinting and a few pixels of
9
+ * drift and punishes a moved, missing, or invented region.
10
+ * - color: is the palette and its distribution the same? Histogram
11
+ * intersection in a coarse quantized space plus a dominant-color extraction,
12
+ * so a navy page built from a bone comp fails even if the shapes match.
13
+ * - detail: is the material there? Local high-frequency energy per cell. A
14
+ * comp with an illustration, texture, or photograph carries energy a flat
15
+ * CSS stand-in does not; the ratio build/comp per region is the most direct
16
+ * measure of "the plate got replaced by a gradient".
17
+ */
18
+ import { resize } from './raster.mjs';
19
+
20
+ export function toGray(img) {
21
+ const g = new Float32Array(img.width * img.height);
22
+ for (let i = 0, p = 0; i < g.length; i++, p += 4) {
23
+ const a = img.data[p + 3] / 255;
24
+ // composite over white so transparent regions read as the page ground
25
+ const r = img.data[p] * a + 255 * (1 - a), gg = img.data[p + 1] * a + 255 * (1 - a), b = img.data[p + 2] * a + 255 * (1 - a);
26
+ g[i] = 0.2126 * r + 0.7152 * gg + 0.0722 * b;
27
+ }
28
+ return { width: img.width, height: img.height, data: g };
29
+ }
30
+
31
+ /** Separable box blur on a float gray image, radius r. */
32
+ export function blurGray(gray, r) {
33
+ if (r <= 0) return gray;
34
+ const { width, height, data } = gray;
35
+ const tmp = new Float32Array(data.length), out = new Float32Array(data.length);
36
+ const win = 2 * r + 1;
37
+ for (let y = 0; y < height; y++) {
38
+ let acc = 0;
39
+ for (let x = -r; x <= r; x++) acc += data[y * width + Math.min(width - 1, Math.max(0, x))];
40
+ for (let x = 0; x < width; x++) {
41
+ tmp[y * width + x] = acc / win;
42
+ const outX = x - r, inX = x + r + 1;
43
+ acc += data[y * width + Math.min(width - 1, inX)] - data[y * width + Math.max(0, outX)];
44
+ }
45
+ }
46
+ for (let x = 0; x < width; x++) {
47
+ let acc = 0;
48
+ for (let y = -r; y <= r; y++) acc += tmp[Math.min(height - 1, Math.max(0, y)) * width + x];
49
+ for (let y = 0; y < height; y++) {
50
+ out[y * width + x] = acc / win;
51
+ const outY = y - r, inY = y + r + 1;
52
+ acc += tmp[Math.min(height - 1, inY) * width + x] - tmp[Math.max(0, outY) * width + x];
53
+ }
54
+ }
55
+ return { width, height, data: out };
56
+ }
57
+
58
+ /** Global SSIM between two same-size gray images using an 8x8 window grid. */
59
+ export function ssim(a, b, win = 8) {
60
+ if (a.width !== b.width || a.height !== b.height) throw new Error('ssim: size mismatch');
61
+ const C1 = (0.01 * 255) ** 2, C2 = (0.03 * 255) ** 2;
62
+ let total = 0, n = 0;
63
+ for (let y = 0; y + win <= a.height; y += win) {
64
+ for (let x = 0; x + win <= a.width; x += win) {
65
+ let ma = 0, mb = 0;
66
+ for (let yy = 0; yy < win; yy++) for (let xx = 0; xx < win; xx++) { const i = (y + yy) * a.width + x + xx; ma += a.data[i]; mb += b.data[i]; }
67
+ ma /= win * win; mb /= win * win;
68
+ let va = 0, vb = 0, cov = 0;
69
+ for (let yy = 0; yy < win; yy++) for (let xx = 0; xx < win; xx++) { const i = (y + yy) * a.width + x + xx; const da = a.data[i] - ma, db = b.data[i] - mb; va += da * da; vb += db * db; cov += da * db; }
70
+ va /= win * win - 1; vb /= win * win - 1; cov /= win * win - 1;
71
+ total += ((2 * ma * mb + C1) * (2 * cov + C2)) / ((ma * ma + mb * mb + C1) * (va + vb + C2));
72
+ n++;
73
+ }
74
+ }
75
+ return n ? total / n : 1;
76
+ }
77
+
78
+ /** SSIM of `a` against `b` shifted by (dx, dy); the overlap is compared, edges dropped. */
79
+ export function ssimShifted(a, b, dx, dy, win = 8) {
80
+ const w = a.width - Math.abs(dx), h = a.height - Math.abs(dy);
81
+ if (w < win || h < win) return 0;
82
+ const sa = { width: w, height: h, data: new Float32Array(w * h) };
83
+ const sb = { width: w, height: h, data: new Float32Array(w * h) };
84
+ const ax = Math.max(0, -dx), ay = Math.max(0, -dy), bx = Math.max(0, dx), by = Math.max(0, dy);
85
+ for (let y = 0; y < h; y++) {
86
+ sa.data.set(a.data.subarray((y + ay) * a.width + ax, (y + ay) * a.width + ax + w), y * w);
87
+ sb.data.set(b.data.subarray((y + by) * b.width + bx, (y + by) * b.width + bx + w), y * w);
88
+ }
89
+ return ssim(sa, sb, win);
90
+ }
91
+
92
+ /**
93
+ * Structure score 0..1: SSIM over blurred grayscale at a fixed working width,
94
+ * taking the best of a small translation search so a composition that sits a
95
+ * few pixels off (a different masthead height, a scrollbar) is not read as a
96
+ * different composition. Shifts up to ~4% of the width are forgiven; a moved
97
+ * region is not.
98
+ */
99
+ export function structureScore(imgA, imgB, workWidth = 256) {
100
+ const h = Math.max(8, Math.round((imgA.height / imgA.width) * workWidth));
101
+ const a = blurGray(toGray(resize(imgA, workWidth, h)), 2);
102
+ const b = blurGray(toGray(resize(imgB, workWidth, h)), 2);
103
+ const win = Math.min(8, Math.max(2, Math.floor(Math.min(workWidth, h) / 8)));
104
+ let best = ssim(a, b, win);
105
+ const maxShift = Math.max(2, Math.round(workWidth * 0.04));
106
+ for (const dy of [-maxShift, -maxShift / 2, 0, maxShift / 2, maxShift]) {
107
+ for (const dx of [-maxShift, -maxShift / 2, 0, maxShift / 2, maxShift]) {
108
+ if (!dx && !dy) continue;
109
+ best = Math.max(best, ssimShifted(a, b, Math.round(dx), Math.round(dy), win));
110
+ }
111
+ }
112
+ return Math.max(0, Math.min(1, best));
113
+ }
114
+
115
+ // ---- color -----------------------------------------------------------------
116
+
117
+ function rgbToLab(r, g, b) {
118
+ const lin = (c) => { c /= 255; return c <= 0.04045 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4; };
119
+ const R = lin(r), G = lin(g), B = lin(b);
120
+ const X = (R * 0.4124 + G * 0.3576 + B * 0.1805) / 0.95047;
121
+ const Y = (R * 0.2126 + G * 0.7152 + B * 0.0722) / 1.0;
122
+ const Z = (R * 0.0193 + G * 0.1192 + B * 0.9505) / 1.08883;
123
+ const f = (t) => (t > 0.008856 ? Math.cbrt(t) : 7.787 * t + 16 / 116);
124
+ const fx = f(X), fy = f(Y), fz = f(Z);
125
+ return [116 * fy - 16, 500 * (fx - fy), 200 * (fy - fz)];
126
+ }
127
+
128
+ export function deltaE(lab1, lab2) {
129
+ return Math.hypot(lab1[0] - lab2[0], lab1[1] - lab2[1], lab1[2] - lab2[2]);
130
+ }
131
+
132
+ /** Quantized color histogram (4 bits per channel = 4096 bins), normalized. */
133
+ export function colorHistogram(img, sampleStep = 2) {
134
+ const bins = new Float32Array(4096);
135
+ let n = 0;
136
+ for (let y = 0; y < img.height; y += sampleStep) {
137
+ for (let x = 0; x < img.width; x += sampleStep) {
138
+ const p = (y * img.width + x) * 4;
139
+ if (img.data[p + 3] < 16) continue;
140
+ const key = ((img.data[p] >> 4) << 8) | ((img.data[p + 1] >> 4) << 4) | (img.data[p + 2] >> 4);
141
+ bins[key]++; n++;
142
+ }
143
+ }
144
+ if (n) for (let i = 0; i < bins.length; i++) bins[i] /= n;
145
+ return bins;
146
+ }
147
+
148
+ export function histogramIntersection(h1, h2) {
149
+ let s = 0;
150
+ for (let i = 0; i < h1.length; i++) s += Math.min(h1[i], h2[i]);
151
+ return s;
152
+ }
153
+
154
+ /**
155
+ * Dominant colors: merge histogram bins greedily by Lab distance into up to
156
+ * `k` clusters and return them sorted by coverage.
157
+ */
158
+ export function dominantColors(img, k = 6, sampleStep = 3) {
159
+ const hist = colorHistogram(img, sampleStep);
160
+ const entries = [];
161
+ for (let i = 0; i < hist.length; i++) if (hist[i] > 0.0005) entries.push({ key: i, w: hist[i] });
162
+ entries.sort((a, b) => b.w - a.w);
163
+ const clusters = [];
164
+ for (const e of entries) {
165
+ const r = ((e.key >> 8) & 15) * 16 + 8, g = ((e.key >> 4) & 15) * 16 + 8, b = (e.key & 15) * 16 + 8;
166
+ const lab = rgbToLab(r, g, b);
167
+ let best = null, bestD = Infinity;
168
+ for (const c of clusters) { const d = deltaE(c.lab, lab); if (d < bestD) { bestD = d; best = c; } }
169
+ if (best && bestD < 14) {
170
+ const tw = best.w + e.w;
171
+ best.rgb = [(best.rgb[0] * best.w + r * e.w) / tw, (best.rgb[1] * best.w + g * e.w) / tw, (best.rgb[2] * best.w + b * e.w) / tw];
172
+ best.lab = rgbToLab(...best.rgb); best.w = tw;
173
+ } else clusters.push({ rgb: [r, g, b], lab, w: e.w });
174
+ }
175
+ clusters.sort((a, b) => b.w - a.w);
176
+ const top = clusters.slice(0, k);
177
+ const covered = top.reduce((s, c) => s + c.w, 0) || 1;
178
+ return top.map((c) => ({ hex: toHex(c.rgb), coverage: +(c.w / covered).toFixed(4), lab: c.lab }));
179
+ }
180
+
181
+ export function toHex(rgb) {
182
+ return '#' + rgb.map((v) => Math.max(0, Math.min(255, Math.round(v))).toString(16).padStart(2, '0')).join('');
183
+ }
184
+
185
+ /**
186
+ * Palette match 0..1: for each dominant comp color, coverage-weighted best
187
+ * Lab match in the build's dominant set (dE 0 -> 1, dE >= 25 -> 0).
188
+ */
189
+ export function paletteMatch(compColors, buildColors) {
190
+ if (!compColors.length) return 1;
191
+ let s = 0, wsum = 0;
192
+ for (const c of compColors) {
193
+ let best = Infinity;
194
+ for (const b of buildColors) best = Math.min(best, deltaE(c.lab, b.lab));
195
+ s += c.coverage * Math.max(0, 1 - best / 25); wsum += c.coverage;
196
+ }
197
+ return wsum ? s / wsum : 1;
198
+ }
199
+
200
+ /** Color score 0..1: blend of histogram intersection and dominant-palette match. */
201
+ export function colorScore(imgA, imgB) {
202
+ const inter = histogramIntersection(colorHistogram(imgA), colorHistogram(imgB));
203
+ const pm = paletteMatch(dominantColors(imgA), dominantColors(imgB));
204
+ return { score: 0.35 * inter + 0.65 * pm, intersection: inter, paletteMatch: pm };
205
+ }
206
+
207
+ // ---- detail ----------------------------------------------------------------
208
+
209
+ /** Mean absolute gradient (Sobel-lite) per cell over a cols x rows grid. */
210
+ export function detailGrid(img, cols = 12, rows = 8, workWidth = 512) {
211
+ const h = Math.max(rows, Math.round((img.height / img.width) * workWidth));
212
+ const g = toGray(resize(img, workWidth, h));
213
+ const grid = new Float32Array(cols * rows);
214
+ const counts = new Float32Array(cols * rows);
215
+ for (let y = 1; y < g.height - 1; y++) {
216
+ const cy = Math.min(rows - 1, Math.floor((y / g.height) * rows));
217
+ for (let x = 1; x < g.width - 1; x++) {
218
+ const cx = Math.min(cols - 1, Math.floor((x / g.width) * cols));
219
+ const i = y * g.width + x;
220
+ const gx = Math.abs(g.data[i + 1] - g.data[i - 1]);
221
+ const gy = Math.abs(g.data[i + g.width] - g.data[i - g.width]);
222
+ grid[cy * cols + cx] += gx + gy; counts[cy * cols + cx]++;
223
+ }
224
+ }
225
+ for (let i = 0; i < grid.length; i++) grid[i] = counts[i] ? grid[i] / counts[i] : 0;
226
+ return { cols, rows, cells: grid };
227
+ }
228
+
229
+ /**
230
+ * Detail score 0..1 and per-cell ratio. Cells where the comp is nearly flat
231
+ * are ignored (nothing to lose); the score is the coverage-weighted mean of
232
+ * min(1, build/comp) over cells with comp energy, so extra detail in the
233
+ * build (invented chrome) is reported separately as `added`.
234
+ */
235
+ export function detailScore(imgA, imgB, cols = 12, rows = 8) {
236
+ const a = detailGrid(imgA, cols, rows), b = detailGrid(imgB, cols, rows);
237
+ const floor = 1.5; // energy below this is a flat field at the 512px working width
238
+ let s = 0, w = 0, added = 0, addedW = 0;
239
+ const ratios = new Float32Array(cols * rows);
240
+ for (let i = 0; i < a.cells.length; i++) {
241
+ const ca = a.cells[i], cb = b.cells[i];
242
+ ratios[i] = ca > floor ? cb / ca : (cb > floor ? Infinity : 1);
243
+ // Signed: too much energy is as wrong as too little. Noise, a tile
244
+ // shuffle, or a mosaic saturate a one-sided ratio; a real plate does not.
245
+ if (ca > floor) { s += Math.min(cb / ca, ca / cb) * ca; w += ca; }
246
+ if (cb > ca * 1.8 && cb > floor * 2) { added += 1; }
247
+ addedW += 1;
248
+ }
249
+ const addedFraction = addedW ? added / addedW : 0;
250
+ const raw = w ? s / w : 1;
251
+ return { score: Math.max(0, raw - 0.5 * addedFraction), rawScore: raw, addedFraction, comp: a, build: b, ratios };
252
+ }
253
+
254
+ // ---- pixel diff -----------------------------------------------------------
255
+
256
+ /** Per-pixel Lab-ish difference map (0..1) at a working width; blurred a little. */
257
+ export function diffMap(imgA, imgB, workWidth = 384) {
258
+ const h = Math.max(8, Math.round((imgA.height / imgA.width) * workWidth));
259
+ const a = resize(imgA, workWidth, h), b = resize(imgB, workWidth, h);
260
+ const out = new Float32Array(workWidth * h);
261
+ for (let i = 0, p = 0; i < out.length; i++, p += 4) {
262
+ const dr = a.data[p] - b.data[p], dg = a.data[p + 1] - b.data[p + 1], db = a.data[p + 2] - b.data[p + 2];
263
+ out[i] = Math.min(1, Math.sqrt(dr * dr + dg * dg + db * db) / 200);
264
+ }
265
+ return blurGray({ width: workWidth, height: h, data: out }, 1);
266
+ }
267
+
268
+ // ---- bands (horizontal layout structure) ---------------------------------
269
+
270
+ /**
271
+ * Detect horizontal band boundaries: rows where the mean color changes
272
+ * sharply. Returns normalized y positions (0..1) with strengths. This is the
273
+ * "layout grid" read of a page: header / hero / index / footer as bands.
274
+ */
275
+ export function horizontalBands(img, workWidth = 128, minGap = 0.02) {
276
+ const h = Math.max(16, Math.round((img.height / img.width) * workWidth));
277
+ const s = resize(img, workWidth, h);
278
+ const rowMean = new Float32Array(h * 3);
279
+ for (let y = 0; y < h; y++) {
280
+ let r = 0, g = 0, b = 0;
281
+ for (let x = 0; x < workWidth; x++) { const p = (y * workWidth + x) * 4; r += s.data[p]; g += s.data[p + 1]; b += s.data[p + 2]; }
282
+ rowMean[y * 3] = r / workWidth; rowMean[y * 3 + 1] = g / workWidth; rowMean[y * 3 + 2] = b / workWidth;
283
+ }
284
+ const edges = [];
285
+ for (let y = 1; y < h; y++) {
286
+ const d = Math.hypot(rowMean[y * 3] - rowMean[(y - 1) * 3], rowMean[y * 3 + 1] - rowMean[(y - 1) * 3 + 1], rowMean[y * 3 + 2] - rowMean[(y - 1) * 3 + 2]);
287
+ if (d > 18) edges.push({ y: y / h, strength: Math.min(1, d / 120) });
288
+ }
289
+ // merge close edges
290
+ const merged = [];
291
+ for (const e of edges) {
292
+ const last = merged[merged.length - 1];
293
+ if (last && e.y - last.y < minGap) { if (e.strength > last.strength) { last.y = e.y; last.strength = e.strength; } }
294
+ else merged.push({ ...e });
295
+ }
296
+ return merged;
297
+ }
298
+
299
+ /** Band agreement 0..1: fraction of comp bands with a build band within tolerance, and vice versa. */
300
+ export function bandScore(bandsA, bandsB, tol = 0.04) {
301
+ if (!bandsA.length && !bandsB.length) return 1;
302
+ const match = (from, to) => from.filter((a) => to.some((b) => Math.abs(a.y - b.y) <= tol)).length;
303
+ const recall = bandsA.length ? match(bandsA, bandsB) / bandsA.length : 1;
304
+ const precision = bandsB.length ? match(bandsB, bandsA) / bandsB.length : 1;
305
+ return 0.6 * recall + 0.4 * precision;
306
+ }