soloforge 1.0.0

package/dist/engine/resilience.js

@@ -0,0 +1,210 @@
+const ALL_COMPONENTS = [
+    "scope_controller",
+    "secret_detection",
+    "intent_expander",
+    "verifier",
+    "evolver",
+    "code_reviewer",
+];
+/**
+ * Ordering from best to worst degradation level, used to determine "worst" level.
+ */
+const LEVEL_SEVERITY = {
+    full: 0,
+    partial: 1,
+    minimal: 2,
+};
+function worseLevel(a, b) {
+    return LEVEL_SEVERITY[a] >= LEVEL_SEVERITY[b] ? a : b;
+}
+// ── Per-component checks ──
+function checkScopeController(context) {
+    return {
+        component: "scope_controller",
+        level: "full",
+        reason: "安全组件永不降级",
+        since: context.created_at,
+    };
+}
+function checkSecretDetection(context) {
+    return {
+        component: "secret_detection",
+        level: "full",
+        reason: "安全组件永不降级",
+        since: context.created_at,
+    };
+}
+function checkIntentExpander(context) {
+    if (context.expansion?.degraded) {
+        return {
+            component: "intent_expander",
+            level: "partial",
+            reason: "未匹配到知识，使用最小 scope + 基础验收",
+            since: context.created_at,
+        };
+    }
+    return {
+        component: "intent_expander",
+        level: "full",
+        reason: "正常",
+        since: context.created_at,
+    };
+}
+function checkVerifier(context) {
+    const verification = context.verification;
+    if (!verification) {
+        return {
+            component: "verifier",
+            level: "full",
+            reason: "正常",
+            since: context.created_at,
+        };
+    }
+    const hasBuild = verification.checks.build.length > 0;
+    const hasTests = verification.checks.tests.length > 0;
+    const hasAcceptance = (verification.checks.acceptance ?? []).length > 0;
+    if (!hasBuild && !hasTests && !hasAcceptance) {
+        return {
+            component: "verifier",
+            level: "minimal",
+            reason: "构建命令不可用",
+            since: context.created_at,
+        };
+    }
+    if (hasBuild && !hasTests && !hasAcceptance) {
+        return {
+            component: "verifier",
+            level: "partial",
+            reason: "仅基础编译验证",
+            since: context.created_at,
+        };
+    }
+    return {
+        component: "verifier",
+        level: "full",
+        reason: "正常",
+        since: context.created_at,
+    };
+}
+function checkEvolver(context) {
+    const failures = context.execution?.failure_history?.length ?? 0;
+    if (context.status === "failed") {
+        return {
+            component: "evolver",
+            level: "minimal",
+            reason: "任务失败，暂停自进化",
+            since: context.created_at,
+        };
+    }
+    if (failures > 0) {
+        return {
+            component: "evolver",
+            level: "partial",
+            reason: "存在修复循环，学习置信度降低",
+            since: context.created_at,
+        };
+    }
+    return {
+        component: "evolver",
+        level: "full",
+        reason: "正常",
+        since: context.created_at,
+    };
+}
+function checkCodeReviewer(context) {
+    if (context.code_review) {
+        return {
+            component: "code_reviewer",
+            level: "full",
+            reason: "正常",
+            since: context.created_at,
+        };
+    }
+    if (context.status === "done" || context.status === "failed") {
+        return {
+            component: "code_reviewer",
+            level: "minimal",
+            reason: "代码审查已跳过",
+            since: context.created_at,
+        };
+    }
+    return {
+        component: "code_reviewer",
+        level: "full",
+        reason: "待执行",
+        since: context.created_at,
+    };
+}
+const COMPONENT_CHECKERS = {
+    scope_controller: checkScopeController,
+    secret_detection: checkSecretDetection,
+    intent_expander: checkIntentExpander,
+    verifier: checkVerifier,
+    evolver: checkEvolver,
+    code_reviewer: checkCodeReviewer,
+};
+// ── Public API ──
+/**
+ * Analyzes a single TaskContext and returns degradation status for each component.
+ *
+ * This is a diagnostic function -- the actual degradation behavior is embedded
+ * in each component.  Components that must never degrade (scope_controller,
+ * secret_detection) always return "full".
+ */
+export function checkDegradation(context) {
+    return ALL_COMPONENTS.map((component) => COMPONENT_CHECKERS[component](context));
+}
+/**
+ * Takes multiple TaskContexts (e.g., recent tasks) and determines overall system
+ * degradation by taking the worst level for each component across all contexts.
+ *
+ * Returns the aggregated component statuses and a human-readable summary in Chinese.
+ */
+export function checkSystemDegradation(contexts) {
+    if (contexts.length === 0) {
+        return {
+            components: [],
+            summary: "无任务数据，无法评估系统降级状态",
+        };
+    }
+    // Collect per-context results and aggregate by worst level per component.
+    const aggregated = new Map();
+    for (const ctx of contexts) {
+        const statuses = checkDegradation(ctx);
+        for (const status of statuses) {
+            const existing = aggregated.get(status.component);
+            if (!existing) {
+                aggregated.set(status.component, { ...status });
+            }
+            else {
+                aggregated.set(status.component, {
+                    component: status.component,
+                    level: worseLevel(existing.level, status.level),
+                    reason: status.level !== "full" ? status.reason : existing.reason,
+                    since: existing.since,
+                });
+            }
+        }
+    }
+    const components = ALL_COMPONENTS.map((name) => aggregated.get(name));
+    // Build Chinese summary.
+    const degraded = components.filter((c) => c.level !== "full");
+    let summary;
+    if (degraded.length === 0) {
+        summary = "所有组件运行正常，无降级";
+    }
+    else {
+        const partial = degraded.filter((c) => c.level === "partial");
+        const minimal = degraded.filter((c) => c.level === "minimal");
+        const parts = [];
+        if (minimal.length > 0) {
+            parts.push(`${minimal.length} 个组件处于最低功能模式：${minimal.map((c) => c.component).join("、")}`);
+        }
+        if (partial.length > 0) {
+            parts.push(`${partial.length} 个组件部分降级：${partial.map((c) => c.component).join("、")}`);
+        }
+        summary = parts.join("；");
+    }
+    return { components, summary };
+}
+//# sourceMappingURL=resilience.js.map

package/dist/engine/resilience.js.map

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

package/dist/engine/scaffolder.d.ts

@@ -0,0 +1,9 @@
+import type { ClassifyResult, ScaffoldResult, ProjectConfig } from "../types.js";
+export interface ScaffoldInput {
+    intent: string;
+    classification: ClassifyResult;
+    config: ProjectConfig;
+    projectPath: string;
+}
+export declare function generateScaffold(input: ScaffoldInput): Promise<ScaffoldResult>;
+//# sourceMappingURL=scaffolder.d.ts.map

package/dist/engine/scaffolder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffolder.d.ts","sourceRoot":"","sources":["../../src/engine/scaffolder.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAgB,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE/F,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,cAAc,CAAC;IAC/B,MAAM,EAAE,aAAa,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAyDpF"}

package/dist/engine/scaffolder.js

@@ -0,0 +1,222 @@
+import fs from "node:fs/promises";
+import fss from "node:fs";
+import path from "node:path";
+import Handlebars from "handlebars";
+export async function generateScaffold(input) {
+    const { intent, classification, config, projectPath } = input;
+    // 提取模块名
+    const moduleName = extractModuleName(intent);
+    // 确定模板集
+    const templateSets = resolveTemplateSets(config);
+    // 渲染模板
+    const files = [];
+    const warnings = [];
+    for (const templateSet of templateSets) {
+        const templateDir = resolveTemplateDir(templateSet, config);
+        if (!fss.existsSync(templateDir)) {
+            warnings.push(`模板目录不存在: ${templateDir}`);
+            continue;
+        }
+        const templateFiles = await fs.readdir(templateDir);
+        for (const tplFile of templateFiles) {
+            if (!tplFile.endsWith(".hbs"))
+                continue;
+            const templateContent = await fs.readFile(path.join(templateDir, tplFile), "utf-8");
+            const compiled = Handlebars.compile(templateContent);
+            const vars = buildTemplateVars(moduleName, config, templateSet, classification);
+            const rendered = compiled(vars);
+            // 计算目标路径
+            const outputName = tplFile.replace(".hbs", "").replaceAll("{{ModuleName}}", vars.ModuleName);
+            const targetPath = resolveTargetPath(outputName, vars, templateSet, config);
+            // 冲突检测
+            const fullPath = path.join(projectPath, targetPath);
+            if (fss.existsSync(fullPath)) {
+                warnings.push(`文件已存在: ${targetPath}`);
+            }
+            files.push({
+                path: targetPath,
+                content: rendered,
+                description: describeFile(outputName, vars.ModuleName),
+                is_template: rendered.includes("{{"),
+                template_vars: rendered.includes("{{") ? { ModuleName: vars.ModuleName } : undefined,
+            });
+        }
+    }
+    return {
+        task_id: "",
+        module_name: moduleName,
+        files,
+        summary: `为模块 ${moduleName} 生成 ${files.length} 个文件${warnings.length > 0 ? `，${warnings.length} 个冲突` : ""}`,
+        total_files: files.length,
+        warnings,
+    };
+}
+// ── 模块名提取 ──
+function extractModuleName(intent) {
+    // 中文实体映射
+    const entityMap = {
+        "订单": "Order", "商品": "Product", "用户": "User",
+        "支付": "Payment", "权限": "Permission", "角色": "Role",
+        "菜单": "Menu", "库存": "Inventory", "退款": "Refund",
+        "发票": "Invoice", "地址": "Address", "评论": "Comment",
+        "通知": "Notification", "消息": "Message", "购物车": "Cart",
+        "配置": "Config", "日志": "AuditLog", "报表": "Report",
+        "导出": "Export", "导入": "Import",
+    };
+    for (const [cn, en] of Object.entries(entityMap)) {
+        if (intent.includes(cn))
+            return en;
+    }
+    // 英文 PascalCase 提取
+    const pascalMatch = intent.match(/[A-Z][a-z]+(?:[A-Z][a-z]+)*/);
+    if (pascalMatch)
+        return pascalMatch[0];
+    // 回退: 取第一个有意义的关键词
+    const words = intent.split(/\s+/).filter((w) => w.length > 1);
+    if (words.length > 0) {
+        const word = words.find((w) => !/新建|创建|添加|初始化|模块|功能/.test(w));
+        if (word)
+            return toPascalCase(word);
+    }
+    return "Module";
+}
+function toPascalCase(str) {
+    return str
+        .replace(/[-_](\w)/g, (_, c) => c.toUpperCase())
+        .replace(/^\w/, (c) => c.toUpperCase());
+}
+function pluralize(name) {
+    const irregulars = {
+        Person: "People", Child: "Children", Man: "Men", Woman: "Women",
+        Mouse: "Mice", Goose: "Geese", Tooth: "Teeth", Foot: "Feet",
+    };
+    if (irregulars[name])
+        return irregulars[name];
+    if (name.endsWith("s") || name.endsWith("sh") || name.endsWith("ch") || name.endsWith("x")) {
+        return name + "es";
+    }
+    if (name.endsWith("y") && !/[aeiou]y$/i.test(name)) {
+        return name.slice(0, -1) + "ies";
+    }
+    return name + "s";
+}
+// ── 模板集解析 ──
+function resolveTemplateSets(config) {
+    const sets = [];
+    const backendFramework = config.tech_stack.backend.framework.toLowerCase();
+    const frontendFramework = config.tech_stack.frontend.framework.toLowerCase();
+    if (backendFramework.includes("spring"))
+        sets.push("spring-boot");
+    if (frontendFramework.includes("react"))
+        sets.push("react");
+    if (sets.length === 0)
+        sets.push("spring-boot"); // 默认后端
+    return sets;
+}
+function resolveTemplateDir(templateSet, config) {
+    // 优先使用项目自定义模板目录
+    if (config?.scaffold?.custom_templates_dir) {
+        const customDir = path.resolve(config.scaffold.custom_templates_dir, templateSet);
+        if (fss.existsSync(customDir))
+            return customDir;
+    }
+    return path.join(process.cwd(), "templates", "scaffolds", templateSet);
+}
+function buildTemplateVars(moduleName, config, _templateSet, classification) {
+    const basePackage = config.scaffold?.base_package ?? "com.example.app";
+    const module = moduleName.charAt(0).toLowerCase() + moduleName.slice(1);
+    const apiVersion = config.scaffold?.templates?.match(/v(\d+)/)?.[1] ?? "1";
+    return {
+        ModuleName: moduleName,
+        moduleName: module,
+        module_name: moduleName.replace(/([A-Z])/g, "_$1").toLowerCase().replace(/^_/, ""),
+        MODULE_NAME: moduleName.replace(/([A-Z])/g, "_$1").toUpperCase().replace(/^_/, ""),
+        basePackage,
+        packagePath: basePackage.replace(/\./g, "/"),
+        moduleNamePlural: pluralize(moduleName),
+        moduleNameLower: module.toLowerCase(),
+        apiVersion: `v${apiVersion}`,
+        basePath: `/api/v${apiVersion}/${module}`,
+        riskLevel: classification?.risk ?? "low",
+        complexityLevel: classification?.complexity ?? "low",
+        date: new Date().toISOString().split("T")[0],
+        author: "SoloForge",
+    };
+}
+function resolveTargetPath(outputName, vars, templateSet, config) {
+    if (templateSet === "spring-boot") {
+        const srcPath = `src/main/java/${vars.packagePath}`;
+        const testPath = `src/test/java/${vars.packagePath}`;
+        if (outputName.endsWith("Test.java")) {
+            return `${testPath}/${outputName}`;
+        }
+        const layerMap = {
+            "Controller.java": "controller",
+            "Service.java": "service",
+            "ServiceImpl.java": "service/impl",
+            "Mapper.java": "mapper",
+            "Entity.java": "entity",
+            "DTO.java": "dto",
+            "ErrorCode.java": "enums",
+            "PageResponse.java": "dto",
+        };
+        for (const [suffix, layer] of Object.entries(layerMap)) {
+            if (outputName.endsWith(suffix)) {
+                return `${srcPath}/${layer}/${outputName}`;
+            }
+        }
+        // 文档类文件
+        if (outputName.endsWith("ApiContract.md")) {
+            return `docs/api/${outputName}`;
+        }
+        return `${srcPath}/${outputName}`;
+    }
+    if (templateSet === "react") {
+        const srcPath = "src";
+        if (outputName.endsWith(".test.tsx")) {
+            return `${srcPath}/pages/__tests__/${outputName}`;
+        }
+        if (outputName.endsWith("service.ts")) {
+            return `${srcPath}/services/${outputName}`;
+        }
+        if (outputName.endsWith("types.ts")) {
+            return `${srcPath}/types/${outputName}`;
+        }
+        if (outputName.startsWith("use") && outputName.endsWith(".ts")) {
+            return `${srcPath}/pages/${vars.moduleName}/${outputName}`;
+        }
+        if (outputName.endsWith("README.md")) {
+            return `docs/modules/${outputName}`;
+        }
+        return `${srcPath}/pages/${vars.moduleName}/${outputName}`;
+    }
+    return outputName;
+}
+function describeFile(outputName, moduleName) {
+    const descMap = {
+        "Controller.java": `${moduleName} REST 控制器`,
+        "Service.java": `${moduleName} 服务接口`,
+        "ServiceImpl.java": `${moduleName} 服务实现`,
+        "Mapper.java": `${moduleName} 数据访问层`,
+        "Entity.java": `${moduleName} 实体类`,
+        "DTO.java": `${moduleName} 数据传输对象`,
+        "ServiceTest.java": `${moduleName} 服务测试`,
+        "ErrorCode.java": `${moduleName} 错误码枚举`,
+        "PageResponse.java": `${moduleName} 分页响应封装`,
+        "ApiContract.md": `${moduleName} API 契约文档`,
+        "README.md": `${moduleName} 模块使用说明`,
+    };
+    // 精确匹配后缀
+    for (const [suffix, desc] of Object.entries(descMap)) {
+        if (outputName.endsWith(suffix))
+            return desc;
+    }
+    if (outputName.endsWith(".tsx"))
+        return `${moduleName} 页面组件`;
+    if (outputName.startsWith("use") && outputName.endsWith(".ts"))
+        return `${moduleName} 数据 Hook`;
+    if (outputName.endsWith(".ts"))
+        return `${moduleName} TypeScript 模块`;
+    return `${moduleName} 文件`;
+}
+//# sourceMappingURL=scaffolder.js.map

package/dist/engine/scaffolder.js.map

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

package/dist/engine/scope_controller.d.ts

@@ -0,0 +1,3 @@
+import type { ScopeCheckResult } from "../types.js";
+export declare function checkScope(filePath: string, allowedPaths: string[], content?: string): ScopeCheckResult;
+//# sourceMappingURL=scope_controller.d.ts.map

package/dist/engine/scope_controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope_controller.d.ts","sourceRoot":"","sources":["../../src/engine/scope_controller.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAqCpD,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EAAE,EACtB,OAAO,CAAC,EAAE,MAAM,GACf,gBAAgB,CA4ClB"}

package/dist/engine/scope_controller.js

@@ -0,0 +1,121 @@
+import fs from "node:fs";
+import path from "node:path";
+import { execFileSync } from "node:child_process";
+let gitleaksAvailable = null;
+function isGitleaksAvailable() {
+    if (gitleaksAvailable === null) {
+        try {
+            execFileSync("which", ["gitleaks"], { stdio: "pipe" });
+            gitleaksAvailable = true;
+        }
+        catch {
+            gitleaksAvailable = false;
+        }
+    }
+    return gitleaksAvailable;
+}
+const SECRET_PATTERNS = [
+    { pattern: /AKIA[0-9A-Z]{16}/, type: "aws_access_key", severity: "blocked" },
+    { pattern: /aws_secret_access_key\s*=\s*['"][^'"]+['"]/, type: "aws_secret", severity: "blocked" },
+    { pattern: /sk-[a-zA-Z0-9]{32,}/, type: "api_key", severity: "blocked" },
+    { pattern: /['"][a-f0-9]{32,}['"]/, type: "possible_token", severity: "warning" },
+    { pattern: /password\s*=\s*['"][^'"]{8,}['"]/, type: "db_password", severity: "blocked" },
+    { pattern: /jwt_secret\s*=\s*['"][^'"]+['"]/, type: "jwt_secret", severity: "blocked" },
+    { pattern: /secret_key\s*=\s*['"][^'"]+['"]/, type: "secret_key", severity: "blocked" },
+];
+const SAFE_PATTERNS = [
+    /process\.env\./,
+    /System\.getenv\(/,
+    /import\.meta\.env\./,
+    /NODE_ENV/,
+];
+export function checkScope(filePath, allowedPaths, content) {
+    // 解析符号链接并规范化
+    const resolvedPath = realPath(filePath);
+    // 检查路径是否在允许的 scope 内（防止路径穿越）
+    const inScope = allowedPaths.some((allowed) => {
+        const resolved = realPath(allowed);
+        if (!resolvedPath.startsWith(resolved))
+            return false;
+        // 目录边界检查：匹配后的下一个字符必须是 / 或已到末尾
+        if (resolvedPath.length === resolved.length)
+            return true;
+        return resolvedPath[resolved.length] === "/";
+    });
+    if (!inScope) {
+        return {
+            allowed: false,
+            reason: `文件 ${filePath} 不在允许的 scope 内`,
+            has_secrets: false,
+            severity: "blocked",
+        };
+    }
+    // 如果提供了内容，检查密钥
+    if (content) {
+        const secretResult = detectSecrets(content, filePath);
+        if (secretResult.length > 0) {
+            const hasBlocked = secretResult.some((s) => s.severity === "blocked");
+            return {
+                allowed: !hasBlocked,
+                reason: hasBlocked
+                    ? `检测到密钥/密码: ${secretResult.map((s) => s.type).join(", ")}。请使用环境变量。`
+                    : `可能包含敏感信息: ${secretResult.map((s) => s.type).join(", ")}`,
+                has_secrets: true,
+                secret_details: secretResult.map((s) => ({
+                    file: filePath,
+                    line: s.line,
+                    type: s.type,
+                })),
+                severity: hasBlocked ? "blocked" : "warning",
+            };
+        }
+    }
+    return { allowed: true, has_secrets: false, severity: "ok" };
+}
+function detectSecrets(content, filePath) {
+    // 如果可用，优先使用 gitleaks
+    if (isGitleaksAvailable()) {
+        try {
+            const result = execFileSync("gitleaks", ["detect", "--no-git", "-f", "json", "-s", filePath], { encoding: "utf-8", timeout: 5000 });
+            const findings = JSON.parse(result || "[]");
+            if (Array.isArray(findings) && findings.length > 0) {
+                return findings.slice(0, 10).map((f) => ({
+                    type: f.RuleID || "gitleaks_finding",
+                    line: f.StartLine || 0,
+                    severity: "blocked",
+                }));
+            }
+            return []; // gitleaks 未发现问题
+        }
+        catch {
+            // gitleaks 失败（无发现 = 退出码 1），回退到正则匹配
+        }
+    }
+    // 回退: 基于正则的检测
+    const lines = content.split("\n");
+    const results = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // 跳过使用环境变量的行
+        if (SAFE_PATTERNS.some((p) => p.test(line)))
+            continue;
+        // 跳过注释
+        if (/^\s*(\/\/|#|<!--|\*)/.test(line))
+            continue;
+        for (const rule of SECRET_PATTERNS) {
+            if (rule.pattern.test(line)) {
+                results.push({ type: rule.type, line: i + 1, severity: rule.severity });
+            }
+        }
+    }
+    return results;
+}
+function realPath(p) {
+    try {
+        return fs.realpathSync(path.resolve(p));
+    }
+    catch {
+        return path.resolve(p);
+    }
+}
+//# sourceMappingURL=scope_controller.js.map

package/dist/engine/scope_controller.js.map

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

package/dist/engine/task_context.d.ts

@@ -0,0 +1,34 @@
+import type { TaskContext, ClassifyResult, ExpandResult, VerifyResult, FailureRecord, PlanResult, CodeReviewResult, DeliveryResult } from "../types.js";
+export declare class TaskContextManager {
+    private stateDir;
+    constructor(stateDir: string);
+    getStateDir(): string;
+    create(intent: string, productProfile: string): Promise<TaskContext>;
+    load(taskId: string): Promise<TaskContext | null>;
+    save(ctx: TaskContext): Promise<void>;
+    updateStatus(taskId: string, status: TaskContext["status"]): Promise<TaskContext | null>;
+    setClassification(taskId: string, result: ClassifyResult): Promise<TaskContext | null>;
+    setExpansion(taskId: string, result: ExpandResult): Promise<TaskContext | null>;
+    setExecution(taskId: string, changedFiles: string[], failure?: FailureRecord): Promise<TaskContext | null>;
+    setVerification(taskId: string, result: VerifyResult): Promise<TaskContext | null>;
+    getCurrentTask(): Promise<TaskContext | null>;
+    cancel(taskId: string): Promise<boolean>;
+    isResumable(ctx: TaskContext): boolean;
+    getResumeHint(ctx: TaskContext): string;
+    listRecent(limit?: number): Promise<Array<{
+        task_id: string;
+        intent: string;
+        status: string;
+        created_at: string;
+    }>>;
+    cleanup(): Promise<number>;
+    setPlanning(taskId: string, result: PlanResult): Promise<TaskContext | null>;
+    setCodeReview(taskId: string, result: CodeReviewResult): Promise<TaskContext | null>;
+    setDelivery(taskId: string, result: DeliveryResult): Promise<TaskContext | null>;
+    updateRepairLoop(taskId: string, failurePhase: string, autoRepairable: boolean, escalationReason?: string): Promise<TaskContext | null>;
+    recordRework(taskId: string, fromPhase: string, toPhase: string, reason: string): Promise<TaskContext | null>;
+    private taskFilePath;
+    private get pointerPath();
+    private writeCurrentPointer;
+}
+//# sourceMappingURL=task_context.d.ts.map

package/dist/engine/task_context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task_context.d.ts","sourceRoot":"","sources":["../../src/engine/task_context.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,gBAAgB,EAAkD,cAAc,EAAE,MAAM,aAAa,CAAC;AAkBxM,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,EAAE,MAAM;IAK5B,WAAW,IAAI,MAAM;IAIf,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAcpE,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAUjD,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAaxF,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAQtF,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAQ/E,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EAAE,EACtB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IA0BxB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAQlF,cAAc,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAU7C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU9C,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO;IAItC,aAAa,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM;IAYjC,UAAU,CAAC,KAAK,SAAK,GAAG,OAAO,CACnC,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAC/E;IAwBK,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAiD1B,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAQ5E,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAYpF,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAUhF,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IA+BvI,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IA2BnH,OAAO,CAAC,YAAY;IAIpB,OAAO,KAAK,WAAW,GAEtB;YAEa,mBAAmB;CAGlC"}