@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.
- package/.agents/agents/api-engineer.md +67 -0
- package/.agents/agents/failure-analyst.md +75 -0
- package/.agents/agents/live-explorer.md +70 -0
- package/.agents/agents/orchestrator.md +104 -0
- package/.agents/agents/perf-engineer.md +74 -0
- package/.agents/agents/pom-crafter.md +112 -0
- package/.agents/agents/quality-gatekeeper.md +87 -0
- package/.agents/agents/test-designer.md +73 -0
- package/.agents/agents/test-runner.md +67 -0
- package/.agents/rules/author-integrity-guard.md +33 -0
- package/.agents/rules/communication-style.md +18 -0
- package/.agents/rules/context-engineering.md +37 -0
- package/.agents/rules/git-push-protocol.md +33 -0
- package/.agents/rules/graphify.md +14 -0
- package/.agents/rules/lessons-learned.md +25 -0
- package/.agents/rules/mandatory-playwright-live.md +25 -0
- package/.agents/rules/mobile_appium_rules.md +43 -0
- package/.agents/rules/performance_testing_rules.md +35 -0
- package/.agents/rules/skill-precedence.md +29 -0
- package/.agents/rules/systematic-debugging.md +36 -0
- package/.agents/skills/actor-qa-swarm/SKILL.md +77 -0
- package/.agents/skills/actor-qa-swarm/examples/broker_sharding_sample.json +12 -0
- package/.agents/skills/agent-orchestration-multi-agent-optimize/SKILL.md +88 -0
- package/.agents/skills/agent-orchestration-multi-agent-optimize/examples/swarm_workload_config.json +15 -0
- package/.agents/skills/agentless-qa-repair/SKILL.md +69 -0
- package/.agents/skills/agentless-qa-repair/examples/healing_report_sample.json +17 -0
- package/.agents/skills/agentless-qa-repair/examples/three_phase_repair_workflow.md +40 -0
- package/.agents/skills/antigravity-test-sentinel/SKILL.md +63 -0
- package/.agents/skills/antigravity-test-sentinel/examples/dod_gate_policy.json +11 -0
- package/.agents/skills/antigravity-test-sentinel/examples/sprint_dod_enforcement.md +47 -0
- package/.agents/skills/api-network-mocking-interception/SKILL.md +142 -0
- package/.agents/skills/api-network-mocking-interception/examples/network_route_stub.json +9 -0
- package/.agents/skills/api-spec-to-e2e-matrix/SKILL.md +80 -0
- package/.agents/skills/api-spec-to-e2e-matrix/examples/sample_openapi.json +19 -0
- package/.agents/skills/architecture-decision-records/SKILL.md +64 -0
- package/.agents/skills/architecture-decision-records/examples/0001-record-architecture-decisions.md +12 -0
- package/.agents/skills/auth-session-and-cookie-manager/SKILL.md +75 -0
- package/.agents/skills/auth-session-and-cookie-manager/examples/multi_role_auth_matrix.md +70 -0
- package/.agents/skills/auth-session-and-cookie-manager/examples/storage_state_sample.json +11 -0
- package/.agents/skills/backend-load-and-stress-patterns/SKILL.md +85 -0
- package/.agents/skills/backend-load-and-stress-patterns/examples/k6_load_test_sample.js +13 -0
- package/.agents/skills/backend-load-and-stress-patterns/references/k6_load_template.js +82 -0
- package/.agents/skills/bats-testing-patterns/SKILL.md +100 -0
- package/.agents/skills/bats-testing-patterns/examples/cli_runner_test.bats +6 -0
- package/.agents/skills/bats-testing-patterns/resources/implementation-playbook.md +614 -0
- package/.agents/skills/clean-pom-crafter/SKILL.md +110 -0
- package/.agents/skills/clean-pom-crafter/examples/standard_test_case.groovy +28 -0
- package/.agents/skills/clean-pom-crafter/references/pom_patterns.groovy +138 -0
- package/.agents/skills/code-refactoring-refactor-clean/SKILL.md +64 -0
- package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_page_sample.groovy +9 -0
- package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_playwright_pom.ts +52 -0
- package/.agents/skills/code-refactoring-refactor-clean/resources/implementation-playbook.md +881 -0
- package/.agents/skills/consumer-driven-contract-testing/SKILL.md +147 -0
- package/.agents/skills/consumer-driven-contract-testing/examples/order_service_pact.json +45 -0
- package/.agents/skills/db-state-verifier-and-seeder/SKILL.md +123 -0
- package/.agents/skills/db-state-verifier-and-seeder/examples/db_fixture_seed.json +12 -0
- package/.agents/skills/e2e-testing-patterns/SKILL.md +103 -0
- package/.agents/skills/e2e-testing-patterns/examples/playwright_sharded_config.ts +12 -0
- package/.agents/skills/e2e-testing-patterns/resources/implementation-playbook.md +522 -0
- package/.agents/skills/event-stream-qa-orchestrator/SKILL.md +79 -0
- package/.agents/skills/event-stream-qa-orchestrator/examples/timeline_sample.jsonl +2 -0
- package/.agents/skills/failure-autopsy-and-healing/SKILL.md +66 -0
- package/.agents/skills/failure-autopsy-and-healing/examples/closed_loop_healing_walkthrough.md +48 -0
- package/.agents/skills/failure-autopsy-and-healing/examples/sample_junit_failure.xml +8 -0
- package/.agents/skills/failure-autopsy-and-healing/references/healing_matrix.md +64 -0
- package/.agents/skills/failure-autopsy-and-healing/references/qa_investigation_protocol.md +56 -0
- package/.agents/skills/failure-autopsy-and-healing/scripts/triage_failures.sh +83 -0
- package/.agents/skills/file-and-report-validator/SKILL.md +90 -0
- package/.agents/skills/file-and-report-validator/examples/sample_export_schema.json +14 -0
- package/.agents/skills/flaky-test-sentinel-and-quarantine/SKILL.md +114 -0
- package/.agents/skills/flaky-test-sentinel-and-quarantine/examples/quarantine_registry.json +11 -0
- package/.agents/skills/gherkin-to-suite/SKILL.md +103 -0
- package/.agents/skills/gherkin-to-suite/examples/checkout.feature +39 -0
- package/.agents/skills/gherkin-to-suite/examples/suite_report_sample.json +334 -0
- package/.agents/skills/github-actions-templates/SKILL.md +77 -0
- package/.agents/skills/github-actions-templates/examples/matrix_test_pipeline.yml +8 -0
- package/.agents/skills/graphify-impact-analyzer/SKILL.md +76 -0
- package/.agents/skills/graphify-impact-analyzer/examples/dependency_blast_radius.json +8 -0
- package/.agents/skills/katalon-cli-runner/SKILL.md +76 -0
- package/.agents/skills/katalon-cli-runner/examples/headless_kre_exec.sh +3 -0
- package/.agents/skills/katalon-cli-runner/references/groovy-patterns.md +209 -0
- package/.agents/skills/katalon-cli-runner/references/katalon-api.md +155 -0
- package/.agents/skills/katalon-cli-runner/references/runner_commands.md +67 -0
- package/.agents/skills/lam-script-generator/SKILL.md +123 -0
- package/.agents/skills/lam-script-generator/examples/user_story_sample.md +8 -0
- package/.agents/skills/lean-code-ladder/SKILL.md +94 -0
- package/.agents/skills/lean-code-ladder/examples/ladder_walkthrough.md +37 -0
- package/.agents/skills/lean-impact-scoreboard/SKILL.md +48 -0
- package/.agents/skills/lean-impact-scoreboard/examples/sample_benchmark_gain.md +20 -0
- package/.agents/skills/lean-impact-scoreboard/examples/sample_scoreboard.md +15 -0
- package/.agents/skills/meta-prompt-crafter/SKILL.md +107 -0
- package/.agents/skills/meta-prompt-crafter/examples/qa_prompt_template.md +35 -0
- package/.agents/skills/mipro-prompt-compiler/SKILL.md +59 -0
- package/.agents/skills/mipro-prompt-compiler/examples/compiled_module_sample.json +22 -0
- package/.agents/skills/mipro-prompt-compiler/examples/dspy_assertion_optimizer_case.md +46 -0
- package/.agents/skills/mobile-appium-som/SKILL.md +88 -0
- package/.agents/skills/mobile-appium-som/examples/BaseScreen.java +88 -0
- package/.agents/skills/mobile-appium-som/examples/LoginScreen.java +46 -0
- package/.agents/skills/mobile-appium-som/examples/TC_MobileLogin.java +43 -0
- package/.agents/skills/persistent-planning-files/SKILL.md +108 -0
- package/.agents/skills/persistent-planning-files/examples/task_plan_example.md +56 -0
- package/.agents/skills/playwright-live-interaction/SKILL.md +131 -0
- package/.agents/skills/playwright-live-interaction/examples/live_probe_script.js +5 -0
- package/.agents/skills/playwright-live-interaction/references/advanced_superpowers.md +160 -0
- package/.agents/skills/playwright-live-interaction/references/compact_accessibility_snapshots.md +75 -0
- package/.agents/skills/playwright-live-interaction/references/recipes.md +388 -0
- package/.agents/skills/playwright-live-interaction/references/swarm_orchestration.md +134 -0
- package/.agents/skills/playwright-webapp-testing/SKILL.md +93 -0
- package/.agents/skills/playwright-webapp-testing/examples/server_lifecycle_playwright.py +63 -0
- package/.agents/skills/qa-aci-interface/SKILL.md +67 -0
- package/.agents/skills/qa-aci-interface/examples/surgical_code_window_walkthrough.md +40 -0
- package/.agents/skills/qa-aci-interface/examples/surgical_edit_sample.json +12 -0
- package/.agents/skills/qa-memory-os/SKILL.md +80 -0
- package/.agents/skills/qa-memory-os/examples/archival_memory_sample.json +21 -0
- package/.agents/skills/rbt-manual-testing/SKILL.md +137 -0
- package/.agents/skills/rbt-manual-testing/examples/checkout_rbt_manual_suite.md +25 -0
- package/.agents/skills/rbt-manual-testing/references/field_validation_checklist.md +29 -0
- package/.agents/skills/repo-quality-audit/SKILL.md +68 -0
- package/.agents/skills/repo-quality-audit/examples/sample_audit_walkthrough.md +15 -0
- package/.agents/skills/repo-quality-audit/examples/sample_repo_audit.md +33 -0
- package/.agents/skills/review-spec/SKILL.md +60 -0
- package/.agents/skills/review-spec/examples/pocock_grilling_decision_rubric.md +40 -0
- package/.agents/skills/review-spec/examples/sample_spec_review.md +33 -0
- package/.agents/skills/security-dast-sentinel/SKILL.md +119 -0
- package/.agents/skills/security-dast-sentinel/examples/dast_scan_config.json +10 -0
- package/.agents/skills/security-dast-sentinel/references/AI-AND-LLM.md +113 -0
- package/.agents/skills/security-dast-sentinel/references/ATTACK-CLASSES.md +89 -0
- package/.agents/skills/security-dast-sentinel/references/dast_recipes.ts +33 -0
- package/.agents/skills/self-healing-locator/SKILL.md +86 -0
- package/.agents/skills/self-healing-locator/examples/aom_diff_sample.json +16 -0
- package/.agents/skills/senior-code-review/SKILL.md +108 -0
- package/.agents/skills/senior-code-review/examples/sample_review_walkthrough.md +29 -0
- package/.agents/skills/skillspector-security-guard/SKILL.md +57 -0
- package/.agents/skills/skillspector-security-guard/examples/audit_threat_vectors_report.json +35 -0
- package/.agents/skills/skillspector-security-guard/examples/safe_mcp_config.json +12 -0
- package/.agents/skills/surgical-coding-principles/SKILL.md +89 -0
- package/.agents/skills/surgical-coding-principles/examples/surgical_vs_scope_creep.md +46 -0
- package/.agents/skills/synthetic-test-data-generator/SKILL.md +135 -0
- package/.agents/skills/synthetic-test-data-generator/examples/idempotent_data_recipe.json +9 -0
- package/.agents/skills/systematic-debugging/SKILL.md +100 -0
- package/.agents/skills/systematic-debugging/examples/four_phase_case.md +44 -0
- package/.agents/skills/technical-debt-harvester/SKILL.md +70 -0
- package/.agents/skills/technical-debt-harvester/examples/sample_debt_ledger.md +25 -0
- package/.agents/skills/technical-debt-harvester/examples/sample_ledger_output.md +20 -0
- package/.agents/skills/test-driven-development/SKILL.md +114 -0
- package/.agents/skills/test-driven-development/examples/red_green_refactor_qa.md +78 -0
- package/.agents/skills/token-and-context-optimizer/SKILL.md +70 -0
- package/.agents/skills/token-and-context-optimizer/examples/distilled_log_sample.txt +3 -0
- package/.agents/skills/token-and-context-optimizer/references/context_engineering_guide.md +49 -0
- package/.agents/skills/tot-exploratory-testing/SKILL.md +59 -0
- package/.agents/skills/tot-exploratory-testing/examples/payment_gateway_tot_tree.json +62 -0
- package/.agents/skills/tot-exploratory-testing/examples/tot_graph_sample.json +35 -0
- package/.agents/skills/verification-before-completion/SKILL.md +100 -0
- package/.agents/skills/verification-before-completion/examples/evidence_log_example.md +46 -0
- package/.agents/skills/visual-regression-sentinel/SKILL.md +82 -0
- package/.agents/skills/visual-regression-sentinel/examples/visual_mask_rules.json +9 -0
- package/.agents/skills/wcag-audit-patterns/SKILL.md +77 -0
- package/.agents/skills/wcag-audit-patterns/examples/wcag_compliance_checklist.json +10 -0
- package/.agents/skills/wcag-audit-patterns/resources/implementation-playbook.md +541 -0
- package/.agents/skills/web-agent-gym-benchmarking/SKILL.md +62 -0
- package/.agents/skills/web-agent-gym-benchmarking/examples/benchmark_report_sample.json +22 -0
- package/.agents/skills/web-agent-gym-benchmarking/examples/enterprise_tasks_suite.json +38 -0
- package/.agents/skills/web-vitals-and-performance-profiler/SKILL.md +65 -0
- package/.agents/skills/web-vitals-and-performance-profiler/examples/cwv_budget_policy.json +6 -0
- package/.agents/skills/web-vitals-and-performance-profiler/examples/playwright_cwv_profiler_fixture.ts +118 -0
- package/.agents/templates/completion_report.md +57 -0
- package/.agents/workflows/analyze_requirement_document.md +18 -0
- package/.agents/workflows/export_testcases_excel.md +32 -0
- package/.agents/workflows/generate_combinatorial_test_data.md +28 -0
- package/.agents/workflows/generate_cross_module_test_plan.md +37 -0
- package/.agents/workflows/generate_manual_testcases_rbt.md +56 -0
- package/.agents/workflows/generate_requirements_from_website.md +25 -0
- package/.agents/workflows/generate_testcases_from_requirements.md +21 -0
- package/.agents/workflows/graphify.md +10 -0
- package/.agents/workflows/test-impact.md +15 -0
- package/.agents/workflows/verify.md +34 -0
- package/.cursor/rules/agents.mdc +16 -0
- package/.cursor/rules/language.mdc +7 -0
- package/.cursor/rules/synapse-qa.mdc +24 -0
- package/.cursorrules +27 -0
- package/.dockerignore +53 -0
- package/.pre-commit-hooks.yaml +14 -0
- package/.windsurfrules +26 -0
- package/AGENTS.md +86 -0
- package/CLAUDE.md +54 -0
- package/Dockerfile +81 -0
- package/LICENSE +52 -0
- package/NOTICE +264 -0
- package/README.en.md +171 -0
- package/README.md +170 -2
- package/action.yml +51 -0
- package/agentskills.json +16 -0
- package/bin/agent-qa.js +138 -0
- package/docker-compose.yml +74 -0
- package/docs/ARCHITECTURE.en.md +198 -0
- package/docs/ARCHITECTURE.md +199 -0
- package/docs/CI_CD_INTEGRATION.en.md +170 -0
- package/docs/CI_CD_INTEGRATION.md +170 -0
- package/docs/CLI_REFERENCE.en.md +174 -0
- package/docs/CLI_REFERENCE.md +176 -0
- package/docs/CONTRIBUTING.en.md +49 -0
- package/docs/CONTRIBUTING.md +49 -0
- package/docs/PERFORMANCE_AUDIT_REPORT.md +783 -0
- package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +127 -0
- package/docs/QUALITY_GATES.en.md +118 -0
- package/docs/QUALITY_GATES.md +118 -0
- package/docs/TOKEN_QUOTA_PLAYBOOK.md +41 -0
- package/docs/TOOL_CATALOG.md +129 -0
- package/docs/adopted-ecosystem-tools.md +96 -0
- package/docs/research/EXTERNAL_AGENT_SKILLS_SURVEY.md +1062 -0
- package/docs/research/agent_skill_training_analysis.md +1358 -0
- package/docs/schemas/synapse.config.schema.json +86 -0
- package/package.json +94 -4
- package/plugin.json +31 -0
- package/scripts/generate_skill_examples.py +244 -0
- package/scripts/install.ps1 +112 -0
- package/scripts/install_global_plugin.ps1 +94 -0
- package/scripts/install_global_plugin.sh +49 -0
- package/scripts/lint_skills.ps1 +57 -0
- package/scripts/package_dist.py +337 -0
- package/scripts/setup.sh +59 -0
- package/scripts/update_hub.ps1 +19 -0
- package/scripts/update_hub.sh +15 -0
- package/skills_manifest.json +854 -0
- package/synapse.config.json +31 -0
- package/templates/PROJECT_AI_GUIDE_TEMPLATE.md +111 -0
- package/templates/PROJECT_STATE_TEMPLATE.md +20 -0
- package/templates/ai_bridges/CLAUDE.md +54 -0
- package/templates/ai_bridges/copilot-instructions.md +20 -0
- package/templates/ai_bridges/cursor_synapse_qa.mdc +24 -0
- package/templates/ai_bridges/windsurfrules +26 -0
- package/templates/ci/github-actions-synapse.yml +95 -0
- package/templates/ci/gitlab-ci-synapse.yml +16 -0
- package/templates/ui/index.html +1069 -0
- package/templates/welcome.html.tmpl +2074 -0
- package/tools/.infer_baseline.json +30 -0
- package/tools/TOOLS_RUNBOOK.md +1553 -0
- package/tools/TOOL_CATALOG.json +1769 -0
- package/tools/__init__.py +43 -0
- package/tools/_openapi_parser.py +158 -0
- package/tools/agent_canary.py +525 -0
- package/tools/agentless_patcher.py +417 -0
- package/tools/analyze_project.py +262 -0
- package/tools/api_drift_sentinel.py +208 -0
- package/tools/api_fuzzer.py +762 -0
- package/tools/author_integrity.py +190 -0
- package/tools/auto_heal.py +271 -0
- package/tools/auto_heal_reflexion.py +532 -0
- package/tools/autogen_qa_broker.py +844 -0
- package/tools/benchmark_swarm_context.py +394 -0
- package/tools/browser_helpers.js +746 -0
- package/tools/browsergym_eval.py +236 -0
- package/tools/bug_reporter.py +252 -0
- package/tools/bump_version.py +423 -0
- package/tools/cache_resolver.py +1214 -0
- package/tools/check_env.py +426 -0
- package/tools/check_version_sync.py +256 -0
- package/tools/ci_healing_hook.py +126 -0
- package/tools/cli.py +1598 -0
- package/tools/config_decoupler.py +253 -0
- package/tools/contract_validator.py +141 -0
- package/tools/core/__init__.py +70 -0
- package/tools/core/adapters.py +431 -0
- package/tools/core/circuit_breaker.py +263 -0
- package/tools/core/cli_runtime.py +66 -0
- package/tools/core/file_lock.py +159 -0
- package/tools/core/i18n.py +394 -0
- package/tools/core/memory_bus.py +905 -0
- package/tools/core/process_supervisor.py +332 -0
- package/tools/core/telemetry.py +329 -0
- package/tools/count_tokens.py +1267 -0
- package/tools/create_mock_docx.py +104 -0
- package/tools/dashboard_generator.py +2403 -0
- package/tools/db_sandbox.py +675 -0
- package/tools/debt_harvester.py +237 -0
- package/tools/distill_log.py +161 -0
- package/tools/dspy_qa_signatures.py +356 -0
- package/tools/e2e_flow_prober.py +132 -0
- package/tools/export_postman_collection.py +945 -0
- package/tools/flaky_detector.py +389 -0
- package/tools/fsm_enforcer.py +450 -0
- package/tools/fsm_middleware.py +401 -0
- package/tools/fuzz_payloads.py +197 -0
- package/tools/generate_allure_report.py +88 -0
- package/tools/generate_api_matrix.py +193 -0
- package/tools/generate_jmx_plan.py +1322 -0
- package/tools/generate_sbom.py +252 -0
- package/tools/generate_tc_from_story.py +203 -0
- package/tools/generate_test_reports.py +133 -0
- package/tools/generate_tool_catalog.py +482 -0
- package/tools/gherkin_suite.py +758 -0
- package/tools/git_pre_commit_guard.py +298 -0
- package/tools/goldfish_review.py +366 -0
- package/tools/heal/__init__.py +28 -0
- package/tools/heal_pr_automator.py +220 -0
- package/tools/heuristic_locator_matcher.py +351 -0
- package/tools/hub_publisher.py +623 -0
- package/tools/humanize_linter.py +438 -0
- package/tools/infer_linter.py +977 -0
- package/tools/init_config.py +306 -0
- package/tools/interview_story.py +116 -0
- package/tools/jira_sync.py +566 -0
- package/tools/jtl_analyzer.py +474 -0
- package/tools/lint/__init__.py +30 -0
- package/tools/lint_ai_docs.py +374 -0
- package/tools/lookup_tc.py +165 -0
- package/tools/lookup_xpath.py +167 -0
- package/tools/matrix_sharder.py +148 -0
- package/tools/mcp/__init__.py +18 -0
- package/tools/mcp_docx_server.ps1 +13 -0
- package/tools/mcp_docx_server.py +851 -0
- package/tools/mcp_excel_server.ps1 +13 -0
- package/tools/mcp_excel_server.py +441 -0
- package/tools/mcp_server.py +725 -0
- package/tools/md_to_xlsx.py +327 -0
- package/tools/micro_mutator.py +887 -0
- package/tools/mipro_assertion_tuner.py +210 -0
- package/tools/network_mock_shield.py +311 -0
- package/tools/newman_analyzer.py +384 -0
- package/tools/omni_emitter.py +579 -0
- package/tools/omni_parser.py +450 -0
- package/tools/omni_transpiler.py +168 -0
- package/tools/openxml_guard.py +438 -0
- package/tools/output_formatter.py +182 -0
- package/tools/package_release.py +325 -0
- package/tools/perf/__init__.py +24 -0
- package/tools/pinpoint_failure.py +190 -0
- package/tools/project_state.py +171 -0
- package/tools/qa_event_stream.py +358 -0
- package/tools/repo_map.py +346 -0
- package/tools/report/__init__.py +32 -0
- package/tools/reversible_sandbox.py +344 -0
- package/tools/safety_firewall.py +437 -0
- package/tools/security_coverage_ledger.py +538 -0
- package/tools/security_scanner.py +229 -0
- package/tools/senior_code_review.py +393 -0
- package/tools/setup_project.py +770 -0
- package/tools/skill_collision_guard.py +304 -0
- package/tools/skill_profiles.py +217 -0
- package/tools/skill_vault.py +481 -0
- package/tools/skillspector.py +1278 -0
- package/tools/smart_visual_masker.py +132 -0
- package/tools/spec_drift_sentinel.py +438 -0
- package/tools/swe_qa_aci.py +369 -0
- package/tools/synapse_observer.py +485 -0
- package/tools/synapse_qa_bench.py +190 -0
- package/tools/sync_agent_rules.py +274 -0
- package/tools/telemetry_correlator.py +397 -0
- package/tools/template_excel_exporter.py +514 -0
- package/tools/templates/jmeter-distributed/README.md +54 -0
- package/tools/templates/jmeter-distributed/docker-compose.yml +83 -0
- package/tools/test_impact.py +419 -0
- package/tools/test_memory_os.py +462 -0
- package/tools/textgrad_mutation_optimizer.py +237 -0
- package/tools/tms_sync_bridge.py +834 -0
- package/tools/tot_exploratory_tester.py +239 -0
- package/tools/trace_data_flow.py +240 -0
- package/tools/traffic_session_converter.py +256 -0
- package/tools/trend_analytics.py +314 -0
- package/tools/ui_server.py +401 -0
- package/tools/universal_ir.py +488 -0
- package/tools/update_sentinel.py +383 -0
- package/tools/validate_groovy_scripts.py +173 -0
- package/tools/verify_all.py +1271 -0
- package/tools/visual_diff_canvas.py +143 -0
- package/tools/visual_som_helper.py +550 -0
- package/tools/watch_mode.py +308 -0
- package/tools/wcag_audit.py +239 -0
- 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())
|