@girardelli/architect-agents 8.1.0

package/dist/src/core/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/src/core/agent-generator/templates/helpers/structure-helpers.js.map

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

@@ -0,0 +1,6 @@
+import { TemplateContext } from '@girardelli/architect-agents/src/core/agent-generator/types/template.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;

package/dist/src/core/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/src/core/agent-generator/templates/helpers/summary-helpers.js.map

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

package/dist/src/core/agent-generator/templates/stack/index.d.ts

@@ -0,0 +1,7 @@
+import { TemplateContext } from '@girardelli/architect-agents/src/core/agent-generator/types/template.js';
+/**
+ * Stack-specific rule generators.
+ * Each generates a 03-[framework].md rule file tailored to the detected stack.
+ */
+export declare function generateStackRules(ctx: TemplateContext): string | null;
+export declare function getStackRuleFileName(ctx: TemplateContext): string | null;