@teevee98/synapse-hub 0.0.0-stage β†’ 3.8.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (369) hide show
  1. package/.agents/agents/api-engineer.md +67 -0
  2. package/.agents/agents/failure-analyst.md +75 -0
  3. package/.agents/agents/live-explorer.md +70 -0
  4. package/.agents/agents/orchestrator.md +104 -0
  5. package/.agents/agents/perf-engineer.md +74 -0
  6. package/.agents/agents/pom-crafter.md +112 -0
  7. package/.agents/agents/quality-gatekeeper.md +87 -0
  8. package/.agents/agents/test-designer.md +73 -0
  9. package/.agents/agents/test-runner.md +67 -0
  10. package/.agents/rules/author-integrity-guard.md +33 -0
  11. package/.agents/rules/communication-style.md +18 -0
  12. package/.agents/rules/context-engineering.md +37 -0
  13. package/.agents/rules/git-push-protocol.md +33 -0
  14. package/.agents/rules/graphify.md +14 -0
  15. package/.agents/rules/lessons-learned.md +25 -0
  16. package/.agents/rules/mandatory-playwright-live.md +25 -0
  17. package/.agents/rules/mobile_appium_rules.md +43 -0
  18. package/.agents/rules/performance_testing_rules.md +35 -0
  19. package/.agents/rules/skill-precedence.md +29 -0
  20. package/.agents/rules/systematic-debugging.md +36 -0
  21. package/.agents/skills/actor-qa-swarm/SKILL.md +77 -0
  22. package/.agents/skills/actor-qa-swarm/examples/broker_sharding_sample.json +12 -0
  23. package/.agents/skills/agent-orchestration-multi-agent-optimize/SKILL.md +88 -0
  24. package/.agents/skills/agent-orchestration-multi-agent-optimize/examples/swarm_workload_config.json +15 -0
  25. package/.agents/skills/agentless-qa-repair/SKILL.md +69 -0
  26. package/.agents/skills/agentless-qa-repair/examples/healing_report_sample.json +17 -0
  27. package/.agents/skills/agentless-qa-repair/examples/three_phase_repair_workflow.md +40 -0
  28. package/.agents/skills/antigravity-test-sentinel/SKILL.md +63 -0
  29. package/.agents/skills/antigravity-test-sentinel/examples/dod_gate_policy.json +11 -0
  30. package/.agents/skills/antigravity-test-sentinel/examples/sprint_dod_enforcement.md +47 -0
  31. package/.agents/skills/api-network-mocking-interception/SKILL.md +142 -0
  32. package/.agents/skills/api-network-mocking-interception/examples/network_route_stub.json +9 -0
  33. package/.agents/skills/api-spec-to-e2e-matrix/SKILL.md +80 -0
  34. package/.agents/skills/api-spec-to-e2e-matrix/examples/sample_openapi.json +19 -0
  35. package/.agents/skills/architecture-decision-records/SKILL.md +64 -0
  36. package/.agents/skills/architecture-decision-records/examples/0001-record-architecture-decisions.md +12 -0
  37. package/.agents/skills/auth-session-and-cookie-manager/SKILL.md +75 -0
  38. package/.agents/skills/auth-session-and-cookie-manager/examples/multi_role_auth_matrix.md +70 -0
  39. package/.agents/skills/auth-session-and-cookie-manager/examples/storage_state_sample.json +11 -0
  40. package/.agents/skills/backend-load-and-stress-patterns/SKILL.md +85 -0
  41. package/.agents/skills/backend-load-and-stress-patterns/examples/k6_load_test_sample.js +13 -0
  42. package/.agents/skills/backend-load-and-stress-patterns/references/k6_load_template.js +82 -0
  43. package/.agents/skills/bats-testing-patterns/SKILL.md +100 -0
  44. package/.agents/skills/bats-testing-patterns/examples/cli_runner_test.bats +6 -0
  45. package/.agents/skills/bats-testing-patterns/resources/implementation-playbook.md +614 -0
  46. package/.agents/skills/clean-pom-crafter/SKILL.md +110 -0
  47. package/.agents/skills/clean-pom-crafter/examples/standard_test_case.groovy +28 -0
  48. package/.agents/skills/clean-pom-crafter/references/pom_patterns.groovy +138 -0
  49. package/.agents/skills/code-refactoring-refactor-clean/SKILL.md +64 -0
  50. package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_page_sample.groovy +9 -0
  51. package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_playwright_pom.ts +52 -0
  52. package/.agents/skills/code-refactoring-refactor-clean/resources/implementation-playbook.md +881 -0
  53. package/.agents/skills/consumer-driven-contract-testing/SKILL.md +147 -0
  54. package/.agents/skills/consumer-driven-contract-testing/examples/order_service_pact.json +45 -0
  55. package/.agents/skills/db-state-verifier-and-seeder/SKILL.md +123 -0
  56. package/.agents/skills/db-state-verifier-and-seeder/examples/db_fixture_seed.json +12 -0
  57. package/.agents/skills/e2e-testing-patterns/SKILL.md +103 -0
  58. package/.agents/skills/e2e-testing-patterns/examples/playwright_sharded_config.ts +12 -0
  59. package/.agents/skills/e2e-testing-patterns/resources/implementation-playbook.md +522 -0
  60. package/.agents/skills/event-stream-qa-orchestrator/SKILL.md +79 -0
  61. package/.agents/skills/event-stream-qa-orchestrator/examples/timeline_sample.jsonl +2 -0
  62. package/.agents/skills/failure-autopsy-and-healing/SKILL.md +66 -0
  63. package/.agents/skills/failure-autopsy-and-healing/examples/closed_loop_healing_walkthrough.md +48 -0
  64. package/.agents/skills/failure-autopsy-and-healing/examples/sample_junit_failure.xml +8 -0
  65. package/.agents/skills/failure-autopsy-and-healing/references/healing_matrix.md +64 -0
  66. package/.agents/skills/failure-autopsy-and-healing/references/qa_investigation_protocol.md +56 -0
  67. package/.agents/skills/failure-autopsy-and-healing/scripts/triage_failures.sh +83 -0
  68. package/.agents/skills/file-and-report-validator/SKILL.md +90 -0
  69. package/.agents/skills/file-and-report-validator/examples/sample_export_schema.json +14 -0
  70. package/.agents/skills/flaky-test-sentinel-and-quarantine/SKILL.md +114 -0
  71. package/.agents/skills/flaky-test-sentinel-and-quarantine/examples/quarantine_registry.json +11 -0
  72. package/.agents/skills/gherkin-to-suite/SKILL.md +103 -0
  73. package/.agents/skills/gherkin-to-suite/examples/checkout.feature +39 -0
  74. package/.agents/skills/gherkin-to-suite/examples/suite_report_sample.json +334 -0
  75. package/.agents/skills/github-actions-templates/SKILL.md +77 -0
  76. package/.agents/skills/github-actions-templates/examples/matrix_test_pipeline.yml +8 -0
  77. package/.agents/skills/graphify-impact-analyzer/SKILL.md +76 -0
  78. package/.agents/skills/graphify-impact-analyzer/examples/dependency_blast_radius.json +8 -0
  79. package/.agents/skills/katalon-cli-runner/SKILL.md +76 -0
  80. package/.agents/skills/katalon-cli-runner/examples/headless_kre_exec.sh +3 -0
  81. package/.agents/skills/katalon-cli-runner/references/groovy-patterns.md +209 -0
  82. package/.agents/skills/katalon-cli-runner/references/katalon-api.md +155 -0
  83. package/.agents/skills/katalon-cli-runner/references/runner_commands.md +67 -0
  84. package/.agents/skills/lam-script-generator/SKILL.md +123 -0
  85. package/.agents/skills/lam-script-generator/examples/user_story_sample.md +8 -0
  86. package/.agents/skills/lean-code-ladder/SKILL.md +94 -0
  87. package/.agents/skills/lean-code-ladder/examples/ladder_walkthrough.md +37 -0
  88. package/.agents/skills/lean-impact-scoreboard/SKILL.md +48 -0
  89. package/.agents/skills/lean-impact-scoreboard/examples/sample_benchmark_gain.md +20 -0
  90. package/.agents/skills/lean-impact-scoreboard/examples/sample_scoreboard.md +15 -0
  91. package/.agents/skills/meta-prompt-crafter/SKILL.md +107 -0
  92. package/.agents/skills/meta-prompt-crafter/examples/qa_prompt_template.md +35 -0
  93. package/.agents/skills/mipro-prompt-compiler/SKILL.md +59 -0
  94. package/.agents/skills/mipro-prompt-compiler/examples/compiled_module_sample.json +22 -0
  95. package/.agents/skills/mipro-prompt-compiler/examples/dspy_assertion_optimizer_case.md +46 -0
  96. package/.agents/skills/mobile-appium-som/SKILL.md +88 -0
  97. package/.agents/skills/mobile-appium-som/examples/BaseScreen.java +88 -0
  98. package/.agents/skills/mobile-appium-som/examples/LoginScreen.java +46 -0
  99. package/.agents/skills/mobile-appium-som/examples/TC_MobileLogin.java +43 -0
  100. package/.agents/skills/persistent-planning-files/SKILL.md +108 -0
  101. package/.agents/skills/persistent-planning-files/examples/task_plan_example.md +56 -0
  102. package/.agents/skills/playwright-live-interaction/SKILL.md +131 -0
  103. package/.agents/skills/playwright-live-interaction/examples/live_probe_script.js +5 -0
  104. package/.agents/skills/playwright-live-interaction/references/advanced_superpowers.md +160 -0
  105. package/.agents/skills/playwright-live-interaction/references/compact_accessibility_snapshots.md +75 -0
  106. package/.agents/skills/playwright-live-interaction/references/recipes.md +388 -0
  107. package/.agents/skills/playwright-live-interaction/references/swarm_orchestration.md +134 -0
  108. package/.agents/skills/playwright-webapp-testing/SKILL.md +93 -0
  109. package/.agents/skills/playwright-webapp-testing/examples/server_lifecycle_playwright.py +63 -0
  110. package/.agents/skills/qa-aci-interface/SKILL.md +67 -0
  111. package/.agents/skills/qa-aci-interface/examples/surgical_code_window_walkthrough.md +40 -0
  112. package/.agents/skills/qa-aci-interface/examples/surgical_edit_sample.json +12 -0
  113. package/.agents/skills/qa-memory-os/SKILL.md +80 -0
  114. package/.agents/skills/qa-memory-os/examples/archival_memory_sample.json +21 -0
  115. package/.agents/skills/rbt-manual-testing/SKILL.md +137 -0
  116. package/.agents/skills/rbt-manual-testing/examples/checkout_rbt_manual_suite.md +25 -0
  117. package/.agents/skills/rbt-manual-testing/references/field_validation_checklist.md +29 -0
  118. package/.agents/skills/repo-quality-audit/SKILL.md +68 -0
  119. package/.agents/skills/repo-quality-audit/examples/sample_audit_walkthrough.md +15 -0
  120. package/.agents/skills/repo-quality-audit/examples/sample_repo_audit.md +33 -0
  121. package/.agents/skills/review-spec/SKILL.md +60 -0
  122. package/.agents/skills/review-spec/examples/pocock_grilling_decision_rubric.md +40 -0
  123. package/.agents/skills/review-spec/examples/sample_spec_review.md +33 -0
  124. package/.agents/skills/security-dast-sentinel/SKILL.md +119 -0
  125. package/.agents/skills/security-dast-sentinel/examples/dast_scan_config.json +10 -0
  126. package/.agents/skills/security-dast-sentinel/references/AI-AND-LLM.md +113 -0
  127. package/.agents/skills/security-dast-sentinel/references/ATTACK-CLASSES.md +89 -0
  128. package/.agents/skills/security-dast-sentinel/references/dast_recipes.ts +33 -0
  129. package/.agents/skills/self-healing-locator/SKILL.md +86 -0
  130. package/.agents/skills/self-healing-locator/examples/aom_diff_sample.json +16 -0
  131. package/.agents/skills/senior-code-review/SKILL.md +108 -0
  132. package/.agents/skills/senior-code-review/examples/sample_review_walkthrough.md +29 -0
  133. package/.agents/skills/skillspector-security-guard/SKILL.md +57 -0
  134. package/.agents/skills/skillspector-security-guard/examples/audit_threat_vectors_report.json +35 -0
  135. package/.agents/skills/skillspector-security-guard/examples/safe_mcp_config.json +12 -0
  136. package/.agents/skills/surgical-coding-principles/SKILL.md +89 -0
  137. package/.agents/skills/surgical-coding-principles/examples/surgical_vs_scope_creep.md +46 -0
  138. package/.agents/skills/synthetic-test-data-generator/SKILL.md +135 -0
  139. package/.agents/skills/synthetic-test-data-generator/examples/idempotent_data_recipe.json +9 -0
  140. package/.agents/skills/systematic-debugging/SKILL.md +100 -0
  141. package/.agents/skills/systematic-debugging/examples/four_phase_case.md +44 -0
  142. package/.agents/skills/technical-debt-harvester/SKILL.md +70 -0
  143. package/.agents/skills/technical-debt-harvester/examples/sample_debt_ledger.md +25 -0
  144. package/.agents/skills/technical-debt-harvester/examples/sample_ledger_output.md +20 -0
  145. package/.agents/skills/test-driven-development/SKILL.md +114 -0
  146. package/.agents/skills/test-driven-development/examples/red_green_refactor_qa.md +78 -0
  147. package/.agents/skills/token-and-context-optimizer/SKILL.md +70 -0
  148. package/.agents/skills/token-and-context-optimizer/examples/distilled_log_sample.txt +3 -0
  149. package/.agents/skills/token-and-context-optimizer/references/context_engineering_guide.md +49 -0
  150. package/.agents/skills/tot-exploratory-testing/SKILL.md +59 -0
  151. package/.agents/skills/tot-exploratory-testing/examples/payment_gateway_tot_tree.json +62 -0
  152. package/.agents/skills/tot-exploratory-testing/examples/tot_graph_sample.json +35 -0
  153. package/.agents/skills/verification-before-completion/SKILL.md +100 -0
  154. package/.agents/skills/verification-before-completion/examples/evidence_log_example.md +46 -0
  155. package/.agents/skills/visual-regression-sentinel/SKILL.md +82 -0
  156. package/.agents/skills/visual-regression-sentinel/examples/visual_mask_rules.json +9 -0
  157. package/.agents/skills/wcag-audit-patterns/SKILL.md +77 -0
  158. package/.agents/skills/wcag-audit-patterns/examples/wcag_compliance_checklist.json +10 -0
  159. package/.agents/skills/wcag-audit-patterns/resources/implementation-playbook.md +541 -0
  160. package/.agents/skills/web-agent-gym-benchmarking/SKILL.md +62 -0
  161. package/.agents/skills/web-agent-gym-benchmarking/examples/benchmark_report_sample.json +22 -0
  162. package/.agents/skills/web-agent-gym-benchmarking/examples/enterprise_tasks_suite.json +38 -0
  163. package/.agents/skills/web-vitals-and-performance-profiler/SKILL.md +65 -0
  164. package/.agents/skills/web-vitals-and-performance-profiler/examples/cwv_budget_policy.json +6 -0
  165. package/.agents/skills/web-vitals-and-performance-profiler/examples/playwright_cwv_profiler_fixture.ts +118 -0
  166. package/.agents/templates/completion_report.md +57 -0
  167. package/.agents/workflows/analyze_requirement_document.md +18 -0
  168. package/.agents/workflows/export_testcases_excel.md +32 -0
  169. package/.agents/workflows/generate_combinatorial_test_data.md +28 -0
  170. package/.agents/workflows/generate_cross_module_test_plan.md +37 -0
  171. package/.agents/workflows/generate_manual_testcases_rbt.md +56 -0
  172. package/.agents/workflows/generate_requirements_from_website.md +25 -0
  173. package/.agents/workflows/generate_testcases_from_requirements.md +21 -0
  174. package/.agents/workflows/graphify.md +10 -0
  175. package/.agents/workflows/test-impact.md +15 -0
  176. package/.agents/workflows/verify.md +34 -0
  177. package/.cursor/rules/agents.mdc +16 -0
  178. package/.cursor/rules/language.mdc +7 -0
  179. package/.cursor/rules/synapse-qa.mdc +24 -0
  180. package/.cursorrules +27 -0
  181. package/.dockerignore +53 -0
  182. package/.pre-commit-hooks.yaml +14 -0
  183. package/.windsurfrules +26 -0
  184. package/AGENTS.md +86 -0
  185. package/CLAUDE.md +54 -0
  186. package/Dockerfile +81 -0
  187. package/LICENSE +52 -0
  188. package/NOTICE +264 -0
  189. package/README.en.md +172 -0
  190. package/README.md +171 -2
  191. package/action.yml +51 -0
  192. package/agentskills.json +16 -0
  193. package/bin/agent-qa.js +138 -0
  194. package/docker-compose.yml +74 -0
  195. package/docs/ARCHITECTURE.en.md +197 -0
  196. package/docs/ARCHITECTURE.md +198 -0
  197. package/docs/CI_CD_INTEGRATION.en.md +170 -0
  198. package/docs/CI_CD_INTEGRATION.md +170 -0
  199. package/docs/CLI_REFERENCE.en.md +175 -0
  200. package/docs/CLI_REFERENCE.md +177 -0
  201. package/docs/CONTRIBUTING.en.md +49 -0
  202. package/docs/CONTRIBUTING.md +49 -0
  203. package/docs/PERFORMANCE_AUDIT_REPORT.md +784 -0
  204. package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +127 -0
  205. package/docs/QUALITY_GATES.en.md +121 -0
  206. package/docs/QUALITY_GATES.md +121 -0
  207. package/docs/TOKEN_QUOTA_PLAYBOOK.md +41 -0
  208. package/docs/TOOL_CATALOG.md +129 -0
  209. package/docs/adopted-ecosystem-tools.md +96 -0
  210. package/docs/research/EXTERNAL_AGENT_SKILLS_SURVEY.md +1062 -0
  211. package/docs/research/agent_skill_training_analysis.md +1359 -0
  212. package/docs/schemas/synapse.config.schema.json +87 -0
  213. package/package.json +94 -4
  214. package/plugin.json +31 -0
  215. package/scripts/generate_skill_examples.py +244 -0
  216. package/scripts/install.ps1 +112 -0
  217. package/scripts/install_global_plugin.ps1 +94 -0
  218. package/scripts/install_global_plugin.sh +49 -0
  219. package/scripts/lint_skills.ps1 +57 -0
  220. package/scripts/package_dist.py +337 -0
  221. package/scripts/setup.sh +59 -0
  222. package/scripts/update_hub.ps1 +19 -0
  223. package/scripts/update_hub.sh +15 -0
  224. package/skills_manifest.json +854 -0
  225. package/synapse.config.json +32 -0
  226. package/templates/PROJECT_AI_GUIDE_TEMPLATE.md +111 -0
  227. package/templates/PROJECT_STATE_TEMPLATE.md +20 -0
  228. package/templates/ai_bridges/CLAUDE.md +54 -0
  229. package/templates/ai_bridges/copilot-instructions.md +20 -0
  230. package/templates/ai_bridges/cursor_synapse_qa.mdc +24 -0
  231. package/templates/ai_bridges/windsurfrules +26 -0
  232. package/templates/ci/github-actions-synapse.yml +95 -0
  233. package/templates/ci/gitlab-ci-synapse.yml +16 -0
  234. package/templates/ui/index.html +1069 -0
  235. package/templates/welcome.html.tmpl +2079 -0
  236. package/tools/.infer_baseline.json +30 -0
  237. package/tools/TOOLS_RUNBOOK.md +1553 -0
  238. package/tools/TOOL_CATALOG.json +1769 -0
  239. package/tools/__init__.py +43 -0
  240. package/tools/_openapi_parser.py +158 -0
  241. package/tools/agent_canary.py +525 -0
  242. package/tools/agentless_patcher.py +417 -0
  243. package/tools/analyze_project.py +258 -0
  244. package/tools/api_drift_sentinel.py +208 -0
  245. package/tools/api_fuzzer.py +762 -0
  246. package/tools/author_integrity.py +184 -0
  247. package/tools/auto_heal.py +271 -0
  248. package/tools/auto_heal_reflexion.py +532 -0
  249. package/tools/autogen_qa_broker.py +844 -0
  250. package/tools/benchmark_swarm_context.py +394 -0
  251. package/tools/browser_helpers.js +746 -0
  252. package/tools/browsergym_eval.py +236 -0
  253. package/tools/bug_reporter.py +252 -0
  254. package/tools/bump_version.py +423 -0
  255. package/tools/cache_resolver.py +1214 -0
  256. package/tools/check_env.py +426 -0
  257. package/tools/check_version_sync.py +256 -0
  258. package/tools/ci_healing_hook.py +126 -0
  259. package/tools/cli.py +1598 -0
  260. package/tools/config_decoupler.py +253 -0
  261. package/tools/contract_validator.py +141 -0
  262. package/tools/core/__init__.py +70 -0
  263. package/tools/core/adapters.py +431 -0
  264. package/tools/core/circuit_breaker.py +263 -0
  265. package/tools/core/cli_runtime.py +66 -0
  266. package/tools/core/file_lock.py +159 -0
  267. package/tools/core/i18n.py +394 -0
  268. package/tools/core/memory_bus.py +905 -0
  269. package/tools/core/process_supervisor.py +332 -0
  270. package/tools/core/telemetry.py +329 -0
  271. package/tools/count_tokens.py +1267 -0
  272. package/tools/create_mock_docx.py +104 -0
  273. package/tools/dashboard_generator.py +2419 -0
  274. package/tools/db_sandbox.py +675 -0
  275. package/tools/debt_harvester.py +237 -0
  276. package/tools/distill_log.py +161 -0
  277. package/tools/dspy_qa_signatures.py +356 -0
  278. package/tools/e2e_flow_prober.py +132 -0
  279. package/tools/export_postman_collection.py +945 -0
  280. package/tools/flaky_detector.py +389 -0
  281. package/tools/fsm_enforcer.py +450 -0
  282. package/tools/fsm_middleware.py +401 -0
  283. package/tools/fuzz_payloads.py +197 -0
  284. package/tools/generate_allure_report.py +88 -0
  285. package/tools/generate_api_matrix.py +193 -0
  286. package/tools/generate_jmx_plan.py +1322 -0
  287. package/tools/generate_sbom.py +252 -0
  288. package/tools/generate_tc_from_story.py +203 -0
  289. package/tools/generate_test_reports.py +133 -0
  290. package/tools/generate_tool_catalog.py +482 -0
  291. package/tools/gherkin_suite.py +758 -0
  292. package/tools/git_pre_commit_guard.py +298 -0
  293. package/tools/goldfish_review.py +366 -0
  294. package/tools/heal/__init__.py +28 -0
  295. package/tools/heal_pr_automator.py +220 -0
  296. package/tools/heuristic_locator_matcher.py +351 -0
  297. package/tools/hub_publisher.py +623 -0
  298. package/tools/humanize_linter.py +438 -0
  299. package/tools/infer_linter.py +977 -0
  300. package/tools/init_config.py +307 -0
  301. package/tools/interview_story.py +116 -0
  302. package/tools/jira_sync.py +566 -0
  303. package/tools/jtl_analyzer.py +474 -0
  304. package/tools/lint/__init__.py +30 -0
  305. package/tools/lint_ai_docs.py +374 -0
  306. package/tools/lookup_tc.py +165 -0
  307. package/tools/lookup_xpath.py +167 -0
  308. package/tools/matrix_sharder.py +148 -0
  309. package/tools/mcp/__init__.py +18 -0
  310. package/tools/mcp_docx_server.ps1 +13 -0
  311. package/tools/mcp_docx_server.py +851 -0
  312. package/tools/mcp_excel_server.ps1 +13 -0
  313. package/tools/mcp_excel_server.py +441 -0
  314. package/tools/mcp_server.py +724 -0
  315. package/tools/md_to_xlsx.py +327 -0
  316. package/tools/micro_mutator.py +887 -0
  317. package/tools/mipro_assertion_tuner.py +210 -0
  318. package/tools/network_mock_shield.py +311 -0
  319. package/tools/newman_analyzer.py +384 -0
  320. package/tools/omni_emitter.py +579 -0
  321. package/tools/omni_parser.py +450 -0
  322. package/tools/omni_transpiler.py +168 -0
  323. package/tools/openxml_guard.py +438 -0
  324. package/tools/output_formatter.py +182 -0
  325. package/tools/package_release.py +325 -0
  326. package/tools/perf/__init__.py +24 -0
  327. package/tools/pinpoint_failure.py +190 -0
  328. package/tools/project_state.py +171 -0
  329. package/tools/qa_event_stream.py +358 -0
  330. package/tools/repo_map.py +346 -0
  331. package/tools/report/__init__.py +32 -0
  332. package/tools/reversible_sandbox.py +344 -0
  333. package/tools/safety_firewall.py +437 -0
  334. package/tools/security_coverage_ledger.py +538 -0
  335. package/tools/security_scanner.py +229 -0
  336. package/tools/senior_code_review.py +393 -0
  337. package/tools/setup_project.py +770 -0
  338. package/tools/skill_collision_guard.py +304 -0
  339. package/tools/skill_profiles.py +217 -0
  340. package/tools/skill_vault.py +481 -0
  341. package/tools/skillspector.py +1278 -0
  342. package/tools/smart_visual_masker.py +132 -0
  343. package/tools/spec_drift_sentinel.py +438 -0
  344. package/tools/swe_qa_aci.py +369 -0
  345. package/tools/synapse_observer.py +485 -0
  346. package/tools/synapse_qa_bench.py +190 -0
  347. package/tools/sync_agent_rules.py +274 -0
  348. package/tools/telemetry_correlator.py +397 -0
  349. package/tools/template_excel_exporter.py +514 -0
  350. package/tools/templates/jmeter-distributed/README.md +54 -0
  351. package/tools/templates/jmeter-distributed/docker-compose.yml +83 -0
  352. package/tools/test_impact.py +419 -0
  353. package/tools/test_memory_os.py +462 -0
  354. package/tools/textgrad_mutation_optimizer.py +237 -0
  355. package/tools/tms_sync_bridge.py +834 -0
  356. package/tools/tot_exploratory_tester.py +239 -0
  357. package/tools/trace_data_flow.py +240 -0
  358. package/tools/traffic_session_converter.py +256 -0
  359. package/tools/trend_analytics.py +314 -0
  360. package/tools/ui_server.py +401 -0
  361. package/tools/universal_ir.py +488 -0
  362. package/tools/update_sentinel.py +383 -0
  363. package/tools/validate_groovy_scripts.py +173 -0
  364. package/tools/verify_all.py +1259 -0
  365. package/tools/visual_diff_canvas.py +143 -0
  366. package/tools/visual_som_helper.py +550 -0
  367. package/tools/watch_mode.py +308 -0
  368. package/tools/wcag_audit.py +239 -0
  369. package/tools/welcome_page.py +290 -0
@@ -0,0 +1,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 11 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("βœ… 11 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()