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,357 @@
1
+ import { validateEvent } from './event-validation.mjs';
2
+ import {
3
+ countByPage as countPendingByPage,
4
+ readBuffer as readManualEditsBuffer,
5
+ removeEntries as removeManualEditEntries,
6
+ stageEntry as stageManualEditEntry,
7
+ truncateBuffer as truncateManualEditsBuffer,
8
+ } from './manual-edits-buffer.mjs';
9
+ import {
10
+ summarizeManualApplyFailures,
11
+ summarizeManualDiagnostics,
12
+ summarizeManualLogFile,
13
+ } from './manual-apply.mjs';
14
+ import { buildManualEditEvidence } from '../live-manual-edit-evidence.mjs';
15
+ import { commitManualEdits } from '../live-commit-manual-edits.mjs';
16
+
17
+ export function createManualEditRoutes({
18
+ getToken,
19
+ manualApply,
20
+ recordManualEditActivity,
21
+ getManualEditStatus,
22
+ chatAgentLikelyActive,
23
+ cwd = () => process.cwd(),
24
+ env = () => process.env,
25
+ } = {}) {
26
+ const projectCwd = () => typeof cwd === 'function' ? cwd() : cwd || process.cwd();
27
+ const currentEnv = () => typeof env === 'function' ? env() : env || process.env;
28
+
29
+ return function handleManualEditRoute(req, res, url) {
30
+ const p = url.pathname;
31
+
32
+ // Save stages entries; Apply commits the staged page batch through the
33
+ // local AI copy-edit runner.
34
+ if (p === '/manual-edit-stash' && req.method === 'POST') {
35
+ let body = '';
36
+ req.on('data', (c) => { body += c; });
37
+ req.on('end', () => {
38
+ let msg;
39
+ try { msg = JSON.parse(body); } catch {
40
+ sendJson(res, 400, { error: 'Invalid JSON' });
41
+ return;
42
+ }
43
+ if (msg.token !== getToken()) {
44
+ sendJson(res, 401, { error: 'Unauthorized' });
45
+ return;
46
+ }
47
+ const error = validateEvent({ ...msg, type: 'manual_edits' });
48
+ if (error) {
49
+ sendJson(res, 400, { error });
50
+ return;
51
+ }
52
+ try {
53
+ stageManualEditEntry(projectCwd(), {
54
+ id: msg.id,
55
+ pageUrl: msg.pageUrl,
56
+ element: msg.element,
57
+ ops: msg.ops,
58
+ });
59
+ } catch (err) {
60
+ sendJson(res, 500, { error: 'stash_write_failed', message: err.message });
61
+ return;
62
+ }
63
+ const { totalCount, perPage } = countPendingByPage(projectCwd());
64
+ const pendingCount = perPage[msg.pageUrl] || 0;
65
+ recordManualEditActivity('manual_edit_stashed', {
66
+ id: msg.id,
67
+ pageUrl: msg.pageUrl,
68
+ opCount: msg.ops.length,
69
+ pendingCount,
70
+ totalCount,
71
+ hintedFileCount: new Set((msg.ops || []).map((op) => summarizeManualLogFile(op.sourceHint?.file, projectCwd())).filter(Boolean)).size,
72
+ });
73
+ sendJson(res, 200, { ok: true, pendingCount, totalCount, perPage });
74
+ });
75
+ return true;
76
+ }
77
+
78
+ if (p === '/manual-edit-stash' && req.method === 'GET') {
79
+ const token = url.searchParams.get('token');
80
+ if (token !== getToken()) { res.writeHead(401); res.end('Unauthorized'); return true; }
81
+ const pageUrl = url.searchParams.get('pageUrl') || '';
82
+ const { totalCount, perPage } = countPendingByPage(projectCwd());
83
+ const buffer = readManualEditsBuffer(projectCwd());
84
+ const entriesForPage = pageUrl ? buffer.entries.filter((e) => e.pageUrl === pageUrl) : buffer.entries;
85
+ sendJson(res, 200, {
86
+ count: pageUrl ? (perPage[pageUrl] || 0) : totalCount,
87
+ totalCount,
88
+ perPage,
89
+ entries: entriesForPage,
90
+ });
91
+ return true;
92
+ }
93
+
94
+ if (p === '/manual-edit-commit' && req.method === 'POST') {
95
+ const token = url.searchParams.get('token');
96
+ if (token !== getToken()) { res.writeHead(401); res.end('Unauthorized'); return true; }
97
+ const pageUrl = url.searchParams.get('pageUrl');
98
+ const asyncMode = /^(1|true|yes)$/i.test(url.searchParams.get('async') || '');
99
+ const repairOnly = /^(1|true|yes)$/i.test(url.searchParams.get('repair') || '');
100
+ const existingTransaction = manualApply.readTransaction();
101
+ if (repairOnly && !existingTransaction) {
102
+ sendJson(res, 409, { error: 'manual_edit_repair_transaction_missing' });
103
+ return true;
104
+ }
105
+ const recoveredTransaction = repairOnly ? null : manualApply.rollbackTransaction({
106
+ pageUrl,
107
+ reason: 'manual_edit_commit_recovered_abandoned_transaction',
108
+ });
109
+ const before = getManualEditStatus();
110
+ const pendingCount = pageUrl ? (before.perPage[pageUrl] || 0) : before.totalCount;
111
+ recordManualEditActivity('manual_edit_commit_started', {
112
+ pageUrl,
113
+ repairOnly,
114
+ pendingCount,
115
+ totalCount: before.totalCount,
116
+ recoveredTransaction: recoveredTransaction ? {
117
+ id: recoveredTransaction.id,
118
+ reason: recoveredTransaction.reason,
119
+ skipped: recoveredTransaction.skipped,
120
+ rolledBackFiles: recoveredTransaction.rolledBackFiles,
121
+ rollbackFailures: summarizeManualDiagnostics(recoveredTransaction.rollbackFailures, projectCwd()),
122
+ } : null,
123
+ ...summarizePendingManualEditBatch(projectCwd(), pageUrl),
124
+ });
125
+ if (asyncMode) {
126
+ sendJson(res, 202, {
127
+ status: 'started',
128
+ pendingCount,
129
+ totalCount: before.totalCount,
130
+ perPage: before.perPage,
131
+ });
132
+ }
133
+ (async () => {
134
+ let result;
135
+ let routedProvider = 'subprocess';
136
+ let transaction = null;
137
+ let commitBatch = null;
138
+ try {
139
+ if (pendingCount > 0) {
140
+ const transactionBatch = buildManualEditEvidence({ cwd: projectCwd(), pageUrl });
141
+ commitBatch = transactionBatch;
142
+ if (!repairOnly && manualApply.countOps(transactionBatch) > 0) {
143
+ transaction = manualApply.writeTransaction({
144
+ pageUrl,
145
+ batch: transactionBatch,
146
+ });
147
+ } else if (repairOnly && existingTransaction) {
148
+ transaction = existingTransaction;
149
+ }
150
+ }
151
+ const envValue = currentEnv();
152
+ const requestedMode = (envValue.IMPECCABLE_LIVE_COPY_AGENT || 'auto').trim().toLowerCase();
153
+ const useChatRoute = requestedMode === 'chat'
154
+ || (requestedMode === 'auto' && chatAgentLikelyActive());
155
+ if (useChatRoute) {
156
+ routedProvider = 'chat';
157
+ const timeoutMs = Number(envValue.IMPECCABLE_LIVE_COPY_AGENT_TIMEOUT_MS || 120000);
158
+ result = await commitManualEdits({
159
+ cwd: projectCwd(),
160
+ pageUrl,
161
+ provider: 'chat',
162
+ env: envValue,
163
+ timeoutMs,
164
+ chatAvailable: chatAgentLikelyActive,
165
+ applyBatchToSource: (batch, context) => manualApply.pushBatchInChunksAndWait(batch, pageUrl, context),
166
+ repairOnly,
167
+ transactionId: transaction?.id || existingTransaction?.id || null,
168
+ batch: commitBatch,
169
+ });
170
+ } else {
171
+ const timeoutMs = Number(envValue.IMPECCABLE_LIVE_COPY_AGENT_TIMEOUT_MS || 120000);
172
+ const provider = ['codex', 'claude', 'mock'].includes(requestedMode) ? requestedMode : undefined;
173
+ result = await commitManualEdits({
174
+ cwd: projectCwd(),
175
+ pageUrl,
176
+ provider,
177
+ env: envValue,
178
+ timeoutMs,
179
+ chatAvailable: chatAgentLikelyActive,
180
+ repairOnly,
181
+ transactionId: transaction?.id || existingTransaction?.id || null,
182
+ batch: commitBatch,
183
+ });
184
+ }
185
+ } catch (err) {
186
+ if (transaction) {
187
+ manualApply.rollbackTransaction({
188
+ pageUrl,
189
+ reason: 'manual_edit_commit_exception',
190
+ });
191
+ }
192
+ const message = err.stderr?.toString?.() || err.message;
193
+ recordManualEditActivity('manual_edit_commit_failed', {
194
+ pageUrl,
195
+ provider: routedProvider,
196
+ error: 'manual_edit_commit_failed',
197
+ message,
198
+ transactionId: transaction?.id || null,
199
+ });
200
+ if (!asyncMode) {
201
+ sendJson(res, 500, {
202
+ error: 'manual_edit_commit_failed',
203
+ message,
204
+ });
205
+ }
206
+ return;
207
+ } finally {
208
+ if (transaction) {
209
+ const shouldKeepTransaction = result?.needsManualDecision === true;
210
+ if (!shouldKeepTransaction) manualApply.clearTransaction(transaction.id);
211
+ }
212
+ }
213
+ const { totalCount, perPage } = countPendingByPage(projectCwd());
214
+ if (result?.needsManualDecision) {
215
+ recordManualEditActivity('manual_edit_repair_needs_decision', {
216
+ pageUrl,
217
+ provider: routedProvider,
218
+ transactionId: transaction?.id || existingTransaction?.id || null,
219
+ repair: result.repair || null,
220
+ failed: summarizeManualApplyFailures(result.failed, projectCwd()),
221
+ files: Array.isArray(result.files) ? result.files.slice(0, 20).map((file) => summarizeManualLogFile(file, projectCwd())).filter(Boolean) : [],
222
+ remainingCount: pageUrl ? (perPage[pageUrl] || 0) : totalCount,
223
+ totalCount,
224
+ });
225
+ } else {
226
+ recordManualEditActivity('manual_edit_commit_done', {
227
+ pageUrl,
228
+ provider: routedProvider,
229
+ reason: result.reason || null,
230
+ repair: result.repair || null,
231
+ appliedCount: Array.isArray(result.applied) ? result.applied.length : 0,
232
+ failedCount: Array.isArray(result.failed) ? result.failed.length : 0,
233
+ failed: summarizeManualApplyFailures(result.failed, projectCwd()),
234
+ files: Array.isArray(result.files) ? result.files.slice(0, 20).map((file) => summarizeManualLogFile(file, projectCwd())).filter(Boolean) : [],
235
+ warnings: summarizeManualDiagnostics(result.warnings, projectCwd()),
236
+ rolledBackFiles: Array.isArray(result.rolledBackFiles) ? result.rolledBackFiles.slice(0, 20).map((file) => summarizeManualLogFile(file, projectCwd())).filter(Boolean) : [],
237
+ rollbackFailures: summarizeManualDiagnostics(result.rollbackFailures, projectCwd()),
238
+ unreportedFiles: Array.isArray(result.unreportedFiles) ? result.unreportedFiles.slice(0, 20).map((file) => summarizeManualLogFile(file, projectCwd())).filter(Boolean) : undefined,
239
+ noteCount: Array.isArray(result.notes) ? result.notes.length : 0,
240
+ cleared: result.cleared || 0,
241
+ remainingCount: pageUrl ? (perPage[pageUrl] || 0) : totalCount,
242
+ totalCount,
243
+ });
244
+ }
245
+ if (!asyncMode) {
246
+ sendJson(res, 200, { ...result, totalCount, perPage });
247
+ }
248
+ })();
249
+ return true;
250
+ }
251
+
252
+ if (p === '/manual-edit-repair-decision' && req.method === 'POST') {
253
+ let body = '';
254
+ req.on('data', (chunk) => { body += chunk; });
255
+ req.on('end', () => {
256
+ let payload = {};
257
+ try { payload = body ? JSON.parse(body) : {}; } catch {
258
+ sendJson(res, 400, { error: 'Invalid JSON' });
259
+ return;
260
+ }
261
+ const token = payload.token || url.searchParams.get('token');
262
+ if (token !== getToken()) { res.writeHead(401); res.end('Unauthorized'); return; }
263
+ const pageUrl = payload.pageUrl || url.searchParams.get('pageUrl') || null;
264
+ const action = String(payload.action || url.searchParams.get('action') || '').trim().toLowerCase();
265
+ if (action !== 'rollback') {
266
+ sendJson(res, 400, { error: 'unsupported_manual_edit_repair_decision', action });
267
+ return;
268
+ }
269
+ const rollback = manualApply.rollbackTransaction({
270
+ pageUrl,
271
+ reason: 'manual_edit_user_requested_rollback',
272
+ });
273
+ const { totalCount, perPage } = countPendingByPage(projectCwd());
274
+ const response = {
275
+ action,
276
+ pageUrl,
277
+ rollback,
278
+ remainingCount: pageUrl ? (perPage[pageUrl] || 0) : totalCount,
279
+ totalCount,
280
+ perPage,
281
+ };
282
+ recordManualEditActivity('manual_edit_repair_rollback_done', response);
283
+ sendJson(res, 200, response);
284
+ });
285
+ return true;
286
+ }
287
+
288
+ if (p === '/manual-edit-discard' && req.method === 'POST') {
289
+ const token = url.searchParams.get('token');
290
+ if (token !== getToken()) { res.writeHead(401); res.end('Unauthorized'); return true; }
291
+ const pageUrl = url.searchParams.get('pageUrl');
292
+ let discarded;
293
+ let discardedEntries = [];
294
+ let canceledApplyEvents = [];
295
+ let transactionRollback = null;
296
+ try {
297
+ const buffer = readManualEditsBuffer(projectCwd());
298
+ transactionRollback = manualApply.rollbackTransaction({
299
+ pageUrl,
300
+ reason: 'manual_edit_discarded',
301
+ });
302
+ if (pageUrl) {
303
+ discardedEntries = buffer.entries.filter((entry) => entry.pageUrl === pageUrl);
304
+ discarded = removeManualEditEntries(projectCwd(), (entry) => entry.pageUrl === pageUrl);
305
+ } else {
306
+ discardedEntries = buffer.entries;
307
+ discarded = truncateManualEditsBuffer(projectCwd());
308
+ }
309
+ canceledApplyEvents = manualApply.cancelPendingEvents(pageUrl);
310
+ } catch (err) {
311
+ sendJson(res, 500, { error: 'discard_failed', message: err.message });
312
+ return true;
313
+ }
314
+ const { totalCount, perPage } = countPendingByPage(projectCwd());
315
+ recordManualEditActivity('manual_edit_discarded', {
316
+ pageUrl,
317
+ discarded,
318
+ canceledApplyIds: canceledApplyEvents.map((event) => event.id),
319
+ transactionRollback: transactionRollback ? {
320
+ id: transactionRollback.id,
321
+ rolledBackFiles: transactionRollback.rolledBackFiles?.map((file) => summarizeManualLogFile(file, projectCwd())).filter(Boolean) || [],
322
+ rollbackFailures: summarizeManualDiagnostics(transactionRollback.rollbackFailures, projectCwd()),
323
+ skipped: transactionRollback.skipped,
324
+ } : undefined,
325
+ totalCount,
326
+ });
327
+ sendJson(res, 200, { discarded, entries: discardedEntries, canceledApplyEvents, totalCount, perPage });
328
+ return true;
329
+ }
330
+
331
+ if (p === '/manual-edit' && req.method === 'POST') {
332
+ sendJson(res, 410, { error: '/manual-edit is removed; use /manual-edit-stash and /manual-edit-commit for staged copy edits.' });
333
+ return true;
334
+ }
335
+
336
+ return false;
337
+ };
338
+ }
339
+
340
+ function sendJson(res, status, body) {
341
+ res.writeHead(status, { 'Content-Type': 'application/json' });
342
+ res.end(JSON.stringify(body));
343
+ }
344
+
345
+ function summarizePendingManualEditBatch(cwd, pageUrl = null) {
346
+ try {
347
+ const buffer = readManualEditsBuffer(cwd);
348
+ const entries = (buffer.entries || [])
349
+ .filter((entry) => !pageUrl || entry.pageUrl === pageUrl);
350
+ return {
351
+ pendingEntryCount: entries.length,
352
+ pendingOpCount: entries.reduce((sum, entry) => sum + (entry.ops?.length || 0), 0),
353
+ };
354
+ } catch (err) {
355
+ return { pendingSummaryError: err.message || String(err) };
356
+ }
357
+ }
@@ -0,0 +1,152 @@
1
+ /**
2
+ * Shared helpers for the pending-manual-edits buffer on disk.
3
+ *
4
+ * Location: .impeccable/live/pending-manual-edits.json (project-local).
5
+ * Schema: { version: 1, entries: [{ id, pageUrl, element, ops, stagedAt }] }
6
+ *
7
+ * Each entry corresponds to one Save action from the browser. Ops merge by
8
+ * (pageUrl, ref): if the user re-edits the same element before committing, the
9
+ * existing entry's `newText` is replaced and `originalText` is kept (it holds
10
+ * the real source state).
11
+ */
12
+
13
+ import fs from 'node:fs';
14
+ import path from 'node:path';
15
+ import { getLiveDir } from '../lib/impeccable-paths.mjs';
16
+
17
+ const BUFFER_VERSION = 1;
18
+ const BUFFER_FILENAME = 'pending-manual-edits.json';
19
+
20
+ export function getBufferPath(cwd = process.cwd()) {
21
+ return path.join(getLiveDir(cwd), BUFFER_FILENAME);
22
+ }
23
+
24
+ export function readBuffer(cwd = process.cwd()) {
25
+ return readBufferInternal(cwd, { strict: false });
26
+ }
27
+
28
+ export function readBufferStrict(cwd = process.cwd()) {
29
+ return readBufferInternal(cwd, { strict: true });
30
+ }
31
+
32
+ function readBufferInternal(cwd, { strict }) {
33
+ const filePath = getBufferPath(cwd);
34
+ try {
35
+ const raw = fs.readFileSync(filePath, 'utf-8');
36
+ const parsed = JSON.parse(raw);
37
+ if (!parsed || typeof parsed !== 'object' || !Array.isArray(parsed.entries)) {
38
+ if (strict) throw new Error('manual_edit_buffer_invalid_schema');
39
+ return { version: BUFFER_VERSION, entries: [] };
40
+ }
41
+ return { version: BUFFER_VERSION, entries: parsed.entries };
42
+ } catch (err) {
43
+ if (strict && err?.code !== 'ENOENT') {
44
+ throw new Error('manual_edit_buffer_unreadable: ' + (err.message || String(err)));
45
+ }
46
+ return { version: BUFFER_VERSION, entries: [] };
47
+ }
48
+ }
49
+
50
+ export function writeBuffer(cwd, buffer) {
51
+ const filePath = getBufferPath(cwd);
52
+ fs.mkdirSync(path.dirname(filePath), { recursive: true });
53
+ fs.writeFileSync(filePath, JSON.stringify({ version: BUFFER_VERSION, entries: buffer.entries }, null, 2));
54
+ }
55
+
56
+ /**
57
+ * Merge a new entry into the buffer. For each op in the new entry, if there's
58
+ * already a buffered op for the same (pageUrl, ref), update that op's newText
59
+ * and keep its original originalText (the true source state). Otherwise add
60
+ * the op (creating an entry if needed).
61
+ *
62
+ * Multiple ops in one Save are allowed; each is keyed by (pageUrl, ref).
63
+ */
64
+ export function stageEntry(cwd, newEntry) {
65
+ const buf = readBufferStrict(cwd);
66
+ const pageUrl = newEntry.pageUrl;
67
+ for (const newOp of newEntry.ops) {
68
+ let mergedIntoExisting = false;
69
+ for (const existing of buf.entries) {
70
+ if (existing.pageUrl !== pageUrl) continue;
71
+ const existingOpIdx = existing.ops.findIndex((op) => op.ref === newOp.ref);
72
+ if (existingOpIdx >= 0) {
73
+ // Keep the original source text but refresh the latest DOM/source evidence.
74
+ existing.ops[existingOpIdx] = {
75
+ ...newOp,
76
+ originalText: existing.ops[existingOpIdx].originalText,
77
+ newText: newOp.newText,
78
+ deleted: newOp.deleted || false,
79
+ };
80
+ if (newEntry.element) existing.element = newEntry.element;
81
+ existing.stagedAt = new Date().toISOString();
82
+ mergedIntoExisting = true;
83
+ break;
84
+ }
85
+ }
86
+ if (mergedIntoExisting) continue;
87
+ // No existing op for this (pageUrl, ref). Find or create an entry to hold it.
88
+ let entry = buf.entries.find((e) => e.pageUrl === pageUrl && e.id === newEntry.id);
89
+ if (!entry) {
90
+ entry = {
91
+ id: newEntry.id,
92
+ pageUrl,
93
+ element: newEntry.element,
94
+ ops: [],
95
+ stagedAt: new Date().toISOString(),
96
+ };
97
+ buf.entries.push(entry);
98
+ }
99
+ entry.ops.push(newOp);
100
+ entry.stagedAt = new Date().toISOString();
101
+ }
102
+ writeBuffer(cwd, buf);
103
+ return buf;
104
+ }
105
+
106
+ /**
107
+ * Remove entries matching a predicate. Returns count of removed *ops* (not
108
+ * entries) so callers report a unit consistent with truncateBuffer and the
109
+ * pill's per-page op count. Empty entries (no ops left) are also pruned.
110
+ */
111
+ export function removeEntries(cwd, predicate) {
112
+ const buf = readBuffer(cwd);
113
+ let removedOps = 0;
114
+ const kept = [];
115
+ for (const entry of buf.entries) {
116
+ if (predicate(entry)) {
117
+ removedOps += entry.ops?.length || 0;
118
+ } else if (entry.ops && entry.ops.length > 0) {
119
+ kept.push(entry);
120
+ }
121
+ }
122
+ buf.entries = kept;
123
+ writeBuffer(cwd, buf);
124
+ return removedOps;
125
+ }
126
+
127
+ /**
128
+ * Count by page for the counter UI. Returns { totalCount, perPage: {[pageUrl]: count} }.
129
+ */
130
+ export function countByPage(cwd = process.cwd()) {
131
+ const buf = readBuffer(cwd);
132
+ const perPage = {};
133
+ let totalCount = 0;
134
+ for (const entry of buf.entries) {
135
+ const n = entry.ops.length;
136
+ perPage[entry.pageUrl] = (perPage[entry.pageUrl] || 0) + n;
137
+ totalCount += n;
138
+ }
139
+ return { totalCount, perPage };
140
+ }
141
+
142
+ /**
143
+ * Truncate the buffer to empty (used by discard-all). Returns the count of
144
+ * removed ops.
145
+ */
146
+ export function truncateBuffer(cwd) {
147
+ const buf = readBuffer(cwd);
148
+ let removed = 0;
149
+ for (const entry of buf.entries) removed += entry.ops.length;
150
+ writeBuffer(cwd, { version: BUFFER_VERSION, entries: [] });
151
+ return removed;
152
+ }
@@ -0,0 +1,14 @@
1
+ export function eventPriority(event = {}) {
2
+ if (event.type === 'accept' || event.type === 'discard' || event.type === 'exit') return 0;
3
+ if (event.type === 'manual_edit_apply' || event.type === 'steer' || event.type === 'carbonize_cleanup') return 1;
4
+ if (event.type === 'generate') return 2;
5
+ return 3;
6
+ }
7
+
8
+ export function selectAvailablePendingEvent(entries, { now = Date.now(), types = null } = {}) {
9
+ const allowed = types instanceof Set ? types : (Array.isArray(types) ? new Set(types) : null);
10
+ return entries
11
+ .filter((entry) => !(entry.leaseUntil && entry.leaseUntil > now))
12
+ .filter((entry) => !allowed || allowed.has(entry.event?.type))
13
+ .sort((a, b) => eventPriority(a.event) - eventPriority(b.event) || a.seq - b.seq)[0] || null;
14
+ }
@@ -0,0 +1,139 @@
1
+ /**
2
+ * Project detector waivers for the live overlay (issue #639, hardened in the
3
+ * PR #645 follow-up). One place decides what the /live.js prelude serializes
4
+ * as window.__IMPECCABLE_PROJECT_IGNORES__:
5
+ *
6
+ * ignoreRules detector.ignoreRules, unioned across every live root.
7
+ * ignoreValues detector.ignoreValues entries ({rule, value, files?}),
8
+ * deduped across roots; createdAt/reason stay local.
9
+ * ignoreFiles detector.ignoreFiles globs, unioned across roots, so a
10
+ * wholly waived page scans to zero findings in the overlay
11
+ * just as it reports nothing through the CLI and the hook.
12
+ * roots served-root prefixes derived from the inject config's own
13
+ * `files` globs. Never derived from the ignore globs: one
14
+ * entry scoped to prototype/library/** would lend
15
+ * prototype/library/ as a candidate prefix to every page,
16
+ * and that rule would suppress site-wide (issue #639).
17
+ * pageFiles the inject config's `files` expanded to real project
18
+ * files, so the browser can resolve a URL to the one file it
19
+ * actually serves instead of trying every root (PR #645
20
+ * review: with src/ and public/ both served, /foo.html must
21
+ * not borrow src/foo.html's waivers while actually serving
22
+ * public/foo.html).
23
+ *
24
+ * Config is read from every root the live session spans: the appRoot the
25
+ * server chdir'd onto, plus contextRoot and repoRoot when they differ. The
26
+ * edit hook keys the same config at the session cwd (the repo root in a
27
+ * monorepo, via resolveCacheCwd), and `impeccable detect` reads it from its
28
+ * invocation cwd, so reading only the appRoot silently dropped every waiver
29
+ * in exactly the monorepo layouts the roots manifest exists for. Reading is
30
+ * additive across roots, matching readConfig's own union of config.json and
31
+ * config.local.json.
32
+ *
33
+ * In a monorepo, roots and pageFiles are serialized repo-relative (the
34
+ * appRoot's path inside the repo is prefixed), so waivers spelled from
35
+ * either root match through the resolver's suffix expansion.
36
+ */
37
+ import fs from 'node:fs';
38
+ import path from 'node:path';
39
+ import { readConfig } from '../hook-lib.mjs';
40
+ import { resolveFiles } from '../live-inject.mjs';
41
+ import { resolveLiveConfigPath } from '../lib/impeccable-paths.mjs';
42
+
43
+ // Serializing thousands of page identities into every /live.js response
44
+ // helps nobody; past this cap pageFiles is omitted and the resolver falls
45
+ // back to the served-root common ancestor, which is correct, just less
46
+ // precise about cross-root duplicates.
47
+ const PAGE_FILES_CAP = 500;
48
+
49
+ export function collectProjectDetectorIgnores({ appRoot, contextRoot, repoRoot, scriptsDir } = {}) {
50
+ const configRoots = [];
51
+ for (const dir of [appRoot, contextRoot, repoRoot]) {
52
+ if (typeof dir !== 'string' || !dir) continue;
53
+ const resolved = path.resolve(dir);
54
+ if (!configRoots.includes(resolved)) configRoots.push(resolved);
55
+ }
56
+ if (configRoots.length === 0) configRoots.push(process.cwd());
57
+
58
+ const ignoreRules = new Set();
59
+ const ignoreFiles = new Set();
60
+ const valueEntries = new Map();
61
+ for (const dir of configRoots) {
62
+ // readConfig merges config.json with the gitignored config.local.json
63
+ // and type-checks both, exactly as the edit hook reads the same pair.
64
+ const config = readConfig(dir);
65
+ for (const rule of Array.isArray(config.ignoreRules) ? config.ignoreRules : []) {
66
+ if (typeof rule === 'string' && rule.trim()) ignoreRules.add(rule);
67
+ }
68
+ for (const glob of Array.isArray(config.ignoreFiles) ? config.ignoreFiles : []) {
69
+ if (typeof glob === 'string' && glob.trim()) ignoreFiles.add(glob);
70
+ }
71
+ for (const entry of Array.isArray(config.ignoreValues) ? config.ignoreValues : []) {
72
+ if (!entry || typeof entry !== 'object') continue;
73
+ // readConfig already normalized rule/value and folded `file` into
74
+ // `files`; serve only what the browser matches on.
75
+ const serialized = {
76
+ rule: entry.rule,
77
+ value: entry.value,
78
+ ...(Array.isArray(entry.files) && entry.files.length > 0 ? { files: entry.files } : {}),
79
+ };
80
+ const key = JSON.stringify([serialized.rule, serialized.value,
81
+ Array.isArray(serialized.files) ? [...serialized.files].sort() : []]);
82
+ if (!valueEntries.has(key)) valueEntries.set(key, serialized);
83
+ }
84
+ }
85
+
86
+ const served = readLiveServedPages({ appRoot: configRoots[0], repoRoot, scriptsDir });
87
+ return {
88
+ ignoreRules: [...ignoreRules],
89
+ ignoreValues: [...valueEntries.values()],
90
+ ignoreFiles: [...ignoreFiles],
91
+ roots: served.roots,
92
+ pageFiles: served.pageFiles,
93
+ };
94
+ }
95
+
96
+ function readLiveServedPages({ appRoot, repoRoot, scriptsDir }) {
97
+ let live = null;
98
+ try {
99
+ const configPath = resolveLiveConfigPath({ cwd: appRoot, scriptsDir });
100
+ live = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
101
+ } catch {
102
+ // No readable inject config: the browser matches URL paths as-is.
103
+ return { roots: [], pageFiles: [] };
104
+ }
105
+ const files = Array.isArray(live?.files)
106
+ ? live.files.filter((glob) => typeof glob === 'string' && glob)
107
+ : [];
108
+
109
+ // A monorepo appRoot serializes identities repo-relative, so waivers
110
+ // spelled from either root match through the resolver's suffix expansion.
111
+ let prefix = '';
112
+ if (typeof repoRoot === 'string' && repoRoot) {
113
+ const rel = path.relative(path.resolve(repoRoot), path.resolve(appRoot)).split(path.sep).join('/');
114
+ if (rel && !rel.startsWith('..') && !path.isAbsolute(rel)) prefix = `${rel}/`;
115
+ }
116
+
117
+ const roots = [...new Set(files.map((glob) => {
118
+ const wildcardAt = glob.search(/[*?{]/);
119
+ const head = wildcardAt === -1 ? glob : glob.slice(0, wildcardAt);
120
+ const cut = head.lastIndexOf('/');
121
+ return prefix + (cut > -1 ? head.slice(0, cut + 1) : '');
122
+ }))];
123
+
124
+ let pageFiles = [];
125
+ try {
126
+ pageFiles = resolveFiles(appRoot, { ...live, files })
127
+ .filter((rel) => {
128
+ // resolveFiles passes literal entries through even when they do not
129
+ // exist; a missing file is nobody's identity.
130
+ try { return fs.statSync(path.join(appRoot, rel)).isFile(); } catch { return false; }
131
+ })
132
+ .map((rel) => prefix + rel);
133
+ } catch {
134
+ pageFiles = [];
135
+ }
136
+ if (pageFiles.length > PAGE_FILES_CAP) pageFiles = [];
137
+
138
+ return { roots, pageFiles };
139
+ }