@zeyue0329/xiaoma-cli 1.0.49 → 1.6.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/.github/workflows/quality.yaml +116 -0
- package/.husky/pre-commit +26 -0
- package/.idea/codeStyles/Project.xml +60 -0
- package/.idea/codeStyles/codeStyleConfig.xml +5 -0
- package/.idea/jsLibraryMappings.xml +6 -0
- package/.idea/modules.xml +1 -1
- package/.idea/vcs.xml +0 -1
- package/.idea/workspace.xml +40 -24
- package/.markdownlint-cli2.yaml +41 -0
- package/.prettierignore +12 -0
- package/.vscode/settings.json +96 -0
- package/LICENSE +30 -0
- package/README.md +108 -2
- package/XIAOMA-CLI-GUIDE.md +512 -0
- package/{.idea/XiaoMa-Cli.iml → XiaoMa-Cli.iml} +1 -1
- package/custom/src/agents/commit-poet/commit-poet.agent.yaml +129 -0
- package/custom/src/agents/commit-poet/installation-guide.md +36 -0
- package/custom/src/agents/toolsmith/installation-guide.md +36 -0
- package/custom/src/agents/toolsmith/toolsmith-sidecar/instructions.md +70 -0
- package/custom/src/agents/toolsmith/toolsmith-sidecar/knowledge/bundlers.md +111 -0
- package/custom/src/agents/toolsmith/toolsmith-sidecar/knowledge/deploy.md +70 -0
- package/custom/src/agents/toolsmith/toolsmith-sidecar/knowledge/docs.md +114 -0
- package/custom/src/agents/toolsmith/toolsmith-sidecar/knowledge/installers.md +134 -0
- package/custom/src/agents/toolsmith/toolsmith-sidecar/knowledge/modules.md +160 -0
- package/custom/src/agents/toolsmith/toolsmith-sidecar/knowledge/tests.md +103 -0
- package/custom/src/agents/toolsmith/toolsmith-sidecar/memories.md +17 -0
- package/custom/src/agents/toolsmith/toolsmith.agent.yaml +108 -0
- package/docs/BUNDLE_DISTRIBUTION_SETUP.md +95 -0
- package/docs/agent-customization-guide.md +208 -0
- package/docs/custom-agent-installation.md +183 -0
- package/docs/document-sharding-guide.md +449 -0
- package/docs/explanation/advanced-elicitation.md +49 -0
- package/docs/explanation/adversarial-review.md +59 -0
- package/docs/explanation/brainstorming.md +33 -0
- package/docs/explanation/established-projects-faq.md +50 -0
- package/docs/explanation/party-mode.md +59 -0
- package/docs/explanation/preventing-agent-conflicts.md +112 -0
- package/docs/explanation/project-context.md +157 -0
- package/docs/explanation/quick-dev-new-preview.md +73 -0
- package/docs/explanation/quick-flow.md +77 -0
- package/docs/explanation/why-solutioning-matters.md +77 -0
- package/docs/how-to/customize-xiaoma.md +172 -0
- package/docs/how-to/established-projects.md +117 -0
- package/docs/how-to/get-answers-about-xiaoma.md +134 -0
- package/docs/how-to/install-xiaoma.md +107 -0
- package/docs/how-to/non-interactive-installation.md +171 -0
- package/docs/how-to/project-context.md +136 -0
- package/docs/how-to/quick-fixes.md +123 -0
- package/docs/how-to/shard-large-documents.md +78 -0
- package/docs/how-to/upgrade-to-v6.md +100 -0
- package/docs/ide-info/auggie.md +31 -0
- package/docs/ide-info/claude-code.md +25 -0
- package/docs/ide-info/cline.md +31 -0
- package/docs/ide-info/codex.md +21 -0
- package/docs/ide-info/crush.md +30 -0
- package/docs/ide-info/cursor.md +25 -0
- package/docs/ide-info/gemini.md +25 -0
- package/docs/ide-info/github-copilot.md +26 -0
- package/docs/ide-info/iflow.md +33 -0
- package/docs/ide-info/kilo.md +24 -0
- package/docs/ide-info/opencode.md +24 -0
- package/docs/ide-info/qwen.md +25 -0
- package/docs/ide-info/roo.md +27 -0
- package/docs/ide-info/rovo-dev.md +388 -0
- package/docs/ide-info/trae.md +25 -0
- package/docs/ide-info/windsurf.md +22 -0
- package/docs/index.md +60 -0
- package/docs/installers-bundlers/ide-injections.md +186 -0
- package/docs/installers-bundlers/installers-modules-platforms-reference.md +379 -0
- package/docs/rag/rag.md +856 -0
- package/docs/reference/agents.md +28 -0
- package/docs/reference/commands.md +145 -0
- package/docs/reference/modules.md +76 -0
- package/docs/reference/testing.md +106 -0
- package/docs/reference/workflow-map.md +89 -0
- package/docs/roadmap.mdx +136 -0
- package/docs/superpowers/plans/2026-03-11-upstream-sync-with-branding.md +586 -0
- package/docs/tutorials/getting-started.md +273 -0
- package/docs/v4-to-v6-upgrade.md +220 -0
- package/docs/v6-open-items.md +17 -0
- package/docs/web-bundles-gemini-gpt-guide.md +468 -0
- package/docs/zh-cn/404.md +9 -0
- package/docs/zh-cn/_STYLE_GUIDE.md +370 -0
- package/docs/zh-cn/explanation/advanced-elicitation.md +62 -0
- package/docs/zh-cn/explanation/adversarial-review.md +71 -0
- package/docs/zh-cn/explanation/brainstorming.md +43 -0
- package/docs/zh-cn/explanation/established-projects-faq.md +60 -0
- package/docs/zh-cn/explanation/party-mode.md +79 -0
- package/docs/zh-cn/explanation/preventing-agent-conflicts.md +137 -0
- package/docs/zh-cn/explanation/project-context.md +176 -0
- package/docs/zh-cn/explanation/quick-flow.md +93 -0
- package/docs/zh-cn/explanation/why-solutioning-matters.md +90 -0
- package/docs/zh-cn/how-to/customize-xiaoma.md +182 -0
- package/docs/zh-cn/how-to/established-projects.md +134 -0
- package/docs/zh-cn/how-to/get-answers-about-xiaoma.md +144 -0
- package/docs/zh-cn/how-to/install-xiaoma.md +105 -0
- package/docs/zh-cn/how-to/non-interactive-installation.md +181 -0
- package/docs/zh-cn/how-to/project-context.md +152 -0
- package/docs/zh-cn/how-to/quick-fixes.md +140 -0
- package/docs/zh-cn/how-to/shard-large-documents.md +86 -0
- package/docs/zh-cn/how-to/upgrade-to-v6.md +120 -0
- package/docs/zh-cn/index.md +69 -0
- package/docs/zh-cn/reference/agents.md +41 -0
- package/docs/zh-cn/reference/commands.md +166 -0
- package/docs/zh-cn/reference/modules.md +94 -0
- package/docs/zh-cn/reference/testing.md +122 -0
- package/docs/zh-cn/reference/workflow-map.md +104 -0
- package/docs/zh-cn/roadmap.mdx +152 -0
- package/docs/zh-cn/tutorials/getting-started.md +300 -0
- package/eslint.config.mjs +144 -0
- package/package.json +56 -58
- package/prettier.config.mjs +32 -0
- package/src/core/_module-installer/install-config.yaml +29 -0
- package/src/core/_module-installer/installer.js +60 -0
- package/src/core/agents/xiaoma-master.agent.yaml +30 -0
- package/src/core/agents/xiaoma-skill-manifest.yaml +3 -0
- package/src/core/agents/xiaoma-web-orchestrator.agent.xml +113 -0
- package/src/core/module-help.csv +10 -0
- package/src/core/module.yaml +25 -0
- package/src/core/resources/excalidraw/README.md +160 -0
- package/src/core/resources/excalidraw/excalidraw-helpers.md +127 -0
- package/src/core/resources/excalidraw/library-loader.md +50 -0
- package/src/core/resources/excalidraw/validate-json-instructions.md +79 -0
- package/src/core/tasks/advanced-elicitation-methods.csv +51 -0
- package/src/core/tasks/advanced-elicitation.xml +116 -0
- package/src/core/tasks/editorial-review-prose.xml +102 -0
- package/src/core/tasks/editorial-review-structure.xml +208 -0
- package/src/core/tasks/help.md +92 -0
- package/src/core/tasks/index-docs.xml +65 -0
- package/src/core/tasks/review-adversarial-general.xml +49 -0
- package/src/core/tasks/review-edge-case-hunter.xml +63 -0
- package/src/core/tasks/shard-doc.xml +108 -0
- package/src/core/tasks/validate-workflow.xml +89 -0
- package/src/core/tasks/workflow.xml +235 -0
- package/src/core/tasks/xiaoma-help/SKILL.md +6 -0
- package/src/core/tasks/xiaoma-help/workflow.md +88 -0
- package/src/core/tasks/xiaoma-help/xiaoma-skill-manifest.yaml +1 -0
- package/src/core/tasks/xiaoma-review-adversarial-general/SKILL.md +6 -0
- package/src/core/tasks/xiaoma-review-adversarial-general/workflow.md +32 -0
- package/src/core/tasks/xiaoma-review-adversarial-general/xiaoma-skill-manifest.yaml +1 -0
- package/src/core/tasks/xiaoma-review-edge-case-hunter/SKILL.md +6 -0
- package/src/core/tasks/xiaoma-review-edge-case-hunter/workflow.md +62 -0
- package/src/core/tasks/xiaoma-review-edge-case-hunter/xiaoma-skill-manifest.yaml +1 -0
- package/src/core/tasks/xiaoma-skill-manifest.yaml +19 -0
- package/src/core/tools/shard-doc.xml +109 -0
- package/src/core/workflows/advanced-elicitation/methods.csv +51 -0
- package/src/core/workflows/advanced-elicitation/workflow.md +138 -0
- package/src/core/workflows/advanced-elicitation/workflow.xml +118 -0
- package/src/core/workflows/advanced-elicitation/xiaoma-skill-manifest.yaml +3 -0
- package/src/core/workflows/brainstorming/brain-methods.csv +62 -0
- package/src/core/workflows/brainstorming/steps/step-01-session-setup.md +210 -0
- package/src/core/workflows/brainstorming/steps/step-01b-continue.md +122 -0
- package/src/core/workflows/brainstorming/steps/step-02a-user-selected.md +225 -0
- package/src/core/workflows/brainstorming/steps/step-02b-ai-recommended.md +237 -0
- package/src/core/workflows/brainstorming/steps/step-02c-random-selection.md +209 -0
- package/src/core/workflows/brainstorming/steps/step-02d-progressive-flow.md +264 -0
- package/src/core/workflows/brainstorming/steps/step-03-technique-execution.md +399 -0
- package/src/core/workflows/brainstorming/steps/step-04-idea-organization.md +303 -0
- package/src/core/workflows/brainstorming/template.md +15 -0
- package/src/core/workflows/brainstorming/workflow.md +60 -0
- package/src/core/workflows/brainstorming/xiaoma-skill-manifest.yaml +3 -0
- package/src/core/workflows/party-mode/steps/step-01-agent-loading.md +138 -0
- package/src/core/workflows/party-mode/steps/step-02-discussion-orchestration.md +187 -0
- package/src/core/workflows/party-mode/steps/step-03-graceful-exit.md +168 -0
- package/src/core/workflows/party-mode/workflow.md +194 -0
- package/src/core/workflows/party-mode/xiaoma-skill-manifest.yaml +3 -0
- package/src/utility/agent-components/activation-rules.txt +6 -0
- package/src/utility/agent-components/activation-steps.txt +14 -0
- package/src/utility/agent-components/agent-command-header.md +1 -0
- package/src/utility/agent-components/agent.customize.template.yaml +41 -0
- package/src/utility/agent-components/handler-action.txt +4 -0
- package/src/utility/agent-components/handler-data.txt +5 -0
- package/src/utility/agent-components/handler-exec.txt +6 -0
- package/src/utility/agent-components/handler-multi.txt +13 -0
- package/src/utility/agent-components/handler-tmpl.txt +5 -0
- package/src/utility/agent-components/handler-validate-workflow.txt +7 -0
- package/src/utility/agent-components/handler-workflow.txt +10 -0
- package/src/utility/agent-components/menu-handlers.txt +6 -0
- package/src/utility/models/action-command-header.md +0 -0
- package/src/utility/models/agent-activation-ide.xml +51 -0
- package/src/utility/models/agent-activation-web.xml +50 -0
- package/src/utility/models/agent-command-header.md +1 -0
- package/src/utility/models/agent-config-template.md +23 -0
- package/src/utility/models/agent-in-team-activation.xml +3 -0
- package/src/utility/models/fragments/activation-rules.xml +7 -0
- package/src/utility/models/fragments/activation-steps.xml +16 -0
- package/src/utility/models/fragments/handler-action.xml +4 -0
- package/src/utility/models/fragments/handler-data.xml +5 -0
- package/src/utility/models/fragments/handler-exec.xml +6 -0
- package/src/utility/models/fragments/handler-multi.xml +14 -0
- package/src/utility/models/fragments/handler-tmpl.xml +5 -0
- package/src/utility/models/fragments/handler-validate-workflow.xml +7 -0
- package/src/utility/models/fragments/handler-workflow.xml +9 -0
- package/src/utility/models/fragments/menu-handlers.xml +6 -0
- package/src/utility/models/fragments/web-bundle-activation-steps.xml +32 -0
- package/src/utility/templates/agent.customize.template.yaml +42 -0
- package/src/xmc/_module-installer/install-config.yaml +53 -0
- package/src/xmc/_module-installer/installer.js +131 -0
- package/src/xmc/_module-installer/platform-specifics/claude-code.js +35 -0
- package/src/xmc/_module-installer/platform-specifics/windsurf.js +32 -0
- package/src/xmc/agents/analyst.agent.yaml +43 -0
- package/src/xmc/agents/architect.agent.yaml +29 -0
- package/src/xmc/agents/dev.agent.yaml +38 -0
- package/src/xmc/agents/pm.agent.yaml +44 -0
- package/src/xmc/agents/qa.agent.yaml +58 -0
- package/src/xmc/agents/quick-flow-solo-dev.agent.yaml +36 -0
- package/src/xmc/agents/sm.agent.yaml +37 -0
- package/src/xmc/agents/tech-writer/tech-writer-sidecar/documentation-standards.md +224 -0
- package/src/xmc/agents/tech-writer/tech-writer.agent.yaml +46 -0
- package/src/xmc/agents/tech-writer/xiaoma-skill-manifest.yaml +3 -0
- package/src/xmc/agents/ux-designer.agent.yaml +27 -0
- package/src/xmc/agents/xiaoma-skill-manifest.yaml +39 -0
- package/src/xmc/data/project-context-template.md +26 -0
- package/src/xmc/module-help.csv +32 -0
- package/src/xmc/module.yaml +50 -0
- package/src/xmc/sub-modules/claude-code/config.yaml +5 -0
- package/src/xmc/sub-modules/claude-code/injections.yaml +242 -0
- package/src/xmc/sub-modules/claude-code/readme.md +87 -0
- package/src/xmc/sub-modules/claude-code/sub-agents/xiaoma-analysis/api-documenter.md +102 -0
- package/src/xmc/sub-modules/claude-code/sub-agents/xiaoma-analysis/codebase-analyzer.md +82 -0
- package/src/xmc/sub-modules/claude-code/sub-agents/xiaoma-analysis/data-analyst.md +101 -0
- package/src/xmc/sub-modules/claude-code/sub-agents/xiaoma-analysis/pattern-detector.md +84 -0
- package/src/xmc/sub-modules/claude-code/sub-agents/xiaoma-planning/dependency-mapper.md +83 -0
- package/src/xmc/sub-modules/claude-code/sub-agents/xiaoma-planning/epic-optimizer.md +81 -0
- package/src/xmc/sub-modules/claude-code/sub-agents/xiaoma-planning/requirements-analyst.md +61 -0
- package/src/xmc/sub-modules/claude-code/sub-agents/xiaoma-planning/technical-decisions-curator.md +168 -0
- package/src/xmc/sub-modules/claude-code/sub-agents/xiaoma-planning/trend-spotter.md +115 -0
- package/src/xmc/sub-modules/claude-code/sub-agents/xiaoma-planning/user-journey-mapper.md +123 -0
- package/src/xmc/sub-modules/claude-code/sub-agents/xiaoma-planning/user-researcher.md +72 -0
- package/src/xmc/sub-modules/claude-code/sub-agents/xiaoma-research/market-researcher.md +51 -0
- package/src/xmc/sub-modules/claude-code/sub-agents/xiaoma-research/tech-debt-auditor.md +106 -0
- package/src/xmc/sub-modules/claude-code/sub-agents/xiaoma-review/document-reviewer.md +102 -0
- package/src/xmc/sub-modules/claude-code/sub-agents/xiaoma-review/technical-evaluator.md +68 -0
- package/src/xmc/sub-modules/claude-code/sub-agents/xiaoma-review/test-coverage-analyzer.md +108 -0
- package/src/xmc/teams/default-party.csv +20 -0
- package/src/xmc/teams/team-fullstack.yaml +12 -0
- package/src/xmc/testarch/knowledge/api-request.md +303 -0
- package/src/xmc/testarch/knowledge/auth-session.md +356 -0
- package/src/xmc/testarch/knowledge/burn-in.md +273 -0
- package/src/xmc/testarch/knowledge/ci-burn-in.md +675 -0
- package/src/xmc/testarch/knowledge/component-tdd.md +486 -0
- package/src/xmc/testarch/knowledge/contract-testing.md +957 -0
- package/src/xmc/testarch/knowledge/data-factories.md +500 -0
- package/src/xmc/testarch/knowledge/email-auth.md +721 -0
- package/src/xmc/testarch/knowledge/error-handling.md +725 -0
- package/src/xmc/testarch/knowledge/feature-flags.md +750 -0
- package/src/xmc/testarch/knowledge/file-utils.md +260 -0
- package/src/xmc/testarch/knowledge/fixture-architecture.md +401 -0
- package/src/xmc/testarch/knowledge/fixtures-composition.md +382 -0
- package/src/xmc/testarch/knowledge/intercept-network-call.md +280 -0
- package/src/xmc/testarch/knowledge/log.md +294 -0
- package/src/xmc/testarch/knowledge/network-error-monitor.md +272 -0
- package/src/xmc/testarch/knowledge/network-first.md +486 -0
- package/src/xmc/testarch/knowledge/network-recorder.md +265 -0
- package/src/xmc/testarch/knowledge/nfr-criteria.md +670 -0
- package/src/xmc/testarch/knowledge/overview.md +284 -0
- package/src/xmc/testarch/knowledge/playwright-config.md +730 -0
- package/src/xmc/testarch/knowledge/probability-impact.md +601 -0
- package/src/xmc/testarch/knowledge/recurse.md +296 -0
- package/src/xmc/testarch/knowledge/risk-governance.md +615 -0
- package/src/xmc/testarch/knowledge/selective-testing.md +732 -0
- package/src/xmc/testarch/knowledge/selector-resilience.md +527 -0
- package/src/xmc/testarch/knowledge/test-healing-patterns.md +644 -0
- package/src/xmc/testarch/knowledge/test-levels-framework.md +473 -0
- package/src/xmc/testarch/knowledge/test-priorities-matrix.md +373 -0
- package/src/xmc/testarch/knowledge/test-quality.md +664 -0
- package/src/xmc/testarch/knowledge/timing-debugging.md +372 -0
- package/src/xmc/testarch/knowledge/visual-debugging.md +524 -0
- package/src/xmc/testarch/tea-index.csv +33 -0
- package/src/xmc/workflows/1-analysis/create-product-brief/product-brief.template.md +10 -0
- package/src/xmc/workflows/1-analysis/create-product-brief/steps/step-01-init.md +177 -0
- package/src/xmc/workflows/1-analysis/create-product-brief/steps/step-01b-continue.md +161 -0
- package/src/xmc/workflows/1-analysis/create-product-brief/steps/step-02-vision.md +199 -0
- package/src/xmc/workflows/1-analysis/create-product-brief/steps/step-03-users.md +202 -0
- package/src/xmc/workflows/1-analysis/create-product-brief/steps/step-04-metrics.md +205 -0
- package/src/xmc/workflows/1-analysis/create-product-brief/steps/step-05-scope.md +219 -0
- package/src/xmc/workflows/1-analysis/create-product-brief/steps/step-06-complete.md +162 -0
- package/src/xmc/workflows/1-analysis/create-product-brief/workflow.md +57 -0
- package/src/xmc/workflows/1-analysis/create-product-brief/xiaoma-skill-manifest.yaml +3 -0
- package/src/xmc/workflows/1-analysis/research/domain-steps/step-01-init.md +137 -0
- package/src/xmc/workflows/1-analysis/research/domain-steps/step-02-domain-analysis.md +229 -0
- package/src/xmc/workflows/1-analysis/research/domain-steps/step-03-competitive-landscape.md +238 -0
- package/src/xmc/workflows/1-analysis/research/domain-steps/step-04-regulatory-focus.md +206 -0
- package/src/xmc/workflows/1-analysis/research/domain-steps/step-05-technical-trends.md +234 -0
- package/src/xmc/workflows/1-analysis/research/domain-steps/step-06-research-synthesis.md +444 -0
- package/src/xmc/workflows/1-analysis/research/market-steps/step-01-init.md +182 -0
- package/src/xmc/workflows/1-analysis/research/market-steps/step-02-customer-behavior.md +237 -0
- package/src/xmc/workflows/1-analysis/research/market-steps/step-03-customer-pain-points.md +249 -0
- package/src/xmc/workflows/1-analysis/research/market-steps/step-04-customer-decisions.md +259 -0
- package/src/xmc/workflows/1-analysis/research/market-steps/step-05-competitive-analysis.md +177 -0
- package/src/xmc/workflows/1-analysis/research/market-steps/step-06-research-completion.md +476 -0
- package/src/xmc/workflows/1-analysis/research/research.template.md +29 -0
- package/src/xmc/workflows/1-analysis/research/technical-steps/step-01-init.md +137 -0
- package/src/xmc/workflows/1-analysis/research/technical-steps/step-02-technical-overview.md +239 -0
- package/src/xmc/workflows/1-analysis/research/technical-steps/step-03-integration-patterns.md +248 -0
- package/src/xmc/workflows/1-analysis/research/technical-steps/step-04-architectural-patterns.md +202 -0
- package/src/xmc/workflows/1-analysis/research/technical-steps/step-05-implementation-research.md +233 -0
- package/src/xmc/workflows/1-analysis/research/technical-steps/step-06-research-synthesis.md +487 -0
- package/src/xmc/workflows/1-analysis/research/workflow-domain-research.md +54 -0
- package/src/xmc/workflows/1-analysis/research/workflow-market-research.md +54 -0
- package/src/xmc/workflows/1-analysis/research/workflow-technical-research.md +54 -0
- package/src/xmc/workflows/1-analysis/research/xiaoma-skill-manifest.yaml +14 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/data/domain-complexity.csv +15 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/data/prd-purpose.md +197 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/data/project-types.csv +11 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/steps-c/step-01-init.md +191 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/steps-c/step-01b-continue.md +152 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/steps-c/step-02-discovery.md +224 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/steps-c/step-02b-vision.md +154 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/steps-c/step-02c-executive-summary.md +170 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/steps-c/step-03-success.md +226 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/steps-c/step-04-journeys.md +213 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/steps-c/step-05-domain.md +207 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/steps-c/step-06-innovation.md +226 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/steps-c/step-07-project-type.md +237 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/steps-c/step-08-scoping.md +228 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/steps-c/step-09-functional.md +231 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/steps-c/step-10-nonfunctional.md +242 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/steps-c/step-11-polish.md +217 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/steps-c/step-12-complete.md +124 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/steps-e/step-e-01-discovery.md +247 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/steps-e/step-e-01b-legacy-conversion.md +208 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/steps-e/step-e-02-review.md +249 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/steps-e/step-e-03-edit.md +253 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/steps-e/step-e-04-complete.md +168 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/steps-v/step-v-01-discovery.md +226 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/steps-v/step-v-02-format-detection.md +191 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/steps-v/step-v-02b-parity-check.md +209 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/steps-v/step-v-03-density-validation.md +174 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/steps-v/step-v-04-brief-coverage-validation.md +214 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/steps-v/step-v-05-measurability-validation.md +228 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/steps-v/step-v-06-traceability-validation.md +217 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/steps-v/step-v-07-implementation-leakage-validation.md +205 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/steps-v/step-v-08-domain-compliance-validation.md +243 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/steps-v/step-v-09-project-type-validation.md +263 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/steps-v/step-v-10-smart-validation.md +209 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/steps-v/step-v-11-holistic-quality-validation.md +264 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/steps-v/step-v-12-completeness-validation.md +242 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/steps-v/step-v-13-report-complete.md +231 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/templates/prd-template.md +10 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/workflow-create-prd.md +63 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/workflow-edit-prd.md +65 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/workflow-validate-prd.md +63 -0
- package/src/xmc/workflows/2-plan-workflows/create-prd/xiaoma-skill-manifest.yaml +14 -0
- package/src/xmc/workflows/2-plan-workflows/create-ux-design/steps/step-01-init.md +135 -0
- package/src/xmc/workflows/2-plan-workflows/create-ux-design/steps/step-01b-continue.md +127 -0
- package/src/xmc/workflows/2-plan-workflows/create-ux-design/steps/step-02-discovery.md +190 -0
- package/src/xmc/workflows/2-plan-workflows/create-ux-design/steps/step-03-core-experience.md +216 -0
- package/src/xmc/workflows/2-plan-workflows/create-ux-design/steps/step-04-emotional-response.md +219 -0
- package/src/xmc/workflows/2-plan-workflows/create-ux-design/steps/step-05-inspiration.md +234 -0
- package/src/xmc/workflows/2-plan-workflows/create-ux-design/steps/step-06-design-system.md +252 -0
- package/src/xmc/workflows/2-plan-workflows/create-ux-design/steps/step-07-defining-experience.md +254 -0
- package/src/xmc/workflows/2-plan-workflows/create-ux-design/steps/step-08-visual-foundation.md +224 -0
- package/src/xmc/workflows/2-plan-workflows/create-ux-design/steps/step-09-design-directions.md +224 -0
- package/src/xmc/workflows/2-plan-workflows/create-ux-design/steps/step-10-user-journeys.md +241 -0
- package/src/xmc/workflows/2-plan-workflows/create-ux-design/steps/step-11-component-strategy.md +248 -0
- package/src/xmc/workflows/2-plan-workflows/create-ux-design/steps/step-12-ux-patterns.md +237 -0
- package/src/xmc/workflows/2-plan-workflows/create-ux-design/steps/step-13-responsive-accessibility.md +264 -0
- package/src/xmc/workflows/2-plan-workflows/create-ux-design/steps/step-14-complete.md +171 -0
- package/src/xmc/workflows/2-plan-workflows/create-ux-design/ux-design-template.md +13 -0
- package/src/xmc/workflows/2-plan-workflows/create-ux-design/workflow.md +42 -0
- package/src/xmc/workflows/2-plan-workflows/create-ux-design/xiaoma-skill-manifest.yaml +3 -0
- package/src/xmc/workflows/3-solutioning/check-implementation-readiness/steps/step-01-document-discovery.md +184 -0
- package/src/xmc/workflows/3-solutioning/check-implementation-readiness/steps/step-02-prd-analysis.md +172 -0
- package/src/xmc/workflows/3-solutioning/check-implementation-readiness/steps/step-03-epic-coverage-validation.md +173 -0
- package/src/xmc/workflows/3-solutioning/check-implementation-readiness/steps/step-04-ux-alignment.md +133 -0
- package/src/xmc/workflows/3-solutioning/check-implementation-readiness/steps/step-05-epic-quality-review.md +245 -0
- package/src/xmc/workflows/3-solutioning/check-implementation-readiness/steps/step-06-final-assessment.md +129 -0
- package/src/xmc/workflows/3-solutioning/check-implementation-readiness/templates/readiness-report-template.md +4 -0
- package/src/xmc/workflows/3-solutioning/check-implementation-readiness/workflow.md +54 -0
- package/src/xmc/workflows/3-solutioning/check-implementation-readiness/xiaoma-skill-manifest.yaml +3 -0
- package/src/xmc/workflows/3-solutioning/create-architecture/architecture-decision-template.md +12 -0
- package/src/xmc/workflows/3-solutioning/create-architecture/data/domain-complexity.csv +13 -0
- package/src/xmc/workflows/3-solutioning/create-architecture/data/project-types.csv +7 -0
- package/src/xmc/workflows/3-solutioning/create-architecture/steps/step-01-init.md +153 -0
- package/src/xmc/workflows/3-solutioning/create-architecture/steps/step-01b-continue.md +173 -0
- package/src/xmc/workflows/3-solutioning/create-architecture/steps/step-02-context.md +224 -0
- package/src/xmc/workflows/3-solutioning/create-architecture/steps/step-03-starter.md +329 -0
- package/src/xmc/workflows/3-solutioning/create-architecture/steps/step-04-decisions.md +318 -0
- package/src/xmc/workflows/3-solutioning/create-architecture/steps/step-05-patterns.md +359 -0
- package/src/xmc/workflows/3-solutioning/create-architecture/steps/step-06-structure.md +379 -0
- package/src/xmc/workflows/3-solutioning/create-architecture/steps/step-07-validation.md +359 -0
- package/src/xmc/workflows/3-solutioning/create-architecture/steps/step-08-complete.md +76 -0
- package/src/xmc/workflows/3-solutioning/create-architecture/workflow.md +49 -0
- package/src/xmc/workflows/3-solutioning/create-architecture/xiaoma-skill-manifest.yaml +3 -0
- package/src/xmc/workflows/3-solutioning/create-epics-and-stories/steps/step-01-validate-prerequisites.md +259 -0
- package/src/xmc/workflows/3-solutioning/create-epics-and-stories/steps/step-02-design-epics.md +233 -0
- package/src/xmc/workflows/3-solutioning/create-epics-and-stories/steps/step-03-create-stories.md +272 -0
- package/src/xmc/workflows/3-solutioning/create-epics-and-stories/steps/step-04-final-validation.md +149 -0
- package/src/xmc/workflows/3-solutioning/create-epics-and-stories/templates/epics-template.md +57 -0
- package/src/xmc/workflows/3-solutioning/create-epics-and-stories/workflow.md +58 -0
- package/src/xmc/workflows/3-solutioning/create-epics-and-stories/xiaoma-skill-manifest.yaml +3 -0
- package/src/xmc/workflows/4-implementation/code-review/checklist.md +23 -0
- package/src/xmc/workflows/4-implementation/code-review/discover-inputs.md +88 -0
- package/src/xmc/workflows/4-implementation/code-review/workflow.md +271 -0
- package/src/xmc/workflows/4-implementation/code-review/xiaoma-skill-manifest.yaml +3 -0
- package/src/xmc/workflows/4-implementation/correct-course/checklist.md +288 -0
- package/src/xmc/workflows/4-implementation/correct-course/workflow.md +274 -0
- package/src/xmc/workflows/4-implementation/correct-course/xiaoma-skill-manifest.yaml +3 -0
- package/src/xmc/workflows/4-implementation/create-story/checklist.md +357 -0
- package/src/xmc/workflows/4-implementation/create-story/discover-inputs.md +88 -0
- package/src/xmc/workflows/4-implementation/create-story/template.md +49 -0
- package/src/xmc/workflows/4-implementation/create-story/workflow.md +388 -0
- package/src/xmc/workflows/4-implementation/create-story/xiaoma-skill-manifest.yaml +3 -0
- package/src/xmc/workflows/4-implementation/dev-story/checklist.md +80 -0
- package/src/xmc/workflows/4-implementation/dev-story/workflow.md +457 -0
- package/src/xmc/workflows/4-implementation/dev-story/xiaoma-skill-manifest.yaml +3 -0
- package/src/xmc/workflows/4-implementation/retrospective/workflow.md +1485 -0
- package/src/xmc/workflows/4-implementation/retrospective/xiaoma-skill-manifest.yaml +3 -0
- package/src/xmc/workflows/4-implementation/sprint-planning/checklist.md +33 -0
- package/src/xmc/workflows/4-implementation/sprint-planning/sprint-status-template.yaml +56 -0
- package/src/xmc/workflows/4-implementation/sprint-planning/workflow.md +271 -0
- package/src/xmc/workflows/4-implementation/sprint-planning/xiaoma-skill-manifest.yaml +3 -0
- package/src/xmc/workflows/4-implementation/sprint-status/workflow.md +267 -0
- package/src/xmc/workflows/4-implementation/sprint-status/xiaoma-skill-manifest.yaml +3 -0
- package/src/xmc/workflows/document-project/checklist.md +245 -0
- package/src/xmc/workflows/document-project/documentation-requirements.csv +12 -0
- package/src/xmc/workflows/document-project/instructions.md +128 -0
- package/src/xmc/workflows/document-project/templates/deep-dive-template.md +345 -0
- package/src/xmc/workflows/document-project/templates/index-template.md +169 -0
- package/src/xmc/workflows/document-project/templates/project-overview-template.md +103 -0
- package/src/xmc/workflows/document-project/templates/project-scan-report-schema.json +160 -0
- package/src/xmc/workflows/document-project/templates/source-tree-template.md +135 -0
- package/src/xmc/workflows/document-project/workflow.md +39 -0
- package/src/xmc/workflows/document-project/workflows/deep-dive-instructions.md +297 -0
- package/src/xmc/workflows/document-project/workflows/deep-dive-workflow.md +42 -0
- package/src/xmc/workflows/document-project/workflows/full-scan-instructions.md +1105 -0
- package/src/xmc/workflows/document-project/workflows/full-scan-workflow.md +42 -0
- package/src/xmc/workflows/document-project/xiaoma-skill-manifest.yaml +3 -0
- package/src/xmc/workflows/generate-project-context/project-context-template.md +21 -0
- package/src/xmc/workflows/generate-project-context/steps/step-01-discover.md +184 -0
- package/src/xmc/workflows/generate-project-context/steps/step-02-generate.md +318 -0
- package/src/xmc/workflows/generate-project-context/steps/step-03-complete.md +278 -0
- package/src/xmc/workflows/generate-project-context/workflow.md +49 -0
- package/src/xmc/workflows/generate-project-context/xiaoma-skill-manifest.yaml +3 -0
- package/src/xmc/workflows/qa-generate-e2e-tests/checklist.md +33 -0
- package/src/xmc/workflows/qa-generate-e2e-tests/workflow.md +143 -0
- package/src/xmc/workflows/qa-generate-e2e-tests/xiaoma-skill-manifest.yaml +3 -0
- package/src/xmc/workflows/xiaoma-quick-flow/quick-dev/steps/step-01-mode-detection.md +174 -0
- package/src/xmc/workflows/xiaoma-quick-flow/quick-dev/steps/step-02-context-gathering.md +118 -0
- package/src/xmc/workflows/xiaoma-quick-flow/quick-dev/steps/step-03-execute.md +111 -0
- package/src/xmc/workflows/xiaoma-quick-flow/quick-dev/steps/step-04-self-check.md +111 -0
- package/src/xmc/workflows/xiaoma-quick-flow/quick-dev/steps/step-05-adversarial-review.md +98 -0
- package/src/xmc/workflows/xiaoma-quick-flow/quick-dev/steps/step-06-resolve-findings.md +146 -0
- package/src/xmc/workflows/xiaoma-quick-flow/quick-dev/workflow.md +50 -0
- package/src/xmc/workflows/xiaoma-quick-flow/quick-dev/xiaoma-skill-manifest.yaml +3 -0
- package/src/xmc/workflows/xiaoma-quick-flow/quick-spec/steps/step-01-understand.md +189 -0
- package/src/xmc/workflows/xiaoma-quick-flow/quick-spec/steps/step-02-investigate.md +143 -0
- package/src/xmc/workflows/xiaoma-quick-flow/quick-spec/steps/step-03-generate.md +126 -0
- package/src/xmc/workflows/xiaoma-quick-flow/quick-spec/steps/step-04-review.md +198 -0
- package/src/xmc/workflows/xiaoma-quick-flow/quick-spec/tech-spec-template.md +74 -0
- package/src/xmc/workflows/xiaoma-quick-flow/quick-spec/workflow.md +79 -0
- package/src/xmc/workflows/xiaoma-quick-flow/quick-spec/xiaoma-skill-manifest.yaml +3 -0
- package/src/xmc/workflows/xiaoma-quick-flow/xiaoma-quick-dev-new-preview/SKILL.md +6 -0
- package/src/xmc/workflows/xiaoma-quick-flow/xiaoma-quick-dev-new-preview/steps/step-01-clarify-and-route.md +54 -0
- package/src/xmc/workflows/xiaoma-quick-flow/xiaoma-quick-dev-new-preview/steps/step-02-plan.md +39 -0
- package/src/xmc/workflows/xiaoma-quick-flow/xiaoma-quick-dev-new-preview/steps/step-03-implement.md +35 -0
- package/src/xmc/workflows/xiaoma-quick-flow/xiaoma-quick-dev-new-preview/steps/step-04-review.md +55 -0
- package/src/xmc/workflows/xiaoma-quick-flow/xiaoma-quick-dev-new-preview/steps/step-05-present.md +19 -0
- package/src/xmc/workflows/xiaoma-quick-flow/xiaoma-quick-dev-new-preview/tech-spec-template.md +90 -0
- package/src/xmc/workflows/xiaoma-quick-flow/xiaoma-quick-dev-new-preview/workflow.md +84 -0
- package/src/xmc/workflows/xiaoma-quick-flow/xiaoma-quick-dev-new-preview/xiaoma-skill-manifest.yaml +1 -0
- package/test/README.md +295 -0
- package/test/adversarial-review-tests/README.md +56 -0
- package/test/adversarial-review-tests/sample-content.md +46 -0
- package/test/adversarial-review-tests/test-cases.yaml +103 -0
- package/test/fixtures/agent-schema/invalid/critical-actions/actions-as-string.agent.yaml +27 -0
- package/test/fixtures/agent-schema/invalid/critical-actions/empty-string-in-actions.agent.yaml +30 -0
- package/test/fixtures/agent-schema/invalid/menu/empty-menu.agent.yaml +22 -0
- package/test/fixtures/agent-schema/invalid/menu/missing-menu.agent.yaml +20 -0
- package/test/fixtures/agent-schema/invalid/menu-commands/empty-command-target.agent.yaml +25 -0
- package/test/fixtures/agent-schema/invalid/menu-commands/no-command-target.agent.yaml +24 -0
- package/test/fixtures/agent-schema/invalid/menu-triggers/camel-case.agent.yaml +25 -0
- package/test/fixtures/agent-schema/invalid/menu-triggers/compound-invalid-format.agent.yaml +25 -0
- package/test/fixtures/agent-schema/invalid/menu-triggers/compound-mismatched-kebab.agent.yaml +25 -0
- package/test/fixtures/agent-schema/invalid/menu-triggers/duplicate-triggers.agent.yaml +31 -0
- package/test/fixtures/agent-schema/invalid/menu-triggers/empty-trigger.agent.yaml +25 -0
- package/test/fixtures/agent-schema/invalid/menu-triggers/leading-asterisk.agent.yaml +25 -0
- package/test/fixtures/agent-schema/invalid/menu-triggers/snake-case.agent.yaml +25 -0
- package/test/fixtures/agent-schema/invalid/menu-triggers/trigger-with-spaces.agent.yaml +25 -0
- package/test/fixtures/agent-schema/invalid/metadata/empty-module-string.agent.yaml +26 -0
- package/test/fixtures/agent-schema/invalid/metadata/empty-name.agent.yaml +24 -0
- package/test/fixtures/agent-schema/invalid/metadata/extra-metadata-fields.agent.yaml +27 -0
- package/test/fixtures/agent-schema/invalid/metadata/missing-id.agent.yaml +23 -0
- package/test/fixtures/agent-schema/invalid/persona/empty-principles-array.agent.yaml +24 -0
- package/test/fixtures/agent-schema/invalid/persona/empty-string-in-principles.agent.yaml +27 -0
- package/test/fixtures/agent-schema/invalid/persona/extra-persona-fields.agent.yaml +27 -0
- package/test/fixtures/agent-schema/invalid/persona/missing-role.agent.yaml +24 -0
- package/test/fixtures/agent-schema/invalid/prompts/empty-content.agent.yaml +29 -0
- package/test/fixtures/agent-schema/invalid/prompts/extra-prompt-fields.agent.yaml +31 -0
- package/test/fixtures/agent-schema/invalid/prompts/missing-content.agent.yaml +28 -0
- package/test/fixtures/agent-schema/invalid/prompts/missing-id.agent.yaml +28 -0
- package/test/fixtures/agent-schema/invalid/top-level/empty-file.agent.yaml +5 -0
- package/test/fixtures/agent-schema/invalid/top-level/extra-top-level-keys.agent.yaml +28 -0
- package/test/fixtures/agent-schema/invalid/top-level/missing-agent-key.agent.yaml +11 -0
- package/test/fixtures/agent-schema/invalid/yaml-errors/invalid-indentation.agent.yaml +19 -0
- package/test/fixtures/agent-schema/invalid/yaml-errors/malformed-yaml.agent.yaml +18 -0
- package/test/fixtures/agent-schema/valid/critical-actions/empty-critical-actions.agent.yaml +24 -0
- package/test/fixtures/agent-schema/valid/critical-actions/no-critical-actions.agent.yaml +22 -0
- package/test/fixtures/agent-schema/valid/critical-actions/valid-critical-actions.agent.yaml +27 -0
- package/test/fixtures/agent-schema/valid/menu/multiple-menu-items.agent.yaml +31 -0
- package/test/fixtures/agent-schema/valid/menu/single-menu-item.agent.yaml +22 -0
- package/test/fixtures/agent-schema/valid/menu-commands/all-command-types.agent.yaml +38 -0
- package/test/fixtures/agent-schema/valid/menu-commands/multiple-commands.agent.yaml +23 -0
- package/test/fixtures/agent-schema/valid/menu-triggers/compound-triggers.agent.yaml +31 -0
- package/test/fixtures/agent-schema/valid/menu-triggers/kebab-case-triggers.agent.yaml +34 -0
- package/test/fixtures/agent-schema/valid/metadata/core-agent-with-module.agent.yaml +24 -0
- package/test/fixtures/agent-schema/valid/metadata/empty-module-name-in-path.agent.yaml +24 -0
- package/test/fixtures/agent-schema/valid/metadata/malformed-path-treated-as-core.agent.yaml +24 -0
- package/test/fixtures/agent-schema/valid/metadata/module-agent-correct.agent.yaml +24 -0
- package/test/fixtures/agent-schema/valid/metadata/module-agent-missing-module.agent.yaml +23 -0
- package/test/fixtures/agent-schema/valid/metadata/wrong-module-value.agent.yaml +24 -0
- package/test/fixtures/agent-schema/valid/persona/complete-persona.agent.yaml +24 -0
- package/test/fixtures/agent-schema/valid/prompts/empty-prompts.agent.yaml +24 -0
- package/test/fixtures/agent-schema/valid/prompts/no-prompts.agent.yaml +22 -0
- package/test/fixtures/agent-schema/valid/prompts/valid-prompts-minimal.agent.yaml +28 -0
- package/test/fixtures/agent-schema/valid/prompts/valid-prompts-with-description.agent.yaml +30 -0
- package/test/fixtures/agent-schema/valid/top-level/minimal-core-agent.agent.yaml +24 -0
- package/test/fixtures/file-refs-csv/invalid/all-empty-workflow.csv +3 -0
- package/test/fixtures/file-refs-csv/invalid/empty-data.csv +1 -0
- package/test/fixtures/file-refs-csv/invalid/no-workflow-column.csv +3 -0
- package/test/fixtures/file-refs-csv/invalid/unresolvable-vars.csv +3 -0
- package/test/fixtures/file-refs-csv/valid/core-style.csv +3 -0
- package/test/fixtures/file-refs-csv/valid/minimal.csv +2 -0
- package/test/fixtures/file-refs-csv/valid/xmc-style.csv +3 -0
- package/test/test-agent-schema.js +387 -0
- package/test/test-cli-integration.sh +159 -0
- package/test/test-file-refs-csv.js +133 -0
- package/test/test-install-to-xiaoma.js +154 -0
- package/test/test-installation-components.js +1802 -0
- package/test/test-rehype-plugins.mjs +1050 -0
- package/test/test-workflow-path-regex.js +88 -0
- package/test/unit-test-schema.js +133 -0
- package/tools/build-docs.mjs +464 -0
- package/tools/cli/README.md +60 -0
- package/tools/cli/bundlers/bundle-web.js +179 -0
- package/tools/cli/bundlers/bundlers/bundle-web.js +179 -0
- package/tools/cli/bundlers/bundlers/test-analyst.js +28 -0
- package/tools/cli/bundlers/bundlers/test-bundler.js +119 -0
- package/tools/cli/bundlers/bundlers/web-bundler.js +1754 -0
- package/tools/cli/bundlers/test-analyst.js +28 -0
- package/tools/cli/bundlers/test-bundler.js +119 -0
- package/tools/cli/bundlers/web-bundler.js +1754 -0
- package/tools/cli/commands/agent-install.js +409 -0
- package/tools/cli/commands/build.js +458 -0
- package/tools/cli/commands/cleanup.js +144 -0
- package/tools/cli/commands/install.js +87 -0
- package/tools/cli/commands/list.js +43 -0
- package/tools/cli/commands/status.js +65 -0
- package/tools/cli/commands/uninstall.js +167 -0
- package/tools/cli/commands/update.js +28 -0
- package/tools/cli/external-official-modules.yaml +53 -0
- package/tools/cli/installers/install-messages.yaml +39 -0
- package/tools/cli/installers/lib/core/config-collector.js +1285 -0
- package/tools/cli/installers/lib/core/custom-module-cache.js +260 -0
- package/tools/cli/installers/lib/core/dependency-resolver.js +743 -0
- package/tools/cli/installers/lib/core/detector.js +223 -0
- package/tools/cli/installers/lib/core/ide-config-manager.js +157 -0
- package/tools/cli/installers/lib/core/installer.js +3195 -0
- package/tools/cli/installers/lib/core/manifest-generator.js +1374 -0
- package/tools/cli/installers/lib/core/manifest.js +1038 -0
- package/tools/cli/installers/lib/custom/handler.js +358 -0
- package/tools/cli/installers/lib/ide/_base-ide.js +674 -0
- package/tools/cli/installers/lib/ide/_config-driven.js +1053 -0
- package/tools/cli/installers/lib/ide/antigravity.js +510 -0
- package/tools/cli/installers/lib/ide/auggie.js +232 -0
- package/tools/cli/installers/lib/ide/claude-code.js +512 -0
- package/tools/cli/installers/lib/ide/cline.js +269 -0
- package/tools/cli/installers/lib/ide/codex.js +440 -0
- package/tools/cli/installers/lib/ide/crush.js +287 -0
- package/tools/cli/installers/lib/ide/cursor.js +400 -0
- package/tools/cli/installers/lib/ide/gemini.js +253 -0
- package/tools/cli/installers/lib/ide/github-copilot.js +699 -0
- package/tools/cli/installers/lib/ide/iflow.js +172 -0
- package/tools/cli/installers/lib/ide/kilo.js +269 -0
- package/tools/cli/installers/lib/ide/manager.js +304 -0
- package/tools/cli/installers/lib/ide/opencode.js +257 -0
- package/tools/cli/installers/lib/ide/platform-codes.js +100 -0
- package/tools/cli/installers/lib/ide/platform-codes.yaml +321 -0
- package/tools/cli/installers/lib/ide/qwen.js +372 -0
- package/tools/cli/installers/lib/ide/roo.js +324 -0
- package/tools/cli/installers/lib/ide/rovo-dev.js +290 -0
- package/tools/cli/installers/lib/ide/rovodev.js +257 -0
- package/tools/cli/installers/lib/ide/shared/agent-command-generator.js +181 -0
- package/tools/cli/installers/lib/ide/shared/module-injections.js +136 -0
- package/tools/cli/installers/lib/ide/shared/path-utils.js +364 -0
- package/tools/cli/installers/lib/ide/shared/skill-manifest.js +90 -0
- package/tools/cli/installers/lib/ide/shared/task-tool-command-generator.js +368 -0
- package/tools/cli/installers/lib/ide/shared/workflow-command-generator.js +179 -0
- package/tools/cli/installers/lib/ide/shared/xiaoma-artifacts.js +181 -0
- package/tools/cli/installers/lib/ide/templates/agent-command-template.md +14 -0
- package/tools/cli/installers/lib/ide/templates/combined/antigravity.md +8 -0
- package/tools/cli/installers/lib/ide/templates/combined/default-agent.md +15 -0
- package/tools/cli/installers/lib/ide/templates/combined/default-task.md +10 -0
- package/tools/cli/installers/lib/ide/templates/combined/default-tool.md +10 -0
- package/tools/cli/installers/lib/ide/templates/combined/default-workflow-yaml.md +14 -0
- package/tools/cli/installers/lib/ide/templates/combined/default-workflow.md +6 -0
- package/tools/cli/installers/lib/ide/templates/combined/gemini-agent.toml +14 -0
- package/tools/cli/installers/lib/ide/templates/combined/gemini-task.toml +11 -0
- package/tools/cli/installers/lib/ide/templates/combined/gemini-tool.toml +11 -0
- package/tools/cli/installers/lib/ide/templates/combined/gemini-workflow-yaml.toml +16 -0
- package/tools/cli/installers/lib/ide/templates/combined/gemini-workflow.toml +14 -0
- package/tools/cli/installers/lib/ide/templates/combined/kiro-agent.md +16 -0
- package/tools/cli/installers/lib/ide/templates/combined/kiro-task.md +9 -0
- package/tools/cli/installers/lib/ide/templates/combined/kiro-tool.md +9 -0
- package/tools/cli/installers/lib/ide/templates/combined/kiro-workflow-yaml.md +15 -0
- package/tools/cli/installers/lib/ide/templates/combined/kiro-workflow.md +7 -0
- package/tools/cli/installers/lib/ide/templates/combined/opencode-agent.md +15 -0
- package/tools/cli/installers/lib/ide/templates/combined/opencode-task.md +13 -0
- package/tools/cli/installers/lib/ide/templates/combined/opencode-tool.md +13 -0
- package/tools/cli/installers/lib/ide/templates/combined/opencode-workflow-yaml.md +16 -0
- package/tools/cli/installers/lib/ide/templates/combined/opencode-workflow.md +16 -0
- package/tools/cli/installers/lib/ide/templates/combined/rovodev.md +9 -0
- package/tools/cli/installers/lib/ide/templates/combined/trae.md +9 -0
- package/tools/cli/installers/lib/ide/templates/combined/windsurf-workflow.md +10 -0
- package/tools/cli/installers/lib/ide/templates/gemini-agent-command.toml +14 -0
- package/tools/cli/installers/lib/ide/templates/gemini-task-command.toml +12 -0
- package/tools/cli/installers/lib/ide/templates/split/.gitkeep +0 -0
- package/tools/cli/installers/lib/ide/templates/workflow-command-template.md +13 -0
- package/tools/cli/installers/lib/ide/templates/workflow-commander.md +5 -0
- package/tools/cli/installers/lib/ide/trae.js +313 -0
- package/tools/cli/installers/lib/ide/windsurf.js +258 -0
- package/tools/cli/installers/lib/message-loader.js +83 -0
- package/tools/cli/installers/lib/modules/external-manager.js +136 -0
- package/tools/cli/installers/lib/modules/manager.js +1382 -0
- package/tools/cli/lib/activation-builder.js +165 -0
- package/tools/cli/lib/agent/compiler.js +516 -0
- package/tools/cli/lib/agent/installer.js +680 -0
- package/tools/cli/lib/agent/template-engine.js +152 -0
- package/tools/cli/lib/agent-analyzer.js +97 -0
- package/tools/cli/lib/agent-party-generator.js +194 -0
- package/tools/cli/lib/cli-utils.js +182 -0
- package/tools/cli/lib/config.js +213 -0
- package/tools/cli/lib/file-ops.js +204 -0
- package/tools/cli/lib/platform-codes.js +116 -0
- package/tools/cli/lib/project-root.js +77 -0
- package/tools/cli/lib/prompts.js +809 -0
- package/tools/cli/lib/replace-project-root.js +239 -0
- package/tools/cli/lib/ui.js +1940 -0
- package/tools/cli/lib/xml-handler.js +177 -0
- package/tools/cli/lib/xml-to-markdown.js +82 -0
- package/tools/{yaml-format.js → cli/lib/yaml-format.js} +39 -71
- package/tools/cli/lib/yaml-xml-builder.js +570 -0
- package/tools/cli/regenerate-manifests.js +28 -0
- package/tools/cli/test-yaml-builder.js +43 -0
- package/tools/cli/xiaoma-cli.js +106 -0
- package/tools/docs/_prompt-external-modules-page.md +59 -0
- package/tools/docs/fix-refs.md +91 -0
- package/tools/docs/native-skills-migration-checklist.md +281 -0
- package/tools/fix-doc-links.js +285 -0
- package/tools/flattener/aggregate.js +12 -30
- package/tools/flattener/binary.js +43 -46
- package/tools/flattener/discovery.js +15 -23
- package/tools/flattener/files.js +6 -6
- package/tools/flattener/flattener/aggregate.js +76 -0
- package/tools/flattener/flattener/binary.js +80 -0
- package/tools/flattener/flattener/discovery.js +71 -0
- package/tools/flattener/flattener/files.js +35 -0
- package/tools/flattener/flattener/ignoreRules.js +172 -0
- package/tools/flattener/flattener/main.js +483 -0
- package/tools/flattener/flattener/projectRoot.js +201 -0
- package/tools/flattener/flattener/prompts.js +44 -0
- package/tools/flattener/flattener/stats.helpers.js +368 -0
- package/tools/flattener/flattener/stats.js +75 -0
- package/tools/flattener/flattener/test-matrix.js +409 -0
- package/tools/flattener/flattener/xml.js +88 -0
- package/tools/flattener/ignoreRules.js +122 -127
- package/tools/flattener/main.js +140 -330
- package/tools/flattener/projectRoot.js +71 -81
- package/tools/flattener/prompts.js +10 -12
- package/tools/flattener/stats.helpers.js +63 -119
- package/tools/flattener/stats.js +2 -7
- package/tools/flattener/test-matrix.js +169 -228
- package/tools/flattener/xml.js +23 -31
- package/tools/format-workflow-md.js +263 -0
- package/tools/lib/xml-utils.js +13 -0
- package/tools/migrate-custom-module-paths.js +124 -0
- package/tools/platform-codes.yaml +157 -0
- package/tools/schema/agent.js +489 -0
- package/tools/validate-agent-schema.js +110 -0
- package/tools/validate-bundles.js +87 -0
- package/tools/validate-doc-links.js +409 -0
- package/tools/validate-file-refs.js +556 -0
- package/tools/validate-svg-changes.sh +356 -0
- package/tools/xiaoma-npx-wrapper.js +18 -24
- package/web-bundles/xmc/agents/analyst.xml +109 -0
- package/web-bundles/xmc/agents/architect.xml +101 -0
- package/web-bundles/xmc/agents/dev.xml +106 -0
- package/web-bundles/xmc/agents/pm.xml +112 -0
- package/web-bundles/xmc/agents/qa.xml +126 -0
- package/web-bundles/xmc/agents/quick-flow-solo-dev.xml +104 -0
- package/web-bundles/xmc/agents/sm.xml +109 -0
- package/web-bundles/xmc/agents/ux-designer.xml +100 -0
- package/web-bundles/xmc/teams/team-fullstack.xml +1192 -0
- package/.claude/agents/tech-translator.md +0 -124
- package/.claude/settings.local.json +0 -37
- package/.idea/misc.xml +0 -6
- package/.xiaoma-core/.coordinator-state.json +0 -19
- package/CLAUDE.md +0 -283
- package/JAVA-BACKEND-COMMANDS-REFERENCE.md +0 -300
- package/JAVA-BACKEND-ITERATION-GUIDE.md +0 -2116
- package/common/tasks/create-doc.md +0 -103
- package/common/tasks/execute-checklist.md +0 -88
- package/common/utils/bmad-doc-template.md +0 -327
- package/common/utils/workflow-management.md +0 -71
- package/dist/agents/analyst.txt +0 -6308
- package/dist/agents/architect.txt +0 -5046
- package/dist/agents/automation-orchestrator.txt +0 -396
- package/dist/agents/dev.txt +0 -1180
- package/dist/agents/full-requirement-orchestrator.txt +0 -505
- package/dist/agents/pm.txt +0 -3078
- package/dist/agents/po.txt +0 -1358
- package/dist/agents/qa.txt +0 -2002
- package/dist/agents/sm.txt +0 -3044
- package/dist/agents/ux-expert.txt +0 -707
- package/dist/agents/workflow-executor.txt +0 -1029
- package/dist/agents/workflow-helper.txt +0 -93
- package/dist/agents/xiaoma-master.txt +0 -9008
- package/dist/agents/xiaoma-orchestrator.txt +0 -1523
- package/dist/teams/team-all.txt +0 -23101
- package/dist/teams/team-fullstack-with-database.txt +0 -25076
- package/dist/teams/team-fullstack.txt +0 -15820
- package/dist/teams/team-ide-minimal.txt +0 -8285
- package/dist/teams/team-no-ui.txt +0 -14368
- package/docs/GUIDING-PRINCIPLES.md +0 -91
- package/docs/architecture/workflow-coordinator-implementation.md +0 -1188
- package/docs/architecture-sharding-modification.md +0 -623
- package/docs/automated-requirements-analysis-outputs.md +0 -896
- package/docs/core-architecture.md +0 -219
- package/docs/enhanced-ide-development-workflow.md +0 -248
- package/docs/prd/workflow-coordinator-prd.md +0 -1214
- package/docs/user-guide.md +0 -530
- package/docs/versioning-and-releases.md +0 -155
- package/docs/versions.md +0 -48
- package/docs/working-in-the-brownfield.md +0 -597
- package/tools/api-server.js +0 -367
- package/tools/builders/web-builder.js +0 -830
- package/tools/bump-all-versions.js +0 -133
- package/tools/cli.js +0 -157
- package/tools/installer/README.md +0 -8
- package/tools/installer/bin/xiaoma.js +0 -477
- package/tools/installer/config/ide-agent-config.yaml +0 -58
- package/tools/installer/config/install.config.yaml +0 -164
- package/tools/installer/lib/config-loader.js +0 -286
- package/tools/installer/lib/file-manager.js +0 -446
- package/tools/installer/lib/ide-base-setup.js +0 -238
- package/tools/installer/lib/ide-setup.js +0 -2027
- package/tools/installer/lib/installer.js +0 -2333
- package/tools/installer/lib/memory-profiler.js +0 -235
- package/tools/installer/lib/module-manager.js +0 -116
- package/tools/installer/lib/resource-locator.js +0 -334
- package/tools/installer/package-lock.json +0 -715
- package/tools/installer/package.json +0 -44
- package/tools/lib/dependency-resolver.js +0 -186
- package/tools/lib/yaml-utils.js +0 -34
- package/tools/md-assets/web-agent-startup-instructions.md +0 -39
- package/tools/preview-release-notes.js +0 -74
- package/tools/setup-hooks.sh +0 -37
- package/tools/shared/bannerArt.js +0 -105
- package/tools/sync-installer-version.js +0 -41
- package/tools/sync-version.sh +0 -23
- package/tools/upgraders/v3-to-v4-upgrader.js +0 -753
- package/tools/version-bump.js +0 -100
- package/tools/workflow-coordinator/README.md +0 -38
- package/tools/workflow-coordinator/USAGE.md +0 -548
- package/tools/workflow-coordinator/package-lock.json +0 -4868
- package/tools/workflow-coordinator/package.json +0 -35
- package/tools/workflow-coordinator/src/api/server.js +0 -207
- package/tools/workflow-coordinator/src/controller/workflow-controller.js +0 -263
- package/tools/workflow-coordinator/src/index.js +0 -113
- package/tools/workflow-coordinator/src/parser/workflow-parser.js +0 -144
- package/tools/workflow-coordinator/src/utils/state-manager.js +0 -59
- package/tools/workflow-coordinator/src/utils/validator.js +0 -86
- package/tools/workflow-coordinator/test/integration-test.js +0 -266
- package/tools/workflow-coordinator/test/quick-test.js +0 -127
- package/xiaoma-core/agent-teams/team-all.yaml +0 -15
- package/xiaoma-core/agent-teams/team-fullstack-with-database.yaml +0 -27
- package/xiaoma-core/agent-teams/team-fullstack.yaml +0 -19
- package/xiaoma-core/agent-teams/team-ide-minimal.yaml +0 -11
- package/xiaoma-core/agent-teams/team-no-ui.yaml +0 -14
- package/xiaoma-core/agents/analyst.md +0 -91
- package/xiaoma-core/agents/architect.md +0 -88
- package/xiaoma-core/agents/automated-fix-validator.yaml +0 -579
- package/xiaoma-core/agents/automated-quality-validator.yaml +0 -549
- package/xiaoma-core/agents/automation-orchestrator.md +0 -353
- package/xiaoma-core/agents/dev.md +0 -144
- package/xiaoma-core/agents/enhanced-workflow-orchestrator.yaml +0 -304
- package/xiaoma-core/agents/full-requirement-orchestrator.md +0 -462
- package/xiaoma-core/agents/global-requirements-auditor.yaml +0 -520
- package/xiaoma-core/agents/intelligent-template-adapter.yaml +0 -389
- package/xiaoma-core/agents/issue-dispatcher.yaml +0 -627
- package/xiaoma-core/agents/master-execution-engine.yaml +0 -543
- package/xiaoma-core/agents/pm.md +0 -85
- package/xiaoma-core/agents/po.md +0 -77
- package/xiaoma-core/agents/qa.md +0 -88
- package/xiaoma-core/agents/requirements-coverage-auditor.yaml +0 -373
- package/xiaoma-core/agents/sm.md +0 -125
- package/xiaoma-core/agents/ux-expert.md +0 -67
- package/xiaoma-core/agents/workflow-executor.md +0 -1031
- package/xiaoma-core/agents/workflow-helper.md +0 -481
- package/xiaoma-core/agents/xiaoma-master.md +0 -108
- package/xiaoma-core/agents/xiaoma-orchestrator.md +0 -145
- package/xiaoma-core/checklists/architect-checklist.md +0 -440
- package/xiaoma-core/checklists/change-checklist.md +0 -184
- package/xiaoma-core/checklists/dev-completion-checklist.md +0 -324
- package/xiaoma-core/checklists/pm-checklist.md +0 -372
- package/xiaoma-core/checklists/po-master-checklist.md +0 -434
- package/xiaoma-core/checklists/po-story-validation-checklist.md +0 -219
- package/xiaoma-core/checklists/qa-approval-checklist.md +0 -393
- package/xiaoma-core/checklists/story-dod-checklist.md +0 -96
- package/xiaoma-core/checklists/story-draft-checklist.md +0 -155
- package/xiaoma-core/core-config.yaml +0 -23
- package/xiaoma-core/data/bmad-kb.md +0 -809
- package/xiaoma-core/data/brainstorming-techniques.md +0 -38
- package/xiaoma-core/data/elicitation-methods.md +0 -156
- package/xiaoma-core/data/technical-preferences.md +0 -5
- package/xiaoma-core/data/test-levels-framework.md +0 -148
- package/xiaoma-core/data/test-priorities-matrix.md +0 -174
- package/xiaoma-core/scripts/build-validation/pre-dev-validation.sh +0 -71
- package/xiaoma-core/scripts/build-validation/progressive-validation.sh +0 -88
- package/xiaoma-core/scripts/build-validation/quick-check.sh +0 -69
- package/xiaoma-core/tasks/advanced-elicitation.md +0 -119
- package/xiaoma-core/tasks/analyze-existing-database.md +0 -155
- package/xiaoma-core/tasks/apply-qa-fixes.md +0 -150
- package/xiaoma-core/tasks/automated-story-cycle.md +0 -370
- package/xiaoma-core/tasks/batch-story-generation.md +0 -354
- package/xiaoma-core/tasks/brownfield-create-epic.md +0 -162
- package/xiaoma-core/tasks/brownfield-create-story.md +0 -149
- package/xiaoma-core/tasks/correct-course.md +0 -72
- package/xiaoma-core/tasks/create-brownfield-story.md +0 -314
- package/xiaoma-core/tasks/create-database-design.md +0 -161
- package/xiaoma-core/tasks/create-deep-research-prompt.md +0 -280
- package/xiaoma-core/tasks/create-enhanced-story-with-database.md +0 -250
- package/xiaoma-core/tasks/create-incremental-architecture.md +0 -525
- package/xiaoma-core/tasks/create-next-story.md +0 -114
- package/xiaoma-core/tasks/create-prd-from-rag.md +0 -435
- package/xiaoma-core/tasks/create-story-with-rag.md +0 -559
- package/xiaoma-core/tasks/develop-story-with-rag.md +0 -536
- package/xiaoma-core/tasks/document-project.md +0 -345
- package/xiaoma-core/tasks/facilitate-brainstorming-session.md +0 -138
- package/xiaoma-core/tasks/generate-ai-frontend-prompt.md +0 -53
- package/xiaoma-core/tasks/generate-database-ddl.md +0 -240
- package/xiaoma-core/tasks/generate-database-entities.md +0 -501
- package/xiaoma-core/tasks/generate-rag-questions.md +0 -312
- package/xiaoma-core/tasks/index-docs.md +0 -175
- package/xiaoma-core/tasks/kb-mode-interaction.md +0 -77
- package/xiaoma-core/tasks/nfr-assess.md +0 -345
- package/xiaoma-core/tasks/project-integration-testing.md +0 -477
- package/xiaoma-core/tasks/qa-gate.md +0 -163
- package/xiaoma-core/tasks/requirement-analysis-with-rag.md +0 -1318
- package/xiaoma-core/tasks/requirements-coverage-audit.md +0 -198
- package/xiaoma-core/tasks/review-story.md +0 -316
- package/xiaoma-core/tasks/risk-profile.md +0 -355
- package/xiaoma-core/tasks/serial-development-orchestration.md +0 -426
- package/xiaoma-core/tasks/shard-doc.md +0 -187
- package/xiaoma-core/tasks/test-design.md +0 -176
- package/xiaoma-core/tasks/trace-requirements.md +0 -266
- package/xiaoma-core/tasks/validate-next-story.md +0 -136
- package/xiaoma-core/templates/api-design-tmpl.yaml +0 -704
- package/xiaoma-core/templates/architecture-tmpl.yaml +0 -650
- package/xiaoma-core/templates/brainstorming-output-tmpl.yaml +0 -156
- package/xiaoma-core/templates/brownfield-architecture-tmpl.yaml +0 -476
- package/xiaoma-core/templates/brownfield-prd-tmpl.yaml +0 -280
- package/xiaoma-core/templates/competitor-analysis-tmpl.yaml +0 -336
- package/xiaoma-core/templates/database-design-tmpl.yaml +0 -266
- package/xiaoma-core/templates/enhanced-story-with-database-tmpl.yaml +0 -428
- package/xiaoma-core/templates/front-end-architecture-tmpl.yaml +0 -272
- package/xiaoma-core/templates/front-end-spec-tmpl.yaml +0 -354
- package/xiaoma-core/templates/fullstack-architecture-tmpl.yaml +0 -925
- package/xiaoma-core/templates/global-qa-monitoring-tmpl.yaml +0 -443
- package/xiaoma-core/templates/incremental-architecture-tmpl.yaml +0 -601
- package/xiaoma-core/templates/market-research-tmpl.yaml +0 -252
- package/xiaoma-core/templates/maven-lombok-template.xml +0 -111
- package/xiaoma-core/templates/prd-from-rag-tmpl.yaml +0 -410
- package/xiaoma-core/templates/prd-tmpl.yaml +0 -202
- package/xiaoma-core/templates/project-brief-tmpl.yaml +0 -221
- package/xiaoma-core/templates/qa-gate-tmpl.yaml +0 -102
- package/xiaoma-core/templates/rag-knowledge-tmpl.yaml +0 -569
- package/xiaoma-core/templates/rag-questions-tmpl.yaml +0 -949
- package/xiaoma-core/templates/requirements-coverage-audit.yaml +0 -330
- package/xiaoma-core/templates/start-enhanced-workflow.yaml +0 -347
- package/xiaoma-core/templates/story-tmpl.yaml +0 -137
- package/xiaoma-core/templates/story-with-rag-tmpl.yaml +0 -360
- package/xiaoma-core/workflows/automated-requirements-analysis.yaml +0 -2149
- package/xiaoma-core/workflows/automated-requirements-development.yaml +0 -739
- package/xiaoma-core/workflows/automated-story-development.yaml +0 -1264
- package/xiaoma-core/workflows/brownfield-fullstack.yaml +0 -298
- package/xiaoma-core/workflows/brownfield-service.yaml +0 -188
- package/xiaoma-core/workflows/brownfield-ui.yaml +0 -198
- package/xiaoma-core/workflows/enhanced-fullstack-with-database.yaml +0 -427
- package/xiaoma-core/workflows/enhanced-fullstack-with-qa-loop.yaml +0 -766
- package/xiaoma-core/workflows/full-requirement-automation.yaml +0 -1305
- package/xiaoma-core/workflows/greenfield-fullstack.yaml +0 -241
- package/xiaoma-core/workflows/greenfield-service.yaml +0 -207
- package/xiaoma-core/workflows/greenfield-ui.yaml +0 -236
|
@@ -0,0 +1,732 @@
|
|
|
1
|
+
# Selective and Targeted Test Execution
|
|
2
|
+
|
|
3
|
+
## Principle
|
|
4
|
+
|
|
5
|
+
Run only the tests you need, when you need them. Use tags/grep to slice suites by risk priority (not directory structure), filter by spec patterns or git diff to focus on impacted areas, and combine priority metadata (P0-P3) with change detection to optimize pre-commit vs. CI execution. Document the selection strategy clearly so teams understand when full regression is mandatory.
|
|
6
|
+
|
|
7
|
+
## Rationale
|
|
8
|
+
|
|
9
|
+
Running the entire test suite on every commit wastes time and resources. Smart test selection provides fast feedback (smoke tests in minutes, full regression in hours) while maintaining confidence. The "32+ ways of selective testing" philosophy balances speed with coverage: quick loops for developers, comprehensive validation before deployment. Poorly documented selection leads to confusion about when tests run and why.
|
|
10
|
+
|
|
11
|
+
## Pattern Examples
|
|
12
|
+
|
|
13
|
+
### Example 1: Tag-Based Execution with Priority Levels
|
|
14
|
+
|
|
15
|
+
**Context**: Organize tests by risk priority and execution stage using grep/tag patterns.
|
|
16
|
+
|
|
17
|
+
**Implementation**:
|
|
18
|
+
|
|
19
|
+
```typescript
|
|
20
|
+
// tests/e2e/checkout.spec.ts
|
|
21
|
+
import { test, expect } from '@playwright/test';
|
|
22
|
+
|
|
23
|
+
/**
|
|
24
|
+
* Tag-based test organization
|
|
25
|
+
* - @smoke: Critical path tests (run on every commit, < 5 min)
|
|
26
|
+
* - @regression: Full test suite (run pre-merge, < 30 min)
|
|
27
|
+
* - @p0: Critical business functions (payment, auth, data integrity)
|
|
28
|
+
* - @p1: Core features (primary user journeys)
|
|
29
|
+
* - @p2: Secondary features (supporting functionality)
|
|
30
|
+
* - @p3: Nice-to-have (cosmetic, non-critical)
|
|
31
|
+
*/
|
|
32
|
+
|
|
33
|
+
test.describe('Checkout Flow', () => {
|
|
34
|
+
// P0 + Smoke: Must run on every commit
|
|
35
|
+
test('@smoke @p0 should complete purchase with valid payment', async ({ page }) => {
|
|
36
|
+
await page.goto('/checkout');
|
|
37
|
+
await page.getByTestId('card-number').fill('4242424242424242');
|
|
38
|
+
await page.getByTestId('submit-payment').click();
|
|
39
|
+
|
|
40
|
+
await expect(page.getByTestId('order-confirmation')).toBeVisible();
|
|
41
|
+
});
|
|
42
|
+
|
|
43
|
+
// P0 but not smoke: Run pre-merge
|
|
44
|
+
test('@regression @p0 should handle payment decline gracefully', async ({ page }) => {
|
|
45
|
+
await page.goto('/checkout');
|
|
46
|
+
await page.getByTestId('card-number').fill('4000000000000002'); // Decline card
|
|
47
|
+
await page.getByTestId('submit-payment').click();
|
|
48
|
+
|
|
49
|
+
await expect(page.getByTestId('payment-error')).toBeVisible();
|
|
50
|
+
await expect(page.getByTestId('payment-error')).toContainText('declined');
|
|
51
|
+
});
|
|
52
|
+
|
|
53
|
+
// P1 + Smoke: Important but not critical
|
|
54
|
+
test('@smoke @p1 should apply discount code', async ({ page }) => {
|
|
55
|
+
await page.goto('/checkout');
|
|
56
|
+
await page.getByTestId('promo-code').fill('SAVE10');
|
|
57
|
+
await page.getByTestId('apply-promo').click();
|
|
58
|
+
|
|
59
|
+
await expect(page.getByTestId('discount-applied')).toBeVisible();
|
|
60
|
+
});
|
|
61
|
+
|
|
62
|
+
// P2: Run in full regression only
|
|
63
|
+
test('@regression @p2 should remember saved payment methods', async ({ page }) => {
|
|
64
|
+
await page.goto('/checkout');
|
|
65
|
+
await expect(page.getByTestId('saved-cards')).toBeVisible();
|
|
66
|
+
});
|
|
67
|
+
|
|
68
|
+
// P3: Low priority, run nightly or weekly
|
|
69
|
+
test('@nightly @p3 should display checkout page analytics', async ({ page }) => {
|
|
70
|
+
await page.goto('/checkout');
|
|
71
|
+
const analyticsEvents = await page.evaluate(() => (window as any).__ANALYTICS__);
|
|
72
|
+
expect(analyticsEvents).toBeDefined();
|
|
73
|
+
});
|
|
74
|
+
});
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
**package.json scripts**:
|
|
78
|
+
|
|
79
|
+
```json
|
|
80
|
+
{
|
|
81
|
+
"scripts": {
|
|
82
|
+
"test": "playwright test",
|
|
83
|
+
"test:smoke": "playwright test --grep '@smoke'",
|
|
84
|
+
"test:p0": "playwright test --grep '@p0'",
|
|
85
|
+
"test:p0-p1": "playwright test --grep '@p0|@p1'",
|
|
86
|
+
"test:regression": "playwright test --grep '@regression'",
|
|
87
|
+
"test:nightly": "playwright test --grep '@nightly'",
|
|
88
|
+
"test:not-slow": "playwright test --grep-invert '@slow'",
|
|
89
|
+
"test:critical-smoke": "playwright test --grep '@smoke.*@p0'"
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
**Cypress equivalent**:
|
|
95
|
+
|
|
96
|
+
```javascript
|
|
97
|
+
// cypress/e2e/checkout.cy.ts
|
|
98
|
+
describe('Checkout Flow', { tags: ['@checkout'] }, () => {
|
|
99
|
+
it('should complete purchase', { tags: ['@smoke', '@p0'] }, () => {
|
|
100
|
+
cy.visit('/checkout');
|
|
101
|
+
cy.get('[data-cy="card-number"]').type('4242424242424242');
|
|
102
|
+
cy.get('[data-cy="submit-payment"]').click();
|
|
103
|
+
cy.get('[data-cy="order-confirmation"]').should('be.visible');
|
|
104
|
+
});
|
|
105
|
+
|
|
106
|
+
it('should handle decline', { tags: ['@regression', '@p0'] }, () => {
|
|
107
|
+
cy.visit('/checkout');
|
|
108
|
+
cy.get('[data-cy="card-number"]').type('4000000000000002');
|
|
109
|
+
cy.get('[data-cy="submit-payment"]').click();
|
|
110
|
+
cy.get('[data-cy="payment-error"]').should('be.visible');
|
|
111
|
+
});
|
|
112
|
+
});
|
|
113
|
+
|
|
114
|
+
// cypress.config.ts
|
|
115
|
+
export default defineConfig({
|
|
116
|
+
e2e: {
|
|
117
|
+
env: {
|
|
118
|
+
grepTags: process.env.GREP_TAGS || '',
|
|
119
|
+
grepFilterSpecs: true,
|
|
120
|
+
},
|
|
121
|
+
setupNodeEvents(on, config) {
|
|
122
|
+
require('@cypress/grep/src/plugin')(config);
|
|
123
|
+
return config;
|
|
124
|
+
},
|
|
125
|
+
},
|
|
126
|
+
});
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
**Usage**:
|
|
130
|
+
|
|
131
|
+
```bash
|
|
132
|
+
# Playwright
|
|
133
|
+
npm run test:smoke # Run all @smoke tests
|
|
134
|
+
npm run test:p0 # Run all P0 tests
|
|
135
|
+
npm run test -- --grep "@smoke.*@p0" # Run tests with BOTH tags
|
|
136
|
+
|
|
137
|
+
# Cypress (with @cypress/grep plugin)
|
|
138
|
+
npx cypress run --env grepTags="@smoke"
|
|
139
|
+
npx cypress run --env grepTags="@p0+@smoke" # AND logic
|
|
140
|
+
npx cypress run --env grepTags="@p0 @p1" # OR logic
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
**Key Points**:
|
|
144
|
+
|
|
145
|
+
- **Multiple tags per test**: Combine priority (@p0) with stage (@smoke)
|
|
146
|
+
- **AND/OR logic**: Grep supports complex filtering
|
|
147
|
+
- **Clear naming**: Tags document test importance
|
|
148
|
+
- **Fast feedback**: @smoke runs < 5 min, full suite < 30 min
|
|
149
|
+
- **CI integration**: Different jobs run different tag combinations
|
|
150
|
+
|
|
151
|
+
---
|
|
152
|
+
|
|
153
|
+
### Example 2: Spec Filter Pattern (File-Based Selection)
|
|
154
|
+
|
|
155
|
+
**Context**: Run tests by file path pattern or directory for targeted execution.
|
|
156
|
+
|
|
157
|
+
**Implementation**:
|
|
158
|
+
|
|
159
|
+
```bash
|
|
160
|
+
#!/bin/bash
|
|
161
|
+
# scripts/selective-spec-runner.sh
|
|
162
|
+
# Run tests based on spec file patterns
|
|
163
|
+
|
|
164
|
+
set -e
|
|
165
|
+
|
|
166
|
+
PATTERN=${1:-"**/*.spec.ts"}
|
|
167
|
+
TEST_ENV=${TEST_ENV:-local}
|
|
168
|
+
|
|
169
|
+
echo "🎯 Selective Spec Runner"
|
|
170
|
+
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
|
171
|
+
echo "Pattern: $PATTERN"
|
|
172
|
+
echo "Environment: $TEST_ENV"
|
|
173
|
+
echo ""
|
|
174
|
+
|
|
175
|
+
# Pattern examples and their use cases
|
|
176
|
+
case "$PATTERN" in
|
|
177
|
+
"**/checkout*")
|
|
178
|
+
echo "📦 Running checkout-related tests"
|
|
179
|
+
npx playwright test --grep-files="**/checkout*"
|
|
180
|
+
;;
|
|
181
|
+
"**/auth*"|"**/login*"|"**/signup*")
|
|
182
|
+
echo "🔐 Running authentication tests"
|
|
183
|
+
npx playwright test --grep-files="**/auth*|**/login*|**/signup*"
|
|
184
|
+
;;
|
|
185
|
+
"tests/e2e/**")
|
|
186
|
+
echo "🌐 Running all E2E tests"
|
|
187
|
+
npx playwright test tests/e2e/
|
|
188
|
+
;;
|
|
189
|
+
"tests/integration/**")
|
|
190
|
+
echo "🔌 Running all integration tests"
|
|
191
|
+
npx playwright test tests/integration/
|
|
192
|
+
;;
|
|
193
|
+
"tests/component/**")
|
|
194
|
+
echo "🧩 Running all component tests"
|
|
195
|
+
npx playwright test tests/component/
|
|
196
|
+
;;
|
|
197
|
+
*)
|
|
198
|
+
echo "🔍 Running tests matching pattern: $PATTERN"
|
|
199
|
+
npx playwright test "$PATTERN"
|
|
200
|
+
;;
|
|
201
|
+
esac
|
|
202
|
+
```
|
|
203
|
+
|
|
204
|
+
**Playwright config for file filtering**:
|
|
205
|
+
|
|
206
|
+
```typescript
|
|
207
|
+
// playwright.config.ts
|
|
208
|
+
import { defineConfig, devices } from '@playwright/test';
|
|
209
|
+
|
|
210
|
+
export default defineConfig({
|
|
211
|
+
// ... other config
|
|
212
|
+
|
|
213
|
+
// Project-based organization
|
|
214
|
+
projects: [
|
|
215
|
+
{
|
|
216
|
+
name: 'smoke',
|
|
217
|
+
testMatch: /.*smoke.*\.spec\.ts/,
|
|
218
|
+
retries: 0,
|
|
219
|
+
},
|
|
220
|
+
{
|
|
221
|
+
name: 'e2e',
|
|
222
|
+
testMatch: /tests\/e2e\/.*\.spec\.ts/,
|
|
223
|
+
retries: 2,
|
|
224
|
+
},
|
|
225
|
+
{
|
|
226
|
+
name: 'integration',
|
|
227
|
+
testMatch: /tests\/integration\/.*\.spec\.ts/,
|
|
228
|
+
retries: 1,
|
|
229
|
+
},
|
|
230
|
+
{
|
|
231
|
+
name: 'component',
|
|
232
|
+
testMatch: /tests\/component\/.*\.spec\.ts/,
|
|
233
|
+
use: { ...devices['Desktop Chrome'] },
|
|
234
|
+
},
|
|
235
|
+
],
|
|
236
|
+
});
|
|
237
|
+
```
|
|
238
|
+
|
|
239
|
+
**Advanced pattern matching**:
|
|
240
|
+
|
|
241
|
+
```typescript
|
|
242
|
+
// scripts/run-by-component.ts
|
|
243
|
+
/**
|
|
244
|
+
* Run tests related to specific component(s)
|
|
245
|
+
* Usage: npm run test:component UserProfile,Settings
|
|
246
|
+
*/
|
|
247
|
+
|
|
248
|
+
import { execSync } from 'child_process';
|
|
249
|
+
|
|
250
|
+
const components = process.argv[2]?.split(',') || [];
|
|
251
|
+
|
|
252
|
+
if (components.length === 0) {
|
|
253
|
+
console.error('❌ No components specified');
|
|
254
|
+
console.log('Usage: npm run test:component UserProfile,Settings');
|
|
255
|
+
process.exit(1);
|
|
256
|
+
}
|
|
257
|
+
|
|
258
|
+
// Convert component names to glob patterns
|
|
259
|
+
const patterns = components.map((comp) => `**/*${comp}*.spec.ts`).join(' ');
|
|
260
|
+
|
|
261
|
+
console.log(`🧩 Running tests for components: ${components.join(', ')}`);
|
|
262
|
+
console.log(`Patterns: ${patterns}`);
|
|
263
|
+
|
|
264
|
+
try {
|
|
265
|
+
execSync(`npx playwright test ${patterns}`, {
|
|
266
|
+
stdio: 'inherit',
|
|
267
|
+
env: { ...process.env, CI: 'false' },
|
|
268
|
+
});
|
|
269
|
+
} catch (error) {
|
|
270
|
+
process.exit(1);
|
|
271
|
+
}
|
|
272
|
+
```
|
|
273
|
+
|
|
274
|
+
**package.json scripts**:
|
|
275
|
+
|
|
276
|
+
```json
|
|
277
|
+
{
|
|
278
|
+
"scripts": {
|
|
279
|
+
"test:checkout": "playwright test **/checkout*.spec.ts",
|
|
280
|
+
"test:auth": "playwright test **/auth*.spec.ts **/login*.spec.ts",
|
|
281
|
+
"test:e2e": "playwright test tests/e2e/",
|
|
282
|
+
"test:integration": "playwright test tests/integration/",
|
|
283
|
+
"test:component": "ts-node scripts/run-by-component.ts",
|
|
284
|
+
"test:project": "playwright test --project",
|
|
285
|
+
"test:smoke-project": "playwright test --project smoke"
|
|
286
|
+
}
|
|
287
|
+
}
|
|
288
|
+
```
|
|
289
|
+
|
|
290
|
+
**Key Points**:
|
|
291
|
+
|
|
292
|
+
- **Glob patterns**: Wildcards match file paths flexibly
|
|
293
|
+
- **Project isolation**: Separate projects have different configs
|
|
294
|
+
- **Component targeting**: Run tests for specific features
|
|
295
|
+
- **Directory-based**: Organize tests by type (e2e, integration, component)
|
|
296
|
+
- **CI optimization**: Run subsets in parallel CI jobs
|
|
297
|
+
|
|
298
|
+
---
|
|
299
|
+
|
|
300
|
+
### Example 3: Diff-Based Test Selection (Changed Files Only)
|
|
301
|
+
|
|
302
|
+
**Context**: Run only tests affected by code changes for maximum speed.
|
|
303
|
+
|
|
304
|
+
**Implementation**:
|
|
305
|
+
|
|
306
|
+
```bash
|
|
307
|
+
#!/bin/bash
|
|
308
|
+
# scripts/test-changed-files.sh
|
|
309
|
+
# Intelligent test selection based on git diff
|
|
310
|
+
|
|
311
|
+
set -e
|
|
312
|
+
|
|
313
|
+
BASE_BRANCH=${BASE_BRANCH:-main}
|
|
314
|
+
TEST_ENV=${TEST_ENV:-local}
|
|
315
|
+
|
|
316
|
+
echo "🔍 Changed File Test Selector"
|
|
317
|
+
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
|
318
|
+
echo "Base branch: $BASE_BRANCH"
|
|
319
|
+
echo "Environment: $TEST_ENV"
|
|
320
|
+
echo ""
|
|
321
|
+
|
|
322
|
+
# Get changed files
|
|
323
|
+
CHANGED_FILES=$(git diff --name-only $BASE_BRANCH...HEAD)
|
|
324
|
+
|
|
325
|
+
if [ -z "$CHANGED_FILES" ]; then
|
|
326
|
+
echo "✅ No files changed. Skipping tests."
|
|
327
|
+
exit 0
|
|
328
|
+
fi
|
|
329
|
+
|
|
330
|
+
echo "Changed files:"
|
|
331
|
+
echo "$CHANGED_FILES" | sed 's/^/ - /'
|
|
332
|
+
echo ""
|
|
333
|
+
|
|
334
|
+
# Arrays to collect test specs
|
|
335
|
+
DIRECT_TEST_FILES=()
|
|
336
|
+
RELATED_TEST_FILES=()
|
|
337
|
+
RUN_ALL_TESTS=false
|
|
338
|
+
|
|
339
|
+
# Process each changed file
|
|
340
|
+
while IFS= read -r file; do
|
|
341
|
+
case "$file" in
|
|
342
|
+
# Changed test files: run them directly
|
|
343
|
+
*.spec.ts|*.spec.js|*.test.ts|*.test.js|*.cy.ts|*.cy.js)
|
|
344
|
+
DIRECT_TEST_FILES+=("$file")
|
|
345
|
+
;;
|
|
346
|
+
|
|
347
|
+
# Critical config changes: run ALL tests
|
|
348
|
+
package.json|package-lock.json|playwright.config.ts|cypress.config.ts|tsconfig.json|.github/workflows/*)
|
|
349
|
+
echo "⚠️ Critical file changed: $file"
|
|
350
|
+
RUN_ALL_TESTS=true
|
|
351
|
+
break
|
|
352
|
+
;;
|
|
353
|
+
|
|
354
|
+
# Component changes: find related tests
|
|
355
|
+
src/components/*.tsx|src/components/*.jsx)
|
|
356
|
+
COMPONENT_NAME=$(basename "$file" | sed 's/\.[^.]*$//')
|
|
357
|
+
echo "🧩 Component changed: $COMPONENT_NAME"
|
|
358
|
+
|
|
359
|
+
# Find tests matching component name
|
|
360
|
+
FOUND_TESTS=$(find tests -name "*${COMPONENT_NAME}*.spec.ts" -o -name "*${COMPONENT_NAME}*.cy.ts" 2>/dev/null || true)
|
|
361
|
+
if [ -n "$FOUND_TESTS" ]; then
|
|
362
|
+
while IFS= read -r test_file; do
|
|
363
|
+
RELATED_TEST_FILES+=("$test_file")
|
|
364
|
+
done <<< "$FOUND_TESTS"
|
|
365
|
+
fi
|
|
366
|
+
;;
|
|
367
|
+
|
|
368
|
+
# Utility/lib changes: run integration + unit tests
|
|
369
|
+
src/utils/*|src/lib/*|src/helpers/*)
|
|
370
|
+
echo "⚙️ Utility file changed: $file"
|
|
371
|
+
RELATED_TEST_FILES+=($(find tests/unit tests/integration -name "*.spec.ts" 2>/dev/null || true))
|
|
372
|
+
;;
|
|
373
|
+
|
|
374
|
+
# API changes: run integration + e2e tests
|
|
375
|
+
src/api/*|src/services/*|src/controllers/*)
|
|
376
|
+
echo "🔌 API file changed: $file"
|
|
377
|
+
RELATED_TEST_FILES+=($(find tests/integration tests/e2e -name "*.spec.ts" 2>/dev/null || true))
|
|
378
|
+
;;
|
|
379
|
+
|
|
380
|
+
# Type changes: run all TypeScript tests
|
|
381
|
+
*.d.ts|src/types/*)
|
|
382
|
+
echo "📝 Type definition changed: $file"
|
|
383
|
+
RUN_ALL_TESTS=true
|
|
384
|
+
break
|
|
385
|
+
;;
|
|
386
|
+
|
|
387
|
+
# Documentation only: skip tests
|
|
388
|
+
*.md|docs/*|README*)
|
|
389
|
+
echo "📄 Documentation changed: $file (no tests needed)"
|
|
390
|
+
;;
|
|
391
|
+
|
|
392
|
+
*)
|
|
393
|
+
echo "❓ Unclassified change: $file (running smoke tests)"
|
|
394
|
+
RELATED_TEST_FILES+=($(find tests -name "*smoke*.spec.ts" 2>/dev/null || true))
|
|
395
|
+
;;
|
|
396
|
+
esac
|
|
397
|
+
done <<< "$CHANGED_FILES"
|
|
398
|
+
|
|
399
|
+
# Execute tests based on analysis
|
|
400
|
+
if [ "$RUN_ALL_TESTS" = true ]; then
|
|
401
|
+
echo ""
|
|
402
|
+
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
|
403
|
+
echo "🚨 Running FULL test suite (critical changes detected)"
|
|
404
|
+
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
|
405
|
+
npm run test
|
|
406
|
+
exit $?
|
|
407
|
+
fi
|
|
408
|
+
|
|
409
|
+
# Combine and deduplicate test files
|
|
410
|
+
ALL_TEST_FILES=(${DIRECT_TEST_FILES[@]} ${RELATED_TEST_FILES[@]})
|
|
411
|
+
UNIQUE_TEST_FILES=($(echo "${ALL_TEST_FILES[@]}" | tr ' ' '\n' | sort -u))
|
|
412
|
+
|
|
413
|
+
if [ ${#UNIQUE_TEST_FILES[@]} -eq 0 ]; then
|
|
414
|
+
echo ""
|
|
415
|
+
echo "✅ No tests found for changed files. Running smoke tests."
|
|
416
|
+
npm run test:smoke
|
|
417
|
+
exit $?
|
|
418
|
+
fi
|
|
419
|
+
|
|
420
|
+
echo ""
|
|
421
|
+
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
|
422
|
+
echo "🎯 Running ${#UNIQUE_TEST_FILES[@]} test file(s)"
|
|
423
|
+
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
|
|
424
|
+
|
|
425
|
+
for test_file in "${UNIQUE_TEST_FILES[@]}"; do
|
|
426
|
+
echo " - $test_file"
|
|
427
|
+
done
|
|
428
|
+
|
|
429
|
+
echo ""
|
|
430
|
+
npm run test -- "${UNIQUE_TEST_FILES[@]}"
|
|
431
|
+
```
|
|
432
|
+
|
|
433
|
+
**GitHub Actions integration**:
|
|
434
|
+
|
|
435
|
+
```yaml
|
|
436
|
+
# .github/workflows/test-changed.yml
|
|
437
|
+
name: Test Changed Files
|
|
438
|
+
on:
|
|
439
|
+
pull_request:
|
|
440
|
+
types: [opened, synchronize, reopened]
|
|
441
|
+
|
|
442
|
+
jobs:
|
|
443
|
+
detect-and-test:
|
|
444
|
+
runs-on: ubuntu-latest
|
|
445
|
+
steps:
|
|
446
|
+
- uses: actions/checkout@v4
|
|
447
|
+
with:
|
|
448
|
+
fetch-depth: 0 # Full history for accurate diff
|
|
449
|
+
|
|
450
|
+
- name: Get changed files
|
|
451
|
+
id: changed-files
|
|
452
|
+
uses: tj-actions/changed-files@v40
|
|
453
|
+
with:
|
|
454
|
+
files: |
|
|
455
|
+
src/**
|
|
456
|
+
tests/**
|
|
457
|
+
*.config.ts
|
|
458
|
+
files_ignore: |
|
|
459
|
+
**/*.md
|
|
460
|
+
docs/**
|
|
461
|
+
|
|
462
|
+
- name: Run tests for changed files
|
|
463
|
+
if: steps.changed-files.outputs.any_changed == 'true'
|
|
464
|
+
run: |
|
|
465
|
+
echo "Changed files: ${{ steps.changed-files.outputs.all_changed_files }}"
|
|
466
|
+
bash scripts/test-changed-files.sh
|
|
467
|
+
env:
|
|
468
|
+
BASE_BRANCH: ${{ github.base_ref }}
|
|
469
|
+
TEST_ENV: staging
|
|
470
|
+
```
|
|
471
|
+
|
|
472
|
+
**Key Points**:
|
|
473
|
+
|
|
474
|
+
- **Intelligent mapping**: Code changes → related tests
|
|
475
|
+
- **Critical file detection**: Config changes = full suite
|
|
476
|
+
- **Component mapping**: UI changes → component + E2E tests
|
|
477
|
+
- **Fast feedback**: Run only what's needed (< 2 min typical)
|
|
478
|
+
- **Safety net**: Unrecognized changes run smoke tests
|
|
479
|
+
|
|
480
|
+
---
|
|
481
|
+
|
|
482
|
+
### Example 4: Promotion Rules (Pre-Commit → CI → Staging → Production)
|
|
483
|
+
|
|
484
|
+
**Context**: Progressive test execution strategy across deployment stages.
|
|
485
|
+
|
|
486
|
+
**Implementation**:
|
|
487
|
+
|
|
488
|
+
```typescript
|
|
489
|
+
// scripts/test-promotion-strategy.ts
|
|
490
|
+
/**
|
|
491
|
+
* Test Promotion Strategy
|
|
492
|
+
* Defines which tests run at each stage of the development lifecycle
|
|
493
|
+
*/
|
|
494
|
+
|
|
495
|
+
export type TestStage = 'pre-commit' | 'ci-pr' | 'ci-merge' | 'staging' | 'production';
|
|
496
|
+
|
|
497
|
+
export type TestPromotion = {
|
|
498
|
+
stage: TestStage;
|
|
499
|
+
description: string;
|
|
500
|
+
testCommand: string;
|
|
501
|
+
timebudget: string; // minutes
|
|
502
|
+
required: boolean;
|
|
503
|
+
failureAction: 'block' | 'warn' | 'alert';
|
|
504
|
+
};
|
|
505
|
+
|
|
506
|
+
export const TEST_PROMOTION_RULES: Record<TestStage, TestPromotion> = {
|
|
507
|
+
'pre-commit': {
|
|
508
|
+
stage: 'pre-commit',
|
|
509
|
+
description: 'Local developer checks before git commit',
|
|
510
|
+
testCommand: 'npm run test:smoke',
|
|
511
|
+
timebudget: '2',
|
|
512
|
+
required: true,
|
|
513
|
+
failureAction: 'block',
|
|
514
|
+
},
|
|
515
|
+
'ci-pr': {
|
|
516
|
+
stage: 'ci-pr',
|
|
517
|
+
description: 'CI checks on pull request creation/update',
|
|
518
|
+
testCommand: 'npm run test:changed && npm run test:p0-p1',
|
|
519
|
+
timebudget: '10',
|
|
520
|
+
required: true,
|
|
521
|
+
failureAction: 'block',
|
|
522
|
+
},
|
|
523
|
+
'ci-merge': {
|
|
524
|
+
stage: 'ci-merge',
|
|
525
|
+
description: 'Full regression before merge to main',
|
|
526
|
+
testCommand: 'npm run test:regression',
|
|
527
|
+
timebudget: '30',
|
|
528
|
+
required: true,
|
|
529
|
+
failureAction: 'block',
|
|
530
|
+
},
|
|
531
|
+
staging: {
|
|
532
|
+
stage: 'staging',
|
|
533
|
+
description: 'Post-deployment validation in staging environment',
|
|
534
|
+
testCommand: 'npm run test:e2e -- --grep "@smoke"',
|
|
535
|
+
timebudget: '15',
|
|
536
|
+
required: true,
|
|
537
|
+
failureAction: 'block',
|
|
538
|
+
},
|
|
539
|
+
production: {
|
|
540
|
+
stage: 'production',
|
|
541
|
+
description: 'Production smoke tests post-deployment',
|
|
542
|
+
testCommand: 'npm run test:e2e:prod -- --grep "@smoke.*@p0"',
|
|
543
|
+
timebudget: '5',
|
|
544
|
+
required: false,
|
|
545
|
+
failureAction: 'alert',
|
|
546
|
+
},
|
|
547
|
+
};
|
|
548
|
+
|
|
549
|
+
/**
|
|
550
|
+
* Get tests to run for a specific stage
|
|
551
|
+
*/
|
|
552
|
+
export function getTestsForStage(stage: TestStage): TestPromotion {
|
|
553
|
+
return TEST_PROMOTION_RULES[stage];
|
|
554
|
+
}
|
|
555
|
+
|
|
556
|
+
/**
|
|
557
|
+
* Validate if tests can be promoted to next stage
|
|
558
|
+
*/
|
|
559
|
+
export function canPromote(currentStage: TestStage, testsPassed: boolean): boolean {
|
|
560
|
+
const promotion = TEST_PROMOTION_RULES[currentStage];
|
|
561
|
+
|
|
562
|
+
if (!promotion.required) {
|
|
563
|
+
return true; // Non-required tests don't block promotion
|
|
564
|
+
}
|
|
565
|
+
|
|
566
|
+
return testsPassed;
|
|
567
|
+
}
|
|
568
|
+
```
|
|
569
|
+
|
|
570
|
+
**Husky pre-commit hook**:
|
|
571
|
+
|
|
572
|
+
```bash
|
|
573
|
+
#!/bin/bash
|
|
574
|
+
# .husky/pre-commit
|
|
575
|
+
# Run smoke tests before allowing commit
|
|
576
|
+
|
|
577
|
+
echo "🔍 Running pre-commit tests..."
|
|
578
|
+
|
|
579
|
+
npm run test:smoke
|
|
580
|
+
|
|
581
|
+
if [ $? -ne 0 ]; then
|
|
582
|
+
echo ""
|
|
583
|
+
echo "❌ Pre-commit tests failed!"
|
|
584
|
+
echo "Please fix failures before committing."
|
|
585
|
+
echo ""
|
|
586
|
+
echo "To skip (NOT recommended): git commit --no-verify"
|
|
587
|
+
exit 1
|
|
588
|
+
fi
|
|
589
|
+
|
|
590
|
+
echo "✅ Pre-commit tests passed"
|
|
591
|
+
```
|
|
592
|
+
|
|
593
|
+
**GitHub Actions workflow**:
|
|
594
|
+
|
|
595
|
+
```yaml
|
|
596
|
+
# .github/workflows/test-promotion.yml
|
|
597
|
+
name: Test Promotion Strategy
|
|
598
|
+
on:
|
|
599
|
+
pull_request:
|
|
600
|
+
push:
|
|
601
|
+
branches: [main]
|
|
602
|
+
workflow_dispatch:
|
|
603
|
+
|
|
604
|
+
jobs:
|
|
605
|
+
# Stage 1: PR tests (changed + P0-P1)
|
|
606
|
+
pr-tests:
|
|
607
|
+
if: github.event_name == 'pull_request'
|
|
608
|
+
runs-on: ubuntu-latest
|
|
609
|
+
timeout-minutes: 10
|
|
610
|
+
steps:
|
|
611
|
+
- uses: actions/checkout@v4
|
|
612
|
+
- name: Run PR-level tests
|
|
613
|
+
run: |
|
|
614
|
+
npm run test:changed
|
|
615
|
+
npm run test:p0-p1
|
|
616
|
+
|
|
617
|
+
# Stage 2: Full regression (pre-merge)
|
|
618
|
+
regression-tests:
|
|
619
|
+
if: github.event_name == 'push' && github.ref == 'refs/heads/main'
|
|
620
|
+
runs-on: ubuntu-latest
|
|
621
|
+
timeout-minutes: 30
|
|
622
|
+
steps:
|
|
623
|
+
- uses: actions/checkout@v4
|
|
624
|
+
- name: Run full regression
|
|
625
|
+
run: npm run test:regression
|
|
626
|
+
|
|
627
|
+
# Stage 3: Staging validation (post-deploy)
|
|
628
|
+
staging-smoke:
|
|
629
|
+
if: github.event_name == 'workflow_dispatch'
|
|
630
|
+
runs-on: ubuntu-latest
|
|
631
|
+
timeout-minutes: 15
|
|
632
|
+
steps:
|
|
633
|
+
- uses: actions/checkout@v4
|
|
634
|
+
- name: Run staging smoke tests
|
|
635
|
+
run: npm run test:e2e -- --grep "@smoke"
|
|
636
|
+
env:
|
|
637
|
+
TEST_ENV: staging
|
|
638
|
+
|
|
639
|
+
# Stage 4: Production smoke (post-deploy, non-blocking)
|
|
640
|
+
production-smoke:
|
|
641
|
+
if: github.event_name == 'workflow_dispatch'
|
|
642
|
+
runs-on: ubuntu-latest
|
|
643
|
+
timeout-minutes: 5
|
|
644
|
+
continue-on-error: true # Don't fail deployment if smoke tests fail
|
|
645
|
+
steps:
|
|
646
|
+
- uses: actions/checkout@v4
|
|
647
|
+
- name: Run production smoke tests
|
|
648
|
+
run: npm run test:e2e:prod -- --grep "@smoke.*@p0"
|
|
649
|
+
env:
|
|
650
|
+
TEST_ENV: production
|
|
651
|
+
|
|
652
|
+
- name: Alert on failure
|
|
653
|
+
if: failure()
|
|
654
|
+
uses: 8398a7/action-slack@v3
|
|
655
|
+
with:
|
|
656
|
+
status: ${{ job.status }}
|
|
657
|
+
text: '🚨 Production smoke tests failed!'
|
|
658
|
+
webhook_url: ${{ secrets.SLACK_WEBHOOK }}
|
|
659
|
+
```
|
|
660
|
+
|
|
661
|
+
**Selection strategy documentation**:
|
|
662
|
+
|
|
663
|
+
````markdown
|
|
664
|
+
# Test Selection Strategy
|
|
665
|
+
|
|
666
|
+
## Test Promotion Stages
|
|
667
|
+
|
|
668
|
+
| Stage | Tests Run | Time Budget | Blocks Deploy | Failure Action |
|
|
669
|
+
| ---------- | ------------------- | ----------- | ------------- | -------------- |
|
|
670
|
+
| Pre-Commit | Smoke (@smoke) | 2 min | ✅ Yes | Block commit |
|
|
671
|
+
| CI PR | Changed + P0-P1 | 10 min | ✅ Yes | Block merge |
|
|
672
|
+
| CI Merge | Full regression | 30 min | ✅ Yes | Block deploy |
|
|
673
|
+
| Staging | E2E smoke | 15 min | ✅ Yes | Rollback |
|
|
674
|
+
| Production | Critical smoke only | 5 min | ❌ No | Alert team |
|
|
675
|
+
|
|
676
|
+
## When Full Regression Runs
|
|
677
|
+
|
|
678
|
+
Full regression suite (`npm run test:regression`) runs in these scenarios:
|
|
679
|
+
|
|
680
|
+
- ✅ Before merging to `main` (CI Merge stage)
|
|
681
|
+
- ✅ Nightly builds (scheduled workflow)
|
|
682
|
+
- ✅ Manual trigger (workflow_dispatch)
|
|
683
|
+
- ✅ Release candidate testing
|
|
684
|
+
|
|
685
|
+
Full regression does NOT run on:
|
|
686
|
+
|
|
687
|
+
- ❌ Every PR commit (too slow)
|
|
688
|
+
- ❌ Pre-commit hooks (too slow)
|
|
689
|
+
- ❌ Production deployments (deploy-blocking)
|
|
690
|
+
|
|
691
|
+
## Override Scenarios
|
|
692
|
+
|
|
693
|
+
Skip tests (emergency only):
|
|
694
|
+
|
|
695
|
+
```bash
|
|
696
|
+
git commit --no-verify # Skip pre-commit hook
|
|
697
|
+
gh pr merge --admin # Force merge (requires admin)
|
|
698
|
+
```
|
|
699
|
+
````
|
|
700
|
+
|
|
701
|
+
```
|
|
702
|
+
|
|
703
|
+
**Key Points**:
|
|
704
|
+
- **Progressive validation**: More tests at each stage
|
|
705
|
+
- **Time budgets**: Clear expectations per stage
|
|
706
|
+
- **Blocking vs. alerting**: Production tests don't block deploy
|
|
707
|
+
- **Documentation**: Team knows when full regression runs
|
|
708
|
+
- **Emergency overrides**: Documented but discouraged
|
|
709
|
+
|
|
710
|
+
---
|
|
711
|
+
|
|
712
|
+
## Test Selection Strategy Checklist
|
|
713
|
+
|
|
714
|
+
Before implementing selective testing, verify:
|
|
715
|
+
|
|
716
|
+
- [ ] **Tag strategy defined**: @smoke, @p0-p3, @regression documented
|
|
717
|
+
- [ ] **Time budgets set**: Each stage has clear timeout (smoke < 5 min, full < 30 min)
|
|
718
|
+
- [ ] **Changed file mapping**: Code changes → test selection logic implemented
|
|
719
|
+
- [ ] **Promotion rules documented**: README explains when full regression runs
|
|
720
|
+
- [ ] **CI integration**: GitHub Actions uses selective strategy
|
|
721
|
+
- [ ] **Local parity**: Developers can run same selections locally
|
|
722
|
+
- [ ] **Emergency overrides**: Skip mechanisms documented (--no-verify, admin merge)
|
|
723
|
+
- [ ] **Metrics tracked**: Monitor test execution time and selection accuracy
|
|
724
|
+
|
|
725
|
+
## Integration Points
|
|
726
|
+
|
|
727
|
+
- Used in workflows: `*ci` (CI/CD setup), `*automate` (test generation with tags)
|
|
728
|
+
- Related fragments: `ci-burn-in.md`, `test-priorities-matrix.md`, `test-quality.md`
|
|
729
|
+
- Selection tools: Playwright --grep, Cypress @cypress/grep, git diff
|
|
730
|
+
|
|
731
|
+
_Source: 32+ selective testing strategies blog, Murat testing philosophy, SEON CI optimization_
|
|
732
|
+
```
|