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.
- package/LICENSE +27 -0
- package/README.md +195 -2
- package/dist/agent-memory-prompts.d.ts +13 -0
- package/dist/agent-memory-prompts.js +55 -0
- package/dist/cli.d.ts +2 -0
- package/dist/cli.js +6 -0
- package/dist/closeout.d.ts +105 -0
- package/dist/closeout.js +473 -0
- package/dist/code.d.ts +39 -0
- package/dist/code.js +124 -0
- package/dist/codex-memory.d.ts +24 -0
- package/dist/codex-memory.js +217 -0
- package/dist/common.d.ts +16 -0
- package/dist/common.js +52 -0
- package/dist/context-envelope.d.ts +59 -0
- package/dist/context-envelope.js +23 -0
- package/dist/host-adapters.d.ts +34 -0
- package/dist/host-adapters.js +151 -0
- package/dist/http.d.ts +3 -0
- package/dist/http.js +90 -0
- package/dist/index.d.ts +16 -0
- package/dist/index.js +13 -0
- package/dist/knowledge-cli.d.ts +198 -0
- package/dist/knowledge-cli.js +761 -0
- package/dist/knowledge-reads.d.ts +72 -0
- package/dist/knowledge-reads.js +201 -0
- package/dist/memory-config.d.ts +44 -0
- package/dist/memory-config.js +204 -0
- package/dist/memory-evidence.d.ts +13 -0
- package/dist/memory-evidence.js +40 -0
- package/dist/memory-history.d.ts +46 -0
- package/dist/memory-history.js +432 -0
- package/dist/memory.d.ts +96 -0
- package/dist/memory.js +362 -0
- package/dist/retrospective.d.ts +57 -0
- package/dist/retrospective.js +240 -0
- package/dist/search.d.ts +36 -0
- package/dist/search.js +112 -0
- package/dist/skill-addition.d.ts +25 -0
- package/dist/skill-addition.js +89 -0
- package/dist/skill-design.d.ts +96 -0
- package/dist/skill-design.js +226 -0
- package/dist/skill-replay.d.ts +55 -0
- package/dist/skill-replay.js +448 -0
- package/dist/skill-route.d.ts +30 -0
- package/dist/skill-route.js +75 -0
- package/dist/transcript-evidence.d.ts +3 -0
- package/dist/transcript-evidence.js +58 -0
- package/dist/upstream/chunker.d.ts +24 -0
- package/dist/upstream/chunker.js +96 -0
- package/dist/upstream/file-protocol.d.ts +45 -0
- package/dist/upstream/file-protocol.js +117 -0
- package/dist/upstream/frontmatter.d.ts +47 -0
- package/dist/upstream/frontmatter.js +86 -0
- package/dist/upstream/graph-search.d.ts +33 -0
- package/dist/upstream/graph-search.js +67 -0
- package/dist/upstream/l1-extraction.d.ts +26 -0
- package/dist/upstream/l1-extraction.js +405 -0
- package/dist/upstream/llm.d.ts +8 -0
- package/dist/upstream/llm.js +1 -0
- package/dist/upstream/merge.d.ts +50 -0
- package/dist/upstream/merge.js +153 -0
- package/dist/upstream/prompts.d.ts +53 -0
- package/dist/upstream/prompts.js +181 -0
- package/dist/upstream/search-utils.d.ts +34 -0
- package/dist/upstream/search-utils.js +55 -0
- package/dist/upstream/slug.d.ts +26 -0
- package/dist/upstream/slug.js +103 -0
- package/dist/upstream/template.d.ts +29 -0
- package/dist/upstream/template.js +80 -0
- package/dist/upstream/tokenize.d.ts +4 -0
- package/dist/upstream/tokenize.js +29 -0
- package/dist/wiki-change.d.ts +76 -0
- package/dist/wiki-change.js +299 -0
- package/dist/wiki-entry.d.ts +26 -0
- package/dist/wiki-entry.js +93 -0
- package/dist/wiki-ingest.d.ts +12 -0
- package/dist/wiki-ingest.js +126 -0
- package/dist/wiki-migration.d.ts +16 -0
- package/dist/wiki-migration.js +268 -0
- package/dist/wiki-tokens.d.ts +1 -0
- package/dist/wiki-tokens.js +46 -0
- package/dist/wiki.d.ts +103 -0
- package/dist/wiki.js +330 -0
- package/dist/workflow-cli.d.ts +2 -0
- package/dist/workflow-cli.js +319 -0
- package/dist/workflow-install.d.ts +37 -0
- package/dist/workflow-install.js +148 -0
- package/dist/workflow-knowledge.d.ts +18 -0
- package/dist/workflow-knowledge.js +32 -0
- package/dist/workflow-mcp.d.ts +2 -0
- package/dist/workflow-mcp.js +137 -0
- package/dist/workflow-names.d.ts +4 -0
- package/dist/workflow-names.js +31 -0
- package/dist/workflow-runtime.d.ts +735 -0
- package/dist/workflow-runtime.js +747 -0
- package/dist/workflow-skills.d.ts +48 -0
- package/dist/workflow-skills.js +141 -0
- package/docs/images/impeccable-skill.png +0 -0
- package/docs/images/workflow-overview.png +0 -0
- package/docs/images/workflow-skills.png +0 -0
- package/package.json +77 -4
- package/skills/ew-impeccable/LICENSE +191 -0
- package/skills/ew-impeccable/NOTICE.md +19 -0
- package/skills/ew-impeccable/SKILL.md +91 -0
- package/skills/ew-impeccable/UPSTREAM.md +23 -0
- package/skills/ew-impeccable/reference/adapt.md +314 -0
- package/skills/ew-impeccable/reference/adapt.native.md +60 -0
- package/skills/ew-impeccable/reference/android.md +46 -0
- package/skills/ew-impeccable/reference/animate.md +91 -0
- package/skills/ew-impeccable/reference/audit.md +138 -0
- package/skills/ew-impeccable/reference/audit.native.md +141 -0
- package/skills/ew-impeccable/reference/bolder.md +35 -0
- package/skills/ew-impeccable/reference/clarify.md +96 -0
- package/skills/ew-impeccable/reference/colorize.md +88 -0
- package/skills/ew-impeccable/reference/craft-floor.md +44 -0
- package/skills/ew-impeccable/reference/craft.md +5 -0
- package/skills/ew-impeccable/reference/critique.md +808 -0
- package/skills/ew-impeccable/reference/degraded/asset-producer.md +36 -0
- package/skills/ew-impeccable/reference/degraded/documenter.md +23 -0
- package/skills/ew-impeccable/reference/degraded/finish-reviewer.md +72 -0
- package/skills/ew-impeccable/reference/degraded/manual-edit-applier.md +91 -0
- package/skills/ew-impeccable/reference/delight.md +72 -0
- package/skills/ew-impeccable/reference/distill.md +113 -0
- package/skills/ew-impeccable/reference/doctor.md +56 -0
- package/skills/ew-impeccable/reference/document.md +418 -0
- package/skills/ew-impeccable/reference/extract.md +68 -0
- package/skills/ew-impeccable/reference/harden.md +338 -0
- package/skills/ew-impeccable/reference/hooks.md +113 -0
- package/skills/ew-impeccable/reference/init.md +133 -0
- package/skills/ew-impeccable/reference/ios.md +51 -0
- package/skills/ew-impeccable/reference/layout.md +86 -0
- package/skills/ew-impeccable/reference/live-setup.md +102 -0
- package/skills/ew-impeccable/reference/live.md +326 -0
- package/skills/ew-impeccable/reference/new-work.md +209 -0
- package/skills/ew-impeccable/reference/onboard.md +236 -0
- package/skills/ew-impeccable/reference/operate.md +61 -0
- package/skills/ew-impeccable/reference/optimize.md +260 -0
- package/skills/ew-impeccable/reference/overdrive.md +127 -0
- package/skills/ew-impeccable/reference/polish.md +105 -0
- package/skills/ew-impeccable/reference/quieter.md +101 -0
- package/skills/ew-impeccable/reference/routing.md +20 -0
- package/skills/ew-impeccable/reference/shape.md +59 -0
- package/skills/ew-impeccable/reference/typeset.md +82 -0
- package/skills/ew-impeccable/reference/visualize.md +46 -0
- package/skills/ew-impeccable/scripts/build-phase.mjs +1022 -0
- package/skills/ew-impeccable/scripts/command-metadata.json +94 -0
- package/skills/ew-impeccable/scripts/comp-diff.mjs +391 -0
- package/skills/ew-impeccable/scripts/comp-spec.mjs +513 -0
- package/skills/ew-impeccable/scripts/concept-seed.mjs +814 -0
- package/skills/ew-impeccable/scripts/context-signals.mjs +325 -0
- package/skills/ew-impeccable/scripts/context.mjs +1521 -0
- package/skills/ew-impeccable/scripts/critique-storage.mjs +473 -0
- package/skills/ew-impeccable/scripts/data/font-index-failures.json +121 -0
- package/skills/ew-impeccable/scripts/data/font-index.json +1 -0
- package/skills/ew-impeccable/scripts/detect-csp.mjs +246 -0
- package/skills/ew-impeccable/scripts/detect.mjs +30 -0
- package/skills/ew-impeccable/scripts/detector/browser/injected/index.mjs +2580 -0
- package/skills/ew-impeccable/scripts/detector/cli/main.mjs +498 -0
- package/skills/ew-impeccable/scripts/detector/design-system.mjs +1311 -0
- package/skills/ew-impeccable/scripts/detector/detect-antipatterns-browser.js +9486 -0
- package/skills/ew-impeccable/scripts/detector/detect-antipatterns.mjs +51 -0
- package/skills/ew-impeccable/scripts/detector/engines/browser/detect-url.mjs +434 -0
- package/skills/ew-impeccable/scripts/detector/engines/regex/detect-text.mjs +1439 -0
- package/skills/ew-impeccable/scripts/detector/engines/static-html/css-cascade.mjs +1242 -0
- package/skills/ew-impeccable/scripts/detector/engines/static-html/detect-html.mjs +263 -0
- package/skills/ew-impeccable/scripts/detector/engines/visual/screenshot-contrast.mjs +189 -0
- package/skills/ew-impeccable/scripts/detector/findings.mjs +23 -0
- package/skills/ew-impeccable/scripts/detector/node/file-system.mjs +225 -0
- package/skills/ew-impeccable/scripts/detector/profile/profiler.mjs +166 -0
- package/skills/ew-impeccable/scripts/detector/registry/antipatterns.mjs +636 -0
- package/skills/ew-impeccable/scripts/detector/rules/checks.mjs +5750 -0
- package/skills/ew-impeccable/scripts/detector/shared/color.mjs +596 -0
- package/skills/ew-impeccable/scripts/detector/shared/constants.mjs +127 -0
- package/skills/ew-impeccable/scripts/detector/shared/fonts.mjs +30 -0
- package/skills/ew-impeccable/scripts/detector/shared/inline-ignores.mjs +148 -0
- package/skills/ew-impeccable/scripts/detector/shared/page.mjs +7 -0
- package/skills/ew-impeccable/scripts/detector/vendor/MDN-DATA-LICENSE +116 -0
- package/skills/ew-impeccable/scripts/detector/vendor/THIRD_PARTY_LICENSES.md +227 -0
- package/skills/ew-impeccable/scripts/detector/vendor/static-html-parser.build-entry.txt +11 -0
- package/skills/ew-impeccable/scripts/detector/vendor/static-html-parser.bundle.mjs +9121 -0
- package/skills/ew-impeccable/scripts/doctor.mjs +330 -0
- package/skills/ew-impeccable/scripts/embed-prompt.mjs +166 -0
- package/skills/ew-impeccable/scripts/font-match.mjs +457 -0
- package/skills/ew-impeccable/scripts/generate-image.mjs +447 -0
- package/skills/ew-impeccable/scripts/hook-admin.mjs +829 -0
- package/skills/ew-impeccable/scripts/hook-before-edit.mjs +538 -0
- package/skills/ew-impeccable/scripts/hook-lib.mjs +2493 -0
- package/skills/ew-impeccable/scripts/hook.mjs +79 -0
- package/skills/ew-impeccable/scripts/lib/artifact-schema.mjs +93 -0
- package/skills/ew-impeccable/scripts/lib/composition-catalog.mjs +200 -0
- package/skills/ew-impeccable/scripts/lib/concept-catalog.mjs +395 -0
- package/skills/ew-impeccable/scripts/lib/design-parser.mjs +880 -0
- package/skills/ew-impeccable/scripts/lib/font-fingerprint.mjs +564 -0
- package/skills/ew-impeccable/scripts/lib/font-index.mjs +130 -0
- package/skills/ew-impeccable/scripts/lib/hero-checks.mjs +246 -0
- package/skills/ew-impeccable/scripts/lib/image-metrics.mjs +306 -0
- package/skills/ew-impeccable/scripts/lib/impeccable-config.mjs +640 -0
- package/skills/ew-impeccable/scripts/lib/impeccable-paths.mjs +137 -0
- package/skills/ew-impeccable/scripts/lib/is-generated.mjs +72 -0
- package/skills/ew-impeccable/scripts/lib/live-path-globs.mjs +37 -0
- package/skills/ew-impeccable/scripts/lib/open-system-browser.mjs +26 -0
- package/skills/ew-impeccable/scripts/lib/png.mjs +281 -0
- package/skills/ew-impeccable/scripts/lib/provider.mjs +5 -0
- package/skills/ew-impeccable/scripts/lib/raster.mjs +194 -0
- package/skills/ew-impeccable/scripts/lib/roll-selection.mjs +369 -0
- package/skills/ew-impeccable/scripts/lib/staleness-deep.mjs +491 -0
- package/skills/ew-impeccable/scripts/lib/staleness-notice.mjs +169 -0
- package/skills/ew-impeccable/scripts/lib/staleness.mjs +532 -0
- package/skills/ew-impeccable/scripts/lib/surface-briefs.mjs +149 -0
- package/skills/ew-impeccable/scripts/lib/target-args.mjs +42 -0
- package/skills/ew-impeccable/scripts/lib/target-slug.mjs +33 -0
- package/skills/ew-impeccable/scripts/lib/template-extensions.mjs +146 -0
- package/skills/ew-impeccable/scripts/live/accept-css.mjs +617 -0
- package/skills/ew-impeccable/scripts/live/accept-verify.mjs +60 -0
- package/skills/ew-impeccable/scripts/live/browser-script-parts.mjs +84 -0
- package/skills/ew-impeccable/scripts/live/completion.mjs +28 -0
- package/skills/ew-impeccable/scripts/live/event-validation.mjs +199 -0
- package/skills/ew-impeccable/scripts/live/frameworks/astro.mjs +47 -0
- package/skills/ew-impeccable/scripts/live/frameworks/detect-utils.mjs +73 -0
- package/skills/ew-impeccable/scripts/live/frameworks/index.mjs +143 -0
- package/skills/ew-impeccable/scripts/live/frameworks/journal.mjs +197 -0
- package/skills/ew-impeccable/scripts/live/frameworks/nextjs.mjs +49 -0
- package/skills/ew-impeccable/scripts/live/frameworks/nuxt.mjs +161 -0
- package/skills/ew-impeccable/scripts/live/frameworks/script-src.mjs +17 -0
- package/skills/ew-impeccable/scripts/live/frameworks/static-html.mjs +26 -0
- package/skills/ew-impeccable/scripts/live/frameworks/sveltekit.mjs +71 -0
- package/skills/ew-impeccable/scripts/live/frameworks/tag-strategy.mjs +247 -0
- package/skills/ew-impeccable/scripts/live/frameworks/tanstack-start.mjs +70 -0
- package/skills/ew-impeccable/scripts/live/frameworks/vite-generic.mjs +42 -0
- package/skills/ew-impeccable/scripts/live/generation-preflight.mjs +149 -0
- package/skills/ew-impeccable/scripts/live/insert-ui.mjs +458 -0
- package/skills/ew-impeccable/scripts/live/instructions.mjs +142 -0
- package/skills/ew-impeccable/scripts/live/manual-apply.mjs +939 -0
- package/skills/ew-impeccable/scripts/live/manual-edit-routes.mjs +357 -0
- package/skills/ew-impeccable/scripts/live/manual-edits-buffer.mjs +152 -0
- package/skills/ew-impeccable/scripts/live/poll-lanes.mjs +14 -0
- package/skills/ew-impeccable/scripts/live/project-ignores.mjs +139 -0
- package/skills/ew-impeccable/scripts/live/roots.mjs +508 -0
- package/skills/ew-impeccable/scripts/live/session-store.mjs +563 -0
- package/skills/ew-impeccable/scripts/live/source-lock.mjs +105 -0
- package/skills/ew-impeccable/scripts/live/source-search.mjs +105 -0
- package/skills/ew-impeccable/scripts/live/svelte-ast.mjs +969 -0
- package/skills/ew-impeccable/scripts/live/svelte-component.mjs +1366 -0
- package/skills/ew-impeccable/scripts/live/sveltekit-adapter.mjs +304 -0
- package/skills/ew-impeccable/scripts/live/tanstack-adapter.mjs +259 -0
- package/skills/ew-impeccable/scripts/live/ui-surfaces.mjs +75 -0
- package/skills/ew-impeccable/scripts/live/vocabulary.mjs +171 -0
- package/skills/ew-impeccable/scripts/live-accept.mjs +938 -0
- package/skills/ew-impeccable/scripts/live-browser-dom.js +167 -0
- package/skills/ew-impeccable/scripts/live-browser-ignores.js +242 -0
- package/skills/ew-impeccable/scripts/live-browser-session.js +144 -0
- package/skills/ew-impeccable/scripts/live-browser.js +12851 -0
- package/skills/ew-impeccable/scripts/live-commit-manual-edits.mjs +1200 -0
- package/skills/ew-impeccable/scripts/live-complete.mjs +107 -0
- package/skills/ew-impeccable/scripts/live-copy-edit-agent.mjs +800 -0
- package/skills/ew-impeccable/scripts/live-discard-manual-edits.mjs +51 -0
- package/skills/ew-impeccable/scripts/live-inject.mjs +463 -0
- package/skills/ew-impeccable/scripts/live-insert.mjs +292 -0
- package/skills/ew-impeccable/scripts/live-manual-edit-evidence.mjs +368 -0
- package/skills/ew-impeccable/scripts/live-poll.mjs +430 -0
- package/skills/ew-impeccable/scripts/live-resume.mjs +123 -0
- package/skills/ew-impeccable/scripts/live-server.mjs +1698 -0
- package/skills/ew-impeccable/scripts/live-status.mjs +71 -0
- package/skills/ew-impeccable/scripts/live-target.mjs +30 -0
- package/skills/ew-impeccable/scripts/live-wrap.mjs +927 -0
- package/skills/ew-impeccable/scripts/live.mjs +334 -0
- package/skills/ew-impeccable/scripts/modern-screenshot.umd.js +14 -0
- package/skills/ew-impeccable/scripts/palette.mjs +628 -0
- package/skills/ew-impeccable/scripts/pin.mjs +352 -0
- package/skills/ew-impeccable/scripts/serve-question.mjs +1783 -0
- package/skills/ew-impeccable/scripts/surface-brief.mjs +74 -0
- package/skills/ew-knowledge/SKILL.md +35 -0
- package/skills/ew-knowledge/references/closeout-protocol.md +68 -0
- package/skills/ew-knowledge/references/knowledge-route.md +73 -0
- package/skills/ew-knowledge/references/wiki-maintenance.md +27 -0
- package/skills/ew-odyssey/SKILL.md +106 -0
- package/skills/ew-odyssey/references/audit-artifacts.md +7 -0
- package/skills/ew-odyssey/references/odyssey-base.md +104 -0
- package/skills/ew-odyssey/references/odyssey-debug.md +264 -0
- package/skills/ew-odyssey/references/odyssey-defensive.md +351 -0
- package/skills/ew-odyssey/references/odyssey-improve.md +230 -0
- package/skills/ew-odyssey/references/odyssey-planex.md +294 -0
- package/skills/ew-odyssey/references/odyssey-review.md +233 -0
- package/skills/ew-odyssey/references/odyssey-security.md +231 -0
- package/skills/ew-odyssey/references/odyssey-ui.md +232 -0
- package/skills/ew-odyssey/references/prepare/odyssey-debug.md +102 -0
- package/skills/ew-odyssey/references/prepare/odyssey-defensive.md +117 -0
- package/skills/ew-odyssey/references/prepare/odyssey-improve.md +95 -0
- package/skills/ew-odyssey/references/prepare/odyssey-planex.md +105 -0
- package/skills/ew-odyssey/references/prepare/odyssey-review.md +105 -0
- package/skills/ew-odyssey/references/prepare/odyssey-security.md +91 -0
- package/skills/ew-odyssey/references/prepare/odyssey-ui.md +88 -0
- package/skills/ew-odyssey/references/runtime-adapters.md +31 -0
- package/skills/ew-orchestrate/SKILL.md +89 -0
- package/skills/ew-orchestrate/references/auto-policy.md +66 -0
- package/skills/ew-orchestrate/references/boundary-grill.md +51 -0
- package/skills/ew-orchestrate/references/companion-route.md +40 -0
- package/skills/ew-orchestrate/references/ew-orchestrate.md +44 -0
- package/skills/ew-orchestrate/references/goal.md +51 -0
- package/skills/ew-orchestrate/references/orchestrator-run-loop.md +33 -0
- package/skills/ew-orchestrate/references/planning.md +54 -0
- package/skills/ew-orchestrate/steps/ew-analyze/SKILL.md +70 -0
- package/skills/ew-orchestrate/steps/ew-analyze/references/issue-gaps-analyze.md +24 -0
- package/skills/ew-orchestrate/steps/ew-analyze/references/prepare.md +8 -0
- package/skills/ew-orchestrate/steps/ew-analyze/references/workflow.md +138 -0
- package/skills/ew-orchestrate/steps/ew-auto-test/SKILL.md +80 -0
- package/skills/ew-orchestrate/steps/ew-auto-test/references/prepare.md +23 -0
- package/skills/ew-orchestrate/steps/ew-auto-test/references/workflow.md +31 -0
- package/skills/ew-orchestrate/steps/ew-blueprint/SKILL.md +122 -0
- package/skills/ew-orchestrate/steps/ew-blueprint/references/prepare.md +21 -0
- package/skills/ew-orchestrate/steps/ew-blueprint/references/workflow.md +28 -0
- package/skills/ew-orchestrate/steps/ew-brainstorm/SKILL.md +49 -0
- package/skills/ew-orchestrate/steps/ew-companion/SKILL.md +50 -0
- package/skills/ew-orchestrate/steps/ew-debug/SKILL.md +85 -0
- package/skills/ew-orchestrate/steps/ew-debug/references/prepare.md +27 -0
- package/skills/ew-orchestrate/steps/ew-debug/references/workflow.md +31 -0
- package/skills/ew-orchestrate/steps/ew-execute/SKILL.md +74 -0
- package/skills/ew-orchestrate/steps/ew-execute/references/prepare.md +27 -0
- package/skills/ew-orchestrate/steps/ew-execute/references/workflow.md +87 -0
- package/skills/ew-orchestrate/steps/ew-grill/SKILL.md +62 -0
- package/skills/ew-orchestrate/steps/ew-grill/references/prepare.md +26 -0
- package/skills/ew-orchestrate/steps/ew-grill/references/workflow.md +31 -0
- package/skills/ew-orchestrate/steps/ew-init/SKILL.md +56 -0
- package/skills/ew-orchestrate/steps/ew-init/references/prepare.md +25 -0
- package/skills/ew-orchestrate/steps/ew-init/references/workflow.md +28 -0
- package/skills/ew-orchestrate/steps/ew-plan/SKILL.md +131 -0
- package/skills/ew-orchestrate/steps/ew-plan/references/prepare.md +8 -0
- package/skills/ew-orchestrate/steps/ew-plan/references/tdd.md +53 -0
- package/skills/ew-orchestrate/steps/ew-plan/references/workflow.md +100 -0
- package/skills/ew-orchestrate/steps/ew-retrospective/SKILL.md +68 -0
- package/skills/ew-orchestrate/steps/ew-retrospective/references/prepare.md +18 -0
- package/skills/ew-orchestrate/steps/ew-retrospective/references/workflow.md +34 -0
- package/skills/ew-orchestrate/steps/ew-review/SKILL.md +45 -0
- package/skills/ew-orchestrate/steps/ew-review/references/prepare.md +17 -0
- package/skills/ew-orchestrate/steps/ew-review/references/workflow.md +116 -0
- package/skills/ew-orchestrate/steps/ew-roadmap/SKILL.md +62 -0
- package/skills/ew-orchestrate/steps/ew-roadmap/references/prepare.md +27 -0
- package/skills/ew-orchestrate/steps/ew-roadmap/references/workflow.md +28 -0
- package/skills/ew-orchestrate/steps/ew-test/SKILL.md +99 -0
- package/skills/ew-orchestrate/steps/ew-test/references/prepare.md +23 -0
- package/skills/ew-orchestrate/steps/ew-test/references/workflow.md +23 -0
- package/skills/ew-orchestrate/steps/ew-verify/SKILL.md +73 -0
- package/skills/ew-orchestrate/steps/ew-verify/references/prepare.md +21 -0
- package/skills/ew-orchestrate/steps/ew-verify/references/workflow.md +29 -0
- package/skills/ew-skill-design/SKILL.md +30 -0
- package/skills/ew-skill-design/references/package-contract.md +40 -0
- package/skills/ew-skill-design/references/validation.md +21 -0
- package/skills/team-swarm/SKILL.md +68 -0
- package/skills/team-swarm/references/mcp-coordination.md +14 -0
- package/skills/team-swarm/roles/analyst/role.md +181 -0
- package/skills/team-swarm/roles/ant/role.md +149 -0
- package/skills/team-swarm/roles/coordinator/commands/converge.md +112 -0
- package/skills/team-swarm/roles/coordinator/commands/init-swarm.md +136 -0
- package/skills/team-swarm/roles/coordinator/commands/iterate.md +171 -0
- package/skills/team-swarm/roles/coordinator/role.md +170 -0
- package/skills/team-swarm/roles/scorer/role.md +150 -0
- package/skills/team-swarm/scripts/aco.py +646 -0
- package/skills/team-swarm/scripts/pheromone.py +144 -0
- package/skills/team-swarm/scripts/scoring.py +111 -0
- package/skills/team-swarm/scripts/test_aco.py +606 -0
- package/skills/team-swarm/specs/ant-output-schema.md +127 -0
- package/skills/team-swarm/specs/convergence-criteria.md +108 -0
- package/skills/team-swarm/specs/pheromone-schema.md +125 -0
- package/skills/team-swarm/specs/swarm-config-template.json +71 -0
- package/skills/team-swarm/specs/swarm-protocol.md +119 -0
- package/skills/workflow-evolve/SKILL.md +64 -0
- package/skills/workflow-evolve/references/agy-gate.md +27 -0
- package/skills/workflow-evolve/references/auto-loop.md +23 -0
- package/skills/workflow-evolve/references/history-review.md +15 -0
- package/skills/workflow-evolve/scripts/codex-memory-replay.mjs +86 -0
- package/skills/workflow-evolve/scripts/codex-replay.mjs +1 -0
- package/skills/workflow-evolve/scripts/evolve-loop.mjs +260 -0
- package/skills/workflow-evolve/scripts/memory-codex-mcp.mjs +124 -0
- 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
|
+
}
|