create-genia-os 2.1.1 → 2.3.0

package/template/.claude/hooks/synapse-engine.cjs

@@ -1,122 +1,122 @@
-#!/usr/bin/env node
-/**
- * GEN.IA OS — Synapse Engine v1.0
- * Trigger: UserPromptSubmit
- *
- * Pipeline de 3 camadas de injeção de contexto em cada prompt:
- *   L0: Constituição (sempre ativa, não-negociável)
- *   L1: Global + Contexto (sempre ativa)
- *   L2: Agente específico (quando @agente detectado no prompt)
- *
- * Timeout: 100ms — NUNCA bloqueia o usuário
- * Inspirado no AIOS Synapse Engine (MIT License, SynkraAI)
- * Adaptado e reescrito para GEN.IA OS — {{TEAM_NAME}} — {{CREATOR_NAME}}
- */
-
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const readline = require('readline');
-
-const TIMEOUT_MS = 100;
-const SYNAPSE_DIR = '.synapse';
-
-// Mapeamento de @agente → domínio synapse
-const AGENT_DOMAINS = {
-  '@analyst': 'agent-analyst',
-  '@pm': 'agent-pm',
-  '@architect': 'agent-architect',
-  '@dev': 'agent-dev',
-  '@devops': 'agent-devops',
-  '@qa': 'agent-qa',
-  '@reviewer': 'agent-reviewer',
-  '@po': 'agent-po',
-  '@sm': 'agent-sm',
-};
-
-function readDomain(cwd, domainName) {
-  try {
-    const domainPath = path.join(cwd, SYNAPSE_DIR, domainName);
-    if (fs.existsSync(domainPath)) {
-      return fs.readFileSync(domainPath, 'utf8').trim();
-    }
-  } catch (_) {
-    // Falha silenciosa — Synapse nunca quebra o fluxo
-  }
-  return null;
-}
-
-function detectActiveAgent(prompt) {
-  if (!prompt) return null;
-  const lower = prompt.toLowerCase();
-  for (const [mention, domain] of Object.entries(AGENT_DOMAINS)) {
-    if (lower.includes(mention)) {
-      return domain;
-    }
-  }
-  return null;
-}
-
-async function run() {
-  let inputData = '';
-  try {
-    const rl = readline.createInterface({ input: process.stdin, terminal: false });
-    for await (const line of rl) {
-      inputData += line + '\n';
-    }
-  } catch (_) {
-    return '';
-  }
-
-  let data = {};
-  try {
-    data = JSON.parse(inputData);
-  } catch (_) {
-    return '';
-  }
-
-  const cwd = data.cwd || process.cwd();
-  const prompt = data.prompt || '';
-  const layers = [];
-
-  // L0 — Constituição (sempre)
-  const constitution = readDomain(cwd, 'constitution');
-  if (constitution) layers.push(constitution);
-
-  // L1 — Global (sempre)
-  const global = readDomain(cwd, 'global');
-  if (global) layers.push(global);
-
-  // L1 — Contexto (sempre)
-  const context = readDomain(cwd, 'context');
-  if (context) layers.push(context);
-
-  // L2 — Agente específico (se detectado)
-  const agentDomain = detectActiveAgent(prompt);
-  if (agentDomain) {
-    const agentRules = readDomain(cwd, agentDomain);
-    if (agentRules) layers.push(agentRules);
-  }
-
-  if (layers.length === 0) return '';
-
-  return `<synapse-rules>\n${layers.join('\n\n')}\n</synapse-rules>`;
-}
-
-async function main() {
-  // Timer de segurança — garante timeout de 100ms
-  const timeoutPromise = new Promise((resolve) =>
-    setTimeout(() => resolve(''), TIMEOUT_MS)
-  );
-
-  const result = await Promise.race([run(), timeoutPromise]);
-
-  process.stdout.write(JSON.stringify({ hookSpecificOutput: result || '' }));
-  process.exit(0);
-}
-
-main().catch(() => {
-  process.stdout.write(JSON.stringify({ hookSpecificOutput: '' }));
-  process.exit(0);
-});
+#!/usr/bin/env node
+/**
+ * GEN.IA OS — Synapse Engine v1.0
+ * Trigger: UserPromptSubmit
+ *
+ * Pipeline de 3 camadas de injeção de contexto em cada prompt:
+ *   L0: Constituição (sempre ativa, não-negociável)
+ *   L1: Global + Contexto (sempre ativa)
+ *   L2: Agente específico (quando @agente detectado no prompt)
+ *
+ * Timeout: 100ms — NUNCA bloqueia o usuário
+ * Inspirado no AIOS Synapse Engine (MIT License, SynkraAI)
+ * Adaptado e reescrito para GEN.IA OS — {{TEAM_NAME}} — {{CREATOR_NAME}}
+ */
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const readline = require('readline');
+
+const TIMEOUT_MS = 100;
+const SYNAPSE_DIR = '.synapse';
+
+// Mapeamento de @agente → domínio synapse
+const AGENT_DOMAINS = {
+  '@analyst': 'agent-analyst',
+  '@pm': 'agent-pm',
+  '@architect': 'agent-architect',
+  '@dev': 'agent-dev',
+  '@devops': 'agent-devops',
+  '@qa': 'agent-qa',
+  '@reviewer': 'agent-reviewer',
+  '@po': 'agent-po',
+  '@sm': 'agent-sm',
+};
+
+function readDomain(cwd, domainName) {
+  try {
+    const domainPath = path.join(cwd, SYNAPSE_DIR, domainName);
+    if (fs.existsSync(domainPath)) {
+      return fs.readFileSync(domainPath, 'utf8').trim();
+    }
+  } catch (_) {
+    // Falha silenciosa — Synapse nunca quebra o fluxo
+  }
+  return null;
+}
+
+function detectActiveAgent(prompt) {
+  if (!prompt) return null;
+  const lower = prompt.toLowerCase();
+  for (const [mention, domain] of Object.entries(AGENT_DOMAINS)) {
+    if (lower.includes(mention)) {
+      return domain;
+    }
+  }
+  return null;
+}
+
+async function run() {
+  let inputData = '';
+  try {
+    const rl = readline.createInterface({ input: process.stdin, terminal: false });
+    for await (const line of rl) {
+      inputData += line + '\n';
+    }
+  } catch (_) {
+    return '';
+  }
+
+  let data = {};
+  try {
+    data = JSON.parse(inputData);
+  } catch (_) {
+    return '';
+  }
+
+  const cwd = data.cwd || process.cwd();
+  const prompt = data.prompt || '';
+  const layers = [];
+
+  // L0 — Constituição (sempre)
+  const constitution = readDomain(cwd, 'constitution');
+  if (constitution) layers.push(constitution);
+
+  // L1 — Global (sempre)
+  const global = readDomain(cwd, 'global');
+  if (global) layers.push(global);
+
+  // L1 — Contexto (sempre)
+  const context = readDomain(cwd, 'context');
+  if (context) layers.push(context);
+
+  // L2 — Agente específico (se detectado)
+  const agentDomain = detectActiveAgent(prompt);
+  if (agentDomain) {
+    const agentRules = readDomain(cwd, agentDomain);
+    if (agentRules) layers.push(agentRules);
+  }
+
+  if (layers.length === 0) return '';
+
+  return `<synapse-rules>\n${layers.join('\n\n')}\n</synapse-rules>`;
+}
+
+async function main() {
+  // Timer de segurança — garante timeout de 100ms
+  const timeoutPromise = new Promise((resolve) =>
+    setTimeout(() => resolve(''), TIMEOUT_MS)
+  );
+
+  const result = await Promise.race([run(), timeoutPromise]);
+
+  process.stdout.write(JSON.stringify({ hookSpecificOutput: result || '' }));
+  process.exit(0);
+}
+
+main().catch(() => {
+  process.stdout.write(JSON.stringify({ hookSpecificOutput: '' }));
+  process.exit(0);
+});

package/template/.claude/hooks/write-path-validation.py

@@ -1,59 +1,59 @@
-#!/usr/bin/env python3
-"""
-GEN.IA OS — Hook: write-path-validation
-Trigger: PreToolUse (Write)
-Ação: Avisa quando documentos são criados fora do path padrão.
-"""
-import json
-import sys
-import re
-import os
-
-
-# Padrões de arquivo → path recomendado
-DOC_RULES = {
-    r"^PRD\.md$": "docs/[projeto]/PRD.md",
-    r"^SPEC-TECNICO\.md$": "docs/[projeto]/SPEC-TECNICO.md",
-    r"^COMERCIAL\.md$": "docs/[projeto]/COMERCIAL.md",
-    r"^BRIEFING\.md$": "docs/[projeto]/BRIEFING.md",
-    r"^STORY-\d+.*\.md$": "docs/stories/STORY-NNN-slug.md",
-    r"^ADR-\d+.*\.md$": "docs/[projeto]/adrs/ADR-NNN-titulo.md",
-}
-
-
-def main():
-    try:
-        raw = sys.stdin.read()
-        data = json.loads(raw)
-    except Exception:
-        sys.exit(0)
-
-    tool = data.get("tool_name", "")
-    if tool != "Write":
-        sys.exit(0)
-
-    file_path = data.get("tool_input", {}).get("file_path", "")
-    if not file_path:
-        sys.exit(0)
-
-    # Normalizar separadores
-    normalized = file_path.replace("\\", "/")
-    filename = os.path.basename(normalized)
-
-    for pattern, correct_path in DOC_RULES.items():
-        if re.match(pattern, filename, re.IGNORECASE):
-            # Verificar se está no path correto
-            if "docs/" not in normalized:
-                print(
-                    f"[GEN.IA OS] ⚠️  Documento '{filename}' fora do path padrão.\n"
-                    f"[GEN.IA OS] Path recomendado: {correct_path}\n"
-                    f"[GEN.IA OS] Criando assim mesmo — ajuste se necessário.",
-                    file=sys.stderr,
-                )
-            break
-
-    sys.exit(0)  # Apenas avisa, não bloqueia
-
-
-if __name__ == "__main__":
-    main()
+#!/usr/bin/env python3
+"""
+GEN.IA OS — Hook: write-path-validation
+Trigger: PreToolUse (Write)
+Ação: Avisa quando documentos são criados fora do path padrão.
+"""
+import json
+import sys
+import re
+import os
+
+
+# Padrões de arquivo → path recomendado
+DOC_RULES = {
+    r"^PRD\.md$": "docs/[projeto]/PRD.md",
+    r"^SPEC-TECNICO\.md$": "docs/[projeto]/SPEC-TECNICO.md",
+    r"^COMERCIAL\.md$": "docs/[projeto]/COMERCIAL.md",
+    r"^BRIEFING\.md$": "docs/[projeto]/BRIEFING.md",
+    r"^STORY-\d+.*\.md$": "docs/stories/STORY-NNN-slug.md",
+    r"^ADR-\d+.*\.md$": "docs/[projeto]/adrs/ADR-NNN-titulo.md",
+}
+
+
+def main():
+    try:
+        raw = sys.stdin.read()
+        data = json.loads(raw)
+    except Exception:
+        sys.exit(0)
+
+    tool = data.get("tool_name", "")
+    if tool != "Write":
+        sys.exit(0)
+
+    file_path = data.get("tool_input", {}).get("file_path", "")
+    if not file_path:
+        sys.exit(0)
+
+    # Normalizar separadores
+    normalized = file_path.replace("\\", "/")
+    filename = os.path.basename(normalized)
+
+    for pattern, correct_path in DOC_RULES.items():
+        if re.match(pattern, filename, re.IGNORECASE):
+            # Verificar se está no path correto
+            if "docs/" not in normalized:
+                print(
+                    f"[GEN.IA OS] ⚠️  Documento '{filename}' fora do path padrão.\n"
+                    f"[GEN.IA OS] Path recomendado: {correct_path}\n"
+                    f"[GEN.IA OS] Criando assim mesmo — ajuste se necessário.",
+                    file=sys.stderr,
+                )
+            break
+
+    sys.exit(0)  # Apenas avisa, não bloqueia
+
+
+if __name__ == "__main__":
+    main()

package/template/.claude/rules/agent-authority.md

@@ -1,39 +1,39 @@
-# Autoridade dos Agentes — GEN.IA OS
-
-## Matriz de Delegação
-
-| Agente | Nome | Autoridade Exclusiva | Git Permitido | Git Bloqueado |
-|--------|------|---------------------|---------------|---------------|
-| @analyst | Ana | Briefing, requisitos, pesquisa | status, log, diff | push, commit, merge |
-| @pm | Marina | PRD, escopo, priorização, épicos | status, log, diff | push, commit, merge |
-| @architect | Arqui | Arquitetura, stack, VETO técnico | status, log, diff | push, commit, merge |
-| @dev | Dev | Implementação de código | checkout, add, commit | **PUSH (BLOQUEADO)** |
-| @devops | Gate | **git push, PR, release, MCP** | TUDO | nada |
-| @qa | Quinn | Veredictos de qualidade, testes | status, log, diff, stash | push, commit |
-| @reviewer | Rev | Code review, aprovação | status, log, diff | push, commit |
-| @po | Pax | Validação de stories, backlog | status, log, diff | push, commit, merge |
-| @sm | Sami | **Criação de stories**, sprint | status, log, diff | push, commit, merge |
-
-## Regras Invioláveis (Artigo II da Constituição)
-
-1. **@dev NUNCA faz push** — sempre delegar para @devops após commit
-2. **@sm é o ÚNICO que cria stories** — nenhum outro agente cria STORY-*.md
-3. **@architect tem veto técnico irrevogável** — qualquer decisão arquitetural
-4. **@po é o ÚNICO que aprova stories** para ir para desenvolvimento
-5. **@devops gerencia MCP** — nenhum outro agente adiciona/remove servidores MCP
-
-## Protocolo de Escalação
-
-Quando uma tarefa está fora do seu escopo:
-1. **PARAR** imediatamente
-2. **Anunciar** o agente correto: "Esta tarefa pertence a @[agente]"
-3. **Fazer handoff** usando o protocolo de `.claude/rules/agent-handoff.md`
-4. **NÃO executar** tarefas fora da sua autoridade
-
-## Exemplos de Escalação Obrigatória
-
-- @dev termina implementação → delega push para **@devops**
-- @dev tem dúvida arquitetural → consulta **@architect**
-- @pm precisa de requisitos → solicita para **@analyst**
-- @dev precisa de story → solicita para **@sm**
-- @sm criou story → entrega para **@po** validar
+# Autoridade dos Agentes — GEN.IA OS
+
+## Matriz de Delegação
+
+| Agente | Nome | Autoridade Exclusiva | Git Permitido | Git Bloqueado |
+|--------|------|---------------------|---------------|---------------|
+| @analyst | Ana | Briefing, requisitos, pesquisa | status, log, diff | push, commit, merge |
+| @pm | Marina | PRD, escopo, priorização, épicos | status, log, diff | push, commit, merge |
+| @architect | Arqui | Arquitetura, stack, VETO técnico | status, log, diff | push, commit, merge |
+| @dev | Dev | Implementação de código | checkout, add, commit | **PUSH (BLOQUEADO)** |
+| @devops | Gate | **git push, PR, release, MCP** | TUDO | nada |
+| @qa | Quinn | Veredictos de qualidade, testes | status, log, diff, stash | push, commit |
+| @reviewer | Rev | Code review, aprovação | status, log, diff | push, commit |
+| @po | Pax | Validação de stories, backlog | status, log, diff | push, commit, merge |
+| @sm | Sami | **Criação de stories**, sprint | status, log, diff | push, commit, merge |
+
+## Regras Invioláveis (Artigo II da Constituição)
+
+1. **@dev NUNCA faz push** — sempre delegar para @devops após commit
+2. **@sm é o ÚNICO que cria stories** — nenhum outro agente cria STORY-*.md
+3. **@architect tem veto técnico irrevogável** — qualquer decisão arquitetural
+4. **@po é o ÚNICO que aprova stories** para ir para desenvolvimento
+5. **@devops gerencia MCP** — nenhum outro agente adiciona/remove servidores MCP
+
+## Protocolo de Escalação
+
+Quando uma tarefa está fora do seu escopo:
+1. **PARAR** imediatamente
+2. **Anunciar** o agente correto: "Esta tarefa pertence a @[agente]"
+3. **Fazer handoff** usando o protocolo de `.claude/rules/agent-handoff.md`
+4. **NÃO executar** tarefas fora da sua autoridade
+
+## Exemplos de Escalação Obrigatória
+
+- @dev termina implementação → delega push para **@devops**
+- @dev tem dúvida arquitetural → consulta **@architect**
+- @pm precisa de requisitos → solicita para **@analyst**
+- @dev precisa de story → solicita para **@sm**
+- @sm criou story → entrega para **@po** validar

package/template/.claude/rules/agent-handoff.md

@@ -1,71 +1,71 @@
-# Protocolo de Handoff — GEN.IA OS
-
-## Quando Fazer Handoff
-
-Handoff é obrigatório quando:
-- Tarefa requer autoridade de outro agente (Artigo II)
-- Fase do workflow mudou
-- Blocker identificado fora do escopo atual
-- Trabalho está completo e próxima etapa é de outro agente
-
-## Formato de Handoff (≤ 400 tokens)
-
-```
-[@agente-atual → @próximo-agente]
-
-📋 Contexto: [O que foi feito em 2-3 frases]
-
-📌 Decisões tomadas:
-- [decisão 1]
-- [decisão 2]
-
-📁 Arquivos criados/modificados:
-- [path/arquivo.md]
-
-⚠️  Pendências:
-- [o que precisa ser feito]
-
-🔗 Story atual: STORY-NNN (se aplicável)
-```
-
-## Regra de Token Budget
-
-- Handoff DEVE ser ≤ 400 tokens
-- Após 2+ trocas de agente, comprimir histórico ao essencial
-- Não repassar contexto completo — apenas decisões e pendências
-
-## Compressão de Contexto
-
-Quando o contexto estiver saturado (muitas trocas de agente):
-
-1. Criar `.genia/session/context-summary.md` com:
-   - Decisões arquiteturais tomadas
-   - Stories em andamento e seus estados
-   - Blockers conhecidos
-   - Stack tecnológica confirmada
-
-2. Referenciar o arquivo no próximo handoff:
-   ```
-   [Contexto comprimido em .genia/session/context-summary.md]
-   ```
-
-## Exemplos de Handoff
-
-**@dev → @devops (após implementação):**
-```
-[@dev → @devops]
-📋 Implementei STORY-003 (autenticação JWT). Commits feitos localmente.
-📌 Decisões: Usei jose library, tokens expiram em 1h, refresh em 7d.
-📁 Modificados: src/auth/jwt.ts, src/middleware/auth.ts, tests/auth.test.ts
-⚠️  Pendências: Push da branch feat/STORY-003-jwt-auth e criar PR para main.
-🔗 Story atual: STORY-003 (status: InReview)
-```
-
-**@analyst → @pm (após briefing):**
-```
-[@analyst → @pm]
-📋 Coletei requisitos completos do sistema de orçamentos BrasilUp.
-📌 Decisões: App web (não mobile), integração com Kommo CRM, 3 usuários simultâneos.
-📁 Criados: docs/brasilup/BRIEFING.md
-⚠️  Pendências: Criar PRD com base no briefing. Atenção ao requisito de relatórios PDF.
-```
+# Protocolo de Handoff — GEN.IA OS
+
+## Quando Fazer Handoff
+
+Handoff é obrigatório quando:
+- Tarefa requer autoridade de outro agente (Artigo II)
+- Fase do workflow mudou
+- Blocker identificado fora do escopo atual
+- Trabalho está completo e próxima etapa é de outro agente
+
+## Formato de Handoff (≤ 400 tokens)
+
+```
+[@agente-atual → @próximo-agente]
+
+📋 Contexto: [O que foi feito em 2-3 frases]
+
+📌 Decisões tomadas:
+- [decisão 1]
+- [decisão 2]
+
+📁 Arquivos criados/modificados:
+- [path/arquivo.md]
+
+⚠️  Pendências:
+- [o que precisa ser feito]
+
+🔗 Story atual: STORY-NNN (se aplicável)
+```
+
+## Regra de Token Budget
+
+- Handoff DEVE ser ≤ 400 tokens
+- Após 2+ trocas de agente, comprimir histórico ao essencial
+- Não repassar contexto completo — apenas decisões e pendências
+
+## Compressão de Contexto
+
+Quando o contexto estiver saturado (muitas trocas de agente):
+
+1. Criar `.genia/session/context-summary.md` com:
+   - Decisões arquiteturais tomadas
+   - Stories em andamento e seus estados
+   - Blockers conhecidos
+   - Stack tecnológica confirmada
+
+2. Referenciar o arquivo no próximo handoff:
+   ```
+   [Contexto comprimido em .genia/session/context-summary.md]
+   ```
+
+## Exemplos de Handoff
+
+**@dev → @devops (após implementação):**
+```
+[@dev → @devops]
+📋 Implementei STORY-003 (autenticação JWT). Commits feitos localmente.
+📌 Decisões: Usei jose library, tokens expiram em 1h, refresh em 7d.
+📁 Modificados: src/auth/jwt.ts, src/middleware/auth.ts, tests/auth.test.ts
+⚠️  Pendências: Push da branch feat/STORY-003-jwt-auth e criar PR para main.
+🔗 Story atual: STORY-003 (status: InReview)
+```
+
+**@analyst → @pm (após briefing):**
+```
+[@analyst → @pm]
+📋 Coletei requisitos completos do sistema de orçamentos BrasilUp.
+📌 Decisões: App web (não mobile), integração com Kommo CRM, 3 usuários simultâneos.
+📁 Criados: docs/brasilup/BRIEFING.md
+⚠️  Pendências: Criar PRD com base no briefing. Atenção ao requisito de relatórios PDF.
+```