@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
|
@@ -1019,7 +1019,7 @@
|
|
|
1019
1019
|
<div class="hero-modes" style="display: flex; justify-content: center; gap: 16px; margin: 0 auto 32px; max-width: 820px; flex-wrap: wrap;">
|
|
1020
1020
|
<div style="background: rgba(255, 255, 255, 0.04); border: 1px solid rgba(255, 255, 255, 0.08); border-radius: 12px; padding: 14px 18px; text-align: left; flex: 1; min-width: 260px;">
|
|
1021
1021
|
<div style="font-weight: 700; font-size: 13px; color: var(--accent-cyan); margin-bottom: 4px;" data-i18n="mode_cli_title">🛠️ Cách 1: CLI Độc Lập (Zero AI)</div>
|
|
1022
|
-
<div style="font-size: 12.5px; color: var(--text-secondary); line-height: 1.45;" data-i18n="mode_cli_desc">Chạy <code>npx synapse-hub lint</code> phát hiện test pass ảo, nén log CI hoặc xuất Excel chuẩn mà không cần cấu hình.</div>
|
|
1022
|
+
<div style="font-size: 12.5px; color: var(--text-secondary); line-height: 1.45;" data-i18n="mode_cli_desc">Chạy <code>npx @teevee98/synapse-hub lint</code> phát hiện test pass ảo, nén log CI hoặc xuất Excel chuẩn mà không cần cấu hình.</div>
|
|
1023
1023
|
</div>
|
|
1024
1024
|
<div style="background: rgba(99, 102, 241, 0.06); border: 1px solid rgba(99, 102, 241, 0.2); border-radius: 12px; padding: 14px 18px; text-align: left; flex: 1; min-width: 260px;">
|
|
1025
1025
|
<div style="font-weight: 700; font-size: 13px; color: #a5b4fc; margin-bottom: 4px;" data-i18n="mode_agent_title">🧠 Cách 2: Chốt Chặn Cho AI Coding</div>
|
|
@@ -1146,7 +1146,7 @@
|
|
|
1146
1146
|
<h3 class="highlight-title" data-i18n="h1_title">Bắt Test Pass Ảo (Fake-Pass Sentinel)</h3>
|
|
1147
1147
|
<p class="highlight-desc" data-i18n="h1_desc">AI coding agents thường sinh test case rỗng hoặc bọc try/catch bỏ qua lỗi để tạo kết quả pass giả. Linter AST phân tích cây cú pháp trong 0.02s giúp phát hiện ngay các bài test thiếu assertion hoặc bỏ qua ngoại lệ ngầm.</p>
|
|
1148
1148
|
</div>
|
|
1149
|
-
<div class="code-snippet">npx synapse-hub lint</div>
|
|
1149
|
+
<div class="code-snippet">npx @teevee98/synapse-hub lint</div>
|
|
1150
1150
|
</div>
|
|
1151
1151
|
|
|
1152
1152
|
<div class="highlight-card">
|
|
@@ -1155,7 +1155,7 @@
|
|
|
1155
1155
|
<h3 class="highlight-title" data-i18n="h2_title">Đo Độ Nhạy Assert (Micro-Mutator)</h3>
|
|
1156
1156
|
<p class="highlight-desc" data-i18n="h2_desc">Tự động biến đổi logic (đảo toán tử, sửa điều kiện) để kiểm tra xem các câu lệnh assert có thực sự bắt được lỗi hay không (yêu cầu Mutation Score ≥ 80%).</p>
|
|
1157
1157
|
</div>
|
|
1158
|
-
<div class="code-snippet">npx synapse-hub mutate --min-score 80</div>
|
|
1158
|
+
<div class="code-snippet">npx @teevee98/synapse-hub mutate --min-score 80</div>
|
|
1159
1159
|
</div>
|
|
1160
1160
|
|
|
1161
1161
|
<div class="highlight-card">
|
|
@@ -1164,7 +1164,7 @@
|
|
|
1164
1164
|
<h3 class="highlight-title" data-i18n="h3_title">Lọc 95% Nhiễu Log CI/CD</h3>
|
|
1165
1165
|
<p class="highlight-desc" data-i18n="h3_desc">Log CLI và Gradle dài hàng nghìn dòng làm AI bị tràn bộ nhớ và mất tập trung. Bộ lọc thông minh cô đọng dữ liệu còn vài dòng chứa đúng dòng gây lỗi, exception gốc và 3 request gần nhất.</p>
|
|
1166
1166
|
</div>
|
|
1167
|
-
<div class="code-snippet">npx synapse-hub distill <log_file></div>
|
|
1167
|
+
<div class="code-snippet">npx @teevee98/synapse-hub distill <log_file></div>
|
|
1168
1168
|
</div>
|
|
1169
1169
|
</div>
|
|
1170
1170
|
</section>
|
|
@@ -1267,8 +1267,8 @@
|
|
|
1267
1267
|
<!-- Tab Doctor -->
|
|
1268
1268
|
<div id="tab-doctor" class="tab-pane">
|
|
1269
1269
|
<div class="cmd-line">
|
|
1270
|
-
<div class="cmd-text"><span class="prompt">$</span>npx synapse-hub doctor</div>
|
|
1271
|
-
<button class="copy-btn" onclick="copyCmd('npx synapse-hub doctor')">Copy</button>
|
|
1270
|
+
<div class="cmd-text"><span class="prompt">$</span>npx @teevee98/synapse-hub doctor</div>
|
|
1271
|
+
<button class="copy-btn" onclick="copyCmd('npx @teevee98/synapse-hub doctor')">Copy</button>
|
|
1272
1272
|
</div>
|
|
1273
1273
|
<p class="cmd-desc" data-i18n="t_desc_doctor">🩺 Quét chẩn đoán 1-click kiểm tra môi trường Python 3.9+, Node.js, Git hook, trình duyệt, và Bộ nhớ Agent Trung tâm.</p>
|
|
1274
1274
|
</div>
|
|
@@ -1276,8 +1276,8 @@
|
|
|
1276
1276
|
<!-- Tab Setup -->
|
|
1277
1277
|
<div id="tab-setup" class="tab-pane" style="display:none;">
|
|
1278
1278
|
<div class="cmd-line">
|
|
1279
|
-
<div class="cmd-text"><span class="prompt">$</span>npx synapse-hub setup</div>
|
|
1280
|
-
<button class="copy-btn" onclick="copyCmd('npx synapse-hub setup')">Copy</button>
|
|
1279
|
+
<div class="cmd-text"><span class="prompt">$</span>npx @teevee98/synapse-hub setup</div>
|
|
1280
|
+
<button class="copy-btn" onclick="copyCmd('npx @teevee98/synapse-hub setup')">Copy</button>
|
|
1281
1281
|
</div>
|
|
1282
1282
|
<p class="cmd-desc" data-i18n="t_desc_setup">⚡ Cài đặt dự án 1-click: sinh hướng dẫn PROJECT_AI_GUIDE.md, cầu nối Universal AI bridges, bản đồ AST, và git hook chặn rò rỉ.</p>
|
|
1283
1283
|
</div>
|
|
@@ -1285,8 +1285,8 @@
|
|
|
1285
1285
|
<!-- Tab Init Config -->
|
|
1286
1286
|
<div id="tab-init-cfg" class="tab-pane" style="display:none;">
|
|
1287
1287
|
<div class="cmd-line">
|
|
1288
|
-
<div class="cmd-text"><span class="prompt">$</span>npx synapse-hub init-config</div>
|
|
1289
|
-
<button class="copy-btn" onclick="copyCmd('npx synapse-hub init-config')">Copy</button>
|
|
1288
|
+
<div class="cmd-text"><span class="prompt">$</span>npx @teevee98/synapse-hub init-config</div>
|
|
1289
|
+
<button class="copy-btn" onclick="copyCmd('npx @teevee98/synapse-hub init-config')">Copy</button>
|
|
1290
1290
|
</div>
|
|
1291
1291
|
<p class="cmd-desc" data-i18n="t_desc_init_cfg">⚙️ Khởi tạo nhanh file cấu hình .synapse.json chuẩn hóa cho dự án Spoke (hỗ trợ interactive wizard và cờ tự động --template, --author, --sheet-name).</p>
|
|
1292
1292
|
</div>
|
|
@@ -1294,8 +1294,8 @@
|
|
|
1294
1294
|
<!-- Tab Verify -->
|
|
1295
1295
|
<div id="tab-verify" class="tab-pane" style="display:none;">
|
|
1296
1296
|
<div class="cmd-line">
|
|
1297
|
-
<div class="cmd-text"><span class="prompt">$</span>npx synapse-hub verify</div>
|
|
1298
|
-
<button class="copy-btn" onclick="copyCmd('npx synapse-hub verify')">Copy</button>
|
|
1297
|
+
<div class="cmd-text"><span class="prompt">$</span>npx @teevee98/synapse-hub verify</div>
|
|
1298
|
+
<button class="copy-btn" onclick="copyCmd('npx @teevee98/synapse-hub verify')">Copy</button>
|
|
1299
1299
|
</div>
|
|
1300
1300
|
<p class="cmd-desc" data-i18n="t_desc_verify">🛡️ Thực thi toàn bộ 10 Quality Gates Definition-of-Done (UTF-8 No BOM, Clean POM, Đường dẫn khả chuyển, Mutation ≥ 80%, Skill Routing Guard, SLA Sentinel).</p>
|
|
1301
1301
|
</div>
|
|
@@ -1303,8 +1303,8 @@
|
|
|
1303
1303
|
<!-- Tab Lint -->
|
|
1304
1304
|
<div id="tab-lint" class="tab-pane" style="display:none;">
|
|
1305
1305
|
<div class="cmd-line">
|
|
1306
|
-
<div class="cmd-text"><span class="prompt">$</span>npx synapse-hub lint</div>
|
|
1307
|
-
<button class="copy-btn" onclick="copyCmd('npx synapse-hub lint')">Copy</button>
|
|
1306
|
+
<div class="cmd-text"><span class="prompt">$</span>npx @teevee98/synapse-hub lint</div>
|
|
1307
|
+
<button class="copy-btn" onclick="copyCmd('npx @teevee98/synapse-hub lint')">Copy</button>
|
|
1308
1308
|
</div>
|
|
1309
1309
|
<p class="cmd-desc" data-i18n="t_desc_lint">🔍 Quét AST phát hiện các test case pass ảo (0 assertion), khối catch rỗng và ngoại lệ bị bỏ qua ngầm (swallowed exceptions) trên toàn bộ test script.</p>
|
|
1310
1310
|
</div>
|
|
@@ -1312,8 +1312,8 @@
|
|
|
1312
1312
|
<!-- Tab Excel -->
|
|
1313
1313
|
<div id="tab-excel" class="tab-pane" style="display:none;">
|
|
1314
1314
|
<div class="cmd-line">
|
|
1315
|
-
<div class="cmd-text"><span class="prompt">$</span>npx synapse-hub export-excel <path_to_markdown></div>
|
|
1316
|
-
<button class="copy-btn" onclick="copyCmd('npx synapse-hub export-excel')">Copy</button>
|
|
1315
|
+
<div class="cmd-text"><span class="prompt">$</span>npx @teevee98/synapse-hub export-excel <path_to_markdown></div>
|
|
1316
|
+
<button class="copy-btn" onclick="copyCmd('npx @teevee98/synapse-hub export-excel')">Copy</button>
|
|
1317
1317
|
</div>
|
|
1318
1318
|
<p class="cmd-desc" data-i18n="t_desc_excel">📊 Biên dịch tài liệu test case markdown sang file bảng tính Excel 12 cột chuyên nghiệp có công thức và danh sách chọn trạng thái.</p>
|
|
1319
1319
|
</div>
|
|
@@ -1321,8 +1321,8 @@
|
|
|
1321
1321
|
<!-- Tab Auto Heal (Reflexion) -->
|
|
1322
1322
|
<div id="tab-heal" class="tab-pane" style="display:none;">
|
|
1323
1323
|
<div class="cmd-line">
|
|
1324
|
-
<div class="cmd-text"><span class="prompt">$</span>npx synapse-hub auto-heal</div>
|
|
1325
|
-
<button class="copy-btn" onclick="copyCmd('npx synapse-hub auto-heal')">Copy</button>
|
|
1324
|
+
<div class="cmd-text"><span class="prompt">$</span>npx @teevee98/synapse-hub auto-heal</div>
|
|
1325
|
+
<button class="copy-btn" onclick="copyCmd('npx @teevee98/synapse-hub auto-heal')">Copy</button>
|
|
1326
1326
|
</div>
|
|
1327
1327
|
<p class="cmd-desc" data-i18n="t_desc_heal">🔄 Tự phục hồi test lỗi theo mô hình Reflexion: AI phân tích call stack, đề xuất bản vá và ghi nhớ các cách sửa hỏng để không bao giờ lặp lại lỗi cũ.</p>
|
|
1328
1328
|
</div>
|
|
@@ -1330,8 +1330,8 @@
|
|
|
1330
1330
|
<!-- Tab Set-of-Marks (SoM) -->
|
|
1331
1331
|
<div id="tab-som" class="tab-pane" style="display:none;">
|
|
1332
1332
|
<div class="cmd-line">
|
|
1333
|
-
<div class="cmd-text"><span class="prompt">$</span>npx synapse-hub som <image_path></div>
|
|
1334
|
-
<button class="copy-btn" onclick="copyCmd('npx synapse-hub som')">Copy</button>
|
|
1333
|
+
<div class="cmd-text"><span class="prompt">$</span>npx @teevee98/synapse-hub som <image_path></div>
|
|
1334
|
+
<button class="copy-btn" onclick="copyCmd('npx @teevee98/synapse-hub som')">Copy</button>
|
|
1335
1335
|
</div>
|
|
1336
1336
|
<p class="cmd-desc" data-i18n="t_desc_som">🏷️ Gắn nhãn thị giác trực tiếp lên màn hình Canvas/GIS: Đánh số thứ tự lên từng nút bấm để AI click chính xác mà không cần mã HTML DOM.</p>
|
|
1337
1337
|
</div>
|
|
@@ -1339,8 +1339,8 @@
|
|
|
1339
1339
|
<!-- Tab Dashboard -->
|
|
1340
1340
|
<div id="tab-dashboard" class="tab-pane" style="display:none;">
|
|
1341
1341
|
<div class="cmd-line">
|
|
1342
|
-
<div class="cmd-text"><span class="prompt">$</span>npx synapse-hub dashboard</div>
|
|
1343
|
-
<button class="copy-btn" onclick="copyCmd('npx synapse-hub dashboard')">Copy</button>
|
|
1342
|
+
<div class="cmd-text"><span class="prompt">$</span>npx @teevee98/synapse-hub dashboard</div>
|
|
1343
|
+
<button class="copy-btn" onclick="copyCmd('npx @teevee98/synapse-hub dashboard')">Copy</button>
|
|
1344
1344
|
</div>
|
|
1345
1345
|
<p class="cmd-desc" data-i18n="t_desc_dashboard">📈 Khởi tạo và mở trang Báo cáo QA Tổng thể dạng HTML độc lập ngay trong trình duyệt của bạn.</p>
|
|
1346
1346
|
</div>
|
|
@@ -1348,8 +1348,8 @@
|
|
|
1348
1348
|
<!-- Tab Watch -->
|
|
1349
1349
|
<div id="tab-watch" class="tab-pane" style="display:none;">
|
|
1350
1350
|
<div class="cmd-line">
|
|
1351
|
-
<div class="cmd-text"><span class="prompt">$</span>npx synapse-hub watch</div>
|
|
1352
|
-
<button class="copy-btn" onclick="copyCmd('npx synapse-hub watch')">Copy</button>
|
|
1351
|
+
<div class="cmd-text"><span class="prompt">$</span>npx @teevee98/synapse-hub watch</div>
|
|
1352
|
+
<button class="copy-btn" onclick="copyCmd('npx @teevee98/synapse-hub watch')">Copy</button>
|
|
1353
1353
|
</div>
|
|
1354
1354
|
<p class="cmd-desc" data-i18n="t_desc_watch">👁️ Bảng điều khiển TUI HUD trực quan thời gian thực, tích hợp cơ chế giám sát tự động chống treo/kẹt mạng và chống vòng lặp thao tác.</p>
|
|
1355
1355
|
</div>
|
|
@@ -1610,7 +1610,7 @@
|
|
|
1610
1610
|
hero_title: "Trung Tâm Trí Tuệ QA Toàn Diện<br>Dành Cho AI Coding Agents",
|
|
1611
1611
|
hero_desc: "Tăng cường sức mạnh cho QA Engineers và các Autonomous AI Agent trên cả 4 mảng: <strong>Manual</strong>, <strong>Automation</strong>, <strong>API</strong> và <strong>Performance Testing</strong>. Trang bị các Sentinel phân tích cú pháp AST 100% offline, 9 hồ sơ Swarm Agent, và 10 Quality Gates Definition-of-Done.",
|
|
1612
1612
|
mode_cli_title: "🛠️ Cách 1: CLI Độc Lập (Zero AI)",
|
|
1613
|
-
mode_cli_desc: "Chạy <code>npx synapse-hub lint</code> phát hiện test pass ảo, nén log CI hoặc xuất Excel chuẩn mà không cần cấu hình.",
|
|
1613
|
+
mode_cli_desc: "Chạy <code>npx @teevee98/synapse-hub lint</code> phát hiện test pass ảo, nén log CI hoặc xuất Excel chuẩn mà không cần cấu hình.",
|
|
1614
1614
|
mode_agent_title: "🧠 Cách 2: Chốt Chặn Cho AI Coding",
|
|
1615
1615
|
mode_agent_desc: "Tích hợp vào Cursor, Antigravity, Claude Code làm bộ quy chuẩn — ngăn AI sinh mã nguồn cẩu thả hoặc bỏ qua ngoại lệ ngầm.",
|
|
1616
1616
|
btn_quickstart: "🚀 Bắt Đầu Trong 5 Giây",
|
|
@@ -1788,7 +1788,7 @@
|
|
|
1788
1788
|
hero_title: "The Complete QA Intelligence Hub<br>for AI Coding Agents",
|
|
1789
1789
|
hero_desc: "Empowering QA Engineers and Autonomous AI Agents across <strong>Manual</strong>, <strong>Automation</strong>, <strong>API</strong>, and <strong>Performance</strong> testing. Equipped with 100% offline-first AST sentinels, 9 swarm profiles, and 10 Quality Gates Definition-of-Done.",
|
|
1790
1790
|
mode_cli_title: "🛠️ Mode 1: Standalone CLI (Zero AI)",
|
|
1791
|
-
mode_cli_desc: "Run <code>npx synapse-hub lint</code> to catch fake passes, distill CI logs, or export Excel with zero setup.",
|
|
1791
|
+
mode_cli_desc: "Run <code>npx @teevee98/synapse-hub lint</code> to catch fake passes, distill CI logs, or export Excel with zero setup.",
|
|
1792
1792
|
mode_agent_title: "🧠 Mode 2: Guardrail for AI Coding",
|
|
1793
1793
|
mode_agent_desc: "Mount into Cursor, Antigravity, or Claude Code as quality guardrails — stopping AI from writing brittle or tautological tests.",
|
|
1794
1794
|
btn_quickstart: "🚀 5-Second Quickstart",
|
package/tools/TOOLS_RUNBOOK.md
CHANGED
|
@@ -10,11 +10,11 @@
|
|
|
10
10
|
| Practical Agent Context | Required Tool | Typical Execution Command |
|
|
11
11
|
| :--- | :--- | :--- |
|
|
12
12
|
| **Autonomous Bootstrap (New project / "setup project")** | `tools/setup_project.py` | `python tools/setup_project.py [target]` (or `agent-qa setup`).<br/>*Autonomous:* Detects stack, generates `PROJECT_AI_GUIDE.md`, installs `pre-push` Git hook, runs initial audit. |
|
|
13
|
-
| **Prerequisites & Environment Health Diagnostic ("doctor")** | `tools/check_env.py` | `agent-qa doctor` (or `npx synapse-hub doctor`) |
|
|
14
|
-
| **Visual Product Landing Page & Interactive Guide ("welcome")** | `tools/welcome_page.py` | `agent-qa welcome` (or `npx synapse-hub welcome`) |
|
|
15
|
-
| **Flaky Test Detection & Quarantine Governance ("flaky")** | `tools/flaky_detector.py` | `agent-qa flaky --detect` (or `npx synapse-hub flaky`) |
|
|
16
|
-
| **Executive Project Health & Quality Dashboard ("dashboard")** | `tools/dashboard_generator.py` | `agent-qa dashboard` (or `npx synapse-hub dashboard`) |
|
|
17
|
-
| **Clean Uninstall of AI Bridges & Global Plugins ("uninstall")** | `tools/cli.py` | `agent-qa uninstall` (or `npx synapse-hub uninstall`) |
|
|
13
|
+
| **Prerequisites & Environment Health Diagnostic ("doctor")** | `tools/check_env.py` | `agent-qa doctor` (or `npx @teevee98/synapse-hub doctor`) |
|
|
14
|
+
| **Visual Product Landing Page & Interactive Guide ("welcome")** | `tools/welcome_page.py` | `agent-qa welcome` (or `npx @teevee98/synapse-hub welcome`) |
|
|
15
|
+
| **Flaky Test Detection & Quarantine Governance ("flaky")** | `tools/flaky_detector.py` | `agent-qa flaky --detect` (or `npx @teevee98/synapse-hub flaky`) |
|
|
16
|
+
| **Executive Project Health & Quality Dashboard ("dashboard")** | `tools/dashboard_generator.py` | `agent-qa dashboard` (or `npx @teevee98/synapse-hub dashboard`) |
|
|
17
|
+
| **Clean Uninstall of AI Bridges & Global Plugins ("uninstall")** | `tools/cli.py` | `agent-qa uninstall` (or `npx @teevee98/synapse-hub uninstall`) |
|
|
18
18
|
| **Comprehensive Health & AST Analysis ("analyze project")** | `tools/analyze_project.py` | `python tools/analyze_project.py [target]` (or `agent-qa analyze`).<br/>*Post-Audit:* Stages and commits `PROJECT_HEALTH_REPORT.md` & `repo_map.txt` locally; confirms with user before pushing to remote. |
|
|
19
19
|
| **Action Safety Firewall (Environment Protection)** | `tools/safety_firewall.py` | `python tools/safety_firewall.py --text "Delete" --action click` (or `agent-qa safety-check`) |
|
|
20
20
|
| **API Contract Drift (Breaking Change Detection)** | `tools/api_drift_sentinel.py` | `python tools/api_drift_sentinel.py --old base.json --new curr.json` (or `agent-qa contract-drift`) |
|
|
@@ -73,14 +73,14 @@
|
|
|
73
73
|
| **Lookup XPath Locator in cached memory** | `tools/lookup_xpath.py` | `python tools/lookup_xpath.py "<keyword>"` |
|
|
74
74
|
| **Lookup Test Case metadata** | `tools/lookup_tc.py` | `python tools/lookup_tc.py "<keyword_or_id>"` |
|
|
75
75
|
| **Linting Markdown documentation quality** | `tools/lint_ai_docs.py` | `python tools/lint_ai_docs.py` |
|
|
76
|
-
| **Auditing AI Agent Skills & MCP Security** | `tools/skillspector.py` | `python tools/skillspector.py [path]` (or `agent-qa skillspector [path]` / `npx synapse-hub skillspector`) |
|
|
76
|
+
| **Auditing AI Agent Skills & MCP Security** | `tools/skillspector.py` | `python tools/skillspector.py [path]` (or `agent-qa skillspector [path]` / `npx @teevee98/synapse-hub skillspector`) |
|
|
77
77
|
| **Author Provenance & Anti-Tamper Integrity Guard** | `tools/author_integrity.py` | `python tools/author_integrity.py` (or `agent-qa verify-author` / `verify_all pre-flight`) |
|
|
78
78
|
| **Cross-Platform Token & Cost Auditor (Antigravity / Cursor / Claude)** | `tools/count_tokens.py` | `python tools/count_tokens.py` (or `--platform cursor` / `--platform all --list` / `--file <path>`) |
|
|
79
79
|
| **Standalone Executive HTML Dashboard Generator** | `tools/dashboard_generator.py` | `python tools/dashboard_generator.py` (or `agent-qa dashboard [--open]`) |
|
|
80
80
|
| **Real-Time Incremental Watch Mode Sentinel** | `tools/watch_mode.py` | `python tools/watch_mode.py` (or `agent-qa watch [--once]`) |
|
|
81
81
|
| **Technical Debt & Shortcut Harvester ("debt")** | `tools/debt_harvester.py` | `agent-qa debt [path]` (or `python tools/debt_harvester.py --scan`).<br/>*Autonomous:* Scans `shortcut:` markers across repo, generates tracked markdown ledger. |
|
|
82
82
|
| **6-Pillar Senior Git Diff Reviewer ("review")** | `tools/senior_code_review.py` | `agent-qa review [--staged]` (or `python tools/senior_code_review.py`).<br/>*Autonomous:* Reviews diff across Bugs, Security, Concurrency, Missing Tests, Speed, Bloat. |
|
|
83
|
-
| **Upstream Version Check & 1-Click Self-Update** | `tools/update_sentinel.py` | `python tools/update_sentinel.py --check / --update` (or `agent-qa update` / `npx synapse-hub update`) |
|
|
83
|
+
| **Upstream Version Check & 1-Click Self-Update** | `tools/update_sentinel.py` | `python tools/update_sentinel.py --check / --update` (or `agent-qa update` / `npx @teevee98/synapse-hub update`) |
|
|
84
84
|
| **Tier-2 Skill Routing & Collision Guard (Gate 9)** | `tools/skill_collision_guard.py` | `python tools/skill_collision_guard.py` (or `verify_all Gate 9` / `--route "<intent>"`) |
|
|
85
85
|
| **GoEx Reversible Sandbox Teardown Stack** | `tools/reversible_sandbox.py` | `python tools/reversible_sandbox.py run --cmd "<cmd>" --rollback "<cleanup>"` |
|
|
86
86
|
| **Multi-Trial Episodic Reflexion Loop (K=3)** | `tools/auto_heal_reflexion.py` | `python tools/auto_heal_reflexion.py --test-cmd "<cmd>" --max-trials 3` |
|
|
@@ -1029,7 +1029,7 @@ agent-qa update
|
|
|
1029
1029
|
- **Trigger Condition:** User requests "push hub" or "publish hub" after SemVer bump.
|
|
1030
1030
|
- **CLI Syntax:**
|
|
1031
1031
|
```bash
|
|
1032
|
-
python tools/hub_publisher.py [--dry-run]
|
|
1032
|
+
python tools/hub_publisher.py [--yes] [--dry-run]
|
|
1033
1033
|
```
|
|
1034
1034
|
|
|
1035
1035
|
---
|
package/tools/__init__.py
CHANGED
package/tools/analyze_project.py
CHANGED
|
@@ -146,7 +146,7 @@ def run_full_analysis(target_repo):
|
|
|
146
146
|
# Step 5: 10 Quality Gates DoD Verification
|
|
147
147
|
print(f"\n{BOLD}[5/5] Verifying 10 Quality Gates DoD (verify_all)...{RESET}")
|
|
148
148
|
if not verify_all.verify_engine_preflight(target_repo, mode=mode, silent=True):
|
|
149
|
-
print(
|
|
149
|
+
print(" ⚠️ Pre-flight Engine Integrity Guard failed: Author Attribution / MIT License Violated.")
|
|
150
150
|
summary["gates_status"] = "PREFLIGHT_TAMPER_DETECTED"
|
|
151
151
|
return summary
|
|
152
152
|
|
|
@@ -213,7 +213,7 @@ def run_full_analysis(target_repo):
|
|
|
213
213
|
> 1. `PROJECT_HEALTH_REPORT.md` (immediate architecture status, warnings, and DoD readiness).
|
|
214
214
|
> 2. `repo_map.txt` (instant lookup for Page Classes, methods, and parameters in < 600 tokens).
|
|
215
215
|
> - **Post-Audit Git Protocol:** Once analysis completes, stage and commit updated in-project artifacts locally (`git add PROJECT_HEALTH_REPORT.md repo_map.txt && git commit -m "docs(audit): update project health report and AST repo map"`). Per `git-push-protocol.md`, always confirm with the user before executing `git push`.
|
|
216
|
-
> - Whenever the user requests **"analyze project"** or **"project audit"**, re-run `npx synapse-hub analyze` to update this file in-place.
|
|
216
|
+
> - Whenever the user requests **"analyze project"** or **"project audit"**, re-run `npx @teevee98/synapse-hub analyze` to update this file in-place.
|
|
217
217
|
"""
|
|
218
218
|
with open(report_in_reports, "w", encoding="utf-8") as f:
|
|
219
219
|
f.write(md_content)
|
package/tools/browser_helpers.js
CHANGED
|
@@ -13,7 +13,7 @@
|
|
|
13
13
|
(function () {
|
|
14
14
|
'use strict';
|
|
15
15
|
|
|
16
|
-
if (window.__qa && window.__qa.__version === '3.
|
|
16
|
+
if (window.__qa && window.__qa.__version === '3.9.0') {
|
|
17
17
|
return window.__qa;
|
|
18
18
|
}
|
|
19
19
|
|
|
@@ -47,7 +47,7 @@
|
|
|
47
47
|
}
|
|
48
48
|
|
|
49
49
|
const qa = {
|
|
50
|
-
__version: '3.
|
|
50
|
+
__version: '3.9.0',
|
|
51
51
|
|
|
52
52
|
/**
|
|
53
53
|
* 1. Smart Action Batching
|