@teevee98/synapse-hub 4.2.3 β 4.2.5
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 +1 -1
- package/.agents/agents/failure-analyst.md +1 -1
- package/.agents/agents/live-explorer.md +1 -1
- package/.agents/agents/orchestrator.md +1 -1
- package/.agents/agents/perf-engineer.md +1 -1
- package/.agents/agents/pom-crafter.md +1 -1
- package/.agents/agents/quality-gatekeeper.md +1 -1
- package/.agents/agents/test-designer.md +1 -1
- package/.agents/agents/test-runner.md +1 -1
- package/.agents/rules/git-push-protocol.md +2 -2
- package/.agents/rules/lessons-learned.md +10 -12
- package/.agents/rules/mandatory-playwright-live.md +1 -1
- package/.agents/rules/skill-precedence.md +1 -1
- package/.agents/rules/systematic-debugging.md +3 -3
- package/.agents/skills/01-web-automation/playwright-live-interaction/SKILL.md +2 -2
- package/.agents/skills/01-web-automation/playwright-live-interaction/references/recipes.md +14 -31
- package/.agents/skills/05-security-and-compliance/wcag-audit-patterns/SKILL.md +5 -4
- package/.agents/workflows/analyze_requirement_document.md +1 -1
- package/.agents/workflows/export_testcases_excel.md +1 -1
- package/.agents/workflows/generate_combinatorial_test_data.md +1 -1
- package/.agents/workflows/generate_cross_module_test_plan.md +1 -1
- package/.agents/workflows/generate_manual_testcases_rbt.md +1 -1
- package/.agents/workflows/generate_requirements_from_website.md +1 -1
- package/.agents/workflows/generate_testcases_from_requirements.md +1 -1
- package/.agents/workflows/test-impact.md +1 -1
- package/.agents/workflows/verify.md +1 -1
- package/AGENTS.md +1 -1
- package/README.en.md +2 -2
- package/README.md +2 -2
- package/agentskills.json +1 -1
- package/docs/ARCHITECTURE.en.md +1 -1
- package/docs/ARCHITECTURE.md +1 -1
- package/docs/PERFORMANCE_AUDIT_REPORT.md +2 -2
- package/docs/TOOL_CATALOG.md +25 -20
- package/package.json +1 -1
- package/plugin.json +1 -1
- package/scripts/setup.sh +6 -1
- package/skills_manifest.json +1 -1
- package/synapse.config.json +1 -1
- package/tools/TOOL_CATALOG.json +112 -31
- package/tools/__init__.py +1 -1
- package/tools/browser_helpers.js +2 -2
- package/tools/cli.py +3 -3
- package/tools/core/file_lock.py +7 -0
- package/tools/core/memory_bus.py +44 -40
- package/tools/core/process_supervisor.py +12 -4
- package/tools/core/telemetry.py +54 -16
- package/tools/dashboard_generator.py +6 -6
- package/tools/db_sandbox.py +8 -2
- package/tools/generate_tool_catalog.py +32 -2
- package/tools/mcp_docx_server.py +1 -1
- package/tools/mcp_excel_server.py +1 -1
- package/tools/mcp_server.py +1 -1
- package/tools/package_release.py +22 -27
- package/tools/reversible_sandbox.py +43 -10
- package/tools/task_memory_manager.py +2 -1
- package/tools/ui_server.py +1 -1
- package/tools/update_sentinel.py +3 -3
- package/tools/welcome_page.py +1 -1
package/docs/TOOL_CATALOG.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# Synapse Hub β Tooling Ecosystem Catalog & Runbook
|
|
2
2
|
|
|
3
3
|
> **Audience:** QA Engineers, Autonomous AI Agents (Lead Orchestrator, POM-Crafter, Test-Runner, Failure-Analyst, Quality-Gatekeeper).
|
|
4
|
-
> **Total Tools Cataloged:** `
|
|
4
|
+
> **Total Tools Cataloged:** `130` | **Stable:** `130` | **Experimental:** `0`
|
|
5
5
|
|
|
6
6
|
## 1. Primary Enterprise CLI Tools
|
|
7
7
|
|
|
@@ -9,24 +9,25 @@
|
|
|
9
9
|
|---|---|:---:|:---:|:---:|---|
|
|
10
10
|
| `python tools/_openapi_parser.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | tools/_openapi_parser.py β Shared OpenAPI & Swagger Specification Parser |
|
|
11
11
|
| `python tools/agent_canary.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | ENTERPRISE AUTONOMOUS AGENT Canary & Mutation Testing Arena |
|
|
12
|
-
| `python tools/agentless_patcher.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `
|
|
12
|
+
| `python tools/agentless_patcher.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `modifying` | Agentless 3-Stage Deterministic Patcher (OpenAutoCoder Agentless Pattern) |
|
|
13
13
|
| `python tools/analyze_project.py` | **Quality Gates** | `quality-gatekeeper` | π’ Stable | `read_only` | Comprehensive health audit analyzing environment, POM structure, and Quality Gates. |
|
|
14
14
|
| `python tools/api_drift_sentinel.py` | **API & Contract Testing** | `api-engineer` | π’ Stable | `read_only` | Detects contract drift and breaking schema mutations against OpenAPI specifications. |
|
|
15
15
|
| `python tools/api_fuzzer.py` | **Testing & Utilities** | `orchestrator` | π’ Stable | `read_only` | Enterprise Autonomous API Fuzzing & Chaos Breaker |
|
|
16
16
|
| `python tools/ast_cache.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | tools/ast_cache.py β AST Dataflow Pre-Validation Cache (Boost B3) |
|
|
17
17
|
| `python tools/author_integrity.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | tools/author_integrity.py β Author Attribution & Repository Provenance Guard |
|
|
18
18
|
| `python tools/auto_heal.py` | **Failure Autopsy & Healing** | `failure-analyst` | π’ Stable | `modifying` | Closed-loop locator self-healing engine matching broken selectors against DOM/AOM. |
|
|
19
|
-
| `python tools/auto_heal_reflexion.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `
|
|
19
|
+
| `python tools/auto_heal_reflexion.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `modifying` | Multi-Trial Episodic Reflexion Loop for Autonomous Healing (Noah Shinn / Reflexion Pattern) |
|
|
20
20
|
| `python tools/autogen_qa_broker.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | Asynchronous Actor QA Message Broker (Microsoft AutoGen v0.4+ Pattern) |
|
|
21
21
|
| `python tools/benchmark_swarm_context.py` | **Benchmarking** | `orchestrator` | π’ Stable | `read_only` | Empirical context token reduction benchmark harness proving >= 40% savings. |
|
|
22
|
+
| `python tools/break_ui_generator.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | tools/break_ui_generator.py β Edge-Case UI Stress Testing Data Generator |
|
|
22
23
|
| `python tools/browsergym_eval.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | BrowserGym Web Agent Benchmark Harness (BrowserGym / WebArena Pattern) |
|
|
23
24
|
| `python tools/bug_reporter.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | Auto-Bug Reporter & Root Cause Analysis (RCA) Ticket Generator |
|
|
24
25
|
| `python tools/build_consolidated_report.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | tools/build_consolidated_report.py β Generate Unified Top 20 Skills & Agents Evaluation Report |
|
|
25
|
-
| `python tools/bump_version.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `
|
|
26
|
+
| `python tools/bump_version.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `modifying` | tools/bump_version.py β Atomic Universal Version Bumper for Synapse Hub |
|
|
26
27
|
| `python tools/cache_resolver.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | Universal Local Semantic Memory Cache & Self-Healing Resolver |
|
|
27
28
|
| `python tools/check_env.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | ============================================================================== |
|
|
28
|
-
| `python tools/check_version_sync.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `
|
|
29
|
-
| `python tools/ci_healing_hook.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `
|
|
29
|
+
| `python tools/check_version_sync.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `modifying` | tools/check_version_sync.py β Version Synchronization Sentinel for Synapse Hub |
|
|
30
|
+
| `python tools/ci_healing_hook.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `modifying` | CI/CD Silent Self-Healing Pipeline Hook |
|
|
30
31
|
| `python tools/cli.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | Enterprise Agent-QA CLI Entrypoint |
|
|
31
32
|
| `python tools/config_decoupler.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | Environment & Secret Decoupling Engine |
|
|
32
33
|
| `python tools/contract_validator.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | Swarm Data Contract Validator (Single Front-Door Integrity Guard) |
|
|
@@ -34,10 +35,11 @@
|
|
|
34
35
|
| `python tools/coverage_reporter.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | tools/coverage_reporter.py β Standardized Coverage Metrics & Roadmap Evaluator |
|
|
35
36
|
| `python tools/create_mock_docx.py` | **Testing & Utilities** | `orchestrator` | π’ Stable | `read_only` | Generates a lightweight valid mock DOCX fixture (< 20 KB) for OpenXML Guard / Word reader tests. |
|
|
36
37
|
| `python tools/dashboard_generator.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | tools/dashboard_generator.py β Standalone One-Page Enterprise QA HTML Dashboard |
|
|
37
|
-
| `python tools/db_sandbox.py` | **
|
|
38
|
+
| `python tools/db_sandbox.py` | **Sandboxing & Isolation** | `failure-analyst` | π’ Stable | `modifying` | Database state isolation sentinel with granular consent-governed snapshot and purge capabilities. |
|
|
38
39
|
| `python tools/debt_harvester.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | tools/debt_harvester.py β Technical Debt & Shortcut Harvester |
|
|
39
40
|
| `python tools/diagram_architect.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | tools/diagram_architect.py β Standalone Self-Contained SVG & HTML Diagram Builder |
|
|
40
41
|
| `python tools/distill_log.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | tools/distill_log.py β Enterprise Multi-Framework Log Distiller (Token & Failure Sentinel) |
|
|
42
|
+
| `python tools/distill_skill.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `destructive` | tools/distill_skill.py β Dual-Skill Distillation Engine |
|
|
41
43
|
| `python tools/dspy_qa_signatures.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | Declarative QA Signature Compilation Engine (Stanford DSPy Pattern) |
|
|
42
44
|
| `python tools/e2e_flow_prober.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | Enterprise E2E Flow Prober & XPath Crawler Dispatcher (Cross-Platform) |
|
|
43
45
|
| `python tools/export_postman_collection.py` | **API & Contract Testing** | `api-engineer` | π’ Stable | `read_only` | Exports API test matrices into runnable Postman Collections with pre-request scripts. |
|
|
@@ -56,14 +58,14 @@
|
|
|
56
58
|
| `python tools/git_pre_commit_guard.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | Enterprise Git Pre-Commit Architecture & Discipline Guard |
|
|
57
59
|
| `python tools/git_worktree_manager.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | tools/git_worktree_manager.py β Ephemeral Git Worktree Manager for Subagents |
|
|
58
60
|
| `python tools/goldfish_review.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | tools/goldfish_review.py β Zero-Context Test Specification Reviewer |
|
|
59
|
-
| `python tools/heal_pr_automator.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `
|
|
61
|
+
| `python tools/heal_pr_automator.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `modifying` | Enterprise Self-Healing Confidence Scorer & PR Automator |
|
|
60
62
|
| `python tools/heuristic_locator_matcher.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | 3-Layer Heuristic Locator Matcher (0-Token Autonomous Recovery) |
|
|
61
63
|
| `python tools/hub_publisher.py` | **CI/CD & Packaging** | `orchestrator` | π’ Stable | `modifying` | Autonomous 1-click 5-step release pipeline for Synapse Hub. |
|
|
62
64
|
| `python tools/humanize_linter.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | Humanize & Anti-AI Slop Linter (Enterprise QA Hub) |
|
|
63
65
|
| `python tools/infer_linter.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | Universal QA Static Defect & Assertion Sentinel (Inspired by facebook/infer) |
|
|
64
66
|
| `python tools/init_config.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | tools/init_config.py β Standardized Project Configuration Bootstrapper |
|
|
65
67
|
| `python tools/interview_story.py` | **Manual Testing & Design** | `test-designer` | π’ Stable | `read_only` | Interactive requirement interrogation engine surfacing hidden assumptions and ambiguous acceptance criteria. |
|
|
66
|
-
| `python tools/jira_sync.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `
|
|
68
|
+
| `python tools/jira_sync.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `modifying` | tools/jira_sync.py β Jira / Xray / Zephyr Enterprise 2-Way Synchronization Engine |
|
|
67
69
|
| `python tools/jtl_analyzer.py` | **Performance Testing** | `perf-engineer` | π’ Stable | `read_only` | Sub-0.1s Apache JMeter JTL results analyzer enforcing automated CI/CD SLA quality gates. |
|
|
68
70
|
| `python tools/lint_ai_docs.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | Enterprise AI Documentation & Artifact Linter (Anti-Drift Guard v2.0) |
|
|
69
71
|
| `python tools/lookup_tc.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | Enterprise QA: Fast Test Case Metadata Lookup (lookup_tc.py) |
|
|
@@ -83,14 +85,14 @@
|
|
|
83
85
|
| `python tools/omni_transpiler.py` | **Code Generation & AST** | `pom-crafter` | π’ Stable | `modifying` | Instant 0-token transpiler between Playwright, Selenium, and Katalon. |
|
|
84
86
|
| `python tools/openxml_guard.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | OpenXML Security & Protocol Defense Guard |
|
|
85
87
|
| `python tools/output_formatter.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | Enterprise Standardized Output Formatter & Exit Code Specification |
|
|
86
|
-
| `python tools/package_release.py` | **CI/CD & Packaging** | `orchestrator` | π’ Stable | `
|
|
88
|
+
| `python tools/package_release.py` | **CI/CD & Packaging** | `orchestrator` | π’ Stable | `modifying` | Enterprise release packager preserving .github/workflows and generating SHA-256 provenance. |
|
|
87
89
|
| `python tools/pairwise_generator.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | tools/pairwise_generator.py β Pairwise (2-Way) Combinatorial Test Case Generator |
|
|
88
90
|
| `python tools/pentest_scope_guard.py` | **Testing & Utilities** | `orchestrator` | π’ Stable | `read_only` | tools/pentest_scope_guard.py β Enterprise Pentest Scope & DAST Runtime Guard |
|
|
89
91
|
| `python tools/pinpoint_failure.py` | **Failure Autopsy & Healing** | `failure-analyst` | π’ Stable | `read_only` | Sub-0.1s JUnit XML autopsy parser diagnosing test crashes without LLM token waste. |
|
|
90
92
|
| `python tools/project_state.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | Enterprise Project State Machine & Token-Capped Memory Anchor |
|
|
91
93
|
| `python tools/qa_event_stream.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | Immutable QA Event Stream Engine (OpenHands EventStream Pattern) |
|
|
92
94
|
| `python tools/repo_map.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | Enterprise Repository Map Compressor (Inspired by Aider-AI/aider) |
|
|
93
|
-
| `python tools/reversible_sandbox.py` | **
|
|
95
|
+
| `python tools/reversible_sandbox.py` | **Sandboxing & Isolation** | `failure-analyst` | π’ Stable | `modifying` | Two-phase commit write-ahead logging (WAL) execution sandbox providing crash-resilient rollback guarantees. |
|
|
94
96
|
| `python tools/rules_router.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | tools/rules_router.py β Progressive Rules Router & Context Optimizer (Boost B2) |
|
|
95
97
|
| `python tools/runaway_stopper.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | tools/runaway_stopper.py β Agent Runaway & Token Loop Sentinel |
|
|
96
98
|
| `python tools/safety_firewall.py` | **Security** | `quality-gatekeeper` | π’ Stable | `read_only` | Non-bypassable safety firewall blocking destructive operations (drop database, git push force, rm -rf). |
|
|
@@ -98,24 +100,26 @@
|
|
|
98
100
|
| `python tools/security_scanner.py` | **Security** | `quality-gatekeeper` | π’ Stable | `read_only` | Comprehensive enterprise security sentinel auditing Python & NPM dependencies and threat-model defense. |
|
|
99
101
|
| `python tools/senior_code_review.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | tools/senior_code_review.py β Senior Developer Quality & Lean Diff Reviewer |
|
|
100
102
|
| `python tools/setup_project.py` | **Setup & Onboarding** | `orchestrator` | π’ Stable | `modifying` | Zero-command automated project bootstrap tailoring AI agent rules to the target stack. |
|
|
101
|
-
| `python tools/skill_canonical_digest.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `
|
|
102
|
-
| `python tools/skill_collision_guard.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `
|
|
103
|
-
| `python tools/skill_profiles.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `
|
|
104
|
-
| `python tools/skill_vault.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `
|
|
103
|
+
| `python tools/skill_canonical_digest.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `destructive` | tools/skill_canonical_digest.py β Single Source of Truth for Skill Canonical Digest & Lockfile Integrity |
|
|
104
|
+
| `python tools/skill_collision_guard.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `destructive` | Tier-2 Skill Routing & Collision Guard (Addy Osmani Pattern) |
|
|
105
|
+
| `python tools/skill_profiles.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `destructive` | tools/skill_profiles.py β Skill Catalog Capability Profile Manager |
|
|
106
|
+
| `python tools/skill_vault.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `destructive` | SkillVault Lifelong Page Object Model & Interaction Library (MineDojo / Voyager Pattern) |
|
|
105
107
|
| `python tools/skillspector.py` | **Security** | `quality-gatekeeper` | π’ Stable | `read_only` | Security scanner detecting prompt injection, Unicode obfuscation, and dangerous CLI tools. |
|
|
108
|
+
| `python tools/slide_deck_exporter.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | tools/slide_deck_exporter.py β Pure HTML/CSS 16:9 Vector Slide Deck Exporter |
|
|
106
109
|
| `python tools/smart_visual_masker.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | Smart Visual Masker & Anti-Flake Visual Engine |
|
|
107
110
|
| `python tools/spec_drift_sentinel.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | tools/spec_drift_sentinel.py β Spec-to-Code Drift Sentinel |
|
|
108
111
|
| `python tools/swe_qa_aci.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | QA Agent-Computer Interface (SWE-agent ACI Pattern) |
|
|
109
112
|
| `python tools/synapse_observer.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | Synapse Cognitive Observer & Tradeoff Sentinel |
|
|
110
113
|
| `python tools/synapse_qa_bench.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | Synapse-QA-Bench: Tool Function Calling Benchmark (Gorilla BFCL Pattern) |
|
|
111
|
-
| `python tools/sync_agent_rules.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `
|
|
112
|
-
| `python tools/sync_skills_manifest.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `
|
|
114
|
+
| `python tools/sync_agent_rules.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `modifying` | tools/sync_agent_rules.py β Synchronizes AGENTS.md single-source rules to all AI bridges |
|
|
115
|
+
| `python tools/sync_skills_manifest.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `destructive` | tools/sync_skills_manifest.py β Synchronize Skill Policies & Frontmatter into Manifest |
|
|
116
|
+
| `python tools/task_memory_manager.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | tools/task_memory_manager.py β Compaction-Resilient Working Memory Manager |
|
|
113
117
|
| `python tools/telemetry_correlator.py` | **Performance Testing** | `perf-engineer` | π’ Stable | `read_only` | Full-stack APM & server telemetry performance correlator linking client latencies with server hardware. |
|
|
114
118
|
| `python tools/template_excel_exporter.py` | **Manual Testing & Design** | `test-designer` | π’ Stable | `modifying` | Enterprise template-driven Excel test case exporter with dropdown Data Validation. |
|
|
115
119
|
| `python tools/test_impact.py` | **Testing & Utilities** | `orchestrator` | π’ Stable | `read_only` | Universal Test Impact Analyzer (Graphify AST-Powered) |
|
|
116
120
|
| `python tools/test_memory_os.py` | **Testing & Utilities** | `orchestrator` | π’ Stable | `read_only` | Hierarchical QA Test Memory OS (Letta / MemGPT Pattern) |
|
|
117
121
|
| `python tools/textgrad_mutation_optimizer.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | Mutant-Directed Textual Loss Optimizer (Deterministic TextGrad-Style Heuristic) |
|
|
118
|
-
| `python tools/tms_sync_bridge.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `
|
|
122
|
+
| `python tools/tms_sync_bridge.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `modifying` | Enterprise ALM & TMS Sync Bridge (Jira / Xray / Zephyr / TestRail) |
|
|
119
123
|
| `python tools/token_telemetry.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | tools/token_telemetry.py β Live LLM Token & MTTR Telemetry Engine |
|
|
120
124
|
| `python tools/tot_exploratory_tester.py` | **Manual Testing & Design** | `test-designer` | π’ Stable | `read_only` | Tree-of-Thoughts exploratory scenario generator with risk scoring and boundary decomposition. |
|
|
121
125
|
| `python tools/trace_data_flow.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | Universal Data Flow & Teardown Tracer (Taint Analysis) |
|
|
@@ -125,7 +129,8 @@
|
|
|
125
129
|
| `python tools/universal_ir.py` | **Code Generation & AST** | `pom-crafter` | π’ Stable | `read_only` | Language-agnostic and framework-agnostic AST data model for automated test suites. |
|
|
126
130
|
| `python tools/update_sentinel.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | Enterprise Synapse-Hub Auto-Update & Version Drift Sentinel |
|
|
127
131
|
| `python tools/validate_groovy_scripts.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | Pre-check validator for Groovy scripts and POM keywords in enterprise test suites. |
|
|
128
|
-
| `python tools/
|
|
132
|
+
| `python tools/validate_host_interop.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | tools/validate_host_interop.py β Multi-Host AI Agent Interoperability Sentinel |
|
|
133
|
+
| `python tools/validate_skills_schema.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `destructive` | tools/validate_skills_schema.py β Standalone Skill Schema & Policy Validator |
|
|
129
134
|
| `python tools/verify_all.py` | **Quality Gates** | `quality-gatekeeper` | π’ Stable | `read_only` | One-command 10 Quality Gates Definition of Done (DoD) verification sentinel. |
|
|
130
135
|
| `python tools/visual_diff_canvas.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | Enterprise Canvas Visual Diff & Regression Checker |
|
|
131
136
|
| `python tools/visual_som_helper.py` | **Auxiliary Utilities** | `orchestrator` | π’ Stable | `read_only` | Enterprise Vision-Grounded Fallback & Set-of-Marks (SoM) Engine |
|
|
@@ -140,4 +145,4 @@
|
|
|
140
145
|
- `network`: Queries external APIs, monitors npm registry, or checks live URLs.
|
|
141
146
|
- `destructive`: High-impact actions guarded by `safety_firewall.py` (e.g. drop database, hard resets).
|
|
142
147
|
|
|
143
|
-
*Catalog generated: `2026-11-
|
|
148
|
+
*Catalog generated: `2026-11-16T07:34:48.105553+00:00` by `tools/generate_tool_catalog.py`*
|
package/package.json
CHANGED
package/plugin.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "synapse-hub",
|
|
3
3
|
"displayName": "Synapse Hub Enterprise QA",
|
|
4
|
-
"version": "4.2.
|
|
4
|
+
"version": "4.2.5",
|
|
5
5
|
"description": "Enterprise AI Agent Intelligence Hub & Autonomous Skill Network for Quality Engineering, Clean POM, and Automated Testing.",
|
|
6
6
|
"author": {
|
|
7
7
|
"name": "TeeVee98",
|
package/scripts/setup.sh
CHANGED
|
@@ -39,7 +39,12 @@ fi
|
|
|
39
39
|
# 4. Verification
|
|
40
40
|
echo -e "\n[4/5] Verifying Skills Catalog Integrity..."
|
|
41
41
|
if [ -f "tools/verify_all.py" ]; then
|
|
42
|
-
"$VENV_PY" tools/verify_all.py
|
|
42
|
+
if ! "$VENV_PY" tools/verify_all.py; then
|
|
43
|
+
echo -e "\n [WARNING] Initial Quality Gate verification reported issues."
|
|
44
|
+
echo " Run '$VENV_PY tools/verify_all.py' manually to inspect details."
|
|
45
|
+
else
|
|
46
|
+
echo " [OK] Quality Gates DoD verified successfully."
|
|
47
|
+
fi
|
|
43
48
|
fi
|
|
44
49
|
|
|
45
50
|
# 5. Initialize Central Agent Memory (SQLite Cache)
|
package/skills_manifest.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
3
|
"name": "Synapse-Hub",
|
|
4
|
-
"version": "4.2.
|
|
4
|
+
"version": "4.2.5",
|
|
5
5
|
"description": "Unified Catalog of 53 Skills across 11 Domain Packages for Enterprise QA AI Agents.",
|
|
6
6
|
"totalSkills": 53,
|
|
7
7
|
"domains": {
|
package/synapse.config.json
CHANGED
package/tools/TOOL_CATALOG.json
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schema_version": "1.0.0",
|
|
3
|
-
"updated_at": "2026-11-
|
|
4
|
-
"total_tools":
|
|
5
|
-
"stable_count":
|
|
3
|
+
"updated_at": "2026-11-16T07:34:48.105553+00:00",
|
|
4
|
+
"total_tools": 130,
|
|
5
|
+
"stable_count": 130,
|
|
6
6
|
"experimental_count": 0,
|
|
7
7
|
"tools": [
|
|
8
8
|
{
|
|
@@ -41,7 +41,7 @@
|
|
|
41
41
|
"category": "Auxiliary Utilities",
|
|
42
42
|
"owner_role": "orchestrator",
|
|
43
43
|
"status": "stable",
|
|
44
|
-
"risk_level": "
|
|
44
|
+
"risk_level": "modifying",
|
|
45
45
|
"inputs": [
|
|
46
46
|
"CLI options"
|
|
47
47
|
],
|
|
@@ -154,7 +154,7 @@
|
|
|
154
154
|
"category": "Auxiliary Utilities",
|
|
155
155
|
"owner_role": "orchestrator",
|
|
156
156
|
"status": "stable",
|
|
157
|
-
"risk_level": "
|
|
157
|
+
"risk_level": "modifying",
|
|
158
158
|
"inputs": [
|
|
159
159
|
"CLI options"
|
|
160
160
|
],
|
|
@@ -195,6 +195,21 @@
|
|
|
195
195
|
],
|
|
196
196
|
"description": "Empirical context token reduction benchmark harness proving >= 40% savings."
|
|
197
197
|
},
|
|
198
|
+
{
|
|
199
|
+
"file": "tools/break_ui_generator.py",
|
|
200
|
+
"command": "python tools/break_ui_generator.py",
|
|
201
|
+
"category": "Auxiliary Utilities",
|
|
202
|
+
"owner_role": "orchestrator",
|
|
203
|
+
"status": "stable",
|
|
204
|
+
"risk_level": "read_only",
|
|
205
|
+
"inputs": [
|
|
206
|
+
"CLI options"
|
|
207
|
+
],
|
|
208
|
+
"outputs": [
|
|
209
|
+
"Artifacts / Telemetry"
|
|
210
|
+
],
|
|
211
|
+
"description": "tools/break_ui_generator.py β Edge-Case UI Stress Testing Data Generator"
|
|
212
|
+
},
|
|
198
213
|
{
|
|
199
214
|
"file": "tools/browsergym_eval.py",
|
|
200
215
|
"command": "python tools/browsergym_eval.py",
|
|
@@ -246,7 +261,7 @@
|
|
|
246
261
|
"category": "Auxiliary Utilities",
|
|
247
262
|
"owner_role": "orchestrator",
|
|
248
263
|
"status": "stable",
|
|
249
|
-
"risk_level": "
|
|
264
|
+
"risk_level": "modifying",
|
|
250
265
|
"inputs": [
|
|
251
266
|
"CLI options"
|
|
252
267
|
],
|
|
@@ -291,7 +306,7 @@
|
|
|
291
306
|
"category": "Auxiliary Utilities",
|
|
292
307
|
"owner_role": "orchestrator",
|
|
293
308
|
"status": "stable",
|
|
294
|
-
"risk_level": "
|
|
309
|
+
"risk_level": "modifying",
|
|
295
310
|
"inputs": [
|
|
296
311
|
"CLI options"
|
|
297
312
|
],
|
|
@@ -306,7 +321,7 @@
|
|
|
306
321
|
"category": "Auxiliary Utilities",
|
|
307
322
|
"owner_role": "orchestrator",
|
|
308
323
|
"status": "stable",
|
|
309
|
-
"risk_level": "
|
|
324
|
+
"risk_level": "modifying",
|
|
310
325
|
"inputs": [
|
|
311
326
|
"CLI options"
|
|
312
327
|
],
|
|
@@ -423,17 +438,20 @@
|
|
|
423
438
|
{
|
|
424
439
|
"file": "tools/db_sandbox.py",
|
|
425
440
|
"command": "python tools/db_sandbox.py",
|
|
426
|
-
"category": "
|
|
427
|
-
"owner_role": "
|
|
441
|
+
"category": "Sandboxing & Isolation",
|
|
442
|
+
"owner_role": "failure-analyst",
|
|
428
443
|
"status": "stable",
|
|
429
|
-
"risk_level": "
|
|
444
|
+
"risk_level": "modifying",
|
|
430
445
|
"inputs": [
|
|
431
|
-
"
|
|
446
|
+
"--mode audit|purge|restore",
|
|
447
|
+
"--db-path",
|
|
448
|
+
"--consent"
|
|
432
449
|
],
|
|
433
450
|
"outputs": [
|
|
434
|
-
"
|
|
451
|
+
"Database snapshots",
|
|
452
|
+
"Purge audit logs"
|
|
435
453
|
],
|
|
436
|
-
"description": "
|
|
454
|
+
"description": "Database state isolation sentinel with granular consent-governed snapshot and purge capabilities."
|
|
437
455
|
},
|
|
438
456
|
{
|
|
439
457
|
"file": "tools/debt_harvester.py",
|
|
@@ -480,6 +498,21 @@
|
|
|
480
498
|
],
|
|
481
499
|
"description": "tools/distill_log.py β Enterprise Multi-Framework Log Distiller (Token & Failure Sentinel)"
|
|
482
500
|
},
|
|
501
|
+
{
|
|
502
|
+
"file": "tools/distill_skill.py",
|
|
503
|
+
"command": "python tools/distill_skill.py",
|
|
504
|
+
"category": "Auxiliary Utilities",
|
|
505
|
+
"owner_role": "orchestrator",
|
|
506
|
+
"status": "stable",
|
|
507
|
+
"risk_level": "destructive",
|
|
508
|
+
"inputs": [
|
|
509
|
+
"CLI options"
|
|
510
|
+
],
|
|
511
|
+
"outputs": [
|
|
512
|
+
"Artifacts / Telemetry"
|
|
513
|
+
],
|
|
514
|
+
"description": "tools/distill_skill.py β Dual-Skill Distillation Engine"
|
|
515
|
+
},
|
|
483
516
|
{
|
|
484
517
|
"file": "tools/dspy_qa_signatures.py",
|
|
485
518
|
"command": "python tools/dspy_qa_signatures.py",
|
|
@@ -774,7 +807,7 @@
|
|
|
774
807
|
"category": "Auxiliary Utilities",
|
|
775
808
|
"owner_role": "orchestrator",
|
|
776
809
|
"status": "stable",
|
|
777
|
-
"risk_level": "
|
|
810
|
+
"risk_level": "modifying",
|
|
778
811
|
"inputs": [
|
|
779
812
|
"CLI options"
|
|
780
813
|
],
|
|
@@ -889,7 +922,7 @@
|
|
|
889
922
|
"category": "Auxiliary Utilities",
|
|
890
923
|
"owner_role": "orchestrator",
|
|
891
924
|
"status": "stable",
|
|
892
|
-
"risk_level": "
|
|
925
|
+
"risk_level": "modifying",
|
|
893
926
|
"inputs": [
|
|
894
927
|
"CLI options"
|
|
895
928
|
],
|
|
@@ -1210,7 +1243,7 @@
|
|
|
1210
1243
|
"category": "CI/CD & Packaging",
|
|
1211
1244
|
"owner_role": "orchestrator",
|
|
1212
1245
|
"status": "stable",
|
|
1213
|
-
"risk_level": "
|
|
1246
|
+
"risk_level": "modifying",
|
|
1214
1247
|
"inputs": [
|
|
1215
1248
|
"--output-dir",
|
|
1216
1249
|
"--format zip|tar.gz|both",
|
|
@@ -1317,17 +1350,20 @@
|
|
|
1317
1350
|
{
|
|
1318
1351
|
"file": "tools/reversible_sandbox.py",
|
|
1319
1352
|
"command": "python tools/reversible_sandbox.py",
|
|
1320
|
-
"category": "
|
|
1321
|
-
"owner_role": "
|
|
1353
|
+
"category": "Sandboxing & Isolation",
|
|
1354
|
+
"owner_role": "failure-analyst",
|
|
1322
1355
|
"status": "stable",
|
|
1323
|
-
"risk_level": "
|
|
1356
|
+
"risk_level": "modifying",
|
|
1324
1357
|
"inputs": [
|
|
1325
|
-
"
|
|
1358
|
+
"--execute-stateful",
|
|
1359
|
+
"--rollback",
|
|
1360
|
+
"--recover-wal"
|
|
1326
1361
|
],
|
|
1327
1362
|
"outputs": [
|
|
1328
|
-
"
|
|
1363
|
+
".agent_memory/undo_wal.jsonl",
|
|
1364
|
+
"Reversible execution rollbacks"
|
|
1329
1365
|
],
|
|
1330
|
-
"description": "
|
|
1366
|
+
"description": "Two-phase commit write-ahead logging (WAL) execution sandbox providing crash-resilient rollback guarantees."
|
|
1331
1367
|
},
|
|
1332
1368
|
{
|
|
1333
1369
|
"file": "tools/rules_router.py",
|
|
@@ -1448,7 +1484,7 @@
|
|
|
1448
1484
|
"category": "Auxiliary Utilities",
|
|
1449
1485
|
"owner_role": "orchestrator",
|
|
1450
1486
|
"status": "stable",
|
|
1451
|
-
"risk_level": "
|
|
1487
|
+
"risk_level": "destructive",
|
|
1452
1488
|
"inputs": [
|
|
1453
1489
|
"CLI options"
|
|
1454
1490
|
],
|
|
@@ -1463,7 +1499,7 @@
|
|
|
1463
1499
|
"category": "Auxiliary Utilities",
|
|
1464
1500
|
"owner_role": "orchestrator",
|
|
1465
1501
|
"status": "stable",
|
|
1466
|
-
"risk_level": "
|
|
1502
|
+
"risk_level": "destructive",
|
|
1467
1503
|
"inputs": [
|
|
1468
1504
|
"CLI options"
|
|
1469
1505
|
],
|
|
@@ -1478,7 +1514,7 @@
|
|
|
1478
1514
|
"category": "Auxiliary Utilities",
|
|
1479
1515
|
"owner_role": "orchestrator",
|
|
1480
1516
|
"status": "stable",
|
|
1481
|
-
"risk_level": "
|
|
1517
|
+
"risk_level": "destructive",
|
|
1482
1518
|
"inputs": [
|
|
1483
1519
|
"CLI options"
|
|
1484
1520
|
],
|
|
@@ -1493,7 +1529,7 @@
|
|
|
1493
1529
|
"category": "Auxiliary Utilities",
|
|
1494
1530
|
"owner_role": "orchestrator",
|
|
1495
1531
|
"status": "stable",
|
|
1496
|
-
"risk_level": "
|
|
1532
|
+
"risk_level": "destructive",
|
|
1497
1533
|
"inputs": [
|
|
1498
1534
|
"CLI options"
|
|
1499
1535
|
],
|
|
@@ -1519,6 +1555,21 @@
|
|
|
1519
1555
|
],
|
|
1520
1556
|
"description": "Security scanner detecting prompt injection, Unicode obfuscation, and dangerous CLI tools."
|
|
1521
1557
|
},
|
|
1558
|
+
{
|
|
1559
|
+
"file": "tools/slide_deck_exporter.py",
|
|
1560
|
+
"command": "python tools/slide_deck_exporter.py",
|
|
1561
|
+
"category": "Auxiliary Utilities",
|
|
1562
|
+
"owner_role": "orchestrator",
|
|
1563
|
+
"status": "stable",
|
|
1564
|
+
"risk_level": "read_only",
|
|
1565
|
+
"inputs": [
|
|
1566
|
+
"CLI options"
|
|
1567
|
+
],
|
|
1568
|
+
"outputs": [
|
|
1569
|
+
"Artifacts / Telemetry"
|
|
1570
|
+
],
|
|
1571
|
+
"description": "tools/slide_deck_exporter.py β Pure HTML/CSS 16:9 Vector Slide Deck Exporter"
|
|
1572
|
+
},
|
|
1522
1573
|
{
|
|
1523
1574
|
"file": "tools/smart_visual_masker.py",
|
|
1524
1575
|
"command": "python tools/smart_visual_masker.py",
|
|
@@ -1600,7 +1651,7 @@
|
|
|
1600
1651
|
"category": "Auxiliary Utilities",
|
|
1601
1652
|
"owner_role": "orchestrator",
|
|
1602
1653
|
"status": "stable",
|
|
1603
|
-
"risk_level": "
|
|
1654
|
+
"risk_level": "modifying",
|
|
1604
1655
|
"inputs": [
|
|
1605
1656
|
"CLI options"
|
|
1606
1657
|
],
|
|
@@ -1615,7 +1666,7 @@
|
|
|
1615
1666
|
"category": "Auxiliary Utilities",
|
|
1616
1667
|
"owner_role": "orchestrator",
|
|
1617
1668
|
"status": "stable",
|
|
1618
|
-
"risk_level": "
|
|
1669
|
+
"risk_level": "destructive",
|
|
1619
1670
|
"inputs": [
|
|
1620
1671
|
"CLI options"
|
|
1621
1672
|
],
|
|
@@ -1624,6 +1675,21 @@
|
|
|
1624
1675
|
],
|
|
1625
1676
|
"description": "tools/sync_skills_manifest.py β Synchronize Skill Policies & Frontmatter into Manifest"
|
|
1626
1677
|
},
|
|
1678
|
+
{
|
|
1679
|
+
"file": "tools/task_memory_manager.py",
|
|
1680
|
+
"command": "python tools/task_memory_manager.py",
|
|
1681
|
+
"category": "Auxiliary Utilities",
|
|
1682
|
+
"owner_role": "orchestrator",
|
|
1683
|
+
"status": "stable",
|
|
1684
|
+
"risk_level": "read_only",
|
|
1685
|
+
"inputs": [
|
|
1686
|
+
"CLI options"
|
|
1687
|
+
],
|
|
1688
|
+
"outputs": [
|
|
1689
|
+
"Artifacts / Telemetry"
|
|
1690
|
+
],
|
|
1691
|
+
"description": "tools/task_memory_manager.py β Compaction-Resilient Working Memory Manager"
|
|
1692
|
+
},
|
|
1627
1693
|
{
|
|
1628
1694
|
"file": "tools/telemetry_correlator.py",
|
|
1629
1695
|
"command": "python tools/telemetry_correlator.py",
|
|
@@ -1717,7 +1783,7 @@
|
|
|
1717
1783
|
"category": "Auxiliary Utilities",
|
|
1718
1784
|
"owner_role": "orchestrator",
|
|
1719
1785
|
"status": "stable",
|
|
1720
|
-
"risk_level": "
|
|
1786
|
+
"risk_level": "modifying",
|
|
1721
1787
|
"inputs": [
|
|
1722
1788
|
"CLI options"
|
|
1723
1789
|
],
|
|
@@ -1866,13 +1932,28 @@
|
|
|
1866
1932
|
],
|
|
1867
1933
|
"description": "Pre-check validator for Groovy scripts and POM keywords in enterprise test suites."
|
|
1868
1934
|
},
|
|
1935
|
+
{
|
|
1936
|
+
"file": "tools/validate_host_interop.py",
|
|
1937
|
+
"command": "python tools/validate_host_interop.py",
|
|
1938
|
+
"category": "Auxiliary Utilities",
|
|
1939
|
+
"owner_role": "orchestrator",
|
|
1940
|
+
"status": "stable",
|
|
1941
|
+
"risk_level": "read_only",
|
|
1942
|
+
"inputs": [
|
|
1943
|
+
"CLI options"
|
|
1944
|
+
],
|
|
1945
|
+
"outputs": [
|
|
1946
|
+
"Artifacts / Telemetry"
|
|
1947
|
+
],
|
|
1948
|
+
"description": "tools/validate_host_interop.py β Multi-Host AI Agent Interoperability Sentinel"
|
|
1949
|
+
},
|
|
1869
1950
|
{
|
|
1870
1951
|
"file": "tools/validate_skills_schema.py",
|
|
1871
1952
|
"command": "python tools/validate_skills_schema.py",
|
|
1872
1953
|
"category": "Auxiliary Utilities",
|
|
1873
1954
|
"owner_role": "orchestrator",
|
|
1874
1955
|
"status": "stable",
|
|
1875
|
-
"risk_level": "
|
|
1956
|
+
"risk_level": "destructive",
|
|
1876
1957
|
"inputs": [
|
|
1877
1958
|
"CLI options"
|
|
1878
1959
|
],
|
package/tools/__init__.py
CHANGED
package/tools/browser_helpers.js
CHANGED
|
@@ -13,7 +13,7 @@
|
|
|
13
13
|
(function () {
|
|
14
14
|
'use strict';
|
|
15
15
|
|
|
16
|
-
if (window.__qa && window.__qa.__version === '4.2.
|
|
16
|
+
if (window.__qa && window.__qa.__version === '4.2.5') {
|
|
17
17
|
return window.__qa;
|
|
18
18
|
}
|
|
19
19
|
|
|
@@ -47,7 +47,7 @@
|
|
|
47
47
|
}
|
|
48
48
|
|
|
49
49
|
const qa = {
|
|
50
|
-
__version: '4.2.
|
|
50
|
+
__version: '4.2.5',
|
|
51
51
|
|
|
52
52
|
/**
|
|
53
53
|
* 1. Smart Action Batching
|
package/tools/cli.py
CHANGED
|
@@ -133,7 +133,7 @@ def _resolve_manifest_path(repo_root: Optional[str] = None) -> Optional[str]:
|
|
|
133
133
|
def cmd_version(args):
|
|
134
134
|
"""Displays the current hub version, skill catalog count, and license information."""
|
|
135
135
|
manifest_path = _resolve_manifest_path()
|
|
136
|
-
version = "4.2.
|
|
136
|
+
version = "4.2.5"
|
|
137
137
|
manifest_skills = 53
|
|
138
138
|
if manifest_path and os.path.exists(manifest_path):
|
|
139
139
|
try:
|
|
@@ -775,14 +775,14 @@ def cmd_trend(args):
|
|
|
775
775
|
|
|
776
776
|
def _hub_version():
|
|
777
777
|
manifest_path = _resolve_manifest_path()
|
|
778
|
-
version = "4.2.
|
|
778
|
+
version = "4.2.5"
|
|
779
779
|
if manifest_path and os.path.exists(manifest_path):
|
|
780
780
|
try:
|
|
781
781
|
import json
|
|
782
782
|
with open(manifest_path, "r", encoding="utf-8") as f:
|
|
783
783
|
version = json.load(f).get("version", version)
|
|
784
784
|
except (OSError, json.JSONDecodeError):
|
|
785
|
-
version = "4.2.
|
|
785
|
+
version = "4.2.5"
|
|
786
786
|
return version
|
|
787
787
|
|
|
788
788
|
|
package/tools/core/file_lock.py
CHANGED
|
@@ -62,6 +62,10 @@ def _win32_lock(fd: int, shared: bool = False) -> bool:
|
|
|
62
62
|
Provides genuine shared (LOCKFILE_FAIL_IMMEDIATELY) and exclusive
|
|
63
63
|
(LOCKFILE_EXCLUSIVE_LOCK | LOCKFILE_FAIL_IMMEDIATELY) locks with an OVERLAPPED structure.
|
|
64
64
|
Gracefully falls back to msvcrt.locking if ctypes or LockFileEx is unavailable.
|
|
65
|
+
|
|
66
|
+
Note on fallback: msvcrt.locking natively only supports exclusive locks (LK_NBLCK).
|
|
67
|
+
When fallback is engaged, shared lock requests are safely upgraded to exclusive,
|
|
68
|
+
serializing concurrent readers.
|
|
65
69
|
"""
|
|
66
70
|
msvcrt_mod = sys.modules.get("msvcrt")
|
|
67
71
|
use_ctypes = _HAS_CTYPES and hasattr(ctypes, "windll") and hasattr(ctypes.windll, "kernel32")
|
|
@@ -92,6 +96,9 @@ def _win32_lock(fd: int, shared: bool = False) -> bool:
|
|
|
92
96
|
|
|
93
97
|
# Graceful fallback to msvcrt.locking (exclusive lock only)
|
|
94
98
|
if msvcrt_mod is not None:
|
|
99
|
+
if shared:
|
|
100
|
+
import logging
|
|
101
|
+
logging.getLogger("file_lock").debug("msvcrt fallback lacks native shared lock support; acquiring exclusive lock")
|
|
95
102
|
os.lseek(fd, 0, os.SEEK_SET)
|
|
96
103
|
msvcrt_mod.locking(fd, msvcrt_mod.LK_NBLCK, 1)
|
|
97
104
|
return True
|