digiqagent 1.2.0

package/.cursor-plugin/plugin.json

@@ -0,0 +1,29 @@
+{
+  "name": "digiqagent",
+  "displayName": "DigiQAgent",
+  "description": "QA and testing skills: TDD, systematic debugging, code review, verification, API spec generation, Postman test suites, and Playwright UI testing",
+  "version": "1.2.0",
+  "author": {
+    "name": "Pradeep SA"
+  },
+  "license": "MIT",
+  "keywords": [
+    "qa",
+    "testing",
+    "tdd",
+    "debugging",
+    "code-review",
+    "verification",
+    "swagger",
+    "openapi",
+    "postman",
+    "api-testing",
+    "playwright",
+    "e2e-testing",
+    "angular",
+    "react",
+    "ui-testing"
+  ],
+  "skills": "./skills/",
+  "agents": "./agents/"
+}

package/README.md

@@ -0,0 +1,197 @@
+# DigiQAgent
+
+[![npm version](https://img.shields.io/npm/v/digiqagent.svg)](https://www.npmjs.com/package/digiqagent)
+
+A Cursor plugin focused on QA, testing, debugging, code review, verification workflows, API artifact generation, and Playwright UI testing.
+
+## What's Included
+
+### Skills (9)
+
+| Skill | Triggers When | What It Does |
+|-------|---------------|--------------|
+| **test-driven-development** | Implementing any feature or bugfix | Enforces Red-Green-Refactor: write failing test first, minimal code to pass, then refactor |
+| **systematic-debugging** | Encountering any bug, test failure, or unexpected behavior | 4-phase process: root cause investigation, pattern analysis, hypothesis testing, implementation |
+| **verification-before-completion** | About to claim work is complete or passing | Requires running verification commands and confirming output before making success claims |
+| **requesting-code-review** | Completing tasks or before merging | Dispatches code-reviewer agent with structured checklist and git diff range |
+| **receiving-code-review** | Receiving code review feedback | Ensures technical evaluation over performative agreement; verify before implementing |
+| **swagger-generator** | Generating or updating API documentation | Produces a complete OpenAPI 3.0 spec from codebase analysis or API design documents |
+| **postman-collection-generator** | Creating Postman collections for manual API testing | Generates organized Postman Collection v2.1 with environment files, variables, and pre-request scripts |
+| **postman-test-suite-generator** | Creating API test coverage with positive and negative scenarios | Produces Postman test collection with systematic positive and negative test cases for every endpoint |
+| **playwright-test-generator** | Generating E2E tests for Angular or React frontends | Auto-detects framework, scans components for interactions, generates Playwright tests with Page Object Model covering forms, clicks, navigation, modals, accessibility, and responsive behavior |
+
+### Agent (1)
+
+| Agent | Purpose |
+|-------|---------|
+| **code-reviewer** | Senior code reviewer that checks plan alignment, code quality, architecture, testing, and production readiness |
+
+### Review Prompt Templates (2)
+
+| Template | Purpose |
+|----------|---------|
+| **spec-reviewer-prompt** | Verify implementation matches specification (nothing more, nothing less) |
+| **code-quality-reviewer-prompt** | Verify implementation is well-built (clean, tested, maintainable) |
+
+## API Artifact Generation
+
+The three new API skills form a pipeline that takes your codebase or API design document and produces ready-to-use testing artifacts:
+
+```
+Codebase / Spec Document
+        │
+        ▼
+┌──────────────────────┐
+│  swagger-generator   │ → openapi.yaml
+└──────────┬───────────┘
+           │
+           ▼
+┌──────────────────────────────┐
+│ postman-collection-generator │ → postman_collection.json
+└──────────┬───────────────────┘   postman_environment.json
+           │
+           ▼
+┌───────────────────────────────┐
+│ postman-test-suite-generator  │ → postman_test_collection.json
+└───────────────────────────────┘
+
+Developer imports into Postman and runs manually.
+```
+
+**Workflow:**
+
+1. **Generate the OpenAPI spec** — analyzes routes, controllers, models, middleware, or reads a design document to produce a complete `openapi.yaml`
+2. **Generate the Postman collection** — builds organized requests with folders, environment variables, realistic example data, and pre-request scripts
+3. **Generate the test suite** — adds comprehensive positive and negative test scenarios covering missing fields, invalid types, boundary values, auth failures, not-found cases, duplicates, and more
+
+Each skill can also run independently. The Postman collection generator can work directly from codebase analysis, and the test suite generator can work from an OpenAPI spec.
+
+## UI Test Generation
+
+The Playwright skill handles frontend UI test generation for Angular and React applications:
+
+```
+Angular / React Codebase
+        │
+        ▼
+┌───────────────────────────────┐
+│  Detect Framework & Scan      │
+│  Components, Routes, Forms,   │
+│  Click Events, Modals, Tables │
+└──────────┬────────────────────┘
+           │
+     ┌─────┴──────┐
+     ▼            ▼
+┌──────────┐ ┌───────────┐
+│  Page    │ │ Playwright │
+│ Objects  │ │   Tests    │
+│ (POM)    │ │ (.spec.ts) │
+└────┬─────┘ └─────┬─────┘
+     │             │
+     └──────┬──────┘
+            ▼
+   Developer runs:
+   npx playwright test
+```
+
+**What it covers:**
+
+- **Auto-detection** — identifies Angular vs React, component libraries (Material, MUI, Ant Design), and routing configuration
+- **Component scanning** — discovers click handlers, form bindings, modals, dropdowns, tables, navigation links, conditional rendering
+- **Positive tests** — page load, valid form submission, navigation, modal interactions, table sorting and pagination
+- **Negative tests** — empty required fields, invalid formats, boundary values, unauthorized access, empty/error states, double-submit prevention
+- **Responsive tests** — mobile hamburger menu, sidebar collapse, stacked layouts
+- **Accessibility tests** — keyboard navigation, ARIA labels, focus management, axe-core audits
+
+## Installation
+
+### Via npm (recommended)
+
+```bash
+npx digiqagent install
+```
+
+### Via script
+
+```bash
+# One-liner (after hosting the repo)
+curl -sSL https://raw.githubusercontent.com/<your-org>/digiqagent/main/install.sh | bash
+
+# Or clone and run the script
+git clone <repo-url> && cd digiqagent && ./install.sh
+```
+
+See [INSTALLATION.md](INSTALLATION.md) for the full guide — npm CLI commands, manual install, environment variables, update/uninstall commands, team distribution options, and troubleshooting.
+
+## Usage
+
+Skills activate automatically based on context. You can also invoke them explicitly:
+
+```
+Use digiqagent:test-driven-development
+Use digiqagent:systematic-debugging
+Use digiqagent:verification-before-completion
+Use digiqagent:requesting-code-review
+Use digiqagent:receiving-code-review
+Use digiqagent:swagger-generator
+Use digiqagent:postman-collection-generator
+Use digiqagent:postman-test-suite-generator
+Use digiqagent:playwright-test-generator
+```
+
+## Directory Structure
+
+```
+digiqagent/
+  package.json
+  bin/
+    cli.js
+  .cursor-plugin/
+    plugin.json
+  skills/
+    test-driven-development/
+      SKILL.md
+      testing-anti-patterns.md
+    systematic-debugging/
+      SKILL.md
+      root-cause-tracing.md
+      defense-in-depth.md
+      condition-based-waiting.md
+      condition-based-waiting-example.ts
+      find-polluter.sh
+      CREATION-LOG.md
+      test-academic.md
+      test-pressure-1.md
+      test-pressure-2.md
+      test-pressure-3.md
+    verification-before-completion/
+      SKILL.md
+    requesting-code-review/
+      SKILL.md
+      code-reviewer.md
+    receiving-code-review/
+      SKILL.md
+    review-prompts/
+      spec-reviewer-prompt.md
+      code-quality-reviewer-prompt.md
+    swagger-generator/
+      SKILL.md
+      openapi-patterns.md
+    postman-collection-generator/
+      SKILL.md
+      collection-patterns.md
+    postman-test-suite-generator/
+      SKILL.md
+      test-scenario-patterns.md
+    playwright-test-generator/
+      SKILL.md
+      page-object-patterns.md
+      interaction-test-patterns.md
+  agents/
+    code-reviewer.md
+  README.md
+```
+
+## License
+
+MIT

package/agents/code-reviewer.md

@@ -0,0 +1,48 @@
+---
+name: code-reviewer
+description: |
+  Use this agent when a major project step has been completed and needs to be reviewed against the original plan and coding standards. Examples: <example>Context: The user is creating a code-review agent that should be called after a logical chunk of code is written. user: "I've finished implementing the user authentication system as outlined in step 3 of our plan" assistant: "Great work! Now let me use the code-reviewer agent to review the implementation against our plan and coding standards" <commentary>Since a major project step has been completed, use the code-reviewer agent to validate the work against the plan and identify any issues.</commentary></example> <example>Context: User has completed a significant feature implementation. user: "The API endpoints for the task management system are now complete - that covers step 2 from our architecture document" assistant: "Excellent! Let me have the code-reviewer agent examine this implementation to ensure it aligns with our plan and follows best practices" <commentary>A numbered step from the planning document has been completed, so the code-reviewer agent should review the work.</commentary></example>
+model: inherit
+---
+
+You are a Senior Code Reviewer with expertise in software architecture, design patterns, and best practices. Your role is to review completed project steps against original plans and ensure code quality standards are met.
+
+When reviewing completed work, you will:
+
+1. **Plan Alignment Analysis**:
+   - Compare the implementation against the original planning document or step description
+   - Identify any deviations from the planned approach, architecture, or requirements
+   - Assess whether deviations are justified improvements or problematic departures
+   - Verify that all planned functionality has been implemented
+
+2. **Code Quality Assessment**:
+   - Review code for adherence to established patterns and conventions
+   - Check for proper error handling, type safety, and defensive programming
+   - Evaluate code organization, naming conventions, and maintainability
+   - Assess test coverage and quality of test implementations
+   - Look for potential security vulnerabilities or performance issues
+
+3. **Architecture and Design Review**:
+   - Ensure the implementation follows SOLID principles and established architectural patterns
+   - Check for proper separation of concerns and loose coupling
+   - Verify that the code integrates well with existing systems
+   - Assess scalability and extensibility considerations
+
+4. **Documentation and Standards**:
+   - Verify that code includes appropriate comments and documentation
+   - Check that file headers, function documentation, and inline comments are present and accurate
+   - Ensure adherence to project-specific coding standards and conventions
+
+5. **Issue Identification and Recommendations**:
+   - Clearly categorize issues as: Critical (must fix), Important (should fix), or Suggestions (nice to have)
+   - For each issue, provide specific examples and actionable recommendations
+   - When you identify plan deviations, explain whether they're problematic or beneficial
+   - Suggest specific improvements with code examples when helpful
+
+6. **Communication Protocol**:
+   - If you find significant deviations from the plan, ask the coding agent to review and confirm the changes
+   - If you identify issues with the original plan itself, recommend plan updates
+   - For implementation problems, provide clear guidance on fixes needed
+   - Always acknowledge what was done well before highlighting issues
+
+Your output should be structured, actionable, and focused on helping maintain high code quality while ensuring project goals are met. Be thorough but concise, and always provide constructive feedback that helps improve both the current implementation and future development practices.

package/bin/cli.js

@@ -0,0 +1,210 @@
+#!/usr/bin/env node
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const PLUGIN_NAME = 'digiqagent';
+const PLUGIN_DIR = path.join(os.homedir(), '.cursor', 'plugins', PLUGIN_NAME);
+const PACKAGE_ROOT = path.resolve(__dirname, '..');
+
+const CONTENT_DIRS = ['.cursor-plugin', 'skills', 'agents'];
+
+const colors = {
+  red: (s) => `\x1b[31m${s}\x1b[0m`,
+  green: (s) => `\x1b[32m${s}\x1b[0m`,
+  yellow: (s) => `\x1b[33m${s}\x1b[0m`,
+  cyan: (s) => `\x1b[36m${s}\x1b[0m`,
+};
+
+function printBanner() {
+  console.log('');
+  console.log(colors.cyan('╔══════════════════════════════════════╗'));
+  console.log(colors.cyan('║        DigiQAgent Installer          ║'));
+  console.log(colors.cyan('║   QA · Testing · Code Review · E2E   ║'));
+  console.log(colors.cyan('╚══════════════════════════════════════╝'));
+  console.log('');
+}
+
+function readPluginVersion(pluginRoot) {
+  const manifestPath = path.join(pluginRoot, '.cursor-plugin', 'plugin.json');
+  try {
+    const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+    return manifest.version || 'unknown';
+  } catch {
+    return 'unknown';
+  }
+}
+
+function copyDirRecursive(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyDirRecursive(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+function removeDirRecursive(dirPath) {
+  if (!fs.existsSync(dirPath)) return;
+  const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = path.join(dirPath, entry.name);
+    if (entry.isDirectory()) {
+      removeDirRecursive(fullPath);
+    } else {
+      fs.unlinkSync(fullPath);
+    }
+  }
+  fs.rmdirSync(dirPath);
+}
+
+function listSkills(pluginRoot) {
+  const skillsDir = path.join(pluginRoot, 'skills');
+  if (!fs.existsSync(skillsDir)) return [];
+  return fs.readdirSync(skillsDir, { withFileTypes: true })
+    .filter((d) => d.isDirectory())
+    .map((d) => d.name);
+}
+
+function listAgents(pluginRoot) {
+  const agentsDir = path.join(pluginRoot, 'agents');
+  if (!fs.existsSync(agentsDir)) return [];
+  return fs.readdirSync(agentsDir, { withFileTypes: true })
+    .filter((f) => f.isFile() && f.name.endsWith('.md'))
+    .map((f) => f.name.replace(/\.md$/, ''));
+}
+
+function install() {
+  printBanner();
+
+  for (const dir of CONTENT_DIRS) {
+    const srcDir = path.join(PACKAGE_ROOT, dir);
+    if (!fs.existsSync(srcDir)) {
+      console.log(colors.red(`Error: Source directory "${dir}" not found in package.`));
+      process.exit(1);
+    }
+  }
+
+  const isUpdate = fs.existsSync(PLUGIN_DIR);
+  if (isUpdate) {
+    const oldVersion = readPluginVersion(PLUGIN_DIR);
+    console.log(colors.yellow(`Existing installation found (v${oldVersion}). Updating...`));
+    removeDirRecursive(PLUGIN_DIR);
+  } else {
+    console.log(colors.cyan('Installing DigiQAgent...'));
+  }
+
+  fs.mkdirSync(PLUGIN_DIR, { recursive: true });
+  for (const dir of CONTENT_DIRS) {
+    copyDirRecursive(path.join(PACKAGE_ROOT, dir), path.join(PLUGIN_DIR, dir));
+  }
+
+  const newVersion = readPluginVersion(PLUGIN_DIR);
+
+  console.log('');
+  console.log(colors.green('Installation complete!'));
+  console.log(colors.cyan(`Version: ${newVersion}`));
+  console.log(`Location: ${PLUGIN_DIR}`);
+  console.log('');
+
+  const skills = listSkills(PLUGIN_DIR);
+  if (skills.length > 0) {
+    console.log('Included skills:');
+    skills.forEach((s) => console.log(`  • ${s}`));
+    console.log('');
+  }
+
+  const agents = listAgents(PLUGIN_DIR);
+  if (agents.length > 0) {
+    console.log('Included agents:');
+    agents.forEach((a) => console.log(`  • ${a}`));
+    console.log('');
+  }
+
+  console.log(colors.yellow('Restart Cursor to activate the plugin.'));
+  console.log('');
+}
+
+function uninstall() {
+  if (fs.existsSync(PLUGIN_DIR)) {
+    const version = readPluginVersion(PLUGIN_DIR);
+    console.log(colors.yellow(`Removing DigiQAgent v${version} from ${PLUGIN_DIR}...`));
+    removeDirRecursive(PLUGIN_DIR);
+    console.log(colors.green('Uninstalled. Restart Cursor to complete removal.'));
+  } else {
+    console.log(colors.yellow('DigiQAgent is not installed.'));
+  }
+}
+
+function status() {
+  if (fs.existsSync(PLUGIN_DIR)) {
+    const version = readPluginVersion(PLUGIN_DIR);
+    console.log(colors.green('DigiQAgent is installed.'));
+    console.log(colors.cyan(`Version: ${version}`));
+    console.log(`Location: ${PLUGIN_DIR}`);
+    console.log('');
+    const packageVersion = readPluginVersion(PACKAGE_ROOT);
+    if (packageVersion !== 'unknown' && version !== packageVersion) {
+      console.log(colors.yellow(`Update available: ${version} → ${packageVersion}`));
+      console.log(`Run "digiqagent update" to update.`);
+    } else if (version === packageVersion) {
+      console.log(colors.green('Up to date.'));
+    }
+  } else {
+    console.log(colors.yellow('DigiQAgent is not installed.'));
+    console.log(`Run "digiqagent install" to install.`);
+  }
+}
+
+function showHelp() {
+  console.log(`
+${colors.cyan('DigiQAgent')} — QA & Testing Skills for Cursor IDE
+
+${colors.yellow('Usage:')}
+  digiqagent <command>
+
+${colors.yellow('Commands:')}
+  install     Install or update DigiQAgent into ~/.cursor/plugins/
+  uninstall   Remove DigiQAgent from ~/.cursor/plugins/
+  update      Alias for install (overwrites with current package version)
+  status      Show current installation status
+  help        Show this help message
+
+${colors.yellow('Examples:')}
+  npx digiqagent install
+  npx digiqagent status
+  npx digiqagent uninstall
+`);
+}
+
+const command = process.argv[2] || 'help';
+
+switch (command) {
+  case 'install':
+  case 'update':
+    install();
+    break;
+  case 'uninstall':
+    uninstall();
+    break;
+  case 'status':
+    status();
+    break;
+  case 'help':
+  case '--help':
+  case '-h':
+    showHelp();
+    break;
+  default:
+    console.log(colors.red(`Unknown command: ${command}`));
+    showHelp();
+    process.exit(1);
+}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "digiqagent",
+  "version": "1.2.0",
+  "description": "QA and testing skills for Cursor IDE: TDD, systematic debugging, code review, verification, API spec generation, Postman test suites, and Playwright UI testing",
+  "author": "Pradeep SA",
+  "license": "MIT",
+  "bin": {
+    "digiqagent": "./bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    ".cursor-plugin/",
+    "skills/",
+    "agents/",
+    "README.md"
+  ],
+  "keywords": [
+    "cursor",
+    "cursor-plugin",
+    "qa",
+    "testing",
+    "tdd",
+    "debugging",
+    "code-review",
+    "verification",
+    "swagger",
+    "openapi",
+    "postman",
+    "api-testing",
+    "playwright",
+    "e2e-testing",
+    "angular",
+    "react",
+    "ui-testing"
+  ],
+  "scripts": {
+    "version": "node -e \"const fs=require('fs');const pkg=JSON.parse(fs.readFileSync('package.json','utf8'));const pj='.cursor-plugin/plugin.json';const d=JSON.parse(fs.readFileSync(pj,'utf8'));d.version=pkg.version;fs.writeFileSync(pj,JSON.stringify(d,null,2)+'\\n');\" && git add .cursor-plugin/plugin.json"
+  },
+  "engines": {
+    "node": ">=16.7.0"
+  }}