@dewtech/dare-cli 2.17.0 → 3.0.0

package/README.md

@@ -16,6 +16,7 @@ means it literally runs:
 
 | Stack | What `dare init` runs |
 |-------|----------------------|
+| `ruby-rails-8` | `rails new . --api --skip-test --skip-bundle --database=postgresql` + DARE templates (`packages/stacks/ruby-rails-8/` generator with Layered Design, OpenAPI, LLM integration, Action Cable, RSpec) |
 | `php-laravel` | `composer create-project laravel/laravel:^11 .` |
 | `node-nestjs` | `npx @nestjs/cli new . --strict --skip-git` |
 | `python-fastapi` | `python -m venv .venv && python -m pip install -r requirements.txt` |
@@ -28,7 +29,7 @@ means it literally runs:
 | `mcp-server-node-ts` | `npm init` + `@modelcontextprotocol/sdk` |
 | `mcp-server-python` | `python -m venv .venv` + `pip install mcp[cli]` |
 
-These need a working `composer` / `npm` / `cargo` / `python` / `go`
+These need a working `ruby` / `composer` / `npm` / `cargo` / `python` / `go`
 **somewhere**. There are three ways to provide it — you pick at init time
 (prompt below), and the choice is saved in `dare.config.json` so
 `dare bootstrap` reuses it later.
@@ -139,6 +140,7 @@ Pick **one** of the two paths per stack:
 
 | Stack | Native toolchain | Docker fallback (used if native missing) |
 |-------|------------------|------------------------------------------|
+| `ruby-rails-8` | Ruby 3.3+ · Bundler 2+ · Rails 8 — https://www.ruby-lang.org/ | `ruby:3.3-slim` |
 | `php-laravel` | PHP 8.2+ · Composer 2+ — https://getcomposer.org/ | `composer:latest` |
 | `node-nestjs` | Node 18+ (bundles `npx`) | `node:20-alpine` |
 | `python-fastapi` | Python 3.11+ — https://www.python.org/downloads/ | `python:3.12-slim` |
@@ -151,6 +153,8 @@ Pick **one** of the two paths per stack:
 | `mcp-server-node-ts` | Node 18+ | `node:20-alpine` |
 | `mcp-server-python` | Python 3.11+ | `python:3.12-slim` |
 
+> **v3.0.0:** `ruby-rails-8` is the only stack with a full generator in `packages/stacks/`. All others run the framework's official scaffold + DARE skill templates on top. Full generators for `node-nestjs`, `python-fastapi`, `go-gin`, `php-laravel` and MCP servers are on the [v3.1.x roadmap](https://github.com/dewtech-technologies/dare-method/blob/main/ROADMAP.md#em-desenvolvimento-ativo---v31x).
+
 > **TL;DR:** if you have **Docker Desktop** installed, you don't strictly need
 > any other toolchain — `dare init` will pull the right image on demand.
 > Native toolchains are faster and don't depend on Docker pulling images.
@@ -249,6 +253,80 @@ Recognizes: NestJS · React · Vue · Nuxt · Rust/Axum · FastAPI · Laravel ·
 
 ---
 
+### `dare reverse` ← brownfield (Phase 0)
+
+Reverse-engineer an existing codebase into a Phase-0 understanding **without touching the source**.
+Deterministically detects module boundaries, sizes them by LOC and infers the dependency graph.
+
+```bash
+cd my-legacy-project
+dare reverse                 # → DARE/IDEIA.md + REVERSE/module-*.md + reverse-facts.json + architecture.excalidraw
+dare reverse --check         # detection only, no files
+dare reverse --modules api,auth
+dare reverse --no-excalidraw
+```
+
+**Confidence & traceability.** The `/dare-reverse` skill marks each claim 🟢 CONFIRMED (with
+`file:line` evidence) · 🟡 INFERRED · 🔴 GAP. Then:
+
+```bash
+dare reverse --report        # deterministic confidence index from the markers (not LLM self-scored)
+```
+
+→ `confidence-report.md` + `traceability/code-spec-matrix.md`; the 🔴 become `gaps.md` + `questions.md`.
+
+**Deep extraction (framework-agnostic per language):**
+
+```bash
+dare reverse --deep          # + ERD, API surface, C4, domain-rules, state-machines, permissions
+```
+
+The CLI extracts the data model (`erd.md`) and endpoints (`api-surface.md`) deterministically from
+**SQL inline (DDL + query tables), Prisma, ORMs and plain types/classes/structs** — so it works on
+legacy projects **with or without a framework** (e.g. raw-PDO PHP without Laravel). Routes cover
+multiple dialects per language (Express/Nest/Fastify, Laravel/Slim/Symfony, FastAPI/Flask/Django,
+Rails/Sinatra, Gin/stdlib, Axum).
+
+---
+
+### `dare dna` ← brownfield
+
+Extract the legacy codebase's **conventions** so the agent follows the house style instead of generic
+defaults — for legacy you can't rewrite.
+
+```bash
+cd my-legacy-project
+dare dna                     # → DARE/PROJECT-DNA.md + dna-facts.json
+dare dna --check
+```
+
+Detects lint/format tooling, naming conventions, architecture layers, test framework, key libraries
+(ORM/HTTP/auth/validation) and commit convention. The `/dare-dna` skill turns the facts into
+actionable rules. Reuses `reverse-facts.json` if `dare reverse` already ran.
+
+---
+
+### `dare migrate` ← brownfield (Phase 2)
+
+Plan a **safe migration** to a target stack, with **Gherkin parity scenarios** that guarantee
+behavior is preserved. Requires `dare reverse` first.
+
+```bash
+cd my-legacy-project
+dare migrate --to go-gin     # or rust-axum, node-nestjs, python-fastapi, php-laravel, ruby-rails-8…
+dare migrate --check
+```
+
+Consumes `IDEIA` + `DNA`, inherits the **blocking gaps** (🔴) as risks, and generates
+`DARE/MIGRATION/MIGRATION.md` (paradigm, strategy, risk register, target architecture, cutover) +
+`parity/<module>.feature` (the behavioral acceptance contract). The `/dare-migrate` skill fills the
+strategy and the real parity scenarios.
+
+> **Brownfield loop:** `reverse` (the *what*) → `dna` (the *how*) → `migrate` (reimplement with
+> parity) → `design`/`blueprint`/`execute` on the target stack.
+
+---
+
 ### `dare design`
 
 Generate `DARE/DESIGN.md` from a project description.
@@ -620,13 +698,30 @@ npm run inspect
 
 | Type | Options |
 |------|---------|
-| **Backend** | Rust/Axum · Node.js/NestJS · Python/FastAPI · PHP/Laravel · Go/Gin · Go/stdlib |
+| **Backend** | Ruby on Rails 8 · Rust/Axum · Node.js/NestJS · Python/FastAPI · PHP/Laravel · Go/Gin · Go/stdlib |
 | **Frontend** | React 18+ · Vue 3+ · Leptos fullstack (Rust SSR+WASM) · Leptos CSR (Rust WASM) |
 | **MCP Server** | TypeScript/Node.js · Python — stdio / SSE / HTTP Stream |
 | **IDE / Agent** | Claude Code · Cursor · Antigravity · Hybrid |
 
 ---
 
+## Skills disponíveis (v3.0.0)
+
+**32 skills em paridade total** nas 3 IDEs (Antigravity, Claude Code, Cursor). Cada skill existe em formato nativo de cada uma e é entregue por `dare init` / `dare update`.
+
+| Categoria | Skills | Exemplos |
+|---|---|---|
+| **Método DARE** | 6 | `dare-design`, `dare-blueprint`, `dare-tasks`, `dare-execute`, `dare-review`, `dare-refine` |
+| **DAG runner** | 4 | `dare-dag-build`, `dare-dag-run`, `dare-dag-runner`, `dare-dag-viz` |
+| **Transversais** | 6 | `dare-ax`, `dare-layered-design`, `dare-llm-integration`, `dare-frontend-design`, `dare-realtime`, `dare-quality-telemetry` |
+| **Stack / Tools** | 8 | `dare-docker`, `dare-security`, `dare-telemetry`, `dare-bugfix-design`, `dare-feature-design`, `dare-rust-workspace`, `dare-rust-leptos`, `dare-laravel-api` |
+| **Stacks novas v3.0.0** | 5 | `dare-nestjs-api`, `dare-fastapi-api`, `dare-go-gin-api`, `dare-mcp-server`, `dare-rails-api` |
+| **Brownfield** | 3 | `dare-reverse`, `dare-dna`, `dare-migrate` |
+
+Ver tabela cruzada completa em [`docs/skills/INDEX.md`](https://github.com/dewtech-technologies/dare-method/blob/main/docs/skills/INDEX.md).
+
+---
+
 ## O que vem com o pacote (v2.0+)
 
 A partir da v2.0 o `@dewtech/dare-cli` é um **pacote único** que inclui todas as
@@ -640,7 +735,7 @@ Isso já dá:
 
 | Componente | O que é |
 |------------|---------|
-| CLI `dare` | `init`, `design`, `blueprint`, `execute`, `discover` |
+| CLI `dare` | `init`, `design`, `blueprint`, `execute`, `discover`, `reverse`, `dna`, `migrate` |
 | CLI `dare-mcp-server` | Servidor MCP local de contexto (~95% economia de tokens) |
 | Engine GraphRAG | Grafo de conhecimento com SQLite + FTS5 |
 | DAG Task Runner | Execução paralela de tasks com Kahn's algorithm |

package/dist/__tests__/confidence.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=confidence.test.d.ts.map

package/dist/__tests__/confidence.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/confidence.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/confidence.test.js

@@ -0,0 +1,73 @@
+import { describe, it, expect } from 'vitest';
+import { parseSpecConfidence, computeIndex, aggregate, renderConfidenceReport, renderCodeSpecMatrix, } from '../utils/confidence.js';
+const SPEC = `# Módulo: auth
+
+## Fatos
+- 🟢 **Caminho:** \`src/auth\`
+- 🟢 **Linguagens:** .ts
+
+## Claims
+- 🟢 Login delega a findUser. \`src/auth/login.ts:2\`
+- 🟡 Provável validação ausente. \`src/auth/login.ts:5\`
+- 🔴 Política de senha não determinável. → ver gaps.md
+
+Texto normal não é claim. \`não-conta.ts:9\`
+- item de lista sem marcador, ignorado
+`;
+describe('parseSpecConfidence', () => {
+    it('counts markers and extracts file:line evidence', () => {
+        const r = parseSpecConfidence('module-01-auth.md', SPEC);
+        expect(r.counts.confirmed).toBe(3); // 2 fatos + 1 claim
+        expect(r.counts.inferred).toBe(1);
+        expect(r.counts.gap).toBe(1);
+        expect(r.counts.total).toBe(5);
+        // Only evidence on marked claim lines is captured (not the plain text line).
+        expect(r.evidence).toEqual(['src/auth/login.ts:2', 'src/auth/login.ts:5']);
+    });
+    it('ignores non-claim lines (no marker)', () => {
+        const r = parseSpecConfidence('x.md', 'just prose\n- bullet\n## heading\n');
+        expect(r.counts.total).toBe(0);
+        expect(r.index).toBe(0);
+    });
+});
+describe('computeIndex', () => {
+    it('weights confirmed=1.0 and inferred=0.5', () => {
+        expect(computeIndex({ confirmed: 9, inferred: 1, gap: 1, total: 11 })).toBe(86.4);
+        expect(computeIndex({ confirmed: 4, inferred: 0, gap: 0, total: 4 })).toBe(100);
+        expect(computeIndex({ confirmed: 0, inferred: 0, gap: 0, total: 0 })).toBe(0);
+    });
+});
+describe('aggregate', () => {
+    it('sums counts across specs and recomputes the index', () => {
+        const specs = [
+            parseSpecConfidence('a.md', '- 🟢 x\n- 🟡 y'),
+            parseSpecConfidence('b.md', '- 🔴 z'),
+        ];
+        const { counts, index } = aggregate(specs);
+        expect(counts).toEqual({ confirmed: 1, inferred: 1, gap: 1, total: 3 });
+        expect(index).toBe(50); // (1 + 0.5) / 3
+    });
+});
+describe('renderConfidenceReport', () => {
+    it('renders a per-spec table with totals and the auditability caveat', () => {
+        const specs = [parseSpecConfidence('module-01-auth.md', SPEC)];
+        const md = renderConfidenceReport(specs, '2026-01-01T00:00:00.000Z');
+        expect(md).toContain('| module-01-auth.md | 3 | 1 | 1 | 70% |');
+        expect(md).toMatch(/\*\*Total\*\* \| \*\*3\*\* \| \*\*1\*\* \| \*\*1\*\*/);
+        expect(md).toContain('não auditoria factual externa');
+    });
+});
+describe('renderCodeSpecMatrix', () => {
+    it('lists evidence refs per spec', () => {
+        const specs = [parseSpecConfidence('module-01-auth.md', SPEC)];
+        const md = renderCodeSpecMatrix(specs, '2026-01-01T00:00:00.000Z');
+        expect(md).toContain('`module-01-auth.md`');
+        expect(md).toContain('`src/auth/login.ts:2`');
+    });
+    it('handles specs with no evidence gracefully', () => {
+        const specs = [parseSpecConfidence('empty.md', '- 🔴 sem evidência')];
+        const md = renderCodeSpecMatrix(specs, '2026-01-01T00:00:00.000Z');
+        expect(md).toContain('nenhuma evidência');
+    });
+});
+//# sourceMappingURL=confidence.test.js.map

package/dist/__tests__/confidence.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence.test.js","sourceRoot":"","sources":["../../src/__tests__/confidence.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/datamodel.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=datamodel.test.d.ts.map

package/dist/__tests__/datamodel.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datamodel.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/datamodel.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/datamodel.test.js

@@ -0,0 +1,131 @@
+import { describe, it, expect, afterEach } from 'vitest';
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+import { extractDataModel, renderErd, renderApiSurface } from '../utils/datamodel.js';
+const tmpDirs = [];
+async function makeProject(files) {
+    const dir = await fs.mkdtemp(path.join(os.tmpdir(), 'dare-dm-'));
+    tmpDirs.push(dir);
+    for (const [rel, content] of Object.entries(files)) {
+        const abs = path.join(dir, rel);
+        await fs.ensureDir(path.dirname(abs));
+        await fs.writeFile(abs, content);
+    }
+    return dir;
+}
+afterEach(async () => {
+    while (tmpDirs.length)
+        await fs.remove(tmpDirs.pop());
+});
+describe('extractDataModel — Prisma', () => {
+    it('parses models, scalar fields, and relations (scalars are not relations)', async () => {
+        const root = await makeProject({
+            'prisma/schema.prisma': `model User {\n  id Int @id\n  email String\n  posts Post[]\n}\nmodel Post {\n  id Int @id\n  title String\n  author User\n}\n`,
+        });
+        const dm = await extractDataModel(root);
+        const user = dm.entities.find((e) => e.name === 'User');
+        expect(user.fields.map((f) => f.name)).toEqual(['id', 'email']); // Int/String are scalars
+        expect(user.relations).toContainEqual({ to: 'Post', kind: 'has-many' });
+        const post = dm.entities.find((e) => e.name === 'Post');
+        expect(post.relations.some((r) => r.to === 'User')).toBe(true);
+    });
+});
+describe('extractDataModel — SQL', () => {
+    it('parses CREATE TABLE columns and FOREIGN KEY references', async () => {
+        const root = await makeProject({
+            'migrations/001.sql': `CREATE TABLE orders (\n  id INT PRIMARY KEY,\n  user_id INT,\n  total DECIMAL,\n  FOREIGN KEY (user_id) REFERENCES users\n);`,
+        });
+        const dm = await extractDataModel(root);
+        const orders = dm.entities.find((e) => e.name === 'orders');
+        expect(orders.fields.map((f) => f.name)).toEqual(['id', 'user_id', 'total']);
+        expect(orders.relations).toContainEqual({ to: 'users', kind: 'references' });
+        expect(orders.source).toMatch(/001\.sql:1/);
+    });
+});
+describe('extractDataModel — endpoints', () => {
+    it('parses routes across frameworks with source refs', async () => {
+        const root = await makeProject({
+            'src/routes.ts': `router.get('/users', h);\nrouter.post('/orders', h);\n@Get('/health')\n`,
+            'app/routes.php': `Route::get('/ping', 'C@m');\n`,
+        });
+        const dm = await extractDataModel(root);
+        const keys = dm.endpoints.map((e) => `${e.method} ${e.route}`);
+        expect(keys).toContain('GET /users');
+        expect(keys).toContain('POST /orders');
+        expect(keys).toContain('GET /health');
+        expect(keys).toContain('GET /ping');
+    });
+});
+describe('renderErd / renderApiSurface', () => {
+    it('renders a Mermaid erDiagram with entities and relations', async () => {
+        const root = await makeProject({
+            'prisma/schema.prisma': `model User {\n  id Int @id\n  posts Post[]\n}\nmodel Post {\n  id Int @id\n}\n`,
+        });
+        const dm = await extractDataModel(root);
+        const md = renderErd(dm, '2026-01-01T00:00:00.000Z');
+        expect(md).toContain('erDiagram');
+        expect(md).toContain('USER ||--o{ POST');
+        expect(md).toMatch(/\| User \| /);
+    });
+    it('renders an empty-state ERD gracefully', async () => {
+        const root = await makeProject({ 'src/x.ts': 'export const x = 1;\n' });
+        const dm = await extractDataModel(root);
+        expect(renderErd(dm, 'now')).toContain('nenhuma entidade detectada');
+        expect(renderApiSurface(dm, 'now')).toContain('nenhum endpoint detectado');
+    });
+});
+// ── Fase 3.1: framework-agnostic por linguagem ──────────────────────────────
+describe('framework-agnostic — legacy PHP (no Laravel)', () => {
+    it('extracts inline SQL DDL, query-only tables, plain model classes and Slim routes', async () => {
+        const root = await makeProject({
+            'db/install.php': `<?php\n$pdo->exec("CREATE TABLE clientes (id INT PRIMARY KEY, nome VARCHAR(120));");\n$rows = $pdo->query("SELECT * FROM produtos WHERE ativo = 1");\n`,
+            'models/Cliente.php': `<?php\nclass Cliente {\n  public int $id;\n  private ?string $email;\n}\n`,
+            'public/index.php': `<?php\n$app->get('/clientes', 'h');\n$app->post('/pedidos', 'h');\n`,
+        });
+        const dm = await extractDataModel(root);
+        const names = dm.entities.map((e) => e.name);
+        expect(names).toContain('clientes'); // inline CREATE TABLE
+        expect(names).toContain('produtos'); // referenced only in a SELECT
+        expect(names).toContain('Cliente'); // plain typed class in models/
+        const cliente = dm.entities.find((e) => e.name === 'Cliente');
+        expect(cliente.fields.map((f) => f.name)).toEqual(['id', 'email']);
+        const routes = dm.endpoints.map((e) => `${e.method} ${e.route}`);
+        expect(routes).toContain('GET /clientes');
+        expect(routes).toContain('POST /pedidos');
+    });
+});
+describe('framework-agnostic — multi-dialect routing', () => {
+    it('parses Flask (methods array), Django (any), Go stdlib (any), Rust/Axum and Ruby', async () => {
+        const root = await makeProject({
+            'app.py': `@app.route('/items', methods=['GET', 'POST'])\ndef items(): pass\n@app.route('/health')\ndef health(): pass\n`,
+            'urls.py': `urlpatterns = [\n  path('admin/', admin),\n]\n`,
+            'main.go': `mux.HandleFunc("/go-route", handler)\n`,
+            'routes.rs': `let app = Router::new().route("/users", get(list_users));\n`,
+            'config/routes.rb': `Rails.application.routes.draw do\n  get '/ruby-route', to: 'x#y'\nend\n`,
+        });
+        const dm = await extractDataModel(root);
+        const routes = dm.endpoints.map((e) => `${e.method} ${e.route}`);
+        expect(routes).toContain('GET /items');
+        expect(routes).toContain('POST /items'); // expanded from methods array
+        expect(routes).toContain('GET /health'); // Flask route without methods → GET
+        expect(routes).toContain('ANY admin/'); // Django path (method-less)
+        expect(routes).toContain('ANY /go-route'); // Go stdlib HandleFunc
+        expect(routes).toContain('GET /users'); // Rust/Axum (path then method)
+        expect(routes).toContain('GET /ruby-route'); // Rails/Sinatra
+    });
+});
+describe('framework-agnostic — type extraction across languages', () => {
+    it('extracts Go structs and Python dataclasses in data dirs', async () => {
+        const root = await makeProject({
+            'models/user.go': `type User struct {\n  ID int\n  Name string\n}\n`,
+            'domain/order.py': `@dataclass\nclass Order:\n    id: int\n    total: float\n`,
+        });
+        const dm = await extractDataModel(root);
+        const go = dm.entities.find((e) => e.name === 'User');
+        expect(go.fields.map((f) => f.name)).toEqual(['ID', 'Name']);
+        const py = dm.entities.find((e) => e.name === 'Order');
+        expect(py.fields.map((f) => f.name)).toEqual(['id', 'total']);
+    });
+});
+//# sourceMappingURL=datamodel.test.js.map

package/dist/__tests__/datamodel.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"datamodel.test.js","sourceRoot":"","sources":["../../src/__tests__/datamodel.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/dna-detector.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dna-detector.test.d.ts.map

package/dist/__tests__/dna-detector.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dna-detector.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/dna-detector.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/dna-detector.test.js

@@ -0,0 +1,97 @@
+import { describe, it, expect, afterEach } from 'vitest';
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+import { detectDna } from '../utils/dna-detector.js';
+const tmpDirs = [];
+async function makeProject(files) {
+    const dir = await fs.mkdtemp(path.join(os.tmpdir(), 'dare-dna-'));
+    tmpDirs.push(dir);
+    for (const [rel, content] of Object.entries(files)) {
+        const abs = path.join(dir, rel);
+        await fs.ensureDir(path.dirname(abs));
+        await fs.writeFile(abs, content);
+    }
+    return dir;
+}
+afterEach(async () => {
+    while (tmpDirs.length)
+        await fs.remove(tmpDirs.pop());
+});
+const AT = '2026-01-01T00:00:00.000Z';
+describe('detectDna — tooling', () => {
+    it('detects and parses Prettier + EditorConfig rules', async () => {
+        const root = await makeProject({
+            'package.json': '{"name":"app","version":"1.0.0"}',
+            '.prettierrc': '{ "semi": false, "singleQuote": true, "tabWidth": 2 }',
+            '.editorconfig': 'root = true\n[*]\nindent_style = space\nindent_size = 2\n',
+            'src/core/x.ts': 'export const x = 1;\n',
+        });
+        const facts = await detectDna(root, AT);
+        const prettier = facts.tooling.formatters.find((f) => f.name === 'Prettier');
+        expect(prettier).toBeTruthy();
+        expect(prettier?.rules?.semi).toBe(false);
+        expect(prettier?.rules?.singleQuote).toBe(true);
+        const editorconfig = facts.tooling.formatters.find((f) => f.name === 'EditorConfig');
+        expect(editorconfig?.rules?.indent_style).toBe('space');
+    });
+    it('detects ESLint from package.json#eslintConfig', async () => {
+        const root = await makeProject({
+            'package.json': '{"name":"app","version":"1.0.0","eslintConfig":{"extends":"airbnb"}}',
+            'src/core/x.ts': 'export const x = 1;\n',
+        });
+        const facts = await detectDna(root, AT);
+        expect(facts.tooling.linters.some((l) => l.name === 'ESLint')).toBe(true);
+    });
+});
+describe('detectDna — naming', () => {
+    it('reports the dominant file-naming style per extension', async () => {
+        const root = await makeProject({
+            'src/api/user-controller.ts': 'export {};\n',
+            'src/api/auth-controller.ts': 'export {};\n',
+            'src/api/order-service.ts': 'export {};\n',
+            'src/api/payment-gateway.ts': 'export {};\n',
+        });
+        const facts = await detectDna(root, AT);
+        const ts = facts.naming.find((n) => n.extension === '.ts');
+        expect(ts?.dominant).toBe('kebab-case');
+    });
+});
+describe('detectDna — architecture & libraries & testing', () => {
+    it('guesses layered/MVC from dirs and detects libs + test framework', async () => {
+        const root = await makeProject({
+            'package.json': JSON.stringify({
+                name: 'app',
+                version: '1.0.0',
+                dependencies: { '@nestjs/core': '^10', '@prisma/client': '^5', zod: '^3' },
+                devDependencies: { vitest: '^1' },
+            }),
+            'src/controllers/user.controller.ts': 'export class U {}\n',
+            'src/services/user.service.ts': 'export class S {}\n',
+            'src/repositories/user.repository.ts': 'export class R {}\n',
+            'src/__tests__/user.test.ts': 'export const t = 1;\n',
+        });
+        const facts = await detectDna(root, AT);
+        expect(facts.architecture.detectedLayers).toEqual(expect.arrayContaining(['controllers', 'services', 'repositories']));
+        expect(facts.architecture.guess).toMatch(/Layered/);
+        expect(facts.libraries.orm).toBe('Prisma');
+        expect(facts.libraries.http).toBe('NestJS');
+        expect(facts.libraries.validation).toBe('Zod');
+        expect(facts.testing.framework).toBe('Vitest');
+        expect(facts.testing.testFiles).toBe(1);
+    });
+});
+describe('detectDna — reuses reverse-facts when present', () => {
+    it('reads the file inventory from DARE/REVERSE/reverse-facts.json', async () => {
+        const root = await makeProject({
+            'DARE/REVERSE/reverse-facts.json': JSON.stringify({
+                modules: [{ id: 'm', name: 'm', path: 'm', files: ['m/alpha-thing.ts', 'm/beta-thing.ts'] }],
+            }),
+        });
+        const facts = await detectDna(root, AT);
+        expect(facts.fileInventorySource).toBe('reverse-facts');
+        const ts = facts.naming.find((n) => n.extension === '.ts');
+        expect(ts?.dominant).toBe('kebab-case');
+    });
+});
+//# sourceMappingURL=dna-detector.test.js.map

package/dist/__tests__/dna-detector.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dna-detector.test.js","sourceRoot":"","sources":["../../src/__tests__/dna-detector.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/dna-facts.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dna-facts.test.d.ts.map

package/dist/__tests__/dna-facts.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dna-facts.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/dna-facts.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/dna-facts.test.js

@@ -0,0 +1,44 @@
+import { describe, it, expect } from 'vitest';
+import { renderDnaSkeleton } from '../utils/dna-facts.js';
+const facts = (over = {}) => ({
+    generatedAt: '2026-01-01T00:00:00.000Z',
+    fileInventorySource: 'module-detector',
+    tooling: {
+        linters: [{ name: 'ESLint', configPath: '.eslintrc.json' }],
+        formatters: [{ name: 'Prettier', configPath: '.prettierrc', rules: { semi: false, singleQuote: true } }],
+    },
+    naming: [{ extension: '.ts', dominant: 'kebab-case', counts: { 'kebab-case': 3 }, samples: ['a-b.ts'] }],
+    architecture: { detectedLayers: ['controllers', 'services'], guess: 'Layered (Controller → Service)' },
+    testing: { framework: 'Vitest', testFiles: 10, prodFiles: 40, ratio: 0.25 },
+    libraries: { orm: 'Prisma', http: 'NestJS', validation: 'Zod' },
+    commits: { sampled: 50, conventional: true, prefixes: { feat: 20, fix: 15 } },
+    ...over,
+});
+describe('renderDnaSkeleton', () => {
+    it('embeds deterministic facts and AGENT placeholders', () => {
+        const md = renderDnaSkeleton(facts());
+        expect(md).toContain('# PROJECT-DNA');
+        expect(md).toContain('**Prettier** (`.prettierrc`)');
+        expect(md).toContain('semi: false');
+        expect(md).toContain('| `.ts` | kebab-case |');
+        expect(md).toContain('Layered (Controller → Service)');
+        expect(md).toContain('| ORM / Dados | Prisma |');
+        expect(md).toContain('Vitest');
+        expect(md).toContain('<!-- AGENT'); // semantic sections left for the skill
+        expect(md).toContain('Regras de Ouro do Projeto');
+    });
+    it('renders the conventional-commits summary with prefixes', () => {
+        const md = renderDnaSkeleton(facts());
+        expect(md).toMatch(/\*\*segue Conventional Commits\*\*/);
+        expect(md).toContain('feat:20');
+    });
+    it('notes when git is unavailable', () => {
+        const md = renderDnaSkeleton(facts({ commits: null }));
+        expect(md).toContain('repositório git indisponível');
+    });
+    it('handles empty tooling gracefully', () => {
+        const md = renderDnaSkeleton(facts({ tooling: { linters: [], formatters: [] } }));
+        expect(md).toContain('_(nenhum detectado)_');
+    });
+});
+//# sourceMappingURL=dna-facts.test.js.map

package/dist/__tests__/dna-facts.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dna-facts.test.js","sourceRoot":"","sources":["../../src/__tests__/dna-facts.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/graph-renderer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=graph-renderer.test.d.ts.map

package/dist/__tests__/graph-renderer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-renderer.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/graph-renderer.test.ts"],"names":[],"mappings":""}