@teevee98/synapse-hub 4.4.0 → 4.4.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 (276) hide show
  1. package/.cursor/rules/agents.mdc +11 -11
  2. package/.cursor/rules/katalon.mdc +11 -0
  3. package/.cursor/rules/perf.mdc +10 -0
  4. package/.cursor/rules/playwright.mdc +10 -0
  5. package/.cursor/rules/pytest.mdc +10 -0
  6. package/.cursor/rules/synapse-qa.mdc +4 -2
  7. package/.cursorrules +3 -10
  8. package/.windsurfrules +3 -10
  9. package/AGENTS.md +4 -3
  10. package/CLAUDE.md +4 -5
  11. package/README.en.md +3 -3
  12. package/README.md +3 -3
  13. package/agentskills.json +15 -15
  14. package/{.agents/agents → ai-agents/personas}/api-engineer.md +2 -2
  15. package/{.agents/agents → ai-agents/personas}/failure-analyst.md +1 -1
  16. package/{.agents/agents → ai-agents/personas}/live-explorer.md +1 -1
  17. package/{.agents/agents → ai-agents/personas}/orchestrator.md +8 -15
  18. package/{.agents/agents → ai-agents/personas}/perf-engineer.md +1 -3
  19. package/{.agents/agents → ai-agents/personas}/pom-crafter.md +3 -9
  20. package/{.agents/agents → ai-agents/personas}/quality-gatekeeper.md +1 -1
  21. package/{.agents/agents → ai-agents/personas}/test-designer.md +2 -1
  22. package/{.agents/agents → ai-agents/personas}/test-runner.md +3 -4
  23. package/{.agents/rules → automation/playwright}/mandatory-playwright-live.md +5 -13
  24. package/{.agents/skills/01-web-automation → automation/playwright}/playwright-webapp-testing/SKILL.md +2 -0
  25. package/{.agents/skills/01-web-automation → automation/shared-utils}/clean-pom-crafter/SKILL.md +8 -0
  26. package/{.agents/skills/01-web-automation → automation/shared-utils}/e2e-testing-patterns/SKILL.md +9 -0
  27. package/{.agents/skills/01-web-automation → automation/shared-utils}/lam-script-generator/SKILL.md +2 -0
  28. package/docs/ARCHITECTURE.en.md +2 -2
  29. package/docs/ARCHITECTURE.md +2 -2
  30. package/docs/TOOL_CATALOG.md +8 -5
  31. package/docs/reports/AUDIT_REPORT.md +1038 -0
  32. package/docs/reports/PROJECT_HEALTH_REPORT.md +49 -0
  33. package/docs/reports/TECHNICAL_DEBT_LEDGER.md +22 -0
  34. package/package.json +8 -1
  35. package/plugin.json +1 -1
  36. package/{.agents/skills/02-test-design → requirement/spec-review}/review-spec/SKILL.md +8 -0
  37. package/scripts/install_global_plugin.ps1 +1 -1
  38. package/scripts/install_global_plugin.sh +1 -1
  39. package/skills_index.json +61 -0
  40. package/skills_manifest.json +88 -62
  41. package/{.agents/skills/08-code-quality → standards/coding-standards}/lean-code-ladder/SKILL.md +8 -1
  42. package/{.agents/skills/08-code-quality → standards/coding-standards}/surgical-coding-principles/SKILL.md +2 -0
  43. package/synapse.config.json +1 -1
  44. package/templates/ai_bridges/CLAUDE.md +4 -5
  45. package/templates/ai_bridges/copilot-instructions.md +1 -0
  46. package/templates/ai_bridges/cursor_synapse_qa.mdc +4 -2
  47. package/templates/ai_bridges/windsurfrules +3 -10
  48. package/testing/api-contracts/api_testing_rules.md +74 -0
  49. package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/agentless-qa-repair/SKILL.md +2 -0
  50. package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/SKILL.md +5 -11
  51. package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/self-healing-locator/SKILL.md +2 -0
  52. package/testing/manual/manual-qa-and-rtm-bridge/SKILL.md +92 -0
  53. package/testing/manual/manual-qa-and-rtm-bridge/examples/sample_bug_and_rtm.json +38 -0
  54. package/{.agents/skills/04-performance-and-load → testing/performance}/backend-load-and-stress-patterns/SKILL.md +1 -1
  55. package/{.agents/rules → testing/performance}/performance_testing_rules.md +23 -0
  56. package/{.agents/rules → testing/security-a11y}/security_testing_rules.md +19 -0
  57. package/tools/TOOLS_RUNBOOK.md +9 -4
  58. package/tools/TOOL_CATALOG.json +75 -30
  59. package/tools/TOOL_INDEX.json +160 -0
  60. package/tools/__init__.py +1 -1
  61. package/tools/assertion_optimizer.py +188 -0
  62. package/tools/author_integrity.py +12 -1
  63. package/tools/benchmark_swarm_context.py +1 -1
  64. package/tools/browser_helpers.js +2 -2
  65. package/tools/catalogs/api_contract_testing.json +107 -0
  66. package/tools/catalogs/auxiliary_utilities.json +1536 -0
  67. package/tools/catalogs/benchmarking.json +23 -0
  68. package/tools/catalogs/ci_cd_packaging.json +46 -0
  69. package/tools/catalogs/code_generation_ast.json +70 -0
  70. package/tools/catalogs/failure_autopsy_healing.json +41 -0
  71. package/tools/catalogs/manual_testing_design.json +80 -0
  72. package/tools/catalogs/orchestration.json +25 -0
  73. package/tools/catalogs/performance_testing.json +71 -0
  74. package/tools/catalogs/quality_gates.json +65 -0
  75. package/tools/catalogs/sandboxing_isolation.json +42 -0
  76. package/tools/catalogs/security.json +72 -0
  77. package/tools/catalogs/setup_onboarding.json +26 -0
  78. package/tools/catalogs/testing_utilities.json +111 -0
  79. package/tools/check_env.py +16 -3
  80. package/tools/check_version_sync.py +114 -63
  81. package/tools/cldr_l10n_verifier.py +1 -1
  82. package/tools/cli.py +787 -3
  83. package/tools/core/circuit_breaker.py +106 -0
  84. package/tools/core/token_estimator.py +56 -7
  85. package/tools/dashboard_generator.py +10 -10
  86. package/tools/generate_tool_catalog.py +60 -2
  87. package/tools/mcp_docx_server.py +1 -1
  88. package/tools/mcp_excel_server.py +1 -1
  89. package/tools/mcp_server.py +5 -1
  90. package/tools/pre_push_guard.py +1 -1
  91. package/tools/project_state.py +17 -10
  92. package/tools/reversible_sandbox.py +7 -2
  93. package/tools/rules_router.py +5 -3
  94. package/tools/runaway_stopper.py +19 -111
  95. package/tools/setup_project.py +1 -1
  96. package/tools/skill_canonical_digest.py +2 -2
  97. package/tools/skillspector.py +78 -10
  98. package/tools/sync_agent_rules.py +15 -27
  99. package/tools/sync_skills_manifest.py +38 -4
  100. package/tools/tmmi_auditor.py +8 -1
  101. package/tools/ui_server.py +1 -1
  102. package/tools/update_sentinel.py +4 -4
  103. package/tools/validate_host_interop.py +3 -1
  104. package/tools/validate_skills_schema.py +49 -2
  105. package/tools/welcome_page.py +4 -4
  106. package/.agents/rules/stack-auto-router.md +0 -30
  107. package/.agents/skills/09-ci-and-devops/github-actions-templates/SKILL.md +0 -114
  108. package/.agents/skills/09-ci-and-devops/github-actions-templates/examples/matrix_test_pipeline.yml +0 -9
  109. package/.agents/skills/09-ci-and-devops/gitlab-ci-templates/SKILL.md +0 -123
  110. package/.agents/skills/09-ci-and-devops/gitlab-ci-templates/examples/sample_gitlab_ci.yml +0 -17
  111. package/.agents/skills/09-ci-and-devops/jenkins-pipeline-templates/SKILL.md +0 -133
  112. package/.agents/skills/09-ci-and-devops/jenkins-pipeline-templates/examples/Jenkinsfile.example +0 -21
  113. package/.cursor/rules/language.mdc +0 -7
  114. package/templates/ci/github-actions-synapse.yml +0 -95
  115. package/templates/ci/gitlab-ci-synapse.yml +0 -16
  116. package/tools/build_consolidated_report.py +0 -1643
  117. package/tools/create_mock_docx.py +0 -107
  118. /package/{.agents → ai-agents/hooks}/hooks.json +0 -0
  119. /package/{.agents → ai-agents}/hooks/session_start.py +0 -0
  120. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/actor-qa-swarm/SKILL.md +0 -0
  121. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/actor-qa-swarm/examples/broker_sharding_sample.json +0 -0
  122. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/agent-orchestration-multi-agent-optimize/SKILL.md +0 -0
  123. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/agent-orchestration-multi-agent-optimize/examples/swarm_workload_config.json +0 -0
  124. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/event-stream-qa-orchestrator/SKILL.md +0 -0
  125. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/event-stream-qa-orchestrator/examples/timeline_sample.jsonl +0 -0
  126. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/persistent-planning-files/SKILL.md +0 -0
  127. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/persistent-planning-files/examples/task_plan_example.md +0 -0
  128. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/qa-memory-os/SKILL.md +0 -0
  129. /package/{.agents/skills/10-agent-orchestration → ai-agents/orchestration}/qa-memory-os/examples/archival_memory_sample.json +0 -0
  130. /package/{.agents → ai-agents}/workflows/graphify.md +0 -0
  131. /package/{.agents → ai-agents}/workflows/test-impact.md +0 -0
  132. /package/{.agents → ai-agents}/workflows/verify.md +0 -0
  133. /package/{.agents/rules → automation/cypress}/cypress_rules.md +0 -0
  134. /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/SKILL.md +0 -0
  135. /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/examples/headless_kre_exec.sh +0 -0
  136. /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/references/groovy-patterns.md +0 -0
  137. /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/references/katalon-api.md +0 -0
  138. /package/{.agents/skills/01-web-automation → automation/katalon}/katalon-cli-runner/references/runner_commands.md +0 -0
  139. /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-appium-som/SKILL.md +0 -0
  140. /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-appium-som/examples/BaseScreen.java +0 -0
  141. /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-appium-som/examples/LoginScreen.java +0 -0
  142. /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-appium-som/examples/TC_MobileLogin.java +0 -0
  143. /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-maestro-detox-patterns/SKILL.md +0 -0
  144. /package/{.agents/skills/01-web-automation → automation/mobile}/mobile-maestro-detox-patterns/examples/sample_flow.yaml +0 -0
  145. /package/{.agents/rules → automation/mobile}/mobile_appium_rules.md +0 -0
  146. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/SKILL.md +0 -0
  147. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/examples/live_probe_script.js +0 -0
  148. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/references/advanced_superpowers.md +0 -0
  149. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/references/compact_accessibility_snapshots.md +0 -0
  150. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/references/recipes.md +0 -0
  151. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-live-interaction/references/swarm_orchestration.md +0 -0
  152. /package/{.agents/skills/01-web-automation → automation/playwright}/playwright-webapp-testing/examples/server_lifecycle_playwright.py +0 -0
  153. /package/{.agents/skills/01-web-automation → automation/shared-utils}/auth-session-and-cookie-manager/SKILL.md +0 -0
  154. /package/{.agents/skills/01-web-automation → automation/shared-utils}/auth-session-and-cookie-manager/examples/multi_role_auth_matrix.md +0 -0
  155. /package/{.agents/skills/01-web-automation → automation/shared-utils}/auth-session-and-cookie-manager/examples/storage_state_sample.json +0 -0
  156. /package/{.agents/skills/01-web-automation → automation/shared-utils}/bats-testing-patterns/SKILL.md +0 -0
  157. /package/{.agents/skills/01-web-automation → automation/shared-utils}/bats-testing-patterns/examples/cli_runner_test.bats +0 -0
  158. /package/{.agents/skills/01-web-automation → automation/shared-utils}/bats-testing-patterns/resources/implementation-playbook.md +0 -0
  159. /package/{.agents/skills/01-web-automation → automation/shared-utils}/clean-pom-crafter/examples/standard_test_case.groovy +0 -0
  160. /package/{.agents/skills/01-web-automation → automation/shared-utils}/clean-pom-crafter/references/pom_patterns.groovy +0 -0
  161. /package/{.agents/skills/01-web-automation → automation/shared-utils}/e2e-testing-patterns/examples/playwright_sharded_config.ts +0 -0
  162. /package/{.agents/skills/01-web-automation → automation/shared-utils}/e2e-testing-patterns/resources/implementation-playbook.md +0 -0
  163. /package/{.agents/skills/01-web-automation → automation/shared-utils}/lam-script-generator/examples/user_story_sample.md +0 -0
  164. /package/{.agents/skills/03-api-and-contracts → requirement/spec-review}/api-spec-to-e2e-matrix/SKILL.md +0 -0
  165. /package/{.agents/skills/03-api-and-contracts → requirement/spec-review}/api-spec-to-e2e-matrix/examples/sample_openapi.json +0 -0
  166. /package/{.agents/skills/02-test-design → requirement/spec-review}/architecture-decision-records/SKILL.md +0 -0
  167. /package/{.agents/skills/02-test-design → requirement/spec-review}/architecture-decision-records/examples/0001-record-architecture-decisions.md +0 -0
  168. /package/{.agents/skills/02-test-design → requirement/spec-review}/review-spec/examples/pocock_grilling_decision_rubric.md +0 -0
  169. /package/{.agents/skills/02-test-design → requirement/spec-review}/review-spec/examples/sample_spec_review.md +0 -0
  170. /package/{.agents → requirement}/workflows/analyze_requirement_document.md +0 -0
  171. /package/{.agents → requirement}/workflows/generate_requirements_from_website.md +0 -0
  172. /package/{.agents/rules → standards/coding-standards}/author-integrity-guard.md +0 -0
  173. /package/{.agents/skills/08-code-quality → standards/coding-standards}/code-refactoring-refactor-clean/SKILL.md +0 -0
  174. /package/{.agents/skills/08-code-quality → standards/coding-standards}/code-refactoring-refactor-clean/examples/refactored_page_sample.groovy +0 -0
  175. /package/{.agents/skills/08-code-quality → standards/coding-standards}/code-refactoring-refactor-clean/examples/refactored_playwright_pom.ts +0 -0
  176. /package/{.agents/skills/08-code-quality → standards/coding-standards}/code-refactoring-refactor-clean/resources/implementation-playbook.md +0 -0
  177. /package/{.agents/rules → standards/coding-standards}/communication-style.md +0 -0
  178. /package/{.agents/rules → standards/coding-standards}/git-push-protocol.md +0 -0
  179. /package/{.agents/skills/08-code-quality → standards/coding-standards}/graphify-impact-analyzer/SKILL.md +0 -0
  180. /package/{.agents/skills/08-code-quality → standards/coding-standards}/graphify-impact-analyzer/examples/dependency_blast_radius.json +0 -0
  181. /package/{.agents/skills/08-code-quality → standards/coding-standards}/lean-code-ladder/examples/ladder_walkthrough.md +0 -0
  182. /package/{.agents/skills/08-code-quality → standards/coding-standards}/repo-quality-audit/SKILL.md +0 -0
  183. /package/{.agents/skills/08-code-quality → standards/coding-standards}/repo-quality-audit/examples/sample_audit_walkthrough.md +0 -0
  184. /package/{.agents/skills/08-code-quality → standards/coding-standards}/repo-quality-audit/examples/sample_repo_audit.md +0 -0
  185. /package/{.agents/skills/08-code-quality → standards/coding-standards}/senior-code-review/SKILL.md +0 -0
  186. /package/{.agents/skills/08-code-quality → standards/coding-standards}/senior-code-review/examples/sample_review_walkthrough.md +0 -0
  187. /package/{.agents/skills/08-code-quality → standards/coding-standards}/surgical-coding-principles/examples/surgical_vs_scope_creep.md +0 -0
  188. /package/{.agents/skills/08-code-quality → standards/coding-standards}/technical-debt-harvester/SKILL.md +0 -0
  189. /package/{.agents/skills/08-code-quality → standards/coding-standards}/technical-debt-harvester/examples/sample_debt_ledger.md +0 -0
  190. /package/{.agents/skills/08-code-quality → standards/coding-standards}/technical-debt-harvester/examples/sample_ledger_output.md +0 -0
  191. /package/{.agents/rules → standards/context-ai}/context-engineering.md +0 -0
  192. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/meta-prompt-crafter/SKILL.md +0 -0
  193. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/meta-prompt-crafter/examples/qa_prompt_template.md +0 -0
  194. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/mipro-prompt-compiler/SKILL.md +0 -0
  195. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/mipro-prompt-compiler/examples/compiled_module_sample.json +0 -0
  196. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/mipro-prompt-compiler/examples/dspy_assertion_optimizer_case.md +0 -0
  197. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/qa-aci-interface/SKILL.md +0 -0
  198. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/qa-aci-interface/examples/surgical_code_window_walkthrough.md +0 -0
  199. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/qa-aci-interface/examples/surgical_edit_sample.json +0 -0
  200. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/token-and-context-optimizer/SKILL.md +0 -0
  201. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/token-and-context-optimizer/examples/distilled_log_sample.txt +0 -0
  202. /package/{.agents/skills/11-ai-and-prompting → standards/context-ai}/token-and-context-optimizer/references/context_engineering_guide.md +0 -0
  203. /package/{.agents/rules → standards/qa-process}/graphify.md +0 -0
  204. /package/{.agents/rules → standards/qa-process}/lessons-learned.md +0 -0
  205. /package/{.agents/rules → standards/qa-process}/skill-precedence.md +0 -0
  206. /package/{.agents/rules → standards/quality-gates}/systematic-debugging.md +0 -0
  207. /package/{.agents/templates → templates/test-plan}/performance-test-plan-template.md +0 -0
  208. /package/{.agents/templates → templates/test-report}/completion_report.md +0 -0
  209. /package/{.agents/skills/02-test-design → test-design/bdd-gherkin}/gherkin-to-suite/SKILL.md +0 -0
  210. /package/{.agents/skills/02-test-design → test-design/bdd-gherkin}/gherkin-to-suite/examples/checkout.feature +0 -0
  211. /package/{.agents/skills/02-test-design → test-design/bdd-gherkin}/gherkin-to-suite/examples/suite_report_sample.json +0 -0
  212. /package/{.agents → test-design/bdd-gherkin}/workflows/generate_cross_module_test_plan.md +0 -0
  213. /package/{.agents → test-design/bdd-gherkin}/workflows/generate_testcases_from_requirements.md +0 -0
  214. /package/{.agents/skills/02-test-design → test-design/exploratory}/tot-exploratory-testing/SKILL.md +0 -0
  215. /package/{.agents/skills/02-test-design → test-design/exploratory}/tot-exploratory-testing/examples/payment_gateway_tot_tree.json +0 -0
  216. /package/{.agents/skills/02-test-design → test-design/exploratory}/tot-exploratory-testing/examples/tot_graph_sample.json +0 -0
  217. /package/{.agents/skills/02-test-design → test-design/manual-rbt}/rbt-manual-testing/SKILL.md +0 -0
  218. /package/{.agents/skills/02-test-design → test-design/manual-rbt}/rbt-manual-testing/examples/checkout_rbt_manual_suite.md +0 -0
  219. /package/{.agents/skills/02-test-design → test-design/manual-rbt}/rbt-manual-testing/references/field_validation_checklist.md +0 -0
  220. /package/{.agents → test-design/manual-rbt}/workflows/export_testcases_excel.md +0 -0
  221. /package/{.agents → test-design/manual-rbt}/workflows/generate_manual_testcases_rbt.md +0 -0
  222. /package/{.agents/skills/07-data-and-state → test-design/test-data}/db-state-verifier-and-seeder/SKILL.md +0 -0
  223. /package/{.agents/skills/07-data-and-state → test-design/test-data}/db-state-verifier-and-seeder/examples/db_fixture_seed.json +0 -0
  224. /package/{.agents/skills/07-data-and-state → test-design/test-data}/file-and-report-validator/SKILL.md +0 -0
  225. /package/{.agents/skills/07-data-and-state → test-design/test-data}/file-and-report-validator/examples/sample_export_schema.json +0 -0
  226. /package/{.agents/skills/07-data-and-state → test-design/test-data}/synthetic-test-data-generator/SKILL.md +0 -0
  227. /package/{.agents/skills/07-data-and-state → test-design/test-data}/synthetic-test-data-generator/examples/idempotent_data_recipe.json +0 -0
  228. /package/{.agents → test-design/test-data}/workflows/generate_combinatorial_test_data.md +0 -0
  229. /package/{.agents/skills/03-api-and-contracts → testing/api-contracts}/api-network-mocking-interception/SKILL.md +0 -0
  230. /package/{.agents/skills/03-api-and-contracts → testing/api-contracts}/api-network-mocking-interception/examples/network_route_stub.json +0 -0
  231. /package/{.agents/skills/03-api-and-contracts → testing/api-contracts}/consumer-driven-contract-testing/SKILL.md +0 -0
  232. /package/{.agents/skills/03-api-and-contracts → testing/api-contracts}/consumer-driven-contract-testing/examples/order_service_pact.json +0 -0
  233. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/agentless-qa-repair/examples/healing_report_sample.json +0 -0
  234. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/agentless-qa-repair/examples/three_phase_repair_workflow.md +0 -0
  235. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/antigravity-test-sentinel/SKILL.md +0 -0
  236. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/antigravity-test-sentinel/examples/dod_gate_policy.json +0 -0
  237. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/antigravity-test-sentinel/examples/sprint_dod_enforcement.md +0 -0
  238. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/examples/closed_loop_healing_walkthrough.md +0 -0
  239. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/examples/sample_junit_failure.xml +0 -0
  240. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/references/healing_matrix.md +0 -0
  241. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/references/qa_investigation_protocol.md +0 -0
  242. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/failure-autopsy-and-healing/scripts/triage_failures.sh +0 -0
  243. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/flaky-test-sentinel-and-quarantine/SKILL.md +0 -0
  244. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/flaky-test-sentinel-and-quarantine/examples/quarantine_registry.json +0 -0
  245. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/self-healing-locator/examples/aom_diff_sample.json +0 -0
  246. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/systematic-debugging/SKILL.md +0 -0
  247. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/systematic-debugging/examples/four_phase_case.md +0 -0
  248. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/test-driven-development/SKILL.md +0 -0
  249. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/test-driven-development/examples/red_green_refactor_qa.md +0 -0
  250. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/verification-before-completion/SKILL.md +0 -0
  251. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/verification-before-completion/examples/evidence_log_example.md +0 -0
  252. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/visual-regression-sentinel/SKILL.md +0 -0
  253. /package/{.agents/skills/06-healing-and-resilience → testing/healing-resilience}/visual-regression-sentinel/examples/visual_mask_rules.json +0 -0
  254. /package/{.agents/skills/04-performance-and-load → testing/performance}/backend-load-and-stress-patterns/examples/k6_load_test_sample.js +0 -0
  255. /package/{.agents/skills/04-performance-and-load → testing/performance}/backend-load-and-stress-patterns/references/k6_load_template.js +0 -0
  256. /package/{.agents/skills/04-performance-and-load → testing/performance}/backend-load-and-stress-patterns/references/performance_test_plan_29119.md +0 -0
  257. /package/{.agents/skills/04-performance-and-load → testing/performance}/lean-impact-scoreboard/SKILL.md +0 -0
  258. /package/{.agents/skills/04-performance-and-load → testing/performance}/lean-impact-scoreboard/examples/sample_benchmark_gain.md +0 -0
  259. /package/{.agents/skills/04-performance-and-load → testing/performance}/lean-impact-scoreboard/examples/sample_scoreboard.md +0 -0
  260. /package/{.agents/skills/04-performance-and-load → testing/performance}/web-vitals-and-performance-profiler/SKILL.md +0 -0
  261. /package/{.agents/skills/04-performance-and-load → testing/performance}/web-vitals-and-performance-profiler/examples/cwv_budget_policy.json +0 -0
  262. /package/{.agents/skills/04-performance-and-load → testing/performance}/web-vitals-and-performance-profiler/examples/playwright_cwv_profiler_fixture.ts +0 -0
  263. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/SKILL.md +0 -0
  264. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/examples/dast_scan_config.json +0 -0
  265. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/references/AI-AND-LLM.md +0 -0
  266. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/references/ATTACK-CLASSES.md +0 -0
  267. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/security-dast-sentinel/references/dast_recipes.ts +0 -0
  268. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/skillspector-security-guard/SKILL.md +0 -0
  269. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/skillspector-security-guard/examples/audit_threat_vectors_report.json +0 -0
  270. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/skillspector-security-guard/examples/safe_mcp_config.json +0 -0
  271. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/wcag-audit-patterns/SKILL.md +0 -0
  272. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/wcag-audit-patterns/examples/wcag_compliance_checklist.json +0 -0
  273. /package/{.agents/skills/05-security-and-compliance → testing/security-a11y}/wcag-audit-patterns/resources/implementation-playbook.md +0 -0
  274. /package/{.agents/skills/01-web-automation → tools/benchmarks-tests}/web-agent-gym-benchmarking/SKILL.md +0 -0
  275. /package/{.agents/skills/01-web-automation → tools/benchmarks-tests}/web-agent-gym-benchmarking/examples/benchmark_report_sample.json +0 -0
  276. /package/{.agents/skills/01-web-automation → tools/benchmarks-tests}/web-agent-gym-benchmarking/examples/enterprise_tasks_suite.json +0 -0
@@ -261,3 +261,109 @@ def get_active_model() -> str:
261
261
 
262
262
  def get_circuit_breaker() -> TokenCircuitBreaker:
263
263
  return GLOBAL_CIRCUIT_BREAKER
264
+
265
+
266
+ # ---------------------------------------------------------------------------
267
+ # Integrated Runaway & Turn-Loop Sentinel (Absorbed from runaway_stopper.py)
268
+ # ---------------------------------------------------------------------------
269
+
270
+ DEFAULT_THRESHOLDS = {
271
+ "max_turns": 30,
272
+ "warn_turns": 20,
273
+ "max_tokens": 150000,
274
+ "warn_tokens": 100000,
275
+ "max_repeated_calls": 3,
276
+ "empty_turn_threshold": 4,
277
+ }
278
+
279
+
280
+ class RunawaySentinel:
281
+ """Evaluates agent transcript turns to detect infinite loops and token blowouts."""
282
+
283
+ def __init__(self, thresholds: Optional[Dict[str, int]] = None):
284
+ self.thresholds = dict(DEFAULT_THRESHOLDS)
285
+ if thresholds:
286
+ self.thresholds.update(thresholds)
287
+
288
+ def evaluate_transcript(self, turns: List[Dict[str, Any]]) -> Dict[str, Any]:
289
+ """Evaluates a list of turn records for budget and loop patterns."""
290
+ turn_count = len(turns)
291
+ total_tokens = sum(t.get("tokens_est", 0) for t in turns)
292
+ flags = []
293
+ verdict = "OK"
294
+
295
+ if turn_count >= self.thresholds["max_turns"]:
296
+ flags.append({
297
+ "severity": "CRITICAL",
298
+ "type": "TURN_LIMIT_EXCEEDED",
299
+ "message": f"Turn count ({turn_count}) exceeded maximum threshold ({self.thresholds['max_turns']}).",
300
+ })
301
+ verdict = "STOP"
302
+ elif turn_count >= self.thresholds["warn_turns"]:
303
+ flags.append({
304
+ "severity": "WARNING",
305
+ "type": "TURN_LIMIT_WARNING",
306
+ "message": f"Turn count ({turn_count}) approached warning threshold ({self.thresholds['warn_turns']}).",
307
+ })
308
+ if verdict == "OK":
309
+ verdict = "WARN"
310
+
311
+ if total_tokens >= self.thresholds["max_tokens"]:
312
+ flags.append({
313
+ "severity": "CRITICAL",
314
+ "type": "TOKEN_BUDGET_EXCEEDED",
315
+ "message": f"Estimated token usage ({total_tokens:,}) exceeded budget ({self.thresholds['max_tokens']:,}).",
316
+ })
317
+ verdict = "STOP"
318
+ elif total_tokens >= self.thresholds["warn_tokens"]:
319
+ flags.append({
320
+ "severity": "WARNING",
321
+ "type": "TOKEN_BUDGET_WARNING",
322
+ "message": f"Estimated token usage ({total_tokens:,}) reached warning limit ({self.thresholds['warn_tokens']:,}).",
323
+ })
324
+ if verdict == "OK":
325
+ verdict = "WARN"
326
+
327
+ recent_commands = [
328
+ (t.get("command") or t.get("tool_name") or t.get("tool") or t.get("name") or "")
329
+ for t in turns
330
+ if (t.get("command") or t.get("tool_name") or t.get("tool") or t.get("name"))
331
+ ]
332
+ if len(recent_commands) >= self.thresholds["max_repeated_calls"]:
333
+ last_cmd = recent_commands[-1]
334
+ repeat_count = 1
335
+ for cmd in reversed(recent_commands[:-1]):
336
+ if cmd == last_cmd and last_cmd:
337
+ repeat_count += 1
338
+ else:
339
+ break
340
+ if repeat_count >= self.thresholds["max_repeated_calls"]:
341
+ flags.append({
342
+ "severity": "CRITICAL",
343
+ "type": "TOOL_LOOP_DETECTED",
344
+ "message": f"Command repeated {repeat_count} consecutive times: '{last_cmd[:60]}...'",
345
+ })
346
+ verdict = "STOP"
347
+
348
+ empty_turns = 0
349
+ for t in reversed(turns):
350
+ if t.get("output_length", 1) == 0 and not t.get("tool_name"):
351
+ empty_turns += 1
352
+ else:
353
+ break
354
+ if empty_turns >= self.thresholds["empty_turn_threshold"]:
355
+ flags.append({
356
+ "severity": "CRITICAL",
357
+ "type": "EMPTY_TURNS_LOOP",
358
+ "message": f"Detected {empty_turns} consecutive empty turns without progress.",
359
+ })
360
+ verdict = "STOP"
361
+
362
+ return {
363
+ "verdict": verdict,
364
+ "turn_count": turn_count,
365
+ "total_tokens_est": total_tokens,
366
+ "flags": flags,
367
+ "is_runaway": verdict == "STOP",
368
+ }
369
+
@@ -212,6 +212,23 @@ def calculate_hydration_payload(
212
212
  rule_bytes = 0
213
213
  for r in rules:
214
214
  p = os.path.join(rules_dir, r)
215
+ if not os.path.isfile(p):
216
+ for sub in [
217
+ os.path.join("standards", "coding-standards"),
218
+ os.path.join("standards", "qa-process"),
219
+ os.path.join("standards", "quality-gates"),
220
+ os.path.join("standards", "context-ai"),
221
+ os.path.join("automation", "cypress"),
222
+ os.path.join("automation", "mobile"),
223
+ os.path.join("automation", "playwright"),
224
+ os.path.join("testing", "performance"),
225
+ os.path.join("testing", "security-a11y"),
226
+ os.path.join("testing", "api-contracts"),
227
+ ]:
228
+ cand = os.path.join(repo_root, sub, r)
229
+ if os.path.isfile(cand):
230
+ p = cand
231
+ break
215
232
  if os.path.isfile(p):
216
233
  rule_tokens += count_file_tokens(p)
217
234
  rule_bytes += os.path.getsize(p)
@@ -223,12 +240,16 @@ def calculate_hydration_payload(
223
240
  full_skill_tokens = 0
224
241
  full_skill_bytes = 0
225
242
 
226
- # Locate each skill directory in .agents/skills
243
+ # Locate each skill directory in .agents/skills or manifest path
227
244
  for skill_name in skills:
228
245
  meta = manifest.get(skill_name)
229
246
  catalog_lines.append(serialize_skill_summary(skill_name, meta))
230
247
 
231
248
  skill_file = _find_skill_file(skills_root, skill_name)
249
+ if (not skill_file or not os.path.isfile(skill_file)) and meta and "path" in meta:
250
+ cand = os.path.join(repo_root, meta["path"])
251
+ if os.path.isfile(cand):
252
+ skill_file = cand
232
253
  if skill_file and os.path.isfile(skill_file):
233
254
  tokens = count_file_tokens(skill_file)
234
255
  size = os.path.getsize(skill_file)
@@ -290,13 +311,41 @@ def get_full_unrouted_baseline(repo_root: str) -> Dict[str, Any]:
290
311
 
291
312
  total_rule_tokens = 0
292
313
  total_rule_bytes = 0
293
- for rf in all_rule_files:
294
- p = os.path.join(rules_dir, rf)
295
- total_rule_tokens += count_file_tokens(p)
296
- total_rule_bytes += os.path.getsize(p)
297
-
298
- # 2. Enumerate all 53 SKILL.md files
314
+ if all_rule_files:
315
+ for rf in all_rule_files:
316
+ p = os.path.join(rules_dir, rf)
317
+ total_rule_tokens += count_file_tokens(p)
318
+ total_rule_bytes += os.path.getsize(p)
319
+ else:
320
+ rule_candidates = [
321
+ os.path.join("standards", "coding-standards", "author-integrity-guard.md"),
322
+ os.path.join("standards", "coding-standards", "communication-style.md"),
323
+ os.path.join("standards", "coding-standards", "git-push-protocol.md"),
324
+ os.path.join("standards", "context-ai", "context-engineering.md"),
325
+ os.path.join("standards", "qa-process", "graphify.md"),
326
+ os.path.join("standards", "qa-process", "lessons-learned.md"),
327
+ os.path.join("standards", "qa-process", "skill-precedence.md"),
328
+ os.path.join("standards", "quality-gates", "systematic-debugging.md"),
329
+ os.path.join("automation", "cypress", "cypress_rules.md"),
330
+ os.path.join("automation", "mobile", "mobile_appium_rules.md"),
331
+ os.path.join("automation", "playwright", "mandatory-playwright-live.md"),
332
+ os.path.join("testing", "performance", "performance_testing_rules.md"),
333
+ os.path.join("testing", "security-a11y", "security_testing_rules.md"),
334
+ os.path.join("testing", "api-contracts", "api_testing_rules.md"),
335
+ ]
336
+ all_rule_paths = [os.path.join(repo_root, p) for p in rule_candidates if os.path.isfile(os.path.join(repo_root, p))]
337
+ all_rule_files = [os.path.basename(p) for p in all_rule_paths]
338
+ total_rule_tokens = sum(count_file_tokens(p) for p in all_rule_paths)
339
+ total_rule_bytes = sum(os.path.getsize(p) for p in all_rule_paths)
340
+
341
+ # 2. Enumerate all SKILL.md files
299
342
  skill_files = sorted(glob.glob(os.path.join(skills_root, "*", "*", "SKILL.md")))
343
+ if not skill_files and manifest:
344
+ for sid, s in manifest.items():
345
+ sp = os.path.join(repo_root, s.get("path", ""))
346
+ if os.path.isfile(sp):
347
+ skill_files.append(sp)
348
+
300
349
  total_skill_tokens = 0
301
350
  total_skill_bytes = 0
302
351
  all_skill_ids: List[str] = []
@@ -14,7 +14,7 @@ Supports Dual-Mode:
14
14
  1. TARGET PROJECT MODE: Displays target project test suites, POM PageClasses,
15
15
  automation tech stack (Playwright/Katalon/Pytest/Cypress), in-project 10 Gates DoD,
16
16
  and active AI skill profile.
17
- 2. HUB ECOSYSTEM MODE: Displays central Synapse-Hub catalog (51 skills),
17
+ 2. HUB ECOSYSTEM MODE: Displays central Synapse-Hub catalog (57 skills),
18
18
  self-healing benchmark (25 challenges), and platform governance.
19
19
 
20
20
  Features:
@@ -1350,7 +1350,7 @@ def _build_target_translations(
1350
1350
  "th_step_status": "Trạng Thái",
1351
1351
  "th_step_details": "Chi Tiết Kỹ Thuật (OTel & AST)",
1352
1352
 
1353
- "footer_text": "Báo cáo được khởi tạo tự động bởi Synapse-Hub v4.4.0 • Bản quyền © Thế Vị (@TeeVee98) • Chuẩn Clean POM & Kiểm Thử Tự Chủ",
1353
+ "footer_text": "Báo cáo được khởi tạo tự động bởi Synapse-Hub v4.4.1 • Bản quyền © Thế Vị (@TeeVee98) • Chuẩn Clean POM & Kiểm Thử Tự Chủ",
1354
1354
  }
1355
1355
 
1356
1356
  translations_en = {
@@ -1428,7 +1428,7 @@ def _build_target_translations(
1428
1428
  "th_step_status": "Status",
1429
1429
  "th_step_details": "Technical Details (OTel & AST)",
1430
1430
 
1431
- "footer_text": "Generated automatically by Synapse-Hub v4.4.0 • Copyright © Thế Vị (@TeeVee98) • Clean POM & Autonomous Testing",
1431
+ "footer_text": "Generated automatically by Synapse-Hub v4.4.1 • Copyright © Thế Vị (@TeeVee98) • Clean POM & Autonomous Testing",
1432
1432
  }
1433
1433
 
1434
1434
  _inject_gate_translations(translations_vi, translations_en, gates)
@@ -1911,13 +1911,13 @@ def _build_hub_translations(
1911
1911
  now_str: str,
1912
1912
  bench: Dict[str, Any],
1913
1913
  gates: List[Dict[str, str]],
1914
- total_skills: int = 56,
1914
+ total_skills: int = 57,
1915
1915
  skills: Optional[List[Dict[str, Any]]] = None,
1916
1916
  ) -> Tuple[Dict[str, str], Dict[str, str]]:
1917
1917
  """Builds bilingual dictionaries for Hub Dashboard."""
1918
1918
  translations_vi = {
1919
1919
  "header_title": "Bảng Điều Hành Chất Lượng Doanh Nghiệp",
1920
- "header_subtitle": "Synapse-Hub v4.4.0 • Hệ Sinh Thái Kiểm Thử AI Agent Tự Chủ",
1920
+ "header_subtitle": "Synapse-Hub v4.4.1 • Hệ Sinh Thái Kiểm Thử AI Agent Tự Chủ",
1921
1921
  "nav_welcome": "Giới Thiệu",
1922
1922
  "meta_mode": "🏷️ Chế độ: <strong>HỆ SINH THÁI QA HUB</strong>",
1923
1923
  "meta_gen": f"🕒 Khởi tạo: <strong>{now_str}</strong>",
@@ -1987,12 +1987,12 @@ def _build_hub_translations(
1987
1987
  "th_sk_ver": "Phiên Bản",
1988
1988
  "th_sk_cap": "Khả Năng Nghiệp Vụ Cốt Lõi",
1989
1989
 
1990
- "footer_text": "Bảng Điều Hành Chất Lượng Doanh Nghiệp &bull; Synapse-Hub v4.4.0 &bull; Bản quyền &copy; Thế Vị (@TeeVee98) &bull; Hệ Thống Kiểm Thử AI Agent Tự Chủ",
1990
+ "footer_text": "Bảng Điều Hành Chất Lượng Doanh Nghiệp &bull; Synapse-Hub v4.4.1 &bull; Bản quyền &copy; Thế Vị (@TeeVee98) &bull; Hệ Thống Kiểm Thử AI Agent Tự Chủ",
1991
1991
  }
1992
1992
 
1993
1993
  translations_en = {
1994
1994
  "header_title": "Enterprise QA Executive Dashboard",
1995
- "header_subtitle": "Synapse-Hub v4.4.0 &bull; Autonomous AI Agent Testing Ecosystem",
1995
+ "header_subtitle": "Synapse-Hub v4.4.1 &bull; Autonomous AI Agent Testing Ecosystem",
1996
1996
  "nav_welcome": "Welcome",
1997
1997
  "meta_mode": "🏷️ Mode: <strong>QA HUB ECOSYSTEM</strong>",
1998
1998
  "meta_gen": f"🕒 Generated: <strong>{now_str}</strong>",
@@ -2062,7 +2062,7 @@ def _build_hub_translations(
2062
2062
  "th_sk_ver": "Version",
2063
2063
  "th_sk_cap": "Core Capabilities",
2064
2064
 
2065
- "footer_text": "Enterprise QA Executive Dashboard &bull; Synapse-Hub v4.4.0 &bull; Copyright &copy; Thế Vị (@TeeVee98) &bull; Autonomous AI Agent Testing Ecosystem",
2065
+ "footer_text": "Enterprise QA Executive Dashboard &bull; Synapse-Hub v4.4.1 &bull; Copyright &copy; Thế Vị (@TeeVee98) &bull; Autonomous AI Agent Testing Ecosystem",
2066
2066
  }
2067
2067
 
2068
2068
  _inject_gate_translations(translations_vi, translations_en, gates)
@@ -2208,7 +2208,7 @@ def _render_hub_content(
2208
2208
  </div>
2209
2209
  {timeline_section_html}
2210
2210
 
2211
- <!-- 51 Specialized Skills Catalog -->
2211
+ <!-- 57 Specialized Skills Catalog -->
2212
2212
  <div class="section-header">
2213
2213
  <h2 data-i18n="sec_skills_title">{t['sec_skills_title']}</h2>
2214
2214
  <span class="section-badge" data-i18n="sec_skills_badge">{t['sec_skills_badge']}</span>
@@ -2258,7 +2258,7 @@ def generate_hub_html(
2258
2258
  now_str = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
2259
2259
  total_skills = manifest.get("totalSkills", len(manifest.get("skills", [])))
2260
2260
  if total_skills == 0:
2261
- total_skills = 56
2261
+ total_skills = 57
2262
2262
  skills = manifest.get("skills", [])
2263
2263
 
2264
2264
  gates = _get_hub_gates()
@@ -480,14 +480,70 @@ def format_markdown_catalog(catalog: Dict[str, Any]) -> str:
480
480
  return "\n".join(md)
481
481
 
482
482
 
483
+ def generate_tool_index(catalog: Dict[str, Any]) -> Dict[str, Any]:
484
+ """Generates Tier-1 lightweight tool index grouped by owner_role (< 12 KB)."""
485
+ import re
486
+ personas = [
487
+ "orchestrator", "live-explorer", "pom-crafter", "test-runner",
488
+ "failure-analyst", "quality-gatekeeper", "api-engineer",
489
+ "perf-engineer", "test-designer"
490
+ ]
491
+ by_role: Dict[str, Dict[str, str]] = {p: {} for p in personas}
492
+ for t in catalog["tools"]:
493
+ role = t.get("owner_role", "orchestrator")
494
+ if role not in by_role:
495
+ by_role[role] = {}
496
+ desc = t.get("description", "").strip()
497
+ if "—" in desc:
498
+ desc = desc.split("—", 1)[1].strip()
499
+ desc = re.sub(r"\s+", " ", desc)
500
+ if len(desc) > 32:
501
+ desc = desc[:30] + ".."
502
+ cmd = t.get("command", "")
503
+ by_role[role][cmd] = desc
504
+ return by_role
505
+
506
+
507
+ def shard_catalogs(catalog: Dict[str, Any], catalogs_dir: str) -> int:
508
+ """Shards full schemas into per-category Tier-2 catalogs."""
509
+ import re
510
+ os.makedirs(catalogs_dir, exist_ok=True)
511
+ by_category: Dict[str, list] = {}
512
+ for t in catalog["tools"]:
513
+ cat = t.get("category", "Auxiliary Utilities")
514
+ by_category.setdefault(cat, []).append(t)
515
+
516
+ for cat, tools in by_category.items():
517
+ slug = re.sub(r"[^a-zA-Z0-9]+", "_", cat.strip()).lower().strip("_")
518
+ cat_file = os.path.join(catalogs_dir, f"{slug}.json")
519
+ payload = {
520
+ "category": cat,
521
+ "total_tools": len(tools),
522
+ "tools": tools
523
+ }
524
+ with open(cat_file, "w", encoding="utf-8") as f:
525
+ json.dump(payload, f, indent=2, ensure_ascii=False)
526
+ return len(by_category)
527
+
528
+
483
529
  def main() -> int:
484
530
  catalog = build_catalog()
485
531
 
486
- # Write JSON catalog
532
+ # Write Tier-2 Full JSON catalog
487
533
  json_path = os.path.join(TOOLS_DIR, "TOOL_CATALOG.json")
488
534
  with open(json_path, "w", encoding="utf-8") as f:
489
535
  json.dump(catalog, f, indent=2, ensure_ascii=False)
490
536
 
537
+ # Write Tier-1 Lightweight JSON index
538
+ index_path = os.path.join(TOOLS_DIR, "TOOL_INDEX.json")
539
+ tool_index = generate_tool_index(catalog)
540
+ with open(index_path, "w", encoding="utf-8") as f:
541
+ json.dump(tool_index, f, indent=2, ensure_ascii=False)
542
+
543
+ # Write Tier-2 Per-Category Sharded catalogs
544
+ catalogs_dir = os.path.join(TOOLS_DIR, "catalogs")
545
+ sharded_count = shard_catalogs(catalog, catalogs_dir)
546
+
491
547
  # Write Markdown catalog
492
548
  docs_dir = os.path.join(REPO_ROOT, "docs")
493
549
  os.makedirs(docs_dir, exist_ok=True)
@@ -501,7 +557,9 @@ def main() -> int:
501
557
  print(f" Indexed Tools : {catalog['total_tools']} tools")
502
558
  print(f" Stable Tools : {catalog['stable_count']} (Production Ready)")
503
559
  print(f" Experimental Tools : {catalog['experimental_count']}")
504
- print(f" JSON Catalog : {os.path.relpath(json_path, REPO_ROOT)}")
560
+ print(f" JSON Catalog (T2) : {os.path.relpath(json_path, REPO_ROOT)}")
561
+ print(f" JSON Index (T1) : {os.path.relpath(index_path, REPO_ROOT)}")
562
+ print(f" Sharded Catalogs : {sharded_count} files in {os.path.relpath(catalogs_dir, REPO_ROOT)}")
505
563
  print(f" Markdown Runbook : {os.path.relpath(md_path, REPO_ROOT)}")
506
564
  print("=" * 68)
507
565
  print("✅ Tool catalog synchronized successfully.")
@@ -60,7 +60,7 @@ if hasattr(sys.stdout, 'reconfigure'):
60
60
  except Exception:
61
61
  pass
62
62
 
63
- SERVER_VERSION = "4.4.0"
63
+ SERVER_VERSION = "4.4.1"
64
64
  MAX_DOCX_SIZE = 50 * 1024 * 1024 # 50 MB
65
65
  MAX_UNCOMPRESSED_SIZE = 200 * 1024 * 1024 # 200 MB
66
66
  MAX_RATIO = 100 # 100:1 compression ratio limit
@@ -55,7 +55,7 @@ if hasattr(sys.stdout, 'reconfigure'):
55
55
  except Exception:
56
56
  pass
57
57
 
58
- SERVER_VERSION = "4.4.0"
58
+ SERVER_VERSION = "4.4.1"
59
59
  MAX_XLSX_SIZE = 50 * 1024 * 1024 # 50 MB
60
60
  MAX_UNCOMPRESSED_SIZE = 200 * 1024 * 1024 # 200 MB
61
61
  MAX_RATIO = 100 # 100:1 compression ratio limit
@@ -50,7 +50,7 @@ import gherkin_suite
50
50
  import api_fuzzer
51
51
 
52
52
  SERVER_NAME = "enterprise-agent-qa"
53
- SERVER_VERSION = "4.4.0"
53
+ SERVER_VERSION = "4.4.1"
54
54
 
55
55
  MCP_TOOLS = [
56
56
  {
@@ -813,4 +813,8 @@ def run_stdio_server():
813
813
 
814
814
 
815
815
  if __name__ == "__main__":
816
+ if any(arg in sys.argv[1:] for arg in ("--help", "-h", "-v", "--version")):
817
+ print("Synapse Hub Enterprise Model Context Protocol (FastMCP) JSON-RPC Stdio Server.")
818
+ print("Usage: python tools/mcp_server.py (Accepts JSON-RPC 2.0 frames over stdin/stdout)")
819
+ sys.exit(0)
816
820
  run_stdio_server()
@@ -75,7 +75,7 @@ def find_recent_sessions(limit: int = 3, brain_dir: Optional[str] = None) -> Lis
75
75
  })
76
76
 
77
77
  # Sort descending by modification time
78
- sessions.sort(key=lambda s: s["modified_time"], reverse=True)
78
+ sessions.sort(key=lambda s: float(s.get("modified_time", 0.0)), reverse=True)
79
79
  return sessions[:limit]
80
80
 
81
81
 
@@ -165,34 +165,41 @@ def read_state(target_dir):
165
165
  return f.read()
166
166
 
167
167
 
168
- if __name__ == "__main__":
169
- if len(sys.argv) > 1 and sys.argv[1] in ("-h", "--help"):
168
+ def main(argv=None):
169
+ if argv is None:
170
+ argv = sys.argv[1:]
171
+ if argv and argv[0] in ("-h", "--help"):
170
172
  print("Usage: python3 tools/project_state.py [status|init|update] [target_dir]")
171
173
  print("Initializes, verifies, or inspects the rolling-window PROJECT_STATE.md anchor.")
172
- sys.exit(0)
174
+ return 0
173
175
 
174
- arg1 = sys.argv[1] if len(sys.argv) > 1 else "status"
176
+ arg1 = argv[0] if argv else "status"
175
177
 
176
178
  if arg1 == "status":
177
- target = sys.argv[2] if len(sys.argv) > 2 else os.getcwd()
179
+ target = argv[1] if len(argv) > 1 else os.getcwd()
178
180
  state = read_state(target)
179
181
  if state is None:
180
182
  init_state(target)
181
183
  state = read_state(target)
182
184
  print(state)
183
- sys.exit(0)
185
+ return 0
184
186
  elif arg1 == "init":
185
- target = sys.argv[2] if len(sys.argv) > 2 else os.getcwd()
187
+ target = argv[1] if len(argv) > 1 else os.getcwd()
186
188
  sf = init_state(target)
187
189
  print(f"Project state anchor initialized at: {sf}")
188
- sys.exit(0)
190
+ return 0
189
191
  elif arg1 == "update":
190
- target = sys.argv[2] if len(sys.argv) > 2 else os.getcwd()
192
+ target = argv[1] if len(argv) > 1 else os.getcwd()
191
193
  sf = update_state(target)
192
194
  print(f"Project state anchor updated at: {sf}")
193
- sys.exit(0)
195
+ return 0
194
196
  else:
195
197
  # Default: treat argument as target_dir
196
198
  target = arg1
197
199
  sf = init_state(target)
198
200
  print(f"Project state anchor initialized at: {sf}")
201
+ return 0
202
+
203
+
204
+ if __name__ == "__main__":
205
+ sys.exit(main())
@@ -478,13 +478,13 @@ def _register_teardown_handlers():
478
478
  _register_teardown_handlers()
479
479
 
480
480
 
481
- if __name__ == "__main__":
481
+ def main(argv=None):
482
482
  import argparse
483
483
  parser = argparse.ArgumentParser(description="GoEx Reversible Teardown Sandbox Stack")
484
484
  parser.add_argument("--demo", action="store_true", help="Run reversible stack demonstration")
485
485
  parser.add_argument("--status", action="store_true", help="Display active undo stack count")
486
486
  parser.add_argument("--recover", action="store_true", help="Recover and roll back uncommitted WAL journal")
487
- args = parser.parse_args()
487
+ args = parser.parse_args(argv)
488
488
 
489
489
  if args.recover:
490
490
  print("Recovering uncommitted mutations from WAL journal...")
@@ -498,3 +498,8 @@ if __name__ == "__main__":
498
498
  print("Exited sandbox context, stack rolled back cleanly.")
499
499
  else:
500
500
  print(f"Active global undo stack size: {GLOBAL_SANDBOX.stack_size()}")
501
+ return 0
502
+
503
+
504
+ if __name__ == "__main__":
505
+ sys.exit(main())
@@ -117,7 +117,7 @@ STACK_RULE_MAPPINGS = {
117
117
  "selenium": ["systematic-debugging.md"],
118
118
  "performance": ["performance_testing_rules.md"],
119
119
  "security": ["security_testing_rules.md"],
120
- "api": ["systematic-debugging.md"],
120
+ "api": ["api_testing_rules.md", "systematic-debugging.md"],
121
121
  "git": ["git-push-protocol.md"],
122
122
  }
123
123
 
@@ -217,7 +217,7 @@ TASK_TYPE_CONFIGS: Dict[str, Dict[str, Any]] = {
217
217
  "rules": ["security_testing_rules.md"],
218
218
  "primary_skills": ["security-dast-sentinel", "skillspector-security-guard"],
219
219
  "secondary_skills": ["wcag-audit-patterns"],
220
- "default_token_cap": 6000,
220
+ "default_token_cap": 7000,
221
221
  },
222
222
  }
223
223
 
@@ -357,7 +357,9 @@ def _find_repo_root() -> str:
357
357
  """Finds the root of Synapse-Hub repository."""
358
358
  curr = os.path.abspath(os.path.dirname(__file__))
359
359
  while curr != os.path.dirname(curr):
360
- if os.path.exists(os.path.join(curr, "AGENTS.md")) and os.path.exists(os.path.join(curr, ".agents")):
360
+ if os.path.exists(os.path.join(curr, "AGENTS.md")) and (
361
+ os.path.exists(os.path.join(curr, "skills_manifest.json")) or os.path.exists(os.path.join(curr, ".agents"))
362
+ ):
361
363
  return curr
362
364
  curr = os.path.dirname(curr)
363
365
  return os.path.abspath(os.path.dirname(os.path.dirname(__file__)))