/**
 * 类型迁移兼容层 — 将旧版英文类型值迁移为中文语义值。
 *
 * 核心职责:
 * - 提供旧 TaskStage / NavigationAction / PhaseDirective / 机制ID 的完整迁移映射
 * - 提供 migrateTaskContext() 用于磁盘加载时的自动迁移
 * - 确保升级后旧的持久化 TaskContext JSON 仍可正常加载
 */
import type { TaskContext } from "../../types/task.js";
/** 新版 TaskStage 值 */
export declare const NEW_TASK_STAGES: readonly ["需求分析", "现有系统分析", "架构设计", "详细设计", "任务规划", "编码与单元测试", "代码审查", "联调验证"];
/** 新版 NavigationAction 值 */
export declare const NEW_NAV_ACTIONS: readonly ["初始化", "需求分析", "现有系统分析", "架构设计", "详细设计", "任务规划", "编码与单元测试", "代码审查", "联调验证", "回退", "门禁校验", "学习沉淀", "过期状态解决"];
/** 新版 PhaseDirective 值 */
export declare const NEW_PHASE_DIRECTIVES: readonly ["推进下一阶段", "门禁阻断", "回退", "回退并标注", "完成", "停止升级"];
/** 系统类型常量（向后兼容） */
export declare const SYSTEM_TYPES: readonly ["新系统", "老系统"];
/** 向后兼容 re-export */
export type { SystemType } from "../../types/base.js";
/** MCP 工具名（英文 ASCII） → NavigationAction（中文） */
export declare const TOOL_NAME_TO_NAV_ACTION: Record<string, string>;
/** NavigationAction（中文） → MCP 工具名（英文 ASCII），多值取第一个 */
export declare const NAV_ACTION_TO_TOOL_NAME: Record<string, string>;
/** 判断字符串是否为 MCP 工具名（sf_ 前缀） */
export declare function isMcpToolName(value: string): boolean;
/** MCP 工具名 → NavigationAction，非工具名原样返回 */
export declare function toolNameToNavAction(toolName: string): string;
/** TaskStage 迁移映射：旧英文值 → 新中文值 */
export declare const TASK_STAGE_MIGRATION: Record<string, string | null>;
/** NavigationAction 迁移映射 */
export declare const NAV_ACTION_MIGRATION: Record<string, string>;
/** PhaseDirective 迁移映射 */
export declare const PHASE_DIRECTIVE_MIGRATION: Record<string, string>;
/** 机制ID迁移映射 */
export declare const MECHANISM_ID_MIGRATION: Record<string, string>;
/** TaskStage 反向映射：新中文值 → 代表性旧英文值 */
export declare const TASK_STAGE_REVERSE: Record<string, string>;
/** NavigationAction 反向映射 */
export declare const NAV_ACTION_REVERSE: Record<string, string>;
/** PhaseDirective 反向映射 */
export declare const PHASE_DIRECTIVE_REVERSE: Record<string, string>;
/** 迁移 TaskStage 旧值到新值，无法映射时返回原值 */
export declare function migrateTaskStage(oldValue: string): string;
/** 迁移 NavigationAction 旧值到新值 */
export declare function migrateNavigationAction(oldValue: string): string;
/** 迁移 PhaseDirective 旧值到新值 */
export declare function migratePhaseDirective(oldValue: string): string;
/** 迁移机制ID旧值到新值 */
export declare function migrateMechanismId(oldValue: string): string;
/**
 * 迁移整个 TaskContext（用于磁盘加载时自动升级旧格式）。
 * 原地修改并返回，不创建新对象。
 */
export declare function migrateTaskContext(ctx: TaskContext): TaskContext;
/**
 * 判断给定的 TaskStage 值是否为新版中文值。
 * 用于区分新旧格式，决定是否需要迁移。
 */
export declare function isNewTaskStage(value: string): boolean;
/**
 * 判断给定的 PhaseDirective 值是否为新版中文值。
 */
export declare function isNewPhaseDirective(value: string): boolean;
//# sourceMappingURL=legacy_type_migration.d.ts.map