{"id":29127795,"url":"https://github.com/synidsweet/claude-testing-infrastructure","last_synced_at":"2026-05-01T08:31:33.117Z","repository":{"id":301555477,"uuid":"1009622992","full_name":"SynidSweet/claude-testing-infrastructure","owner":"SynidSweet","description":"AI-first testing infrastructure for JavaScript/TypeScript and Python projects","archived":false,"fork":false,"pushed_at":"2025-06-27T13:18:34.000Z","size":402,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-27T13:42:41.399Z","etag":null,"topics":["ai-agents","developer-tools","javascript","jest","pytest","python","testing","testing-framework","typescript"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SynidSweet.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-27T12:39:48.000Z","updated_at":"2025-06-27T13:18:38.000Z","dependencies_parsed_at":"2025-06-27T13:42:44.539Z","dependency_job_id":"c83cc59b-a930-47c7-ad7d-2ae5ee5e8660","html_url":"https://github.com/SynidSweet/claude-testing-infrastructure","commit_stats":null,"previous_names":["synidsweet/claude-testing-infrastructure"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/SynidSweet/claude-testing-infrastructure","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SynidSweet%2Fclaude-testing-infrastructure","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SynidSweet%2Fclaude-testing-infrastructure/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SynidSweet%2Fclaude-testing-infrastructure/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SynidSweet%2Fclaude-testing-infrastructure/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SynidSweet","download_url":"https://codeload.github.com/SynidSweet/claude-testing-infrastructure/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SynidSweet%2Fclaude-testing-infrastructure/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262690385,"owners_count":23349168,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","developer-tools","javascript","jest","pytest","python","testing","testing-framework","typescript"],"created_at":"2025-06-30T01:01:54.318Z","updated_at":"2026-05-01T08:31:33.100Z","avatar_url":"https://github.com/SynidSweet.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Claude Testing Infrastructure\n\nA comprehensive, AI-agent-friendly testing infrastructure for JavaScript/TypeScript and Python projects. This decoupled approach implements comprehensive testing in any codebase within minutes, not hours.\n\n## 🔒 IMPORTANT: This is Infrastructure\n\n**Clone this repo into your project and use as-is. Do NOT modify files.**\n\n- ✅ Clone into your project directory\n- ✅ Pull updates regularly: `git pull origin main`\n- ✅ Report bugs via GitHub issues (mention `@claude` for automated assistance)\n- ❌ Never modify infrastructure files\n\n## 🚀 Quick Start for AI Agents\n\nAfter cloning this repository:\n\n### Decoupled Testing Infrastructure (Zero Project Modification)\n```bash\nnpm install\nnpm run build\n\n# Analyze any project\nnode dist/src/cli/index.js analyze /path/to/your/project\n\n# Generate comprehensive tests\nnode dist/src/cli/index.js test /path/to/your/project\n\n# Run tests with coverage\nnode dist/src/cli/index.js run /path/to/your/project --coverage\n```\nThis maintains tests externally while providing complete testing infrastructure that updates via `git pull`.\n\n## 🎯 What This Project Does\n\nThis infrastructure helps you:\n- **Set up comprehensive testing** in under 10 minutes\n- **Support both JavaScript/TypeScript and Python** projects automatically\n- **Generate test templates** for your specific framework (React, Vue, Express, FastAPI, Django, etc.)\n- **Achieve \u003e80% test coverage** with provided templates and patterns\n- **Integrate with CI/CD** platforms like GitHub Actions\n\n## 📖 For AI Agents: Navigation Guide\n\n1. **First Time?** Read `AI_AGENT_GUIDE.md` for stable, comprehensive project navigation\n2. **Architecture Questions?** See `/docs/architecture/overview.md` for design philosophy\n3. **Full Documentation Hub?** See `PROJECT_CONTEXT.md` for modular documentation structure\n4. **User Guide?** See `/docs/user/getting-started.md` for complete usage examples\n\n## 🔧 Installation \u0026 Setup\n\n### Prerequisites\n- Node.js 14+ \n- Git\n- Target project runtime (Python 3.9+ for Python projects)\n\n### Git Ownership Setup\nIf you encounter git dubious ownership warnings:\n```bash\n# Add the infrastructure directory to git safe.directory\ngit config --global --add safe.directory \"$(pwd)\"\n\n# Or for the target project if needed\ngit config --global --add safe.directory \"/path/to/your/project\"\n```\n\n### Installation Options\n\n#### For Testing Your Own Projects (Recommended)\nUse the clean deployment branch that contains only the core infrastructure:\n```bash\ngit clone -b deploy/clean https://github.com/SynidSweet/claude-testing-infrastructure.git\ncd claude-testing-infrastructure\nnpm install\nnpm run build\n```\n\n#### For Contributing to the Infrastructure\nUse the main branch with full development environment:\n```bash\ngit clone https://github.com/SynidSweet/claude-testing-infrastructure.git\ncd claude-testing-infrastructure\nnpm install\nnpm run build\n```\n\n2. **Analyze Your Project**\n   ```bash\n   node dist/src/cli/index.js analyze /path/to/your/project\n   ```\n\n3. **Generate Tests**\n   ```bash\n   node dist/src/cli/index.js test /path/to/your/project\n   ```\n\n4. **Run Tests with Coverage**\n   ```bash\n   node dist/src/cli/index.js run /path/to/your/project --coverage\n   ```\n\n5. **Watch Mode for Development**\n   ```bash\n   node dist/src/cli/index.js watch /path/to/your/project\n   ```\n\n## 🎓 Examples\n\n### JavaScript/React Project\n```bash\n# Template approach\ncd ai-testing-template\nnpm run init\n# Select: Frontend \u003e React \u003e JavaScript\n# Testing is now set up in your project!\n\n# Decoupled approach\ncd decoupled-testing-suite\nnpm run discover -- --project-path ../my-react-app\nnpm run init\nnpm run test\n```\n\n### Python/FastAPI Project\n```bash\n# Template approach\ncd ai-testing-template\nnpm run init\n# Select: Backend \u003e FastAPI \u003e Python\n# Testing is now set up in your project!\n\n# Decoupled approach\ncd decoupled-testing-suite\nnpm run discover -- --project-path ../my-fastapi-app\nnpm run init\nnpm run test\n```\n\n## 🏗️ Architecture Overview\n\nThis project uses a **Language Adapter Pattern** to support multiple languages:\n\n```\n┌─────────────────────┐     ┌──────────────────────┐\n│  Template Approach  │     │  Decoupled Approach  │\n│  (Modifies Project) │     │  (Zero Modification) │\n└──────────┬──────────┘     └──────────┬───────────┘\n           │                            │\n           └──────────┬─────────────────┘\n                      │\n            ┌─────────▼──────────┐\n            │  Adapter Factory   │\n            └─────────┬──────────┘\n                      │\n     ┌────────────────┼────────────────┐\n     │                │                │\n┌────▼─────┐   ┌─────▼──────┐  ┌─────▼──────┐\n│JavaScript│   │   Python    │  │Multi-Lang  │\n│ Adapter  │   │  Adapter    │  │  Adapter   │\n└──────────┘   └─────────────┘  └────────────┘\n```\n\n## 📚 Key Features\n\n### Automatic Language Detection\n- Detects JavaScript/TypeScript projects via package.json\n- Detects Python projects via setup.py, pyproject.toml, requirements.txt\n- Supports full-stack projects with both languages\n\n### Framework-Specific Support\n- **JavaScript**: React, Vue, Angular, Express, Next.js, Nest.js\n- **Python**: FastAPI, Django, Flask, Pytest, unittest\n- **Testing**: Jest, Vitest, pytest, Playwright, Cypress\n\n### Comprehensive Test Templates\n- Unit tests with mocking patterns\n- Integration tests for APIs\n- Component tests for UI\n- End-to-end test setups\n- Performance testing templates\n\n### CI/CD Integration\n- GitHub Actions workflows\n- GitLab CI templates\n- Coverage reporting\n- Automated test runs\n\n## 🤖 AI Agent Instructions\n\nWhen implementing testing for a project:\n\n1. **Analyze the Project**\n   ```bash\n   # Check project type\n   ls package.json setup.py pyproject.toml requirements.txt\n   ```\n\n2. **Analyze Project Structure**\n   ```bash\n   node dist/src/cli/index.js analyze /path/to/your/project\n   ```\n\n3. **Generate and Run Tests**\n   ```bash\n   node dist/src/cli/index.js test /path/to/your/project\n   node dist/src/cli/index.js run /path/to/your/project --coverage\n   ```\n\n4. **Customize as Needed**\n   - Modify test templates for project-specific needs\n   - Add custom test utilities\n   - Configure coverage thresholds\n   - Set up CI/CD pipelines\n\n## 🛠️ Available Commands\n\n### Production CLI Commands\n```bash\nnode dist/src/cli/index.js analyze \u003cpath\u003e     # Analyze project structure\nnode dist/src/cli/index.js test \u003cpath\u003e        # Generate comprehensive tests\nnode dist/src/cli/index.js run \u003cpath\u003e         # Run generated tests\nnode dist/src/cli/index.js watch \u003cpath\u003e       # Watch mode for development\n\n# Additional options\nnode dist/src/cli/index.js test \u003cpath\u003e --only-structural  # Skip AI generation\nnode dist/src/cli/index.js run \u003cpath\u003e --coverage          # With coverage report\nnode dist/src/cli/index.js test \u003cpath\u003e --config \u003cfile\u003e    # Custom configuration\n```\n\n## 📋 Configuration\n\n### Test Configuration Files\n- **JavaScript**: `jest.config.js`, `vitest.config.js`, `.eslintrc.test.js`\n- **Python**: `pytest.ini`, `setup.cfg`, `.coveragerc`\n- **E2E**: `playwright.config.js`, `cypress.config.js`\n\n### Environment Variables\n```bash\n# .env.test\nTEST_ENV=test\nDATABASE_URL=sqlite:///test.db\nAPI_BASE_URL=http://localhost:3000\n```\n\n## 🐛 Troubleshooting\n\n### Common Issues\n\n1. **\"Cannot find project type\"**\n   - Ensure you're in the correct directory\n   - Check for package.json or Python config files\n   - Use `--project-path` flag for custom locations\n\n2. **\"Tests failing after setup\"**\n   - Run `npm install` or `pip install -r requirements.txt`\n   - Check Node/Python version compatibility\n   - Verify all dependencies are installed\n\n3. **\"Permission denied errors\"**\n   - Check file permissions\n   - Run with appropriate user permissions\n   - Use `--force` flag if necessary\n\n### Debug Mode\n```bash\n# Run with debug output\nDEBUG=* npm run init\n\n# Verbose logging\nnpm run init -- --verbose\n```\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\n\n### Development Setup\n```bash\n# Clone the repository\ngit clone \u003crepository-url\u003e\ncd claude-testing\n\n# Install all dependencies\nnpm install\n\n# Run tests\nnpm test\n\n# Check code style\nnpm run lint\n```\n\n## 📄 License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n## 🔗 Quick Links\n\n- [Documentation Hub](PROJECT_CONTEXT.md)\n- [Architecture Overview](/docs/architecture/overview.md)\n- [AI Agent Primary Guide](AI_AGENT_GUIDE.md) - **Protected \u0026 Stable**\n- [AI Agent Legacy Guide](CLAUDE.md) - Working Document\n- [User Guide](/docs/user/getting-started.md)\n- [API Reference](/docs/api/interfaces.md)\n\n---\n\n*Built with ❤️ for AI agents and developers who value comprehensive testing*\\n\n## Task \u0026 Sprint Management\n\nThis project uses a JSON-based Task \u0026 Sprint Management System for organized development.\n\n**Team Prefix**: `CTI`\n\n### Quick Commands\n```bash\n# Check current sprint and tasks\nclaude-tasks sprint current\n\n# Add new tasks to backlog\nclaude-tasks backlog add \"Feature description\"\n\n# Plan new sprint from backlog\nclaude-tasks sprint plan --interactive\n```\n\n### Sprint Discipline\nWhen a sprint is active, work **only** on sprint tasks. This ensures focused development and clear progress tracking.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsynidsweet%2Fclaude-testing-infrastructure","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsynidsweet%2Fclaude-testing-infrastructure","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsynidsweet%2Fclaude-testing-infrastructure/lists"}