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,325 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * Context-signals gatherer for the bare Impeccable invocation
4
+ * (no-argument) path. Collects cheap, deterministic signals about the current
5
+ * project and emits them as JSON.
6
+ *
7
+ * It does NOT score or rank. The agent reasons over the raw signals using its
8
+ * knowledge of the command catalog (see SKILL.md routing rule 1). Deliberately
9
+ * light: no LLM calls, no bundled detector run (that pass is heavier and
10
+ * opt-in), no file writes. Every probe is best-effort and never throws; the
11
+ * output is always valid JSON.
12
+ *
13
+ * Signals:
14
+ * - setup: PRODUCT.md / DESIGN.md presence and whether code exists
15
+ * - critique: the latest cached critique score (.impeccable/critique)
16
+ * - git: branch + files changed vs the default branch (a scope hint)
17
+ * - devServer: whether a local dev server answers on a common port (gates live)
18
+ */
19
+ import fs from 'node:fs';
20
+ import net from 'node:net';
21
+ import path from 'node:path';
22
+ import { fileURLToPath } from 'node:url';
23
+ import { execFileSync } from 'node:child_process';
24
+ import { loadContext, extractPlatform } from './context.mjs';
25
+ import { readLatestSnapshotAcrossTargets } from './critique-storage.mjs';
26
+
27
+ /** Is there code here at all, or just context files / an empty repo? */
28
+ function hasCode(cwd) {
29
+ if (fs.existsSync(path.join(cwd, 'package.json'))) return true;
30
+ for (const d of ['src', 'app', 'pages', 'site', 'public', 'components', 'lib']) {
31
+ if (fs.existsSync(path.join(cwd, d))) return true;
32
+ }
33
+ return false;
34
+ }
35
+
36
+ /**
37
+ * Summarize the most recent critique snapshot across all targets.
38
+ */
39
+ function latestCritique(cwd) {
40
+ try {
41
+ const latest = readLatestSnapshotAcrossTargets({ cwd });
42
+ if (!latest) return null;
43
+ const get = (key) => latest.meta[key] ?? null;
44
+ const num = (v) => {
45
+ if (v == null || (typeof v === 'string' && v.trim() === '')) return null;
46
+ const n = Number(v);
47
+ return Number.isFinite(n) ? n : null;
48
+ };
49
+ return {
50
+ slug: get('slug'),
51
+ score: num(get('total_score') ?? get('score')),
52
+ p0: num(get('p0_count') ?? get('p0')),
53
+ p1: num(get('p1_count') ?? get('p1')),
54
+ timestamp: get('timestamp'),
55
+ file: path.relative(cwd, latest.path),
56
+ };
57
+ } catch {
58
+ return null;
59
+ }
60
+ }
61
+
62
+ /** Branch + a scope hint: files changed vs the default branch, else working tree. */
63
+ function gitSignals(cwd) {
64
+ const run = (args, { trim = true } = {}) => {
65
+ try {
66
+ const out = execFileSync('git', args, {
67
+ cwd,
68
+ encoding: 'utf-8',
69
+ stdio: ['ignore', 'pipe', 'ignore'],
70
+ });
71
+ return trim ? out.trim() : out;
72
+ } catch {
73
+ return null;
74
+ }
75
+ };
76
+ if (run(['rev-parse', '--is-inside-work-tree']) !== 'true') {
77
+ return { isRepo: false, branch: null, base: null, changedFiles: [], changedCount: 0 };
78
+ }
79
+ const branch = run(['rev-parse', '--abbrev-ref', 'HEAD']);
80
+ // The merge target is detected, not assumed. A hardcoded main/master list
81
+ // diffed develop-based repos against the wrong base, so git.changedFiles
82
+ // carried the whole develop/main divergence into scan.targets (issue
83
+ // #302). Signals, most specific first: the branch's configured upstream
84
+ // (@{u}; a branch pushed with -u tracks itself and is skipped by the
85
+ // self-check), then the remote's default-branch symref (origin/HEAD),
86
+ // then the conventional integration names. The conventional fallbacks
87
+ // are withheld when the current branch IS one of them: sitting on main
88
+ // in a repo that also has develop must not diff the two integration
89
+ // branches against each other.
90
+ // Candidates carry a display name (what git.base reports) and the revs to
91
+ // try, in order. A remote ref like `upstream/release` (fork workflows) or
92
+ // an origin/HEAD target with no local checkout is a perfectly good diff
93
+ // base, so revs are not limited to local branch names.
94
+ const remotes = (run(['remote']) || '').split('\n').filter(Boolean);
95
+ // Read @{u} as a FULL symbolic ref: refs/heads/... is a local upstream
96
+ // (branch.<x>.remote = "."), refs/remotes/<r>/... is remote-tracking. No
97
+ // string guessing on the abbreviated form survives contact with reality:
98
+ // a local upstream named release/2.0 is one branch name, and a local
99
+ // feature/foo beside a remote actually named "feature" is only told apart
100
+ // from feature's remote-tracking refs by the full ref namespace.
101
+ const resolveUpstream = () => {
102
+ const full = run(['rev-parse', '--symbolic-full-name', '@{u}']);
103
+ if (!full) return null;
104
+ if (full.startsWith('refs/heads/')) {
105
+ const name = full.slice('refs/heads/'.length);
106
+ return { name, rev: name };
107
+ }
108
+ if (full.startsWith('refs/remotes/')) {
109
+ const rest = full.slice('refs/remotes/'.length);
110
+ const i = rest.indexOf('/');
111
+ if (i > 0) return { name: rest.slice(i + 1), rev: rest };
112
+ }
113
+ return null;
114
+ };
115
+ const conventional = ['develop', 'main', 'master'];
116
+ // On an integration branch itself the scope hint is the working tree. No
117
+ // signal may override that: an origin/HEAD or upstream naming a DIFFERENT
118
+ // integration branch (sitting on develop while the remote default is
119
+ // main) would produce exactly the integration-vs-integration divergence
120
+ // this detection exists to prevent. "Integration branch" means a
121
+ // conventional name OR any remote's default branch (origin first, but a
122
+ // fork-parent layout may only have an `upstream` remote), so a
123
+ // non-standard default like trunk is guarded the same way. A detached
124
+ // checkout (branch reads as the literal `HEAD`) has no branch identity to
125
+ // diff for and keeps the working-tree scope too.
126
+ const remoteHeads = [];
127
+ for (const r of [...new Set(['origin', ...remotes])]) {
128
+ // The symref's own prefix is the remote just queried, so it is stripped
129
+ // directly; the remote need not be in `git remote` output (tests and
130
+ // partial clones fabricate refs/remotes/origin/* without a remote).
131
+ const ref = run(['symbolic-ref', '--short', `refs/remotes/${r}/HEAD`]);
132
+ if (ref && ref.startsWith(`${r}/`)) remoteHeads.push({ name: ref.slice(r.length + 1), rev: ref });
133
+ }
134
+ const onIntegrationBranch = branch === 'HEAD'
135
+ || conventional.includes(branch)
136
+ || remoteHeads.some((head) => head.name === branch);
137
+ let base = null;
138
+ let baseRev = null;
139
+ if (!onIntegrationBranch) {
140
+ const upstream = resolveUpstream();
141
+ // Every named candidate tries the local branch first, then that name on
142
+ // every remote (origin first). Covering all remotes up front is what
143
+ // makes the name-level dedup below safe: a develop or main that exists
144
+ // only as upstream/<name> still resolves even though origin's candidate
145
+ // claimed the name first.
146
+ const remoteOrder = ['origin', ...remotes.filter((name) => name !== 'origin')];
147
+ const revsFor = (name) => [name, ...remoteOrder.map((r) => `${r}/${name}`)];
148
+ const candidates = [];
149
+ const seen = new Set();
150
+ const addCandidate = (name, revs) => {
151
+ if (!name || name === branch || seen.has(name)) return;
152
+ seen.add(name);
153
+ candidates.push({ name, revs });
154
+ };
155
+ // The upstream tracks the actual merge target, so its own rev wins over
156
+ // a possibly stale local branch of the same name.
157
+ if (upstream) addCandidate(upstream.name, [upstream.rev]);
158
+ // A develop branch marks a git-flow repo where features merge to develop
159
+ // even when the platform default (origin/HEAD) was never flipped off
160
+ // main; an existing develop therefore outranks the remote default. This
161
+ // is #302's own repro shape, and repos without develop are unaffected.
162
+ // A remote's advertised default prefers its own remote-tracking rev over
163
+ // a possibly stale local checkout of the same name, for the same reason
164
+ // the upstream candidate leads with its rev. That applies to the develop
165
+ // candidate too when the remote default IS develop: it sits before the
166
+ // remote-default entries in the order, so it must lead with their rev
167
+ // itself or a stale local develop would win.
168
+ const advertisedRevs = (name) => remoteHeads.filter((head) => head.name === name).map((head) => head.rev);
169
+ addCandidate('develop', [...new Set([...advertisedRevs('develop'), ...revsFor('develop')])]);
170
+ for (const head of remoteHeads) addCandidate(head.name, [...new Set([head.rev, ...revsFor(head.name)])]);
171
+ for (const name of ['main', 'master']) addCandidate(name, revsFor(name));
172
+ for (const c of candidates) {
173
+ const rev = c.revs.find((r) => run(['rev-parse', '--verify', '--quiet', r]) !== null);
174
+ if (rev) {
175
+ base = c.name;
176
+ baseRev = rev;
177
+ break;
178
+ }
179
+ }
180
+ }
181
+ const diffBase = base && branch && branch !== base ? base : null;
182
+ const fromDiff = diffBase ? run(['diff', '--name-only', `${baseRev}...HEAD`]) : null;
183
+ // porcelain lines are `XY PATH`: a 2-char status + a space, then the path.
184
+ // Don't trim the combined output — an unstaged-modified line starts with a
185
+ // leading space (` M path`), and a global trim would eat the first line's
186
+ // status column and shift the slice. Renames render as `old -> new`.
187
+ const fromStatus = run(['-c', 'core.quotepath=false', 'status', '--porcelain'], { trim: false });
188
+ let changed = [];
189
+ if (fromDiff) {
190
+ changed = fromDiff.split('\n').filter(Boolean);
191
+ } else if (fromStatus) {
192
+ changed = fromStatus.split(/\r?\n/).filter(Boolean).map((l) => {
193
+ const p = l.slice(3);
194
+ const arrow = p.indexOf(' -> ');
195
+ return arrow === -1 ? p : p.slice(arrow + 4);
196
+ });
197
+ }
198
+ return {
199
+ isRepo: true,
200
+ branch,
201
+ base: diffBase,
202
+ changedFiles: changed.slice(0, 50),
203
+ changedCount: changed.length,
204
+ };
205
+ }
206
+
207
+ const COMMON_DEV_PORTS = [4321, 3000, 5173, 5174, 8080, 8000, 4200];
208
+
209
+ function probePort(port, timeout = 250) {
210
+ return new Promise((resolve) => {
211
+ const sock = new net.Socket();
212
+ let settled = false;
213
+ const finish = (ok) => {
214
+ if (settled) return;
215
+ settled = true;
216
+ try { sock.destroy(); } catch { /* ignore */ }
217
+ resolve(ok);
218
+ };
219
+ sock.setTimeout(timeout);
220
+ sock.once('connect', () => finish(true));
221
+ sock.once('timeout', () => finish(false));
222
+ sock.once('error', () => finish(false));
223
+ sock.connect(port, '127.0.0.1');
224
+ });
225
+ }
226
+
227
+ async function devServerSignals() {
228
+ const open = [];
229
+ await Promise.all(
230
+ COMMON_DEV_PORTS.map(async (p) => {
231
+ if (await probePort(p)) open.push(p);
232
+ }),
233
+ );
234
+ open.sort((a, b) => a - b);
235
+ return { running: open.length > 0, ports: open };
236
+ }
237
+
238
+ // Extensions the detector scans (mirrors the engine's walkDir set + HTML).
239
+ const SCANNABLE_EXT = new Set([
240
+ '.html', '.htm', '.css', '.scss',
241
+ '.jsx', '.tsx', '.js', '.ts', '.vue', '.svelte', '.astro',
242
+ ]);
243
+ // Where UI source typically lives. The detector walks these and skips
244
+ // node_modules / dist / build and all hidden dirs automatically.
245
+ const SOURCE_DIRS = ['src', 'app', 'components', 'pages', 'public'];
246
+
247
+ // A changed file under a hidden or dependency/build directory is not app
248
+ // source — it's a vendored AI-harness install (.claude/skills/..., .cursor/,
249
+ // .impeccable/, issue #303), a build artifact, or a dependency. Mirrors the
250
+ // engine walkDir's skip rule so git-changes targeting can't resurface paths
251
+ // the walker would never visit.
252
+ function isVendoredPath(rel) {
253
+ const dirSegments = rel.split(/[\\/]/).slice(0, -1);
254
+ return dirSegments.some(
255
+ (seg) =>
256
+ (seg.startsWith('.') && seg !== '.vitepress' && seg !== '.vuepress' && seg !== '.storybook') ||
257
+ seg === 'node_modules' || seg === 'dist' || seg === 'build' || seg === '__pycache__',
258
+ );
259
+ }
260
+
261
+ /**
262
+ * Local paths the agent should point the bundled detector at — never a URL.
263
+ * A URL means a costly Puppeteer browser render, and a probed dev-server port
264
+ * may not even belong to this project. An HTML *file* or a source tree is
265
+ * scanned by the cheap, jsdom-free static engine. This script does NOT run the
266
+ * detector; it just surfaces the target(s) so the agent can run
267
+ * `node <scripts>/detect.mjs --json <targets>` and fold the hits in.
268
+ */
269
+ function scanTargets(cwd, git) {
270
+ // 1. Dirty tree wins: scan exactly the markup/style files in flight. It's
271
+ // what the user is working on, it's a small set, and it's local.
272
+ if (git.isRepo && git.changedFiles.length) {
273
+ const changed = git.changedFiles
274
+ .filter((f) => SCANNABLE_EXT.has(path.extname(f).toLowerCase()))
275
+ .filter((f) => !isVendoredPath(f))
276
+ .filter((f) => fs.existsSync(path.join(cwd, f)));
277
+ if (changed.length) return { targets: changed.slice(0, 50), via: 'git-changes' };
278
+ }
279
+ // 2. Otherwise scan the local source dirs that exist.
280
+ const dirs = SOURCE_DIRS.filter((d) => fs.existsSync(path.join(cwd, d)));
281
+ if (dirs.length) return { targets: dirs, via: 'source-dir' };
282
+ // 3. A root HTML entry, or the project root as a last resort when there's
283
+ // code but no conventional source dir (walkDir still skips heavy dirs).
284
+ if (fs.existsSync(path.join(cwd, 'index.html'))) return { targets: ['index.html'], via: 'html' };
285
+ if (hasCode(cwd)) return { targets: ['.'], via: 'root' };
286
+ return { targets: [], via: null };
287
+ }
288
+
289
+ export async function gatherSignals(cwd = process.cwd()) {
290
+ const ctx = loadContext(cwd);
291
+ const git = gitSignals(cwd);
292
+ return {
293
+ setup: {
294
+ hasProduct: ctx.hasProduct,
295
+ productPath: ctx.productPath,
296
+ hasDesign: ctx.hasDesign,
297
+ designPath: ctx.designPath,
298
+ hasCode: hasCode(cwd),
299
+ platform: extractPlatform(ctx.product),
300
+ },
301
+ critique: { latest: latestCritique(cwd) },
302
+ git,
303
+ devServer: await devServerSignals(),
304
+ scan: scanTargets(cwd, git),
305
+ };
306
+ }
307
+
308
+ async function cli() {
309
+ const signals = await gatherSignals(process.cwd());
310
+ process.stdout.write(`${JSON.stringify(signals, null, 2)}\n`);
311
+ }
312
+
313
+ function invokedAsScript() {
314
+ const arg = process.argv[1];
315
+ if (!arg) return false;
316
+ try {
317
+ return fs.realpathSync(arg) === fs.realpathSync(fileURLToPath(import.meta.url));
318
+ } catch {
319
+ return false;
320
+ }
321
+ }
322
+
323
+ if (invokedAsScript()) {
324
+ cli();
325
+ }