@teevee98/synapse-hub 3.8.4 → 3.8.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (52) hide show
  1. package/.agents/rules/author-integrity-guard.md +13 -10
  2. package/.agents/rules/skill-precedence.md +6 -4
  3. package/.agents/skills/agent-orchestration-multi-agent-optimize/SKILL.md +1 -1
  4. package/.agents/skills/agentless-qa-repair/SKILL.md +1 -1
  5. package/.agents/skills/auth-session-and-cookie-manager/SKILL.md +22 -2
  6. package/.agents/skills/qa-memory-os/SKILL.md +21 -4
  7. package/.agents/skills/security-dast-sentinel/SKILL.md +1 -1
  8. package/.agents/skills/token-and-context-optimizer/SKILL.md +1 -1
  9. package/.agents/skills/verification-before-completion/SKILL.md +1 -1
  10. package/AGENTS.md +3 -2
  11. package/CLAUDE.md +3 -3
  12. package/README.en.md +9 -9
  13. package/README.md +9 -9
  14. package/agentskills.json +1 -1
  15. package/bin/agent-qa.js +1 -1
  16. package/docs/ARCHITECTURE.en.md +3 -3
  17. package/docs/ARCHITECTURE.md +2 -2
  18. package/docs/CI_CD_INTEGRATION.en.md +6 -6
  19. package/docs/CI_CD_INTEGRATION.md +6 -6
  20. package/docs/CLI_REFERENCE.md +1 -1
  21. package/docs/PERFORMANCE_AUDIT_REPORT.md +1 -1
  22. package/docs/QUALITY_GATES.en.md +1 -1
  23. package/docs/QUALITY_GATES.md +1 -1
  24. package/package.json +1 -1
  25. package/plugin.json +1 -1
  26. package/skills_manifest.json +103 -54
  27. package/synapse.config.json +1 -1
  28. package/templates/PROJECT_AI_GUIDE_TEMPLATE.md +3 -3
  29. package/templates/ai_bridges/CLAUDE.md +3 -3
  30. package/templates/ci/github-actions-synapse.yml +2 -2
  31. package/templates/ci/gitlab-ci-synapse.yml +1 -1
  32. package/templates/ui/index.html +2 -2
  33. package/templates/welcome.html.tmpl +26 -26
  34. package/tools/TOOLS_RUNBOOK.md +8 -8
  35. package/tools/__init__.py +1 -1
  36. package/tools/analyze_project.py +2 -2
  37. package/tools/browser_helpers.js +2 -2
  38. package/tools/bump_version.py +5 -15
  39. package/tools/cli.py +3 -3
  40. package/tools/count_tokens.py +29 -5
  41. package/tools/dashboard_generator.py +10 -10
  42. package/tools/distill_log.py +2 -8
  43. package/tools/hub_publisher.py +38 -0
  44. package/tools/mcp_docx_server.py +1 -1
  45. package/tools/mcp_excel_server.py +1 -1
  46. package/tools/mcp_server.py +1 -1
  47. package/tools/repo_map.py +308 -106
  48. package/tools/setup_project.py +3 -3
  49. package/tools/sync_agent_rules.py +3 -3
  50. package/tools/ui_server.py +1 -1
  51. package/tools/update_sentinel.py +6 -6
  52. package/tools/welcome_page.py +2 -2
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
3
  "name": "Synapse-Hub",
4
- "version": "3.8.4",
4
+ "version": "3.8.5",
5
5
  "description": "Unified Catalog of 53 Specialized Skills for Autonomous AI Agents in Enterprise Software Quality Engineering, Performance, and Architecture.",
6
6
  "totalSkills": 53,
7
7
  "categories": {
@@ -270,7 +270,8 @@
270
270
  "version": "2.0.0",
271
271
  "profiles": [
272
272
  "perf-and-load"
273
- ]
273
+ ],
274
+ "description": "Profile, benchmark, and orchestrate multi-agent test workloads and token throughput. Use when orchestrating multi-agent swarms, partitioning workloads, or optimizing agent roles."
274
275
  },
275
276
  {
276
277
  "id": "antigravity-test-sentinel",
@@ -281,7 +282,8 @@
281
282
  "version": "2.0.0",
282
283
  "profiles": [
283
284
  "core-web-qa"
284
- ]
285
+ ],
286
+ "description": "Enforce verification-first discipline: blocks task completion until tests and quality gates pass. Use when enforcing Definition-of-Done quality gates before completing a code or test task."
285
287
  },
286
288
  {
287
289
  "id": "api-network-mocking-interception",
@@ -292,7 +294,8 @@
292
294
  "version": "2.0.0",
293
295
  "profiles": [
294
296
  "api-security"
295
- ]
297
+ ],
298
+ "description": "Intercept HTTP/GraphQL traffic, stub routes, and simulate chaos network failures. Use when stubbing, mocking, or intercepting network calls during UI or API tests."
296
299
  },
297
300
  {
298
301
  "id": "api-spec-to-e2e-matrix",
@@ -303,7 +306,8 @@
303
306
  "version": "2.0.0",
304
307
  "profiles": [
305
308
  "api-security"
306
- ]
309
+ ],
310
+ "description": "Generate automated positive, boundary, and negative test matrices from OpenAPI specifications. Use when converting an OpenAPI/Swagger spec into an end-to-end test matrix."
307
311
  },
308
312
  {
309
313
  "id": "architecture-decision-records",
@@ -314,7 +318,8 @@
314
318
  "version": "2.0.0",
315
319
  "profiles": [
316
320
  "enterprise-rbt"
317
- ]
321
+ ],
322
+ "description": "Record, structure, and maintain technical Architecture Decision Records (ADRs). Use when documenting significant architecture decisions as ADRs."
318
323
  },
319
324
  {
320
325
  "id": "auth-session-and-cookie-manager",
@@ -325,12 +330,13 @@
325
330
  "version": "2.0.0",
326
331
  "profiles": [
327
332
  "core-web-qa"
328
- ]
333
+ ],
334
+ "description": "Manage browser authentication sessions, storageState, JWT tokens, and multi-role state. Use when managing login sessions, storage state, or cookie reuse across tests."
329
335
  },
330
336
  {
331
337
  "id": "backend-load-and-stress-patterns",
332
338
  "name": "Backend Load And Stress Patterns",
333
- "description": "Enterprise backend load, stress, and endurance test orchestration using k6 and Locust. Directs AI agents in modeling concurrent Virtual Users (VUs), establishing SLA threshold assertions (P95/P99 latency, throughput/RPS, error rate < 0.1%), executing stress break-point tests, and soak/endurance validation.",
339
+ "description": "Orchestrate k6, Locust, and JMeter backend load, stress, and SLA endurance test suites. Use when designing load, stress, or spike test patterns for backend systems.",
334
340
  "category": "test_automation_and_execution",
335
341
  "path": ".agents/skills/backend-load-and-stress-patterns/SKILL.md",
336
342
  "version": "1.0.0",
@@ -348,7 +354,8 @@
348
354
  "version": "2.0.0",
349
355
  "profiles": [
350
356
  "core-web-qa"
351
- ]
357
+ ],
358
+ "description": "Test bash/sh scripts, CLI tools, and CI/CD pipelines with Bats. Use when writing Bash automation tests with the BATS framework."
352
359
  },
353
360
  {
354
361
  "id": "clean-pom-crafter",
@@ -359,7 +366,8 @@
359
366
  "version": "2.0.0",
360
367
  "profiles": [
361
368
  "core-web-qa"
362
- ]
369
+ ],
370
+ "description": "Build and refactor Clean POM Page Classes adhering to Flat Architecture standards. Use when designing Clean POM page classes or enforcing zero-locator discipline in scripts."
363
371
  },
364
372
  {
365
373
  "id": "code-refactoring-refactor-clean",
@@ -370,7 +378,8 @@
370
378
  "version": "2.0.0",
371
379
  "profiles": [
372
380
  "core-web-qa"
373
- ]
381
+ ],
382
+ "description": "Eliminate technical debt and refactor code using SOLID and Clean Code patterns. Use when refactoring legacy test code toward clean, maintainable structures."
374
383
  },
375
384
  {
376
385
  "id": "consumer-driven-contract-testing",
@@ -381,7 +390,8 @@
381
390
  "version": "3.2.0",
382
391
  "profiles": [
383
392
  "api-security"
384
- ]
393
+ ],
394
+ "description": "Standardize Consumer-Driven Contract (CDC) testing with Pact and OpenAPI Bidirectional Contract Testing. Detect and prevent breaking schema changes, payload drift, and microservice integration failures."
385
395
  },
386
396
  {
387
397
  "id": "db-state-verifier-and-seeder",
@@ -393,7 +403,8 @@
393
403
  "profiles": [
394
404
  "perf-and-load",
395
405
  "api-security"
396
- ]
406
+ ],
407
+ "description": "Seed isolated test fixtures and assert database mutations across SQL and NoSQL. Use when seeding, verifying, or cleaning database state around tests."
397
408
  },
398
409
  {
399
410
  "id": "e2e-testing-patterns",
@@ -404,7 +415,8 @@
404
415
  "version": "2.0.0",
405
416
  "profiles": [
406
417
  "core-web-qa"
407
- ]
418
+ ],
419
+ "description": "Design robust multi-browser E2E test architectures, parallel sharding, and retry governance. Use when designing end-to-end test suites for web applications."
408
420
  },
409
421
  {
410
422
  "id": "failure-autopsy-and-healing",
@@ -415,7 +427,8 @@
415
427
  "version": "2.0.0",
416
428
  "profiles": [
417
429
  "core-web-qa"
418
- ]
430
+ ],
431
+ "description": "Triage test failures from JUnit XML/screenshots and heal broken Page Class locators. Use when diagnosing failed test runs and producing closed-loop healing plans."
419
432
  },
420
433
  {
421
434
  "id": "file-and-report-validator",
@@ -427,12 +440,13 @@
427
440
  "profiles": [
428
441
  "api-security",
429
442
  "enterprise-rbt"
430
- ]
443
+ ],
444
+ "description": "Validate downloaded and uploaded files (Excel, CSV, PDF) schemas and tabular integrity. Use when validating exported files or reports against a schema."
431
445
  },
432
446
  {
433
447
  "id": "flaky-test-sentinel-and-quarantine",
434
448
  "name": "Flaky Test Sentinel And Quarantine",
435
- "description": "Enterprise flaky test detection, scoring, and automated quarantine governance. Detects non-deterministic test behavior via multi-run repetition (e.g., 5 iterations), computes flakiness index, isolates unstable tests from blocking CI/CD merges via quarantine tagging (@quarantine / @flaky), and tracks MTBF until remediation.",
449
+ "description": "Detect non-deterministic flaky tests, calculate flakiness scores, and manage quarantine. Use when detecting flaky tests and managing quarantine lifecycles.",
436
450
  "category": "verification_and_resilience",
437
451
  "path": ".agents/skills/flaky-test-sentinel-and-quarantine/SKILL.md",
438
452
  "version": "1.0.0",
@@ -450,7 +464,8 @@
450
464
  "version": "2.0.0",
451
465
  "profiles": [
452
466
  "core-web-qa"
453
- ]
467
+ ],
468
+ "description": "Create production-ready GitHub Actions workflows for automated test suites and CI/CD. Use when wiring test pipelines, matrix shards, or quality gates into GitHub Actions."
454
469
  },
455
470
  {
456
471
  "id": "graphify-impact-analyzer",
@@ -461,7 +476,8 @@
461
476
  "version": "2.0.0",
462
477
  "profiles": [
463
478
  "enterprise-rbt"
464
- ]
479
+ ],
480
+ "description": "Analyze code change blast radius and scope impacted test cases via AST. Use when analyzing the blast radius of code changes via dependency graphs."
465
481
  },
466
482
  {
467
483
  "id": "katalon-cli-runner",
@@ -472,7 +488,8 @@
472
488
  "version": "2.0.0",
473
489
  "profiles": [
474
490
  "core-web-qa"
475
- ]
491
+ ],
492
+ "description": "Execute headless Katalon and Gradle test runners with automatic driver cleanup. Use when running Katalon suites headless or integrating KRE into CI/CD."
476
493
  },
477
494
  {
478
495
  "id": "lam-script-generator",
@@ -483,7 +500,8 @@
483
500
  "version": "2.0.0",
484
501
  "profiles": [
485
502
  "core-web-qa"
486
- ]
503
+ ],
504
+ "description": "Transform user stories and acceptance criteria into Clean POM automation scripts. Use when the user provides a user story, acceptance criteria, or requirement document that must become a runnable script."
487
505
  },
488
506
  {
489
507
  "id": "lean-code-ladder",
@@ -494,7 +512,8 @@
494
512
  "version": "1.0.0",
495
513
  "profiles": [
496
514
  "core-web-qa"
497
- ]
515
+ ],
516
+ "description": "Apply a 7-rung reuse-first ladder so every new test-automation code path is the smallest complete change that fully solves the task. Use when adding helpers, Page Class methods, dependencies, or any new code where a shorter existing option might already exist."
498
517
  },
499
518
  {
500
519
  "id": "persistent-planning-files",
@@ -505,7 +524,8 @@
505
524
  "version": "1.0.0",
506
525
  "profiles": [
507
526
  "enterprise-rbt"
508
- ]
527
+ ],
528
+ "description": "Persist multi-step task plans, findings, and progress to three markdown files on disk so work survives context resets, compaction, and session crashes. Use when a task needs 5 or more tool calls, spans multiple phases, or must be resumable by another agent."
509
529
  },
510
530
  {
511
531
  "id": "playwright-live-interaction",
@@ -516,7 +536,8 @@
516
536
  "version": "2.0.0",
517
537
  "profiles": [
518
538
  "core-web-qa"
519
- ]
539
+ ],
540
+ "description": "Probe live web DOM/AOM and verify selectors under 200ms using headless Playwright. Use when probing live DOM/AOM, verifying selectors, or debugging a live browser session."
520
541
  },
521
542
  {
522
543
  "id": "playwright-webapp-testing",
@@ -527,7 +548,8 @@
527
548
  "version": "1.0.0",
528
549
  "profiles": [
529
550
  "core-web-qa"
530
- ]
551
+ ],
552
+ "description": "Drive Playwright test runs against a local web application with a managed server lifecycle: start, wait for readiness, run automation, and guarantee teardown. Use when verifying frontend functionality or debugging UI behavior of a dynamic webapp that must be started before testing."
531
553
  },
532
554
  {
533
555
  "id": "rbt-manual-testing",
@@ -538,12 +560,13 @@
538
560
  "version": "2.0.0",
539
561
  "profiles": [
540
562
  "enterprise-rbt"
541
- ]
563
+ ],
564
+ "description": "Comprehensive Risk-Based Testing (AI-RBT) 6-stage manual test case generation, Ambiguity Q&A analysis, Traceability Matrix, Field-Level Validation Checklist (15 input field types), Non-Functional scenarios (Double-Submit, Race Conditions), and Excel export formatting. Use when generating risk-based manual test cases and exploratory charters."
542
565
  },
543
566
  {
544
567
  "id": "security-dast-sentinel",
545
568
  "name": "Security DAST Sentinel",
546
- "description": "Dynamic Application Security Testing (DAST) and OWASP Top 10 automated verification for web apps and APIs. Audits security response headers (CSP, HSTS, X-Frame-Options), detects sensitive data leaks (PII, tokens, internal stacktraces), asserts BOLA/IDOR authorization boundaries via role token swapping, and validates CORS configurations.",
569
+ "description": "Run dynamic security audits: OWASP Top 10, security headers, BOLA/IDOR, and token leakage. Use when running or planning DAST and security scans against a target app.",
547
570
  "category": "verification_and_resilience",
548
571
  "path": ".agents/skills/security-dast-sentinel/SKILL.md",
549
572
  "version": "1.0.0",
@@ -555,7 +578,7 @@
555
578
  {
556
579
  "id": "skillspector-security-guard",
557
580
  "name": "SkillSpector Security Guard",
558
- "description": "Autonomous security scanner for AI Agent skills, prompt instructions, and MCP tool configs. Detects 71 vulnerability vectors across 17 categories (Prompt Injection, Data Exfiltration, Privilege Escalation, Agent Snooping, Tool Poisoning, Behavioral AST). Powered by NVIDIA SkillSpector heuristics with Prohibition Context Guard.",
581
+ "description": "Audit and verify AI agent skills, prompts, and MCP configurations against vulnerability vectors inspired by NVIDIA SkillSpector. Use when auditing skills and plugins for prompt-injection and security threats.",
559
582
  "category": "verification_and_resilience",
560
583
  "path": ".agents/skills/skillspector-security-guard/SKILL.md",
561
584
  "version": "1.0.0",
@@ -573,7 +596,8 @@
573
596
  "version": "2.0.0",
574
597
  "profiles": [
575
598
  "core-web-qa"
576
- ]
599
+ ],
600
+ "description": "Heal broken locators using semantic AOM diffing with Role, Label, and TestId hierarchy. Use when locators break and automated healing strategies are needed."
577
601
  },
578
602
  {
579
603
  "id": "surgical-coding-principles",
@@ -584,7 +608,8 @@
584
608
  "version": "1.0.0",
585
609
  "profiles": [
586
610
  "core-web-qa"
587
- ]
611
+ ],
612
+ "description": "Enforce four behavioral principles (Think Before Coding, Simplicity First, Surgical Changes, Goal-Driven Execution) when writing or modifying test automation code. Use when implementing Page Classes, editing test scripts, or changing hub tools to prevent assumption drift and over-engineering."
588
613
  },
589
614
  {
590
615
  "id": "synthetic-test-data-generator",
@@ -595,7 +620,8 @@
595
620
  "version": "2.0.0",
596
621
  "profiles": [
597
622
  "core-web-qa"
598
- ]
623
+ ],
624
+ "description": "Generate idempotent, boundary-value synthetic test data with unique runtime timestamps. Use when generating idempotent, unique test data for creation tests."
599
625
  },
600
626
  {
601
627
  "id": "systematic-debugging",
@@ -606,7 +632,8 @@
606
632
  "version": "1.0.0",
607
633
  "profiles": [
608
634
  "core-web-qa"
609
- ]
635
+ ],
636
+ "description": "Investigate root cause through four disciplined phases before proposing any fix for a test failure, bug, or unexpected behavior. Use when a test fails, a defect appears, or a fix attempt has already failed and guessing is tempting."
610
637
  },
611
638
  {
612
639
  "id": "test-driven-development",
@@ -617,7 +644,8 @@
617
644
  "version": "1.0.0",
618
645
  "profiles": [
619
646
  "core-web-qa"
620
- ]
647
+ ],
648
+ "description": "Enforce the RED-GREEN-REFACTOR cycle: no production or automation code is written before a failing test exists and has been watched failing. Use when implementing new helpers, Page Class logic, bug fixes, or any behavior change in test codebases."
621
649
  },
622
650
  {
623
651
  "id": "token-and-context-optimizer",
@@ -628,7 +656,8 @@
628
656
  "version": "2.0.0",
629
657
  "profiles": [
630
658
  "core-web-qa"
631
- ]
659
+ ],
660
+ "description": "Optimize prompt context, distill verbose logs, and prevent context rot in Antigravity. Use when optimizing prompts or reducing token and context overhead."
632
661
  },
633
662
  {
634
663
  "id": "verification-before-completion",
@@ -639,7 +668,8 @@
639
668
  "version": "1.0.0",
640
669
  "profiles": [
641
670
  "core-web-qa"
642
- ]
671
+ ],
672
+ "description": "Require fresh verification evidence — a command run in the current session with its real output — before any claim that work is complete, fixed, or passing. Use when about to report success, commit, open a PR, or close a task."
643
673
  },
644
674
  {
645
675
  "id": "visual-regression-sentinel",
@@ -650,7 +680,8 @@
650
680
  "version": "2.0.0",
651
681
  "profiles": [
652
682
  "core-web-qa"
653
- ]
683
+ ],
684
+ "description": "Run pixel and layout shift visual regression checks with anti-flake masking. Use when comparing screenshots for visual regressions with anti-flake masking."
654
685
  },
655
686
  {
656
687
  "id": "wcag-audit-patterns",
@@ -661,7 +692,8 @@
661
692
  "version": "2.0.0",
662
693
  "profiles": [
663
694
  "enterprise-rbt"
664
- ]
695
+ ],
696
+ "description": "Audit WCAG 2.2 accessibility (A/AA), keyboard navigation, and ARIA roles. Use when auditing accessibility against WCAG 2.2 A/AA criteria."
665
697
  },
666
698
  {
667
699
  "id": "web-vitals-and-performance-profiler",
@@ -672,7 +704,8 @@
672
704
  "version": "2.0.0",
673
705
  "profiles": [
674
706
  "perf-and-load"
675
- ]
707
+ ],
708
+ "description": "Measure Core Web Vitals (LCP, CLS, INP) and network waterfalls via CDP. Use when the user asks why a page is slow or needs CWV budgets enforced in CI."
676
709
  },
677
710
  {
678
711
  "id": "gherkin-to-suite",
@@ -683,7 +716,8 @@
683
716
  "version": "1.0.0",
684
717
  "profiles": [
685
718
  "enterprise-rbt"
686
- ]
719
+ ],
720
+ "description": "Compile Gherkin .feature files into an expanded test matrix, hub Universal IR and a proven-vs-owed coverage-gap report with zero LLM tokens. Use when the user supplies BDD .feature specs or wants a BDD suite audited before codification."
687
721
  },
688
722
  {
689
723
  "id": "meta-prompt-crafter",
@@ -694,7 +728,8 @@
694
728
  "version": "1.0.0",
695
729
  "profiles": [
696
730
  "enterprise-rbt"
697
- ]
731
+ ],
732
+ "description": "Meta-prompt engineer transforming rough human requests into high-fidelity, production-grade prompts for ChatGPT, Gemini, Claude, Midjourney, and Coding AIs. Use when the user asks to write, design, refine, or optimize a prompt for another AI."
698
733
  },
699
734
  {
700
735
  "id": "senior-code-review",
@@ -705,7 +740,8 @@
705
740
  "version": "1.0.0",
706
741
  "profiles": [
707
742
  "enterprise-rbt"
708
- ]
743
+ ],
744
+ "description": "Review code changes across logic, security, concurrency, and test coverage. Use when conducting pull request reviews, diff inspections, or auditing commit changes before merge."
709
745
  },
710
746
  {
711
747
  "id": "repo-quality-audit",
@@ -716,7 +752,8 @@
716
752
  "version": "1.0.0",
717
753
  "profiles": [
718
754
  "enterprise-rbt"
719
- ]
755
+ ],
756
+ "description": "Comprehensive codebase quality audit covering bugs, security, bottlenecks, and bloat. Use when auditing an entire project, evaluating repository health, or prioritizing technical debt."
720
757
  },
721
758
  {
722
759
  "id": "technical-debt-harvester",
@@ -727,7 +764,8 @@
727
764
  "version": "1.0.0",
728
765
  "profiles": [
729
766
  "enterprise-rbt"
730
- ]
767
+ ],
768
+ "description": "Harvest shortcut: comments into a tracked technical debt ledger. Use when auditing code compromises, tracking deferred refactorings, or scanning for shortcut markers."
731
769
  },
732
770
  {
733
771
  "id": "lean-impact-scoreboard",
@@ -738,7 +776,8 @@
738
776
  "version": "1.0.0",
739
777
  "profiles": [
740
778
  "perf-and-load"
741
- ]
779
+ ],
780
+ "description": "Display empirical impact scoreboards (code reduction, token savings, mutation rigor). Use when reviewing lean engineering benchmarks, token throughput, or reporting quality metrics."
742
781
  },
743
782
  {
744
783
  "id": "agentless-qa-repair",
@@ -749,7 +788,8 @@
749
788
  "version": "1.0.0",
750
789
  "profiles": [
751
790
  "core-web-qa"
752
- ]
791
+ ],
792
+ "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."
753
793
  },
754
794
  {
755
795
  "id": "qa-aci-interface",
@@ -760,7 +800,8 @@
760
800
  "version": "1.0.0",
761
801
  "profiles": [
762
802
  "core-web-qa"
763
- ]
803
+ ],
804
+ "description": "Safe Agent-Computer Interface for inspecting code windows (40-50 lines), surgical editing with pre-commit AST checks, and distilled test execution. Use when inspecting, editing, or refactoring code without context blowout."
764
805
  },
765
806
  {
766
807
  "id": "qa-memory-os",
@@ -771,7 +812,8 @@
771
812
  "version": "1.0.0",
772
813
  "profiles": [
773
814
  "core-web-qa"
774
- ]
815
+ ],
816
+ "description": "Hierarchical 3-tier memory operating system for test automation: Core Memory blocks, Recall step logs, and Archival semantic store with AUT version scoping. Use when managing long-term test session state, auth tokens, and preventing context rot."
775
817
  },
776
818
  {
777
819
  "id": "event-stream-qa-orchestrator",
@@ -782,7 +824,8 @@
782
824
  "version": "1.0.0",
783
825
  "profiles": [
784
826
  "perf-and-load"
785
- ]
827
+ ],
828
+ "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."
786
829
  },
787
830
  {
788
831
  "id": "web-agent-gym-benchmarking",
@@ -793,7 +836,8 @@
793
836
  "version": "1.0.0",
794
837
  "profiles": [
795
838
  "core-web-qa"
796
- ]
839
+ ],
840
+ "description": "Empirical benchmark harness evaluating web agents and Page Classes against standardized enterprise tasks with headless <200ms latency budgets and ground-truth DB state verification. Use when benchmarking web agents or certifying Page Classes."
797
841
  },
798
842
  {
799
843
  "id": "tot-exploratory-testing",
@@ -804,7 +848,8 @@
804
848
  "version": "1.0.0",
805
849
  "profiles": [
806
850
  "enterprise-rbt"
807
- ]
851
+ ],
852
+ "description": "Non-linear Tree/Graph-of-Thoughts exploratory testing engine exploring Happy Path, Boundary/Race, and Negative/Chaos branches with Beam Search risk scoring and multi-hypothesis RCA. Use when decomposing complex user stories into exploratory test trees or triaging complex failures."
808
853
  },
809
854
  {
810
855
  "id": "actor-qa-swarm",
@@ -815,7 +860,8 @@
815
860
  "version": "1.0.0",
816
861
  "profiles": [
817
862
  "perf-and-load"
818
- ]
863
+ ],
864
+ "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."
819
865
  },
820
866
  {
821
867
  "id": "mipro-prompt-compiler",
@@ -826,7 +872,8 @@
826
872
  "version": "1.0.0",
827
873
  "profiles": [
828
874
  "perf-and-load"
829
- ]
875
+ ],
876
+ "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."
830
877
  },
831
878
  {
832
879
  "id": "review-spec",
@@ -837,7 +884,8 @@
837
884
  "version": "1.0.0",
838
885
  "profiles": [
839
886
  "enterprise-rbt"
840
- ]
887
+ ],
888
+ "description": "Stress-test specifications, user stories, and BDD feature files with zero-context rigor. Use when reviewing requirements, user stories, or acceptance criteria before code generation."
841
889
  },
842
890
  {
843
891
  "id": "mobile-appium-som",
@@ -848,7 +896,8 @@
848
896
  "version": "1.0.0",
849
897
  "profiles": [
850
898
  "core-web-qa"
851
- ]
899
+ ],
900
+ "description": "Enterprise Screen Object Model (SOM) and Appium mobile automation standards for iOS and Android. Use when authoring, refactoring, or executing native or hybrid mobile tests with Appium, UIAutomator2, or XCUITest."
852
901
  }
853
902
  ]
854
903
  }
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "$schema": "https://raw.githubusercontent.com/TeeVee98/Synapse-Hub/main/docs/schemas/synapse.config.schema.json",
3
- "version": "3.8.4",
3
+ "version": "3.8.5",
4
4
  "quality_gates": {
5
5
  "mutation_min_score": 80,
6
6
  "gates": {
@@ -53,7 +53,7 @@
53
53
  ```
54
54
  - **Execute 10 Quality Gates Verification:**
55
55
  ```bash
56
- npx synapse-hub verify
56
+ npx @teevee98/synapse-hub verify
57
57
  # or
58
58
  python tools/verify_all.py
59
59
  ```
@@ -90,11 +90,11 @@ To enable instant (<300 tokens) lookups for Test Cases and DOM Locators without
90
90
  - **Test Case Metadata File:**
91
91
  - Standard path: `testcases.json` (or `references/testcases.json`)
92
92
  - Environment variable: `TC_DATA_FILE="references/testcases.json"` in `.env`
93
- - Lookup command: `npx synapse-hub lookup-tc <TC-ID> --file references/testcases.json`
93
+ - Lookup command: `npx @teevee98/synapse-hub lookup-tc <TC-ID> --file references/testcases.json`
94
94
  - **Scraped Selectors & XPath File:**
95
95
  - Standard path: `selectors.json` (or `references/selectors.json`)
96
96
  - Environment variable: `XPATH_DATA_FILE="references/selectors.json"` in `.env`
97
- - Lookup command: `npx synapse-hub lookup-xpath <PageClass> --file references/selectors.json`
97
+ - Lookup command: `npx @teevee98/synapse-hub lookup-xpath <PageClass> --file references/selectors.json`
98
98
 
99
99
  ---
100
100
 
@@ -17,9 +17,9 @@ In accordance with the MIT License, the original copyright notice crediting **Th
17
17
  ---
18
18
 
19
19
  ## ⚡ Quick Commands
20
- - Verify 10 Quality Gates: `npx synapse-hub verify` (or `python tools/verify_all.py`)
21
- - Project Health Audit: `npx synapse-hub analyze` (or `python tools/analyze_project.py`)
22
- - Code Linter & Fake-Pass Sentinel: `npx synapse-hub lint` (or `python tools/infer_linter.py`)
20
+ - Verify 10 Quality Gates: `npx @teevee98/synapse-hub verify` (or `python tools/verify_all.py`)
21
+ - Project Health Audit: `npx @teevee98/synapse-hub analyze` (or `python tools/analyze_project.py`)
22
+ - Code Linter & Fake-Pass Sentinel: `npx @teevee98/synapse-hub lint` (or `python tools/infer_linter.py`)
23
23
  - Verify Author Attribution: `python tools/author_integrity.py`
24
24
  - Skill Security Audit: `python tools/skillspector.py .agents/skills`
25
25
 
@@ -33,13 +33,13 @@ jobs:
33
33
  continue-on-error: true
34
34
  run: |
35
35
  mkdir -p reports
36
- npx synapse-hub lint --json > reports/infer_linter_report.json || true
36
+ npx @teevee98/synapse-hub lint --json > reports/infer_linter_report.json || true
37
37
  cat reports/infer_linter_report.json || true
38
38
 
39
39
  - name: Run 10 Quality Gates DoD Verification
40
40
  id: verify
41
41
  run: |
42
- npx synapse-hub verify
42
+ npx @teevee98/synapse-hub verify
43
43
 
44
44
  - name: Generate GitHub Step Summary
45
45
  if: always()
@@ -10,7 +10,7 @@ synapse-qa-gate:
10
10
  before_script:
11
11
  - apt-get update && apt-get install -y python3 python3-pip
12
12
  script:
13
- - npx synapse-hub verify
13
+ - npx @teevee98/synapse-hub verify
14
14
  rules:
15
15
  - if: $CI_PIPELINE_SOURCE == "merge_request_event"
16
16
  - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
@@ -916,7 +916,7 @@
916
916
  alert(
917
917
  '💡 Để kết nối với máy chủ cục bộ và chạy lệnh thật trên máy tính của bạn:\n\n' +
918
918
  '1. Mở cửa sổ Terminal trong thư mục agent-skills\n' +
919
- '2. Gõ lệnh: npx synapse-hub ui (hoặc: python tools/cli.py ui)\n' +
919
+ '2. Gõ lệnh: npx @teevee98/synapse-hub ui (hoặc: python tools/cli.py ui)\n' +
920
920
  '3. Máy chủ sẽ khởi chạy tại http://127.0.0.1:8080 và tự động kết nối!'
921
921
  );
922
922
  }
@@ -987,7 +987,7 @@
987
987
  } catch (err) {
988
988
  // Fallback to high-fidelity interactive simulation
989
989
  appendConsoleLine(`ℹ️ [SYNAPSE HUB] Máy chủ cục bộ chưa kích hoạt tại ${getApiBaseUrl() || 'http://127.0.0.1:8080'}.`, 'line-warn');
990
- appendConsoleLine(`👉 Để chạy thật: Gõ 'npx synapse-hub ui' trong terminal.`, 'line-info');
990
+ appendConsoleLine(`👉 Để chạy thật: Gõ 'npx @teevee98/synapse-hub ui' trong terminal.`, 'line-info');
991
991
  appendConsoleLine(`⚡ [CHẾ ĐỘ MÔ PHỎNG TƯƠNG TÁC ACTIVE] Đang phát luồng log trực tiếp...\n`, 'line-pass');
992
992
  runSimulation(cmdName);
993
993
  }