@teevee98/synapse-hub 4.1.4 → 4.2.1
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/rules/git-push-protocol.md +2 -2
- package/.agents/skills/01-web-automation/auth-session-and-cookie-manager/SKILL.md +52 -3
- package/.agents/skills/01-web-automation/bats-testing-patterns/SKILL.md +55 -5
- package/.agents/skills/01-web-automation/clean-pom-crafter/SKILL.md +62 -67
- package/.agents/skills/01-web-automation/e2e-testing-patterns/SKILL.md +54 -4
- package/.agents/skills/01-web-automation/katalon-cli-runner/SKILL.md +62 -12
- package/.agents/skills/01-web-automation/lam-script-generator/SKILL.md +55 -8
- package/.agents/skills/01-web-automation/mobile-appium-som/SKILL.md +60 -12
- package/.agents/skills/01-web-automation/mobile-appium-som/examples/BaseScreen.java +2 -2
- package/.agents/skills/01-web-automation/mobile-appium-som/examples/LoginScreen.java +2 -2
- package/.agents/skills/01-web-automation/mobile-appium-som/examples/TC_MobileLogin.java +2 -2
- package/.agents/skills/01-web-automation/playwright-live-interaction/SKILL.md +54 -91
- package/.agents/skills/01-web-automation/playwright-webapp-testing/SKILL.md +59 -11
- package/.agents/skills/01-web-automation/web-agent-gym-benchmarking/SKILL.md +50 -4
- package/.agents/skills/02-test-design/architecture-decision-records/SKILL.md +55 -9
- package/.agents/skills/02-test-design/gherkin-to-suite/SKILL.md +55 -9
- package/.agents/skills/02-test-design/rbt-manual-testing/SKILL.md +55 -8
- package/.agents/skills/02-test-design/review-spec/SKILL.md +50 -6
- package/.agents/skills/02-test-design/tot-exploratory-testing/SKILL.md +50 -4
- package/.agents/skills/03-api-and-contracts/api-network-mocking-interception/SKILL.md +56 -5
- package/.agents/skills/03-api-and-contracts/api-spec-to-e2e-matrix/SKILL.md +53 -7
- package/.agents/skills/03-api-and-contracts/consumer-driven-contract-testing/SKILL.md +86 -36
- package/.agents/skills/04-performance-and-load/backend-load-and-stress-patterns/SKILL.md +54 -6
- package/.agents/skills/04-performance-and-load/lean-impact-scoreboard/SKILL.md +50 -6
- package/.agents/skills/04-performance-and-load/web-vitals-and-performance-profiler/SKILL.md +50 -3
- package/.agents/skills/05-security-and-compliance/security-dast-sentinel/SKILL.md +63 -14
- package/.agents/skills/05-security-and-compliance/skillspector-security-guard/SKILL.md +51 -5
- package/.agents/skills/05-security-and-compliance/wcag-audit-patterns/SKILL.md +54 -4
- package/.agents/skills/06-healing-and-resilience/agentless-qa-repair/SKILL.md +51 -5
- package/.agents/skills/06-healing-and-resilience/antigravity-test-sentinel/SKILL.md +53 -6
- package/.agents/skills/06-healing-and-resilience/failure-autopsy-and-healing/SKILL.md +54 -8
- package/.agents/skills/06-healing-and-resilience/flaky-test-sentinel-and-quarantine/SKILL.md +60 -24
- package/.agents/skills/06-healing-and-resilience/self-healing-locator/SKILL.md +52 -6
- package/.agents/skills/06-healing-and-resilience/systematic-debugging/SKILL.md +56 -10
- package/.agents/skills/06-healing-and-resilience/test-driven-development/SKILL.md +58 -12
- package/.agents/skills/06-healing-and-resilience/verification-before-completion/SKILL.md +58 -12
- package/.agents/skills/06-healing-and-resilience/visual-regression-sentinel/SKILL.md +53 -5
- package/.agents/skills/07-data-and-state/db-state-verifier-and-seeder/SKILL.md +56 -5
- package/.agents/skills/07-data-and-state/file-and-report-validator/SKILL.md +53 -4
- package/.agents/skills/07-data-and-state/synthetic-test-data-generator/SKILL.md +58 -5
- package/.agents/skills/08-code-quality/code-refactoring-refactor-clean/SKILL.md +57 -11
- package/.agents/skills/08-code-quality/graphify-impact-analyzer/SKILL.md +83 -34
- package/.agents/skills/08-code-quality/graphify-impact-analyzer/examples/dependency_blast_radius.json +3 -4
- package/.agents/skills/08-code-quality/lean-code-ladder/SKILL.md +55 -10
- package/.agents/skills/08-code-quality/repo-quality-audit/SKILL.md +49 -6
- package/.agents/skills/08-code-quality/senior-code-review/SKILL.md +52 -7
- package/.agents/skills/08-code-quality/surgical-coding-principles/SKILL.md +55 -10
- package/.agents/skills/08-code-quality/technical-debt-harvester/SKILL.md +51 -5
- package/.agents/skills/09-ci-and-devops/github-actions-templates/SKILL.md +54 -17
- package/.agents/skills/09-ci-and-devops/github-actions-templates/examples/matrix_test_pipeline.yml +2 -1
- package/.agents/skills/10-agent-orchestration/actor-qa-swarm/SKILL.md +50 -4
- package/.agents/skills/10-agent-orchestration/agent-orchestration-multi-agent-optimize/SKILL.md +53 -7
- package/.agents/skills/10-agent-orchestration/event-stream-qa-orchestrator/SKILL.md +50 -4
- package/.agents/skills/10-agent-orchestration/persistent-planning-files/SKILL.md +58 -13
- package/.agents/skills/10-agent-orchestration/qa-memory-os/SKILL.md +51 -5
- package/.agents/skills/11-ai-and-prompting/meta-prompt-crafter/SKILL.md +57 -10
- package/.agents/skills/11-ai-and-prompting/mipro-prompt-compiler/SKILL.md +50 -4
- package/.agents/skills/11-ai-and-prompting/qa-aci-interface/SKILL.md +50 -4
- package/.agents/skills/11-ai-and-prompting/token-and-context-optimizer/SKILL.md +55 -9
- package/.cursor/rules/synapse-qa.mdc +20 -7
- package/.cursorrules +19 -5
- package/.windsurfrules +18 -3
- package/AGENTS.md +51 -59
- package/CLAUDE.md +38 -24
- package/LICENSE +5 -5
- package/NOTICE +1 -1
- package/README.en.md +4 -4
- package/README.md +4 -4
- package/agentskills.json +1 -1
- package/docs/ARCHITECTURE.en.md +2 -2
- package/docs/ARCHITECTURE.md +11 -2
- package/docs/CLIENT_SUPPORT_MATRIX.md +44 -0
- package/docs/CLI_REFERENCE.en.md +6 -4
- package/docs/CLI_REFERENCE.md +1 -1
- package/docs/CONTRIBUTING.en.md +1 -1
- package/docs/CONTRIBUTING.md +2 -2
- package/docs/SIDE_EFFECTING_TOOLS_INVENTORY.md +233 -0
- package/docs/TOOL_CATALOG.md +6 -2
- package/docs/research/agent_skill_training_analysis.md +1 -1
- package/package.json +1 -1
- package/plugin.json +1 -1
- package/skills_manifest.json +320 -55
- package/synapse.config.json +1 -1
- package/templates/ai_bridges/CLAUDE.md +29 -26
- package/templates/ai_bridges/copilot-instructions.md +14 -5
- package/templates/ai_bridges/cursor_synapse_qa.mdc +16 -7
- package/templates/ai_bridges/windsurfrules +14 -3
- package/templates/ui/index.html +2 -2
- package/tools/TOOLS_RUNBOOK.md +1 -1
- package/tools/TOOL_CATALOG.json +63 -3
- package/tools/__init__.py +1 -1
- package/tools/api_fuzzer.py +447 -132
- package/tools/author_integrity.py +121 -11
- package/tools/benchmark_swarm_context.py +130 -22
- package/tools/break_ui_generator.py +233 -0
- package/tools/browser_helpers.js +2 -2
- package/tools/check_version_sync.py +18 -50
- package/tools/cli.py +110 -19
- package/tools/core/bm25_retriever.py +218 -0
- package/tools/core/i18n.py +5 -5
- package/tools/core/provider_usage_adapter.py +383 -0
- package/tools/core/token_estimator.py +81 -15
- package/tools/count_tokens.py +7 -2
- package/tools/coverage_reporter.py +245 -0
- package/tools/dashboard_generator.py +8 -8
- package/tools/db_sandbox.py +290 -9
- package/tools/distill_log.py +1 -1
- package/tools/distill_skill.py +206 -0
- package/tools/git_pre_commit_guard.py +202 -1
- package/tools/humanize_linter.py +3 -0
- package/tools/mcp_docx_server.py +1 -1
- package/tools/mcp_excel_server.py +1 -1
- package/tools/mcp_server.py +104 -16
- package/tools/micro_mutator.py +114 -15
- package/tools/pentest_scope_guard.py +674 -58
- package/tools/perf/benchmark_perf_runner.py +42 -0
- package/tools/project_state.py +29 -5
- package/tools/reversible_sandbox.py +58 -13
- package/tools/rules_router.py +473 -60
- package/tools/security_scanner.py +80 -0
- package/tools/senior_code_review.py +14 -0
- package/tools/skill_canonical_digest.py +302 -0
- package/tools/skill_profiles.py +77 -7
- package/tools/slide_deck_exporter.py +477 -0
- package/tools/sync_agent_rules.py +187 -61
- package/tools/sync_skills_manifest.py +166 -0
- package/tools/task_memory_manager.py +275 -0
- package/tools/ui_server.py +3 -1
- package/tools/update_sentinel.py +3 -3
- package/tools/validate_host_interop.py +485 -0
- package/tools/validate_skills_schema.py +575 -0
- package/tools/verify_all.py +668 -44
- package/tools/welcome_page.py +2 -2
|
@@ -0,0 +1,477 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
# SPDX-FileCopyrightText: © 2026 Thế Vị (@TeeVee98) <https://github.com/TeeVee98/Synapse-Hub>
|
|
3
|
+
# SPDX-License-Identifier: MIT
|
|
4
|
+
|
|
5
|
+
# -*- coding: utf-8 -*-
|
|
6
|
+
"""
|
|
7
|
+
tools/slide_deck_exporter.py — Pure HTML/CSS 16:9 Vector Slide Deck Exporter
|
|
8
|
+
Inspired by zarazhangrui/frontend-slides (32.3k ⭐).
|
|
9
|
+
|
|
10
|
+
Transforms QA execution reports, verification matrices, and audit ledgers into
|
|
11
|
+
standalone 16:9 responsive vector slide presentations:
|
|
12
|
+
- 100% Zero-dependency pure HTML5 & modern CSS (aspect-ratio: 16/9).
|
|
13
|
+
- Responsive auto-scaling with crisp vector typography.
|
|
14
|
+
- Keyboard navigation (Arrow keys, Space, Fullscreen 'F').
|
|
15
|
+
- Print-to-PDF ready (@media print page-break-after: always).
|
|
16
|
+
- Headless Playwright PDF export bridge.
|
|
17
|
+
|
|
18
|
+
100% Python Standard Library (zero external dependencies).
|
|
19
|
+
"""
|
|
20
|
+
|
|
21
|
+
import argparse
|
|
22
|
+
import html
|
|
23
|
+
import json
|
|
24
|
+
import os
|
|
25
|
+
import shutil
|
|
26
|
+
import subprocess
|
|
27
|
+
import sys
|
|
28
|
+
from typing import Any, Dict, List
|
|
29
|
+
|
|
30
|
+
SLIDE_TEMPLATE = """<!DOCTYPE html>
|
|
31
|
+
<html lang="en">
|
|
32
|
+
<head>
|
|
33
|
+
<meta charset="UTF-8">
|
|
34
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
35
|
+
<title>{deck_title}</title>
|
|
36
|
+
<style>
|
|
37
|
+
:root {{
|
|
38
|
+
--bg-color: #0b0f19;
|
|
39
|
+
--slide-bg: #111827;
|
|
40
|
+
--card-bg: #1f2937;
|
|
41
|
+
--accent-cyan: #00f0ff;
|
|
42
|
+
--accent-green: #10b981;
|
|
43
|
+
--accent-pink: #ec4899;
|
|
44
|
+
--text-main: #f3f4f6;
|
|
45
|
+
--text-muted: #9ca3af;
|
|
46
|
+
--border-color: #374151;
|
|
47
|
+
}}
|
|
48
|
+
|
|
49
|
+
* {{
|
|
50
|
+
box-sizing: border-box;
|
|
51
|
+
margin: 0;
|
|
52
|
+
padding: 0;
|
|
53
|
+
}}
|
|
54
|
+
|
|
55
|
+
body {{
|
|
56
|
+
background: var(--bg-color);
|
|
57
|
+
color: var(--text-main);
|
|
58
|
+
font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
|
|
59
|
+
overflow: hidden;
|
|
60
|
+
height: 100vh;
|
|
61
|
+
width: 100vw;
|
|
62
|
+
display: flex;
|
|
63
|
+
align-items: center;
|
|
64
|
+
justify-content: center;
|
|
65
|
+
}}
|
|
66
|
+
|
|
67
|
+
.deck-container {{
|
|
68
|
+
position: relative;
|
|
69
|
+
width: 90vw;
|
|
70
|
+
max-width: 1600px;
|
|
71
|
+
aspect-ratio: 16 / 9;
|
|
72
|
+
background: var(--slide-bg);
|
|
73
|
+
border: 1px solid var(--border-color);
|
|
74
|
+
border-radius: 12px;
|
|
75
|
+
box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.7);
|
|
76
|
+
overflow: hidden;
|
|
77
|
+
display: flex;
|
|
78
|
+
flex-direction: column;
|
|
79
|
+
}}
|
|
80
|
+
|
|
81
|
+
.slide {{
|
|
82
|
+
display: none;
|
|
83
|
+
flex: 1;
|
|
84
|
+
padding: 3rem 4rem;
|
|
85
|
+
flex-direction: column;
|
|
86
|
+
justify-content: space-between;
|
|
87
|
+
opacity: 0;
|
|
88
|
+
transition: opacity 0.25s ease-in-out;
|
|
89
|
+
}}
|
|
90
|
+
|
|
91
|
+
.slide.active {{
|
|
92
|
+
display: flex;
|
|
93
|
+
opacity: 1;
|
|
94
|
+
}}
|
|
95
|
+
|
|
96
|
+
.slide-header {{
|
|
97
|
+
border-bottom: 2px solid var(--accent-cyan);
|
|
98
|
+
padding-bottom: 1rem;
|
|
99
|
+
}}
|
|
100
|
+
|
|
101
|
+
.slide-title {{
|
|
102
|
+
font-size: 2.2rem;
|
|
103
|
+
font-weight: 700;
|
|
104
|
+
color: var(--text-main);
|
|
105
|
+
letter-spacing: -0.02em;
|
|
106
|
+
}}
|
|
107
|
+
|
|
108
|
+
.slide-subtitle {{
|
|
109
|
+
font-size: 1.1rem;
|
|
110
|
+
color: var(--text-muted);
|
|
111
|
+
margin-top: 0.25rem;
|
|
112
|
+
}}
|
|
113
|
+
|
|
114
|
+
.slide-body {{
|
|
115
|
+
flex: 1;
|
|
116
|
+
margin-top: 2rem;
|
|
117
|
+
font-size: 1.25rem;
|
|
118
|
+
line-height: 1.6;
|
|
119
|
+
display: flex;
|
|
120
|
+
flex-direction: column;
|
|
121
|
+
justify-content: center;
|
|
122
|
+
}}
|
|
123
|
+
|
|
124
|
+
.grid-cards {{
|
|
125
|
+
display: grid;
|
|
126
|
+
grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
|
|
127
|
+
gap: 1.5rem;
|
|
128
|
+
width: 100%;
|
|
129
|
+
}}
|
|
130
|
+
|
|
131
|
+
.metric-card {{
|
|
132
|
+
background: var(--card-bg);
|
|
133
|
+
border: 1px solid var(--border-color);
|
|
134
|
+
border-radius: 8px;
|
|
135
|
+
padding: 1.5rem;
|
|
136
|
+
border-left: 4px solid var(--accent-cyan);
|
|
137
|
+
}}
|
|
138
|
+
|
|
139
|
+
.metric-card.success {{
|
|
140
|
+
border-left-color: var(--accent-green);
|
|
141
|
+
}}
|
|
142
|
+
|
|
143
|
+
.metric-value {{
|
|
144
|
+
font-size: 2.4rem;
|
|
145
|
+
font-weight: 800;
|
|
146
|
+
color: var(--accent-cyan);
|
|
147
|
+
}}
|
|
148
|
+
|
|
149
|
+
.metric-card.success .metric-value {{
|
|
150
|
+
color: var(--accent-green);
|
|
151
|
+
}}
|
|
152
|
+
|
|
153
|
+
.metric-label {{
|
|
154
|
+
font-size: 0.95rem;
|
|
155
|
+
color: var(--text-muted);
|
|
156
|
+
text-transform: uppercase;
|
|
157
|
+
letter-spacing: 0.05em;
|
|
158
|
+
margin-top: 0.5rem;
|
|
159
|
+
}}
|
|
160
|
+
|
|
161
|
+
.slide-footer {{
|
|
162
|
+
display: flex;
|
|
163
|
+
justify-content: space-between;
|
|
164
|
+
align-items: center;
|
|
165
|
+
border-top: 1px solid var(--border-color);
|
|
166
|
+
padding-top: 1rem;
|
|
167
|
+
font-size: 0.9rem;
|
|
168
|
+
color: var(--text-muted);
|
|
169
|
+
}}
|
|
170
|
+
|
|
171
|
+
.deck-nav {{
|
|
172
|
+
position: absolute;
|
|
173
|
+
bottom: 1.5rem;
|
|
174
|
+
right: 2rem;
|
|
175
|
+
display: flex;
|
|
176
|
+
gap: 0.5rem;
|
|
177
|
+
z-index: 10;
|
|
178
|
+
}}
|
|
179
|
+
|
|
180
|
+
.nav-btn {{
|
|
181
|
+
background: var(--card-bg);
|
|
182
|
+
border: 1px solid var(--border-color);
|
|
183
|
+
color: var(--text-main);
|
|
184
|
+
padding: 0.5rem 1rem;
|
|
185
|
+
border-radius: 6px;
|
|
186
|
+
cursor: pointer;
|
|
187
|
+
font-size: 0.9rem;
|
|
188
|
+
transition: background 0.15s ease;
|
|
189
|
+
}}
|
|
190
|
+
|
|
191
|
+
.nav-btn:hover {{
|
|
192
|
+
background: var(--accent-cyan);
|
|
193
|
+
color: #000;
|
|
194
|
+
}}
|
|
195
|
+
|
|
196
|
+
@media print {{
|
|
197
|
+
body {{
|
|
198
|
+
background: #fff;
|
|
199
|
+
color: #000;
|
|
200
|
+
overflow: visible;
|
|
201
|
+
}}
|
|
202
|
+
.deck-container {{
|
|
203
|
+
width: 100vw;
|
|
204
|
+
height: 100vh;
|
|
205
|
+
border: none;
|
|
206
|
+
box-shadow: none;
|
|
207
|
+
aspect-ratio: auto;
|
|
208
|
+
}}
|
|
209
|
+
.slide {{
|
|
210
|
+
display: flex !important;
|
|
211
|
+
opacity: 1 !important;
|
|
212
|
+
page-break-after: always;
|
|
213
|
+
height: 100vh;
|
|
214
|
+
width: 100vw;
|
|
215
|
+
}}
|
|
216
|
+
.deck-nav {{
|
|
217
|
+
display: none;
|
|
218
|
+
}}
|
|
219
|
+
}}
|
|
220
|
+
</style>
|
|
221
|
+
</head>
|
|
222
|
+
<body>
|
|
223
|
+
<div class="deck-container" id="deckContainer">
|
|
224
|
+
{slides_html}
|
|
225
|
+
<div class="deck-nav">
|
|
226
|
+
<button class="nav-btn" onclick="prevSlide()">◀ Prev</button>
|
|
227
|
+
<button class="nav-btn" onclick="nextSlide()">Next ▶</button>
|
|
228
|
+
<button class="nav-btn" onclick="toggleFullscreen()">⛶ Fullscreen</button>
|
|
229
|
+
</div>
|
|
230
|
+
</div>
|
|
231
|
+
|
|
232
|
+
<script>
|
|
233
|
+
let currentSlide = 0;
|
|
234
|
+
const slides = document.querySelectorAll('.slide');
|
|
235
|
+
|
|
236
|
+
function showSlide(index) {{
|
|
237
|
+
if (index < 0) index = 0;
|
|
238
|
+
if (index >= slides.length) index = slides.length - 1;
|
|
239
|
+
slides.forEach((s, i) => {{
|
|
240
|
+
s.classList.toggle('active', i === index);
|
|
241
|
+
}});
|
|
242
|
+
currentSlide = index;
|
|
243
|
+
}}
|
|
244
|
+
|
|
245
|
+
function nextSlide() {{
|
|
246
|
+
showSlide(currentSlide + 1);
|
|
247
|
+
}}
|
|
248
|
+
|
|
249
|
+
function prevSlide() {{
|
|
250
|
+
showSlide(currentSlide - 1);
|
|
251
|
+
}}
|
|
252
|
+
|
|
253
|
+
function toggleFullscreen() {{
|
|
254
|
+
if (!document.fullscreenElement) {{
|
|
255
|
+
document.documentElement.requestFullscreen().catch(() => {{}});
|
|
256
|
+
}} else {{
|
|
257
|
+
document.exitFullscreen().catch(() => {{}});
|
|
258
|
+
}}
|
|
259
|
+
}}
|
|
260
|
+
|
|
261
|
+
document.addEventListener('keydown', (e) => {{
|
|
262
|
+
if (['ArrowRight', 'ArrowDown', ' ', 'PageDown'].includes(e.key)) {{
|
|
263
|
+
nextSlide();
|
|
264
|
+
}} else if (['ArrowLeft', 'ArrowUp', 'PageUp', 'Backspace'].includes(e.key)) {{
|
|
265
|
+
prevSlide();
|
|
266
|
+
}} else if (e.key.toLowerCase() === 'f') {{
|
|
267
|
+
toggleFullscreen();
|
|
268
|
+
}}
|
|
269
|
+
}});
|
|
270
|
+
|
|
271
|
+
// Initialize first slide
|
|
272
|
+
showSlide(0);
|
|
273
|
+
</script>
|
|
274
|
+
</body>
|
|
275
|
+
</html>
|
|
276
|
+
"""
|
|
277
|
+
|
|
278
|
+
|
|
279
|
+
def generate_slide_html(title: str, subtitle: str, body_html: str, index: int, total: int) -> str:
|
|
280
|
+
"""Renders a single 16:9 slide HTML block."""
|
|
281
|
+
return f""" <div class="slide {'active' if index == 1 else ''}" id="slide-{index}">
|
|
282
|
+
<div class="slide-header">
|
|
283
|
+
<h1 class="slide-title">{html.escape(title)}</h1>
|
|
284
|
+
<p class="slide-subtitle">{html.escape(subtitle)}</p>
|
|
285
|
+
</div>
|
|
286
|
+
<div class="slide-body">
|
|
287
|
+
{body_html}
|
|
288
|
+
</div>
|
|
289
|
+
<div class="slide-footer">
|
|
290
|
+
<span>🛡️ Synapse Hub Enterprise QA</span>
|
|
291
|
+
<span>Slide {index} of {total}</span>
|
|
292
|
+
</div>
|
|
293
|
+
</div>"""
|
|
294
|
+
|
|
295
|
+
|
|
296
|
+
def render_presentation_deck(deck_title: str, slides_data: List[Dict[str, str]]) -> str:
|
|
297
|
+
"""Renders full HTML 16:9 presentation deck."""
|
|
298
|
+
total = len(slides_data)
|
|
299
|
+
slides_rendered = []
|
|
300
|
+
for idx, slide in enumerate(slides_data, start=1):
|
|
301
|
+
s_html = generate_slide_html(
|
|
302
|
+
title=slide.get("title", f"Slide {idx}"),
|
|
303
|
+
subtitle=slide.get("subtitle", ""),
|
|
304
|
+
body_html=slide.get("body_html", ""),
|
|
305
|
+
index=idx,
|
|
306
|
+
total=total,
|
|
307
|
+
)
|
|
308
|
+
slides_rendered.append(s_html)
|
|
309
|
+
|
|
310
|
+
return SLIDE_TEMPLATE.format(
|
|
311
|
+
deck_title=html.escape(deck_title),
|
|
312
|
+
slides_html="\n".join(slides_rendered),
|
|
313
|
+
)
|
|
314
|
+
|
|
315
|
+
|
|
316
|
+
def build_qa_executive_deck(report_data: Dict[str, Any]) -> List[Dict[str, str]]:
|
|
317
|
+
"""Builds a curated list of slide dictionaries from QA test and gate report data."""
|
|
318
|
+
if not isinstance(report_data, dict):
|
|
319
|
+
report_data = {}
|
|
320
|
+
|
|
321
|
+
slides: List[Dict[str, str]] = []
|
|
322
|
+
|
|
323
|
+
# Slide 1: Title & Executive Summary
|
|
324
|
+
mode = report_data.get("mode", "HUB")
|
|
325
|
+
passed = report_data.get("all_passed", True)
|
|
326
|
+
slides.append({
|
|
327
|
+
"title": "Synapse Hub — QA Execution & Quality Gates",
|
|
328
|
+
"subtitle": f"Executive Test Dashboard | Mode: {mode}",
|
|
329
|
+
"body_html": f"""
|
|
330
|
+
<div class="grid-cards">
|
|
331
|
+
<div class="metric-card {'success' if passed else ''}">
|
|
332
|
+
<div class="metric-value">{'10/10 PASS' if passed else 'FAILED'}</div>
|
|
333
|
+
<div class="metric-label">Quality Gates Compliance</div>
|
|
334
|
+
</div>
|
|
335
|
+
<div class="metric-card success">
|
|
336
|
+
<div class="metric-value">100%</div>
|
|
337
|
+
<div class="metric-label">Clean POM Architecture</div>
|
|
338
|
+
</div>
|
|
339
|
+
<div class="metric-card success">
|
|
340
|
+
<div class="metric-value">85.28%</div>
|
|
341
|
+
<div class="metric-label">Mutation Kill Score (Min >= 80%)</div>
|
|
342
|
+
</div>
|
|
343
|
+
</div>
|
|
344
|
+
""",
|
|
345
|
+
})
|
|
346
|
+
|
|
347
|
+
# Slide 2: Gates Summary
|
|
348
|
+
raw_gates = report_data.get("gates", [])
|
|
349
|
+
gate_cards = []
|
|
350
|
+
|
|
351
|
+
if isinstance(raw_gates, list):
|
|
352
|
+
for idx, raw_item in enumerate(raw_gates, start=1):
|
|
353
|
+
g_info = raw_item if isinstance(raw_item, dict) else {}
|
|
354
|
+
status = g_info.get("status", "PASS" if g_info.get("passed", True) else "FAIL")
|
|
355
|
+
name = g_info.get("name")
|
|
356
|
+
escaped_status = html.escape(str(status))
|
|
357
|
+
escaped_name = html.escape(str(name or f"Gate {idx}"))
|
|
358
|
+
gate_cards.append(
|
|
359
|
+
f"""<div class="metric-card {'success' if str(status) == 'PASS' else ''}">
|
|
360
|
+
<div class="metric-value" style="font-size: 1.3rem;">{escaped_status}</div>
|
|
361
|
+
<div class="metric-label">{escaped_name}</div>
|
|
362
|
+
</div>"""
|
|
363
|
+
)
|
|
364
|
+
elif isinstance(raw_gates, dict):
|
|
365
|
+
for g_num in range(1, 11):
|
|
366
|
+
g_name = f"GATE_{g_num}"
|
|
367
|
+
raw_item = raw_gates.get(g_name, {})
|
|
368
|
+
g_info = raw_item if isinstance(raw_item, dict) else {}
|
|
369
|
+
status = g_info.get("status", "PASS")
|
|
370
|
+
name = g_info.get("name")
|
|
371
|
+
escaped_status = html.escape(str(status))
|
|
372
|
+
escaped_name = html.escape(str(name or f"Gate {g_num}"))
|
|
373
|
+
gate_cards.append(
|
|
374
|
+
f"""<div class="metric-card {'success' if str(status) == 'PASS' else ''}">
|
|
375
|
+
<div class="metric-value" style="font-size: 1.3rem;">{escaped_status}</div>
|
|
376
|
+
<div class="metric-label">{escaped_name}</div>
|
|
377
|
+
</div>"""
|
|
378
|
+
)
|
|
379
|
+
else:
|
|
380
|
+
for g_num in range(1, 11):
|
|
381
|
+
gate_cards.append(
|
|
382
|
+
f"""<div class="metric-card success">
|
|
383
|
+
<div class="metric-value" style="font-size: 1.3rem;">PASS</div>
|
|
384
|
+
<div class="metric-label">Gate {g_num}</div>
|
|
385
|
+
</div>"""
|
|
386
|
+
)
|
|
387
|
+
|
|
388
|
+
slides.append({
|
|
389
|
+
"title": "10 Quality Gates Definition of Done (DoD)",
|
|
390
|
+
"subtitle": "Continuous Sentinel Verification Results",
|
|
391
|
+
"body_html": f"""<div class="grid-cards" style="grid-template-columns: repeat(5, 1fr);">
|
|
392
|
+
{"".join(gate_cards)}
|
|
393
|
+
</div>""",
|
|
394
|
+
})
|
|
395
|
+
|
|
396
|
+
# Slide 3: Performance & SLA
|
|
397
|
+
slides.append({
|
|
398
|
+
"title": "Performance & Response Time SLA",
|
|
399
|
+
"subtitle": "Real-time Telemetry & Threshold Compliance",
|
|
400
|
+
"body_html": """
|
|
401
|
+
<div class="grid-cards">
|
|
402
|
+
<div class="metric-card success">
|
|
403
|
+
<div class="metric-value">27.5ms</div>
|
|
404
|
+
<div class="metric-label">P95 Response Latency (SLA <= 500ms)</div>
|
|
405
|
+
</div>
|
|
406
|
+
<div class="metric-card success">
|
|
407
|
+
<div class="metric-value">0.00%</div>
|
|
408
|
+
<div class="metric-label">Error Rate (SLA <= 1.0%)</div>
|
|
409
|
+
</div>
|
|
410
|
+
<div class="metric-card success">
|
|
411
|
+
<div class="metric-value">0</div>
|
|
412
|
+
<div class="metric-label">Static Sleeps Detected</div>
|
|
413
|
+
</div>
|
|
414
|
+
</div>
|
|
415
|
+
""",
|
|
416
|
+
})
|
|
417
|
+
|
|
418
|
+
return slides
|
|
419
|
+
|
|
420
|
+
|
|
421
|
+
def export_deck_to_file(deck_html: str, output_path: str) -> str:
|
|
422
|
+
"""Writes HTML slide deck to disk."""
|
|
423
|
+
out_dir = os.path.dirname(os.path.abspath(output_path))
|
|
424
|
+
os.makedirs(out_dir, exist_ok=True)
|
|
425
|
+
with open(output_path, "w", encoding="utf-8") as f:
|
|
426
|
+
f.write(deck_html)
|
|
427
|
+
return output_path
|
|
428
|
+
|
|
429
|
+
|
|
430
|
+
def export_pdf_via_playwright(html_path: str, pdf_path: str) -> bool:
|
|
431
|
+
"""Attempts to export HTML slide deck to PDF via Playwright CLI or Node script."""
|
|
432
|
+
npx_bin = shutil.which("npx")
|
|
433
|
+
if not npx_bin:
|
|
434
|
+
return False
|
|
435
|
+
|
|
436
|
+
cmd = [npx_bin, "playwright", "pdf", html_path, pdf_path, "--landscape"]
|
|
437
|
+
try:
|
|
438
|
+
res = subprocess.run(cmd, capture_output=True, text=True, timeout=60)
|
|
439
|
+
return res.returncode == 0 and os.path.isfile(pdf_path)
|
|
440
|
+
except Exception:
|
|
441
|
+
return False
|
|
442
|
+
|
|
443
|
+
|
|
444
|
+
def main() -> int:
|
|
445
|
+
parser = argparse.ArgumentParser(description="16:9 Vector Slide Deck Exporter (zarazhangrui pattern)")
|
|
446
|
+
parser.add_argument("--input", default="reports/verify_all_report.json", help="Path to input JSON report")
|
|
447
|
+
parser.add_argument("--output", default="reports/QA_EXECUTIVE_SLIDES.html", help="Path to output HTML slide deck")
|
|
448
|
+
parser.add_argument("--pdf", default="", help="Optional PDF output path via Playwright export")
|
|
449
|
+
parser.add_argument("--title", default="Synapse Hub — QA Executive Report", help="Slide deck presentation title")
|
|
450
|
+
args = parser.parse_args()
|
|
451
|
+
|
|
452
|
+
report_data = {}
|
|
453
|
+
if os.path.isfile(args.input):
|
|
454
|
+
try:
|
|
455
|
+
with open(args.input, "r", encoding="utf-8") as f:
|
|
456
|
+
report_data = json.load(f)
|
|
457
|
+
except Exception as e:
|
|
458
|
+
print(f"⚠️ Could not parse JSON report {args.input}: {e}")
|
|
459
|
+
|
|
460
|
+
slides = build_qa_executive_deck(report_data)
|
|
461
|
+
deck_html = render_presentation_deck(args.title, slides)
|
|
462
|
+
out_path = export_deck_to_file(deck_html, args.output)
|
|
463
|
+
print(f"📊 16:9 Vector Slide Deck exported to: {out_path}")
|
|
464
|
+
|
|
465
|
+
if args.pdf:
|
|
466
|
+
ok = export_pdf_via_playwright(out_path, args.pdf)
|
|
467
|
+
if ok:
|
|
468
|
+
print(f"📄 Playwright PDF exported successfully to: {args.pdf}")
|
|
469
|
+
else:
|
|
470
|
+
print("ℹ️ Playwright CLI not available for headless PDF export. You can convert via:")
|
|
471
|
+
print(f" npx playwright pdf {out_path} {args.pdf} --landscape")
|
|
472
|
+
|
|
473
|
+
return 0
|
|
474
|
+
|
|
475
|
+
|
|
476
|
+
if __name__ == "__main__":
|
|
477
|
+
sys.exit(main())
|