@teevee98/synapse-hub 0.0.0-stage → 3.8.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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 +172 -0
- package/README.md +171 -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 +197 -0
- package/docs/ARCHITECTURE.md +198 -0
- package/docs/CI_CD_INTEGRATION.en.md +170 -0
- package/docs/CI_CD_INTEGRATION.md +170 -0
- package/docs/CLI_REFERENCE.en.md +175 -0
- package/docs/CLI_REFERENCE.md +177 -0
- package/docs/CONTRIBUTING.en.md +49 -0
- package/docs/CONTRIBUTING.md +49 -0
- package/docs/PERFORMANCE_AUDIT_REPORT.md +784 -0
- package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +127 -0
- package/docs/QUALITY_GATES.en.md +121 -0
- package/docs/QUALITY_GATES.md +121 -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 +1359 -0
- package/docs/schemas/synapse.config.schema.json +87 -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 +32 -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 +2079 -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 +258 -0
- package/tools/api_drift_sentinel.py +208 -0
- package/tools/api_fuzzer.py +762 -0
- package/tools/author_integrity.py +184 -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 +2419 -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 +307 -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 +724 -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 +1259 -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,482 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
# SPDX-FileCopyrightText: Copyright (c) 2026 Thế Vị (@TeeVee998). All rights reserved.
|
|
3
|
+
# SPDX-License-Identifier: MIT
|
|
4
|
+
# Project: Synapse-Hub (https://github.com/TeeVee998/Synapse-Hub)
|
|
5
|
+
|
|
6
|
+
"""
|
|
7
|
+
tools/generate_tool_catalog.py — Enterprise Tooling Ecosystem Catalog Generator
|
|
8
|
+
--------------------------------------------------------------------------------
|
|
9
|
+
Inventories, classifies, and documents all CLI tools in Synapse Hub:
|
|
10
|
+
- Command invocation & primary executable file
|
|
11
|
+
- Responsible Agent Role (Single Front-Door Orchestrator, Live-Explorer, POM-Crafter, Test-Runner, Failure-Analyst, Quality-Gatekeeper)
|
|
12
|
+
- Functional Category (Quality Gates, Orchestration, Healing, Code Generation, Security, Testing, Release)
|
|
13
|
+
- Maturity Tier: 'stable' (Production ready & tested) vs 'experimental' (Active R&D)
|
|
14
|
+
- Risk Level: 'read_only', 'modifying', 'network', 'destructive'
|
|
15
|
+
- Input arguments, Outputs & artifacts
|
|
16
|
+
|
|
17
|
+
Generates:
|
|
18
|
+
- tools/TOOL_CATALOG.json (Machine-readable manifest)
|
|
19
|
+
- docs/TOOL_CATALOG.md (Human-readable comprehensive runbook)
|
|
20
|
+
"""
|
|
21
|
+
|
|
22
|
+
import os
|
|
23
|
+
import sys
|
|
24
|
+
import json
|
|
25
|
+
import ast
|
|
26
|
+
from datetime import datetime, timezone
|
|
27
|
+
from typing import Dict, Any
|
|
28
|
+
|
|
29
|
+
# Enforce UTF-8 console output
|
|
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
|
+
TOOLS_DIR = os.path.join(REPO_ROOT, "tools")
|
|
39
|
+
|
|
40
|
+
# Well-defined tool metadata overrides & classifications
|
|
41
|
+
TOOL_REGISTRY_METADATA = {
|
|
42
|
+
"verify_all.py": {
|
|
43
|
+
"command": "python tools/verify_all.py",
|
|
44
|
+
"category": "Quality Gates",
|
|
45
|
+
"owner_role": "quality-gatekeeper",
|
|
46
|
+
"status": "stable",
|
|
47
|
+
"risk_level": "read_only",
|
|
48
|
+
"inputs": ["--mode auto|hub|target", "--test-cmd", "--format text|json|junit"],
|
|
49
|
+
"outputs": ["Console report", "Exit code 0/1", "reports/PROJECT_HEALTH_REPORT.md"],
|
|
50
|
+
"description": "One-command 11 Quality Gates Definition of Done (DoD) verification sentinel."
|
|
51
|
+
},
|
|
52
|
+
"hub_publisher.py": {
|
|
53
|
+
"command": "python tools/hub_publisher.py",
|
|
54
|
+
"category": "CI/CD & Packaging",
|
|
55
|
+
"owner_role": "orchestrator",
|
|
56
|
+
"status": "stable",
|
|
57
|
+
"risk_level": "modifying",
|
|
58
|
+
"inputs": ["--message", "--skip-verify", "--dry-run", "--no-wait", "--timeout"],
|
|
59
|
+
"outputs": ["Git main push", "Git tag", "GitHub Release", "NPM publication"],
|
|
60
|
+
"description": "Autonomous 1-click 5-step release pipeline for Synapse Hub."
|
|
61
|
+
},
|
|
62
|
+
"package_release.py": {
|
|
63
|
+
"command": "python tools/package_release.py",
|
|
64
|
+
"category": "CI/CD & Packaging",
|
|
65
|
+
"owner_role": "orchestrator",
|
|
66
|
+
"status": "stable",
|
|
67
|
+
"risk_level": "read_only",
|
|
68
|
+
"inputs": ["--output-dir", "--format zip|tar.gz|both", "--verify-archive"],
|
|
69
|
+
"outputs": ["dist/synapse-hub-vX.Y.Z.zip", "dist/*-checksums.sha256"],
|
|
70
|
+
"description": "Enterprise release packager preserving .github/workflows and generating SHA-256 provenance."
|
|
71
|
+
},
|
|
72
|
+
"fsm_enforcer.py": {
|
|
73
|
+
"command": "python tools/fsm_enforcer.py",
|
|
74
|
+
"category": "Orchestration",
|
|
75
|
+
"owner_role": "orchestrator",
|
|
76
|
+
"status": "stable",
|
|
77
|
+
"risk_level": "modifying",
|
|
78
|
+
"inputs": ["start --session-id", "advance --stage --actor --evidence", "verify-compliance", "status"],
|
|
79
|
+
"outputs": [".agent_memory/fsm_session.json", "Cryptographic HMAC proof tokens"],
|
|
80
|
+
"description": "5-Stage QA Multi-Agent Finite State Machine enforcer with cryptographic proof tokens."
|
|
81
|
+
},
|
|
82
|
+
"micro_mutator.py": {
|
|
83
|
+
"command": "python tools/micro_mutator.py",
|
|
84
|
+
"category": "Quality Gates",
|
|
85
|
+
"owner_role": "quality-gatekeeper",
|
|
86
|
+
"status": "stable",
|
|
87
|
+
"risk_level": "read_only",
|
|
88
|
+
"inputs": ["target", "--min-score", "--test-cmd", "--dry-run", "--json", "--allow-empty"],
|
|
89
|
+
"outputs": ["Mutation score report", "SARIF output", "JUnit XML output"],
|
|
90
|
+
"description": "Syntactic micro-mutation sentinel eliminating tautological tests and measuring assertion sensitivity."
|
|
91
|
+
},
|
|
92
|
+
"benchmark_swarm_context.py": {
|
|
93
|
+
"command": "python tools/benchmark_swarm_context.py",
|
|
94
|
+
"category": "Benchmarking",
|
|
95
|
+
"owner_role": "orchestrator",
|
|
96
|
+
"status": "stable",
|
|
97
|
+
"risk_level": "read_only",
|
|
98
|
+
"inputs": ["--verify-min-savings", "--json"],
|
|
99
|
+
"outputs": ["benchmarks/CONTEXT_TOKEN_BENCHMARK.md", "reports/context_benchmark.json"],
|
|
100
|
+
"description": "Empirical context token reduction benchmark harness proving >= 40% savings."
|
|
101
|
+
},
|
|
102
|
+
"universal_ir.py": {
|
|
103
|
+
"command": "python tools/universal_ir.py",
|
|
104
|
+
"category": "Code Generation & AST",
|
|
105
|
+
"owner_role": "pom-crafter",
|
|
106
|
+
"status": "stable",
|
|
107
|
+
"risk_level": "read_only",
|
|
108
|
+
"inputs": ["Python dataclasses / JSON schema v1.0.0"],
|
|
109
|
+
"outputs": ["ProjectIR AST", "Hermetic test fixtures"],
|
|
110
|
+
"description": "Language-agnostic and framework-agnostic AST data model for automated test suites."
|
|
111
|
+
},
|
|
112
|
+
"omni_emitter.py": {
|
|
113
|
+
"command": "python tools/omni_emitter.py",
|
|
114
|
+
"category": "Code Generation & AST",
|
|
115
|
+
"owner_role": "pom-crafter",
|
|
116
|
+
"status": "stable",
|
|
117
|
+
"risk_level": "read_only",
|
|
118
|
+
"inputs": ["ProjectIR instance", "target_framework"],
|
|
119
|
+
"outputs": ["Generated Playwright TS/Python, Selenium Java, Katalon Groovy code"],
|
|
120
|
+
"description": "Universal polyglot code generator emitting Clean POM Flat Architecture scripts."
|
|
121
|
+
},
|
|
122
|
+
"omni_parser.py": {
|
|
123
|
+
"command": "python tools/omni_parser.py",
|
|
124
|
+
"category": "Code Generation & AST",
|
|
125
|
+
"owner_role": "pom-crafter",
|
|
126
|
+
"status": "stable",
|
|
127
|
+
"risk_level": "read_only",
|
|
128
|
+
"inputs": ["source_file_path"],
|
|
129
|
+
"outputs": ["ProjectIR AST"],
|
|
130
|
+
"description": "Deterministic 0-token polyglot AST parser extracting Page Classes and test workflows."
|
|
131
|
+
},
|
|
132
|
+
"omni_transpiler.py": {
|
|
133
|
+
"command": "python tools/omni_transpiler.py",
|
|
134
|
+
"category": "Code Generation & AST",
|
|
135
|
+
"owner_role": "pom-crafter",
|
|
136
|
+
"status": "stable",
|
|
137
|
+
"risk_level": "modifying",
|
|
138
|
+
"inputs": ["--source", "--target-framework", "--output-dir"],
|
|
139
|
+
"outputs": ["Transpiled target framework files"],
|
|
140
|
+
"description": "Instant 0-token transpiler between Playwright, Selenium, and Katalon."
|
|
141
|
+
},
|
|
142
|
+
"pinpoint_failure.py": {
|
|
143
|
+
"command": "python tools/pinpoint_failure.py",
|
|
144
|
+
"category": "Failure Autopsy & Healing",
|
|
145
|
+
"owner_role": "failure-analyst",
|
|
146
|
+
"status": "stable",
|
|
147
|
+
"risk_level": "read_only",
|
|
148
|
+
"inputs": ["path_to_junit_xml", "--json"],
|
|
149
|
+
"outputs": ["Triage report", "Failing line & locator signature"],
|
|
150
|
+
"description": "Sub-0.1s JUnit XML autopsy parser diagnosing test crashes without LLM token waste."
|
|
151
|
+
},
|
|
152
|
+
"auto_heal.py": {
|
|
153
|
+
"command": "python tools/auto_heal.py",
|
|
154
|
+
"category": "Failure Autopsy & Healing",
|
|
155
|
+
"owner_role": "failure-analyst",
|
|
156
|
+
"status": "stable",
|
|
157
|
+
"risk_level": "modifying",
|
|
158
|
+
"inputs": ["--report", "--interactive", "--apply"],
|
|
159
|
+
"outputs": ["Patched Page Class locator", "Healing ledger record"],
|
|
160
|
+
"description": "Closed-loop locator self-healing engine matching broken selectors against DOM/AOM."
|
|
161
|
+
},
|
|
162
|
+
"setup_project.py": {
|
|
163
|
+
"command": "python tools/setup_project.py",
|
|
164
|
+
"category": "Setup & Onboarding",
|
|
165
|
+
"owner_role": "orchestrator",
|
|
166
|
+
"status": "stable",
|
|
167
|
+
"risk_level": "modifying",
|
|
168
|
+
"inputs": ["target_dir", "--profile", "--apply", "--uninstall"],
|
|
169
|
+
"outputs": ["PROJECT_AI_GUIDE.md", "Universal IDE AI rules", "Pre-push hooks"],
|
|
170
|
+
"description": "Zero-command automated project bootstrap tailoring AI agent rules to the target stack."
|
|
171
|
+
},
|
|
172
|
+
"analyze_project.py": {
|
|
173
|
+
"command": "python tools/analyze_project.py",
|
|
174
|
+
"category": "Quality Gates",
|
|
175
|
+
"owner_role": "quality-gatekeeper",
|
|
176
|
+
"status": "stable",
|
|
177
|
+
"risk_level": "read_only",
|
|
178
|
+
"inputs": ["target_dir", "--json", "--mode"],
|
|
179
|
+
"outputs": ["reports/PROJECT_HEALTH_REPORT.md", "AST repo map"],
|
|
180
|
+
"description": "Comprehensive health audit analyzing environment, POM structure, and Quality Gates."
|
|
181
|
+
},
|
|
182
|
+
"safety_firewall.py": {
|
|
183
|
+
"command": "python tools/safety_firewall.py",
|
|
184
|
+
"category": "Security",
|
|
185
|
+
"owner_role": "quality-gatekeeper",
|
|
186
|
+
"status": "stable",
|
|
187
|
+
"risk_level": "read_only",
|
|
188
|
+
"inputs": ["--check-command <cmd>", "--inspect-path <path>"],
|
|
189
|
+
"outputs": ["Authorization verdict PASS/BLOCKED"],
|
|
190
|
+
"description": "Non-bypassable safety firewall blocking destructive operations (drop database, git push force, rm -rf)."
|
|
191
|
+
},
|
|
192
|
+
"skillspector.py": {
|
|
193
|
+
"command": "python tools/skillspector.py",
|
|
194
|
+
"category": "Security",
|
|
195
|
+
"owner_role": "quality-gatekeeper",
|
|
196
|
+
"status": "stable",
|
|
197
|
+
"risk_level": "read_only",
|
|
198
|
+
"inputs": ["target_dir_or_skill", "--strict"],
|
|
199
|
+
"outputs": ["Vulnerability audit report", "Zero-day prompt injection alerts"],
|
|
200
|
+
"description": "Security scanner detecting prompt injection, Unicode obfuscation, and dangerous CLI tools."
|
|
201
|
+
},
|
|
202
|
+
"security_scanner.py": {
|
|
203
|
+
"command": "python tools/security_scanner.py",
|
|
204
|
+
"category": "Security",
|
|
205
|
+
"owner_role": "quality-gatekeeper",
|
|
206
|
+
"status": "stable",
|
|
207
|
+
"risk_level": "read_only",
|
|
208
|
+
"inputs": ["--json", "--strict"],
|
|
209
|
+
"outputs": ["Security audit report", "Dependency vulnerability alerts"],
|
|
210
|
+
"description": "Comprehensive enterprise security sentinel auditing Python & NPM dependencies and threat-model defense."
|
|
211
|
+
},
|
|
212
|
+
"generate_sbom.py": {
|
|
213
|
+
"command": "python tools/generate_sbom.py",
|
|
214
|
+
"category": "Security",
|
|
215
|
+
"owner_role": "orchestrator",
|
|
216
|
+
"status": "stable",
|
|
217
|
+
"risk_level": "read_only",
|
|
218
|
+
"inputs": ["--output", "--repo-root"],
|
|
219
|
+
"outputs": ["reports/synapse_hub_sbom.spdx.json"],
|
|
220
|
+
"description": "Standard SPDX 2.3 JSON Software Bill of Materials (SBOM) generator for software supply chain security."
|
|
221
|
+
},
|
|
222
|
+
"generate_jmx_plan.py": {
|
|
223
|
+
"command": "python tools/generate_jmx_plan.py",
|
|
224
|
+
"category": "Performance Testing",
|
|
225
|
+
"owner_role": "perf-engineer",
|
|
226
|
+
"status": "stable",
|
|
227
|
+
"risk_level": "read_only",
|
|
228
|
+
"inputs": ["--spec", "--postman", "--har", "--vus", "--duration", "--sla-p95", "--output", "--emit-locust"],
|
|
229
|
+
"outputs": ["JMeter .jmx test plan XML", "Locust locustfile.py"],
|
|
230
|
+
"description": "Enterprise Apache JMeter 5.x & Locust test plan generator from OpenAPI/Postman/HAR specs."
|
|
231
|
+
},
|
|
232
|
+
"jtl_analyzer.py": {
|
|
233
|
+
"command": "python tools/jtl_analyzer.py",
|
|
234
|
+
"category": "Performance Testing",
|
|
235
|
+
"owner_role": "perf-engineer",
|
|
236
|
+
"status": "stable",
|
|
237
|
+
"risk_level": "read_only",
|
|
238
|
+
"inputs": ["jtl_file", "--sla-p95", "--sla-p99", "--max-error-rate", "--markdown", "--json"],
|
|
239
|
+
"outputs": ["Performance SLA Quality Gate report", "Structured JSON metrics"],
|
|
240
|
+
"description": "Sub-0.1s Apache JMeter JTL results analyzer enforcing automated CI/CD SLA quality gates."
|
|
241
|
+
},
|
|
242
|
+
"telemetry_correlator.py": {
|
|
243
|
+
"command": "python tools/telemetry_correlator.py",
|
|
244
|
+
"category": "Performance Testing",
|
|
245
|
+
"owner_role": "perf-engineer",
|
|
246
|
+
"status": "stable",
|
|
247
|
+
"risk_level": "read_only",
|
|
248
|
+
"inputs": ["--jtl", "--server-metrics", "--markdown", "--json", "--otel"],
|
|
249
|
+
"outputs": ["Markdown RCA report", "JSON diagnostics", "OpenTelemetry metrics payload"],
|
|
250
|
+
"description": "Full-stack APM & server telemetry performance correlator linking client latencies with server hardware."
|
|
251
|
+
},
|
|
252
|
+
"template_excel_exporter.py": {
|
|
253
|
+
"command": "python tools/template_excel_exporter.py",
|
|
254
|
+
"category": "Manual Testing & Design",
|
|
255
|
+
"owner_role": "test-designer",
|
|
256
|
+
"status": "stable",
|
|
257
|
+
"risk_level": "modifying",
|
|
258
|
+
"inputs": ["input_file", "-o", "-t", "--module-code", "--module-name", "--author", "--tester"],
|
|
259
|
+
"outputs": ["Standardized 12-column Excel test suite (.xlsx)"],
|
|
260
|
+
"description": "Enterprise template-driven Excel test case exporter with dropdown Data Validation."
|
|
261
|
+
},
|
|
262
|
+
"interview_story.py": {
|
|
263
|
+
"command": "python tools/interview_story.py",
|
|
264
|
+
"category": "Manual Testing & Design",
|
|
265
|
+
"owner_role": "test-designer",
|
|
266
|
+
"status": "stable",
|
|
267
|
+
"risk_level": "read_only",
|
|
268
|
+
"inputs": ["--story", "--auto-clarify", "--export-md"],
|
|
269
|
+
"outputs": ["Ambiguity audit report", "Clarified Acceptance Criteria"],
|
|
270
|
+
"description": "Interactive requirement interrogation engine surfacing hidden assumptions and ambiguous acceptance criteria."
|
|
271
|
+
},
|
|
272
|
+
"tot_exploratory_tester.py": {
|
|
273
|
+
"command": "python tools/tot_exploratory_tester.py",
|
|
274
|
+
"category": "Manual Testing & Design",
|
|
275
|
+
"owner_role": "test-designer",
|
|
276
|
+
"status": "stable",
|
|
277
|
+
"risk_level": "read_only",
|
|
278
|
+
"inputs": ["--story", "--max-depth", "--beam-width"],
|
|
279
|
+
"outputs": ["Exploratory testing tree (Happy, Boundary, Chaos)", "Risk scores"],
|
|
280
|
+
"description": "Tree-of-Thoughts exploratory scenario generator with risk scoring and boundary decomposition."
|
|
281
|
+
},
|
|
282
|
+
"gherkin_suite.py": {
|
|
283
|
+
"command": "python tools/gherkin_suite.py",
|
|
284
|
+
"category": "Manual Testing & Design",
|
|
285
|
+
"owner_role": "test-designer",
|
|
286
|
+
"status": "stable",
|
|
287
|
+
"risk_level": "read_only",
|
|
288
|
+
"inputs": ["--features", "--audit-coverage"],
|
|
289
|
+
"outputs": ["Compiled test matrix", "Proven-vs-owed coverage gap report"],
|
|
290
|
+
"description": "Compiles Gherkin .feature specs into expanded test matrices and coverage reports."
|
|
291
|
+
},
|
|
292
|
+
"generate_api_matrix.py": {
|
|
293
|
+
"command": "python tools/generate_api_matrix.py",
|
|
294
|
+
"category": "API & Contract Testing",
|
|
295
|
+
"owner_role": "api-engineer",
|
|
296
|
+
"status": "stable",
|
|
297
|
+
"risk_level": "read_only",
|
|
298
|
+
"inputs": ["--spec", "--output", "--include-boundary"],
|
|
299
|
+
"outputs": ["E2E API test matrix (.md / .json)"],
|
|
300
|
+
"description": "Converts OpenAPI/Swagger specs into automated positive, boundary, and negative test matrices."
|
|
301
|
+
},
|
|
302
|
+
"api_drift_sentinel.py": {
|
|
303
|
+
"command": "python tools/api_drift_sentinel.py",
|
|
304
|
+
"category": "API & Contract Testing",
|
|
305
|
+
"owner_role": "api-engineer",
|
|
306
|
+
"status": "stable",
|
|
307
|
+
"risk_level": "read_only",
|
|
308
|
+
"inputs": ["--spec", "--actual-payload", "--fail-on-drift"],
|
|
309
|
+
"outputs": ["Schema drift analysis report"],
|
|
310
|
+
"description": "Detects contract drift and breaking schema mutations against OpenAPI specifications."
|
|
311
|
+
},
|
|
312
|
+
"newman_analyzer.py": {
|
|
313
|
+
"command": "python tools/newman_analyzer.py",
|
|
314
|
+
"category": "API & Contract Testing",
|
|
315
|
+
"owner_role": "api-engineer",
|
|
316
|
+
"status": "stable",
|
|
317
|
+
"risk_level": "read_only",
|
|
318
|
+
"inputs": ["newman_report.json", "--sla-p95", "--max-failures"],
|
|
319
|
+
"outputs": ["API execution metrics & CI/CD SLA quality gate status"],
|
|
320
|
+
"description": "Sub-0.1s Postman/Newman JSON test report analyzer enforcing CI/CD quality gates."
|
|
321
|
+
},
|
|
322
|
+
"network_mock_shield.py": {
|
|
323
|
+
"command": "python tools/network_mock_shield.py",
|
|
324
|
+
"category": "API & Contract Testing",
|
|
325
|
+
"owner_role": "api-engineer",
|
|
326
|
+
"status": "stable",
|
|
327
|
+
"risk_level": "modifying",
|
|
328
|
+
"inputs": ["--route", "--status", "--body", "--delay-ms"],
|
|
329
|
+
"outputs": ["Stubbed HTTP/GraphQL response mocks"],
|
|
330
|
+
"description": "Network interception shield stubbing external routes and injecting chaos network faults."
|
|
331
|
+
},
|
|
332
|
+
"export_postman_collection.py": {
|
|
333
|
+
"command": "python tools/export_postman_collection.py",
|
|
334
|
+
"category": "API & Contract Testing",
|
|
335
|
+
"owner_role": "api-engineer",
|
|
336
|
+
"status": "stable",
|
|
337
|
+
"risk_level": "read_only",
|
|
338
|
+
"inputs": ["--matrix", "--output"],
|
|
339
|
+
"outputs": ["Postman Collection v2.1.0 (.json)"],
|
|
340
|
+
"description": "Exports API test matrices into runnable Postman Collections with pre-request scripts."
|
|
341
|
+
},
|
|
342
|
+
"traffic_session_converter.py": {
|
|
343
|
+
"command": "python tools/traffic_session_converter.py",
|
|
344
|
+
"category": "API & Contract Testing",
|
|
345
|
+
"owner_role": "api-engineer",
|
|
346
|
+
"status": "stable",
|
|
347
|
+
"risk_level": "read_only",
|
|
348
|
+
"inputs": ["--har", "--output"],
|
|
349
|
+
"outputs": ["Executable API test scripts"],
|
|
350
|
+
"description": "Converts recorded HAR traffic sessions into executable API automation test cases."
|
|
351
|
+
}
|
|
352
|
+
}
|
|
353
|
+
|
|
354
|
+
|
|
355
|
+
def build_catalog() -> Dict[str, Any]:
|
|
356
|
+
"""Scans all Python scripts in tools/ and builds a comprehensive catalog."""
|
|
357
|
+
catalog = {
|
|
358
|
+
"schema_version": "1.0.0",
|
|
359
|
+
"updated_at": datetime.now(timezone.utc).isoformat(),
|
|
360
|
+
"total_tools": 0,
|
|
361
|
+
"stable_count": 0,
|
|
362
|
+
"experimental_count": 0,
|
|
363
|
+
"tools": []
|
|
364
|
+
}
|
|
365
|
+
|
|
366
|
+
all_py_files = sorted([f for f in os.listdir(TOOLS_DIR) if f.endswith(".py") and not f.startswith("__")])
|
|
367
|
+
|
|
368
|
+
for fname in all_py_files:
|
|
369
|
+
meta = TOOL_REGISTRY_METADATA.get(fname)
|
|
370
|
+
full_path = os.path.join(TOOLS_DIR, fname)
|
|
371
|
+
|
|
372
|
+
# Fallback docstring extraction
|
|
373
|
+
doc_summary = ""
|
|
374
|
+
try:
|
|
375
|
+
with open(full_path, "r", encoding="utf-8", errors="ignore") as f:
|
|
376
|
+
tree = ast.parse(f.read(), fname)
|
|
377
|
+
doc = ast.get_docstring(tree)
|
|
378
|
+
if doc:
|
|
379
|
+
doc_summary = doc.strip().split("\n")[0].strip("- ")
|
|
380
|
+
except Exception:
|
|
381
|
+
doc_summary = fname
|
|
382
|
+
|
|
383
|
+
if meta:
|
|
384
|
+
entry = {
|
|
385
|
+
"file": f"tools/{fname}",
|
|
386
|
+
"command": meta["command"],
|
|
387
|
+
"category": meta["category"],
|
|
388
|
+
"owner_role": meta["owner_role"],
|
|
389
|
+
"status": meta["status"],
|
|
390
|
+
"risk_level": meta["risk_level"],
|
|
391
|
+
"inputs": meta["inputs"],
|
|
392
|
+
"outputs": meta["outputs"],
|
|
393
|
+
"description": meta["description"]
|
|
394
|
+
}
|
|
395
|
+
else:
|
|
396
|
+
# Auto-inferred metadata for auxiliary tools
|
|
397
|
+
is_test_tool = "test" in fname or "fuzz" in fname or "mock" in fname
|
|
398
|
+
entry = {
|
|
399
|
+
"file": f"tools/{fname}",
|
|
400
|
+
"command": f"python tools/{fname}",
|
|
401
|
+
"category": "Testing & Utilities" if is_test_tool else "Auxiliary Utilities",
|
|
402
|
+
"owner_role": "orchestrator",
|
|
403
|
+
"status": "stable" if os.path.getsize(full_path) > 1000 else "experimental",
|
|
404
|
+
"risk_level": "read_only",
|
|
405
|
+
"inputs": ["CLI options"],
|
|
406
|
+
"outputs": ["Artifacts / Telemetry"],
|
|
407
|
+
"description": doc_summary or f"Synapse Hub utility module: {fname}"
|
|
408
|
+
}
|
|
409
|
+
|
|
410
|
+
catalog["tools"].append(entry)
|
|
411
|
+
|
|
412
|
+
catalog["total_tools"] = len(catalog["tools"])
|
|
413
|
+
catalog["stable_count"] = sum(1 for t in catalog["tools"] if t["status"] == "stable")
|
|
414
|
+
catalog["experimental_count"] = sum(1 for t in catalog["tools"] if t["status"] == "experimental")
|
|
415
|
+
|
|
416
|
+
return catalog
|
|
417
|
+
|
|
418
|
+
|
|
419
|
+
def format_markdown_catalog(catalog: Dict[str, Any]) -> str:
|
|
420
|
+
"""Renders catalog into an enterprise markdown runbook."""
|
|
421
|
+
md = [
|
|
422
|
+
"# Synapse Hub — Tooling Ecosystem Catalog & Runbook",
|
|
423
|
+
"",
|
|
424
|
+
"> **Audience:** QA Engineers, Autonomous AI Agents (Lead Orchestrator, POM-Crafter, Test-Runner, Failure-Analyst, Quality-Gatekeeper).",
|
|
425
|
+
f"> **Total Tools Cataloged:** `{catalog['total_tools']}` | **Stable:** `{catalog['stable_count']}` | **Experimental:** `{catalog['experimental_count']}`",
|
|
426
|
+
"",
|
|
427
|
+
"## 1. Primary Enterprise CLI Tools",
|
|
428
|
+
"",
|
|
429
|
+
"| Command | Category | Owner Role | Status | Risk Level | Description |",
|
|
430
|
+
"|---|---|:---:|:---:|:---:|---|"
|
|
431
|
+
]
|
|
432
|
+
|
|
433
|
+
for t in catalog["tools"]:
|
|
434
|
+
status_badge = "🟢 Stable" if t["status"] == "stable" else "🟡 Exp"
|
|
435
|
+
risk_badge = f"`{t['risk_level']}`"
|
|
436
|
+
md.append(f"| `{t['command']}` | **{t['category']}** | `{t['owner_role']}` | {status_badge} | {risk_badge} | {t['description']} |")
|
|
437
|
+
|
|
438
|
+
md.extend([
|
|
439
|
+
"",
|
|
440
|
+
"## 2. Risk & Operational Classification",
|
|
441
|
+
"",
|
|
442
|
+
"- `read_only`: Diagnostic, linting, AST inspection, reporting (zero side effects on workspace or git).",
|
|
443
|
+
"- `modifying`: Generates files, updates Page Classes, or writes test suites.",
|
|
444
|
+
"- `network`: Queries external APIs, monitors npm registry, or checks live URLs.",
|
|
445
|
+
"- `destructive`: High-impact actions guarded by `safety_firewall.py` (e.g. drop database, hard resets).",
|
|
446
|
+
"",
|
|
447
|
+
f"*Catalog generated: `{catalog['updated_at']}` by `tools/generate_tool_catalog.py`*"
|
|
448
|
+
])
|
|
449
|
+
|
|
450
|
+
return "\n".join(md)
|
|
451
|
+
|
|
452
|
+
|
|
453
|
+
def main() -> int:
|
|
454
|
+
catalog = build_catalog()
|
|
455
|
+
|
|
456
|
+
# Write JSON catalog
|
|
457
|
+
json_path = os.path.join(TOOLS_DIR, "TOOL_CATALOG.json")
|
|
458
|
+
with open(json_path, "w", encoding="utf-8") as f:
|
|
459
|
+
json.dump(catalog, f, indent=2, ensure_ascii=False)
|
|
460
|
+
|
|
461
|
+
# Write Markdown catalog
|
|
462
|
+
docs_dir = os.path.join(REPO_ROOT, "docs")
|
|
463
|
+
os.makedirs(docs_dir, exist_ok=True)
|
|
464
|
+
md_path = os.path.join(docs_dir, "TOOL_CATALOG.md")
|
|
465
|
+
with open(md_path, "w", encoding="utf-8") as f:
|
|
466
|
+
f.write(format_markdown_catalog(catalog))
|
|
467
|
+
|
|
468
|
+
print("=" * 68)
|
|
469
|
+
print(" SYNAPSE HUB — TOOLING ECOSYSTEM CATALOG GENERATOR")
|
|
470
|
+
print("=" * 68)
|
|
471
|
+
print(f" Indexed Tools : {catalog['total_tools']} tools")
|
|
472
|
+
print(f" Stable Tools : {catalog['stable_count']} (Production Ready)")
|
|
473
|
+
print(f" Experimental Tools : {catalog['experimental_count']}")
|
|
474
|
+
print(f" JSON Catalog : {os.path.relpath(json_path, REPO_ROOT)}")
|
|
475
|
+
print(f" Markdown Runbook : {os.path.relpath(md_path, REPO_ROOT)}")
|
|
476
|
+
print("=" * 68)
|
|
477
|
+
print("✅ Tool catalog synchronized successfully.")
|
|
478
|
+
return 0
|
|
479
|
+
|
|
480
|
+
|
|
481
|
+
if __name__ == "__main__":
|
|
482
|
+
sys.exit(main())
|