@teevee98/synapse-hub 4.2.2 → 4.2.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (40) hide show
  1. package/.agents/rules/mandatory-playwright-live.md +1 -1
  2. package/.agents/skills/01-web-automation/playwright-live-interaction/SKILL.md +2 -2
  3. package/.agents/skills/01-web-automation/playwright-live-interaction/references/recipes.md +14 -31
  4. package/.agents/skills/05-security-and-compliance/wcag-audit-patterns/SKILL.md +5 -4
  5. package/AGENTS.md +1 -1
  6. package/README.en.md +2 -2
  7. package/README.md +2 -2
  8. package/agentskills.json +1 -1
  9. package/docs/ARCHITECTURE.en.md +1 -1
  10. package/docs/ARCHITECTURE.md +1 -1
  11. package/docs/PERFORMANCE_AUDIT_REPORT.md +2 -2
  12. package/docs/TOOL_CATALOG.md +25 -20
  13. package/package.json +1 -1
  14. package/plugin.json +1 -1
  15. package/scripts/package_dist.py +21 -8
  16. package/scripts/setup.sh +6 -1
  17. package/skills_manifest.json +1 -1
  18. package/synapse.config.json +1 -1
  19. package/tools/TOOL_CATALOG.json +112 -31
  20. package/tools/__init__.py +1 -1
  21. package/tools/browser_helpers.js +2 -2
  22. package/tools/cli.py +3 -3
  23. package/tools/core/file_lock.py +7 -0
  24. package/tools/core/memory_bus.py +44 -40
  25. package/tools/core/process_supervisor.py +12 -4
  26. package/tools/core/telemetry.py +54 -16
  27. package/tools/dashboard_generator.py +6 -6
  28. package/tools/db_sandbox.py +8 -2
  29. package/tools/generate_tool_catalog.py +32 -2
  30. package/tools/mcp_docx_server.py +1 -1
  31. package/tools/mcp_excel_server.py +1 -1
  32. package/tools/mcp_server.py +1 -1
  33. package/tools/package_release.py +28 -27
  34. package/tools/reversible_sandbox.py +43 -10
  35. package/tools/skillspector.py +6 -2
  36. package/tools/ui_server.py +1 -1
  37. package/tools/update_sentinel.py +3 -3
  38. package/tools/verify_all.py +10 -9
  39. package/tools/watch_mode.py +1 -1
  40. package/tools/welcome_page.py +1 -1
@@ -29,7 +29,7 @@ description: Rules for Autonomous Multi-Agent Swarm, Pure Headless Playwright Li
29
29
 
30
30
  4. **Native Playwright Assertions & Zero-Sleep Standard:**
31
31
  - **Web-First Assertions Only:** Always utilize native auto-retrying matchers: `await expect(locator).toBeVisible()`, `await expect(locator).toBeEnabled()`, `await expect(locator).toHaveText(...)`.
32
- - **Zero Static Sleeps (AGENTS.md Rule 1.4):** Static delays (`page.waitForTimeout`, `time.sleep`, `Thread.sleep`) are strictly prohibited in test scripts. Synchronize via locator auto-waiting or `page.waitForLoadState('networkidle')`.
32
+ - **Zero Static Sleeps (AGENTS.md Rule 1.3):** Static delays (`page.waitForTimeout`, `time.sleep`, `Thread.sleep`) are strictly prohibited in test scripts. Synchronize via locator auto-waiting or bounded `page.waitForLoadState('networkidle')` (avoid unconditional `networkidle` on apps with continuous background polling, WebSocket, or streaming traffic).
33
33
  - **Clean POM Locator Hierarchy:** Page Classes must prioritize semantic locators:
34
34
  1. User-facing ARIA role (`page.getByRole(...)`)
35
35
  2. Semantic test identifier (`page.getByTestId(...)`)
@@ -61,7 +61,7 @@ flowchart LR
61
61
  | **Fill Input** | `await page.locator(sel).fill(val);` | `WebElement el = findElement(By.cssSelector(sel)); jsSetInput(el, val);` | `await this.inputField.fill(val);` |
62
62
  | **Safe Click / Overlay** | `await page.locator(sel).click();` | `WebElement el = findElement(By.cssSelector(sel)); clickElement(el);` | `await this.submitButton.click();` |
63
63
  | **Dropdown Selection** | `await page.locator('p-dropdown').click(); await page.locator('.p-dropdown-item:has-text("X")').click();` | `selectDropdownByText(dropdownEl, "X")` | `await this.dropdown.selectOption("X");` |
64
- | **Calendar Picker** | Synthetic `input` + `change` event | `jsSetInput(calendarInput, "25/10/2026")` | `await this.datePicker.fill("2026-10-25");` |
64
+ | **Calendar Picker** | `await page.locator('p-calendar input').fill('2026-10-25');` | `jsSetInput(calendarInput, "25/10/2026")` | `await this.datePicker.fill("2026-10-25");` |
65
65
  | **Catch Success Toast** | `await page.waitForSelector('.toast-success')` | `verifyToastMessage("Success")` | `await expect(this.toast).toBeVisible();` |
66
66
 
67
67
  ### Phase 3: Observe → Act → Extract Triad
@@ -82,7 +82,7 @@ flowchart LR
82
82
 
83
83
  1. **Selector Uniqueness:** Every codified locator matches exactly 1 target element in the active DOM/AOM.
84
84
  2. **Response Responsiveness:** Element interaction completes with sub-second verified latency under normal load.
85
- 3. **Event Triggering:** Complex inputs correctly fire synthetic `input` and `change` events.
85
+ 3. **Event Triggering:** Complex inputs correctly receive and validate user-equivalent inputs without bypassing framework validation.
86
86
  4. **Encoding & Standards:** All generated test fixtures adhere to 100% UTF-8 No BOM.
87
87
 
88
88
  ---
@@ -51,28 +51,17 @@ async (page) => {
51
51
  ## Recipe 4: Modal Dialogs & Popup Forms (`p-dialog`, `.card.popup-data`)
52
52
  ```javascript
53
53
  async (page) => {
54
- await page.evaluate(() => {
55
- function setAngularInput(selector, val) {
56
- const el = document.querySelector(selector);
57
- if (el) {
58
- el.value = val;
59
- el.dispatchEvent(new Event('input', { bubbles: true }));
60
- el.dispatchEvent(new Event('change', { bubbles: true }));
61
- }
62
- }
63
- const testCode = 'CCN_' + Math.floor(Date.now() / 1000);
64
- setAngularInput('input[formcontrolname="code"]', testCode);
65
- setAngularInput('input[formcontrolname="name"]', 'Cụm Công Nghiệp ' + testCode);
66
- setAngularInput('textarea[formcontrolname="address"]', 'Địa chỉ kiểm thử tự động');
67
- });
54
+ const testCode = 'CCN_' + Math.floor(Date.now() / 1000);
55
+ await page.locator('input[formcontrolname="code"]').fill(testCode);
56
+ await page.locator('input[formcontrolname="name"]').fill('Cụm Công Nghiệp ' + testCode);
57
+ await page.locator('textarea[formcontrolname="address"]').fill('Địa chỉ kiểm thử tự động');
68
58
 
69
59
  const saveBtn = page.locator('button:has-text("Lưu"), button:has-text("Xác nhận"), button[title="Xác nhận"]').first();
70
- const isEnabled = !(await saveBtn.isDisabled());
71
- if (isEnabled) {
72
- await saveBtn.click();
73
- await page.waitForTimeout(1500);
74
- }
75
- return { isSaveButtonEnabled: isEnabled };
60
+ await expect(saveBtn).toBeEnabled({ timeout: 5000 });
61
+ await saveBtn.click();
62
+ // Dynamic smart wait: wait for modal dismissal rather than arbitrary sleep
63
+ await expect(page.locator('p-dialog, .card.popup-data')).toBeHidden({ timeout: 10000 });
64
+ return { testCode, isSaveSuccess: true };
76
65
  }
77
66
  ```
78
67
 
@@ -227,17 +216,11 @@ async (page, targetKeyword) => {
227
216
  ```javascript
228
217
  async (page) => {
229
218
  const dateValue = '25/10/2026';
230
- await page.evaluate(({ selector, val }) => {
231
- const calInput = document.querySelector(selector);
232
- if (calInput) {
233
- calInput.value = val;
234
- calInput.dispatchEvent(new Event('input', { bubbles: true }));
235
- calInput.dispatchEvent(new Event('change', { bubbles: true }));
236
- calInput.dispatchEvent(new Event('blur', { bubbles: true }));
237
- }
238
- }, { selector: 'p-calendar input, input[formcontrolname*="date"], input[formcontrolname*="Date"]', val: dateValue });
239
-
240
- await page.waitForTimeout(300);
219
+ const calInput = page.locator('p-calendar input, input[formcontrolname*="date"], input[formcontrolname*="Date"]').first();
220
+ await calInput.click();
221
+ await calInput.fill(dateValue);
222
+ await calInput.press('Enter');
223
+ await expect(calInput).toHaveValue(dateValue, { timeout: 3000 });
241
224
  return { status: 'Date filled', value: dateValue };
242
225
  }
243
226
  ```
@@ -42,14 +42,14 @@ Engineering standards for automated, continuous Web Content Accessibility Guidel
42
42
 
43
43
  | Criterion | Rule Code | Level | Requirement & Automated Assertion |
44
44
  | :--- | :--- | :--- | :--- |
45
- | **Non-text Content** | WCAG 1.1.1 | Level A | All `<img>` tags must possess non-empty `alt` attributes or `aria-hidden="true"` if decorative. |
45
+ | **Non-text Content** | WCAG 1.1.1 | Level A | Informative `<img>` tags must possess descriptive `alt` text; decorative images must use null/empty `alt=""` (W3C Technique H67), `role="presentation"`, or `aria-hidden="true"`. |
46
46
  | **Info and Relationships**| WCAG 1.3.1 | Level A | Form controls `<input>`, `<select>` must link to `<label>` via `id/for` or `aria-label`. |
47
- | **Heading Structure** | WCAG 1.3.1 | Level A | Headings must not skip levels (e.g. `<h1>` followed immediately by `<h3>`). |
47
+ | **Heading Structure** | WCAG 1.3.1 | Level A | Headings should follow logical hierarchy without skipping levels (advisory best practice per W3C Technique G141). |
48
48
  | **Contrast (Minimum)** | WCAG 1.4.3 | Level AA | Normal text contrast ratio $\ge 4.5:1$; Large text ($\ge 18\text{pt}$ or bold $14\text{pt}$) $\ge 3:1$. |
49
49
  | **Keyboard Navigable** | WCAG 2.1.1 | Level A | All interactive elements must be focusable via `Tab` with visible focus indicators. |
50
- | **No Keyboard Trap** | WCAG 2.1.2 | Level A | Focus must not become permanently trapped in modal dialogs; `Esc` key must exit. |
50
+ | **No Keyboard Trap** | WCAG 2.1.2 | Level A | Focus must not become trapped; modal dialogs must provide a standard keyboard exit (e.g. `Esc` key, reachable close button). |
51
51
  | **Focus Not Obscured** | WCAG 2.4.11 | Level AA | Focused element must not be completely hidden by sticky banners, footers, or overlays (WCAG 2.2). |
52
- | **Target Size (Minimum)**| WCAG 2.5.8 | Level AA | Interactive targets must meet $24 \times 24\text{px}$ minimum bounding box or sufficient spacing (WCAG 2.2). |
52
+ | **Target Size (Minimum)**| WCAG 2.5.8 | Level AA | Interactive targets must meet $24 \times 24\text{px}$ or sufficient spacing/offset (WCAG 2.2; exceptions: inline text links, essential UI). |
53
53
  | **Consistent Help** | WCAG 3.2.6 | Level A | Help options (chat, FAQ, phone) must reside in identical relative layout order across pages (WCAG 2.2). |
54
54
  | **Redundant Entry** | WCAG 3.3.7 | Level A | Multi-step workflows must auto-populate or allow selection of previously entered data (WCAG 2.2). |
55
55
  | **Accessible Auth** | WCAG 3.3.8 | Level AA | Login must support password managers / paste / passkeys without cognitive puzzles (WCAG 2.2). |
@@ -98,6 +98,7 @@ test('modal dialog traps keyboard focus and closes on Escape', async ({ page })
98
98
  ```
99
99
 
100
100
  ### Pattern C: WCAG 2.5.8 Target Size ($24 \times 24\text{px}$) Assertion
101
+ > **WCAG 2.5.8 Exceptions:** Targets under $24 \times 24\text{px}$ pass if sufficient spacing (offset) ensures a 24px diameter circle centered on the target does not intersect another target/circle, or if the target is inline within a block of text, user-agent controlled, or essential.
101
102
  <!-- classification: illustrative -->
102
103
  ```typescript
103
104
  test('all interactive buttons satisfy WCAG 2.5.8 24x24px target size', async ({ page }) => {
package/AGENTS.md CHANGED
@@ -19,7 +19,7 @@ Mandatory across all workspaces, projects, test scripts, and runtime environment
19
19
 
20
20
  1. **100% UTF-8 No BOM:** Zero BOM bytes (`0xEF, 0xBB, 0xBF`) across all repository and test files (`.groovy`, `.java`, `.ts`, `.py`, `.json`, `.md`).
21
21
  2. **Truth Anchor (Zero Fake Passes):** Never relax assertions, skip validation steps, write empty tests (0 asserts), or catch-and-swallow exceptions (`pass`, dummy suppression `_ = err` or `_ = False`, `const _ = e`) to manufacture a pass. Report AUT defects honestly.
22
- 3. **Dynamic Smart Waits Only:** Static sleeps (`Thread.sleep`, `time.sleep`) are strictly prohibited in test scripts to prevent flakiness. Use dynamic smart waits: element visibility checks or Playwright `waitForLoadState('networkidle')`.
22
+ 3. **Dynamic Smart Waits Only:** Static sleeps (`Thread.sleep`, `time.sleep`, `waitForTimeout`) are strictly prohibited in test scripts to prevent flakiness. Use dynamic smart waits: web-first element visibility checks (`expect(locator).toBeVisible()`) or bounded Playwright `waitForLoadState('networkidle')` (avoid unconditional `networkidle` on apps with continuous polling, WebSocket, or streaming traffic).
23
23
  4. **Dynamic & Idempotent Test Data:** Always randomize test entity codes with dynamic timestamps and prefixes (`BasePage.uniqueCode("AUTO_")` or `DataGenerator`) to eliminate database unique key collisions. Every creation test case must be paired with automated Teardown cleanup.
24
24
  5. **Strict Credential Security:** Never commit raw plaintext passwords, secret tokens, private keys, or cloud credentials to git. Inject secrets via environment variables or test fixtures.
25
25
  6. **Out-of-Scope Isolation & Stop-and-Report:** When verification gates fail due to legacy defects in files outside task scope, strictly forbid modifying those files or writing dummy bypasses. Stop and report with evidence; ask the user whether to baseline legacy debt or handle it in a separate task.
package/README.en.md CHANGED
@@ -6,7 +6,7 @@
6
6
 
7
7
  > **Core Mission:** A standalone linter and guardrail engine (zero external dependencies for core engine & DoD gates) safeguarding automated test suites when AI writes code — Automatically catching "fake-pass" tests (0 assertions, tautologies), eliminating fixed sleeps, compressing 95% of CI/CD log noise, and enforcing Clean POM architecture.
8
8
  > **Author:** Thế Vị ([@TeeVee98](https://github.com/TeeVee98)) | **License:** MIT License
9
- > **Version:** `v4.2.2` | **Scale:** 53 Standardized QA Skills, 9 Specialized AI Agents, 10 DoD Quality Gates.
9
+ > **Version:** `v4.2.4` | **Scale:** 53 Standardized QA Skills, 9 Specialized AI Agents, 10 DoD Quality Gates.
10
10
 
11
11
  [![npm version](https://img.shields.io/npm/v/@teevee98/synapse-hub.svg?style=flat-square&color=blue)](https://www.npmjs.com/package/@teevee98/synapse-hub)
12
12
  [![node version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg?style=flat-square)](https://nodejs.org)
@@ -154,7 +154,7 @@ Every test code change must satisfy all 10 Quality Gates before pull request mer
154
154
  # Pre-commit hook (.pre-commit-config.yaml):
155
155
  repos:
156
156
  - repo: https://github.com/TeeVee98/Synapse-Hub
157
- rev: v4.2.2
157
+ rev: v4.2.4
158
158
  hooks:
159
159
  - id: synapse-lint
160
160
  - id: synapse-verify
package/README.md CHANGED
@@ -6,7 +6,7 @@
6
6
 
7
7
  > **Định vị cốt lõi:** Bộ Linter & Guardrails độc lập (zero external dependencies cho core engine & DoD gates) bảo vệ độ tin cậy của test suite khi AI viết code — Tự động bắt test "pass ảo" (0 assert, tautology), loại bỏ hoàn toàn sleep cố định, nén 95% log CI/CD, và chuẩn hóa cấu trúc Clean POM.
8
8
  > **Tác giả:** Thế Vị ([@TeeVee98](https://github.com/TeeVee98)) | **Giấy phép:** MIT License
9
- > **Phiên bản:** `v4.2.2` | **Quy mô:** 53 Kỹ năng QA, 9 Vai trò AI Agent, 10 Cổng kiểm định DoD.
9
+ > **Phiên bản:** `v4.2.4` | **Quy mô:** 53 Kỹ năng QA, 9 Vai trò AI Agent, 10 Cổng kiểm định DoD.
10
10
 
11
11
  [![npm version](https://img.shields.io/npm/v/@teevee98/synapse-hub.svg?style=flat-square&color=blue)](https://www.npmjs.com/package/@teevee98/synapse-hub)
12
12
  [![node version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg?style=flat-square)](https://nodejs.org)
@@ -154,7 +154,7 @@ Mọi thay đổi mã nguồn kiểm thử đều được kiểm chứng qua 10
154
154
  # Pre-commit hook (.pre-commit-config.yaml):
155
155
  repos:
156
156
  - repo: https://github.com/TeeVee98/Synapse-Hub
157
- rev: v4.2.2
157
+ rev: v4.2.4
158
158
  hooks:
159
159
  - id: synapse-lint
160
160
  - id: synapse-verify
package/agentskills.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://agentskills.io/schema/v1.json",
3
3
  "name": "Synapse-Hub",
4
- "version": "4.2.2",
4
+ "version": "4.2.4",
5
5
  "description": "Enterprise QA & Test Automation AI Skills Ecosystem — 53 skills organised across 11 Domain Packages adhering to Clean POM Flat Architecture.",
6
6
  "author": "Thế Vị (@TeeVee98)",
7
7
  "repository": "https://github.com/TeeVee98/Synapse-Hub",
@@ -3,7 +3,7 @@
3
3
  [🇻🇳 Tiếng Việt](ARCHITECTURE.md) | [🇬🇧 English Edition](ARCHITECTURE.en.md)
4
4
 
5
5
  > **Scope:** Enterprise Multi-Agent QA Hub
6
- > **Version:** `4.2.2` | **Status:** Active / Production Standard
6
+ > **Version:** `4.2.4` | **Status:** Active / Production Standard
7
7
 
8
8
  ---
9
9
 
@@ -3,7 +3,7 @@
3
3
  [🇻🇳 Tiếng Việt](ARCHITECTURE.md) | [🇬🇧 English Edition](ARCHITECTURE.en.md)
4
4
 
5
5
  > **Phạm vi:** Enterprise Multi-Agent QA Hub
6
- > **Version:** `4.2.2` | **Trạng thái:** Hoạt động / Tiêu chuẩn Sản xuất
6
+ > **Version:** `4.2.4` | **Trạng thái:** Hoạt động / Tiêu chuẩn Sản xuất
7
7
  > **Tác giả:** Thế Vị (@TeeVee98) | **Giấy phép:** MIT License
8
8
 
9
9
  ---
@@ -86,8 +86,8 @@ The evaluation covers five core performance pillars:
86
86
  ### 2.2 Technical Invalidation: Why the System Fails Production Certification
87
87
  Deploying this performance testing framework into mission-critical production pipelines without human oversight will lead to false passes, undetected latency spikes, or infrastructure instability. The certification denial is grounded in six fatal deficiencies:
88
88
 
89
- 1. **Complete Disconnection from Mandatory Quality Gatekeeper (`tools/verify_all.py`):**
90
- The central Definition of Done (`verify_all.py`), which controls Stage 5 acceptance in `AGENTS.md`, evaluates Gates 0 through 9 (attribution, BOM, path portability, clean POM, docs drift, cleanup blacklist, credentials, static defect AST, micro-mutation, and skill collision). **Zero performance or SLA gates exist in `verify_all.py`.** A PR introducing severe tail-latency degradation or elevated 5xx error rates will pass the 10 gates with zero warnings and merge into production.
89
+ 1. **[RESOLVED] Historical Disconnection from Mandatory Quality Gatekeeper (`tools/verify_all.py`):**
90
+ *(Status: Resolved in Synapse Hub v4.2+ via `gate_10_performance_sla`).* Earlier audits noted that `verify_all.py` only evaluated Gates 0 through 9 without a performance gate. `verify_all.py` now implements **Gate 10: Performance & SLA Sentinel**, which ingests performance test artifacts (`.jtl`, `k6_summary.json`) from `Reports/perf/` and validates P95 latency and error rate thresholds against configured SLAs before granting DoD certification.
91
91
  2. **Absence of Autonomous `abortOnFail` Kill-Switch in Generated JMeter Suites:**
92
92
  While the k6 documentation specifies error rate thresholds, `tools/generate_jmx_plan.py` emits thread groups with `<stringProp name="ThreadGroup.on_sample_error">continue</stringProp>` and injects no AutoStop listeners or JSR223 aggregate failure monitors. Under catastrophic gateway degradation (e.g. cascading 503s), the load generator will continuously hammer degraded upstream microservices until test completion, triggering cascading outages in shared environments.
93
93
  3. **Single-Token Auth Anti-Pattern in Canonical k6 Template:**
@@ -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:** `125` | **Stable:** `125` | **Experimental:** `0`
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 | `read_only` | Agentless 3-Stage Deterministic Patcher (OpenAutoCoder Agentless Pattern) |
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 | `read_only` | Multi-Trial Episodic Reflexion Loop for Autonomous Healing (Noah Shinn / Reflexion Pattern) |
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 | `read_only` | tools/bump_version.py — Atomic Universal Version Bumper for Synapse Hub |
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 | `read_only` | tools/check_version_sync.py — Version Synchronization Sentinel for Synapse Hub |
29
- | `python tools/ci_healing_hook.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | CI/CD Silent Self-Healing Pipeline Hook |
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` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Enterprise Zero-Pollution Database Sandbox & Ephemeral Teardown Engine |
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 | `read_only` | Enterprise Self-Healing Confidence Scorer & PR Automator |
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 | `read_only` | tools/jira_sync.py — Jira / Xray / Zephyr Enterprise 2-Way Synchronization Engine |
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 | `read_only` | Enterprise release packager preserving .github/workflows and generating SHA-256 provenance. |
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` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Reversible Execution Sandbox & Automated Teardown Engine (GoEx Pattern) |
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 | `read_only` | tools/skill_canonical_digest.py — Single Source of Truth for Skill Canonical Digest & Lockfile Integrity |
102
- | `python tools/skill_collision_guard.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | Tier-2 Skill Routing & Collision Guard (Addy Osmani Pattern) |
103
- | `python tools/skill_profiles.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/skill_profiles.py — Skill Catalog Capability Profile Manager |
104
- | `python tools/skill_vault.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | SkillVault Lifelong Page Object Model & Interaction Library (MineDojo / Voyager Pattern) |
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 | `read_only` | tools/sync_agent_rules.py — Synchronizes AGENTS.md single-source rules to all AI bridges |
112
- | `python tools/sync_skills_manifest.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/sync_skills_manifest.py — Synchronize Skill Policies & Frontmatter into Manifest |
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 | `read_only` | Enterprise ALM & TMS Sync Bridge (Jira / Xray / Zephyr / TestRail) |
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/validate_skills_schema.py` | **Auxiliary Utilities** | `orchestrator` | 🟢 Stable | `read_only` | tools/validate_skills_schema.py — Standalone Skill Schema & Policy Validator |
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-15T03:21:02.088778+00:00` by `tools/generate_tool_catalog.py`*
148
+ *Catalog generated: `2026-11-16T07:34:48.105553+00:00` by `tools/generate_tool_catalog.py`*
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@teevee98/synapse-hub",
3
- "version": "4.2.2",
3
+ "version": "4.2.4",
4
4
  "description": "Enterprise AI Agent Intelligence Hub & Autonomous Skill Network",
5
5
  "publishConfig": {
6
6
  "access": "public"
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.2",
4
+ "version": "4.2.4",
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",
@@ -44,6 +44,7 @@ EXCLUDE_DIRS = {
44
44
  ".idea",
45
45
  ".vscode",
46
46
  "agent_qa.egg-info",
47
+ "synapse_hub.egg-info",
47
48
  "archive",
48
49
  "reports",
49
50
  "Reports",
@@ -274,10 +275,16 @@ def create_package(output_zip: str = "agent-skills.zip") -> Path:
274
275
  with zipfile.ZipFile(out_path, mode="w", compression=zipfile.ZIP_DEFLATED, compresslevel=9) as zf:
275
276
  for root, dirs, files in os.walk(REPO_ROOT):
276
277
  # Prune excluded directories
277
- dirs[:] = [d for d in dirs if d not in EXCLUDE_DIRS and not d.startswith(".temp-")]
278
+ dirs[:] = [
279
+ d for d in dirs
280
+ if d not in EXCLUDE_DIRS
281
+ and not d.startswith(".temp-")
282
+ and not d.endswith(".egg-info")
283
+ and not d.startswith(("synapse_hub-", "synapse-hub-"))
284
+ ]
278
285
 
279
286
  rel_root = Path(root).relative_to(REPO_ROOT)
280
- if any(part in EXCLUDE_DIRS for part in rel_root.parts):
287
+ if any(part in EXCLUDE_DIRS or part.endswith(".egg-info") or part.startswith(("synapse_hub-", "synapse-hub-")) for part in rel_root.parts):
281
288
  continue
282
289
 
283
290
  for file_name in files:
@@ -289,12 +296,18 @@ def create_package(output_zip: str = "agent-skills.zip") -> Path:
289
296
  continue
290
297
 
291
298
  full_path = Path(root) / file_name
292
- rel_path = full_path.relative_to(REPO_ROOT)
293
- arc_name = rel_path.as_posix()
294
-
295
- zf.write(full_path, arcname=arc_name)
296
- total_files += 1
297
- total_size += full_path.stat().st_size
299
+ try:
300
+ if not full_path.exists():
301
+ continue
302
+ rel_path = full_path.relative_to(REPO_ROOT)
303
+ arc_name = rel_path.as_posix()
304
+
305
+ zf.write(full_path, arcname=arc_name)
306
+ total_files += 1
307
+ total_size += full_path.stat().st_size
308
+ except (FileNotFoundError, OSError):
309
+ # Handle transient build files or race conditions
310
+ continue
298
311
 
299
312
  zip_size_mb = out_path.stat().st_size / (1024 * 1024)
300
313
  print("✅ Packaging complete:")
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 || true
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)
@@ -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.2",
4
+ "version": "4.2.4",
5
5
  "description": "Unified Catalog of 53 Skills across 11 Domain Packages for Enterprise QA AI Agents.",
6
6
  "totalSkills": 53,
7
7
  "domains": {
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "$schema": "https://raw.githubusercontent.com/TeeVee98/Synapse-Hub/main/docs/schemas/synapse.config.schema.json",
3
- "version": "4.2.2",
3
+ "version": "4.2.4",
4
4
  "quality_gates": {
5
5
  "mutation_min_score": 80,
6
6
  "gates": {