@co0ontty/wand 4.83.1 → 4.84.0

package/dist/ai-team-types.d.ts

@@ -18,6 +18,9 @@ export interface AiTeamMember {
     id: string;
     /** 通讯录身份链接；缺省是独立 CLI 成员，不按名字猜测。 */
     employeeId?: string;
+    /** Group-only identity for unbound legacy preset members; never guessed from a name. */
+    legacyTemplateId?: string;
+    legacyMemberId?: string;
     name: string;
     /** 职责说明，原样写进提示词。 */
     duty: string;
@@ -28,7 +31,7 @@ export interface AiTeamMember {
     /** 职责标注；缺省视同 "any"。 */
     role?: TeamMemberRole;
     isLeader: boolean;
-    /** 头像：空串按 id 哈希选毛色；"cat:<n>" 指定毛色；"data:image/…" 为用户上传的小图。 */
+    /** 头像：空串按身份生成（渐变底 + 名字首字）；"cat:<n>" 指定毛色；"data:image/…" 为用户上传的小图。 */
     avatar?: string;
 }
 /**
@@ -45,7 +48,7 @@ export declare function memberAgents(member: {
  */
 export declare function agentKey(agent: WandTaskAgent): string;
 /** 启动失败分类（§3.4）；ai-team-availability（T2）复用此联合类型。 */
-export type CandidateFailureKind = "spawn-missing" | "host-disabled" | "model-unknown" | "startup-timeout" | "runtime-failure" | "format-error" | "user-stop";
+export type CandidateFailureKind = "spawn-missing" | "input-rejected" | "host-disabled" | "model-unknown" | "startup-timeout" | "runtime-failure" | "format-error" | "user-stop";
 /** 步骤实际派发用的候选与本步之前跳过的候选（§3.2，存 ai_team_steps.dispatch_info_json）。 */
 export interface StepDispatchInfo {
     usedCandidate: number;
@@ -77,14 +80,18 @@ export interface SiliconEmployee {
     updatedAt: string;
 }
 /**
- * AI 按自然语言期望起草的员工配置：只带一个首选执行候选，
- * 其余手动字段（头像、备用候选）仍由表单和「高级配置」负责。
+ * AI 按自然语言期望起草（或结构化校验后）的员工配置：agent 是首选执行候选，
+ * candidates 是已校验的完整候选清单。其余手动字段（头像等）仍由表单和「高级配置」负责。
  */
 export interface SiliconEmployeeDraft {
     name: string;
     duty: string;
     prompt: string;
     agent: WandTaskAgent;
+    /**
+     * IM-11 新增：已校验的执行候选，首项即 agent；旧客户端继续只读 agent 不受影响。
+     */
+    candidates?: WandTaskAgent[];
 }
 export declare const AI_TEAM_AVATAR_MAX_CHARS = 60000;
 export declare const SILICON_EMPLOYEE_AVATAR_MAX_CHARS = 60000;
@@ -114,6 +121,8 @@ export interface AiTeam {
     /** 协作指令：分工、工作要求与注意事项，写进负责人和成员的提示词。 */
     instructions: string;
     members: AiTeamMember[];
+    /** Per-run @ coordinator may take a duty-specific work step in a separate stage session. */
+    allowLeaderWork?: boolean;
     requirePlanApproval: boolean;
     /** Leader 轮次 + 成员步骤合计的上限。 */
     maxSteps: number;
@@ -127,7 +136,11 @@ export declare const AI_TEAM_TERMINAL_RUN_STATUSES: readonly AiTeamRunStatus[];
 export interface AiTeamRun {
     id: string;
     teamId: string;
-    /** 执行快照；仅 runner 在明确续跑/回复边界按规则刷新，展示层改名不写回这里。 */
+    /** 群实例运行全程冻结；预设旧 CLI 运行保留兼容刷新规则。 */
+    conversationId?: string;
+    memberVersion?: number;
+    roundNumber?: number;
+    /** 执行快照；展示层改名不写回这里。 */
     team: AiTeam;
     taskId: string;
     objective: string;
@@ -210,11 +223,42 @@ export interface AiTeamStep {
 export interface AiTeamRunSummary extends AiTeamRun {
     taskTitle: string;
     taskIdentifier: string;
+    /**
+     * 活动时间投影（派生、不入库）。本机服务端总是带；旧服务端或测试夹具可能缺省，
+     * 读取端按可选处理，不要在缺省时把 `updatedAt` 当活动证据（长静默期它不动）。
+     */
+    activity?: AiTeamRunActivity;
 }
 /** detail() 里群聊回合的截尾条数（§4.4）：面板只给最近这一段，完整会话走「打开群聊」。 */
 export declare const AI_TEAM_DETAIL_CHAT_TURNS = 200;
 /** live 卡片文本的尾部保留上限（§4.9），超出部分回报 omittedChars 给前端显示「已省略前面 N 字」。 */
 export declare const AI_TEAM_LIVE_TEXT_MAX_CHARS = 2000;
+/**
+ * 静默心跳阈值：run 处于 running 且这段时间内没有任何可观测活动，就重推一次 live 快照
+ * 和一次 `ai-team-run` 通知（与会话侧的静默口径同一数值）。阈值只决定**重推频率**，
+ * 不引入新事件类型，也不是轮询：计时器每个 run 至多一个，run 离开 running 即 cancel。
+ */
+export declare const AI_TEAM_SILENCE_HEARTBEAT_MS = 30000;
+/**
+ * run 级活动时间的投影，读取时派生、**不入库**（`ai_team_runs` 没有对应列，也不加）：
+ * 长任务静默期（模型在想、在跑一条长命令）界面上要能区分「还在跑」和「卡死了」。
+ */
+export interface AiTeamRunActivity {
+    /**
+     * 本轮开始 = `run.createdAt`。终态 run 也照原值返回，客户端可以继续显示「共运行 N 分钟」；
+     * 它不是心跳时间，不会随推送前进。
+     */
+    startedAt: string;
+    /**
+     * 最近一次**可观测活动**的时刻：live 文本/状态/输出增长、步骤开始或结束、run 状态写入。
+     * 心跳不推进它 —— 只有真实活动才变，所以「startedAt 在走、lastActivityAt 不动」正是
+     * 「仍在跑、只是这一轮安静」的判据。终态 run 取最后一次活动的时刻（等于结束时的
+     * `run.updatedAt`），之后不再变化；缺证据时退回 `startedAt`，不会返回未来时间。
+     */
+    lastActivityAt: string;
+    /** 服务端生成这份投影的时刻；客户端用它算「N 秒前」，不受两端时钟偏差影响。 */
+    observedAt: string;
+}
 /**
  * 一个正在干活的运行中步骤的实时快照（§4.9）：Web 走 ai-team-step-live 推送，
  * 移动端轮询 GET /api/ai-team-runs/:id/live，两边共用这个形状。
@@ -238,18 +282,61 @@ export interface AiTeamLiveStep {
     /** renderLiveStepText 的渲染结果，尾部保留、至多 AI_TEAM_LIVE_TEXT_MAX_CHARS 字。 */
     text: string;
     omittedChars: number;
+    /**
+     * 本步开始执行的时刻（= `AiTeamStep.startedAt`，步骤进入 running 时写入）。
+     * 客户端用它算「这步已运行 N 分钟」；理论上 running 步都有值，旧数据缺省时为 null，
+     * 客户端按「没有开始时间」处理，不要拿 updatedAt 代替。
+     */
+    startedAt: string | null;
+    /**
+     * 这一步最近一次**可观测活动**的时刻：live 文本、思考/输出增量或活动状态发生变化才前进。
+     * 静默期（模型在想、在跑长命令、没有新输出）它保持不变，此时靠 `heartbeat` 快照证明还活着。
+     * 首次观察到该步时以 `startedAt` 为基线（不假造「刚刚有活动」），所以它不会早于 startedAt、
+     * 也不会晚于生成这次快照的时刻。步骤结束后该步不再出现在 live 列表里，本字段随之消失。
+     */
+    lastActivityAt: string;
+    /** 本次快照的生成时刻（不是活动时刻）：每次推送/轮询都会前进，别拿它判断「有没有新进展」。 */
     updatedAt: string;
 }
 /** notifyLive 回调与 ai-team-step-live 通知的 payload（§4.9）。 */
 export interface AiTeamLiveUpdate {
     runId: string;
     taskId: string;
+    /**
+     * 推送时的 run 状态；客户端据此区分「在跑」「等批准」「已结束」，不必再拉 detail。
+     * 本机服务端总是带；未升级的转发层或旧服务端可能缺省，读取端按可选处理。
+     */
+    status?: AiTeamRunStatus;
+    /** run 级活动时间；与 steps 同级，避免为「仍在运行」指示再多打一次 detail。同上，可选项。 */
+    activity?: AiTeamRunActivity;
+    /**
+     * true = 静默超阈值的重推：内容与上一次可能逐字相同，但 `activity.observedAt` 是新的，
+     * 语义是「服务端此刻仍在跟踪这个 run」。真实内容变化产生的推送这里是 false，
+     * 缺省按 false 处理。run 进入终态后不会再有 heartbeat 推送。
+     */
+    heartbeat?: boolean;
+    steps: AiTeamLiveStep[];
+}
+/**
+ * `GET /api/ai-team-runs/:id/live` 的回包（§4.9.1）：轮询侧的 live 快照 + run 级活动时间。
+ * 轮询本身就是「服务端此刻的真实观察」，所以没有 heartbeat 标记，只有推送通道才有。
+ */
+export interface AiTeamLiveSnapshot {
+    runId: string;
+    /** 投影时的 run 状态；轮询端不必为「还在跑吗」再拉一次 detail。 */
+    status: AiTeamRunStatus;
+    activity: AiTeamRunActivity;
     steps: AiTeamLiveStep[];
 }
 export interface AiTeamRunDetail {
     run: AiTeamRun;
     /** One run's result/files/current handoffs; absent on older servers, no side effects. */
     delivery?: AiTeamDeliverySummary;
+    /**
+     * 活动时间投影（派生、不入库）：长任务静默期靠它显示「已运行 N 分钟、M 秒前有活动」。
+     * 本机的 detail() 总是带；旧服务端缺省时读取端要退回 `run.updatedAt`，不能当作活动证据。
+     */
+    activity?: AiTeamRunActivity;
     /** 仅供展示的群名，读取当前任务标题，不以团队名代替。 */
     chatTitle?: string;
     /** 任务标题的版本；任务改名不改变 run.updatedAt。 */

package/dist/ai-team-types.js

@@ -23,7 +23,8 @@ export function memberAgents(member) {
  * 按字面量比较：model:"default" 不与具体默认模型名做等价归一。
  */
 export function agentKey(agent) {
-    return `${agent.provider}|${agent.model}|${agent.thinkingEffort}|${agent.mode}|${agent.kind}`;
+    const engine = agent.engine === "sdk" ? "|sdk" : "";
+    return `${agent.provider}|${agent.model}|${agent.thinkingEffort}|${agent.mode}|${agent.kind}${engine}`;
 }
 export const AI_TEAM_AVATAR_MAX_CHARS = 60_000;
 export const SILICON_EMPLOYEE_AVATAR_MAX_CHARS = 60_000;
@@ -94,9 +95,15 @@ export const AI_TEAM_ACTIVE_RUN_STATUSES = ["running", "awaiting_approval", "wai
 export const AI_TEAM_TERMINAL_RUN_STATUSES = ["done", "failed", "stopped"];
 /** 群聊名从任务标题派生；不修改团队定义，也不回写历史消息。 */
 export function aiTeamChatTitle(taskTitle) {
-    return `${taskTitle?.trim() ?? ""}任务处理群`;
+    return taskTitle?.trim() || "群聊";
 }
 /** detail() 里群聊回合的截尾条数（§4.4）：面板只给最近这一段，完整会话走「打开群聊」。 */
 export const AI_TEAM_DETAIL_CHAT_TURNS = 200;
 /** live 卡片文本的尾部保留上限（§4.9），超出部分回报 omittedChars 给前端显示「已省略前面 N 字」。 */
 export const AI_TEAM_LIVE_TEXT_MAX_CHARS = 2000;
+/**
+ * 静默心跳阈值：run 处于 running 且这段时间内没有任何可观测活动，就重推一次 live 快照
+ * 和一次 `ai-team-run` 通知（与会话侧的静默口径同一数值）。阈值只决定**重推频率**，
+ * 不引入新事件类型，也不是轮询：计时器每个 run 至多一个，run 离开 running 即 cancel。
+ */
+export const AI_TEAM_SILENCE_HEARTBEAT_MS = 30_000;

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
-  "commit": "97d7ae95626425a23420a4f9bfabbf733d5ae73a",
-  "builtAt": "2026-10-03T02:50:17.324Z",
-  "version": "4.83.1",
+  "commit": "a87dbb00803c14eb160778bbc2097270457b3b7a",
+  "builtAt": "2026-10-07T23:20:56.996Z",
+  "version": "4.84.0",
   "channel": "stable"
 }

package/dist/cli-api.d.ts

@@ -5,6 +5,7 @@ export declare class WandCliApi {
     constructor(config: WandConfig);
     get<T>(pathname: string): Promise<T>;
     post<T>(pathname: string, body: unknown): Promise<T>;
+    del<T>(pathname: string): Promise<T>;
     private login;
     private request;
     private rawRequest;

package/dist/cli-api.js

@@ -12,6 +12,9 @@ export class WandCliApi {
     async post(pathname, body) {
         return this.request("POST", pathname, body);
     }
+    async del(pathname) {
+        return this.request("DELETE", pathname);
+    }
     async login() {
         const result = await this.rawRequest("POST", "/api/login", { password: this.config.password });
         if (result.status < 200 || result.status >= 300)

package/dist/cli.js

@@ -175,10 +175,23 @@ async function main() {
         case "mission:create":
         case "mission:diff":
         case "mission:review":
-        case "mission:review:send": {
+        case "mission:review:send":
+        case "tasks:purge-archived": {
             await runAgentCliCommand(command, args, configPath);
             break;
         }
+        case "core:status": {
+            const { checkCoreStatus } = await import("./core-status-cli.js");
+            await checkCoreStatus(configPath);
+            break;
+        }
+        case "core:wait": {
+            const { waitForCoreTurnsComplete } = await import("./core-status-cli.js");
+            const timeoutArg = readFlagValue(args.slice(1), "--timeout");
+            const timeout = timeoutArg === undefined ? 0 : Number(timeoutArg);
+            await waitForCoreTurnsComplete(configPath, timeout);
+            break;
+        }
         case "decision:configure": {
             const { isAbsolute, join } = await import("node:path");
             const disabling = args.includes("--disable");
@@ -267,6 +280,7 @@ Agent runtime:
   wand mission:diff <mission-id> <attempt-id>
   wand mission:review <mission-id> <attempt-id> --file <path> --body <text> [--line N]
   wand mission:review:send <mission-id> <attempt-id>
+  wand tasks:purge-archived   Hard-delete every archived board task
   wand decide --stdin | --status  Use the session-bound local decision service
   wand decision:configure --python <path> --model <dir> | --disable
   wand decision:skills [--providers pi,claude,...]  Install managed user-level skills
@@ -361,6 +375,7 @@ async function runAgentCliCommand(command, args, configPath) {
             const attemptId = required(args[2], "wand mission:review:send <mission-id> <attempt-id>");
             return output(await api.post(`/api/missions/${encodeURIComponent(missionId)}/attempts/${encodeURIComponent(attemptId)}/review/send`, {}));
         }
+        case "tasks:purge-archived": return output(await api.del("/api/wand-tasks/archived"));
     }
 }
 async function ensureRequiredFiles(configPath, opts = {}) {
@@ -461,6 +476,8 @@ async function registerInstance(handle, configPath, startedAtMs) {
     const { buildSnapshotData } = await import("./tui/snapshot.js");
     const ipc = startIpcServer({
         socketPath: sockPath,
+        coreStatusProvider: () => handle.structuredSessions.getCoreTurnStatus(),
+        beginCoreDrain: () => handle.structuredSessions.beginCoreRestartDrain(),
         snapshotProvider: () => buildSnapshotData({
             version: handle.version,
             url: pidInfo.url,

package/dist/commit-task-archive.d.ts

@@ -1,3 +1,5 @@
 import type { WandStorage } from "./storage.js";
 import type { SessionSnapshot } from "./types.js";
-export declare function archiveCommitTasks(storage: WandStorage, session: SessionSnapshot, entryIds: readonly string[]): string[];
+export declare function archiveCommitTasks(storage: WandStorage, session: SessionSnapshot, entryIds: readonly string[], options?: {
+    workspaceTaskId?: string | null;
+}): string[];

package/dist/commit-task-archive.js

@@ -1,8 +1,10 @@
 import { projectCwdForSession, normalizeProjectCwd } from "./workspace-binding.js";
 /**
- * Only close completed cards linked to this commit's selected iteration entries (or its
- * session). A shared default iteration can contain several projects and old completed work;
- * neither is a reason to archive an unrelated card.
+ * Close cards linked to this commit. The session's own task (or the task the client
+ * opened this chat from) leaves the active list even while it is still in progress —
+ * that is the row the user just asked to archive. Other cards only close when they are
+ * already done: a shared iteration can contain unrelated in-progress work, and selecting
+ * its prompts must not sweep those cards off the list.
  */
 function cardIdForSession(storage, sessionId) {
     const binding = storage.getSessionWorkspace(sessionId);
@@ -11,21 +13,30 @@ function cardIdForSession(storage, sessionId) {
         : null;
     return card?.id ?? storage.getWandTaskIdForSession(sessionId);
 }
-export function archiveCommitTasks(storage, session, entryIds) {
+export function archiveCommitTasks(storage, session, entryIds, options = {}) {
     const directory = projectCwdForSession(session);
-    const related = new Set();
     const currentTaskId = cardIdForSession(storage, session.id);
+    const openedTaskId = options.workspaceTaskId
+        ? storage.getWandTaskByWorkspaceTaskId(options.workspaceTaskId)?.id ?? null
+        : null;
+    // These two are the task the user is looking at. Archive them even if still todo/doing.
+    const inProgressAllowed = new Set();
     if (currentTaskId)
-        related.add(currentTaskId);
+        inProgressAllowed.add(currentTaskId);
+    if (openedTaskId)
+        inProgressAllowed.add(openedTaskId);
+    const related = new Set(inProgressAllowed);
     for (const entry of storage.listIterationPromptsByIds(entryIds)) {
         const taskId = entry.taskId || (entry.sessionId ? cardIdForSession(storage, entry.sessionId) : null);
         if (taskId)
             related.add(taskId);
     }
-    const completed = [];
+    const eligible = [];
     for (const id of related) {
         const task = storage.getWandTask(id);
-        if (task?.status !== "done")
+        if (!task || task.status === "archived")
+            continue;
+        if (task.status !== "done" && !inProgressAllowed.has(id))
             continue;
         // Project directory constrains selected history; standalone cards qualify via this session.
         const workspace = task.workspaceId ? storage.getWorkspace(task.workspaceId) : null;
@@ -33,7 +44,7 @@ export function archiveCommitTasks(storage, session, entryIds) {
             && !!directory && normalizeProjectCwd(workspace.cwd) === directory;
         if (!sameDirectory && !(id === currentTaskId && (!workspace || workspace.kind === "global")))
             continue;
-        completed.push(id);
+        eligible.push(id);
     }
-    return storage.archiveCompletedWandTasks(completed);
+    return storage.archiveWandTasks(eligible);
 }

package/dist/config.d.ts

@@ -7,7 +7,7 @@ import type { WandStorage } from "./storage.js";
  * 升级路径：老 JSON 里仍存有这些字段时，首次启动会被搬到 DB（见 migrateLegacyPreferencesToDb），
  * 然后下一次 saveConfig 写回 JSON 时它们会被剥离（见 stripPreferenceFields）。
  */
-export declare const PREFERENCE_KEYS: readonly ["defaultProvider", "defaultSessionKind", "defaultTaskWorktree", "defaultMode", "defaultCwd", "defaultModel", "defaultCodexModel", "defaultOpenCodeModel", "defaultGrokModel", "defaultQoderModel", "defaultPiModel", "defaultGeminiModel", "commitCli", "commitModel", "systemAiCli", "systemAiModel", "defaultThinkingEffort", "language", "cardDefaults", "inheritEnv"];
+export declare const PREFERENCE_KEYS: readonly ["defaultProvider", "defaultSessionKind", "defaultTaskWorktree", "defaultMode", "defaultCwd", "defaultModel", "defaultCodexModel", "defaultOpenCodeModel", "defaultGrokModel", "defaultQoderModel", "defaultPiModel", "defaultGeminiModel", "modelGroups", "commitCli", "commitModel", "systemAiCli", "systemAiModel", "defaultThinkingEffort", "language", "cardDefaults", "inheritEnv", "taskRetention", "userProfile"];
 export type PreferenceKey = (typeof PREFERENCE_KEYS)[number];
 /**
  * 每个 provider 的默认模型偏好字段。新增 provider 时只改这一处：

package/dist/config.js

@@ -7,6 +7,9 @@ import process from "node:process";
 import { isRunningAsRoot } from "./env-utils.js";
 import { isSessionProvider, SESSION_PROVIDERS } from "./session-provider.js";
 import { isThinkingEffort } from "./structured-provider-common.js";
+import { normalizeModelGroups } from "./model-groups.js";
+import { normalizeUserProfile, parseUserProfile } from "./user-profile.js";
+import { defaultTaskRetention, normalizeTaskRetention, parseTaskRetention } from "./task-retention.js";
 const DEFAULT_CONFIG_DIR = ".wand";
 const DEFAULT_CONFIG_FILE = "config.json";
 /**
@@ -29,6 +32,7 @@ export const PREFERENCE_KEYS = [
     "defaultQoderModel",
     "defaultPiModel",
     "defaultGeminiModel",
+    "modelGroups",
     "commitCli",
     "commitModel",
     "systemAiCli",
@@ -37,6 +41,8 @@ export const PREFERENCE_KEYS = [
     "language",
     "cardDefaults",
     "inheritEnv",
+    "taskRetention",
+    "userProfile",
 ];
 /**
  * 每个 provider 的默认模型偏好字段。新增 provider 时只改这一处：
@@ -109,9 +115,11 @@ export const defaultConfig = () => ({
     macos: defaultMacosDmgConfig(),
     ios: defaultIosIpaConfig(),
     render: defaultRenderConfig(),
+    harness: defaultHarnessConfig(),
     structured: { processHost: "legacy" },
     localDecision: { enabled: false, pythonPath: "", modelPath: "" },
     cardDefaults: defaultCardExpandDefaults(),
+    taskRetention: defaultTaskRetention(),
     defaultModel: "",
     defaultCodexModel: "",
     defaultOpenCodeModel: "",
@@ -119,6 +127,7 @@ export const defaultConfig = () => ({
     defaultQoderModel: "",
     defaultPiModel: "",
     defaultGeminiModel: "",
+    modelGroups: [],
     commitCli: "claude",
     commitModel: "",
     systemAiModel: "",
@@ -359,6 +368,9 @@ export function applyStoragePreferences(config, storage) {
         if (typeof v === "string")
             config[field] = v.trim();
     }
+    if (storage.hasPreference(preferenceStorageKey("modelGroups"))) {
+        config.modelGroups = normalizeModelGroups(storage.getPreference(preferenceStorageKey("modelGroups"), []));
+    }
     if (storage.hasPreference(preferenceStorageKey("commitCli"))) {
         const v = storage.getPreference(preferenceStorageKey("commitCli"), defaults.commitCli ?? "claude");
         if (v === "claude" || v === "codex" || v === "opencode")
@@ -397,6 +409,12 @@ export function applyStoragePreferences(config, storage) {
         const v = storage.getPreference(preferenceStorageKey("inheritEnv"), defaults.inheritEnv ?? true);
         config.inheritEnv = v === false ? false : true;
     }
+    if (storage.hasPreference(preferenceStorageKey("taskRetention"))) {
+        config.taskRetention = normalizeTaskRetention(storage.getPreference(preferenceStorageKey("taskRetention"), defaults.taskRetention));
+    }
+    if (storage.hasPreference(preferenceStorageKey("userProfile"))) {
+        config.userProfile = normalizeUserProfile(storage.getPreference(preferenceStorageKey("userProfile"), null));
+    }
     return config;
 }
 /** Write a single preference value to DB and (in-place) update the live config object. */
@@ -411,6 +429,12 @@ export function writePreferenceToStorage(config, storage, key, value) {
         return;
     }
     switch (key) {
+        case "modelGroups": {
+            const groups = normalizeModelGroups(value);
+            storage.setPreference(dbKey, groups);
+            config.modelGroups = groups;
+            break;
+        }
         case "defaultProvider": {
             if (!isSessionProvider(value))
                 throw new Error(`无效 Provider: ${String(value)}`);
@@ -499,6 +523,18 @@ export function writePreferenceToStorage(config, storage, key, value) {
             config.inheritEnv = v;
             break;
         }
+        case "taskRetention": {
+            const retention = parseTaskRetention(value);
+            storage.setPreference(dbKey, retention);
+            config.taskRetention = retention;
+            break;
+        }
+        case "userProfile": {
+            const profile = parseUserProfile(value);
+            storage.setPreference(dbKey, profile ?? null);
+            config.userProfile = profile;
+            break;
+        }
     }
 }
 function defaultCardExpandDefaults() {
@@ -587,6 +623,39 @@ function normalizeRenderConfig(input) {
     const binaryPath = typeof raw.binaryPath === "string" ? raw.binaryPath.trim() : "";
     return { engine, ...(binaryPath ? { binaryPath } : {}) };
 }
+/**
+ * 默认 auto：Pi 侧有可用认证时，结构化 pi 会话走进程内 core，否则保持 CLI。
+ * 放在 config.json（部署项）而非 SQLite 偏好里：它决定「谁持有 agent loop」，属于部署决策。
+ */
+function defaultHarnessConfig() {
+    return { engine: "auto" };
+}
+function normalizeHarnessTokenLimit(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value >= 0 ? value : undefined;
+}
+/** 旧 config.json 没有 harness 字段时回落到默认值，不能因为新字段让启动失败。 */
+function normalizeHarnessConfig(input) {
+    if (!input || typeof input !== "object" || Array.isArray(input))
+        return undefined;
+    const raw = input;
+    const engine = raw.engine === "core" || raw.engine === "cli" ? raw.engine : "auto";
+    const compactionRaw = raw.compaction && typeof raw.compaction === "object" && !Array.isArray(raw.compaction)
+        ? raw.compaction
+        : null;
+    const reserveTokens = normalizeHarnessTokenLimit(compactionRaw?.reserveTokens);
+    const keepRecentTokens = normalizeHarnessTokenLimit(compactionRaw?.keepRecentTokens);
+    const compaction = {
+        ...(typeof compactionRaw?.enabled === "boolean" ? { enabled: compactionRaw.enabled } : {}),
+        ...(reserveTokens !== undefined ? { reserveTokens } : {}),
+        ...(keepRecentTokens !== undefined ? { keepRecentTokens } : {}),
+    };
+    const agentDir = typeof raw.agentDir === "string" ? raw.agentDir.trim() : "";
+    return {
+        engine,
+        ...(agentDir ? { agentDir } : {}),
+        ...(Object.keys(compaction).length > 0 ? { compaction } : {}),
+    };
+}
 function normalizeIosIpaConfig(input) {
     if (!input || typeof input !== "object")
         return undefined;
@@ -683,6 +752,7 @@ function mergeWithDefaults(input) {
             }))
             : defaults.commandPresets,
         structuredChatPersona: normalizeStructuredChatPersona(input.structuredChatPersona),
+        userProfile: normalizeUserProfile(input.userProfile),
         language: typeof input.language === "string" ? input.language.trim() : defaults.language,
         appSecret: typeof input.appSecret === "string" && input.appSecret.length >= 32
             ? input.appSecret
@@ -691,6 +761,7 @@ function mergeWithDefaults(input) {
         macos: normalizeMacosDmgConfig(input.macos) ?? defaults.macos,
         ios: normalizeIosIpaConfig(input.ios) ?? defaults.ios,
         render: normalizeRenderConfig(input.render) ?? defaults.render,
+        harness: normalizeHarnessConfig(input.harness) ?? defaults.harness,
         structured: { processHost: input.structured?.processHost === "rust" ? "rust" : "legacy" },
         localDecision: {
             enabled: input.localDecision?.enabled === true,
@@ -698,10 +769,12 @@ function mergeWithDefaults(input) {
             modelPath: typeof input.localDecision?.modelPath === "string" ? input.localDecision.modelPath.trim() : "",
         },
         cardDefaults: normalizeCardDefaults(input.cardDefaults),
+        taskRetention: normalizeTaskRetention(input.taskRetention),
         defaultProvider: isSessionProvider(input.defaultProvider) ? input.defaultProvider : "claude",
         defaultSessionKind: input.defaultSessionKind === "pty" ? "pty" : "structured",
         defaultTaskWorktree: typeof input.defaultTaskWorktree === "boolean" ? input.defaultTaskWorktree : defaults.defaultTaskWorktree,
         ...providerModelOverrides(input, defaults),
+        modelGroups: normalizeModelGroups(input.modelGroups ?? []),
         commitCli: input.commitCli === "codex" || input.commitCli === "opencode" ? input.commitCli : "claude",
         commitModel: typeof input.commitModel === "string" ? input.commitModel.trim() : defaults.commitModel,
         systemAiCli: isSessionProvider(input.systemAiCli) ? input.systemAiCli : undefined,

package/dist/conversation-mentions.d.ts

@@ -0,0 +1,16 @@
+import type { AiTeamMember } from "./ai-team-types.js";
+type Member = Pick<AiTeamMember, "id" | "name">;
+export type ConversationLeaderMention = {
+    memberId: string;
+    name: string;
+    body: string;
+} | {
+    error: string;
+};
+/** Only a leading, explicit address selects a coordinator. Quoted/body mentions and emails are data. */
+export declare function conversationLeaderMention(text: string, members: readonly Member[]): ConversationLeaderMention | null;
+/** Shared upload-envelope handling: paths are never task titles or addressees. */
+export declare function conversationMessageBody(text: string): string;
+/** Duplicate display names remain addressable without guessing an employee identity. */
+export declare function conversationMentionToken(member: Member, members: readonly Member[]): string;
+export {};

package/dist/conversation-mentions.js

@@ -0,0 +1,32 @@
+/** Only a leading, explicit address selects a coordinator. Quoted/body mentions and emails are data. */
+export function conversationLeaderMention(text, members) {
+    // Upload envelopes precede the user's text on Web/Android; filenames are never mention targets.
+    const input = conversationMessageBody(text).trimStart();
+    if (!/^[@＠]/u.test(input))
+        return null;
+    const addressed = input.slice(1);
+    const candidates = members.flatMap(member => [member.name.trim(), member.id]
+        .filter(Boolean).map(label => ({ member, label })))
+        .filter(({ label }) => addressed.startsWith(label) && /^(?:$|[\s,，:：;；、!！?？。])/u.test(addressed.slice(label.length)))
+        .sort((a, b) => b.label.length - a.label.length);
+    const match = candidates[0];
+    if (!match)
+        return { error: "没有找到被 @ 的群成员，请用「@姓名 消息」或从成员列表选择。" };
+    if (new Set(candidates.filter(c => c.label.length === match.label.length).map(c => c.member.id)).size !== 1) {
+        return { error: "被 @ 的名字对应多位群成员，请从成员列表选择，或用 @成员ID 指定。" };
+    }
+    const body = addressed.slice(match.label.length).replace(/^[\s,，:：]+/u, "").trim();
+    if (!body)
+        return { error: "请在 @负责人 后写明本轮消息。" };
+    return { memberId: match.member.id, name: match.member.name, body };
+}
+/** Shared upload-envelope handling: paths are never task titles or addressees. */
+export function conversationMessageBody(text) {
+    return text.replace(/^\s*\[附件已上传，请查看以下文件:\r?\n[\s\S]*?\r?\n\]\s*/u, "");
+}
+/** Duplicate display names remain addressable without guessing an employee identity. */
+export function conversationMentionToken(member, members) {
+    const name = member.name.trim();
+    const unique = name && !/\r|\n/u.test(name) && members.filter(m => m.name.trim() === name || m.id === name).length === 1;
+    return `@${unique ? name : member.id}`;
+}