agim-orchestrator 1.1.2 → 1.1.4

package/CHANGELOG.md

@@ -14,6 +14,40 @@ e este projeto adere ao [Versionamento Semântico](https://semver.org/lang/pt-BR
 
 ---
 
+## [1.1.4] - 2026-10-29
+
+### Adicionado
+- **`--json` em todos os comandos** — `sync`, `graph`, `rag:rebuild`, `core:link` agora suportam saída estruturada para CI/CD e integração com ferramentas externas.
+- **`agim init` com RAG por padrão** — tenta criar índice do projeto se `@xenova/transformers` estiver disponível; caso contrário, orienta como instalar.
+
+### Corrigido
+- **`agim sync --json`** — saída estruturada para automação.
+- **`agim graph --json`** — captura saída do Graphify e retorna JSON.
+- **`agim rag:rebuild --json`** — output estruturado (sucesso/erro).
+- **`agim core:link --json`** — resultado estruturado do link.
+
+### Alterado
+- `agim init` não pula mais RAG silenciosamente — tenta criar índice do projeto por padrão.
+
+---
+
+## [1.1.3] - 2026-10-29
+
+### Adicionado
+- **`agim doctor`**: mensagens RAG melhoradas — mostra chunks/arquivos do índice do projeto, menciona economia de tokens, não menciona "global/core".
+- **`agim init`**: tentativa de RAG por padrão — avisa se dependência `@xenova/transformers` não está instalada e orienta como ativar economia de tokens.
+- **`agim audit --json`**: output estruturado para CI/CD (já funcionava, agora documentado).
+
+### Corrigido
+- **`agim doctor` RAG**: remove menção confusa a "índice RAG global" — agora diz "nenhum índice deste projeto" e orienta `agim rag:rebuild`.
+- **`agim init` RAG**: não pula mais silenciosamente — informa se dependência `@xenova/transformers` falta e como instalar.
+
+### Alterado
+- `agim init` não pula mais RAG silenciosamente (era `--skip-rag` por padrão implícito).
+- Mensagens de `doctor` e `init` padronizadas para focar em "economia de tokens".
+
+---
+
 ## [1.1.2] - 2026-10-29
 
 ### Corrigido (P0 — bloqueadores de release)

package/CONTRIBUTING.md

@@ -8,6 +8,10 @@ Obrigado por considerar contribuir para a **Bíblia Universal de IA**! Este docu
 
 Este projeto está licenciado sob a **Licença MIT** — veja o arquivo [LICENSE](LICENSE) para detalhes.
 
+## 📚 Documentação
+
+Manual do usuário: [github.com/Brendontailor/agim-docs](https://github.com/Brendontailor/agim-docs)
+
 ## 📋 Índice
 
 - [Código de Conduta](#código-de-conduta)

package/README.en.md

@@ -1,9 +1,10 @@
-# AGIM (Agent Grimoire)
+# AGIM (Agent Grimoire) — **v1.1.3**
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![npm version](https://img.shields.io/npm/v/agim-orchestrator.svg)](https://www.npmjs.com/package/agim-orchestrator)
 [![npm downloads](https://img.shields.io/npm/dm/agim-orchestrator.svg)](https://www.npmjs.com/package/agim-orchestrator)
 [![Node Version](https://img.shields.io/node/v/agim-orchestrator.svg)](https://www.npmjs.com/package/agim-orchestrator)
+[![Documentation](https://img.shields.io/badge/docs-agim--docs-blue.svg)](https://github.com/Brendontailor/agim-docs)
 
 > **AGIM (Agent Grimoire)** is an orchestration engine for AI agents.
 > It installs what an agent needs to work with discipline: clear rules, persistent memory, skills, checklists, templates and automatic validation.
@@ -12,6 +13,8 @@
 
 It works with any agent that reads `AGENTS.md` (OpenCode, Claude Code, Cursor, Copilot, Codex and similar).
 
+> **Full documentation**: [github.com/Brendontailor/agim-docs](https://github.com/Brendontailor/agim-docs)
+
 ---
 
 ## Table of contents

package/README.md

@@ -1,9 +1,10 @@
-# AGIM (Agent Grimoire)
+# AGIM (Agent Grimoire) — **v1.1.3**
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![npm version](https://img.shields.io/npm/v/agim-orchestrator.svg)](https://www.npmjs.com/package/agim-orchestrator)
 [![npm downloads](https://img.shields.io/npm/dm/agim-orchestrator.svg)](https://www.npmjs.com/package/agim-orchestrator)
 [![Node Version](https://img.shields.io/node/v/agim-orchestrator.svg)](https://www.npmjs.com/package/agim-orchestrator)
+[![Documentation](https://img.shields.io/badge/docs-agim--docs-blue.svg)](https://github.com/Brendontailor/agim-docs)
 
 > **AGIM (Agent Grimoire)** é um motor de orquestração para agentes de IA.
 > Ele instala, no seu projeto, o que um agente precisa para trabalhar com disciplina: regras claras, memória persistente, skills, checklists, templates e validação automática.
@@ -12,6 +13,8 @@
 
 Funciona com qualquer agente que leia `AGENTS.md` (OpenCode, Claude Code, Cursor, Copilot, Codex e similares).
 
+> **Documentação completa**: [github.com/Brendontailor/agim-docs](https://github.com/Brendontailor/agim-docs)
+
 ---
 
 ## Índice

package/docs/TROUBLESHOOTING.md

@@ -2,6 +2,8 @@
 
 > Cada entrada segue o formato **mensagem → causa → solução**.
 > Comece sempre por `agim doctor`: ele aponta o que falta e qual comando resolve.
+>
+> **Documentação completa**: [github.com/Brendontailor/agim-docs](https://github.com/Brendontailor/agim-docs)
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agim-orchestrator",
-  "version": "1.1.2",
+  "version": "1.1.4",
   "description": "AGIM (Agent Grimoire): motor de orquestração para agentes de IA com skills, sub-agentes, memória persistente, checklists e validação.",
   "type": "module",
   "bin": {
@@ -50,10 +50,11 @@
     "type": "git",
     "url": "git+https://github.com/Brendontailor/AGIM.git"
   },
-  "homepage": "https://github.com/Brendontailor/AGIM#readme",
+  "homepage": "https://github.com/Brendontailor/agim-docs#readme",
   "bugs": {
     "url": "https://github.com/Brendontailor/AGIM/issues"
   },
+  "documentation": "https://github.com/Brendontailor/agim-docs",
   "engines": {
     "node": ">=18.0.0"
   },

package/scripts/agim-cli.cjs

@@ -153,13 +153,14 @@ const COMMANDS = {
 
   graph: {
     description: 'Consulta o grafo de código com Graphify (se instalado)',
-    usage: 'agim graph "pergunta" [--cwd <dir>]',
-    run: ({ positional, values }) => {
+    usage: 'agim graph "pergunta" [--json] [--cwd <dir>]',
+    run: ({ positional, flags, values }) => {
       const pergunta = positional.slice(1).join(' ').trim();
       if (!pergunta) {
         console.log('Uso: agim graph "pergunta sobre o código"');
         return { ok: false };
       }
+      const asJson = flags.has('json');
 
       const cwd = cwdFrom(values);
       const isWindows = process.platform === 'win32';
@@ -185,8 +186,12 @@ const COMMANDS = {
 
       const result = spawnSync(cmd, [...prefix, 'query', pergunta], {
         cwd,
-        stdio: 'inherit'
+        stdio: asJson ? 'pipe' : 'inherit',
+        encoding: 'utf8'
       });
+      if (asJson) {
+        console.log(JSON.stringify({ ok: result.status === 0, output: result.stdout?.trim() || '', error: result.stderr?.trim() || '' }, null, 2));
+      }
       return { ok: result.status === 0 };
     }
   },
@@ -240,17 +245,46 @@ const ALIASES = {
     const { validate } = require('./config-schema.cjs');
     return { ok: validate(values && values.cwd ? path.resolve(values.cwd) : process.cwd()).valid };
   },
-  'rag:rebuild': () => runRagRebuild(),
-  'core:link': ({ values } = {}) => {
+  'rag:rebuild': ({ flags } = {}) => {
+    const script = path.join(__dirname, 'bible-rag-index.js');
+    const asJson = flags?.has('json') || process.argv.includes('--json');
+    if (!hasDependency('@xenova/transformers')) {
+      if (asJson) {
+        console.log(JSON.stringify({ ok: false, reason: 'missing-dependency', message: 'Dependência opcional ausente: @xenova/transformers' }, null, 2));
+      } else {
+        console.log('⚠️  Dependência opcional ausente: @xenova/transformers');
+        console.log('   Instale com: npm install -g @xenova/transformers');
+      }
+      return { ok: false, reason: 'missing-dependency' };
+    }
+    const result = spawnSync(process.execPath, [script, '--rebuild'], { 
+      stdio: asJson ? 'pipe' : 'inherit',
+      encoding: 'utf8'
+    });
+    if (asJson) {
+      console.log(JSON.stringify({ ok: result.status === 0, output: result.stdout?.trim() || '', error: result.stderr?.trim() || '' }, null, 2));
+    }
+    return { ok: result.status === 0 };
+  },
+  'core:link': ({ flags, values } = {}) => {
+    const asJson = flags?.has('json') || process.argv.includes('--json');
     const { ensureCore, createCoreLink } = require('./core-link.cjs');
     const ensured = ensureCore();
     if (!ensured.ok) {
-      console.log(`❌ Core indisponível: ${ensured.reason}`);
+      if (asJson) {
+        console.log(JSON.stringify({ ok: false, reason: 'core-unavailable', message: ensured.reason }, null, 2));
+      } else {
+        console.log(`❌ Core indisponível: ${ensured.reason}`);
+      }
       return { ok: false };
     }
-    return createCoreLink(values && values.cwd ? path.resolve(values.cwd) : process.cwd(), {
+    const result = createCoreLink(values && values.cwd ? path.resolve(values.cwd) : process.cwd(), {
       force: process.argv.includes('--force')
     });
+    if (asJson) {
+      console.log(JSON.stringify({ ok: result.ok, ...result }, null, 2));
+    }
+    return result;
   }
 };
 

package/scripts/bootstrap-init.cjs

@@ -285,16 +285,35 @@ agim interview "Definir objetivo do projeto"
 
 function initRAG(cwd, skipRag = false) {
   if (skipRag) return { skipped: true, reason: 'flag --skip-rag' };
-  const indexFile = path.join(
-    process.env.USERPROFILE || process.env.HOME || '',
-    '.agent-bible',
-    'rag_index',
-    'bible-index.json'
-  );
-  if (fs.existsSync(indexFile)) {
-    return { skipped: true, reason: 'índice global já existe', indexFile };
+  
+  const projectIndex = path.join(cwd, '.agim', 'rag', 'bible-index.json');
+  if (fs.existsSync(projectIndex)) {
+    return { skipped: true, reason: 'índice do projeto já existe', indexFile: projectIndex };
+  }
+  
+  // Tentar criar índice do projeto se @xenova/transformers estiver disponível
+  try {
+    require.resolve('@xenova/transformers');
+    // Dep disponível - criar índice do projeto
+    const script = path.join(__dirname, 'bible-rag-index.js');
+    if (fs.existsSync(script)) {
+      const { spawnSync } = require('child_process');
+      const result = spawnSync(process.execPath, [script, '--rebuild', '--project', cwd], { 
+        stdio: 'inherit',
+        timeout: 300000
+      });
+      if (result.status === 0 && fs.existsSync(projectIndex)) {
+        return { skipped: false, reason: 'índice do projeto criado', indexFile: projectIndex };
+      }
+      return { skipped: true, reason: 'falha ao criar índice do projeto (rode `agim rag:rebuild`)' };
+    }
+    return { skipped: true, reason: 'script de RAG não encontrado' };
+  } catch {
+    return { 
+      skipped: true, 
+      reason: 'dependência @xenova/transformers não instalada — rode `npm i -g @xenova/transformers` e depois `agim rag:rebuild` para ativar economia de tokens' 
+    };
   }
-  return { skipped: true, reason: 'índice global ainda não construído (rode `agim rag:rebuild`)', indexFile };
 }
 
 function initGraphify(cwd, skipGraphify = false) {

package/scripts/doctor.cjs

@@ -119,10 +119,34 @@ function checkRag(cwd) {
     path.join(cwd, '.agim', 'rag_index', 'bible-index.json'),
     path.join(cwd, 'rag_index', 'bible-index.json')
   ];
-  if (projectIndexes.some((file) => fs.existsSync(file))) {
-    return { ok: true, level: 'optional', message: 'índice RAG do projeto presente' };
+  
+  let indexFile = null;
+  for (const file of projectIndexes) {
+    if (fs.existsSync(file)) {
+      indexFile = file;
+      break;
+    }
   }
-
+  
+  if (indexFile) {
+    // Tentar ler chunks/arquivos do índice
+    let chunks = 0, files = 0;
+    try {
+      const content = fs.readFileSync(indexFile, 'utf8');
+      const index = JSON.parse(content);
+      chunks = index.chunks?.length || index.totalChunks || Object.keys(index).length;
+      files = index.files?.length || index.totalFiles || 0;
+    } catch {
+      // índice corrompido ou formato diferente
+    }
+    return {
+      ok: true,
+      level: 'optional',
+      message: `RAG: índice ativo (${chunks} chunks, ${files} arquivos) — economia de tokens ativa`
+    };
+  }
+  
+  // Verificar global (não mencionar "global" explicitamente, só dizer que não há do projeto)
   const globalIndex = path.join(
     process.env.USERPROFILE || process.env.HOME || '',
     '.agent-bible',
@@ -133,10 +157,15 @@ function checkRag(cwd) {
     return {
       ok: false,
       level: 'optional',
-      message: 'índice RAG global existe, mas não há índice deste projeto (opcional: `agim rag:rebuild`)'
+      message: 'RAG: nenhum índice deste projeto — rode `agim rag:rebuild` para ativar economia de tokens'
     };
   }
-  return { ok: false, level: 'optional', message: 'índice RAG ausente (opcional: `agim rag:rebuild`)' };
+  
+  return { 
+    ok: false, 
+    level: 'optional', 
+    message: 'RAG: ausente — rode `agim rag:rebuild` para ativar economia de tokens (contexto não reenviado a cada turno)' 
+  };
 }
 
 function checkGraphify(cwd) {

package/scripts/sync-agents-md.cjs

@@ -37,7 +37,8 @@ function sync(options = {}) {
   const cwd = options.cwd || process.cwd();
   const check = options.check === true;
   const force = options.force === true;
-  const log = options.quiet === true ? () => {} : console.log;
+  const asJson = options.asJson === true;
+  const log = options.quiet === true || asJson ? () => {} : console.log;
   const agentsPath = path.join(cwd, 'AGENTS.md');
 
   log('═'.repeat(50));
@@ -101,7 +102,8 @@ if (require.main === module) {
   const args = process.argv.slice(2);
   const cwdIndex = args.indexOf('--cwd');
   const cwd = cwdIndex !== -1 && args[cwdIndex + 1] ? args[cwdIndex + 1] : process.cwd();
-  const result = sync({ cwd, check: args.includes('--check'), force: args.includes('--force') });
+  const result = sync({ cwd, check: args.includes('--check'), force: args.includes('--force'), asJson: args.includes('--json') });
+  if (args.includes('--json')) console.log(JSON.stringify(result, null, 2));
   if (args.includes('--check') && result.drift) process.exit(1);
   if (result.synced === false && result.reason && result.reason !== 'missing-markers') process.exit(1);
 }