🔬 AIOS-Core Deep Dive

Gate Severity Levels

State Machine (AC6)

INITIALIZED → READY → IN_PROGRESS → COMPLETE
                    ↓           ↓
                 BLOCKED ←──────┘

Epic Configuration

Context Building por Epic

• Epic 3 (Spec): source, prdPath
• Epic 4 (Execution): spec path, complexity, requirements
• Epic 5 (Recovery): implementationPath, errors, attempts
• Epic 6 (QA): buildResult, testResults, codeChanges
• Epic 7 (Memory): qaReport, patterns, sessionInsights

Integrations

• TechStackDetector - Pre-flight detection (AC7)
• RecoveryHandler - Story 0.5
• GateEvaluator - Story 0.6
• AgentInvoker - Story 0.7
• DashboardIntegration - Story 0.8

Acceptance Criteria

• AC1: Detecta stuck: 3+ falhas consecutivas
• AC2: Detecta circular: abordagem similar à que já falhou
• AC3: Bloqueia execução se circular detectado
• AC4: Marca subtask como "stuck" em implementation.yaml
• AC5: Escala para humano com contexto completo
• AC6: Sugere abordagens alternativas baseadas nos erros
• AC7: Configurável via autoClaude.recovery.maxAttempts

Error Pattern Categories

Circular Detection Algorithm

function check(attempts, currentApproach):
    recentAttempts = attempts.slice(-windowSize)
    consecutiveFailures = countConsecutive(recentAttempts)
    
    if consecutiveFailures >= maxAttempts:
        return { stuck: true, reason: 'consecutive_failures' }
    
    if circularDetection && currentApproach:
        similarity = compareApproaches(currentApproach, failedApproaches)
        if similarity >= similarityThreshold:
            return { stuck: true, reason: 'circular_approach' }

Build Status Enum

State Schema (AC1)

{
  storyId: string,
  startedAt: ISO8601,
  lastCheckpoint: ISO8601,
  status: BuildStatus,
  currentPhase: string,
  currentSubtask: string,
  completedSubtasks: [],
  failedAttempts: [],
  worktree: string | null,
  checkpoints: [],
  metrics: {
    totalSubtasks: number,
    completedSubtasks: number,
    totalAttempts: number,
    averageTimePerSubtask: number
  }
}

Epic 5 Integration (AC8)

• StuckDetector - Detecta builds stuck
• RecoveryTracker - Rastreia tentativas de recuperação

Arquitetura

1. SemanticAnalyzer - Extrai elementos semânticos do código
2. ConflictDetector - Detecta conflitos usando regras de compatibilidade
3. AutoMerger - Resolve conflitos simples deterministicamente
4. AIResolver - Usa Claude para conflitos complexos
5. MergeOrchestrator - Coordena o pipeline completo

Change Types

Merge Strategies

Compatibility Rules

// Combinações compatíveis (auto-merge)
IMPORT_ADDED + IMPORT_ADDED → COMBINE
FUNCTION_ADDED + FUNCTION_ADDED → COMBINE
FUNCTION_ADDED + IMPORT_ADDED → COMBINE

// Conflitos (AI required)
FUNCTION_MODIFIED + FUNCTION_MODIFIED → AI_REQUIRED

Pattern Categories

• STATE_MANAGEMENT - Zustand, Redux, MobX, Vuex, Pinia, Context API
• API_CALLS - fetch-wrapper, axios, react-query, SWR, tRPC, GraphQL
• ERROR_HANDLING - try-catch-toast, error-boundary, global-handler
• COMPONENTS - React patterns
• DATA_ACCESS - Database patterns
• TESTING - Jest, Vitest, RTL, Cypress, Playwright
• HOOKS - Custom hooks
• UTILITIES - Helper functions

Output Example

{
  category: "State Management",
  name: "Zustand Store with Persist",
  description: "State management with persistence...",
  whenToUse: "Any domain state that needs persistence...",
  example: "```typescript\nimport { create } from 'zustand'...",
  filesUsing: ["src/stores/userStore.ts"],
  confidence: 0.95
}

Output: .aios/codebase-map.json

• services - Serviços detectados
• directories - Estrutura de diretórios
• patterns - Padrões encontrados
• conventions - Convenções do projeto
• dependencies - Runtime e dev dependencies

Pattern Detectors

Config Files Detectados

package.json, tsconfig.json, vite.config.*, next.config.*, webpack.config.js, .eslintrc*, jest.config.*, vitest.config.*, docker-compose.yml, Dockerfile, pyproject.toml, Cargo.toml, go.mod, Gemfile...

Optimization Patterns

Static Analysis Metrics

{
  complexity: number,      // Cyclomatic complexity
  functionCount: number,
  loopDepth: number,       // Max nested loop depth
  asyncOperations: number,
  stringOperations: number,
  objectOperations: number,
  arrayOperations: number,
  domOperations: number,
  fileSize: number,
  lineCount: number
}