atabey 0.0.17 → 0.0.19

package/dist/src/modules/engines/agent-loop.d.ts

@@ -1,34 +0,0 @@
-/**
- * [ENGINE] AgentLoop — Real-time Hermes Message Consumer
- *
- * Runs as a background loop polling and consuming DELEGATION messages from the
- * Hermes queue and forwarding them to agents for acknowledgment.
- *
- * Acts as a message-polling and workflow enforcer, ensuring task messages are
- * routed to their designated target agents, which then get processed by the AI client interface.
- *
- * v0.0.14: First real implementation. Agents are now reliably acknowledged and routed.
- */
-export declare class AgentLoop {
-    private static loopHandle;
-    private static running;
-    /**
-     * Start the agent dispatch loop.
-     * @param activeAgents - Agent names to process (empty = all registered agents)
-     * @param intervalMs   - Poll interval in milliseconds (default: 1000ms)
-     */
-    static start(activeAgents?: string[], intervalMs?: number): void;
-    /**
-     * Stop the agent dispatch loop gracefully.
-     */
-    static stop(): void;
-    /**
-     * Returns whether the loop is currently running.
-     */
-    static isRunning(): boolean;
-    /**
-     * Single dispatch cycle — reads pending DELEGATION messages and executes them.
-     * Marks each message as PROCESSED immediately to prevent duplicate dispatch.
-     */
-    private static processDelegations;
-}

package/dist/src/modules/engines/agent-loop.js

@@ -1,102 +0,0 @@
-import { logger } from "../../shared/logger.js";
-import { AtabeyStorage } from "../../shared/storage.js";
-import { AgentExecutor } from "./agent-executor.js";
-/**
- * [ENGINE] AgentLoop — Real-time Hermes Message Consumer
- *
- * Runs as a background loop polling and consuming DELEGATION messages from the
- * Hermes queue and forwarding them to agents for acknowledgment.
- *
- * Acts as a message-polling and workflow enforcer, ensuring task messages are
- * routed to their designated target agents, which then get processed by the AI client interface.
- *
- * v0.0.14: First real implementation. Agents are now reliably acknowledged and routed.
- */
-export class AgentLoop {
-    static loopHandle = null;
-    static running = false;
-    /**
-     * Start the agent dispatch loop.
-     * @param activeAgents - Agent names to process (empty = all registered agents)
-     * @param intervalMs   - Poll interval in milliseconds (default: 1000ms)
-     */
-    static start(activeAgents = [], intervalMs = 1000) {
-        if (this.running) {
-            logger.warn("[AGENT_LOOP] Loop already running. Ignoring duplicate start.");
-            return;
-        }
-        this.running = true;
-        logger.info(`[AGENT_LOOP] Starting. Active agents: ${activeAgents.length === 0 ? "all" : activeAgents.join(", ")} | Interval: ${intervalMs}ms`);
-        this.loopHandle = setInterval(() => {
-            this.processDelegations(activeAgents).catch((err) => {
-                logger.error("[AGENT_LOOP] Error in dispatch cycle", {
-                    error: err.message,
-                });
-            });
-        }, intervalMs);
-    }
-    /**
-     * Stop the agent dispatch loop gracefully.
-     */
-    static stop() {
-        if (this.loopHandle) {
-            clearInterval(this.loopHandle);
-            this.loopHandle = null;
-        }
-        this.running = false;
-        logger.info("[AGENT_LOOP] Stopped.");
-    }
-    /**
-     * Returns whether the loop is currently running.
-     */
-    static isRunning() {
-        return this.running;
-    }
-    /**
-     * Single dispatch cycle — reads pending DELEGATION messages and executes them.
-     * Marks each message as PROCESSED immediately to prevent duplicate dispatch.
-     */
-    static async processDelegations(activeAgents) {
-        const pendingMessages = AtabeyStorage.getPendingMessages();
-        const delegations = pendingMessages.filter(m => m.category === "DELEGATION" && m.status === "PENDING");
-        if (delegations.length === 0)
-            return;
-        logger.debug(`[AGENT_LOOP] Processing ${delegations.length} pending DELEGATION(s)`);
-        for (const msg of delegations) {
-            const rawTarget = String(msg.to);
-            const agentName = rawTarget.startsWith("@") ? rawTarget : `@${rawTarget}`;
-            // If activeAgents is specified, only process those agents
-            if (activeAgents.length > 0 && !activeAgents.includes(agentName)) {
-                continue;
-            }
-            // Mark as PROCESSED immediately to prevent duplicate processing
-            if (msg.id !== undefined) {
-                AtabeyStorage.updateMessageStatus(msg.id, "PROCESSED");
-            }
-            // Parse task from message content (may be JSON or plain text)
-            let taskDescription = msg.content;
-            try {
-                const parsed = JSON.parse(msg.content);
-                if (parsed.task)
-                    taskDescription = parsed.task;
-            }
-            catch {
-                // Content is plain text task description — use as-is
-            }
-            logger.info(`[AGENT_LOOP] Dispatching → ${agentName}`, {
-                traceId: String(msg.traceId),
-                task: taskDescription.substring(0, 80),
-            });
-            try {
-                await AgentExecutor.executeForAgent(agentName, taskDescription, String(msg.traceId));
-            }
-            catch (err) {
-                logger.error(`[AGENT_LOOP] Failed to execute task for ${agentName}`, {
-                    error: err.message,
-                    traceId: String(msg.traceId),
-                });
-            }
-        }
-    }
-}
-//# sourceMappingURL=agent-loop.js.map

package/dist/src/modules/engines/agent-loop.js.map

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

package/dist/src/modules/engines/contract-engine.d.ts

@@ -1,46 +0,0 @@
-/**
- * [ENGINE] Contract Engine — API Versioning & Contract-First Enforcement
- *
- * Implements:
- * - API Versioning Strategy: /api/v1/... URL versioning, contract.version.json
- * - Contract-First: atabey verify-contract, contract_hash validation, auto-rollback
- */
-export interface ContractVersion {
-    version: string;
-    lastUpdated: string;
-    contractHash: string;
-    breakingChanges: Array<{
-        version: string;
-        description: string;
-    }>;
-    deprecatedVersions: string[];
-}
-export declare class ContractEngine {
-    private static readonly CONTRACT_FILE;
-    /**
-     * Loads the contract.version.json file.
-     */
-    static loadContract(projectRoot: string): ContractVersion | null;
-    /**
-     * Computes SHA-256 hash of all shared type files in src/contracts or src/shared/types.
-     */
-    static computeHash(projectRoot: string): string;
-    /**
-     * Verifies contract integrity. If hash changed, auto-triggers rollback.
-     */
-    static verifyContract(projectRoot: string): Promise<{
-        valid: boolean;
-        hash: string;
-        previousHash: string;
-        message: string;
-    }>;
-    /**
-     * Updates contract.version.json with current hash.
-     */
-    static updateContract(projectRoot: string, breaking: boolean): Promise<ContractVersion>;
-    /**
-     * Validates that work is allowed in current phase before writing contracts.
-     */
-    static validatePhaseForContract(workDescription: string): boolean;
-    private static bumpVersion;
-}

package/dist/src/modules/engines/contract-engine.js

@@ -1,116 +0,0 @@
-/**
- * [ENGINE] Contract Engine — API Versioning & Contract-First Enforcement
- *
- * Implements:
- * - API Versioning Strategy: /api/v1/... URL versioning, contract.version.json
- * - Contract-First: atabey verify-contract, contract_hash validation, auto-rollback
- */
-import crypto from "crypto";
-import fs from "fs";
-import path from "path";
-import { logger } from "../../shared/logger.js";
-import { AtabeyStorage } from "../../shared/storage.js";
-import { PhaseEngine } from "./phase-engine.js";
-export class ContractEngine {
-    static CONTRACT_FILE = "contract.version.json";
-    /**
-     * Loads the contract.version.json file.
-     */
-    static loadContract(projectRoot) {
-        const contractPath = path.join(projectRoot, ContractEngine.CONTRACT_FILE);
-        if (!fs.existsSync(contractPath))
-            return null;
-        try {
-            return JSON.parse(fs.readFileSync(contractPath, "utf8"));
-        }
-        catch {
-            return null;
-        }
-    }
-    /**
-     * Computes SHA-256 hash of all shared type files in src/contracts or src/shared/types.
-     */
-    static computeHash(projectRoot) {
-        const hash = crypto.createHash("sha256");
-        const dirs = ["src/contracts", "src/shared/types", "src/types", "apps/backend/src/types"];
-        for (const dir of dirs) {
-            const fullPath = path.join(projectRoot, dir);
-            if (fs.existsSync(fullPath)) {
-                const files = fs.readdirSync(fullPath).filter(f => f.endsWith(".ts"));
-                for (const file of files.sort()) {
-                    const content = fs.readFileSync(path.join(fullPath, file), "utf8");
-                    hash.update(content);
-                }
-            }
-        }
-        return hash.digest("hex").substring(0, 16);
-    }
-    /**
-     * Verifies contract integrity. If hash changed, auto-triggers rollback.
-     */
-    static async verifyContract(projectRoot) {
-        const contract = ContractEngine.loadContract(projectRoot);
-        const currentHash = ContractEngine.computeHash(projectRoot);
-        if (!contract) {
-            return { valid: false, hash: currentHash, previousHash: "", message: "contract.version.json not found. Create one with `atabey verify-contract --init`." };
-        }
-        const previousHash = contract.contractHash;
-        const valid = currentHash === previousHash;
-        if (!valid) {
-            logger.warn(`[CONTRACT] Hash mismatch: ${previousHash} → ${currentHash}. Contracts changed!`);
-            await PhaseEngine.detectBrokenContracts("@contract-engine");
-            AtabeyStorage.saveLog({
-                agent: "@architect",
-                action: "CONTRACT_HASH_MISMATCH",
-                trace_id: AtabeyStorage.getMetadata("traceId") || "N/A",
-                status: "FAILED",
-                summary: `Contract hash changed: ${previousHash} → ${currentHash}. Rollback triggered.`
-            });
-        }
-        return { valid, hash: currentHash, previousHash, message: valid ? "Contracts valid." : "Contract hash mismatch! Run rollback." };
-    }
-    /**
-     * Updates contract.version.json with current hash.
-     */
-    static async updateContract(projectRoot, breaking) {
-        const existing = ContractEngine.loadContract(projectRoot);
-        const newHash = ContractEngine.computeHash(projectRoot);
-        const contract = {
-            version: existing ? ContractEngine.bumpVersion(existing.version, breaking) : "1.0",
-            lastUpdated: new Date().toISOString(),
-            contractHash: newHash,
-            breakingChanges: existing?.breakingChanges || [],
-            deprecatedVersions: existing?.deprecatedVersions || [],
-        };
-        if (breaking) {
-            contract.breakingChanges.push({ version: contract.version, description: "Breaking change" });
-        }
-        fs.writeFileSync(path.join(projectRoot, ContractEngine.CONTRACT_FILE), JSON.stringify(contract, null, 2));
-        AtabeyStorage.saveLog({
-            agent: "@architect",
-            action: "CONTRACT_UPDATED",
-            trace_id: AtabeyStorage.getMetadata("traceId") || "N/A",
-            status: "SUCCESS",
-            summary: `Contract updated to v${contract.version} (hash: ${newHash})`
-        });
-        return contract;
-    }
-    /**
-     * Validates that work is allowed in current phase before writing contracts.
-     */
-    static validatePhaseForContract(workDescription) {
-        const phase = PhaseEngine.getCurrentPhase();
-        if (phase === "PHASE_0" || phase === "PHASE_3" || phase === "PHASE_4") {
-            logger.warn(`[CONTRACT] Phase ${phase} does not allow contract changes: ${workDescription}`);
-            return false;
-        }
-        return true;
-    }
-    static bumpVersion(current, breaking) {
-        const [major, minor] = current.split(".").map(Number);
-        if (breaking)
-            return `${major + 1}.0`;
-        return `${major}.${minor + 1}`;
-    }
-}
-//# sourceMappingURL=contract-engine.js.map

package/dist/src/modules/engines/contract-engine.js.map

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

package/dist/src/modules/engines/crud-governance.d.ts

@@ -1,64 +0,0 @@
-/**
- * [GOV] CRUD Governance Engine — Enterprise Administrative Operation Gate
- *
- * Implements the CRUD governance standards from templates/standards/crud-governance.md.
- * Prevents specialist agents from performing high-risk operations autonomously.
- *
- * High-risk operations requiring @manager + human approval:
- * 1. Database schema changes (DDL)
- * 2. Bulk data deletion/purge
- * 3. User authorization/role changes
- * 4. Payment/billing integrations
- * 5. PII export
- * 6. Environment variable/secret changes
- * 7. Production deployment
- * 8. Force-push to shared branches
- */
-export type HighRiskOperation = "SCHEMA_CHANGE" | "BULK_DELETE" | "ROLE_CHANGE" | "BILLING_CHANGE" | "PII_EXPORT" | "ENV_CHANGE" | "PRODUCTION_DEPLOY" | "FORCE_PUSH";
-export interface HighRiskRequest {
-    operation: HighRiskOperation;
-    agent: string;
-    description: string;
-    traceId: string;
-    target?: string;
-    reason: string;
-}
-export interface GovernanceDecision {
-    allowed: boolean;
-    requiresApproval: boolean;
-    reason: string;
-    escalatedTo: string | null;
-}
-/**
- * CRUD Governance — enforces the enterprise administrative operation policy.
- *
- * Flow:
- * 1. Agent requests a high-risk operation
- * 2. GovernanceEngine checks if the agent is authorized
- * 3. Unauthorized → escalates to @manager, sets requiresApproval=true
- * 4. @manager reviews → if approved → human approval via `atabey approve`
- * 5. Only after human approval → operation proceeds
- */
-export declare class GovernanceEngine {
-    private static AUTHORIZED_AGENTS;
-    private static OPERATION_RISK;
-    /**
-     * Evaluates whether an agent is allowed to perform a high-risk operation.
-     * If unauthorized, escalates to @manager and requires human approval.
-     */
-    static evaluate(agent: string, operation: HighRiskOperation, description: string, traceId: string): Promise<GovernanceDecision>;
-    /**
-     * Approves a previously escalated high-risk operation.
-     * Called by `atabey approve <traceId>` CLI command.
-     */
-    static approve(operation: HighRiskOperation, traceId: string): Promise<boolean>;
-    /**
-     * Rejects a previously escalated high-risk operation.
-     */
-    static reject(operation: HighRiskOperation, traceId: string, reason?: string): Promise<boolean>;
-    /**
-     * Detects high-risk operations from a natural language task description.
-     * Uses keyword matching to classify the operation type.
-     */
-    static classifyTask(task: string): HighRiskOperation | null;
-}

package/dist/src/modules/engines/crud-governance.js

@@ -1,184 +0,0 @@
-/**
- * [GOV] CRUD Governance Engine — Enterprise Administrative Operation Gate
- *
- * Implements the CRUD governance standards from templates/standards/crud-governance.md.
- * Prevents specialist agents from performing high-risk operations autonomously.
- *
- * High-risk operations requiring @manager + human approval:
- * 1. Database schema changes (DDL)
- * 2. Bulk data deletion/purge
- * 3. User authorization/role changes
- * 4. Payment/billing integrations
- * 5. PII export
- * 6. Environment variable/secret changes
- * 7. Production deployment
- * 8. Force-push to shared branches
- */
-import { logger } from "../../shared/logger.js";
-import { AtabeyStorage } from "../../shared/storage.js";
-import { asAgentID, asTraceID } from "../../shared/types.js";
-/**
- * CRUD Governance — enforces the enterprise administrative operation policy.
- *
- * Flow:
- * 1. Agent requests a high-risk operation
- * 2. GovernanceEngine checks if the agent is authorized
- * 3. Unauthorized → escalates to @manager, sets requiresApproval=true
- * 4. @manager reviews → if approved → human approval via `atabey approve`
- * 5. Only after human approval → operation proceeds
- */
-export class GovernanceEngine {
-    // Agents authorized to perform each operation type
-    static AUTHORIZED_AGENTS = {
-        SCHEMA_CHANGE: ["@manager", "@database", "@architect"],
-        BULK_DELETE: ["@manager"],
-        ROLE_CHANGE: ["@manager"],
-        BILLING_CHANGE: ["@manager"],
-        PII_EXPORT: ["@manager", "@security"],
-        ENV_CHANGE: ["@manager", "@devops"],
-        PRODUCTION_DEPLOY: ["@manager", "@devops"],
-        FORCE_PUSH: ["@manager", "@git"],
-    };
-    // Risk weight for each operation (used by RiskEngine)
-    static OPERATION_RISK = {
-        SCHEMA_CHANGE: 70,
-        BULK_DELETE: 90,
-        ROLE_CHANGE: 80,
-        BILLING_CHANGE: 85,
-        PII_EXPORT: 95,
-        ENV_CHANGE: 75,
-        PRODUCTION_DEPLOY: 80,
-        FORCE_PUSH: 60,
-    };
-    /**
-     * Evaluates whether an agent is allowed to perform a high-risk operation.
-     * If unauthorized, escalates to @manager and requires human approval.
-     */
-    static async evaluate(agent, operation, description, traceId) {
-        const normalizedAgent = agent.startsWith("@") ? agent : `@${agent}`;
-        const authorizedAgents = GovernanceEngine.AUTHORIZED_AGENTS[operation];
-        // Check if agent is authorized
-        if (!authorizedAgents.includes(normalizedAgent)) {
-            const escalationMsg = `[GOV] ${normalizedAgent} attempted ${operation} — UNAUTHORIZED. Escalated to @manager.`;
-            logger.warn(escalationMsg);
-            // Log the violation
-            AtabeyStorage.saveLog({
-                agent: normalizedAgent.replace("@", ""),
-                action: "GOVERNANCE_VIOLATION",
-                trace_id: traceId,
-                status: "BLOCKED",
-                summary: `${normalizedAgent} attempted unauthorized ${operation}: ${description}`
-            });
-            // Escalate to @manager via Hermes
-            AtabeyStorage.saveMessage({
-                from: asAgentID(normalizedAgent),
-                to: asAgentID("@manager"),
-                category: "ALERT",
-                content: `[GOVERNANCE] High-risk operation ${operation} requested by ${normalizedAgent}: ${description}. Requires your review and human approval.`,
-                traceId: asTraceID(traceId),
-                timestamp: new Date().toISOString(),
-                status: "PENDING",
-                priority: "HIGH",
-                requiresApproval: true,
-            });
-            return {
-                allowed: false,
-                requiresApproval: true,
-                reason: `${normalizedAgent} is not authorized for ${operation}. Escalated to @manager. Human approval required.`,
-                escalatedTo: "@manager",
-            };
-        }
-        // Authorized but still high-risk — requires human approval
-        const riskScore = GovernanceEngine.OPERATION_RISK[operation];
-        AtabeyStorage.saveLog({
-            agent: normalizedAgent.replace("@", ""),
-            action: "GOVERNANCE_APPROVAL_REQUIRED",
-            trace_id: traceId,
-            status: "PENDING",
-            summary: `${normalizedAgent} requested ${operation} (risk: ${riskScore}). Human approval required.`
-        });
-        // Send approval request to @manager
-        AtabeyStorage.saveMessage({
-            from: asAgentID(normalizedAgent),
-            to: asAgentID("@manager"),
-            category: "ACTION",
-            content: `[APPROVAL REQUIRED] ${operation}: ${description} (risk score: ${riskScore}). Agent: ${normalizedAgent}`,
-            traceId: asTraceID(traceId),
-            timestamp: new Date().toISOString(),
-            status: "PENDING",
-            priority: "HIGH",
-            requiresApproval: true,
-        });
-        return {
-            allowed: false,
-            requiresApproval: true,
-            reason: `${operation} requires human approval (risk score: ${riskScore}). Approval request sent to @manager.`,
-            escalatedTo: "@manager",
-        };
-    }
-    /**
-     * Approves a previously escalated high-risk operation.
-     * Called by `atabey approve <traceId>` CLI command.
-     */
-    static async approve(operation, traceId) {
-        logger.info(`[GOV] Operation ${operation} approved for trace ${traceId}`);
-        AtabeyStorage.saveLog({
-            agent: "@human",
-            action: "GOVERNANCE_APPROVED",
-            trace_id: traceId,
-            status: "SUCCESS",
-            summary: `Human approved ${operation} for trace ${traceId}`
-        });
-        return true;
-    }
-    /**
-     * Rejects a previously escalated high-risk operation.
-     */
-    static async reject(operation, traceId, reason) {
-        logger.warn(`[GOV] Operation ${operation} REJECTED for trace ${traceId}: ${reason || "No reason given"}`);
-        AtabeyStorage.saveLog({
-            agent: "@human",
-            action: "GOVERNANCE_REJECTED",
-            trace_id: traceId,
-            status: "FAILED",
-            summary: `Human rejected ${operation} for trace ${traceId}: ${reason || "No reason"}`
-        });
-        return false;
-    }
-    /**
-     * Detects high-risk operations from a natural language task description.
-     * Uses keyword matching to classify the operation type.
-     */
-    static classifyTask(task) {
-        const lower = task.toLowerCase();
-        if (/\b(drop|truncate|alter|create\s+table|migration|schema)\b/i.test(task) &&
-            /\b(database|table|column|index)\b/i.test(lower)) {
-            return "SCHEMA_CHANGE";
-        }
-        if (/\b(delete\s+all|purge\s+all|bulk\s+delete|clear\s+all|truncate)\b/i.test(task)) {
-            return "BULK_DELETE";
-        }
-        if (/\b(role|permission|authorization|user\s+role|admin)\b/i.test(task) &&
-            /\b(change|modify|update|create|delete|assign)\b/i.test(lower)) {
-            return "ROLE_CHANGE";
-        }
-        if (/\b(billing|payment|invoice|subscription|pricing)\b/i.test(task)) {
-            return "BILLING_CHANGE";
-        }
-        if (/\b(pii|personal\s+data|export\s+user|gdpr|kvkk|privacy)\b/i.test(task)) {
-            return "PII_EXPORT";
-        }
-        if (/\b(environment|env\s+var|secret|api\s+key)\b/i.test(task) &&
-            /\b(change|update|modify|rotate|set)\b/i.test(lower)) {
-            return "ENV_CHANGE";
-        }
-        if (/\b(deploy|release|production|prod)\b/i.test(task)) {
-            return "PRODUCTION_DEPLOY";
-        }
-        if (/\b(force\s+push|rewrite\s+history|git\s+push\s+--force)\b/i.test(task)) {
-            return "FORCE_PUSH";
-        }
-        return null;
-    }
-}
-//# sourceMappingURL=crud-governance.js.map

package/dist/src/modules/engines/crud-governance.js.map

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

package/dist/src/modules/engines/discovery-engine.d.ts

@@ -1,42 +0,0 @@
-/**
- * [ENGINE] Architecture Discovery Protocol (ADP)
- *
- * Implements the ADP from ATABEY_FULL.md:
- * 1. Entry Point Hunt — find main entry points (index.ts, main.ts, server.ts)
- * 2. Business Logic Mapping — search for service/repository/controller patterns
- * 3. Contract Analysis — locate type definitions and API schemas
- * 4. Adaptive Scaffolding — propose architectural improvements before coding
- */
-export interface DiscoveryResult {
-    entryPoints: string[];
-    businessLogic: string[];
-    contracts: string[];
-    architecture: string;
-    recommendations: string[];
-}
-export declare class DiscoveryEngine {
-    /**
-     * Runs the full Architecture Discovery Protocol on a project.
-     */
-    static discover(projectRoot: string): Promise<DiscoveryResult>;
-    /**
-     * Step 1: Entry Point Hunt — find main entry points.
-     */
-    static findEntryPoints(projectRoot: string): string[];
-    /**
-     * Step 2: Business Logic Mapping — find service/repository/controller patterns.
-     */
-    static mapBusinessLogic(projectRoot: string): string[];
-    /**
-     * Step 3: Contract Analysis — find type definitions and API schemas.
-     */
-    static analyzeContracts(projectRoot: string): string[];
-    /**
-     * Detects the project architecture type.
-     */
-    static detectArchitecture(projectRoot: string): string;
-    /**
-     * Generates recommendations based on discovery results.
-     */
-    static generateRecommendations(entryPoints: string[], businessLogic: string[], contracts: string[], architecture: string): string[];
-}