@teevee98/synapse-hub 0.0.0-stage → 3.8.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.agents/agents/api-engineer.md +67 -0
- package/.agents/agents/failure-analyst.md +75 -0
- package/.agents/agents/live-explorer.md +70 -0
- package/.agents/agents/orchestrator.md +104 -0
- package/.agents/agents/perf-engineer.md +74 -0
- package/.agents/agents/pom-crafter.md +112 -0
- package/.agents/agents/quality-gatekeeper.md +87 -0
- package/.agents/agents/test-designer.md +73 -0
- package/.agents/agents/test-runner.md +67 -0
- package/.agents/rules/author-integrity-guard.md +33 -0
- package/.agents/rules/communication-style.md +18 -0
- package/.agents/rules/context-engineering.md +37 -0
- package/.agents/rules/git-push-protocol.md +33 -0
- package/.agents/rules/graphify.md +14 -0
- package/.agents/rules/lessons-learned.md +25 -0
- package/.agents/rules/mandatory-playwright-live.md +25 -0
- package/.agents/rules/mobile_appium_rules.md +43 -0
- package/.agents/rules/performance_testing_rules.md +35 -0
- package/.agents/rules/skill-precedence.md +29 -0
- package/.agents/rules/systematic-debugging.md +36 -0
- package/.agents/skills/actor-qa-swarm/SKILL.md +77 -0
- package/.agents/skills/actor-qa-swarm/examples/broker_sharding_sample.json +12 -0
- package/.agents/skills/agent-orchestration-multi-agent-optimize/SKILL.md +88 -0
- package/.agents/skills/agent-orchestration-multi-agent-optimize/examples/swarm_workload_config.json +15 -0
- package/.agents/skills/agentless-qa-repair/SKILL.md +69 -0
- package/.agents/skills/agentless-qa-repair/examples/healing_report_sample.json +17 -0
- package/.agents/skills/agentless-qa-repair/examples/three_phase_repair_workflow.md +40 -0
- package/.agents/skills/antigravity-test-sentinel/SKILL.md +63 -0
- package/.agents/skills/antigravity-test-sentinel/examples/dod_gate_policy.json +11 -0
- package/.agents/skills/antigravity-test-sentinel/examples/sprint_dod_enforcement.md +47 -0
- package/.agents/skills/api-network-mocking-interception/SKILL.md +142 -0
- package/.agents/skills/api-network-mocking-interception/examples/network_route_stub.json +9 -0
- package/.agents/skills/api-spec-to-e2e-matrix/SKILL.md +80 -0
- package/.agents/skills/api-spec-to-e2e-matrix/examples/sample_openapi.json +19 -0
- package/.agents/skills/architecture-decision-records/SKILL.md +64 -0
- package/.agents/skills/architecture-decision-records/examples/0001-record-architecture-decisions.md +12 -0
- package/.agents/skills/auth-session-and-cookie-manager/SKILL.md +75 -0
- package/.agents/skills/auth-session-and-cookie-manager/examples/multi_role_auth_matrix.md +70 -0
- package/.agents/skills/auth-session-and-cookie-manager/examples/storage_state_sample.json +11 -0
- package/.agents/skills/backend-load-and-stress-patterns/SKILL.md +85 -0
- package/.agents/skills/backend-load-and-stress-patterns/examples/k6_load_test_sample.js +13 -0
- package/.agents/skills/backend-load-and-stress-patterns/references/k6_load_template.js +82 -0
- package/.agents/skills/bats-testing-patterns/SKILL.md +100 -0
- package/.agents/skills/bats-testing-patterns/examples/cli_runner_test.bats +6 -0
- package/.agents/skills/bats-testing-patterns/resources/implementation-playbook.md +614 -0
- package/.agents/skills/clean-pom-crafter/SKILL.md +110 -0
- package/.agents/skills/clean-pom-crafter/examples/standard_test_case.groovy +28 -0
- package/.agents/skills/clean-pom-crafter/references/pom_patterns.groovy +138 -0
- package/.agents/skills/code-refactoring-refactor-clean/SKILL.md +64 -0
- package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_page_sample.groovy +9 -0
- package/.agents/skills/code-refactoring-refactor-clean/examples/refactored_playwright_pom.ts +52 -0
- package/.agents/skills/code-refactoring-refactor-clean/resources/implementation-playbook.md +881 -0
- package/.agents/skills/consumer-driven-contract-testing/SKILL.md +147 -0
- package/.agents/skills/consumer-driven-contract-testing/examples/order_service_pact.json +45 -0
- package/.agents/skills/db-state-verifier-and-seeder/SKILL.md +123 -0
- package/.agents/skills/db-state-verifier-and-seeder/examples/db_fixture_seed.json +12 -0
- package/.agents/skills/e2e-testing-patterns/SKILL.md +103 -0
- package/.agents/skills/e2e-testing-patterns/examples/playwright_sharded_config.ts +12 -0
- package/.agents/skills/e2e-testing-patterns/resources/implementation-playbook.md +522 -0
- package/.agents/skills/event-stream-qa-orchestrator/SKILL.md +79 -0
- package/.agents/skills/event-stream-qa-orchestrator/examples/timeline_sample.jsonl +2 -0
- package/.agents/skills/failure-autopsy-and-healing/SKILL.md +66 -0
- package/.agents/skills/failure-autopsy-and-healing/examples/closed_loop_healing_walkthrough.md +48 -0
- package/.agents/skills/failure-autopsy-and-healing/examples/sample_junit_failure.xml +8 -0
- package/.agents/skills/failure-autopsy-and-healing/references/healing_matrix.md +64 -0
- package/.agents/skills/failure-autopsy-and-healing/references/qa_investigation_protocol.md +56 -0
- package/.agents/skills/failure-autopsy-and-healing/scripts/triage_failures.sh +83 -0
- package/.agents/skills/file-and-report-validator/SKILL.md +90 -0
- package/.agents/skills/file-and-report-validator/examples/sample_export_schema.json +14 -0
- package/.agents/skills/flaky-test-sentinel-and-quarantine/SKILL.md +114 -0
- package/.agents/skills/flaky-test-sentinel-and-quarantine/examples/quarantine_registry.json +11 -0
- package/.agents/skills/gherkin-to-suite/SKILL.md +103 -0
- package/.agents/skills/gherkin-to-suite/examples/checkout.feature +39 -0
- package/.agents/skills/gherkin-to-suite/examples/suite_report_sample.json +334 -0
- package/.agents/skills/github-actions-templates/SKILL.md +77 -0
- package/.agents/skills/github-actions-templates/examples/matrix_test_pipeline.yml +8 -0
- package/.agents/skills/graphify-impact-analyzer/SKILL.md +76 -0
- package/.agents/skills/graphify-impact-analyzer/examples/dependency_blast_radius.json +8 -0
- package/.agents/skills/katalon-cli-runner/SKILL.md +76 -0
- package/.agents/skills/katalon-cli-runner/examples/headless_kre_exec.sh +3 -0
- package/.agents/skills/katalon-cli-runner/references/groovy-patterns.md +209 -0
- package/.agents/skills/katalon-cli-runner/references/katalon-api.md +155 -0
- package/.agents/skills/katalon-cli-runner/references/runner_commands.md +67 -0
- package/.agents/skills/lam-script-generator/SKILL.md +123 -0
- package/.agents/skills/lam-script-generator/examples/user_story_sample.md +8 -0
- package/.agents/skills/lean-code-ladder/SKILL.md +94 -0
- package/.agents/skills/lean-code-ladder/examples/ladder_walkthrough.md +37 -0
- package/.agents/skills/lean-impact-scoreboard/SKILL.md +48 -0
- package/.agents/skills/lean-impact-scoreboard/examples/sample_benchmark_gain.md +20 -0
- package/.agents/skills/lean-impact-scoreboard/examples/sample_scoreboard.md +15 -0
- package/.agents/skills/meta-prompt-crafter/SKILL.md +107 -0
- package/.agents/skills/meta-prompt-crafter/examples/qa_prompt_template.md +35 -0
- package/.agents/skills/mipro-prompt-compiler/SKILL.md +59 -0
- package/.agents/skills/mipro-prompt-compiler/examples/compiled_module_sample.json +22 -0
- package/.agents/skills/mipro-prompt-compiler/examples/dspy_assertion_optimizer_case.md +46 -0
- package/.agents/skills/mobile-appium-som/SKILL.md +88 -0
- package/.agents/skills/mobile-appium-som/examples/BaseScreen.java +88 -0
- package/.agents/skills/mobile-appium-som/examples/LoginScreen.java +46 -0
- package/.agents/skills/mobile-appium-som/examples/TC_MobileLogin.java +43 -0
- package/.agents/skills/persistent-planning-files/SKILL.md +108 -0
- package/.agents/skills/persistent-planning-files/examples/task_plan_example.md +56 -0
- package/.agents/skills/playwright-live-interaction/SKILL.md +131 -0
- package/.agents/skills/playwright-live-interaction/examples/live_probe_script.js +5 -0
- package/.agents/skills/playwright-live-interaction/references/advanced_superpowers.md +160 -0
- package/.agents/skills/playwright-live-interaction/references/compact_accessibility_snapshots.md +75 -0
- package/.agents/skills/playwright-live-interaction/references/recipes.md +388 -0
- package/.agents/skills/playwright-live-interaction/references/swarm_orchestration.md +134 -0
- package/.agents/skills/playwright-webapp-testing/SKILL.md +93 -0
- package/.agents/skills/playwright-webapp-testing/examples/server_lifecycle_playwright.py +63 -0
- package/.agents/skills/qa-aci-interface/SKILL.md +67 -0
- package/.agents/skills/qa-aci-interface/examples/surgical_code_window_walkthrough.md +40 -0
- package/.agents/skills/qa-aci-interface/examples/surgical_edit_sample.json +12 -0
- package/.agents/skills/qa-memory-os/SKILL.md +80 -0
- package/.agents/skills/qa-memory-os/examples/archival_memory_sample.json +21 -0
- package/.agents/skills/rbt-manual-testing/SKILL.md +137 -0
- package/.agents/skills/rbt-manual-testing/examples/checkout_rbt_manual_suite.md +25 -0
- package/.agents/skills/rbt-manual-testing/references/field_validation_checklist.md +29 -0
- package/.agents/skills/repo-quality-audit/SKILL.md +68 -0
- package/.agents/skills/repo-quality-audit/examples/sample_audit_walkthrough.md +15 -0
- package/.agents/skills/repo-quality-audit/examples/sample_repo_audit.md +33 -0
- package/.agents/skills/review-spec/SKILL.md +60 -0
- package/.agents/skills/review-spec/examples/pocock_grilling_decision_rubric.md +40 -0
- package/.agents/skills/review-spec/examples/sample_spec_review.md +33 -0
- package/.agents/skills/security-dast-sentinel/SKILL.md +119 -0
- package/.agents/skills/security-dast-sentinel/examples/dast_scan_config.json +10 -0
- package/.agents/skills/security-dast-sentinel/references/AI-AND-LLM.md +113 -0
- package/.agents/skills/security-dast-sentinel/references/ATTACK-CLASSES.md +89 -0
- package/.agents/skills/security-dast-sentinel/references/dast_recipes.ts +33 -0
- package/.agents/skills/self-healing-locator/SKILL.md +86 -0
- package/.agents/skills/self-healing-locator/examples/aom_diff_sample.json +16 -0
- package/.agents/skills/senior-code-review/SKILL.md +108 -0
- package/.agents/skills/senior-code-review/examples/sample_review_walkthrough.md +29 -0
- package/.agents/skills/skillspector-security-guard/SKILL.md +57 -0
- package/.agents/skills/skillspector-security-guard/examples/audit_threat_vectors_report.json +35 -0
- package/.agents/skills/skillspector-security-guard/examples/safe_mcp_config.json +12 -0
- package/.agents/skills/surgical-coding-principles/SKILL.md +89 -0
- package/.agents/skills/surgical-coding-principles/examples/surgical_vs_scope_creep.md +46 -0
- package/.agents/skills/synthetic-test-data-generator/SKILL.md +135 -0
- package/.agents/skills/synthetic-test-data-generator/examples/idempotent_data_recipe.json +9 -0
- package/.agents/skills/systematic-debugging/SKILL.md +100 -0
- package/.agents/skills/systematic-debugging/examples/four_phase_case.md +44 -0
- package/.agents/skills/technical-debt-harvester/SKILL.md +70 -0
- package/.agents/skills/technical-debt-harvester/examples/sample_debt_ledger.md +25 -0
- package/.agents/skills/technical-debt-harvester/examples/sample_ledger_output.md +20 -0
- package/.agents/skills/test-driven-development/SKILL.md +114 -0
- package/.agents/skills/test-driven-development/examples/red_green_refactor_qa.md +78 -0
- package/.agents/skills/token-and-context-optimizer/SKILL.md +70 -0
- package/.agents/skills/token-and-context-optimizer/examples/distilled_log_sample.txt +3 -0
- package/.agents/skills/token-and-context-optimizer/references/context_engineering_guide.md +49 -0
- package/.agents/skills/tot-exploratory-testing/SKILL.md +59 -0
- package/.agents/skills/tot-exploratory-testing/examples/payment_gateway_tot_tree.json +62 -0
- package/.agents/skills/tot-exploratory-testing/examples/tot_graph_sample.json +35 -0
- package/.agents/skills/verification-before-completion/SKILL.md +100 -0
- package/.agents/skills/verification-before-completion/examples/evidence_log_example.md +46 -0
- package/.agents/skills/visual-regression-sentinel/SKILL.md +82 -0
- package/.agents/skills/visual-regression-sentinel/examples/visual_mask_rules.json +9 -0
- package/.agents/skills/wcag-audit-patterns/SKILL.md +77 -0
- package/.agents/skills/wcag-audit-patterns/examples/wcag_compliance_checklist.json +10 -0
- package/.agents/skills/wcag-audit-patterns/resources/implementation-playbook.md +541 -0
- package/.agents/skills/web-agent-gym-benchmarking/SKILL.md +62 -0
- package/.agents/skills/web-agent-gym-benchmarking/examples/benchmark_report_sample.json +22 -0
- package/.agents/skills/web-agent-gym-benchmarking/examples/enterprise_tasks_suite.json +38 -0
- package/.agents/skills/web-vitals-and-performance-profiler/SKILL.md +65 -0
- package/.agents/skills/web-vitals-and-performance-profiler/examples/cwv_budget_policy.json +6 -0
- package/.agents/skills/web-vitals-and-performance-profiler/examples/playwright_cwv_profiler_fixture.ts +118 -0
- package/.agents/templates/completion_report.md +57 -0
- package/.agents/workflows/analyze_requirement_document.md +18 -0
- package/.agents/workflows/export_testcases_excel.md +32 -0
- package/.agents/workflows/generate_combinatorial_test_data.md +28 -0
- package/.agents/workflows/generate_cross_module_test_plan.md +37 -0
- package/.agents/workflows/generate_manual_testcases_rbt.md +56 -0
- package/.agents/workflows/generate_requirements_from_website.md +25 -0
- package/.agents/workflows/generate_testcases_from_requirements.md +21 -0
- package/.agents/workflows/graphify.md +10 -0
- package/.agents/workflows/test-impact.md +15 -0
- package/.agents/workflows/verify.md +34 -0
- package/.cursor/rules/agents.mdc +16 -0
- package/.cursor/rules/language.mdc +7 -0
- package/.cursor/rules/synapse-qa.mdc +24 -0
- package/.cursorrules +27 -0
- package/.dockerignore +53 -0
- package/.pre-commit-hooks.yaml +14 -0
- package/.windsurfrules +26 -0
- package/AGENTS.md +86 -0
- package/CLAUDE.md +54 -0
- package/Dockerfile +81 -0
- package/LICENSE +52 -0
- package/NOTICE +264 -0
- package/README.en.md +171 -0
- package/README.md +170 -2
- package/action.yml +51 -0
- package/agentskills.json +16 -0
- package/bin/agent-qa.js +138 -0
- package/docker-compose.yml +74 -0
- package/docs/ARCHITECTURE.en.md +198 -0
- package/docs/ARCHITECTURE.md +199 -0
- package/docs/CI_CD_INTEGRATION.en.md +170 -0
- package/docs/CI_CD_INTEGRATION.md +170 -0
- package/docs/CLI_REFERENCE.en.md +174 -0
- package/docs/CLI_REFERENCE.md +176 -0
- package/docs/CONTRIBUTING.en.md +49 -0
- package/docs/CONTRIBUTING.md +49 -0
- package/docs/PERFORMANCE_AUDIT_REPORT.md +783 -0
- package/docs/PLUGIN_DEVELOPMENT_GUIDE.md +127 -0
- package/docs/QUALITY_GATES.en.md +118 -0
- package/docs/QUALITY_GATES.md +118 -0
- package/docs/TOKEN_QUOTA_PLAYBOOK.md +41 -0
- package/docs/TOOL_CATALOG.md +129 -0
- package/docs/adopted-ecosystem-tools.md +96 -0
- package/docs/research/EXTERNAL_AGENT_SKILLS_SURVEY.md +1062 -0
- package/docs/research/agent_skill_training_analysis.md +1358 -0
- package/docs/schemas/synapse.config.schema.json +86 -0
- package/package.json +94 -4
- package/plugin.json +31 -0
- package/scripts/generate_skill_examples.py +244 -0
- package/scripts/install.ps1 +112 -0
- package/scripts/install_global_plugin.ps1 +94 -0
- package/scripts/install_global_plugin.sh +49 -0
- package/scripts/lint_skills.ps1 +57 -0
- package/scripts/package_dist.py +337 -0
- package/scripts/setup.sh +59 -0
- package/scripts/update_hub.ps1 +19 -0
- package/scripts/update_hub.sh +15 -0
- package/skills_manifest.json +854 -0
- package/synapse.config.json +31 -0
- package/templates/PROJECT_AI_GUIDE_TEMPLATE.md +111 -0
- package/templates/PROJECT_STATE_TEMPLATE.md +20 -0
- package/templates/ai_bridges/CLAUDE.md +54 -0
- package/templates/ai_bridges/copilot-instructions.md +20 -0
- package/templates/ai_bridges/cursor_synapse_qa.mdc +24 -0
- package/templates/ai_bridges/windsurfrules +26 -0
- package/templates/ci/github-actions-synapse.yml +95 -0
- package/templates/ci/gitlab-ci-synapse.yml +16 -0
- package/templates/ui/index.html +1069 -0
- package/templates/welcome.html.tmpl +2074 -0
- package/tools/.infer_baseline.json +30 -0
- package/tools/TOOLS_RUNBOOK.md +1553 -0
- package/tools/TOOL_CATALOG.json +1769 -0
- package/tools/__init__.py +43 -0
- package/tools/_openapi_parser.py +158 -0
- package/tools/agent_canary.py +525 -0
- package/tools/agentless_patcher.py +417 -0
- package/tools/analyze_project.py +262 -0
- package/tools/api_drift_sentinel.py +208 -0
- package/tools/api_fuzzer.py +762 -0
- package/tools/author_integrity.py +190 -0
- package/tools/auto_heal.py +271 -0
- package/tools/auto_heal_reflexion.py +532 -0
- package/tools/autogen_qa_broker.py +844 -0
- package/tools/benchmark_swarm_context.py +394 -0
- package/tools/browser_helpers.js +746 -0
- package/tools/browsergym_eval.py +236 -0
- package/tools/bug_reporter.py +252 -0
- package/tools/bump_version.py +423 -0
- package/tools/cache_resolver.py +1214 -0
- package/tools/check_env.py +426 -0
- package/tools/check_version_sync.py +256 -0
- package/tools/ci_healing_hook.py +126 -0
- package/tools/cli.py +1598 -0
- package/tools/config_decoupler.py +253 -0
- package/tools/contract_validator.py +141 -0
- package/tools/core/__init__.py +70 -0
- package/tools/core/adapters.py +431 -0
- package/tools/core/circuit_breaker.py +263 -0
- package/tools/core/cli_runtime.py +66 -0
- package/tools/core/file_lock.py +159 -0
- package/tools/core/i18n.py +394 -0
- package/tools/core/memory_bus.py +905 -0
- package/tools/core/process_supervisor.py +332 -0
- package/tools/core/telemetry.py +329 -0
- package/tools/count_tokens.py +1267 -0
- package/tools/create_mock_docx.py +104 -0
- package/tools/dashboard_generator.py +2403 -0
- package/tools/db_sandbox.py +675 -0
- package/tools/debt_harvester.py +237 -0
- package/tools/distill_log.py +161 -0
- package/tools/dspy_qa_signatures.py +356 -0
- package/tools/e2e_flow_prober.py +132 -0
- package/tools/export_postman_collection.py +945 -0
- package/tools/flaky_detector.py +389 -0
- package/tools/fsm_enforcer.py +450 -0
- package/tools/fsm_middleware.py +401 -0
- package/tools/fuzz_payloads.py +197 -0
- package/tools/generate_allure_report.py +88 -0
- package/tools/generate_api_matrix.py +193 -0
- package/tools/generate_jmx_plan.py +1322 -0
- package/tools/generate_sbom.py +252 -0
- package/tools/generate_tc_from_story.py +203 -0
- package/tools/generate_test_reports.py +133 -0
- package/tools/generate_tool_catalog.py +482 -0
- package/tools/gherkin_suite.py +758 -0
- package/tools/git_pre_commit_guard.py +298 -0
- package/tools/goldfish_review.py +366 -0
- package/tools/heal/__init__.py +28 -0
- package/tools/heal_pr_automator.py +220 -0
- package/tools/heuristic_locator_matcher.py +351 -0
- package/tools/hub_publisher.py +623 -0
- package/tools/humanize_linter.py +438 -0
- package/tools/infer_linter.py +977 -0
- package/tools/init_config.py +306 -0
- package/tools/interview_story.py +116 -0
- package/tools/jira_sync.py +566 -0
- package/tools/jtl_analyzer.py +474 -0
- package/tools/lint/__init__.py +30 -0
- package/tools/lint_ai_docs.py +374 -0
- package/tools/lookup_tc.py +165 -0
- package/tools/lookup_xpath.py +167 -0
- package/tools/matrix_sharder.py +148 -0
- package/tools/mcp/__init__.py +18 -0
- package/tools/mcp_docx_server.ps1 +13 -0
- package/tools/mcp_docx_server.py +851 -0
- package/tools/mcp_excel_server.ps1 +13 -0
- package/tools/mcp_excel_server.py +441 -0
- package/tools/mcp_server.py +725 -0
- package/tools/md_to_xlsx.py +327 -0
- package/tools/micro_mutator.py +887 -0
- package/tools/mipro_assertion_tuner.py +210 -0
- package/tools/network_mock_shield.py +311 -0
- package/tools/newman_analyzer.py +384 -0
- package/tools/omni_emitter.py +579 -0
- package/tools/omni_parser.py +450 -0
- package/tools/omni_transpiler.py +168 -0
- package/tools/openxml_guard.py +438 -0
- package/tools/output_formatter.py +182 -0
- package/tools/package_release.py +325 -0
- package/tools/perf/__init__.py +24 -0
- package/tools/pinpoint_failure.py +190 -0
- package/tools/project_state.py +171 -0
- package/tools/qa_event_stream.py +358 -0
- package/tools/repo_map.py +346 -0
- package/tools/report/__init__.py +32 -0
- package/tools/reversible_sandbox.py +344 -0
- package/tools/safety_firewall.py +437 -0
- package/tools/security_coverage_ledger.py +538 -0
- package/tools/security_scanner.py +229 -0
- package/tools/senior_code_review.py +393 -0
- package/tools/setup_project.py +770 -0
- package/tools/skill_collision_guard.py +304 -0
- package/tools/skill_profiles.py +217 -0
- package/tools/skill_vault.py +481 -0
- package/tools/skillspector.py +1278 -0
- package/tools/smart_visual_masker.py +132 -0
- package/tools/spec_drift_sentinel.py +438 -0
- package/tools/swe_qa_aci.py +369 -0
- package/tools/synapse_observer.py +485 -0
- package/tools/synapse_qa_bench.py +190 -0
- package/tools/sync_agent_rules.py +274 -0
- package/tools/telemetry_correlator.py +397 -0
- package/tools/template_excel_exporter.py +514 -0
- package/tools/templates/jmeter-distributed/README.md +54 -0
- package/tools/templates/jmeter-distributed/docker-compose.yml +83 -0
- package/tools/test_impact.py +419 -0
- package/tools/test_memory_os.py +462 -0
- package/tools/textgrad_mutation_optimizer.py +237 -0
- package/tools/tms_sync_bridge.py +834 -0
- package/tools/tot_exploratory_tester.py +239 -0
- package/tools/trace_data_flow.py +240 -0
- package/tools/traffic_session_converter.py +256 -0
- package/tools/trend_analytics.py +314 -0
- package/tools/ui_server.py +401 -0
- package/tools/universal_ir.py +488 -0
- package/tools/update_sentinel.py +383 -0
- package/tools/validate_groovy_scripts.py +173 -0
- package/tools/verify_all.py +1271 -0
- package/tools/visual_diff_canvas.py +143 -0
- package/tools/visual_som_helper.py +550 -0
- package/tools/watch_mode.py +308 -0
- package/tools/wcag_audit.py +239 -0
- package/tools/welcome_page.py +290 -0
|
@@ -0,0 +1,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())
|