@nextsparkjs/core 0.1.0-beta.8 → 0.1.0-beta.82

package/dist/presets/ai-workflow/claude/commands/fix:bug.md

@@ -1,442 +0,0 @@
----
-description: Fix a reported bug with automatic test creation and execution
----
-
-# Fix Bug - Debug and Repair with Tests
-
-You are fixing a reported bug with comprehensive debugging and test coverage.
-
-**Bug Description:**
-{{{ input }}}
-
----
-
-## Your Mission
-
-Fix the bug with proper validation:
-
-1. **Understand the bug** from description and reproduction steps
-2. **Locate the root cause** through investigation
-3. **Create a failing test** that reproduces the bug
-4. **Fix the bug** in the code
-5. **Verify the test passes** after the fix
-6. **Run regression tests** to ensure no new breaks
-
----
-
-## Bug Fix Protocol
-
-### Step 1: Analyze Bug Report
-
-```typescript
-const bugDescription = '{{{ input }}}'
-
-// Extract key information
-const bugInfo = {
-  description: extractDescription(bugDescription),
-  stepsToReproduce: extractSteps(bugDescription),
-  expectedBehavior: extractExpected(bugDescription),
-  actualBehavior: extractActual(bugDescription),
-  affectedArea: determineArea(bugDescription)  // frontend, backend, api
-}
-```
-
-### Step 2: Locate Affected Code
-
-```typescript
-// Search for related code based on bug description
-const searchTerms = extractKeyTerms(bugDescription)
-
-// Search in codebase
-for (const term of searchTerms) {
-  await Grep({
-    pattern: term,
-    path: 'app/',
-    type: 'ts'
-  })
-}
-
-// Read likely affected files
-await Read(affectedFiles)
-```
-
-### Step 3: Understand Root Cause
-
-```typescript
-// Analyze the code flow
-// Identify where the bug occurs
-
-// Common bug patterns:
-const bugPatterns = {
-  'null_reference': 'Missing null check',
-  'type_mismatch': 'Incorrect type handling',
-  'state_bug': 'State not updated correctly',
-  'race_condition': 'Async timing issue',
-  'validation_gap': 'Missing input validation',
-  'auth_bypass': 'Authentication check missing',
-  'logic_error': 'Incorrect business logic'
-}
-
-// Document findings
-console.log(`Root Cause: ${rootCause}`)
-console.log(`Location: ${bugLocation}`)
-```
-
-### Step 4: Create Failing Test (TDD)
-
-```typescript
-// Determine test type
-const isApiIssue = bugInfo.affectedArea === 'api'
-const isUiIssue = bugInfo.affectedArea === 'frontend'
-
-if (isApiIssue) {
-  // Create API test that reproduces bug
-  const apiTestPath = `contents/themes/default/tests/cypress/e2e/api/bug-${bugId}.cy.ts`
-
-  await Write({
-    file_path: apiTestPath,
-    content: `/**
- * Bug Fix Test: ${bugInfo.description}
- *
- * This test reproduces and verifies the fix for:
- * ${bugDescription}
- */
-
-describe('Bug Fix: ${bugInfo.description}', () => {
-  beforeEach(() => {
-    cy.loginByApi('superadmin@nextspark.dev', 'Test123!@#')
-  })
-
-  it('should ${expectedBehavior} (was: ${actualBehavior})', () => {
-    // Steps to reproduce
-    ${stepsToReproduce.map(step => `// ${step}`).join('\n    ')}
-
-    // Test the fix
-    cy.request({
-      method: '${method}',
-      url: '${endpoint}',
-      body: ${JSON.stringify(requestBody)},
-      failOnStatusCode: false
-    }).then((response) => {
-      // Expected behavior after fix
-      expect(response.status).to.eq(${expectedStatus})
-      expect(response.body).to.have.property('${expectedProperty}')
-    })
-  })
-})
-`
-  })
-} else {
-  // Create UAT test that reproduces bug
-  const uatTestPath = `contents/themes/default/tests/cypress/e2e/uat/bug-${bugId}.cy.ts`
-
-  await Write({
-    file_path: uatTestPath,
-    content: `/**
- * Bug Fix Test: ${bugInfo.description}
- *
- * This test reproduces and verifies the fix for:
- * ${bugDescription}
- */
-
-describe('Bug Fix: ${bugInfo.description}', () => {
-  beforeEach(() => {
-    cy.loginByUI('superadmin@nextspark.dev', 'Test123!@#')
-  })
-
-  it('should ${expectedBehavior} (was: ${actualBehavior})', () => {
-    // Steps to reproduce
-    ${stepsToReproduce.map((step, i) => `
-    // Step ${i + 1}: ${step}
-    cy.get('[data-cy="${stepSelector}"]').${stepAction}()`).join('\n')}
-
-    // Verify fix
-    cy.get('[data-cy="${verifySelector}"]')
-      .should('${assertion}', '${expectedValue}')
-  })
-})
-`
-  })
-}
-```
-
-### Step 5: Run Test to Confirm Bug
-
-```typescript
-// Run the test - it should FAIL before fix
-const testResult = await Bash({
-  command: `pnpm cypress run --spec "${testPath}"`,
-  description: 'Confirm test fails (reproduces bug)'
-})
-
-if (testResult.success) {
-  console.log('Warning: Test passed. Bug may not be reproduced correctly.')
-  // Review test logic
-} else {
-  console.log('Test fails as expected. Bug confirmed.')
-}
-```
-
-### Step 6: Implement Fix
-
-```typescript
-// Based on root cause, fix the bug
-const fixType = determineFix(rootCause)
-
-switch (fixType) {
-  case 'null_check':
-    await Edit({
-      file_path: bugLocation,
-      old_string: 'value.property',
-      new_string: 'value?.property'
-    })
-    break
-
-  case 'validation':
-    await Edit({
-      file_path: bugLocation,
-      old_string: '// Process input',
-      new_string: `// Validate input first
-    if (!input || typeof input !== 'string') {
-      throw new Error('Invalid input')
-    }
-    // Process input`
-    })
-    break
-
-  case 'state_update':
-    await Edit({
-      file_path: bugLocation,
-      old_string: 'setState(newValue)',
-      new_string: `setState(prev => ({
-      ...prev,
-      ...newValue
-    }))`
-    })
-    break
-
-  case 'auth_check':
-    await Edit({
-      file_path: bugLocation,
-      old_string: '// Handle request',
-      new_string: `// Verify authentication
-    const session = await auth.api.getSession({ headers: request.headers })
-    if (!session?.user) {
-      return Response.json({ error: 'Unauthorized' }, { status: 401 })
-    }
-    // Handle request`
-    })
-    break
-
-  // More fix patterns...
-}
-```
-
-### Step 7: Verify Fix
-
-```typescript
-// Run the test again - it should PASS after fix
-const verifyResult = await Bash({
-  command: `pnpm cypress run --spec "${testPath}"`,
-  description: 'Verify test passes after fix'
-})
-
-if (!verifyResult.success) {
-  console.log('Fix did not work. Investigating further...')
-  // Continue debugging
-} else {
-  console.log('Test passes. Bug fixed!')
-}
-```
-
-### Step 8: Run Regression Tests
-
-```typescript
-// Run full test suite to ensure no regressions
-await Bash({
-  command: 'pnpm cypress run',
-  description: 'Run regression tests'
-})
-
-// Run build to ensure no type errors
-await Bash({
-  command: 'pnpm build',
-  description: 'Verify build succeeds'
-})
-```
-
----
-
-## Bug Categories and Fix Approaches
-
-### Null/Undefined Errors
-```typescript
-// Before (bug)
-const name = user.profile.name
-
-// After (fix)
-const name = user?.profile?.name ?? 'Unknown'
-```
-
-### Type Mismatches
-```typescript
-// Before (bug)
-function process(id) { // any type
-  return items[id]
-}
-
-// After (fix)
-function process(id: string): Item | undefined {
-  return items[id]
-}
-```
-
-### State Management Bugs
-```typescript
-// Before (bug)
-const [items, setItems] = useState([])
-const addItem = (item) => {
-  items.push(item)  // Mutating state directly!
-  setItems(items)
-}
-
-// After (fix)
-const addItem = (item) => {
-  setItems(prev => [...prev, item])
-}
-```
-
-### API Response Handling
-```typescript
-// Before (bug)
-const data = await response.json()
-return data.results  // No error handling
-
-// After (fix)
-const data = await response.json()
-if (!response.ok) {
-  throw new Error(data.message || 'Request failed')
-}
-return data.results ?? []
-```
-
-### Authentication Bypass
-```typescript
-// Before (bug)
-export async function GET(request) {
-  const items = await db.getAll()  // No auth check!
-  return Response.json(items)
-}
-
-// After (fix)
-export async function GET(request) {
-  const session = await auth.api.getSession({ headers: request.headers })
-  if (!session?.user) {
-    return Response.json({ error: 'Unauthorized' }, { status: 401 })
-  }
-  const items = await db.getByUser(session.user.id)
-  return Response.json(items)
-}
-```
-
----
-
-## Output Format
-
-```markdown
-## Bug Fix Complete
-
-**Bug:** ${bugDescription}
-**Root Cause:** ${rootCause}
-**Fix Applied:** ${fixDescription}
-
-### Investigation Summary
-
-**Affected Files:**
-${affectedFiles.map(f => `- \`${f}\``).join('\n')}
-
-**Root Cause Analysis:**
-${rootCauseAnalysis}
-
-### Changes Made
-
-\`\`\`diff
-${diff}
-\`\`\`
-
-### Test Coverage
-
-**New Test:** \`${testPath}\`
-**Test Status:** ✅ Passing
-
-### Regression Testing
-
-- **Bug Fix Test:** ✅ Passed
-- **Related Tests:** ✅ X/X Passed
-- **Full Suite:** ✅ Y/Y Passed
-- **Build:** ✅ Success
-
-### Verification Steps
-
-To verify the fix manually:
-1. ${verificationStep1}
-2. ${verificationStep2}
-3. ${verificationStep3}
-
-### Prevention Recommendations
-
-To prevent similar bugs:
-- ${prevention1}
-- ${prevention2}
-```
-
----
-
-## Best Practices
-
-### DO:
-- Always create a failing test BEFORE fixing
-- Understand root cause, don't just patch symptoms
-- Check for similar issues elsewhere in code
-- Run full test suite after fix
-- Document the fix clearly
-
-### DON'T:
-- Fix without understanding the cause
-- Skip creating tests
-- Only test the specific bug (run regression)
-- Introduce new bugs while fixing
-- Leave debugging code in production
-
----
-
-## Integration with Session Workflow
-
-If fixing a bug during active development:
-
-```typescript
-// Update session context
-await Edit({
-  file_path: `${sessionPath}/context.md`,
-  new_content: `
----
-
-### [${date}] - bug-fix
-
-**Estado:** ✅ Bug Corregido
-
-**Bug:** ${bugDescription}
-**Root Cause:** ${rootCause}
-**Fix:** ${fixDescription}
-
-**Test Added:** \`${testPath}\`
-
-**Files Modified:**
-${modifiedFiles.map(f => `- \`${f}\``).join('\n')}
-`
-})
-```
-
----
-
-**Now fix the bug described above.**

package/dist/presets/ai-workflow/claude/commands/fix:build.md

@@ -1,284 +0,0 @@
----
-description: Automatically diagnose and fix build errors by launching appropriate developer agents
----
-
-# Fix Build - Repair Build Errors
-
-You are fixing build errors by analyzing error output and launching specialized agents.
-
-**Error Description (optional):**
-{{{ input }}}
-
----
-
-## Your Mission
-
-Automatically diagnose and fix build errors:
-
-1. **Run build** to capture current errors
-2. **Analyze error type** (frontend, backend, plugin, registry)
-3. **Launch appropriate agent** to fix
-4. **Iterate until success** (max 5 attempts)
-5. **Report final status**
-
----
-
-## Build Fix Protocol
-
-### Step 1: Run Initial Build
-
-```typescript
-// Capture current build state
-await Bash({
-  command: 'pnpm build 2>&1',
-  description: 'Run build to capture errors'
-})
-
-// Parse error output
-const errors = parseBuildErrors(output)
-```
-
-### Step 2: Categorize Errors
-
-**Frontend Errors:**
-- React/Next.js component errors
-- TypeScript errors in `app/`, `core/components/`
-- CSS/styling errors
-- Client-side hooks errors
-- UI component issues
-
-**Backend Errors:**
-- API route errors (`app/api/`)
-- Server-side TypeScript errors
-- Database connection/migration errors
-- Authentication/session errors
-- Middleware errors
-
-**Plugin Errors:**
-- Plugin configuration errors (`contents/plugins/`)
-- Plugin entity errors
-- Plugin registry errors
-- Plugin dependencies errors
-
-**Registry/Build System Errors:**
-- `core/scripts/build/registry.mjs` errors
-- `core/scripts/build/theme.mjs` errors
-- Registry generation failures
-- Theme/plugin discovery errors
-
-### Step 3: Launch Appropriate Agent
-
-```typescript
-// Determine agent based on error location
-function determineAgent(error) {
-  if (error.file.includes('app/api/') || error.file.includes('core/lib/')) {
-    return 'backend-developer'
-  }
-  if (error.file.includes('app/components/') || error.file.includes('.tsx')) {
-    return 'frontend-developer'
-  }
-  if (error.file.includes('contents/plugins/')) {
-    return 'dev-plugin'
-  }
-  if (error.file.includes('scripts/') || error.file.includes('registry')) {
-    return 'general-purpose'
-  }
-  return 'frontend-developer' // Default
-}
-```
-
-### Step 4: Agent Tasks
-
-**Frontend Developer Agent:**
-```typescript
-await launchAgent('frontend-developer', {
-  task: 'Fix frontend build errors',
-  requirements: [
-    'Read affected component files',
-    'Fix TypeScript/React errors',
-    'Ensure imports are correct',
-    'Follow .rules/components.md patterns',
-    'Maintain type safety',
-    'Run pnpm build to verify',
-    'Continue until build succeeds'
-  ]
-})
-```
-
-**Backend Developer Agent:**
-```typescript
-await launchAgent('backend-developer', {
-  task: 'Fix backend build errors',
-  requirements: [
-    'Read affected API routes and server files',
-    'Fix TypeScript errors in backend code',
-    'Ensure database connections are correct',
-    'Verify authentication middleware',
-    'Follow .rules/api.md patterns',
-    'Run pnpm build to verify',
-    'Continue until build succeeds'
-  ]
-})
-```
-
-**Plugin Developer Agent:**
-```typescript
-await launchAgent('dev-plugin', {
-  task: 'Fix plugin build errors',
-  requirements: [
-    'Read affected plugin files',
-    'Fix TypeScript errors in plugin code',
-    'Verify plugin configuration',
-    'Ensure entity configs are valid',
-    'Follow .rules/plugins.md patterns',
-    'Run pnpm build to verify',
-    'Continue until build succeeds'
-  ]
-})
-```
-
-**General Purpose Agent (Registry/Build System):**
-```typescript
-await launchAgent('general-purpose', {
-  task: 'Fix build system errors',
-  requirements: [
-    'Read build scripts and registry files',
-    'Fix errors in build-registry.mjs or build-theme.mjs',
-    'Verify registry generation',
-    'Ensure theme/plugin discovery works',
-    'Run pnpm build to verify',
-    'Continue until build succeeds'
-  ]
-})
-```
-
-### Step 5: Iteration Loop
-
-```typescript
-const MAX_ATTEMPTS = 5
-
-for (let attempt = 1; attempt <= MAX_ATTEMPTS; attempt++) {
-  console.log(`Build attempt ${attempt}/${MAX_ATTEMPTS}`)
-
-  const result = await Bash({
-    command: 'pnpm build 2>&1',
-    description: `Build attempt ${attempt}`
-  })
-
-  if (result.success) {
-    console.log('Build successful!')
-    break
-  }
-
-  // Parse remaining errors
-  const remainingErrors = parseBuildErrors(result.output)
-
-  // Categorize and launch appropriate agent
-  const errorCategory = categorizeErrors(remainingErrors)
-  await launchAgent(determineAgent(errorCategory), {
-    task: `Fix remaining ${errorCategory} errors (attempt ${attempt})`,
-    errors: remainingErrors
-  })
-}
-```
-
----
-
-## Error Pattern Reference
-
-### Frontend Error Patterns
-```
-- "Type 'X' is not assignable to type 'Y'" in components/
-- "Cannot find module" in app/ directory
-- "Property 'X' does not exist on type 'Y'" in hooks/
-- React component rendering errors
-- "JSX element type 'X' does not have any construct"
-```
-
-### Backend Error Patterns
-```
-- Errors in app/api/ directory
-- "Cannot read properties of undefined" in server code
-- Database connection errors
-- Authentication/session errors
-- Middleware errors
-```
-
-### Plugin Error Patterns
-```
-- Errors in contents/plugins/[plugin]/
-- Plugin configuration validation errors
-- Entity registry errors for plugins
-- Plugin dependency errors
-```
-
-### Registry/Build System Patterns
-```
-- Errors in core/scripts/build/registry.mjs
-- "Failed to generate registry" messages
-- Theme discovery errors
-- Dynamic import violations
-```
-
----
-
-## Output Format
-
-```markdown
-## Build Fix Results
-
-**Initial Errors:** ${initialErrorCount}
-**Attempts:** ${attemptCount}/${MAX_ATTEMPTS}
-**Final Status:** ✅ Success / ❌ Failed
-
-### Error Resolution
-
-| Error Type | Count | Agent Used | Status |
-|------------|-------|------------|--------|
-| Frontend | 5 | frontend-developer | ✅ Fixed |
-| Backend | 2 | backend-developer | ✅ Fixed |
-| Plugin | 0 | - | N/A |
-
-### Files Modified
-
-${modifiedFiles.map(f => `- \`${f.path}\` - ${f.change}`).join('\n')}
-
-### Build Output
-
-\`\`\`
-${finalBuildOutput}
-\`\`\`
-
-### Recommendations
-${recommendations.map(r => `- ${r}`).join('\n')}
-```
-
----
-
-## Best Practices
-
-### DO:
-- Always read the error fully before fixing
-- Verify fix after each change
-- Follow the .rules/ files for patterns
-- Maintain type safety (no `any` unless necessary)
-- Document complex fixes with comments
-
-### DON'T:
-- Skip errors without understanding them
-- Use `@ts-ignore` to hide errors
-- Break existing functionality
-- Ignore TypeScript warnings
-
----
-
-## Integration with Other Commands
-
-Works well with:
-- `/task:execute` - Continue task after fixing build
-- `/task:scope-change` - If fix requires scope changes
-- `/test:run` - Run tests after build succeeds
-
----
-
-**Now fix the build errors described above (or run pnpm build to detect errors).**