@co0ontty/wand 4.89.4 → 4.89.5-beta.343.1.gb264adf

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:
 
@@ -233,18 +234,30 @@ npm install -g @google/gemini-cli@latest
 
 #### 交互体验
 
-- **结构化对话** — 代码块语法高亮、工具调用折叠/展开、多问题分组渲染、Token 用量按轮累计
+- **结构化对话** — 代码块语法高亮、工具调用折叠/展开、多问题分组渲染、输入区展示最近一轮 Token 用量与费用
 - **个性化角色** — 像素风猫咪头像（赛博虎妞 / 勤劳初二），支持自定义对话角色名称
 - **消息排队** — 在 AI 思考时可继续输入，消息自动排队发送
 - **文件浏览器** — 内置路径浏览和搜索功能
 - **本地预览** — 消息和终端里的本机链接可点击预览；顶栏也可手动打开本机 HTTP 端口或 HTML 目录
 - **快捷提交** — Git 变动快速提交入口，一键生成 commit message
+- **定时任务** — 选择员工、工作区目录和提示词，单次或每天／每周自动执行，并查看执行记录；详见 [使用说明](docs/scheduled-tasks.md)。
 
 #### 部署与访问
 
 - **多平台客户端** — Android / iOS / macOS 原生客户端，支持加密连接码分发、自动更新检查
 - **HTTPS** — 可选自签证书，适合远程或移动端访问
 - **版本管理** — 内置更新检查与升级提示，支持 stable/beta 双通道
+
+Web 设置中的「Beta 通道」决定服务端 npm 更新来源：关闭时仅检查
+`@co0ontty/wand@latest`，开启时检查 `@co0ontty/wand@beta`；「自动更新 Web 服务」
+独立决定是否自动安装。检查后安装锁定具体版本，避免 dist-tag 在安装期间移动。
+关闭 Beta 不会自动降级；需要立即返回较旧正式版时，点击「更新或重新安装」。
+
+正式 npm 发布由 `vX.Y.Z` Git tag 触发，只写入 `latest`，拒绝预发布版本。
+master 的 Beta 发布只写入 `beta`，版本为下一补丁号加
+`-beta.<构建序号>.<重试序号>.g<提交>`，例如 `4.89.5-beta.100.1.gabcdef0`。
+版本基数同时检查正式 Git tags 和 npm latest，兼容未推送 Git 的本地正式发布。
+Beta 尚未发布、通道版本无效或 npm 暂不可达时，不自动安装其他通道。
 - **CLI 更新** — 在服务端设置中检查并快速更新 Claude Code、Codex、OpenCode、Qoder CLI、Pi 和 Gemini CLI，也可开启自动更新
 
 ### 配置
@@ -271,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)。
 
 ### 可选本地决策（实验性）
 
@@ -322,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/ai-team-employee-binding.js

@@ -31,7 +31,8 @@ export function requireTeamEmployee(source, id) {
     }
     // The default partner's read projection includes short-term habits; they are not team snapshot data.
     return isDefaultSiliconEmployee(employee)
-        ? defaultEmployeeDefinition(employee.agents, employee.updatedAt, source.getSiliconEmployeeDefinition?.(id) ?? employee, null)
+        ? { ...defaultEmployeeDefinition(employee.agents, employee.updatedAt, source.getSiliconEmployeeDefinition?.(id) ?? employee, null),
+            avatar: employee.avatar }
         : employee;
 }
 /** Resolve once per new run. Team duty/role/leadership remain local; no knowledge is read. */

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>;