synapse-hub 2.6.0 → 2.7.0

package/.agents/agents/failure-analyst.md

@@ -6,6 +6,7 @@ skills:
   - self-healing-locator
   - file-and-report-validator
   - systematic-debugging
+  - agentless-qa-repair
 tools:
   - tools/auto_heal.py
   - tools/auto_heal_reflexion.py
@@ -16,6 +17,9 @@ tools:
   - tools/ci_healing_hook.py
   - tools/micro_mutator.py
   - tools/textgrad_mutation_optimizer.py
+  - tools/agentless_patcher.py
+  - tools/heuristic_locator_matcher.py
+  - tools/telemetry_correlator.py
 ---
 
 # Failure Autopsy & Adversarial Red-Team Agent (Agent Red)

package/.agents/agents/orchestrator.md

@@ -10,6 +10,11 @@ skills:
   - meta-prompt-crafter
   - token-and-context-optimizer
   - repo-quality-audit
+  - actor-qa-swarm
+  - event-stream-qa-orchestrator
+  - qa-memory-os
+  - tot-exploratory-testing
+  - review-spec
 tools:
   - tools/setup_project.py
   - tools/analyze_project.py
@@ -22,6 +27,17 @@ tools:
   - tools/mcp_server.py
   - tools/goldfish_review.py
   - tools/interview_story.py
+  - tools/dspy_qa_signatures.py
+  - tools/autogen_qa_broker.py
+  - tools/qa_event_stream.py
+  - tools/test_memory_os.py
+  - tools/tot_exploratory_tester.py
+  - tools/watch_mode.py
+  - tools/dashboard_generator.py
+  - tools/update_sentinel.py
+  - tools/config_decoupler.py
+  - tools/check_version_sync.py
+  - tools/count_tokens.py
 ---
 
 # Lead QA Orchestrator Agent

package/.agents/agents/pom-crafter.md

@@ -14,6 +14,8 @@ skills:
   - gherkin-to-suite
   - api-network-mocking-interception
   - rbt-manual-testing
+  - mipro-prompt-compiler
+  - qa-aci-interface
 tools:
   - tools/generate_tc_from_story.py
   - tools/generate_api_matrix.py
@@ -28,6 +30,12 @@ tools:
   - tools/micro_mutator.py
   - tools/skill_vault.py
   - tools/mcp_excel_server.ps1
+  - tools/gherkin_suite.py
+  - tools/swe_qa_aci.py
+  - tools/mipro_assertion_tuner.py
+  - tools/api_fuzzer.py
+  - tools/fuzz_payloads.py
+  - tools/export_postman_collection.py
 ---
 
 # Clean POM Crafter Agent (Agent Blue)

package/.agents/agents/quality-gatekeeper.md

@@ -12,6 +12,8 @@ skills:
   - skillspector-security-guard
   - senior-code-review
   - technical-debt-harvester
+  - lean-impact-scoreboard
+  - web-agent-gym-benchmarking
 tools:
   - tools/verify_all.py
   - tools/infer_linter.py
@@ -27,6 +29,9 @@ tools:
   - tools/debt_harvester.py
   - tools/skill_collision_guard.py
   - tools/synapse_qa_bench.py
+  - tools/skillspector.py
+  - tools/author_integrity.py
+  - tools/browsergym_eval.py
 ---
 
 # Quality Gatekeeper & Sentinel Agent

package/.agents/agents/test-runner.md

@@ -19,6 +19,11 @@ tools:
   - tools/ci_healing_hook.py
   - tools/generate_allure_report.ps1
   - tools/generate_test_reports.ps1
+  - tools/generate_jmx_plan.py
+  - tools/jtl_analyzer.py
+  - tools/newman_analyzer.py
+  - tools/traffic_session_converter.py
+  - tools/db_sandbox.py
 ---
 
 # Test Execution Runner Agent

package/.agents/rules/git-push-protocol.md

@@ -31,7 +31,7 @@ AI Agents execute the clean standard Git workflow within the target project:
 ### Step 1: Pre-Push Verification (DoD Gate)
 Run the project's quality verification gate or test suite before committing:
 ```bash
-# Example: 9 Quality Gates verification or project test runner
+# Example: 10 Quality Gates verification or project test runner
 python tools/verify_all.py  # or npm test / npx playwright test
 ```
 *Never push unverified code or broken tests.*

package/.agents/rules/graphify.md

@@ -5,6 +5,8 @@ description: Consult the graphify knowledge graph at graphify-out/ for codebase
 
 ## graphify
 
+> ⚠️ **Hub vs Spoke Boundary:** Graphify directives apply strictly to target client projects containing a graphify-out/ directory. Per Anti-Pattern Blacklist Rule 7, Graphify CLI commands must never be executed on the Synapse Hub workspace.
+
 This project has a graphify knowledge graph at graphify-out/.
 
 Rules:

package/.agents/rules/mandatory-playwright-live.md

@@ -8,17 +8,17 @@ description: Mandatory rules for Autonomous Multi-Agent Swarm, Pure Headless Pla
 Mandatory for all test automation tasks in enterprise web test suites:
 
 1. **Autonomous Swarm Orchestration:**
-   - Main AI acts as **Lead QA Orchestrator**, executing directions from **Project Lead / QA Director** and coordinating 5 specialized subagents:
-     * **Live Interaction Explorer:** Probe live DOM/AOM via Playwright MCP (`browser_run_code_unsafe`).
-     * **Automation Code Crafter:** Generate Page Classes and Groovy scripts adhering to Clean POM Flat Architecture.
-     * **Test Execution Runner:** Dispatch headless Katalon tests via CLI.
-     * **Quality Gatekeeper & Failure Analyst:** Enforce 100% UTF-8 No BOM, block bypass logic, analyze failures via `FAILED_*.png` and Allure reports.
-     * **Technical Documentation Specialist:** Translate code to business workflows, generate Mermaid diagrams.
+   - Main AI acts as **Lead QA Orchestrator**, executing directions from **Project Lead / QA Director** and coordinating 5 specialized subagents in a 5-Stage FSM:
+     * **Live Interaction Explorer (live-explorer):** Probe live DOM/AOM via Playwright MCP (rowser_run_code_unsafe).
+     * **Automation Code Crafter (pom-crafter):** Generate Page Classes and test scripts adhering to Clean POM Flat Architecture.
+     * **Test Execution Runner (	est-runner):** Dispatch headless automated tests via CLI (Playwright, Katalon, Gradle, Pytest).
+     * **Failure Analyst (ailure-analyst):** Diagnose test crashes via logs, FAILED_*.png, and Allure reports; coordinate healing.
+     * **Quality Gatekeeper (quality-gatekeeper):** Air-gap sentinel enforcing 10 Quality Gates DoD, 100% UTF-8 No BOM, and zero bypass logic.
 2. **Anti-Redundancy Protocol:**
-   - Single sign-on via Zero-Second Auth (`session.json`); never re-enter login forms.
-   - Live Explorer emits JSON Data Contract -> Code Crafter consumes to codify; Documentation Specialist consumes to chart workflows. Zero redundant DOM rescanning.
+   - Single sign-on via Zero-Second Auth (session.json); never re-enter login forms.
+   - Live Explorer emits JSON Data Contract -> Code Crafter consumes to codify; Orchestrator charts workflows. Zero redundant DOM rescanning.
    - Targeted re-tests only on failed cases; never re-run entire batches for single-case bug fixes.
-   - Quality Gatekeeper conducts deep RCA only on actual FAILED cases; immediately accept PASSED runs.
+   - Failure Analyst conducts deep RCA only on actual FAILED cases; immediately accept PASSED runs.
 3. **Playwright Live Interaction & Mandatory Headless:**
    - All flow discovery, live probing, and bug fixing **MUST RUN IN PURE HEADLESS MODE**.
    - Do not open browser GUI windows to avoid stealing user desktop focus.

package/.agents/rules/mobile_appium_rules.md

@@ -1,5 +1,12 @@
-# Mobile Automation Standards & Appium Rules (Enterprise Standard)
+---
+trigger: on_demand
+description: Mobile Automation standards, Screen Object Model (SOM), and Appium driver invariants for iOS/Android suites.
+status: upcoming_extension
+---
+
+# Mobile Automation Standards & Appium Rules (Enterprise Extension)
 
+> **Status:** Upcoming extension module for Appium / Mobile SOM architectures. Activated when mobile drivers or native iOS/Android test suites are mounted.  
 > **Scope:** Applies to Mobile Automation using Appium, UIAutomator2 (Android), and XCUITest (iOS).  
 > **Objective:** Deliver resilient, independent, flake-free mobile suites supporting parallel multi-device execution.
 

package/.agents/skills/actor-qa-swarm/SKILL.md

@@ -0,0 +1,77 @@
+---
+name: actor-qa-swarm
+description: "Asynchronous Actor Model message broker and matrix sharding coordinator for multi-agent test execution. Use when distributing parallel test workloads or wiring decoupled subagent event pub/sub."
+---
+
+# Actor QA Swarm Skill — Asynchronous Actor Messaging & Matrix Sharding
+
+> **Paradigm Attribution:** Inspired by **Microsoft AutoGen v0.4+ (AG2 Actor Framework)**.  
+> **Core Principle:** Transition from synchronous lock-step file coordination to an asynchronous Actor Model. Subagents exchange messages via non-blocking mailboxes and subscribe to test failure events in real time.
+
+---
+
+## 1. The Actor Swarm Architecture
+
+```mermaid
+flowchart TD
+    Orchestrator["Orchestrator Actor"] -->|dispatch-shards| Broker["Actor QA Message Broker (tools/autogen_qa_broker.py)"]
+    Broker -->|ASSIGN_SHARD| W1["test-runner:worker_1 (Playwright Shard 1)"]
+    Broker -->|ASSIGN_SHARD| W2["test-runner:worker_2 (Playwright Shard 2)"]
+    Broker -->|ASSIGN_SHARD| W3["test-runner:worker_3 (Playwright Shard 3)"]
+    
+    W1 -.->|publish(TEST_FAILED)| Broker
+    Broker -.->|notify| Analyst["failure-analyst Actor (Triage in Parallel)"]
+```
+
+1. **Decoupled Actor Mailboxes (`send-message` / `fetch-messages`):**
+   - Each QA subagent operates as an autonomous Actor with its own private mailbox.
+   - Eliminates monolithic conversational logs and prevents context contamination across subagents.
+
+2. **Parallel Matrix Sharding (`dispatch-shards`):**
+   - Automatically splits regression test suites into $N$ balanced shards.
+   - Dispatches shards to headless Playwright worker actors running in parallel.
+
+3. **Event-Driven Triage (`subscribe` / `publish`):**
+   - When a test runner encounters a failure, it immediately publishes `TEST_FAILED`.
+   - `failure-analyst` diagnoses the failure concurrently while other test runners continue uninterrupted.
+
+---
+
+## 2. CLI Tool Usage
+
+Autonomous commands via `tools/autogen_qa_broker.py`:
+
+```bash
+# 1. Dispatch regression suite across 4 parallel shards
+python tools/autogen_qa_broker.py dispatch-shards \
+  --suite-manifest tests/regression_manifest.json \
+  --shard-count 4 \
+  --worker-role "test-runner"
+
+# 2. Subscribe failure-analyst to test failure events
+python tools/autogen_qa_broker.py subscribe \
+  --actor "failure-analyst" \
+  --event "TEST_FAILED"
+
+# 3. Send direct message between subagents
+python tools/autogen_qa_broker.py send-message \
+  --from-actor "test-runner:worker_1" \
+  --to-actor "failure-analyst" \
+  --topic "TEST_FAILED" \
+  --payload '{"test_case": "TC-102", "error": "TimeoutError"}'
+
+# 4. Fetch messages from actor mailbox
+python tools/autogen_qa_broker.py fetch-messages \
+  --actor "failure-analyst"
+
+# 5. Check broker health and verify zero deadlocks
+python tools/autogen_qa_broker.py check-health
+```
+
+---
+
+## 3. Strict Operating Invariants
+
+- **Deadlock Prevention:** Enforce 300s timeout ceilings on actor response waits.
+- **Asynchronous Execution:** No subagent shall block the main thread waiting for another subagent's response.
+- **Zero Raw Selectors:** Messages instructing code synthesis must strictly enforce Clean POM standards.

package/.agents/skills/actor-qa-swarm/examples/broker_sharding_sample.json

@@ -0,0 +1,12 @@
+{
+  "status": "PASS",
+  "total_tests": 12,
+  "shard_count": 4,
+  "shards": {
+    "worker_1": 3,
+    "worker_2": 3,
+    "worker_3": 3,
+    "worker_4": 3
+  },
+  "dispatched_to_role": "test-runner"
+}

package/.agents/skills/agentless-qa-repair/SKILL.md

@@ -0,0 +1,69 @@
+---
+name: agentless-qa-repair
+description: "Repair broken test scripts and Page Classes using an Agentless 3-phase flow: localization, candidate synthesis, and minimal diff validation. Use when repairing test failures without multi-agent chat bloat."
+---
+
+# Agentless QA Repair Skill — Ultra-Low-Token 3-Phase Failure Healing
+
+> **Paradigm Attribution:** Inspired by **UIUC OpenAutoCoder Agentless**.  
+> **Core Principle:** The best fix is the smallest working diff without round-trip chat loops. Solve 80% of daily test automation defects with a single-pass 3-stage pipeline under 2,500 tokens.
+
+---
+
+## 1. The 3-Phase Deterministic Pipeline
+
+Rather than spawning multi-turn swarm conversations that cost 40,000–80,000 tokens per failure, `agentless-qa-repair` executes in three deterministic stages:
+
+```mermaid
+flowchart LR
+    Fail["Test Failure (Stacktrace)"] --> P1["Phase 1: Localization<br/>Pinpoint file & line span"]
+    P1 --> P2["Phase 2: Candidate Gen<br/>Synthesize 3 minimal patches"]
+    P2 --> P3["Phase 3: Validation & Gate<br/>Syntax + Clean POM + Diff"]
+    P3 --> Winner["Apply Shortest Winning Diff (<10s)"]
+```
+
+1. **Phase 1 (Localization):**
+   - Parses the stacktrace (Playwright, Jest, JUnit XML, or Python Traceback).
+   - Cross-references `tools/repo_map.txt` or repository structure.
+   - Restricts focus strictly to the enclosing method and 5–10 line span.
+
+2. **Phase 2 (Parallel Candidate Synthesis):**
+   - Candidate 1: Semantic ARIA role locator (`getByRole('button', { name: '...' })`).
+   - Candidate 2: Resilient test identifier (`getByTestId('...')`).
+   - Candidate 3: Smart wait / network idle synchronization wrapper (`waitForLoadState('networkidle')`).
+
+3. **Phase 3 (Validation & Selection):**
+   - Checks AST syntax validity (Python `ast.parse` or JS/TS/Groovy bracket balance).
+   - Enforces **Clean POM**: strictly rejects raw XPath / CSS injected into test script files.
+   - Selects the shortest valid diff that clears all checks.
+
+---
+
+## 2. CLI Tool Usage
+
+Autonomous trigger via `tools/agentless_patcher.py`:
+
+```bash
+# End-to-end 3-stage healing
+python tools/agentless_patcher.py heal-failure \
+  --error-log reports/failed_run.log \
+  --repo-map tools/repo_map.txt \
+  --max-candidates 3
+
+# Localize failing line only
+python tools/agentless_patcher.py localize-error \
+  --error-log reports/failed_run.log
+
+# Generate patch candidates for a specific line
+python tools/agentless_patcher.py generate-candidates \
+  --file src/pages/CustomerDirectoryPage.ts \
+  --line 48
+```
+
+---
+
+## 3. Strict Operating Invariants
+
+- **Token Budget Ceiling:** Must stay under **2,500 tokens** per repair cycle.
+- **Zero Raw Selectors in Test Scripts:** If the failing file is located in `tests/`, `Scripts/`, or matches `*.spec.ts`, the fix must redirect selector adjustments into the corresponding Page Class extending `BasePage`.
+- **Minimal Working Diff:** Always choose the patch with the fewest altered lines that passes verification.

package/.agents/skills/agentless-qa-repair/examples/healing_report_sample.json

@@ -0,0 +1,17 @@
+{
+  "status": "PASS",
+  "localization": {
+    "file": "src/pages/CustomerDirectoryPage.ts",
+    "method": "selectCustomerRow",
+    "line_span": [48, 52]
+  },
+  "candidates_evaluated": 3,
+  "validation_results": {
+    "candidate_1": "FAIL (Syntax error: unbalanced bracket)",
+    "candidate_2": "PASS (All DoD Gates cleared, diff: 2 lines)",
+    "candidate_3": "PASS (All DoD Gates cleared, diff: 6 lines)"
+  },
+  "selected_winner": "candidate_2",
+  "tokens_consumed": 1780,
+  "elapsed_seconds": 7.8
+}

package/.agents/skills/api-spec-to-e2e-matrix/SKILL.md

@@ -65,7 +65,7 @@ Agent can automatically invoke `tools/generate_api_matrix.py` and `tools/export_
 python3 tools/generate_api_matrix.py --spec path/to/openapi.json --format md -o docs/api_matrix.md
 
 # 2. Generate JSON matrix for programmatic ingestion
-python3 tools/generate_api_matrix.py --spec path/to/openapi.json --format json -o tools/api_matrix.json
+python3 tools/generate_api_matrix.py --spec path/to/openapi.json --format json -o reports/api_matrix.json
 
 # 3. Export directly to Postman Collection v2.1.0 with AJV JSON Schema & DDT
 synapse export-postman --spec path/to/openapi.json -o postman_collection.json --env-output postman_env.json --ddt-output test_data.csv

package/.agents/skills/clean-pom-crafter/SKILL.md

@@ -22,7 +22,7 @@ Specialized skill for creating, refactoring, and standardizing test automation s
    - All `.groovy`, `.java`, `.ts`, `.tc` files must NEVER contain UTF-8 BOM bytes (`0xEF, 0xBB, 0xBF`).
 5. **Context Window Protection (Zero-Token Economy):**
    - 🚫 **NEVER read entire monolithic Page Class files (> 100KB) into LLM context.**
-   - Always use `python3 ~/.zcode/synapse-hub/tools/lookup_xpath.py <keyword>` or line-range targeted reads (`read_file` with `StartLine`/`EndLine`) to find selectors and methods on demand.
+   - Always use `python tools/lookup_xpath.py <keyword>` or line-range targeted reads (`read_file` with `StartLine`/`EndLine`) to find selectors and methods on demand.
 
 ---
 
@@ -68,7 +68,7 @@ All Page Classes **MUST** follow this strict locator hierarchy:
 
 - [**Standard Clean POM Methods (`pom_patterns.groovy`)**](references/pom_patterns.groovy): Full implementation of `searchRecord`, `editRecord`, `deleteRecord`, `setCalendarDate`, `selectMultiOptions`, `verifyRecordExists`, `verifyRecordNotExists`, `jsSetInput`.
 - [**Standard Test Script Template (`standard_test_case.groovy`)**](examples/standard_test_case.groovy): 7-step complete script template from Login -> Create -> Search -> Edit -> Delete.
-- [**Zero-Token XPath Lookup (`~/.zcode/synapse-hub/tools/lookup_xpath.py`)**](~/.zcode/synapse-hub/tools/lookup_xpath.py): Command `python3 ~/.zcode/synapse-hub/tools/lookup_xpath.py <PageClass>` returns exact locators in <200 tokens without parsing full files.
+- [**Zero-Token XPath Lookup (`tools/lookup_xpath.py`)**](tools/lookup_xpath.py): Command `python tools/lookup_xpath.py <PageClass>` returns exact locators in <200 tokens without parsing full files.
 - [**Browser Runtime Helper (`tools/browser_helpers.js`)**](tools/browser_helpers.js): In-browser validation engine for form audits, safe clicks, and batch verification.
 
 ---

package/.agents/skills/db-state-verifier-and-seeder/SKILL.md

@@ -102,22 +102,22 @@ To eliminate cascading flakiness and orphan test junk in parallel CI runs, agent
 ### 1. Transaction Savepoint Rollback Context
 Wrap E2E test data creation inside transactional savepoints:
 ```bash
-python3 ~/.zcode/synapse-hub/tools/db_sandbox.py rollback-test --db-path "path/to/db.sqlite"
+python tools/db_sandbox.py rollback-test --db-path "path/to/db.sqlite"
 ```
 *Guarantees zero leftover records: state is automatically rolled back to pristine baseline upon test completion.*
 
 ### 2. Ephemeral Snapshot & Instant Restore (< 0.5s)
 ```bash
 # Before test suite runs: capture pristine database baseline
-python3 ~/.zcode/synapse-hub/tools/db_sandbox.py snapshot --id pristine_baseline
+python tools/db_sandbox.py snapshot --id pristine_baseline
 
 # After suite execution: instantly restore clean database
-python3 ~/.zcode/synapse-hub/tools/db_sandbox.py restore --id pristine_baseline
+python tools/db_sandbox.py restore --id pristine_baseline
 ```
 
 ### 3. Taint Pollution Audit & Cascading Purge
 Scan all tables for orphan records carrying test prefixes (`AUTO_`, `TEST_`) and purge them cleanly:
 ```bash
-python3 ~/.zcode/synapse-hub/tools/db_sandbox.py audit
+python tools/db_sandbox.py audit
 ```
 

package/.agents/skills/event-stream-qa-orchestrator/SKILL.md

@@ -0,0 +1,79 @@
+---
+name: event-stream-qa-orchestrator
+description: "Immutable EventStream orchestrator recording deterministic action/observation timelines with SHA-256 hash chains and reversible checkpoint rollbacks. Use when tracing test executions and managing replayable state."
+---
+
+# QA Event Stream Orchestrator Skill — Immutable Audit & Replay Timeline
+
+> **Paradigm Attribution:** Inspired by **All-Hands-AI OpenHands (EventStream & CodeAct Runtime)**.  
+> **Core Principle:** Treat automated testing sessions as an append-only, immutable stream of events. Prevent state corruption and lost context by chaining each event with cryptographic SHA-256 hashes and enabling deterministic check-pointed rollbacks.
+
+---
+
+## 1. The EventStream Pipeline
+
+```mermaid
+flowchart LR
+    Init["init-stream<br/>Genesis Hash (000...0)"] --> Act["record-event<br/>ACTION_NAVIGATE / ACTION_CLICK"]
+    Act --> Obs["record-event<br/>OBSERVATION_DOM / ASSERTION"]
+    Obs --> Check["Checkpoint Anchor<br/>CHECKPOINT_PRE_SUBMIT"]
+    Check --> Verify["verify-stream<br/>Cryptographic Audit"]
+    Verify --> Rollback["rollback<br/>Rewind to Checkpoint"]
+```
+
+1. **Immutable Event Logging (`record-event`):**
+   - Each event records: `index`, `session_id`, `event_type`, `actor`, `payload`, `timestamp`, `prev_hash`, and `event_hash`.
+   - Continuous SHA-256 hash chaining prevents unobserved event injection or tampering.
+
+2. **Reversible Checkpointing (`rollback`):**
+   - In conjunction with GoEx LIFO undo stack (`tools/reversible_sandbox.py`), enables restoring the browser or data state when an unexpected crash occurs.
+   - Appends a `ROLLBACK_EXECUTED` event to the stream without destroying the audit trail.
+
+3. **Cryptographic Verification (`verify-stream`):**
+   - Verifies hash continuity from genesis to latest event.
+   - Ensures zero missing or out-of-order events before certifying run results.
+
+---
+
+## 2. CLI Tool Usage
+
+Autonomous commands via `tools/qa_event_stream.py`:
+
+```bash
+# 1. Initialize stream
+python tools/qa_event_stream.py init-stream \
+  --session-id "CHECKOUT_E2E_001" \
+  --out-file .agent_memory/timeline.jsonl
+
+# 2. Record an action event
+python tools/qa_event_stream.py record-event \
+  --stream .agent_memory/timeline.jsonl \
+  --event-type ACTION_CLICK \
+  --actor live-explorer \
+  --payload '{"page":"CartPage","element":"checkout_button"}'
+
+# 3. Create a state checkpoint
+python tools/qa_event_stream.py record-event \
+  --stream .agent_memory/timeline.jsonl \
+  --event-type CHECKPOINT \
+  --actor test-runner \
+  --payload '{"cart_total": 99.99}' \
+  --checkpoint-id "PRE_CHECKOUT_FORM"
+
+# 4. Verify stream integrity
+python tools/qa_event_stream.py verify-stream \
+  --stream .agent_memory/timeline.jsonl
+
+# 5. Rollback to checkpoint on test failure
+python tools/qa_event_stream.py rollback \
+  --stream .agent_memory/timeline.jsonl \
+  --to-checkpoint "PRE_CHECKOUT_FORM"
+```
+
+---
+
+## 3. Strict Operating Invariants
+
+- **Hash Chain Integrity:** All events must compute `SHA-256(prev_hash | session_id | event_type | actor | payload | timestamp)`.
+- **Zero Log Tampering:** Never edit `timeline.jsonl` lines manually; always append via the CLI tool.
+- **UTF-8 No BOM:** Timeline files must remain clean UTF-8 without byte-order marks.

package/.agents/skills/event-stream-qa-orchestrator/examples/timeline_sample.jsonl

@@ -0,0 +1,2 @@
+{"index": 0, "session_id": "SESSION_DEMO_001", "event_type": "STREAM_INIT", "actor": "system", "payload": {"initialized_at": "2026-11-04T12:00:00Z"}, "timestamp": "2026-11-04T12:00:00Z", "prev_hash": "0000000000000000000000000000000000000000000000000000000000000000", "event_hash": "1a2b3c4d5e6f"}
+{"index": 1, "session_id": "SESSION_DEMO_001", "event_type": "ACTION_NAVIGATE", "actor": "live-explorer", "payload": {"url": "https://app.local/login"}, "timestamp": "2026-11-04T12:00:01Z", "prev_hash": "1a2b3c4d5e6f", "event_hash": "2b3c4d5e6f7a"}

package/.agents/skills/failure-autopsy-and-healing/SKILL.md

@@ -21,7 +21,7 @@ flowchart LR
 
 1. **Zero-Token Triage:** Pinpoint failed line and cause instantly (<50 tokens):
    ```bash
-   python3 ~/.zcode/synapse-hub/tools/pinpoint_failure.py
+   python tools/pinpoint_failure.py
    # or bash .agents/skills/failure-autopsy-and-healing/scripts/triage_failures.sh
    ```
 2. **Visual Autopsy:** Inspect the latest error screenshot to immediately detect: disabled buttons, missing required fields, UI overlaps, or obscuring modal backdrops.
@@ -49,7 +49,7 @@ flowchart LR
 
 - [**Diagnostic & Healing Matrix (`healing_matrix.md`)**](references/healing_matrix.md): Concrete code prescriptions for disabled buttons, boundary overlaps, `ElementClickInterceptedException`, `StaleElementReferenceException`, and 4 flaky test root causes.
 - [**Fast-Fix Triad & Runtime Helper (`tools/browser_helpers.js`)**](tools/browser_helpers.js): In-browser diagnosis engine via `window.__qa` (`audit`, `heal`, `clickSafe`, `hud`).
-- **Automated Triage Script:** `python3 ~/.zcode/synapse-hub/tools/pinpoint_failure.py` and `scripts/triage_failures.sh`.
+- **Automated Triage Script:** `python tools/pinpoint_failure.py` and `scripts/triage_failures.sh`.
 
 ---
 

package/.agents/skills/failure-autopsy-and-healing/scripts/triage_failures.sh

@@ -64,28 +64,13 @@ list_recent_screenshots() {
 list_recent_screenshots | while read -r epoch date time filepath; do
     filename=$(basename "$filepath")
     
-    # Ánh xạ Page Class gợi ý dựa trên mã Test Case (Dynamic Pattern Matching)
+    # Dynamic Page Class mapping via repo_map lookup or fallback to BasePage
     suggested_page="BasePage.groovy"
-    if [[ "$filename" =~ TC-([0-9]+) ]]; then
-        tc_num="${BASH_REMATCH[1]}"
-        if [ "$tc_num" -ge 1 ] && [ "$tc_num" -le 7 ]; then
-            suggested_page="TargetPlanPage.groovy"
-        elif [ "$tc_num" -ge 8 ] && [ "$tc_num" -le 12 ]; then
-            suggested_page="LoginPage.groovy"
-        elif [ "$tc_num" -ge 13 ] && [ "$tc_num" -le 16 ]; then
-            suggested_page="UserAdminPage.groovy"
-        elif [ "$tc_num" -ge 17 ] && [ "$tc_num" -le 28 ]; then
-            suggested_page="CommonCategoryPage.groovy"
-        elif [ "$tc_num" -ge 29 ] && [ "$tc_num" -le 92 ]; then
-            suggested_page="IndustryCategoryPage.groovy"
-        elif [ "$tc_num" -ge 93 ] && [ "$tc_num" -le 122 ]; then
-            suggested_page="PlanningPage.groovy"
-        elif [ "$tc_num" -ge 123 ] && [ "$tc_num" -le 247 ]; then
-            suggested_page="DataMiningPage.groovy"
-        elif [ "$tc_num" -ge 248 ] && [ "$tc_num" -le 249 ]; then
-            suggested_page="ReportPage.groovy"
-        elif [ "$tc_num" -ge 250 ] && [ "$tc_num" -le 259 ]; then
-            suggested_page="TokenMgmtPage.groovy"
+    if [ -f "tools/repo_map.txt" ] && [[ "$filename" =~ TC-([0-9]+) ]]; then
+        tc_pattern="TC-${BASH_REMATCH[1]}"
+        found_page=$(grep -m 1 -i "$tc_pattern" tools/repo_map.txt | awk '{print $1}' 2>/dev/null)
+        if [ -n "$found_page" ]; then
+            suggested_page="$found_page"
         fi
     fi
 

package/.agents/skills/katalon-cli-runner/SKILL.md

@@ -72,5 +72,5 @@ katalonc -noSplash -runMode=console \
 3. **Compile Allure Report:** `allure generate ./allure-results -o ./Reports/allure-report --clean`.
 4. If failures occur, immediately dispatch failure autopsy:
    ```bash
-   python3 ~/.zcode/synapse-hub/tools/pinpoint_failure.py
+   python tools/pinpoint_failure.py
    ```

package/.agents/skills/mipro-prompt-compiler/SKILL.md

@@ -0,0 +1,59 @@
+---
+name: mipro-prompt-compiler
+description: "MIPROv2 Bayesian teleprompter optimizer and few-shot compiler tuning prompt instructions against AST mutation kill scores. Use when optimizing QA prompts or compiling few-shot assertion generators."
+---
+
+# MIPROv2 Prompt Compiler Skill — Bayesian Few-Shot & Assertion Optimization
+
+> **Paradigm Attribution:** Inspired by **Stanford NLP DSPy v2 (MIPROv2 Teleprompter) & Optuna TPE**.  
+> **Core Principle:** Transition from subjective handcrafted prompting to algorithmic Bayesian compilation. Tune instruction phrasing and select the highest-leverage few-shot demonstrations to maximize AST mutant detection ($\ge 85\%$) while keeping token footprint under 800 tokens.
+
+---
+
+## 1. The MIPROv2 Compilation Pipeline
+
+```mermaid
+flowchart LR
+    Sig["QA Signature<br/>tools/dspy_qa_signatures.py"] --> Tuner["MIPROv2 Prompt Tuner<br/>tools/mipro_assertion_tuner.py"]
+    Vault["Few-Shot Demonstrations<br/>tools/skill_vault.py"] --> Tuner
+    Tuner --> Trials["20-25 Iterative Trials<br/>Bayesian Instruction Search"]
+    Trials --> Eval["Objective Function<br/>micro_mutator.py (Kill Rate >= 85%)"]
+    Eval --> Export["Compiled Prompt Module<br/>compiled/optimized_module.json"]
+```
+
+1. **Multi-Prompt Instruction Search:**
+   - Explores multiple candidate instruction phrasings (defensive assertions, state verification, boundary checks).
+   - Dynamically selects optimal subsets of few-shot demonstrations from `skill_vault.db`.
+
+2. **AST Mutation Objective Function:**
+   - Instead of subjective human preference, prompts are evaluated against real syntactic AST faults generated by `tools/micro_mutator.py`.
+   - Rejects prompt configurations with mutant kill rates below 85%.
+
+3. **Compiled Module Artifact:**
+   - Produces a frozen, deterministic JSON specification ready for deployment in production AI subagents.
+
+---
+
+## 2. CLI Tool Usage
+
+Autonomous commands via `tools/mipro_assertion_tuner.py`:
+
+```bash
+# 1. Compile and optimize assertion generation prompt
+python tools/mipro_assertion_tuner.py compile-module \
+  --signature "AssertionGenerator" \
+  --trials 20 \
+  --out-module compiled/optimized_assertion_gen.json
+
+# 2. Evaluate compiled prompt module against testset
+python tools/mipro_assertion_tuner.py evaluate \
+  --module compiled/optimized_assertion_gen.json
+```
+
+---
+
+## 3. Strict Operating Invariants
+
+- **Mutation Score Hard Floor:** Prompts must achieve a minimum mutant kill rate of **85%**.
+- **Token Ceiling:** Compiled prompts must not exceed **800 tokens**.
+- **No Handcrafted Drift:** Do not manually edit compiled JSON modules; re-run `compile-module` when requirements evolve.

package/.agents/skills/mipro-prompt-compiler/examples/compiled_module_sample.json

@@ -0,0 +1,22 @@
+{
+  "status": "PASS",
+  "module": "AssertionGenerator",
+  "optimization_trials": 20,
+  "best_trial_id": 14,
+  "baseline_mutation_score": 0.68,
+  "optimized_mutation_score": 0.895,
+  "estimated_token_footprint": 245,
+  "token_reduction_percent": 69.4,
+  "compiled_prompt": {
+    "instruction": "Produce strict web-first assertions avoiding tautologies, with dynamic wait and payload integrity checks.",
+    "demonstrations": [
+      {
+        "id": "demo_1",
+        "action": "submitOrder",
+        "assertion": "await expect(this.confirmationModal).toBeVisible();\nawait expect(this.orderId).not.toBeEmpty();"
+      }
+    ],
+    "signature": "AssertionGenerator"
+  },
+  "elapsed_seconds": 0.12
+}