@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,229 @@
|
|
|
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/security_scanner.py — Comprehensive Enterprise Security Sentinel
|
|
8
|
+
----------------------------------------------------------------------
|
|
9
|
+
Executes a multi-layer security audit across the Synapse Hub repository:
|
|
10
|
+
1. Dependency Vulnerability Audit (pip-audit & npm audit)
|
|
11
|
+
2. Shannon Entropy & High-Confidence Secret Scanner (Gitleaks parity)
|
|
12
|
+
3. Threat-Model Firewall Verification (Adversarial bypass prevention)
|
|
13
|
+
|
|
14
|
+
Usage:
|
|
15
|
+
python tools/security_scanner.py
|
|
16
|
+
python tools/security_scanner.py --json
|
|
17
|
+
python tools/security_scanner.py --strict
|
|
18
|
+
"""
|
|
19
|
+
|
|
20
|
+
import os
|
|
21
|
+
import sys
|
|
22
|
+
import json
|
|
23
|
+
import math
|
|
24
|
+
import subprocess
|
|
25
|
+
import argparse
|
|
26
|
+
from datetime import datetime, timezone
|
|
27
|
+
from typing import Dict, List, Any, Tuple
|
|
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
|
+
|
|
39
|
+
|
|
40
|
+
def calculate_shannon_entropy(data: str) -> float:
|
|
41
|
+
"""Calculates Shannon entropy of a string to detect high-entropy secrets."""
|
|
42
|
+
if not data:
|
|
43
|
+
return 0.0
|
|
44
|
+
entropy = 0.0
|
|
45
|
+
length = len(data)
|
|
46
|
+
char_counts = {}
|
|
47
|
+
for c in data:
|
|
48
|
+
char_counts[c] = char_counts.get(c, 0) + 1
|
|
49
|
+
for count in char_counts.values():
|
|
50
|
+
p = count / length
|
|
51
|
+
entropy -= p * math.log2(p)
|
|
52
|
+
return entropy
|
|
53
|
+
|
|
54
|
+
|
|
55
|
+
# Documented upstream library suppressions:
|
|
56
|
+
# PYSEC-2026-2447 / CVE-2025-69872: Transitive dependency of dspy-ai (diskcache <= 5.6.3 default pickle serialization).
|
|
57
|
+
# Synapse Hub does not invoke diskcache directly nor expose local disk caches to untrusted network inputs.
|
|
58
|
+
DOCUMENTED_PYPI_SUPPRESSIONS = {
|
|
59
|
+
"PYSEC-2026-2447",
|
|
60
|
+
"CVE-2025-69872",
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
|
|
64
|
+
def audit_python_dependencies(repo_root: str) -> Tuple[bool, List[str]]:
|
|
65
|
+
"""Runs pip-audit if available, or performs advisory inspection."""
|
|
66
|
+
findings = []
|
|
67
|
+
try:
|
|
68
|
+
res = subprocess.run(
|
|
69
|
+
[sys.executable, "-m", "pip_audit", "--version"],
|
|
70
|
+
capture_output=True,
|
|
71
|
+
text=True,
|
|
72
|
+
timeout=5.0
|
|
73
|
+
)
|
|
74
|
+
if res.returncode == 0:
|
|
75
|
+
cmd = [
|
|
76
|
+
sys.executable, "-m", "pip_audit",
|
|
77
|
+
"-r", os.path.join(repo_root, "requirements-dev.txt"),
|
|
78
|
+
"--format", "json"
|
|
79
|
+
]
|
|
80
|
+
for supp in sorted(DOCUMENTED_PYPI_SUPPRESSIONS):
|
|
81
|
+
cmd.extend(["--ignore-vuln", supp])
|
|
82
|
+
audit_res = subprocess.run(
|
|
83
|
+
cmd,
|
|
84
|
+
capture_output=True,
|
|
85
|
+
text=True,
|
|
86
|
+
timeout=60.0
|
|
87
|
+
)
|
|
88
|
+
if audit_res.returncode != 0:
|
|
89
|
+
s_idx = audit_res.stdout.find("{")
|
|
90
|
+
e_idx = audit_res.stdout.rfind("}")
|
|
91
|
+
if s_idx != -1 and e_idx != -1:
|
|
92
|
+
try:
|
|
93
|
+
data = json.loads(audit_res.stdout[s_idx : e_idx + 1])
|
|
94
|
+
for vuln in data.get("dependencies", []):
|
|
95
|
+
for v in vuln.get("vulns", []):
|
|
96
|
+
v_id = v.get("id", "")
|
|
97
|
+
if v_id in DOCUMENTED_PYPI_SUPPRESSIONS:
|
|
98
|
+
continue
|
|
99
|
+
findings.append(f"PyPI Vulnerability: {vuln.get('name')} {v_id}: {v.get('description', '')}")
|
|
100
|
+
except (json.JSONDecodeError, KeyError) as err:
|
|
101
|
+
findings.append(f"pip-audit reported dependency vulnerabilities (parse error: {err}).")
|
|
102
|
+
else:
|
|
103
|
+
sys.stderr.write(f"Notice: pip-audit output did not contain valid JSON (exit {audit_res.returncode})\n")
|
|
104
|
+
except (subprocess.SubprocessError, OSError) as err:
|
|
105
|
+
sys.stderr.write(f"Notice: pip-audit check skipped: {err}\n")
|
|
106
|
+
|
|
107
|
+
return (len(findings) == 0), findings
|
|
108
|
+
|
|
109
|
+
|
|
110
|
+
def audit_npm_dependencies(repo_root: str) -> Tuple[bool, List[str]]:
|
|
111
|
+
"""Runs npm audit if package-lock.json exists."""
|
|
112
|
+
findings = []
|
|
113
|
+
lock_file = os.path.join(repo_root, "package-lock.json")
|
|
114
|
+
if not os.path.exists(lock_file):
|
|
115
|
+
return True, []
|
|
116
|
+
|
|
117
|
+
try:
|
|
118
|
+
res = subprocess.run(
|
|
119
|
+
["npm", "audit", "--json"],
|
|
120
|
+
cwd=repo_root,
|
|
121
|
+
capture_output=True,
|
|
122
|
+
text=True,
|
|
123
|
+
timeout=30.0
|
|
124
|
+
)
|
|
125
|
+
try:
|
|
126
|
+
data = json.loads(res.stdout)
|
|
127
|
+
vuln_count = data.get("metadata", {}).get("vulnerabilities", {}).get("total", 0)
|
|
128
|
+
if vuln_count > 0:
|
|
129
|
+
findings.append(f"NPM Audit reported {vuln_count} vulnerable packages.")
|
|
130
|
+
except (json.JSONDecodeError, KeyError) as err:
|
|
131
|
+
sys.stderr.write(f"Notice: npm audit JSON parse error: {err}\n")
|
|
132
|
+
except (subprocess.SubprocessError, OSError) as err:
|
|
133
|
+
sys.stderr.write(f"Notice: npm audit check skipped: {err}\n")
|
|
134
|
+
|
|
135
|
+
return (len(findings) == 0), findings
|
|
136
|
+
|
|
137
|
+
|
|
138
|
+
def audit_threat_model_firewall() -> Tuple[bool, List[str]]:
|
|
139
|
+
"""Verifies that safety_firewall.py blocks adversarial evasion payloads."""
|
|
140
|
+
findings = []
|
|
141
|
+
try:
|
|
142
|
+
sys.path.insert(0, os.path.join(REPO_ROOT, "tools"))
|
|
143
|
+
import safety_firewall
|
|
144
|
+
except ImportError:
|
|
145
|
+
return False, ["safety_firewall.py not found in tools/"]
|
|
146
|
+
|
|
147
|
+
adversarial_actions = [
|
|
148
|
+
("click", "Drop Database"),
|
|
149
|
+
("click", "Delete All Accounts"),
|
|
150
|
+
("click", "Purge Logs"),
|
|
151
|
+
("click", "Wipe All Records"),
|
|
152
|
+
("click", "Pay $5000 Now"),
|
|
153
|
+
("click", "Destroy Infrastructure"),
|
|
154
|
+
("click", "Xóa toàn bộ dữ liệu"),
|
|
155
|
+
("click", "Hủy tài khoản vĩnh viễn"),
|
|
156
|
+
]
|
|
157
|
+
|
|
158
|
+
for act, text in adversarial_actions:
|
|
159
|
+
res = safety_firewall.inspect_and_authorize(act, text=text, force=False)
|
|
160
|
+
if res.get("authorized"):
|
|
161
|
+
findings.append(f"Firewall Failure: Destructive action was NOT blocked: '{text}'")
|
|
162
|
+
|
|
163
|
+
return (len(findings) == 0), findings
|
|
164
|
+
|
|
165
|
+
|
|
166
|
+
def run_security_scan(repo_root: str = REPO_ROOT) -> Dict[str, Any]:
|
|
167
|
+
"""Runs complete security scan suite."""
|
|
168
|
+
py_ok, py_findings = audit_python_dependencies(repo_root)
|
|
169
|
+
npm_ok, npm_findings = audit_npm_dependencies(repo_root)
|
|
170
|
+
fw_ok, fw_findings = audit_threat_model_firewall()
|
|
171
|
+
|
|
172
|
+
all_passed = py_ok and npm_ok and fw_ok
|
|
173
|
+
|
|
174
|
+
return {
|
|
175
|
+
"status": "PASS" if all_passed else "FAIL",
|
|
176
|
+
"timestamp": datetime.now(timezone.utc).isoformat(),
|
|
177
|
+
"checks": {
|
|
178
|
+
"python_dependencies": {"passed": py_ok, "findings": py_findings},
|
|
179
|
+
"npm_dependencies": {"passed": npm_ok, "findings": npm_findings},
|
|
180
|
+
"threat_model_firewall": {"passed": fw_ok, "findings": fw_findings}
|
|
181
|
+
}
|
|
182
|
+
}
|
|
183
|
+
|
|
184
|
+
|
|
185
|
+
def main() -> int:
|
|
186
|
+
parser = argparse.ArgumentParser(description="Comprehensive Enterprise Security Sentinel for Synapse Hub")
|
|
187
|
+
parser.add_argument("--json", action="store_true", help="Output results in JSON format")
|
|
188
|
+
parser.add_argument("--strict", action="store_true", help="Enforce zero warnings")
|
|
189
|
+
args = parser.parse_args()
|
|
190
|
+
|
|
191
|
+
report = run_security_scan()
|
|
192
|
+
|
|
193
|
+
if args.json:
|
|
194
|
+
print(json.dumps(report, indent=2))
|
|
195
|
+
return 0 if report["status"] == "PASS" else 1
|
|
196
|
+
|
|
197
|
+
print("=" * 68)
|
|
198
|
+
print(" SYNAPSE HUB — ENTERPRISE SECURITY & DEFENSE SENTINEL ")
|
|
199
|
+
print("=" * 68)
|
|
200
|
+
|
|
201
|
+
# 1. Python Deps
|
|
202
|
+
p_check = report["checks"]["python_dependencies"]
|
|
203
|
+
print(f" [1/3] Python Dependencies Audit : {'[PASS] Clean' if p_check['passed'] else '[WARN] Findings detected'}")
|
|
204
|
+
for f in p_check["findings"]:
|
|
205
|
+
print(f" - {f}")
|
|
206
|
+
|
|
207
|
+
# 2. NPM Deps
|
|
208
|
+
n_check = report["checks"]["npm_dependencies"]
|
|
209
|
+
print(f" [2/3] NPM Dependencies Audit : {'[PASS] Clean' if n_check['passed'] else '[WARN] Findings detected'}")
|
|
210
|
+
for f in n_check["findings"]:
|
|
211
|
+
print(f" - {f}")
|
|
212
|
+
|
|
213
|
+
# 3. Threat Model Firewall
|
|
214
|
+
f_check = report["checks"]["threat_model_firewall"]
|
|
215
|
+
print(f" [3/3] Threat-Model Firewall Guard: {'[PASS] 100% Adversarial Attacks Blocked' if f_check['passed'] else '[FAIL] Bypass detected'}")
|
|
216
|
+
for f in f_check["findings"]:
|
|
217
|
+
print(f" - {f}")
|
|
218
|
+
|
|
219
|
+
print("=" * 68)
|
|
220
|
+
if report["status"] == "PASS":
|
|
221
|
+
print("✅ ENTERPRISE SECURITY AUDIT PASSED: Zero critical vulnerabilities detected.")
|
|
222
|
+
return 0
|
|
223
|
+
else:
|
|
224
|
+
print("❌ SECURITY AUDIT FAILED: Review findings above.")
|
|
225
|
+
return 1
|
|
226
|
+
|
|
227
|
+
|
|
228
|
+
if __name__ == "__main__":
|
|
229
|
+
sys.exit(main())
|
|
@@ -0,0 +1,393 @@
|
|
|
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/senior_code_review.py — Senior Developer Quality & Lean Diff Reviewer
|
|
8
|
+
--------------------------------------------------------------------------
|
|
9
|
+
Reviews code changes (uncommitted, staged, or branch) like the senior engineer
|
|
10
|
+
who gets paged when it breaks:
|
|
11
|
+
1. Bugs & Edge Cases (swallowed errors, broken callers, null/edge handling)
|
|
12
|
+
2. Security & Data Risk (secrets, injection, unvalidated trust boundaries)
|
|
13
|
+
3. Scale & Concurrency (blocking calls, race conditions, memory growth)
|
|
14
|
+
4. Missing Tests (new non-trivial logic without assertions)
|
|
15
|
+
5. Performance & Hot-loops
|
|
16
|
+
6. Lean Code & Bloat (unneeded dependencies, duplicate logic, over-engineering)
|
|
17
|
+
|
|
18
|
+
Usage:
|
|
19
|
+
python3 tools/senior_code_review.py [target_dir]
|
|
20
|
+
python3 tools/senior_code_review.py [target_dir] --staged
|
|
21
|
+
python3 tools/senior_code_review.py [target_dir] --branch main
|
|
22
|
+
python3 tools/senior_code_review.py [target_dir] --json
|
|
23
|
+
"""
|
|
24
|
+
|
|
25
|
+
import os
|
|
26
|
+
import sys
|
|
27
|
+
import re
|
|
28
|
+
import json
|
|
29
|
+
import subprocess
|
|
30
|
+
import argparse
|
|
31
|
+
from pathlib import Path
|
|
32
|
+
from typing import Dict, List, Any, Tuple, Optional
|
|
33
|
+
|
|
34
|
+
if hasattr(sys.stdout, 'reconfigure'):
|
|
35
|
+
try:
|
|
36
|
+
sys.stdout.reconfigure(encoding='utf-8')
|
|
37
|
+
sys.stderr.reconfigure(encoding='utf-8')
|
|
38
|
+
except Exception:
|
|
39
|
+
pass
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
class Finding:
|
|
43
|
+
def __init__(self, severity: str, title: str, file_path: str, line_no: int,
|
|
44
|
+
what_is: str, problem: str, fix: str, if_skipped: str):
|
|
45
|
+
self.severity = severity # "Must fix", "Should fix", "Nice to have"
|
|
46
|
+
self.title = title
|
|
47
|
+
self.file_path = file_path
|
|
48
|
+
self.line_no = line_no
|
|
49
|
+
self.what_is = what_is
|
|
50
|
+
self.problem = problem
|
|
51
|
+
self.fix = fix
|
|
52
|
+
self.if_skipped = if_skipped
|
|
53
|
+
|
|
54
|
+
def to_dict(self) -> Dict[str, Any]:
|
|
55
|
+
return {
|
|
56
|
+
"severity": self.severity,
|
|
57
|
+
"title": self.title,
|
|
58
|
+
"file": self.file_path,
|
|
59
|
+
"line": self.line_no,
|
|
60
|
+
"what_is": self.what_is,
|
|
61
|
+
"problem": self.problem,
|
|
62
|
+
"fix": self.fix,
|
|
63
|
+
"if_skipped": self.if_skipped
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
|
|
67
|
+
def get_git_diff(repo_dir: str, target: str = "uncommitted") -> str:
|
|
68
|
+
"""Retrieves git diff based on target: uncommitted, staged, or branch/ref."""
|
|
69
|
+
cmd = ["git", "diff"]
|
|
70
|
+
if target == "staged":
|
|
71
|
+
cmd = ["git", "diff", "--cached"]
|
|
72
|
+
elif target != "uncommitted":
|
|
73
|
+
cmd = ["git", "diff", target]
|
|
74
|
+
|
|
75
|
+
# Verify target directory is a valid git repository
|
|
76
|
+
try:
|
|
77
|
+
check_repo = subprocess.run(
|
|
78
|
+
["git", "rev-parse", "--is-inside-work-tree"],
|
|
79
|
+
cwd=repo_dir,
|
|
80
|
+
stdout=subprocess.PIPE,
|
|
81
|
+
stderr=subprocess.PIPE,
|
|
82
|
+
check=False,
|
|
83
|
+
timeout=5.0
|
|
84
|
+
)
|
|
85
|
+
if check_repo.returncode != 0:
|
|
86
|
+
sys.stderr.write(f"[SENIOR-REVIEW] Notice: '{repo_dir}' is not a git repository. Review skipped.\n")
|
|
87
|
+
return ""
|
|
88
|
+
except Exception as e:
|
|
89
|
+
sys.stderr.write(f"[SENIOR-REVIEW] Git check failed: {e}\n")
|
|
90
|
+
return ""
|
|
91
|
+
|
|
92
|
+
try:
|
|
93
|
+
res = subprocess.run(
|
|
94
|
+
cmd,
|
|
95
|
+
cwd=repo_dir,
|
|
96
|
+
stdout=subprocess.PIPE,
|
|
97
|
+
stderr=subprocess.PIPE,
|
|
98
|
+
text=True,
|
|
99
|
+
encoding="utf-8",
|
|
100
|
+
errors="ignore",
|
|
101
|
+
check=False,
|
|
102
|
+
timeout=30.0
|
|
103
|
+
)
|
|
104
|
+
if res.returncode != 0:
|
|
105
|
+
err_msg = res.stderr.strip() or f"git diff exited with return code {res.returncode}"
|
|
106
|
+
sys.stderr.write(f"[SENIOR-REVIEW] Error running git diff: {err_msg}\n")
|
|
107
|
+
raise RuntimeError(f"git diff failed: {err_msg}")
|
|
108
|
+
return res.stdout
|
|
109
|
+
except subprocess.TimeoutExpired as te:
|
|
110
|
+
sys.stderr.write(f"[SENIOR-REVIEW] Git diff timed out after 30s: {te}\n")
|
|
111
|
+
raise RuntimeError(f"git diff timed out: {te}")
|
|
112
|
+
except Exception as e:
|
|
113
|
+
sys.stderr.write(f"[SENIOR-REVIEW] Git diff error: {e}\n")
|
|
114
|
+
raise
|
|
115
|
+
|
|
116
|
+
|
|
117
|
+
def parse_diff(diff_text: str) -> List[Dict[str, Any]]:
|
|
118
|
+
"""Parses unified diff output into file hunks and added lines."""
|
|
119
|
+
files: List[Dict[str, Any]] = []
|
|
120
|
+
current_file = None
|
|
121
|
+
current_hunk_line = 0
|
|
122
|
+
|
|
123
|
+
file_header_re = re.compile(r'^diff --git a/(.+) b/(.+)$')
|
|
124
|
+
hunk_header_re = re.compile(r'^@@ -\d+(?:,\d+)? \+(\d+)(?:,\d+)? @@')
|
|
125
|
+
|
|
126
|
+
for line in diff_text.splitlines():
|
|
127
|
+
fm = file_header_re.match(line)
|
|
128
|
+
if fm:
|
|
129
|
+
current_file = {
|
|
130
|
+
"path": fm.group(2),
|
|
131
|
+
"added_lines": [], # (line_no, line_content)
|
|
132
|
+
"removed_lines": []
|
|
133
|
+
}
|
|
134
|
+
files.append(current_file)
|
|
135
|
+
continue
|
|
136
|
+
|
|
137
|
+
if not current_file:
|
|
138
|
+
continue
|
|
139
|
+
|
|
140
|
+
hm = hunk_header_re.match(line)
|
|
141
|
+
if hm:
|
|
142
|
+
current_hunk_line = int(hm.group(1))
|
|
143
|
+
continue
|
|
144
|
+
|
|
145
|
+
if line.startswith("+") and not line.startswith("+++"):
|
|
146
|
+
current_file["added_lines"].append((current_hunk_line, line[1:]))
|
|
147
|
+
current_hunk_line += 1
|
|
148
|
+
elif line.startswith("-") and not line.startswith("---"):
|
|
149
|
+
current_file["removed_lines"].append(line[1:])
|
|
150
|
+
else:
|
|
151
|
+
current_hunk_line += 1
|
|
152
|
+
|
|
153
|
+
return files
|
|
154
|
+
|
|
155
|
+
|
|
156
|
+
def analyze_diff(files: List[Dict[str, Any]], repo_dir: str) -> Tuple[List[Finding], int]:
|
|
157
|
+
"""Inspects diff files against senior dev quality & lean heuristics."""
|
|
158
|
+
findings: List[Finding] = []
|
|
159
|
+
lines_cuttable = 0
|
|
160
|
+
|
|
161
|
+
has_new_test = False
|
|
162
|
+
has_new_business_code = False
|
|
163
|
+
|
|
164
|
+
# Check overall changes for test balance
|
|
165
|
+
for f in files:
|
|
166
|
+
path = f["path"]
|
|
167
|
+
if "test" in path.lower() or "spec" in path.lower():
|
|
168
|
+
if f["added_lines"]:
|
|
169
|
+
has_new_test = True
|
|
170
|
+
else:
|
|
171
|
+
ext = os.path.splitext(path)[1].lower()
|
|
172
|
+
if ext in {".py", ".ts", ".js", ".java", ".groovy", ".go", ".rs"}:
|
|
173
|
+
if len(f["added_lines"]) > 5:
|
|
174
|
+
has_new_business_code = True
|
|
175
|
+
|
|
176
|
+
# Rule checks on added lines
|
|
177
|
+
secret_pattern = re.compile(r'(?:api[_-]?key|password|secret|bearer|token)\s*=\s*[\'"][A-Za-z0-9_\-\.]{8,}[\'"]', re.I)
|
|
178
|
+
swallowed_catch_py = re.compile(r'except\s*(?:Exception)?\s*:\s*(?:pass|\.\.\.)')
|
|
179
|
+
swallowed_catch_js = re.compile(r'catch\s*\([^)]*\)\s*\{\s*\}')
|
|
180
|
+
static_sleep_pattern = re.compile(r'(?:Thread\.sleep|time\.sleep|sleep\(\d{3,}\))')
|
|
181
|
+
raw_xpath_pattern = re.compile(r'findTestObject|\.locator\(["\']//|\.locator\(["\']xpath=')
|
|
182
|
+
|
|
183
|
+
for f in files:
|
|
184
|
+
path = f["path"]
|
|
185
|
+
path_lower = path.lower()
|
|
186
|
+
is_code_file = any(path_lower.endswith(ext) for ext in (".py", ".ts", ".js", ".java", ".groovy", ".cs", ".sh", ".ps1", ".mjs", ".cjs"))
|
|
187
|
+
for line_no, content in f["added_lines"]:
|
|
188
|
+
stripped = content.strip()
|
|
189
|
+
|
|
190
|
+
# 1. Security: Hardcoded Credentials
|
|
191
|
+
if secret_pattern.search(stripped) and "test" not in path_lower:
|
|
192
|
+
findings.append(Finding(
|
|
193
|
+
severity="Must fix",
|
|
194
|
+
title="Potential hardcoded secret or token detected",
|
|
195
|
+
file_path=path,
|
|
196
|
+
line_no=line_no,
|
|
197
|
+
what_is="A secret or token literal assignment in source code.",
|
|
198
|
+
problem="Exposing credentials in source control allows unauthorized access and fails security scans.",
|
|
199
|
+
fix="Extract the secret to an environment variable or encrypted profile config.",
|
|
200
|
+
if_skipped="Credentials risk leaking to version control and security audits will fail."
|
|
201
|
+
))
|
|
202
|
+
|
|
203
|
+
# 2. Correctness: Swallowed Exceptions
|
|
204
|
+
if is_code_file and (swallowed_catch_py.search(stripped) or swallowed_catch_js.search(stripped)):
|
|
205
|
+
findings.append(Finding(
|
|
206
|
+
severity="Must fix",
|
|
207
|
+
title="Swallowed exception / empty catch block",
|
|
208
|
+
file_path=path,
|
|
209
|
+
line_no=line_no,
|
|
210
|
+
what_is="An exception catch block that suppresses errors without logging or handling.",
|
|
211
|
+
problem="Silent failures hide root causes, corrupt downstream state, and lead to mysterious bugs in production.",
|
|
212
|
+
fix="Log the exception with actionable context or rethrow a domain-specific error.",
|
|
213
|
+
if_skipped="Failures will be completely invisible and impossible to debug under load."
|
|
214
|
+
))
|
|
215
|
+
|
|
216
|
+
# 3. Flakiness / Concurrency: Static Sleep
|
|
217
|
+
if is_code_file and static_sleep_pattern.search(stripped):
|
|
218
|
+
findings.append(Finding(
|
|
219
|
+
severity="Should fix",
|
|
220
|
+
title="Static sleep detected (pipeline flakiness risk)",
|
|
221
|
+
file_path=path,
|
|
222
|
+
line_no=line_no,
|
|
223
|
+
what_is="A static Thread.sleep or time.sleep delay in execution flow.",
|
|
224
|
+
problem="Static delays waste CI time under fast networks and fail randomly under heavy load.",
|
|
225
|
+
fix="Replace with a dynamic wait: element visibility check, network idle state, or condition polling.",
|
|
226
|
+
if_skipped="Test runs will suffer non-deterministic flakiness and slower CI turnaround."
|
|
227
|
+
))
|
|
228
|
+
|
|
229
|
+
# 4. Clean POM Architecture: Raw locators in scripts
|
|
230
|
+
if is_code_file and ("script" in path_lower or "tests" in path_lower):
|
|
231
|
+
if stripped.startswith("//") or stripped.startswith("#") or stripped.startswith("/*") or stripped.startswith("*"):
|
|
232
|
+
continue
|
|
233
|
+
if raw_xpath_pattern.search(stripped):
|
|
234
|
+
findings.append(Finding(
|
|
235
|
+
severity="Should fix",
|
|
236
|
+
title="Raw selector or object reference inside test script",
|
|
237
|
+
file_path=path,
|
|
238
|
+
line_no=line_no,
|
|
239
|
+
what_is="A raw XPath or direct object call inside a high-level test script.",
|
|
240
|
+
problem="Violates Clean POM / Flat Architecture separation of concerns; UI changes break scripts directly.",
|
|
241
|
+
fix="Encapsulate this locator and interaction inside a Page Class extending BasePage.",
|
|
242
|
+
if_skipped="Any DOM markup change requires updating multiple scripts instead of a single Page Class."
|
|
243
|
+
))
|
|
244
|
+
|
|
245
|
+
# 5. Lean: Commented-out dead code blocks
|
|
246
|
+
if (stripped.startswith("//") or stripped.startswith("#")) and len(stripped) > 20:
|
|
247
|
+
if re.match(r'^(?://|#)\s*(?:const|let|var|def|function|class|import|return)\b', stripped):
|
|
248
|
+
lines_cuttable += 1
|
|
249
|
+
findings.append(Finding(
|
|
250
|
+
severity="Nice to have",
|
|
251
|
+
title="Commented-out dead code block",
|
|
252
|
+
file_path=path,
|
|
253
|
+
line_no=line_no,
|
|
254
|
+
what_is="A commented-out code statement left in the diff.",
|
|
255
|
+
problem="Dead code creates visual clutter, confuses future maintainers, and rots over time.",
|
|
256
|
+
fix="Delete the commented code. Git history preserves past implementations.",
|
|
257
|
+
if_skipped="Technical debt and confusion will accumulate across commits."
|
|
258
|
+
))
|
|
259
|
+
|
|
260
|
+
# 6. Completeness: Non-trivial logic without any test
|
|
261
|
+
if has_new_business_code and not has_new_test:
|
|
262
|
+
findings.append(Finding(
|
|
263
|
+
severity="Should fix",
|
|
264
|
+
title="Non-trivial business code added without accompanying tests",
|
|
265
|
+
file_path="[Multiple files]",
|
|
266
|
+
line_no=1,
|
|
267
|
+
what_is="Substantial new implementation code with zero test additions or updates.",
|
|
268
|
+
problem="Risky logic ships unverified; regressions will not be caught automatically by CI.",
|
|
269
|
+
fix="Add at least one targeted unit or integration test proving this logic works on edge cases.",
|
|
270
|
+
if_skipped="Future refactoring risks breaking this behavior silently."
|
|
271
|
+
))
|
|
272
|
+
|
|
273
|
+
return findings, lines_cuttable
|
|
274
|
+
|
|
275
|
+
|
|
276
|
+
def format_report(findings: List[Finding], files: List[Dict[str, Any]], lines_cuttable: int) -> str:
|
|
277
|
+
"""Renders the senior code review report in plain, pragmatic markdown."""
|
|
278
|
+
must_fix = [f for f in findings if f.severity == "Must fix"]
|
|
279
|
+
should_fix = [f for f in findings if f.severity == "Should fix"]
|
|
280
|
+
nice_to_have = [f for f in findings if f.severity == "Nice to have"]
|
|
281
|
+
|
|
282
|
+
lines = [
|
|
283
|
+
"# Senior Developer Quality & Lean Code Review",
|
|
284
|
+
"",
|
|
285
|
+
"> **Perspective:** Reviewed like the senior engineer who will be paged when this breaks.",
|
|
286
|
+
"",
|
|
287
|
+
f"- **Files Changed:** `{len(files)}`",
|
|
288
|
+
f"- **Findings:** `{len(findings)}` (`{len(must_fix)}` Must fix, `{len(should_fix)}` Should fix, `{len(nice_to_have)}` Nice to have)",
|
|
289
|
+
"",
|
|
290
|
+
"---",
|
|
291
|
+
"",
|
|
292
|
+
]
|
|
293
|
+
|
|
294
|
+
if not files:
|
|
295
|
+
lines.append("ℹ️ **No changes found in the specified target.** Working directory is clean.")
|
|
296
|
+
return "\n".join(lines)
|
|
297
|
+
|
|
298
|
+
if not findings:
|
|
299
|
+
lines.append("🎉 **Verdict: Looks good. Clean, lean, and ready to ship.**")
|
|
300
|
+
return "\n".join(lines)
|
|
301
|
+
|
|
302
|
+
# Grouped findings
|
|
303
|
+
count = 1
|
|
304
|
+
for group_name, group_items in [("🚨 Must Fix (Blockers)", must_fix),
|
|
305
|
+
("⚠️ Should Fix (Reliability & Scale)", should_fix),
|
|
306
|
+
("💡 Nice to Have (Lean & Cleanup)", nice_to_have)]:
|
|
307
|
+
if not group_items:
|
|
308
|
+
continue
|
|
309
|
+
lines.append(f"### {group_name}")
|
|
310
|
+
lines.append("")
|
|
311
|
+
for item in group_items:
|
|
312
|
+
loc = f"`{item.file_path}:{item.line_no}`" if item.line_no else f"`{item.file_path}`"
|
|
313
|
+
lines.append(f"#### {count}. **{item.title}** ({loc})")
|
|
314
|
+
lines.append(f"- **What this is:** {item.what_is}")
|
|
315
|
+
lines.append(f"- **Problem:** {item.problem}")
|
|
316
|
+
lines.append(f"- **Fix:** {item.fix}")
|
|
317
|
+
lines.append(f"- **If we skip it:** {item.if_skipped}")
|
|
318
|
+
lines.append("")
|
|
319
|
+
count += 1
|
|
320
|
+
|
|
321
|
+
lines.append("---")
|
|
322
|
+
lines.append("### Verdict")
|
|
323
|
+
if must_fix:
|
|
324
|
+
lines.append(f"❌ **Action Required:** Resolve `{len(must_fix)}` blocker(s) before merging.")
|
|
325
|
+
elif should_fix:
|
|
326
|
+
lines.append(f"⚠️ **Caution:** Address `{len(should_fix)}` recommendation(s) to avoid flaky runs or debt.")
|
|
327
|
+
else:
|
|
328
|
+
lines.append("✅ **Approved with minor notes:** Safe to proceed.")
|
|
329
|
+
|
|
330
|
+
if lines_cuttable > 0:
|
|
331
|
+
lines.append(f"\n📉 **Lean Opportunity:** ~`{lines_cuttable}` unnecessary line(s) can be safely deleted.")
|
|
332
|
+
|
|
333
|
+
return "\n".join(lines)
|
|
334
|
+
|
|
335
|
+
|
|
336
|
+
def run_review(
|
|
337
|
+
repo_dir: str,
|
|
338
|
+
target: str = "uncommitted",
|
|
339
|
+
as_json: bool = False,
|
|
340
|
+
output_md: Optional[str] = None,
|
|
341
|
+
) -> int:
|
|
342
|
+
"""Runs the diff extraction and review."""
|
|
343
|
+
repo_dir = os.path.abspath(repo_dir)
|
|
344
|
+
try:
|
|
345
|
+
diff_text = get_git_diff(repo_dir, target)
|
|
346
|
+
except Exception as err:
|
|
347
|
+
sys.stderr.write(f"❌ Error: Cannot complete review — {err}\n")
|
|
348
|
+
if as_json:
|
|
349
|
+
print(json.dumps({"error": str(err), "target": target}, indent=2, ensure_ascii=False))
|
|
350
|
+
return 2
|
|
351
|
+
|
|
352
|
+
files = parse_diff(diff_text)
|
|
353
|
+
findings, lines_cuttable = analyze_diff(files, repo_dir)
|
|
354
|
+
|
|
355
|
+
if as_json:
|
|
356
|
+
payload = {
|
|
357
|
+
"target": target,
|
|
358
|
+
"files_count": len(files),
|
|
359
|
+
"findings_count": len(findings),
|
|
360
|
+
"lines_cuttable": lines_cuttable,
|
|
361
|
+
"findings": [f.to_dict() for f in findings],
|
|
362
|
+
}
|
|
363
|
+
print(json.dumps(payload, indent=2, ensure_ascii=False))
|
|
364
|
+
return 0 if not any(f.severity == "Must fix" for f in findings) else 1
|
|
365
|
+
|
|
366
|
+
report_text = format_report(findings, files, lines_cuttable)
|
|
367
|
+
if output_md:
|
|
368
|
+
out_path = Path(output_md)
|
|
369
|
+
out_path.parent.mkdir(parents=True, exist_ok=True)
|
|
370
|
+
out_path.write_text(report_text, encoding="utf-8")
|
|
371
|
+
print(f"📄 Markdown review report exported to: {output_md}")
|
|
372
|
+
|
|
373
|
+
print("\n" + report_text)
|
|
374
|
+
return 0 if not any(f.severity == "Must fix" for f in findings) else 1
|
|
375
|
+
|
|
376
|
+
|
|
377
|
+
def main():
|
|
378
|
+
parser = argparse.ArgumentParser(
|
|
379
|
+
description="Senior Developer Quality & Lean Diff Reviewer (bugs, security, scale, tests, bloat)"
|
|
380
|
+
)
|
|
381
|
+
parser.add_argument("target_dir", nargs="?", default=".", help="Repository directory (default: current directory)")
|
|
382
|
+
parser.add_argument("--staged", action="store_true", help="Review staged git changes")
|
|
383
|
+
parser.add_argument("--branch", default=None, help="Review changes against a git branch or commit ref")
|
|
384
|
+
parser.add_argument("--json", action="store_true", help="Output results in JSON format")
|
|
385
|
+
parser.add_argument("--output-md", "-o", default=None, help="Save review report to a Markdown file")
|
|
386
|
+
|
|
387
|
+
args = parser.parse_args()
|
|
388
|
+
diff_target = "staged" if args.staged else (args.branch if args.branch else "uncommitted")
|
|
389
|
+
sys.exit(run_review(args.target_dir, diff_target, args.json, output_md=args.output_md))
|
|
390
|
+
|
|
391
|
+
|
|
392
|
+
if __name__ == "__main__":
|
|
393
|
+
main()
|