aw-ecc 1.4.21

package/.opencode/commands/update-codemaps.md

@@ -0,0 +1,81 @@
+---
+description: Update codemaps for codebase navigation
+agent: doc-updater
+subtask: true
+---
+
+# Update Codemaps Command
+
+Update codemaps to reflect current codebase structure: $ARGUMENTS
+
+## Your Task
+
+Generate or update codemaps in `docs/CODEMAPS/` directory:
+
+1. **Analyze codebase structure**
+2. **Generate component maps**
+3. **Document relationships**
+4. **Update navigation guides**
+
+## Codemap Types
+
+### Architecture Map
+```
+docs/CODEMAPS/ARCHITECTURE.md
+```
+- High-level system overview
+- Component relationships
+- Data flow diagrams
+
+### Module Map
+```
+docs/CODEMAPS/MODULES.md
+```
+- Module descriptions
+- Public APIs
+- Dependencies
+
+### File Map
+```
+docs/CODEMAPS/FILES.md
+```
+- Directory structure
+- File purposes
+- Key files
+
+## Codemap Format
+
+### [Module Name]
+
+**Purpose**: [Brief description]
+
+**Location**: `src/[path]/`
+
+**Key Files**:
+- `file1.ts` - [purpose]
+- `file2.ts` - [purpose]
+
+**Dependencies**:
+- [Module A]
+- [Module B]
+
+**Exports**:
+- `functionName()` - [description]
+- `ClassName` - [description]
+
+**Usage Example**:
+```typescript
+import { functionName } from '@/module'
+```
+
+## Generation Process
+
+1. Scan directory structure
+2. Parse imports/exports
+3. Build dependency graph
+4. Generate markdown maps
+5. Validate links
+
+---
+
+**TIP**: Keep codemaps updated when adding new modules or significant refactoring.

package/.opencode/commands/update-docs.md

@@ -0,0 +1,67 @@
+---
+description: Update documentation for recent changes
+agent: doc-updater
+subtask: true
+---
+
+# Update Docs Command
+
+Update documentation to reflect recent changes: $ARGUMENTS
+
+## Your Task
+
+1. **Identify changed code** - `git diff --name-only`
+2. **Find related docs** - README, API docs, guides
+3. **Update documentation** - Keep in sync with code
+4. **Verify accuracy** - Docs match implementation
+
+## Documentation Types
+
+### README.md
+- Installation instructions
+- Quick start guide
+- Feature overview
+- Configuration options
+
+### API Documentation
+- Endpoint descriptions
+- Request/response formats
+- Authentication details
+- Error codes
+
+### Code Comments
+- JSDoc for public APIs
+- Complex logic explanations
+- TODO/FIXME cleanup
+
+### Guides
+- How-to tutorials
+- Architecture decisions (ADRs)
+- Troubleshooting guides
+
+## Update Checklist
+
+- [ ] README reflects current features
+- [ ] API docs match endpoints
+- [ ] JSDoc updated for changed functions
+- [ ] Examples are working
+- [ ] Links are valid
+- [ ] Version numbers updated
+
+## Documentation Quality
+
+### Good Documentation
+- Accurate and up-to-date
+- Clear and concise
+- Has working examples
+- Covers edge cases
+
+### Avoid
+- Outdated information
+- Missing parameters
+- Broken examples
+- Ambiguous language
+
+---
+
+**IMPORTANT**: Documentation should be updated alongside code changes, not as an afterthought.

package/.opencode/commands/verify.md

@@ -0,0 +1,67 @@
+---
+description: Run verification loop to validate implementation
+agent: build
+---
+
+# Verify Command
+
+Run verification loop to validate the implementation: $ARGUMENTS
+
+## Your Task
+
+Execute comprehensive verification:
+
+1. **Type Check**: `npx tsc --noEmit`
+2. **Lint**: `npm run lint`
+3. **Unit Tests**: `npm test`
+4. **Integration Tests**: `npm run test:integration` (if available)
+5. **Build**: `npm run build`
+6. **Coverage Check**: Verify 80%+ coverage
+
+## Verification Checklist
+
+### Code Quality
+- [ ] No TypeScript errors
+- [ ] No lint warnings
+- [ ] No console.log statements
+- [ ] Functions < 50 lines
+- [ ] Files < 800 lines
+
+### Tests
+- [ ] All tests passing
+- [ ] Coverage >= 80%
+- [ ] Edge cases covered
+- [ ] Error conditions tested
+
+### Security
+- [ ] No hardcoded secrets
+- [ ] Input validation present
+- [ ] No SQL injection risks
+- [ ] No XSS vulnerabilities
+
+### Build
+- [ ] Build succeeds
+- [ ] No warnings
+- [ ] Bundle size acceptable
+
+## Verification Report
+
+### Summary
+- Status: ✅ PASS / ❌ FAIL
+- Score: X/Y checks passed
+
+### Details
+| Check | Status | Notes |
+|-------|--------|-------|
+| TypeScript | ✅/❌ | [details] |
+| Lint | ✅/❌ | [details] |
+| Tests | ✅/❌ | [details] |
+| Coverage | ✅/❌ | XX% (target: 80%) |
+| Build | ✅/❌ | [details] |
+
+### Action Items
+[If FAIL, list what needs to be fixed]
+
+---
+
+**NOTE**: Verification loop should be run before every commit and PR.

package/.opencode/index.ts

@@ -0,0 +1,79 @@
+/**
+ * Everything Claude Code (ECC) Plugin for OpenCode
+ *
+ * This package provides the published ECC OpenCode plugin module:
+ * - Plugin hooks (auto-format, TypeScript check, console.log warning, env injection, etc.)
+ * - Custom tools (run-tests, check-coverage, security-audit, format-code, lint-check, git-summary)
+ * - Bundled reference config/assets for the wider ECC OpenCode setup
+ *
+ * Usage:
+ *
+ * Option 1: Install via npm
+ * ```bash
+ * npm install ecc-universal
+ * ```
+ *
+ * Then add to your opencode.json:
+ * ```json
+ * {
+ *   "plugin": ["ecc-universal"]
+ * }
+ * ```
+ *
+ * That enables the published plugin module only. For ECC commands, agents,
+ * prompts, and instructions, use this repository's `.opencode/opencode.json`
+ * as a base or copy the bundled `.opencode/` assets into your project.
+ *
+ * Option 2: Clone and use directly
+ * ```bash
+ * git clone https://github.com/affaan-m/everything-claude-code
+ * cd everything-claude-code
+ * opencode
+ * ```
+ *
+ * @packageDocumentation
+ */
+
+// Export the main plugin
+export { ECCHooksPlugin, default } from "./plugins/index.js"
+
+// Export individual components for selective use
+export * from "./plugins/index.js"
+
+// Version export
+export const VERSION = "1.6.0"
+
+// Plugin metadata
+export const metadata = {
+  name: "ecc-universal",
+  version: VERSION,
+  description: "Everything Claude Code plugin for OpenCode",
+  author: "affaan-m",
+  features: {
+    agents: 13,
+    commands: 31,
+    skills: 37,
+    configAssets: true,
+    hookEvents: [
+      "file.edited",
+      "tool.execute.before",
+      "tool.execute.after",
+      "session.created",
+      "session.idle",
+      "session.deleted",
+      "file.watcher.updated",
+      "permission.ask",
+      "todo.updated",
+      "shell.env",
+      "experimental.session.compacting",
+    ],
+    customTools: [
+      "run-tests",
+      "check-coverage",
+      "security-audit",
+      "format-code",
+      "lint-check",
+      "git-summary",
+    ],
+  },
+}

package/.opencode/instructions/INSTRUCTIONS.md

@@ -0,0 +1,337 @@
+# Everything Claude Code - OpenCode Instructions
+
+This document consolidates the core rules and guidelines from the Claude Code configuration for use with OpenCode.
+
+## Security Guidelines (CRITICAL)
+
+### Mandatory Security Checks
+
+Before ANY commit:
+- [ ] No hardcoded secrets (API keys, passwords, tokens)
+- [ ] All user inputs validated
+- [ ] SQL injection prevention (parameterized queries)
+- [ ] XSS prevention (sanitized HTML)
+- [ ] CSRF protection enabled
+- [ ] Authentication/authorization verified
+- [ ] Rate limiting on all endpoints
+- [ ] Error messages don't leak sensitive data
+
+### Secret Management
+
+```typescript
+// NEVER: Hardcoded secrets
+const apiKey = "sk-proj-xxxxx"
+
+// ALWAYS: Environment variables
+const apiKey = process.env.OPENAI_API_KEY
+
+if (!apiKey) {
+  throw new Error('OPENAI_API_KEY not configured')
+}
+```
+
+### Security Response Protocol
+
+If security issue found:
+1. STOP immediately
+2. Use **security-reviewer** agent
+3. Fix CRITICAL issues before continuing
+4. Rotate any exposed secrets
+5. Review entire codebase for similar issues
+
+---
+
+## Coding Style
+
+### Immutability (CRITICAL)
+
+ALWAYS create new objects, NEVER mutate:
+
+```javascript
+// WRONG: Mutation
+function updateUser(user, name) {
+  user.name = name  // MUTATION!
+  return user
+}
+
+// CORRECT: Immutability
+function updateUser(user, name) {
+  return {
+    ...user,
+    name
+  }
+}
+```
+
+### File Organization
+
+MANY SMALL FILES > FEW LARGE FILES:
+- High cohesion, low coupling
+- 200-400 lines typical, 800 max
+- Extract utilities from large components
+- Organize by feature/domain, not by type
+
+### Error Handling
+
+ALWAYS handle errors comprehensively:
+
+```typescript
+try {
+  const result = await riskyOperation()
+  return result
+} catch (error) {
+  console.error('Operation failed:', error)
+  throw new Error('Detailed user-friendly message')
+}
+```
+
+### Input Validation
+
+ALWAYS validate user input:
+
+```typescript
+import { z } from 'zod'
+
+const schema = z.object({
+  email: z.string().email(),
+  age: z.number().int().min(0).max(150)
+})
+
+const validated = schema.parse(input)
+```
+
+### Code Quality Checklist
+
+Before marking work complete:
+- [ ] Code is readable and well-named
+- [ ] Functions are small (<50 lines)
+- [ ] Files are focused (<800 lines)
+- [ ] No deep nesting (>4 levels)
+- [ ] Proper error handling
+- [ ] No console.log statements
+- [ ] No hardcoded values
+- [ ] No mutation (immutable patterns used)
+
+---
+
+## Testing Requirements
+
+### Minimum Test Coverage: 80%
+
+Test Types (ALL required):
+1. **Unit Tests** - Individual functions, utilities, components
+2. **Integration Tests** - API endpoints, database operations
+3. **E2E Tests** - Critical user flows (Playwright)
+
+### Test-Driven Development
+
+MANDATORY workflow:
+1. Write test first (RED)
+2. Run test - it should FAIL
+3. Write minimal implementation (GREEN)
+4. Run test - it should PASS
+5. Refactor (IMPROVE)
+6. Verify coverage (80%+)
+
+### Troubleshooting Test Failures
+
+1. Use **tdd-guide** agent
+2. Check test isolation
+3. Verify mocks are correct
+4. Fix implementation, not tests (unless tests are wrong)
+
+---
+
+## Git Workflow
+
+### Commit Message Format
+
+```
+<type>: <description>
+
+<optional body>
+```
+
+Types: feat, fix, refactor, docs, test, chore, perf, ci
+
+### Pull Request Workflow
+
+When creating PRs:
+1. Analyze full commit history (not just latest commit)
+2. Use `git diff [base-branch]...HEAD` to see all changes
+3. Draft comprehensive PR summary
+4. Include test plan with TODOs
+5. Push with `-u` flag if new branch
+
+### Feature Implementation Workflow
+
+1. **Plan First**
+   - Use **planner** agent to create implementation plan
+   - Identify dependencies and risks
+   - Break down into phases
+
+2. **TDD Approach**
+   - Use **tdd-guide** agent
+   - Write tests first (RED)
+   - Implement to pass tests (GREEN)
+   - Refactor (IMPROVE)
+   - Verify 80%+ coverage
+
+3. **Code Review**
+   - Use **code-reviewer** agent immediately after writing code
+   - Address CRITICAL and HIGH issues
+   - Fix MEDIUM issues when possible
+
+4. **Commit & Push**
+   - Detailed commit messages
+   - Follow conventional commits format
+
+---
+
+## Agent Orchestration
+
+### Available Agents
+
+| Agent | Purpose | When to Use |
+|-------|---------|-------------|
+| planner | Implementation planning | Complex features, refactoring |
+| architect | System design | Architectural decisions |
+| tdd-guide | Test-driven development | New features, bug fixes |
+| code-reviewer | Code review | After writing code |
+| security-reviewer | Security analysis | Before commits |
+| build-error-resolver | Fix build errors | When build fails |
+| e2e-runner | E2E testing | Critical user flows |
+| refactor-cleaner | Dead code cleanup | Code maintenance |
+| doc-updater | Documentation | Updating docs |
+| go-reviewer | Go code review | Go projects |
+| go-build-resolver | Go build errors | Go build failures |
+| database-reviewer | Database optimization | SQL, schema design |
+
+### Immediate Agent Usage
+
+No user prompt needed:
+1. Complex feature requests - Use **planner** agent
+2. Code just written/modified - Use **code-reviewer** agent
+3. Bug fix or new feature - Use **tdd-guide** agent
+4. Architectural decision - Use **architect** agent
+
+---
+
+## Performance Optimization
+
+### Model Selection Strategy
+
+**Haiku** (90% of Sonnet capability, 3x cost savings):
+- Lightweight agents with frequent invocation
+- Pair programming and code generation
+- Worker agents in multi-agent systems
+
+**Sonnet** (Best coding model):
+- Main development work
+- Orchestrating multi-agent workflows
+- Complex coding tasks
+
+**Opus** (Deepest reasoning):
+- Complex architectural decisions
+- Maximum reasoning requirements
+- Research and analysis tasks
+
+### Context Window Management
+
+Avoid last 20% of context window for:
+- Large-scale refactoring
+- Feature implementation spanning multiple files
+- Debugging complex interactions
+
+### Build Troubleshooting
+
+If build fails:
+1. Use **build-error-resolver** agent
+2. Analyze error messages
+3. Fix incrementally
+4. Verify after each fix
+
+---
+
+## Common Patterns
+
+### API Response Format
+
+```typescript
+interface ApiResponse<T> {
+  success: boolean
+  data?: T
+  error?: string
+  meta?: {
+    total: number
+    page: number
+    limit: number
+  }
+}
+```
+
+### Custom Hooks Pattern
+
+```typescript
+export function useDebounce<T>(value: T, delay: number): T {
+  const [debouncedValue, setDebouncedValue] = useState<T>(value)
+
+  useEffect(() => {
+    const handler = setTimeout(() => setDebouncedValue(value), delay)
+    return () => clearTimeout(handler)
+  }, [value, delay])
+
+  return debouncedValue
+}
+```
+
+### Repository Pattern
+
+```typescript
+interface Repository<T> {
+  findAll(filters?: Filters): Promise<T[]>
+  findById(id: string): Promise<T | null>
+  create(data: CreateDto): Promise<T>
+  update(id: string, data: UpdateDto): Promise<T>
+  delete(id: string): Promise<void>
+}
+```
+
+---
+
+## OpenCode-Specific Notes
+
+Since OpenCode does not support hooks, the following actions that were automated in Claude Code must be done manually:
+
+### After Writing/Editing Code
+- Run `prettier --write <file>` to format JS/TS files
+- Run `npx tsc --noEmit` to check for TypeScript errors
+- Check for console.log statements and remove them
+
+### Before Committing
+- Run security checks manually
+- Verify no secrets in code
+- Run full test suite
+
+### Commands Available
+
+Use these commands in OpenCode:
+- `/plan` - Create implementation plan
+- `/tdd` - Enforce TDD workflow
+- `/code-review` - Review code changes
+- `/security` - Run security review
+- `/build-fix` - Fix build errors
+- `/e2e` - Generate E2E tests
+- `/refactor-clean` - Remove dead code
+- `/orchestrate` - Multi-agent workflow
+
+---
+
+## Success Metrics
+
+You are successful when:
+- All tests pass (80%+ coverage)
+- No security vulnerabilities
+- Code is readable and maintainable
+- Performance is acceptable
+- User requirements are met