@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,423 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
# -*- coding: utf-8 -*-
|
|
3
|
+
"""
|
|
4
|
+
tools/bump_version.py β Atomic Universal Version Bumper for Synapse Hub
|
|
5
|
+
|
|
6
|
+
Synchronizes version numbers across all polyglot targets in a single command:
|
|
7
|
+
1. package.json (NPM)
|
|
8
|
+
2. pyproject.toml (Python/Poetry/PEP 621)
|
|
9
|
+
3. skills_manifest.json (Skill Catalog Index)
|
|
10
|
+
4. agentskills.json (Agent Skills Manifest)
|
|
11
|
+
5. tools/cli.py (Agent-QA CLI)
|
|
12
|
+
6. tools/mcp_server.py (MCP Protocol Server)
|
|
13
|
+
7. tools/browser_helpers.js (In-Browser CDP Helper)
|
|
14
|
+
8. tools/mcp_excel_server.py (Excel MCP Service)
|
|
15
|
+
9. docs/ARCHITECTURE.md (Architecture Specifications)
|
|
16
|
+
10. README.md (Bilingual Documentation & Badges)
|
|
17
|
+
|
|
18
|
+
Usage:
|
|
19
|
+
python3 tools/bump_version.py patch # 2.0.1 -> 2.0.2
|
|
20
|
+
python3 tools/bump_version.py minor # 2.0.1 -> 2.1.0
|
|
21
|
+
python3 tools/bump_version.py major # 2.0.1 -> 3.0.0
|
|
22
|
+
python3 tools/bump_version.py 2.0.5 # Explicit version
|
|
23
|
+
python3 tools/bump_version.py patch --commit # Bump + git commit
|
|
24
|
+
python3 tools/bump_version.py patch --commit --push # Bump + commit + git push + tag
|
|
25
|
+
python3 tools/bump_version.py patch --dry-run # Preview only
|
|
26
|
+
"""
|
|
27
|
+
|
|
28
|
+
import sys
|
|
29
|
+
import os
|
|
30
|
+
import re
|
|
31
|
+
import json
|
|
32
|
+
import argparse
|
|
33
|
+
import subprocess
|
|
34
|
+
|
|
35
|
+
# Enforce UTF-8 stdout encoding for Windows console compatibility
|
|
36
|
+
if hasattr(sys.stdout, 'reconfigure'):
|
|
37
|
+
try:
|
|
38
|
+
sys.stdout.reconfigure(encoding='utf-8')
|
|
39
|
+
sys.stderr.reconfigure(encoding='utf-8')
|
|
40
|
+
except Exception:
|
|
41
|
+
pass
|
|
42
|
+
|
|
43
|
+
REPO_ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
|
|
44
|
+
|
|
45
|
+
def parse_semver(v_str: str):
|
|
46
|
+
"""Parses a semantic version string into major, minor, patch integers and optional suffix.
|
|
47
|
+
|
|
48
|
+
Args:
|
|
49
|
+
v_str: The version string to parse (e.g. '2.9.0' or '2.9.0-rc1').
|
|
50
|
+
|
|
51
|
+
Returns:
|
|
52
|
+
A tuple of (major, minor, patch, suffix).
|
|
53
|
+
|
|
54
|
+
Raises:
|
|
55
|
+
ValueError: If the string does not follow semantic versioning.
|
|
56
|
+
"""
|
|
57
|
+
m = re.match(r"^(\d+)\.(\d+)\.(\d+)(.*)$", v_str.strip())
|
|
58
|
+
if not m:
|
|
59
|
+
raise ValueError(f"Invalid semver: '{v_str}'. Must follow major.minor.patch[-suffix]")
|
|
60
|
+
return int(m.group(1)), int(m.group(2)), int(m.group(3)), m.group(4)
|
|
61
|
+
|
|
62
|
+
def calculate_next_version(current: str, action: str) -> str:
|
|
63
|
+
"""Computes the target version based on an action or explicit semver string.
|
|
64
|
+
|
|
65
|
+
Args:
|
|
66
|
+
current: Current semver version string.
|
|
67
|
+
action: 'patch', 'minor', 'major', or an explicit target version string.
|
|
68
|
+
|
|
69
|
+
Returns:
|
|
70
|
+
The computed next semver version string.
|
|
71
|
+
"""
|
|
72
|
+
major, minor, patch, suffix = parse_semver(current)
|
|
73
|
+
action = action.lower()
|
|
74
|
+
if action == "patch":
|
|
75
|
+
return f"{major}.{minor}.{patch + 1}"
|
|
76
|
+
elif action == "minor":
|
|
77
|
+
return f"{major}.{minor + 1}.0"
|
|
78
|
+
elif action == "major":
|
|
79
|
+
return f"{major + 1}.0.0"
|
|
80
|
+
else:
|
|
81
|
+
# Validate that action itself is a valid semver
|
|
82
|
+
parse_semver(action)
|
|
83
|
+
return action
|
|
84
|
+
|
|
85
|
+
def get_current_version() -> str:
|
|
86
|
+
"""Reads the current canonical version from package.json in the repository root.
|
|
87
|
+
|
|
88
|
+
Returns:
|
|
89
|
+
The version string.
|
|
90
|
+
|
|
91
|
+
Raises:
|
|
92
|
+
ValueError: If package.json is missing or lacks a valid version field.
|
|
93
|
+
"""
|
|
94
|
+
pkg_file = os.path.join(REPO_ROOT, "package.json")
|
|
95
|
+
with open(pkg_file, "r", encoding="utf-8") as f:
|
|
96
|
+
data = json.load(f)
|
|
97
|
+
version = data.get("version")
|
|
98
|
+
if not version:
|
|
99
|
+
raise ValueError("package.json does not contain a valid 'version' field.")
|
|
100
|
+
return version
|
|
101
|
+
|
|
102
|
+
ORIGINAL_SNAPSHOTS = {}
|
|
103
|
+
|
|
104
|
+
def rollback_all_files():
|
|
105
|
+
"""Restores all modified files to their original snapshot on failure."""
|
|
106
|
+
if not ORIGINAL_SNAPSHOTS:
|
|
107
|
+
return
|
|
108
|
+
print("\nπ Rolling back version changes across files to restore clean working tree...")
|
|
109
|
+
for fpath, orig_text in ORIGINAL_SNAPSHOTS.items():
|
|
110
|
+
try:
|
|
111
|
+
with open(fpath, "w", encoding="utf-8", newline="\n") as rf:
|
|
112
|
+
rf.write(orig_text)
|
|
113
|
+
print(f" [RESTORED] {os.path.relpath(fpath, REPO_ROOT)}")
|
|
114
|
+
except Exception as e:
|
|
115
|
+
print(f" [ERROR] Failed to restore {fpath}: {e}")
|
|
116
|
+
|
|
117
|
+
def update_json_root_version(rel_path: str, new_ver: str, dry_run: bool = False) -> bool:
|
|
118
|
+
"""Updates the top-level 'version' property in a JSON manifest file.
|
|
119
|
+
|
|
120
|
+
Args:
|
|
121
|
+
rel_path: Relative path to the target JSON file from repo root.
|
|
122
|
+
new_ver: Target version string.
|
|
123
|
+
dry_run: If True, previews changes without writing to disk.
|
|
124
|
+
|
|
125
|
+
Returns:
|
|
126
|
+
True if the file was modified or would be updated.
|
|
127
|
+
"""
|
|
128
|
+
full_path = os.path.join(REPO_ROOT, rel_path)
|
|
129
|
+
if not os.path.exists(full_path):
|
|
130
|
+
print(f" [WARN] File not found: {rel_path}")
|
|
131
|
+
return False
|
|
132
|
+
|
|
133
|
+
with open(full_path, "r", encoding="utf-8") as f:
|
|
134
|
+
raw_text = f.read()
|
|
135
|
+
|
|
136
|
+
try:
|
|
137
|
+
data = json.loads(raw_text)
|
|
138
|
+
except json.JSONDecodeError as err:
|
|
139
|
+
print(f" [ERROR] Invalid JSON in {rel_path}: {err}")
|
|
140
|
+
return False
|
|
141
|
+
|
|
142
|
+
old_ver = data.get("version")
|
|
143
|
+
if old_ver == new_ver:
|
|
144
|
+
print(f" [SKIP] {rel_path} already at v{new_ver}")
|
|
145
|
+
return False
|
|
146
|
+
|
|
147
|
+
if not dry_run and full_path not in ORIGINAL_SNAPSHOTS:
|
|
148
|
+
ORIGINAL_SNAPSHOTS[full_path] = raw_text
|
|
149
|
+
|
|
150
|
+
data["version"] = new_ver
|
|
151
|
+
if not dry_run:
|
|
152
|
+
with open(full_path, "w", encoding="utf-8", newline="\n") as f:
|
|
153
|
+
json.dump(data, f, indent=2, ensure_ascii=False)
|
|
154
|
+
f.write("\n")
|
|
155
|
+
print(f" [UPDATED] {rel_path} (root version {old_ver} -> {new_ver})")
|
|
156
|
+
else:
|
|
157
|
+
print(f" [DRY-RUN] Would update {rel_path} (root version {old_ver} -> {new_ver})")
|
|
158
|
+
return True
|
|
159
|
+
|
|
160
|
+
def update_file(rel_path: str, pattern: str, replacement: str, dry_run: bool = False) -> bool:
|
|
161
|
+
"""Performs regex replacement within a target file to update version strings.
|
|
162
|
+
|
|
163
|
+
Args:
|
|
164
|
+
rel_path: Relative path to the target file from repo root.
|
|
165
|
+
pattern: Regular expression pattern matching existing version occurrences.
|
|
166
|
+
replacement: String replacement containing the new version.
|
|
167
|
+
dry_run: If True, previews changes without writing to disk.
|
|
168
|
+
|
|
169
|
+
Returns:
|
|
170
|
+
True if matches were found and updated.
|
|
171
|
+
"""
|
|
172
|
+
full_path = os.path.join(REPO_ROOT, rel_path)
|
|
173
|
+
if not os.path.exists(full_path):
|
|
174
|
+
print(f" [WARN] File not found: {rel_path}")
|
|
175
|
+
return False
|
|
176
|
+
|
|
177
|
+
with open(full_path, "r", encoding="utf-8") as f:
|
|
178
|
+
content = f.read()
|
|
179
|
+
|
|
180
|
+
new_content, count = re.subn(pattern, replacement, content)
|
|
181
|
+
if count == 0:
|
|
182
|
+
print(f" [SKIP] No pattern match in {rel_path}")
|
|
183
|
+
return False
|
|
184
|
+
|
|
185
|
+
if not dry_run and full_path not in ORIGINAL_SNAPSHOTS:
|
|
186
|
+
ORIGINAL_SNAPSHOTS[full_path] = content
|
|
187
|
+
|
|
188
|
+
if not dry_run:
|
|
189
|
+
with open(full_path, "w", encoding="utf-8", newline="\n") as f:
|
|
190
|
+
f.write(new_content)
|
|
191
|
+
print(f" [UPDATED] {rel_path} ({count} occurrence{'s' if count > 1 else ''})")
|
|
192
|
+
else:
|
|
193
|
+
print(f" [DRY-RUN] Would update {rel_path} ({count} occurrence{'s' if count > 1 else ''})")
|
|
194
|
+
return True
|
|
195
|
+
|
|
196
|
+
def run_tests() -> bool:
|
|
197
|
+
"""Executes the test suite and 10 DoD Quality Gates before release.
|
|
198
|
+
|
|
199
|
+
Returns:
|
|
200
|
+
True if all tests and gates pass.
|
|
201
|
+
"""
|
|
202
|
+
print("\nπ Running verification suite...")
|
|
203
|
+
cmd = [sys.executable, "-m", "pytest", "tests", "-q"]
|
|
204
|
+
try:
|
|
205
|
+
res = subprocess.run(cmd, cwd=REPO_ROOT, timeout=240.0)
|
|
206
|
+
if res.returncode != 0:
|
|
207
|
+
print("β Unit tests failed! Aborting release.")
|
|
208
|
+
return False
|
|
209
|
+
print("β
All unit tests PASSED.")
|
|
210
|
+
except subprocess.TimeoutExpired:
|
|
211
|
+
print("β Unit tests timed out after 240s! Aborting release.")
|
|
212
|
+
return False
|
|
213
|
+
|
|
214
|
+
verify_script = os.path.join(REPO_ROOT, "tools", "verify_all.py")
|
|
215
|
+
try:
|
|
216
|
+
res_verify = subprocess.run([sys.executable, verify_script], cwd=REPO_ROOT, timeout=240.0)
|
|
217
|
+
if res_verify.returncode != 0:
|
|
218
|
+
print("β Quality Gates failed! Aborting release.")
|
|
219
|
+
return False
|
|
220
|
+
print("β
10 Quality Gates DoD PASSED.")
|
|
221
|
+
except subprocess.TimeoutExpired:
|
|
222
|
+
print("β Quality Gates timed out after 240s! Aborting release.")
|
|
223
|
+
return False
|
|
224
|
+
return True
|
|
225
|
+
|
|
226
|
+
def git_commit_and_tag(version: str, push: bool = False):
|
|
227
|
+
"""Creates a conventional Git release commit and tags the repository.
|
|
228
|
+
|
|
229
|
+
Args:
|
|
230
|
+
version: Target version string.
|
|
231
|
+
push: If True, pushes the commit and tag to git remote origin.
|
|
232
|
+
"""
|
|
233
|
+
tag_name = f"v{version}"
|
|
234
|
+
|
|
235
|
+
# Pre-check: warn about untracked files
|
|
236
|
+
try:
|
|
237
|
+
status_res = subprocess.run(["git", "status", "--porcelain"], cwd=REPO_ROOT, capture_output=True, text=True, timeout=15.0)
|
|
238
|
+
untracked = [line for line in status_res.stdout.splitlines() if line.startswith("??")]
|
|
239
|
+
if untracked:
|
|
240
|
+
print(f"β οΈ Warning: Detected {len(untracked)} untracked file(s). Note that 'git add -u' only stages modified tracked files.")
|
|
241
|
+
except Exception as err:
|
|
242
|
+
_ = err
|
|
243
|
+
|
|
244
|
+
print(f"\nπ¦ Creating Git commit and tag {tag_name}...")
|
|
245
|
+
subprocess.run(["git", "add", "-u"], cwd=REPO_ROOT, check=True, timeout=30.0)
|
|
246
|
+
subprocess.run(["git", "commit", "-m", f"chore(release): bump version to {tag_name}"], cwd=REPO_ROOT, check=True, timeout=30.0)
|
|
247
|
+
|
|
248
|
+
# Check if tag already exists before creating
|
|
249
|
+
tag_check = subprocess.run(["git", "tag", "-l", tag_name], cwd=REPO_ROOT, capture_output=True, text=True, timeout=15.0)
|
|
250
|
+
if tag_check.stdout.strip():
|
|
251
|
+
print(f"β οΈ Tag {tag_name} already exists locally. Reusing existing tag.")
|
|
252
|
+
else:
|
|
253
|
+
subprocess.run(["git", "tag", tag_name], cwd=REPO_ROOT, check=True, timeout=30.0)
|
|
254
|
+
print(f"β
Git commit and tag {tag_name} created.")
|
|
255
|
+
|
|
256
|
+
if push:
|
|
257
|
+
print("π Pushing commit and tags to remote origin...")
|
|
258
|
+
res = subprocess.run(["git", "branch", "--show-current"], cwd=REPO_ROOT, stdout=subprocess.PIPE, text=True, timeout=30.0)
|
|
259
|
+
cur_branch = res.stdout.strip()
|
|
260
|
+
if cur_branch == "develop":
|
|
261
|
+
try:
|
|
262
|
+
subprocess.run(["git", "checkout", "main"], cwd=REPO_ROOT, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL, timeout=30.0)
|
|
263
|
+
subprocess.run(["git", "merge", "develop", "--ff-only"], cwd=REPO_ROOT, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL, timeout=30.0)
|
|
264
|
+
subprocess.run(["git", "checkout", "develop"], cwd=REPO_ROOT, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL, timeout=30.0)
|
|
265
|
+
subprocess.run(["git", "push", "origin", "develop", "main", "--tags"], cwd=REPO_ROOT, check=True, timeout=60.0)
|
|
266
|
+
except Exception:
|
|
267
|
+
subprocess.run(["git", "push", "origin", "HEAD", "--tags"], cwd=REPO_ROOT, check=True, timeout=60.0)
|
|
268
|
+
else:
|
|
269
|
+
subprocess.run(["git", "push", "origin", "HEAD", "--tags"], cwd=REPO_ROOT, check=True, timeout=60.0)
|
|
270
|
+
print("β
Remote origin synchronized.")
|
|
271
|
+
|
|
272
|
+
def main():
|
|
273
|
+
"""CLI entrypoint for bumping Synapse Hub version synchronously across manifests."""
|
|
274
|
+
parser = argparse.ArgumentParser(description="Atomic Universal Version Bumper for Synapse Hub")
|
|
275
|
+
parser.add_argument("action", nargs="?", default="patch", help="patch | minor | major | <explicit_version> (default: patch)")
|
|
276
|
+
parser.add_argument("--dry-run", action="store_true", help="Preview version changes without writing files")
|
|
277
|
+
parser.add_argument("--no-test", action="store_true", help="Skip running test suite after bumping")
|
|
278
|
+
parser.add_argument("--commit", action="store_true", help="Auto-commit changes with conventional message")
|
|
279
|
+
parser.add_argument("--tag", action="store_true", help="Create Git tag v<version>")
|
|
280
|
+
parser.add_argument("--push", action="store_true", help="Push commit and tags to Git remote")
|
|
281
|
+
|
|
282
|
+
args = parser.parse_args()
|
|
283
|
+
|
|
284
|
+
current_ver = get_current_version()
|
|
285
|
+
new_ver = calculate_next_version(current_ver, args.action)
|
|
286
|
+
|
|
287
|
+
print("======================================================================")
|
|
288
|
+
print(" SYNAPSE HUB β ATOMIC UNIVERSAL VERSION BUMPER ")
|
|
289
|
+
print("======================================================================")
|
|
290
|
+
print(f" Current Version : {current_ver}")
|
|
291
|
+
print(f" Target Version : {new_ver} ({args.action})")
|
|
292
|
+
print(f" Mode : {'DRY RUN (Preview)' if args.dry_run else 'APPLY CHANGES'}")
|
|
293
|
+
print("======================================================================")
|
|
294
|
+
|
|
295
|
+
# Pre-flight baseline verification (ensure starting state is clean and passing)
|
|
296
|
+
if not args.no_test and not args.dry_run:
|
|
297
|
+
print("\nπ Running pre-flight baseline verification...")
|
|
298
|
+
if not run_tests():
|
|
299
|
+
print("β Baseline test suite or Quality Gates failed! Zero files modified on disk.")
|
|
300
|
+
sys.exit(1)
|
|
301
|
+
|
|
302
|
+
# 1. package.json
|
|
303
|
+
update_json_root_version("package.json", new_ver, args.dry_run)
|
|
304
|
+
|
|
305
|
+
# 1b. plugin.json
|
|
306
|
+
update_json_root_version("plugin.json", new_ver, args.dry_run)
|
|
307
|
+
|
|
308
|
+
# 1c. editors/vscode/package.json
|
|
309
|
+
update_json_root_version("editors/vscode/package.json", new_ver, args.dry_run)
|
|
310
|
+
|
|
311
|
+
# 2. pyproject.toml
|
|
312
|
+
update_file("pyproject.toml", r'(?m)^(\s*version\s*=\s*")[^"]+(")', rf"\g<1>{new_ver}\g<2>", args.dry_run)
|
|
313
|
+
|
|
314
|
+
# 3. skills_manifest.json
|
|
315
|
+
update_json_root_version("skills_manifest.json", new_ver, args.dry_run)
|
|
316
|
+
|
|
317
|
+
# 3b. synapse.config.json
|
|
318
|
+
update_json_root_version("synapse.config.json", new_ver, args.dry_run)
|
|
319
|
+
|
|
320
|
+
# 3c. agentskills.json
|
|
321
|
+
update_json_root_version("agentskills.json", new_ver, args.dry_run)
|
|
322
|
+
|
|
323
|
+
# 4. tools/cli.py
|
|
324
|
+
update_file("tools/cli.py", r'(version\s*=\s*")[^"]+(")', rf"\g<1>{new_ver}\g<2>", args.dry_run)
|
|
325
|
+
|
|
326
|
+
# 5. tools/mcp_server.py
|
|
327
|
+
update_file("tools/mcp_server.py", r'(SERVER_VERSION\s*=\s*")[^"]+(")', rf"\g<1>{new_ver}\g<2>", args.dry_run)
|
|
328
|
+
|
|
329
|
+
# 6. tools/browser_helpers.js
|
|
330
|
+
update_file("tools/browser_helpers.js", r"(__version === ')[^']+(')", rf"\g<1>{new_ver}\g<2>", args.dry_run)
|
|
331
|
+
update_file("tools/browser_helpers.js", r"(__version:\s*')[^']+(')", rf"\g<1>{new_ver}\g<2>", args.dry_run)
|
|
332
|
+
|
|
333
|
+
# 7. tools/mcp_excel_server.py & tools/mcp_docx_server.py
|
|
334
|
+
update_file("tools/mcp_excel_server.py", r'(SERVER_VERSION\s*=\s*")[^"]+(")', rf"\g<1>{new_ver}\g<2>", args.dry_run)
|
|
335
|
+
update_file("tools/mcp_excel_server.py", r'("serverInfo":\s*\{[^}]*"version":\s*")[^"]+(")', rf"\g<1>{new_ver}\g<2>", args.dry_run)
|
|
336
|
+
update_file("tools/mcp_docx_server.py", r'(SERVER_VERSION\s*=\s*")[^"]+(")', rf"\g<1>{new_ver}\g<2>", args.dry_run)
|
|
337
|
+
update_file("tools/mcp_docx_server.py", r'("serverInfo":\s*\{[^}]*"version":\s*")[^"]+(")', rf"\g<1>{new_ver}\g<2>", args.dry_run)
|
|
338
|
+
|
|
339
|
+
# 8. docs/ARCHITECTURE.md & docs/ARCHITECTURE.en.md
|
|
340
|
+
update_file("docs/ARCHITECTURE.md", r'(>\s*\*\*Version:\*\*\s*`)[^`]+(`)', rf"\g<1>{new_ver}\g<2>", args.dry_run)
|
|
341
|
+
update_file("docs/ARCHITECTURE.en.md", r'(>\s*\*\*Version:\*\*\s*`)[^`]+(`)', rf"\g<1>{new_ver}\g<2>", args.dry_run)
|
|
342
|
+
|
|
343
|
+
# 9. README.md & README.en.md (Documentation headings and badges)
|
|
344
|
+
update_file("README.md", r'(PhiΓͺn bαΊ£n(?: Hub)?:\*\*\s*`v)[^`]+(`)', rf"\g<1>{new_ver}\g<2>", args.dry_run)
|
|
345
|
+
update_file("README.md", r'((?:Hub )?Version:\*\*\s*`v)[^`]+(`)', rf"\g<1>{new_ver}\g<2>", args.dry_run)
|
|
346
|
+
update_file("README.md", r'(Intelligence Core v)[^")\]]+', rf"\g<1>{new_ver}", args.dry_run)
|
|
347
|
+
update_file("README.md", r'(rev:\s*v)[0-9]+\.[0-9]+\.[0-9]+', rf"\g<1>{new_ver}", args.dry_run)
|
|
348
|
+
update_file("README.md", r'(Synapse Hub \(Core v)[0-9]+\.[0-9]+\.[0-9]+(\))', rf"\g<1>{new_ver}\g<2>", args.dry_run)
|
|
349
|
+
update_file("README.en.md", r'((?:Hub )?Version:\*\*\s*`v)[^`]+(`)', rf"\g<1>{new_ver}\g<2>", args.dry_run)
|
|
350
|
+
update_file("README.en.md", r'(Intelligence Core v)[^")\]]+', rf"\g<1>{new_ver}", args.dry_run)
|
|
351
|
+
update_file("README.en.md", r'(rev:\s*v)[0-9]+\.[0-9]+\.[0-9]+', rf"\g<1>{new_ver}", args.dry_run)
|
|
352
|
+
update_file("README.en.md", r'(Synapse Hub \(Core v)[0-9]+\.[0-9]+\.[0-9]+(\))', rf"\g<1>{new_ver}\g<2>", args.dry_run)
|
|
353
|
+
|
|
354
|
+
# 9b. SECURITY.md
|
|
355
|
+
major, minor, _, _ = parse_semver(new_ver)
|
|
356
|
+
current_branch = f"{major}.{minor}.x"
|
|
357
|
+
update_file("SECURITY.md", r'(\|\s*`)[0-9]+\.[0-9]+\.x(`\s*\|\s*β
)', rf"\g<1>{current_branch}\g<2>", args.dry_run)
|
|
358
|
+
|
|
359
|
+
# 10. tools/__init__.py
|
|
360
|
+
update_file("tools/__init__.py", r'(__version__\s*=\s*")[^"]+(")', rf"\g<1>{new_ver}\g<2>", args.dry_run)
|
|
361
|
+
|
|
362
|
+
# 10b. tools/ui_server.py
|
|
363
|
+
update_file("tools/ui_server.py", r'("version":\s*")[0-9]+\.[0-9]+\.[0-9]+(")', rf"\g<1>{new_ver}\g<2>", args.dry_run)
|
|
364
|
+
|
|
365
|
+
# 11. tools/welcome_page.py
|
|
366
|
+
update_file("tools/welcome_page.py", r'("version":\s*")[^"]+(")', rf"\g<1>{new_ver}\g<2>", args.dry_run)
|
|
367
|
+
|
|
368
|
+
# 12. tools/dashboard_generator.py
|
|
369
|
+
update_file("tools/dashboard_generator.py", r'(Synapse-Hub v)[0-9]+\.[0-9]+\.[0-9]+', rf"\g<1>{new_ver}", args.dry_run)
|
|
370
|
+
|
|
371
|
+
# 13. tools/update_sentinel.py
|
|
372
|
+
update_file("tools/update_sentinel.py", r'(\.get\("version",\s*")[^"]+(")', rf"\g<1>{new_ver}\g<2>", args.dry_run)
|
|
373
|
+
update_file("tools/update_sentinel.py", r'(return\s*")[0-9]+\.[0-9]+\.[0-9]+(")', rf"\g<1>{new_ver}\g<2>", args.dry_run)
|
|
374
|
+
|
|
375
|
+
# 14. CHANGELOG.md
|
|
376
|
+
cl_path = os.path.join(REPO_ROOT, "CHANGELOG.md")
|
|
377
|
+
if os.path.exists(cl_path) and not args.dry_run:
|
|
378
|
+
try:
|
|
379
|
+
with open(cl_path, "r", encoding="utf-8") as f:
|
|
380
|
+
cl_text = f.read()
|
|
381
|
+
if cl_path not in ORIGINAL_SNAPSHOTS:
|
|
382
|
+
ORIGINAL_SNAPSHOTS[cl_path] = cl_text
|
|
383
|
+
if f"## [{new_ver}]" not in cl_text:
|
|
384
|
+
from datetime import date
|
|
385
|
+
today_str = date.today().isoformat()
|
|
386
|
+
new_block = f"---\n\n## [{new_ver}] - {today_str}\n\n### Changed\n- Maintenance & version release v{new_ver}.\n\n"
|
|
387
|
+
cl_text = re.sub(r'(?m)^---\s*\n\s*##\s*\[', new_block + "## [", cl_text, count=1)
|
|
388
|
+
with open(cl_path, "w", encoding="utf-8") as f:
|
|
389
|
+
f.write(cl_text)
|
|
390
|
+
print(f" [UPDATED] CHANGELOG.md (v{new_ver} entry added)")
|
|
391
|
+
except Exception as e:
|
|
392
|
+
print(f" [WARN] CHANGELOG.md update notice: {e}")
|
|
393
|
+
|
|
394
|
+
if args.dry_run:
|
|
395
|
+
print("\n[INFO] Dry-run completed. No files modified on disk.")
|
|
396
|
+
return
|
|
397
|
+
|
|
398
|
+
# Post-bump tests verification (validate that bumped files pass all gates and version sync)
|
|
399
|
+
if not args.no_test:
|
|
400
|
+
if not run_tests():
|
|
401
|
+
print("β Post-bump verification failed! Rolling back all version changes...")
|
|
402
|
+
rollback_all_files()
|
|
403
|
+
sys.exit(1)
|
|
404
|
+
|
|
405
|
+
# Git operations
|
|
406
|
+
if args.commit or args.push:
|
|
407
|
+
try:
|
|
408
|
+
git_commit_and_tag(new_ver, push=args.push)
|
|
409
|
+
except Exception as e:
|
|
410
|
+
print(f"β Git commit or tag operation failed: {e}")
|
|
411
|
+
rollback_all_files()
|
|
412
|
+
sys.exit(1)
|
|
413
|
+
|
|
414
|
+
print("\n======================================================================")
|
|
415
|
+
print(f"π VERSION BUMP COMPLETE: v{current_ver} β v{new_ver}")
|
|
416
|
+
print("======================================================================")
|
|
417
|
+
print("Next steps:")
|
|
418
|
+
print(" β’ Publish to NPM : npm publish")
|
|
419
|
+
print(" β’ Or Git Push : git push origin HEAD --tags")
|
|
420
|
+
print("======================================================================")
|
|
421
|
+
|
|
422
|
+
if __name__ == "__main__":
|
|
423
|
+
main()
|