aiox-core 5.0.3 → 5.0.4

package/.claude/hooks/code-intel-pretool.cjs

@@ -1,107 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-/**
- * Code-Intel PreToolUse Hook — Auto-injects code intelligence context
- * when an agent is about to Write or Edit a file.
- *
- * Protocol:
- * - Reads JSON from stdin (Claude Code PreToolUse event)
- * - Filters: only acts on Write and Edit tools
- * - Queries RegistryProvider for entity, references, dependencies
- * - Outputs JSON with additionalContext containing <code-intel-context> XML
- * - Silent exit on any error (never blocks the tool call)
- *
- * @module code-intel-pretool-hook
- */
-
-const path = require('path');
-
-/** Tools that trigger code-intel injection. */
-const TARGET_TOOLS = new Set(['Write', 'Edit']);
-
-/** Safety timeout (ms) — defense-in-depth. */
-const HOOK_TIMEOUT_MS = 4000;
-
-/**
- * Read all data from stdin as a JSON object.
- * @returns {Promise<object>}
- */
-function readStdin() {
-  return new Promise((resolve, reject) => {
-    let data = '';
-    process.stdin.setEncoding('utf8');
-    process.stdin.on('error', (e) => reject(e));
-    process.stdin.on('data', (chunk) => { data += chunk; });
-    process.stdin.on('end', () => {
-      try { resolve(JSON.parse(data)); }
-      catch (e) { reject(e); }
-    });
-  });
-}
-
-/**
- * Main hook pipeline.
- */
-async function main() {
-  const input = await readStdin();
-
-  // Filter: only act on Write/Edit tools
-  const toolName = input && input.tool_name;
-  if (!toolName || !TARGET_TOOLS.has(toolName)) return;
-
-  // Extract file_path from tool input
-  const toolInput = input.tool_input;
-  if (!toolInput) return;
-  const filePath = toolInput.file_path;
-  if (!filePath) return;
-
-  // Resolve project root from hook cwd or process.cwd()
-  const cwd = input.cwd || process.cwd();
-
-  // Load hook-runtime (lazy — only when we actually need it)
-  const { resolveCodeIntel, formatAsXml } = require(
-    path.join(__dirname, '..', '..', '.aios-core', 'core', 'code-intel', 'hook-runtime.js'),
-  );
-
-  const intel = await resolveCodeIntel(filePath, cwd);
-  const xml = formatAsXml(intel, filePath);
-  if (!xml) return;
-
-  // Output in Claude Code hook format
-  const output = JSON.stringify({
-    hookSpecificOutput: {
-      additionalContext: xml,
-    },
-  });
-
-  const flushed = process.stdout.write(output);
-  if (!flushed) {
-    await new Promise((resolve) => process.stdout.once('drain', resolve));
-  }
-}
-
-/**
- * Safely exit — no-op inside Jest workers.
- * @param {number} code
- */
-function safeExit(code) {
-  if (process.env.JEST_WORKER_ID) return;
-  process.exit(code);
-}
-
-/** Entry point runner. */
-function run() {
-  const timer = setTimeout(() => safeExit(0), HOOK_TIMEOUT_MS);
-  timer.unref();
-  main()
-    .then(() => safeExit(0))
-    .catch(() => {
-      // Silent exit — stderr output triggers "hook error" in Claude Code UI
-      safeExit(0);
-    });
-}
-
-if (require.main === module) run();
-
-module.exports = { readStdin, main, run, HOOK_TIMEOUT_MS, TARGET_TOOLS };

package/docs/guides/aios-workflows/README.md

@@ -1,247 +0,0 @@
-# AIOS Workflows - Documentação Detalhada dos Workflows
-
-> 🌐 **PT** | [EN](../en/aios-workflows/README.md) | [ES](../es/aios-workflows/README.md)
-
----
-
-**Versão:** 1.0.0
-**Última Atualização:** 2026-02-05
-**Status:** Documentação Oficial
-
----
-
-## Visão Geral
-
-Esta pasta contém a documentação detalhada de todos os workflows do AIOS, incluindo:
-
-- **Diagramas Mermaid** completos (flowchart, sequence, state)
-- **Steps detalhados** com inputs/outputs
-- **Agentes participantes** e seus papéis
-- **Pontos de decisão** e condições
-- **Pré-requisitos** e configurações
-- **Troubleshooting** e modos de execução
-
----
-
-## Workflows Documentados
-
-### Por Tipo de Projeto
-
-| Tipo | Workflow | Descrição | Documento |
-|------|----------|-----------|-----------|
-| **Greenfield** | Fullstack | Aplicações full-stack do zero | [greenfield-fullstack-workflow.md](./greenfield-fullstack-workflow.md) |
-| **Greenfield** | Service | Backend/API do zero | [greenfield-service-workflow.md](./greenfield-service-workflow.md) |
-| **Greenfield** | UI | Frontend do zero | [greenfield-ui-workflow.md](./greenfield-ui-workflow.md) |
-| **Brownfield** | Discovery | Análise de projeto existente | [brownfield-discovery-workflow.md](./brownfield-discovery-workflow.md) |
-| **Brownfield** | Fullstack | Evolução full-stack existente | [brownfield-fullstack-workflow.md](./brownfield-fullstack-workflow.md) |
-| **Brownfield** | Service | Evolução backend existente | [brownfield-service-workflow.md](./brownfield-service-workflow.md) |
-| **Brownfield** | UI | Evolução frontend existente | [brownfield-ui-workflow.md](./brownfield-ui-workflow.md) |
-
-### Por Processo
-
-| Processo | Workflow | Descrição | Documento |
-|----------|----------|-----------|-----------|
-| **Development** | Story Cycle | Ciclo completo de story | [story-development-cycle-workflow.md](./story-development-cycle-workflow.md) |
-| **Quality** | QA Loop | Ciclo de qualidade | [qa-loop-workflow.md](./qa-loop-workflow.md) |
-| **Spec** | Spec Pipeline | Pipeline de especificação | [spec-pipeline-workflow.md](./spec-pipeline-workflow.md) |
-| **Design** | Design System | Construção de design system | [design-system-build-quality-workflow.md](./design-system-build-quality-workflow.md) |
-| **Git** | Auto Worktree | Gestão automática de worktrees | [auto-worktree-workflow.md](./auto-worktree-workflow.md) |
-
----
-
-## Estrutura de Cada Documento
-
-Cada documento de workflow segue esta estrutura padrão:
-
-```
-1. Visão Geral
-   - Objetivo do workflow
-   - Tipos de projeto suportados
-   - Quando usar / não usar
-
-2. Diagrama Mermaid
-   - Flowchart principal
-   - Diagrama de estados
-   - Diagrama de sequência
-
-3. Steps Detalhados
-   - ID, agente, ação
-   - Inputs e outputs
-   - Critérios de sucesso
-   - Status transitions
-
-4. Agentes Participantes
-   - Papel de cada agente
-   - Comandos relevantes
-
-5. Tasks Executadas
-   - Mapa de tasks por fase
-   - Arquivos de task
-
-6. Pré-requisitos
-   - Configuração necessária
-   - Documentação prerequisita
-   - Ferramentas integradas
-
-7. Entradas e Saídas
-   - Inputs do workflow
-   - Outputs produzidos
-
-8. Pontos de Decisão
-   - Condições de branching
-   - Critérios de bloqueio
-
-9. Modos de Execução
-   - YOLO (autônomo)
-   - Interactive (balanceado)
-   - Pre-Flight (planejamento)
-
-10. Troubleshooting
-    - Problemas comuns
-    - Logs e diagnóstico
-
-11. Changelog
-    - Histórico de versões
-```
-
----
-
-## Mapa de Workflows
-
-```mermaid
-flowchart TB
-    subgraph GREENFIELD["Greenfield (Novos Projetos)"]
-        GF["greenfield-fullstack"]
-        GS["greenfield-service"]
-        GU["greenfield-ui"]
-    end
-
-    subgraph BROWNFIELD["Brownfield (Projetos Existentes)"]
-        BD["brownfield-discovery"]
-        BF["brownfield-fullstack"]
-        BS["brownfield-service"]
-        BU["brownfield-ui"]
-    end
-
-    subgraph PROCESS["Processos"]
-        SDC["story-development-cycle"]
-        QAL["qa-loop"]
-        SP["spec-pipeline"]
-        DSB["design-system-build"]
-        AW["auto-worktree"]
-    end
-
-    BD --> BF
-    BD --> BS
-    BD --> BU
-
-    GF --> SDC
-    GS --> SDC
-    GU --> SDC
-    BF --> SDC
-    BS --> SDC
-    BU --> SDC
-
-    SDC --> QAL
-    SP --> SDC
-
-    style GREENFIELD fill:#c8e6c9
-    style BROWNFIELD fill:#fff9c4
-    style PROCESS fill:#e3f2fd
-```
-
----
-
-## Guia de Seleção de Workflow
-
-### Novo Projeto?
-
-```mermaid
-flowchart TD
-    A{Tipo de Projeto?} --> B[Full-Stack]
-    A --> C[Apenas Backend/API]
-    A --> D[Apenas Frontend]
-
-    B --> E[greenfield-fullstack]
-    C --> F[greenfield-service]
-    D --> G[greenfield-ui]
-```
-
-### Projeto Existente?
-
-```mermaid
-flowchart TD
-    A{Conhece o Projeto?} --> |Não| B[brownfield-discovery]
-    A --> |Sim| C{Tipo de Mudança?}
-
-    B --> C
-
-    C --> D[Full-Stack]
-    C --> E[Apenas Backend]
-    C --> F[Apenas Frontend]
-
-    D --> G[brownfield-fullstack]
-    E --> H[brownfield-service]
-    F --> I[brownfield-ui]
-```
-
----
-
-## Fluxo entre Workflows
-
-| De | Para | Condição |
-|----|------|----------|
-| `brownfield-discovery` | `brownfield-*` | Após análise completa |
-| `greenfield-*` | `story-development-cycle` | Para cada story |
-| `brownfield-*` | `story-development-cycle` | Para cada story |
-| `spec-pipeline` | `story-development-cycle` | Após spec aprovada |
-| `story-development-cycle` | `qa-loop` | Na fase de QA |
-
----
-
-## Como Usar Esta Documentação
-
-### Para Iniciar um Projeto
-
-1. Use o **Guia de Seleção** acima para escolher o workflow
-2. Leia a **Visão Geral** do workflow escolhido
-3. Verifique os **Pré-requisitos**
-4. Siga os **Steps** na ordem
-
-### Para Entender um Processo
-
-1. Analise os **Diagramas Mermaid**
-2. Veja os **Agentes Participantes** e seus papéis
-3. Consulte os **Pontos de Decisão**
-
-### Para Debugar Problemas
-
-1. Vá à seção **Troubleshooting**
-2. Verifique os **Logs e Diagnóstico**
-3. Consulte os **Critérios de Sucesso** de cada step
-
----
-
-## Relacionamento com Outras Documentações
-
-| Documentação | Localização | Propósito |
-|--------------|-------------|-----------|
-| Workflows Guide | [docs/guides/workflows-guide.md](../guides/workflows-guide.md) | Guia geral |
-| Agent Flows | [docs/aios-agent-flows/](../aios-agent-flows/) | Detalhes de agentes |
-| Agent Reference | [docs/agent-reference-guide.md](../agent-reference-guide.md) | Referência rápida |
-
----
-
-## Contribuindo
-
-Para adicionar ou atualizar documentação de workflows:
-
-1. Siga a estrutura padrão descrita acima
-2. Inclua diagramas Mermaid completos
-3. Documente todos os inputs/outputs
-4. Mantenha o changelog atualizado
-5. Crie traduções em EN e ES
-
----
-
-*AIOS Workflows Documentation v1.0 - Documentação detalhada dos workflows de desenvolvimento*