atabey 0.0.16 → 0.0.18

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

@@ -0,0 +1,34 @@
+/**
+ * [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/atabey/src/modules/engines/agent-loop.js

@@ -0,0 +1,102 @@
+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/atabey/src/modules/engines/agent-loop.js.map

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

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

@@ -0,0 +1,46 @@
+/**
+ * [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/atabey/src/modules/engines/contract-engine.js

@@ -0,0 +1,116 @@
+/**
+ * [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/atabey/src/modules/engines/contract-engine.js.map

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

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

@@ -0,0 +1,64 @@
+/**
+ * [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/atabey/src/modules/engines/crud-governance.js

@@ -0,0 +1,184 @@
+/**
+ * [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/atabey/src/modules/engines/crud-governance.js.map

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

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

@@ -0,0 +1,42 @@
+/**
+ * [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[];
+}