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,51 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Anti-Pattern Detector for Impeccable
|
|
5
|
+
* Copyright (c) 2026 Paul Bakaus
|
|
6
|
+
* SPDX-License-Identifier: Apache-2.0
|
|
7
|
+
*
|
|
8
|
+
* Public API facade. Runtime engines live under cli/engine/engines/.
|
|
9
|
+
*/
|
|
10
|
+
|
|
11
|
+
import { detectCli } from './cli/main.mjs';
|
|
12
|
+
|
|
13
|
+
export { ANTIPATTERNS, RULE_ENGINE_SUPPORT, getAntipattern, getRulesForCategory, getRuleEngineSupport } from './registry/antipatterns.mjs';
|
|
14
|
+
export { SAFE_TAGS, BORDER_SAFE_TAGS, OVERUSED_FONTS, GENERIC_FONTS, KNOWN_SERIF_FONTS } from './shared/constants.mjs';
|
|
15
|
+
export { isNeutralColor, parseRgb, relativeLuminance, contrastRatio, parseGradientColors, hasChroma, getHue, colorToHex } from './shared/color.mjs';
|
|
16
|
+
export { isFullPage } from './shared/page.mjs';
|
|
17
|
+
export {
|
|
18
|
+
checkElementBorders,
|
|
19
|
+
checkElementMotion,
|
|
20
|
+
checkElementGlow,
|
|
21
|
+
checkPageTypography,
|
|
22
|
+
checkPageLayout,
|
|
23
|
+
checkHtmlPatterns,
|
|
24
|
+
} from './rules/checks.mjs';
|
|
25
|
+
export { createDetectorProfile, summarizeDetectorProfile } from './profile/profiler.mjs';
|
|
26
|
+
export {
|
|
27
|
+
parseFrontmatter as parseDesignFrontmatter,
|
|
28
|
+
normalizeDesignSystem,
|
|
29
|
+
loadDesignSystemForCwd,
|
|
30
|
+
checkSourceDesignSystem,
|
|
31
|
+
collectStaticDesignSystemFindings,
|
|
32
|
+
} from './design-system.mjs';
|
|
33
|
+
export { detectHtml } from './engines/static-html/detect-html.mjs';
|
|
34
|
+
export { detectUrl, createBrowserDetector } from './engines/browser/detect-url.mjs';
|
|
35
|
+
export { detectText, extractStyleBlocks, extractCSSinJS } from './engines/regex/detect-text.mjs';
|
|
36
|
+
export {
|
|
37
|
+
walkDir,
|
|
38
|
+
hasScannableExtension,
|
|
39
|
+
SCANNABLE_EXTENSIONS,
|
|
40
|
+
SKIP_DIRS,
|
|
41
|
+
buildImportGraph,
|
|
42
|
+
resolveImport,
|
|
43
|
+
detectFrameworkConfig,
|
|
44
|
+
isPortListening,
|
|
45
|
+
FRAMEWORK_CONFIGS,
|
|
46
|
+
} from './node/file-system.mjs';
|
|
47
|
+
export { formatFindings, detectCli } from './cli/main.mjs';
|
|
48
|
+
|
|
49
|
+
const isMainModule = process.argv[1]?.endsWith('detect-antipatterns.mjs') ||
|
|
50
|
+
process.argv[1]?.endsWith('detect-antipatterns.mjs/');
|
|
51
|
+
if (isMainModule) detectCli();
|
|
@@ -0,0 +1,434 @@
|
|
|
1
|
+
import fs from 'node:fs';
|
|
2
|
+
import path from 'node:path';
|
|
3
|
+
import { fileURLToPath } from 'node:url';
|
|
4
|
+
|
|
5
|
+
import { deriveAdvisoryFlag, finding } from '../../findings.mjs';
|
|
6
|
+
import { profileFindingsAsync, profileStep, profileStepAsync } from '../../profile/profiler.mjs';
|
|
7
|
+
import { captureVisualContrastCandidate } from '../visual/screenshot-contrast.mjs';
|
|
8
|
+
import { checkContentHiddenAtRest } from '../../rules/checks.mjs';
|
|
9
|
+
|
|
10
|
+
// On Windows, puppeteer's bundled Chrome lives in a user-writable cache
|
|
11
|
+
// directory. Its GPU process can be denied (STATUS_ACCESS_DENIED) by security
|
|
12
|
+
// software or the GPU sandbox because it launches from an untrusted path.
|
|
13
|
+
// Chrome then crash-loops the GPU process, and each relaunch briefly flashes a
|
|
14
|
+
// compositor surface, the black window users report during `detect <url>`
|
|
15
|
+
// (issue #372). The system-installed Chrome runs from a trusted location with a
|
|
16
|
+
// healthy GPU, so channel:'chrome' avoids the crash entirely; both use hardware
|
|
17
|
+
// GPU, so contrast measurement is unaffected. Scope this to Windows only: other
|
|
18
|
+
// platforms do not have the bug, so they keep the pinned bundled build for
|
|
19
|
+
// consistent measurement across machines. Fall back to bundled when the switch
|
|
20
|
+
// fails (Chrome not installed, or channel resolution fails). If the bundled
|
|
21
|
+
// launch then also fails, surface the original system-Chrome error as the
|
|
22
|
+
// cause so the real failure is not lost.
|
|
23
|
+
async function launchBrowser(puppeteer, { headless = true, args = [] } = {}) {
|
|
24
|
+
let channelError;
|
|
25
|
+
if (process.platform === 'win32') {
|
|
26
|
+
try {
|
|
27
|
+
return await puppeteer.default.launch({ channel: 'chrome', headless, args });
|
|
28
|
+
} catch (err) {
|
|
29
|
+
// System Chrome unavailable or unlaunchable; fall through to the bundled
|
|
30
|
+
// browser, but keep the error in case the fallback fails too.
|
|
31
|
+
channelError = err;
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
try {
|
|
35
|
+
return await puppeteer.default.launch({ headless, args });
|
|
36
|
+
} catch (err) {
|
|
37
|
+
if (channelError && err && err.cause === undefined) err.cause = channelError;
|
|
38
|
+
throw err;
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
// Reveal sweep + invisible-text measurement for the content-hidden-at-rest
|
|
43
|
+
// rule. Scrolls through the document with instant jumps (bypasses CSS
|
|
44
|
+
// scroll-behavior: smooth) so IntersectionObserver / scroll reveal handlers
|
|
45
|
+
// get every chance to fire, returns to the top, lets transitions settle,
|
|
46
|
+
// then measures how much text still renders invisible. A healthy
|
|
47
|
+
// reveal-on-scroll page drops to ~0 after the sweep; a page whose reveal
|
|
48
|
+
// script died keeps most of its text at opacity 0.
|
|
49
|
+
async function measureContentHiddenAfterReveal(page) {
|
|
50
|
+
await page.evaluate(async () => {
|
|
51
|
+
const step = Math.max(200, Math.floor(window.innerHeight * 0.7));
|
|
52
|
+
const max = Math.max(
|
|
53
|
+
document.documentElement.scrollHeight || 0,
|
|
54
|
+
document.body?.scrollHeight || 0,
|
|
55
|
+
);
|
|
56
|
+
for (let y = 0; y <= max; y += step) {
|
|
57
|
+
window.scrollTo({ top: y, left: 0, behavior: 'instant' });
|
|
58
|
+
await new Promise(resolve => requestAnimationFrame(() => setTimeout(resolve, 40)));
|
|
59
|
+
}
|
|
60
|
+
window.scrollTo({ top: 0, left: 0, behavior: 'instant' });
|
|
61
|
+
await new Promise(resolve => setTimeout(resolve, 700));
|
|
62
|
+
});
|
|
63
|
+
return page.evaluate(() => {
|
|
64
|
+
if (typeof window.impeccableMeasureHiddenText !== 'function') return null;
|
|
65
|
+
return window.impeccableMeasureHiddenText();
|
|
66
|
+
});
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
function serializeDesignSystemForBrowser(designSystem) {
|
|
70
|
+
if (!designSystem?.present) return null;
|
|
71
|
+
return {
|
|
72
|
+
present: true,
|
|
73
|
+
hasFonts: designSystem.hasFonts === true,
|
|
74
|
+
allowedFonts: Array.from(designSystem.allowedFonts || []),
|
|
75
|
+
hasColors: designSystem.hasColors === true,
|
|
76
|
+
allowedColors: Array.from(designSystem.allowedColorKeys?.values?.() || [])
|
|
77
|
+
.map(entry => entry?.color)
|
|
78
|
+
.filter(color => color && Number.isFinite(color.r) && Number.isFinite(color.g) && Number.isFinite(color.b))
|
|
79
|
+
.map(color => ({ r: color.r, g: color.g, b: color.b })),
|
|
80
|
+
hasRadii: designSystem.hasRadii === true,
|
|
81
|
+
allowedRadii: (designSystem.allowedRadii || [])
|
|
82
|
+
.map(entry => Number(entry?.px))
|
|
83
|
+
.filter(px => Number.isFinite(px)),
|
|
84
|
+
hasPillRadius: designSystem.hasPillRadius === true,
|
|
85
|
+
};
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
async function runVisualContrastFallback(page, serializedGroups, options, profile, target) {
|
|
89
|
+
if (options?.visualContrast === false) return [];
|
|
90
|
+
const maxCandidates = Number.isFinite(options?.visualContrastMaxCandidates)
|
|
91
|
+
? options.visualContrastMaxCandidates
|
|
92
|
+
: 12;
|
|
93
|
+
const scrollOffscreen = options?.visualContrastScrollOffscreen !== false;
|
|
94
|
+
const existingLowContrastSelectors = new Set(
|
|
95
|
+
serializedGroups
|
|
96
|
+
.filter(group => group.findings?.some(f => f.type === 'low-contrast'))
|
|
97
|
+
.map(group => group.selector)
|
|
98
|
+
.filter(Boolean)
|
|
99
|
+
);
|
|
100
|
+
|
|
101
|
+
let browserAnalyses = [];
|
|
102
|
+
const findings = [];
|
|
103
|
+
if (options?.visualContrastBrowser !== false) {
|
|
104
|
+
const browserFindings = await profileFindingsAsync(profile, {
|
|
105
|
+
engine: 'browser',
|
|
106
|
+
phase: 'visual-contrast',
|
|
107
|
+
ruleId: 'browser-fallback',
|
|
108
|
+
target,
|
|
109
|
+
}, async () => {
|
|
110
|
+
browserAnalyses = await page.evaluate(async ({ maxCandidates, scrollOffscreen }) => {
|
|
111
|
+
if (typeof window.impeccableAnalyzeVisualContrast !== 'function') return [];
|
|
112
|
+
return window.impeccableAnalyzeVisualContrast({ maxCandidates, scrollOffscreen });
|
|
113
|
+
}, { maxCandidates, scrollOffscreen });
|
|
114
|
+
return browserAnalyses
|
|
115
|
+
.filter(result => result.finding && !existingLowContrastSelectors.has(result.selector))
|
|
116
|
+
.map(result => result.finding);
|
|
117
|
+
});
|
|
118
|
+
findings.push(...browserFindings);
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
let candidates = browserAnalyses.length > 0 ? browserAnalyses : [];
|
|
122
|
+
if (candidates.length === 0) {
|
|
123
|
+
candidates = await profileStepAsync(profile, {
|
|
124
|
+
engine: 'browser',
|
|
125
|
+
phase: 'visual-contrast',
|
|
126
|
+
ruleId: 'collect-candidates',
|
|
127
|
+
target,
|
|
128
|
+
}, () => page.evaluate(({ maxCandidates }) => {
|
|
129
|
+
if (typeof window.impeccableCollectVisualContrastCandidates !== 'function') return [];
|
|
130
|
+
return window.impeccableCollectVisualContrastCandidates({ maxCandidates });
|
|
131
|
+
}, { maxCandidates }));
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
const viewport = options?.viewport || { width: 1280, height: 800 };
|
|
135
|
+
const browserResolvedSelectors = new Set(
|
|
136
|
+
browserAnalyses
|
|
137
|
+
.filter(result => result.status === 'fail' || result.status === 'pass')
|
|
138
|
+
.map(result => result.selector)
|
|
139
|
+
.filter(Boolean)
|
|
140
|
+
);
|
|
141
|
+
const filtered = candidates.filter(candidate =>
|
|
142
|
+
!existingLowContrastSelectors.has(candidate.selector) &&
|
|
143
|
+
!browserResolvedSelectors.has(candidate.selector)
|
|
144
|
+
);
|
|
145
|
+
if (options?.visualContrastPixel === false) return findings;
|
|
146
|
+
for (const candidate of filtered) {
|
|
147
|
+
const result = await profileFindingsAsync(profile, {
|
|
148
|
+
engine: 'browser',
|
|
149
|
+
phase: 'visual-contrast',
|
|
150
|
+
ruleId: 'pixel-diff',
|
|
151
|
+
target,
|
|
152
|
+
}, async () => {
|
|
153
|
+
const finding = await captureVisualContrastCandidate(page, candidate, viewport);
|
|
154
|
+
return finding ? [finding] : [];
|
|
155
|
+
});
|
|
156
|
+
findings.push(...result);
|
|
157
|
+
}
|
|
158
|
+
return findings;
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
// ---------------------------------------------------------------------------
|
|
162
|
+
// Puppeteer detection (for URLs)
|
|
163
|
+
// ---------------------------------------------------------------------------
|
|
164
|
+
|
|
165
|
+
function decodeUrlComponent(value) {
|
|
166
|
+
try {
|
|
167
|
+
return decodeURIComponent(value);
|
|
168
|
+
} catch {
|
|
169
|
+
return value;
|
|
170
|
+
}
|
|
171
|
+
}
|
|
172
|
+
|
|
173
|
+
function splitScanUrl(url) {
|
|
174
|
+
let parsed;
|
|
175
|
+
try {
|
|
176
|
+
parsed = new URL(url);
|
|
177
|
+
} catch {
|
|
178
|
+
return { href: url, credentials: null };
|
|
179
|
+
}
|
|
180
|
+
if (!parsed.username && !parsed.password) {
|
|
181
|
+
return { href: url, credentials: null };
|
|
182
|
+
}
|
|
183
|
+
const credentials =
|
|
184
|
+
parsed.protocol === 'http:' || parsed.protocol === 'https:'
|
|
185
|
+
? {
|
|
186
|
+
username: decodeUrlComponent(parsed.username),
|
|
187
|
+
password: decodeUrlComponent(parsed.password),
|
|
188
|
+
}
|
|
189
|
+
: null;
|
|
190
|
+
parsed.username = '';
|
|
191
|
+
parsed.password = '';
|
|
192
|
+
return { href: parsed.href, credentials };
|
|
193
|
+
}
|
|
194
|
+
|
|
195
|
+
function basicAuthHeader(credentials) {
|
|
196
|
+
return `Basic ${Buffer.from(`${credentials.username}:${credentials.password}`).toString('base64')}`;
|
|
197
|
+
}
|
|
198
|
+
|
|
199
|
+
// page.authenticate is page-wide: a cross-origin redirect that then 401s
|
|
200
|
+
// would receive these credentials. Attach Authorization only to the scan origin.
|
|
201
|
+
async function applyOriginScopedAuth(page, href, credentials) {
|
|
202
|
+
if (!credentials) return;
|
|
203
|
+
let origin = '';
|
|
204
|
+
try {
|
|
205
|
+
origin = new URL(href).origin;
|
|
206
|
+
} catch {
|
|
207
|
+
return;
|
|
208
|
+
}
|
|
209
|
+
if (!origin) return;
|
|
210
|
+
const header = basicAuthHeader(credentials);
|
|
211
|
+
await page.setRequestInterception(true);
|
|
212
|
+
page.on('request', (request) => {
|
|
213
|
+
let headers;
|
|
214
|
+
try {
|
|
215
|
+
if (new URL(request.url()).origin === origin) {
|
|
216
|
+
headers = { ...request.headers(), authorization: header };
|
|
217
|
+
}
|
|
218
|
+
} catch {
|
|
219
|
+
// invalid request URL: continue without auth
|
|
220
|
+
}
|
|
221
|
+
void request.continue(headers ? { headers } : undefined).catch(() => {});
|
|
222
|
+
});
|
|
223
|
+
}
|
|
224
|
+
|
|
225
|
+
async function detectUrl(rawUrl, options = {}) {
|
|
226
|
+
const { href: url, credentials } = splitScanUrl(rawUrl);
|
|
227
|
+
const profile = options?.profile;
|
|
228
|
+
const waitUntil = options?.waitUntil || 'networkidle0';
|
|
229
|
+
const settleMs = Number.isFinite(options?.settleMs) ? options.settleMs : 0;
|
|
230
|
+
const viewport = options?.viewport || { width: 1280, height: 800 };
|
|
231
|
+
const externalBrowser = options?.browser || null;
|
|
232
|
+
let puppeteer;
|
|
233
|
+
if (!externalBrowser) {
|
|
234
|
+
try {
|
|
235
|
+
puppeteer = await profileStepAsync(profile, {
|
|
236
|
+
engine: 'browser',
|
|
237
|
+
phase: 'setup',
|
|
238
|
+
ruleId: 'import-puppeteer',
|
|
239
|
+
target: url,
|
|
240
|
+
}, () => import('puppeteer'));
|
|
241
|
+
} catch {
|
|
242
|
+
throw new Error('puppeteer is required for URL scanning. Install: npm install puppeteer');
|
|
243
|
+
}
|
|
244
|
+
}
|
|
245
|
+
|
|
246
|
+
// Read the browser detection script — reuse it instead of reimplementing
|
|
247
|
+
const browserScriptPath = path.resolve(
|
|
248
|
+
path.dirname(fileURLToPath(import.meta.url)),
|
|
249
|
+
'..',
|
|
250
|
+
'..',
|
|
251
|
+
'detect-antipatterns-browser.js'
|
|
252
|
+
);
|
|
253
|
+
let browserScript;
|
|
254
|
+
try {
|
|
255
|
+
browserScript = profileStep(profile, {
|
|
256
|
+
engine: 'browser',
|
|
257
|
+
phase: 'setup',
|
|
258
|
+
ruleId: 'read-browser-script',
|
|
259
|
+
target: url,
|
|
260
|
+
}, () => fs.readFileSync(browserScriptPath, 'utf-8'));
|
|
261
|
+
} catch {
|
|
262
|
+
throw new Error(`Browser script not found at ${browserScriptPath}`);
|
|
263
|
+
}
|
|
264
|
+
|
|
265
|
+
// CI runners (GitHub Actions Ubuntu) block unprivileged user namespaces, so
|
|
266
|
+
// Chrome can't initialize its sandbox there. Disable the sandbox only when
|
|
267
|
+
// running in CI; local users keep the default hardened launch.
|
|
268
|
+
const launchArgs = process.env.CI ? ['--no-sandbox', '--disable-setuid-sandbox'] : [];
|
|
269
|
+
const browser = externalBrowser || await profileStepAsync(profile, {
|
|
270
|
+
engine: 'browser',
|
|
271
|
+
phase: 'load',
|
|
272
|
+
ruleId: 'launch-browser',
|
|
273
|
+
target: url,
|
|
274
|
+
}, () => launchBrowser(puppeteer, { headless: options?.headless ?? true, args: launchArgs }));
|
|
275
|
+
const page = await profileStepAsync(profile, {
|
|
276
|
+
engine: 'browser',
|
|
277
|
+
phase: 'load',
|
|
278
|
+
ruleId: 'new-page',
|
|
279
|
+
target: url,
|
|
280
|
+
}, () => browser.newPage());
|
|
281
|
+
|
|
282
|
+
// Uncaught exceptions and parse errors surface as pageerror events. The
|
|
283
|
+
// listener must attach before goto: a syntax error fires during the
|
|
284
|
+
// initial parse, long before the load event. Dedupe by message; a single
|
|
285
|
+
// broken loop can otherwise throw hundreds of identical errors.
|
|
286
|
+
const pageErrors = [];
|
|
287
|
+
if (options?.scriptErrors !== false) {
|
|
288
|
+
page.on('pageerror', (err) => {
|
|
289
|
+
const message = String(err?.message || err).split('\n')[0].trim().slice(0, 160);
|
|
290
|
+
if (message && !pageErrors.includes(message)) pageErrors.push(message);
|
|
291
|
+
});
|
|
292
|
+
}
|
|
293
|
+
|
|
294
|
+
let results = [];
|
|
295
|
+
try {
|
|
296
|
+
await profileStepAsync(profile, {
|
|
297
|
+
engine: 'browser',
|
|
298
|
+
phase: 'load',
|
|
299
|
+
ruleId: 'set-viewport',
|
|
300
|
+
target: url,
|
|
301
|
+
}, () => page.setViewport(viewport));
|
|
302
|
+
await applyOriginScopedAuth(page, url, credentials);
|
|
303
|
+
await profileStepAsync(profile, {
|
|
304
|
+
engine: 'browser',
|
|
305
|
+
phase: 'load',
|
|
306
|
+
ruleId: `goto:${waitUntil}`,
|
|
307
|
+
target: url,
|
|
308
|
+
}, () => page.goto(url, { waitUntil, timeout: 30000 }));
|
|
309
|
+
if (settleMs > 0) {
|
|
310
|
+
await profileStepAsync(profile, {
|
|
311
|
+
engine: 'browser',
|
|
312
|
+
phase: 'load',
|
|
313
|
+
ruleId: 'settle',
|
|
314
|
+
target: url,
|
|
315
|
+
}, () => new Promise(resolve => setTimeout(resolve, settleMs)));
|
|
316
|
+
}
|
|
317
|
+
|
|
318
|
+
// Inject the browser detection script and collect results
|
|
319
|
+
const browserDesignSystem = serializeDesignSystemForBrowser(options?.designSystem);
|
|
320
|
+
await profileStepAsync(profile, {
|
|
321
|
+
engine: 'browser',
|
|
322
|
+
phase: 'scan',
|
|
323
|
+
ruleId: 'configure-pure-detect',
|
|
324
|
+
target: url,
|
|
325
|
+
}, () => page.evaluate((designSystem) => {
|
|
326
|
+
window.__IMPECCABLE_CONFIG__ = {
|
|
327
|
+
...(window.__IMPECCABLE_CONFIG__ || {}),
|
|
328
|
+
autoScan: false,
|
|
329
|
+
...(designSystem ? { designSystem } : {}),
|
|
330
|
+
};
|
|
331
|
+
}, browserDesignSystem));
|
|
332
|
+
await profileStepAsync(profile, {
|
|
333
|
+
engine: 'browser',
|
|
334
|
+
phase: 'scan',
|
|
335
|
+
ruleId: 'inject-browser-script',
|
|
336
|
+
target: url,
|
|
337
|
+
}, () => page.evaluate(browserScript));
|
|
338
|
+
let serializedGroups = [];
|
|
339
|
+
results = await profileFindingsAsync(profile, {
|
|
340
|
+
engine: 'browser',
|
|
341
|
+
phase: 'scan',
|
|
342
|
+
ruleId: 'browser-scan',
|
|
343
|
+
target: url,
|
|
344
|
+
}, async () => {
|
|
345
|
+
serializedGroups = await page.evaluate(() => {
|
|
346
|
+
if (!window.impeccableDetect) return [];
|
|
347
|
+
return window.impeccableDetect({ decorate: false, serialize: true });
|
|
348
|
+
});
|
|
349
|
+
return serializedGroups.flatMap(({ findings }) =>
|
|
350
|
+
findings.map(f => ({ id: f.type, snippet: f.detail, ignoreValue: f.ignoreValue || '', severity: f.severity || '' }))
|
|
351
|
+
);
|
|
352
|
+
});
|
|
353
|
+
// Content invisible at rest: reveal sweep, then re-measure. Runs after
|
|
354
|
+
// the main scan (which must see the true at-rest state) and before the
|
|
355
|
+
// visual contrast fallback (the sweep restores scroll to the top).
|
|
356
|
+
if (options?.contentHidden !== false) {
|
|
357
|
+
const hiddenFindings = await profileFindingsAsync(profile, {
|
|
358
|
+
engine: 'browser',
|
|
359
|
+
phase: 'scan',
|
|
360
|
+
ruleId: 'content-hidden-at-rest',
|
|
361
|
+
target: url,
|
|
362
|
+
}, async () => {
|
|
363
|
+
const measured = await measureContentHiddenAfterReveal(page);
|
|
364
|
+
return measured ? checkContentHiddenAtRest(measured) : [];
|
|
365
|
+
});
|
|
366
|
+
results.push(...hiddenFindings);
|
|
367
|
+
}
|
|
368
|
+
|
|
369
|
+
for (const message of pageErrors.slice(0, 3)) {
|
|
370
|
+
results.push({ id: 'script-error', snippet: message });
|
|
371
|
+
}
|
|
372
|
+
|
|
373
|
+
const visualFindings = await runVisualContrastFallback(page, serializedGroups, options, profile, url);
|
|
374
|
+
results.push(...visualFindings);
|
|
375
|
+
} finally {
|
|
376
|
+
await profileStepAsync(profile, {
|
|
377
|
+
engine: 'browser',
|
|
378
|
+
phase: 'load',
|
|
379
|
+
ruleId: 'close-page',
|
|
380
|
+
target: url,
|
|
381
|
+
}, () => page.close().catch(() => {}));
|
|
382
|
+
if (!externalBrowser) {
|
|
383
|
+
await profileStepAsync(profile, {
|
|
384
|
+
engine: 'browser',
|
|
385
|
+
phase: 'load',
|
|
386
|
+
ruleId: 'close-browser',
|
|
387
|
+
target: url,
|
|
388
|
+
}, () => browser.close());
|
|
389
|
+
}
|
|
390
|
+
}
|
|
391
|
+
return results.map(f => {
|
|
392
|
+
const item = finding(f.id, url, f.snippet);
|
|
393
|
+
if (f.ignoreValue) item.ignoreValue = f.ignoreValue;
|
|
394
|
+
// Per-finding severity promotion (e.g. hero-region pulsing dot)
|
|
395
|
+
// overrides the registry default carried by finding().
|
|
396
|
+
if (f.severity && f.severity !== item.severity) item.severity = f.severity;
|
|
397
|
+
return deriveAdvisoryFlag(item);
|
|
398
|
+
});
|
|
399
|
+
}
|
|
400
|
+
|
|
401
|
+
async function createBrowserDetector(options = {}) {
|
|
402
|
+
let puppeteer;
|
|
403
|
+
try {
|
|
404
|
+
puppeteer = await import('puppeteer');
|
|
405
|
+
} catch {
|
|
406
|
+
throw new Error('puppeteer is required for URL scanning. Install: npm install puppeteer');
|
|
407
|
+
}
|
|
408
|
+
const launchArgs = options.launchArgs || (process.env.CI ? ['--no-sandbox', '--disable-setuid-sandbox'] : []);
|
|
409
|
+
const browser = options.browser || await launchBrowser(puppeteer, {
|
|
410
|
+
headless: options.headless ?? true,
|
|
411
|
+
args: launchArgs,
|
|
412
|
+
});
|
|
413
|
+
const ownsBrowser = !options.browser;
|
|
414
|
+
const defaults = {
|
|
415
|
+
waitUntil: options.waitUntil || 'load',
|
|
416
|
+
settleMs: Number.isFinite(options.settleMs) ? options.settleMs : 100,
|
|
417
|
+
viewport: options.viewport || { width: 1280, height: 800 },
|
|
418
|
+
};
|
|
419
|
+
return {
|
|
420
|
+
browser,
|
|
421
|
+
async detectUrl(url, scanOptions = {}) {
|
|
422
|
+
return detectUrl(url, {
|
|
423
|
+
...defaults,
|
|
424
|
+
...scanOptions,
|
|
425
|
+
browser,
|
|
426
|
+
});
|
|
427
|
+
},
|
|
428
|
+
async close() {
|
|
429
|
+
if (ownsBrowser) await browser.close().catch(() => {});
|
|
430
|
+
},
|
|
431
|
+
};
|
|
432
|
+
}
|
|
433
|
+
|
|
434
|
+
export { runVisualContrastFallback, detectUrl, createBrowserDetector, launchBrowser, splitScanUrl };
|