@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,304 @@
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
+ Tier-2 Skill Routing & Collision Guard (Addy Osmani Pattern)
8
+ ------------------------------------------------------------
9
+ Computes pairwise cosine similarity across all SKILL.md descriptions.
10
+ Operates 100% offline with zero LLM tokens using a lightweight suffix-stripping
11
+ stemmer heuristic and TF-IDF word frequency representation.
12
+
13
+ Enforces:
14
+ - Warning when description similarity >= 0.50 (semantic proximity)
15
+ - Critical Error (Quality Gate Failure) when similarity >= 0.75 (ambiguous routing)
16
+
17
+ Usage:
18
+ python tools/skill_collision_guard.py [--dir .agents/skills] [--threshold 0.75] [--json]
19
+ """
20
+
21
+ import os
22
+ import sys
23
+ import re
24
+ import math
25
+ import json
26
+ from typing import Dict, List, Tuple, Any
27
+ import argparse
28
+ from collections import Counter
29
+
30
+ # Enforce UTF-8 stdout encoding for Windows console compatibility
31
+ if hasattr(sys.stdout, 'reconfigure'):
32
+ try:
33
+ sys.stdout.reconfigure(encoding='utf-8')
34
+ sys.stderr.reconfigure(encoding='utf-8')
35
+ except Exception:
36
+ pass
37
+
38
+ STOPWORDS = {
39
+ "a", "about", "above", "after", "again", "against", "all", "am", "an", "and", "any", "are",
40
+ "aren't", "as", "at", "be", "because", "been", "before", "being", "below", "between", "both",
41
+ "but", "by", "can", "cannot", "could", "couldn't", "did", "didn't", "do", "does", "doesn't",
42
+ "doing", "don't", "down", "during", "each", "few", "for", "from", "further", "had", "hadn't",
43
+ "has", "hasn't", "have", "haven't", "having", "he", "her", "here", "hers", "herself", "him",
44
+ "himself", "his", "how", "i", "if", "in", "into", "is", "isn't", "it", "it's", "its", "itself",
45
+ "let's", "me", "more", "most", "mustn't", "my", "myself", "no", "nor", "not", "of", "off", "on",
46
+ "once", "only", "or", "other", "ought", "our", "ours", "ourselves", "out", "over", "own", "same",
47
+ "shan't", "she", "should", "shouldn't", "so", "some", "such", "than", "that", "the", "their",
48
+ "theirs", "them", "themselves", "then", "there", "these", "they", "this", "those", "through",
49
+ "to", "too", "under", "until", "up", "very", "was", "wasn't", "we", "were", "weren't", "what",
50
+ "when", "where", "which", "while", "who", "whom", "why", "with", "won't", "would", "wouldn't",
51
+ "you", "your", "yours", "yourself", "yourselves", "use", "when", "allows", "provides", "designed"
52
+ }
53
+
54
+
55
+ def strip_suffix(word: str) -> str:
56
+ """Lightweight suffix-stripping heuristic (Addy Osmani Tier-2 standard)."""
57
+ if len(word) <= 4:
58
+ return word
59
+ for suffix in ("ing", "tion", "ment", "ness", "able", "ible", "ize", "ise", "ies", "es", "ed", "ly", "al", "s"):
60
+ if word.endswith(suffix) and len(word) - len(suffix) >= 3:
61
+ return word[:-len(suffix)]
62
+ return word
63
+
64
+
65
+ def tokenize(text: str) -> List[str]:
66
+ """Tokenizes text, strips punctuation, removes stopwords and applies suffix stripping."""
67
+ words = re.findall(r"\b[a-zA-Z0-9_\-]+\b", text.lower())
68
+ tokens = []
69
+ for w in words:
70
+ cleaned = re.sub(r"^[^a-zA-Z0-9]+|[^a-zA-Z0-9]+$", "", w)
71
+ if len(cleaned) >= 2 and cleaned not in STOPWORDS:
72
+ tokens.append(strip_suffix(cleaned))
73
+ return tokens
74
+
75
+
76
+ def build_tf_vector(tokens: List[str]) -> Dict[str, float]:
77
+ """Builds normalized term-frequency vector."""
78
+ counts = Counter(tokens)
79
+ total = len(tokens)
80
+ if total == 0:
81
+ return {}
82
+ return {word: count / total for word, count in counts.items()}
83
+
84
+
85
+ def cosine_similarity(vec1: Dict[str, float], vec2: Dict[str, float]) -> float:
86
+ """Computes cosine similarity between two term-frequency vectors."""
87
+ intersection = set(vec1.keys()) & set(vec2.keys())
88
+ numerator = sum(vec1[x] * vec2[x] for x in intersection)
89
+ sum1 = sum(v ** 2 for v in vec1.values())
90
+ sum2 = sum(v ** 2 for v in vec2.values())
91
+ denominator = math.sqrt(sum1) * math.sqrt(sum2)
92
+ if not denominator:
93
+ return 0.0
94
+ return float(numerator) / denominator
95
+
96
+
97
+ class SkillCollisionGuard:
98
+ """Audits skill descriptions across repository for routing collisions and ambiguous triggers."""
99
+
100
+ def __init__(self, skills_dir: str = ".agents/skills", threshold: float = 0.75, warn_threshold: float = 0.50):
101
+ self.skills_dir = skills_dir
102
+ self.threshold = threshold
103
+ self.warn_threshold = warn_threshold
104
+
105
+ def load_descriptions(self) -> Dict[str, str]:
106
+ """Loads all SKILL.md files and extracts their description strings."""
107
+ descriptions = {}
108
+ if not os.path.exists(self.skills_dir):
109
+ return descriptions
110
+
111
+ for root, _, files in os.walk(self.skills_dir):
112
+ for file in files:
113
+ if file.lower() == "skill.md":
114
+ full_path = os.path.join(root, file)
115
+ skill_name, desc = self._extract_frontmatter(full_path)
116
+ if skill_name and desc:
117
+ descriptions[skill_name] = desc
118
+ return descriptions
119
+
120
+ def load_rules(self, rules_dir: str = ".agents/rules") -> Dict[str, str]:
121
+ """Loads all markdown rule files from rules_dir and extracts their text content."""
122
+ rules = {}
123
+ if not os.path.exists(rules_dir):
124
+ return rules
125
+ for f in os.listdir(rules_dir):
126
+ if f.endswith(".md"):
127
+ full_path = os.path.join(rules_dir, f)
128
+ try:
129
+ with open(full_path, "r", encoding="utf-8", errors="ignore") as fp:
130
+ content = fp.read()
131
+ rules[f] = content
132
+ except OSError as err:
133
+ _ = err
134
+ return rules
135
+
136
+ def audit_rules(self, rules_dir: str = ".agents/rules") -> Tuple[bool, List[Dict[str, Any]]]:
137
+ """Computes pairwise similarity across all rule files."""
138
+ rules = self.load_rules(rules_dir)
139
+ names = sorted(list(rules.keys()))
140
+ vectors = {name: build_tf_vector(tokenize(rules[name])) for name in names}
141
+ findings = []
142
+ has_critical = False
143
+ for i in range(len(names)):
144
+ for j in range(i + 1, len(names)):
145
+ name_a = names[i]
146
+ name_b = names[j]
147
+ sim = cosine_similarity(vectors[name_a], vectors[name_b])
148
+ if sim >= self.threshold:
149
+ has_critical = True
150
+ findings.append({
151
+ "level": "CRITICAL",
152
+ "rule_a": name_a,
153
+ "rule_b": name_b,
154
+ "similarity": round(sim, 3),
155
+ "message": f"Critical Rule Collision: '{name_a}' and '{name_b}' have cosine similarity {sim:.3f} >= {self.threshold}"
156
+ })
157
+ elif sim >= self.warn_threshold:
158
+ findings.append({
159
+ "level": "WARNING",
160
+ "rule_a": name_a,
161
+ "rule_b": name_b,
162
+ "similarity": round(sim, 3),
163
+ "message": f"Rule Proximity Warning: '{name_a}' and '{name_b}' have similarity {sim:.3f} >= {self.warn_threshold}"
164
+ })
165
+ return (not has_critical), findings
166
+
167
+ def _extract_frontmatter(self, path: str) -> Tuple[str, str]:
168
+ try:
169
+ with open(path, "r", encoding="utf-8", errors="ignore") as f:
170
+ content = f.read()
171
+ except OSError:
172
+ return "", ""
173
+
174
+ match = re.search(r"^---\s*\n(.*?)\n---", content, re.DOTALL)
175
+ if match:
176
+ fm = match.group(1)
177
+ name_m = re.search(r"^name:\s*(.+)$", fm, re.MULTILINE)
178
+ desc_m = re.search(r"^description:\s*[\"']?(.*?)[\"']?$", fm, re.MULTILINE)
179
+ name = name_m.group(1).strip() if name_m else os.path.basename(os.path.dirname(path))
180
+ desc = desc_m.group(1).strip() if desc_m else ""
181
+ return name, desc
182
+
183
+ fallback_name = os.path.basename(os.path.dirname(path))
184
+ return fallback_name, ""
185
+
186
+ def audit(self) -> Tuple[bool, List[Dict[str, Any]]]:
187
+ """
188
+ Computes pairwise similarity.
189
+ Returns (is_clean, report_items).
190
+ """
191
+ descriptions = self.load_descriptions()
192
+ names = sorted(list(descriptions.keys()))
193
+ vectors = {name: build_tf_vector(tokenize(descriptions[name])) for name in names}
194
+
195
+ findings = []
196
+ has_critical = False
197
+
198
+ for i in range(len(names)):
199
+ for j in range(i + 1, len(names)):
200
+ name_a = names[i]
201
+ name_b = names[j]
202
+ sim = cosine_similarity(vectors[name_a], vectors[name_b])
203
+
204
+ if sim >= self.threshold:
205
+ has_critical = True
206
+ findings.append({
207
+ "level": "CRITICAL",
208
+ "skill_a": name_a,
209
+ "skill_b": name_b,
210
+ "similarity": round(sim, 3),
211
+ "message": f"Critical Collision: '{name_a}' and '{name_b}' have cosine similarity {sim:.3f} >= {self.threshold}"
212
+ })
213
+ elif sim >= self.warn_threshold:
214
+ findings.append({
215
+ "level": "WARNING",
216
+ "skill_a": name_a,
217
+ "skill_b": name_b,
218
+ "similarity": round(sim, 3),
219
+ "message": f"Proximity Warning: '{name_a}' and '{name_b}' have similarity {sim:.3f} >= {self.warn_threshold}"
220
+ })
221
+
222
+ return (not has_critical), findings
223
+
224
+
225
+ def run_guard(
226
+ skills_dir: str = ".agents/skills",
227
+ threshold: float = 0.75,
228
+ warn_threshold: float = 0.50,
229
+ output_json: bool = False,
230
+ scan_rules: bool = False,
231
+ rules_dir: str = ".agents/rules"
232
+ ) -> int:
233
+ guard = SkillCollisionGuard(skills_dir, threshold=threshold, warn_threshold=warn_threshold)
234
+ passed, findings = guard.audit()
235
+
236
+ if scan_rules:
237
+ r_passed, r_findings = guard.audit_rules(rules_dir=rules_dir)
238
+ findings.extend(r_findings)
239
+ passed = passed and r_passed
240
+
241
+ if output_json:
242
+ print(json.dumps({
243
+ "skills_dir": skills_dir,
244
+ "rules_dir": rules_dir if scan_rules else None,
245
+ "scan_rules": scan_rules,
246
+ "passed": passed,
247
+ "threshold": threshold,
248
+ "warn_threshold": warn_threshold,
249
+ "findings": findings
250
+ }, indent=2))
251
+ return 0 if passed else 1
252
+
253
+ print("\n" + "=" * 70)
254
+ print(" TIER-2 SKILL ROUTING & COLLISION GUARD (ADDY OSMANI PATTERN)")
255
+ print("=" * 70)
256
+ print(f"Skills Directory : {skills_dir}")
257
+ if scan_rules:
258
+ print(f"Rules Directory : {rules_dir} (Audited for rule-to-rule collision)")
259
+ print(f"Collision Threshold: {threshold} (FAIL) | Warning Threshold: {warn_threshold} (WARN)")
260
+
261
+ criticals = [f for f in findings if f["level"] == "CRITICAL"]
262
+ warnings = [f for f in findings if f["level"] == "WARNING"]
263
+
264
+ if warnings:
265
+ print(f"\n⚠️ {len(warnings)} Near-Neighbor Warnings detected (similarity >= {warn_threshold}):")
266
+ for w in warnings:
267
+ print(f" - {w['message']}")
268
+
269
+ if criticals:
270
+ print(f"\n❌ {len(criticals)} CRITICAL COLLISION(S) detected (similarity >= {threshold}):")
271
+ for c in criticals:
272
+ print(f" [FAIL] {c['message']}")
273
+ print("\n[DoD BLOCKED] High similarity causes routing ambiguity and context contamination.")
274
+ print("=" * 70 + "\n")
275
+ return 1
276
+
277
+ target_str = "All skill descriptions and rule files" if scan_rules else "All skill descriptions"
278
+ print(f"\n✅ [PASS] 0 routing collisions detected. {target_str} uniquely segmented.\n")
279
+ print("=" * 70 + "\n")
280
+ return 0
281
+
282
+
283
+ def main():
284
+ parser = argparse.ArgumentParser(description="Tier-2 Skill Routing & Collision Guard")
285
+ parser.add_argument("--dir", default=".agents/skills", help="Directory containing skill packages")
286
+ parser.add_argument("--threshold", type=float, default=0.75, help="Critical similarity threshold (default: 0.75)")
287
+ parser.add_argument("--warn-threshold", type=float, default=0.50, help="Warning similarity threshold (default: 0.50)")
288
+ parser.add_argument("--scan-rules", action="store_true", help="Also audit .agents/rules markdown files for collision")
289
+ parser.add_argument("--rules-dir", default=".agents/rules", help="Directory containing rule files")
290
+ parser.add_argument("--json", action="store_true", help="Output results in JSON format")
291
+ args = parser.parse_args()
292
+
293
+ return run_guard(
294
+ skills_dir=args.dir,
295
+ threshold=args.threshold,
296
+ warn_threshold=args.warn_threshold,
297
+ output_json=args.json,
298
+ scan_rules=args.scan_rules,
299
+ rules_dir=args.rules_dir
300
+ )
301
+
302
+
303
+ if __name__ == "__main__":
304
+ sys.exit(main())
@@ -0,0 +1,217 @@
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/skill_profiles.py — Skill Catalog Capability Profile Manager
8
+
9
+ Provides filtering, listing, and inspection of the 53 standardized AI Agent skills
10
+ partitioned across the 4 core capability profiles:
11
+ 1. core-web-qa (Web E2E, POM, Playwright, live probing, locators, visual regression)
12
+ 2. perf-and-load (JMeter, k6, Locust, backend load, CWV, APM telemetry)
13
+ 3. api-security (OpenAPI, CDC Pact, DAST sentinel, network mocking, fuzzing)
14
+ 4. enterprise-rbt (AI-RBT manual testing, Gherkin, risk matrices, 12-column Excel suites, WCAG, a11y)
15
+
16
+ Usage:
17
+ python3 tools/skill_profiles.py --list-profiles
18
+ python3 tools/skill_profiles.py --profile core-web-qa
19
+ python3 tools/skill_profiles.py --profile perf-and-load --format json
20
+ python3 tools/skill_profiles.py --query "playwright"
21
+ """
22
+
23
+ import os
24
+ import sys
25
+ import json
26
+ import argparse
27
+ from typing import Dict, Any, List, Optional
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
+ REPO_ROOT = os.path.abspath(os.path.join(os.path.dirname(__file__), ".."))
38
+ DEFAULT_MANIFEST = os.path.join(REPO_ROOT, "skills_manifest.json")
39
+
40
+
41
+ def load_manifest(manifest_path: Optional[str] = None) -> Dict[str, Any]:
42
+ """Loads and validates skills_manifest.json."""
43
+ path = manifest_path or DEFAULT_MANIFEST
44
+ if not os.path.isfile(path):
45
+ raise FileNotFoundError(f"Skills manifest not found: {path}")
46
+ with open(path, "r", encoding="utf-8") as f:
47
+ return json.load(f)
48
+
49
+
50
+ def list_profiles(manifest: Optional[Dict[str, Any]] = None) -> Dict[str, Dict[str, Any]]:
51
+ """Returns available profiles with metadata and resolved skill count."""
52
+ mf = manifest or load_manifest()
53
+ profiles_raw = mf.get("profiles", {})
54
+ all_skills = mf.get("skills", [])
55
+ total_count = len(all_skills)
56
+
57
+ result = {}
58
+ for key, pdata in profiles_raw.items():
59
+ skills_val = pdata.get("skills", [])
60
+ if skills_val == "all":
61
+ skill_list = [s.get("id") for s in all_skills]
62
+ elif isinstance(skills_val, list):
63
+ skill_list = list(skills_val)
64
+ else:
65
+ skill_list = []
66
+
67
+ result[key] = {
68
+ "key": key,
69
+ "name": pdata.get("name", key),
70
+ "description": pdata.get("description", ""),
71
+ "skill_count": len(skill_list),
72
+ "skills": skill_list
73
+ }
74
+ return result
75
+
76
+
77
+ def get_profile(profile_key: str, manifest: Optional[Dict[str, Any]] = None) -> Optional[Dict[str, Any]]:
78
+ """Returns a specific capability profile by key."""
79
+ profiles = list_profiles(manifest)
80
+ normalized = profile_key.strip().lower()
81
+ return profiles.get(normalized)
82
+
83
+
84
+ def filter_skills(
85
+ profile_key: Optional[str] = None,
86
+ category: Optional[str] = None,
87
+ query: Optional[str] = None,
88
+ manifest: Optional[Dict[str, Any]] = None
89
+ ) -> List[Dict[str, Any]]:
90
+ """Filters skills by profile key, category, and/or search query."""
91
+ mf = manifest or load_manifest()
92
+ all_skills = mf.get("skills", [])
93
+
94
+ # Profile filtering
95
+ allowed_ids = None
96
+ if profile_key:
97
+ prof = get_profile(profile_key, mf)
98
+ if prof is None:
99
+ available = ", ".join(list_profiles(mf).keys())
100
+ raise ValueError(f"Unknown profile '{profile_key}'. Available profiles: {available}")
101
+ allowed_ids = set(prof["skills"])
102
+
103
+ matched = []
104
+ q_lower = query.strip().lower() if query else None
105
+ cat_lower = category.strip().lower() if category else None
106
+
107
+ for skill in all_skills:
108
+ sid = skill.get("id", "")
109
+ if allowed_ids is not None and sid not in allowed_ids:
110
+ continue
111
+
112
+ if cat_lower and skill.get("category", "").lower() != cat_lower:
113
+ continue
114
+
115
+ if q_lower:
116
+ s_name = skill.get("name", "").lower()
117
+ s_summary = skill.get("summary", "").lower()
118
+ s_desc = skill.get("description", "").lower()
119
+ if q_lower not in sid.lower() and q_lower not in s_name and q_lower not in s_summary and q_lower not in s_desc:
120
+ continue
121
+
122
+ matched.append(skill)
123
+
124
+ return matched
125
+
126
+
127
+ def format_profiles_text(profiles: Dict[str, Dict[str, Any]]) -> str:
128
+ """Formats profiles dictionary into a clean CLI table."""
129
+ lines = [
130
+ "==========================================================================================",
131
+ " SYNAPSE HUB — 4 CORE CAPABILITY PROFILES & CATALOG MODULES ",
132
+ "==========================================================================================",
133
+ f"{'KEY':<18} {'NAME':<36} {'SKILLS':<8} {'DESCRIPTION'}",
134
+ "-" * 90
135
+ ]
136
+ core_keys = ["core-web-qa", "perf-and-load", "api-security", "enterprise-rbt"]
137
+ # Print core 4 first, then others
138
+ ordered_keys = [k for k in core_keys if k in profiles] + [k for k in profiles if k not in core_keys]
139
+
140
+ for key in ordered_keys:
141
+ p = profiles[key]
142
+ desc = p["description"]
143
+ if len(desc) > 55:
144
+ desc = desc[:52] + "..."
145
+ lines.append(f"{p['key']:<18} {p['name']:<36} {p['skill_count']:<8} {desc}")
146
+ lines.append("=" * 90)
147
+ lines.append("💡 Tip: Use 'agent-qa skills --profile <key>' to view skills in a specific profile.")
148
+ return "\n".join(lines)
149
+
150
+
151
+ def format_skills_text(skills: List[Dict[str, Any]], profile_key: Optional[str] = None) -> str:
152
+ """Formats a list of skills into a clean CLI table."""
153
+ header_title = f"SKILLS IN PROFILE: {profile_key.upper()}" if profile_key else "STANDARDIZED AI AGENT SKILLS"
154
+ lines = [
155
+ "==========================================================================================",
156
+ f" {header_title} (Total: {len(skills)})",
157
+ "==========================================================================================",
158
+ f"{'ID':<36} {'CATEGORY':<28} {'SUMMARY'}",
159
+ "-" * 90
160
+ ]
161
+ for s in sorted(skills, key=lambda x: x.get("id", "")):
162
+ sid = s.get("id", "")
163
+ cat = s.get("category", "")
164
+ summary = s.get("summary", "")
165
+ if len(summary) > 65:
166
+ summary = summary[:62] + "..."
167
+ lines.append(f"{sid:<36} {cat:<28} {summary}")
168
+ lines.append("=" * 90)
169
+ return "\n".join(lines)
170
+
171
+
172
+ def main() -> int:
173
+ parser = argparse.ArgumentParser(description="Synapse Hub AI Agent Skill Capability Profile Manager")
174
+ parser.add_argument("--profile", "-p", help="Filter skills by capability profile (e.g. core-web-qa, perf-and-load, api-security, enterprise-rbt)")
175
+ parser.add_argument("--list-profiles", "-l", action="store_true", help="List all available capability profiles")
176
+ parser.add_argument("--category", "-c", help="Filter skills by category")
177
+ parser.add_argument("--query", "-q", help="Search skills by keyword")
178
+ parser.add_argument("--format", choices=["text", "json"], default="text", help="Output format (default: text)")
179
+ parser.add_argument("--manifest", help="Optional path to skills_manifest.json", default=DEFAULT_MANIFEST)
180
+
181
+ args = parser.parse_args()
182
+
183
+ try:
184
+ manifest = load_manifest(args.manifest)
185
+ except Exception as e:
186
+ print(f"Error loading manifest: {e}", file=sys.stderr)
187
+ return 1
188
+
189
+ if args.list_profiles or (not args.profile and not args.category and not args.query):
190
+ profiles = list_profiles(manifest)
191
+ if args.format == "json":
192
+ print(json.dumps(profiles, indent=2, ensure_ascii=False))
193
+ else:
194
+ print(format_profiles_text(profiles))
195
+ return 0
196
+
197
+ try:
198
+ skills = filter_skills(
199
+ profile_key=args.profile,
200
+ category=args.category,
201
+ query=args.query,
202
+ manifest=manifest
203
+ )
204
+ except ValueError as e:
205
+ print(f"Error: {e}", file=sys.stderr)
206
+ return 1
207
+
208
+ if args.format == "json":
209
+ print(json.dumps(skills, indent=2, ensure_ascii=False))
210
+ else:
211
+ print(format_skills_text(skills, profile_key=args.profile))
212
+
213
+ return 0
214
+
215
+
216
+ if __name__ == "__main__":
217
+ sys.exit(main())