@teevee98/synapse-hub 4.4.0 → 4.4.1

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 (276) hide show
  1. package/.cursor/rules/agents.mdc +11 -11
  2. package/.cursor/rules/katalon.mdc +11 -0
  3. package/.cursor/rules/perf.mdc +10 -0
  4. package/.cursor/rules/playwright.mdc +10 -0
  5. package/.cursor/rules/pytest.mdc +10 -0
  6. package/.cursor/rules/synapse-qa.mdc +4 -2
  7. package/.cursorrules +3 -10
  8. package/.windsurfrules +3 -10
  9. package/AGENTS.md +4 -3
  10. package/CLAUDE.md +4 -5
  11. package/README.en.md +3 -3
  12. package/README.md +3 -3
  13. package/agentskills.json +15 -15
  14. package/{.agents/agents → ai-agents/personas}/api-engineer.md +2 -2
  15. package/{.agents/agents → ai-agents/personas}/failure-analyst.md +1 -1
  16. package/{.agents/agents → ai-agents/personas}/live-explorer.md +1 -1
  17. package/{.agents/agents → ai-agents/personas}/orchestrator.md +8 -15
  18. package/{.agents/agents → ai-agents/personas}/perf-engineer.md +1 -3
  19. package/{.agents/agents → ai-agents/personas}/pom-crafter.md +3 -9
  20. package/{.agents/agents → ai-agents/personas}/quality-gatekeeper.md +1 -1
  21. package/{.agents/agents → ai-agents/personas}/test-designer.md +2 -1
  22. package/{.agents/agents → ai-agents/personas}/test-runner.md +3 -4
  23. package/{.agents/rules → automation/playwright}/mandatory-playwright-live.md +5 -13
  24. package/{.agents/skills/01-web-automation → automation/playwright}/playwright-webapp-testing/SKILL.md +2 -0
  25. package/{.agents/skills/01-web-automation → automation/shared-utils}/clean-pom-crafter/SKILL.md +8 -0
  26. package/{.agents/skills/01-web-automation → automation/shared-utils}/e2e-testing-patterns/SKILL.md +9 -0
  27. package/{.agents/skills/01-web-automation → automation/shared-utils}/lam-script-generator/SKILL.md +2 -0
  28. package/docs/ARCHITECTURE.en.md +2 -2
  29. package/docs/ARCHITECTURE.md +2 -2
  30. package/docs/TOOL_CATALOG.md +8 -5
  31. package/docs/reports/AUDIT_REPORT.md +1038 -0
  32. package/docs/reports/PROJECT_HEALTH_REPORT.md +49 -0
  33. package/docs/reports/TECHNICAL_DEBT_LEDGER.md +22 -0
  34. package/package.json +8 -1
  35. package/plugin.json +1 -1
  36. package/{.agents/skills/02-test-design → requirement/spec-review}/review-spec/SKILL.md +8 -0
  37. package/scripts/install_global_plugin.ps1 +1 -1
  38. package/scripts/install_global_plugin.sh +1 -1
  39. package/skills_index.json +61 -0
  40. package/skills_manifest.json +88 -62
  41. package/{.agents/skills/08-code-quality → standards/coding-standards}/lean-code-ladder/SKILL.md +8 -1
  42. package/{.agents/skills/08-code-quality → standards/coding-standards}/surgical-coding-principles/SKILL.md +2 -0
  43. package/synapse.config.json +1 -1
  44. package/templates/ai_bridges/CLAUDE.md +4 -5
  45. package/templates/ai_bridges/copilot-instructions.md +1 -0
  46. package/templates/ai_bridges/cursor_synapse_qa.mdc +4 -2
  47. package/templates/ai_bridges/windsurfrules +3 -10
  48. package/testing/api-contracts/api_testing_rules.md +74 -0
  49. package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/agentless-qa-repair/SKILL.md +2 -0
  50. package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/SKILL.md +5 -11
  51. package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/self-healing-locator/SKILL.md +2 -0
  52. package/testing/manual/manual-qa-and-rtm-bridge/SKILL.md +92 -0
  53. package/testing/manual/manual-qa-and-rtm-bridge/examples/sample_bug_and_rtm.json +38 -0
  54. package/{.agents/skills/04-performance-and-load → testing/performance}/backend-load-and-stress-patterns/SKILL.md +1 -1
  55. package/{.agents/rules → testing/performance}/performance_testing_rules.md +23 -0
  56. package/{.agents/rules → testing/security-a11y}/security_testing_rules.md +19 -0
  57. package/tools/TOOLS_RUNBOOK.md +9 -4
  58. package/tools/TOOL_CATALOG.json +75 -30
  59. package/tools/TOOL_INDEX.json +160 -0
  60. package/tools/__init__.py +1 -1
  61. package/tools/assertion_optimizer.py +188 -0
  62. package/tools/author_integrity.py +12 -1
  63. package/tools/benchmark_swarm_context.py +1 -1
  64. package/tools/browser_helpers.js +2 -2
  65. package/tools/catalogs/api_contract_testing.json +107 -0
  66. package/tools/catalogs/auxiliary_utilities.json +1536 -0
  67. package/tools/catalogs/benchmarking.json +23 -0
  68. package/tools/catalogs/ci_cd_packaging.json +46 -0
  69. package/tools/catalogs/code_generation_ast.json +70 -0
  70. package/tools/catalogs/failure_autopsy_healing.json +41 -0
  71. package/tools/catalogs/manual_testing_design.json +80 -0
  72. package/tools/catalogs/orchestration.json +25 -0
  73. package/tools/catalogs/performance_testing.json +71 -0
  74. package/tools/catalogs/quality_gates.json +65 -0
  75. package/tools/catalogs/sandboxing_isolation.json +42 -0
  76. package/tools/catalogs/security.json +72 -0
  77. package/tools/catalogs/setup_onboarding.json +26 -0
  78. package/tools/catalogs/testing_utilities.json +111 -0
  79. package/tools/check_env.py +16 -3
  80. package/tools/check_version_sync.py +114 -63
  81. package/tools/cldr_l10n_verifier.py +1 -1
  82. package/tools/cli.py +787 -3
  83. package/tools/core/circuit_breaker.py +106 -0
  84. package/tools/core/token_estimator.py +56 -7
  85. package/tools/dashboard_generator.py +10 -10
  86. package/tools/generate_tool_catalog.py +60 -2
  87. package/tools/mcp_docx_server.py +1 -1
  88. package/tools/mcp_excel_server.py +1 -1
  89. package/tools/mcp_server.py +5 -1
  90. package/tools/pre_push_guard.py +1 -1
  91. package/tools/project_state.py +17 -10
  92. package/tools/reversible_sandbox.py +7 -2
  93. package/tools/rules_router.py +5 -3
  94. package/tools/runaway_stopper.py +19 -111
  95. package/tools/setup_project.py +1 -1
  96. package/tools/skill_canonical_digest.py +2 -2
  97. package/tools/skillspector.py +78 -10
  98. package/tools/sync_agent_rules.py +15 -27
  99. package/tools/sync_skills_manifest.py +38 -4
  100. package/tools/tmmi_auditor.py +8 -1
  101. package/tools/ui_server.py +1 -1
  102. package/tools/update_sentinel.py +4 -4
  103. package/tools/validate_host_interop.py +3 -1
  104. package/tools/validate_skills_schema.py +49 -2
  105. package/tools/welcome_page.py +4 -4
  106. package/.agents/rules/stack-auto-router.md +0 -30
  107. package/.agents/skills/09-ci-and-devops/github-actions-templates/SKILL.md +0 -114
  108. package/.agents/skills/09-ci-and-devops/github-actions-templates/examples/matrix_test_pipeline.yml +0 -9
  109. package/.agents/skills/09-ci-and-devops/gitlab-ci-templates/SKILL.md +0 -123
  110. package/.agents/skills/09-ci-and-devops/gitlab-ci-templates/examples/sample_gitlab_ci.yml +0 -17
  111. package/.agents/skills/09-ci-and-devops/jenkins-pipeline-templates/SKILL.md +0 -133
  112. package/.agents/skills/09-ci-and-devops/jenkins-pipeline-templates/examples/Jenkinsfile.example +0 -21
  113. package/.cursor/rules/language.mdc +0 -7
  114. package/templates/ci/github-actions-synapse.yml +0 -95
  115. package/templates/ci/gitlab-ci-synapse.yml +0 -16
  116. package/tools/build_consolidated_report.py +0 -1643
  117. package/tools/create_mock_docx.py +0 -107
  118. /package/{.agents → ai-agents/hooks}/hooks.json +0 -0
  119. /package/{.agents → ai-agents}/hooks/session_start.py +0 -0
  120. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/actor-qa-swarm/SKILL.md +0 -0
  121. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/actor-qa-swarm/examples/broker_sharding_sample.json +0 -0
  122. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/agent-orchestration-multi-agent-optimize/SKILL.md +0 -0
  123. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/agent-orchestration-multi-agent-optimize/examples/swarm_workload_config.json +0 -0
  124. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/event-stream-qa-orchestrator/SKILL.md +0 -0
  125. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/event-stream-qa-orchestrator/examples/timeline_sample.jsonl +0 -0
  126. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/persistent-planning-files/SKILL.md +0 -0
  127. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/persistent-planning-files/examples/task_plan_example.md +0 -0
  128. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/qa-memory-os/SKILL.md +0 -0
  129. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/qa-memory-os/examples/archival_memory_sample.json +0 -0
  130. /package/{.agents → ai-agents}/workflows/graphify.md +0 -0
  131. /package/{.agents → ai-agents}/workflows/test-impact.md +0 -0
  132. /package/{.agents → ai-agents}/workflows/verify.md +0 -0
  133. /package/{.agents/rules → automation/cypress}/cypress_rules.md +0 -0
  134. /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/SKILL.md +0 -0
  135. /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/examples/headless_kre_exec.sh +0 -0
  136. /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/references/groovy-patterns.md +0 -0
  137. /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/references/katalon-api.md +0 -0
  138. /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/references/runner_commands.md +0 -0
  139. /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-appium-som/SKILL.md +0 -0
  140. /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-appium-som/examples/BaseScreen.java +0 -0
  141. /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-appium-som/examples/LoginScreen.java +0 -0
  142. /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-appium-som/examples/TC_MobileLogin.java +0 -0
  143. /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-maestro-detox-patterns/SKILL.md +0 -0
  144. /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-maestro-detox-patterns/examples/sample_flow.yaml +0 -0
  145. /package/{.agents/rules → automation/mobile}/mobile_appium_rules.md +0 -0
  146. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/SKILL.md +0 -0
  147. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/examples/live_probe_script.js +0 -0
  148. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/references/advanced_superpowers.md +0 -0
  149. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/references/compact_accessibility_snapshots.md +0 -0
  150. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/references/recipes.md +0 -0
  151. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/references/swarm_orchestration.md +0 -0
  152. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-webapp-testing/examples/server_lifecycle_playwright.py +0 -0
  153. /package/{.agents/skills/01-web-automation → automation/shared-utils}/auth-session-and-cookie-manager/SKILL.md +0 -0
  154. /package/{.agents/skills/01-web-automation → automation/shared-utils}/auth-session-and-cookie-manager/examples/multi_role_auth_matrix.md +0 -0
  155. /package/{.agents/skills/01-web-automation → automation/shared-utils}/auth-session-and-cookie-manager/examples/storage_state_sample.json +0 -0
  156. /package/{.agents/skills/01-web-automation → automation/shared-utils}/bats-testing-patterns/SKILL.md +0 -0
  157. /package/{.agents/skills/01-web-automation → automation/shared-utils}/bats-testing-patterns/examples/cli_runner_test.bats +0 -0
  158. /package/{.agents/skills/01-web-automation → automation/shared-utils}/bats-testing-patterns/resources/implementation-playbook.md +0 -0
  159. /package/{.agents/skills/01-web-automation → automation/shared-utils}/clean-pom-crafter/examples/standard_test_case.groovy +0 -0
  160. /package/{.agents/skills/01-web-automation → automation/shared-utils}/clean-pom-crafter/references/pom_patterns.groovy +0 -0
  161. /package/{.agents/skills/01-web-automation → automation/shared-utils}/e2e-testing-patterns/examples/playwright_sharded_config.ts +0 -0
  162. /package/{.agents/skills/01-web-automation → automation/shared-utils}/e2e-testing-patterns/resources/implementation-playbook.md +0 -0
  163. /package/{.agents/skills/01-web-automation → automation/shared-utils}/lam-script-generator/examples/user_story_sample.md +0 -0
  164. /package/{.agents/skills/03-api-and-contracts → requirement/spec-review}/api-spec-to-e2e-matrix/SKILL.md +0 -0
  165. /package/{.agents/skills/03-api-and-contracts → requirement/spec-review}/api-spec-to-e2e-matrix/examples/sample_openapi.json +0 -0
  166. /package/{.agents/skills/02-test-design → requirement/spec-review}/architecture-decision-records/SKILL.md +0 -0
  167. /package/{.agents/skills/02-test-design → requirement/spec-review}/architecture-decision-records/examples/0001-record-architecture-decisions.md +0 -0
  168. /package/{.agents/skills/02-test-design → requirement/spec-review}/review-spec/examples/pocock_grilling_decision_rubric.md +0 -0
  169. /package/{.agents/skills/02-test-design → requirement/spec-review}/review-spec/examples/sample_spec_review.md +0 -0
  170. /package/{.agents → requirement}/workflows/analyze_requirement_document.md +0 -0
  171. /package/{.agents → requirement}/workflows/generate_requirements_from_website.md +0 -0
  172. /package/{.agents/rules → standards/coding-standards}/author-integrity-guard.md +0 -0
  173. /package/{.agents/skills/08-code-quality → standards/coding-standards}/code-refactoring-refactor-clean/SKILL.md +0 -0
  174. /package/{.agents/skills/08-code-quality → standards/coding-standards}/code-refactoring-refactor-clean/examples/refactored_page_sample.groovy +0 -0
  175. /package/{.agents/skills/08-code-quality → standards/coding-standards}/code-refactoring-refactor-clean/examples/refactored_playwright_pom.ts +0 -0
  176. /package/{.agents/skills/08-code-quality → standards/coding-standards}/code-refactoring-refactor-clean/resources/implementation-playbook.md +0 -0
  177. /package/{.agents/rules → standards/coding-standards}/communication-style.md +0 -0
  178. /package/{.agents/rules → standards/coding-standards}/git-push-protocol.md +0 -0
  179. /package/{.agents/skills/08-code-quality → standards/coding-standards}/graphify-impact-analyzer/SKILL.md +0 -0
  180. /package/{.agents/skills/08-code-quality → standards/coding-standards}/graphify-impact-analyzer/examples/dependency_blast_radius.json +0 -0
  181. /package/{.agents/skills/08-code-quality → standards/coding-standards}/lean-code-ladder/examples/ladder_walkthrough.md +0 -0
  182. /package/{.agents/skills/08-code-quality → standards/coding-standards}/repo-quality-audit/SKILL.md +0 -0
  183. /package/{.agents/skills/08-code-quality → standards/coding-standards}/repo-quality-audit/examples/sample_audit_walkthrough.md +0 -0
  184. /package/{.agents/skills/08-code-quality → standards/coding-standards}/repo-quality-audit/examples/sample_repo_audit.md +0 -0
  185. /package/{.agents/skills/08-code-quality → standards/coding-standards}/senior-code-review/SKILL.md +0 -0
  186. /package/{.agents/skills/08-code-quality → standards/coding-standards}/senior-code-review/examples/sample_review_walkthrough.md +0 -0
  187. /package/{.agents/skills/08-code-quality → standards/coding-standards}/surgical-coding-principles/examples/surgical_vs_scope_creep.md +0 -0
  188. /package/{.agents/skills/08-code-quality → standards/coding-standards}/technical-debt-harvester/SKILL.md +0 -0
  189. /package/{.agents/skills/08-code-quality → standards/coding-standards}/technical-debt-harvester/examples/sample_debt_ledger.md +0 -0
  190. /package/{.agents/skills/08-code-quality → standards/coding-standards}/technical-debt-harvester/examples/sample_ledger_output.md +0 -0
  191. /package/{.agents/rules → standards/context-ai}/context-engineering.md +0 -0
  192. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/meta-prompt-crafter/SKILL.md +0 -0
  193. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/meta-prompt-crafter/examples/qa_prompt_template.md +0 -0
  194. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/mipro-prompt-compiler/SKILL.md +0 -0
  195. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/mipro-prompt-compiler/examples/compiled_module_sample.json +0 -0
  196. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/mipro-prompt-compiler/examples/dspy_assertion_optimizer_case.md +0 -0
  197. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/qa-aci-interface/SKILL.md +0 -0
  198. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/qa-aci-interface/examples/surgical_code_window_walkthrough.md +0 -0
  199. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/qa-aci-interface/examples/surgical_edit_sample.json +0 -0
  200. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/token-and-context-optimizer/SKILL.md +0 -0
  201. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/token-and-context-optimizer/examples/distilled_log_sample.txt +0 -0
  202. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/token-and-context-optimizer/references/context_engineering_guide.md +0 -0
  203. /package/{.agents/rules → standards/qa-process}/graphify.md +0 -0
  204. /package/{.agents/rules → standards/qa-process}/lessons-learned.md +0 -0
  205. /package/{.agents/rules → standards/qa-process}/skill-precedence.md +0 -0
  206. /package/{.agents/rules → standards/quality-gates}/systematic-debugging.md +0 -0
  207. /package/{.agents/templates → templates/test-plan}/performance-test-plan-template.md +0 -0
  208. /package/{.agents/templates → templates/test-report}/completion_report.md +0 -0
  209. /package/{.agents/skills/02-test-design → test-design/bdd-gherkin}/gherkin-to-suite/SKILL.md +0 -0
  210. /package/{.agents/skills/02-test-design → test-design/bdd-gherkin}/gherkin-to-suite/examples/checkout.feature +0 -0
  211. /package/{.agents/skills/02-test-design → test-design/bdd-gherkin}/gherkin-to-suite/examples/suite_report_sample.json +0 -0
  212. /package/{.agents → test-design/bdd-gherkin}/workflows/generate_cross_module_test_plan.md +0 -0
  213. /package/{.agents → test-design/bdd-gherkin}/workflows/generate_testcases_from_requirements.md +0 -0
  214. /package/{.agents/skills/02-test-design → test-design/exploratory}/tot-exploratory-testing/SKILL.md +0 -0
  215. /package/{.agents/skills/02-test-design → test-design/exploratory}/tot-exploratory-testing/examples/payment_gateway_tot_tree.json +0 -0
  216. /package/{.agents/skills/02-test-design → test-design/exploratory}/tot-exploratory-testing/examples/tot_graph_sample.json +0 -0
  217. /package/{.agents/skills/02-test-design → test-design/manual-rbt}/rbt-manual-testing/SKILL.md +0 -0
  218. /package/{.agents/skills/02-test-design → test-design/manual-rbt}/rbt-manual-testing/examples/checkout_rbt_manual_suite.md +0 -0
  219. /package/{.agents/skills/02-test-design → test-design/manual-rbt}/rbt-manual-testing/references/field_validation_checklist.md +0 -0
  220. /package/{.agents → test-design/manual-rbt}/workflows/export_testcases_excel.md +0 -0
  221. /package/{.agents → test-design/manual-rbt}/workflows/generate_manual_testcases_rbt.md +0 -0
  222. /package/{.agents/skills/07-data-and-state → test-design/test-data}/db-state-verifier-and-seeder/SKILL.md +0 -0
  223. /package/{.agents/skills/07-data-and-state → test-design/test-data}/db-state-verifier-and-seeder/examples/db_fixture_seed.json +0 -0
  224. /package/{.agents/skills/07-data-and-state → test-design/test-data}/file-and-report-validator/SKILL.md +0 -0
  225. /package/{.agents/skills/07-data-and-state → test-design/test-data}/file-and-report-validator/examples/sample_export_schema.json +0 -0
  226. /package/{.agents/skills/07-data-and-state → test-design/test-data}/synthetic-test-data-generator/SKILL.md +0 -0
  227. /package/{.agents/skills/07-data-and-state → test-design/test-data}/synthetic-test-data-generator/examples/idempotent_data_recipe.json +0 -0
  228. /package/{.agents → test-design/test-data}/workflows/generate_combinatorial_test_data.md +0 -0
  229. /package/{.agents/skills/03-api-and-contracts → testing/api-contracts}/api-network-mocking-interception/SKILL.md +0 -0
  230. /package/{.agents/skills/03-api-and-contracts → testing/api-contracts}/api-network-mocking-interception/examples/network_route_stub.json +0 -0
  231. /package/{.agents/skills/03-api-and-contracts → testing/api-contracts}/consumer-driven-contract-testing/SKILL.md +0 -0
  232. /package/{.agents/skills/03-api-and-contracts → testing/api-contracts}/consumer-driven-contract-testing/examples/order_service_pact.json +0 -0
  233. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/agentless-qa-repair/examples/healing_report_sample.json +0 -0
  234. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/agentless-qa-repair/examples/three_phase_repair_workflow.md +0 -0
  235. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/antigravity-test-sentinel/SKILL.md +0 -0
  236. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/antigravity-test-sentinel/examples/dod_gate_policy.json +0 -0
  237. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/antigravity-test-sentinel/examples/sprint_dod_enforcement.md +0 -0
  238. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/examples/closed_loop_healing_walkthrough.md +0 -0
  239. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/examples/sample_junit_failure.xml +0 -0
  240. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/references/healing_matrix.md +0 -0
  241. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/references/qa_investigation_protocol.md +0 -0
  242. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/scripts/triage_failures.sh +0 -0
  243. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/flaky-test-sentinel-and-quarantine/SKILL.md +0 -0
  244. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/flaky-test-sentinel-and-quarantine/examples/quarantine_registry.json +0 -0
  245. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/self-healing-locator/examples/aom_diff_sample.json +0 -0
  246. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/systematic-debugging/SKILL.md +0 -0
  247. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/systematic-debugging/examples/four_phase_case.md +0 -0
  248. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/test-driven-development/SKILL.md +0 -0
  249. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/test-driven-development/examples/red_green_refactor_qa.md +0 -0
  250. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/verification-before-completion/SKILL.md +0 -0
  251. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/verification-before-completion/examples/evidence_log_example.md +0 -0
  252. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/visual-regression-sentinel/SKILL.md +0 -0
  253. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/visual-regression-sentinel/examples/visual_mask_rules.json +0 -0
  254. /package/{.agents/skills/04-performance-and-load → testing/performance}/backend-load-and-stress-patterns/examples/k6_load_test_sample.js +0 -0
  255. /package/{.agents/skills/04-performance-and-load → testing/performance}/backend-load-and-stress-patterns/references/k6_load_template.js +0 -0
  256. /package/{.agents/skills/04-performance-and-load → testing/performance}/backend-load-and-stress-patterns/references/performance_test_plan_29119.md +0 -0
  257. /package/{.agents/skills/04-performance-and-load → testing/performance}/lean-impact-scoreboard/SKILL.md +0 -0
  258. /package/{.agents/skills/04-performance-and-load → testing/performance}/lean-impact-scoreboard/examples/sample_benchmark_gain.md +0 -0
  259. /package/{.agents/skills/04-performance-and-load → testing/performance}/lean-impact-scoreboard/examples/sample_scoreboard.md +0 -0
  260. /package/{.agents/skills/04-performance-and-load → testing/performance}/web-vitals-and-performance-profiler/SKILL.md +0 -0
  261. /package/{.agents/skills/04-performance-and-load → testing/performance}/web-vitals-and-performance-profiler/examples/cwv_budget_policy.json +0 -0
  262. /package/{.agents/skills/04-performance-and-load → testing/performance}/web-vitals-and-performance-profiler/examples/playwright_cwv_profiler_fixture.ts +0 -0
  263. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/SKILL.md +0 -0
  264. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/examples/dast_scan_config.json +0 -0
  265. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/references/AI-AND-LLM.md +0 -0
  266. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/references/ATTACK-CLASSES.md +0 -0
  267. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/references/dast_recipes.ts +0 -0
  268. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/skillspector-security-guard/SKILL.md +0 -0
  269. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/skillspector-security-guard/examples/audit_threat_vectors_report.json +0 -0
  270. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/skillspector-security-guard/examples/safe_mcp_config.json +0 -0
  271. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/wcag-audit-patterns/SKILL.md +0 -0
  272. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/wcag-audit-patterns/examples/wcag_compliance_checklist.json +0 -0
  273. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/wcag-audit-patterns/resources/implementation-playbook.md +0 -0
  274. /package/{.agents/skills/01-web-automation → tools/benchmarks-tests}/web-agent-gym-benchmarking/SKILL.md +0 -0
  275. /package/{.agents/skills/01-web-automation → tools/benchmarks-tests}/web-agent-gym-benchmarking/examples/benchmark_report_sample.json +0 -0
  276. /package/{.agents/skills/01-web-automation → tools/benchmarks-tests}/web-agent-gym-benchmarking/examples/enterprise_tasks_suite.json +0 -0
@@ -0,0 +1,160 @@
1
+ {
2
+ "orchestrator": {
3
+ "python tools/_openapi_parser.py": "Shared OpenAPI & Swagger Speci..",
4
+ "python tools/agent_canary.py": "ENTERPRISE AUTONOMOUS AGENT Ca..",
5
+ "python tools/agentless_patcher.py": "Agentless 3-Stage Deterministi..",
6
+ "python tools/ai_eval_sentinel.py": "Enterprise RAG & LLM Evaluatio..",
7
+ "python tools/api_fuzzer.py": "Enterprise Autonomous API Fuzz..",
8
+ "python tools/assertion_optimizer.py": "Unified Assertion Optimization..",
9
+ "python tools/ast_cache.py": "AST Dataflow Pre-Validation Ca..",
10
+ "python tools/asvs_auditor.py": "OWASP Application Security Ver..",
11
+ "python tools/author_integrity.py": "Author Attribution & Repositor..",
12
+ "python tools/auto_heal_reflexion.py": "Multi-Trial Episodic Reflexion..",
13
+ "python tools/autogen_qa_broker.py": "Asynchronous Actor QA Message ..",
14
+ "python tools/benchmark_swarm_context.py": "Empirical context token reduct..",
15
+ "python tools/break_ui_generator.py": "Edge-Case UI Stress Testing Da..",
16
+ "python tools/browsergym_eval.py": "BrowserGym Web Agent Benchmark..",
17
+ "python tools/bug_reporter.py": "Auto-Bug Reporter & Root Cause..",
18
+ "python tools/bump_version.py": "Atomic Universal Version Bumpe..",
19
+ "python tools/cache_resolver.py": "Universal Local Semantic Memor..",
20
+ "python tools/chaos_resilience_probe.py": "Enterprise Chaos Engineering &..",
21
+ "python tools/check_env.py": "==============================..",
22
+ "python tools/check_version_sync.py": "Version Synchronization Sentin..",
23
+ "python tools/ci_healing_hook.py": "CI/CD Silent Self-Healing Pipe..",
24
+ "python tools/cldr_l10n_verifier.py": "Enterprise Unicode CLDR & L10n..",
25
+ "python tools/cli.py": "Enterprise Agent-QA CLI Entryp..",
26
+ "python tools/config_decoupler.py": "Environment & Secret Decouplin..",
27
+ "python tools/contract_validator.py": "Swarm Data Contract Validator ..",
28
+ "python tools/count_tokens.py": "Cross-Platform Token & Cost Au..",
29
+ "python tools/coverage_reporter.py": "Standardized Coverage Metrics ..",
30
+ "python tools/cvss_calculator.py": "Enterprise Common Vulnerabilit..",
31
+ "python tools/dashboard_generator.py": "Standalone One-Page Enterprise..",
32
+ "python tools/debt_harvester.py": "Technical Debt & Shortcut Harv..",
33
+ "python tools/diagram_architect.py": "Standalone Self-Contained SVG ..",
34
+ "python tools/distill_log.py": "Enterprise Multi-Framework Log..",
35
+ "python tools/distill_skill.py": "Dual-Skill Distillation Engine",
36
+ "python tools/dspy_qa_signatures.py": "Declarative QA Signature Compi..",
37
+ "python tools/e2e_flow_prober.py": "Enterprise E2E Flow Prober & X..",
38
+ "python tools/etl_data_reconciler.py": "Enterprise Data Quality & ETL ..",
39
+ "python tools/flaky_detector.py": "Enterprise Flaky Test Detector..",
40
+ "python tools/fsm_enforcer.py": "5-Stage QA Multi-Agent Finite ..",
41
+ "python tools/fsm_middleware.py": "Runtime FSM Interceptor & Tool..",
42
+ "python tools/fuzz_payloads.py": "Enterprise Edge-Case Fuzzing &..",
43
+ "python tools/generate_allure_report.py": "Enterprise Allure HTML Report ..",
44
+ "python tools/generate_sbom.py": "Standard SPDX 2.3 JSON Softwar..",
45
+ "python tools/generate_tc_from_story.py": "Large Action Model (LAM) Scrip..",
46
+ "python tools/generate_test_reports.py": "Enterprise Test Report Aggrega..",
47
+ "python tools/generate_tool_catalog.py": "Enterprise Tooling Ecosystem C..",
48
+ "python tools/git_pre_commit_guard.py": "Enterprise Git Pre-Commit Arch..",
49
+ "python tools/git_worktree_manager.py": "Ephemeral Git Worktree Manager..",
50
+ "python tools/goldfish_review.py": "Zero-Context Test Specificatio..",
51
+ "python tools/heal_pr_automator.py": "Enterprise Self-Healing Confid..",
52
+ "python tools/heuristic_locator_matcher.py": "3-Layer Heuristic Locator Matc..",
53
+ "python tools/hub_publisher.py": "Autonomous 1-click 5-step rele..",
54
+ "python tools/humanize_linter.py": "Humanize & Anti-AI Slop Linter..",
55
+ "python tools/infer_linter.py": "Universal QA Static Defect & A..",
56
+ "python tools/init_config.py": "Standardized Project Configura..",
57
+ "python tools/jira_sync.py": "Jira / Xray / Zephyr Enterpris..",
58
+ "python tools/lint_ai_docs.py": "Enterprise AI Documentation & ..",
59
+ "python tools/lookup_tc.py": "Enterprise QA: Fast Test Case ..",
60
+ "python tools/lookup_xpath.py": "Enterprise QA: Fast XPath / Se..",
61
+ "python tools/matrix_sharder.py": "Enterprise Duration-Balanced T..",
62
+ "python tools/mcp_docx_server.py": "Enterprise Cross-Platform MCP ..",
63
+ "python tools/mcp_excel_server.py": "Enterprise Cross-Platform MCP ..",
64
+ "python tools/mcp_server.py": "Enterprise Model Context Proto..",
65
+ "python tools/md_to_xlsx.py": "Markdown to Excel (.xlsx) Ente..",
66
+ "python tools/mechanical_ui_gate.py": "Headless Chrome Mechanical Lay..",
67
+ "python tools/mipro_assertion_tuner.py": "MIPROv2 Prompt Assertion Tuner..",
68
+ "python tools/mobile_resilience_sentinel.py": "Mobile Hardware Interrupts, MA..",
69
+ "python tools/observability_tester.py": "OpenTelemetry Trace & Log Hygi..",
70
+ "python tools/openxml_guard.py": "OpenXML Security & Protocol De..",
71
+ "python tools/output_formatter.py": "Enterprise Standardized Output..",
72
+ "python tools/package_release.py": "Enterprise release packager pr..",
73
+ "python tools/pairwise_generator.py": "Pairwise (2-Way) Combinatorial..",
74
+ "python tools/payment_interop_simulator.py": "ISO 8583 & Financial Gateway I..",
75
+ "python tools/pentest_scope_guard.py": "Enterprise Pentest Scope & DAS..",
76
+ "python tools/pre_push_guard.py": "Pre-Push Quality & Anti-Halluc..",
77
+ "python tools/project_state.py": "Enterprise Project State Machi..",
78
+ "python tools/qa_event_stream.py": "Immutable QA Event Stream Engi..",
79
+ "python tools/regulatory_compliance.py": "Enterprise Regulatory & Compli..",
80
+ "python tools/repo_map.py": "Enterprise Repository Map Comp..",
81
+ "python tools/rules_router.py": "Progressive Rules Router & Con..",
82
+ "python tools/runaway_stopper.py": "Agent Runaway & Token Loop Sen..",
83
+ "python tools/security_coverage_ledger.py": "Mathematical Security Coverage..",
84
+ "python tools/senior_code_review.py": "Senior Developer Quality & Lea..",
85
+ "python tools/setup_project.py": "Zero-command automated project..",
86
+ "python tools/skill_canonical_digest.py": "Single Source of Truth for Ski..",
87
+ "python tools/skill_collision_guard.py": "Tier-2 Skill Routing & Collisi..",
88
+ "python tools/skill_profiles.py": "Skill Catalog Capability Profi..",
89
+ "python tools/skill_vault.py": "SkillVault Lifelong Page Objec..",
90
+ "python tools/slide_deck_exporter.py": "Pure HTML/CSS 16:9 Vector Slid..",
91
+ "python tools/smart_visual_masker.py": "Smart Visual Masker & Anti-Fla..",
92
+ "python tools/spec_drift_sentinel.py": "Spec-to-Code Drift Sentinel",
93
+ "python tools/swe_qa_aci.py": "QA Agent-Computer Interface (S..",
94
+ "python tools/synapse_observer.py": "Synapse Cognitive Observer & T..",
95
+ "python tools/synapse_qa_bench.py": "Synapse-QA-Bench: Tool Functio..",
96
+ "python tools/sync_agent_rules.py": "Synchronizes AGENTS.md single-..",
97
+ "python tools/sync_skills_manifest.py": "Synchronize Skill Policies & F..",
98
+ "python tools/task_memory_manager.py": "Compaction-Resilient Working M..",
99
+ "python tools/test_impact.py": "Universal Test Impact Analyzer..",
100
+ "python tools/test_memory_os.py": "Hierarchical QA Test Memory OS..",
101
+ "python tools/textgrad_mutation_optimizer.py": "Mutant-Directed Textual Loss O..",
102
+ "python tools/tmmi_auditor.py": "Enterprise TMMi (Test Maturity..",
103
+ "python tools/tms_sync_bridge.py": "Enterprise ALM & TMS Sync Brid..",
104
+ "python tools/token_telemetry.py": "Live LLM Token & MTTR Telemetr..",
105
+ "python tools/trace_data_flow.py": "Universal Data Flow & Teardown..",
106
+ "python tools/trend_analytics.py": "Historical Quality Trend & Fla..",
107
+ "python tools/ui_server.py": "Synapse Hub Interactive QA Mis..",
108
+ "python tools/update_sentinel.py": "Enterprise Synapse-Hub Auto-Up..",
109
+ "python tools/validate_groovy_scripts.py": "Pre-check validator for Groovy..",
110
+ "python tools/validate_host_interop.py": "Multi-Host AI Agent Interopera..",
111
+ "python tools/validate_skills_schema.py": "Standalone Skill Schema & Poli..",
112
+ "python tools/visual_diff_canvas.py": "Enterprise Canvas Visual Diff ..",
113
+ "python tools/visual_som_helper.py": "Enterprise Vision-Grounded Fal..",
114
+ "python tools/vpat_exporter.py": "Enterprise Section 508 & EN 30..",
115
+ "python tools/watch_mode.py": "Incremental Watch Mode & Real-..",
116
+ "python tools/wcag_audit.py": "tools/wcag_audit.py - Automate..",
117
+ "python tools/welcome_page.py": "Interactive Visual Landing Pag.."
118
+ },
119
+ "live-explorer": {},
120
+ "pom-crafter": {
121
+ "python tools/omni_emitter.py": "Universal polyglot code genera..",
122
+ "python tools/omni_parser.py": "Deterministic 0-token polyglot..",
123
+ "python tools/omni_transpiler.py": "Instant 0-token transpiler bet..",
124
+ "python tools/universal_ir.py": "Language-agnostic and framewor.."
125
+ },
126
+ "test-runner": {},
127
+ "failure-analyst": {
128
+ "python tools/auto_heal.py": "Closed-loop locator self-heali..",
129
+ "python tools/db_sandbox.py": "Database state isolation senti..",
130
+ "python tools/pinpoint_failure.py": "Sub-0.1s JUnit XML autopsy par..",
131
+ "python tools/reversible_sandbox.py": "Two-phase commit write-ahead l.."
132
+ },
133
+ "quality-gatekeeper": {
134
+ "python tools/analyze_project.py": "Comprehensive health audit ana..",
135
+ "python tools/micro_mutator.py": "Syntactic micro-mutation senti..",
136
+ "python tools/safety_firewall.py": "Non-bypassable safety firewall..",
137
+ "python tools/security_scanner.py": "Comprehensive enterprise secur..",
138
+ "python tools/skillspector.py": "Security scanner detecting pro..",
139
+ "python tools/verify_all.py": "One-command 10 Quality Gates D.."
140
+ },
141
+ "api-engineer": {
142
+ "python tools/api_drift_sentinel.py": "Detects contract drift and bre..",
143
+ "python tools/export_postman_collection.py": "Exports API test matrices into..",
144
+ "python tools/generate_api_matrix.py": "Converts OpenAPI/Swagger specs..",
145
+ "python tools/network_mock_shield.py": "Network interception shield st..",
146
+ "python tools/newman_analyzer.py": "Sub-0.1s Postman/Newman JSON t..",
147
+ "python tools/traffic_session_converter.py": "Converts recorded HAR traffic .."
148
+ },
149
+ "perf-engineer": {
150
+ "python tools/generate_jmx_plan.py": "Enterprise Apache JMeter 5.x &..",
151
+ "python tools/jtl_analyzer.py": "Sub-0.1s Apache JMeter JTL res..",
152
+ "python tools/telemetry_correlator.py": "Full-stack APM & server teleme.."
153
+ },
154
+ "test-designer": {
155
+ "python tools/gherkin_suite.py": "Compiles Gherkin .feature spec..",
156
+ "python tools/interview_story.py": "Interactive requirement interr..",
157
+ "python tools/template_excel_exporter.py": "Enterprise template-driven Exc..",
158
+ "python tools/tot_exploratory_tester.py": "Tree-of-Thoughts exploratory s.."
159
+ }
160
+ }
package/tools/__init__.py CHANGED
@@ -17,7 +17,7 @@ Domain Packages:
17
17
  - tools.mcp: Model Context Protocol servers (core QA and Excel manipulation).
18
18
  """
19
19
 
20
- __version__ = "4.4.0"
20
+ __version__ = "4.4.1"
21
21
  __author__ = "Thế Vị (@TeeVee98)"
22
22
 
23
23
  # Expose domain packages
@@ -0,0 +1,188 @@
1
+ #!/usr/bin/env python3
2
+ # SPDX-FileCopyrightText: Copyright (c) 2026 Thế Vị (@TeeVee98). All rights reserved.
3
+ # SPDX-License-Identifier: MIT
4
+ # Project: Synapse-Hub (https://github.com/TeeVee98/Synapse-Hub)
5
+
6
+ """
7
+ tools/assertion_optimizer.py — Unified Assertion Optimization & Tuning Suite
8
+ ----------------------------------------------------------------------------
9
+ Unifies and orchestrates the DSPy v2 declarative signatures, MIPROv2 Bayesian
10
+ instruction search, and TextGrad mutation loss feedback into a single CLI tool.
11
+
12
+ Subcommands:
13
+ signatures : Inspect or compile declarative QA DSPy signatures.
14
+ tune : Run MIPROv2 prompt optimization over candidate instructions & demonstrations.
15
+ gradient : Compute textual gradients from surviving micro-mutants to refine assertions.
16
+ eval : Evaluate assertion code against Synapse-Hub 10 Quality Gates DoD metric.
17
+
18
+ 100% UTF-8 No BOM.
19
+ """
20
+
21
+ import os
22
+ import sys
23
+ import json
24
+ import argparse
25
+
26
+ # Enforce UTF-8 stdio
27
+ if hasattr(sys.stdout, "reconfigure"):
28
+ try:
29
+ sys.stdout.reconfigure(encoding="utf-8")
30
+ sys.stderr.reconfigure(encoding="utf-8")
31
+ except Exception:
32
+ pass
33
+
34
+ SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
35
+ if SCRIPT_DIR not in sys.path:
36
+ sys.path.insert(0, SCRIPT_DIR)
37
+
38
+ # Safe imports from underlying assertion engines
39
+ try:
40
+ import dspy_qa_signatures
41
+ except ImportError:
42
+ dspy_qa_signatures = None
43
+
44
+ try:
45
+ import mipro_assertion_tuner
46
+ except ImportError:
47
+ mipro_assertion_tuner = None
48
+
49
+ try:
50
+ import textgrad_mutation_optimizer
51
+ except ImportError:
52
+ textgrad_mutation_optimizer = None
53
+
54
+
55
+ def run_signatures_cmd(args: argparse.Namespace) -> int:
56
+ """Handles signatures subcommand."""
57
+ if not dspy_qa_signatures:
58
+ print("Error: dspy_qa_signatures engine not available.", file=sys.stderr)
59
+ return 1
60
+
61
+ print("====================================================================")
62
+ print(" DECLARATIVE QA DSPy SIGNATURES ENGINE")
63
+ print("====================================================================")
64
+ print("Registered Signatures:")
65
+ print(" 1. UserStoryToUniversalIR : Formalizes agile stories into AST IR.")
66
+ print(" 2. UniversalIRToCleanPOM : Transpiles Universal IR into Clean POM Page Classes.")
67
+ print(" 3. RCAFailureDiagnosis : Extracts root cause analysis from test trace.")
68
+ print("====================================================================")
69
+ return 0
70
+
71
+
72
+ def run_tune_cmd(args: argparse.Namespace) -> int:
73
+ """Handles MIPROv2 tuning subcommand."""
74
+ if not mipro_assertion_tuner:
75
+ print("Error: mipro_assertion_tuner engine not available.", file=sys.stderr)
76
+ return 1
77
+
78
+ tuner = mipro_assertion_tuner.MiproAssertionTuner()
79
+ res = tuner.compile_module(signature_name="AssertionGenerator", trials=args.trials)
80
+ if args.json:
81
+ print(json.dumps(res, indent=2, ensure_ascii=False))
82
+ else:
83
+ print("====================================================================")
84
+ print(" MIPROv2 BAYESIAN ASSERTION TUNING RESULTS")
85
+ print("====================================================================")
86
+ print(f"Optimal Score: {res.get('best_score', 0):.2f}%")
87
+ print(f"Instruction : {res.get('best_instruction', '')}")
88
+ print(f"Few-Shot Demos: {len(res.get('best_demonstrations', []))}")
89
+ print("====================================================================")
90
+ return 0
91
+
92
+
93
+ def run_gradient_cmd(args: argparse.Namespace) -> int:
94
+ """Handles TextGrad mutation loss feedback subcommand."""
95
+ if not textgrad_mutation_optimizer:
96
+ print("Error: textgrad_mutation_optimizer engine not available.", file=sys.stderr)
97
+ return 1
98
+
99
+ optimizer = textgrad_mutation_optimizer.TextualGradientOptimizer(
100
+ target_score=args.target_score,
101
+ max_iterations=args.max_iterations,
102
+ )
103
+ initial_code = args.prompt or (
104
+ "import { test, expect } from '@playwright/test';\n"
105
+ "test('demo test', async ({ page }) => {\n"
106
+ " expect(1).toBe(1);\n"
107
+ "});"
108
+ )
109
+ success, optimized_code, history = optimizer.optimize_assertions(initial_code)
110
+ if args.json:
111
+ payload = {
112
+ "success": success,
113
+ "optimized_code": optimized_code,
114
+ "history": history,
115
+ }
116
+ print(json.dumps(payload, indent=2, ensure_ascii=False))
117
+ else:
118
+ print("====================================================================")
119
+ print(" TEXTGRAD MUTATION LOSS OPTIMIZATION RESULTS")
120
+ print("====================================================================")
121
+ print(f"Convergence : {'SUCCESS' if success else 'PARTIAL'}")
122
+ print(f"Iterations : {len(history)}")
123
+ print(f"Optimized Code:\n{optimized_code}")
124
+ print("====================================================================")
125
+ return 0 if success else 1
126
+
127
+
128
+ def run_eval_cmd(args: argparse.Namespace) -> int:
129
+ """Evaluates assertion snippet against QA DoD metric."""
130
+ if not dspy_qa_signatures:
131
+ print("Error: dspy_qa_signatures engine not available.", file=sys.stderr)
132
+ return 1
133
+
134
+ class _MockPred:
135
+ def __init__(self, code: str):
136
+ self.test_script_code = code
137
+ self.page_class_code = "export class Page { async doAction() {} }"
138
+
139
+ code_to_eval = args.code or (
140
+ "import { test, expect } from '@playwright/test';\n"
141
+ "test('demo', async ({ page }) => {\n"
142
+ " expect(true).toBe(true);\n"
143
+ "});"
144
+ )
145
+ score = dspy_qa_signatures.qa_dod_metric(None, _MockPred(code_to_eval))
146
+ print(f"DoD Metric Score: {score:.2f} (Passed: {score >= 0.8})")
147
+ return 0 if score >= 0.8 else 1
148
+
149
+
150
+ def main() -> int:
151
+ parser = argparse.ArgumentParser(
152
+ description="Unified Assertion Optimization & Tuning Suite (DSPy v2, MIPROv2 & TextGrad)"
153
+ )
154
+ subparsers = parser.add_subparsers(dest="subcommand", help="Available subcommands")
155
+
156
+ # Signatures
157
+ sub_sig = subparsers.add_parser("signatures", help="Inspect or compile declarative QA DSPy signatures")
158
+ sub_sig.set_defaults(func=run_signatures_cmd)
159
+
160
+ # Tune
161
+ sub_tune = subparsers.add_parser("tune", help="Run MIPROv2 Bayesian instruction & few-shot search")
162
+ sub_tune.add_argument("--trials", type=int, default=10, help="Number of search trials")
163
+ sub_tune.add_argument("--json", action="store_true", help="Output JSON")
164
+ sub_tune.set_defaults(func=run_tune_cmd)
165
+
166
+ # Gradient
167
+ sub_grad = subparsers.add_parser("gradient", help="Compute textual gradients from surviving mutants")
168
+ sub_grad.add_argument("--prompt", type=str, default="", help="Initial assertion prompt")
169
+ sub_grad.add_argument("--target-score", type=float, default=80.0, help="Target mutation score (default: 80.0)")
170
+ sub_grad.add_argument("--max-iterations", type=int, default=3, help="Max gradient steps")
171
+ sub_grad.add_argument("--json", action="store_true", help="Output JSON")
172
+ sub_grad.set_defaults(func=run_gradient_cmd)
173
+
174
+ # Eval
175
+ sub_eval = subparsers.add_parser("eval", help="Evaluate code snippet against DoD metric")
176
+ sub_eval.add_argument("--code", type=str, default="", help="Code snippet to evaluate")
177
+ sub_eval.set_defaults(func=run_eval_cmd)
178
+
179
+ args = parser.parse_args()
180
+ if not hasattr(args, "func") or not args.subcommand:
181
+ parser.print_help()
182
+ return 0
183
+
184
+ return args.func(args)
185
+
186
+
187
+ if __name__ == "__main__":
188
+ sys.exit(main())
@@ -49,7 +49,18 @@ CANONICAL_AUTHOR_SIGS = {
49
49
  CANONICAL_AUTHOR_SIG = "6c56b5f2c2d6f4e4b82cf4d1fa6ccd4a5e8cf0cb0e15a4a60136965fe8ebb697"
50
50
 
51
51
  SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
52
- DEFAULT_REPO_ROOT = os.path.dirname(SCRIPT_DIR)
52
+
53
+
54
+ def _find_repo_root() -> str:
55
+ curr = SCRIPT_DIR
56
+ while curr and curr != os.path.dirname(curr):
57
+ if os.path.isfile(os.path.join(curr, "LICENSE")) or os.path.isfile(os.path.join(curr, "package.json")):
58
+ return curr
59
+ curr = os.path.dirname(curr)
60
+ return os.path.dirname(os.path.dirname(os.path.dirname(SCRIPT_DIR)))
61
+
62
+
63
+ DEFAULT_REPO_ROOT = _find_repo_root()
53
64
 
54
65
 
55
66
  def get_canonical_watermark() -> str:
@@ -511,7 +511,7 @@ def format_markdown_report(bench: Dict[str, Any]) -> str:
511
511
  "",
512
512
  "## Track 2: Empirical Reference Suites Benchmark (Static Workspace Inspection)",
513
513
  "",
514
- "> *Methodology: Dynamically enumerates all 14 rules and 56 skills in repository without static per-skill multiplier assumptions.*",
514
+ "> *Methodology: Dynamically enumerates all 14 rules and 57 skills in repository without static per-skill multiplier assumptions.*",
515
515
  "> *Disclosure: 'Avoided Disk Read (I/O)' measures filesystem file size bytes not read from storage; it is strictly distinguished from context tokens and is not billed token savings.*",
516
516
  "",
517
517
  "| Reference Project | Detected Stack | Confidence | Catalog Summary Saved | Full Hydration Saved | Avoided Disk Read (I/O) |",
@@ -13,7 +13,7 @@
13
13
  (function () {
14
14
  'use strict';
15
15
 
16
- if (window.__qa && window.__qa.__version === '4.4.0') {
16
+ if (window.__qa && window.__qa.__version === '4.4.1') {
17
17
  return window.__qa;
18
18
  }
19
19
 
@@ -47,7 +47,7 @@
47
47
  }
48
48
 
49
49
  const qa = {
50
- __version: '4.4.0',
50
+ __version: '4.4.1',
51
51
 
52
52
  /**
53
53
  * 1. Smart Action Batching
@@ -0,0 +1,107 @@
1
+ {
2
+ "category": "API & Contract Testing",
3
+ "total_tools": 6,
4
+ "tools": [
5
+ {
6
+ "file": "tools/api_drift_sentinel.py",
7
+ "command": "python tools/api_drift_sentinel.py",
8
+ "category": "API & Contract Testing",
9
+ "owner_role": "api-engineer",
10
+ "status": "stable",
11
+ "risk_level": "read_only",
12
+ "inputs": [
13
+ "--spec",
14
+ "--actual-payload",
15
+ "--fail-on-drift"
16
+ ],
17
+ "outputs": [
18
+ "Schema drift analysis report"
19
+ ],
20
+ "description": "Detects contract drift and breaking schema mutations against OpenAPI specifications."
21
+ },
22
+ {
23
+ "file": "tools/export_postman_collection.py",
24
+ "command": "python tools/export_postman_collection.py",
25
+ "category": "API & Contract Testing",
26
+ "owner_role": "api-engineer",
27
+ "status": "stable",
28
+ "risk_level": "read_only",
29
+ "inputs": [
30
+ "--matrix",
31
+ "--output"
32
+ ],
33
+ "outputs": [
34
+ "Postman Collection v2.1.0 (.json)"
35
+ ],
36
+ "description": "Exports API test matrices into runnable Postman Collections with pre-request scripts."
37
+ },
38
+ {
39
+ "file": "tools/generate_api_matrix.py",
40
+ "command": "python tools/generate_api_matrix.py",
41
+ "category": "API & Contract Testing",
42
+ "owner_role": "api-engineer",
43
+ "status": "stable",
44
+ "risk_level": "read_only",
45
+ "inputs": [
46
+ "--spec",
47
+ "--output",
48
+ "--include-boundary"
49
+ ],
50
+ "outputs": [
51
+ "E2E API test matrix (.md / .json)"
52
+ ],
53
+ "description": "Converts OpenAPI/Swagger specs into automated positive, boundary, and negative test matrices."
54
+ },
55
+ {
56
+ "file": "tools/network_mock_shield.py",
57
+ "command": "python tools/network_mock_shield.py",
58
+ "category": "API & Contract Testing",
59
+ "owner_role": "api-engineer",
60
+ "status": "stable",
61
+ "risk_level": "modifying",
62
+ "inputs": [
63
+ "--route",
64
+ "--status",
65
+ "--body",
66
+ "--delay-ms"
67
+ ],
68
+ "outputs": [
69
+ "Stubbed HTTP/GraphQL response mocks"
70
+ ],
71
+ "description": "Network interception shield stubbing external routes and injecting chaos network faults."
72
+ },
73
+ {
74
+ "file": "tools/newman_analyzer.py",
75
+ "command": "python tools/newman_analyzer.py",
76
+ "category": "API & Contract Testing",
77
+ "owner_role": "api-engineer",
78
+ "status": "stable",
79
+ "risk_level": "read_only",
80
+ "inputs": [
81
+ "newman_report.json",
82
+ "--sla-p95",
83
+ "--max-failures"
84
+ ],
85
+ "outputs": [
86
+ "API execution metrics & CI/CD SLA quality gate status"
87
+ ],
88
+ "description": "Sub-0.1s Postman/Newman JSON test report analyzer enforcing CI/CD quality gates."
89
+ },
90
+ {
91
+ "file": "tools/traffic_session_converter.py",
92
+ "command": "python tools/traffic_session_converter.py",
93
+ "category": "API & Contract Testing",
94
+ "owner_role": "api-engineer",
95
+ "status": "stable",
96
+ "risk_level": "read_only",
97
+ "inputs": [
98
+ "--har",
99
+ "--output"
100
+ ],
101
+ "outputs": [
102
+ "Executable API test scripts"
103
+ ],
104
+ "description": "Converts recorded HAR traffic sessions into executable API automation test cases."
105
+ }
106
+ ]
107
+ }