@girardelli/architect-agents 8.1.0

package/dist/src/core/agent-generator/templates/template-helpers.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Template Helpers v3.2 — Facade para todos os utilitários agnósticos e estruturais.
+ *
+ * Refatorado na Fase 2.3.4: Erradicação final da God Class (777 → 20 linhas).
+ */
+export * from './helpers/base-helpers.js';
+export * from './helpers/cross-ref-helpers.js';
+export * from './helpers/summary-helpers.js';
+export * from './helpers/stack-helpers.js';
+export * from './helpers/structure-helpers.js';
+export * from './helpers/security-helpers.js';

package/dist/src/core/agent-generator/templates/template-helpers.js

@@ -0,0 +1,12 @@
+/**
+ * Template Helpers v3.2 — Facade para todos os utilitários agnósticos e estruturais.
+ *
+ * Refatorado na Fase 2.3.4: Erradicação final da God Class (777 → 20 linhas).
+ */
+export * from './helpers/base-helpers.js';
+export * from './helpers/cross-ref-helpers.js';
+export * from './helpers/summary-helpers.js';
+export * from './helpers/stack-helpers.js';
+export * from './helpers/structure-helpers.js';
+export * from './helpers/security-helpers.js';
+//# sourceMappingURL=template-helpers.js.map

package/dist/src/core/agent-generator/templates/template-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-helpers.js","sourceRoot":"","sources":["../../../../../src/core/agent-generator/templates/template-helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,+BAA+B,CAAC"}

package/dist/src/core/agent-generator/types/agent.d.ts

@@ -0,0 +1,39 @@
+import { StackInfo } from './stack.js';
+export interface AgentAuditFinding {
+    type: 'MISSING' | 'OUTDATED' | 'IMPROVEMENT' | 'OK';
+    category: string;
+    file: string;
+    description: string;
+    suggestion?: string;
+}
+export type AgentItemStatus = 'KEEP' | 'MODIFY' | 'CREATE' | 'DELETE';
+export interface AgentItem {
+    name: string;
+    status: AgentItemStatus;
+    reason?: string;
+    description?: string;
+}
+export interface AgentSuggestion {
+    stack: StackInfo;
+    hasExistingAgents: boolean;
+    suggestedAgents: AgentItem[];
+    suggestedRules: AgentItem[];
+    suggestedGuards: AgentItem[];
+    suggestedWorkflows: AgentItem[];
+    suggestedSkills: {
+        name: string;
+        source: string;
+        description: string;
+        status: AgentItemStatus;
+    }[];
+    audit: AgentAuditFinding[];
+    command: string;
+}
+export interface AgentGeneratorConfig {
+    coverageMinimum: number;
+    scoreThreshold: number;
+    language: 'pt-BR' | 'en';
+    goldenRules: string[];
+    blockers: string[];
+}
+export declare const DEFAULT_AGENT_CONFIG: AgentGeneratorConfig;

package/dist/src/core/agent-generator/types/agent.js

@@ -0,0 +1,27 @@
+export const DEFAULT_AGENT_CONFIG = {
+    coverageMinimum: 80,
+    scoreThreshold: 70,
+    language: 'pt-BR',
+    goldenRules: [
+        'Git Flow completo (branch → PR → review → merge)',
+        'Arquitetura C4 (4 níveis de documentação)',
+        'BDD antes de código',
+        'TDD — Red → Green → Refactor',
+        'Diagnóstico obrigatório antes de codar',
+        'Mockup antes de qualquer UI',
+        'Nunca decidir sozinho — perguntar ao humano',
+        'Qualidade > Velocidade',
+        'Não abrir browser, não tirar screenshot — apenas código',
+    ],
+    blockers: [
+        'console.log / print() em código de produção',
+        'TODO / FIXME / HACK sem issue vinculada',
+        'any (TypeScript) / type: ignore (Python) sem justificativa',
+        'Testes com .skip() ou @pytest.mark.skip sem motivo',
+        'Secrets, tokens ou senhas hardcoded',
+        'Push direto em main/develop',
+        'Arquivos > 500 linhas sem justificativa',
+        'Imports circulares',
+    ],
+};
+//# sourceMappingURL=agent.js.map

package/dist/src/core/agent-generator/types/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../../../../src/core/agent-generator/types/agent.ts"],"names":[],"mappings":"AAuCA,MAAM,CAAC,MAAM,oBAAoB,GAAyB;IACxD,eAAe,EAAE,EAAE;IACnB,cAAc,EAAE,EAAE;IAClB,QAAQ,EAAE,OAAO;IACjB,WAAW,EAAE;QACX,kDAAkD;QAClD,2CAA2C;QAC3C,qBAAqB;QACrB,8BAA8B;QAC9B,wCAAwC;QACxC,6BAA6B;QAC7B,6CAA6C;QAC7C,wBAAwB;QACxB,yDAAyD;KAC1D;IACD,QAAQ,EAAE;QACR,6CAA6C;QAC7C,yCAAyC;QACzC,4DAA4D;QAC5D,oDAAoD;QACpD,qCAAqC;QACrC,6BAA6B;QAC7B,yCAAyC;QACzC,oBAAoB;KACrB;CACF,CAAC"}

package/dist/src/core/agent-generator/types/domain.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Detailed module information extracted from project analysis.
+ */
+export interface ModuleDetail {
+    name: string;
+    path: string;
+    files: string[];
+    fileCount: number;
+    lineCount: number;
+    description: string;
+    hasTests: boolean;
+    testFiles: string[];
+    entities: string[];
+    controllers: string[];
+    services: string[];
+    layer: string;
+}
+/**
+ * API endpoint detected from route/controller files.
+ */
+export interface DetectedEndpoint {
+    method: string;
+    path: string;
+    file: string;
+    handler: string;
+    hasAuth: boolean;
+    hasValidation: boolean;
+}
+export interface BusinessEntity {
+    name: string;
+    source: string;
+    fields: string[];
+    relationships: string[];
+    layer: 'model' | 'entity' | 'schema' | 'dto' | 'unknown';
+}
+export interface ComplianceRequirement {
+    name: string;
+    reason: string;
+    mandatoryChecks: string[];
+}
+export interface ExternalIntegration {
+    name: string;
+    type: 'api' | 'database' | 'queue' | 'storage' | 'payment' | 'auth' | 'government' | 'other';
+    detectedFrom: string;
+}
+/**
+ * Domain classification inferred from project analysis.
+ */
+export interface DomainInsights {
+    domain: string;
+    subDomain: string;
+    description: string;
+    businessEntities: BusinessEntity[];
+    compliance: ComplianceRequirement[];
+    integrations: ExternalIntegration[];
+    keywords: string[];
+    confidence: number;
+}

package/dist/src/core/agent-generator/types/domain.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=domain.js.map

package/dist/src/core/agent-generator/types/domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.js","sourceRoot":"","sources":["../../../../../src/core/agent-generator/types/domain.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,36 @@
+/**
+ * Stack detection result from project analysis.
+ */
+export interface StackInfo {
+    primary: string;
+    languages: string[];
+    frameworks: string[];
+    hasBackend: boolean;
+    hasFrontend: boolean;
+    hasMobile: boolean;
+    hasDatabase: boolean;
+    testFramework: string;
+    packageManager: string;
+}
+/**
+ * Detected framework with version, detected from dependency files.
+ */
+export interface FrameworkInfo {
+    name: string;
+    version: string | null;
+    category: 'web' | 'orm' | 'test' | 'lint' | 'build' | 'other';
+    confidence: number;
+}
+/**
+ * Detected toolchain — build, test, lint, run commands.
+ */
+export interface DetectedToolchain {
+    buildCmd: string;
+    testCmd: string;
+    lintCmd: string;
+    runCmd: string;
+    coverageCmd: string;
+    installCmd: string;
+    migrateCmd: string | null;
+    depsFile: string;
+}

package/dist/src/core/agent-generator/types/stack.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=stack.js.map

package/dist/src/core/agent-generator/types/stack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack.js","sourceRoot":"","sources":["../../../../../src/core/agent-generator/types/stack.ts"],"names":[],"mappings":""}

package/dist/src/core/agent-generator/types/template.d.ts

@@ -0,0 +1,29 @@
+import { AnalysisReport } from '@girardelli/architect-core/src/core/types/core.js';
+import { RefactoringPlan } from '@girardelli/architect-core/src/core/types/rules.js';
+import { StackInfo, FrameworkInfo, DetectedToolchain } from './stack.js';
+import { DomainInsights, ModuleDetail, DetectedEndpoint } from './domain.js';
+import { AgentGeneratorConfig } from './agent.js';
+export interface TemplateContext {
+    report: AnalysisReport;
+    plan: RefactoringPlan;
+    stack: StackInfo;
+    projectName: string;
+    stackLabel: string;
+    config: AgentGeneratorConfig;
+}
+export interface EnrichedTemplateContext extends TemplateContext {
+    domain: DomainInsights;
+    modules: ModuleDetail[];
+    endpoints: DetectedEndpoint[];
+    untestedModules: string[];
+    criticalPaths: string[];
+    projectDepth: 'small' | 'medium' | 'large' | 'enterprise';
+    /** Detected frameworks with versions */
+    detectedFrameworks: FrameworkInfo[];
+    /** Primary web framework (e.g., 'FastAPI', 'NestJS', 'Django') */
+    primaryFramework: FrameworkInfo | null;
+    /** Detected toolchain commands */
+    toolchain: DetectedToolchain;
+    /** Real project structure pattern detected */
+    projectStructure: 'clean-architecture' | 'mvc' | 'modular' | 'flat' | 'monorepo' | 'unknown';
+}

package/dist/src/core/agent-generator/types/template.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=template.js.map

package/dist/src/core/agent-generator/types/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../../../../src/core/agent-generator/types/template.ts"],"names":[],"mappings":""}

package/dist/src/core/agent-runtime/ai-provider.d.ts

@@ -0,0 +1,33 @@
+/**
+ * AI Provider Factory
+ * Zero-dependency, lightweight adapter for multiple LLM endpoints.
+ */
+export interface AIProvider {
+    /**
+     * Translates an explicit AI prompt along with the existing file content
+     * into a newly unified source code string.
+     */
+    executeRefactoringPrompt(fileContent: string, prompt: string): Promise<string>;
+}
+export declare class OpenAIProvider implements AIProvider {
+    private apiKey;
+    private model;
+    private apiUrl;
+    constructor(apiKey: string, model?: string, apiUrl?: string);
+    executeRefactoringPrompt(fileContent: string, prompt: string): Promise<string>;
+}
+export declare class AnthropicProvider implements AIProvider {
+    private apiKey;
+    private model;
+    constructor(apiKey: string, model?: string);
+    executeRefactoringPrompt(fileContent: string, prompt: string): Promise<string>;
+}
+export declare class GeminiProvider implements AIProvider {
+    private apiKey;
+    private model;
+    constructor(apiKey: string, model?: string);
+    executeRefactoringPrompt(fileContent: string, prompt: string): Promise<string>;
+}
+export declare class ModelProviderFactory {
+    static createProvider(): AIProvider;
+}

package/dist/src/core/agent-runtime/ai-provider.js

@@ -0,0 +1,146 @@
+/**
+ * AI Provider Factory
+ * Zero-dependency, lightweight adapter for multiple LLM endpoints.
+ */
+export class OpenAIProvider {
+    apiKey;
+    model;
+    apiUrl;
+    constructor(apiKey, model = 'gpt-4o', apiUrl = 'https://api.openai.com/v1/chat/completions') {
+        this.apiKey = apiKey;
+        this.model = model;
+        this.apiUrl = apiUrl;
+    }
+    async executeRefactoringPrompt(fileContent, prompt) {
+        const systemPrompt = `You are a strict, top-tier Software Architect AI modifying code.
+Return ONLY the fully rewritten source code. Never use markdown code blocks (\`\`\`).
+Do NOT include explanations or prefix/suffix text. Your complete response must be purely the new raw code content.`;
+        const userMessage = `${prompt}\n\nCurrent file content:\n\n${fileContent}`;
+        const response = await fetch(this.apiUrl, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify({
+                model: this.model,
+                messages: [
+                    { role: 'system', content: systemPrompt },
+                    { role: 'user', content: userMessage },
+                ],
+                temperature: 0.1,
+            }),
+        });
+        if (!response.ok) {
+            const err = await response.text();
+            throw new Error(`OpenAI API Error (${response.status}): ${err}`);
+        }
+        const data = await response.json();
+        let newCode = data.choices[0].message.content.trim();
+        // Safety check just in case LLM injected markdown blocks
+        if (newCode.startsWith('```') && newCode.endsWith('```')) {
+            const lines = newCode.split('\n');
+            lines.shift(); // Remove first line (```language)
+            lines.pop(); // Remove last line (```)
+            newCode = lines.join('\n');
+        }
+        return newCode;
+    }
+}
+export class AnthropicProvider {
+    apiKey;
+    model;
+    constructor(apiKey, model = 'claude-3-7-sonnet-20250219') {
+        this.apiKey = apiKey;
+        this.model = model;
+    }
+    async executeRefactoringPrompt(fileContent, prompt) {
+        const systemPrompt = `You are a strict Software Architect AI modifying code. Return ONLY the fully rewritten source code. Never use markdown code blocks (\`\`\`). Do NOT include any conversational text.`;
+        const userMessage = `${prompt}\n\n<current_file>\n${fileContent}\n</current_file>`;
+        const response = await fetch('https://api.anthropic.com/v1/messages', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'x-api-key': this.apiKey,
+                'anthropic-version': '2023-06-01',
+            },
+            body: JSON.stringify({
+                model: this.model,
+                system: systemPrompt,
+                messages: [{ role: 'user', content: userMessage }],
+                max_tokens: 8192,
+                temperature: 0.1,
+            }),
+        });
+        if (!response.ok) {
+            const err = await response.text();
+            throw new Error(`Anthropic API Error (${response.status}): ${err}`);
+        }
+        const data = await response.json();
+        let newCode = data.content[0].text.trim();
+        if (newCode.startsWith('```') && newCode.endsWith('```')) {
+            const lines = newCode.split('\n');
+            lines.shift();
+            lines.pop();
+            newCode = lines.join('\n');
+        }
+        return newCode;
+    }
+}
+export class GeminiProvider {
+    apiKey;
+    model;
+    constructor(apiKey, model = 'gemini-2.5-flash') {
+        this.apiKey = apiKey;
+        this.model = model;
+    }
+    async executeRefactoringPrompt(fileContent, prompt) {
+        const url = `https://generativelanguage.googleapis.com/v1beta/models/${this.model}:generateContent?key=${this.apiKey}`;
+        const systemPrompt = 'You are a strict Software Architect AI modifying code. Return ONLY the fully rewritten source code without markdown formatting or conversational filler.';
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                systemInstruction: { parts: [{ text: systemPrompt }] },
+                contents: [
+                    { role: 'user', parts: [{ text: `${prompt}\n\nFile Content:\n\n${fileContent}` }] }
+                ],
+                generationConfig: { temperature: 0.1 }
+            }),
+        });
+        if (!response.ok) {
+            const err = await response.text();
+            throw new Error(`Gemini API Error (${response.status}): ${err}`);
+        }
+        const data = await response.json();
+        const candidate = data.candidates?.[0]?.content?.parts?.[0]?.text || '';
+        let newCode = candidate.trim();
+        if (newCode.startsWith('```') && newCode.endsWith('```')) {
+            const lines = newCode.split('\n');
+            lines.shift();
+            lines.pop();
+            newCode = lines.join('\n');
+        }
+        return newCode;
+    }
+}
+export class ModelProviderFactory {
+    static createProvider() {
+        if (process.env.ANTHROPIC_API_KEY) {
+            return new AnthropicProvider(process.env.ANTHROPIC_API_KEY);
+        }
+        if (process.env.OPENAI_API_KEY) {
+            // Allow overriding API URL for OpenAI compatibles (e.g. DeepSeek, Groq, local LMStudio)
+            const model = process.env.OPENAI_MODEL_NAME || 'gpt-4o';
+            const apiUrl = process.env.OPENAI_BASE_URL
+                ? `${process.env.OPENAI_BASE_URL.replace(/\/$/, '')}/chat/completions`
+                : undefined;
+            return new OpenAIProvider(process.env.OPENAI_API_KEY, model, apiUrl);
+        }
+        if (process.env.GEMINI_API_KEY) {
+            return new GeminiProvider(process.env.GEMINI_API_KEY);
+        }
+        throw new Error('No AI API Key found in environment variables. Define OPENAI_API_KEY, ANTHROPIC_API_KEY, or GEMINI_API_KEY to execute AI-based refactoring.');
+    }
+}
+//# sourceMappingURL=ai-provider.js.map

package/dist/src/core/agent-runtime/ai-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-provider.js","sourceRoot":"","sources":["../../../../src/core/agent-runtime/ai-provider.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,MAAM,OAAO,cAAc;IACjB,MAAM,CAAS;IACf,KAAK,CAAS;IACd,MAAM,CAAS;IAEvB,YAAY,MAAc,EAAE,QAAgB,QAAQ,EAAE,MAAM,GAAG,4CAA4C;QACzG,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,wBAAwB,CAAC,WAAmB,EAAE,MAAc;QAChE,MAAM,YAAY,GAAG;;mHAE0F,CAAC;QAEhH,MAAM,WAAW,GAAG,GAAG,MAAM,gCAAgC,WAAW,EAAE,CAAC;QAE3E,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE;YACxC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;aACvC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,QAAQ,EAAE;oBACR,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE;oBACzC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE;iBACvC;gBACD,WAAW,EAAE,GAAG;aACjB,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,CAAC,MAAM,MAAM,GAAG,EAAE,CAAC,CAAC;QACnE,CAAC;QAED,MAAM,IAAI,GAAQ,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACxC,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAErD,yDAAyD;QACzD,IAAI,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACzD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAClC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,kCAAkC;YACjD,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,yBAAyB;YACtC,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAED,MAAM,OAAO,iBAAiB;IACpB,MAAM,CAAS;IACf,KAAK,CAAS;IAEtB,YAAY,MAAc,EAAE,QAAgB,4BAA4B;QACtE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,wBAAwB,CAAC,WAAmB,EAAE,MAAc;QAChE,MAAM,YAAY,GAAG,sLAAsL,CAAC;QAC5M,MAAM,WAAW,GAAG,GAAG,MAAM,uBAAuB,WAAW,mBAAmB,CAAC;QAEnF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,uCAAuC,EAAE;YACpE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,WAAW,EAAE,IAAI,CAAC,MAAM;gBACxB,mBAAmB,EAAE,YAAY;aAClC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,MAAM,EAAE,YAAY;gBACpB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;gBAClD,UAAU,EAAE,IAAI;gBAChB,WAAW,EAAE,GAAG;aACjB,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,wBAAwB,QAAQ,CAAC,MAAM,MAAM,GAAG,EAAE,CAAC,CAAC;QACtE,CAAC;QAED,MAAM,IAAI,GAAQ,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACxC,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC1C,IAAI,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACzD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAClC,KAAK,CAAC,KAAK,EAAE,CAAC;YAAC,KAAK,CAAC,GAAG,EAAE,CAAC;YAC3B,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAED,MAAM,OAAO,cAAc;IACjB,MAAM,CAAS;IACf,KAAK,CAAS;IAEtB,YAAY,MAAc,EAAE,QAAgB,kBAAkB;QAC5D,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,wBAAwB,CAAC,WAAmB,EAAE,MAAc;QAChE,MAAM,GAAG,GAAG,2DAA2D,IAAI,CAAC,KAAK,wBAAwB,IAAI,CAAC,MAAM,EAAE,CAAC;QAEvH,MAAM,YAAY,GAAG,0JAA0J,CAAC;QAEhL,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,iBAAiB,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,EAAE;gBACtD,QAAQ,EAAE;oBACR,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,MAAM,wBAAwB,WAAW,EAAE,EAAE,CAAC,EAAE;iBACpF;gBACD,gBAAgB,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE;aACvC,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,CAAC,MAAM,MAAM,GAAG,EAAE,CAAC,CAAC;QACnE,CAAC;QAED,MAAM,IAAI,GAAQ,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACxC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;QACxE,IAAI,OAAO,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;QAE/B,IAAI,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACzD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAClC,KAAK,CAAC,KAAK,EAAE,CAAC;YAAC,KAAK,CAAC,GAAG,EAAE,CAAC;YAC3B,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAED,MAAM,OAAO,oBAAoB;IAC/B,MAAM,CAAC,cAAc;QACnB,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC;YAClC,OAAO,IAAI,iBAAiB,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAC9D,CAAC;QAED,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;YAC/B,wFAAwF;YACxF,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,QAAQ,CAAC;YACxD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe;gBACxC,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,mBAAmB;gBACtE,CAAC,CAAC,SAAS,CAAC;YACd,OAAO,IAAI,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACvE,CAAC;QAED,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;YAC/B,OAAO,IAAI,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACxD,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,4IAA4I,CAAC,CAAC;IAChK,CAAC;CACF"}

package/dist/src/core/agent-runtime/executor.d.ts

@@ -0,0 +1,13 @@
+import { RefactoringPlan } from '@girardelli/architect-core/src/core/types/rules.js';
+export declare class AgentExecutor {
+    private gate;
+    private autoMode;
+    constructor(autoMode?: boolean);
+    /**
+     * Main entrypoint for Agent Runtime.
+     */
+    executePlan(plan: RefactoringPlan): Promise<void>;
+    private executeOperation;
+    private ensureProtectiveBranch;
+    private commitStep;
+}

package/dist/src/core/agent-runtime/executor.js

@@ -0,0 +1,138 @@
+import { writeFileSync, mkdirSync, readFileSync, renameSync, unlinkSync, existsSync } from 'fs';
+import { dirname } from 'path';
+import { execSync } from 'child_process';
+import { HumanGate } from './human-gate.js';
+import { ModelProviderFactory } from './ai-provider.js';
+export class AgentExecutor {
+    gate;
+    // @ts-ignore - Audit cleanup unused variable
+    autoMode;
+    constructor(autoMode = false) {
+        this.autoMode = autoMode;
+        this.gate = new HumanGate(autoMode);
+    }
+    /**
+     * Main entrypoint for Agent Runtime.
+     */
+    async executePlan(plan) {
+        console.log(`\n\x1b[35m=== 🤖 Architect Autonomous Agent ===\x1b[0m`);
+        console.log(`Loaded Refactoring Plan: ${plan.steps.length} procedural steps.\n`);
+        // 1. Mandatory Git Flow Branching
+        this.ensureProtectiveBranch();
+        // 2. Load AI Provider if needed
+        const needsAI = plan.steps.some((s) => !!s.aiPrompt);
+        let aiProvider = null;
+        if (needsAI) {
+            try {
+                aiProvider = ModelProviderFactory.createProvider();
+                console.log(`\x1b[32m[AI Engine Ready]\x1b[0m Linked to external LLM provider.\n`);
+            }
+            catch (e) {
+                console.warn(`\x1b[33m[AI Warning]\x1b[0m Could not connect AI Provider (` + e.message + `). Steps requiring AI will be skipped.\n`);
+            }
+        }
+        // 3. Execution Loop
+        for (const step of plan.steps) {
+            const approved = await this.gate.requestApproval(step);
+            if (!approved) {
+                console.log(`\x1b[90mSkipping step #${step.id}...\x1b[0m\n`);
+                continue;
+            }
+            console.log(`\n\x1b[36mExecuting Step #${step.id}...\x1b[0m`);
+            let successCount = 0;
+            for (const op of step.operations) {
+                try {
+                    await this.executeOperation(op, step.aiPrompt, aiProvider);
+                    successCount++;
+                }
+                catch (e) {
+                    console.error(`\x1b[31mFailed to execute operation on ${op.path}:\x1b[0m ${e.message}`);
+                }
+            }
+            // 4. Atomic Commit per Step
+            if (successCount > 0) {
+                this.commitStep(step);
+            }
+        }
+        this.gate.close();
+        console.log(`\n\x1b[32m=== ✅ Autonomous Execution Complete ===\x1b[0m`);
+        console.log(`Changes are safed in the current feature branch. Review, test, and push to remote!`);
+    }
+    async executeOperation(op, aiPrompt, aiProvider) {
+        const targetPath = op.path;
+        if (op.type === 'CREATE') {
+            if (op.content) {
+                mkdirSync(dirname(targetPath), { recursive: true });
+                writeFileSync(targetPath, op.content, 'utf8');
+                console.log(`  \x1b[32m✔ Created:\x1b[0m ${targetPath}`);
+            }
+        }
+        else if (op.type === 'MOVE' && op.newPath) {
+            if (existsSync(targetPath)) {
+                mkdirSync(dirname(op.newPath), { recursive: true });
+                renameSync(targetPath, op.newPath);
+                console.log(`  \x1b[34m✔ Moved:\x1b[0m ${targetPath} -> ${op.newPath}`);
+            }
+        }
+        else if (op.type === 'DELETE') {
+            if (existsSync(targetPath)) {
+                unlinkSync(targetPath);
+                console.log(`  \x1b[31m✔ Deleted:\x1b[0m ${targetPath}`);
+            }
+        }
+        else if (op.type === 'MODIFY') {
+            if (!existsSync(targetPath)) {
+                throw new Error(`Target file ${targetPath} does not exist`);
+            }
+            const currentContent = readFileSync(targetPath, 'utf8');
+            if (aiPrompt) {
+                if (!aiProvider)
+                    throw new Error('AI Provider not configured, cannot execute prompt');
+                console.log(`  \x1b[35m✨ AI Generating structure for ${targetPath}...\x1b[0m`);
+                const newContent = await aiProvider.executeRefactoringPrompt(currentContent, aiPrompt);
+                writeFileSync(targetPath, newContent, 'utf8');
+                console.log(`  \x1b[33m✔ AI Re-wrote:\x1b[0m ${targetPath}`);
+            }
+            else if (op.content) {
+                // Fallback or exact replacement
+                writeFileSync(targetPath, op.content, 'utf8');
+                console.log(`  \x1b[33m✔ Modified:\x1b[0m ${targetPath}`);
+            }
+        }
+    }
+    ensureProtectiveBranch() {
+        if (process.env.NODE_ENV === 'test')
+            return;
+        try {
+            const currentBranch = execSync('git rev-parse --abbrev-ref HEAD').toString().trim();
+            const needsNewBranch = ['main', 'master', 'develop'].includes(currentBranch);
+            if (needsNewBranch) {
+                const ts = new Date().getTime();
+                const branchName = `feature/architect-refactor-${ts}`;
+                console.log(`\x1b[36m[Git Flow]\x1b[0m Currently on '${currentBranch}'. Creating protective branch \x1b[33m${branchName}\x1b[0m...`);
+                execSync(`git checkout -b ${branchName}`);
+            }
+            else {
+                console.log(`\x1b[32m[Git Flow]\x1b[0m Continuing firmly on non-base branch '${currentBranch}'.`);
+            }
+        }
+        catch (e) {
+            console.warn(`\x1b[33m[Warning]\x1b[0m Git repository not detected or git command failed. Proceeding without branch protection.`);
+        }
+    }
+    commitStep(step) {
+        if (process.env.NODE_ENV === 'test')
+            return;
+        try {
+            execSync('git add .');
+            const msg = `refactor(architect): apply rule ${step.rule}\n\nAuto-applied by Architect Agent.\nMotivation: ${step.title}`;
+            execSync(`git commit -m "${msg}"`);
+            console.log(`  \x1b[32m✔ Git Commit Saved: ${step.rule}\x1b[0m\n`);
+        }
+        catch (e) {
+            // Might happen if there were no actual changes (e.g. content was identical)
+            console.log(`  \x1b[90m(No git changes detected for this step)\x1b[0m\n`);
+        }
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/src/core/agent-runtime/executor.js.map

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

package/dist/src/core/agent-runtime/human-gate.d.ts

@@ -0,0 +1,16 @@
+import { RefactorStep } from '@girardelli/architect-core/src/core/types/rules.js';
+export declare class HumanGate {
+    private rl;
+    private autoMode;
+    constructor(autoMode?: boolean);
+    /**
+     * Request manual approval before applying a refactoring step.
+     * If autoMode is true, it always auto-approves.
+     */
+    requestApproval(step: RefactorStep): Promise<boolean>;
+    /**
+     * Prints the planned operation visually
+     */
+    private printOperation;
+    close(): void;
+}