@co0ontty/wand 4.89.5 → 4.90.0

package/README.md

@@ -59,6 +59,7 @@ wand config:password
 - **Message queueing** — keep typing while the AI is working; messages are queued automatically
 - **File browser** — built-in path browsing and search
 - **Quick commits** — review Git changes and generate a commit message from the web UI
+- **Scheduled tasks** — choose an employee, workspace directory and prompt, run once or repeat daily/weekly, and review execution history. See [scheduling behavior](docs/scheduled-tasks.md).
 
 #### Deployment
 
@@ -135,7 +136,7 @@ npm run check              # TypeScript type check
 npm run build              # Compile and copy static assets to dist/
 ```
 
-On this configured development machine, use `~/start.sh` to build/install the working tree and restart, `~/start.sh --restart` to restart without rebuilding, or `~/start.sh --status` to check status. This user-home helper enters the project and handles sudo locally; do not prefix it with `sudo`. It is not included in a fresh clone, and credentials stay outside the repository. Restart safety rules remain in [AGENTS.md](AGENTS.md).
+On this configured development machine, use `~/start.sh` to build/install the working tree and restart, `~/start.sh --restart` to restart without rebuilding, or `~/start.sh --status` to check status. This user-home helper enters the project and handles sudo locally; do not prefix it with `sudo`. It is not included in a fresh clone, and credentials stay outside the repository. Restart safety rules remain in [AGENTS.md](AGENTS.md). Build/check commands share a project lock; local deployment and npm updates share the global installation lock. A busy lock fails before package or service changes. Local Beta versions are written only to build metadata and a private package snapshot, never to the working tree's package manifests. The `build:body` / `check:body` scripts are internal steps for the locked entry points.
 
 Use an isolated config for testing:
 
@@ -239,6 +240,7 @@ npm install -g @google/gemini-cli@latest
 - **文件浏览器** — 内置路径浏览和搜索功能
 - **本地预览** — 消息和终端里的本机链接可点击预览；顶栏也可手动打开本机 HTTP 端口或 HTML 目录
 - **快捷提交** — Git 变动快速提交入口，一键生成 commit message
+- **定时任务** — 选择员工、工作区目录和提示词，单次或每天／每周自动执行，并查看执行记录；详见 [使用说明](docs/scheduled-tasks.md)。
 
 #### 部署与访问
 
@@ -282,7 +284,7 @@ wand config:set port 9443
 
 ### 语音识别
 
-Web、Android、iOS 可在语音输入设置中选择「服务端识别」或「客户端本地识别」。服务端使用按需安装的 whisper.cpp 多语言模型，支持无 GPU CPU 服务器、Mac mini Metal 与可选 CUDA；模型不随普通构建下载。部署、模型大小、鉴权和隐私边界见 [服务端语音识别](docs/server-speech.md)。设置内下载/初始化 LAYA 与语音模型，以及「决策专家」的本机性能检查和默认本地/免费调用链，见 [本地模型管理](docs/local-model-setup.md)。
+Web、Android、iOS 可在语音输入设置中选择「服务端识别」或「客户端本地识别」。服务端使用按需安装的 whisper.cpp 多语言模型，支持无 GPU CPU 服务器、Mac mini Metal 与可选 CUDA；模型不随普通构建下载。部署、模型大小、鉴权和隐私边界见 [服务端语音识别](docs/server-speech.md)。设置内下载/初始化 LAYA 与语音模型，以及「石一」（决策专家）的本机性能检查和默认本地/免费调用链，见 [本地模型管理](docs/local-model-setup.md)。
 
 ### 可选本地决策（实验性）
 
@@ -333,7 +335,7 @@ npm run check              # TypeScript 类型检查
 npm run build              # 编译 + 复制静态资源到 dist/
 ```
 
-本机开发环境统一调用用户主目录入口：`~/start.sh` 构建/安装当前代码并重启，`~/start.sh --restart` 仅重启、不重新构建，`~/start.sh --status` 查状态。入口自动进入项目并在本地处理 sudo，外层不要再加 sudo；它是本机配置，不随新克隆提供，凭据不入仓库。重启安全约束仍以 [AGENTS.md](AGENTS.md) 为准。
+本机开发环境统一调用用户主目录入口：`~/start.sh` 构建/安装当前代码并重启，`~/start.sh --restart` 仅重启、不重新构建，`~/start.sh --status` 查状态。入口自动进入项目并在本地处理 sudo，外层不要再加 sudo；它是本机配置，不随新克隆提供，凭据不入仓库。重启安全约束仍以 [AGENTS.md](AGENTS.md) 为准。构建/检查共用项目锁，本地部署与 npm 更新共用全局安装锁；锁忙时在包或服务修改前拒绝执行。本地 Beta 版本仅写入构建信息和私有打包快照，不改共享工作树的包版本文件。`build:body` / `check:body` 是加锁入口的内部步骤，不直接调用。
 
 隔离测试环境（不影响生产实例）：
 

package/dist/agent-dispatch.js

@@ -1,6 +1,5 @@
-import { getDefaultModelForProvider } from "./config.js";
 import { isLocalDecisionModel } from "./decision-expert-identity.js";
-import { defaultModelGroupSelector } from "./model-groups.js";
+import { fallbackProviderModel, sessionEmployeeFields } from "./session-model.js";
 import { defaultRoleForCli } from "./default-employee.js";
 import { providerCliCommand } from "./session-provider.js";
 import { agentKey } from "./ai-team-types.js";
@@ -46,7 +45,7 @@ export async function dispatchAgentForTask(deps, input) {
     const cwd = group.cwd;
     const provider = agent.provider;
     const model = agent.model === "default" ? "" : agent.model;
-    const resolvedModel = model || defaultModelGroupSelector(config.modelGroups, provider, getDefaultModelForProvider(config, provider)) || getDefaultModelForProvider(config, provider) || undefined;
+    const resolvedModel = model || fallbackProviderModel(config, provider);
     if (isLocalDecisionModel(resolvedModel)) {
         throw new AgentDispatchPreflightError("LAYA 仅支持有界决策，不能执行聊天或任务；该候选尚未接受输入。");
     }
@@ -58,9 +57,7 @@ export async function dispatchAgentForTask(deps, input) {
             sessionSource: "automation",
             automationId: input.automationId,
             systemPrompt,
-            employeeId: role?.id,
-            employeeName: role?.name,
-            employeeAvatar: role?.avatar,
+            ...sessionEmployeeFields(role),
             workspaceId: group.workspaceId,
             workspaceTaskId: group.workspaceTaskId,
         })
@@ -79,9 +76,7 @@ export async function dispatchAgentForTask(deps, input) {
             sessionSource: "automation",
             automationId: input.automationId,
             systemPrompt,
-            employeeId: role?.id,
-            employeeName: role?.name,
-            employeeAvatar: role?.avatar,
+            ...sessionEmployeeFields(role),
             employeeCandidates: input.employee?.agents,
             employeeCandidateIndex: input.employeeCandidateIndex,
             workspaceId: group.workspaceId,

package/dist/ai-team-employee-binding.js

@@ -61,18 +61,19 @@ export function serializeExecutionTeam(team) {
             ...member, _employeeSnapshot: snapshots.get(member),
         })) });
 }
+function projectBoundMember(member, source, includeAgents) {
+    const employee = member.employeeId ? source.getSiliconEmployee(member.employeeId) : null;
+    if (!employee)
+        return member;
+    return includeAgents
+        ? { ...member, name: employee.name, avatar: employee.avatar, agents: employee.agents, agent: employee.agents[0] }
+        : { ...member, name: employee.name, avatar: employee.avatar };
+}
 /** Team definitions expose current employee-owned fields without storing another copy of the role. */
 export function projectTeamDefinition(team, source) {
-    return { ...team, members: team.members.map((member) => {
-            const employee = member.employeeId ? source.getSiliconEmployee(member.employeeId) : null;
-            return employee ? { ...member, name: employee.name, avatar: employee.avatar,
-                agents: employee.agents, agent: employee.agents[0] } : member;
-        }) };
+    return { ...team, members: team.members.map((member) => projectBoundMember(member, source, true)) };
 }
 /** Read-only names/avatars follow the same employee, never a replacement at the same member id. */
 export function projectTeamEmployees(team, source) {
-    return { ...team, members: team.members.map((member) => {
-            const employee = member.employeeId ? source.getSiliconEmployee(member.employeeId) : null;
-            return employee ? { ...member, name: employee.name, avatar: employee.avatar } : member;
-        }) };
+    return { ...team, members: team.members.map((member) => projectBoundMember(member, source, false)) };
 }

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

@@ -178,6 +178,7 @@ export declare class AiTeamRunner {
     private readonly noDegrade;
     private readonly teamRequestIds;
     private sweepTimer;
+    private disposed;
     /** 脱敏参照目录只算一次：os.homedir() 读 env，configDir 随 storage 定，运行期不变。 */
     private redactionDirsValue;
     constructor(options: AiTeamRunnerOptions);
@@ -284,7 +285,7 @@ export declare class AiTeamRunner {
      * 没变就什么都不发。巡检间隔与 evaluate 行为都不动。
      */
     startSweep(): void;
-    dispose(): void;
+    dispose(): Promise<void>;
     /** 等当前排队的所有操作跑完（测试用）。 */
     idle(): Promise<void>;
     private enqueue;

package/dist/ai-team-runner.js

@@ -381,6 +381,7 @@ export class AiTeamRunner {
     noDegrade = new Set();
     teamRequestIds = new Map();
     sweepTimer = null;
+    disposed = false;
     /** 脱敏参照目录只算一次：os.homedir() 读 env，configDir 随 storage 定，运行期不变。 */
     redactionDirsValue = null;
     constructor(options) {
@@ -423,6 +424,8 @@ export class AiTeamRunner {
     }
     // ── 公开操作 ──
     async start(input) {
+        if (this.disposed)
+            throw new AiTeamConflictError("AiTeamRunner has been disposed.");
         const definition = input.team ?? this.storage.getAiTeam(input.teamId ?? "");
         if (!definition)
             throw new Error("团队不存在。");
@@ -791,6 +794,8 @@ export class AiTeamRunner {
     }
     /** 挂一次 run 级 live 去抖：同一 run 每 500ms 至多算一遍、推一次，与 evaluate 的计时器互不干扰。 */
     scheduleLivePush(runId) {
+        if (this.disposed)
+            return;
         if (!this.notifyLiveListener || this.liveTimers.has(runId))
             return;
         const timer = setTimeout(() => {
@@ -807,6 +812,8 @@ export class AiTeamRunner {
      * 放行不松开去抖：推完照样记指纹并重排心跳，所以静默期最多每 heartbeatMs 一次，不是无界重推。
      */
     pushLive(runId, heartbeat = false) {
+        if (this.disposed)
+            return;
         if (!this.notifyLiveListener)
             return;
         const run = this.storage.getAiTeamRun(runId);
@@ -858,6 +865,8 @@ export class AiTeamRunner {
      * 同一 run 至多一个计时器；run 不在 running、被删除或 dispose 时 cancel，不泄漏。
      */
     scheduleHeartbeat(runId) {
+        if (this.disposed)
+            return;
         if (this.heartbeatTimers.has(runId))
             return;
         if (!this.notifyLiveListener && !this.notifyListener)
@@ -921,6 +930,8 @@ export class AiTeamRunner {
     // ── 事件驱动 ──
     /** 与 missions.ingest 并列调用。绝大多数事件与团队无关，必须廉价返回。 */
     ingest(event) {
+        if (this.disposed)
+            return;
         if (!event.sessionId || event.sessionId === "__system__")
             return;
         if (event.type !== "status" && event.type !== "ended" && event.type !== "task" && event.type !== "output")
@@ -972,6 +983,8 @@ export class AiTeamRunner {
      * 没变就什么都不发。巡检间隔与 evaluate 行为都不动。
      */
     startSweep() {
+        if (this.disposed)
+            return;
         if (this.sweepTimer)
             return;
         this.sweepTimer = setInterval(() => {
@@ -984,7 +997,8 @@ export class AiTeamRunner {
         }, SWEEP_INTERVAL_MS);
         this.sweepTimer.unref?.();
     }
-    dispose() {
+    async dispose() {
+        this.disposed = true;
         if (this.sweepTimer)
             clearInterval(this.sweepTimer);
         this.sweepTimer = null;
@@ -1006,6 +1020,8 @@ export class AiTeamRunner {
         this.lastLiveKey.clear();
         this.noDegrade.clear();
         this.teamRequestIds.clear();
+        // Settle accepted host handshakes before the server closes storage.
+        await this.idle();
     }
     /** 等当前排队的所有操作跑完（测试用）。 */
     async idle() {
@@ -1016,7 +1032,11 @@ export class AiTeamRunner {
     // ── 内部：串行化 ──
     enqueue(runId, task) {
         const previous = this.chains.get(runId) ?? Promise.resolve();
-        const next = previous.catch(() => undefined).then(task);
+        const next = previous.catch(() => undefined).then(() => {
+            if (this.disposed)
+                throw new AiTeamConflictError("AiTeamRunner has been disposed.");
+            return task();
+        });
         const tracked = next.catch((error) => {
             if (!(error instanceof AiTeamConflictError)) {
                 console.error(`[AiTeam] run ${runId}:`, getErrorMessage(error));
@@ -1044,6 +1064,8 @@ export class AiTeamRunner {
     }
     // ── 内部：推进 ──
     async evaluate(runId) {
+        if (this.disposed)
+            return;
         const run = this.storage.getAiTeamRun(runId);
         if (!run || run.status !== "running")
             return;
@@ -1066,6 +1088,8 @@ export class AiTeamRunner {
             await this.advance(run);
     }
     scheduleRecheck(runId, delayMs) {
+        if (this.disposed)
+            return;
         if (this.recheckTimers.has(runId))
             return;
         const timer = setTimeout(() => {
@@ -1250,6 +1274,8 @@ export class AiTeamRunner {
      * 有成员失败、队列清空或依赖再也满足不了时，等在跑的都结束后交回 Leader。
      */
     async advance(run) {
+        if (this.disposed)
+            return;
         if (run.status !== "running")
             return;
         const steps = this.storage.listAiTeamSteps(run.id);
@@ -1294,6 +1320,8 @@ export class AiTeamRunner {
     }
     /** 开一轮 Leader：把上一轮 Leader 之后结束的成员报告交给他。 */
     async startLeaderRound(run, userNote) {
+        if (this.disposed)
+            return;
         if (!this.hasBudget(run))
             return;
         // 成员干活时用户在群里说的话，这一轮一起交给负责人。
@@ -1482,6 +1510,8 @@ export class AiTeamRunner {
      * 提示词分两段：`system`（角色与规则）只在新建会话时交给系统提示通道，`message` 是本轮用户消息。
      */
     async dispatchStep(run, step, buildPrompt, proceed = true) {
+        if (this.disposed)
+            return;
         const member = this.member(run.team, step.memberId);
         const candidates = member ? memberAgents(member) : [];
         const info = this.infoOf(step);
@@ -1550,6 +1580,8 @@ export class AiTeamRunner {
             }
         }
         catch (error) {
+            if (this.disposed)
+                return;
             const message = getErrorMessage(error);
             const rejected = error instanceof AgentDispatchPreflightError && error.failure.retryable;
             const kind = rejected ? "input-rejected" : classifyCandidateFailure(message);
@@ -1939,6 +1971,8 @@ export class AiTeamRunner {
         }
     }
     postTurn(run, turn) {
+        if (this.disposed)
+            return;
         if (!this.chat || !run.chatSessionId)
             return;
         try {
@@ -2046,6 +2080,8 @@ export class AiTeamRunner {
         this.storage.saveAiTeamStep(step);
     }
     notify(run) {
+        if (this.disposed)
+            return;
         // 记下 run 通道的活动基线并排上静默心跳：长任务只等一次状态写入是不够的，
         // 用户在十几分钟没有新消息时需要「仍在运行」的证据，见 beat()。
         this.lastRunNotifyAt.set(run.id, this.now());

package/dist/ai-team-types.js

@@ -1,5 +1,6 @@
 import { DECISION_EXPERT_KEY } from "./decision-expert-identity.js";
 import { SPEECH_POLISHER_KEY } from "./speech-polisher-identity.js";
+import { HR_EMPLOYEE_KEY } from "./hr-employee-identity.js";
 export const AI_TEAM_MIN_MEMBERS = 2;
 export const AI_TEAM_MAX_MEMBERS = 8;
 export const AI_TEAM_DEFAULT_MAX_STEPS = 30;
@@ -53,13 +54,13 @@ export function isDecisionExpertSiliconEmployee(employee) {
     return employee?.systemKey === DECISION_EXPERT_KEY;
 }
 export function isBuiltinSiliconEmployee(employee) {
-    return isSystemSiliconEmployee(employee) || isDefaultSiliconEmployee(employee) || isDecisionExpertSiliconEmployee(employee) || employee?.systemKey === SPEECH_POLISHER_KEY;
+    return isSystemSiliconEmployee(employee) || isDefaultSiliconEmployee(employee) || isDecisionExpertSiliconEmployee(employee) || employee?.systemKey === SPEECH_POLISHER_KEY || employee?.systemKey === HR_EMPLOYEE_KEY;
 }
 export const SILICON_EMPLOYEE_MAX_TAGS = 8;
 export const SILICON_EMPLOYEE_TAG_MAX_CHARS = 20;
 /** 内置标识只由真实员工身份投影，不能用自定义标签冒充。 */
 export function siliconEmployeeTags(employee) {
-    if (isSystemSiliconEmployee(employee) || isDecisionExpertSiliconEmployee(employee) || employee.systemKey === SPEECH_POLISHER_KEY)
+    if (isSystemSiliconEmployee(employee) || isDecisionExpertSiliconEmployee(employee) || employee.systemKey === SPEECH_POLISHER_KEY || employee.systemKey === HR_EMPLOYEE_KEY)
         return [SYSTEM_EMPLOYEE_TAG];
     if (isDefaultSiliconEmployee(employee))
         return [DEFAULT_EMPLOYEE_TAG];

package/dist/ai-text-runner.d.ts

@@ -0,0 +1,61 @@
+import { type EmployeeTextDeps } from "./employee-text.js";
+import type { AiTextRequest, SessionProvider, SessionSnapshot } from "./types.js";
+export { QuickCommitError } from "./command-error.js";
+/** Neutral one-shot text execution. Tool-running Git fallback never uses the retry chain. */
+export declare function defaultProvider(provider: SessionProvider | undefined): SessionProvider;
+export interface QuickCommitAiOptions {
+    modelGroups?: import("./model-groups.js").ModelGroup[];
+    provider?: SessionProvider;
+    model?: string | null;
+    thinkingEffort?: SessionSnapshot["thinkingEffort"];
+    inheritEnv?: boolean;
+    /** 内置「系统运维」员工的角色设定：作为系统提示前缀注入。 */
+    opsPersona?: string;
+    /** 员工候选链（按顺序）；未设置时只用 provider/model 这一次调用。 */
+    cliCandidates?: import("./types.js").AiCliCandidate[];
+    /** SDK 使用当前实例配置与现有免费分组服务，不创建其他执行渠道。 */
+    employeeText?: EmployeeTextDeps;
+    /** 系统应用必须经员工渠道；没有可用候选时直接失败，不退回默认 provider。 */
+    employeeChannelOnly?: boolean;
+    /** 整条候选链的时间上限；默认 CLI_CHAIN_BUDGET_MS。第一条消息里的调用要短得多。 */
+    budgetMs?: number;
+    signal?: AbortSignal;
+}
+type CliAiTextOptions = QuickCommitAiOptions & {
+    deadline?: number;
+};
+export declare function normalizeAiText(raw: string): string;
+export declare function buildPiTextArgs(request: AiTextRequest, opts: QuickCommitAiOptions, allowTools?: boolean): string[];
+export declare function buildGrokTextArgs(request: AiTextRequest, opts: QuickCommitAiOptions, allowTools?: boolean): string[];
+/**
+ * Gemini CLI 没有 `--append-system-prompt`，规则走 `contentWithSystemPrompt` 并进内容；
+ * headless 下必须带 `--skip-trust`，否则未信任的工作目录会直接以 55 退出。
+ *
+ * `-p ""` 只把 CLI 钉在 headless 模式，真正的 prompt 走 stdin：commit diff 可能很大，
+ * 塞进 argv 会撞 ARG_MAX。Gemini 没有 Codex `--ephemeral` 那样的临时会话开关，
+ * 一次性调用会留在它自己的聊天记录里（Wand 不扫描 Gemini 历史，不会误当可恢复会话）。
+ */
+export declare function buildGeminiTextArgs(opts: QuickCommitAiOptions, allowTools?: boolean): string[];
+export declare function buildQoderTextArgs(request: AiTextRequest, opts: QuickCommitAiOptions, allowTools?: boolean): string[];
+/** provider 自己的系统提示开关 + 规则文本；没有开关的 provider 返回空。 */
+export declare function systemPromptArgsFrom(provider: SessionProvider, system: string): string[];
+/** 没有系统提示开关的 provider（codex / opencode）：规则只能并进内容前面。 */
+export declare function contentWithSystemPrompt(provider: SessionProvider, request: AiTextRequest): string;
+export declare function runCliText(command: string, args: string[], prompt: string, opts: {
+    cwd: string;
+    timeoutMs: number;
+    inheritEnv?: boolean;
+    signal?: AbortSignal;
+    env?: (base: NodeJS.ProcessEnv) => NodeJS.ProcessEnv;
+}): Promise<string>;
+export declare function assertGeminiTextCapability(): void;
+export declare function callCliAiText(request: AiTextRequest, cwd: string, language: string, opts: CliAiTextOptions): Promise<string>;
+/** 角色设定走系统提示前缀；任务自己的输出格式与约束必须排在后面。 */
+export declare function withOpsPersona(request: AiTextRequest, persona?: string): AiTextRequest;
+/**
+ * Run a lightweight AI request through the system employee's configured chain.
+ * provider 与引擎由候选决定；SDK 与 CLI 均保留各自适配和身份。
+ * parseOutput 在候选链内解析/校验结果；失败后继续下一条，而非提前宣布成功。
+ */
+export declare function callConfiguredAiText(request: AiTextRequest, cwd: string, language: string, opts: QuickCommitAiOptions): Promise<string>;
+export declare function callConfiguredAiText<T>(request: AiTextRequest, cwd: string, language: string, opts: QuickCommitAiOptions, parseOutput: (raw: string) => T): Promise<T>;