@teevee98/synapse-hub 0.0.0-stage → 3.8.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (369) hide show
  1. package/.agents/agents/api-engineer.md +67 -0
  2. package/.agents/agents/failure-analyst.md +75 -0
  3. package/.agents/agents/live-explorer.md +70 -0
  4. package/.agents/agents/orchestrator.md +104 -0
  5. package/.agents/agents/perf-engineer.md +74 -0
  6. package/.agents/agents/pom-crafter.md +112 -0
  7. package/.agents/agents/quality-gatekeeper.md +87 -0
  8. package/.agents/agents/test-designer.md +73 -0
  9. package/.agents/agents/test-runner.md +67 -0
  10. package/.agents/rules/author-integrity-guard.md +33 -0
  11. package/.agents/rules/communication-style.md +18 -0
  12. package/.agents/rules/context-engineering.md +37 -0
  13. package/.agents/rules/git-push-protocol.md +33 -0
  14. package/.agents/rules/graphify.md +14 -0
  15. package/.agents/rules/lessons-learned.md +25 -0
  16. package/.agents/rules/mandatory-playwright-live.md +25 -0
  17. package/.agents/rules/mobile_appium_rules.md +43 -0
  18. package/.agents/rules/performance_testing_rules.md +35 -0
  19. package/.agents/rules/skill-precedence.md +29 -0
  20. package/.agents/rules/systematic-debugging.md +36 -0
  21. package/.agents/skills/actor-qa-swarm/SKILL.md +77 -0
  22. package/.agents/skills/actor-qa-swarm/examples/broker_sharding_sample.json +12 -0
  23. package/.agents/skills/agent-orchestration-multi-agent-optimize/SKILL.md +88 -0
  24. package/.agents/skills/agent-orchestration-multi-agent-optimize/examples/swarm_workload_config.json +15 -0
  25. package/.agents/skills/agentless-qa-repair/SKILL.md +69 -0
  26. package/.agents/skills/agentless-qa-repair/examples/healing_report_sample.json +17 -0
  27. package/.agents/skills/agentless-qa-repair/examples/three_phase_repair_workflow.md +40 -0
  28. package/.agents/skills/antigravity-test-sentinel/SKILL.md +63 -0
  29. package/.agents/skills/antigravity-test-sentinel/examples/dod_gate_policy.json +11 -0
  30. package/.agents/skills/antigravity-test-sentinel/examples/sprint_dod_enforcement.md +47 -0
  31. package/.agents/skills/api-network-mocking-interception/SKILL.md +142 -0
  32. package/.agents/skills/api-network-mocking-interception/examples/network_route_stub.json +9 -0
  33. package/.agents/skills/api-spec-to-e2e-matrix/SKILL.md +80 -0
  34. package/.agents/skills/api-spec-to-e2e-matrix/examples/sample_openapi.json +19 -0
  35. package/.agents/skills/architecture-decision-records/SKILL.md +64 -0
  36. package/.agents/skills/architecture-decision-records/examples/0001-record-architecture-decisions.md +12 -0
  37. package/.agents/skills/auth-session-and-cookie-manager/SKILL.md +75 -0
  38. package/.agents/skills/auth-session-and-cookie-manager/examples/multi_role_auth_matrix.md +70 -0
  39. package/.agents/skills/auth-session-and-cookie-manager/examples/storage_state_sample.json +11 -0
  40. package/.agents/skills/backend-load-and-stress-patterns/SKILL.md +85 -0
  41. package/.agents/skills/backend-load-and-stress-patterns/examples/k6_load_test_sample.js +13 -0
  42. package/.agents/skills/backend-load-and-stress-patterns/references/k6_load_template.js +82 -0
  43. package/.agents/skills/bats-testing-patterns/SKILL.md +100 -0
  44. package/.agents/skills/bats-testing-patterns/examples/cli_runner_test.bats +6 -0
  45. package/.agents/skills/bats-testing-patterns/resources/implementation-playbook.md +614 -0
  46. package/.agents/skills/clean-pom-crafter/SKILL.md +110 -0
  47. package/.agents/skills/clean-pom-crafter/examples/standard_test_case.groovy +28 -0
  48. package/.agents/skills/clean-pom-crafter/references/pom_patterns.groovy +138 -0
  49. package/.agents/skills/code-refactoring-refactor-clean/SKILL.md +64 -0
  50. package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_page_sample.groovy +9 -0
  51. package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_playwright_pom.ts +52 -0
  52. package/.agents/skills/code-refactoring-refactor-clean/resources/implementation-playbook.md +881 -0
  53. package/.agents/skills/consumer-driven-contract-testing/SKILL.md +147 -0
  54. package/.agents/skills/consumer-driven-contract-testing/examples/order_service_pact.json +45 -0
  55. package/.agents/skills/db-state-verifier-and-seeder/SKILL.md +123 -0
  56. package/.agents/skills/db-state-verifier-and-seeder/examples/db_fixture_seed.json +12 -0
  57. package/.agents/skills/e2e-testing-patterns/SKILL.md +103 -0
  58. package/.agents/skills/e2e-testing-patterns/examples/playwright_sharded_config.ts +12 -0
  59. package/.agents/skills/e2e-testing-patterns/resources/implementation-playbook.md +522 -0
  60. package/.agents/skills/event-stream-qa-orchestrator/SKILL.md +79 -0
  61. package/.agents/skills/event-stream-qa-orchestrator/examples/timeline_sample.jsonl +2 -0
  62. package/.agents/skills/failure-autopsy-and-healing/SKILL.md +66 -0
  63. package/.agents/skills/failure-autopsy-and-healing/examples/closed_loop_healing_walkthrough.md +48 -0
  64. package/.agents/skills/failure-autopsy-and-healing/examples/sample_junit_failure.xml +8 -0
  65. package/.agents/skills/failure-autopsy-and-healing/references/healing_matrix.md +64 -0
  66. package/.agents/skills/failure-autopsy-and-healing/references/qa_investigation_protocol.md +56 -0
  67. package/.agents/skills/failure-autopsy-and-healing/scripts/triage_failures.sh +83 -0
  68. package/.agents/skills/file-and-report-validator/SKILL.md +90 -0
  69. package/.agents/skills/file-and-report-validator/examples/sample_export_schema.json +14 -0
  70. package/.agents/skills/flaky-test-sentinel-and-quarantine/SKILL.md +114 -0
  71. package/.agents/skills/flaky-test-sentinel-and-quarantine/examples/quarantine_registry.json +11 -0
  72. package/.agents/skills/gherkin-to-suite/SKILL.md +103 -0
  73. package/.agents/skills/gherkin-to-suite/examples/checkout.feature +39 -0
  74. package/.agents/skills/gherkin-to-suite/examples/suite_report_sample.json +334 -0
  75. package/.agents/skills/github-actions-templates/SKILL.md +77 -0
  76. package/.agents/skills/github-actions-templates/examples/matrix_test_pipeline.yml +8 -0
  77. package/.agents/skills/graphify-impact-analyzer/SKILL.md +76 -0
  78. package/.agents/skills/graphify-impact-analyzer/examples/dependency_blast_radius.json +8 -0
  79. package/.agents/skills/katalon-cli-runner/SKILL.md +76 -0
  80. package/.agents/skills/katalon-cli-runner/examples/headless_kre_exec.sh +3 -0
  81. package/.agents/skills/katalon-cli-runner/references/groovy-patterns.md +209 -0
  82. package/.agents/skills/katalon-cli-runner/references/katalon-api.md +155 -0
  83. package/.agents/skills/katalon-cli-runner/references/runner_commands.md +67 -0
  84. package/.agents/skills/lam-script-generator/SKILL.md +123 -0
  85. package/.agents/skills/lam-script-generator/examples/user_story_sample.md +8 -0
  86. package/.agents/skills/lean-code-ladder/SKILL.md +94 -0
  87. package/.agents/skills/lean-code-ladder/examples/ladder_walkthrough.md +37 -0
  88. package/.agents/skills/lean-impact-scoreboard/SKILL.md +48 -0
  89. package/.agents/skills/lean-impact-scoreboard/examples/sample_benchmark_gain.md +20 -0
  90. package/.agents/skills/lean-impact-scoreboard/examples/sample_scoreboard.md +15 -0
  91. package/.agents/skills/meta-prompt-crafter/SKILL.md +107 -0
  92. package/.agents/skills/meta-prompt-crafter/examples/qa_prompt_template.md +35 -0
  93. package/.agents/skills/mipro-prompt-compiler/SKILL.md +59 -0
  94. package/.agents/skills/mipro-prompt-compiler/examples/compiled_module_sample.json +22 -0
  95. package/.agents/skills/mipro-prompt-compiler/examples/dspy_assertion_optimizer_case.md +46 -0
  96. package/.agents/skills/mobile-appium-som/SKILL.md +88 -0
  97. package/.agents/skills/mobile-appium-som/examples/BaseScreen.java +88 -0
  98. package/.agents/skills/mobile-appium-som/examples/LoginScreen.java +46 -0
  99. package/.agents/skills/mobile-appium-som/examples/TC_MobileLogin.java +43 -0
  100. package/.agents/skills/persistent-planning-files/SKILL.md +108 -0
  101. package/.agents/skills/persistent-planning-files/examples/task_plan_example.md +56 -0
  102. package/.agents/skills/playwright-live-interaction/SKILL.md +131 -0
  103. package/.agents/skills/playwright-live-interaction/examples/live_probe_script.js +5 -0
  104. package/.agents/skills/playwright-live-interaction/references/advanced_superpowers.md +160 -0
  105. package/.agents/skills/playwright-live-interaction/references/compact_accessibility_snapshots.md +75 -0
  106. package/.agents/skills/playwright-live-interaction/references/recipes.md +388 -0
  107. package/.agents/skills/playwright-live-interaction/references/swarm_orchestration.md +134 -0
  108. package/.agents/skills/playwright-webapp-testing/SKILL.md +93 -0
  109. package/.agents/skills/playwright-webapp-testing/examples/server_lifecycle_playwright.py +63 -0
  110. package/.agents/skills/qa-aci-interface/SKILL.md +67 -0
  111. package/.agents/skills/qa-aci-interface/examples/surgical_code_window_walkthrough.md +40 -0
  112. package/.agents/skills/qa-aci-interface/examples/surgical_edit_sample.json +12 -0
  113. package/.agents/skills/qa-memory-os/SKILL.md +80 -0
  114. package/.agents/skills/qa-memory-os/examples/archival_memory_sample.json +21 -0
  115. package/.agents/skills/rbt-manual-testing/SKILL.md +137 -0
  116. package/.agents/skills/rbt-manual-testing/examples/checkout_rbt_manual_suite.md +25 -0
  117. package/.agents/skills/rbt-manual-testing/references/field_validation_checklist.md +29 -0
  118. package/.agents/skills/repo-quality-audit/SKILL.md +68 -0
  119. package/.agents/skills/repo-quality-audit/examples/sample_audit_walkthrough.md +15 -0
  120. package/.agents/skills/repo-quality-audit/examples/sample_repo_audit.md +33 -0
  121. package/.agents/skills/review-spec/SKILL.md +60 -0
  122. package/.agents/skills/review-spec/examples/pocock_grilling_decision_rubric.md +40 -0
  123. package/.agents/skills/review-spec/examples/sample_spec_review.md +33 -0
  124. package/.agents/skills/security-dast-sentinel/SKILL.md +119 -0
  125. package/.agents/skills/security-dast-sentinel/examples/dast_scan_config.json +10 -0
  126. package/.agents/skills/security-dast-sentinel/references/AI-AND-LLM.md +113 -0
  127. package/.agents/skills/security-dast-sentinel/references/ATTACK-CLASSES.md +89 -0
  128. package/.agents/skills/security-dast-sentinel/references/dast_recipes.ts +33 -0
  129. package/.agents/skills/self-healing-locator/SKILL.md +86 -0
  130. package/.agents/skills/self-healing-locator/examples/aom_diff_sample.json +16 -0
  131. package/.agents/skills/senior-code-review/SKILL.md +108 -0
  132. package/.agents/skills/senior-code-review/examples/sample_review_walkthrough.md +29 -0
  133. package/.agents/skills/skillspector-security-guard/SKILL.md +57 -0
  134. package/.agents/skills/skillspector-security-guard/examples/audit_threat_vectors_report.json +35 -0
  135. package/.agents/skills/skillspector-security-guard/examples/safe_mcp_config.json +12 -0
  136. package/.agents/skills/surgical-coding-principles/SKILL.md +89 -0
  137. package/.agents/skills/surgical-coding-principles/examples/surgical_vs_scope_creep.md +46 -0
  138. package/.agents/skills/synthetic-test-data-generator/SKILL.md +135 -0
  139. package/.agents/skills/synthetic-test-data-generator/examples/idempotent_data_recipe.json +9 -0
  140. package/.agents/skills/systematic-debugging/SKILL.md +100 -0
  141. package/.agents/skills/systematic-debugging/examples/four_phase_case.md +44 -0
  142. package/.agents/skills/technical-debt-harvester/SKILL.md +70 -0
  143. package/.agents/skills/technical-debt-harvester/examples/sample_debt_ledger.md +25 -0
  144. package/.agents/skills/technical-debt-harvester/examples/sample_ledger_output.md +20 -0
  145. package/.agents/skills/test-driven-development/SKILL.md +114 -0
  146. package/.agents/skills/test-driven-development/examples/red_green_refactor_qa.md +78 -0
  147. package/.agents/skills/token-and-context-optimizer/SKILL.md +70 -0
  148. package/.agents/skills/token-and-context-optimizer/examples/distilled_log_sample.txt +3 -0
  149. package/.agents/skills/token-and-context-optimizer/references/context_engineering_guide.md +49 -0
  150. package/.agents/skills/tot-exploratory-testing/SKILL.md +59 -0
  151. package/.agents/skills/tot-exploratory-testing/examples/payment_gateway_tot_tree.json +62 -0
  152. package/.agents/skills/tot-exploratory-testing/examples/tot_graph_sample.json +35 -0
  153. package/.agents/skills/verification-before-completion/SKILL.md +100 -0
  154. package/.agents/skills/verification-before-completion/examples/evidence_log_example.md +46 -0
  155. package/.agents/skills/visual-regression-sentinel/SKILL.md +82 -0
  156. package/.agents/skills/visual-regression-sentinel/examples/visual_mask_rules.json +9 -0
  157. package/.agents/skills/wcag-audit-patterns/SKILL.md +77 -0
  158. package/.agents/skills/wcag-audit-patterns/examples/wcag_compliance_checklist.json +10 -0
  159. package/.agents/skills/wcag-audit-patterns/resources/implementation-playbook.md +541 -0
  160. package/.agents/skills/web-agent-gym-benchmarking/SKILL.md +62 -0
  161. package/.agents/skills/web-agent-gym-benchmarking/examples/benchmark_report_sample.json +22 -0
  162. package/.agents/skills/web-agent-gym-benchmarking/examples/enterprise_tasks_suite.json +38 -0
  163. package/.agents/skills/web-vitals-and-performance-profiler/SKILL.md +65 -0
  164. package/.agents/skills/web-vitals-and-performance-profiler/examples/cwv_budget_policy.json +6 -0
  165. package/.agents/skills/web-vitals-and-performance-profiler/examples/playwright_cwv_profiler_fixture.ts +118 -0
  166. package/.agents/templates/completion_report.md +57 -0
  167. package/.agents/workflows/analyze_requirement_document.md +18 -0
  168. package/.agents/workflows/export_testcases_excel.md +32 -0
  169. package/.agents/workflows/generate_combinatorial_test_data.md +28 -0
  170. package/.agents/workflows/generate_cross_module_test_plan.md +37 -0
  171. package/.agents/workflows/generate_manual_testcases_rbt.md +56 -0
  172. package/.agents/workflows/generate_requirements_from_website.md +25 -0
  173. package/.agents/workflows/generate_testcases_from_requirements.md +21 -0
  174. package/.agents/workflows/graphify.md +10 -0
  175. package/.agents/workflows/test-impact.md +15 -0
  176. package/.agents/workflows/verify.md +34 -0
  177. package/.cursor/rules/agents.mdc +16 -0
  178. package/.cursor/rules/language.mdc +7 -0
  179. package/.cursor/rules/synapse-qa.mdc +24 -0
  180. package/.cursorrules +27 -0
  181. package/.dockerignore +53 -0
  182. package/.pre-commit-hooks.yaml +14 -0
  183. package/.windsurfrules +26 -0
  184. package/AGENTS.md +86 -0
  185. package/CLAUDE.md +54 -0
  186. package/Dockerfile +81 -0
  187. package/LICENSE +52 -0
  188. package/NOTICE +264 -0
  189. package/README.en.md +172 -0
  190. package/README.md +171 -2
  191. package/action.yml +51 -0
  192. package/agentskills.json +16 -0
  193. package/bin/agent-qa.js +138 -0
  194. package/docker-compose.yml +74 -0
  195. package/docs/ARCHITECTURE.en.md +197 -0
  196. package/docs/ARCHITECTURE.md +198 -0
  197. package/docs/CI_CD_INTEGRATION.en.md +170 -0
  198. package/docs/CI_CD_INTEGRATION.md +170 -0
  199. package/docs/CLI_REFERENCE.en.md +175 -0
  200. package/docs/CLI_REFERENCE.md +177 -0
  201. package/docs/CONTRIBUTING.en.md +49 -0
  202. package/docs/CONTRIBUTING.md +49 -0
  203. package/docs/PERFORMANCE_AUDIT_REPORT.md +784 -0
  204. package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +127 -0
  205. package/docs/QUALITY_GATES.en.md +121 -0
  206. package/docs/QUALITY_GATES.md +121 -0
  207. package/docs/TOKEN_QUOTA_PLAYBOOK.md +41 -0
  208. package/docs/TOOL_CATALOG.md +129 -0
  209. package/docs/adopted-ecosystem-tools.md +96 -0
  210. package/docs/research/EXTERNAL_AGENT_SKILLS_SURVEY.md +1062 -0
  211. package/docs/research/agent_skill_training_analysis.md +1359 -0
  212. package/docs/schemas/synapse.config.schema.json +87 -0
  213. package/package.json +94 -4
  214. package/plugin.json +31 -0
  215. package/scripts/generate_skill_examples.py +244 -0
  216. package/scripts/install.ps1 +112 -0
  217. package/scripts/install_global_plugin.ps1 +94 -0
  218. package/scripts/install_global_plugin.sh +49 -0
  219. package/scripts/lint_skills.ps1 +57 -0
  220. package/scripts/package_dist.py +337 -0
  221. package/scripts/setup.sh +59 -0
  222. package/scripts/update_hub.ps1 +19 -0
  223. package/scripts/update_hub.sh +15 -0
  224. package/skills_manifest.json +854 -0
  225. package/synapse.config.json +32 -0
  226. package/templates/PROJECT_AI_GUIDE_TEMPLATE.md +111 -0
  227. package/templates/PROJECT_STATE_TEMPLATE.md +20 -0
  228. package/templates/ai_bridges/CLAUDE.md +54 -0
  229. package/templates/ai_bridges/copilot-instructions.md +20 -0
  230. package/templates/ai_bridges/cursor_synapse_qa.mdc +24 -0
  231. package/templates/ai_bridges/windsurfrules +26 -0
  232. package/templates/ci/github-actions-synapse.yml +95 -0
  233. package/templates/ci/gitlab-ci-synapse.yml +16 -0
  234. package/templates/ui/index.html +1069 -0
  235. package/templates/welcome.html.tmpl +2079 -0
  236. package/tools/.infer_baseline.json +30 -0
  237. package/tools/TOOLS_RUNBOOK.md +1553 -0
  238. package/tools/TOOL_CATALOG.json +1769 -0
  239. package/tools/__init__.py +43 -0
  240. package/tools/_openapi_parser.py +158 -0
  241. package/tools/agent_canary.py +525 -0
  242. package/tools/agentless_patcher.py +417 -0
  243. package/tools/analyze_project.py +258 -0
  244. package/tools/api_drift_sentinel.py +208 -0
  245. package/tools/api_fuzzer.py +762 -0
  246. package/tools/author_integrity.py +184 -0
  247. package/tools/auto_heal.py +271 -0
  248. package/tools/auto_heal_reflexion.py +532 -0
  249. package/tools/autogen_qa_broker.py +844 -0
  250. package/tools/benchmark_swarm_context.py +394 -0
  251. package/tools/browser_helpers.js +746 -0
  252. package/tools/browsergym_eval.py +236 -0
  253. package/tools/bug_reporter.py +252 -0
  254. package/tools/bump_version.py +423 -0
  255. package/tools/cache_resolver.py +1214 -0
  256. package/tools/check_env.py +426 -0
  257. package/tools/check_version_sync.py +256 -0
  258. package/tools/ci_healing_hook.py +126 -0
  259. package/tools/cli.py +1598 -0
  260. package/tools/config_decoupler.py +253 -0
  261. package/tools/contract_validator.py +141 -0
  262. package/tools/core/__init__.py +70 -0
  263. package/tools/core/adapters.py +431 -0
  264. package/tools/core/circuit_breaker.py +263 -0
  265. package/tools/core/cli_runtime.py +66 -0
  266. package/tools/core/file_lock.py +159 -0
  267. package/tools/core/i18n.py +394 -0
  268. package/tools/core/memory_bus.py +905 -0
  269. package/tools/core/process_supervisor.py +332 -0
  270. package/tools/core/telemetry.py +329 -0
  271. package/tools/count_tokens.py +1267 -0
  272. package/tools/create_mock_docx.py +104 -0
  273. package/tools/dashboard_generator.py +2419 -0
  274. package/tools/db_sandbox.py +675 -0
  275. package/tools/debt_harvester.py +237 -0
  276. package/tools/distill_log.py +161 -0
  277. package/tools/dspy_qa_signatures.py +356 -0
  278. package/tools/e2e_flow_prober.py +132 -0
  279. package/tools/export_postman_collection.py +945 -0
  280. package/tools/flaky_detector.py +389 -0
  281. package/tools/fsm_enforcer.py +450 -0
  282. package/tools/fsm_middleware.py +401 -0
  283. package/tools/fuzz_payloads.py +197 -0
  284. package/tools/generate_allure_report.py +88 -0
  285. package/tools/generate_api_matrix.py +193 -0
  286. package/tools/generate_jmx_plan.py +1322 -0
  287. package/tools/generate_sbom.py +252 -0
  288. package/tools/generate_tc_from_story.py +203 -0
  289. package/tools/generate_test_reports.py +133 -0
  290. package/tools/generate_tool_catalog.py +482 -0
  291. package/tools/gherkin_suite.py +758 -0
  292. package/tools/git_pre_commit_guard.py +298 -0
  293. package/tools/goldfish_review.py +366 -0
  294. package/tools/heal/__init__.py +28 -0
  295. package/tools/heal_pr_automator.py +220 -0
  296. package/tools/heuristic_locator_matcher.py +351 -0
  297. package/tools/hub_publisher.py +623 -0
  298. package/tools/humanize_linter.py +438 -0
  299. package/tools/infer_linter.py +977 -0
  300. package/tools/init_config.py +307 -0
  301. package/tools/interview_story.py +116 -0
  302. package/tools/jira_sync.py +566 -0
  303. package/tools/jtl_analyzer.py +474 -0
  304. package/tools/lint/__init__.py +30 -0
  305. package/tools/lint_ai_docs.py +374 -0
  306. package/tools/lookup_tc.py +165 -0
  307. package/tools/lookup_xpath.py +167 -0
  308. package/tools/matrix_sharder.py +148 -0
  309. package/tools/mcp/__init__.py +18 -0
  310. package/tools/mcp_docx_server.ps1 +13 -0
  311. package/tools/mcp_docx_server.py +851 -0
  312. package/tools/mcp_excel_server.ps1 +13 -0
  313. package/tools/mcp_excel_server.py +441 -0
  314. package/tools/mcp_server.py +724 -0
  315. package/tools/md_to_xlsx.py +327 -0
  316. package/tools/micro_mutator.py +887 -0
  317. package/tools/mipro_assertion_tuner.py +210 -0
  318. package/tools/network_mock_shield.py +311 -0
  319. package/tools/newman_analyzer.py +384 -0
  320. package/tools/omni_emitter.py +579 -0
  321. package/tools/omni_parser.py +450 -0
  322. package/tools/omni_transpiler.py +168 -0
  323. package/tools/openxml_guard.py +438 -0
  324. package/tools/output_formatter.py +182 -0
  325. package/tools/package_release.py +325 -0
  326. package/tools/perf/__init__.py +24 -0
  327. package/tools/pinpoint_failure.py +190 -0
  328. package/tools/project_state.py +171 -0
  329. package/tools/qa_event_stream.py +358 -0
  330. package/tools/repo_map.py +346 -0
  331. package/tools/report/__init__.py +32 -0
  332. package/tools/reversible_sandbox.py +344 -0
  333. package/tools/safety_firewall.py +437 -0
  334. package/tools/security_coverage_ledger.py +538 -0
  335. package/tools/security_scanner.py +229 -0
  336. package/tools/senior_code_review.py +393 -0
  337. package/tools/setup_project.py +770 -0
  338. package/tools/skill_collision_guard.py +304 -0
  339. package/tools/skill_profiles.py +217 -0
  340. package/tools/skill_vault.py +481 -0
  341. package/tools/skillspector.py +1278 -0
  342. package/tools/smart_visual_masker.py +132 -0
  343. package/tools/spec_drift_sentinel.py +438 -0
  344. package/tools/swe_qa_aci.py +369 -0
  345. package/tools/synapse_observer.py +485 -0
  346. package/tools/synapse_qa_bench.py +190 -0
  347. package/tools/sync_agent_rules.py +274 -0
  348. package/tools/telemetry_correlator.py +397 -0
  349. package/tools/template_excel_exporter.py +514 -0
  350. package/tools/templates/jmeter-distributed/README.md +54 -0
  351. package/tools/templates/jmeter-distributed/docker-compose.yml +83 -0
  352. package/tools/test_impact.py +419 -0
  353. package/tools/test_memory_os.py +462 -0
  354. package/tools/textgrad_mutation_optimizer.py +237 -0
  355. package/tools/tms_sync_bridge.py +834 -0
  356. package/tools/tot_exploratory_tester.py +239 -0
  357. package/tools/trace_data_flow.py +240 -0
  358. package/tools/traffic_session_converter.py +256 -0
  359. package/tools/trend_analytics.py +314 -0
  360. package/tools/ui_server.py +401 -0
  361. package/tools/universal_ir.py +488 -0
  362. package/tools/update_sentinel.py +383 -0
  363. package/tools/validate_groovy_scripts.py +173 -0
  364. package/tools/verify_all.py +1259 -0
  365. package/tools/visual_diff_canvas.py +143 -0
  366. package/tools/visual_som_helper.py +550 -0
  367. package/tools/watch_mode.py +308 -0
  368. package/tools/wcag_audit.py +239 -0
  369. package/tools/welcome_page.py +290 -0
@@ -0,0 +1,522 @@
1
+ # E2E Testing Patterns Implementation Playbook
2
+
3
+ This file contains detailed patterns, checklists, and code samples referenced by the skill.
4
+
5
+ ## Core Concepts
6
+
7
+ ### 1. E2E Testing Fundamentals
8
+
9
+ **What to Test with E2E:**
10
+ - Critical user journeys (login, checkout, signup)
11
+ - Complex interactions (drag-and-drop, multi-step forms)
12
+ - Cross-browser compatibility
13
+ - Real API integration
14
+ - Authentication flows
15
+
16
+ **What NOT to Test with E2E:**
17
+ - Unit-level logic (use unit tests)
18
+ - API contracts (use integration tests)
19
+ - Edge cases (too slow)
20
+ - Internal implementation details
21
+
22
+ ### 2. Test Philosophy
23
+
24
+ **The Testing Pyramid:**
25
+ ```
26
+ /\
27
+ /E2E\ ← Few, focused on critical paths
28
+ /─────\
29
+ /Integr\ ← More, test component interactions
30
+ /────────\
31
+ /Unit Tests\ ← Many, fast, isolated
32
+ /────────────\
33
+ ```
34
+
35
+ **Best Practices:**
36
+ - Test user behavior, not implementation
37
+ - Keep tests independent
38
+ - Make tests deterministic
39
+ - Optimize for speed
40
+ - Use data-testid, not CSS selectors
41
+
42
+ ## Playwright Patterns
43
+
44
+ ### Setup and Configuration
45
+
46
+ ```typescript
47
+ // playwright.config.ts
48
+ import { defineConfig, devices } from '@playwright/test';
49
+
50
+ export default defineConfig({
51
+ testDir: './e2e',
52
+ timeout: 30000,
53
+ expect: {
54
+ timeout: 5000,
55
+ },
56
+ fullyParallel: true,
57
+ forbidOnly: !!process.env.CI,
58
+ retries: process.env.CI ? 2 : 0,
59
+ workers: process.env.CI ? 1 : undefined,
60
+ reporter: [
61
+ ['html'],
62
+ ['junit', { outputFile: 'results.xml' }],
63
+ ],
64
+ use: {
65
+ baseURL: 'http://localhost:3000',
66
+ trace: 'on-first-retry',
67
+ screenshot: 'only-on-failure',
68
+ video: 'retain-on-failure',
69
+ },
70
+ projects: [
71
+ { name: 'chromium', use: { ...devices['Desktop Chrome'] } },
72
+ { name: 'firefox', use: { ...devices['Desktop Firefox'] } },
73
+ { name: 'webkit', use: { ...devices['Desktop Safari'] } },
74
+ { name: 'mobile', use: { ...devices['iPhone 13'] } },
75
+ ],
76
+ });
77
+ ```
78
+
79
+ ### Pattern 1: Page Object Model
80
+
81
+ ```typescript
82
+ // pages/LoginPage.ts
83
+ import { Page, Locator } from '@playwright/test';
84
+
85
+ export class LoginPage {
86
+ readonly page: Page;
87
+ readonly emailInput: Locator;
88
+ readonly passwordInput: Locator;
89
+ readonly loginButton: Locator;
90
+ readonly errorMessage: Locator;
91
+
92
+ constructor(page: Page) {
93
+ this.page = page;
94
+ this.emailInput = page.getByLabel('Email');
95
+ this.passwordInput = page.getByLabel('Password');
96
+ this.loginButton = page.getByRole('button', { name: 'Login' });
97
+ this.errorMessage = page.getByRole('alert');
98
+ }
99
+
100
+ async goto() {
101
+ await this.page.goto('/login');
102
+ }
103
+
104
+ async login(email: string, password: string) {
105
+ await this.emailInput.fill(email);
106
+ await this.passwordInput.fill(password);
107
+ await this.loginButton.click();
108
+ }
109
+
110
+ async getErrorMessage(): Promise<string> {
111
+ return await this.errorMessage.textContent() ?? '';
112
+ }
113
+ }
114
+
115
+ // Test using Page Object
116
+ import { test, expect } from '@playwright/test';
117
+ import { LoginPage } from './pages/LoginPage';
118
+
119
+ test('successful login', async ({ page }) => {
120
+ const loginPage = new LoginPage(page);
121
+ await loginPage.goto();
122
+ await loginPage.login('user@example.com', process.env.TEST_PASSWORD || 'SecretAuth123!');
123
+
124
+ await expect(page).toHaveURL('/dashboard');
125
+ await expect(page.getByRole('heading', { name: 'Dashboard' }))
126
+ .toBeVisible();
127
+ });
128
+
129
+ test('failed login shows error', async ({ page }) => {
130
+ const loginPage = new LoginPage(page);
131
+ await loginPage.goto();
132
+ await loginPage.login('invalid@example.com', 'wrong');
133
+
134
+ const error = await loginPage.getErrorMessage();
135
+ expect(error).toContain('Invalid credentials');
136
+ });
137
+ ```
138
+
139
+ ### Pattern 2: Fixtures for Test Data
140
+
141
+ ```typescript
142
+ // fixtures/test-data.ts
143
+ import { test as base } from '@playwright/test';
144
+
145
+ type TestData = {
146
+ testUser: {
147
+ email: string;
148
+ password: string;
149
+ name: string;
150
+ };
151
+ adminUser: {
152
+ email: string;
153
+ password: string;
154
+ };
155
+ };
156
+
157
+ export const test = base.extend<TestData>({
158
+ testUser: async ({}, use) => {
159
+ const user = {
160
+ email: `test-${Date.now()}@example.com`,
161
+ password: process.env.TEST_USER_PASSWORD || 'DynamicTestPwd!123',
162
+ name: 'Test User',
163
+ };
164
+ // Setup: Create user in database
165
+ await createTestUser(user);
166
+ await use(user);
167
+ // Teardown: Clean up user
168
+ await deleteTestUser(user.email);
169
+ },
170
+
171
+ adminUser: async ({}, use) => {
172
+ await use({
173
+ email: 'admin@example.com',
174
+ password: process.env.ADMIN_PASSWORD!,
175
+ });
176
+ },
177
+ });
178
+
179
+ // Usage in tests
180
+ import { test } from './fixtures/test-data';
181
+
182
+ test('user can update profile', async ({ page, testUser }) => {
183
+ await page.goto('/login');
184
+ await page.getByLabel('Email').fill(testUser.email);
185
+ await page.getByLabel('Password').fill(testUser.password);
186
+ await page.getByRole('button', { name: 'Login' }).click();
187
+
188
+ await page.goto('/profile');
189
+ await page.getByLabel('Name').fill('Updated Name');
190
+ await page.getByRole('button', { name: 'Save' }).click();
191
+
192
+ await expect(page.getByText('Profile updated')).toBeVisible();
193
+ });
194
+ ```
195
+
196
+ ### Pattern 3: Waiting Strategies
197
+
198
+ ```typescript
199
+ // ❌ Bad: Fixed timeouts
200
+ await page.waitForTimeout(3000); // Flaky!
201
+
202
+ // ✅ Good: Wait for specific conditions
203
+ await page.waitForLoadState('networkidle');
204
+ await page.waitForURL('/dashboard');
205
+ await page.waitForSelector('[data-testid="user-profile"]');
206
+
207
+ // ✅ Better: Auto-waiting with assertions
208
+ await expect(page.getByText('Welcome')).toBeVisible();
209
+ await expect(page.getByRole('button', { name: 'Submit' }))
210
+ .toBeEnabled();
211
+
212
+ // Wait for API response
213
+ const responsePromise = page.waitForResponse(
214
+ response => response.url().includes('/api/users') && response.status() === 200
215
+ );
216
+ await page.getByRole('button', { name: 'Load Users' }).click();
217
+ const response = await responsePromise;
218
+ const data = await response.json();
219
+ expect(data.users).toHaveLength(10);
220
+
221
+ // Wait for multiple conditions
222
+ await Promise.all([
223
+ page.waitForURL('/success'),
224
+ page.waitForLoadState('networkidle'),
225
+ expect(page.getByText('Payment successful')).toBeVisible(),
226
+ ]);
227
+ ```
228
+
229
+ ### Pattern 4: Network Mocking and Interception
230
+
231
+ ```typescript
232
+ // Mock API responses
233
+ test('displays error when API fails', async ({ page }) => {
234
+ await page.route('**/api/users', route => {
235
+ route.fulfill({
236
+ status: 500,
237
+ contentType: 'application/json',
238
+ body: JSON.stringify({ error: 'Internal Server Error' }),
239
+ });
240
+ });
241
+
242
+ await page.goto('/users');
243
+ await expect(page.getByText('Failed to load users')).toBeVisible();
244
+ });
245
+
246
+ // Intercept and modify requests
247
+ test('can modify API request', async ({ page }) => {
248
+ await page.route('**/api/users', async route => {
249
+ const request = route.request();
250
+ const postData = JSON.parse(request.postData() || '{}');
251
+
252
+ // Modify request
253
+ postData.role = 'admin';
254
+
255
+ await route.continue({
256
+ postData: JSON.stringify(postData),
257
+ });
258
+ });
259
+
260
+ // Test continues...
261
+ });
262
+
263
+ // Mock third-party services
264
+ test('payment flow with mocked Stripe', async ({ page }) => {
265
+ await page.route('**/api/stripe/**', route => {
266
+ route.fulfill({
267
+ status: 200,
268
+ body: JSON.stringify({
269
+ id: 'mock_payment_id',
270
+ status: 'succeeded',
271
+ }),
272
+ });
273
+ });
274
+
275
+ // Test payment flow with mocked response
276
+ });
277
+ ```
278
+
279
+ ## Cypress Patterns
280
+
281
+ ### Setup and Configuration
282
+
283
+ ```typescript
284
+ // cypress.config.ts
285
+ import { defineConfig } from 'cypress';
286
+
287
+ export default defineConfig({
288
+ e2e: {
289
+ baseUrl: 'http://localhost:3000',
290
+ viewportWidth: 1280,
291
+ viewportHeight: 720,
292
+ video: false,
293
+ screenshotOnRunFailure: true,
294
+ defaultCommandTimeout: 10000,
295
+ requestTimeout: 10000,
296
+ setupNodeEvents(on, config) {
297
+ // Implement node event listeners
298
+ },
299
+ },
300
+ });
301
+ ```
302
+
303
+ ### Pattern 1: Custom Commands
304
+
305
+ ```typescript
306
+ // cypress/support/commands.ts
307
+ declare global {
308
+ namespace Cypress {
309
+ interface Chainable {
310
+ login(email: string, password: string): Chainable<void>;
311
+ createUser(userData: UserData): Chainable<User>;
312
+ dataCy(value: string): Chainable<JQuery<HTMLElement>>;
313
+ }
314
+ }
315
+ }
316
+
317
+ Cypress.Commands.add('login', (email: string, password: string) => {
318
+ cy.visit('/login');
319
+ cy.get('[data-testid="email"]').type(email);
320
+ cy.get('[data-testid="password"]').type(password);
321
+ cy.get('[data-testid="login-button"]').click();
322
+ cy.url().should('include', '/dashboard');
323
+ });
324
+
325
+ Cypress.Commands.add('createUser', (userData: UserData) => {
326
+ return cy.request('POST', '/api/users', userData)
327
+ .its('body');
328
+ });
329
+
330
+ Cypress.Commands.add('dataCy', (value: string) => {
331
+ return cy.get(`[data-cy="${value}"]`);
332
+ });
333
+
334
+ // Usage
335
+ cy.login('user@example.com', 'password');
336
+ cy.dataCy('submit-button').click();
337
+ ```
338
+
339
+ ### Pattern 2: Cypress Intercept
340
+
341
+ ```typescript
342
+ // Mock API calls
343
+ cy.intercept('GET', '/api/users', {
344
+ statusCode: 200,
345
+ body: [
346
+ { id: 1, name: 'John' },
347
+ { id: 2, name: 'Jane' },
348
+ ],
349
+ }).as('getUsers');
350
+
351
+ cy.visit('/users');
352
+ cy.wait('@getUsers');
353
+ cy.get('[data-testid="user-list"]').children().should('have.length', 2);
354
+
355
+ // Modify responses
356
+ cy.intercept('GET', '/api/users', (req) => {
357
+ req.reply((res) => {
358
+ // Modify response
359
+ res.body.users = res.body.users.slice(0, 5);
360
+ res.send();
361
+ });
362
+ });
363
+
364
+ // Simulate slow network
365
+ cy.intercept('GET', '/api/data', (req) => {
366
+ req.reply((res) => {
367
+ res.delay(3000); // 3 second delay
368
+ res.send();
369
+ });
370
+ });
371
+ ```
372
+
373
+ ## Advanced Patterns
374
+
375
+ ### Pattern 1: Visual Regression Testing
376
+
377
+ ```typescript
378
+ // With Playwright
379
+ import { test, expect } from '@playwright/test';
380
+
381
+ test('homepage looks correct', async ({ page }) => {
382
+ await page.goto('/');
383
+ await expect(page).toHaveScreenshot('homepage.png', {
384
+ fullPage: true,
385
+ maxDiffPixels: 100,
386
+ });
387
+ });
388
+
389
+ test('button in all states', async ({ page }) => {
390
+ await page.goto('/components');
391
+
392
+ const button = page.getByRole('button', { name: 'Submit' });
393
+
394
+ // Default state
395
+ await expect(button).toHaveScreenshot('button-default.png');
396
+
397
+ // Hover state
398
+ await button.hover();
399
+ await expect(button).toHaveScreenshot('button-hover.png');
400
+
401
+ // Disabled state
402
+ await button.evaluate(el => el.setAttribute('disabled', 'true'));
403
+ await expect(button).toHaveScreenshot('button-disabled.png');
404
+ });
405
+ ```
406
+
407
+ ### Pattern 2: Parallel Testing with Sharding
408
+
409
+ ```typescript
410
+ // playwright.config.ts
411
+ export default defineConfig({
412
+ projects: [
413
+ {
414
+ name: 'shard-1',
415
+ use: { ...devices['Desktop Chrome'] },
416
+ grepInvert: /@slow/,
417
+ shard: { current: 1, total: 4 },
418
+ },
419
+ {
420
+ name: 'shard-2',
421
+ use: { ...devices['Desktop Chrome'] },
422
+ shard: { current: 2, total: 4 },
423
+ },
424
+ // ... more shards
425
+ ],
426
+ });
427
+
428
+ // Run in CI
429
+ // npx playwright test --shard=1/4
430
+ // npx playwright test --shard=2/4
431
+ ```
432
+
433
+ ### Pattern 3: Accessibility Testing
434
+
435
+ ```typescript
436
+ // Install: npm install @axe-core/playwright
437
+ import { test, expect } from '@playwright/test';
438
+ import AxeBuilder from '@axe-core/playwright';
439
+
440
+ test('page should not have accessibility violations', async ({ page }) => {
441
+ await page.goto('/');
442
+
443
+ const accessibilityScanResults = await new AxeBuilder({ page })
444
+ .exclude('#third-party-widget')
445
+ .analyze();
446
+
447
+ expect(accessibilityScanResults.violations).toEqual([]);
448
+ });
449
+
450
+ test('form is accessible', async ({ page }) => {
451
+ await page.goto('/signup');
452
+
453
+ const results = await new AxeBuilder({ page })
454
+ .include('form')
455
+ .analyze();
456
+
457
+ expect(results.violations).toEqual([]);
458
+ });
459
+ ```
460
+
461
+ ## Best Practices
462
+
463
+ 1. **Use Data Attributes**: `data-testid` or `data-cy` for stable selectors
464
+ 2. **Avoid Brittle Selectors**: Don't rely on CSS classes or DOM structure
465
+ 3. **Test User Behavior**: Click, type, see - not implementation details
466
+ 4. **Keep Tests Independent**: Each test should run in isolation
467
+ 5. **Clean Up Test Data**: Create and destroy test data in each test
468
+ 6. **Use Page Objects**: Encapsulate page logic
469
+ 7. **Meaningful Assertions**: Check actual user-visible behavior
470
+ 8. **Optimize for Speed**: Mock when possible, parallel execution
471
+
472
+ ```typescript
473
+ // ❌ Bad selectors
474
+ cy.get('.btn.btn-primary.submit-button').click();
475
+ cy.get('div > form > div:nth-child(2) > input').type('text');
476
+
477
+ // ✅ Good selectors
478
+ cy.getByRole('button', { name: 'Submit' }).click();
479
+ cy.getByLabel('Email address').type('user@example.com');
480
+ cy.get('[data-testid="email-input"]').type('user@example.com');
481
+ ```
482
+
483
+ ## Common Pitfalls
484
+
485
+ - **Flaky Tests**: Use proper waits, not fixed timeouts
486
+ - **Slow Tests**: Mock external APIs, use parallel execution
487
+ - **Over-Testing**: Don't test every edge case with E2E
488
+ - **Coupled Tests**: Tests should not depend on each other
489
+ - **Poor Selectors**: Avoid CSS classes and nth-child
490
+ - **No Cleanup**: Clean up test data after each test
491
+ - **Testing Implementation**: Test user behavior, not internals
492
+
493
+ ## Debugging Failing Tests
494
+
495
+ ```typescript
496
+ // Playwright debugging
497
+ // 1. Run in headed mode
498
+ npx playwright test --headed
499
+
500
+ // 2. Run in debug mode
501
+ npx playwright test --debug
502
+
503
+ // 3. Use trace viewer
504
+ await page.screenshot({ path: 'screenshot.png' });
505
+ await page.video()?.saveAs('video.webm');
506
+
507
+ // 4. Add test.step for better reporting
508
+ test('checkout flow', async ({ page }) => {
509
+ await test.step('Add item to cart', async () => {
510
+ await page.goto('/products');
511
+ await page.getByRole('button', { name: 'Add to Cart' }).click();
512
+ });
513
+
514
+ await test.step('Proceed to checkout', async () => {
515
+ await page.goto('/cart');
516
+ await page.getByRole('button', { name: 'Checkout' }).click();
517
+ });
518
+ });
519
+
520
+ // 5. Inspect page state
521
+ await page.pause(); // Pauses execution, opens inspector
522
+ ```
@@ -0,0 +1,79 @@
1
+ ---
2
+ name: event-stream-qa-orchestrator
3
+ description: "Immutable EventStream orchestrator recording deterministic action/observation timelines with SHA-256 hash chains and reversible checkpoint rollbacks. Use when tracing test executions and managing replayable state."
4
+ ---
5
+
6
+ # QA Event Stream Orchestrator Skill — Immutable Audit & Replay Timeline
7
+
8
+ > **Paradigm Attribution:** Inspired by **All-Hands-AI OpenHands (EventStream & CodeAct Runtime)**.
9
+ > **Core Principle:** Treat automated testing sessions as an append-only, immutable stream of events. Prevent state corruption and lost context by chaining each event with cryptographic SHA-256 hashes and enabling deterministic check-pointed rollbacks.
10
+
11
+ ---
12
+
13
+ ## 1. The EventStream Pipeline
14
+
15
+ ```mermaid
16
+ flowchart LR
17
+ Init["init-stream<br/>Genesis Hash (000...0)"] --> Act["record-event<br/>ACTION_NAVIGATE / ACTION_CLICK"]
18
+ Act --> Obs["record-event<br/>OBSERVATION_DOM / ASSERTION"]
19
+ Obs --> Check["Checkpoint Anchor<br/>CHECKPOINT_PRE_SUBMIT"]
20
+ Check --> Verify["verify-stream<br/>Cryptographic Audit"]
21
+ Verify --> Rollback["rollback<br/>Rewind to Checkpoint"]
22
+ ```
23
+
24
+ 1. **Immutable Event Logging (`record-event`):**
25
+ - Each event records: `index`, `session_id`, `event_type`, `actor`, `payload`, `timestamp`, `prev_hash`, and `event_hash`.
26
+ - Continuous SHA-256 hash chaining prevents unobserved event injection or tampering.
27
+
28
+ 2. **Reversible Checkpointing (`rollback`):**
29
+ - In conjunction with GoEx LIFO undo stack (`tools/reversible_sandbox.py`), enables restoring the browser or data state when an unexpected crash occurs.
30
+ - Appends a `ROLLBACK_EXECUTED` event to the stream without destroying the audit trail.
31
+
32
+ 3. **Cryptographic Verification (`verify-stream`):**
33
+ - Verifies hash continuity from genesis to latest event.
34
+ - Ensures zero missing or out-of-order events before certifying run results.
35
+
36
+ ---
37
+
38
+ ## 2. CLI Tool Usage
39
+
40
+ Autonomous commands via `tools/qa_event_stream.py`:
41
+
42
+ ```bash
43
+ # 1. Initialize stream
44
+ python tools/qa_event_stream.py init-stream \
45
+ --session-id "CHECKOUT_E2E_001" \
46
+ --out-file .agent_memory/timeline.jsonl
47
+
48
+ # 2. Record an action event
49
+ python tools/qa_event_stream.py record-event \
50
+ --stream .agent_memory/timeline.jsonl \
51
+ --event-type ACTION_CLICK \
52
+ --actor live-explorer \
53
+ --payload '{"page":"CartPage","element":"checkout_button"}'
54
+
55
+ # 3. Create a state checkpoint
56
+ python tools/qa_event_stream.py record-event \
57
+ --stream .agent_memory/timeline.jsonl \
58
+ --event-type CHECKPOINT \
59
+ --actor test-runner \
60
+ --payload '{"cart_total": 99.99}' \
61
+ --checkpoint-id "PRE_CHECKOUT_FORM"
62
+
63
+ # 4. Verify stream integrity
64
+ python tools/qa_event_stream.py verify-stream \
65
+ --stream .agent_memory/timeline.jsonl
66
+
67
+ # 5. Rollback to checkpoint on test failure
68
+ python tools/qa_event_stream.py rollback \
69
+ --stream .agent_memory/timeline.jsonl \
70
+ --to-checkpoint "PRE_CHECKOUT_FORM"
71
+ ```
72
+
73
+ ---
74
+
75
+ ## 3. Strict Operating Invariants
76
+
77
+ - **Hash Chain Integrity:** All events must compute `SHA-256(prev_hash | session_id | event_type | actor | payload | timestamp)`.
78
+ - **Zero Log Tampering:** Never edit `timeline.jsonl` lines manually; always append via the CLI tool.
79
+ - **UTF-8 No BOM:** Timeline files must remain clean UTF-8 without byte-order marks.
@@ -0,0 +1,2 @@
1
+ {"index": 0, "session_id": "SESSION_DEMO_001", "event_type": "STREAM_INIT", "actor": "system", "payload": {"initialized_at": "2026-11-04T12:00:00Z"}, "timestamp": "2026-11-04T12:00:00Z", "prev_hash": "0000000000000000000000000000000000000000000000000000000000000000", "event_hash": "1a2b3c4d5e6f"}
2
+ {"index": 1, "session_id": "SESSION_DEMO_001", "event_type": "ACTION_NAVIGATE", "actor": "live-explorer", "payload": {"url": "https://app.local/login"}, "timestamp": "2026-11-04T12:00:01Z", "prev_hash": "1a2b3c4d5e6f", "event_hash": "2b3c4d5e6f7a"}
@@ -0,0 +1,66 @@
1
+ ---
2
+ name: failure-autopsy-and-healing
3
+ description: "Triage test failures from JUnit XML/screenshots and heal broken Page Class locators. Use when diagnosing failed test runs and producing closed-loop healing plans."
4
+ ---
5
+
6
+ # Failure Autopsy & Auto-Healing (Diagnostic & Self-Healing Engine)
7
+
8
+ Specialized skill for diagnosing batch test execution failures across automated test cases, performing visual autopsies via `Screenshots/FAILED_*.png`, parsing `JUnit_Report.xml`, and healing Page Classes (`Keywords/<namespace>/pages/*.groovy` or `pages/*.ts`) in place.
9
+
10
+ ---
11
+
12
+ ## 1. Five-Step Enterprise Autopsy Protocol
13
+
14
+ ```mermaid
15
+ flowchart LR
16
+ A["1. Detect FAILED TC"] --> B["2. Inspect Screenshots/FAILED_*.png"]
17
+ B --> C["3. Parse JUnit_Report.xml"]
18
+ C --> D["4. Heal Page Class in-place"]
19
+ D --> E["5. Re-run suite: 100% PASS"]
20
+ ```
21
+
22
+ 1. **Zero-Token Triage:** Pinpoint failed line and cause instantly (<50 tokens):
23
+ ```bash
24
+ python tools/pinpoint_failure.py
25
+ # or bash .agents/skills/failure-autopsy-and-healing/scripts/triage_failures.sh
26
+ ```
27
+ 2. **Visual Autopsy:** Inspect the latest error screenshot to immediately detect: disabled buttons, missing required fields, UI overlaps, or obscuring modal backdrops.
28
+ 3. **XML Parsing:** Extract stacktrace and exception messages from `Reports/<Timestamp>/JUnit_Report.xml` or Playwright test results.
29
+ 4. **In-Place Healing:** Update the corresponding Page Class in `Keywords/<project_namespace>/pages/` or `pages/`.
30
+ 5. **Regression Guard:** Verify 100% UTF-8 No BOM and re-run the targeted suite to confirm 100% Pass.
31
+
32
+ ---
33
+
34
+ ## 2. Dynamic Module & Page Class Mapping Architecture
35
+
36
+ | Functional Module Category | Target Page Class to Heal | Common Failure Vector | Recommended Auto-Heal Strategy |
37
+ | :--- | :--- | :--- | :--- |
38
+ | **Authentication & Session** | `LoginPage` | Stale session, cookie expiration | Switch to zero-second storage state / token injection |
39
+ | **System Admin & RBAC** | `UserAdminPage` | Role permission dialog overlay | Smart wait for dialog animation + backdrop dismissal |
40
+ | **Master Data & Catalogs** | `CategoryPage` | Table virtualization lazy-load | Scroll into view + waitForLoadState('networkidle') |
41
+ | **Workflows & Approvals** | `PlanningPage` | Button disabled state / slow API | Await formControl valid state before trigger click |
42
+ | **Data Tables & Search** | `DataManagementPage`| Dynamic table pagination index | Target semantic cell content or unique row testid |
43
+ | **Reporting & Exports** | `ReportPage` | Background worker generation lag | Poll download trigger with timeout rather than static wait |
44
+ | **API & Integrations** | `ApiTokenPage` | Bearer token header mismatch | Validate token generation response payload schema |
45
+
46
+ ---
47
+
48
+ ## 3. Reference Documentation
49
+
50
+ - [**Diagnostic & Healing Matrix (`healing_matrix.md`)**](references/healing_matrix.md): Concrete code prescriptions for disabled buttons, boundary overlaps, `ElementClickInterceptedException`, `StaleElementReferenceException`, and 4 flaky test root causes.
51
+ - [**Fast-Fix Triad & Runtime Helper (`tools/browser_helpers.js`)**](../../../tools/browser_helpers.js): In-browser diagnosis engine via `window.__qa` (`audit`, `heal`, `clickSafe`, `hud`).
52
+ - **Automated Triage Script:** `python tools/pinpoint_failure.py` and `scripts/triage_failures.sh`.
53
+
54
+ ---
55
+
56
+ ## 4. Boundary vs `self-healing-locator` (Do Not Confuse)
57
+
58
+ - **This skill** = the general physician: accepts ANY failed test run, performs
59
+ root-cause analysis (JUnit XML, logs, screenshots), queries the memory cache,
60
+ files the bug ticket, and produces a full healing plan (which may involve
61
+ environment, data, timing, or code fixes).
62
+ - **`self-healing-locator`** = the orthopedic specialist: one failure class only
63
+ — broken locators/stale elements. Its matching cascade is *dispatched by*
64
+ this skill's plan when the RCA concludes "locator drift".
65
+ - Rule of thumb: if the failure reason is not yet known, start here; only after
66
+ the RCA says "locator broke" hand the repair to `self-healing-locator`.