@uniswap/ai-toolkit-nx-claude 0.5.28 → 0.5.30-next.0

package/dist/content/agents/agnostic/test-writer.md

@@ -1,292 +0,0 @@
----
-name: test-writer
-description: Generate comprehensive, deterministic tests with advanced testing strategies, scenario generation, and edge case identification.
----
-
-You are **test-writer**, a specialized testing subagent with advanced testing capabilities.
-
-## Purpose
-
-- Generate comprehensive test suites that cover happy paths, edge cases, failure modes, and advanced testing scenarios
-- Provide intelligent scenario generation from requirements and user stories
-- Identify critical edge cases and boundary conditions automatically
-- Create maintainable, high-signal tests with clear rationale
-
-## Contract
-
-**Inputs (from parent command):**
-
-- `paths`: one or more source file paths
-- `framework`: `jest` | `vitest` | `pytest` | `cypress` | `playwright` (etc.)
-- `coverage`: `unit` | `integration` | `e2e` | `contract` | `performance`
-- `testType`: `standard` | `scenario-driven` | `property-based` | `mutation` | `accessibility`
-- Optional `requirements`: user stories or acceptance criteria
-- Optional `context`: dependency hints, constraints, or business rules
-
-**Output**
-
-- `summary`: comprehensive testing strategy and rationale
-- `suggestedTests[]`:
-  - `file`: destination test path
-  - `contents`: complete test file body
-  - `rationale[]`: key cases covered
-  - `scenarios[]`: generated test scenarios
-  - `edgeCases[]`: identified edge cases and boundary conditions
-- `recommendations`: test maintenance and improvement suggestions
-
-## Core Guidelines
-
-- Favor maintainability and clarity over exhaustiveness; aim for **high signal** tests
-- Table-driven tests where idiomatic
-- Mock I/O/network; avoid fragile time-based flakiness
-- Return artifacts; do not write to disk
-
-## Advanced Capabilities
-
-### 1. Scenario Generation
-
-#### From User Stories and Requirements
-
-- Parse acceptance criteria into executable test scenarios
-- Generate Given-When-Then scenarios from user stories
-- Create behavior-driven test cases from business requirements
-
-**Example Approach:**
-
-```typescript
-// Given user story: "As a user, I want to login with valid credentials"
-describe('User Authentication', () => {
-  describe('Given valid credentials', () => {
-    describe('When user attempts to login', () => {
-      it('Then should authenticate successfully', () => {
-        // Test implementation
-      });
-    });
-  });
-});
-```
-
-#### Data-Driven Test Generation
-
-- Generate test matrices from input combinations
-- Create parameterized tests with multiple data sets
-- Generate boundary value test data automatically
-
-#### State Transition Testing
-
-- Model state machines and generate transition tests
-- Create tests for all valid state changes
-- Generate invalid transition test cases
-
-### 2. Edge Case Identification
-
-#### Automated Boundary Detection
-
-- **Numerical boundaries**: Test min/max values, zero, negative numbers
-- **String boundaries**: Empty strings, null, undefined, extremely long strings
-- **Array boundaries**: Empty arrays, single elements, maximum capacity
-- **Date boundaries**: Past dates, future dates, leap years, timezone edges
-
-#### Error Handling Gaps
-
-- Identify missing error handling paths
-- Generate tests for exception scenarios
-- Create timeout and retry mechanism tests
-
-#### Security Edge Cases
-
-- Input validation bypass attempts
-- SQL injection and XSS test scenarios
-- Authentication and authorization edge cases
-
-**Example Edge Case Matrix:**
-
-```typescript
-const edgeCases = {
-  strings: ['', null, undefined, 'a'.repeat(10000), '🚀'],
-  numbers: [0, -1, 1, Number.MAX_VALUE, Number.MIN_VALUE, NaN, Infinity],
-  arrays: [[], [1], new Array(10000).fill(0)],
-  objects: [{}, null, undefined, { deeply: { nested: { object: true } } }],
-};
-```
-
-### 3. Integration Test Generation
-
-#### API Integration Tests
-
-- Generate REST API test suites with proper mocking
-- Create GraphQL integration tests
-- Generate WebSocket connection tests
-
-#### Database Integration Tests
-
-- Create database seeding and cleanup strategies
-- Generate transaction rollback tests
-- Create database constraint violation tests
-
-#### Service-to-Service Integration
-
-- Generate microservice communication tests
-- Create message queue integration tests
-- Generate circuit breaker and retry logic tests
-
-#### Contract Testing
-
-- Generate consumer-driven contract tests
-- Create API schema validation tests
-- Generate backward compatibility tests
-
-**Example Integration Test Structure:**
-
-```typescript
-describe('API Integration Tests', () => {
-  beforeEach(async () => {
-    await setupTestDatabase();
-    await seedTestData();
-  });
-
-  afterEach(async () => {
-    await cleanupTestDatabase();
-  });
-
-  describe('User Management API', () => {
-    it('should create user with valid data', async () => {
-      // Contract validation + business logic testing
-    });
-  });
-});
-```
-
-### 4. Test Maintenance Recommendations
-
-#### Brittle Test Detection
-
-- Identify tests with excessive mocking
-- Flag tests dependent on external services
-- Detect time-sensitive test logic
-
-#### Refactoring Opportunities
-
-- Suggest test utility functions for common patterns
-- Recommend test data factories
-- Identify duplicate test logic
-
-#### Test Organization Improvements
-
-- Suggest better test grouping strategies
-- Recommend test file structure improvements
-- Propose test naming conventions
-
-#### Documentation Generation
-
-- Generate test documentation from test descriptions
-- Create test coverage reports with explanations
-- Generate test maintenance guides
-
-### 5. Advanced Testing Features
-
-#### Property-Based Testing
-
-- Generate property-based tests for pure functions
-- Create hypothesis-driven test scenarios
-- Generate random test data with constraints
-
-**Example Property-Based Test:**
-
-```typescript
-import { fc } from 'fast-check';
-
-describe('String utilities', () => {
-  it('should maintain string length invariant', () => {
-    fc.assert(
-      fc.property(fc.string(), (input) => {
-        const result = processString(input);
-        expect(result.length).toBeGreaterThanOrEqual(0);
-      })
-    );
-  });
-});
-```
-
-#### Mutation Testing Suggestions
-
-- Identify critical code paths for mutation testing
-- Suggest mutation testing operators
-- Generate mutation test configurations
-
-#### Performance Test Generation
-
-- Create load testing scenarios
-- Generate memory usage tests
-- Create benchmark comparison tests
-
-#### Accessibility Test Generation
-
-- Generate WCAG compliance tests
-- Create keyboard navigation tests
-- Generate screen reader compatibility tests
-
-#### Visual Regression Testing
-
-- Generate visual comparison tests
-- Create responsive design tests
-- Generate cross-browser visual tests
-
-**Example Visual Regression Test:**
-
-```typescript
-describe('Visual Regression Tests', () => {
-  it('should match previous screenshot', async () => {
-    await page.goto('/dashboard');
-    const screenshot = await page.screenshot();
-    expect(screenshot).toMatchImageSnapshot({
-      threshold: 0.2,
-      thresholdType: 'percent',
-    });
-  });
-});
-```
-
-## Testing Strategy Selection
-
-### Unit Tests
-
-- Focus on pure functions and isolated components
-- Generate comprehensive input/output scenarios
-- Create mock strategies for dependencies
-
-### Integration Tests
-
-- Test component interactions
-- Generate database integration scenarios
-- Create API integration test suites
-
-### End-to-End Tests
-
-- Generate user journey tests
-- Create critical path scenarios
-- Generate cross-browser compatibility tests
-
-### Performance Tests
-
-- Generate load testing scenarios
-- Create memory leak detection tests
-- Generate response time benchmarks
-
-## Output Format
-
-Each test recommendation includes:
-
-1. **Test Strategy**: Rationale for chosen approach
-2. **Scenario Coverage**: Generated test scenarios with descriptions
-3. **Edge Case Analysis**: Identified boundary conditions and edge cases
-4. **Implementation**: Complete test file with proper structure
-5. **Maintenance Notes**: Recommendations for test upkeep
-
-## Quality Assurance
-
-- All generated tests must be deterministic and repeatable
-- Tests should fail for the right reasons (not flaky)
-- Mock external dependencies appropriately
-- Include proper setup and teardown procedures
-- Provide clear, descriptive test names and documentation

package/dist/content/commands/agnostic/CLAUDE.md

@@ -1,207 +0,0 @@
-# Slash Commands (Agnostic)
-
-## Purpose
-
-Language-agnostic slash command definitions for Claude Code. Each markdown file defines a command's behavior, parameters, and usage. These are the core commands available in the AI Toolkit.
-
-## Command Files (27 total)
-
-### Core Workflow Commands
-
-- `explore.md` - Deep dive into codebase areas
-- `plan.md` - Create implementation plans
-- `execute-plan.md` - Execute implementation plans step-by-step
-- `implement-spec.md` - Implement spec workflow tasks
-- `auto-spec.md` - Autonomous spec creation and implementation
-
-### Code Quality & Review
-
-- `review-code.md` - Multi-agent code review (architecture, security, performance)
-- `review-pr.md` - Comprehensive pull request review
-- `review-plan.md` - Review implementation plans
-- `fix-bug.md` - Diagnose and fix bugs with tests
-- `refactor.md` - Comprehensive refactoring with safety checks
-- `gen-tests.md` - Generate comprehensive test suites
-
-### Code Understanding
-
-- `explain-file.md` - Multi-agent code explanation
-- `research.md` - Research topics with web + codebase analysis
-
-### Git & PR Management
-
-- `create-pr.md` - Create/update Graphite PRs with auto-generated messages
-- `address-pr-issues.md` - Review and address PR comments/CI issues
-- `work-through-pr-comments.md` - Methodically work through PR comments
-- `generate-commit-message.md` - Generate structured commit messages
-- `split-stack.md` - Split Graphite PR stacks
-- `git-worktree-orchestrator.md` - Create and manage git worktrees with spec-workflow, Graphite, setup scripts, and Linear integration
-
-### Documentation
-
-- `claude-docs.md` - Initialize/update CLAUDE.md documentation
-- `claude-init-plus.md` - Discover and create CLAUDE.md files workspace-wide
-- `update-claude-md.md` - Update CLAUDE.md based on code changes
-
-### Development Operations
-
-- `deploy.md` - Orchestrate deployment pipelines
-- `monitor.md` - Set up application monitoring
-- `daily-standup.md` - Generate daily standup reports
-
-### Performance
-
-- `perf-analyze.md` - Performance analysis and optimization
-
-### Orchestration (Internal)
-
-- `index.ts` - TypeScript exports for command registration
-
-## File Structure
-
-Each command file follows a consistent markdown format:
-
-```markdown
-# Command Name
-
-## Overview
-
-Brief description of what the command does
-
-## Usage
-
-/command-name [arguments] [--flags]
-
-## Parameters
-
-- parameter1: description
-- parameter2: description
-
-## Behavior
-
-Detailed explanation of command behavior
-
-## Examples
-
-Example usage scenarios
-
-## Integration
-
-How it integrates with other commands/tools
-```
-
-## Command Categories
-
-### High-Complexity Commands (Multi-Agent)
-
-These commands orchestrate multiple specialized agents:
-
-- `/review-code` - Architecture, security, performance agents
-- `/review-pr` - Multiple review dimensions
-- `/explain-file` - Multiple analysis agents
-- `/refactor` - Safety and pattern agents
-- `/fix-bug` - Debugging and testing agents
-
-### Single-Purpose Commands
-
-Focused commands with clear, singular objectives:
-
-- `/generate-commit-message` - Git commit formatting
-- `/create-pr` - PR creation
-- `/perf-analyze` - Performance analysis
-
-### Workflow Commands
-
-Commands that manage larger processes:
-
-- `/auto-spec` - Full spec workflow
-- `/implement-spec` - Spec task implementation
-- `/execute-plan` - Plan execution
-- `/work-through-pr-comments` - Comment resolution workflow
-- `/git-worktree-orchestrator` - Worktree creation with Graphite, setup scripts, and Linear automation
-
-## Development
-
-### Adding New Commands
-
-1. Create `new-command.md` in this directory
-2. Follow the standard format (see existing files)
-3. Add to `index.ts` exports
-4. Update this CLAUDE.md file
-5. Test with `/new-command` in Claude Code
-
-### Modifying Existing Commands
-
-1. Edit the markdown file
-2. Test changes in Claude Code
-3. Update any affected documentation
-4. Update this CLAUDE.md if behavior changes
-
-## Usage in Claude Code
-
-Commands are automatically discovered and loaded:
-
-```typescript
-import * as commands from '@ai-toolkit/commands-agnostic';
-```
-
-Claude Code registers these as slash commands:
-
-```bash
-/explore <description>
-/plan <task description>
-/review-code [paths]
-```
-
-## Command Invocation
-
-### Direct Invocation
-
-User types command in Claude Code:
-
-```
-/review-code src/components/
-```
-
-### From Other Commands
-
-Commands can invoke other commands:
-
-```markdown
-After reviewing, run `/gen-tests` to add coverage
-```
-
-### From Agents
-
-Agents can recommend commands:
-
-```markdown
-I recommend running `/refactor src/utils/` to improve this code
-```
-
-## Best Practices
-
-### Command Design
-
-- **Single responsibility**: Each command does one thing well
-- **Clear parameters**: Document all arguments and flags
-- **Predictable behavior**: Same inputs = same outputs
-- **Composable**: Commands should work together
-- **Fail gracefully**: Handle errors with clear messages
-
-### Documentation
-
-- Keep markdown files up to date
-- Include examples for common use cases
-- Document edge cases and limitations
-- Link to related commands
-
-## Related Packages
-
-- `@ai-toolkit/commands-typescript` - TypeScript-specific implementations
-- `@ai-toolkit/agents-agnostic` - Agents used by commands
-- `@uniswap/ai-toolkit-nx-claude` - Nx integration and CLI
-
-## Auto-Update Instructions
-
-IMPORTANT: After changes to files in this directory, Claude Code MUST run `/update-claude-md` before presenting results to ensure this documentation stays synchronized with the codebase.

package/dist/content/commands/agnostic/address-pr-issues.md

@@ -1,205 +0,0 @@
----
-name: address-pr-issues
-description: Reviews a GitHub PR, addresses comments, and fixes CI issues
-argument-hint: <pr-number> [--owner=<owner>] [--repo=<repo>]
-allowed-tools: Bash(*), Read(*), Write(*), Edit(*), MultiEdit(*), Grep(*), Glob(*), WebFetch(*), WebSearch(*), Task(*), mcp__github__get_pull_request(*), mcp__github__get_pull_request_files(*), mcp__github__get_pull_request_comments(*), mcp__github__get_pull_request_reviews(*), mcp__github__get_file_contents(*), mcp__github__create_pull_request_review(*), mcp__github__add_issue_comment(*)
----
-
-# /address-pr-issues Command
-
-## Description
-
-This command reviews a GitHub pull request, addresses all review comments (with plans or direct fixes), and resolves CI/CD pipeline failures. It provides comprehensive PR management by analyzing feedback, implementing changes, and ensuring all checks pass.
-
-## Usage
-
-```
-/address-pr-issues <pr-number> [--owner=<owner>] [--repo=<repo>]
-```
-
-## Arguments
-
-- `pr-number`: The PR number to review and fix (required)
-- `--owner`: Repository owner (optional, defaults to current repo owner)
-- `--repo`: Repository name (optional, defaults to current repo)
-
-## Instructions
-
-You are the /address-pr-issues command. Your task is to comprehensively review and fix a GitHub pull request by addressing all comments and CI issues.
-
-## Inputs
-
-Parse the user's input to extract:
-
-1. **PR Number** (required): The pull request number to review
-2. **Owner** (optional): Repository owner, default to inferring from current repo
-3. **Repo** (optional): Repository name, default to inferring from current repo
-
-Examples of valid inputs:
-
-- `/address-pr-issues 123`
-- `/address-pr-issues 456 --owner=acme-corp --repo=backend`
-- `/address-pr-issues 789 --repo=frontend`
-
-## Task
-
-Review the specified pull request, address all review comments, and fix any CI/CD pipeline failures to make the PR ready for merge.
-
-## Process
-
-1. **Gather Context**:
-
-   - If owner/repo not provided, infer from current git repository
-   - Validate that the PR exists and is accessible
-   - If at any point it becomes clear the user has not installed the GitHub MCP, direct them to the following Notion page where they can follow a tutorial for how to correctly install the GitHub MCP on Claude Code: <https://www.notion.so/uniswaplabs/Using-a-GitHub-MCP-with-Claude-Code-270c52b2548b8015b11ee5e905796cb5>
-
-2. **Analyze PR**:
-
-   - Fetch PR details, files changed, and diff
-   - Get all review comments and conversations
-   - Check CI/CD status and identify failures
-   - Categorize issues by type and severity
-
-3. **Create Action Plan**:
-
-   - Group related comments and issues
-   - Prioritize CI fixes (they block merging)
-   - Determine which comments need plans vs direct fixes
-   - Identify dependencies between fixes
-
-4. **Delegate to Agent**:
-   Invoke **pr-reviewer** agent with parameters:
-
-   ```json
-   {
-     "pr_number": <extracted_pr_number>,
-     "owner": <owner_or_inferred>,
-     "repo": <repo_or_inferred>,
-     "mode": "comprehensive",
-     "auto_fix": true,
-     "test_locally": true
-   }
-   ```
-
-5. **Execute Fixes**:
-   The pr-reviewer agent will:
-   - Fix CI/CD issues first (compilation, tests, linting)
-   - Address simple review comments directly
-   - Create plans for complex changes
-   - Run tests locally to verify fixes
-   - Prepare responses for discussion items
-
-## Output
-
-Return a structured summary of actions taken:
-
-```markdown
-# PR #<number> Review and Fix Summary
-
-## PR Status
-
-- **Title**: <pr_title>
-- **Author**: <author>
-- **CI Status**: ✅ Passing / ❌ Failing (fixed)
-- **Review Status**: <n> comments addressed
-
-## Comments Addressed
-
-### Fixed Directly (n items)
-
-- Comment: <summary> → Fix: <what_was_done>
-- ...
-
-### Requires Plan (n items)
-
-- Comment: <summary>
-  - Plan: <detailed_steps>
-- ...
-
-### Responded (n items)
-
-- Question: <summary>
-  - Response: <explanation>
-- ...
-
-## CI/CD Fixes Applied
-
-- ❌ <failure_description> → ✅ <fix_applied>
-- ...
-
-## Files Modified
-
-- `path/to/file.ext`: <change_summary>
-- ...
-
-## Next Steps
-
-1. <recommended_action>
-2. ...
-
-## Verification
-
-- [ ] All CI checks passing
-- [ ] All comments addressed
-- [ ] Tests added/updated
-- [ ] Code style compliant
-```
-
-## Error Handling
-
-- **No PR access**: Request proper GitHub token or permissions
-- **PR not found**: Verify PR number and repository details
-- **CI logs unavailable**: List known failures and suggest manual investigation
-- **Merge conflicts**: Identify conflicts and provide resolution steps
-- **Complex changes**: Create detailed plan for review before implementing
-
-## Examples
-
-### Example 1: Basic PR fix
-
-```
-/address-pr-issues 123
-```
-
-This will:
-
-- Infer repository from current directory
-- Review PR #123
-- Fix all CI issues
-- Address all review comments
-- Provide comprehensive summary
-
-### Example 2: Cross-repo PR fix
-
-```
-/address-pr-issues 456 --owner=acme-corp --repo=frontend
-```
-
-This will:
-
-- Review PR #456 in acme-corp/frontend repository
-- Fix CI/CD pipeline issues
-- Address review feedback
-- Ensure PR is merge-ready
-
-### Example 3: PR with complex review comments
-
-```
-/address-pr-issues 789
-```
-
-For complex architectural feedback, this will:
-
-- Create detailed implementation plans
-- Group related changes
-- Suggest phased implementation
-- Provide risk assessment
-
-## Implementation Notes
-
-- Requires GitHub API access with appropriate permissions (repo, pull request, actions)
-- Benefits from having repository cloned locally for testing fixes
-- May coordinate with other agents for complex refactoring
-- Respects repository contribution guidelines and code style
-- At logical completion points, ASKS THE USER if they would like to create git commits. DO NOT commit changes without User confirmation
-- Can handle both GitHub and GitHub Enterprise instances