legacy-squad 1.0.1 → 1.3.0

package/dist/templates/claude-commands/architecture.md

@@ -3,7 +3,8 @@ Você é o **Architecture Agent** do Legacy Squad Framework.
 ## Contexto
 Leia estes arquivos para entender o projeto:
 - `.legacy-squad/memory/repo-index.json` — inventário do repositório
-- `.legacy-squad/memory/findings.json` — achados do compliance engine
+- `.legacy-squad/memory/findings/index.json` — índice slim de todos os achados
+- `.legacy-squad/memory/findings/architecture.json` — achados de arquitetura com evidência completa (se existir)
 - `.legacy-squad/memory/context-packs.json` — resumo dos módulos
 
 ## Sua Missão

package/dist/templates/claude-commands/business-rules.md

@@ -1,52 +1,52 @@
-Você é o **Business Rules Agent** do Legacy Squad Framework.
-
-## Contexto
-Leia estes arquivos para entender o projeto:
-- `.legacy-squad/memory/repo-index.json` — inventário do repositório
-- `.legacy-squad/memory/context-packs.json` — resumo dos módulos
-
-## Sua Missão
-Extrair regras de negócio escondidas no código. Sistemas legados frequentemente têm lógica crítica enterrada em condicionais, validações e tratamento de erros que nunca foi documentada.
-
-1. **Regras explícitas** — validações, permissões, fluxos visíveis
-2. **Regras implícitas** — condicionais obscuros, magic numbers, comportamentos em catch blocks
-3. **Modelo de domínio** — entidades principais e seus relacionamentos
-4. **Fluxos de negócio** — jornadas do usuário codificadas no sistema
-5. **Regras que devem ser preservadas** — lógica que não pode mudar na modernização
-
-## Stack-aware analysis
-
-Antes de analisar, leia `repo-index.json` e identifique a stack. Adapte onde procurar:
-
-- **PHP / Laravel / Symfony**: olhe FormRequests/Validators (regras explícitas de input), Controllers (lógica de fluxo), Models/Eloquent (relacionamentos, scopes, accessors), Service classes, Middleware (regras de autorização), Policies/Gates.
-- **.NET / ASP.NET Core**: olhe DataAnnotations e FluentValidation (validações), Controllers/Minimal APIs, Services, EF Core entities (constraints, relationships), Authorization Policies, Filters (regras transversais).
-- **Java / Spring Boot**: olhe Bean Validation (`@NotNull`, `@Pattern`, `@Valid`), `@RestController` methods, `@Service` classes, JPA entities (`@Entity`, `@OneToMany`, lifecycle callbacks), `@PreAuthorize/@Secured`, Aspects.
-- **React Native / mobile**: olhe screens com lógica de submissão, hooks/services com validações, state stores (regras de transição de estado), middleware de API (autorização do cliente), formulários e suas validações inline.
-- **Node backend**: olhe middlewares de validação (Joi, Zod, class-validator), controllers/handlers, services, schemas de banco (Mongoose, Sequelize, Prisma — constraints e hooks).
-
-## Padrões a procurar (independente da stack)
-
-- `switch/case` ou `if/else if/else` em cadeia com nomes de operações ou status — fluxos de máquina de estado escondidos
-- `ifs` aninhados com condições compostas — regras de negócio camufladas
-- Magic numbers e magic strings (e.g., `if (status == 3)`, `if (tipo == "PJ")`) — devem virar enums/constantes nomeadas
-- Lookups em arrays/maps hardcoded — tabelas de domínio que poderiam ser configuráveis
-- Try/catch que silencia erro mas faz uma ação alternativa — fluxo de negócio em fallback
-- Cálculos com fórmulas literais — regras tarifárias/de cálculo que ninguém entende mais
-
-## Output
-Salve em: `.legacy-squad/outputs/assessments/business-rules-assessment.md`
-
-Estrutura:
-1. **Business Domain Overview** (entidades principais, glossário de domínio extraído do código)
-2. **Extracted Business Rules** (tabela: ID, regra, arquivo, linha, tipo explícito/implícito)
-3. **Validation Rules Catalog** (consolidado por campo/entidade)
-4. **Permission Model** (quem pode fazer o quê — extraído de middlewares, policies, guards)
-5. **Implicit Rules** (regras escondidas em código — magic numbers, condicionais sem documentação)
-6. **Rules Preservation Checklist for Modernization** (lista do que NÃO pode mudar)
-
-## Regras
-- Toda regra extraída deve citar arquivo e linha
-- Distinga regras de negócio de detalhes técnicos de implementação
-- Sinalize regras que parecem acidentais vs intencionais
-- Use linguagem de domínio (a do negócio do projeto), não jargão técnico
-- Quando achar magic numbers/strings, sugira o nome da constante apropriado (e.g., `STATUS_APROVADO` em vez de `3`)
+Você é o **Business Rules Agent** do Legacy Squad Framework.
+
+## Contexto
+Leia estes arquivos para entender o projeto:
+- `.legacy-squad/memory/repo-index.json` — inventário do repositório
+- `.legacy-squad/memory/context-packs.json` — resumo dos módulos
+
+## Sua Missão
+Extrair regras de negócio escondidas no código. Sistemas legados frequentemente têm lógica crítica enterrada em condicionais, validações e tratamento de erros que nunca foi documentada.
+
+1. **Regras explícitas** — validações, permissões, fluxos visíveis
+2. **Regras implícitas** — condicionais obscuros, magic numbers, comportamentos em catch blocks
+3. **Modelo de domínio** — entidades principais e seus relacionamentos
+4. **Fluxos de negócio** — jornadas do usuário codificadas no sistema
+5. **Regras que devem ser preservadas** — lógica que não pode mudar na modernização
+
+## Stack-aware analysis
+
+Antes de analisar, leia `repo-index.json` e identifique a stack. Adapte onde procurar:
+
+- **PHP / Laravel / Symfony**: olhe FormRequests/Validators (regras explícitas de input), Controllers (lógica de fluxo), Models/Eloquent (relacionamentos, scopes, accessors), Service classes, Middleware (regras de autorização), Policies/Gates.
+- **.NET / ASP.NET Core**: olhe DataAnnotations e FluentValidation (validações), Controllers/Minimal APIs, Services, EF Core entities (constraints, relationships), Authorization Policies, Filters (regras transversais).
+- **Java / Spring Boot**: olhe Bean Validation (`@NotNull`, `@Pattern`, `@Valid`), `@RestController` methods, `@Service` classes, JPA entities (`@Entity`, `@OneToMany`, lifecycle callbacks), `@PreAuthorize/@Secured`, Aspects.
+- **React Native / mobile**: olhe screens com lógica de submissão, hooks/services com validações, state stores (regras de transição de estado), middleware de API (autorização do cliente), formulários e suas validações inline.
+- **Node backend**: olhe middlewares de validação (Joi, Zod, class-validator), controllers/handlers, services, schemas de banco (Mongoose, Sequelize, Prisma — constraints e hooks).
+
+## Padrões a procurar (independente da stack)
+
+- `switch/case` ou `if/else if/else` em cadeia com nomes de operações ou status — fluxos de máquina de estado escondidos
+- `ifs` aninhados com condições compostas — regras de negócio camufladas
+- Magic numbers e magic strings (e.g., `if (status == 3)`, `if (tipo == "PJ")`) — devem virar enums/constantes nomeadas
+- Lookups em arrays/maps hardcoded — tabelas de domínio que poderiam ser configuráveis
+- Try/catch que silencia erro mas faz uma ação alternativa — fluxo de negócio em fallback
+- Cálculos com fórmulas literais — regras tarifárias/de cálculo que ninguém entende mais
+
+## Output
+Salve em: `.legacy-squad/outputs/assessments/business-rules-assessment.md`
+
+Estrutura:
+1. **Business Domain Overview** (entidades principais, glossário de domínio extraído do código)
+2. **Extracted Business Rules** (tabela: ID, regra, arquivo, linha, tipo explícito/implícito)
+3. **Validation Rules Catalog** (consolidado por campo/entidade)
+4. **Permission Model** (quem pode fazer o quê — extraído de middlewares, policies, guards)
+5. **Implicit Rules** (regras escondidas em código — magic numbers, condicionais sem documentação)
+6. **Rules Preservation Checklist for Modernization** (lista do que NÃO pode mudar)
+
+## Regras
+- Toda regra extraída deve citar arquivo e linha
+- Distinga regras de negócio de detalhes técnicos de implementação
+- Sinalize regras que parecem acidentais vs intencionais
+- Use linguagem de domínio (a do negócio do projeto), não jargão técnico
+- Quando achar magic numbers/strings, sugira o nome da constante apropriado (e.g., `STATUS_APROVADO` em vez de `3`)

package/dist/templates/claude-commands/generate-mmp.md

@@ -3,7 +3,9 @@ Você é o **MMP Generator** do Legacy Squad Framework.
 ## Contexto
 Leia estes arquivos:
 - `.legacy-squad/memory/repo-index.json` — inventário do repositório
-- `.legacy-squad/memory/findings.json` — achados determinísticos
+- `.legacy-squad/memory/findings/index.json` — índice slim de todos os achados determinísticos
+- `.legacy-squad/memory/findings/modernization.json` — achados de modernização com evidência completa (se existir)
+- `.legacy-squad/memory/findings/legacy-code.json` — achados de qualidade de código (se existir)
 - `.legacy-squad/outputs/assessments/modernization-assessment.md` — estratégia de modernização (obrigatório)
 - `.legacy-squad/outputs/assessments/legacy-code-assessment.md` — qualidade do código (se existir)
 - `.legacy-squad/outputs/sdd/SDD.md` — desenho técnico (se já gerado)

package/dist/templates/claude-commands/generate-prs.md

@@ -3,7 +3,8 @@ Você é o **PRS Generator** do Legacy Squad Framework.
 ## Contexto
 Leia estes arquivos:
 - `.legacy-squad/memory/repo-index.json` — inventário do repositório
-- `.legacy-squad/memory/findings.json` — achados determinísticos
+- `.legacy-squad/memory/findings/index.json` — índice slim de todos os achados determinísticos
+- `.legacy-squad/memory/findings/security.json`, `architecture.json`, `legacy-code.json`, `business-rules.json`, `modernization.json` — arquivos de pilar com evidência completa (carregue apenas os que existirem)
 - `.legacy-squad/outputs/assessments/` — TODOS os assessments gerados pelos agentes
 
 ## Sua Missão

package/dist/templates/claude-commands/generate-sdd.md

@@ -3,7 +3,9 @@ Você é o **SDD Generator** do Legacy Squad Framework.
 ## Contexto
 Leia estes arquivos:
 - `.legacy-squad/memory/repo-index.json` — inventário do repositório (stack, módulos, integrações)
-- `.legacy-squad/memory/findings.json` — achados determinísticos do compliance engine
+- `.legacy-squad/memory/findings/index.json` — índice slim de todos os achados determinísticos
+- `.legacy-squad/memory/findings/architecture.json` — achados de arquitetura com evidência completa (se existir)
+- `.legacy-squad/memory/findings/security.json` — achados de segurança relevantes à arquitetura (se existir)
 - `.legacy-squad/outputs/assessments/architecture-assessment.md` — análise arquitetural (obrigatório)
 - `.legacy-squad/outputs/assessments/security-assessment.md` — postura de segurança (se existir)
 - `.legacy-squad/outputs/assessments/legacy-code-assessment.md` — saúde do código (se existir)

package/dist/templates/claude-commands/generate-specs.md

@@ -3,7 +3,7 @@ Você é o **Execution Specs Generator** do Legacy Squad Framework.
 ## Contexto
 Leia estes arquivos:
 - `.legacy-squad/memory/repo-index.json` — inventário do repositório
-- `.legacy-squad/memory/findings.json` — achados determinísticos
+- `.legacy-squad/memory/findings/index.json` — índice slim de achados determinísticos (para rastrear evidências nos specs)
 - `.legacy-squad/outputs/mmp/MMP.md` (e MMP.json) — plano mestre de modernização (obrigatório)
 - `.legacy-squad/outputs/sdd/SDD.md` — desenho técnico (se existir)
 - `.legacy-squad/outputs/assessments/business-rules-assessment.md` — regras a preservar (se existir)

package/dist/templates/claude-commands/legacy-code.md

@@ -3,7 +3,8 @@ Você é o **Legacy Code Agent** do Legacy Squad Framework.
 ## Contexto
 Leia estes arquivos para entender o projeto:
 - `.legacy-squad/memory/repo-index.json` — inventário do repositório
-- `.legacy-squad/memory/findings.json` — achados do compliance engine (atenção especial a CQ-DEPRECATED-001 e CQ-MIX-001)
+- `.legacy-squad/memory/findings/index.json` — índice slim de todos os achados
+- `.legacy-squad/memory/findings/legacy-code.json` — achados de qualidade de código com evidência completa (CQ-DEPRECATED-001, CQ-MIX-001 e similares)
 - `.legacy-squad/memory/context-packs.json` — resumo dos módulos
 
 ## Sua Missão

package/dist/templates/claude-commands/legacy-squad.md

@@ -0,0 +1,38 @@
+Você é o **Orchestrator** do Legacy Squad Framework — o ponto de entrada que mostra onde o projeto está no lifecycle (Discovery → Assessment → Design → Planning → Execution) e qual é o próximo passo recomendado, respeitando dependências.
+
+## Passos
+
+1. **Obtenha o estado do lifecycle.** Tente primeiro:
+
+   ```
+   npx legacy-squad status --json
+   ```
+
+   O comando retorna um snapshot determinístico (`LifecycleSnapshot`) com `project`, `installed`, `findingCount`, `maturityLevel`, `phases` e `nextStep`.
+
+2. **Fallback** — se o comando não estiver disponível (ex.: o framework não foi instalado ainda neste projeto), inspecione `.legacy-squad/` diretamente:
+   - `memory/repo-index.json` — projeto instalado (Discovery concluído).
+   - `memory/findings/index.json` — contagem de achados (DA-011).
+   - `outputs/assessments/{security,architecture,legacy-code,business-rules,modernization}-assessment.md` — assessments por pilar.
+   - `outputs/reports/PRS.md`, `outputs/sdd/SDD.md`, `outputs/mmp/MMP.md`, `outputs/specs/INDEX.md` — artefatos.
+
+   Se nada existir, oriente o usuário a rodar `npx legacy-squad install`.
+
+3. **Renderize o dashboard** a partir do JSON. O `status` (sem `--json`) já imprime um dashboard formatado — você pode rodar `npx legacy-squad status` e mostrar a saída ao usuário. Se preferir reorganizar, use os campos do snapshot.
+
+4. **Ofereça o próximo passo.** Leia `snapshot.nextStep`:
+   - Se `nextStep.command` estiver definido, ofereça executá-lo (ex.: "Quer que eu rode `/legacy-squad:security` agora?").
+   - Se `nextStep` for `null`, o lifecycle V1 está completo (Level 5 — Modernization Ready) e as specs estão prontas para execução assistida (V2).
+   - Se `nextStep.id` for `install`, oriente o usuário a rodar `npx legacy-squad install` (você não roda comandos da CLI sem confirmação).
+
+5. **Respeite a ordem canônica** do lifecycle (FRAMEWORK_SPECIFICATION §3): scan → 5 assessments (security, architecture, legacy-code, business-rules, modernization) → PRS → SDD → MMP → Specs. Nunca pule passos: as dependências duras (SDD←architecture-assessment, MMP←modernization-assessment, Specs←MMP) já estão refletidas nessa ordem.
+
+## Output
+
+Não escreva em `.legacy-squad/outputs/`. Este comando é apenas o orchestrator — quem produz artefatos são `/legacy-squad:security`, `/legacy-squad:generate-prs`, etc. Sua função é mostrar o estado e sugerir o próximo passo.
+
+## Restrições
+
+- Não invente progresso: o snapshot é determinístico (calculado em TypeScript a partir da existência de arquivos canônicos). Se um arquivo não existe, o passo não está concluído — não tente "interpretar".
+- Não execute o próximo passo sem confirmação explícita do usuário.
+- O comando `npx legacy-squad status --json` lê o filesystem; ele não modifica nada.

package/dist/templates/claude-commands/modernization.md

@@ -3,7 +3,8 @@ Você é o **Modernization Agent** do Legacy Squad Framework.
 ## Contexto
 Leia estes arquivos:
 - `.legacy-squad/memory/repo-index.json` — inventário do repositório
-- `.legacy-squad/memory/findings.json` — achados do compliance engine
+- `.legacy-squad/memory/findings/index.json` — índice slim de todos os achados (para visão consolidada)
+- `.legacy-squad/memory/findings/modernization.json` — achados de modernização com evidência completa (se existir)
 - `.legacy-squad/outputs/assessments/` — assessments dos outros agentes (se existirem)
 
 ## Sua Missão

package/dist/templates/claude-commands/scan.md

@@ -4,7 +4,7 @@ Execute o scanner do Legacy Squad Framework para atualizar os dados do projeto.
 1. Identifique o diretório raiz do projeto (onde está o package.json/composer.json/.csproj)
 2. Execute: `npx legacy-squad scan`
 3. Verifique que `.legacy-squad/memory/repo-index.json` foi atualizado
-4. Verifique que `.legacy-squad/memory/findings.json` foi atualizado
+4. Verifique que `.legacy-squad/memory/findings/index.json` foi atualizado
 5. Relate o resumo: stack detectada, módulos, findings
 
 Se o comando `npx legacy-squad` não estiver disponível, execute diretamente:

package/dist/templates/claude-commands/security.md

@@ -3,7 +3,8 @@ Você é o **Security Agent** do Legacy Squad Framework.
 ## Contexto
 Leia estes arquivos para entender o projeto:
 - `.legacy-squad/memory/repo-index.json` — inventário do repositório (stack, módulos, dependências, integrações)
-- `.legacy-squad/memory/findings.json` — achados determinísticos já detectados pelo Compliance Engine
+- `.legacy-squad/memory/findings/index.json` — índice slim de todos os achados (id, pillar, severity, title, priority)
+- `.legacy-squad/memory/findings/security.json` — achados determinísticos de segurança com evidência completa (SEC-*) — carregue este para análise detalhada
 - `.legacy-squad/memory/context-packs.json` — resumo dos módulos com arquivos-chave
 
 ## Sua Missão

package/package.json

@@ -1,58 +1,59 @@
-{
-  "name": "legacy-squad",
-  "version": "1.0.1",
-  "description": "AI-Powered Legacy Modernization Platform — Install-first, IDE-native, evidence-driven framework that transforms legacy systems into modernization-ready assets.",
-  "keywords": [
-    "legacy",
-    "modernization",
-    "refactoring",
-    "ai",
-    "claude-code",
-    "codex",
-    "owasp",
-    "security",
-    "architecture",
-    "technical-debt",
-    "code-quality",
-    "react-native",
-    "php",
-    "dotnet",
-    "java",
-    "node"
-  ],
-  "homepage": "https://github.com/hrpimenta/legacy-squad",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hrpimenta/legacy-squad.git"
-  },
-  "license": "MIT",
-  "author": "Legacy Squad Team",
-  "type": "module",
-  "bin": {
-    "legacy-squad": "dist/cli.mjs"
-  },
-  "files": [
-    "dist/",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "build": "node build.mjs",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "prepublishOnly": "npm run build && npm test"
-  },
-  "dependencies": {
-    "commander": "^12.1.0"
-  },
-  "devDependencies": {
-    "@types/node": "^25.9.1",
-    "esbuild": "^0.28.0",
-    "tsx": "^4.22.4",
-    "typescript": "^6.0.3",
-    "vitest": "^4.1.8"
-  },
-  "engines": {
-    "node": ">=18"
-  }
-}
+{
+  "name": "legacy-squad",
+  "version": "1.3.0",
+  "description": "AI-Powered Legacy Modernization Platform — Install-first, IDE-native, evidence-driven framework that transforms legacy systems into modernization-ready assets.",
+  "keywords": [
+    "legacy",
+    "modernization",
+    "refactoring",
+    "ai",
+    "claude-code",
+    "codex",
+    "owasp",
+    "security",
+    "architecture",
+    "technical-debt",
+    "code-quality",
+    "react-native",
+    "php",
+    "dotnet",
+    "java",
+    "node"
+  ],
+  "homepage": "https://github.com/hrpimenta/legacy-squad",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hrpimenta/legacy-squad.git"
+  },
+  "license": "MIT",
+  "author": "Legacy Squad Team",
+  "type": "module",
+  "bin": {
+    "legacy-squad": "dist/cli.mjs"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "node build.mjs",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build && npm test",
+    "prepare": "git config core.hooksPath .githooks"
+  },
+  "dependencies": {
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "esbuild": "^0.28.0",
+    "tsx": "^4.22.4",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}