@yuaone/core 0.2.0 → 0.3.0

package/dist/execution-policy-engine.js

@@ -0,0 +1,367 @@
+/**
+ * @module execution-policy-engine
+ * @description 실행 정책 엔진 — `.yuan/policy.json` 또는 YUAN.md에서 정책을 로드하여
+ * 에이전트의 모든 모듈을 단일 소스에서 구성.
+ *
+ * 로드 순서: DEFAULT_POLICY → .yuan/policy.json → YUAN.md 오버라이드
+ */
+import { readFile, writeFile, mkdir, rename, access, constants } from "node:fs/promises";
+import path from "node:path";
+// ─── Defaults ───
+export const DEFAULT_POLICY = {
+    planning: {
+        enabled: true,
+        threshold: "moderate",
+        maxDepth: 3,
+        autoReplan: true,
+    },
+    speculation: {
+        enabled: false,
+        maxApproaches: 3,
+        minComplexity: "complex",
+    },
+    debate: {
+        enabled: false,
+        rounds: 3,
+        roles: ["coder", "reviewer", "verifier"],
+        minComplexity: "moderate",
+    },
+    verification: {
+        depth: "standard",
+        strictness: 0.7,
+        autoTest: false,
+        autoBuild: true,
+        autoLint: true,
+    },
+    cost: {
+        maxTokensPerSession: 500_000,
+        maxTokensPerIteration: 50_000,
+        budgetPerRole: {},
+        preferredModel: "standard",
+    },
+    safety: {
+        sandboxTier: 2,
+        approvalLevel: "dangerous",
+        blockedCommands: ["rm -rf /", "sudo", "mkfs", "dd if=", ":(){:|:&};:"],
+        blockedPaths: ["/etc", "/usr", "/bin", "/sbin", "/boot", "/sys", "/proc"],
+        secretDetection: true,
+    },
+    recovery: {
+        maxRetries: 3,
+        maxStrategySwitches: 3,
+        enableRollback: true,
+        enableScopeReduce: true,
+        escalateThreshold: 2,
+    },
+    memory: {
+        enabled: true,
+        autoSavelearnings: true,
+        checkpointThreshold: 0.8,
+        maxCheckpoints: 5,
+    },
+    mcp: {
+        enabled: false,
+        servers: [],
+    },
+};
+// ─── Utilities ───
+const VALID_THRESHOLDS = new Set(["simple", "moderate", "complex"]);
+const VALID_COMPLEXITY = new Set(["moderate", "complex", "massive"]);
+const VALID_DEPTH = new Set(["shallow", "standard", "deep"]);
+const VALID_APPROVAL = new Set(["none", "dangerous", "all"]);
+/** Deep merge: source values override target. Arrays are replaced, not concatenated. */
+function deepMerge(target, source) {
+    const result = { ...target };
+    for (const key of Object.keys(source)) {
+        const srcVal = source[key];
+        const tgtVal = target[key];
+        if (srcVal !== null &&
+            srcVal !== undefined &&
+            typeof srcVal === "object" &&
+            !Array.isArray(srcVal) &&
+            typeof tgtVal === "object" &&
+            !Array.isArray(tgtVal) &&
+            tgtVal !== null) {
+            result[key] = deepMerge(tgtVal, srcVal);
+        }
+        else if (srcVal !== undefined) {
+            result[key] = srcVal;
+        }
+    }
+    return result;
+}
+/** Set a nested value using dot-notation path (e.g. "safety.sandboxTier"). */
+function setNestedValue(obj, dotPath, value) {
+    const parts = dotPath.split(".");
+    let current = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const part = parts[i];
+        if (typeof current[part] !== "object" || current[part] === null) {
+            current[part] = {};
+        }
+        current = current[part];
+    }
+    const lastKey = parts[parts.length - 1];
+    current[lastKey] = value;
+}
+/** Coerce a string value to the appropriate JS type. */
+function coerceValue(raw) {
+    const trimmed = raw.trim();
+    if (trimmed === "true")
+        return true;
+    if (trimmed === "false")
+        return false;
+    if (/^-?\d+$/.test(trimmed))
+        return parseInt(trimmed, 10);
+    if (/^-?\d+\.\d+$/.test(trimmed))
+        return parseFloat(trimmed);
+    // Strip quotes if present
+    if ((trimmed.startsWith('"') && trimmed.endsWith('"')) ||
+        (trimmed.startsWith("'") && trimmed.endsWith("'"))) {
+        return trimmed.slice(1, -1);
+    }
+    return trimmed;
+}
+// ─── Engine ───
+export class ExecutionPolicyEngine {
+    policy;
+    source;
+    projectPath;
+    constructor(projectPath) {
+        this.projectPath = projectPath;
+        this.policy = structuredClone(DEFAULT_POLICY);
+        this.source = { type: "default", loadedAt: new Date().toISOString() };
+    }
+    /**
+     * Load policy: DEFAULT → .yuan/policy.json → YUAN.md overrides.
+     */
+    async load() {
+        let merged = structuredClone(DEFAULT_POLICY);
+        let sourceType = "default";
+        let sourcePath;
+        // 1. Try .yuan/policy.json
+        const policyJsonPath = path.join(this.projectPath, ".yuan", "policy.json");
+        try {
+            await access(policyJsonPath, constants.R_OK);
+            const raw = await readFile(policyJsonPath, "utf-8");
+            const parsed = JSON.parse(raw);
+            merged = deepMerge(merged, parsed);
+            sourceType = "file";
+            sourcePath = policyJsonPath;
+        }
+        catch {
+            // No policy.json — continue with defaults
+        }
+        // 2. Try YUAN.md overrides
+        const yuanMdPath = path.join(this.projectPath, "YUAN.md");
+        try {
+            await access(yuanMdPath, constants.R_OK);
+            const md = await readFile(yuanMdPath, "utf-8");
+            const overrides = this.parseYuanMd(md);
+            if (Object.keys(overrides).length > 0) {
+                merged = deepMerge(merged, overrides);
+                if (sourceType === "default") {
+                    sourceType = "yuanmd";
+                    sourcePath = yuanMdPath;
+                }
+            }
+        }
+        catch {
+            // No YUAN.md — continue
+        }
+        // 3. Validate & store
+        const { valid, errors } = ExecutionPolicyEngine.validate(merged);
+        if (!valid) {
+            throw new Error(`Invalid execution policy:\n${errors.join("\n")}`);
+        }
+        this.policy = merged;
+        this.source = {
+            type: sourceType,
+            path: sourcePath,
+            loadedAt: new Date().toISOString(),
+        };
+        return this.policy;
+    }
+    /** Get the full current policy. */
+    getPolicy() {
+        return this.policy;
+    }
+    /** Get a specific policy section. */
+    get(section) {
+        return this.policy[section];
+    }
+    /** Override a section at runtime (in-memory only, call save() to persist). */
+    override(section, values) {
+        this.policy[section] = {
+            ...this.policy[section],
+            ...values,
+        };
+    }
+    /** Save current policy to .yuan/policy.json (atomic write via tmp + rename). */
+    async save() {
+        const dir = path.join(this.projectPath, ".yuan");
+        await mkdir(dir, { recursive: true });
+        const target = path.join(dir, "policy.json");
+        const tmp = path.join(dir, `policy.json.tmp.${Date.now()}`);
+        const content = JSON.stringify(this.policy, null, 2) + "\n";
+        await writeFile(tmp, content, "utf-8");
+        await rename(tmp, target);
+        this.source = {
+            type: "file",
+            path: target,
+            loadedAt: new Date().toISOString(),
+        };
+    }
+    /** Get info about where the policy was loaded from. */
+    getSource() {
+        return this.source;
+    }
+    // ─── Static helpers ───
+    /** Merge a partial policy with defaults. */
+    static mergeWithDefaults(partial) {
+        return deepMerge(structuredClone(DEFAULT_POLICY), partial);
+    }
+    /** Validate policy values (ranges, enums). Returns all errors, not just the first. */
+    static validate(policy) {
+        const errors = [];
+        // planning
+        if (!VALID_THRESHOLDS.has(policy.planning.threshold)) {
+            errors.push(`planning.threshold must be one of: ${[...VALID_THRESHOLDS].join(", ")} (got "${policy.planning.threshold}")`);
+        }
+        if (policy.planning.maxDepth < 1) {
+            errors.push(`planning.maxDepth must be >= 1 (got ${policy.planning.maxDepth})`);
+        }
+        // speculation
+        if (!VALID_COMPLEXITY.has(policy.speculation.minComplexity)) {
+            errors.push(`speculation.minComplexity must be one of: ${[...VALID_COMPLEXITY].join(", ")} (got "${policy.speculation.minComplexity}")`);
+        }
+        // debate
+        if (!VALID_COMPLEXITY.has(policy.debate.minComplexity)) {
+            errors.push(`debate.minComplexity must be one of: ${[...VALID_COMPLEXITY].join(", ")} (got "${policy.debate.minComplexity}")`);
+        }
+        if (policy.debate.rounds < 1) {
+            errors.push(`debate.rounds must be >= 1 (got ${policy.debate.rounds})`);
+        }
+        // verification
+        if (!VALID_DEPTH.has(policy.verification.depth)) {
+            errors.push(`verification.depth must be one of: ${[...VALID_DEPTH].join(", ")} (got "${policy.verification.depth}")`);
+        }
+        if (policy.verification.strictness < 0 || policy.verification.strictness > 1) {
+            errors.push(`verification.strictness must be 0-1 (got ${policy.verification.strictness})`);
+        }
+        // cost
+        if (policy.cost.maxTokensPerSession <= 0) {
+            errors.push(`cost.maxTokensPerSession must be > 0 (got ${policy.cost.maxTokensPerSession})`);
+        }
+        if (policy.cost.maxTokensPerIteration <= 0) {
+            errors.push(`cost.maxTokensPerIteration must be > 0 (got ${policy.cost.maxTokensPerIteration})`);
+        }
+        // safety
+        if (policy.safety.sandboxTier < 0 || policy.safety.sandboxTier > 3) {
+            errors.push(`safety.sandboxTier must be 0-3 (got ${policy.safety.sandboxTier})`);
+        }
+        if (!VALID_APPROVAL.has(policy.safety.approvalLevel)) {
+            errors.push(`safety.approvalLevel must be one of: ${[...VALID_APPROVAL].join(", ")} (got "${policy.safety.approvalLevel}")`);
+        }
+        // recovery
+        if (policy.recovery.maxRetries < 0) {
+            errors.push(`recovery.maxRetries must be >= 0 (got ${policy.recovery.maxRetries})`);
+        }
+        if (policy.recovery.escalateThreshold < 0) {
+            errors.push(`recovery.escalateThreshold must be >= 0 (got ${policy.recovery.escalateThreshold})`);
+        }
+        // memory
+        if (policy.memory.checkpointThreshold < 0 || policy.memory.checkpointThreshold > 1) {
+            errors.push(`memory.checkpointThreshold must be 0-1 (got ${policy.memory.checkpointThreshold})`);
+        }
+        if (policy.memory.maxCheckpoints < 1) {
+            errors.push(`memory.maxCheckpoints must be >= 1 (got ${policy.memory.maxCheckpoints})`);
+        }
+        return { valid: errors.length === 0, errors };
+    }
+    // ─── Conversion methods ───
+    /** Convert policy → GovernorConfig shape. */
+    toGovernorConfig() {
+        return {
+            planTier: this.policy.cost.preferredModel,
+            customLimits: {
+                tokensPerRequest: this.policy.cost.maxTokensPerIteration,
+                maxIterations: Math.ceil(this.policy.cost.maxTokensPerSession / this.policy.cost.maxTokensPerIteration),
+            },
+        };
+    }
+    /** Convert policy → AutoFixConfig shape. */
+    toAutoFixConfig() {
+        return {
+            maxRetries: this.policy.recovery.maxRetries,
+            autoLint: this.policy.verification.autoLint,
+            autoTest: this.policy.verification.autoTest,
+            autoBuild: this.policy.verification.autoBuild,
+        };
+    }
+    /** Convert policy → failure recovery config. */
+    toFailureRecoveryConfig() {
+        return {
+            maxStrategySwitches: this.policy.recovery.maxStrategySwitches,
+            enableRollback: this.policy.recovery.enableRollback,
+            enableScopeReduce: this.policy.recovery.enableScopeReduce,
+            escalateThreshold: this.policy.recovery.escalateThreshold,
+        };
+    }
+    /** Convert policy → ContextManagerConfig shape. */
+    toContextManagerConfig() {
+        return {
+            maxContextTokens: this.policy.cost.maxTokensPerSession,
+        };
+    }
+    /** Convert policy → ExecutionEngineConfig shape (general-purpose). */
+    toExecutionEngineConfig() {
+        return {
+            planning: this.policy.planning,
+            speculation: this.policy.speculation,
+            debate: this.policy.debate,
+            verification: this.policy.verification,
+            safety: {
+                sandboxTier: this.policy.safety.sandboxTier,
+                approvalLevel: this.policy.safety.approvalLevel,
+                secretDetection: this.policy.safety.secretDetection,
+            },
+            memory: this.policy.memory,
+            mcp: this.policy.mcp,
+        };
+    }
+    // ─── Private ───
+    /**
+     * Parse YUAN.md for policy overrides.
+     * Looks for a `## Policy` or `## Configuration` section, then extracts
+     * lines matching `- dotted.key: value`.
+     */
+    parseYuanMd(content) {
+        const overrides = {};
+        const lines = content.split("\n");
+        let inPolicySection = false;
+        for (const line of lines) {
+            const trimmed = line.trim();
+            // Detect section boundaries
+            if (/^##\s+(Policy|Configuration)\s*$/i.test(trimmed)) {
+                inPolicySection = true;
+                continue;
+            }
+            // Any other H2 ends the section
+            if (/^##\s+/.test(trimmed) && inPolicySection) {
+                inPolicySection = false;
+                continue;
+            }
+            if (!inPolicySection)
+                continue;
+            // Match lines like: - planning.threshold: complex
+            const match = trimmed.match(/^-\s+([\w.]+)\s*:\s*(.+)$/);
+            if (match) {
+                const [, dotPath, rawValue] = match;
+                setNestedValue(overrides, dotPath, coerceValue(rawValue));
+            }
+        }
+        return overrides;
+    }
+}
+//# sourceMappingURL=execution-policy-engine.js.map

package/dist/execution-policy-engine.js.map

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

package/dist/failure-recovery.d.ts

@@ -0,0 +1,228 @@
+/**
+ * @module failure-recovery
+ * @description Intelligent error recovery on top of AutoFixLoop.
+ *
+ * While AutoFixLoop handles simple retry loops (validate → fix prompt → retry),
+ * FailureRecovery classifies root causes and selects from 5 recovery strategies:
+ *   1. retry          — same approach, try again
+ *   2. rollback       — undo changes, restore originals
+ *   3. approach_change — different implementation approach
+ *   4. scope_reduce   — simplify the task
+ *   5. escalate       — ask user for help
+ *
+ * Flow:
+ *   error → analyzeRootCause → selectStrategy → buildRecoveryPrompt
+ *         → (optionally) executeRollback / buildScopeReduction
+ *
+ * @see auto-fix.ts for the underlying AutoFixLoop
+ * @see 설계 문서 Section 6.4
+ */
+/** Extended error categories beyond AutoFixLoop's basic triggers. */
+export type ErrorCategory = "BUILD_FAIL" | "TEST_FAIL" | "LINT_ERROR" | "RUNTIME_ERROR" | "TYPE_ERROR" | "IMPORT_ERROR" | "PERMISSION_ERROR" | "TIMEOUT" | "RESOURCE_ERROR" | "UNKNOWN";
+/** Available recovery strategies, ordered from least to most disruptive. */
+export type RecoveryStrategy = "retry" | "rollback" | "approach_change" | "scope_reduce" | "escalate";
+/** Root cause analysis result. */
+export interface RootCause {
+    /** Error classification */
+    category: ErrorCategory;
+    /** Human-readable error summary */
+    message: string;
+    /** File where the error originated */
+    file?: string;
+    /** Line number of the error */
+    line?: number;
+    /** Suggested fix or next step */
+    suggestion?: string;
+    /** Confidence in the classification (0–1) */
+    confidence: number;
+}
+/** Decision on which recovery strategy to use. */
+export interface RecoveryDecision {
+    /** Selected strategy */
+    strategy: RecoveryStrategy;
+    /** Why this strategy was chosen */
+    reason: string;
+    /** Additional context for the strategy */
+    context: Record<string, unknown>;
+    /** LLM prompt for the chosen strategy */
+    prompt?: string;
+}
+/** Full context about a failure, used by strategy selection. */
+export interface FailureContext {
+    /** Raw error string */
+    error: string;
+    /** Tool that produced the error */
+    toolName?: string;
+    /** Raw tool output */
+    toolOutput?: string;
+    /** Current attempt number (1-based) */
+    attemptNumber: number;
+    /** Maximum attempts allowed */
+    maxAttempts: number;
+    /** Files that were changed during this task */
+    changedFiles: string[];
+    /** Original file contents before changes (file path → content) */
+    originalSnapshots: Map<string, string>;
+    /** Strategies already tried for this failure */
+    previousStrategies: RecoveryStrategy[];
+}
+/** Configuration for the FailureRecovery system. */
+export interface FailureRecoveryConfig {
+    /** Maximum number of strategy switches before escalating (default 3) */
+    maxStrategySwitches: number;
+    /** Whether rollback is allowed (default true) */
+    enableRollback: boolean;
+    /** Whether scope reduction is allowed (default true) */
+    enableScopeReduce: boolean;
+    /** Escalate after this many failed strategies (default 2) */
+    escalateThreshold: number;
+}
+/**
+ * FailureRecovery — Intelligent error recovery with root cause analysis
+ * and multi-strategy recovery selection.
+ *
+ * Sits on top of AutoFixLoop to provide higher-level recovery when
+ * simple retries are insufficient.
+ *
+ * @example
+ * ```typescript
+ * const recovery = new FailureRecovery({ maxStrategySwitches: 3 });
+ *
+ * // Analyze the error
+ * const rootCause = recovery.analyzeRootCause(errorOutput, 'shell_exec');
+ *
+ * // Select a strategy
+ * const decision = recovery.selectStrategy(rootCause, failureContext);
+ *
+ * // Get the recovery prompt for LLM
+ * const prompt = recovery.buildRecoveryPrompt(decision, failureContext);
+ *
+ * // If rollback was selected
+ * if (decision.strategy === 'rollback') {
+ *   await recovery.executeRollback(changedFiles, originalSnapshots);
+ * }
+ *
+ * // Record outcome
+ * recovery.recordStrategyResult(decision.strategy, wasSuccessful);
+ * ```
+ */
+export declare class FailureRecovery {
+    private readonly config;
+    private readonly history;
+    constructor(config?: Partial<FailureRecoveryConfig>);
+    /**
+     * Analyze an error string and classify its root cause.
+     *
+     * Checks against known error patterns in priority order and extracts
+     * file/line information when available.
+     *
+     * @param error Raw error string
+     * @param toolName Optional tool that produced the error
+     * @returns Root cause analysis with category, confidence, and suggestion
+     */
+    analyzeRootCause(error: string, toolName?: string): RootCause;
+    /**
+     * Select the best recovery strategy based on root cause and context.
+     *
+     * Strategy selection logic:
+     * - Attempt 1 + fixable categories → retry
+     * - PERMISSION_ERROR / RESOURCE_ERROR → escalate immediately
+     * - Attempt 2+ + rollback not tried → rollback
+     * - Rollback tried + approach_change not tried → approach_change
+     * - TIMEOUT + attempt 2+ → scope_reduce
+     * - Too many strategies tried → escalate
+     * - Default → approach_change
+     *
+     * @param rootCause Analyzed root cause
+     * @param context Full failure context
+     * @returns Recovery decision with strategy, reason, and optional prompt
+     */
+    selectStrategy(rootCause: RootCause, context: FailureContext): RecoveryDecision;
+    /**
+     * Build an LLM prompt tailored to the selected recovery strategy.
+     *
+     * Each strategy produces a different prompt style:
+     * - retry: focused on the specific error with suggestion
+     * - rollback: instructs fresh start after file restoration
+     * - approach_change: suggests alternative implementations
+     * - scope_reduce: narrows down the task scope
+     * - escalate: summarizes the situation for the user
+     *
+     * @param decision Recovery decision from selectStrategy
+     * @param context Full failure context
+     * @returns Formatted prompt string
+     */
+    buildRecoveryPrompt(decision: RecoveryDecision, context: FailureContext): string;
+    /**
+     * Execute a rollback by restoring original file contents.
+     *
+     * Uses atomic writes: writes to a .tmp file first, then renames.
+     * This prevents partial writes from corrupting files.
+     *
+     * @param changedFiles List of file paths to restore
+     * @param originalSnapshots Map of file path → original content
+     * @returns true if all files were successfully restored
+     */
+    executeRollback(changedFiles: string[], originalSnapshots: Map<string, string>): Promise<boolean>;
+    /**
+     * Build a scope-reduced version of the task description.
+     *
+     * Strips failed aspects from the original goal and produces
+     * a simplified task that avoids the problematic areas.
+     *
+     * @param originalGoal The original task description
+     * @param failedAspects Aspects that failed and should be skipped
+     * @returns Scope-reduced task description
+     */
+    buildScopeReduction(originalGoal: string, failedAspects: string[]): string;
+    /**
+     * Record the outcome of a strategy attempt.
+     *
+     * Used to track success rates and inform future strategy selection.
+     *
+     * @param strategy The strategy that was attempted
+     * @param success Whether it resolved the error
+     */
+    recordStrategyResult(strategy: RecoveryStrategy, success: boolean): void;
+    /**
+     * Reset all state for a new task.
+     * Clears strategy history and statistics.
+     */
+    reset(): void;
+    /**
+     * Get statistics about strategy usage and success rate.
+     *
+     * @returns Object with strategies used, success rate, and current attempt count
+     */
+    getStats(): {
+        strategiesUsed: RecoveryStrategy[];
+        successRate: number;
+        currentAttempt: number;
+    };
+    private buildRetryPrompt;
+    private buildRollbackPrompt;
+    private buildApproachChangePrompt;
+    private buildScopeReducePrompt;
+    private buildEscalatePrompt;
+    /**
+     * Extract file path and line number from an error string.
+     * Handles common formats: "file.ts(10,5)", "file.ts:10:5", "(file.ts:10)"
+     */
+    private extractFileLocation;
+    /**
+     * Extract a clean error message from raw output.
+     * Takes the first meaningful error line.
+     */
+    private extractErrorMessage;
+    /**
+     * Compute confidence score for a category match.
+     * Higher confidence when multiple signals align.
+     */
+    private computeConfidence;
+    /**
+     * Suggest alternative approaches based on the root cause category.
+     */
+    private suggestAlternatives;
+    private truncate;
+}
+//# sourceMappingURL=failure-recovery.d.ts.map

package/dist/failure-recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-recovery.d.ts","sourceRoot":"","sources":["../src/failure-recovery.ts"],"names":[],"mappings":"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"}