@teevee98/synapse-hub 0.0.0-stage → 3.8.3

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 +171 -0
  190. package/README.md +170 -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 +198 -0
  196. package/docs/ARCHITECTURE.md +199 -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 +174 -0
  200. package/docs/CLI_REFERENCE.md +176 -0
  201. package/docs/CONTRIBUTING.en.md +49 -0
  202. package/docs/CONTRIBUTING.md +49 -0
  203. package/docs/PERFORMANCE_AUDIT_REPORT.md +783 -0
  204. package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +127 -0
  205. package/docs/QUALITY_GATES.en.md +118 -0
  206. package/docs/QUALITY_GATES.md +118 -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 +1358 -0
  212. package/docs/schemas/synapse.config.schema.json +86 -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 +31 -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 +2074 -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 +262 -0
  244. package/tools/api_drift_sentinel.py +208 -0
  245. package/tools/api_fuzzer.py +762 -0
  246. package/tools/author_integrity.py +190 -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 +2403 -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 +306 -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 +725 -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 +1271 -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,481 @@
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
+ SkillVault Lifelong Page Object Model & Interaction Library (MineDojo / Voyager Pattern)
8
+ ---------------------------------------------------------------------------------------
9
+ Adapts Voyager's self-evolving SkillManager into a persistent SQLite store (.synapse/skill_vault.db).
10
+ When pom-crafter authors new test cases, it queries SkillVault to retrieve existing, verified
11
+ Page Class methods and business interaction primitives, preventing redundant locator generation.
12
+
13
+ Reference:
14
+ - Guanzhi Wang et al. (Voyager: An Open-Ended Embodied Agent with Large Language Models).
15
+ - Synapse-Hub Subsystem 1: Section 6.2 of agent_skill_training_analysis.md.
16
+ """
17
+
18
+ import os
19
+ import sys
20
+ import sqlite3
21
+ import json
22
+ import re
23
+ import difflib
24
+ import argparse
25
+ import ast
26
+ from dataclasses import dataclass
27
+ from typing import List, Optional, Dict, Any, Set
28
+
29
+ # Enforce UTF-8 stdout encoding for Windows console compatibility
30
+ if hasattr(sys.stdout, 'reconfigure'):
31
+ try:
32
+ sys.stdout.reconfigure(encoding='utf-8')
33
+ sys.stderr.reconfigure(encoding='utf-8')
34
+ except Exception:
35
+ pass
36
+
37
+
38
+ # Domain synonym ontology for enterprise QA & UI interactions (Offline Fuzzy Semantic Matching)
39
+ QA_SYNONYMS: Dict[str, Set[str]] = {
40
+ "auth": {"login", "signin", "sign-in", "authenticate", "sso", "session", "credential", "token", "password", "user", "oauth"},
41
+ "login": {"auth", "signin", "sign-in", "authenticate", "sso", "session", "credential"},
42
+ "table": {"grid", "datatable", "datagrid", "row", "cell", "column", "pagination", "paging", "list", "tbody"},
43
+ "grid": {"table", "datatable", "datagrid", "row", "cell", "column", "pagination"},
44
+ "pagination": {"paging", "page", "pager", "next-page", "previous", "pagination", "table"},
45
+ "approve": {"accept", "confirm", "reconcile", "verify", "validate", "signoff", "approval", "pass"},
46
+ "modal": {"dialog", "popup", "overlay", "backdrop", "drawer", "alert", "window"},
47
+ "dialog": {"modal", "popup", "overlay", "backdrop", "window"},
48
+ "navigate": {"goto", "route", "url", "visit", "open", "link", "redirect"},
49
+ "button": {"btn", "click", "press", "submit", "action", "trigger"},
50
+ "input": {"textbox", "fill", "type", "enter", "field", "value", "text"},
51
+ "dropdown": {"select", "combobox", "option", "menu", "picker", "choice"},
52
+ "invoice": {"billing", "order", "receipt", "payment", "charge", "reconcile"},
53
+ "cart": {"checkout", "basket", "purchase", "item", "order"},
54
+ "upload": {"attachment", "file", "import", "choose-file", "document", "dropzone"},
55
+ "export": {"export", "download", "csv", "excel", "pdf", "report"},
56
+ "toast": {"toast", "notification", "snackbar", "alert", "message", "banner", "popup"},
57
+ "spinner": {"spinner", "loader", "loading", "shimmer", "skeleton", "progress", "wait"},
58
+ "drawer": {"drawer", "sidebar", "panel", "modal", "aside", "sheet"},
59
+ "tab": {"tab", "tabs", "tabpanel", "nav", "segment"},
60
+ "wait": {"detach", "detached", "sleep", "loading", "spinner", "ready", "networkidle", "smartwait"},
61
+ }
62
+
63
+
64
+ def split_identifier(identifier: str) -> List[str]:
65
+ """Splits camelCase, PascalCase, and snake_case tokens into lowercase sub-tokens."""
66
+ tokens = re.sub(r'([A-Z]+)', r' \1', identifier).split()
67
+ sub_tokens = []
68
+ for t in tokens:
69
+ sub_tokens.extend(re.split(r'[_\\-]+', t))
70
+ return [t.lower() for t in sub_tokens if len(t) >= 2]
71
+
72
+
73
+ def _expand_tokens_with_synonyms(tokens: List[str]) -> Set[str]:
74
+ """Expands query tokens using the QA domain synonym clusters."""
75
+ expanded = set(tokens)
76
+ for t in tokens:
77
+ if t in QA_SYNONYMS:
78
+ expanded.update(QA_SYNONYMS[t])
79
+ for syn_key, cluster in QA_SYNONYMS.items():
80
+ if t in cluster:
81
+ expanded.add(syn_key)
82
+ expanded.update(cluster)
83
+ return expanded
84
+
85
+
86
+ def _calculate_token_match_score(q_token: str, target_tokens: List[str]) -> float:
87
+ """Computes best match score for a single query token against target corpus tokens."""
88
+ best = 0.0
89
+ for target in target_tokens:
90
+ if q_token == target:
91
+ return 1.0
92
+ if q_token in target or target in q_token:
93
+ best = max(best, 0.8)
94
+ continue
95
+ # Synonym check
96
+ if q_token in QA_SYNONYMS and target in QA_SYNONYMS[q_token]:
97
+ best = max(best, 0.85)
98
+ continue
99
+ # Fuzzy morphological / typo similarity via SequenceMatcher
100
+ ratio = difflib.SequenceMatcher(None, q_token, target).ratio()
101
+ if ratio >= 0.75:
102
+ best = max(best, ratio * 0.8)
103
+ return best
104
+
105
+
106
+ @dataclass
107
+ class PageClassPrimitive:
108
+ skill_id: str # e.g., "SKILL_AUTH_LOGIN_SSO"
109
+ page_class: str # e.g., "LoginPage"
110
+ method_signature: str # e.g., "loginWithSSO(username: str, sso_token: str)"
111
+ method_code: str # Complete executable method body
112
+ locator_tier: int # 1 to 6 (Master Locator Hierarchy)
113
+ semantic_docstring: str # Generated docstring for embedding / retrieval
114
+ verified_on_url: str # Target AUT URL verified against
115
+ mutation_score: float # Verified assertion sensitivity score (>= 80%)
116
+ tags: str = "" # Comma-separated domain tags, e.g. "auth,sso,login"
117
+
118
+
119
+ class ManagedConnection(sqlite3.Connection):
120
+ """SQLite connection that automatically commits/rollbacks and closes on context exit."""
121
+ def __exit__(self, exc_type, exc_val, exc_tb):
122
+ try:
123
+ super().__exit__(exc_type, exc_val, exc_tb)
124
+ finally:
125
+ self.close()
126
+
127
+
128
+ class SkillVault:
129
+ """Persistent library of verified, self-contained Page Class methods."""
130
+
131
+ def __init__(self, db_path: Optional[str] = None):
132
+ if db_path is None:
133
+ # Anchor to .synapse in workspace or CWD
134
+ base_dir = os.path.join(os.getcwd(), ".synapse")
135
+ os.makedirs(base_dir, exist_ok=True)
136
+ db_path = os.path.join(base_dir, "skill_vault.db")
137
+ self.db_path = db_path
138
+ self._init_schema()
139
+
140
+ def _get_connection(self) -> ManagedConnection:
141
+ conn = sqlite3.connect(self.db_path, timeout=30.0, factory=ManagedConnection)
142
+ conn.row_factory = sqlite3.Row
143
+ try:
144
+ conn.execute("PRAGMA journal_mode=WAL;")
145
+ conn.execute("PRAGMA synchronous=NORMAL;")
146
+ conn.execute("PRAGMA busy_timeout=30000;")
147
+ except sqlite3.Error as err:
148
+ sys.stderr.write(f"Notice: SQLite PRAGMA configuration skipped: {err}\n")
149
+ return conn
150
+
151
+ def _init_schema(self):
152
+ with self._get_connection() as conn:
153
+ conn.execute("""
154
+ CREATE TABLE IF NOT EXISTS page_primitives (
155
+ skill_id TEXT PRIMARY KEY,
156
+ page_class TEXT NOT NULL,
157
+ method_signature TEXT NOT NULL,
158
+ method_code TEXT NOT NULL,
159
+ locator_tier INTEGER DEFAULT 1,
160
+ semantic_docstring TEXT,
161
+ verified_on_url TEXT,
162
+ mutation_score REAL DEFAULT 0.0,
163
+ tags TEXT DEFAULT '',
164
+ created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
165
+ );
166
+ """)
167
+ conn.execute("CREATE INDEX IF NOT EXISTS idx_page_class ON page_primitives(page_class);")
168
+ conn.execute("CREATE INDEX IF NOT EXISTS idx_method_sig ON page_primitives(method_signature);")
169
+ # Auto-migrate: check if tags column exists
170
+ try:
171
+ cursor = conn.execute("PRAGMA table_info(page_primitives)")
172
+ cols = [row["name"] for row in cursor.fetchall()]
173
+ if "tags" not in cols:
174
+ conn.execute("ALTER TABLE page_primitives ADD COLUMN tags TEXT DEFAULT '';")
175
+ except Exception as e:
176
+ # Column check non-fatal during migration
177
+ sys.stderr.write(f"Notice: table migration skipped: {e}\n")
178
+
179
+ def register_primitive(self, primitive: PageClassPrimitive) -> bool:
180
+ """Persists a verified Page Class primitive."""
181
+ try:
182
+ with self._get_connection() as conn:
183
+ conn.execute("""
184
+ INSERT OR REPLACE INTO page_primitives (
185
+ skill_id, page_class, method_signature, method_code,
186
+ locator_tier, semantic_docstring, verified_on_url, mutation_score, tags
187
+ ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?);
188
+ """, (
189
+ primitive.skill_id,
190
+ primitive.page_class,
191
+ primitive.method_signature,
192
+ primitive.method_code,
193
+ primitive.locator_tier,
194
+ primitive.semantic_docstring,
195
+ primitive.verified_on_url,
196
+ primitive.mutation_score,
197
+ primitive.tags
198
+ ))
199
+ return True
200
+ except sqlite3.Error as e:
201
+ sys.stderr.write(f"SkillVault Error: {e}\n")
202
+ return False
203
+
204
+ def query_primitives(self, query: str, top_k: int = 5, tag: Optional[str] = None, min_score: float = 0.15) -> List[Dict[str, Any]]:
205
+ """
206
+ Queries verified primitives using intelligent fuzzy semantic matching:
207
+ combines exact tokens, synonym expansion, n-gram substring match, and SequenceMatcher similarity.
208
+ """
209
+ words = re.findall(r'[a-zA-Z0-9_-]+', query)
210
+ raw_tokens = []
211
+ for w in words:
212
+ sub = split_identifier(w)
213
+ raw_tokens.extend(sub if sub else [w.lower()])
214
+ raw_tokens = list(dict.fromkeys(raw_tokens))
215
+
216
+ if not raw_tokens and not tag:
217
+ return self.list_primitives(limit=top_k)
218
+
219
+ expanded_tokens = _expand_tokens_with_synonyms(raw_tokens) if raw_tokens else set()
220
+
221
+ with self._get_connection() as conn:
222
+ if tag:
223
+ rows = conn.execute("SELECT * FROM page_primitives WHERE tags LIKE ?", (f"%{tag}%",)).fetchall()
224
+ else:
225
+ rows = conn.execute("SELECT * FROM page_primitives").fetchall()
226
+
227
+ if not raw_tokens:
228
+ return [dict(r) for r in rows[:top_k]]
229
+
230
+ scored = []
231
+ for r in rows:
232
+ corpus_text = f"{r['page_class']} {r['method_signature']} {r['semantic_docstring'] or ''} {r['tags'] or ''}".lower()
233
+ corpus_words = re.findall(r'[a-zA-Z0-9_-]+', corpus_text)
234
+ corpus_tokens = []
235
+ for cw in corpus_words:
236
+ sub = split_identifier(cw)
237
+ corpus_tokens.extend(sub if sub else [cw.lower()])
238
+ corpus_tokens = list(dict.fromkeys(corpus_tokens))
239
+
240
+ # Calculate individual query token matches
241
+ token_scores = [_calculate_token_match_score(qt, corpus_tokens) for qt in raw_tokens]
242
+ avg_token_score = sum(token_scores) / len(token_scores) if token_scores else 0.0
243
+
244
+ # Synonym boost
245
+ synonym_hits = sum(1 for st in expanded_tokens if st in corpus_text)
246
+ synonym_factor = min(0.3, (synonym_hits / max(1, len(expanded_tokens))) * 0.3)
247
+
248
+ # Mutation score quality boost (up to +0.1 for high mutation score)
249
+ mut_score = r["mutation_score"] or 0.0
250
+ mutation_boost = (mut_score / 100.0) * 0.1
251
+
252
+ total_relevance = round(min(1.0, (avg_token_score * 0.7) + synonym_factor + mutation_boost), 4)
253
+
254
+ # Pass if relevance reaches threshold OR direct substring match exists
255
+ if total_relevance >= min_score or any(qt in corpus_text for qt in raw_tokens):
256
+ item = dict(r)
257
+ item["relevance_score"] = total_relevance
258
+ item["relevance_percentage"] = f"{round(total_relevance * 100, 1)}%"
259
+ scored.append(item)
260
+
261
+ scored.sort(key=lambda x: (x["relevance_score"], x["mutation_score"]), reverse=True)
262
+ return scored[:top_k]
263
+
264
+ def harvest_page_classes(self, dir_path: str) -> int:
265
+ """
266
+ Scans a directory for Page Classes across TS, JS, Python, and Groovy,
267
+ extracts method signatures, and registers them into SkillVault.
268
+ """
269
+ if not os.path.isdir(dir_path):
270
+ return 0
271
+ count = 0
272
+ for root, _, files in os.walk(dir_path):
273
+ for f in files:
274
+ ext = os.path.splitext(f)[1].lower()
275
+ if ext not in (".py", ".ts", ".js", ".groovy", ".java"):
276
+ continue
277
+ file_path = os.path.join(root, f)
278
+ try:
279
+ with open(file_path, "r", encoding="utf-8", errors="ignore") as fp:
280
+ content = fp.read()
281
+ except OSError:
282
+ continue
283
+
284
+ page_class = os.path.splitext(f)[0]
285
+ extracted_methods = []
286
+
287
+ # AST Parser for Python Page Classes
288
+ if ext == ".py":
289
+ try:
290
+ tree = ast.parse(content, filename=file_path)
291
+ for node in ast.walk(tree):
292
+ if isinstance(node, ast.ClassDef):
293
+ cls_name = node.name
294
+ for item in node.body:
295
+ if isinstance(item, (ast.FunctionDef, ast.AsyncFunctionDef)):
296
+ m_name = item.name
297
+ if m_name.startswith("_") or m_name in ("constructor", "constructor__"):
298
+ continue
299
+ args_list = [a.arg for a in item.args.args if a.arg != "self"]
300
+ sig = f"{m_name}({', '.join(args_list)})"
301
+ doc = ast.get_docstring(item) or f"Page method for {m_name} on {cls_name}"
302
+ tags = ",".join(split_identifier(cls_name) + split_identifier(m_name))
303
+ extracted_methods.append((cls_name, m_name, sig, doc, tags))
304
+ except SyntaxError:
305
+ extracted_methods = []
306
+
307
+ # Polyglot fallback (TS/JS/Groovy/Java) or when AST is empty
308
+ if not extracted_methods:
309
+ method_matches = re.finditer(r'(?:def\s+([a-zA-Z_]\w*)\s*\(([^)]*)\)|(?:async\s+)?([a-zA-Z_]\w*)\s*\(([^)]*)\)\s*(?::\s*[^\{]+)?\s*\{)', content)
310
+ for mm in method_matches:
311
+ m_name = mm.group(1) or mm.group(3)
312
+ m_args = mm.group(2) if mm.group(1) else mm.group(4)
313
+ if not m_name or m_name.startswith("_") or m_name in ("constructor", "constructor__"):
314
+ continue
315
+ sig = f"{m_name}({m_args.strip() if m_args else ''})"
316
+ doc_m = re.search(rf'{re.escape(m_name)}[^\n]*\n\s*[\'\""""/]+([^\'\""""\n*]+)', content)
317
+ doc = doc_m.group(1).strip() if doc_m else f"Page method for {m_name} on {page_class}"
318
+ tags = ",".join(split_identifier(page_class) + split_identifier(m_name))
319
+ extracted_methods.append((page_class, m_name, sig, doc, tags))
320
+
321
+ for p_cls, m_name, sig, doc, tags in extracted_methods:
322
+ skill_id = f"SKILL_{p_cls.upper()}_{m_name.upper()}"
323
+ prim = PageClassPrimitive(
324
+ skill_id=skill_id,
325
+ page_class=p_cls,
326
+ method_signature=sig,
327
+ method_code=f"// Harvested from {f}\n{sig}",
328
+ locator_tier=1,
329
+ semantic_docstring=doc,
330
+ verified_on_url=f"local://{f}",
331
+ mutation_score=85.0,
332
+ tags=tags
333
+ )
334
+ if self.register_primitive(prim):
335
+ count += 1
336
+ return count
337
+
338
+ def list_primitives(self, limit: int = 50) -> List[Dict[str, Any]]:
339
+ with self._get_connection() as conn:
340
+ rows = conn.execute("SELECT * FROM page_primitives ORDER BY created_at DESC LIMIT ?", (limit,)).fetchall()
341
+ return [dict(r) for r in rows]
342
+
343
+ def get_primitive(self, skill_id: str) -> Optional[Dict[str, Any]]:
344
+ """Retrieves a single verified primitive by its unique skill_id."""
345
+ with self._get_connection() as conn:
346
+ row = conn.execute("SELECT * FROM page_primitives WHERE skill_id = ?", (skill_id,)).fetchone()
347
+ return dict(row) if row else None
348
+
349
+ def delete_primitive(self, skill_id: str) -> bool:
350
+ """Deletes a primitive by its skill_id. Returns True if deleted."""
351
+ with self._get_connection() as conn:
352
+ cur = conn.execute("DELETE FROM page_primitives WHERE skill_id = ?", (skill_id,))
353
+ return cur.rowcount > 0
354
+
355
+ def export_vault_json(self) -> str:
356
+ """Exports all stored primitives as a formatted JSON string."""
357
+ primitives = self.list_primitives(limit=1000)
358
+ return json.dumps({"count": len(primitives), "primitives": primitives}, indent=2)
359
+
360
+
361
+ def main():
362
+ parser = argparse.ArgumentParser(description="SkillVault Lifelong POM Library")
363
+ parser.add_argument("--query", default=None, help="Query verified primitives by keyword (fuzzy semantic search)")
364
+ parser.add_argument("--tag", default=None, help="Filter primitives by domain tag (e.g. auth, table, invoice)")
365
+ parser.add_argument("--harvest", default=None, help="Directory path to harvest Page Classes from")
366
+ parser.add_argument("--list", action="store_true", help="List all stored primitives")
367
+ parser.add_argument("--seed-samples", action="store_true", help="Seed initial verified POM primitives")
368
+ args = parser.parse_args()
369
+
370
+ vault = SkillVault()
371
+
372
+ if args.harvest:
373
+ num = vault.harvest_page_classes(args.harvest)
374
+ print(f"✅ Harvested {num} Page Class primitives from '{args.harvest}'.")
375
+ return 0
376
+
377
+ if args.seed_samples:
378
+ samples = [
379
+ PageClassPrimitive(
380
+ skill_id="SKILL_AUTH_LOGIN_SSO",
381
+ page_class="LoginPage",
382
+ method_signature="loginWithSSO(username: str, sso_token: str)",
383
+ method_code="""def loginWithSSO(self, username: str, sso_token: str):
384
+ self.page.goto("/auth/sso")
385
+ self.page.getByRole("textbox", name="SSO User").fill(username)
386
+ self.page.getByRole("textbox", name="Token").fill(sso_token)
387
+ self.page.getByRole("button", name="Authenticate").click()
388
+ self.page.waitForLoadState("networkidle")""",
389
+ locator_tier=1,
390
+ semantic_docstring="Authenticates user through enterprise SSO portal with token and networkidle smart wait.",
391
+ verified_on_url="https://app.enterprise.com/auth/sso",
392
+ mutation_score=92.5,
393
+ tags="auth,login,signin,sso,security"
394
+ ),
395
+ PageClassPrimitive(
396
+ skill_id="SKILL_INVOICE_APPROVE_RECONCILE",
397
+ page_class="InvoicePage",
398
+ method_signature="approveAndReconcileInvoice(invoice_code: str)",
399
+ method_code="""def approveAndReconcileInvoice(self, invoice_code: str):
400
+ self.page.getByRole("row", name=invoice_code).getByRole("button", name="Approve").click()
401
+ self.page.getByRole("button", name="Confirm Approval").click()
402
+ self.page.waitForSelector(".p-component-overlay", state="detached")""",
403
+ locator_tier=1,
404
+ semantic_docstring="Approves and reconciles invoice row item with modal overlay detachment verification.",
405
+ verified_on_url="https://app.enterprise.com/invoices",
406
+ mutation_score=88.0,
407
+ tags="invoice,billing,approve,reconcile,modal"
408
+ ),
409
+ PageClassPrimitive(
410
+ skill_id="SKILL_TABLE_PAGINATION_NAV",
411
+ page_class="DataTableComponent",
412
+ method_signature="navigateToNextPage(expected_min_rows: int = 1)",
413
+ method_code="""def navigateToNextPage(self, expected_min_rows: int = 1):
414
+ next_btn = self.page.getByRole("button", name="Next Page")
415
+ if next_btn.is_enabled():
416
+ next_btn.click()
417
+ self.page.waitForSelector(".loading-shimmer", state="detached")
418
+ rows = self.page.getByRole("row").all()
419
+ assert len(rows) >= expected_min_rows, f"Expected at least {expected_min_rows} rows" """,
420
+ locator_tier=1,
421
+ semantic_docstring="Navigates through paginated grid/table with dynamic shimmer detachment and row count assertion.",
422
+ verified_on_url="https://app.enterprise.com/data-grid",
423
+ mutation_score=90.0,
424
+ tags="table,grid,pagination,paging,navigation"
425
+ ),
426
+ PageClassPrimitive(
427
+ skill_id="SKILL_FORM_MODAL_SUBMIT",
428
+ page_class="UserManagementPage",
429
+ method_signature="fillAndSubmitModalForm(user_data: dict)",
430
+ method_code="""def fillAndSubmitModalForm(self, user_data: dict):
431
+ dialog = self.page.getByRole("dialog")
432
+ dialog.getByRole("textbox", name="Full Name").fill(user_data.get("name", ""))
433
+ dialog.getByRole("textbox", name="Email").fill(user_data.get("email", ""))
434
+ dialog.getByRole("combobox", name="Role").selectOption(user_data.get("role", "Viewer"))
435
+ dialog.getByRole("button", name="Save").click()
436
+ self.page.waitForSelector(".toast-success", state="visible")""",
437
+ locator_tier=1,
438
+ semantic_docstring="Fills interactive modal dialog form and validates submission toast notification.",
439
+ verified_on_url="https://app.enterprise.com/users",
440
+ mutation_score=87.5,
441
+ tags="modal,dialog,form,input,submit"
442
+ ),
443
+ PageClassPrimitive(
444
+ skill_id="SKILL_ATTACHMENT_UPLOAD_VERIFY",
445
+ page_class="DocumentManagementPage",
446
+ method_signature="uploadAttachmentAndVerify(file_path: str, expected_filename: str)",
447
+ method_code="""def uploadAttachmentAndVerify(self, file_path: str, expected_filename: str):
448
+ file_input = self.page.locator("input[type='file']")
449
+ file_input.setInputFiles(file_path)
450
+ self.page.waitForSelector(".upload-progress", state="detached")
451
+ badge = self.page.getByText(expected_filename)
452
+ assert badge.is_visible(), f"Expected uploaded file badge '{expected_filename}' to be visible" """,
453
+ locator_tier=1,
454
+ semantic_docstring="Uploads file attachment, waits for progress bar detachment and asserts filename badge.",
455
+ verified_on_url="https://app.enterprise.com/documents",
456
+ mutation_score=94.0,
457
+ tags="upload,attachment,file,document,verify"
458
+ )
459
+ ]
460
+ for s in samples:
461
+ vault.register_primitive(s)
462
+ print(f"✅ Seeded {len(samples)} verified PageClass primitives into SkillVault.")
463
+ return 0
464
+
465
+ if args.list:
466
+ items = vault.list_primitives()
467
+ print(json.dumps(items, indent=2))
468
+ return 0
469
+
470
+ if args.query or args.tag:
471
+ matches = vault.query_primitives(args.query or "", tag=args.tag)
472
+ print(f"🔍 Found {len(matches)} matching primitives in SkillVault (Fuzzy Semantic Search):")
473
+ print(json.dumps(matches, indent=2))
474
+ return 0
475
+
476
+ print("SkillVault active. Use --query, --tag, --list, or --seed-samples.")
477
+ return 0
478
+
479
+
480
+ if __name__ == "__main__":
481
+ sys.exit(main())