jarvis-ai-framework 1.0.0 → 1.0.2

package/README.md

@@ -12,7 +12,53 @@
 
 ## Get Started
 
-Por enquanto o Jarvis **não está no npm registry**. Clone o repo e instale a partir do path local.
+### 1. Instale
+
+Global (comando `jarvis` no PATH):
+
+```bash
+npm install -g jarvis-ai-framework
+```
+
+**Só neste workspace** (não sobe no PATH):
+
+```bash
+cd workspace-squad/
+npm install jarvis-ai-framework --save-dev
+```
+
+Confira **onde** o binário ficou no PATH (útil se houver mais de uma instalação):
+
+```bash
+which jarvis
+jarvis --version
+```
+
+> Quer editar o próprio framework (skills, agents, workflows) e ver as mudanças refletidas na hora? Veja [Desenvolvendo o Jarvis localmente](#desenvolvendo-o-jarvis-localmente) mais abaixo.
+
+### 2. Bootstrap da IDE
+
+```bash
+jarvis init --ide cursor
+```
+
+Se instalou só com `--save-dev`, use `npx jarvis init --ide cursor`.
+
+IDEs: `windsurf` · `claude` · `cursor` · `codex` · `opencode` · `gemini` · `kiro`
+
+### 3. No chat da IDE
+
+```
+/init-jarvis
+```
+
+Siga o guia do seu papel. Sem `/init-jarvis`, o `ENV.md` não existe e o resto dos comandos não tem contexto.
+
+---
+
+## Desenvolvendo o Jarvis localmente
+
+Se você quer editar o framework (skills, agents, workflows) e ver as mudanças refletidas na hora, instale a partir de um clone local em vez do npm registry.
 
 ### 1. Clone
 
@@ -22,7 +68,7 @@ git clone https://github.com/phelipperibeiro/jarvis-framework.git
 
 Ou baixe o ZIP e extraia. O path da pasta clonada é o que você usa no passo seguinte.
 
-### 2. Instale
+### 2. Instale a partir do clone
 
 Global (comando `jarvis` no PATH):
 
@@ -48,7 +94,7 @@ Isso já registra o comando `jarvis` no global. Opcional, para o workspace resol
 
 ```bash
 cd workspace-squad/
-npm link jarvis-framework
+npm link jarvis-ai-framework
 ```
 
 Confira **onde** o binário ficou no PATH (útil se houver mais de uma instalação):
@@ -58,29 +104,22 @@ which jarvis
 jarvis --version
 ```
 
-### 3. Bootstrap da IDE
+### 3. Bootstrap da IDE e 4. No chat da IDE
 
-```bash
-jarvis init --ide cursor
-```
+Mesmos passos 2 e 3 do [Get Started](#get-started) acima — `jarvis init --ide {ide}` e `/init-jarvis` no chat.
 
-Se instalou só com `--save-dev` (sem `-g` / `npm link`), use `npx jarvis init --ide cursor`.
+---
 
-IDEs: `windsurf` · `claude` · `cursor` · `codex` · `opencode` · `gemini` · `kiro`
+## Atualizar / sincronizar
 
-### 4. No chat da IDE
+**Instalou via npm registry** (fluxo padrão do [Get Started](#get-started)):
 
+```bash
+npm install -g jarvis-ai-framework@latest
+jarvis init --ide {ide}   # re-sincroniza os assets (agents/skills/workflows/rules)
 ```
-/init-jarvis
-```
-
-Siga o guia do seu papel. Sem `/init-jarvis`, o `ENV.md` não existe e o resto dos comandos não tem contexto.
-
----
-
-## Atualizar / sincronizar
 
-Quando o repo no GitHub ganhar commits novos (skills, agents, workflows…), sincronize assim:
+**Instalou via clone local** (fluxo de [Desenvolvendo o Jarvis localmente](#desenvolvendo-o-jarvis-localmente)) — quando o repo no GitHub ganhar commits novos, sincronize assim:
 
 ### 1. Atualizar o clone
 

package/bin/commands/install-rtk.js

@@ -11,6 +11,15 @@ function commandExists(cmd) {
   }
 }
 
+function isValidTokenKiller() {
+  try {
+    const helpOutput = execSync("rtk gain --help 2>&1", { encoding: "utf-8" });
+    return helpOutput.toLowerCase().includes("gain") || helpOutput.toLowerCase().includes("token");
+  } catch {
+    return false;
+  }
+}
+
 export async function installRtk(flags) {
   configureFromFlags(flags);
 
@@ -21,13 +30,20 @@ export async function installRtk(flags) {
 
   // 1. Verificar se RTK já está instalado
   if (commandExists("rtk")) {
-    try {
-      const version = execSync("rtk --version", { encoding: "utf-8" }).trim();
-      logger.info(`${GREEN}✓ RTK já instalado: ${version}${NC}`);
-      logger.info(`${DIM}  Para atualizar: cargo install rtk --force${NC}`);
+    // Validar que é o Token Killer (não Rust Type Kit)
+    if (isValidTokenKiller()) {
+      try {
+        const version = execSync("rtk --version", { encoding: "utf-8" }).trim();
+        logger.info(`${GREEN}✓ RTK já instalado: ${version}${NC}`);
+        logger.info(`${DIM}  Para atualizar: cargo install brokk-rtk --force${NC}`);
+        logger.info("");
+        return;
+      } catch {}
+    } else {
+      logger.info(`${YELLOW}⚠ RTK encontrado mas não é o Token Killer (Rust Type Kit detectado)${NC}`);
+      logger.info(`${DIM}  Sobrescrevendo com Token Killer...${NC}`);
       logger.info("");
-      return;
-    } catch {}
+    }
   }
 
   // 2. Verificar se cargo está disponível
@@ -64,7 +80,7 @@ export async function installRtk(flags) {
   logger.info(`${YELLOW}⏳ Instalando RTK via cargo (pode levar alguns minutos)...${NC}`);
   logger.info("");
   try {
-    execSync("cargo install rtk", { stdio: "inherit" });
+    execSync("cargo install brokk-rtk", { stdio: "inherit" });
   } catch (err) {
     logger.error(`${RED}✗ Falha ao instalar RTK: ${err.message}${NC}`);
     logger.info("");
@@ -73,14 +89,22 @@ export async function installRtk(flags) {
 
   // 4. Verificar instalação
   if (commandExists("rtk")) {
-    const version = execSync("rtk --version", { encoding: "utf-8" }).trim();
-    logger.info("");
-    logger.info(`${GREEN}✓ RTK instalado com sucesso: ${version}${NC}`);
-    logger.info("");
-    logger.info(`${YELLOW}Próximo passo:${NC}`);
-    logger.info(`  Execute ${GREEN}jarvis init${NC} (ou atualize o ENV.md) para ativar ${GREEN}RTK_ENABLED=true${NC}`);
-    logger.info(`  A rule de economia de tokens será ativada automaticamente.`);
-    logger.info("");
+    if (isValidTokenKiller()) {
+      const version = execSync("rtk --version", { encoding: "utf-8" }).trim();
+      logger.info("");
+      logger.info(`${GREEN}✓ RTK instalado com sucesso: ${version}${NC}`);
+      logger.info("");
+      logger.info(`${YELLOW}Próximo passo:${NC}`);
+      logger.info(`  Execute ${GREEN}jarvis init${NC} (ou atualize o ENV.md) para ativar ${GREEN}RTK_ENABLED=true${NC}`);
+      logger.info(`  A rule de economia de tokens será ativada automaticamente.`);
+      logger.info("");
+    } else {
+      logger.error(`${RED}✗ RTK instalado mas não é o Token Killer${NC}`);
+      logger.info(`${DIM}  Possível conflito: crate 'rtk' no crates.io é Rust Type Kit, não Token Killer${NC}`);
+      logger.info(`${DIM}  Use: cargo install brokk-rtk${NC}`);
+      logger.info("");
+      process.exit(1);
+    }
   } else {
     logger.error(`${RED}✗ RTK não encontrado no PATH após instalação${NC}`);
     logger.info(`${DIM}  Reinicie o terminal e verifique: rtk --version${NC}`);

package/bin/lib/core/sync-engine.js

@@ -189,7 +189,7 @@ function reconcileRtk(ideDir, targetDir, ide) {
   const envPath = join(ideDir, "ENV.md");
   const hasRtk = (() => {
     try {
-      execSync("which rtk 2>/dev/null", { stdio: "pipe" });
+      execSync("rtk gain --help 2>/dev/null", { stdio: "pipe" });
       return true;
     } catch {
       return false;

package/bin/postinstall.js

@@ -33,7 +33,7 @@ if (existsSync(lockPath)) {
 
 // ── Sugestão RTK (sempre, se rtk não estiver instalado) ─────────────────────
 try {
-  execSync("which rtk 2>/dev/null", { stdio: "pipe" });
+  execSync("rtk gain --help 2>/dev/null", { stdio: "pipe" });
 } catch {
   const { logger } = await import("./lib/utils/logger.js");
   logger.info(`  💡 Dica: instale o RTK para economizar 60-90% dos tokens de shell.`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jarvis-ai-framework",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Jarvis framework",
   "type": "module",
   "bin": {

package/rules/rtk-rules.md

@@ -17,11 +17,11 @@ Quando `RTK_ENABLED=true` no ENV.md, use o prefixo `rtk` em chamadas Bash para r
 **Antes de executar qualquer comando Bash**, verificar se RTK está disponível:
 
 ```bash
-which rtk 2>/dev/null
+rtk gain --help 2>/dev/null
 ```
 
-- Se RTK estiver no PATH: usar `rtk <comando>` em vez do comando direto
-- Se RTK **não** estiver no PATH: executar o comando original sem alteração
+- Se RTK estiver no PATH com subcomando `gain`: usar `rtk <comando>` em vez do comando direto
+- Se RTK **não** estiver no PATH ou não suportar `gain`: executar o comando original sem alteração
 
 **Fallback gracioso**: nunca falhar por causa do RTK. Se `rtk` não estiver
 instalado ou retornar erro, executar o comando original.
@@ -47,6 +47,24 @@ O RTK comprime o output automaticamente — o comportamento do comando não muda
 
 ---
 
+## ⚠️ Conflito de Nome de Crate
+
+O crate `rtk` no crates.io é o **Rust Type Kit** (FFI generator), **não** o Token Killer.
+
+**Instalar o correto:**
+```bash
+cargo install brokk-rtk
+```
+
+**NUNCA faça:**
+```bash
+cargo install rtk  # ❌ Isso instala Rust Type Kit, não Token Killer
+```
+
+Use o comando `npx jarvis install-rtk` que valida e instala a ferramenta correta automaticamente.
+
+---
+
 ## Meta-comandos RTK (usar diretamente)
 
 Estes comandos são do próprio RTK e devem ser usados sem proxy:
@@ -65,4 +83,4 @@ rtk proxy <cmd>       # Executar comando sem filtro (debug)
 - Comandos interativos que precisam de input do usuário
 - Pipes complexos onde a compressão pode afetar o resultado
 - Quando o comando original precisa de output exato (ex: parsing JSON)
-- Se `which rtk` falhar — usar o comando original silenciosamente
+- Se `rtk gain --help` falhar — usar o comando original silenciosamente

package/skills/init-jarvis/SKILL.md

@@ -591,7 +591,7 @@ Nunca grave TOKEN_VERSION_CONTROL (chave removida do template).
 **Após as variáveis opcionais**, verificar automaticamente se o RTK está instalado:
 
 ```bash
-which rtk 2>/dev/null
+rtk gain --help 2>/dev/null
 ```
 
 **Se RTK encontrado no PATH:**
@@ -605,7 +605,7 @@ which rtk 2>/dev/null
 **Se RTK NÃO encontrado:**
 ```
 ℹ️ RTK não detectado. Integração desativada.
-   Para instalar: cargo install rtk (requer Rust)
+   Para instalar: cargo install brokk-rtk (requer Rust)
    → RTK_ENABLED=false
 ```