@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.
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 +171 -0
  190. package/README.md +170 -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 +198 -0
  196. package/docs/ARCHITECTURE.md +199 -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 +174 -0
  200. package/docs/CLI_REFERENCE.md +176 -0
  201. package/docs/CONTRIBUTING.en.md +49 -0
  202. package/docs/CONTRIBUTING.md +49 -0
  203. package/docs/PERFORMANCE_AUDIT_REPORT.md +783 -0
  204. package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +127 -0
  205. package/docs/QUALITY_GATES.en.md +118 -0
  206. package/docs/QUALITY_GATES.md +118 -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 +1358 -0
  212. package/docs/schemas/synapse.config.schema.json +86 -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 +31 -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 +2074 -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 +262 -0
  244. package/tools/api_drift_sentinel.py +208 -0
  245. package/tools/api_fuzzer.py +762 -0
  246. package/tools/author_integrity.py +190 -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 +2403 -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 +306 -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 +725 -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 +1271 -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,623 @@
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/hub_publisher.py — End-to-End Autonomous Hub Release & Publishing Pipeline
8
+
9
+ Orchestrates the 5-step universal release workflow for Synapse Hub:
10
+ 1. [Git Push] Push verified code to origin/main.
11
+ 2. [Git Tag] Create & push semantic version tag (vX.Y.Z).
12
+ 3. [GitHub Release] Generate release notes from commits and create GitHub Release via API.
13
+ 4. [GitHub Packages] Build and publish scoped package (@teevee98/synapse-hub).
14
+ 5. [NPM Registry] Publish package to npmjs.com via OIDC Trusted Publishing and verify live availability.
15
+
16
+ Usage:
17
+ python tools/hub_publisher.py
18
+ python tools/hub_publisher.py --message "feat(core): add new feature"
19
+ python tools/hub_publisher.py --skip-verify
20
+ python tools/hub_publisher.py --dry-run
21
+ """
22
+
23
+ import os
24
+ import sys
25
+ import json
26
+ import re
27
+ import time
28
+ import argparse
29
+ import subprocess
30
+ import urllib.request
31
+ import urllib.error
32
+ from typing import Optional, Tuple, List
33
+
34
+ # Enforce UTF-8 stdout encoding and line buffering for Windows console compatibility
35
+ if hasattr(sys.stdout, 'reconfigure'):
36
+ try:
37
+ sys.stdout.reconfigure(encoding='utf-8', line_buffering=True)
38
+ sys.stderr.reconfigure(encoding='utf-8', line_buffering=True)
39
+ except Exception:
40
+ pass
41
+
42
+ REPO_ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
43
+
44
+ # Terminal ANSI styling
45
+ CYAN = "\033[96m"
46
+ GREEN = "\033[92m"
47
+ YELLOW = "\033[93m"
48
+ RED = "\033[91m"
49
+ BOLD = "\033[1m"
50
+ RESET = "\033[0m"
51
+
52
+
53
+ def log_step(step_num: int, title: str):
54
+ """Outputs a prominent visual header for the current pipeline stage."""
55
+ print(f"\n{CYAN}{BOLD}[STEP {step_num}/5] {title}{RESET}")
56
+ print(f"{CYAN}{'-' * 65}{RESET}")
57
+
58
+
59
+ def log_success(msg: str):
60
+ print(f"{GREEN} [PASS] {msg}{RESET}")
61
+
62
+
63
+ def log_warn(msg: str):
64
+ print(f"{YELLOW} [WARN] {msg}{RESET}")
65
+
66
+
67
+ def log_error(msg: str):
68
+ print(f"{RED} [FAIL] {msg}{RESET}")
69
+
70
+
71
+ def get_current_version() -> str:
72
+ """Extracts canonical semantic version from package.json."""
73
+ pkg_path = os.path.join(REPO_ROOT, "package.json")
74
+ if not os.path.exists(pkg_path):
75
+ raise FileNotFoundError(f"package.json not found at {pkg_path}")
76
+ with open(pkg_path, "r", encoding="utf-8") as f:
77
+ data = json.load(f)
78
+ version = data.get("version")
79
+ if not version:
80
+ raise ValueError("package.json is missing 'version' field.")
81
+ return version.strip()
82
+
83
+
84
+ def get_current_package_name() -> str:
85
+ """Extracts canonical package name from package.json."""
86
+ pkg_path = os.path.join(REPO_ROOT, "package.json")
87
+ if not os.path.exists(pkg_path):
88
+ return "@teevee98/synapse-hub"
89
+ try:
90
+ with open(pkg_path, "r", encoding="utf-8") as f:
91
+ data = json.load(f)
92
+ return data.get("name", "@teevee98/synapse-hub").strip()
93
+ except Exception:
94
+ return "@teevee98/synapse-hub"
95
+
96
+
97
+ try:
98
+ DEFAULT_CMD_TIMEOUT = float(os.environ.get("PUBLISHER_CMD_TIMEOUT", "60.0"))
99
+ except (ValueError, TypeError):
100
+ DEFAULT_CMD_TIMEOUT = 60.0
101
+
102
+
103
+ def get_remote_repo_info() -> Tuple[str, str]:
104
+ """Extracts GitHub owner and repo name from git remote origin URL."""
105
+ try:
106
+ res = subprocess.run(["git", "config", "--get", "remote.origin.url"], cwd=REPO_ROOT, capture_output=True, text=True, check=True, timeout=15.0)
107
+ url = res.stdout.strip()
108
+ # Handles https://github.com/owner/repo.git or git@github.com:owner/repo.git
109
+ m = re.search(r'github\.com[:/]([^/]+)/([^/.]+)(?:\.git)?$', url)
110
+ if m:
111
+ return m.group(1), m.group(2)
112
+ except Exception as e:
113
+ log_warn(f"Could not parse git remote origin URL: {e}")
114
+ return "TeeVee98", "Synapse-Hub"
115
+
116
+
117
+ def get_github_auth_token() -> Optional[str]:
118
+ """Retrieves authenticated GitHub token via git credential helper."""
119
+ token = os.environ.get("GITHUB_TOKEN") or os.environ.get("GH_TOKEN")
120
+ if token:
121
+ return token.strip()
122
+ try:
123
+ proc = subprocess.run(
124
+ ["git", "credential", "fill"],
125
+ input="protocol=https\nhost=github.com\n",
126
+ capture_output=True,
127
+ text=True,
128
+ cwd=REPO_ROOT,
129
+ check=True,
130
+ timeout=5.0
131
+ )
132
+ for line in proc.stdout.splitlines():
133
+ if line.startswith("password="):
134
+ candidate = line.split("=", 1)[1].strip()
135
+ if candidate:
136
+ return candidate
137
+ except Exception as e:
138
+ log_warn(f"git credential fill lookup failed: {e}")
139
+ return None
140
+
141
+
142
+ def execute_cmd(cmd: List[str], error_msg: str, dry_run: bool = False, capture: bool = False, timeout: float = DEFAULT_CMD_TIMEOUT) -> Tuple[int, str]:
143
+ """Executes a subprocess command safely with logging and explicit timeout."""
144
+ cmd_str = " ".join(cmd)
145
+ if dry_run:
146
+ print(f" [DRY-RUN] {cmd_str}")
147
+ return 0, ""
148
+ try:
149
+ res = subprocess.run(cmd, cwd=REPO_ROOT, capture_output=capture, text=True, timeout=timeout)
150
+ if res.returncode != 0:
151
+ log_error(f"{error_msg} (Exit code {res.returncode})")
152
+ if capture and res.stderr:
153
+ print(f" {res.stderr.strip()}")
154
+ return res.returncode, res.stdout or ""
155
+ return 0, res.stdout or ""
156
+ except subprocess.TimeoutExpired as te:
157
+ log_error(f"{error_msg}: Command timed out after {timeout} seconds ({cmd_str})")
158
+ return 124, str(te)
159
+ except Exception as e:
160
+ log_error(f"{error_msg}: {e}")
161
+ return 1, str(e)
162
+
163
+
164
+ def run_preflight_verification(skip_verify: bool = False, dry_run: bool = False) -> bool:
165
+ """Verifies universal version synchronization and 10 Quality Gates DoD."""
166
+ print(f"\n{BOLD}🔍 Pre-Flight Verification & Universal Quality Gates...{RESET}")
167
+
168
+ # 1. Version sync
169
+ sync_script = os.path.join(REPO_ROOT, "tools", "check_version_sync.py")
170
+ if os.path.exists(sync_script):
171
+ ret, _ = execute_cmd([sys.executable, sync_script], "Universal Version Synchronization Audit failed", dry_run=dry_run)
172
+ if ret != 0:
173
+ return False
174
+ log_success("Universal version synchronization verified across 16 targets.")
175
+
176
+ # 2. Regression Test Suite
177
+ if not skip_verify:
178
+ print(" Running Regression Test Suite (pytest tests -q)...")
179
+ ret, out = execute_cmd([sys.executable, "-m", "pytest", "tests", "-q"], "Regression Test Suite failed", dry_run=dry_run, timeout=180.0)
180
+ if ret != 0:
181
+ return False
182
+ log_success("Hub Regression Test Suite passed 100%.")
183
+ else:
184
+ log_warn("Pre-flight Regression Test Suite skipped by user (--skip-verify).")
185
+
186
+ # 3. 10 Quality Gates DoD
187
+ if not skip_verify:
188
+ verify_script = os.path.join(REPO_ROOT, "tools", "verify_all.py")
189
+ if os.path.exists(verify_script):
190
+ ret, _ = execute_cmd([sys.executable, verify_script, "--mode", "hub"], "10 Quality Gates DoD Verification failed", dry_run=dry_run, timeout=180.0)
191
+ if ret != 0:
192
+ return False
193
+ log_success("10 Quality Gates DoD verified 100% compliant.")
194
+ else:
195
+ log_warn("Pre-flight 10 Quality Gates skipped by user (--skip-verify).")
196
+
197
+ return True
198
+
199
+
200
+ def stage_and_commit_changes(message: Optional[str] = None, dry_run: bool = False) -> bool:
201
+ """Checks git status and optionally commits pending changes."""
202
+ res = subprocess.run(["git", "status", "--porcelain"], cwd=REPO_ROOT, capture_output=True, text=True, timeout=15.0)
203
+ status_out = res.stdout.strip()
204
+ if status_out:
205
+ print(f" Detected uncommitted changes:\n{status_out}")
206
+ commit_msg = message or "chore(release): synchronize assets and prepare release"
207
+ print(f" Staging and committing with: '{commit_msg}'")
208
+ ret, _ = execute_cmd(["git", "add", "-A"], "git add failed", dry_run=dry_run)
209
+ if ret != 0:
210
+ return False
211
+ ret, _ = execute_cmd(["git", "commit", "-m", commit_msg], "git commit failed", dry_run=dry_run)
212
+ if ret != 0:
213
+ return False
214
+ log_success(f"Changes committed: '{commit_msg}'")
215
+ else:
216
+ log_success("Working directory is clean (zero uncommitted changes).")
217
+ return True
218
+
219
+
220
+ def step_1_push_main(dry_run: bool = False) -> bool:
221
+ """Pushes the current branch to origin/main."""
222
+ log_step(1, "Push to origin/main")
223
+ res = subprocess.run(["git", "branch", "--show-current"], cwd=REPO_ROOT, capture_output=True, text=True, timeout=15.0)
224
+ cur_branch = res.stdout.strip() or "main"
225
+ ret, _ = execute_cmd(["git", "push", "origin", cur_branch], f"Failed to push {cur_branch} to origin", dry_run=dry_run)
226
+ if ret != 0:
227
+ return False
228
+ log_success(f"Pushed branch '{cur_branch}' successfully to origin.")
229
+ return True
230
+
231
+
232
+ def step_2_create_and_push_tag(version: str, dry_run: bool = False) -> bool:
233
+ """Creates local semantic tag vX.Y.Z and pushes it to origin."""
234
+ log_step(2, f"Create and Push Git Tag v{version}")
235
+ tag_name = f"v{version}"
236
+
237
+ # Check if tag exists locally
238
+ res = subprocess.run(["git", "tag", "-l", tag_name], cwd=REPO_ROOT, capture_output=True, text=True, timeout=15.0)
239
+ if not res.stdout.strip():
240
+ ret, _ = execute_cmd(["git", "tag", "-a", tag_name, "-m", f"Release {tag_name}"], f"Failed to create tag {tag_name}", dry_run=dry_run)
241
+ if ret != 0:
242
+ return False
243
+ log_success(f"Created local tag: {tag_name}")
244
+ else:
245
+ log_success(f"Tag {tag_name} already exists locally.")
246
+
247
+ # Push tag to remote
248
+ ret, out = execute_cmd(["git", "push", "origin", tag_name], f"Failed to push tag {tag_name} to origin", dry_run=dry_run)
249
+ if ret != 0:
250
+ log_warn(f"Standard tag push rejected; attempting force tag update for {tag_name}...")
251
+ ret, _ = execute_cmd(["git", "push", "origin", tag_name, "--force"], f"Failed to force push tag {tag_name} to origin", dry_run=dry_run)
252
+ if ret != 0:
253
+ return False
254
+ log_success(f"Pushed tag '{tag_name}' to remote origin.")
255
+ return True
256
+
257
+
258
+ def rollback_release(version: str, owner: str, repo: str, token: Optional[str], dry_run: bool = False) -> bool:
259
+ """Safely rolls back remote tag and deletes/drafts GitHub release if publication fails."""
260
+ tag_name = f"v{version}"
261
+ print(f"\n{YELLOW}{BOLD}⚠️ Initiating Rollback for release {tag_name}...{RESET}")
262
+ success = True
263
+ # 1. Delete remote tag
264
+ ret, _ = execute_cmd(["git", "push", "origin", f":refs/tags/{tag_name}"], f"Failed to delete remote tag {tag_name}", dry_run=dry_run)
265
+ if ret == 0:
266
+ log_success(f"Deleted remote tag: {tag_name}")
267
+ else:
268
+ success = False
269
+
270
+ # 2. Delete local tag
271
+ ret, _ = execute_cmd(["git", "tag", "-d", tag_name], f"Failed to delete local tag {tag_name}", dry_run=dry_run)
272
+ if ret == 0:
273
+ log_success(f"Deleted local tag: {tag_name}")
274
+
275
+ # 3. Delete GitHub Release if token available
276
+ if token and not dry_run:
277
+ try:
278
+ check_url = f"https://api.github.com/repos/{owner}/{repo}/releases/tags/{tag_name}"
279
+ req_check = urllib.request.Request(
280
+ check_url,
281
+ headers={"Authorization": f"token {token}", "User-Agent": "Synapse-Hub-Publisher", "Accept": "application/vnd.github.v3+json"}
282
+ )
283
+ with urllib.request.urlopen(req_check, timeout=10.0) as resp:
284
+ rel_data = json.loads(resp.read().decode("utf-8"))
285
+ rel_id = rel_data.get("id")
286
+ if rel_id:
287
+ del_url = f"https://api.github.com/repos/{owner}/{repo}/releases/{rel_id}"
288
+ req_del = urllib.request.Request(
289
+ del_url,
290
+ headers={"Authorization": f"token {token}", "User-Agent": "Synapse-Hub-Publisher", "Accept": "application/vnd.github.v3+json"},
291
+ method="DELETE"
292
+ )
293
+ with urllib.request.urlopen(req_del, timeout=10.0):
294
+ log_success(f"Deleted remote GitHub Release ID: {rel_id}")
295
+ except Exception as e:
296
+ log_warn(f"GitHub API release deletion notice: {e}")
297
+ return success
298
+
299
+
300
+ def generate_release_notes(version: str) -> str:
301
+ """Collects git commit history since the previous tag to build changelog notes."""
302
+ tag_name = f"v{version}"
303
+ # Find previous tag
304
+ res = subprocess.run(["git", "describe", "--tags", "--abbrev=0", f"{tag_name}^"], cwd=REPO_ROOT, capture_output=True, text=True, timeout=15.0)
305
+ prev_tag = res.stdout.strip() if res.returncode == 0 else ""
306
+
307
+ commits = []
308
+ if prev_tag:
309
+ git_range = f"{prev_tag}..{tag_name}"
310
+ res_log = subprocess.run(["git", "log", git_range, "--oneline"], cwd=REPO_ROOT, capture_output=True, text=True, timeout=15.0)
311
+ if res_log.returncode == 0:
312
+ commits = [line.strip() for line in res_log.stdout.splitlines() if line.strip()]
313
+
314
+ commit_lines = "\n".join([f"- {c}" for c in commits[:15]]) if commits else "- Maintenance, stability, and feature updates."
315
+
316
+ body = f"""## Release {tag_name}
317
+
318
+ ### Highlights & Changes
319
+ {commit_lines}
320
+
321
+ - **Universal Synchronization:** 100% synchronized across all 15 polyglot manifests, configs, and tool entrypoints to version `{version}`.
322
+ - **Enterprise DoD Integrity:** Passed all 10 Quality Gates and automated unit test suites.
323
+
324
+ **Full Comparison**: https://github.com/TeeVee98/Synapse-Hub/compare/{prev_tag}...{tag_name}
325
+ """
326
+ return body
327
+
328
+
329
+ def step_3_create_github_release(owner: str, repo: str, version: str, token: Optional[str], dry_run: bool = False) -> Optional[str]:
330
+ """Creates GitHub Release via GitHub REST API if not already present."""
331
+ log_step(3, f"Create GitHub Release for v{version}")
332
+ tag_name = f"v{version}"
333
+
334
+ if not token:
335
+ log_warn("GitHub token not found. Skipping API release creation (can be done on web UI).")
336
+ return f"https://github.com/{owner}/{repo}/releases/tag/{tag_name}"
337
+
338
+ if dry_run:
339
+ print(f" [DRY-RUN] POST https://api.github.com/repos/{owner}/{repo}/releases for tag {tag_name}")
340
+ return f"https://github.com/{owner}/{repo}/releases/tag/{tag_name}"
341
+
342
+ # Check if release exists
343
+ check_url = f"https://api.github.com/repos/{owner}/{repo}/releases/tags/{tag_name}"
344
+ req_check = urllib.request.Request(
345
+ check_url,
346
+ headers={"Authorization": f"token {token}", "User-Agent": "Synapse-Hub-Publisher", "Accept": "application/vnd.github.v3+json"}
347
+ )
348
+ try:
349
+ with urllib.request.urlopen(req_check, timeout=15.0) as resp:
350
+ data = json.loads(resp.read().decode("utf-8"))
351
+ html_url = data.get("html_url")
352
+ log_success(f"GitHub Release already exists: {html_url}")
353
+ return html_url
354
+ except urllib.error.HTTPError as e:
355
+ if e.code != 404:
356
+ log_warn(f"GitHub API check release returned status {e.code}")
357
+ except Exception as e:
358
+ log_warn(f"GitHub API check release error/timeout: {e}")
359
+
360
+ # Create new release
361
+ body_text = generate_release_notes(version)
362
+ payload = {
363
+ "tag_name": tag_name,
364
+ "target_commitish": "main",
365
+ "name": f"{tag_name} — Release {tag_name}",
366
+ "body": body_text,
367
+ "draft": False,
368
+ "prerelease": False,
369
+ "generate_release_notes": False
370
+ }
371
+
372
+ create_url = f"https://api.github.com/repos/{owner}/{repo}/releases"
373
+ req_create = urllib.request.Request(
374
+ create_url,
375
+ data=json.dumps(payload).encode("utf-8"),
376
+ headers={
377
+ "Authorization": f"token {token}",
378
+ "User-Agent": "Synapse-Hub-Publisher",
379
+ "Accept": "application/vnd.github.v3+json",
380
+ "Content-Type": "application/json"
381
+ },
382
+ method="POST"
383
+ )
384
+
385
+ try:
386
+ with urllib.request.urlopen(req_create, timeout=15.0) as resp:
387
+ data = json.loads(resp.read().decode("utf-8"))
388
+ html_url = data.get("html_url")
389
+ log_success(f"GitHub Release created successfully: {html_url}")
390
+ return html_url
391
+ except urllib.error.HTTPError as e:
392
+ err_msg = e.read().decode("utf-8", errors="replace")
393
+ log_error(f"Failed to create GitHub Release (HTTP {e.code}): {err_msg}")
394
+ return None
395
+ except Exception as e:
396
+ log_error(f"Failed to create GitHub Release (network timeout/error): {e}")
397
+ return None
398
+
399
+
400
+ def check_npm_registry_live_version(package_name: Optional[str] = None) -> Optional[str]:
401
+ """Queries npmjs registry directly via HTTPS to retrieve the latest live version."""
402
+ if not package_name:
403
+ package_name = get_current_package_name()
404
+ escaped_pkg = package_name.replace("/", "%2F")
405
+ url = f"https://registry.npmjs.org/{escaped_pkg}/latest"
406
+ try:
407
+ req = urllib.request.Request(url, headers={"User-Agent": "Synapse-Hub-Publisher"})
408
+ with urllib.request.urlopen(req, timeout=8.0) as resp:
409
+ data = json.loads(resp.read().decode("utf-8"))
410
+ return data.get("version")
411
+ except Exception as exc:
412
+ _ = f"npm HTTP probe skipped: {exc}"
413
+ return None
414
+
415
+
416
+ def step_4_and_5_monitor_packages_and_npm(owner: str, repo: str, version: str, token: Optional[str], wait_timeout: int = 180, dry_run: bool = False) -> bool:
417
+ """Monitors GitHub Actions CI workflow for GitHub Packages and NPM Registry publication."""
418
+ pkg_name = get_current_package_name()
419
+ log_step(4, "GitHub Packages Build & Verification")
420
+ print(f" Target: {pkg_name}@{version} (GitHub Packages)")
421
+
422
+ log_step(5, "NPM Registry Publishing & Verification")
423
+ print(f" Target: {pkg_name}@{version} on https://registry.npmjs.org")
424
+
425
+ if dry_run:
426
+ print(" [DRY-RUN] Would poll GitHub Actions publish_npm.yml run and verify NPM Registry.")
427
+ return True
428
+
429
+ print(f"\n{BOLD}📡 Listening to GitHub Actions CI/CD pipeline ({owner}/{repo})...{RESET}")
430
+ tag_name = f"v{version}"
431
+ start_time = time.time()
432
+ npm_verified = False
433
+
434
+ # Check immediate live version on npmjs registry first
435
+ live_ver = check_npm_registry_live_version(pkg_name)
436
+ if live_ver == version:
437
+ log_success(f"{pkg_name}@{version} is ALREADY published and verified live on npmjs.com!")
438
+ return True
439
+
440
+ poll_interval = 10.0
441
+ while time.time() - start_time < wait_timeout:
442
+ # Check npmjs live version
443
+ live_ver = check_npm_registry_live_version(pkg_name)
444
+ if live_ver == version:
445
+ log_success(f"NPM Registry verified: {pkg_name}@{version} is LIVE on npmjs.com!")
446
+ npm_verified = True
447
+ break
448
+
449
+ # Check GitHub Actions runs if token available
450
+ if token:
451
+ try:
452
+ runs_url = f"https://api.github.com/repos/{owner}/{repo}/actions/workflows/publish_npm.yml/runs?per_page=3"
453
+ req_runs = urllib.request.Request(runs_url, headers={"Authorization": f"token {token}", "User-Agent": "Synapse-Hub-Publisher"})
454
+ with urllib.request.urlopen(req_runs, timeout=10.0) as resp:
455
+ runs_data = json.loads(resp.read().decode("utf-8"))
456
+ for r in runs_data.get("workflow_runs", []):
457
+ if r.get("head_branch") == tag_name:
458
+ status = r.get("status")
459
+ conclusion = r.get("conclusion")
460
+ print(f" • CI Workflow ({tag_name}): status={status}, conclusion={conclusion}")
461
+ if status == "completed":
462
+ if conclusion == "success":
463
+ log_success("GitHub Actions publish_npm.yml completed with SUCCESS!")
464
+ else:
465
+ log_warn(f"GitHub Actions publish_npm.yml completed with conclusion: {conclusion}")
466
+ break
467
+ except Exception as exc:
468
+ _ = f"GitHub Actions poll skipped: {exc}"
469
+
470
+ print(f" Waiting for NPM registry replication... ({int(time.time() - start_time)}s/{wait_timeout}s)")
471
+ time.sleep(poll_interval)
472
+
473
+ if not npm_verified:
474
+ # Final fallback check
475
+ live_ver = check_npm_registry_live_version(pkg_name)
476
+ if live_ver == version:
477
+ log_success(f"{pkg_name}@{version} is LIVE on npmjs.com!")
478
+ return True
479
+ else:
480
+ log_warn(f"NPM registry currently serves: v{live_ver or 'unknown'}. CI may still be in progress.")
481
+ print(f" 👉 Check live workflow progress at: https://github.com/{owner}/{repo}/actions")
482
+ return False
483
+
484
+ return True
485
+
486
+
487
+ def main() -> int:
488
+ parser = argparse.ArgumentParser(
489
+ description="Autonomous 1-Click Release & Publishing Pipeline for Synapse Hub"
490
+ )
491
+ parser.add_argument("--message", "-m", help="Optional commit message for unstaged/pending changes")
492
+ parser.add_argument("--skip-verify", action="store_true", help="Skip running 10 Quality Gates DoD before push")
493
+ parser.add_argument("--dry-run", action="store_true", help="Simulate all steps without pushing or publishing")
494
+ parser.add_argument("--no-wait", action="store_true", help="Fire and forget (do not wait for CI workflow / npm verification)")
495
+ parser.add_argument("--skip-tag", "--no-npm", dest="skip_tag", action="store_true", help="Push to main only, skipping git tag creation, GitHub Release, and NPM publishing")
496
+ parser.add_argument("--auto-rollback", action="store_true", help="Automatically rollback remote tag and GitHub Release if NPM publication verification fails")
497
+ parser.add_argument("--rollback", action="store_true", help="Immediately rollback remote tag and GitHub Release for the current version")
498
+ parser.add_argument("--timeout", type=int, default=180, help="Maximum seconds to wait for npm publication (default 180s)")
499
+ args = parser.parse_args()
500
+
501
+ print("=" * 68)
502
+ print(" SYNAPSE HUB — 1-CLICK AUTONOMOUS RELEASE & PUBLISHER ")
503
+ print("=" * 68)
504
+
505
+ version = get_current_version()
506
+ owner, repo = get_remote_repo_info()
507
+ token = get_github_auth_token()
508
+
509
+ if args.rollback:
510
+ print(f" Target Version to Rollback : v{version}")
511
+ print(f" Target Repository : {owner}/{repo}")
512
+ ok = rollback_release(version, owner, repo, token, dry_run=args.dry_run)
513
+ return 0 if ok else 1
514
+
515
+ print(f" Target Repository : {owner}/{repo}")
516
+ print(f" Target Version : v{version}")
517
+ print(f" GitHub Auth Token : {'[AVAILABLE via Git Credential]' if token else '[NONE - Web Fallback]'}")
518
+ print("=" * 68)
519
+
520
+ # Pre-flight
521
+ if not run_preflight_verification(skip_verify=args.skip_verify, dry_run=args.dry_run):
522
+ log_error("Pre-flight verification failed. Pipeline aborted to protect release integrity.")
523
+ return 1
524
+
525
+ # Stage & Commit
526
+ if not stage_and_commit_changes(message=args.message, dry_run=args.dry_run):
527
+ log_error("Failed to prepare clean Git working state.")
528
+ return 1
529
+
530
+ # Step 1: Push main
531
+ if not step_1_push_main(dry_run=args.dry_run):
532
+ return 1
533
+
534
+ if args.skip_tag:
535
+ print("\n" + "=" * 68)
536
+ print(f"🎉 PUSH COMPLETED FOR SYNAPSE HUB v{version} (NPM & TAG SKIPPED)!")
537
+ print("=" * 68)
538
+ print(" 1. Git Main Branch : ✅ Pushed to origin/main")
539
+ print(" 2. Git Tag : ⏭️ Skipped (--skip-tag / --no-npm)")
540
+ print(" 3. GitHub Release : ⏭️ Skipped (--skip-tag / --no-npm)")
541
+ print(" 4. GitHub Packages : ⏭️ Skipped (--skip-tag / --no-npm)")
542
+ print(" 5. NPM Registry : ⏭️ Skipped (--skip-tag / --no-npm)")
543
+ print("=" * 68)
544
+ return 0
545
+
546
+ # Step 2: Create & Push Tag
547
+ if not step_2_create_and_push_tag(version, dry_run=args.dry_run):
548
+ return 1
549
+
550
+ # Step 3: Create GitHub Release
551
+ release_url = step_3_create_github_release(owner, repo, version, token, dry_run=args.dry_run)
552
+
553
+ # Step 4 & 5: GitHub Packages and NPM Registry
554
+ npm_ok = True
555
+ if not args.no_wait:
556
+ npm_ok = step_4_and_5_monitor_packages_and_npm(owner, repo, version, token, wait_timeout=args.timeout, dry_run=args.dry_run)
557
+ else:
558
+ log_step(4, "GitHub Packages Build & NPM Publish (Backgrounded)")
559
+ print(" CI workflow triggered on GitHub Actions. Pipeline finishing without waiting (--no-wait).")
560
+
561
+ if args.dry_run:
562
+ print("\n" + "=" * 68)
563
+ print(f"🎉 [DRY-RUN] 1-CLICK RELEASE SIMULATION COMPLETE FOR SYNAPSE HUB v{version}!")
564
+ print("=" * 68)
565
+ print(" 1. Git Main Branch : 🔍 Simulated push to origin/main")
566
+ print(f" 2. Git Tag : 🔍 Simulated tag v{version}")
567
+ print(f" 3. GitHub Release : 🔍 Simulated release for v{version}")
568
+ print(" 4. GitHub Packages : 🔍 Simulated package publish")
569
+ print(" 5. NPM Registry : 🔍 Simulated npm publication")
570
+ print("=" * 68)
571
+ return 0
572
+
573
+ if not args.no_wait:
574
+ if not npm_ok:
575
+ print("\n" + "=" * 68)
576
+ print(f"⚠️ RELEASE PARTIALLY COMPLETED FOR SYNAPSE HUB v{version}")
577
+ print("=" * 68)
578
+ print(" 1. Git Main Branch : ✅ Pushed to origin/main")
579
+ print(f" 2. Git Tag : ✅ Pushed v{version}")
580
+ if release_url:
581
+ print(f" 3. GitHub Release : ✅ {release_url}")
582
+ print(" 4. GitHub Packages : ⏳ CI workflow in progress / see Actions")
583
+ print(f" 5. NPM Registry : ❌ Not verified on npmjs.com within {args.timeout}s timeout")
584
+ print("=" * 68)
585
+ log_error(f"Release v{version} tag/release created, but NPM live publication could not be verified.")
586
+ if args.auto_rollback:
587
+ print(f"\n 🔄 Auto-rollback enabled: Rolling back tag v{version} and release...")
588
+ rollback_release(version, owner, repo, token, dry_run=args.dry_run)
589
+ else:
590
+ print(f" 👉 Check live GitHub Actions: https://github.com/{owner}/{repo}/actions")
591
+ print(" 👉 To rollback this unverified release: python tools/hub_publisher.py --rollback")
592
+ print(" 👉 To run publish asynchronously without failing local exit code: use --no-wait")
593
+ return 1
594
+
595
+ print("\n" + "=" * 68)
596
+ print(f"🎉 1-CLICK RELEASE COMPLETED & VERIFIED FOR SYNAPSE HUB v{version}!")
597
+ print("=" * 68)
598
+ print(" 1. Git Main Branch : ✅ Pushed to origin/main")
599
+ print(f" 2. Git Tag : ✅ Pushed v{version}")
600
+ if release_url:
601
+ print(f" 3. GitHub Release : ✅ {release_url}")
602
+ print(f" 4. GitHub Packages : ✅ https://github.com/{owner}/{repo}/packages")
603
+ pkg_name = get_current_package_name()
604
+ print(f" 5. NPM Registry : ✅ LIVE at https://www.npmjs.com/package/{pkg_name}")
605
+ print("=" * 68)
606
+ return 0
607
+ else:
608
+ print("\n" + "=" * 68)
609
+ print(f"🚀 RELEASE CREATED FOR SYNAPSE HUB v{version} (PUBLISH ASYNC)")
610
+ print("=" * 68)
611
+ print(" 1. Git Main Branch : ✅ Pushed to origin/main")
612
+ print(f" 2. Git Tag : ✅ Pushed v{version}")
613
+ if release_url:
614
+ print(f" 3. GitHub Release : ✅ {release_url}")
615
+ print(" 4. GitHub Packages : ⏳ Publishing in background (--no-wait)")
616
+ print(" 5. NPM Registry : ⏳ Publishing in background (--no-wait)")
617
+ print(f" 👉 Monitor CI at : https://github.com/{owner}/{repo}/actions")
618
+ print("=" * 68)
619
+ return 0
620
+
621
+
622
+ if __name__ == "__main__":
623
+ sys.exit(main())