openfeel 1.0.0

package/dist/core/metrics.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Agent 性能指标模块
+ * 记录每个 Agent 的执行时间、成功率、重试次数
+ * 数据持久化到 .openfeel/metrics.json（与 flow.json 同级）
+ */
+/** Agent 性能指标 */
+export interface AgentMetrics {
+    agentName: string;
+    totalRuns: number;
+    successfulRuns: number;
+    failedRuns: number;
+    totalRetries: number;
+    totalDurationMs: number;
+    avgDurationMs: number;
+}
+/**
+ * MetricsStore 单例
+ * 管理所有 Agent 的性能指标，支持持久化读写
+ */
+export declare class MetricsStore {
+    private static instance;
+    private agents;
+    private dataDir;
+    private constructor();
+    /** 获取单例实例（默认 dataDir = CWD/.openfeel） */
+    static getInstance(dataDir?: string): MetricsStore;
+    /** 重置单例（仅测试用） */
+    static resetInstance(): void;
+    /**
+     * 记录一次 Agent 运行
+     * @param agentName Agent 名称
+     * @param durationMs 执行耗时（毫秒）
+     * @param result 执行结果（成功或失败）
+     * @param retries 本次操作的重试次数
+     */
+    recordRun(agentName: string, durationMs: number, result: 'success' | 'failure', retries?: number): void;
+    /**
+     * 获取指定 Agent 或全部 Agent 的性能指标
+     * @param agentName 可选，指定名称返回单个指标，否则返回全部
+     */
+    getAgentMetrics(agentName?: string): AgentMetrics | AgentMetrics[] | undefined;
+    /**
+     * 生成人类可读的性能摘要字符串
+     * 包含每个 Agent 的总执行次数、成功率、重试次数、耗时统计
+     */
+    summary(): string;
+    /** metrics.json 文件完整路径 */
+    private get metricsPath();
+    /**
+     * 从 .openfeel/metrics.json 加载已有数据
+     * 文件不存在时静默跳过；数据损坏时从空状态开始
+     */
+    load(): void;
+    /**
+     * 保存当前所有指标到 .openfeel/metrics.json
+     * 确保 .openfeel 目录存在
+     */
+    save(): void;
+}
+//# sourceMappingURL=metrics.d.ts.map

package/dist/core/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/core/metrics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,iBAAiB;AACjB,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB;AAoBD;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA6B;IACpD,OAAO,CAAC,MAAM,CAAwC;IACtD,OAAO,CAAC,OAAO,CAAS;IAExB,OAAO;IAIP,yCAAyC;IACzC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,YAAY;IASlD,iBAAiB;IACjB,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B;;;;;;OAMG;IACH,SAAS,CACP,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,SAAS,GAAG,SAAS,EAC7B,OAAO,GAAE,MAAU,GAClB,IAAI;IAqBP;;;OAGG;IACH,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,YAAY,EAAE,GAAG,SAAS;IAO9E;;;OAGG;IACH,OAAO,IAAI,MAAM;IA2BjB,0BAA0B;IAC1B,OAAO,KAAK,WAAW,GAEtB;IAED;;;OAGG;IACH,IAAI,IAAI,IAAI;IAoBZ;;;OAGG;IACH,IAAI,IAAI,IAAI;CAcb"}

package/dist/core/metrics.js

@@ -0,0 +1,137 @@
+/**
+ * Agent 性能指标模块
+ * 记录每个 Agent 的执行时间、成功率、重试次数
+ * 数据持久化到 .openfeel/metrics.json（与 flow.json 同级）
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { resolve } from 'node:path';
+/** 创建默认的 AgentMetrics 初始值 */
+function createDefaultMetrics(agentName) {
+    return {
+        agentName,
+        totalRuns: 0,
+        successfulRuns: 0,
+        failedRuns: 0,
+        totalRetries: 0,
+        totalDurationMs: 0,
+        avgDurationMs: 0,
+    };
+}
+/**
+ * MetricsStore 单例
+ * 管理所有 Agent 的性能指标，支持持久化读写
+ */
+export class MetricsStore {
+    static instance = null;
+    agents = new Map();
+    dataDir;
+    constructor(dataDir) {
+        this.dataDir = dataDir;
+    }
+    /** 获取单例实例（默认 dataDir = CWD/.openfeel） */
+    static getInstance(dataDir) {
+        if (!MetricsStore.instance) {
+            MetricsStore.instance = new MetricsStore(dataDir ?? resolve(process.cwd(), '.openfeel'));
+        }
+        return MetricsStore.instance;
+    }
+    /** 重置单例（仅测试用） */
+    static resetInstance() {
+        MetricsStore.instance = null;
+    }
+    /**
+     * 记录一次 Agent 运行
+     * @param agentName Agent 名称
+     * @param durationMs 执行耗时（毫秒）
+     * @param result 执行结果（成功或失败）
+     * @param retries 本次操作的重试次数
+     */
+    recordRun(agentName, durationMs, result, retries = 0) {
+        let metrics = this.agents.get(agentName);
+        if (!metrics) {
+            metrics = createDefaultMetrics(agentName);
+            this.agents.set(agentName, metrics);
+        }
+        metrics.totalRuns += 1;
+        metrics.totalDurationMs += durationMs;
+        if (result === 'success') {
+            metrics.successfulRuns += 1;
+        }
+        else {
+            metrics.failedRuns += 1;
+        }
+        metrics.totalRetries += retries;
+        // 平均耗时 = 总耗时 / 总执行次数（取整）
+        metrics.avgDurationMs = Math.round(metrics.totalDurationMs / metrics.totalRuns);
+    }
+    /**
+     * 获取指定 Agent 或全部 Agent 的性能指标
+     * @param agentName 可选，指定名称返回单个指标，否则返回全部
+     */
+    getAgentMetrics(agentName) {
+        if (agentName) {
+            return this.agents.get(agentName);
+        }
+        return Array.from(this.agents.values());
+    }
+    /**
+     * 生成人类可读的性能摘要字符串
+     * 包含每个 Agent 的总执行次数、成功率、重试次数、耗时统计
+     */
+    summary() {
+        if (this.agents.size === 0) {
+            return '暂无 Agent 性能数据。';
+        }
+        const lines = ['Agent 性能指标摘要', '═══════════════════'];
+        for (const m of this.agents.values()) {
+            const successRate = m.totalRuns > 0
+                ? `${((m.successfulRuns / m.totalRuns) * 100).toFixed(1)}%`
+                : 'N/A';
+            lines.push(`\n${m.agentName}`, `  总执行次数: ${m.totalRuns}`, `  成功 / 失败: ${m.successfulRuns} / ${m.failedRuns}`, `  成功率: ${successRate}`, `  总重试次数: ${m.totalRetries}`, `  总耗时: ${m.totalDurationMs}ms`, `  平均耗时: ${m.avgDurationMs}ms`);
+        }
+        return lines.join('\n');
+    }
+    /** metrics.json 文件完整路径 */
+    get metricsPath() {
+        return resolve(this.dataDir, 'metrics.json');
+    }
+    /**
+     * 从 .openfeel/metrics.json 加载已有数据
+     * 文件不存在时静默跳过；数据损坏时从空状态开始
+     */
+    load() {
+        const filePath = this.metricsPath;
+        if (!existsSync(filePath)) {
+            return;
+        }
+        try {
+            const raw = readFileSync(filePath, 'utf-8');
+            const data = JSON.parse(raw);
+            if (data.agents) {
+                for (const [name, metrics] of Object.entries(data.agents)) {
+                    this.agents.set(name, { ...metrics });
+                }
+            }
+        }
+        catch {
+            // 文件损坏时静默忽略，从空状态开始
+        }
+    }
+    /**
+     * 保存当前所有指标到 .openfeel/metrics.json
+     * 确保 .openfeel 目录存在
+     */
+    save() {
+        // 确保目录存在
+        if (!existsSync(this.dataDir)) {
+            mkdirSync(this.dataDir, { recursive: true });
+        }
+        const agents = {};
+        for (const [name, metrics] of this.agents) {
+            agents[name] = { ...metrics };
+        }
+        const data = { agents };
+        writeFileSync(this.metricsPath, JSON.stringify(data, null, 2), 'utf-8');
+    }
+}
+//# sourceMappingURL=metrics.js.map

package/dist/core/metrics.js.map

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

package/dist/core/pipeline-schema.d.ts

@@ -0,0 +1,78 @@
+/**
+ * 流水线配置 Zod Schema
+ * 定义 pipeline.yaml 的数据结构，用于校验和类型推导。
+ *
+ * 变更摘要 (stage-01: flow.json 鲁棒性加固):
+ * - 新增 PIPELINE_PHASES 枚举常量，硬编码 15 个合法流水线阶段
+ * - 新增 PipelinePhaseSchema (Zod enum)，用于运行时校验 phase 值的合法性
+ * - 新增 PipelinePhase 类型，替代此前的动态 string 类型
+ * - PipelineConfigSchema 保持 string 泛型以兼容自定义 YAML，phase 值校验由 PipelinePhaseSchema 负责
+ */
+import { z } from 'zod';
+/** 合法的流水线阶段枚举常量 */
+export declare const PIPELINE_PHASES: readonly ["plan_pending", "plan_review", "plan_passed", "scheme_pending", "scheme_review", "scheme_passed", "exec_running", "review_pending", "review_failed", "review_passed", "test_pending", "test_failed", "test_passed", "archiving", "done"];
+/** 流水线阶段 Zod 枚举 Schema，用于运行时校验 phase 值 */
+export declare const PipelinePhaseSchema: z.ZodEnum<{
+    plan_pending: "plan_pending";
+    plan_review: "plan_review";
+    plan_passed: "plan_passed";
+    scheme_pending: "scheme_pending";
+    scheme_review: "scheme_review";
+    scheme_passed: "scheme_passed";
+    exec_running: "exec_running";
+    review_pending: "review_pending";
+    review_failed: "review_failed";
+    review_passed: "review_passed";
+    test_pending: "test_pending";
+    test_failed: "test_failed";
+    test_passed: "test_passed";
+    archiving: "archiving";
+    done: "done";
+}>;
+/** 流水线阶段类型（从 Zod enum 推导，替代此前动态 string） */
+export type PipelinePhase = z.infer<typeof PipelinePhaseSchema>;
+/** 流水线全局宏观状态枚举常量 */
+export declare const META_PHASES: readonly ["active", "paused", "done"];
+/** 全局宏观状态 Zod 枚举 Schema，用于运行时校验 */
+export declare const MetaPhaseSchema: z.ZodEnum<{
+    done: "done";
+    active: "active";
+    paused: "paused";
+}>;
+/** 全局宏观状态类型 */
+export type MetaPhase = z.infer<typeof MetaPhaseSchema>;
+/**
+ * 组合转换条件分隔符
+ * transitions 的 key 可用 '|' 组合多个源 phase，任一源 phase 匹配即可推进到目标（多 Agent 并行场景）。
+ * 示例: `'test_passed|review_passed': ['archiving']` → 审查或测试任一通过即可归档。
+ */
+export declare const TRANSITION_OR_SEPARATOR = "|";
+/**
+ * 将 transitions 的 key 解析为条件 phase 列表
+ * 简单 key（如 'review_pending'）返回单个条件；组合 key（如 'test_passed|review_passed'）按 '|' 分割返回多个条件。
+ * @param key 转换 key（transitions 的键）
+ * @returns 条件 phase 列表（已去空、去空白）
+ */
+export declare function parseTransitionKey(key: string): string[];
+/** 判断某 phase 是否匹配转换 key（组合条件下任一条件匹配即 true，简单 key 为精确相等） */
+export declare function transitionKeyMatches(key: string, phase: string): boolean;
+/** pipeline.yaml 的完整 Schema（transitions key 允许 '|' 组合条件） */
+export declare const PipelineConfigSchema: z.ZodObject<{
+    phases: z.ZodArray<z.ZodString>;
+    transitions: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
+    checkpoint_mapping: z.ZodRecord<z.ZodString, z.ZodString>;
+    phase_corrections: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+/** pipeline.yaml 解析后的类型 */
+export type PipelineConfig = z.infer<typeof PipelineConfigSchema>;
+/** 阶段耗时统计 */
+export interface StageStats {
+    /** 阶段开始时间（ISO 8601） */
+    start_time: string;
+    /** 阶段结束时间（ISO 8601），未完成时为空字符串 */
+    end_time: string;
+    /** 阶段耗时（毫秒），未完成时为 0 */
+    duration_ms: number;
+}
+/** 阶段级流水线阶段（从 PipelineMeta 移到 StageData 内） */
+//# sourceMappingURL=pipeline-schema.d.ts.map

package/dist/core/pipeline-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-schema.d.ts","sourceRoot":"","sources":["../../src/core/pipeline-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,mBAAmB;AACnB,eAAO,MAAM,eAAe,oPAMlB,CAAC;AAEX,0CAA0C;AAC1C,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;EAA0B,CAAC;AAE3D,2CAA2C;AAC3C,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,oBAAoB;AACpB,eAAO,MAAM,WAAW,uCAAwC,CAAC;AAEjE,mCAAmC;AACnC,eAAO,MAAM,eAAe;;;;EAAsB,CAAC;AAEnD,eAAe;AACf,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAKxD;AAED,2DAA2D;AAC3D,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAExE;AAED,4DAA4D;AAC5D,eAAO,MAAM,oBAAoB;;;;;iBAM/B,CAAC;AAEH,2BAA2B;AAC3B,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,aAAa;AACb,MAAM,WAAW,UAAU;IACzB,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,8CAA8C"}

package/dist/core/pipeline-schema.js

@@ -0,0 +1,57 @@
+/**
+ * 流水线配置 Zod Schema
+ * 定义 pipeline.yaml 的数据结构，用于校验和类型推导。
+ *
+ * 变更摘要 (stage-01: flow.json 鲁棒性加固):
+ * - 新增 PIPELINE_PHASES 枚举常量，硬编码 15 个合法流水线阶段
+ * - 新增 PipelinePhaseSchema (Zod enum)，用于运行时校验 phase 值的合法性
+ * - 新增 PipelinePhase 类型，替代此前的动态 string 类型
+ * - PipelineConfigSchema 保持 string 泛型以兼容自定义 YAML，phase 值校验由 PipelinePhaseSchema 负责
+ */
+import { z } from 'zod';
+/** 合法的流水线阶段枚举常量 */
+export const PIPELINE_PHASES = [
+    'plan_pending', 'plan_review', 'plan_passed',
+    'scheme_pending', 'scheme_review', 'scheme_passed',
+    'exec_running', 'review_pending', 'review_failed',
+    'review_passed', 'test_pending', 'test_failed',
+    'test_passed', 'archiving', 'done',
+];
+/** 流水线阶段 Zod 枚举 Schema，用于运行时校验 phase 值 */
+export const PipelinePhaseSchema = z.enum(PIPELINE_PHASES);
+/** 流水线全局宏观状态枚举常量 */
+export const META_PHASES = ['active', 'paused', 'done'];
+/** 全局宏观状态 Zod 枚举 Schema，用于运行时校验 */
+export const MetaPhaseSchema = z.enum(META_PHASES);
+/**
+ * 组合转换条件分隔符
+ * transitions 的 key 可用 '|' 组合多个源 phase，任一源 phase 匹配即可推进到目标（多 Agent 并行场景）。
+ * 示例: `'test_passed|review_passed': ['archiving']` → 审查或测试任一通过即可归档。
+ */
+export const TRANSITION_OR_SEPARATOR = '|';
+/**
+ * 将 transitions 的 key 解析为条件 phase 列表
+ * 简单 key（如 'review_pending'）返回单个条件；组合 key（如 'test_passed|review_passed'）按 '|' 分割返回多个条件。
+ * @param key 转换 key（transitions 的键）
+ * @returns 条件 phase 列表（已去空、去空白）
+ */
+export function parseTransitionKey(key) {
+    return key
+        .split(TRANSITION_OR_SEPARATOR)
+        .map((c) => c.trim())
+        .filter(Boolean);
+}
+/** 判断某 phase 是否匹配转换 key（组合条件下任一条件匹配即 true，简单 key 为精确相等） */
+export function transitionKeyMatches(key, phase) {
+    return parseTransitionKey(key).includes(phase);
+}
+/** pipeline.yaml 的完整 Schema（transitions key 允许 '|' 组合条件） */
+export const PipelineConfigSchema = z.object({
+    phases: z.array(z.string()),
+    // transitions: { fromPhase | "fromA|fromB": [toPhase, ...] }，key 可含 '|' 组合多个源 phase
+    transitions: z.record(z.string(), z.array(z.string())),
+    checkpoint_mapping: z.record(z.string(), z.string()),
+    phase_corrections: z.record(z.string(), z.string()).default({}),
+});
+/** 阶段级流水线阶段（从 PipelineMeta 移到 StageData 内） */
+//# sourceMappingURL=pipeline-schema.js.map

package/dist/core/pipeline-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-schema.js","sourceRoot":"","sources":["../../src/core/pipeline-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,mBAAmB;AACnB,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,cAAc,EAAE,aAAa,EAAE,aAAa;IAC5C,gBAAgB,EAAE,eAAe,EAAE,eAAe;IAClD,cAAc,EAAE,gBAAgB,EAAE,eAAe;IACjD,eAAe,EAAE,cAAc,EAAE,aAAa;IAC9C,aAAa,EAAE,WAAW,EAAE,MAAM;CAC1B,CAAC;AAEX,0CAA0C;AAC1C,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;AAK3D,oBAAoB;AACpB,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAC;AAEjE,mCAAmC;AACnC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;AAKnD;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,OAAO,GAAG;SACP,KAAK,CAAC,uBAAuB,CAAC;SAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,oBAAoB,CAAC,GAAW,EAAE,KAAa;IAC7D,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACjD,CAAC;AAED,4DAA4D;AAC5D,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3B,oFAAoF;IACpF,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IACtD,kBAAkB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IACpD,iBAAiB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAChE,CAAC,CAAC;AAeH,8CAA8C"}

package/dist/core/plan/roadmap.d.ts

@@ -0,0 +1,17 @@
+/** 分期大纲 */
+export interface Roadmap {
+    version: string;
+    /** 相对路径 .openfeel/roadmap/v{version}.md */
+    path: string;
+}
+/**
+ * 创建分期大纲
+ * 在 .openfeel/roadmap/ 下创建 v{version}.md 骨架文件
+ */
+export declare function createRoadmap(projectPath: string, version: string): void;
+/**
+ * 显示分期大纲内容
+ * @param version 不传则列出所有大纲文件
+ */
+export declare function showRoadmap(projectPath: string, version?: string): string;
+//# sourceMappingURL=roadmap.d.ts.map

package/dist/core/plan/roadmap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roadmap.d.ts","sourceRoot":"","sources":["../../../src/core/plan/roadmap.ts"],"names":[],"mappings":"AAOA,WAAW;AACX,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;CACd;AAOD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAoCxE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CA0BzE"}

package/dist/core/plan/roadmap.js

@@ -0,0 +1,71 @@
+/**
+ * 分期大纲管理
+ * 负责 .openfeel/roadmap/ 下的版本大纲文件创建与读取
+ */
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
+import { resolve, join } from 'node:path';
+/** 规范化版本号：去掉用户可能输入的前导 v */
+function normalizeVersion(version) {
+    return version.replace(/^v/, '');
+}
+/**
+ * 创建分期大纲
+ * 在 .openfeel/roadmap/ 下创建 v{version}.md 骨架文件
+ */
+export function createRoadmap(projectPath, version) {
+    const ver = normalizeVersion(version);
+    const roadmapDir = resolve(projectPath, '.openfeel', 'roadmap');
+    if (!existsSync(roadmapDir)) {
+        mkdirSync(roadmapDir, { recursive: true });
+    }
+    const filePath = join(roadmapDir, `v${ver}.md`);
+    if (existsSync(filePath)) {
+        console.log(`大纲已存在: v${ver}.md`);
+        return;
+    }
+    const content = `# 分期大纲 v${ver}
+
+## 目标
+
+> 待补充 — 描述本版本的总体目标
+
+## 阶段划分
+
+> 待补充 — 列出各阶段（stage-01, stage-02, ...）及简要说明
+
+## 里程碑
+
+> 待补充 — 关键里程碑和预期完成时间
+
+## 备注
+
+> 待补充
+`;
+    writeFileSync(filePath, content, 'utf-8');
+    console.log(`已创建分期大纲: v${ver}.md`);
+}
+/**
+ * 显示分期大纲内容
+ * @param version 不传则列出所有大纲文件
+ */
+export function showRoadmap(projectPath, version) {
+    const roadmapDir = resolve(projectPath, '.openfeel', 'roadmap');
+    if (!existsSync(roadmapDir)) {
+        return '暂无分期大纲（.openfeel/roadmap/ 目录不存在）';
+    }
+    if (version) {
+        const ver = normalizeVersion(version);
+        const filePath = join(roadmapDir, `v${ver}.md`);
+        if (!existsSync(filePath)) {
+            console.error(`错误：大纲文件不存在 — v${ver}.md`);
+            process.exit(1);
+        }
+        return readFileSync(filePath, 'utf-8');
+    }
+    const files = readdirSync(roadmapDir).filter((f) => f.startsWith('v') && f.endsWith('.md'));
+    if (files.length === 0) {
+        return '暂无分期大纲文件';
+    }
+    return files.join('\n');
+}
+//# sourceMappingURL=roadmap.js.map

package/dist/core/plan/roadmap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roadmap.js","sourceRoot":"","sources":["../../../src/core/plan/roadmap.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC1F,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAS1C,2BAA2B;AAC3B,SAAS,gBAAgB,CAAC,OAAe;IACvC,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,WAAmB,EAAE,OAAe;IAChE,MAAM,GAAG,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IAEhE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,KAAK,CAAC,CAAC;IAEhD,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,KAAK,CAAC,CAAC;QACjC,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,WAAW,GAAG;;;;;;;;;;;;;;;;;CAiB/B,CAAC;IAEA,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,KAAK,CAAC,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,WAAmB,EAAE,OAAgB;IAC/D,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IAEhE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,kCAAkC,CAAC;IAC5C,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,KAAK,CAAC,CAAC;QAChD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,KAAK,CAAC,iBAAiB,GAAG,KAAK,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC,MAAM,CAC1C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAC9C,CAAC;IAEF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/core/plan/scheme.d.ts

@@ -0,0 +1,34 @@
+/** 操作方案 */
+export interface Scheme {
+    /** 如 op-001 */
+    opId: string;
+    /** 所属阶段名 */
+    stage: string;
+    /** 方案标题 */
+    title: string;
+    /** Markdown 全文 */
+    content: string;
+    /** 相对路径 .openfeel/stages/{stage}/ops/op-001_{title}.md */
+    filePath: string;
+}
+/**
+ * 创建操作方案
+ * 在 .openfeel/stages/{stage}/ops/ 下创建 op-NNN_{title}.md
+ * NNN 自动递增（从该阶段的已有方案中计算）
+ * 必须按固定模板生成，包含：目标、实施步骤（checkbox）、产出文件、自测清单、修正记录
+ * 创建后自动同步到 flow.json（如果存在）
+ * @returns opId（如 op-001）
+ */
+export declare function createScheme(projectPath: string, stageName: string, title: string): string;
+/**
+ * 读取操作方案
+ * @param opId 操作ID（如 op-001）或完整 opId（如 stage-01.op-001）
+ * @returns Scheme 或 null
+ */
+export declare function getScheme(projectPath: string, opId: string): Scheme | null;
+/**
+ * 列出操作方案
+ * @param stageName 可选，不传则列出所有阶段的方案
+ */
+export declare function listSchemes(projectPath: string, stageName?: string): Scheme[];
+//# sourceMappingURL=scheme.d.ts.map

package/dist/core/plan/scheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheme.d.ts","sourceRoot":"","sources":["../../../src/core/plan/scheme.ts"],"names":[],"mappings":"AASA,WAAW;AACX,MAAM,WAAW,MAAM;IACrB,eAAe;IACf,IAAI,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAoID;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAwB1F;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA4D1E;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAyD7E"}