agim-orchestrator 1.1.2 → 1.1.3

package/CHANGELOG.md

@@ -14,6 +14,23 @@ e este projeto adere ao [Versionamento Semântico](https://semver.org/lang/pt-BR
 
 ---
 
+## [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

@@ -4,6 +4,7 @@
 [![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

@@ -4,6 +4,7 @@
 [![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.3",
   "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/bootstrap-init.cjs

@@ -285,16 +285,33 @@ agim interview "Definir objetivo do projeto"
 
 function initRAG(cwd, skipRag = false) {
   if (skipRag) return { skipped: true, reason: 'flag --skip-rag' };
-  const indexFile = path.join(
+  
+  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 };
+  }
+  
+  const globalIndex = 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 };
+  if (fs.existsSync(globalIndex)) {
+    return { skipped: true, reason: 'índice global existe (use `agim rag:rebuild` para criar do projeto)', indexFile: globalIndex };
+  }
+  
+  // Tentar criar índice do projeto se @xenova/transformers estiver disponível
+  try {
+    require.resolve('@xenova/transformers');
+    // Dep disponível - poderia criar, mas deixamos para rag:rebuild explícito
+    return { skipped: true, reason: 'dependência disponível — rode `agim rag:rebuild` para criar índice do projeto' };
+  } 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) {