sauron-cli 1.4.5 → 1.4.7

package/README.md

@@ -2,7 +2,7 @@
 
 > O "Lobo Frontal" dos assistentes de código de IA. Resolva a amnésia de contexto de uma vez por todas.
 
-O **Sauron CLI** é uma infraestrutura passiva de orquestração de contexto para IAs. Ele injeta um "Cérebro" estruturado nos seus repositórios, forçando as Inteligências Artificiais (como Cursor, Windsurf e Aider) a respeitarem um conceito de **"Write Obligation" (Obrigação de Escrita)**. Em vez de apenas ler código, a IA passará a documentar decisões de negócio e arquitetura continuamente, garantindo que o seu projeto não quebre após meses sem ser tocado.
+O **Sauron CLI** é uma infraestrutura passiva de orquestração de contexto para IAs. Ele injeta um "Cérebro" estruturado nos seus repositórios, forçando as Inteligências Artificiais (como Cursor, Windsurf, Aider, Claude Code, Codex e Opencode) a respeitarem um conceito de **"Write Obligation" (Obrigação de Escrita)**. Em vez de apenas ler código, a IA passará a documentar decisões de negócio e arquitetura continuamente, garantindo que o seu projeto não quebre após meses sem ser tocado.
 
 ## O Problema
 
@@ -12,6 +12,16 @@ Assistentes de código são incrivelmente poderosos, mas sofrem de amnésia vol
 
 O Sauron resolve isso ejetando pastas estruturadas (`.sauron` e `.agents`) no seu repositório local. A partir desse momento, as IAs são condicionadas a documentar regras passivamente de acordo com os templates gerados, preservando o **Single Source of Truth** do seu produto.
 
+## Destaques da versão 1.4.7
+
+A versão `1.4.7` aprimora a instalação passiva do Sauron para garantir que reinstalações e atualizações não dupliquem blocos de governança nos arquivos dos agentes.
+
+- **Injeção de memória idempotente**: o `init` agora usa o template canônico `templates/.agents/rules/memory.md` como fonte limpa para os adaptadores, evitando aninhamento repetido de `SAURON START/END`.
+- **Mais agentes detectados automaticamente**: o scanner agora reconhece Codex, Opencode e Claude Code, além de Cursor, Windsurf, Aider e Antigravity.
+- **Marcadores de stack aninhados**: assinaturas como `prisma/schema.prisma` agora podem ser detectadas mesmo quando o arquivo marcador está dentro de subpastas conhecidas.
+- **Auditoria mais fiel ao projeto**: o `doctor` prioriza os targets definidos no manifesto local antes do registro global da máquina.
+- **Versão sincronizada**: `sauron --version` passa a ler a versão diretamente do `package.json`.
+
 
 ## Instalação
 
@@ -26,7 +36,7 @@ npx sauron-cli init
 ### `sauron init`
 
 Inicializa o Sauron Memory System no projeto atual de forma inteligente.
-O comando executa uma **varredura heurística não-bloqueante** ($O(1)$) na raiz do repositório para detectar de forma autônoma a linguagem primária, frameworks, bancos de dados, gerenciadores de pacotes e ferramentas de IA ativas (Cursor, Windsurf, Aider, Antigravity).
+O comando executa uma **varredura heurística não-bloqueante** ($O(1)$) na raiz do repositório para detectar de forma autônoma a linguagem primária, frameworks, bancos de dados, gerenciadores de pacotes e ferramentas de IA ativas (Cursor, Windsurf, Aider, Antigravity, Claude Code, Codex, Opencode).
 
 Durante o onboarding interativo, as perguntas são pré-populadas de forma inteligente com as informações detectadas. Ao concluir, o Sauron realiza a **injeção automática de receitas de Wiki** (Wiki Recipes) personalizadas para a sua stack tecnológica em `.sauron/wiki/standards/` (ex. TypeScript, Next.js, React, Tailwind CSS, PostgreSQL) de forma idempotente e não-destrutiva, gerando o manifesto dinâmico `AGENTS.md` e as regras de governança locais das IAs.
 
@@ -35,6 +45,7 @@ O comando é totalmente **Idempotente**. Se executado em um repositório já ini
 - **Fast-Track (Bypass)**: O CLI detecta a configuração passada e oferece a opção de pular o onboarding, atualizando os agentes internos silenciosamente.
 - **Reidratação Interativa**: Caso você queira alterar a configuração, os formulários do terminal são reidratados com o seu último estado configurado, poupando a necessidade de redigitar contextos complexos.
 - **Wiki Protection**: Um filtro cirúrgico é ativado no motor de cópia da CLI, tornando a sua Base de Conhecimento em `.sauron/wiki/` 100% blindada contra *overwrites* acidentais durante a atualização.
+- **Canonical Memory Payload**: Os arquivos específicos de agentes são regenerados a partir de uma fonte limpa de template, preservando a fluidez da governança passiva sem acumular wrappers de instalações anteriores.
 
 ### Como Atualizar um Projeto Existente
 Para trazer as regras e inteligências mais recentes para o seu repositório sem perder o seu contexto salvo, basta rodar o `init` forçando a versão `@latest` do NPM:

package/dist/index.js

@@ -2,6 +2,7 @@
 
 // src/index.ts
 import { Command } from "commander";
+import { createRequire } from "module";
 
 // src/features/init/init.command.ts
 import fs13 from "fs-extra";
@@ -630,6 +631,28 @@ var WikiBootstrapper = class {
 };
 
 // src/features/init/init.service.ts
+var ADAPTER_OWNED_TEMPLATE_FILES = /* @__PURE__ */ new Set([".agents/rules/memory.md"]);
+function stripLeadingFrontmatter(content) {
+  let normalized = content.trimStart();
+  let previous = "";
+  while (normalized !== previous) {
+    previous = normalized;
+    normalized = normalized.replace(/^---\r?\n[\s\S]*?\r?\n---\r?\n*/, "").trimStart();
+  }
+  return normalized;
+}
+function normalizeMemoryRules(content) {
+  const withoutMarkers = content.replace(/^\s*# SAURON START\s*$/gm, "").replace(/^\s*# SAURON END\s*$/gm, "");
+  const normalized = stripLeadingFrontmatter(withoutMarkers).trim();
+  return normalized ? `${normalized}
+` : "";
+}
+async function loadCanonicalMemoryRules(templatesDir, fallbackContent) {
+  const templateMemoryPath = path11.join(templatesDir, ".agents", "rules", "memory.md");
+  const rawContent = await fs11.pathExists(templateMemoryPath) ? await fs11.readFile(templateMemoryPath, "utf8") : fallbackContent;
+  return normalizeMemoryRules(rawContent) || `${fallbackContent.trim()}
+`;
+}
 var InitService = class {
   registryService = new RegistryService();
   async execute(options, driver) {
@@ -651,8 +674,11 @@ var InitService = class {
           await fs11.ensureDir(targetPath);
           await processDirectory(sourcePath, targetPath);
         } else {
-          const content = await fs11.readFile(sourcePath, "utf8");
           const relPath = path11.relative(cwd, targetPath).replace(/\\/g, "/");
+          if (ADAPTER_OWNED_TEMPLATE_FILES.has(relPath)) {
+            continue;
+          }
+          const content = await fs11.readFile(sourcePath, "utf8");
           let shouldWrite = true;
           if (await fs11.pathExists(targetPath)) {
             const localContent = await fs11.readFile(targetPath, "utf8");
@@ -670,7 +696,7 @@ var InitService = class {
             await fs11.writeFile(targetPath, content, "utf8");
             modifiedFiles.push(relPath);
           }
-          const isMutable = relPath.startsWith(".sauron/wiki/") || relPath === ".agents/rules/memory.md";
+          const isMutable = relPath.startsWith(".sauron/wiki/");
           if (!isMutable) {
             manifest.files[relPath] = generateHash(content);
           }
@@ -710,13 +736,7 @@ var InitService = class {
     };
     await saveManifest(cwd, manifest);
     modifiedFiles.push(".sauron/.manifest.json");
-    const memoryFilePath = path11.join(cwd, ".agents", "rules", "memory.md");
-    let memoryRulesContent = "";
-    if (await fs11.pathExists(memoryFilePath)) {
-      memoryRulesContent = await fs11.readFile(memoryFilePath, "utf8");
-    } else {
-      memoryRulesContent = agentsMdContent;
-    }
+    const memoryRulesContent = await loadCanonicalMemoryRules(templatesDir, agentsMdContent);
     const projectName = path11.basename(cwd) || "Unnamed Project";
     const memoryPayload = {
       projectName,
@@ -1063,35 +1083,35 @@ var ProjectScanner = class {
       if (rootFiles.includes("tsconfig.json")) {
         context.primaryLanguage = "TypeScript";
       }
-      if (rootDirs.includes(".cursor") || rootFiles.includes(".cursorrules")) {
-        context.detectedIAs.push("Cursor");
-      }
-      if (rootFiles.includes(".windsurfrules")) {
-        context.detectedIAs.push("Windsurf");
-      }
-      if (rootFiles.includes(".aider.instructions.md") || rootFiles.includes(".aider.conf.yml")) {
-        context.detectedIAs.push("Aider");
-      }
-      if (rootDirs.includes(".agents")) {
-        context.detectedIAs.push("Antigravity");
-      }
+      this.addDetectedIA(context, rootDirs.includes(".cursor") || rootFiles.includes(".cursorrules"), "Cursor");
+      this.addDetectedIA(context, rootDirs.includes(".windsurf") || rootFiles.includes(".windsurfrules"), "Windsurf");
+      this.addDetectedIA(context, rootFiles.includes(".aider.instructions.md") || rootFiles.includes(".aider.conf.yml"), "Aider");
+      this.addDetectedIA(context, rootDirs.includes(".agents"), "Antigravity");
+      this.addDetectedIA(context, rootDirs.includes(".codex"), "Codex");
+      this.addDetectedIA(context, rootDirs.includes(".opencode") || rootFiles.includes("opencode.json"), "Opencode");
+      this.addDetectedIA(context, rootDirs.includes(".claude") || rootFiles.includes("CLAUDE.md"), "Claude");
       if (context.detectedIAs.length === 0) {
-        context.detectedIAs = ["Cursor", "Windsurf", "Aider", "Antigravity"];
+        context.detectedIAs = ["Cursor", "Windsurf", "Aider", "Antigravity", "Codex", "Opencode", "Claude"];
       }
       if (rootFiles.includes("package.json")) {
         const pkgPath = path12.join(this.cwd, "package.json");
-        const pkg = await fs12.readJson(pkgPath);
+        const pkg2 = await fs12.readJson(pkgPath);
         const allDeps = {
-          ...pkg.dependencies || {},
-          ...pkg.devDependencies || {}
+          ...pkg2.dependencies || {},
+          ...pkg2.devDependencies || {}
         };
         for (const sig of TECHNOLOGY_SIGNATURES) {
           let matched = false;
           if (sig.deps && sig.deps.some((dep) => allDeps[dep])) {
             matched = true;
           }
-          if (sig.files && sig.files.some((f) => rootFiles.includes(f) || rootDirs.includes(f))) {
-            matched = true;
+          if (sig.files) {
+            for (const marker of sig.files) {
+              if (await this.matchesFileMarker(marker, rootFiles, rootDirs)) {
+                matched = true;
+                break;
+              }
+            }
           }
           if (matched) {
             this.categorizeAndAdd(sig, context);
@@ -1132,6 +1152,17 @@ var ProjectScanner = class {
       context.wikiTemplatesToInject.push(sig.wikiTemplate);
     }
   }
+  addDetectedIA(context, condition, name) {
+    if (condition && !context.detectedIAs.includes(name)) {
+      context.detectedIAs.push(name);
+    }
+  }
+  async matchesFileMarker(marker, rootFiles, rootDirs) {
+    if (!marker.includes("/") && !marker.includes("\\")) {
+      return rootFiles.includes(marker) || rootDirs.includes(marker);
+    }
+    return fs12.pathExists(path12.join(this.cwd, marker));
+  }
 };
 
 // src/features/init/init.command.ts
@@ -1420,7 +1451,7 @@ var DoctorService = class {
         });
       }
     }
-    const targets = registered?.aiTargets || ["Cursor", "Windsurf", "Aider", "Antigravity"];
+    const targets = manifest?.config?.aiTargets || registered?.aiTargets || ["Cursor", "Windsurf", "Aider", "Antigravity", "Codex", "Opencode", "Claude"];
     for (const target of targets) {
       try {
         const adapters = AdapterRegistry.resolve([target]);
@@ -1611,8 +1642,10 @@ async function runUninstallCommand(options) {
 }
 
 // src/index.ts
+var require2 = createRequire(import.meta.url);
+var pkg = require2("../package.json");
 var program = new Command();
-program.name("sauron").description("Sauron CLI - Framework para resolu\xE7\xE3o de Amn\xE9sia de Contexto em IAs").version("1.2.0");
+program.name("sauron").description("Sauron CLI - Framework para resolu\xE7\xE3o de Amn\xE9sia de Contexto em IAs").version(pkg.version || "0.0.0");
 program.command("init").description("Inicializa o Sauron Memory System no projeto atual").option("-y, --yes", "Pula os prompts interativos e usa os valores padr\xE3o (N\xE3o-interativo)").option("--json", "Sa\xEDda do resultado em formato JSON estruturado").option("--conflict <resolution>", "Estrat\xE9gia de resolu\xE7\xE3o de conflitos autom\xE1tica (ours | theirs)").action((options) => runInitCommand(options));
 program.command("doctor").description("Executa uma auditoria de integridade e conformidade estrutural das regras e wiki").option("--json", "Sa\xEDda do relat\xF3rio em formato JSON estruturado").action((options) => runDoctorCommand(options));
 program.command("uninstall").description("Remove as vincula\xE7\xF5es do Sauron CLI e regras de assistentes locais").option("--purge", "Remove fisicamente a pasta .sauron/ incluindo a wiki de documenta\xE7\xE3o").option("-y, --yes", "Pula os prompts de confirma\xE7\xE3o de desinstala\xE7\xE3o").option("--json", "Sa\xEDda do resultado em formato JSON estruturado").action((options) => runUninstallCommand(options));

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "sauron-cli",
-  "version": "1.4.5",
+  "version": "1.4.7",
   "description": "",
   "main": "dist/index.js",
   "bin": {
-    "sauron": "./dist/index.js"
+    "sauron": "dist/index.js"
   },
   "files": [
     "dist",