patchwarden 1.1.0 → 1.5.1

package/dist/goal/goalReport.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Goal 最终报告导出 — 将 Goal 完成情况渲染为人类可读 Markdown 和机器可读 JSON。
+ *
+ * exportGoalReport 读取 GoalStatus 和进度统计，关联 Evidence Pack，
+ * 生成 REPORT.md 和 report.json 到 {workspaceRoot}/.patchwarden/goals/{goalId}/report/。
+ * 所有写入操作使用原子写（.tmp + rename），所有字符串内容经 redactSensitiveValue 脱敏。
+ */
+import { type GoalProgressSummary } from "./goalProgress.js";
+export interface SubgoalReportEntry {
+    id: string;
+    title: string;
+    status: string;
+    task_ids: string[];
+    evidence_packs: string[];
+    accepted_at?: string;
+    rejected_reason?: string;
+}
+export interface SafeGoalReport {
+    goal_id: string;
+    generated_at: string;
+    path: string;
+    completion_rate: number;
+    files: {
+        report_md: string;
+        report_json: string;
+    };
+    summary: GoalProgressSummary;
+    subgoals: SubgoalReportEntry[];
+    risks: string[];
+    timeline: {
+        created_at: string;
+        updated_at: string;
+        status: string;
+    };
+    bounded: true;
+}
+/**
+ * 导出 Goal 最终报告，生成 REPORT.md 和 report.json。
+ *
+ * 流程：
+ *   1. 读取 GoalStatus（readGoalStatus）
+ *   2. 调用 summarizeGoalProgress 获取完成度统计
+ *   3. 遍历 subgoals，构建 SubgoalReportEntry，关联 Evidence Pack
+ *   4. 生成 REPORT.md（人类可读）和 report.json（机器可读）
+ *   5. 原子写到 {workspaceRoot}/.patchwarden/goals/{goalId}/report/
+ *   6. 所有字符串内容经 redactSensitiveValue 脱敏
+ *
+ * @param goalId   Goal 标识
+ * @param options  可选配置（workspaceRoot：工作区根目录，默认从 getConfig 获取）
+ * @returns SafeGoalReport（脱敏后的报告对象）
+ */
+export declare function exportGoalReport(goalId: string, options?: {
+    workspaceRoot?: string;
+}): SafeGoalReport;

package/dist/goal/goalReport.js

@@ -0,0 +1,204 @@
+/**
+ * Goal 最终报告导出 — 将 Goal 完成情况渲染为人类可读 Markdown 和机器可读 JSON。
+ *
+ * exportGoalReport 读取 GoalStatus 和进度统计，关联 Evidence Pack，
+ * 生成 REPORT.md 和 report.json 到 {workspaceRoot}/.patchwarden/goals/{goalId}/report/。
+ * 所有写入操作使用原子写（.tmp + rename），所有字符串内容经 redactSensitiveValue 脱敏。
+ */
+import { mkdirSync, renameSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { getConfig } from "../config.js";
+import { redactSensitiveValue } from "../security/contentRedaction.js";
+import { listEvidencePacks } from "../tools/evidencePack.js";
+import { summarizeGoalProgress } from "./goalProgress.js";
+import { readGoalStatus } from "./goalStore.js";
+// ── 辅助函数 ──────────────────────────────────────────────────────
+function resolveWorkspaceRoot(workspaceRoot) {
+    return workspaceRoot ?? getConfig().workspaceRoot;
+}
+/**
+ * 原子写文件：先写到 .tmp 文件，再 renameSync 到目标路径。
+ */
+function atomicWriteFile(filePath, content) {
+    const tmpPath = filePath + ".tmp";
+    writeFileSync(tmpPath, content, "utf-8");
+    renameSync(tmpPath, filePath);
+}
+/**
+ * 将百分比字符串（如 "100%"）解析为数字。
+ */
+function parseCompletionRate(value) {
+    const n = parseInt(value, 10);
+    return Number.isFinite(n) ? n : 0;
+}
+/**
+ * 查找与 task_ids 关联的 Evidence Pack 路径。
+ * 通过 listEvidencePacks 列出所有 pack，匹配 lineage_id 在 task_ids 中的 pack。
+ */
+function collectEvidencePacks(taskIds) {
+    if (taskIds.length === 0)
+        return [];
+    const packs = listEvidencePacks({ max_items: 50 });
+    const taskIdSet = new Set(taskIds);
+    const paths = [];
+    for (const pack of packs.evidence_packs) {
+        if (taskIdSet.has(pack.lineage_id)) {
+            paths.push(pack.path);
+        }
+    }
+    return paths;
+}
+// ── Markdown 生成 ─────────────────────────────────────────────────
+/**
+ * 从脱敏后的报告对象生成人类可读 Markdown。
+ */
+function buildReportMarkdown(report, flags) {
+    const lines = [];
+    // 标题
+    lines.push("# Goal Report: " + report.summary.title);
+    lines.push("");
+    // 元信息
+    lines.push("## 元信息");
+    lines.push("");
+    lines.push("- **goal_id**: " + report.goal_id);
+    lines.push("- **generated_at**: " + report.generated_at);
+    lines.push("- **status**: " + report.timeline.status);
+    lines.push("- **completion_rate**: " + report.completion_rate + "%");
+    if (flags.noSubgoals) {
+        lines.push("- **备注**: 无子目标");
+    }
+    if (flags.incomplete) {
+        lines.push("- **备注**: 未完成");
+    }
+    lines.push("");
+    // 完成度统计表
+    lines.push("## 完成度统计");
+    lines.push("");
+    lines.push("| 指标 | 数值 |");
+    lines.push("| --- | --- |");
+    lines.push("| total | " + report.summary.total + " |");
+    lines.push("| accepted | " + report.summary.accepted + " |");
+    lines.push("| rejected | " + report.summary.rejected + " |");
+    lines.push("| running | " + report.summary.running + " |");
+    lines.push("| ready | " + report.summary.ready + " |");
+    lines.push("| needs_fix | " + report.summary.needs_fix + " |");
+    lines.push("");
+    // 子目标清单
+    lines.push("## 子目标清单");
+    lines.push("");
+    if (report.subgoals.length === 0) {
+        lines.push("无子目标");
+        lines.push("");
+    }
+    else {
+        for (const sg of report.subgoals) {
+            lines.push("### " + sg.id + ": " + sg.title);
+            lines.push("");
+            lines.push("- **status**: " + sg.status);
+            lines.push("- **task_ids**: " + (sg.task_ids.length > 0 ? sg.task_ids.join(", ") : "无"));
+            lines.push("- **evidence_packs**: " +
+                (sg.evidence_packs.length > 0 ? sg.evidence_packs.join(", ") : "无"));
+            if (sg.accepted_at) {
+                lines.push("- **accepted_at**: " + sg.accepted_at);
+            }
+            if (sg.rejected_reason) {
+                lines.push("- **rejected_reason**: " + sg.rejected_reason);
+            }
+            lines.push("");
+        }
+    }
+    // 风险汇总
+    lines.push("## 风险汇总");
+    lines.push("");
+    if (report.risks.length === 0) {
+        lines.push("无");
+    }
+    else {
+        for (const r of report.risks) {
+            lines.push("- " + r);
+        }
+    }
+    lines.push("");
+    // 时间线
+    lines.push("## 时间线");
+    lines.push("");
+    lines.push("- **created_at**: " + report.timeline.created_at);
+    lines.push("- **updated_at**: " + report.timeline.updated_at);
+    lines.push("");
+    return lines.join("\n");
+}
+// ── 公共 API ──────────────────────────────────────────────────────
+/**
+ * 导出 Goal 最终报告，生成 REPORT.md 和 report.json。
+ *
+ * 流程：
+ *   1. 读取 GoalStatus（readGoalStatus）
+ *   2. 调用 summarizeGoalProgress 获取完成度统计
+ *   3. 遍历 subgoals，构建 SubgoalReportEntry，关联 Evidence Pack
+ *   4. 生成 REPORT.md（人类可读）和 report.json（机器可读）
+ *   5. 原子写到 {workspaceRoot}/.patchwarden/goals/{goalId}/report/
+ *   6. 所有字符串内容经 redactSensitiveValue 脱敏
+ *
+ * @param goalId   Goal 标识
+ * @param options  可选配置（workspaceRoot：工作区根目录，默认从 getConfig 获取）
+ * @returns SafeGoalReport（脱敏后的报告对象）
+ */
+export function exportGoalReport(goalId, options) {
+    const workspaceRoot = resolveWorkspaceRoot(options?.workspaceRoot);
+    const goalStatus = readGoalStatus(goalId, workspaceRoot);
+    const summary = summarizeGoalProgress(goalId, workspaceRoot);
+    const generatedAt = new Date().toISOString();
+    const noSubgoals = goalStatus.subgoals.length === 0;
+    const hasIncomplete = goalStatus.subgoals.some((s) => s.status === "running" || s.status === "ready");
+    const incomplete = goalStatus.status === "active" && hasIncomplete;
+    // 构建 subgoal 报告条目
+    const subgoalEntries = goalStatus.subgoals.map((sg) => {
+        const entry = {
+            id: sg.id,
+            title: sg.title,
+            status: sg.status,
+            task_ids: [...sg.task_ids],
+            evidence_packs: collectEvidencePacks(sg.task_ids),
+        };
+        if (sg.accepted_at)
+            entry.accepted_at = sg.accepted_at;
+        if (sg.rejected_reason)
+            entry.rejected_reason = sg.rejected_reason;
+        return entry;
+    });
+    // 风险汇总
+    const risks = summary.risks.map((r) => r.subgoal_id + " (" + r.status + "): " + r.reason);
+    if (incomplete) {
+        risks.push("未完成：Goal 仍有 running/ready 子目标");
+    }
+    // 报告目录
+    const reportDir = resolve(workspaceRoot, ".patchwarden", "goals", goalId, "report");
+    mkdirSync(reportDir, { recursive: true });
+    const reportMdPath = join(reportDir, "REPORT.md");
+    const reportJsonPath = join(reportDir, "report.json");
+    // 构建原始报告对象
+    const rawReport = {
+        goal_id: goalStatus.goal_id,
+        generated_at: generatedAt,
+        path: reportDir,
+        completion_rate: noSubgoals ? 0 : parseCompletionRate(summary.completion_rate),
+        files: { report_md: reportMdPath, report_json: reportJsonPath },
+        summary,
+        subgoals: subgoalEntries,
+        risks,
+        timeline: {
+            created_at: goalStatus.created_at,
+            updated_at: goalStatus.updated_at,
+            status: goalStatus.status,
+        },
+        bounded: true,
+    };
+    // 脱敏所有字符串内容
+    const safeReport = redactSensitiveValue(rawReport).value;
+    // 原子写 JSON（机器可读）
+    atomicWriteFile(reportJsonPath, JSON.stringify(safeReport, null, 2) + "\n");
+    // 原子写 Markdown（人类可读，从脱敏后的对象生成）
+    const markdown = buildReportMarkdown(safeReport, { noSubgoals, incomplete });
+    atomicWriteFile(reportMdPath, markdown);
+    return safeReport;
+}

package/dist/goal/goalStatus.d.ts

@@ -19,6 +19,10 @@ export interface Subgoal {
     task_ids: string[];
     accepted_at?: string;
     rejected_reason?: string;
+    /** Spec Kit task id 回溯（用于幂等去重） */
+    external_ref?: string;
+    /** Spec Kit task.files 提示（作用域文件路径列表） */
+    scope_hints?: string[];
 }
 export interface GoalStatus {
     goal_id: string;
@@ -28,6 +32,8 @@ export interface GoalStatus {
     created_at: string;
     updated_at: string;
     subgoals: Subgoal[];
+    /** Spec Kit 验收标准列表 */
+    acceptance_criteria?: string[];
 }
 /**
  * 创建初始 GoalStatus，用于新 goal。

package/dist/goal/specKitImport.d.ts

@@ -0,0 +1,63 @@
+/**
+ * v0.8.0: Spec Kit tasks 导入 — 将 Spec Kit 的 spec/tasks 结构转换为 Goal Session 子目标。
+ *
+ * - 解析 Spec Kit JSON（parseSpecKitJson）
+ * - 幂等导入：按 external_ref 去重，重复导入不产生重复 subgoal
+ * - 依赖解析：将 task.depends_on（external_ref 引用）解析为本地 subgoal id
+ * - 验收标准映射：input.acceptance → GoalStatus.acceptance_criteria
+ *
+ * 不引入第三方依赖，仅用 Node.js 内置模块。
+ */
+export interface SpecKitTask {
+    id: string;
+    desc: string;
+    files?: string[];
+    /** 引用其他 task 的 id（external_ref） */
+    depends_on?: string[];
+}
+export interface SpecKitInput {
+    spec: string;
+    tasks: SpecKitTask[];
+    acceptance?: string[];
+}
+export interface SpecKitImportResult {
+    goal_id: string;
+    spec_name: string;
+    created_count: number;
+    existing_count: number;
+    subgoal_ids: string[];
+}
+/**
+ * 解析 Spec Kit JSON 文本并验证结构。
+ *
+ * 必须包含：
+ * - spec: 非空字符串
+ * - tasks: 数组，每个元素含 id（字符串）和 desc（字符串）
+ *
+ * 可选：
+ * - acceptance: 字符串数组
+ *
+ * 解析失败或结构不合法时抛出 PatchWardenError("invalid_spec_kit_json" | "invalid_spec_kit_input")。
+ */
+export declare function parseSpecKitJson(jsonText: string): SpecKitInput;
+/**
+ * 将 Spec Kit tasks 导入到指定 Goal Session，创建对应的 subgoal。
+ *
+ * 行为：
+ * - 验证 input（spec 非空、tasks 为数组）
+ * - 幂等去重：按 external_ref（task.id）匹配现有 subgoal，已存在则跳过
+ * - 依赖解析：将 task.depends_on（external_ref）解析为本地 subgoal id
+ *   - 先创建无依赖的 subgoal，再处理有依赖的，支持多级依赖
+ *   - 依赖的 task 在同一批次中：用刚创建的 subgoal_id
+ *   - 依赖的 task 不存在：忽略该依赖并记录 warning（console.warn）
+ * - 验收标准：input.acceptance 非空时写入 GoalStatus.acceptance_criteria
+ * - 持久化：用 writeGoalStatus 原子写入
+ *
+ * @param goalId       目标 Goal 标识
+ * @param input        Spec Kit 输入（spec + tasks + acceptance）
+ * @param options      可选配置：workspaceRoot 用于测试
+ * @returns SpecKitImportResult
+ */
+export declare function importSpecKitTasks(goalId: string, input: SpecKitInput, options?: {
+    workspaceRoot?: string;
+}): SpecKitImportResult;

package/dist/goal/specKitImport.js

@@ -0,0 +1,220 @@
+/**
+ * v0.8.0: Spec Kit tasks 导入 — 将 Spec Kit 的 spec/tasks 结构转换为 Goal Session 子目标。
+ *
+ * - 解析 Spec Kit JSON（parseSpecKitJson）
+ * - 幂等导入：按 external_ref 去重，重复导入不产生重复 subgoal
+ * - 依赖解析：将 task.depends_on（external_ref 引用）解析为本地 subgoal id
+ * - 验收标准映射：input.acceptance → GoalStatus.acceptance_criteria
+ *
+ * 不引入第三方依赖，仅用 Node.js 内置模块。
+ */
+import { PatchWardenError } from "../errors.js";
+import { addSubgoal } from "./goalStatus.js";
+import { readGoalStatus, writeGoalStatus } from "./goalStore.js";
+// ── JSON 解析 ─────────────────────────────────────────────────────
+/**
+ * 解析 Spec Kit JSON 文本并验证结构。
+ *
+ * 必须包含：
+ * - spec: 非空字符串
+ * - tasks: 数组，每个元素含 id（字符串）和 desc（字符串）
+ *
+ * 可选：
+ * - acceptance: 字符串数组
+ *
+ * 解析失败或结构不合法时抛出 PatchWardenError("invalid_spec_kit_json" | "invalid_spec_kit_input")。
+ */
+export function parseSpecKitJson(jsonText) {
+    let parsed;
+    try {
+        parsed = JSON.parse(jsonText);
+    }
+    catch (e) {
+        throw new PatchWardenError("invalid_spec_kit_json", `Failed to parse Spec Kit JSON: ${e instanceof Error ? e.message : String(e)}`, "Ensure the input is valid JSON.", true, {});
+    }
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+        throw new PatchWardenError("invalid_spec_kit_input", "Spec Kit JSON must be a JSON object", 'Ensure the top-level value is an object with "spec" and "tasks" fields.', true, { actual_type: Array.isArray(parsed) ? "array" : typeof parsed });
+    }
+    const obj = parsed;
+    if (typeof obj.spec !== "string" || obj.spec === "") {
+        throw new PatchWardenError("invalid_spec_kit_input", 'Spec Kit JSON must contain a non-empty "spec" string field', 'Add a "spec" field with a non-empty string value describing the specification name.', true, { spec: obj.spec });
+    }
+    if (!Array.isArray(obj.tasks)) {
+        throw new PatchWardenError("invalid_spec_kit_input", 'Spec Kit JSON must contain a "tasks" array field', 'Add a "tasks" field with an array of task objects (each with "id" and "desc").', true, { tasks_type: Array.isArray(obj.tasks) ? "array" : typeof obj.tasks });
+    }
+    const tasks = [];
+    for (let i = 0; i < obj.tasks.length; i++) {
+        const raw = obj.tasks[i];
+        if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+            throw new PatchWardenError("invalid_spec_kit_input", `Spec Kit task at index ${i} must be an object`, "Each task must be an object with at least \"id\" and \"desc\" string fields.", true, { task_index: i, actual_type: typeof raw });
+        }
+        const t = raw;
+        if (typeof t.id !== "string" || t.id === "") {
+            throw new PatchWardenError("invalid_spec_kit_input", `Spec Kit task at index ${i} must have a non-empty "id" string`, "Ensure each task has a unique non-empty string \"id\".", true, { task_index: i, id: t.id });
+        }
+        if (typeof t.desc !== "string") {
+            throw new PatchWardenError("invalid_spec_kit_input", `Spec Kit task at index ${i} (id="${t.id}") must have a "desc" string`, "Ensure each task has a \"desc\" string describing the task.", true, { task_index: i, id: t.id, desc_type: typeof t.desc });
+        }
+        const task = { id: t.id, desc: t.desc };
+        if (Array.isArray(t.files)) {
+            task.files = t.files.filter((f) => typeof f === "string");
+        }
+        if (Array.isArray(t.depends_on)) {
+            task.depends_on = t.depends_on.filter((d) => typeof d === "string");
+        }
+        tasks.push(task);
+    }
+    const result = { spec: obj.spec, tasks };
+    if (Array.isArray(obj.acceptance)) {
+        result.acceptance = obj.acceptance.filter((a) => typeof a === "string");
+    }
+    return result;
+}
+// ── 导入实现 ──────────────────────────────────────────────────────
+/**
+ * 将 Spec Kit tasks 导入到指定 Goal Session，创建对应的 subgoal。
+ *
+ * 行为：
+ * - 验证 input（spec 非空、tasks 为数组）
+ * - 幂等去重：按 external_ref（task.id）匹配现有 subgoal，已存在则跳过
+ * - 依赖解析：将 task.depends_on（external_ref）解析为本地 subgoal id
+ *   - 先创建无依赖的 subgoal，再处理有依赖的，支持多级依赖
+ *   - 依赖的 task 在同一批次中：用刚创建的 subgoal_id
+ *   - 依赖的 task 不存在：忽略该依赖并记录 warning（console.warn）
+ * - 验收标准：input.acceptance 非空时写入 GoalStatus.acceptance_criteria
+ * - 持久化：用 writeGoalStatus 原子写入
+ *
+ * @param goalId       目标 Goal 标识
+ * @param input        Spec Kit 输入（spec + tasks + acceptance）
+ * @param options      可选配置：workspaceRoot 用于测试
+ * @returns SpecKitImportResult
+ */
+export function importSpecKitTasks(goalId, input, options) {
+    // ── 验证 ───────────────────────────────────────────────────
+    if (!input || typeof input !== "object") {
+        throw new PatchWardenError("invalid_spec_kit_input", "Spec Kit input must be an object", "Pass a SpecKitInput object with spec, tasks, and optional acceptance fields.", true, {});
+    }
+    if (typeof input.spec !== "string" || input.spec === "") {
+        throw new PatchWardenError("invalid_spec_kit_input", 'Spec Kit input must contain a non-empty "spec" string', "Ensure input.spec is a non-empty string.", true, { spec: input.spec });
+    }
+    if (!Array.isArray(input.tasks)) {
+        throw new PatchWardenError("invalid_spec_kit_input", 'Spec Kit input must contain a "tasks" array', "Ensure input.tasks is an array of SpecKitTask objects.", true, { tasks_type: Array.isArray(input.tasks) ? "array" : typeof input.tasks });
+    }
+    const workspaceRoot = options?.workspaceRoot;
+    // ── 读取现有 GoalStatus ────────────────────────────────────
+    let goalStatus = readGoalStatus(goalId, workspaceRoot);
+    // ── 构建 external_ref → subgoal_id 映射（现有 subgoal）─────
+    const refToSubgoalId = new Map();
+    for (const sg of goalStatus.subgoals) {
+        if (sg.external_ref) {
+            refToSubgoalId.set(sg.external_ref, sg.id);
+        }
+    }
+    // ── 幂等去重：区分新 task 和已存在的 task ─────────────────
+    const newTasks = [];
+    let existingCount = 0;
+    for (const task of input.tasks) {
+        if (refToSubgoalId.has(task.id)) {
+            existingCount++;
+        }
+        else {
+            newTasks.push(task);
+        }
+    }
+    // 新批次中所有 task id 集合（用于判断依赖是否在同批次）
+    const newTaskIds = new Set(newTasks.map((t) => t.id));
+    // ── 按依赖顺序创建 subgoal（拓扑排序，迭代多轮）────────────
+    const createdIds = [];
+    let remaining = [...newTasks];
+    // 辅助：创建单个 subgoal 并设置 external_ref / scope_hints
+    const createSubgoalForTask = (gs, task, resolvedDeps) => {
+        const { goalStatus: newGs, subgoalId } = addSubgoal(gs, task.desc, resolvedDeps);
+        // 新 subgoal 是数组最后一个元素，追加 external_ref 和 scope_hints
+        const subgoals = [...newGs.subgoals];
+        const lastIdx = subgoals.length - 1;
+        const updated = {
+            ...subgoals[lastIdx],
+            external_ref: task.id,
+        };
+        if (task.files && task.files.length > 0) {
+            updated.scope_hints = [...task.files];
+        }
+        subgoals[lastIdx] = updated;
+        return { goalStatus: { ...newGs, subgoals }, subgoalId };
+    };
+    while (remaining.length > 0) {
+        const stillRemaining = [];
+        let progress = false;
+        // 正向遍历：保持输入顺序，先创建的 task 可被同批次后续 task 依赖
+        for (const task of remaining) {
+            const deps = task.depends_on ?? [];
+            const resolvedDeps = [];
+            let hasUnresolvedInBatch = false;
+            for (const dep of deps) {
+                if (refToSubgoalId.has(dep)) {
+                    // 依赖已存在（已有 subgoal 或本批次已创建）
+                    resolvedDeps.push(refToSubgoalId.get(dep));
+                }
+                else if (newTaskIds.has(dep)) {
+                    // 依赖同批次中尚未创建的 task
+                    hasUnresolvedInBatch = true;
+                }
+                else {
+                    // 依赖的 task 不存在任何地方：忽略并记录 warning
+                    console.warn(`[specKitImport] Task "${task.id}" depends on non-existent task "${dep}"; ignoring this dependency.`);
+                }
+            }
+            if (!hasUnresolvedInBatch) {
+                const { goalStatus: newGs, subgoalId } = createSubgoalForTask(goalStatus, task, resolvedDeps);
+                goalStatus = newGs;
+                refToSubgoalId.set(task.id, subgoalId);
+                createdIds.push(subgoalId);
+                progress = true;
+            }
+            else {
+                stillRemaining.push(task);
+            }
+        }
+        remaining = stillRemaining;
+        if (!progress && remaining.length > 0) {
+            // 检测到循环依赖：强制创建剩余 task，忽略未解析的同批次依赖
+            for (const task of remaining) {
+                const deps = task.depends_on ?? [];
+                const resolvedDeps = [];
+                for (const dep of deps) {
+                    if (refToSubgoalId.has(dep)) {
+                        resolvedDeps.push(refToSubgoalId.get(dep));
+                    }
+                    else if (newTaskIds.has(dep)) {
+                        console.warn(`[specKitImport] Circular dependency detected: task "${task.id}" depends on "${dep}" which could not be resolved; ignoring this dependency.`);
+                    }
+                    else {
+                        console.warn(`[specKitImport] Task "${task.id}" depends on non-existent task "${dep}"; ignoring this dependency.`);
+                    }
+                }
+                const { goalStatus: newGs, subgoalId } = createSubgoalForTask(goalStatus, task, resolvedDeps);
+                goalStatus = newGs;
+                refToSubgoalId.set(task.id, subgoalId);
+                createdIds.push(subgoalId);
+            }
+            break;
+        }
+    }
+    // ── 验收标准 ───────────────────────────────────────────────
+    if (input.acceptance && input.acceptance.length > 0) {
+        goalStatus = {
+            ...goalStatus,
+            acceptance_criteria: [...input.acceptance],
+        };
+    }
+    // ── 持久化（原子写）────────────────────────────────────────
+    writeGoalStatus(goalId, goalStatus, workspaceRoot);
+    // ── 返回结果 ───────────────────────────────────────────────
+    return {
+        goal_id: goalId,
+        spec_name: input.spec,
+        created_count: createdIds.length,
+        existing_count: existingCount,
+        subgoal_ids: createdIds,
+    };
+}

package/dist/goal/subgoalSync.js

@@ -10,6 +10,7 @@ import { readFileSync } from "node:fs";
 import { join } from "node:path";
 import { readGoalStatus, writeGoalStatus } from "./goalStore.js";
 import { updateSubgoalStatus } from "./goalStatus.js";
+import { logger } from "../logging.js";
 // ── 同步函数 ──────────────────────────────────────────────────────
 /**
  * v0.8.0: 当任务状态变为 done_by_agent 时，同步更新关联的 subgoal 状态。
@@ -42,7 +43,7 @@ export function syncSubgoalOnTaskDone(taskId, taskMeta, workspaceRoot) {
     }
     catch (err) {
         // subgoal 同步失败不应影响任务完成流程，只记录到 stderr
-        console.error(`[goal] syncSubgoalOnTaskDone failed for task ${taskId}: ${err instanceof Error ? err.message : String(err)}`);
+        logger.error(`[goal] syncSubgoalOnTaskDone failed for task ${taskId}`, { error: err instanceof Error ? err.message : String(err) });
     }
 }
 // ── Task 元信息读取 ───────────────────────────────────────────────

package/dist/httpServer.js

@@ -24,24 +24,25 @@ import { registerTools } from "./tools/registry.js";
 import { healthCheck } from "./tools/healthCheck.js";
 import { getToolCatalogSnapshot } from "./tools/registry.js";
 import { PATCHWARDEN_VERSION } from "./version.js";
+import { logger } from "./logging.js";
 // ── Bootstrap ─────────────────────────────────────────────────────
 const config = loadConfig();
 const port = parseInt(process.env.PATCHWARDEN_HTTP_PORT || "") ||
     config.httpPort ||
     7331;
 const host = "127.0.0.1";
-console.error(`[patchwarden-http] Workspace: ${config.workspaceRoot}`);
-console.error(`[patchwarden-http] Listening:  http://${host}:${port}/mcp`);
-console.error(`[patchwarden-http] ⚠️  Bound to 127.0.0.1 only — not exposed to network`);
+logger.info(`[patchwarden-http] Workspace: ${config.workspaceRoot}`);
+logger.info(`[patchwarden-http] Listening:  http://${host}:${port}/mcp`);
+logger.info(`[patchwarden-http] ⚠️  Bound to 127.0.0.1 only — not exposed to network`);
 // ── Owner token (optional) ────────────────────────────────────────
 const httpCfg = config.http || {};
 const ownerTokenEnv = httpCfg.ownerTokenEnv || "PATCHWARDEN_OWNER_TOKEN";
 const ownerToken = process.env[ownerTokenEnv] || "";
 if (ownerToken) {
-    console.error(`[patchwarden-http] 🔒 Owner token required (env: ${ownerTokenEnv})`);
+    logger.info(`[patchwarden-http] 🔒 Owner token required (env: ${ownerTokenEnv})`);
 }
 else {
-    console.error(`[patchwarden-http] ⚠️  No owner token set — all local requests accepted`);
+    logger.info(`[patchwarden-http] ⚠️  No owner token set — all local requests accepted`);
 }
 function checkOwnerToken(req) {
     if (!ownerToken)
@@ -123,7 +124,9 @@ async function handleMcpRequest(req, res) {
         await transport.handleRequest(req, res);
     }
     catch (err) {
-        console.error("[patchwarden-http] Request error:", err);
+        logger.error("[patchwarden-http] Request error", {
+            error: err instanceof Error ? err.message : String(err),
+        });
         if (!res.headersSent) {
             res.writeHead(500, { "Content-Type": "application/json" });
             res.end(JSON.stringify({ error: "Internal server error" }));
@@ -233,21 +236,21 @@ const httpServer = createServer(async (req, res) => {
 // ── Start ─────────────────────────────────────────────────────────
 httpServer.on("error", (err) => {
     if (err.code === "EADDRINUSE") {
-        console.error(`[patchwarden-http] Fatal: port ${port} is already in use on ${host}.`);
-        console.error("[patchwarden-http] Stop the other PatchWarden HTTP instance or change httpPort in patchwarden.config.json.");
+        logger.fatal(`[patchwarden-http] Fatal: port ${port} is already in use on ${host}.`);
+        logger.fatal("[patchwarden-http] Stop the other PatchWarden HTTP instance or change httpPort in patchwarden.config.json.");
     }
     else {
-        console.error(`[patchwarden-http] Fatal: ${err.message}`);
+        logger.fatal(`[patchwarden-http] Fatal: ${err.message}`);
     }
     process.exit(1);
 });
 httpServer.listen(port, host, () => {
-    console.error(`[patchwarden-http] ✅ Ready`);
-    console.error(`[patchwarden-http] Admin:    http://${host}:${port}/admin/tasks/:id/accept`);
+    logger.info(`[patchwarden-http] ✅ Ready`);
+    logger.info(`[patchwarden-http] Admin:    http://${host}:${port}/admin/tasks/:id/accept`);
 });
 // Graceful shutdown
 process.on("SIGINT", () => {
-    console.error("[patchwarden-http] Shutting down...");
+    logger.info("[patchwarden-http] Shutting down...");
     httpServer.close(() => process.exit(0));
 });
 process.on("SIGTERM", () => {