@girardelli/architect 4.0.0 → 6.0.0

package/dist/agent-generator/templates/helpers/security-helpers.js

@@ -0,0 +1,182 @@
+import { getEnriched } from './base-helpers.js';
+export function frameworkSecurityChecklist(ctx) {
+    const enriched = getEnriched(ctx);
+    const fw = enriched.primaryFramework?.name || '';
+    const lang = ctx.stack.primary;
+    if (fw === 'FastAPI') {
+        return `
+## Checklist Segurança — FastAPI
+
+\`\`\`
+□ Pydantic models para validação de TODOS os inputs
+□ OAuth2PasswordBearer / OAuth2AuthorizationCodeBearer configurado
+□ Depends() para injeção segura de autenticação
+□ CORS via CORSMiddleware com origins whitelist (não usar "*")
+□ Rate limiting via slowapi ou middleware customizado
+□ Security headers via middleware (X-Content-Type-Options, etc.)
+□ Senhas hasheadas com passlib (bcrypt/argon2)
+□ JWT tokens com expiração curta + refresh token
+□ HTTPS obrigatório em produção (redirect HTTP → HTTPS)
+□ Logs estruturados SEM dados sensíveis (loguru/structlog)
+□ SQLAlchemy com queries parametrizadas (nunca string concat)
+□ Background tasks validadas contra injection
+□ File uploads com validação de tipo e tamanho
+□ Dependency scanning: pip-audit / safety
+\`\`\``;
+    }
+    if (fw === 'Django' || fw === 'DRF') {
+        return `
+## Checklist Segurança — Django
+
+\`\`\`
+□ CSRF protection habilitado (CsrfViewMiddleware)
+□ XSS protection via auto-escaping nos templates
+□ SQL Injection prevenido via ORM (nunca raw SQL sem parametrize)
+□ Clickjacking protection (X-Frame-Options)
+□ SECURE_SSL_REDIRECT = True em produção
+□ SESSION_COOKIE_SECURE = True
+□ CSRF_COOKIE_SECURE = True
+□ ALLOWED_HOSTS configurado corretamente
+□ DEBUG = False em produção
+□ SECRET_KEY rotacionado e não commitado
+□ django-rest-framework permissions e throttling
+□ django-cors-headers com whitelist
+□ Senhas hasheadas com PBKDF2/Argon2 (PASSWORD_HASHERS)
+□ Dependency scanning: pip-audit / safety
+\`\`\``;
+    }
+    if (fw === 'Flask') {
+        return `
+## Checklist Segurança — Flask
+
+\`\`\`
+□ Flask-Talisman para security headers
+□ Flask-CORS com origins whitelist
+□ Flask-Limiter para rate limiting
+□ Flask-Login / Flask-JWT-Extended para auth
+□ CSRF via Flask-WTF
+□ SECRET_KEY seguro e rotacionado
+□ Session cookie seguro (httponly, secure, samesite)
+□ SQLAlchemy com queries parametrizadas
+□ Jinja2 auto-escaping habilitado
+□ File uploads validados (tipo, tamanho, path traversal)
+□ Dependency scanning: pip-audit / safety
+\`\`\``;
+    }
+    if (fw === 'NestJS') {
+        return `
+## Checklist Segurança — NestJS
+
+\`\`\`
+□ Helmet habilitado (app.use(helmet()))
+□ CORS com origins whitelist
+□ Rate limiting via @nestjs/throttler
+□ class-validator em TODOS os DTOs
+□ Guards para autenticação/autorização
+□ JWT via @nestjs/jwt com expiração curta
+□ CSRF protection (se serve HTML)
+□ TypeORM/Prisma com queries parametrizadas
+□ Pipes de validação globais (ValidationPipe)
+□ Exception filters customizados (sem stack traces em prod)
+□ npm audit sem vulnerabilidades críticas
+□ strict: true em tsconfig.json
+\`\`\``;
+    }
+    if (fw === 'Express' || fw === 'Fastify') {
+        return `
+## Checklist Segurança — ${fw}
+
+\`\`\`
+□ Helmet.js habilitado
+□ CORS configurado restritivamente
+□ Rate limiting (express-rate-limit)
+□ Input validation (joi / zod / express-validator)
+□ JWT com expiração + refresh
+□ CSRF protection (csurf)
+□ Queries parametrizadas (nunca string interpolation)
+□ Error handler que não vaza stack traces
+□ npm audit sem vulnerabilidades críticas
+□ HTTPS obrigatório
+\`\`\``;
+    }
+    if (fw === 'Spring Boot') {
+        return `
+## Checklist Segurança — Spring Boot
+
+\`\`\`
+□ Spring Security configurado
+□ CSRF habilitado para endpoints com estado
+□ CORS via WebMvcConfigurer com whitelist
+□ @Valid / @Validated em DTOs
+□ BCrypt para senhas (PasswordEncoder)
+□ JPA parametrizado (nunca JPQL com concat)
+□ Actuator endpoints protegidos em produção
+□ OAuth2/JWT via Spring Security OAuth
+□ Content-Security-Policy configurado
+□ Dependências: OWASP Dependency-Check
+\`\`\``;
+    }
+    if (fw === 'Laravel') {
+        return `
+## Checklist Segurança — Laravel
+
+\`\`\`
+□ CSRF token em todos os forms (@csrf)
+□ Eloquent parametrizado (nunca DB::raw sem bind)
+□ Form Requests para validação
+□ Sanctum/Passport para API auth
+□ Gate/Policy para autorização
+□ Encryption via Crypt facade
+□ Rate limiting via RateLimiter
+□ APP_DEBUG=false em produção
+□ CORS via config/cors.php com whitelist
+□ Composer audit sem vulnerabilidades
+\`\`\``;
+    }
+    // Fallback by language
+    if (lang === 'Python') {
+        return `
+## Checklist Segurança — Python
+
+\`\`\`
+□ Inputs validados (pydantic / marshmallow / WTForms)
+□ Queries parametrizadas (SQLAlchemy / Django ORM)
+□ CORS configurado com whitelist
+□ Rate limiting implementado
+□ Security headers configurados
+□ Senhas hasheadas com bcrypt/argon2
+□ Sem pickle para dados untrusted
+□ HTTPS obrigatório em produção
+□ pip-audit / safety para vulnerabilidades
+□ Logging sem dados sensíveis
+\`\`\``;
+    }
+    if (lang === 'Go') {
+        return `
+## Checklist Segurança — Go
+
+\`\`\`
+□ Inputs validados via validator package
+□ Prepared statements para SQL
+□ TLS/mTLS para comunicação inter-serviços
+□ CORS headers explícitos
+□ Rate limiting implementado
+□ Logging de ações críticas (sem PII)
+□ go vet / staticcheck no CI
+□ govulncheck para vulnerabilidades
+\`\`\``;
+    }
+    return `
+## Checklist Segurança — ${lang}
+
+\`\`\`
+□ Inputs sanitizados e validados
+□ Queries parametrizadas obrigatoriamente
+□ CSRF tokens em formulários
+□ Rate limiting em APIs
+□ Secrets em variáveis de ambiente
+□ HTTPS obrigatório em produção
+□ Dependency scanning no CI
+\`\`\``;
+}
+//# sourceMappingURL=security-helpers.js.map

package/dist/agent-generator/templates/helpers/security-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"security-helpers.js","sourceRoot":"","sources":["../../../../src/agent-generator/templates/helpers/security-helpers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,UAAU,0BAA0B,CAAC,GAAoB;IAC7D,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,EAAE,GAAG,QAAQ,CAAC,gBAAgB,EAAE,IAAI,IAAI,EAAE,CAAC;IACjD,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC;IAE/B,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QACrB,OAAO;;;;;;;;;;;;;;;;;;OAkBJ,CAAC;IACN,CAAC;IAED,IAAI,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,KAAK,EAAE,CAAC;QACpC,OAAO;;;;;;;;;;;;;;;;;;OAkBJ,CAAC;IACN,CAAC;IAED,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC;QACnB,OAAO;;;;;;;;;;;;;;;OAeJ,CAAC;IACN,CAAC;IAED,IAAI,EAAE,KAAK,QAAQ,EAAE,CAAC;QACpB,OAAO;;;;;;;;;;;;;;;;OAgBJ,CAAC;IACN,CAAC;IAED,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QACzC,OAAO;2BACgB,EAAE;;;;;;;;;;;;;OAatB,CAAC;IACN,CAAC;IAED,IAAI,EAAE,KAAK,aAAa,EAAE,CAAC;QACzB,OAAO;;;;;;;;;;;;;;OAcJ,CAAC;IACN,CAAC;IAED,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QACrB,OAAO;;;;;;;;;;;;;;OAcJ,CAAC;IACN,CAAC;IAED,uBAAuB;IACvB,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,OAAO;;;;;;;;;;;;;;OAcJ,CAAC;IACN,CAAC;IAED,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO;;;;;;;;;;;;OAYJ,CAAC;IACN,CAAC;IAED,OAAO;2BACkB,IAAI;;;;;;;;;;OAUxB,CAAC;AACR,CAAC"}

package/dist/agent-generator/templates/helpers/stack-helpers.d.ts

@@ -0,0 +1,5 @@
+import { TemplateContext } from '../../types.js';
+export declare function frameworkBadge(ctx: TemplateContext): string;
+export declare function projectStructureBadge(ctx: TemplateContext): string;
+export declare function toolchainCommands(ctx: TemplateContext): string;
+//# sourceMappingURL=stack-helpers.d.ts.map

package/dist/agent-generator/templates/helpers/stack-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-helpers.d.ts","sourceRoot":"","sources":["../../../../src/agent-generator/templates/helpers/stack-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAA0C,MAAM,gBAAgB,CAAC;AAIzF,wBAAgB,cAAc,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAsB3D;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAclE;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CA+B9D"}

package/dist/agent-generator/templates/helpers/stack-helpers.js

@@ -0,0 +1,69 @@
+import { getEnriched } from './base-helpers.js';
+export function frameworkBadge(ctx) {
+    const enriched = getEnriched(ctx);
+    if (!enriched.detectedFrameworks?.length)
+        return '';
+    const fws = enriched.detectedFrameworks
+        .filter((f) => f.category === 'web' || f.category === 'orm')
+        .map((f) => `**${f.name}**${f.version ? ` ${f.version}` : ''}`);
+    const testFws = enriched.detectedFrameworks
+        .filter((f) => f.category === 'test')
+        .map((f) => f.name);
+    const lintFws = enriched.detectedFrameworks
+        .filter((f) => f.category === 'lint')
+        .map((f) => f.name);
+    const parts = [];
+    if (fws.length)
+        parts.push(fws.join(' + '));
+    if (testFws.length)
+        parts.push(`Testes: ${testFws.join(', ')}`);
+    if (lintFws.length)
+        parts.push(`Lint: ${lintFws.join(', ')}`);
+    return `> 🚀 **Stack Detectada:** ${parts.join(' · ')}`;
+}
+export function projectStructureBadge(ctx) {
+    const enriched = getEnriched(ctx);
+    const structure = enriched.projectStructure || 'unknown';
+    const labels = {
+        'clean-architecture': '🏛️ Clean Architecture / DDD',
+        'mvc': '📐 MVC (Model-View-Controller)',
+        'modular': '📦 Modular (Feature-based)',
+        'flat': '📄 Flat Structure',
+        'monorepo': '🏗️ Monorepo',
+        'unknown': '❓ Estrutura não identificada',
+    };
+    return labels[structure] || labels['unknown'];
+}
+export function toolchainCommands(ctx) {
+    const enriched = getEnriched(ctx);
+    if (!enriched.toolchain)
+        return '';
+    const tc = enriched.toolchain;
+    return `
+## 🔧 Toolchain Detectado
+
+\`\`\`bash
+# Build
+${tc.buildCmd}
+
+# Testes
+${tc.testCmd}
+
+# Lint
+${tc.lintCmd}
+
+# Coverage
+${tc.coverageCmd}
+
+# Dev Server
+${tc.runCmd}
+
+# Instalar dependências
+${tc.installCmd}
+${tc.migrateCmd ? `\n# Migrations\n${tc.migrateCmd}` : ''}
+\`\`\`
+
+> **Deps file:** \`${tc.depsFile}\`
+`;
+}
+//# sourceMappingURL=stack-helpers.js.map

package/dist/agent-generator/templates/helpers/stack-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-helpers.js","sourceRoot":"","sources":["../../../../src/agent-generator/templates/helpers/stack-helpers.ts"],"names":[],"mappings":"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"}

package/dist/agent-generator/templates/helpers/structure-helpers.d.ts

@@ -0,0 +1,3 @@
+import { TemplateContext } from '../../types.js';
+export declare function frameworkModuleStructure(ctx: TemplateContext): string;
+//# sourceMappingURL=structure-helpers.d.ts.map

package/dist/agent-generator/templates/helpers/structure-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure-helpers.d.ts","sourceRoot":"","sources":["../../../../src/agent-generator/templates/helpers/structure-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAA0C,MAAM,gBAAgB,CAAC;AAIzF,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CA4RrE"}

package/dist/agent-generator/templates/helpers/structure-helpers.js

@@ -0,0 +1,275 @@
+import { getEnriched } from './base-helpers.js';
+export function frameworkModuleStructure(ctx) {
+    const enriched = getEnriched(ctx);
+    const fw = enriched.primaryFramework?.name || '';
+    const structure = enriched.projectStructure || 'unknown';
+    const lang = ctx.stack.primary;
+    // Clean Architecture (Python, any framework)
+    if (structure === 'clean-architecture') {
+        if (lang === 'Python') {
+            return `
+\`\`\`
+src/[projeto]/
+├── domain/                          → Regras de negócio puras
+│   ├── entities/                    → Entidades com identidade
+│   ├── value_objects/               → Objetos de valor (imutáveis)
+│   ├── services/                    → Serviços de domínio
+│   ├── events/                      → Eventos de domínio
+│   ├── enums/                       → Enumerações
+│   └── exceptions/                  → Exceções customizadas
+├── application/                     → Casos de uso
+│   ├── services/                    → Application services
+│   └── interfaces/                  → Contratos (ports)
+├── infrastructure/                  → Implementações externas
+│   ├── persistence/                 → Repositórios concretos
+│   ├── storage/                     → MinIO, S3, filesystem
+│   ├── extraction/                  → Extração de dados
+│   │   ├── extractors/              → Extractors por tipo
+│   │   ├── ocr/                     → OCR engine
+│   │   └── guards/                  → Validadores
+│   └── agents/                      → Agentes de automação
+├── presentation/                    → Interface com o mundo
+│   ├── api/                         → REST API
+│   │   ├── routes/                  → Endpoints${fw === 'FastAPI' ? ' (FastAPI routers)' : ''}
+│   │   └── dependencies/            → ${fw === 'FastAPI' ? 'FastAPI Depends()' : 'Injeção de deps'}
+│   └── workers/                     → Background workers
+└── tests/
+    ├── unit/                        → Testes unitários
+    ├── integration/                 → Testes de integração
+    └── fixtures/                    → Dados de teste
+\`\`\``;
+        }
+        // TypeScript Clean Architecture
+        return `
+\`\`\`
+src/
+├── domain/                          → Regras de negócio puras
+│   ├── entities/                    → Entidades com identidade
+│   ├── value-objects/               → Objetos de valor
+│   ├── services/                    → Serviços de domínio
+│   └── events/                      → Eventos de domínio
+├── application/                     → Casos de uso
+│   ├── use-cases/                   → Casos de uso
+│   └── ports/                       → Interfaces (contratos)
+├── infrastructure/                  → Implementações externas
+│   ├── repositories/                → Repositórios concretos
+│   ├── adapters/                    → Adaptadores externos
+│   └── config/                      → Configuração
+├── presentation/                    → Interface com o mundo
+│   ├── controllers/                 → Endpoints da API
+│   ├── dto/                         → Data Transfer Objects
+│   └── middleware/                  → Middleware
+└── tests/
+\`\`\``;
+    }
+    // FastAPI (non-clean-arch)
+    if (fw === 'FastAPI') {
+        return `
+\`\`\`
+app/
+├── main.py                          → Entrypoint (FastAPI app)
+├── api/
+│   ├── routes/                      → APIRouter por recurso
+│   │   ├── __init__.py
+│   │   ├── users.py                 → @router.get("/users")
+│   │   └── items.py                 → @router.get("/items")
+│   └── dependencies.py              → Depends() compartilhados
+├── core/
+│   ├── config.py                    → Settings (pydantic BaseSettings)
+│   └── security.py                  → JWT, OAuth2
+├── models/                          → SQLAlchemy / Pydantic models
+├── schemas/                         → Pydantic schemas (request/response)
+├── services/                        → Lógica de negócio
+├── db/                              → Database session, migrations
+└── tests/
+    ├── conftest.py                  → Fixtures (TestClient, db session)
+    ├── test_users.py
+    └── test_items.py
+\`\`\``;
+    }
+    // Django
+    if (fw === 'Django' || fw === 'DRF') {
+        return `
+\`\`\`
+project/
+├── manage.py
+├── config/                          → Settings, URLs, WSGI
+│   ├── settings/
+│   │   ├── base.py
+│   │   ├── local.py
+│   │   └── production.py
+│   └── urls.py                      → Root URL config
+├── apps/
+│   └── [app_name]/                  → Django app
+│       ├── models.py                → Django ORM models
+│       ├── views.py                 → ViewSets / APIViews
+│       ├── serializers.py           → DRF serializers
+│       ├── urls.py                  → App URLs
+│       ├── admin.py                 → Django admin
+│       ├── forms.py                 → Forms
+│       ├── signals.py               → Django signals
+│       └── tests/
+│           ├── test_models.py
+│           └── test_views.py
+└── requirements/
+\`\`\``;
+    }
+    // Flask
+    if (fw === 'Flask') {
+        return `
+\`\`\`
+app/
+├── __init__.py                      → create_app() factory
+├── blueprints/                      → Flask Blueprints
+│   ├── auth/
+│   │   ├── __init__.py              → Blueprint registration
+│   │   ├── routes.py                → @bp.route()
+│   │   └── models.py
+│   └── api/
+├── models/                          → SQLAlchemy models
+├── services/                        → Lógica de negócio
+├── extensions.py                    → db, migrate, login_manager
+├── config.py                        → Configuração
+└── tests/
+\`\`\``;
+    }
+    // NestJS
+    if (fw === 'NestJS') {
+        return `
+\`\`\`
+src/
+├── main.ts                          → Bootstrap (NestFactory)
+├── app.module.ts                    → Root module
+├── modules/
+│   └── [module-name]/
+│       ├── [name].module.ts         → @Module()
+│       ├── [name].controller.ts     → @Controller() endpoints
+│       ├── [name].service.ts        → @Injectable() lógica
+│       ├── dto/
+│       │   ├── create-[name].dto.ts → class-validator DTOs
+│       │   └── update-[name].dto.ts
+│       ├── entities/
+│       │   └── [name].entity.ts     → TypeORM/Prisma entity
+│       └── __tests__/
+│           ├── [name].service.spec.ts
+│           └── [name].controller.spec.ts
+├── common/                          → Guards, pipes, interceptors
+└── config/                          → ConfigModule
+\`\`\``;
+    }
+    // Express
+    if (fw === 'Express' || fw === 'Fastify') {
+        return `
+\`\`\`
+src/
+├── index.ts                         → Entrypoint
+├── routes/                          → Route handlers
+│   ├── users.router.ts
+│   └── items.router.ts
+├── controllers/                     → Request handlers
+├── services/                        → Business logic
+├── models/                          → Data models
+├── middleware/                       → Auth, validation, error handler
+├── config/                          → Environment config
+└── tests/
+\`\`\``;
+    }
+    // Spring Boot
+    if (fw === 'Spring Boot') {
+        return `
+\`\`\`
+src/main/java/com/company/project/
+├── Application.java                 → @SpringBootApplication
+├── controller/                      → @RestController
+│   └── UserController.java
+├── service/                         → @Service
+│   └── UserService.java
+├── repository/                      → @Repository (Spring Data JPA)
+│   └── UserRepository.java
+├── model/                           → @Entity
+│   └── User.java
+├── dto/                             → Request/Response DTOs
+├── config/                          → @Configuration
+├── exception/                       → @ControllerAdvice
+└── security/                        → Spring Security config
+\`\`\``;
+    }
+    // Laravel
+    if (fw === 'Laravel') {
+        return `
+\`\`\`
+app/
+├── Http/
+│   ├── Controllers/                 → Controllers
+│   ├── Middleware/                   → Middleware
+│   └── Requests/                    → Form Requests (validation)
+├── Models/                          → Eloquent Models
+├── Services/                        → Business Logic
+├── Repositories/                    → Data Access
+├── Providers/                       → Service Providers
+├── Events/                          → Event classes
+├── Listeners/                       → Event listeners
+├── Policies/                        → Authorization policies
+database/
+├── migrations/                      → Database migrations
+├── seeders/                         → Database seeders
+└── factories/                       → Model factories
+\`\`\``;
+    }
+    // Go
+    if (fw === 'Gin' || fw === 'Echo' || fw === 'Fiber' || fw === 'Chi') {
+        return `
+\`\`\`
+.
+├── cmd/
+│   └── server/
+│       └── main.go                  → Entrypoint
+├── internal/
+│   ├── handler/                     → HTTP handlers
+│   ├── service/                     → Business logic
+│   ├── repository/                  → Data access
+│   ├── model/                       → Domain models
+│   ├── middleware/                   → HTTP middleware
+│   └── config/                      → Configuration
+├── pkg/                             → Public packages
+├── go.mod
+└── go.sum
+\`\`\``;
+    }
+    // Ruby on Rails
+    if (fw === 'Ruby on Rails') {
+        return `
+\`\`\`
+app/
+├── controllers/                     → ActionController
+├── models/                          → ActiveRecord models
+├── views/                           → ERB/HAML templates
+├── services/                        → Service objects
+├── jobs/                            → ActiveJob
+├── mailers/                         → ActionMailer
+├── serializers/                     → JSON serializers
+config/
+├── routes.rb                        → Route definitions
+├── database.yml                     → Database config
+db/
+├── migrate/                         → Migrations
+├── seeds.rb                         → Seed data
+spec/ (ou test/)
+\`\`\``;
+    }
+    // Generic fallback
+    const ext = lang === 'Python' ? 'py' : lang === 'Go' ? 'go' : lang === 'PHP' ? 'php' : lang === 'Ruby' ? 'rb' : 'ts';
+    return `
+\`\`\`
+src/
+├── controllers/                     → Endpoints / HTTP handlers
+├── services/                        → Lógica de negócio
+├── models/                          → Modelos de dados
+├── repositories/                    → Acesso a dados
+├── dto/                             → Data Transfer Objects
+├── middleware/                       → Middleware
+├── config/                          → Configuração
+└── tests/                           → Testes (.${ext})
+\`\`\``;
+}
+//# sourceMappingURL=structure-helpers.js.map

package/dist/agent-generator/templates/helpers/structure-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure-helpers.js","sourceRoot":"","sources":["../../../../src/agent-generator/templates/helpers/structure-helpers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,UAAU,wBAAwB,CAAC,GAAoB;IAC3D,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,EAAE,GAAG,QAAQ,CAAC,gBAAgB,EAAE,IAAI,IAAI,EAAE,CAAC;IACjD,MAAM,SAAS,GAAG,QAAQ,CAAC,gBAAgB,IAAI,SAAS,CAAC;IACzD,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC;IAE/B,6CAA6C;IAC7C,IAAI,SAAS,KAAK,oBAAoB,EAAE,CAAC;QACvC,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,OAAO;;;;;;;;;;;;;;;;;;;;;;;kDAuBqC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE;yCACrD,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,iBAAiB;;;;;;OAM5F,CAAC;QACJ,CAAC;QAED,gCAAgC;QAChC,OAAO;;;;;;;;;;;;;;;;;;;;OAoBJ,CAAC;IACN,CAAC;IAED,2BAA2B;IAC3B,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QACrB,OAAO;;;;;;;;;;;;;;;;;;;;;OAqBJ,CAAC;IACN,CAAC;IAED,SAAS;IACT,IAAI,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,KAAK,EAAE,CAAC;QACpC,OAAO;;;;;;;;;;;;;;;;;;;;;;;OAuBJ,CAAC;IACN,CAAC;IAED,QAAQ;IACR,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC;QACnB,OAAO;;;;;;;;;;;;;;;OAeJ,CAAC;IACN,CAAC;IAED,SAAS;IACT,IAAI,EAAE,KAAK,QAAQ,EAAE,CAAC;QACpB,OAAO;;;;;;;;;;;;;;;;;;;;OAoBJ,CAAC;IACN,CAAC;IAED,UAAU;IACV,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QACzC,OAAO;;;;;;;;;;;;;OAaJ,CAAC;IACN,CAAC;IAED,cAAc;IACd,IAAI,EAAE,KAAK,aAAa,EAAE,CAAC;QACzB,OAAO;;;;;;;;;;;;;;;;OAgBJ,CAAC;IACN,CAAC;IAED,UAAU;IACV,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QACrB,OAAO;;;;;;;;;;;;;;;;;;OAkBJ,CAAC;IACN,CAAC;IAED,KAAK;IACL,IAAI,EAAE,KAAK,KAAK,IAAI,EAAE,KAAK,MAAM,IAAI,EAAE,KAAK,OAAO,IAAI,EAAE,KAAK,KAAK,EAAE,CAAC;QACpE,OAAO;;;;;;;;;;;;;;;;OAgBJ,CAAC;IACN,CAAC;IAED,gBAAgB;IAChB,IAAI,EAAE,KAAK,eAAe,EAAE,CAAC;QAC3B,OAAO;;;;;;;;;;;;;;;;;OAiBJ,CAAC;IACN,CAAC;IAED,mBAAmB;IACnB,MAAM,GAAG,GAAG,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACrH,OAAO;;;;;;;;;;kDAUyC,GAAG;OAC9C,CAAC;AACR,CAAC"}

package/dist/agent-generator/templates/helpers/summary-helpers.d.ts

@@ -0,0 +1,7 @@
+import { TemplateContext } from '../../types.js';
+export declare function domainBadge(ctx: TemplateContext): string;
+export declare function complianceBadges(ctx: TemplateContext): string;
+export declare function depthIndicator(ctx: TemplateContext): string;
+export declare function modulesSummaryTable(ctx: TemplateContext): string;
+export declare function integrationsSummary(ctx: TemplateContext): string;
+//# sourceMappingURL=summary-helpers.d.ts.map

package/dist/agent-generator/templates/helpers/summary-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary-helpers.d.ts","sourceRoot":"","sources":["../../../../src/agent-generator/templates/helpers/summary-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAA0C,MAAM,gBAAgB,CAAC;AAIzF,wBAAgB,WAAW,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAQxD;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAU7D;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAU3D;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAahE;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAShE"}

package/dist/agent-generator/templates/helpers/summary-helpers.js

@@ -0,0 +1,56 @@
+import { getEnriched, depthScale } from './base-helpers.js';
+export function domainBadge(ctx) {
+    const enriched = getEnriched(ctx);
+    if (!enriched.domain)
+        return '';
+    const { domain } = enriched;
+    return `
+> 📌 **Domínio:** ${domain.domain} · **Sub-domínio:** ${domain.subDomain} · **Confiança:** ${Math.round(domain.confidence * 100)}%
+`;
+}
+export function complianceBadges(ctx) {
+    const enriched = getEnriched(ctx);
+    if (!enriched.domain?.compliance?.length)
+        return '';
+    return `
+### ⚖️ Compliance Obrigatório
+
+${enriched.domain.compliance.map((c) => `- **${c.name}** — ${c.reason}
+  - Checks: ${c.mandatoryChecks.join(', ')}`).join('\n')}
+`;
+}
+export function depthIndicator(ctx) {
+    const enriched = getEnriched(ctx);
+    const depth = enriched.projectDepth || 'medium';
+    const labels = {
+        small: '🟢 Projeto Pequeno (< 50 arquivos)',
+        medium: '🟡 Projeto Médio (50-200 arquivos)',
+        large: '🟠 Projeto Grande (200-500 arquivos)',
+        enterprise: '🔴 Enterprise (500+ arquivos)',
+    };
+    return labels[depth];
+}
+export function modulesSummaryTable(ctx) {
+    const enriched = getEnriched(ctx);
+    if (!enriched.modules?.length)
+        return '';
+    const maxModules = depthScale(ctx, { small: 5, medium: 10, large: 20, enterprise: 50 });
+    const modules = enriched.modules.slice(0, maxModules);
+    return `
+| Módulo | Arquivos | Linhas | Testes | Camada |
+|--------|----------|--------|--------|--------|
+${modules.map((m) => `| ${m.name} | ${m.fileCount} | ${m.lineCount > 0 ? m.lineCount.toLocaleString() : '—'} | ${m.hasTests ? '✅' : '❌'} | ${m.layer} |`).join('\n')}
+${enriched.modules.length > maxModules ? `\n> ... e mais ${enriched.modules.length - maxModules} módulos.` : ''}
+`;
+}
+export function integrationsSummary(ctx) {
+    const enriched = getEnriched(ctx);
+    if (!enriched.domain?.integrations?.length)
+        return '';
+    return `
+### Integrações Externas Detectadas
+
+${enriched.domain.integrations.map((i) => `- **${i.name}** (${i.type}) — detectado em \`${i.detectedFrom}\``).join('\n')}
+`;
+}
+//# sourceMappingURL=summary-helpers.js.map

package/dist/agent-generator/templates/helpers/summary-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary-helpers.js","sourceRoot":"","sources":["../../../../src/agent-generator/templates/helpers/summary-helpers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE5D,MAAM,UAAU,WAAW,CAAC,GAAoB;IAC9C,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,CAAC,QAAQ,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IAEhC,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC;IAC5B,OAAO;oBACW,MAAM,CAAC,MAAM,uBAAuB,MAAM,CAAC,SAAS,qBAAqB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,GAAG,GAAG,CAAC;CAC/H,CAAC;AACF,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAoB;IACnD,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM;QAAE,OAAO,EAAE,CAAC;IAEpD,OAAO;;;EAGP,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,MAAM;cAC5D,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;CACvD,CAAC;AACF,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAoB;IACjD,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,QAAQ,CAAC,YAAY,IAAI,QAAQ,CAAC;IAChD,MAAM,MAAM,GAA2B;QACrC,KAAK,EAAE,oCAAoC;QAC3C,MAAM,EAAE,oCAAoC;QAC5C,KAAK,EAAE,sCAAsC;QAC7C,UAAU,EAAE,+BAA+B;KAC5C,CAAC;IACF,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAoB;IACtD,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM;QAAE,OAAO,EAAE,CAAC;IAEzC,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;IACxF,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAEtD,OAAO;;;EAGP,OAAO,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;EACvK,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,kBAAkB,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,UAAU,WAAW,CAAC,CAAC,CAAC,EAAE;CAC9G,CAAC;AACF,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAoB;IACtD,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM;QAAE,OAAO,EAAE,CAAC;IAEtD,OAAO;;;EAGP,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,IAAI,sBAAsB,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;CAC5H,CAAC;AACF,CAAC"}