@co0ontty/wand 4.71.2 → 4.72.0

package/dist/milestone-scope.js

@@ -18,3 +18,25 @@ export function scopedMilestoneId(storage, milestoneId, workspaceId) {
         return milestoneId;
     return milestone.workspaceId === workspaceId ? milestoneId : null;
 }
+/**
+ * 写路径的迭代兑底：用户没选（或没传）迭代就落到默认迭代，
+ * 这样「每个任务都属于一个迭代」在前端和后续 commit 总结里都成立。
+ */
+export function defaultMilestoneIdForWrite(storage) {
+    return storage.ensureDefaultWandMilestone().id;
+}
+/**
+ * 读出任务该显示的迭代：库里仍然用 NULL 表示「没单独指定」
+ * （历史数据不动，写入时才开始落默认迭代），读的时候统一兑成默认迭代。
+ */
+export function resolvedMilestoneFields(storage, milestoneId) {
+    const milestone = milestoneId
+        ? storage.getWandMilestone(milestoneId)
+        : storage.ensureDefaultWandMilestone();
+    if (!milestone)
+        return { milestoneId: null, milestone: null };
+    return {
+        milestoneId: milestone.id,
+        milestone: { id: milestone.id, name: milestone.name, isDefault: milestone.isDefault },
+    };
+}

package/dist/missions.js

@@ -2,6 +2,7 @@ import { randomUUID } from "node:crypto";
 import { existsSync, statSync } from "node:fs";
 import path from "node:path";
 import { buildMissionDiff } from "./mission-diff.js";
+import { recordIterationPromptForTask } from "./iteration-log.js";
 import { isSessionProvider } from "./session-provider.js";
 import { syncWorkspaceTaskToBoard } from "./wand-task-sync.js";
 const MAX_ATTEMPTS = 6;
@@ -148,9 +149,11 @@ export class Missions {
             throw new Error(`请选择 1-${MAX_ATTEMPTS} 个有效 provider。`);
         }
         const createdAt = nowIso();
-        const milestoneId = input.milestoneId?.trim() || null;
-        if (milestoneId && !this.storage.getWandMilestone(milestoneId))
+        // 没选迭代就落到默认迭代：每个任务都属于一个迭代，后面按迭代做 commit 总结才成立。
+        const requestedMilestoneId = input.milestoneId?.trim() || null;
+        if (requestedMilestoneId && !this.storage.getWandMilestone(requestedMilestoneId))
             throw new Error("未找到该里程碑。");
+        const milestoneId = requestedMilestoneId ?? this.storage.ensureDefaultWandMilestone().id;
         const mission = {
             id: randomUUID(),
             title: input.title?.trim().slice(0, 120) || firstPromptLine(prompt),
@@ -168,6 +171,15 @@ export class Missions {
             updatedAt: createdAt,
         };
         this.storage.saveMission(mission);
+        // 派发即改动意图：记进迭代提示词，commit / 汇报总结时不必读 diff。
+        recordIterationPromptForTask(this.storage, {
+            cwd: mission.cwd,
+            milestoneId: mission.milestoneId,
+            taskId: mission.taskId,
+            title: mission.title,
+            detail: prompt,
+            source: "dispatch",
+        });
         for (const provider of providers)
             this.dispatchAttempt(mission, provider);
         this.refreshMissionStatus(mission.id);

package/dist/process-manager.js

@@ -14,8 +14,9 @@ import { buildLanguageDirective, buildManagedAutonomyDirective } from "./languag
 import { prepareSessionWorktree } from "./git-worktree.js";
 import { getProviderCommandSessionId, getProviderResumeCommandSessionId } from "./resume-policy.js";
 import { normalizeThinkingEffort, thinkingEffortToClaudeCliEffort, thinkingEffortToClaudeSlashEffort, thinkingEffortToCodexReasoningEffort, thinkingEffortToOpenCodeVariant, thinkingEffortToPiLevel } from "./structured-provider-common.js";
-import { consumePtyInputForTopic, createPtyTopicLineBuffer, provisionalSessionTopic, SessionTopicCoordinator, sessionTopicBlocklistForSnapshot, shouldAcceptGeneratedSessionTitle, } from "./session-topic.js";
+import { consumePtyInputForTopic, createPtyTopicLineBuffer, provisionalSessionTopic, SessionTopicCoordinator, sessionTopicBlocklistForSnapshot, shouldAcceptGeneratedSessionTitle, shouldGenerateSessionTopicFromInput, } from "./session-topic.js";
 import { getErrorMessage } from "./error-utils.js";
+import { recordIterationPrompt } from "./iteration-log.js";
 import { describePtySpawnFailure } from "./ensure-node-pty-helper.js";
 import { resolveSystemAiContext } from "./session-ai-context.js";
 import { resolveSessionCwd } from "./session-cwd.js";
@@ -1935,9 +1936,13 @@ export class ProcessManager extends EventEmitter {
         const record = this.sessions.get(id);
         if (this.disposed || !prompt || !record)
             return;
+        // 迭代提示词记录：和会话标题共用同一套「有没有信息量」判断，用户不用多做一步。
+        recordIterationPrompt(this.storage, record, prompt, "session");
         const blockedTitles = sessionTopicBlocklistForSnapshot(record, this.storage);
         const provisional = provisionalSessionTopic(prompt, blockedTitles);
-        if (provisional && (record.title !== provisional.title || record.description !== provisional.description)) {
+        if (provisional
+            && shouldGenerateSessionTopicFromInput(prompt)
+            && (record.title !== provisional.title || record.description !== provisional.description)) {
             this.setSessionTopic(id, provisional.title, provisional.description);
         }
         this.topicCoordinator.request(id, {

package/dist/server-session-routes.js

@@ -8,6 +8,7 @@ import { resolveSessionCwd } from "./session-cwd.js";
 import { resolveCommitAiContext } from "./session-ai-context.js";
 import { getGitStatusAsync, QuickCommitError, runQuickCommitWithFallback, runTagHead, runPush, generateCommitMessageOnly, } from "./git-quick-commit.js";
 import { getErrorMessage } from "./error-utils.js";
+import { buildIterationCommitContext, COMMIT_CONTEXT_MODE_PREF_KEY, isCommitContextMode, readCommitContextMode, resolveCommitContextInput, } from "./iteration-log.js";
 import { inferProviderFromCommand, isSessionProvider, providerCliCommand, SESSION_PROVIDERS } from "./session-provider.js";
 import { buildProviderResumeCommand, isProviderSessionId } from "./resume-policy.js";
 import { parseBoundedInteger } from "./request-limits.js";
@@ -27,6 +28,23 @@ export function parseExecutionMode(value, fallback) {
     }
     return value;
 }
+/** 提交输入模式：query 覆盖 > 记住的偏好 > 默认（有提示词就优先用提示词）。 */
+function commitModeForRead(storage, override) {
+    return readCommitContextMode(storage, override);
+}
+/**
+ * 生成 commit message 的输入：迭代模式下给「本轮提示词清单」，
+ * 切到 diff 模式、或本轮没记录到任何提示词时给空 digest（调用方自动读完整 diff）。
+ */
+async function iterationCommitInput(storage, snapshot, body) {
+    const context = await buildIterationCommitContext(storage, { session: snapshot });
+    const input = resolveCommitContextInput(storage, context, body);
+    return { digest: input.digest, entryIds: input.entryIds, iteration: context.iteration };
+}
+/** 只有「让模型自己写 message」时才把迭代提示词交给它；用户手写的 message 不需要读任何输入。 */
+function commitMessageFromIteration(body) {
+    return body.autoMessage !== false && !body.customMessage?.trim();
+}
 export function parseSessionCreationOrigin(body) {
     const rawSource = body?.sessionSource;
     if (rawSource !== undefined && rawSource !== "interactive" && rawSource !== "automation" && rawSource !== "startup") {
@@ -451,6 +469,23 @@ export function registerSessionRoutes(app, processes, structured, storage, defau
             syncWorkspaceTaskToBoard(storage, snapshot.workspaceTaskId);
             const prompt = body.prompt?.trim();
             if (prompt) {
+                if (body.respondImmediately === true) {
+                    // 只创建、不等首轮：整轮可能是几分钟，调用方（新建任务对话框、worktree 合并）
+                    // 等在 HTTP 上会把用户锁在「正在创建…」且关闭按钮被禁用。与
+                    // /api/sessions/:id/input 的 respondImmediately、/api/wand-tasks/:id/dispatch
+                    // 一致：先回会话快照，首轮进度继续走结构化事件。
+                    structured.sendMessage(snapshot.id, prompt).catch((error) => {
+                        console.error("[wand] Accepted structured prompt later failed", {
+                            sessionId: snapshot.id,
+                            error: getInputDebugMeta(error),
+                        });
+                    });
+                    const accepted = structured.get(snapshot.id);
+                    if (!accepted)
+                        throw new Error("未找到该结构化会话。");
+                    res.status(201).json(sessionResponseDTO(accepted));
+                    return;
+                }
                 const finished = await structured.sendMessage(snapshot.id, prompt);
                 res.status(201).json(finished);
                 return;
@@ -755,6 +790,8 @@ export function registerSessionRoutes(app, processes, structured, storage, defau
         const body = (req.body ?? {});
         try {
             const ai = resolveCommitAiContext(snapshot, config);
+            // 自动 message + 迭代模式：拿本轮提示词当输入；提交成功后标记已用掉。
+            const context = await iterationCommitInput(storage, snapshot, body);
             const result = await runQuickCommitWithFallback({
                 cwd: snapshot.cwd,
                 language: config.language ?? "",
@@ -765,8 +802,21 @@ export function registerSessionRoutes(app, processes, structured, storage, defau
                 autoTag: !!body.autoTag,
                 push: !!body.push,
                 submodule: !!body.submodule,
+                iterationDigest: commitMessageFromIteration(body) ? context.digest : "",
+                includeDiff: !!body.includeDiff,
+            });
+            const consumed = result.ok && result.commit?.hash && context.entryIds.length > 0
+                ? storage.markIterationPromptsConsumed(context.entryIds, result.commit.hash)
+                : 0;
+            res.json({
+                ...result,
+                commitContext: {
+                    source: commitMessageFromIteration(body) && context.digest ? "iteration" : "diff",
+                    entryIds: context.entryIds,
+                    iteration: context.iteration,
+                },
+                iterationEntriesConsumed: consumed,
             });
-            res.json(result);
         }
         catch (error) {
             if (error instanceof QuickCommitError) {
@@ -777,6 +827,37 @@ export function registerSessionRoutes(app, processes, structured, storage, defau
             sendRouteError(res, error, "快捷提交失败。");
         }
     }));
+    // 本轮迭代的提示词清单：快捷提交面板默认勾选「上次提交以来」的那些，
+    // 也可以往回勾已提交过的历史，或者整套切成读 diff。
+    app.get("/api/sessions/:id/iteration-context", asyncRoute(async (req, res) => {
+        const snapshot = sessions.getLatest(req.params.id);
+        if (!snapshot) {
+            res.status(404).json({ error: "未找到该会话。" });
+            return;
+        }
+        const milestoneId = typeof req.query.milestoneId === "string" ? req.query.milestoneId : null;
+        try {
+            const context = await buildIterationCommitContext(storage, { session: snapshot, milestoneId });
+            res.json({ ...context, mode: commitModeForRead(storage, req.query.mode) });
+        }
+        catch (error) {
+            sendRouteError(res, error, "无法读取本轮变更。");
+        }
+    }));
+    // 记住用户选的模式（只存偏好，不碰仓库）。
+    app.post("/api/sessions/:id/iteration-context", (req, res) => {
+        if (!sessions.getLatest(req.params.id)) {
+            res.status(404).json({ error: "未找到该会话。" });
+            return;
+        }
+        const mode = (req.body ?? {}).mode;
+        if (!isCommitContextMode(mode)) {
+            res.status(400).json({ error: "无效的提交输入模式。" });
+            return;
+        }
+        storage.setPreference(COMMIT_CONTEXT_MODE_PREF_KEY, mode);
+        res.json({ ok: true, mode });
+    });
     app.post("/api/sessions/:id/generate-commit-message", asyncRoute(async (req, res) => {
         const snapshot = sessions.getLatest(req.params.id);
         if (!snapshot) {
@@ -787,12 +868,24 @@ export function registerSessionRoutes(app, processes, structured, storage, defau
             res.status(400).json({ error: "会话没有工作目录。" });
             return;
         }
+        const body = (req.body ?? {});
         try {
             const ai = resolveCommitAiContext(snapshot, config);
+            const context = await iterationCommitInput(storage, snapshot, body);
             const result = await generateCommitMessageOnly(snapshot.cwd, config.language ?? "", {
                 ...ai,
+            }, {
+                iterationDigest: context.digest,
+                includeDiff: !!body.includeDiff,
+            });
+            res.json({
+                ...result,
+                commitContext: {
+                    source: context.digest ? "iteration" : "diff",
+                    entryIds: context.entryIds,
+                    iteration: context.iteration,
+                },
             });
-            res.json(result);
         }
         catch (error) {
             if (error instanceof QuickCommitError) {

package/dist/server-task-routes.js

@@ -3,8 +3,9 @@ import { asyncRoute } from "./express-async.js";
 import { getErrorMessage } from "./error-utils.js";
 import { bodyObject, sendRouteError, text } from "./server-request.js";
 import { parseWandTaskAgent } from "./storage.js";
-import { scopedMilestoneId } from "./milestone-scope.js";
+import { defaultMilestoneIdForWrite, resolvedMilestoneFields, scopedMilestoneId } from "./milestone-scope.js";
 import { generateWandTaskTitle, provisionalTaskTitleFromDescription, TASK_TITLE_MAX_LENGTH } from "./task-title.js";
+import { recordIterationPromptForTask } from "./iteration-log.js";
 import { resolveSystemAiContext } from "./session-ai-context.js";
 import { DEFAULT_WAND_TASK_AGENT_KIND, DEFAULT_WAND_TASK_AGENT_MODE, DEFAULT_WAND_TASK_PRIORITY, isWandTaskAgentKind, isWandTaskAgentMode, normalizeWandTaskAgentMode, WAND_MILESTONE_NAME_MAX_LENGTH } from "./task-types.js";
 import { archiveBoardTask, ensureWorkspaceTaskForBoardTask, isAutoNameableBoardTask, moveSessionToWorkspaceTask, syncClosedBoardTask, syncUngroupedSessionsToBoard, syncWorkspaceTaskToBoard, taskAutoNameSignature, taskAutoNameSourceText } from "./wand-task-sync.js";
@@ -117,7 +118,7 @@ function taskDto({ storage, sessions }, task) {
         return null;
     const workspace = task.workspaceId ? storage.getWorkspace(task.workspaceId) : null;
     const sessionIds = storage.listWandTaskSessionIds(task.id);
-    const milestone = task.milestoneId ? storage.getWandMilestone(task.milestoneId) : null;
+    const milestone = resolvedMilestoneFields(storage, task.milestoneId);
     return {
         ...task,
         sessionIds,
@@ -128,8 +129,10 @@ function taskDto({ storage, sessions }, task) {
         workspace: workspace
             ? { id: workspace.id, name: workspace.name, cwd: workspace.cwd }
             : null,
-        // 卡片上要显示里程碑名字，直接在这里解出，免去前端再查一次列表。
-        milestone: milestone ? { id: milestone.id, name: milestone.name } : null,
+        // 卡片上要显示迭代名字，直接在这里解出，免去前端再查一次列表。
+        // 任务没有单独指定迭代时给的就是默认迭代（id 与名字成对返回）。
+        milestoneId: milestone.milestoneId,
+        milestone: milestone.milestone,
     };
 }
 function taskSessionSummary(session) {
@@ -254,10 +257,12 @@ export function registerTaskRoutes(app, deps) {
     app.get("/api/wand-task-agent-defaults", (_req, res) => {
         res.json(readTaskBoardLastAgent(storage));
     });
-    // ── 里程碑（迭代）：归属工作区，任务面板的「新建任务」按工作区过滤 ──
+    // ── 迭代（里程碑）：归属工作区，任务面板的「新建任务」按工作区过滤 ──
     app.get("/api/wand-milestones", (req, res) => {
-        // 不传 workspaceId 返回全部；传了就只给「该工作区 + 全局」的里程碑。
+        // 不传 workspaceId 返回全部；传了就只给「该工作区 + 全局」的迭代。
         const workspaceId = typeof req.query.workspaceId === "string" ? req.query.workspaceId : null;
+        // 默认迭代是惰性创建的：列表是它的第一个真实读取点，在这里保证它一定存在。
+        storage.ensureDefaultWandMilestone();
         const counts = storage.countWandTasksByMilestone();
         res.json({
             milestones: storage.listWandMilestones(workspaceId).map((milestone) => ({
@@ -319,6 +324,12 @@ export function registerTaskRoutes(app, deps) {
         }
     });
     app.delete("/api/wand-milestones/:id", (req, res) => {
+        const current = storage.getWandMilestone(req.params.id);
+        // 默认迭代是所有任务的兜底归属，删了就再没有地方接「没选迭代」的任务。
+        if (current?.isDefault) {
+            res.status(400).json({ error: "默认迭代不能删除，可以改成你自己习惯的名字。" });
+            return;
+        }
         // 只解绑任务，不删任务；已经删过的 id 幂等返回 ok。
         storage.deleteWandMilestone(req.params.id);
         res.json({ ok: true });
@@ -356,7 +367,10 @@ export function registerTaskRoutes(app, deps) {
                 writeTaskBoardLastAgent(storage, agent);
             const labels = labelsFrom(body.labels);
             const dueDate = dateValue(body.dueDate) ?? null;
-            const milestoneId = scopedMilestoneId(storage, milestoneIdFrom(storage, body.milestoneId), workspaceId);
+            // 没选迭代就落到默认迭代：每个任务都属于一个迭代。
+            const requestedMilestoneId = milestoneIdFrom(storage, body.milestoneId) ?? defaultMilestoneIdForWrite(storage);
+            const milestoneId = scopedMilestoneId(storage, requestedMilestoneId, workspaceId)
+                ?? defaultMilestoneIdForWrite(storage);
             const task = storage.transaction(() => {
                 const card = storage.createWandTask({
                     workspaceId,
@@ -414,18 +428,21 @@ export function registerTaskRoutes(app, deps) {
                 patch.labels = labelsFrom(body.labels);
             if (body.dueDate !== undefined)
                 patch.dueDate = dateValue(body.dueDate) ?? null;
-            if (body.milestoneId !== undefined)
-                patch.milestoneId = milestoneIdFrom(storage, body.milestoneId);
+            if (body.milestoneId !== undefined) {
+                // 清空迭代等于回到默认迭代（原生端的「清除」按钮也走这里）。
+                patch.milestoneId = milestoneIdFrom(storage, body.milestoneId) ?? defaultMilestoneIdForWrite(storage);
+            }
             if (body.workspaceId !== undefined) {
                 const workspaceId = body.workspaceId === null ? null : text(body.workspaceId);
                 if (workspaceId && !storage.getWorkspace(workspaceId))
                     throw new Error("项目不存在。");
                 patch.workspaceId = workspaceId || null;
-                // 换项目后原迭代不再属于新工作区就一并摘掉；移动端只 PATCH workspaceId，不会自己清。
+                // 换项目后原迭代不再属于新工作区就一并收敛；移动端只 PATCH workspaceId，不会自己清。
                 const milestoneId = body.milestoneId !== undefined
                     ? patch.milestoneId
                     : storage.getWandTask(req.params.id)?.milestoneId ?? null;
-                patch.milestoneId = scopedMilestoneId(storage, milestoneId, patch.workspaceId);
+                patch.milestoneId = scopedMilestoneId(storage, milestoneId, patch.workspaceId)
+                    ?? defaultMilestoneIdForWrite(storage);
             }
             if (body.agent !== undefined) {
                 // 老客户端不传 mode / kind：沿用任务当前值，而不是复位成标准 / 结构化。
@@ -560,6 +577,17 @@ export function registerTaskRoutes(app, deps) {
                 });
             storage.updateWandTask(task.id, { agent, status: task.status === "todo" ? "doing" : task.status });
             storage.bindWandTaskSession(task.id, session.id);
+            // 派发也算一轮迭代里的改动意图：直接把任务的标题 / 描述记进迭代记录。
+            recordIterationPromptForTask(storage, {
+                sessionId: session.id,
+                cwd,
+                workspaceId: group.workspaceId,
+                milestoneId: task.milestoneId,
+                taskId: task.id,
+                title: task.title,
+                detail: task.description || prompt,
+                source: "dispatch",
+            });
             if (agent.kind !== "pty") {
                 const completion = structured.sendMessage(session.id, prompt);
                 completion.catch((error) => console.error(`[WandTask] Agent dispatch failed for ${task.id}:`, error));

package/dist/server-workspace-routes.js

@@ -9,7 +9,7 @@ import { checkSessionWorktreeMergeabilityAsync, cleanupWorktreeSync, prepareSess
 import { collectSessionTopicBlocklist } from "./session-topic.js";
 import { resolveSessionDisplayTitle } from "./session-transport.js";
 import { attachUnboundSessionsToWorkspace, backfillSessionWorkspaces, normalizeProjectCwd, projectCwdForSession, isGlobalWorkspace, syncDirectoryNameForWorkspace } from "./workspace-binding.js";
-import { scopedMilestoneId } from "./milestone-scope.js";
+import { defaultMilestoneIdForWrite, resolvedMilestoneFields, scopedMilestoneId } from "./milestone-scope.js";
 import { archiveBoardTaskForWorkspaceTask, archiveWorkspaceTask, ensureBoardTaskForWorkspaceTask, isUnnamedWorkspaceTaskName, moveSessionToWorkspaceTask, syncSidebarTasksFromBoard, UNNAMED_WORKSPACE_TASK_NAME } from "./wand-task-sync.js";
 import { isSessionProvider } from "./session-provider.js";
 import { firstLayoutTabId } from "./layout-tree.js";
@@ -124,7 +124,7 @@ function createTaskForWorkspace(storage, workspace, body) {
     if (requestedMilestoneId && !storage.getWandMilestone(requestedMilestoneId)) {
         throw new Error("未找到该里程碑。");
     }
-    const milestoneId = scopedMilestoneId(storage, requestedMilestoneId || null, isGlobalWorkspace(workspace) ? null : workspace.id);
+    const milestoneId = scopedMilestoneId(storage, requestedMilestoneId || null, isGlobalWorkspace(workspace) ? null : workspace.id) ?? defaultMilestoneIdForWrite(storage);
     let mountedCwd;
     if (body.cwd !== undefined && body.cwd !== null && String(body.cwd).trim()) {
         mountedCwd = resolveWorkspaceCwd(body.cwd);
@@ -429,6 +429,7 @@ export function registerWorkspaceRoutes(app, storage, sessions, titleOptions = {
             refreshAutoBoardTaskTitles(storage, titleOptions);
             res.status(201).json({
                 ...created.task,
+                ...resolvedMilestoneFields(storage, created.task.milestoneId),
                 cwd: created.cwd,
                 isolated: created.isolated,
                 worktreeError: created.worktreeError,
@@ -539,6 +540,8 @@ export function registerWorkspaceRoutes(app, storage, sessions, titleOptions = {
             }));
             target.tasks.push({
                 ...task,
+                // 没单独指定迭代的任务读作默认迭代（id 与名字成对）。
+                ...resolvedMilestoneFields(storage, task.milestoneId),
                 cwd: taskRuntimeCwd(task, workspace),
                 isolated: task.worktree !== null,
                 sessions,
@@ -640,7 +643,10 @@ export function registerWorkspaceRoutes(app, storage, sessions, titleOptions = {
             res.status(404).json({ error: "未找到该项目。" });
             return;
         }
-        res.json(storage.listWorkspaceTasks(workspace.id));
+        res.json(storage.listWorkspaceTasks(workspace.id).map((task) => ({
+            ...task,
+            ...resolvedMilestoneFields(storage, task.milestoneId),
+        })));
     });
     // 项目级 Worktree 总览：一次解析默认目标分支，再为每个任务读取可合并状态。
     app.get("/api/workspaces/:id/worktrees", asyncRoute(async (req, res) => {
@@ -730,6 +736,7 @@ export function registerWorkspaceRoutes(app, storage, sessions, titleOptions = {
             refreshAutoBoardTaskTitles(storage, titleOptions);
             res.status(201).json({
                 ...created.task,
+                ...resolvedMilestoneFields(storage, created.task.milestoneId),
                 cwd: created.cwd,
                 isolated: created.isolated,
                 worktreeError: created.worktreeError,
@@ -750,6 +757,7 @@ export function registerWorkspaceRoutes(app, storage, sessions, titleOptions = {
         const workspace = storage.getWorkspace(task.workspaceId);
         res.json({
             ...task,
+            ...resolvedMilestoneFields(storage, task.milestoneId),
             cwd: taskRuntimeCwd(task, workspace),
             sessions: storage.listSessionsByWorkspaceTaskSlim(task.id).map((session) => ({
                 ...workspaceSessionSummary(session, {
@@ -795,12 +803,17 @@ export function registerWorkspaceRoutes(app, storage, sessions, titleOptions = {
                 sendRouteError(res, new Error("未找到该里程碑。"), "无法更新任务。");
                 return;
             }
-            patch.milestoneId = milestoneId || null;
+            // 清空迭代等于回到默认迭代（老客户端不传时不会走到这里）。
+            patch.milestoneId = milestoneId || defaultMilestoneIdForWrite(storage);
         }
         storage.updateWorkspaceTask(existing.id, patch);
         if (patch.status === "done")
             archiveBoardTaskForWorkspaceTask(storage, existing.id);
-        res.json(storage.getWorkspaceTask(existing.id));
+        const updated = storage.getWorkspaceTask(existing.id);
+        res.json({
+            ...updated,
+            ...resolvedMilestoneFields(storage, updated?.milestoneId),
+        });
     });
     // 归档任务：软删除。终端继续运行、worktree 与卡片历史都保留，只是侧栏不再显示。
     app.post("/api/workspace-tasks/:taskId/archive", (req, res) => {
@@ -810,7 +823,11 @@ export function registerWorkspaceRoutes(app, storage, sessions, titleOptions = {
             return;
         }
         archiveWorkspaceTask(storage, existing);
-        res.json(storage.getWorkspaceTask(existing.id));
+        const archived = storage.getWorkspaceTask(existing.id);
+        res.json({
+            ...archived,
+            ...resolvedMilestoneFields(storage, archived?.milestoneId),
+        });
     });
     // 删除任务；cascade=true 连带删会话，否则仅解绑；尽力清理 worktree
     app.delete("/api/workspace-tasks/:taskId", (req, res) => {

package/dist/session-topic.d.ts

@@ -39,6 +39,9 @@ export declare function collectSessionTopicBlocklist(input: {
     cwd?: string;
 }): string[];
 export declare function shouldAcceptGeneratedSessionTitle(title: string, blockedTitles?: readonly string[]): boolean;
+export declare function measureSessionTopicInputWeight(input: string): number;
+/** 太短的用户输入不值得生成标题，也不应该覆盖已有标题。 */
+export declare function shouldGenerateSessionTopicFromInput(input: string): boolean;
 /** Immediate title from the user's command, without waiting for the model. */
 export declare function summarizeSessionTitleFromInput(input: string, options?: {
     blockedTitles?: readonly string[];
@@ -63,6 +66,7 @@ export declare function generateSessionTopic(userMessages: readonly string[], cw
 /**
  * Coalesces title refreshes per session. A newer user message invalidates an
  * in-flight result and is summarized together with every earlier user turn.
+ * Short inputs (single commands, choices) are dropped before any model call.
  */
 export declare class SessionTopicCoordinator {
     private readonly generate;

package/dist/session-topic.js

@@ -141,6 +141,24 @@ export function shouldAcceptGeneratedSessionTitle(title, blockedTitles = []) {
         return false;
     return !blockedTitles.some((blocked) => isSameSessionTitle(cleaned, blocked));
 }
+const CJK_CHARACTER_PATTERN = /[\u3040-\u30ff\u3400-\u4dbf\u4e00-\u9fff\uf900-\ufaff\uac00-\ud7af]/g;
+/**
+ * 用户输入的「信息量」：CJK 字符按 2 计，其余非空白字符按 1 计。
+ * 单条命令（`pwd`、`git status`）、选择与确认（`y`、`1`、`好的`）、斜杠命令（`/compact`）
+ * 都低于阈值：让模型总结只会把输入复述一遍，还多花一次调用。
+ */
+const SESSION_TOPIC_INPUT_MIN_WEIGHT = 12;
+export function measureSessionTopicInputWeight(input) {
+    const text = input.replace(/\s+/g, "");
+    if (!text)
+        return 0;
+    const cjkCount = text.match(CJK_CHARACTER_PATTERN)?.length ?? 0;
+    return cjkCount * 2 + (text.length - cjkCount);
+}
+/** 太短的用户输入不值得生成标题，也不应该覆盖已有标题。 */
+export function shouldGenerateSessionTopicFromInput(input) {
+    return measureSessionTopicInputWeight(input) >= SESSION_TOPIC_INPUT_MIN_WEIGHT;
+}
 /** Immediate title from the user's command, without waiting for the model. */
 export function summarizeSessionTitleFromInput(input, options = {}) {
     const blockedTitles = options.blockedTitles ?? [];
@@ -248,6 +266,7 @@ export async function generateSessionTopic(userMessages, cwd, language, ai = {})
 /**
  * Coalesces title refreshes per session. A newer user message invalidates an
  * in-flight result and is summarized together with every earlier user turn.
+ * Short inputs (single commands, choices) are dropped before any model call.
  */
 export class SessionTopicCoordinator {
     generate;
@@ -260,7 +279,7 @@ export class SessionTopicCoordinator {
         if (this.disposed)
             return;
         const input = request.input.trim();
-        if (!input)
+        if (!input || !shouldGenerateSessionTopicFromInput(input))
             return;
         let state = this.states.get(sessionId);
         if (!state) {

package/dist/storage.d.ts

@@ -143,20 +143,61 @@ export declare class WandStorage {
      */
     listWandMilestones(workspaceId?: string | null): import("./task-types.js").WandTaskMilestone[];
     getWandMilestone(id: string): import("./task-types.js").WandTaskMilestone | null;
+    /** 已有的默认迭代；未创建过时返回 null（读路径用它，不写库）。 */
+    findDefaultWandMilestone(): import("./task-types.js").WandTaskMilestone | null;
+    /**
+     * 惰性拿到全局唯一的「默认迭代」：没有就建一个，返回值一定可写进任务 / 记录。
+     * 用户已经自己建过一个同名迭代时直接把它提升为默认，不再造第二个重名行。
+     */
+    ensureDefaultWandMilestone(): import("./task-types.js").WandTaskMilestone;
     createWandMilestone(input: {
         name: string;
         dueDate?: string | null;
         workspaceId?: string | null;
+        isDefault?: boolean;
     }): import("./task-types.js").WandTaskMilestone;
     updateWandMilestone(id: string, patch: {
         name?: string;
         dueDate?: string | null;
         workspaceId?: string | null;
     }): import("./task-types.js").WandTaskMilestone | null;
-    /** 删除里程碑只解绑任务（milestone_id 置空），绝不删除任务。 */
+    /**
+     * 删除里程碑只解绑任务（milestone_id 置空）、并把提示词记录改挂到默认迭代，绝不删任务与记录。
+     * 默认迭代不可删除：返回 false，由调用方给出明确提示。
+     */
     deleteWandMilestone(id: string): boolean;
-    /** 各里程碑下的任务数（看板卡片），用于下拉里的数量提示。 */
+    /** 各迭代下的任务数（看板卡片），用于下拉里的数量提示；历史 NULL 行算在默认迭代里。 */
     countWandTasksByMilestone(): Record<string, number>;
+    /** 同一会话最近一条记录；用来去重（同一提示词重复提交 / 占位与模型结果双写）。 */
+    latestIterationPromptForSession(sessionId: string): import("./task-types.js").WandIterationPrompt | null;
+    createIterationPrompt(input: {
+        milestoneId: string;
+        workspaceId?: string | null;
+        sessionId?: string | null;
+        taskId?: string | null;
+        repoKey?: string | null;
+        cwd?: string;
+        title: string;
+        detail?: string;
+        source?: import("./task-types.js").WandIterationPromptSource;
+    }): import("./task-types.js").WandIterationPrompt;
+    /**
+     * 迭代窗口里的提示词记录，按时间正序（模型读起来就是「先做什么、后做什么」）。
+     * `repoKey` 给值时按仓库隔离；`includeConsumed=false` 只看还没提交的部分。
+     */
+    listIterationPrompts(filter?: {
+        milestoneId?: string | null;
+        repoKey?: string | null;
+        sessionId?: string | null;
+        includeConsumed?: boolean;
+        limit?: number;
+    }): import("./task-types.js").WandIterationPrompt[];
+    /** 按 id 批量取记录（用户只勾选了一部分历史变更时用）。 */
+    listIterationPromptsByIds(ids: readonly string[]): import("./task-types.js").WandIterationPrompt[];
+    /** 标记这些记录已被某次提交用掉，下一轮「上次提交以来」从这里开始。 */
+    markIterationPromptsConsumed(ids: readonly string[], commit: string): number;
+    /** 会话绑定的看板任务 id；没绑或已删除时返回 null。 */
+    getWandTaskIdForSession(sessionId: string): string | null;
     listWandTaskSessionIds(taskId: string): string[];
     listBoundWandTaskSessionIds(): string[];
     bindWandTaskSession(taskId: string, sessionId: string): void;