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,233 @@
|
|
|
1
|
+
# Workflow: Odyssey Review
|
|
2
|
+
|
|
3
|
+
Follow [shared phases](odyssey-base.md) and [runtime adapters](runtime-adapters.md) for parallel agents, structured prompts, and metadata.
|
|
4
|
+
|
|
5
|
+
## State Chain
|
|
6
|
+
|
|
7
|
+
```
|
|
8
|
+
S_INTAKE → S_ARCHAEOLOGY → S_EXPLORE → S_REVIEW → S_FIX → S_CONFIRM → [back-half]
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
Back-half: `S_GENERALIZE → S_DISCOVER → S_RECORD → END` (see [shared phases](odyssey-base.md)).
|
|
12
|
+
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
## Boundary
|
|
16
|
+
|
|
17
|
+
**In scope:** Multi-dimensional deep review of target code → exhaustive fix ALL findings by severity → generalize patterns project-wide.
|
|
18
|
+
**Out of scope:** Root cause debug → `--mode debug` | Feature implementation → `--mode planex` | UI visual optimization → `--mode ui`. Zero-residual applies (fix ALL findings within fix_threshold, default all).
|
|
19
|
+
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
## Target Resolution
|
|
23
|
+
|
|
24
|
+
| Input | Resolution |
|
|
25
|
+
|-------|-----------|
|
|
26
|
+
| File/dir path | Review those files |
|
|
27
|
+
| `HEAD` / `staged` | `git diff HEAD` / `git diff --staged` |
|
|
28
|
+
| Session/Run ID or commit range | Evolve Run artifacts / `git diff <base>..<head>` |
|
|
29
|
+
| PR number | `git diff main...HEAD` |
|
|
30
|
+
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
## Session Fields
|
|
34
|
+
|
|
35
|
+
```json
|
|
36
|
+
{ "target": "", "dimensions": [], "review_result": {"remaining_actionable": 0},
|
|
37
|
+
"patterns": [], "confirmation": null, "generalization_stats": null }
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
---
|
|
41
|
+
|
|
42
|
+
## evidence.ndjson Phases
|
|
43
|
+
|
|
44
|
+
`archaeology|explore|review|fix|discovery|decision|self-iteration`
|
|
45
|
+
|
|
46
|
+
---
|
|
47
|
+
|
|
48
|
+
## phase_goals[]
|
|
49
|
+
|
|
50
|
+
| ID | Goal | done_when | phase | skip_when |
|
|
51
|
+
|----|------|-----------|-------|-----------|
|
|
52
|
+
| G1 | Review completed | all dimensions reviewed | S_REVIEW | — |
|
|
53
|
+
| G2 | Explore context | explore.json populated | S_EXPLORE | — |
|
|
54
|
+
| G3 | Zero remaining | `remaining_actionable == 0` | S_CONFIRM | skip_fix |
|
|
55
|
+
| G4 | Pattern generalized | patterns[] ≥1 | S_GENERALIZE | skip_generalize |
|
|
56
|
+
| G5 | Discoveries triaged | all hits classified | S_DISCOVER | skip_generalize |
|
|
57
|
+
| G6 | Learnings persisted | spec entries or no actionable | S_RECORD | — |
|
|
58
|
+
|
|
59
|
+
---
|
|
60
|
+
|
|
61
|
+
## understanding.md — 8 Sections
|
|
62
|
+
|
|
63
|
+
1. Target & Scope
|
|
64
|
+
2. Archaeology
|
|
65
|
+
3. Exploration
|
|
66
|
+
4. Review Results
|
|
67
|
+
5. Fix & Confirmation
|
|
68
|
+
6. Generalization
|
|
69
|
+
7. Discoveries
|
|
70
|
+
8. Learnings
|
|
71
|
+
|
|
72
|
+
Specs: `evolve wiki constraints --category review`.
|
|
73
|
+
|
|
74
|
+
---
|
|
75
|
+
|
|
76
|
+
## State Machine — Transitions
|
|
77
|
+
|
|
78
|
+
```
|
|
79
|
+
S_ARCHAEOLOGY → S_EXPLORE : complete
|
|
80
|
+
S_EXPLORE → S_REVIEW : complete
|
|
81
|
+
S_REVIEW → S_FIX : !skip_fix AND findings
|
|
82
|
+
S_REVIEW → S_GENERALIZE : skip_fix OR no findings, !skip_generalize
|
|
83
|
+
S_REVIEW → S_RECORD : both skip
|
|
84
|
+
S_FIX → S_CONFIRM : tier complete
|
|
85
|
+
S_CONFIRM → S_GENERALIZE : confirmed, !skip_generalize
|
|
86
|
+
S_CONFIRM → S_RECORD : confirmed, skip_generalize
|
|
87
|
+
S_CONFIRM → S_FIX : needs_rework
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
Discover routes: fixable sibling → S_FIX; new target needing review → S_REVIEW (loops < max_loops).
|
|
91
|
+
|
|
92
|
+
---
|
|
93
|
+
|
|
94
|
+
## Actions
|
|
95
|
+
|
|
96
|
+
### A_ARCHAEOLOGY
|
|
97
|
+
|
|
98
|
+
Run 2 parallel subagents (join before advancing — see [runtime adapters](runtime-adapters.md)):
|
|
99
|
+
- **Timeline**: `git log --oneline -20 -- {files}`
|
|
100
|
+
- **Blame**: top 3 files `git blame -L {region}`
|
|
101
|
+
|
|
102
|
+
Evidence phase=archaeology.
|
|
103
|
+
|
|
104
|
+
`evolve delegate "PURPOSE: review recent modifications related to {target}. EXPECTED: JSON [{commit_sha, risk_level, analysis, could_cause_issue, explanation}]" --to codex --mode analysis`
|
|
105
|
+
|
|
106
|
+
Update §2 (Archaeology).
|
|
107
|
+
|
|
108
|
+
If an archaeology agent fails, log W003 and proceed with available results.
|
|
109
|
+
|
|
110
|
+
### A_EXPLORE
|
|
111
|
+
|
|
112
|
+
Skip if no CLI tools (W006).
|
|
113
|
+
|
|
114
|
+
`evolve delegate "PURPOSE: trace call chains, recent changes, error gaps, and similar patterns for {target}. EXPECTED: JSON {call_chains, recent_changes, error_gaps, similar_patterns}" --to codex --mode analysis`
|
|
115
|
+
|
|
116
|
+
Write `explore.json` + evidence phase=explore. Update §3 (Exploration). Mark G2.
|
|
117
|
+
|
|
118
|
+
**GATE: discovery-complete** — archaeology/explore evidence logged, understanding.md §2-§3 updated, G2 marked (W003 partial / W006 skip acceptable).
|
|
119
|
+
|
|
120
|
+
### A_REVIEW
|
|
121
|
+
|
|
122
|
+
Run N parallel subagents (one per dimension; join all before advancing — see [runtime adapters](runtime-adapters.md)):
|
|
123
|
+
- **Correctness**: logic errors, boundary conditions, null/undefined, race conditions
|
|
124
|
+
- **Security**: injection, XSS, CSRF, data exposure, auth bypass
|
|
125
|
+
- **Performance**: hot paths, N+1, memory leaks, unnecessary recomputation
|
|
126
|
+
- **Architecture**: layer violations, circular deps, interface contracts, SoC
|
|
127
|
+
|
|
128
|
+
Each returns `[{title, severity, file, line, description, suggestion, cwe}]`. Merge → evidence phase=review. Write `review_result` + §4 severity matrix. Mark G1.
|
|
129
|
+
|
|
130
|
+
**GATE: all-dimensions-reviewed** — all 4 dimension agents (correctness, security, performance, architecture) completed, findings merged into review_result with severity classification, evidence phase=review logged, §4 severity matrix written, G1 marked. Zero dimensions reviewed is BLOCKED (W002 partial with ≥1 dimension allowed).
|
|
131
|
+
|
|
132
|
+
### A_FIX
|
|
133
|
+
|
|
134
|
+
Exhaustive iterative fix — descend by severity until `remaining_actionable == 0`:
|
|
135
|
+
```
|
|
136
|
+
for tier in [critical, high, medium, low].filter(>= threshold):
|
|
137
|
+
for each unfixed candidate: read ±20 lines → fix → evidence phase=fix
|
|
138
|
+
re-review modified area (new findings → append, continue; max 2 per tier)
|
|
139
|
+
tier done → auto-commit
|
|
140
|
+
```
|
|
141
|
+
Normal: structured prompt per tier | `-y`: auto-fix all. Remaining > 0 → retry (**MANDATORY hard limit: max_fix_rounds = 5**). Unchanged 2 rounds → classify each individually. After 5 rounds remaining > 0 → escalate: Normal: structured prompt (continue/accept/reclassify) | `-y`: classify remaining as `deferred`, proceed. **No partial-tier advancement** — a tier is complete only when every finding is fixed or individually classified. Blanket "pre-existing" forbidden. Commit per tier: `"odyssey-review({slug}): FIX-{tier} — {N} items fixed"`.
|
|
142
|
+
|
|
143
|
+
### A_CONFIRM
|
|
144
|
+
|
|
145
|
+
Run tests + `evolve delegate "Review modified files for zero-residual defects across correctness, security, performance, and architecture; return remaining findings and verdict" --to codex --mode analysis`. `remaining == 0 AND new == 0` → confirmed, mark G3; otherwise → needs_rework → S_FIX. Update `confirmation` + `remaining_actionable` + §5.
|
|
146
|
+
|
|
147
|
+
**GATE: zero-remaining** — exhaustive fix applied tier-by-tier, `remaining_actionable == 0` (or all remaining individually classified as deferred after 5-round escalation), tests pass, CLI re-review confirms no new findings, confirmation + §5 written, G3 marked. `needs_rework` routes back to FIX; skippable only when `skip_fix == true`.
|
|
148
|
+
|
|
149
|
+
---
|
|
150
|
+
|
|
151
|
+
## Generalize Source
|
|
152
|
+
|
|
153
|
+
Review findings with severity >= medium.
|
|
154
|
+
|
|
155
|
+
**Discover routing:** fixable sibling → S_FIX; new target → S_REVIEW.
|
|
156
|
+
|
|
157
|
+
---
|
|
158
|
+
|
|
159
|
+
## Knowledge Persistence (§8)
|
|
160
|
+
|
|
161
|
+
Include verified reusable findings in the Run summary and harvest the completed Session through `evolve workflows show knowledge` (`evolve closeout session` → `evolve wiki propose`).
|
|
162
|
+
|
|
163
|
+
| Category | Content | Follow-up |
|
|
164
|
+
|----------|---------|-----------|
|
|
165
|
+
| Cross-dimension recurring pattern | Pattern + affected dimensions + coding standard | `evolve closeout session` → `evolve wiki propose` (`category: review`) |
|
|
166
|
+
| Security finding | Vulnerability type + triggers + fix approach | `evolve closeout session` → `evolve wiki propose` (`category: debug`) |
|
|
167
|
+
| Architecture violation pattern | Violation + correct boundary + verification | `evolve closeout session` → `evolve wiki propose` (`category: arch`) |
|
|
168
|
+
| Reusable generalization pattern | Signature + risk + fix template + scope | `evolve closeout session` → `evolve wiki propose` (`category: coding`) |
|
|
169
|
+
|
|
170
|
+
---
|
|
171
|
+
|
|
172
|
+
## Completion Summary
|
|
173
|
+
|
|
174
|
+
```
|
|
175
|
+
--- REVIEW-TEST-FIX ODYSSEY COMPLETE ---
|
|
176
|
+
Target: {target} Dimensions: {dims}
|
|
177
|
+
Findings: {C}C {H}H {M}M {L}L Fix: {fixed}, confirmed={yes|skip}
|
|
178
|
+
Patterns: {N} ({by_layer}) Scan hits: {total} ({cross} cross-layer)
|
|
179
|
+
Issues: {N} created
|
|
180
|
+
Decisions: {N} resolved, {M} pending, {K} deferred
|
|
181
|
+
Learnings: {N} persisted
|
|
182
|
+
Self-iter: {N} rounds across {M} stages
|
|
183
|
+
Goals: {done}/{total} ({skipped} skipped)
|
|
184
|
+
---
|
|
185
|
+
```
|
|
186
|
+
|
|
187
|
+
---
|
|
188
|
+
|
|
189
|
+
## `-y` Decision Points
|
|
190
|
+
|
|
191
|
+
| Decision Point | Normal | `-y` |
|
|
192
|
+
|---------------|--------|------|
|
|
193
|
+
| S_FIX tier candidates | structured prompt | auto-fix `deferred` |
|
|
194
|
+
| S_FIX re-review new findings | structured prompt | auto-append |
|
|
195
|
+
| S_CONFIRM needs_rework | structured prompt | auto proceed |
|
|
196
|
+
| A_DISCOVER routing | structured prompt | auto-fix w/ template, issue for rest |
|
|
197
|
+
|
|
198
|
+
---
|
|
199
|
+
|
|
200
|
+
## Mode-Specific Phase Gates
|
|
201
|
+
|
|
202
|
+
- **Discovery gate** (ARCHAEOLOGY/EXPLORE): evidence logged, understanding.md updated. Archaeology partial via W003 acceptable; explore W006 skip acceptable.
|
|
203
|
+
- **Audit gate** (REVIEW): all dimension agents completed, findings merged. Zero dimensions reviewed is BLOCKED (W002 partial allowed).
|
|
204
|
+
- **FIX gate:** current severity tier fully addressed. Per-fix evidence logged. Auto-commit per tier. No partial-tier advancement.
|
|
205
|
+
- **CONFIRM gate:** tests pass; `remaining_actionable == 0` and new findings == 0; confirmation written. needs_rework → route back to FIX.
|
|
206
|
+
|
|
207
|
+
---
|
|
208
|
+
|
|
209
|
+
## Error Codes (review-specific)
|
|
210
|
+
|
|
211
|
+
| Code | Severity | Condition | Recovery |
|
|
212
|
+
|------|----------|-----------|----------|
|
|
213
|
+
| W003 | warning | Archaeology agent failure | Proceed with available results |
|
|
214
|
+
| W006 | warning | No CLI tools | Skip explore |
|
|
215
|
+
|
|
216
|
+
---
|
|
217
|
+
|
|
218
|
+
## Success Criteria (review-specific)
|
|
219
|
+
|
|
220
|
+
- [ ] Session + 4 output files + prior knowledge searched
|
|
221
|
+
- [ ] Archaeology + CLI review → evidence
|
|
222
|
+
- [ ] CLI exploration → explore.json
|
|
223
|
+
- [ ] All 4 dimensions reviewed with findings merged
|
|
224
|
+
- [ ] understanding.md 8 sections progressive
|
|
225
|
+
- [ ] Exhaustive fix by severity tier + confirmed (unless --skip-fix)
|
|
226
|
+
- [ ] Generalization + scan (unless --skip-generalize)
|
|
227
|
+
- [ ] Discoveries classified; unfixed findings individually justified
|
|
228
|
+
- [ ] phase_goals + goal audit + resumable via -c
|
|
229
|
+
- [ ] Completion summary
|
|
230
|
+
|
|
231
|
+
---
|
|
232
|
+
|
|
233
|
+
See [shared base](odyssey-base.md) for generic follow-up routing (`Next Step Routing`). Root-cause debugging: `/ew-odyssey <issue> --mode debug`.
|
|
@@ -0,0 +1,231 @@
|
|
|
1
|
+
# Workflow: Odyssey Security
|
|
2
|
+
|
|
3
|
+
Read-only tiered security audit — OWASP Top 10 / dependency supply chain / secrets / CI/CD / STRIDE / git history → severity matrix report → generalize security patterns. Follow [shared phases](odyssey-base.md) and [runtime adapters](runtime-adapters.md).
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## State Chain
|
|
8
|
+
|
|
9
|
+
```
|
|
10
|
+
S_INTAKE → S_RECON → S_SCAN → S_REPORT → [back-half]
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
Back-half: `S_GENERALIZE → S_DISCOVER → S_RECORD → END` (see [shared phases](odyssey-base.md) §Shared Back-Half).
|
|
14
|
+
|
|
15
|
+
**No S_FIX / S_CONFIRM** — this mode is read-only. Findings route to `--mode improve` or `--mode debug` for remediation.
|
|
16
|
+
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
## Boundary
|
|
20
|
+
|
|
21
|
+
**In scope:** Read-only security audit — OWASP Top 10, dependency supply chain, secrets detection, CI/CD pipeline, STRIDE threat modeling, git history archaeology → severity matrix report → generalize security patterns.
|
|
22
|
+
**Out of scope:** Fixing vulnerabilities → `--mode improve` | Root cause debug → `--mode debug` | Feature implementation → `--mode planex` | UI → `--mode ui`. Read-only invariant applies: NEVER modify source code.
|
|
23
|
+
|
|
24
|
+
---
|
|
25
|
+
|
|
26
|
+
## Context
|
|
27
|
+
|
|
28
|
+
Target resolution (input → audit scope) and tier coverage (which audits each tier runs) are defined in [the selected mode preparation](prepare/odyssey-security.md) §Input Interpretation — that is the canonical wording.
|
|
29
|
+
|
|
30
|
+
### Session Fields
|
|
31
|
+
|
|
32
|
+
```json
|
|
33
|
+
{ "target": "", "tier": "standard", "scan_phases": [],
|
|
34
|
+
"audit_result": {}, "findings_count": {},
|
|
35
|
+
"generalization_stats": null }
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
### evidence.ndjson Phases
|
|
39
|
+
|
|
40
|
+
`recon|scan|report|discovery|decision|self-iteration`
|
|
41
|
+
|
|
42
|
+
- `recon`: `category` (tech_stack|entry_point|auth_module|data_flow), `detail`
|
|
43
|
+
- `scan`: `phase` (owasp|dependency|secrets|cicd|stride|git_history), `severity`, `cwe`
|
|
44
|
+
- `report`: `finding_ref`, `remediation`
|
|
45
|
+
|
|
46
|
+
### phase_goals[]
|
|
47
|
+
|
|
48
|
+
| ID | Goal | Phase | skip_when |
|
|
49
|
+
|----|------|-------|-----------|
|
|
50
|
+
| G1 | Recon completed | S_RECON | — |
|
|
51
|
+
| G2 | Scan completed (all tier phases) | S_SCAN | — |
|
|
52
|
+
| G3 | Report produced | S_REPORT | — |
|
|
53
|
+
| G4 | Pattern generalized | S_GENERALIZE | skip_generalize |
|
|
54
|
+
| G5 | Discoveries triaged | S_DISCOVER | skip_generalize |
|
|
55
|
+
| G6 | Learnings persisted | S_RECORD | — |
|
|
56
|
+
|
|
57
|
+
### understanding.md — 7 Sections
|
|
58
|
+
|
|
59
|
+
1. Target & Tier
|
|
60
|
+
2. Reconnaissance
|
|
61
|
+
3. Scan Findings (by phase)
|
|
62
|
+
4. Severity Matrix
|
|
63
|
+
5. Full Report (findings + remediation)
|
|
64
|
+
6. Generalization
|
|
65
|
+
7. Discoveries & Learnings
|
|
66
|
+
|
|
67
|
+
---
|
|
68
|
+
|
|
69
|
+
## State Machine
|
|
70
|
+
|
|
71
|
+
### Transitions
|
|
72
|
+
|
|
73
|
+
```
|
|
74
|
+
S_RECON → S_SCAN : complete
|
|
75
|
+
S_SCAN → S_REPORT : all tier phases complete
|
|
76
|
+
S_REPORT → S_GENERALIZE : report produced, !skip_generalize
|
|
77
|
+
S_REPORT → S_RECORD : report produced, skip_generalize
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
Discover routes: new security concern in sibling module → S_SCAN (re-scan with expanded scope, loops < max_loops).
|
|
81
|
+
|
|
82
|
+
---
|
|
83
|
+
|
|
84
|
+
## Actions
|
|
85
|
+
|
|
86
|
+
**A_INTAKE extra** — Tier resolution: parse `--tier` flag (default: standard). Record tier + applicable scan phases to `session.json.scan_phases`.
|
|
87
|
+
|
|
88
|
+
**A_RECON** — (1) Detect tech stack from package.json / go.mod / requirements.txt / Cargo.toml. (2) Identify entry points: HTTP handlers, API routes, CLI parsers, WebSocket handlers. (3) List authentication/authorization modules. (4) Map data flow: user input → processing → storage → output. (5) Evidence phase=recon. Update §2. Mark G1.
|
|
89
|
+
|
|
90
|
+
**GATE: recon-complete** — tech stack detected, entry points identified, auth/authz modules listed, data flow mapped. Evidence phase=recon logged. §2 updated. BLOCKED if no entry points found (E002).
|
|
91
|
+
|
|
92
|
+
Commit: `"odyssey-security({slug}): RECON — reconnaissance complete"`
|
|
93
|
+
|
|
94
|
+
**A_SCAN** — Tier-gated parallel scan phases:
|
|
95
|
+
|
|
96
|
+
- **OWASP Top 10** (all tiers): Run parallel subagents per category (A01-A10; join all before merging — see [runtime adapters](runtime-adapters.md)). Each scans relevant source files using Grep pattern matching (`eval(`, `exec(`, `innerHTML`, `dangerouslySetInnerHTML`, `sql.*\+.*req\.`, `process\.env` without validation). Returns `[{title, severity, category, file, line, description, cwe, remediation}]`.
|
|
97
|
+
|
|
98
|
+
| # | Category | What to check |
|
|
99
|
+
|---|----------|--------------|
|
|
100
|
+
| A01 | Broken Access Control | Missing auth middleware, direct object references, path traversal |
|
|
101
|
+
| A02 | Cryptographic Failures | Weak algorithms, hardcoded keys, missing TLS, plaintext storage |
|
|
102
|
+
| A03 | Injection | SQL concatenation, shell exec with user input, template injection |
|
|
103
|
+
| A04 | Insecure Design | Missing rate limits, no CSRF tokens, predictable tokens |
|
|
104
|
+
| A05 | Security Misconfiguration | Debug mode, default credentials, verbose errors, open CORS |
|
|
105
|
+
| A06 | Vulnerable Components | Known CVEs in dependencies |
|
|
106
|
+
| A07 | Auth Failures | Weak password rules, missing brute-force protection, session fixation |
|
|
107
|
+
| A08 | Data Integrity | Deserialization of untrusted data, unsigned updates |
|
|
108
|
+
| A09 | Logging Failures | Missing audit logs, logging sensitive data |
|
|
109
|
+
| A10 | SSRF | Unvalidated URLs in server-side requests |
|
|
110
|
+
|
|
111
|
+
- **Dependency Audit** (all tiers): `npm audit --json` / lockfile integrity / typosquatting risk on critical dependencies.
|
|
112
|
+
- **Secrets Detection** (standard + deep): Grep for `(password|secret|api.?key|token|credential).*=.*['"][^'"]{8,}` in `*.{ts,js,json,env*}`. Check `.env.example` for leaked values. Check `.gitignore` for missing `.env` patterns. **NEVER log actual secret values.**
|
|
113
|
+
- **CI/CD Audit** (standard + deep): Scan `.github/workflows/*.yml` for overly permissive permissions, unpinned action versions, secrets in logs, `pull_request_target` injection risk.
|
|
114
|
+
- **STRIDE Threat Modeling** (deep only): For each critical module from recon:
|
|
115
|
+
|
|
116
|
+
| Threat | Question |
|
|
117
|
+
|--------|----------|
|
|
118
|
+
| **S**poofing | Can identity be faked? Is auth per-request? |
|
|
119
|
+
| **T**ampering | Can data be modified in transit/storage? Integrity checks? |
|
|
120
|
+
| **R**epudiation | Are actions logged with user identity? |
|
|
121
|
+
| **I**nformation Disclosure | Can unauthorized data be accessed? |
|
|
122
|
+
| **D**enial of Service | Resource limits? Rate limiting? |
|
|
123
|
+
| **E**levation of Privilege | Can roles be escalated? Input validation on role fields? |
|
|
124
|
+
|
|
125
|
+
- **Git History Archaeology** (deep only): Search for previously committed secrets (`git log --all --diff-filter=D -- "*.env" "*.key" "*.pem"`), password strings in history.
|
|
126
|
+
|
|
127
|
+
Merge all findings → evidence phase=scan. Write `session.json.audit_result`. Update §3 (findings by phase) + §4 (severity matrix). Mark G2.
|
|
128
|
+
|
|
129
|
+
**GATE: scan-complete** — all tier-required scan phases completed with structured findings, merged into severity matrix, evidence phase=scan logged per phase. Tier-required phase not attempted is BLOCKED (W001 tool unavailable / W002 git history failure are warnings, not blocks).
|
|
130
|
+
|
|
131
|
+
Commit: `"odyssey-security({slug}): SCAN — {tier} tier scan complete"`
|
|
132
|
+
|
|
133
|
+
**A_REPORT** — (1) Produce severity matrix: CRITICAL / HIGH / MEDIUM / LOW with file:line references and remediation for each finding. (2) Compute summary statistics. (3) Write understanding.md §5 (full report). (4) Write `session.json.findings_count`. (5) Evidence phase=report. Mark G3.
|
|
134
|
+
|
|
135
|
+
**GATE: report-produced** — severity matrix with file:line references and remediation for every finding; summary statistics computed; §5 written; `audit_result` populated.
|
|
136
|
+
|
|
137
|
+
Commit: `"odyssey-security({slug}): REPORT — severity matrix produced"`
|
|
138
|
+
|
|
139
|
+
---
|
|
140
|
+
|
|
141
|
+
## Generalize Source
|
|
142
|
+
|
|
143
|
+
Security findings with severity >= medium + vulnerability patterns across scan phases.
|
|
144
|
+
|
|
145
|
+
**Discover routing:** sibling module with same vulnerability class → S_SCAN (re-scan expanded scope); new critical finding → evidence phase=decision, recommend `--mode improve`.
|
|
146
|
+
|
|
147
|
+
---
|
|
148
|
+
|
|
149
|
+
## Knowledge Persistence (§7)
|
|
150
|
+
|
|
151
|
+
Include verified reusable findings in the Run summary and harvest the completed Session through `evolve workflows show knowledge` (`evolve closeout session` → `evolve wiki propose`).
|
|
152
|
+
|
|
153
|
+
| Category | Content | Follow-up |
|
|
154
|
+
|----------|---------|-----------|
|
|
155
|
+
| Vulnerability pattern | CWE + trigger + detection pattern + remediation | `evolve closeout session` → `evolve wiki propose` (`category: debug`) |
|
|
156
|
+
| Security constraint | Trust boundary + validation rule + enforcement | `evolve closeout session` → `evolve wiki propose` (`category: arch`) |
|
|
157
|
+
| Dependency risk | Package + CVE + safe version + migration path | `evolve closeout session` → `evolve wiki propose` (`category: coding`) |
|
|
158
|
+
| CI/CD hardening | Misconfiguration + fix + prevention check | `evolve closeout session` → `evolve wiki propose` (`category: coding`) |
|
|
159
|
+
|
|
160
|
+
---
|
|
161
|
+
|
|
162
|
+
## Completion Summary
|
|
163
|
+
|
|
164
|
+
```
|
|
165
|
+
--- SECURITY ODYSSEY COMPLETE ---
|
|
166
|
+
Target: {target}
|
|
167
|
+
Tier: {tier}
|
|
168
|
+
Phases: {completed}/{total} ({skipped} skipped)
|
|
169
|
+
Findings: {critical}C / {high}H / {medium}M / {low}L
|
|
170
|
+
Categories: {owasp_hits} OWASP / {dep_vulns} dependency / {secrets} secrets
|
|
171
|
+
Patterns: {count} ({by_layer})
|
|
172
|
+
Scan hits: {total} ({cross_layer_confirmed} confirmed)
|
|
173
|
+
Issues: {N} created
|
|
174
|
+
Decisions: {N} resolved, {M} pending, {K} deferred
|
|
175
|
+
Learnings: {N} persisted
|
|
176
|
+
Self-iter: {N} rounds across {M} stages
|
|
177
|
+
Cross-loops: {N}
|
|
178
|
+
Goals: {done}/{total} ({skipped} skipped)
|
|
179
|
+
---
|
|
180
|
+
```
|
|
181
|
+
|
|
182
|
+
---
|
|
183
|
+
|
|
184
|
+
## Mode `-y` Points
|
|
185
|
+
|
|
186
|
+
| Decision Point | Normal | `-y` |
|
|
187
|
+
|---------------|--------|------|
|
|
188
|
+
| A_SCAN false positive dismissal | structured prompt | Dismiss only with recorded counter-evidence. Keep unresolved candidates as deferred. |
|
|
189
|
+
| A_REPORT severity downgrade | structured prompt | Downgrade only with documented counter-evidence. Keep the current severity when the decision is deferred. |
|
|
190
|
+
| A_DISCOVER routing | structured prompt | Record a deferred discovery with evidence. Route issue creation through an explicit follow-up. |
|
|
191
|
+
| Ambiguous items | structured prompt | all `deferred` |
|
|
192
|
+
|
|
193
|
+
---
|
|
194
|
+
|
|
195
|
+
## Phase Gates
|
|
196
|
+
|
|
197
|
+
- **Recon gate** (S_RECON): tech stack + entry points + auth modules + data flow mapped. Evidence logged, understanding.md §2 updated.
|
|
198
|
+
- **Scan gate** (S_SCAN): all tier-required phases completed. Per-phase evidence logged. Findings merged with severity classification. Tier-required phase missing is BLOCKED (W001/W002 partial allowed).
|
|
199
|
+
- **Report gate** (S_REPORT): severity matrix produced with file:line + remediation. Summary statistics. §5 written. Read-only invariant verified (no source modifications in session).
|
|
200
|
+
|
|
201
|
+
---
|
|
202
|
+
|
|
203
|
+
## Error Codes
|
|
204
|
+
|
|
205
|
+
| Code | Severity | Condition | Recovery |
|
|
206
|
+
|------|----------|-----------|----------|
|
|
207
|
+
| E001 | error | No target / scope provided | Provide target or -c |
|
|
208
|
+
| E002 | error | No source files found in scope / no entry points | Verify target path exists |
|
|
209
|
+
| W001 | warning | Dependency audit tool unavailable (npm audit etc.) | Skip dependency phase, note limitation |
|
|
210
|
+
| W002 | warning | Git history scan failed | Skip git history phase, note limitation |
|
|
211
|
+
| W003 | warning | Partial scan (some files inaccessible) | Report coverage gap in findings |
|
|
212
|
+
| W004 | warning | Generalization 0 hits after full 3-layer scan | Advance to S_RECORD |
|
|
213
|
+
| W005 | warning | Pending decisions | Filter evidence phase=decision |
|
|
214
|
+
|
|
215
|
+
---
|
|
216
|
+
|
|
217
|
+
## Success Criteria
|
|
218
|
+
|
|
219
|
+
- [ ] Target resolved; tier determined; session + output files created
|
|
220
|
+
- [ ] Recon completed: tech stack, entry points, auth modules, data flow mapped
|
|
221
|
+
- [ ] All tier-required scan phases completed (OWASP, dependencies, secrets, CI/CD, STRIDE, git history per tier)
|
|
222
|
+
- [ ] understanding.md sections written progressively (§1–§7)
|
|
223
|
+
- [ ] Severity matrix produced with file:line references and remediation for every finding
|
|
224
|
+
- [ ] Read-only invariant maintained — zero source code modifications
|
|
225
|
+
- [ ] Multi-layer generalization + discovery triage (unless --skip-generalize)
|
|
226
|
+
- [ ] phase_goals derived, tracked, and hardened-audited; goal_mode injected via prepare goal:true
|
|
227
|
+
- [ ] Session resumable via -c; completion summary emitted
|
|
228
|
+
|
|
229
|
+
---
|
|
230
|
+
|
|
231
|
+
See [shared base](odyssey-base.md) for generic follow-up routing (`Next Step Routing`). Related transitions: `/ew-odyssey <finding> --mode improve` (remediation), `/ew-odyssey <finding> --mode debug` (root cause), `/ew-odyssey <target> --mode security --tier deep` (deeper scan).
|