sauron-cli 1.4.1 → 1.4.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +16 -0
- package/dist/index.js +448 -199
- package/package.json +7 -1
- package/.agents/rules/memory.md +0 -156
- package/.agents/skills/wiki/SKILL.md +0 -172
- package/.aider.instructions.md +0 -152
- package/.cursor/rules/sauron-memory.mdc +0 -157
- package/.genesis/prompts/CLI Init_ Atualiza/303/247/303/243o com Mem/303/263ria.md" +0 -133
- package/.genesis/prompts/prompt-onboarding-inteligente.md +0 -45
- package/.genesis/prompts/prompt-sauron-update-intelligence.md +0 -20
- package/.genesis/prompts/prompt-sauron-vs-openspec-arquitetura.md +0 -106
- package/.github/workflows/ci.yml +0 -27
- package/.sauron/.manifest.json +0 -7
- package/.sauron/wiki/history/implementacao-scanner-inteligente.md +0 -29
- package/.sauron/wiki/history/reestruturacao-arquitetural-core.md +0 -29
- package/.sauron/wiki/history/resiliencia-caminho-templates.md +0 -29
- package/.sauron/wiki/standards/typescript.rules.md +0 -21
- package/.sauron/wiki/summary.json +0 -81
- package/.windsurfrules +0 -160
- package/Evolu/303/247/303/243o Arquitetural do Sauron CLI.md" +0 -97
package/README.md
CHANGED
|
@@ -12,6 +12,7 @@ Assistentes de código são incrivelmente poderosos, mas sofrem de amnésia vol
|
|
|
12
12
|
|
|
13
13
|
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.
|
|
14
14
|
|
|
15
|
+
|
|
15
16
|
## Instalação
|
|
16
17
|
|
|
17
18
|
Para inicializar o Sauron CLI no seu projeto, basta rodar o comando abaixo no terminal da raiz do seu projeto (não é necessário instalar nada globalmente):
|
|
@@ -29,6 +30,21 @@ O comando executa uma **varredura heurística não-bloqueante** ($O(1)$) na raiz
|
|
|
29
30
|
|
|
30
31
|
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.
|
|
31
32
|
|
|
33
|
+
### Atualizações Inteligentes (Bypass & Reidratação)
|
|
34
|
+
O comando é totalmente **Idempotente**. Se executado em um repositório já inicializado:
|
|
35
|
+
- **Fast-Track (Bypass)**: O CLI detecta a configuração passada e oferece a opção de pular o onboarding, atualizando os agentes internos silenciosamente.
|
|
36
|
+
- **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.
|
|
37
|
+
- **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.
|
|
38
|
+
|
|
39
|
+
### Como Atualizar um Projeto Existente
|
|
40
|
+
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:
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
npx sauron-cli@latest init
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
### Comandos da CLI
|
|
47
|
+
|
|
32
48
|
```bash
|
|
33
49
|
# Inicialização interativa padrão
|
|
34
50
|
sauron init
|