@codemieai/code 0.1.0 → 0.2.0

package/dist/agents/plugins/claude/plugin/claude-templates/templates/guides/data/database-patterns.md.template

@@ -1,248 +0,0 @@
----
-# Database Patterns
-
-<!--
-GENERATION INSTRUCTIONS:
-1. Detect ORM/query builder/raw SQL approach
-2. Scan models/entities for relationships
-3. Extract actual query patterns from repositories/services
-4. Find transaction usage examples
-5. Locate migration files and commands
-6. Output: 150-300 lines max
--->
-
-**Project**: [Extract from config]
-**Database**: [Detect: PostgreSQL | MySQL | MongoDB | SQLite | etc.]
-**Data Access**: [Detect: ORM (name) | Query Builder | Raw SQL | Mixed]
-**Models Location**: `[Detect path]`
-
----
-
-## Connection Setup
-
-<!-- Extract actual connection configuration -->
-
-```[lang]
-// Source: [file:lines]
-[Extract connection/pool configuration]
-```
-
-**Environment Variables**:
-| Variable | Purpose |
-|----------|---------|
-| `[DB_HOST/DATABASE_URL]` | [Connection string or host] |
-| `[DB_NAME]` | [Database name] |
-| `[DB_POOL_SIZE]` | [Pool size if configured] |
-
----
-
-## Data Access Pattern
-
-<!-- Identify how this codebase accesses data -->
-
-**Pattern**: [Detect: Repository | Active Record | DAO | Direct ORM | Service Layer]
-
-```[lang]
-// Source: [file:lines]
-[Extract canonical data access example - the PRIMARY pattern used]
-```
-
-**To add new data access:**
-1. Create in `[detected path]`
-2. Follow pattern: `[detected naming convention]`
-3. Inject/import via `[detected DI or import pattern]`
-
----
-
-## Entity/Model Definition
-
-<!-- Extract representative model showing conventions -->
-
-```[lang]
-// Source: [file:lines]
-[Extract one model with relationships, validations, typical fields]
-```
-
-**Conventions:**
-| Aspect | Convention |
-|--------|------------|
-| Table naming | `[singular/plural, snake_case/PascalCase]` |
-| Primary key | `[id/uuid/_id pattern]` |
-| Timestamps | `[created_at/createdAt, updated_at/updatedAt]` |
-| Soft delete | `[deleted_at field or N/A]` |
-
----
-
-## Relationships
-
-<!-- Scan models and document relationship patterns -->
-
-```
-[EntityA] ──1:N──► [EntityB] ──N:M──► [EntityC]
-                       │
-                   1:1─┴─► [EntityD]
-```
-
-| Relationship | Implementation | Source |
-|--------------|----------------|--------|
-| One-to-Many | `[syntax used]` | `[file:line]` |
-| Many-to-Many | `[syntax used]` | `[file:line]` |
-| One-to-One | `[syntax used]` | `[file:line]` |
-
----
-
-## Query Patterns
-
-<!-- Extract actual query patterns used in codebase -->
-
-### Basic Operations
-
-| Operation | Pattern | Source |
-|-----------|---------|--------|
-| Find by ID | `[extract syntax]` | `[file:line]` |
-| Find many | `[extract syntax]` | `[file:line]` |
-| Create | `[extract syntax]` | `[file:line]` |
-| Update | `[extract syntax]` | `[file:line]` |
-| Delete | `[extract syntax]` | `[file:line]` |
-
-### Filtering & Search
-
-```[lang]
-// Source: [file:lines]
-[Extract example with WHERE conditions, filtering]
-```
-
-### Pagination
-
-```[lang]
-// Source: [file:lines]
-[Extract pagination implementation]
-```
-
-**Type**: [Offset-based | Cursor-based | Keyset]
-**Params**: `[page/limit or cursor/take]`
-
-### Complex Query Example
-
-```[lang]
-// Source: [file:lines]
-[Extract query with joins, aggregations, or subqueries if exists]
-```
-
----
-
-## Transactions
-
-<!-- Find transaction usage in codebase -->
-
-```[lang]
-// Source: [file:lines]
-[Extract transaction pattern]
-```
-
-**Transaction boundaries managed at**: `[Service layer | Repository | Controller]`
-
-**Rules in this codebase:**
-- [Extract or infer transaction conventions]
-- [When transactions are used]
-
----
-
-## Eager Loading / N+1 Prevention
-
-<!-- Find include/join/populate patterns -->
-
-```[lang]
-// Source: [file:lines]
-[Extract eager loading example]
-```
-
-**Syntax**: `[include/populate/joinedLoad/with - whatever ORM uses]`
-
----
-
-## Migrations
-
-<!-- Extract exact commands from package.json, Makefile, or docs -->
-
-| Action | Command |
-|--------|---------|
-| Create migration | `[exact command]` |
-| Run pending | `[exact command]` |
-| Rollback last | `[exact command]` |
-| Check status | `[exact command]` |
-
-**Migrations location**: `[path]`
-
-**Naming convention**: `[timestamp_description | sequential | etc.]`
-
-```[lang]
-// Source: [file:lines]
-[Extract example migration structure]
-```
-
----
-
-## Seeding / Fixtures
-
-<!-- Find seed data patterns if they exist -->
-
-| Action | Command |
-|--------|---------|
-| Run seeds | `[command or N/A]` |
-| Reset + seed | `[command or N/A]` |
-
-**Seeds location**: `[path or N/A]`
-
----
-
-## Raw Queries
-
-<!-- Find if/how raw SQL is used -->
-
-**Used for**: [Complex reports | Bulk operations | Not used | etc.]
-
-```[lang]
-// Source: [file:lines] - ALWAYS parameterized
-[Extract parameterized raw query example]
-```
-
-⚠️ **Never**: String interpolation → SQL injection risk
-
----
-
-## Error Handling
-
-<!-- Find database error handling patterns -->
-
-| Error Type | Handling | Source |
-|------------|----------|--------|
-| Not found | `[throw/return pattern]` | `[file:line]` |
-| Duplicate key | `[catch/handle pattern]` | `[file:line]` |
-| Connection error | `[retry/fail pattern]` | `[file:line]` |
-
----
-
-## Conventions Summary
-
-| ✅ DO | ❌ DON'T |
-|-------|----------|
-| Use `[detected data access pattern]` | Direct DB calls in `[wrong layer]` |
-| `[eager load syntax]` for relations | Lazy load in loops (N+1) |
-| Parameterized queries | String interpolation |
-| Transactions for multi-writes | Individual saves for related data |
-| `[soft delete if used]` | Hard delete `[if soft delete is convention]` |
-
----
-
-## Quick Reference
-
-| Need | Location | Pattern |
-|------|----------|---------|
-| Models/Entities | `[path]` | `[naming]` |
-| Repositories/DAOs | `[path]` | `[naming]` |
-| Migrations | `[path]` | `[naming]` |
-| Seeds | `[path]` | `[naming]` |
-| DB Config | `[path]` | - |
-
----

package/dist/agents/plugins/claude/plugin/claude-templates/templates/guides/development/development-practices.md.template

@@ -1,298 +0,0 @@
----
-# Development Practices
-
-<!--
-GENERATION INSTRUCTIONS:
-1. Scan for linter/formatter configs (.eslintrc, .prettierrc, pyproject.toml, etc.)
-2. Extract naming patterns from existing code
-3. Find error handling patterns in services/controllers
-4. Locate logging usage and configuration
-5. Check for pre-commit hooks, CI config
-6. Output: 150-300 lines max
--->
-
-**Project**: [Extract from config]
-**Language**: [Detect] | **Framework**: [Detect]
-**Linter**: [Detect] | **Formatter**: [Detect]
-
----
-
-## Code Style
-
-<!-- Extract from linter config + analyze existing code patterns -->
-
-### Naming Conventions
-
-| Element | Convention | Example |
-|---------|------------|---------|
-| Files | `[kebab-case/snake_case/PascalCase]` | `[actual example from codebase]` |
-| Classes | `[PascalCase]` | `[actual example]` |
-| Functions | `[camelCase/snake_case]` | `[actual example]` |
-| Variables | `[camelCase/snake_case]` | `[actual example]` |
-| Constants | `[UPPER_SNAKE_CASE]` | `[actual example]` |
-| Private | `[_prefix/no prefix/#private]` | `[actual example]` |
-
-### File Organization
-
-```[lang]
-// Source: [representative file path]
-// Standard file structure in this codebase:
-
-[Extract typical file structure showing imports, class/function order]
-```
-
-### Import Order
-
-<!-- Extract from linter config or consistent patterns -->
-
-```[lang]
-// 1. [Standard library / Built-ins]
-// 2. [External packages / Third-party]
-// 3. [Internal modules / Local imports]
-
-[Extract example showing import organization]
-```
-
----
-
-## Code Quality
-
-<!-- Find linter/formatter configuration -->
-
-### Commands
-
-| Action | Command | Auto-fix |
-|--------|---------|----------|
-| Lint | `[exact command]` | `[fix command]` |
-| Format | `[exact command]` | `[format write command]` |
-| Type check | `[command or N/A]` | - |
-| All checks | `[combined command if exists]` | - |
-
-### Configuration Files
-
-| Tool | Config File |
-|------|-------------|
-| Linter | `[.eslintrc / .pylintrc / etc.]` |
-| Formatter | `[.prettierrc / pyproject.toml / etc.]` |
-| Type checker | `[tsconfig.json / mypy.ini / etc.]` |
-
-### Pre-commit Hooks
-
-<!-- Check for .pre-commit-config.yaml, husky, lint-staged -->
-
-```bash
-# Setup (if not auto-installed)
-[pre-commit install command or N/A]
-```
-
-**Runs on commit**: [List what runs - lint, format, tests]
-
----
-
-## Error Handling
-
-<!-- Extract exception classes and handling patterns -->
-
-### Exception Types
-
-| Exception | Use When | Source |
-|-----------|----------|--------|
-| `[ValidationError]` | Invalid input data | `[file:line]` |
-| `[NotFoundError]` | Resource doesn't exist | `[file:line]` |
-| `[UnauthorizedError]` | Auth required/failed | `[file:line]` |
-| `[ForbiddenError]` | Permission denied | `[file:line]` |
-| `[ConflictError]` | State conflict | `[file:line]` |
-
-### Pattern
-
-```[lang]
-// Source: [file:lines]
-[Extract canonical error throwing/handling pattern]
-```
-
-**Rules:**
-- Throw specific exceptions from `[exceptions path]`
-- Let `[error handler/middleware]` convert to response
-- ❌ Never catch-and-ignore silently
-
----
-
-## Logging
-
-<!-- Find logging configuration and usage patterns -->
-
-### Setup
-
-```[lang]
-// Source: [file:lines]
-[Extract logger initialization/import pattern]
-```
-
-### Usage Pattern
-
-```[lang]
-// Source: [file:lines]
-[Extract example showing structured logging with context]
-```
-
-### Levels
-
-| Level | Use For |
-|-------|---------|
-| `debug` | Development troubleshooting |
-| `info` | Significant operations (startup, requests) |
-| `warn` | Recoverable issues, deprecations |
-| `error` | Failures requiring attention |
-
-### Rules
-
-- ✅ Include context: `{ userId, requestId, [relevant ids] }`
-- ✅ Use `[detected logger]` from `[import path]`
-- ❌ No secrets, passwords, tokens in logs
-- ❌ No excessive logging in loops/hot paths
-
----
-
-## Async Patterns
-
-<!-- Detect if async/await, promises, or sync patterns used -->
-
-**Style**: [async/await | Promises | Callbacks | Sync | Mixed]
-
-```[lang]
-// Source: [file:lines]
-[Extract canonical async pattern]
-```
-
-### Error Handling in Async
-
-```[lang]
-// Source: [file:lines]
-[Extract async error handling - try/catch wrapper, error middleware, etc.]
-```
-
----
-
-## Configuration & Environment
-
-<!-- Find how config is loaded and validated -->
-
-### Loading Pattern
-
-```[lang]
-// Source: [file:lines]
-[Extract config loading/validation pattern]
-```
-
-### Required Variables
-
-| Variable | Purpose | Example |
-|----------|---------|---------|
-| `[VAR_NAME]` | [Purpose] | `[example value]` |
-| `[VAR_NAME]` | [Purpose] | `[example value]` |
-
-### Accessing Config
-
-```[lang]
-// Use this pattern to access configuration
-[Extract how to import/use config values]
-```
-
----
-
-## Dependencies
-
-<!-- Find package manager and conventions -->
-
-### Adding Dependencies
-
-```bash
-# Production dependency
-[npm install X / pip install X / etc.]
-
-# Dev dependency
-[npm install -D X / pip install X --dev / etc.]
-```
-
-### Update Process
-
-```bash
-# Check outdated
-[command]
-
-# Update
-[command]
-```
-
-**Lock file**: `[package-lock.json / poetry.lock / etc.]` - ✅ Always commit
-
----
-
-## Git Workflow
-
-<!-- Extract from CONTRIBUTING.md, .github, or infer from history -->
-
-### Branch Naming
-
-```
-[feature/bugfix/hotfix]/[ticket-id]-[short-description]
-```
-
-**Examples**: `feature/ABC-123-add-user-auth`, `bugfix/fix-login-redirect`
-
-### Commit Messages
-
-<!-- Detect conventional commits, or extract pattern -->
-
-```
-[type]([scope]): [description]
-
-[body - optional]
-```
-
-**Types**: `feat`, `fix`, `docs`, `refactor`, `test`, `chore`
-
-### PR Checklist
-
-- [ ] Linting passes (`[lint command]`)
-- [ ] Tests pass (`[test command]`)
-- [ ] [Other checks from CI or CONTRIBUTING.md]
-
----
-
-## Common Patterns
-
-<!-- Extract recurring patterns specific to this codebase -->
-
-| Pattern | When to Use | Example |
-|---------|-------------|---------|
-| `[Helper/Utility name]` | [Use case] | `[file:line]` |
-| `[Decorator/Middleware]` | [Use case] | `[file:line]` |
-| `[Factory/Builder]` | [Use case] | `[file:line]` |
-
----
-
-## Don't Do
-
-<!-- Extract anti-patterns from linter rules or code review patterns -->
-
-| ❌ Avoid | ✅ Instead | Why |
-|----------|-----------|-----|
-| `[anti-pattern]` | `[correct pattern]` | [reason] |
-| `[anti-pattern]` | `[correct pattern]` | [reason] |
-| `[anti-pattern]` | `[correct pattern]` | [reason] |
-
----
-
-## Quick Reference
-
-| Need | Location |
-|------|----------|
-| Linter config | `[path]` |
-| Formatter config | `[path]` |
-| Exception classes | `[path]` |
-| Logger setup | `[path]` |
-| Config loader | `[path]` |
-| Utilities | `[path]` |
-
----

package/dist/agents/plugins/claude/plugin/claude-templates/templates/guides/integration/external-integrations.md.template

@@ -1,160 +0,0 @@
-# External Integrations
-
-## Quick Summary
-
-External service integration patterns for [PROJECT_NAME]: API clients, authentication, retries, and error handling.
-
-**Category**: Integration
-**Complexity**: Medium-High
-**Prerequisites**: HTTP clients, async/await, API fundamentals
-
----
-
-## 🚨 SIZE LIMIT WARNING
-
-**This generated guide MUST be 200-400 lines maximum.**
-
-**When filling this template**:
-- ✅ Code examples: 5-15 lines (NEVER > 20)
-- ✅ ONE example per pattern
-- ✅ Use file:line references, not full code
-- ✅ Use tables for multiple patterns
-- ❌ NO multiple examples for same pattern
-- ❌ NO verbose explanations
-- ❌ NO copying entire functions
-
-**Validate line count after generation**: `wc -l [this-file]`
-**If > 400 lines**: Condense immediately before continuing!
-
----
-
-## Integrated Services
-
-| Service | Purpose | Auth | Source |
-|---------|---------|------|--------|
-| [Service1] | [Purpose] | [Method] | [file:lines] |
-| [Service2] | [Purpose] | [Method] | [file:lines] |
-
----
-
-## Client Pattern
-
-```[language]
-# Source: [file:lines]
-[client_class]
-```
-
-**Components**: Base URL, auth, retries, timeouts
-
----
-
-## Authentication
-
-### API Key
-
-```[language]
-# Source: [file:lines]
-[api_key_auth]
-```
-
-### OAuth2
-
-```[language]
-# Source: [file:lines]
-[oauth2_auth]
-```
-
-**Token Management**: Store securely, refresh before expiry
-
----
-
-## Error Handling
-
-```[language]
-# Source: [file:lines]
-[error_handling]
-```
-
-| Status | Action |
-|--------|--------|
-| 4xx | Log, don't retry (usually) |
-| 5xx | Log, retry with backoff |
-| Timeout | Retry with backoff |
-
----
-
-## Retry Logic
-
-```[language]
-# Source: [file:lines]
-[retry_pattern]
-```
-
-**Strategy**: Exponential backoff
-**Max Retries**: [N]
-**When**: 5xx, timeouts, connection errors
-**When Not**: 4xx (usually), auth failures
-
----
-
-## Rate Limiting
-
-```[language]
-# Source: [file:lines]
-[rate_limit]
-```
-
-**Headers**: `X-RateLimit-*`, `Retry-After`
-
----
-
-## Timeouts
-
-```[language]
-# Source: [file:lines]
-[timeout_config]
-```
-
-**Types**: Connection | Read | Total
-
----
-
-## Best Practices
-
-| ✅ DO | ❌ DON'T |
-|-------|----------|
-| Retry with backoff | Infinite retries |
-| Set timeouts | Wait forever |
-| Log external calls | Silent failures |
-| Cache when possible | Call repeatedly |
-| Store secrets securely | Hardcode API keys |
-
----
-
-## Security
-
-- ✅ Env vars / secrets manager
-- ✅ HTTPS only
-- ✅ Validate TLS certs
-- ❌ Log API keys
-- ❌ Ignore cert errors
-
----
-
-## Testing
-
-```[language]
-# Source: [test_file:lines]
-[mock_example]
-```
-
-**Strategy**: Mock in unit tests, use test APIs in integration tests
-
----
-
-## References
-
-- **Clients**: `[path/to/clients]`
-- **Service Docs**: [Links]
-
----