@teevee98/synapse-hub 3.8.4 ā 3.9.0
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/author-integrity-guard.md +13 -10
- package/.agents/rules/skill-precedence.md +6 -4
- package/.agents/skills/agent-orchestration-multi-agent-optimize/SKILL.md +1 -1
- package/.agents/skills/agentless-qa-repair/SKILL.md +1 -1
- package/.agents/skills/auth-session-and-cookie-manager/SKILL.md +22 -2
- package/.agents/skills/qa-memory-os/SKILL.md +21 -4
- package/.agents/skills/security-dast-sentinel/SKILL.md +1 -1
- package/.agents/skills/token-and-context-optimizer/SKILL.md +1 -1
- package/.agents/skills/verification-before-completion/SKILL.md +1 -1
- package/AGENTS.md +3 -2
- package/CLAUDE.md +3 -3
- package/NOTICE +48 -0
- package/README.en.md +9 -9
- package/README.md +9 -9
- package/agentskills.json +1 -1
- package/bin/agent-qa.js +1 -1
- package/docs/ARCHITECTURE.en.md +7 -3
- package/docs/ARCHITECTURE.md +6 -2
- package/docs/CI_CD_INTEGRATION.en.md +6 -6
- package/docs/CI_CD_INTEGRATION.md +6 -6
- package/docs/CLI_REFERENCE.md +1 -1
- package/docs/PERFORMANCE_AUDIT_REPORT.md +1 -1
- package/docs/QUALITY_GATES.en.md +1 -1
- package/docs/QUALITY_GATES.md +1 -1
- package/docs/adopted-ecosystem-tools.md +37 -0
- package/docs/diagrams/clean_pom.svg +48 -0
- package/docs/diagrams/fsm_flow.svg +78 -0
- package/package.json +1 -1
- package/plugin.json +1 -1
- package/skills_manifest.json +103 -54
- package/synapse.config.json +1 -1
- package/templates/PROJECT_AI_GUIDE_TEMPLATE.md +3 -3
- package/templates/ai_bridges/CLAUDE.md +3 -3
- package/templates/ci/github-actions-synapse.yml +2 -2
- package/templates/ci/gitlab-ci-synapse.yml +1 -1
- package/templates/ui/index.html +2 -2
- package/templates/welcome.html.tmpl +26 -26
- package/tools/TOOLS_RUNBOOK.md +8 -8
- package/tools/__init__.py +1 -1
- package/tools/analyze_project.py +2 -2
- package/tools/browser_helpers.js +2 -2
- package/tools/build_consolidated_report.py +1640 -0
- package/tools/bump_version.py +5 -15
- package/tools/cli.py +3 -3
- package/tools/count_tokens.py +29 -5
- package/tools/dashboard_generator.py +10 -10
- package/tools/diagram_architect.py +220 -0
- package/tools/distill_log.py +33 -8
- package/tools/git_worktree_manager.py +185 -0
- package/tools/hub_publisher.py +38 -0
- package/tools/humanize_linter.py +4 -0
- package/tools/interview_story.py +25 -2
- package/tools/mcp_docx_server.py +1 -1
- package/tools/mcp_excel_server.py +1 -1
- package/tools/mcp_server.py +1 -1
- package/tools/mechanical_ui_gate.py +242 -0
- package/tools/pairwise_generator.py +175 -0
- package/tools/repo_map.py +308 -106
- package/tools/runaway_stopper.py +178 -0
- package/tools/setup_project.py +3 -3
- package/tools/sync_agent_rules.py +3 -3
- package/tools/ui_server.py +1 -1
- package/tools/update_sentinel.py +6 -6
- package/tools/verify_all.py +15 -0
- package/tools/welcome_page.py +2 -2
package/tools/bump_version.py
CHANGED
|
@@ -194,23 +194,13 @@ def update_file(rel_path: str, pattern: str, replacement: str, dry_run: bool = F
|
|
|
194
194
|
return True
|
|
195
195
|
|
|
196
196
|
def run_tests() -> bool:
|
|
197
|
-
"""Executes the
|
|
197
|
+
"""Executes the 10 DoD Quality Gates before and after release.
|
|
198
198
|
|
|
199
|
-
|
|
200
|
-
|
|
199
|
+
Note: verify_all.py already executes the full regression test suite
|
|
200
|
+
under Gate 7 (with multi-worker parallel xdist), so calling standalone
|
|
201
|
+
pytest here is redundant.
|
|
201
202
|
"""
|
|
202
|
-
print("\nš Running verification
|
|
203
|
-
cmd = [sys.executable, "-m", "pytest", "tests", "-q"]
|
|
204
|
-
try:
|
|
205
|
-
res = subprocess.run(cmd, cwd=REPO_ROOT, timeout=240.0)
|
|
206
|
-
if res.returncode != 0:
|
|
207
|
-
print("ā Unit tests failed! Aborting release.")
|
|
208
|
-
return False
|
|
209
|
-
print("ā
All unit tests PASSED.")
|
|
210
|
-
except subprocess.TimeoutExpired:
|
|
211
|
-
print("ā Unit tests timed out after 240s! Aborting release.")
|
|
212
|
-
return False
|
|
213
|
-
|
|
203
|
+
print("\nš Running 10 DoD Quality Gates verification...")
|
|
214
204
|
verify_script = os.path.join(REPO_ROOT, "tools", "verify_all.py")
|
|
215
205
|
try:
|
|
216
206
|
res_verify = subprocess.run([sys.executable, verify_script], cwd=REPO_ROOT, timeout=240.0)
|
package/tools/cli.py
CHANGED
|
@@ -99,7 +99,7 @@ def cmd_set_lang(args):
|
|
|
99
99
|
def cmd_version(args):
|
|
100
100
|
"""Displays the current hub version, skill catalog count, and license information."""
|
|
101
101
|
manifest_path = os.path.join(REPO_ROOT, "skills_manifest.json")
|
|
102
|
-
version = "3.
|
|
102
|
+
version = "3.9.0"
|
|
103
103
|
if os.path.exists(manifest_path):
|
|
104
104
|
try:
|
|
105
105
|
import json
|
|
@@ -680,14 +680,14 @@ def cmd_trend(args):
|
|
|
680
680
|
|
|
681
681
|
def _hub_version():
|
|
682
682
|
manifest_path = os.path.join(REPO_ROOT, "skills_manifest.json")
|
|
683
|
-
version = "3.
|
|
683
|
+
version = "3.9.0"
|
|
684
684
|
if os.path.exists(manifest_path):
|
|
685
685
|
try:
|
|
686
686
|
import json
|
|
687
687
|
with open(manifest_path, "r", encoding="utf-8") as f:
|
|
688
688
|
version = json.load(f).get("version", version)
|
|
689
689
|
except (OSError, json.JSONDecodeError):
|
|
690
|
-
version = "3.
|
|
690
|
+
version = "3.9.0"
|
|
691
691
|
return version
|
|
692
692
|
|
|
693
693
|
|
package/tools/count_tokens.py
CHANGED
|
@@ -720,7 +720,7 @@ def calculate_cost(input_tokens: int, cache_tokens: int, output_tokens: int, mod
|
|
|
720
720
|
}
|
|
721
721
|
|
|
722
722
|
|
|
723
|
-
def calculate_hub_savings(input_tokens: int, cache_tokens: int, output_tokens: int, model_key: str = DEFAULT_MODEL) -> Dict[str, Any]:
|
|
723
|
+
def calculate_hub_savings(input_tokens: int, cache_tokens: int, output_tokens: int, model_key: str = DEFAULT_MODEL, turns_count: Optional[int] = None) -> Dict[str, Any]:
|
|
724
724
|
"""
|
|
725
725
|
Empirical Hub Savings Model:
|
|
726
726
|
Compares actual Synapse-Hub execution against vanilla/non-Hub agent execution:
|
|
@@ -728,12 +728,23 @@ def calculate_hub_savings(input_tokens: int, cache_tokens: int, output_tokens: i
|
|
|
728
728
|
2. Sparse Retrieval (Repo Map): 500-token AST map vs reading full 4,000-line classes.
|
|
729
729
|
3. Compact AOM: <500-token interactive tree vs 15,000-token raw HTML DOM.
|
|
730
730
|
4. KV-Cache Alignment: 95%+ Cache Hit vs <15% without prefix stability.
|
|
731
|
+
5. Lean Telemetry Badge: ~180 tokens/turn saved by omitting verbose footer.
|
|
731
732
|
"""
|
|
732
733
|
pricing = PRICING_TABLE.get(model_key, PRICING_TABLE[DEFAULT_MODEL])
|
|
733
734
|
|
|
734
735
|
estimated_non_hub_input = int(input_tokens * 3.5 + cache_tokens * 0.82)
|
|
735
736
|
estimated_non_hub_cache = int(cache_tokens * 0.18)
|
|
736
|
-
|
|
737
|
+
|
|
738
|
+
# Output savings from Lean Telemetry Badge (~180 tokens/turn saved vs verbose markdown table)
|
|
739
|
+
if turns_count is not None and turns_count > 0:
|
|
740
|
+
estimated_saved_output = turns_count * 180
|
|
741
|
+
elif output_tokens > 0:
|
|
742
|
+
estimated_turns = max(1, output_tokens // 400)
|
|
743
|
+
estimated_saved_output = estimated_turns * 180
|
|
744
|
+
else:
|
|
745
|
+
estimated_saved_output = 0
|
|
746
|
+
|
|
747
|
+
estimated_non_hub_output = output_tokens + estimated_saved_output
|
|
737
748
|
|
|
738
749
|
estimated_non_hub_total = estimated_non_hub_input + estimated_non_hub_cache + estimated_non_hub_output
|
|
739
750
|
actual_hub_total = input_tokens + cache_tokens + output_tokens
|
|
@@ -786,7 +797,8 @@ def get_preflight_block_lines(platform: str = "antigravity", model_key: str = DE
|
|
|
786
797
|
parsed_cur = adapter.parse_transcript(convs[0]["transcript_file"])
|
|
787
798
|
if model_key == DEFAULT_MODEL and parsed_cur.get("detected_model"):
|
|
788
799
|
model_key = parsed_cur["detected_model"]
|
|
789
|
-
|
|
800
|
+
turns_len = len(parsed_cur.get("turns", [])) if parsed_cur.get("turns") else None
|
|
801
|
+
savings = calculate_hub_savings(w5["input_tokens"], w5["cache_read_tokens"], w5["output_tokens"], model_key, turns_count=turns_len)
|
|
790
802
|
if parsed_cur.get("turns"):
|
|
791
803
|
turns = parsed_cur["turns"]
|
|
792
804
|
target_t = turns[-1]
|
|
@@ -1148,7 +1160,13 @@ def main():
|
|
|
1148
1160
|
|
|
1149
1161
|
if args.json:
|
|
1150
1162
|
parsed["costs"] = calculate_cost(parsed["input_tokens"], parsed["cache_read_tokens"], parsed["output_tokens"], active_pricing)
|
|
1151
|
-
parsed["savings"] = calculate_hub_savings(
|
|
1163
|
+
parsed["savings"] = calculate_hub_savings(
|
|
1164
|
+
parsed["input_tokens"],
|
|
1165
|
+
parsed["cache_read_tokens"],
|
|
1166
|
+
parsed["output_tokens"],
|
|
1167
|
+
active_pricing,
|
|
1168
|
+
turns_count=len(parsed.get("turns", []))
|
|
1169
|
+
)
|
|
1152
1170
|
print(json.dumps(parsed, indent=2, ensure_ascii=False))
|
|
1153
1171
|
else:
|
|
1154
1172
|
format_table(parsed, f"File: {args.file}", active_pricing, args.turns, args.last_task)
|
|
@@ -1251,7 +1269,13 @@ def main():
|
|
|
1251
1269
|
parsed["session_id"] = target_conv["id"]
|
|
1252
1270
|
parsed["title"] = target_conv["title"]
|
|
1253
1271
|
parsed["costs"] = calculate_cost(parsed["input_tokens"], parsed["cache_read_tokens"], parsed["output_tokens"], active_pricing)
|
|
1254
|
-
parsed["savings"] = calculate_hub_savings(
|
|
1272
|
+
parsed["savings"] = calculate_hub_savings(
|
|
1273
|
+
parsed["input_tokens"],
|
|
1274
|
+
parsed["cache_read_tokens"],
|
|
1275
|
+
parsed["output_tokens"],
|
|
1276
|
+
active_pricing,
|
|
1277
|
+
turns_count=len(parsed.get("turns", []))
|
|
1278
|
+
)
|
|
1255
1279
|
print(json.dumps(parsed, indent=2, ensure_ascii=False))
|
|
1256
1280
|
else:
|
|
1257
1281
|
format_table(
|
|
@@ -1218,8 +1218,8 @@ def _build_target_tables(assets: Dict[str, Any], stack_info: Dict[str, str], def
|
|
|
1218
1218
|
</tr>
|
|
1219
1219
|
""")
|
|
1220
1220
|
else:
|
|
1221
|
-
empty_pom_vi = "ā¹ļø Chʰa có Page Class nĆ o Äược lįŗp chį» mỄc. Chįŗ”y <code>npx synapse-hub analyze</code> trong dį»± Ć”n Äį» tįŗ”o bįŗ£n Äį» AST repo."
|
|
1222
|
-
empty_pom_en = "ā¹ļø No Page Classes indexed yet. Run <code>npx synapse-hub analyze</code> inside project to generate AST repo map."
|
|
1221
|
+
empty_pom_vi = "ā¹ļø Chʰa có Page Class nĆ o Äược lįŗp chį» mỄc. Chįŗ”y <code>npx @teevee98/synapse-hub analyze</code> trong dį»± Ć”n Äį» tįŗ”o bįŗ£n Äį» AST repo."
|
|
1222
|
+
empty_pom_en = "ā¹ļø No Page Classes indexed yet. Run <code>npx @teevee98/synapse-hub analyze</code> inside project to generate AST repo map."
|
|
1223
1223
|
classes_rows_html.append(f"""
|
|
1224
1224
|
<tr>
|
|
1225
1225
|
<td colspan="5" style="text-align:center; padding: 24px; color: var(--text-muted);" data-i18n="empty_pom_table">
|
|
@@ -1324,7 +1324,7 @@ def _build_target_translations(
|
|
|
1324
1324
|
"th_pom_extends": "Kế Thừa",
|
|
1325
1325
|
"th_pom_methods": "PhưƔng Thức",
|
|
1326
1326
|
"th_pom_api": "Tóm TįŗÆt Chữ Ký API & HĆ nh Äį»ng",
|
|
1327
|
-
"empty_pom_table": "ā¹ļø Chʰa có Page Class nĆ o Äược lįŗp chį» mỄc. Chįŗ”y <code>npx synapse-hub analyze</code> trong dį»± Ć”n Äį» tįŗ”o bįŗ£n Äį» AST repo.",
|
|
1327
|
+
"empty_pom_table": "ā¹ļø Chʰa có Page Class nĆ o Äược lįŗp chį» mỄc. Chįŗ”y <code>npx @teevee98/synapse-hub analyze</code> trong dį»± Ć”n Äį» tįŗ”o bįŗ£n Äį» AST repo.",
|
|
1328
1328
|
|
|
1329
1329
|
"sec_tests_title": f"š§Ŗ Danh MỄc Kį»ch Bįŗ£n Kiį»m Thį» Tį»± Äį»ng ({assets['test_count']} Test Cases)",
|
|
1330
1330
|
"sec_tests_badge": "100% Nghiį»p VỄ",
|
|
@@ -1348,7 +1348,7 @@ def _build_target_translations(
|
|
|
1348
1348
|
"th_step_status": "TrẔng ThÔi",
|
|
1349
1349
|
"th_step_details": "Chi Tiįŗæt Kỹ Thuįŗt (OTel & AST)",
|
|
1350
1350
|
|
|
1351
|
-
"footer_text": "BĆ”o cĆ”o Äược khį»i tįŗ”o tį»± Äį»ng bį»i Synapse-Hub v3.
|
|
1351
|
+
"footer_text": "BĆ”o cĆ”o Äược khį»i tįŗ”o tį»± Äį»ng bį»i Synapse-Hub v3.9.0 • Bįŗ£n quyį»n © Thįŗæ Vį» (@TeeVee98) • Chuįŗ©n Clean POM & Kiį»m Thį» Tį»± Chį»§",
|
|
1352
1352
|
}
|
|
1353
1353
|
|
|
1354
1354
|
translations_en = {
|
|
@@ -1402,7 +1402,7 @@ def _build_target_translations(
|
|
|
1402
1402
|
"th_pom_extends": "Extends",
|
|
1403
1403
|
"th_pom_methods": "Methods",
|
|
1404
1404
|
"th_pom_api": "Action Summary & Signatures",
|
|
1405
|
-
"empty_pom_table": "ā¹ļø No Page Classes indexed yet. Run <code>npx synapse-hub analyze</code> inside project to generate AST repo map.",
|
|
1405
|
+
"empty_pom_table": "ā¹ļø No Page Classes indexed yet. Run <code>npx @teevee98/synapse-hub analyze</code> inside project to generate AST repo map.",
|
|
1406
1406
|
|
|
1407
1407
|
"sec_tests_title": f"š§Ŗ Automated Test Scripts ({assets['test_count']} Test Cases)",
|
|
1408
1408
|
"sec_tests_badge": "100% Business Logic",
|
|
@@ -1426,7 +1426,7 @@ def _build_target_translations(
|
|
|
1426
1426
|
"th_step_status": "Status",
|
|
1427
1427
|
"th_step_details": "Technical Details (OTel & AST)",
|
|
1428
1428
|
|
|
1429
|
-
"footer_text": "Generated automatically by Synapse-Hub v3.
|
|
1429
|
+
"footer_text": "Generated automatically by Synapse-Hub v3.9.0 • Copyright © Thįŗæ Vį» (@TeeVee98) • Clean POM & Autonomous Testing",
|
|
1430
1430
|
}
|
|
1431
1431
|
|
|
1432
1432
|
_inject_gate_translations(translations_vi, translations_en, gates)
|
|
@@ -1915,7 +1915,7 @@ def _build_hub_translations(
|
|
|
1915
1915
|
"""Builds bilingual dictionaries for Hub Dashboard."""
|
|
1916
1916
|
translations_vi = {
|
|
1917
1917
|
"header_title": "Bįŗ£ng Äiį»u HĆ nh Chįŗ„t Lượng Doanh Nghiį»p",
|
|
1918
|
-
"header_subtitle": "Synapse-Hub v3.
|
|
1918
|
+
"header_subtitle": "Synapse-Hub v3.9.0 • Hį» Sinh ThĆ”i Kiį»m Thį» AI Agent Tį»± Chį»§",
|
|
1919
1919
|
"nav_welcome": "Giį»i Thiį»u",
|
|
1920
1920
|
"meta_mode": "š·ļø Chįŗæ Äį»: <strong>Hį» SINH THĆI QA HUB</strong>",
|
|
1921
1921
|
"meta_gen": f"š Khį»i tįŗ”o: <strong>{now_str}</strong>",
|
|
@@ -1985,12 +1985,12 @@ def _build_hub_translations(
|
|
|
1985
1985
|
"th_sk_ver": "PhiĆŖn Bįŗ£n",
|
|
1986
1986
|
"th_sk_cap": "Khįŗ£ NÄng Nghiį»p VỄ Cį»t LƵi",
|
|
1987
1987
|
|
|
1988
|
-
"footer_text": "Bįŗ£ng Äiį»u HĆ nh Chįŗ„t Lượng Doanh Nghiį»p • Synapse-Hub v3.
|
|
1988
|
+
"footer_text": "Bįŗ£ng Äiį»u HĆ nh Chįŗ„t Lượng Doanh Nghiį»p • Synapse-Hub v3.9.0 • Bįŗ£n quyį»n © Thįŗæ Vį» (@TeeVee98) • Hį» Thį»ng Kiį»m Thį» AI Agent Tį»± Chį»§",
|
|
1989
1989
|
}
|
|
1990
1990
|
|
|
1991
1991
|
translations_en = {
|
|
1992
1992
|
"header_title": "Enterprise QA Executive Dashboard",
|
|
1993
|
-
"header_subtitle": "Synapse-Hub v3.
|
|
1993
|
+
"header_subtitle": "Synapse-Hub v3.9.0 • Autonomous AI Agent Testing Ecosystem",
|
|
1994
1994
|
"nav_welcome": "Welcome",
|
|
1995
1995
|
"meta_mode": "š·ļø Mode: <strong>QA HUB ECOSYSTEM</strong>",
|
|
1996
1996
|
"meta_gen": f"š Generated: <strong>{now_str}</strong>",
|
|
@@ -2060,7 +2060,7 @@ def _build_hub_translations(
|
|
|
2060
2060
|
"th_sk_ver": "Version",
|
|
2061
2061
|
"th_sk_cap": "Core Capabilities",
|
|
2062
2062
|
|
|
2063
|
-
"footer_text": "Enterprise QA Executive Dashboard • Synapse-Hub v3.
|
|
2063
|
+
"footer_text": "Enterprise QA Executive Dashboard • Synapse-Hub v3.9.0 • Copyright © Thįŗæ Vį» (@TeeVee98) • Autonomous AI Agent Testing Ecosystem",
|
|
2064
2064
|
}
|
|
2065
2065
|
|
|
2066
2066
|
_inject_gate_translations(translations_vi, translations_en, gates)
|
|
@@ -0,0 +1,220 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
# -*- coding: utf-8 -*-
|
|
3
|
+
"""
|
|
4
|
+
tools/diagram_architect.py ā Standalone Self-Contained SVG & HTML Diagram Builder
|
|
5
|
+
Inspired by Cathryn Lavery's diagram-design standard.
|
|
6
|
+
Generates fully self-contained SVG and HTML architectural diagrams
|
|
7
|
+
with zero Mermaid dependencies, guaranteed text contrast, and mathematical containment.
|
|
8
|
+
100% UTF-8 No BOM.
|
|
9
|
+
"""
|
|
10
|
+
|
|
11
|
+
import sys
|
|
12
|
+
import os
|
|
13
|
+
import argparse
|
|
14
|
+
from typing import Dict, Any
|
|
15
|
+
|
|
16
|
+
# Enforce UTF-8 stdout encoding
|
|
17
|
+
if hasattr(sys.stdout, "reconfigure"):
|
|
18
|
+
try:
|
|
19
|
+
sys.stdout.reconfigure(encoding="utf-8")
|
|
20
|
+
sys.stderr.reconfigure(encoding="utf-8")
|
|
21
|
+
except Exception:
|
|
22
|
+
pass
|
|
23
|
+
|
|
24
|
+
def generate_fsm_diagram() -> str:
|
|
25
|
+
"""Generates the 5-Stage FSM flow diagram of Synapse Hub."""
|
|
26
|
+
svg = """<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1000 240" width="100%" height="240" style="background:#0f172a; border-radius:12px; font-family:-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;">
|
|
27
|
+
<defs>
|
|
28
|
+
<linearGradient id="cyan-grad" x1="0%" y1="0%" x2="100%" y2="100%">
|
|
29
|
+
<stop offset="0%" stop-color="#06b6d4"/>
|
|
30
|
+
<stop offset="100%" stop-color="#3b82f6"/>
|
|
31
|
+
</linearGradient>
|
|
32
|
+
<linearGradient id="purple-grad" x1="0%" y1="0%" x2="100%" y2="100%">
|
|
33
|
+
<stop offset="0%" stop-color="#8b5cf6"/>
|
|
34
|
+
<stop offset="100%" stop-color="#ec4899"/>
|
|
35
|
+
</linearGradient>
|
|
36
|
+
<linearGradient id="emerald-grad" x1="0%" y1="0%" x2="100%" y2="100%">
|
|
37
|
+
<stop offset="0%" stop-color="#10b981"/>
|
|
38
|
+
<stop offset="100%" stop-color="#059669"/>
|
|
39
|
+
</linearGradient>
|
|
40
|
+
<marker id="arrow" viewBox="0 0 10 10" refX="6" refY="5" markerWidth="6" markerHeight="6" orient="auto-start-reverse">
|
|
41
|
+
<path d="M 0 1 L 8 5 L 0 9 z" fill="#64748b"/>
|
|
42
|
+
</marker>
|
|
43
|
+
</defs>
|
|
44
|
+
|
|
45
|
+
<!-- Connectors -->
|
|
46
|
+
<line x1="180" y1="120" x2="225" y2="120" stroke="#475569" stroke-width="2" marker-end="url(#arrow)"/>
|
|
47
|
+
<line x1="380" y1="120" x2="425" y2="120" stroke="#475569" stroke-width="2" marker-end="url(#arrow)"/>
|
|
48
|
+
<line x1="580" y1="120" x2="625" y2="120" stroke="#475569" stroke-width="2" marker-end="url(#arrow)"/>
|
|
49
|
+
<line x1="780" y1="120" x2="825" y2="120" stroke="#475569" stroke-width="2" marker-end="url(#arrow)"/>
|
|
50
|
+
|
|
51
|
+
<!-- Stage 1 -->
|
|
52
|
+
<g transform="translate(30, 60)">
|
|
53
|
+
<rect width="150" height="120" rx="10" fill="#1e293b" stroke="#06b6d4" stroke-width="2"/>
|
|
54
|
+
<rect width="150" height="28" rx="10" fill="#06b6d4"/>
|
|
55
|
+
<text x="75" y="19" text-anchor="middle" fill="#0f172a" font-size="12" font-weight="bold">STAGE 1: DISCOVERY</text>
|
|
56
|
+
<text x="75" y="60" text-anchor="middle" fill="#f8fafc" font-size="13" font-weight="600">test-designer</text>
|
|
57
|
+
<text x="75" y="80" text-anchor="middle" fill="#94a3b8" font-size="11">RBT Risk Matrices</text>
|
|
58
|
+
<text x="75" y="98" text-anchor="middle" fill="#38bdf8" font-size="11">Spec SDD / Gherkin</text>
|
|
59
|
+
</g>
|
|
60
|
+
|
|
61
|
+
<!-- Stage 2 -->
|
|
62
|
+
<g transform="translate(230, 60)">
|
|
63
|
+
<rect width="150" height="120" rx="10" fill="#1e293b" stroke="#3b82f6" stroke-width="2"/>
|
|
64
|
+
<rect width="150" height="28" rx="10" fill="#3b82f6"/>
|
|
65
|
+
<text x="75" y="19" text-anchor="middle" fill="#ffffff" font-size="12" font-weight="bold">STAGE 2: SYNTHESIS</text>
|
|
66
|
+
<text x="75" y="60" text-anchor="middle" fill="#f8fafc" font-size="13" font-weight="600">pom-crafter</text>
|
|
67
|
+
<text x="75" y="80" text-anchor="middle" fill="#94a3b8" font-size="11">Clean POM Classes</text>
|
|
68
|
+
<text x="75" y="98" text-anchor="middle" fill="#60a5fa" font-size="11">Zero Script Locators</text>
|
|
69
|
+
</g>
|
|
70
|
+
|
|
71
|
+
<!-- Stage 3 -->
|
|
72
|
+
<g transform="translate(430, 60)">
|
|
73
|
+
<rect width="150" height="120" rx="10" fill="#1e293b" stroke="#8b5cf6" stroke-width="2"/>
|
|
74
|
+
<rect width="150" height="28" rx="10" fill="#8b5cf6"/>
|
|
75
|
+
<text x="75" y="19" text-anchor="middle" fill="#ffffff" font-size="12" font-weight="bold">STAGE 3: EXECUTION</text>
|
|
76
|
+
<text x="75" y="60" text-anchor="middle" fill="#f8fafc" font-size="13" font-weight="600">test-runner</text>
|
|
77
|
+
<text x="75" y="80" text-anchor="middle" fill="#94a3b8" font-size="11">100% Pure Headless</text>
|
|
78
|
+
<text x="75" y="98" text-anchor="middle" fill="#c084fc" font-size="11">Parallel Worktrees</text>
|
|
79
|
+
</g>
|
|
80
|
+
|
|
81
|
+
<!-- Stage 4 -->
|
|
82
|
+
<g transform="translate(630, 60)">
|
|
83
|
+
<rect width="150" height="120" rx="10" fill="#1e293b" stroke="#f59e0b" stroke-width="2"/>
|
|
84
|
+
<rect width="150" height="28" rx="10" fill="#f59e0b"/>
|
|
85
|
+
<text x="75" y="19" text-anchor="middle" fill="#0f172a" font-size="12" font-weight="bold">STAGE 4: HEALING</text>
|
|
86
|
+
<text x="75" y="60" text-anchor="middle" fill="#f8fafc" font-size="13" font-weight="600">failure-analyst</text>
|
|
87
|
+
<text x="75" y="80" text-anchor="middle" fill="#94a3b8" font-size="11">AOM Diff Healing</text>
|
|
88
|
+
<text x="75" y="98" text-anchor="middle" fill="#fbbf24" font-size="11">Pinpoint RCA</text>
|
|
89
|
+
</g>
|
|
90
|
+
|
|
91
|
+
<!-- Stage 5 -->
|
|
92
|
+
<g transform="translate(830, 60)">
|
|
93
|
+
<rect width="150" height="120" rx="10" fill="#1e293b" stroke="#10b981" stroke-width="2"/>
|
|
94
|
+
<rect width="150" height="28" rx="10" fill="#10b981"/>
|
|
95
|
+
<text x="75" y="19" text-anchor="middle" fill="#0f172a" font-size="12" font-weight="bold">STAGE 5: DoD ACCEPT</text>
|
|
96
|
+
<text x="75" y="60" text-anchor="middle" fill="#f8fafc" font-size="13" font-weight="600">quality-gatekeeper</text>
|
|
97
|
+
<text x="75" y="80" text-anchor="middle" fill="#94a3b8" font-size="11">10 Quality Gates</text>
|
|
98
|
+
<text x="75" y="98" text-anchor="middle" fill="#34d399" font-size="11">Mutation >= 80%</text>
|
|
99
|
+
</g>
|
|
100
|
+
|
|
101
|
+
<!-- Title bar -->
|
|
102
|
+
<text x="500" y="32" text-anchor="middle" fill="#e2e8f0" font-size="15" font-weight="700" letter-spacing="1">SYNAPSE HUB ā 5-STAGE AUTONOMOUS FSM ENGINE</text>
|
|
103
|
+
</svg>"""
|
|
104
|
+
return svg
|
|
105
|
+
|
|
106
|
+
def generate_clean_pom_diagram() -> str:
|
|
107
|
+
"""Generates the Clean POM Flat Architecture diagram."""
|
|
108
|
+
svg = """<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 900 280" width="100%" height="280" style="background:#0b0f19; border-radius:12px; font-family:-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;">
|
|
109
|
+
<defs>
|
|
110
|
+
<marker id="pom-arrow" viewBox="0 0 10 10" refX="6" refY="5" markerWidth="6" markerHeight="6" orient="auto-start-reverse">
|
|
111
|
+
<path d="M 0 1 L 8 5 L 0 9 z" fill="#06b6d4"/>
|
|
112
|
+
</marker>
|
|
113
|
+
</defs>
|
|
114
|
+
|
|
115
|
+
<text x="450" y="35" text-anchor="middle" fill="#ffffff" font-size="16" font-weight="bold">CLEAN POM / FLAT ARCHITECTURE INVARIANT</text>
|
|
116
|
+
|
|
117
|
+
<!-- Box 1: Test Scripts -->
|
|
118
|
+
<g transform="translate(40, 70)">
|
|
119
|
+
<rect width="240" height="160" rx="8" fill="#131b2e" stroke="#ef4444" stroke-width="2"/>
|
|
120
|
+
<text x="120" y="35" text-anchor="middle" fill="#f87171" font-size="14" font-weight="bold">Test Scripts (tests/)</text>
|
|
121
|
+
<line x1="20" y1="50" x2="220" y2="50" stroke="#334155"/>
|
|
122
|
+
<text x="25" y="75" fill="#f8fafc" font-size="12">ā
Business actions only</text>
|
|
123
|
+
<text x="25" y="100" fill="#f8fafc" font-size="12">ā
loginPage.login(u, p)</text>
|
|
124
|
+
<text x="25" y="125" fill="#ef4444" font-size="12">ā ZERO Raw XPaths / CSS</text>
|
|
125
|
+
<text x="25" y="145" fill="#ef4444" font-size="12">ā ZERO findTestObject</text>
|
|
126
|
+
</g>
|
|
127
|
+
|
|
128
|
+
<!-- Arrow 1 -> 2 -->
|
|
129
|
+
<line x1="280" y1="150" x2="335" y2="150" stroke="#06b6d4" stroke-width="2" marker-end="url(#pom-arrow)"/>
|
|
130
|
+
|
|
131
|
+
<!-- Box 2: Page Classes -->
|
|
132
|
+
<g transform="translate(340, 70)">
|
|
133
|
+
<rect width="240" height="160" rx="8" fill="#131b2e" stroke="#06b6d4" stroke-width="2"/>
|
|
134
|
+
<text x="120" y="35" text-anchor="middle" fill="#22d3ee" font-size="14" font-weight="bold">Page Classes (pages/)</text>
|
|
135
|
+
<line x1="20" y1="50" x2="220" y2="50" stroke="#334155"/>
|
|
136
|
+
<text x="25" y="75" fill="#f8fafc" font-size="12">ā
Encapsulated Locators</text>
|
|
137
|
+
<text x="25" y="100" fill="#f8fafc" font-size="12">ā
extends BasePage</text>
|
|
138
|
+
<text x="25" y="125" fill="#f8fafc" font-size="12">ā
Semantic action methods</text>
|
|
139
|
+
<text x="25" y="145" fill="#f8fafc" font-size="12">ā
Smart Wait integration</text>
|
|
140
|
+
</g>
|
|
141
|
+
|
|
142
|
+
<!-- Arrow 2 -> 3 -->
|
|
143
|
+
<line x1="580" y1="150" x2="635" y2="150" stroke="#06b6d4" stroke-width="2" marker-end="url(#pom-arrow)"/>
|
|
144
|
+
|
|
145
|
+
<!-- Box 3: BasePage / Framework -->
|
|
146
|
+
<g transform="translate(640, 70)">
|
|
147
|
+
<rect width="220" height="160" rx="8" fill="#131b2e" stroke="#10b981" stroke-width="2"/>
|
|
148
|
+
<text x="110" y="35" text-anchor="middle" fill="#34d399" font-size="14" font-weight="bold">BasePage & Helpers</text>
|
|
149
|
+
<line x1="20" y1="50" x2="200" y2="50" stroke="#334155"/>
|
|
150
|
+
<text x="25" y="75" fill="#f8fafc" font-size="12">ā
uniqueCode("AUTO_")</text>
|
|
151
|
+
<text x="25" y="100" fill="#f8fafc" font-size="12">ā
Dynamic Smart Waits</text>
|
|
152
|
+
<text x="25" y="125" fill="#f8fafc" font-size="12">ā
Spinner detachment</text>
|
|
153
|
+
<text x="25" y="145" fill="#f8fafc" font-size="12">ā
100% UTF-8 No BOM</text>
|
|
154
|
+
</g>
|
|
155
|
+
</svg>"""
|
|
156
|
+
return svg
|
|
157
|
+
|
|
158
|
+
def build_html_wrapper(svg_content: str, title: str = "Synapse Hub Architecture Diagram") -> str:
|
|
159
|
+
return f"""<!DOCTYPE html>
|
|
160
|
+
<html lang="en">
|
|
161
|
+
<head>
|
|
162
|
+
<meta charset="utf-8"/>
|
|
163
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0"/>
|
|
164
|
+
<title>{title}</title>
|
|
165
|
+
<style>
|
|
166
|
+
body {{
|
|
167
|
+
margin: 0;
|
|
168
|
+
padding: 32px;
|
|
169
|
+
background: #020617;
|
|
170
|
+
color: #f8fafc;
|
|
171
|
+
font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
|
|
172
|
+
display: flex;
|
|
173
|
+
flex-direction: column;
|
|
174
|
+
align-items: center;
|
|
175
|
+
}}
|
|
176
|
+
.diagram-container {{
|
|
177
|
+
max-width: 1040px;
|
|
178
|
+
width: 100%;
|
|
179
|
+
background: #0f172a;
|
|
180
|
+
border: 1px solid #1e293b;
|
|
181
|
+
border-radius: 16px;
|
|
182
|
+
padding: 24px;
|
|
183
|
+
box-shadow: 0 10px 25px -5px rgba(0, 0, 0, 0.5);
|
|
184
|
+
}}
|
|
185
|
+
</style>
|
|
186
|
+
</head>
|
|
187
|
+
<body>
|
|
188
|
+
<div class="diagram-container">
|
|
189
|
+
{svg_content}
|
|
190
|
+
</div>
|
|
191
|
+
</body>
|
|
192
|
+
</html>"""
|
|
193
|
+
|
|
194
|
+
def main():
|
|
195
|
+
parser = argparse.ArgumentParser(description="Generate self-contained standalone architectural diagrams.")
|
|
196
|
+
parser.add_argument("--type", choices=["fsm", "clean-pom"], default="fsm", help="Diagram type to generate.")
|
|
197
|
+
parser.add_argument("--output", "-o", help="Target output file path (.svg or .html).")
|
|
198
|
+
args = parser.parse_args()
|
|
199
|
+
|
|
200
|
+
if args.type == "fsm":
|
|
201
|
+
svg = generate_fsm_diagram()
|
|
202
|
+
title = "Synapse Hub ā 5-Stage Autonomous FSM Engine"
|
|
203
|
+
else:
|
|
204
|
+
svg = generate_clean_pom_diagram()
|
|
205
|
+
title = "Synapse Hub ā Clean POM Architecture"
|
|
206
|
+
|
|
207
|
+
if args.output:
|
|
208
|
+
if args.output.endswith(".html"):
|
|
209
|
+
content = build_html_wrapper(svg, title)
|
|
210
|
+
else:
|
|
211
|
+
content = svg
|
|
212
|
+
os.makedirs(os.path.dirname(os.path.abspath(args.output)), exist_ok=True)
|
|
213
|
+
with open(args.output, "w", encoding="utf-8") as f:
|
|
214
|
+
f.write(content)
|
|
215
|
+
print(f"[DIAGRAM ARCHITECT] Successfully exported {args.type} diagram to {args.output}")
|
|
216
|
+
else:
|
|
217
|
+
print(svg)
|
|
218
|
+
|
|
219
|
+
if __name__ == "__main__":
|
|
220
|
+
main()
|
package/tools/distill_log.py
CHANGED
|
@@ -93,16 +93,11 @@ def distill(log_text, max_lines=40):
|
|
|
93
93
|
if failure_block:
|
|
94
94
|
captured_failures.append("\n".join(failure_block[:10]))
|
|
95
95
|
|
|
96
|
-
# Distillation Report
|
|
97
|
-
output = []
|
|
98
|
-
output.append("======================================================================")
|
|
99
|
-
output.append(" š LOG DISTILLER ā AUTOMATED FAILURE TRIAGE SUMMARY ")
|
|
100
|
-
output.append("======================================================================")
|
|
101
|
-
output.append(f"Total Raw Lines: {total_raw_lines:,} lines analyzed.")
|
|
96
|
+
# Distillation Report (Lean Unix-style format saving ~150 tokens per block)
|
|
97
|
+
output = [f"[LOG DISTILLER] Analyzed {total_raw_lines:,} lines."]
|
|
102
98
|
|
|
103
99
|
if not failing_tcs and not captured_failures:
|
|
104
100
|
output.append("ā
ALL TESTS PASSED: Zero errors or failed steps detected.")
|
|
105
|
-
output.append("======================================================================")
|
|
106
101
|
return "\n".join(output)
|
|
107
102
|
|
|
108
103
|
if failing_tcs:
|
|
@@ -119,16 +114,44 @@ def distill(log_text, max_lines=40):
|
|
|
119
114
|
joined_blocks = "\n---\n".join(captured_failures[:3])
|
|
120
115
|
output.append(joined_blocks[:2000])
|
|
121
116
|
|
|
122
|
-
output.append("======================================================================")
|
|
123
117
|
return "\n".join(output)
|
|
124
118
|
|
|
125
119
|
# Public alias for MCP server compatibility
|
|
126
120
|
distill_log_content = distill
|
|
127
121
|
|
|
122
|
+
def shrink_tokens(text: str, max_chars_per_line: int = 120) -> str:
|
|
123
|
+
"""
|
|
124
|
+
Caveman / shrink compression: drops verbose metadata, collapses repetitive traces,
|
|
125
|
+
and truncates stack noise while preserving 100% error names, line locations,
|
|
126
|
+
and assertion mismatches (Julius Brussee caveman/shrink pattern).
|
|
127
|
+
Achieves 33-65% token drop.
|
|
128
|
+
"""
|
|
129
|
+
lines = text.splitlines()
|
|
130
|
+
shrunk_lines = []
|
|
131
|
+
seen_signatures = set()
|
|
132
|
+
|
|
133
|
+
for line in lines:
|
|
134
|
+
cleaned = re.sub(r'\s+', ' ', line).strip()
|
|
135
|
+
if not cleaned:
|
|
136
|
+
continue
|
|
137
|
+
# Deduplicate repeated identical trace lines
|
|
138
|
+
if cleaned.startswith("at ") or cleaned.startswith("File "):
|
|
139
|
+
sig = cleaned[:60]
|
|
140
|
+
if sig in seen_signatures:
|
|
141
|
+
continue
|
|
142
|
+
seen_signatures.add(sig)
|
|
143
|
+
# Drop excessive UUID/hex hash strings
|
|
144
|
+
cleaned = re.sub(r'\b[0-9a-f]{16,64}\b', '<hash>', cleaned, flags=re.IGNORECASE)
|
|
145
|
+
if len(cleaned) > max_chars_per_line:
|
|
146
|
+
cleaned = cleaned[:max_chars_per_line] + "..."
|
|
147
|
+
shrunk_lines.append(cleaned)
|
|
148
|
+
return "\n".join(shrunk_lines)
|
|
149
|
+
|
|
128
150
|
def main():
|
|
129
151
|
parser = argparse.ArgumentParser(description="Distill terminal execution logs into high-signal failure blocks.")
|
|
130
152
|
parser.add_argument("--file", "-f", help="Path to raw log file (reads from stdin if omitted).")
|
|
131
153
|
parser.add_argument("--save-raw", "-s", default=None, help="Path to preserve raw log (omitted by default to prevent hub pollution).")
|
|
154
|
+
parser.add_argument("--shrink", action="store_true", help="Apply caveman/shrink token compression (33-65%% token drop).")
|
|
132
155
|
args = parser.parse_args()
|
|
133
156
|
|
|
134
157
|
if args.file:
|
|
@@ -153,6 +176,8 @@ def main():
|
|
|
153
176
|
sys.stderr.write(f"Warning: Could not save raw log: {err}\n")
|
|
154
177
|
|
|
155
178
|
summary = distill(log_text)
|
|
179
|
+
if args.shrink:
|
|
180
|
+
summary = shrink_tokens(summary)
|
|
156
181
|
print(summary)
|
|
157
182
|
if args.save_raw and os.path.exists(args.save_raw):
|
|
158
183
|
print(f"[Full raw log saved to file://{os.path.abspath(args.save_raw)}]")
|