synapse-hub 0.0.0-stage → 2.0.0

package/package.json

@@ -1,6 +1,61 @@
 {
   "name": "synapse-hub",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "2.0.0",
+  "description": "Enterprise AI Agent Intelligence Hub & Autonomous Skill Network",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "synapse",
+    "ai-agents",
+    "qa",
+    "testing",
+    "playwright",
+    "clean-pom",
+    "quality-gates",
+    "antigravity",
+    "npx"
+  ],
+  "homepage": "https://github.com/TeeVee998/Agent-Cortex#readme",
+  "bugs": {
+    "url": "https://github.com/TeeVee998/Agent-Cortex/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TeeVee998/Agent-Cortex.git"
+  },
+  "license": "MIT",
+  "author": "AI QA Engineering Swarm <qa-swarm@enterprise.internal>",
+  "main": "bin/agent-qa.js",
+  "bin": {
+    "synapse-hub": "./bin/agent-qa.js",
+    "synapse": "./bin/agent-qa.js",
+    "agent-qa": "./bin/agent-qa.js",
+    "agent-skills": "./bin/agent-qa.js"
+  },
+  "files": [
+    ".agents",
+    "bin",
+    "tools",
+    "templates",
+    "README.md",
+    "AGENTS.md",
+    "skills_manifest.json",
+    "!**/__pycache__/**",
+    "!**/*.py[cod]",
+    "!**/*.db",
+    "!**/*.sqlite*"
+  ],
+  "scripts": {
+    "start": "node ./bin/agent-qa.js",
+    "version": "node ./bin/agent-qa.js version",
+    "verify": "node ./bin/agent-qa.js verify",
+    "setup": "node ./bin/agent-qa.js setup",
+    "analyze": "node ./bin/agent-qa.js analyze",
+    "lint": "node ./bin/agent-qa.js lint",
+    "test": "python3 -m unittest discover tests -p 'test_*.py'"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}

package/skills_manifest.json

@@ -0,0 +1,262 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "name": "Enterprise Agent Skills Hub",
+    "version": "2.0.0",
+    "description": "Unified Catalog of 27 Specialized Skills for Autonomous AI Agents in Enterprise Software Quality Engineering, Performance, and Architecture.",
+    "totalSkills": 27,
+    "categories": {
+        "context_and_optimization": [
+            "token-and-context-optimizer",
+            "agent-orchestration-multi-agent-optimize"
+        ],
+        "test_automation_and_execution": [
+            "clean-pom-crafter",
+            "e2e-testing-patterns",
+            "playwright-live-interaction",
+            "katalon-cli-runner",
+            "bats-testing-patterns",
+            "lam-script-generator",
+            "auth-session-and-cookie-manager",
+            "backend-load-and-stress-patterns"
+        ],
+        "verification_and_resilience": [
+            "antigravity-test-sentinel",
+            "self-healing-locator",
+            "failure-autopsy-and-healing",
+            "api-network-mocking-interception",
+            "visual-regression-sentinel",
+            "synthetic-test-data-generator",
+            "file-and-report-validator",
+            "db-state-verifier-and-seeder",
+            "security-dast-sentinel",
+            "flaky-test-sentinel-and-quarantine"
+        ],
+        "architecture_and_analysis": [
+            "api-spec-to-e2e-matrix",
+            "architecture-decision-records",
+            "code-refactoring-refactor-clean",
+            "graphify-impact-analyzer",
+            "wcag-audit-patterns",
+            "github-actions-templates",
+            "web-vitals-and-performance-profiler"
+        ]
+    },
+    "skills": [
+        {
+            "id": "agent-orchestration-multi-agent-optimize",
+            "name": "Agent Orchestration Multi-Agent Optimize",
+            "category": "context_and_optimization",
+            "path": ".agents/skills/agent-orchestration-multi-agent-optimize/SKILL.md",
+            "summary": "Optimize multi-agent systems with coordinated profiling, workload distribution, and cost-aware orchestration.",
+            "version": "2.0.0"
+        },
+        {
+            "id": "antigravity-test-sentinel",
+            "name": "Antigravity Test Sentinel",
+            "category": "verification_and_resilience",
+            "path": ".agents/skills/antigravity-test-sentinel/SKILL.md",
+            "summary": "Verification-first sentinel locking task completion until runner commands return exit code 0.",
+            "version": "2.0.0"
+        },
+        {
+            "id": "api-network-mocking-interception",
+            "name": "API Network Mocking & Interception",
+            "category": "verification_and_resilience",
+            "path": ".agents/skills/api-network-mocking-interception/SKILL.md",
+            "summary": "Intercept, stub, and mock HTTP/GraphQL network traffic, and verify chaos network resilience during E2E test runs.",
+            "version": "2.0.0"
+        },
+        {
+            "id": "api-spec-to-e2e-matrix",
+            "name": "API Spec to E2E Matrix",
+            "category": "architecture_and_analysis",
+            "path": ".agents/skills/api-spec-to-e2e-matrix/SKILL.md",
+            "summary": "Transforms OpenAPI/Swagger specifications and schemas into positive, boundary, and negative test matrices.",
+            "version": "2.0.0"
+        },
+        {
+            "id": "architecture-decision-records",
+            "name": "Architecture Decision Records",
+            "category": "architecture_and_analysis",
+            "path": ".agents/skills/architecture-decision-records/SKILL.md",
+            "summary": "Write and maintain Architecture Decision Records (ADRs) following engineering standards.",
+            "version": "2.0.0"
+        },
+        {
+            "id": "auth-session-and-cookie-manager",
+            "name": "Auth Session and Cookie Manager",
+            "category": "test_automation_and_execution",
+            "path": ".agents/skills/auth-session-and-cookie-manager/SKILL.md",
+            "summary": "Manage browser authentication sessions, JWT tokens, and storageState for zero-second logins on-demand.",
+            "version": "2.0.0"
+        },
+        {
+            "id": "backend-load-and-stress-patterns",
+            "name": "Backend Load And Stress Patterns",
+            "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.",
+            "category": "test_automation_and_execution",
+            "path": ".agents/skills/backend-load-and-stress-patterns/SKILL.md",
+            "version": "1.0.0"
+        },
+        {
+            "id": "bats-testing-patterns",
+            "name": "Bats Testing Patterns",
+            "category": "test_automation_and_execution",
+            "path": ".agents/skills/bats-testing-patterns/SKILL.md",
+            "summary": "Master Bash Automated Testing System (Bats) for shell scripts and CI/CD pipelines.",
+            "version": "2.0.0"
+        },
+        {
+            "id": "clean-pom-crafter",
+            "name": "Clean POM Crafter",
+            "category": "test_automation_and_execution",
+            "path": ".agents/skills/clean-pom-crafter/SKILL.md",
+            "summary": "Standardized Clean Page Object Model development and Flat Architecture enforcement.",
+            "version": "2.0.0"
+        },
+        {
+            "id": "code-refactoring-refactor-clean",
+            "name": "Code Refactoring Refactor Clean",
+            "category": "architecture_and_analysis",
+            "path": ".agents/skills/code-refactoring-refactor-clean/SKILL.md",
+            "summary": "Master code refactoring, SOLID patterns, code smell elimination, and technical debt reduction.",
+            "version": "2.0.0"
+        },
+        {
+            "id": "db-state-verifier-and-seeder",
+            "name": "Database State Verifier and Seeder",
+            "category": "verification_and_resilience",
+            "path": ".agents/skills/db-state-verifier-and-seeder/SKILL.md",
+            "summary": "Verify database records, seed isolated test fixtures, and assert mutations (SQL/NoSQL) on-demand.",
+            "version": "2.0.0"
+        },
+        {
+            "id": "e2e-testing-patterns",
+            "name": "E2E Testing Patterns",
+            "category": "test_automation_and_execution",
+            "path": ".agents/skills/e2e-testing-patterns/SKILL.md",
+            "summary": "Master end-to-end testing with Playwright and Cypress to build fast and reliable test suites.",
+            "version": "2.0.0"
+        },
+        {
+            "id": "failure-autopsy-and-healing",
+            "name": "Failure Autopsy and Healing",
+            "category": "verification_and_resilience",
+            "path": ".agents/skills/failure-autopsy-and-healing/SKILL.md",
+            "summary": "Automated failure triage, visual error autopsy from screenshots and Allure reports, and in-place code healing.",
+            "version": "2.0.0"
+        },
+        {
+            "id": "file-and-report-validator",
+            "name": "File and Report Validator",
+            "category": "verification_and_resilience",
+            "path": ".agents/skills/file-and-report-validator/SKILL.md",
+            "summary": "Validate uploaded and exported files (Excel .xlsx, CSV, PDF) for correct schemas and data integrity on-demand.",
+            "version": "2.0.0"
+        },
+        {
+            "id": "flaky-test-sentinel-and-quarantine",
+            "name": "Flaky Test Sentinel And Quarantine",
+            "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.",
+            "category": "verification_and_resilience",
+            "path": ".agents/skills/flaky-test-sentinel-and-quarantine/SKILL.md",
+            "version": "1.0.0"
+        },
+        {
+            "id": "github-actions-templates",
+            "name": "GitHub Actions Templates",
+            "category": "architecture_and_analysis",
+            "path": ".agents/skills/github-actions-templates/SKILL.md",
+            "summary": "Production-ready GitHub Actions workflows for automated testing, building, and deploying.",
+            "version": "2.0.0"
+        },
+        {
+            "id": "graphify-impact-analyzer",
+            "name": "Graphify Impact Analyzer",
+            "category": "architecture_and_analysis",
+            "path": ".agents/skills/graphify-impact-analyzer/SKILL.md",
+            "summary": "AST Knowledge Graph exploration, navigation, and zero-waste test impact analysis.",
+            "version": "2.0.0"
+        },
+        {
+            "id": "katalon-cli-runner",
+            "name": "Katalon CLI Runner",
+            "category": "test_automation_and_execution",
+            "path": ".agents/skills/katalon-cli-runner/SKILL.md",
+            "summary": "Adaptive test execution manager supporting licensed KRE CLI and headless automation runs.",
+            "version": "2.0.0"
+        },
+        {
+            "id": "lam-script-generator",
+            "name": "LAM Script Generator",
+            "category": "test_automation_and_execution",
+            "path": ".agents/skills/lam-script-generator/SKILL.md",
+            "summary": "Large Action Model (LAM) script generator transforming user stories into Clean POM scripts.",
+            "version": "2.0.0"
+        },
+        {
+            "id": "playwright-live-interaction",
+            "name": "Playwright Live Interaction",
+            "category": "test_automation_and_execution",
+            "path": ".agents/skills/playwright-live-interaction/SKILL.md",
+            "summary": "Fast live web interaction and interactive DOM/AOM probing via Playwright MCP.",
+            "version": "2.0.0"
+        },
+        {
+            "id": "security-dast-sentinel",
+            "name": "Security DAST Sentinel",
+            "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.",
+            "category": "verification_and_resilience",
+            "path": ".agents/skills/security-dast-sentinel/SKILL.md",
+            "version": "1.0.0"
+        },
+        {
+            "id": "self-healing-locator",
+            "name": "Self Healing Locator",
+            "category": "verification_and_resilience",
+            "path": ".agents/skills/self-healing-locator/SKILL.md",
+            "summary": "Token-efficient self-healing locator skill using Accessibility Tree (AOM) and semantic DOM diffing.",
+            "version": "2.0.0"
+        },
+        {
+            "id": "synthetic-test-data-generator",
+            "name": "Synthetic Test Data Generator",
+            "category": "verification_and_resilience",
+            "path": ".agents/skills/synthetic-test-data-generator/SKILL.md",
+            "summary": "Generate robust, idempotent, and boundary-value synthetic test data for automated test suites.",
+            "version": "2.0.0"
+        },
+        {
+            "id": "token-and-context-optimizer",
+            "name": "Token and Context Optimizer",
+            "category": "context_and_optimization",
+            "path": ".agents/skills/token-and-context-optimizer/SKILL.md",
+            "summary": "Sparse context retrieval, terminal log distillation, context degradation prevention, and file-backed memory scratchpad.",
+            "version": "2.0.0"
+        },
+        {
+            "id": "visual-regression-sentinel",
+            "name": "Visual Regression Sentinel",
+            "category": "verification_and_resilience",
+            "path": ".agents/skills/visual-regression-sentinel/SKILL.md",
+            "summary": "Pixel-level and perceptual visual regression testing with dynamic masking and layout shift detection.",
+            "version": "2.0.0"
+        },
+        {
+            "id": "wcag-audit-patterns",
+            "name": "WCAG Audit Patterns",
+            "category": "architecture_and_analysis",
+            "path": ".agents/skills/wcag-audit-patterns/SKILL.md",
+            "summary": "Conduct WCAG 2.2 accessibility audits with automated testing and remediation guidance.",
+            "version": "2.0.0"
+        },
+        {
+            "id": "web-vitals-and-performance-profiler",
+            "name": "Web Vitals and Performance Profiler",
+            "category": "architecture_and_analysis",
+            "path": ".agents/skills/web-vitals-and-performance-profiler/SKILL.md",
+            "summary": "Profile Core Web Vitals (LCP, CLS, INP/FID, TTFB) and detect slow APIs via CDP on-demand.",
+            "version": "2.0.0"
+        }
+    ]
+}

package/templates/PROJECT_AI_GUIDE_TEMPLATE.md

@@ -0,0 +1,97 @@
+# PROJECT AI GUIDE TEMPLATE: [TARGET_PROJECT_NAME] (`PROJECT_AI_GUIDE.md`)
+
+> **Purpose:** This file provides project-specific business context, technology stack definitions, and execution commands to AI Agents (Antigravity / Cursor / Claude Code).
+> AI Agents combine universal skills from the `agent-skills` hub with the project context declared below.
+
+---
+
+## 1. General System Under Test (SUT) Information
+- **Project / Module Name:** `[e.g., Enterprise Billing Platform / Customer Portal]`
+- **Environments:**
+  - Test / Dev URL: `https://test.example.com`
+  - Staging / UAT URL: `https://staging.example.com`
+- **Frontend Framework:** `[e.g., React 18, Angular 17 + PrimeNG, Vue 3, Next.js]`
+- **Testing Framework:** `[e.g., Playwright Test, Katalon Studio 10.x, Cypress, Selenium]`
+- **Script Language:** `[e.g., TypeScript, Groovy, Python, JavaScript]`
+
+---
+
+## 2. Test Accounts & Authentication Credentials
+- **Admin Account:** `ADMIN_USER` / `ADMIN_PASS` (Sourced via environment variables)
+- **Standard User Account:** `USER_NAME` / `USER_PASS`
+- **Auth Mechanism:** `[e.g., JWT Bearer Token, Cookie StorageState, OAuth2 / OIDC, SSO]`
+- **Zero-Second Auth Storage State Path:** `.auth/user_state.json`
+
+---
+
+## 3. Repository Architecture & Directory Mapping
+- **Page Objects / Page Classes:** `src/pages/...` or `Keywords/pages/...`
+- **Test Scripts / Specs:** `tests/e2e/...` or `Scripts/...`
+- **Test Suites / Collections:** `tests/suites/...` or `Test Suites/...`
+- **Fixtures & Mock Payloads:** `tests/fixtures/...` or `Data Files/...`
+- **Environment Configuration:** `.env` or `Profiles/default.glbl`
+
+---
+
+## 4. Engineering Standards & Quality Gates
+1. **Clean POM Architecture:** 100% of locators, selectors, and assertions encapsulated within Page Classes inheriting from `BasePage`. Zero raw selectors in test scripts.
+2. **Dynamic Test Data:** Always use randomized identifiers with execution timestamp prefixes (`uniqueCode("AUTO_")`) to eliminate DB unique key collisions.
+3. **Encoding Discipline:** 100% `UTF-8 No BOM` across all code, script, and documentation files.
+4. **Smart Wait & Synchronization:** Pure event-driven waiting (`waitForLoadState('networkidle')`, Angular `zone.isStable()`). Static sleeps (`Thread.sleep`, `waitForTimeout`) are strictly forbidden.
+5. **Idempotent Teardown:** Every data creation test case must be paired with automated deletion cleanup in its teardown phase.
+
+---
+
+## 5. Standard CLI Execution Commands
+- **Run Headless E2E Suite:**
+  ```bash
+  [e.g., npx playwright test --project=chromium --reporter=html,junit:results.xml]
+  ```
+- **Run Targeted Test Case:**
+  ```bash
+  [e.g., npx playwright test tests/e2e/login.spec.ts]
+  ```
+- **Execute 7 Quality Gates Verification:**
+  ```bash
+  python tools/verify_all.py
+  ```
+
+---
+
+## 6. Git Push & SCM Workflow
+- **Clean SCM by Architecture:** Because `agent-skills` is a separate external repository, this target project stays 100% clean of AI skills, rules, and prompts. No dual-remote or smart push script is needed.
+- **Push Command:** Commit verified code and push directly to this project's remote branch:
+  ```bash
+  git add <project-files>
+  git commit -m "feat(module): add verified test scenario"
+  git push origin <current-branch>
+  ```
+- **Privacy Mode:** If enterprise policy restricts AI markdown files in the repository, add `PROJECT_AI_GUIDE.md` to `.gitignore`.
+
+---
+
+## 7. Fast Index & Reference Data Configuration (`lookup_tc` & `lookup_xpath`)
+
+To enable instant (<300 tokens) lookups for Test Cases and DOM Locators without cluttering LLM context:
+- **Test Case Metadata File:**
+  - Standard path: `testcases.json` (or `references/testcases.json`)
+  - Environment variable: `TC_DATA_FILE="references/testcases.json"` in `.env`
+  - Lookup command: `python ../agent-skills/tools/lookup_tc.py <TC-ID> --file references/testcases.json`
+- **Scraped Selectors & XPath File:**
+  - Standard path: `selectors.json` (or `references/selectors.json`)
+  - Environment variable: `XPATH_DATA_FILE="references/selectors.json"` in `.env`
+  - Lookup command: `python ../agent-skills/tools/lookup_xpath.py <PageClass> --file references/selectors.json`
+
+---
+
+## 8. First-Time SQLite Memory Cache Bootstrap (CI / Docker / Fresh Clone)
+
+The Central Agent Memory (`~/.agent_memory/global_cache.db`) stores positive healing patches and negative anti-patterns.
+- **In fresh environments (CI runner, Docker container, new developer machine):**
+  Initialize and seed the database with baseline solutions:
+  ```bash
+  agent-qa heal init
+  # or directly via python:
+  python ../agent-skills/tools/cache_resolver.py init
+  ```
+- **Automatic bootstrap:** Running `./scripts/install.ps1` (Windows) or `./scripts/setup.sh` (Linux/macOS) in `agent-skills` performs this initialization automatically.

package/templates/PROJECT_STATE_TEMPLATE.md

@@ -0,0 +1,20 @@
+# Project Execution State (`PROJECT_STATE.md`)
+
+- **Project:** `[PROJECT_NAME]`
+- **Last Sync:** `[TIMESTAMP]`
+- **Overall Status:** `IN_PROGRESS`
+
+## 1. Active Goal
+- [Short description of current sprint or user instruction]
+
+## 2. Task Checklist (Rolling Window - Max 8 active items)
+- [ ] [Task 1]
+- [ ] [Task 2]
+
+## 3. Active Watchpoints & Healing (Max 3 items)
+- Target Suite / Script: `[None]`
+- Failing Locator / Line: `[None]`
+
+## 4. Quality Verification
+- 7 Quality Gates: `PENDING`
+- Clean POM Integrity: `VERIFIED`