@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.
Files changed (133) hide show
  1. package/.agents/rules/git-push-protocol.md +2 -2
  2. package/.agents/skills/01-web-automation/auth-session-and-cookie-manager/SKILL.md +52 -3
  3. package/.agents/skills/01-web-automation/bats-testing-patterns/SKILL.md +55 -5
  4. package/.agents/skills/01-web-automation/clean-pom-crafter/SKILL.md +62 -67
  5. package/.agents/skills/01-web-automation/e2e-testing-patterns/SKILL.md +54 -4
  6. package/.agents/skills/01-web-automation/katalon-cli-runner/SKILL.md +62 -12
  7. package/.agents/skills/01-web-automation/lam-script-generator/SKILL.md +55 -8
  8. package/.agents/skills/01-web-automation/mobile-appium-som/SKILL.md +60 -12
  9. package/.agents/skills/01-web-automation/mobile-appium-som/examples/BaseScreen.java +2 -2
  10. package/.agents/skills/01-web-automation/mobile-appium-som/examples/LoginScreen.java +2 -2
  11. package/.agents/skills/01-web-automation/mobile-appium-som/examples/TC_MobileLogin.java +2 -2
  12. package/.agents/skills/01-web-automation/playwright-live-interaction/SKILL.md +54 -91
  13. package/.agents/skills/01-web-automation/playwright-webapp-testing/SKILL.md +59 -11
  14. package/.agents/skills/01-web-automation/web-agent-gym-benchmarking/SKILL.md +50 -4
  15. package/.agents/skills/02-test-design/architecture-decision-records/SKILL.md +55 -9
  16. package/.agents/skills/02-test-design/gherkin-to-suite/SKILL.md +55 -9
  17. package/.agents/skills/02-test-design/rbt-manual-testing/SKILL.md +55 -8
  18. package/.agents/skills/02-test-design/review-spec/SKILL.md +50 -6
  19. package/.agents/skills/02-test-design/tot-exploratory-testing/SKILL.md +50 -4
  20. package/.agents/skills/03-api-and-contracts/api-network-mocking-interception/SKILL.md +56 -5
  21. package/.agents/skills/03-api-and-contracts/api-spec-to-e2e-matrix/SKILL.md +53 -7
  22. package/.agents/skills/03-api-and-contracts/consumer-driven-contract-testing/SKILL.md +86 -36
  23. package/.agents/skills/04-performance-and-load/backend-load-and-stress-patterns/SKILL.md +54 -6
  24. package/.agents/skills/04-performance-and-load/lean-impact-scoreboard/SKILL.md +50 -6
  25. package/.agents/skills/04-performance-and-load/web-vitals-and-performance-profiler/SKILL.md +50 -3
  26. package/.agents/skills/05-security-and-compliance/security-dast-sentinel/SKILL.md +63 -14
  27. package/.agents/skills/05-security-and-compliance/skillspector-security-guard/SKILL.md +51 -5
  28. package/.agents/skills/05-security-and-compliance/wcag-audit-patterns/SKILL.md +54 -4
  29. package/.agents/skills/06-healing-and-resilience/agentless-qa-repair/SKILL.md +51 -5
  30. package/.agents/skills/06-healing-and-resilience/antigravity-test-sentinel/SKILL.md +53 -6
  31. package/.agents/skills/06-healing-and-resilience/failure-autopsy-and-healing/SKILL.md +54 -8
  32. package/.agents/skills/06-healing-and-resilience/flaky-test-sentinel-and-quarantine/SKILL.md +60 -24
  33. package/.agents/skills/06-healing-and-resilience/self-healing-locator/SKILL.md +52 -6
  34. package/.agents/skills/06-healing-and-resilience/systematic-debugging/SKILL.md +56 -10
  35. package/.agents/skills/06-healing-and-resilience/test-driven-development/SKILL.md +58 -12
  36. package/.agents/skills/06-healing-and-resilience/verification-before-completion/SKILL.md +58 -12
  37. package/.agents/skills/06-healing-and-resilience/visual-regression-sentinel/SKILL.md +53 -5
  38. package/.agents/skills/07-data-and-state/db-state-verifier-and-seeder/SKILL.md +56 -5
  39. package/.agents/skills/07-data-and-state/file-and-report-validator/SKILL.md +53 -4
  40. package/.agents/skills/07-data-and-state/synthetic-test-data-generator/SKILL.md +58 -5
  41. package/.agents/skills/08-code-quality/code-refactoring-refactor-clean/SKILL.md +57 -11
  42. package/.agents/skills/08-code-quality/graphify-impact-analyzer/SKILL.md +83 -34
  43. package/.agents/skills/08-code-quality/graphify-impact-analyzer/examples/dependency_blast_radius.json +3 -4
  44. package/.agents/skills/08-code-quality/lean-code-ladder/SKILL.md +55 -10
  45. package/.agents/skills/08-code-quality/repo-quality-audit/SKILL.md +49 -6
  46. package/.agents/skills/08-code-quality/senior-code-review/SKILL.md +52 -7
  47. package/.agents/skills/08-code-quality/surgical-coding-principles/SKILL.md +55 -10
  48. package/.agents/skills/08-code-quality/technical-debt-harvester/SKILL.md +51 -5
  49. package/.agents/skills/09-ci-and-devops/github-actions-templates/SKILL.md +54 -17
  50. package/.agents/skills/09-ci-and-devops/github-actions-templates/examples/matrix_test_pipeline.yml +2 -1
  51. package/.agents/skills/10-agent-orchestration/actor-qa-swarm/SKILL.md +50 -4
  52. package/.agents/skills/10-agent-orchestration/agent-orchestration-multi-agent-optimize/SKILL.md +53 -7
  53. package/.agents/skills/10-agent-orchestration/event-stream-qa-orchestrator/SKILL.md +50 -4
  54. package/.agents/skills/10-agent-orchestration/persistent-planning-files/SKILL.md +58 -13
  55. package/.agents/skills/10-agent-orchestration/qa-memory-os/SKILL.md +51 -5
  56. package/.agents/skills/11-ai-and-prompting/meta-prompt-crafter/SKILL.md +57 -10
  57. package/.agents/skills/11-ai-and-prompting/mipro-prompt-compiler/SKILL.md +50 -4
  58. package/.agents/skills/11-ai-and-prompting/qa-aci-interface/SKILL.md +50 -4
  59. package/.agents/skills/11-ai-and-prompting/token-and-context-optimizer/SKILL.md +55 -9
  60. package/.cursor/rules/synapse-qa.mdc +20 -7
  61. package/.cursorrules +19 -5
  62. package/.windsurfrules +18 -3
  63. package/AGENTS.md +51 -59
  64. package/CLAUDE.md +38 -24
  65. package/LICENSE +5 -5
  66. package/NOTICE +1 -1
  67. package/README.en.md +4 -4
  68. package/README.md +4 -4
  69. package/agentskills.json +1 -1
  70. package/docs/ARCHITECTURE.en.md +2 -2
  71. package/docs/ARCHITECTURE.md +11 -2
  72. package/docs/CLIENT_SUPPORT_MATRIX.md +44 -0
  73. package/docs/CLI_REFERENCE.en.md +6 -4
  74. package/docs/CLI_REFERENCE.md +1 -1
  75. package/docs/CONTRIBUTING.en.md +1 -1
  76. package/docs/CONTRIBUTING.md +2 -2
  77. package/docs/SIDE_EFFECTING_TOOLS_INVENTORY.md +233 -0
  78. package/docs/TOOL_CATALOG.md +6 -2
  79. package/docs/research/agent_skill_training_analysis.md +1 -1
  80. package/package.json +1 -1
  81. package/plugin.json +1 -1
  82. package/skills_manifest.json +320 -55
  83. package/synapse.config.json +1 -1
  84. package/templates/ai_bridges/CLAUDE.md +29 -26
  85. package/templates/ai_bridges/copilot-instructions.md +14 -5
  86. package/templates/ai_bridges/cursor_synapse_qa.mdc +16 -7
  87. package/templates/ai_bridges/windsurfrules +14 -3
  88. package/templates/ui/index.html +2 -2
  89. package/tools/TOOLS_RUNBOOK.md +1 -1
  90. package/tools/TOOL_CATALOG.json +63 -3
  91. package/tools/__init__.py +1 -1
  92. package/tools/api_fuzzer.py +447 -132
  93. package/tools/author_integrity.py +121 -11
  94. package/tools/benchmark_swarm_context.py +130 -22
  95. package/tools/break_ui_generator.py +233 -0
  96. package/tools/browser_helpers.js +2 -2
  97. package/tools/check_version_sync.py +18 -50
  98. package/tools/cli.py +110 -19
  99. package/tools/core/bm25_retriever.py +218 -0
  100. package/tools/core/i18n.py +5 -5
  101. package/tools/core/provider_usage_adapter.py +383 -0
  102. package/tools/core/token_estimator.py +81 -15
  103. package/tools/count_tokens.py +7 -2
  104. package/tools/coverage_reporter.py +245 -0
  105. package/tools/dashboard_generator.py +8 -8
  106. package/tools/db_sandbox.py +290 -9
  107. package/tools/distill_log.py +1 -1
  108. package/tools/distill_skill.py +206 -0
  109. package/tools/git_pre_commit_guard.py +202 -1
  110. package/tools/humanize_linter.py +3 -0
  111. package/tools/mcp_docx_server.py +1 -1
  112. package/tools/mcp_excel_server.py +1 -1
  113. package/tools/mcp_server.py +104 -16
  114. package/tools/micro_mutator.py +114 -15
  115. package/tools/pentest_scope_guard.py +674 -58
  116. package/tools/perf/benchmark_perf_runner.py +42 -0
  117. package/tools/project_state.py +29 -5
  118. package/tools/reversible_sandbox.py +58 -13
  119. package/tools/rules_router.py +473 -60
  120. package/tools/security_scanner.py +80 -0
  121. package/tools/senior_code_review.py +14 -0
  122. package/tools/skill_canonical_digest.py +302 -0
  123. package/tools/skill_profiles.py +77 -7
  124. package/tools/slide_deck_exporter.py +477 -0
  125. package/tools/sync_agent_rules.py +187 -61
  126. package/tools/sync_skills_manifest.py +166 -0
  127. package/tools/task_memory_manager.py +275 -0
  128. package/tools/ui_server.py +3 -1
  129. package/tools/update_sentinel.py +3 -3
  130. package/tools/validate_host_interop.py +485 -0
  131. package/tools/validate_skills_schema.py +575 -0
  132. package/tools/verify_all.py +668 -44
  133. package/tools/welcome_page.py +2 -2
@@ -1,15 +1,44 @@
1
1
  ---
2
2
  name: surgical-coding-principles
3
3
  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."
4
+ category: architecture_and_analysis
5
+ version: "1.0.0"
6
+ policies:
7
+ network: none
8
+ shell: none
9
+ filesystem: workspace-sandbox
4
10
  ---
5
-
6
11
  # Surgical Coding Principles — Enterprise Minimal-Diff Discipline
7
12
 
13
+ > **Author Attribution & MIT License Guard:** Synapse Hub is open-source software created by **Thế Vị (@TeeVee98)** (<https://github.com/TeeVee98/Synapse-Hub>) under the MIT License.
14
+
15
+ ---
16
+
17
+ ## 1. Trigger & Activation
18
+
19
+ - **Trigger Clause:** 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.
20
+ - **Activation Scope:** Domain workflows for `08-code-quality` involving `surgical-coding-principles`.
21
+
22
+ ---
23
+
24
+ ## 2. Non-Goals & Boundary Constraints
25
+
26
+ - **What NOT to do:**
27
+ - Do NOT perform broad speculative edits across unrelated files.
28
+ - Do NOT reformat untouched lines of code creating noisy diffs.
29
+ - Do NOT modify code without reading the target file and verifying callers first.
30
+ - **Sibling Skill Boundaries:**
31
+ - lean-code-ladder decides what to build; surgical-coding-principles restricts where and how to modify existing files.
32
+
33
+ ---
34
+
35
+ ## 3. Ordered Execution Workflow
36
+
8
37
  Specialized skill for reducing the three classic LLM coding failure modes — silent assumptions, over-engineering, and out-of-scope edits — across Page Classes, test scripts, and `tools/*.py` maintenance.
9
38
 
10
39
  ---
11
40
 
12
- ## 1. The Four Principles
41
+ ### The Four Principles
13
42
 
14
43
  ```mermaid
15
44
  flowchart LR
@@ -20,7 +49,7 @@ flowchart LR
20
49
 
21
50
  **Tradeoff:** these principles bias toward caution over speed. For trivial, single-line fixes, apply judgment and do not ritualize.
22
51
 
23
- ## 2. Principle 1: Think Before Coding
52
+ ### Principle 1: Think Before Coding
24
53
 
25
54
  - **Rule:** Do not assume; do not hide confusion. Before implementing, state assumptions explicitly and ask when uncertain.
26
55
  - **Enforcement:**
@@ -28,13 +57,13 @@ flowchart LR
28
57
  - If a simpler approach exists, say so before writing code; push back when warranted.
29
58
  - If something is unclear, stop, name what is confusing, and ask. Proceeding on a guess converts one clarification into one full rework cycle.
30
59
 
31
- ## 3. Principle 2: Simplicity First
60
+ ### Principle 2: Simplicity First
32
61
 
33
62
  - **Rule:** Write the minimum code that solves the stated problem. Nothing speculative.
34
63
  - **Forbidden:** features beyond what was asked; abstractions for single-use code; "flexibility" or configurability that was not requested; error handling for impossible scenarios.
35
64
  - **Self-test:** if 200 lines were written and 50 would do, rewrite. Ask: "Would a senior engineer call this overcomplicated?" If yes, simplify before continuing.
36
65
 
37
- ## 4. Principle 3: Surgical Changes
66
+ ### Principle 3: Surgical Changes
38
67
 
39
68
  - **Rule:** Touch only what the request requires. Clean up only the mess your own change created.
40
69
  - **When editing existing code (Page Classes, test scripts, hub tools):**
@@ -44,7 +73,7 @@ flowchart LR
44
73
  - **Orphan rule:** remove imports, variables, or functions that YOUR change made unused; leave pre-existing dead code untouched unless asked.
45
74
  - **The test:** every changed line must trace directly to the user's request.
46
75
 
47
- ## 5. Principle 4: Goal-Driven Execution
76
+ ### Principle 4: Goal-Driven Execution
48
77
 
49
78
  - **Rule:** Transform every task into a verifiable goal with explicit success criteria, then loop until verified.
50
79
  - **Rewrites:** "add validation" becomes "write tests for invalid inputs, then make them pass"; "fix the bug" becomes "write a test that reproduces it, then make it pass" (pair with `test-driven-development`).
@@ -58,7 +87,7 @@ flowchart LR
58
87
 
59
88
  Strong success criteria allow independent looping; weak criteria ("make it work") force constant clarification.
60
89
 
61
- ## 6. Pre-Diff Self-Check
90
+ ### Pre-Diff Self-Check
62
91
 
63
92
  Before handing back any change, verify all boxes:
64
93
 
@@ -70,7 +99,7 @@ Before handing back any change, verify all boxes:
70
99
 
71
100
  These principles are working if diffs shrink, rewrites due to overcomplication disappear, and clarifying questions arrive before implementation instead of after mistakes.
72
101
 
73
- ## 7. Boundary vs Sibling Skills (Do Not Confuse)
102
+ ### Boundary vs Sibling Skills (Do Not Confuse)
74
103
 
75
104
  | Sibling | Owns | Hand-off |
76
105
  |---|---|---|
@@ -78,12 +107,28 @@ These principles are working if diffs shrink, rewrites due to overcomplication d
78
107
  | `code-refactoring-refactor-clean` | Deliberate debt-elimination refactors | A refactor task still obeys surgical scope: diff lines trace to the refactor request |
79
108
  | `lean-code-ladder` | The 7-rung reuse-first decision ladder | Use the ladder to choose the solution; use this skill to keep the diff disciplined |
80
109
 
81
- ## 8. Reference Documentation
110
+ ### Reference Documentation
82
111
 
83
112
  - `python3 tools/verify_all.py --mode hub` — 10 Quality Gates as the verification anchor for Goal-Driven Execution.
84
113
  - `python3 tools/test_impact.py --git-diff` — scope the blast radius of a change before editing.
85
114
  - `python3 tools/infer_linter.py` — confirm no fake-pass assertions were introduced by the change.
86
115
 
87
- ## 9. Attribution
116
+ ### Attribution
88
117
 
89
118
  Adapted from **andrej-karpathy-skills** (https://github.com/multica-ai/andrej-karpathy-skills) — MIT License (declared in repository `plugin.json`), by forrestchang, derived from Andrej Karpathy's published observations on LLM coding pitfalls. Principles re-scoped for enterprise QA automation in Synapse Hub; wording, structure, and examples modified.
119
+
120
+ ---
121
+
122
+ ## 4. Verification Points & DoD
123
+
124
+ 1. Shortest working diff that achieves the requirement.
125
+ 2. Existing comments, docstrings, and unrelated logic preserved intact.
126
+ 3. Callers of modified functions verified to prevent regression.
127
+
128
+ ---
129
+
130
+ ## 5. Handoff Protocol
131
+
132
+ - **Deliverables:** Minimal surgical patch diff and caller impact verification report.
133
+ - **Next Subagent:** pom-crafter
134
+ - **Output Format:** Clean POM code, structured JSON telemetry, or validated markdown handoff.
@@ -3,18 +3,46 @@ name: technical-debt-harvester
3
3
  description: "Harvest shortcut: comments into a tracked technical debt ledger. Use when auditing code compromises, tracking deferred refactorings, or scanning for shortcut markers."
4
4
  category: architecture_and_analysis
5
5
  version: "1.0.0"
6
+ policies:
7
+ network: none
8
+ shell: read-only
9
+ filesystem: read-only
6
10
  ---
7
-
8
11
  # Technical Debt Harvester — Pragmatic Shortcut & Deferral Tracker
9
12
 
13
+ > **Author Attribution & MIT License Guard:** Synapse Hub is open-source software created by **Thế Vị (@TeeVee98)** (<https://github.com/TeeVee98/Synapse-Hub>) under the MIT License.
14
+
15
+ ---
16
+
17
+ ## 1. Trigger & Activation
18
+
19
+ - **Trigger Clause:** Harvest shortcut: comments into a tracked technical debt ledger. Use when auditing code compromises, tracking deferred refactorings, or scanning for shortcut markers.
20
+ - **Activation Scope:** Domain workflows for `08-code-quality` involving `technical-debt-harvester`.
21
+
22
+ ---
23
+
24
+ ## 2. Non-Goals & Boundary Constraints
25
+
26
+ - **What NOT to do:**
27
+ - Do NOT hide or disguise technical shortcuts; mark every deliberate simplification explicitly.
28
+ - Do NOT leave shortcut comments without stating the operational limit and upgrade trigger.
29
+ - Do NOT alter code behavior when harvesting or indexing debt markers.
30
+ - **Sibling Skill Boundaries:**
31
+ - lean-code-ladder allows pragmatic shortcuts; technical-debt-harvester tracks, catalogs, and schedules debt retirement.
32
+
33
+ ---
34
+
35
+ ## 3. Ordered Execution Workflow
36
+
10
37
  Harvest deliberate shortcut comments (`shortcut: <limit>, <when to upgrade>`) across the entire repository into a structured Markdown ledger so pragmatic compromises do not silently rot into permanent defects.
11
38
 
12
39
  ---
13
40
 
14
- ## 1. The Shortcut Comment Standard
41
+ ### The Shortcut Comment Standard
15
42
 
16
43
  When writing lean code or taking a pragmatic shortcut under time or scope constraints, leave an inline comment specifying the **ceiling (limit)** and the **upgrade trigger**:
17
44
 
45
+ <!-- classification: illustrative -->
18
46
  ```python
19
47
  # Format:
20
48
  # shortcut: <the limit>, <when to upgrade>
@@ -28,7 +56,7 @@ Any shortcut comment that omits an upgrade trigger is classified as `no-trigger`
28
56
 
29
57
  ---
30
58
 
31
- ## 2. Supported Comment Syntaxes
59
+ ### Supported Comment Syntaxes
32
60
 
33
61
  The harvester automatically detects markers across all common language comment styles:
34
62
  - `# shortcut:` (Python, Bash, Ruby, YAML)
@@ -41,8 +69,9 @@ The harvester automatically detects markers across all common language comment s
41
69
 
42
70
  ---
43
71
 
44
- ## 3. Automation CLI
72
+ ### Automation CLI
45
73
 
74
+ <!-- classification: illustrative -->
46
75
  ```bash
47
76
  # Scan working directory and display ledger
48
77
  python3 tools/debt_harvester.py
@@ -58,6 +87,7 @@ python3 tools/debt_harvester.py --keyword "DEBT:"
58
87
  ```
59
88
 
60
89
  Or via the unified CLI:
90
+ <!-- classification: illustrative -->
61
91
  ```bash
62
92
  agent-qa debt
63
93
  agent-qa debt --output DEBT_LEDGER.md
@@ -65,6 +95,22 @@ agent-qa debt --output DEBT_LEDGER.md
65
95
 
66
96
  ---
67
97
 
68
- ## 4. Attribution
98
+ ### Attribution
69
99
 
70
100
  Adapted from **ponytail-debt** (https://github.com/DietrichGebert/ponytail) — MIT License, Copyright (c) 2026 DietrichGebert. Re-architected with native Python tooling for Synapse Hub.
101
+
102
+ ---
103
+
104
+ ## 4. Verification Points & DoD
105
+
106
+ 1. All deliberate simplifications adhere to `shortcut: <the limit>, <when to upgrade>` syntax.
107
+ 2. Automated debt scan parses all active shortcuts across the repository.
108
+ 3. Debt ledger prioritizes items by operational risk and upgrade urgency.
109
+
110
+ ---
111
+
112
+ ## 5. Handoff Protocol
113
+
114
+ - **Deliverables:** Technical debt inventory report, shortcut registry ledger, and retirement roadmap.
115
+ - **Next Subagent:** quality-gatekeeper
116
+ - **Output Format:** Clean POM code, structured JSON telemetry, or validated markdown handoff.
@@ -1,28 +1,50 @@
1
1
  ---
2
2
  name: github-actions-templates
3
3
  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."
4
+ category: architecture_and_analysis
5
+ version: "2.0.0"
6
+ policies:
7
+ network: none
8
+ shell: none
9
+ filesystem: workspace-sandbox
4
10
  ---
5
-
6
11
  # GitHub Actions CI/CD Patterns for Test Automation
7
12
 
8
- > **Target:** Author secure, performant, and matrix-sharded GitHub Actions workflows for automated test execution, quality gate validation, and Allure reporting.
13
+ > **Author Attribution & MIT License Guard:** Synapse Hub is open-source software created by **Thế Vị (@TeeVee98)** (<https://github.com/TeeVee98/Synapse-Hub>) under the MIT License.
14
+
15
+ ---
16
+
17
+ ## 1. Trigger & Activation
18
+
19
+ - **Trigger Clause:** Use when configuring continuous integration pipelines, setting up multi-OS and multi-version test execution matrices, wiring quality gates into GitHub Actions, or generating automated test report artifacts.
20
+ - **Activation Scope:**
21
+ - Automated test suites (Playwright, Pytest, Katalon, Newman).
22
+ - Parallel matrix sharding across runners and execution stages.
23
+ - Quality Gate Definition of Done (DoD) verification.
9
24
 
10
25
  ---
11
26
 
12
- ## 1. When to Use
27
+ ## 2. Non-Goals & Boundary Constraints
13
28
 
14
- - Configuring continuous integration pipelines for Playwright, Katalon, Pytest, or Newman.
15
- - Setting up multi-OS and multi-version test execution matrices.
16
- - Integrating automated Quality Gate DoD (`tools/verify_all.py`).
17
- - Generating and publishing automated test report artifacts.
29
+ - **What NOT to do:**
30
+ - Do NOT use unpinned mutable tags (`@v4`, `@main`) for third-party actions; always pin to immutable 40-character commit SHAs.
31
+ - Do NOT hardcode credentials or tokens in workflow files; inject secrets exclusively through repository secrets (`${{ secrets.TEST_TOKEN }}`).
32
+ - Do NOT retain video and trace artifacts indefinitely; cap retention between 7 and 14 days.
33
+ - **Sibling Skill Boundaries:**
34
+ - `verification-before-completion`: Enforces DoD evidence collection prior to declaring task completion.
35
+ - `github-actions-templates` (this skill): Provides workflow blueprints, matrix sharding, and supply-chain-secure pipeline definitions.
18
36
 
19
37
  ---
20
38
 
21
- ## 2. Standard Enterprise Test Workflow Template
39
+ ## 3. Ordered Execution Workflow
40
+
41
+ ### Phase 1: Workflow Configuration & Matrix Architecture
22
42
 
23
- Create in `.github/workflows/e2e_tests.yml`:
43
+ Author or update the CI/CD pipeline template (see reference `examples/matrix_test_pipeline.yml`).
24
44
 
45
+ <!-- classification: illustrative -->
25
46
  ```yaml
47
+ # Supply chain security: Pin actions to immutable full 40-character commit SHAs to mitigate tag hijacking and malicious upstream mutation risks.
26
48
  name: Enterprise Automated E2E Test Suite
27
49
 
28
50
  on:
@@ -41,10 +63,10 @@ jobs:
41
63
 
42
64
  steps:
43
65
  - name: Checkout Code
44
- uses: actions/checkout@v4
66
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
45
67
 
46
68
  - name: Setup Node.js
47
- uses: actions/setup-node@v4
69
+ uses: actions/setup-node@1d0ff469b7ec7b3cb9d8673fde0c81c44821de2a # v4.2.0
48
70
  with:
49
71
  node-version: 20
50
72
  cache: 'npm'
@@ -60,18 +82,33 @@ jobs:
60
82
 
61
83
  - name: Upload Test Report & Screenshots
62
84
  if: always()
63
- uses: actions/upload-artifact@v4
85
+ uses: actions/upload-artifact@b4b15b8c7c6ac21ea08fcf65892d2ee8f75cf882 # v4.4.3
64
86
  with:
65
87
  name: playwright-report-shard-${{ strategy.job-index }}
66
88
  path: playwright-report/
67
89
  retention-days: 14
68
90
  ```
69
91
 
92
+ ### Phase 2: Security & Supply Chain Invariants
93
+
94
+ 1. **Dependency Pinning:** Pin all third-party GitHub Actions to 40-character commit SHAs with version comments to protect against compromised release tags.
95
+ 2. **Secret Masking:** Never echo secrets into workflow steps; pass them as environment variables mapped from GitHub Secrets.
96
+ 3. **Concurrency Governance:** Cancel stale runs on pull request updates:
97
+ `concurrency: { group: ${{ github.workflow }}-${{ github.ref }}, cancel-in-progress: true }`.
98
+
99
+ ---
100
+
101
+ ## 4. Verification Points & DoD
102
+
103
+ 1. **Syntax Validation:** Workflow passes YAML linting and GitHub Actions schema checks.
104
+ 2. **Commit SHA Pinning:** All `uses:` directives reference 40-character commit hashes with supply chain risk disclosures.
105
+ 3. **Secret Protection:** 0 exposed secrets in step definitions, run scripts, or job logs.
106
+ 4. **Execution Verification:** Pipeline successfully executes test matrix and uploads artifacts upon completion.
107
+
70
108
  ---
71
109
 
72
- ## 3. Best Practices & Security Invariants
110
+ ## 5. Handoff Protocol
73
111
 
74
- 1. **Dependency Pinning:** Always pin third-party actions to full commit SHAs or major versions (`actions/checkout@v4`).
75
- 2. **Secret Masking:** Never hardcode credentials in workflow files; inject via `secrets.TEST_USER` and `secrets.TEST_PASS`.
76
- 3. **Artifact Retention:** Cap test video and screenshot artifacts to 7-14 days to prevent storage bloat.
77
- 4. **Concurrency Governance:** Cancel outdated in-flight runs on new PR commits using `concurrency: { group: ${{ github.ref }}, cancel-in-progress: true }`.
112
+ - **Deliverables:** Production-ready `.github/workflows/*.yml` workflow definitions and example templates in `examples/`.
113
+ - **Next Subagent:** Pass to `test-runner` for local execution or `quality-gatekeeper` for CI/CD integration acceptance.
114
+ - **Output Format:** Valid GitHub Actions YAML syntax adhering to enterprise security baselines.
@@ -1,8 +1,9 @@
1
+ # Supply chain security: Pin actions to immutable full 40-character commit SHAs to mitigate tag hijacking and malicious upstream mutation risks.
1
2
  name: Automated E2E Matrix
2
3
  on: [push, pull_request]
3
4
  jobs:
4
5
  test:
5
6
  runs-on: ubuntu-latest
6
7
  steps:
7
- - uses: actions/checkout@v4
8
+ - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
8
9
  - run: npx playwright test
@@ -1,16 +1,45 @@
1
1
  ---
2
2
  name: actor-qa-swarm
3
3
  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."
4
+ category: context_and_optimization
5
+ version: "1.0.0"
6
+ policies:
7
+ network: none
8
+ shell: workspace-sandbox
9
+ filesystem: workspace-sandbox
4
10
  ---
5
-
6
11
  # Actor QA Swarm Skill — Asynchronous Actor Messaging & Matrix Sharding
7
12
 
13
+ > **Author Attribution & MIT License Guard:** Synapse Hub is open-source software created by **Thế Vị (@TeeVee98)** (<https://github.com/TeeVee98/Synapse-Hub>) under the MIT License.
14
+
15
+ ---
16
+
17
+ ## 1. Trigger & Activation
18
+
19
+ - **Trigger Clause:** 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.
20
+ - **Activation Scope:** Domain workflows for `10-agent-orchestration` involving `actor-qa-swarm`.
21
+
22
+ ---
23
+
24
+ ## 2. Non-Goals & Boundary Constraints
25
+
26
+ - **What NOT to do:**
27
+ - Do NOT allow subagents to share mutable global state; communicate via isolated message passing.
28
+ - Do NOT spawn unbounded subagent hierarchies that exceed token and resource ceilings.
29
+ - Do NOT allow subagents to stall on trivial decisions (follow Jesse Vincent Protocol).
30
+ - **Sibling Skill Boundaries:**
31
+ - agent-orchestration-multi-agent-optimize schedules work; actor-qa-swarm provides the Actor Model execution harness for concurrent subagents.
32
+
33
+ ---
34
+
35
+ ## 3. Ordered Execution Workflow
36
+
8
37
  > **Paradigm Attribution:** Inspired by **Microsoft AutoGen v0.4+ (AG2 Actor Framework)**.
9
38
  > **Core Principle:** Transition from synchronous lock-step file coordination to an asynchronous Actor Model. Subagents exchange messages via non-blocking mailboxes and subscribe to test failure events in real time.
10
39
 
11
40
  ---
12
41
 
13
- ## 1. The Actor Swarm Architecture
42
+ ### The Actor Swarm Architecture
14
43
 
15
44
  ```mermaid
16
45
  flowchart TD
@@ -37,10 +66,11 @@ flowchart TD
37
66
 
38
67
  ---
39
68
 
40
- ## 2. CLI Tool Usage
69
+ ### CLI Tool Usage
41
70
 
42
71
  Autonomous commands via `tools/autogen_qa_broker.py`:
43
72
 
73
+ <!-- classification: illustrative -->
44
74
  ```bash
45
75
  # 1. Dispatch regression suite across 4 parallel shards
46
76
  python tools/autogen_qa_broker.py dispatch-shards \
@@ -70,8 +100,24 @@ python tools/autogen_qa_broker.py check-health
70
100
 
71
101
  ---
72
102
 
73
- ## 3. Strict Operating Invariants
103
+ ### Strict Operating Invariants
74
104
 
75
105
  - **Deadlock Prevention:** Enforce 300s timeout ceilings on actor response waits.
76
106
  - **Asynchronous Execution:** No subagent shall block the main thread waiting for another subagent's response.
77
107
  - **Zero Raw Selectors:** Messages instructing code synthesis must strictly enforce Clean POM standards.
108
+
109
+ ---
110
+
111
+ ## 4. Verification Points & DoD
112
+
113
+ 1. Subagents maintain isolated state directories and strictly bounded role assignments.
114
+ 2. Messages between agents follow structured context, content, and action contracts.
115
+ 3. Execution finishes within allocated token budget and concurrency limits.
116
+
117
+ ---
118
+
119
+ ## 5. Handoff Protocol
120
+
121
+ - **Deliverables:** Swarm execution traces, subagent state records, and aggregated task deliverables.
122
+ - **Next Subagent:** orchestrator
123
+ - **Output Format:** Clean POM code, structured JSON telemetry, or validated markdown handoff.
@@ -1,15 +1,44 @@
1
1
  ---
2
2
  name: agent-orchestration-multi-agent-optimize
3
3
  description: "Profile, benchmark, and orchestrate multi-agent test workloads and token throughput. Use when orchestrating multi-agent swarms, partitioning workloads, or optimizing agent roles."
4
+ category: context_and_optimization
5
+ version: "2.0.0"
6
+ policies:
7
+ network: none
8
+ shell: none
9
+ filesystem: read-only
4
10
  ---
5
-
6
11
  # Multi-Agent Optimization & Orchestration Skill
7
12
 
13
+ > **Author Attribution & MIT License Guard:** Synapse Hub is open-source software created by **Thế Vị (@TeeVee98)** (<https://github.com/TeeVee98/Synapse-Hub>) under the MIT License.
14
+
15
+ ---
16
+
17
+ ## 1. Trigger & Activation
18
+
19
+ - **Trigger Clause:** Profile, benchmark, and orchestrate multi-agent test workloads and token throughput. Use when orchestrating multi-agent swarms, partitioning workloads, or optimizing agent roles.
20
+ - **Activation Scope:** Domain workflows for `10-agent-orchestration` involving `agent-orchestration-multi-agent-optimize`.
21
+
22
+ ---
23
+
24
+ ## 2. Non-Goals & Boundary Constraints
25
+
26
+ - **What NOT to do:**
27
+ - Do NOT dispatch tasks to subagents with incomplete or ambiguous task briefings.
28
+ - Do NOT spawn parallel subagents for sequential dependent tasks.
29
+ - Do NOT omit timeout and failure recovery handlers for worker agents.
30
+ - **Sibling Skill Boundaries:**
31
+ - actor-qa-swarm provides actor primitives; agent-orchestration-multi-agent-optimize plans and coordinates multi-agent workload sharding.
32
+
33
+ ---
34
+
35
+ ## 3. Ordered Execution Workflow
36
+
8
37
  > **Target:** Optimize multi-agent test workloads, reduce context overhead, streamline agent handoffs, and monitor token consumption across autonomous test swarms.
9
38
 
10
39
  ---
11
40
 
12
- ## 1. When to Use
41
+ ### When to Use
13
42
 
14
43
  - Managing multi-agent coordination, test suite sharding, and throughput.
15
44
  - Profiling sub-agent task decomposition to eliminate redundant execution.
@@ -18,7 +47,7 @@ description: "Profile, benchmark, and orchestrate multi-agent test workloads and
18
47
 
19
48
  ---
20
49
 
21
- ## 2. Core Orchestration Principles
50
+ ### Core Orchestration Principles
22
51
 
23
52
  1. **Single Front-Door Protocol:**
24
53
  - All inbound tasks route through `orchestrator` to prevent split-brain execution.
@@ -32,8 +61,9 @@ description: "Profile, benchmark, and orchestrate multi-agent test workloads and
32
61
 
33
62
  ---
34
63
 
35
- ## 3. Workload Sharding & Matrix Execution
64
+ ### Workload Sharding & Matrix Execution
36
65
 
66
+ <!-- classification: illustrative -->
37
67
  ```python
38
68
  # Multi-agent workload partition example
39
69
  def shard_test_workload(suite_files: list, max_agents: int = 4) -> list:
@@ -46,7 +76,7 @@ def shard_test_workload(suite_files: list, max_agents: int = 4) -> list:
46
76
 
47
77
  ---
48
78
 
49
- ## 4. Token & Latency Governance
79
+ ### Token & Latency Governance
50
80
 
51
81
  | Optimization Layer | Baseline (Naive) | Optimized (Synapse Swarm) | Savings |
52
82
  | :--- | :--- | :--- | :--- |
@@ -57,7 +87,7 @@ def shard_test_workload(suite_files: list, max_agents: int = 4) -> list:
57
87
 
58
88
  ---
59
89
 
60
- ## 5. Verification & Safety Guidelines
90
+ ### Verification & Safety Guidelines
61
91
 
62
92
  - Always establish baseline metrics before applying workflow changes.
63
93
  - Ensure subagent dynamic test data uses unique runtime IDs (`AUTO_<timestamp>_<agentId>`).
@@ -65,7 +95,7 @@ def shard_test_workload(suite_files: list, max_agents: int = 4) -> list:
65
95
 
66
96
  ---
67
97
 
68
- ## 6. Hierarchical Process & Manager Delegation
98
+ ### Hierarchical Process & Manager Delegation
69
99
 
70
100
  > *Borrowed and adapted from the crewAI hierarchical process model (MIT license, crewAIInc/crewAI).*
71
101
 
@@ -86,3 +116,19 @@ The hub's default is a flat swarm with the `orchestrator` as single front-door
86
116
  4. **Escalate structure, not authority** — the hierarchy speeds coordination;
87
117
  Truth Anchor, safety firewall and quality gates apply identically at every
88
118
  level. Delegation never bypasses a gate.
119
+
120
+ ---
121
+
122
+ ## 4. Verification Points & DoD
123
+
124
+ 1. Task decomposed into independent, parallelizable sub-milestones.
125
+ 2. Subagent dispatch briefings are 100% self-contained (`BRIEFING.md` format).
126
+ 3. Consolidated outputs verified against definition of done before milestone completion.
127
+
128
+ ---
129
+
130
+ ## 5. Handoff Protocol
131
+
132
+ - **Deliverables:** Milestone orchestration plan, dispatch records, and consolidated verification summary.
133
+ - **Next Subagent:** orchestrator
134
+ - **Output Format:** Clean POM code, structured JSON telemetry, or validated markdown handoff.
@@ -1,16 +1,45 @@
1
1
  ---
2
2
  name: event-stream-qa-orchestrator
3
3
  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."
4
+ category: context_and_optimization
5
+ version: "1.0.0"
6
+ policies:
7
+ network: localhost-only
8
+ shell: workspace-sandbox
9
+ filesystem: workspace-sandbox
4
10
  ---
5
-
6
11
  # QA Event Stream Orchestrator Skill — Immutable Audit & Replay Timeline
7
12
 
13
+ > **Author Attribution & MIT License Guard:** Synapse Hub is open-source software created by **Thế Vị (@TeeVee98)** (<https://github.com/TeeVee98/Synapse-Hub>) under the MIT License.
14
+
15
+ ---
16
+
17
+ ## 1. Trigger & Activation
18
+
19
+ - **Trigger Clause:** 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.
20
+ - **Activation Scope:** Domain workflows for `10-agent-orchestration` involving `event-stream-qa-orchestrator`.
21
+
22
+ ---
23
+
24
+ ## 2. Non-Goals & Boundary Constraints
25
+
26
+ - **What NOT to do:**
27
+ - Do NOT poll in tight synchronous loops when waiting for asynchronous background tasks.
28
+ - Do NOT drop or miss event notifications in the event stream pipeline.
29
+ - Do NOT process event payloads without schema and boundary validation.
30
+ - **Sibling Skill Boundaries:**
31
+ - actor-qa-swarm coordinates actor agents; event-stream-qa-orchestrator processes asynchronous event streams and reactive test pipelines.
32
+
33
+ ---
34
+
35
+ ## 3. Ordered Execution Workflow
36
+
8
37
  > **Paradigm Attribution:** Inspired by **All-Hands-AI OpenHands (EventStream & CodeAct Runtime)**.
9
38
  > **Core Principle:** Treat automated testing sessions as an append-only, immutable stream of events. Prevent state corruption and lost context by chaining each event with cryptographic SHA-256 hashes and enabling deterministic check-pointed rollbacks.
10
39
 
11
40
  ---
12
41
 
13
- ## 1. The EventStream Pipeline
42
+ ### The EventStream Pipeline
14
43
 
15
44
  ```mermaid
16
45
  flowchart LR
@@ -35,10 +64,11 @@ flowchart LR
35
64
 
36
65
  ---
37
66
 
38
- ## 2. CLI Tool Usage
67
+ ### CLI Tool Usage
39
68
 
40
69
  Autonomous commands via `tools/qa_event_stream.py`:
41
70
 
71
+ <!-- classification: illustrative -->
42
72
  ```bash
43
73
  # 1. Initialize stream
44
74
  python tools/qa_event_stream.py init-stream \
@@ -72,8 +102,24 @@ python tools/qa_event_stream.py rollback \
72
102
 
73
103
  ---
74
104
 
75
- ## 3. Strict Operating Invariants
105
+ ### Strict Operating Invariants
76
106
 
77
107
  - **Hash Chain Integrity:** All events must compute `SHA-256(prev_hash | session_id | event_type | actor | payload | timestamp)`.
78
108
  - **Zero Log Tampering:** Never edit `timeline.jsonl` lines manually; always append via the CLI tool.
79
109
  - **UTF-8 No BOM:** Timeline files must remain clean UTF-8 without byte-order marks.
110
+
111
+ ---
112
+
113
+ ## 4. Verification Points & DoD
114
+
115
+ 1. Event stream pipeline handles test execution events asynchronously.
116
+ 2. Task status and heartbeat updates recorded via reactive event subscriptions.
117
+ 3. Zero zombie or hanging background worker tasks.
118
+
119
+ ---
120
+
121
+ ## 5. Handoff Protocol
122
+
123
+ - **Deliverables:** Event pipeline logs, reactive execution traces, and stream processing telemetry.
124
+ - **Next Subagent:** orchestrator
125
+ - **Output Format:** Clean POM code, structured JSON telemetry, or validated markdown handoff.