@realqiyan/agent-task 0.1.0-rc.2 → 0.1.0-rc.4

package/README.md

@@ -34,37 +34,16 @@ agent-task status
 agent-task restart
 ```
 
-npm 包名为 `@realqiyan/agent-task`，安装后的命令仍为 `agent-task`。setup 要求确认目录、端口、令牌与协调模型。MCP 连接自动启动或复用独立后台，检测本机执行 CLI，并在缺少 ACP 适配器时安装当时最新版；已有适配器复用，原生登录仍由其官方工具管理。宿主退出后后台继续运行。接入配置与前台管理方式见[部署说明](docs/deployment.md)。
-
-stdio 入口从私有文件读取内部服务 token；直接 HTTP 接入需配置独立服务 token。源码开发辅助命令（凭据须安全注入环境，不写命令行）：
-
-```bash
-node scripts/mcp-call.mjs --list
-node scripts/mcp-call.mjs service_status
-```
+setup 确认本机配置；MCP 连接自动启动或复用独立后台，宿主退出后后台继续运行。首次使用须安装至少一种原生执行 CLI 并准备其认证。完整接入配置、执行端准备与服务管理见[部署说明](docs/deployment.md)。
 
 任务由 `task_create` 提交固定 DAG，每个节点选择已就绪执行端。显式工作目录优先，否则 stdio 入口补入自己的启动目录；直接 HTTP 调用必须提供目录。具体契约见 [task-contract.ts](src/protocol/task-contract.ts)，管理工具见 [mcp.ts](src/protocol/mcp.ts)。Prompt、人工回复和工作空间选择都不授予工具权限。
 
 ## CLI 命令索引
 
-下表列出全部命令及子命令。参数见 `agent-task <命令> --help`，操作流程见 [CLI 说明](docs/cli.md)和[部署说明](docs/deployment.md)。
+完整命令与参数使用 `agent-task --help`、`agent-task <命令> --help` 查询，不在文档中维护副本。
 
-| 命令 | 子命令 | 用途 |
-| --- | --- | --- |
-| `agent-task setup` | — | 初始化、检查或接续安装配置 |
-| `agent-task mcp` | — | stdio 接入，自动启动或连接共用后台 |
-| `agent-task start` | — | 前台启动服务并调度任务 |
-| `agent-task stop` | — | 停止共用服务 |
-| `agent-task restart` | — | 应用已保存配置并重启、检查可用性 |
-| `agent-task status` | — | 查看服务健康、活动任务及待生效配置 |
-| `agent-task config` | `show`、`diff`、`edit`、`export`、`validate`、`apply` | 查看、编辑、导出、校验及保存配置 |
-| `agent-task executor` | `list`、`show`、`refresh`、`upgrade`、`enable`、`disable` | 查看与刷新执行端、升级适配器、设置启停 |
-| `agent-task coordinator` | `show`、`set`、`clear` | 查看、设置或清除协调模型配置 |
-| `agent-task credential` | `list`、`set`、`delete` | 查看凭据状态、设置或删除凭据 |
-| `agent-task task` | `list`、`show`、`pause`、`resume`、`cancel` | 查看任务，控制未来触发 |
-| `agent-task run` | `list`、`show` | 查看运行历史与交付详情 |
-| `agent-task help` / `agent-task --help` | — | 查看总帮助 |
-| `agent-task --version` | — | 查看版本 |
+- 安装与运行：`setup`、`mcp`、`start`、`stop`、`restart`、`status`，见[部署说明](docs/deployment.md)。
+- 配置与凭据：`config`、`executor`、`coordinator`、`credential`；任务与运行：`task`、`run`，见 [CLI 说明](docs/cli.md)。
 
 ## 许可证
 

package/dist/protocol/mcp-contract.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { absolutePath, identifier, timestamp } from "../shared/validation.js";
-import { nodeData, nodeStatusSchema, questionData, runStatusSchema, taskData, taskStatusSchema } from "../tasks/validation.js";
+import { cronScheduleData, nodeData, nodeStatusSchema, questionData, runStatusSchema, taskData, taskStatusSchema } from "../tasks/validation.js";
 /** Shared MCP initialization text; both the HTTP server and the local stdio proxy advertise it. */
 export const serverInstructions = `Agent Task runs caller-defined DAGs asynchronously with local ACP executors. A task is a persistent definition and schedule; a run is one execution. Task and run UUIDs are distinct from caller-defined DAG node IDs.
 Check service_status and executor_list before task_create. Poll task_run_list(taskId) at intervals for progress; use task_run_get for full outputs and task_run_reply for requested user facts. Creation returns a task, not a run or completed result. Disconnecting does not cancel work.
@@ -17,11 +17,10 @@ const scheduleOutput = z.discriminatedUnion("type", [
         type: z.literal("once"),
         at: timestamp.describe("Scheduled trigger, not actual execution start."),
     }).strict(),
-    z.object({
-        type: z.literal("interval"),
-        startAt: timestamp.describe("Anchor for the repeating schedule."),
-        seconds: z.number().int().describe("Fixed elapsed seconds between triggers."),
-    }).strict(),
+    cronScheduleData.safeExtend({
+        expression: cronScheduleData.shape.expression.describe("Five-field calendar Cron expression."),
+        timezone: cronScheduleData.shape.timezone.describe("Explicit timezone used to calculate calendar triggers."),
+    }),
 ]).describe("Stored schedule. Task status and nextAt are authoritative for future eligibility.");
 const taskNodeOutput = nodeData.safeExtend({
     id: nodeData.shape.id.describe("Caller-defined DAG node ID within this task; not a node-run UUID."),
@@ -181,6 +180,39 @@ export function pageOutput(item) {
         next: z.number().int().nonnegative().nullable().describe("Next page's after offset with the same filters; null means the scan is exhausted now, not that all work is complete."),
     }).strict();
 }
+/** Keep explicit nulls without array-valued types that some MCP clients reject. */
+export function mcpJsonSchema(schema, io) {
+    const json = z.toJSONSchema(schema, { target: "draft-7", io });
+    // Normalize after conversion: Zod compacts unions after its override callback.
+    function visit(node) {
+        if (!node || typeof node !== "object")
+            return;
+        if (Array.isArray(node.type)) {
+            const anyOf = node.type.map(type => ({ type }));
+            delete node.type;
+            if (node.anyOf)
+                node.allOf = [...(node.allOf ?? []), { anyOf }];
+            else
+                node.anyOf = anyOf;
+        }
+        for (const map of [node.properties, node.patternProperties, node.$defs]) {
+            for (const child of Object.values(map ?? {}))
+                visit(child);
+        }
+        for (const branches of [node.anyOf, node.oneOf, node.allOf]) {
+            for (const child of branches ?? [])
+                visit(child);
+        }
+        for (const child of [node.additionalProperties, node.not, node.if, node.then, node.else, node.contains, node.propertyNames])
+            visit(child);
+        if (Array.isArray(node.items))
+            node.items.forEach(visit);
+        else
+            visit(node.items);
+    }
+    visit(json);
+    return json;
+}
 export function toolOutput(data) {
     return z.discriminatedUnion("ok", [
         z.object({ ok: z.literal(true), data }).strict(),

package/dist/protocol/mcp.js

@@ -3,7 +3,7 @@ import { CallToolRequestSchema, ListToolsRequestSchema, ToolSchema } from "@mode
 import { z } from "zod";
 import { errorCode, errorText, StorageError } from "../shared/errors.js";
 import { replySchema, taskSchema, taskUpdateSchema, taskIdSchema, runIdSchema, taskListSchema, taskRunListSchema } from "./task-contract.js";
-import { executorsOutput, pageOutput, runOutput, runSummaryOutput, serverInstructions, statusOutput, taskOutput, taskSummaryOutput, toolOutput } from "./mcp-contract.js";
+import { executorsOutput, mcpJsonSchema, pageOutput, runOutput, runSummaryOutput, serverInstructions, statusOutput, taskOutput, taskSummaryOutput, toolOutput } from "./mcp-contract.js";
 import { version } from "../infrastructure/version.js";
 const readOnly = { readOnly: true, destructive: false, idempotent: true, openWorld: false };
 export function createMcpServer(service, fatal) {
@@ -17,8 +17,8 @@ export function createMcpServer(service, fatal) {
             definition: ToolSchema.parse({
                 name,
                 description,
-                inputSchema: { ...z.toJSONSchema(inputSchema, { target: "draft-7", io: "input" }), type: "object" },
-                outputSchema: { ...z.toJSONSchema(outputSchema, { target: "draft-7", io: "output" }), type: "object" },
+                inputSchema: { ...mcpJsonSchema(inputSchema, "input"), type: "object" },
+                outputSchema: { ...mcpJsonSchema(outputSchema, "output"), type: "object" },
                 annotations: { readOnlyHint: hints.readOnly, destructiveHint: hints.destructive, idempotentHint: hints.idempotent, openWorldHint: hints.openWorld },
             }),
             call(input) {
@@ -39,7 +39,7 @@ export function createMcpServer(service, fatal) {
     }
     register("service_status", "Check scheduler/storage health, coordinator configuration and capacity before creating work or when diagnosing a stalled run. Does not test model credentials or availability; use executor_list for executor readiness.", z.object({}).strict(), statusOutput, () => service.supervisor.status());
     register("executor_list", "Find local ACP executor IDs for task_create and inspect adapter preparation. Select only state=ready; this confirms launch dependencies, not native authentication or tool authorization. Does not refresh discovery or install adapters.", z.object({}).strict(), executorsOutput, () => ({ executors: service.executors.list().executors.map(executorStatus) }));
-    register("task_create", "Create a persistent task for immediate, one-time or interval execution. Supply the complete fixed DAG and a ready executor per node; the coordinator reviews deliveries and requests missing facts, but does not plan or reassign work. Requires service_status.coordinatorConfigured=true. Returns a task, not an execution result; find runs with task_run_list(taskId). Background model/ACP work survives MCP disconnection. Retry the same submission with the same requestKey and parameters, not a replacement task.", taskSchema, taskOutput, input => taskView(service.definitions.create(input)), { readOnly: false, destructive: false, idempotent: true, openWorld: true });
+    register("task_create", "Create a persistent task for immediate, one-time or Cron-scheduled execution. Supply the complete fixed DAG and a ready executor per node; the coordinator reviews deliveries and requests missing facts, but does not plan or reassign work. Requires service_status.coordinatorConfigured=true. Returns a task, not an execution result; find runs with task_run_list(taskId). Background model/ACP work survives MCP disconnection. Retry the same submission with the same requestKey and parameters, not a replacement task.", taskSchema, taskOutput, input => taskView(service.definitions.create(input)), { readOnly: false, destructive: false, idempotent: true, openWorld: true });
     register("task_list", "Find tasks and their future-trigger state, including cancelled and completed tasks. Returns compact records, oldest first; follow next for more. Use task_get for the full definition and task_run_list for execution outcomes.", taskListSchema, pageOutput(taskSummaryOutput), input => {
         const page = service.definitions.list(input.after, input.limit);
         return { items: page.items.map(taskSummary), next: page.next };

package/dist/protocol/task-contract.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { requestTimestamp } from "../shared/validation.js";
-import { nodeData, replyData, runStatusSchema, taskData, taskUpdateData } from "../tasks/validation.js";
+import { cronScheduleData, nodeData, replyData, runStatusSchema, taskData, taskUpdateData } from "../tasks/validation.js";
 export const nodeSchema = nodeData.extend({
     id: nodeData.shape.id.describe("Unique caller-defined ID in this DAG, referenced by dependsOn; not a run UUID."),
     prompt: z.string().trim().min(1).max(64_000).describe("Self-contained work and acceptance criteria for this executor. The task-level prompt is not copied here. Plain text/Markdown delivery is valid unless a format is required."),
@@ -26,7 +26,7 @@ export const taskRunListSchema = taskListSchema.extend({
 });
 export const taskUpdateSchema = taskUpdateData.extend({
     id: taskIdSchema.shape.id,
-    action: taskUpdateData.shape.action.describe("pause keeps the next trigger but suspends it; resume re-enables it without catch-up (past interval slots advance; past now/once slots become completed); cancel permanently removes future triggers. pause/resume require a remaining trigger. resume fails if any run has an interrupted node."),
+    action: taskUpdateData.shape.action.describe("pause keeps the next trigger but suspends it; resume re-enables it without catch-up (past Cron slots advance; past now/once slots become completed); cancel permanently removes future triggers. pause/resume require a remaining trigger. resume fails if any run has an interrupted node."),
 });
 export const taskSchema = taskData.extend({
     requestKey: taskData.shape.requestKey.describe("Caller-chosen creation key, scoped to the canonical workspace. Keep it stable for retries: identical normalized parameters return the existing task, including cancelled/completed tasks; changes conflict. A new key creates separate work, not a retry."),
@@ -40,11 +40,11 @@ export const taskSchema = taskData.extend({
             type: z.literal("once").describe("One slot at the specified future time."),
             at: requestTimestamp.describe("Future ISO 8601 trigger time with UTC Z or numeric offset; normalized to UTC."),
         }).strict(),
-        z.object({
-            type: z.literal("interval").describe("Repeating slots anchored to startAt, not to completion of the previous run."),
-            startAt: requestTimestamp.describe("First trigger, in the future, as ISO 8601 with UTC Z or numeric offset."),
-            seconds: z.number().int().min(60).max(31_536_000).describe("Fixed elapsed seconds between slots; not a calendar/timezone schedule."),
-        }).strict(),
+        cronScheduleData.safeExtend({
+            type: z.literal("cron").describe("Repeating calendar slots; the first match strictly after creation, not after the previous run completes."),
+            expression: z.string().trim().min(1).max(200).describe("Five fields: minute hour day-of-month month day-of-week, e.g. 0 9 * * 1-5. No seconds, @ aliases or hashed H fields. Day-of-month and day-of-week use OR when both are restricted."),
+            timezone: z.string().trim().min(1).max(100).describe("Required IANA timezone, e.g. Asia/Shanghai or UTC; never inferred from the server environment. DST follows cron-parser calendar rules."),
+        }),
     ]).describe("When runs become eligible, not guaranteed start times. Slots over 30 seconds late or overlapping a running/waiting run of this task are skipped, not queued for catch-up."),
     expiresAt: requestTimestamp.optional().describe("Cutoff for new runs and previously unstarted nodes, not a completion timeout. Must follow the first trigger. Existing ACP sessions may continue. ISO 8601 with timezone; omit for no cutoff."),
     maxRunSeconds: taskData.shape.maxRunSeconds.default(1800).describe("Run execution budget in seconds from coordinator start, excluding human-input waits; includes ACP execution. Separate from expiresAt and each node's session lifetime."),

package/dist/tasks/cron.js

@@ -0,0 +1,10 @@
+import { CronExpressionParser } from "cron-parser";
+/** Five calendar fields, deterministic expressions and an explicit IANA timezone. */
+export function parseCron(schedule, now) {
+    if (schedule.expression.trim().split(/\s+/).length !== 5 || /\bH\b/i.test(schedule.expression)) {
+        throw new Error("Cron requires five fields (minute hour day-of-month month day-of-week); hashed fields are not supported");
+    }
+    new Intl.DateTimeFormat("en", { timeZone: schedule.timezone });
+    return CronExpressionParser.parse(schedule.expression, { currentDate: now, tz: schedule.timezone });
+}
+//# sourceMappingURL=cron.js.map

package/dist/tasks/schedule.js

@@ -1,9 +1,10 @@
 import { TaskError } from "../shared/errors.js";
+import { parseCron } from "./cron.js";
 export function hasUncertainOutcome(run) {
     return run.nodes.some(node => node.status === "interrupted");
 }
 export function initialTime(schedule, now) {
-    return schedule.type === "now" ? now : Date.parse(schedule.type === "once" ? schedule.at : schedule.startAt);
+    return schedule.type === "now" ? now : schedule.type === "once" ? Date.parse(schedule.at) : parseCron(schedule, now).next().getTime();
 }
 export function resumeSchedule(task, now) {
     const next = structuredClone(task);
@@ -11,8 +12,8 @@ export function resumeSchedule(task, now) {
         throw new TaskError("precondition", "Task has no future schedule");
     next.status = "active";
     if (next.nextAt < now) {
-        if (next.input.schedule.type === "interval")
-            next.nextAt += (Math.floor((now - next.nextAt) / (next.input.schedule.seconds * 1000)) + 1) * next.input.schedule.seconds * 1000;
+        if (next.input.schedule.type === "cron")
+            next.nextAt = parseCron(next.input.schedule, now).next().getTime();
         else {
             next.nextAt = null;
             next.status = "completed";
@@ -29,9 +30,17 @@ export function dueTrigger(task, overlaps, now) {
     if (task.nextAt > now)
         return { kind: "none" };
     const schedule = task.input.schedule;
-    const count = schedule.type === "interval" ? Math.floor((now - task.nextAt) / (schedule.seconds * 1000)) + 1 : 1;
-    const at = task.nextAt + (schedule.type === "interval" ? (count - 1) * schedule.seconds * 1000 : 0);
-    return { kind: "due", at, count, nextAt: schedule.type === "interval" ? at + schedule.seconds * 1000 : null,
+    let count = 1, at = task.nextAt, nextAt = null;
+    if (schedule.type === "cron") {
+        const cron = parseCron(schedule, at);
+        nextAt = cron.next().getTime();
+        while (nextAt <= now) {
+            at = nextAt;
+            count++;
+            nextAt = cron.next().getTime();
+        }
+    }
+    return { kind: "due", at, count, nextAt,
         reason: overlaps ? "Previous round still active; slot skipped" : now - at > 30_000 ? "Late slot skipped" : null };
 }
 //# sourceMappingURL=schedule.js.map

package/dist/tasks/validation.js

@@ -1,9 +1,20 @@
 import { z } from "zod";
 import { absolutePath, identifier, text, timestamp } from "../shared/validation.js";
+import { parseCron } from "./cron.js";
+export const cronScheduleData = z.object({
+    type: z.literal("cron"), expression: text(200), timezone: text(100),
+}).strict().superRefine((schedule, ctx) => {
+    try {
+        parseCron(schedule, Date.UTC(2000, 0, 1)).next();
+    }
+    catch {
+        ctx.addIssue({ code: "custom", message: "Invalid five-field Cron expression or timezone" });
+    }
+});
 export const scheduleData = z.discriminatedUnion("type", [
     z.object({ type: z.literal("now") }).strict(),
     z.object({ type: z.literal("once"), at: timestamp }).strict(),
-    z.object({ type: z.literal("interval"), startAt: timestamp, seconds: z.number().int().min(60).max(31_536_000) }).strict(),
+    cronScheduleData,
 ]);
 export const taskStatusSchema = z.enum(["active", "paused", "cancelled", "completed", "expired"]);
 export const runStatusSchema = z.enum(["running", "succeeded", "failed", "interrupted", "skipped", "cancelled", "timed_out", "waiting_input"]);

package/docs/cli.md

@@ -44,11 +44,16 @@ agent-task config show --running
 
 ## 执行端发现与更新
 
-`agent-task executor list` 查看当前发现和准备结果；`executor show codex` 查看单个执行端。安装新的原生 CLI 后，运行 `executor refresh` 重新检测并在后台准备缺少的 ACP 适配器。该操作无需重启。准备失败时先检查报告的原因，修正后显式刷新或升级。
-
-已准备的适配器不会随普通启动或刷新自动升级。需要更新时运行 `agent-task executor upgrade codex --yes`，再用 `executor list` 检查结果。升级期间暂停向该执行端派发新工作；它不修改已有任务指派。OpenCode 使用原生 ACP 命令，通过原生 CLI 的安装渠道更新。
+```bash
+agent-task executor list
+agent-task executor show codex
+agent-task executor refresh
+# 仅在需要升级适配器时执行：
+agent-task executor upgrade codex --yes
+agent-task executor list
+```
 
-就绪状态只表示启动依赖已准备。原生登录和权限仍由执行端管理；首次准备、版本来源及运行边界见[部署说明](deployment.md)。
+发现、安装复用、升级影响和原生认证统一见[部署说明](deployment.md#执行端发现与准备)。就绪不证明工具授权或任务成功；PATH 变化也不能仅靠刷新生效。
 
 ## 凭据与任务
 

package/docs/deployment.md

@@ -54,7 +54,7 @@ agent-task setup --home /absolute/private/agent-task \
 
 发现原生 CLI 后，后台为缺少 ACP 适配器的执行端安装当时最新版，已有安装直接复用；OpenCode 使用原生 ACP 命令。安装在后台进行，可用 MCP `executor_list`、`agent-task executor list` 或 Web 查看准备结果。任务只能选择就绪执行端。适配器安装失败时保留管理入口和其他就绪执行端，修正原因后显式刷新或升级。包映射和安装实现见 [discovery.ts](../src/integrations/acp/discovery.ts)。
 
-适配器保存在安装目录的私有 `adapters/` 中，不修改全局 npm 包或执行 CLI 的原生配置。普通重连不访问 registry 升级已有适配器。显式更新使用 `agent-task executor upgrade codex --yes`，再查询状态；新版本发布成功前保留原安装，活动 ACP 进程不因升级被重启。高级启停设置及 Web/CLI 操作见 [CLI 说明](cli.md#执行端发现与更新)。
+适配器保存在安装目录的私有 `adapters/` 中，不修改全局 npm 包或执行 CLI 的原生配置。普通重连不访问 registry 升级已有适配器。显式更新使用 `agent-task executor upgrade codex --yes`，再查询状态；升级期间暂停向该执行端派发新工作，新版本发布成功前保留原安装，活动 ACP 进程不因升级被重启。重新检测和升级直接作用于当前执行端目录，无需重启，也不保存启动配置。OpenCode 通过原生 CLI 的安装渠道更新。命令入口见 [CLI 说明](cli.md#执行端发现与更新)。
 
 后台的原生环境来自启动它的进程，不随不同 MCP 客户端切换。新 CLI 位于已有 PATH 时可用 `executor refresh` 重新检测；PATH 本身变化时先停止后台，再从正确环境连接或启动。原生登录须与后台使用同一 OS 用户及 HOME/配置目录。
 
@@ -82,7 +82,7 @@ MCP 接入不会自动重启一个已存在但不可用的后台。故障时查
 
 运行配置、私有环境文件、任务和协调会话记录、结果及服务日志位于当前 `dataDir`。安装目录保留 `launch.json` 定位文件、初始化清单、适配器及启动器控制资源。npm 包、项目工作空间和执行端原生配置与数据目录分开。路径实现见 [startup.ts](../src/application/startup.ts)。
 
-打开 `status` 返回地址同源的 `/admin/`，用本地编辑器读取当前 `dataDir/environment.json` 中的 `AGENT_TASK_ADMIN_TOKEN`，在连接表单输入。不要把 token 放入 URL、命令参数、Git 或截图。CLI 从私有文件读取管理员令牌。两端使用同一管理服务，见[控制台说明](web-console.md)和 [CLI 说明](cli.md)。
+Web 访问 `status` 返回地址同源的 `/admin/`，连接与令牌保护见[控制台说明](web-console.md#启用与连接)；命令行管理见 [CLI 说明](cli.md)。两端使用同一管理服务。
 
 修改数据目录后，下次启动只准备目标配置和私有环境，并切换定位文件；不复制任务、会话、结果或日志，不删除旧目录。目标已有不同启动文件时拒绝覆盖，须停服核对并显式准备目标。新目录没有旧任务，目录切换不是恢复或重放许可。
 

package/docs/design-proposal.md

@@ -6,7 +6,7 @@
 
 ## 产品目标
 
-- 调用方通过 MCP 提交整体目标、DAG 和每节点的 ACP 执行端指派，支持立即、定时及周期执行。
+- 调用方通过 MCP 提交整体目标、DAG 和每节点的 ACP 执行端指派，支持立即、定时及 Cron 周期执行；Cron 使用五段表达式与显式时区，契约见 [task-contract.ts](../src/protocol/task-contract.ts)。
 - 任务不依赖发起客户端持续在线，保留执行、交付、失败和缺少用户事实的记录。
 - 初始化由用户确认目录、端口、令牌及协调模型；执行端自动发现并按需准备适配器。stdio 接入连接独立后台，宿主退出后后台继续调度；宿主配置由用户添加，不自动识别宿主当前项目。
 - 协调员推进既定 DAG、解释中间结果、处理澄清并组织交付；领域分析和工具操作交给执行端。
@@ -45,7 +45,7 @@ ACP 执行端：原生会话、领域推理和工具操作
 
 当前是调研和 MVP 验证阶段，直接调整接口和数据结构，不维护旧版兼容或业务库版本递增；这不授权迁移或删除历史数据。
 
-暂不实现：执行中修改 DAG、自动重试或跨端故障转移、丢失 ACP 会话的重连、人工核对后强制恢复、远程执行、多租户、日历时区调度、技能同步及动态 MCP 转发。它们需要独立产品决策，不因引入 durable 自动获得。
+暂不实现：执行中修改 DAG、自动重试或跨端故障转移、丢失 ACP 会话的重连、人工核对后强制恢复、远程执行、多租户、技能同步及动态 MCP 转发。它们需要独立产品决策，不因引入 durable 自动获得。
 
 启动方式见[部署说明](deployment.md)。[本机控制台](web-console.md)复用任务服务，使用独立管理员认证与浏览器请求边界；不提供文件下载或其他任务写操作。
 

package/docs/release.md

@@ -16,17 +16,17 @@ VERSION=$(node -p "require('./package.json').version")
 npm run test:install -- "./realqiyan-agent-task-$VERSION.tgz"
 ```
 
-安装验证先检查当前 OS 和 Node.js 版本，再在独立临时目录执行真正的全局 npm 安装，禁用 lifecycle scripts，不使用项目源码或编译器；随后验证初始化、前台启动、Web 配置、重启和认证健康检查，再验证 stdio 自动启动后台、断开后后台仍可用及显式 stop。MCP 客户端使用安装包的 SDK 依赖。验证脚本不调用模型或启动 ACP 工作。
+[安装验证](../scripts/verify-install.mjs)在独立临时目录执行真正的全局 npm 安装，禁用 lifecycle scripts，不依赖项目源码或编译器。它检查服务生命周期和认证，不调用模型或启动 ACP 工作；具体检查项以脚本为准。
 
 输出报告只包含结果和证据目录，不包含 token；只将实际运行的宿主平台记为通过，其他平台明确记为未执行。临时目录权限为私有，内有验证专用随机凭据及空任务库，不上传这些目录。基础测试中的真实 PTY 用例先检查平台及 `script` 能否创建终端；能力不可用时明确跳过，不能把跳过当成终端验收通过。
 
 脚本只验证当前环境，不在 Linux 上推断 macOS 行为；需要 macOS 证据时，在相应环境单独运行同一命令。本地可设置 `npm_config_cache` 复用下载缓存，tarball 验证可用 `npm_config_registry` 指定依赖镜像，报告会记录其地址；`--registry` 发布后验收固定使用 npmjs。不能以复制项目的 node_modules 替代安装验证。
 
-npm 接收发布后可能仍在处理包。发布后验收最多等待五分钟，确认公开 `latest` 指向目标版本，再执行默认全局安装；等待只读取 registry。超时先核对版本状态，不重复上传。
+npm 接收发布后可能仍在处理包。[发布后验收](../scripts/verify-install.mjs)有限等待公开 `latest` 指向目标版本，再执行默认全局安装；等待只读取 registry。超时先核对版本状态，不重复上传。
 
 ## GitHub Actions 门禁与受控发布
 
-- [Validate](../.github/workflows/ci.yml)：PR/master 或手动触发时在 Ubuntu 执行 TypeScript 与依赖边界检查、基础测试及构建；检查包清单。安装任务**不 checkout 项目源码**，只接收 tarball 和验收脚本，在当前 Linux runner 验证启动、重启及认证检查。常规 CI 不再要求 macOS runner；这不代表 macOS 已验证或不受支持。
+- [Validate](../.github/workflows/ci.yml)：PR/master 或手动触发时在 Ubuntu 执行 TypeScript 与依赖边界检查、基础测试及构建；检查包清单。安装任务**不 checkout 项目源码**，只接收 tarball 和验收脚本，在当前 Linux runner 验证启动、重启及认证检查。常规 CI 使用 Linux runner，不能据此推断 macOS 验证结果。
 - [Publish npm](../.github/workflows/publish.yml)：推送 `v*` tag 自动触发，也保留手动入口；仅账号 realqiyan 可发起或重跑。[发布准入](../scripts/check-release.mjs)要求 tag 与包版本一致、锁文件版本一致，且提交已进入远端 master。手动入口仅接受 master 或版本 tag，输入版本须匹配。通过全部门禁后发布同一 tarball，不重建、不执行包脚本；上传前确认版本未占用，发布后核查 latest 并执行默认全局安装验证。
 - 普通 CI 没有 npm 凭据。发布作业使用 npm Trusted Publisher 和 GitHub OIDC，不读取 `NPM_TOKEN`；并发发布被串行化。
 
@@ -70,6 +70,6 @@ EXPECTED_VERSION="$VERSION" node scripts/verify-install.mjs --registry
 
 登录成功不等于发布授权已完成。若 registry 返回需要 2FA 的 E403，停止发布；维护者须在自己的终端完成发布时认证，或配置有目标包发布权限、短有效期且获准 bypass 2FA 的 granular token。不要关闭账号 2FA，不在聊天、命令参数或日志中传递一次性验证码或 token；不把本机登录凭据自动上传到 GitHub。
 
-不得把 dry-run、上传成功提示或候选包安装当成 npmjs 完成证据。应记录 registry 版本与 latest、默认安装结果、各平台报告，以及未执行的检查。发布结果不明时先查询 registry；同一版本不可覆盖，不盲目重试，也不擅自换版本。
+不得把 dry-run、上传成功提示或候选包安装当成 npmjs 完成证据。验收结论须有 registry 版本与 latest、默认安装和平台报告作为证据，并注明未执行的检查；按 [AGENTS.md](../AGENTS.md#tests-and-documentation)合并维护，不追加发布经过。发布结果不明时先查询 registry；同一版本不可覆盖，不盲目重试，也不擅自换版本。
 
 已发布候选有问题时，停止继续安装验证，保留证据并通知维护者决定弃用提示、tag 调整或新版本。不自动撤包、覆盖历史或删除用户数据。

package/docs/technical-design.md

@@ -8,7 +8,7 @@
 
 | 责任 | 实现入口 | 基础验证 |
 | --- | --- | --- |
-| 任务定义、执行端快照、未来触发控制 | [TaskDefinitions](../src/tasks/definitions.ts)、[图校验](../src/tasks/graph.ts)、[时间规则](../src/tasks/schedule.ts) | [tasks.test.mjs](../tests/tasks.test.mjs) |
+| 任务定义、执行端快照、未来触发控制 | [TaskDefinitions](../src/tasks/definitions.ts)、[图校验](../src/tasks/graph.ts)、[时间规则](../src/tasks/schedule.ts)、[Cron 解析](../src/tasks/cron.ts) | [tasks.test.mjs](../tests/tasks.test.mjs)、[schedule.test.mjs](../tests/schedule.test.mjs) |
 | Run 与节点状态的业务修改入口、派发与提交顺序 | [TaskRuns](../src/tasks/runs.ts)、[数据模型](../src/tasks/model.ts)、[窄能力契约](../src/tasks/ports.ts) | [tasks.test.mjs](../tests/tasks.test.mjs)、[task-storage.test.mjs](../tests/task-storage.test.mjs) |
 | 时钟、协调会话监督、取消与收尾 | [RunSupervisor](../src/tasks/supervisor.ts)、[NodeSessions](../src/tasks/sessions.ts) | [tasks.test.mjs](../tests/tasks.test.mjs)、[restart.test.mjs](../tests/restart.test.mjs) |
 | 人工事实等待与回复 | [纯状态规则](../src/tasks/human-input.ts)、[TaskRuns](../src/tasks/runs.ts) | [human-input.test.mjs](../tests/human-input.test.mjs) |
@@ -22,15 +22,13 @@
 | MCP、HTTP 与 Web | [MCP 工具](../src/protocol/mcp.ts)、[输出契约](../src/protocol/mcp-contract.ts)、[stdio 接入](../src/protocol/stdio.ts)、[HTTP 服务](../src/protocol/http/server.ts)、[Web 路由](../src/protocol/http/web.ts)、[页面](../src/web/) | [service.test.mjs](../tests/service.test.mjs)、[web.test.mjs](../tests/web.test.mjs) |
 | CLI 与本机控制协议 | [CLI](../src/protocol/cli/commands.ts)、[管理客户端](../src/protocol/cli/admin-client.ts)、[启动器客户端](../src/integrations/local-service/control.ts) | [web.test.mjs](../tests/web.test.mjs)、[restart.test.mjs](../tests/restart.test.mjs) |
 | 装配、启动、关闭与重启 | [main](../src/application/main.ts)、[MCP 后台启动](../src/application/mcp-entry.ts)、[业务运行实例](../src/application/task-runtime.ts)、[launcher](../src/application/launcher.ts)、[启动准备](../src/application/startup.ts) | [stdio.test.mjs](../tests/stdio.test.mjs)、[restart.test.mjs](../tests/restart.test.mjs)、[service.test.mjs](../tests/service.test.mjs) |
-| 安装与发布 | [命令入口](../bin/agent-task.mjs)、[setup](../scripts/setup.mjs)、[安装库](../scripts/install-lib.mjs)、[包门禁](../scripts/pack-release.mjs)、[工作流](../.github/workflows/) | [install.test.mjs](../tests/install.test.mjs)、[setup.test.mjs](../tests/setup.test.mjs)、[发布说明](release.md) |
+| 安装与发布 | [命令入口](../bin/agent-task.mjs)、[setup](../scripts/setup.mjs)、[安装库](../scripts/install-lib.mjs)、[包门禁](../scripts/pack-release.mjs)、[发布准入](../scripts/check-release.mjs)、[工作流](../.github/workflows/) | [install.test.mjs](../tests/install.test.mjs)、[setup.test.mjs](../tests/setup.test.mjs)、[release.test.mjs](../tests/release.test.mjs)、[发布说明](release.md) |
 
 ## 依赖与一致性边界
 
-[依赖检查器](../scripts/check-boundaries.mjs)随 `npm run check` 执行。它检查 TypeScript 模块的静态导入、类型依赖、再导出、字面量动态导入和 worker 文件引用，拒绝循环依赖、越层引用、SDK 进入业务模块，以及运行服务之外的 `commitRun` 调用。新增文件必须有明确职责分类。
+依赖方向由[架构原则](architecture-guidelines.md#职责与依赖)定义，[依赖检查器](../scripts/check-boundaries.mjs)随 `npm run check` 执行。模块分类、允许引用及 Run 写入口检查以该脚本为准；新增文件须明确归属。
 
-模型只依赖模型；能力契约只依赖数据与其他契约；纯规则和基础校验不接触存储或协议。服务可组合其他服务，但不导入存储实现、基础设施或协议 SDK。存储实现依赖数据、校验和基础设施。协议与执行适配器调用业务能力，由应用入口装配。CLI 读取私有启动信息及调用启动器的边界在检查器中明确列出。
-
-[TaskRuns](../src/tasks/runs.ts)持有 Run 写能力。定义服务不写 Run；监督器、模型工具、ACP 回调、超时、取消和人工回复通过运行服务的业务操作修改它。任务游标与 Run 仍使用同一事务，节点派发在创建 worker 前提交；异步结果返回后重新读取当前状态。缺少持久字段或非规范记录直接拒绝，不使用请求默认值修复。配置文件是管理员提供的下次启动输入，按配置请求契约解析；它不与 Task/Run 的持久记录契约共用默认值。
+[TaskRuns](../src/tasks/runs.ts)是 Run 状态的唯一业务写入口。状态转换与提交顺序在该服务维护，事务实现在 [TaskStore](../src/tasks/storage/store.ts)。[持久记录校验](../src/tasks/storage/records.ts)严格拒绝缺失或非规范记录，不使用请求默认值修复；管理员提供的下次启动配置另用[配置请求契约](../src/protocol/settings-contract.ts)解析。
 
 检查器约束源码依赖，不是权限沙箱，也不证明运行时副作用安全。真实模型和执行端的证据边界见[验证说明](validation.md)。
 

package/docs/validation.md

@@ -1,6 +1,6 @@
 # 验证导航与证据边界
 
-**当前使用流程简化已通过本地基础测试、适配器安装、独立安装包验收，以及单节点与三节点 DAG 的真实模型复验。** 具体版本、环境和证据见下文。项目不宣称生产可用或外部副作用 exactly-once。
+项目处于调研阶段，不宣称生产可用或外部副作用 exactly-once。以下结论只适用于所列版本、环境和用例；安装、协议连接与真实任务成功是不同证据，不能互相替代。
 
 ## 本地验证
 
@@ -10,36 +10,15 @@ npm test
 git diff --check
 ```
 
-各职责的测试入口见[代码导航](technical-design.md)。基础测试使用真实本地文件、SQLite、进程和 SDK，不调用外部模型，不使用假模型或模拟 provider。失败进程和 no_model 只证明失败路径；结构化状态用例不证明模型语义判断。`check` 同时执行 TypeScript 与[依赖边界检查](../scripts/check-boundaries.mjs)，后者检查模块依赖、循环、SDK 位置和 Run 写入口；它不证明运行时权限或模型语义。
+基础测试使用真实本地文件、SQLite、进程和 SDK，不调用外部模型，不使用假模型或模拟 provider。各职责的测试入口统一见[代码导航](technical-design.md)。失败进程和 `no_model` 只证明失败路径；结构化状态断言不证明模型语义判断。静态依赖检查不证明运行时权限或外部副作用安全。
 
-[MCP 服务测试](../tests/service.test.mjs)还通过真实 HTTP `tools/list` 获取全部工具的输出契约，确认嵌套字段均有校验约束，并用 SDK 的 AJV 校验器验证每个工具的成功和参数错误响应、稳定错误 `code`、业务失败、分页、按状态过滤及紧凑任务/运行列表。反例验证缺失字段、错误类型和矛盾的成功/失败封装被拒绝。契约入口见 [mcp-contract.ts](../src/protocol/mcp-contract.ts)。这不替代原警告客户端的复验；其名称和版本尚未提供。
-
-2026-10-23，Linux x64、Node 24.15.0：使用流程简化通过类型与依赖边界检查、49 项基础测试和包清单门禁。重点证据：
-
-- [stdio 进程测试](../tests/stdio.test.mjs)：两个项目并发连接只保留一个后台；目录默认值、显式覆盖及跨项目请求键独立。关闭 stdin 和向客户端进程组发送 SIGHUP 后，后台仍触发未来任务。这些运行因 `no_model` 失败，只证明持续调度与无误派发，不证明 ACP 成功。
-- [MCP 服务测试](../tests/service.test.mjs)：没有原生 CLI 时拒绝连接，管理接口可用；安装到已有 PATH 后，下次连接重新发现。直接 HTTP 提交缺少目录时拒绝。
-- [执行端测试](../tests/executors.test.mjs)：原生 CLI 与适配器分开检测，禁用不安装，已有安装离线复用；真实失败安装进程不替换已发布组件，关闭时取消等待且不释放其他进程的锁。
-- [初始化 PTY 测试](../tests/setup.test.mjs)：目录、端口和令牌须确认，取消不写文件；协调员密钥隐藏输入，生成令牌不输出。初始化不安装执行端。
-- [启动锁测试](../tests/sqlite.test.mjs)：四个真实进程同时争用全新锁文件时，只有一个取得所有权；持锁进程强杀后可重新取得锁。修复前曾复现所有启动器同时争锁失败，修复后使用有限的错开重试，不触发任务重放。
-- [存储测试](../tests/task-storage.test.mjs)与[任务测试](../tests/tasks.test.mjs)：固定规范工作目录、按目录去重、严格记录拒绝而不修复、事务失败回滚、先持久派发意图再启动真实进程，以及关闭与迟到回调。
-
-当前版本的真实模型证据见 [0.1.0-rc.1 复验](#010-rc1-复验)。本次未运行 macOS 验收。此前模块化重构的 42 项测试及临时源码副本中的依赖违规拒绝实验也已通过，属于本次改造前的证据。
+[MCP 服务测试](../tests/service.test.mjs)通过真实 HTTP 和 SDK 校验器检查输入/输出契约、成功与失败响应及列表查询。契约不使用数组形式的 `type`，可空字段仍必填并接受 `null`；实现见 [mcp-contract.ts](../src/protocol/mcp-contract.ts)。这不替代曾报告契约警告的客户端复验，其名称和版本尚未提供。
 
 ## 控制台验证
 
-[Web/CLI 用例](../tests/web.test.mjs)使用真实本机服务进程验证两端查询与保存的互通、旧草稿拒绝、发现状态和禁用策略一致、凭据引用保护、离线失败不写文件，以及独立管理员认证、Host/Origin/请求类型边界、有限任务写入、密钥不回显或进入日志。也验证重启后的配置差异和目录切换不复制历史。[重启用例](../tests/restart.test.mjs)验证前台 CLI、固定端口进程更换、绑定失败不能报成功，以及持久化的不确定派发在重复重启后仍被阻断。实际任务记录来自业务服务，不使用假模型输出。
-
-[配置用例](../tests/settings.test.mjs)验证私有文件边界、旧编辑拒绝、显式凭据环境、端点与密钥引用分离、服务令牌别名不能作为模型凭据、失败时保留文件，以及关闭后拒绝操作。这些用例不构成断电、磁盘满或目录同步失败窗口的完整证据。
-
-尚未完成真实浏览器交互、CSP 执行和跨浏览器缓存/自动填充验收；CLI 的编辑器交互和隐藏终端凭据输入也未做终端验收，凭据测试使用 stdin。需在浏览器核对：不可信任务文本不执行脚本或加载外链；离开、刷新和退出后无令牌残留；配置草稿不被轮询覆盖；密钥保存与配置保存的提示明确。HTTP 头检查不能替代这些验证，也不证明模型认证或 ACP 执行成功。
-
-### 执行端与安装包
-
-同日使用隔离 HOME，从 npm registry 真实安装 pi-acp 0.0.34、codex-acp 2.2.2 和 claude-agent-acp 0.94.0，再确认后续准备复用同一安装。报告位于 `/tmp/agent-task-adapter-install-T68wMA/report.json`。没有启动原生 CLI、发送 ACP 会话或调用模型；成功下载与准备不等于认证或任务成功。
+[Web/CLI](../tests/web.test.mjs)、[配置](../tests/settings.test.mjs)和[重启](../tests/restart.test.mjs)测试覆盖真实本机服务的管理互通、旧编辑拒绝、凭据隔离、浏览器请求边界、配置生效与目录切换，以及重启后不确定派发仍被阻断。配置文件测试不构成断电、磁盘满或目录同步失败窗口的完整证据。
 
-由当前源码打包的本地 tarball 通过独立 prefix 安装验收，不依赖源码或 TypeScript。前台启动、Web HTTP 保存、Web/CLI 重启、stdio 自动启动后台、执行端发现、客户端断开后后台健康，以及显式 stop 均通过。使用真实失败程序提供可发现的原生路径，未执行 ACP 或模型工作；捕获输出未发现验证凭据。报告位于 `/tmp/agent-task-npm-LD5GQJ/report.json`。临时目录可能被系统清理，长期证据需安全归档。
-
-当前候选的发布状态见下文；历史包验收不代替当前 macOS、真实宿主应用或四种执行端的模型任务复验。
+尚未完成真实浏览器交互、CSP 执行和跨浏览器缓存/自动填充验收。仍需核对不可信文本不执行脚本或加载外链、离开页面后无令牌残留、配置草稿不被轮询覆盖，以及密钥与配置保存的提示。HTTP 头检查不能替代这些验证。CLI 编辑器交互和隐藏终端凭据输入也未做终端验收，凭据测试使用 stdin。
 
 ## 真实模型验收入口
 
@@ -51,140 +30,56 @@ git diff --check
 
 完整前置检查、参数和断言见 [E2E 用例](../tests/e2e/)、[Pi 启动器](../scripts/run-pi-human-e2e.mjs)。Pi 启动器为两端共用获准测试密钥，创建独立原生配置，只启用 read；这不是 OS 沙箱或独立账户隔离。强杀或断电不能保证临时认证清理，需管理员核查。
 
-运行证据保留在命令输出的私有目录，可能包含敏感内容；不自动删除或将一次成功推广为普遍支持。
-
-### 0.1.0-rc.1 复验
-
-2026-10-23，Linux x64、Node 24.15.0，使用已有获准 DeepSeek 测试凭据、`deepseek-flash` 协调员、隔离的只读 Pi 原生配置及连接时安装的 pi-acp 0.0.34。现有单节点和三节点用例各执行一次，均通过；没有修改交付断言或重试任务。
-
-- 单节点约 16.3 秒：真实 ACP 交付包含标识和结果 323，一个会话、一轮执行，结果文件持久化通过。证据：`/tmp/agent-task-real-e2e-Igj91J`；Run：`5d4f2b74-eb41-402c-874e-441b1fb29d91`。
-- 三节点约 36.5 秒：测试客户端提供数量 4，结果 1292；同一 Run 等待并接受回复，节点轮数 1 / 2 / 1，已接受的上游不重放，三个交付均保留标识和必需数值。证据：`/tmp/agent-task-real-e2e-oreA3j`；Run：`3e6dd91b-35a5-4038-945c-c9d402d2829f`。
-
-两项测试均在提交任务后断开客户端，再由新连接观察结果。原始测试日志：`/tmp/agent-task-pi-human-6N0Zlj/test-1.log`。服务正常退出，临时原生认证和服务环境文件已清空，任务、会话、结果及验收摘要保留。临时目录可能被系统清理，长期证据需安全归档。
-
-此证据覆盖当前任务契约和适配器准备路径。系统级自启、真实 Pi 宿主退出、模型执行中重启及 Codex、Claude、OpenCode 模型任务未验收；stdio 后台生命周期由本地进程测试覆盖。只读配置不是 OS 沙箱。
-
-### 本机三节点验收
-
-2026-10-22，Linux x64、Node 24.15.0，使用 DeepSeek 协调员和只读 Pi ACP 执行端，此前带 JSON 格式约束的用例运行 `npm run test:e2e:human -- --quantity 4` 一次通过，约 28 秒。数量由测试客户端提供，结果为 1292，不是真人输入。
-
-该次运行验证了固定 DAG 的真实 ACP 交付、人工等待后续接同一运行、同一 ACP 会话内澄清，以及已接受上游不重放。未执行独立单节点用例、真人回答文件模式或重启/故障恢复。
-
-复核业务库、durable 记录和 Pi 原生会话后，确认只有一个 TaskRun、三个 ACP 会话和两次上游文件读取。`audit` 的工具前说明与最终 JSON 被聚合进同一轮输出，导致额外一轮格式澄清；没有重复读取上游文件。
-
-执行端启动时还留下了三次 `npm view @earendil-works/pi-coding-agent version` 记录，来源是 `pi-acp` 的版本检查，Pi 子进程的 `--offline` 未阻止该行为。日志没有查询结果，不能确认 registry 请求是否完成。服务和执行端原始 stderr、完整 ACP 通信未保留，不能据此证明整个执行栈无其他外部访问或诊断错误。
-
-测试日志：`/tmp/agent-task-pi-human-H1OKJO/test-1.log`；Pi 原生会话及 npm 日志位于同目录的 `home/`；运行证据：`/tmp/agent-task-real-e2e-O9N9RY`。临时原生认证已清空。临时文件可能被系统清理，长期留存需管理员安全归档。
-
-### 文本交付复验
-
-同日移除用例中的 JSON 格式要求和固定澄清口令，以相同命令复验一次，约 26 秒。三个节点均输出普通文本或 Markdown，轮数为 1 / 2 / 1；没有为了格式追加澄清，计算结果仍为 1292。
-
-但测试未通过：`audit` 原始输出包含必需标识，协调员接受的片段遗漏了该标识，验收理由仍声称包含它，运行被标为 `succeeded`。[三节点用例](../tests/e2e/human-dag.test.mjs)的内容断言拦住了这一遗漏，没有降低断言或重跑。此结果说明文本传递可执行，但不能把运行成功状态当成完整交付的证据；随后补充了摘录完整性指令，后续复验见下节。交付格式原则见[总体方案](design-proposal.md#架构选择)。
-
-测试日志：`/tmp/agent-task-pi-human-K8huNN/test-1.log`；运行证据：`/tmp/agent-task-real-e2e-XgRgeo`。旧记录保留，临时原生认证已清空。
-
-### 模块化重构后复验
-
-2026-10-23，Linux x64、Node 24.15.0，使用 DeepSeek `deepseek-flash` 协调员、独立只读 Pi 配置和 pi-acp 0.0.34。两项现有用例各执行一次，均通过；没有修改用例断言或重复运行失败任务。
+### 已验证结论
 
-| 用例 | 结果与证据 |
-| --- | --- |
-| 三节点 DAG 与人工回复 | `npm run test:e2e:human -- --quantity 4`，约 31.4 秒。一个 TaskRun、三个 ACP 会话，节点轮数为 1 / 2 / 1。测试客户端提供数量 4，结果为 1292；等待约 2.1 秒后续接原 Run，在同一 `total` 会话内澄清，已接受的 `price` 记录保持不变。三个交付均保留必需标识，内容断言通过。 |
-| 单节点 | 复用同一隔离配置的临时启动器运行现有 `deepseek-acp.test.mjs`，约 7.6 秒。一个 TaskRun、一个 ACP 会话、一轮执行，接受包含标识和结果 323 的交付，验证结果文件已持久化。 |
+`0.1.0-rc.1`：2026-10-23，Linux x64、Node 24.15.0，DeepSeek `deepseek-flash` 协调员、隔离的只读 Pi 原生配置及连接时安装的 pi-acp 0.0.34。单节点和三节点 DAG 用例均通过内容断言：
 
-两次提交后均断开发起 MCP 客户端，再由新连接观察完成。服务均正常退出；本次创建的 Pi 原生认证与测试服务环境文件中的凭据已清空，历史和结果文件保留。
+| 范围 | 结论 | 证据目录 |
+| --- | --- | --- |
+| 单节点 | 真实 ACP 交付保留必需标识与数值，结果文件持久化成功 | `/tmp/agent-task-real-e2e-Igj91J` |
+| 三节点 DAG 与人工回复 | 等待后续接同一 Run，在同一节点会话内澄清；已接受上游不重放，文本交付保留必需内容 | `/tmp/agent-task-real-e2e-oreA3j` |
 
-- DAG 日志：`/tmp/agent-task-pi-human-lpMTR3/test-1.log`；证据：`/tmp/agent-task-real-e2e-nwjC0U`；Run：`a42b672f-2f49-4c23-a169-98d25b2b2243`。
-- 单节点日志：`/tmp/agent-task-pi-single-lseufC/test-1.log`；证据：`/tmp/agent-task-real-e2e-iV24X1`；Run：`7320bfda-3968-4305-acf6-10d7a9dae4e7`。
-- 两个证据目录均保留 `acceptance-summary.json`、`record-audit.json`、业务 SQLite、运行快照及事件记录。临时目录可能被系统清理，长期留存需管理员安全归档。
+两项用例均在提交后断开客户端，再由新连接观察结果。原始测试日志：`/tmp/agent-task-pi-human-6N0Zlj/test-1.log`。数量来自测试客户端，不是真人文件回复。此证据不代表后续版本已完成模型复验，也不覆盖 Codex、Claude、OpenCode 的模型任务、真实宿主退出或模型执行中重启。
 
-同日以只读方式交叉核查业务库、durable 库、Pi 原生会话和结果文件。四个数据库的完整性与外键检查通过，业务记录通过严格持久化 schema 校验，最终快照与数据库一致。DAG 只有一个协调会话、两次提交（初始任务与数量回复）、11 次模型生成及 11 次工具调用；单节点为一个会话、一次提交、4 次模型生成及 4 次工具调用。所有调用均完成，无工具错误，协调员活动状态及收件箱为空。等待快照中下游仍为 pending，接受的 price 与最终记录完全一致。
+### 必须保留的限制
 
-四个节点的逐轮输入输出均与 Pi 原生日志一致，接受的交付全文与末轮输出及结果文件一致，标识和必需数值完整。DAG 原生日志只有两次 read，分别读取已接受的 price、total 文件；单节点没有工具调用。执行端启动另有 3 + 1 次 `npm view @earendil-works/pi-coding-agent version` 记录，来源为本机 pi-acp 的启动版本检查，Pi 的 `--offline` 不阻止该行为；日志没有查询结果，无法确认 registry 请求是否完成。两次服务退出码均为 0，临时认证及服务环境文件均为空对象。
+- **运行成功状态不证明交付完整。** 文本交付验收曾发现：原始输出含必需标识，但协调员接受的摘录遗漏标识，仍将运行标为 `succeeded`；内容断言拒绝了该结果。后续通过不能证明模型始终完整摘录。反例证据：`/tmp/agent-task-real-e2e-XgRgeo`。
+- **原生只读配置和 `--offline` 不证明整个执行栈无外部访问。** Pi ACP 验收留下适配器启动时的 `npm view` 版本检查记录；日志没有查询结果，不能确认 registry 请求是否完成。原生记录：`/tmp/agent-task-pi-human-lpMTR3/home/`。原始 stderr 与完整 ACP 通信未保留，也不能据此排除其他访问或诊断错误。
+- **检查点不保证外部副作用 exactly-once。** 早期 durable 的真实 SQLite/文件/SIGKILL 研究曾观察到，外部写入后、结果提交前崩溃会使恢复重复写入。这不是 ACP 恢复验收；原记录未提供实验附件链接，不能据此扩大恢复保证。
 
-本次通过覆盖了此前失败的交付标识断言，不证明模型始终完整摘录。数量来自声明的测试值，不是真人文件回复；未进行真实模型运行中的重启、故障恢复，或 Codex、Claude、OpenCode 成功路径验收。原生只读配置不是 OS 沙箱；原始 stderr 和完整 ACP 通信未保留，不能据此证明执行栈没有其他外部访问或诊断错误。
+## 执行端准备与协议连接
 
-## 恢复保证的边界
+Linux x64、Node 24.15.0 的隔离环境证据：
 
-早期 durable 研究曾在真实 SQLite/文件/SIGKILL 实验中观察到：外部文件写入后、结果提交前崩溃，恢复检查点再次执行了未做幂等保护的写入。这不是 ACP 恢复验收，而是检查点不保证外部副作用 exactly-once 的证据。
-
-## 部署验证
-
-Linux x64、Node 24.15.0 的本机记录：
-
-- 专属目录安装、重复安装及带 token 的 MCP 健康检查通过。
-- Pi 1.3.0 + pi-acp 0.0.34、codex-acp 2.2.2、OpenCode 1.19.3 在独立无认证 HOME 下均通过 initialize；没有发送 session/new 或模型任务，也未自动批准执行端。
-- 首次安装实验遭遇磁盘满并损坏实验清单；未删除任务数据修复。修正后在新的专属目录完成上述部署复验，不构成业务运行时磁盘满恢复的证据。
-
-证据目录：`/tmp/agent-task-deploy-verified`、`/tmp/agent-task-deploy-final`；工作空间：`/tmp/agent-task-deploy-workspace`；空认证 HOME：`/tmp/agent-task-deploy-native-home`。临时文件可能被系统清理，长期留存需管理员安全归档。
+| 范围 | 结论与条件 | 证据 |
+| --- | --- | --- |
+| 适配器安装 | pi-acp 0.0.34、codex-acp 2.2.2、claude-agent-acp 0.94.0 从 npm registry 安装并复用成功；未启动原生 CLI 或模型 | `/tmp/agent-task-adapter-install-T68wMA/report.json` |
+| ACP initialize | Pi 1.3.0 + pi-acp 0.0.34、codex-acp 2.2.2、OpenCode 1.19.3 在无认证 HOME 下通过；未发送 `session/new` 或模型任务 | `/tmp/agent-task-deploy-verified`、`/tmp/agent-task-deploy-final` |
 
+下载成功与 initialize 不证明原生认证、工具授权或任务成功。
 
 ## npm 发布候选验证
 
-### 0.1.0-rc.1（已发布）
-
-本候选包含 stdio 共用后台、本机执行端发现与适配器准备、固定任务目录和按目录去重，以及调度周期调整。初始化须确认目录、端口、令牌及协调模型；普通启动不转换旧配置或业务数据。
-
-2026-10-23，Linux x64、Node 24.15.0：锁定依赖重装、类型与依赖边界检查、49 项基础测试、两项真实模型测试、包清单门禁及独立安装验收均通过。真实模型范围见 [0.1.0-rc.1 复验](#010-rc1-复验)。
-
-本地候选包安装报告：`/tmp/agent-task-npm-SxC74r/report.json`。使用独立 prefix 与原生 HOME，不依赖源码或 TypeScript；前台、Web/CLI 重启、stdio 自动启动、断开后后台健康和 stop 均通过。此次依赖下载使用 npm 镜像；发布后的默认安装须另以 npmjs 验证。报告仅把本机 Linux 记为通过，未执行 macOS 验收。发布完成以工作流结果和 registry 核对为准。
-
-[GitHub 发布运行 40005739943](https://github.com/realqiyan/agent-task/actions/runs/40005739943)验证提交 `b6d138d`：Node 22.19.0/24.x 检查与 49 项测试、包门禁及 Linux 独立安装全部通过。GitHub OIDC 发布步骤成功，npm 随后提示包正在处理；即时 latest 检查仍读到旧版本，导致该运行最终失败。此失败发生在发布后的校验阶段。
-
-后续匿名 npmjs 核对确认 **[@realqiyan/agent-task@0.1.0-rc.1](https://www.npmjs.com/package/@realqiyan/agent-task/v/0.1.0-rc.1)** 存在、`latest=0.1.0-rc.1`，并包含 GitHub provenance。未指定版本的默认全局安装及前台、Web/CLI、stdio 后台验收通过，报告：`/tmp/agent-task-npm-lTc9FG/report.json`。捕获输出未发现验证凭据，无模型或 ACP 工作。发布后校验现已加入有限等待和 `verify_only` 入口，后续复核无需再次上传同一版本。
-
-[仅验证运行 40006683937](https://github.com/realqiyan/agent-task/actions/runs/40006683937)在提交 `3e8e7cd` 上全部通过：Node 22.19.0/24.x 检查和 49 项测试、打包、Linux 独立安装及 npmjs 默认安装复核。该运行跳过发布上传，未重复发布同一版本。
-
-### 0.0.1-rc.3（历史证据）
-
-2026-10-23，[GitHub 发布运行 39980466554](https://github.com/realqiyan/agent-task/actions/runs/39980466554)验证提交 `80b12de`：Node 22.19.0/24.x 类型与依赖检查、基础测试、包清单门禁，以及当前 Linux runner 的独立安装、启动、重启和认证检查均通过。当前发布门禁验证宿主环境；macOS 需在对应环境另行验收。安装报告明确标记其他平台未执行，PTY 用例在缺少终端能力时明确跳过。
-
-发布作业使用 Node 24.21.0、npm 11.19.0 和 GitHub OIDC。包版本检查及 provenance 签名成功，但上传包的 npm PUT 请求返回 E404；发布后的默认安装验证因此未执行。随后 registry 查询未发现 `0.0.1-rc.3`，不能把生成 provenance 当作包已发布。
-
-错误指向 npm 发布授权未生效，需核对该包的 Trusted Publisher 与仓库、工作流、Environment 和允许操作是否匹配。本机凭据读取 trust 设置返回 403，尚未确认具体缺失或不匹配项。GitHub 的 `npm` Environment 已限制为 master；工作流配置与 npm 端授权仍需分别核实，见[发布说明](release.md)。
-
-本机检查与 42 项基础测试通过；独立空工具 PATH 下的真实测试进程确认 PTY 用例明确跳过。发布诊断及已去除下载 URL 查询参数的日志保留于 `/tmp/agent-task-rc3-final-d4tqqpt9`，临时目录可能被系统清理。
-
-2026-10-23 后续匿名 registry 核对确认 `0.0.1-rc.3` 已存在，发布元数据包含 provenance；当时 `latest=0.0.1-rc.3`。上述失败运行是历史记录，不代表后续 registry 状态，也不能单凭元数据判定最终成功发布的操作渠道。
-
-### 0.0.1-rc.2（历史证据）
-
-2026-10-22，`realqiyan` 已将 **[@realqiyan/agent-task@0.0.1-rc.2](https://www.npmjs.com/package/@realqiyan/agent-task/v/0.0.1-rc.2)** 发布到 npmjs。匿名 registry 查询确认版本、发布账号、MIT 许可证及 `latest=0.0.1-rc.2`。本机直接发布了下述 CI 已验收的同一 tarball，没有重新构建，也没有 GitHub provenance。
-
-- [Validate 运行 39829900075](https://github.com/realqiyan/agent-task/actions/runs/39829900075)在提交 `48549ea` 上全部通过：Node 22.19.0/24.x 类型检查、35 项基础测试、构建和包清单门禁。
-- Ubuntu x64 与 macOS ARM64 的 Node 22.19.0 安装任务不 checkout 源码，使用同一 CI tarball 验证前台、Web/CLI 重启、启动目录/端口/token 变量名切换、认证健康检查。macOS 证据来自 hosted runner，不包括 Intel Mac、浏览器、休眠或用户注销场景。
-- 发布后在 Linux x64、Node 24.15.0 以独立空 npm 配置匿名执行默认 `npm install -g @realqiyan/agent-task`，未指定版本或使用本地 tarball；固定使用 npmjs。前台、Web HTTP 配置、重启、健康检查均通过。
-
-发布后安装报告：`/tmp/agent-task-npm-vseswA/report.json`。捕获输出未发现验证凭据，测试服务已移除。没有模型调用或 ACP 任务，不替代原生认证、权限或真实模型复验。临时目录可能被系统清理；包内文档是打包时快照，后续证据以本仓库为准。
-
-### 0.0.1-rc.1（历史证据）
-
-2026-10-22，`realqiyan` 已将 **[@realqiyan/agent-task@0.0.1-rc.1](https://www.npmjs.com/package/@realqiyan/agent-task/v/0.0.1-rc.1)** 发布到 npmjs。匿名 registry 查询确认版本、发布账号、MIT 许可证及 `latest=0.0.1-rc.1`。本次经授权从本机发布，没有 GitHub provenance。包内文档是打包时快照，后续证据以[仓库中的最新记录](https://github.com/realqiyan/agent-task/blob/master/docs/validation.md#npm-发布候选验证)为准。
-
-npm 因包名保护拒绝了未加 scope 的 `agent-task`：名称被判定与 `agent-base` 过于相似。维护者已明确批准使用 `@realqiyan/agent-task`，安装命令随之改为 `npm install -g @realqiyan/agent-task`，CLI 仍为 `agent-task`。未关闭账号 2FA，也未上传本机凭据。
-
-本次 Linux x64 证据：
-
-- Node 22.19.0 和 24.15.0 的 TypeScript 检查、33 项基础测试及构建均通过；真实 PTY 用例验证 setup 的确认/取消、生成独立 token 和不输出凭据。
-- [包清单门禁](../scripts/pack-release.mjs)通过：仅包含预编译 JS、Web 资源、明确列出的操作脚本、示例及公开文档；不包含源码、开发工具、凭据文件、运行数据库或本地记录。
-- Node 22.19.0 先验收 scoped tarball，再从 npmjs 按 `npm install -g @realqiyan/agent-task` 的默认版本选择全局安装到独立临时 prefix；没有指定版本或使用本地 tarball 替代 registry 安装。禁用 lifecycle scripts，不使用项目源码或 TypeScript。前台启动、Web HTTP 配置保存/重启及带认证的健康检查均通过。
-- tarball 预验收使用 npm 镜像依赖；发布后验收固定使用 `https://registry.npmjs.org/`，通过独立空 npm 配置文件进行匿名安装。复用 npm 下载缓存，没有复制项目 node_modules；不构成空缓存下载时延的保证。
+发布与安装操作由[发布说明](release.md)维护。此处只保留有适用范围的证据，不逐版记录发布过程。
 
-Linux 22.19.0 的发布后 registry 安装报告：`/tmp/agent-task-npm-uM8FT5/report.json`；scoped tarball 预验收报告：`/tmp/agent-task-npm-Zgkggc/report.json`。临时目录包含验证专用随机凭据和空业务库，不上传或打包；报告仅含结果。Node 22.19.0 会输出内置 SQLite 的 experimental warning，这不是认证错误。
+| 范围 | 结论 | 证据 |
+| --- | --- | --- |
+| `0.1.0-rc.2`，提交 `7ffed5c` | Node 22.19.0/24.x 基础检查、包门禁、Linux 独立安装、GitHub OIDC 发布及 npmjs 默认安装验收通过；公开包有 provenance | [发布运行](https://github.com/realqiyan/agent-task/actions/runs/40067373860)、[npm 版本](https://www.npmjs.com/package/@realqiyan/agent-task/v/0.1.0-rc.2) |
+| 同版本，Linux x64、Node 24.15.0 | 从 npmjs 默认安装到独立 prefix，通过前台、Web/CLI 重启、stdio 后台、断开后健康及 stop 检查；捕获输出未发现验证凭据 | `/tmp/agent-task-npm-qiT8oy/report.json` |
+| `0.0.1-rc.2`，提交 `48549ea`，历史平台证据 | Ubuntu x64 与 macOS ARM64 hosted runner 在 Node 22.19.0 下使用 CI tarball、无源码完成安装、前台、重启及认证检查 | [Validate 运行](https://github.com/realqiyan/agent-task/actions/runs/39829900075) |
 
-同日，[GitHub Validate 运行 39813423968](https://github.com/realqiyan/agent-task/actions/runs/39813423968)在提交 `461a1b0` 上全部通过：Node 22.19.0/24.x 检查、基础测试、构建及包清单门禁；Ubuntu x64 与 macOS ARM64 的 Node 22.19.0 安装任务均不 checkout 源码，使用 CI tarball 完成前台、Web HTTP 配置、认证健康检查验收。报告确认输出无验证凭据，没有模型或 ACP 工作。macOS 的证据来自 hosted runner，不包括 Intel Mac、交互式终端/浏览器、休眠或用户注销场景。
+`0.1.0-rc.2` 的发布验收未执行 macOS、浏览器或真实模型/ACP 任务；旧 macOS 证据不覆盖当前版本、Intel Mac、休眠或用户注销。安装检查使用真实失败程序提供可发现路径，不证明成功 ACP 执行。PTY 能力不可用时测试明确跳过，跳过不是通过。
 
-[受控发布工作流](../.github/workflows/publish.yml)已推送，但发布 Environment 审核和 npm 发布 secret 尚未配置，发布作业没有实际执行；本机首发和 Validate 通过不等于 Actions 发布已经验收。
+上述发布状态是验收时的事实，不是实时 registry 查询；包内文档是发布提交的快照。
 
-操作和发布条件见[部署说明](deployment.md)、[发布说明](release.md)。此前源码安装的历史部署证据不替代本次 npm 候选包验收。
+## 证据保管与未验证边界
 
-## 尚未验证
+本地证据目录可能含敏感的任务、会话和原生配置，不上传到 Git 或 npm，也不自动删除。`/tmp` 路径是原始证据定位，不保证仍存在；需长期复核时由管理员安全归档。测试入口说明可验证什么，不等于已经执行。
 
-- 复杂任务的语义验收、并行分支与汇合、不同执行端之间的交付。
-- 各执行端原生权限、认证续期、沙箱、技能/MCP 发现及文件访问；其他模型和 OpenAI 兼容端点的协议差异。
-- 真实模型崩溃窗口、重复收费和预算行为；人工等待期间保留真实 ACP 会话的续答、并发回复、长时间等待及重启。
-- 系统级强杀、断电、业务库磁盘满、真实任务的长期监督和原生权限。
-- SDK 升级、历史数据转换，以及执行中修改计划等当前未开放能力。
+除各节限制外，以下尚未完成真实验收：
 
-实现和操作入口见[代码导航](technical-design.md)、[部署说明](deployment.md)。
+- 复杂任务语义、并行分支与汇合、跨执行端交付；其他模型及 OpenAI 兼容端点差异。
+- 各执行端原生权限、认证续期、沙箱、技能/MCP 发现及文件访问边界。
+- 真人回答文件模式、并发回复，以及长时间等待或重启后的真实 ACP 会话续答。
+- 真实模型崩溃窗口、重复收费和预算行为；系统级强杀、断电、业务库磁盘满、系统自启及真实任务长期监督。
+- SDK 升级和历史数据转换；[当前未开放能力](design-proposal.md#当前范围与暂缓能力)不因已有测试通过而获得保证。

package/docs/web-console.md

@@ -19,8 +19,7 @@
 - 任务列表、固定 DAG、运行历史、节点进度、已接受交付、错误和问题只读。触发计划结束不等于运行成功，原始输出不等于交付。
 - 任务写操作仅复用 `task_update`，暂停、恢复或取消未来触发。不停止当前运行，不补跑错过的触发，不回答问题或修改 DAG。已有不确定外部结果的任务拒绝恢复未来触发；当前不提供人工核对后强制恢复能力。
 - 协调模型是常规配置入口。数据目录、监听端口、MCP token 环境变量名和执行端启停位于高级设置，下次启动生效。修改 token 变量名保留令牌值，不在页面回显。
-- 执行端自动检测本机 pi、codex、claude 和 opencode。页面显示本机路径、准备结果和错误，提供重新检测与显式适配器升级；准备过程中自动更新状态。就绪不代表原生认证或工具权限已经验收。安装与更新边界见[部署说明](deployment.md)。
-- 无须手工注册执行端、设置默认工作目录或另行批准。原生认证和权限继续用官方工具管理；任务工作目录通过 MCP 上下文或创建参数确定。
+- 执行端页面显示本机路径、准备结果和错误，提供重新检测与显式适配器升级。就绪不代表原生认证或工具权限已经验收；安装、更新及原生环境边界见[部署说明](deployment.md#执行端发现与准备)。
 
 页面与接口入口见 [web.ts](../src/protocol/http/web.ts)、[页面模块](../src/web/)，任务契约见 [task-contract.ts](../src/protocol/task-contract.ts)。提供受管理员认证保护的重启入口；没有通用 MCP 代理、文件浏览器或下载接口。固定结果目录不授予整个 dataDir 的读取能力。
 
@@ -34,8 +33,6 @@
 
 待回答运行也可能持有 ACP 会话，重启不保证无损续接。执行端未就绪、被禁用或本机路径与任务快照不一致时，旧任务的派发会被拒绝；页面不改写快照、DAG 或执行端指派。需要新任务时由 MCP 调用方处理。
 
-重新检测和适配器升级直接作用于当前执行端目录，无需重启；它们不保存启动配置。普通刷新复用已经准备的适配器，只有显式升级才请求更新。升级期间暂停向该执行端派发新工作，完成后可在状态表核对结果。OpenCode 使用原生 ACP，通过原生 CLI 的安装渠道更新。
-
 Web 与 CLI 的旧编辑都会被拒绝，不做自动合并。离线编辑配置须先停服。校验与保存职责见 [settings.ts](../src/configuration/settings.ts)、[配置影响预览](../src/configuration/management.ts)、[settings-contract.ts](../src/protocol/settings-contract.ts)、[配置文件适配](../src/configuration/files.ts)。
 
 ## 安全与验收

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@realqiyan/agent-task",
-  "version": "0.1.0-rc.2",
+  "version": "0.1.0-rc.4",
   "license": "MIT",
   "author": "realqiyan",
   "repository": {
@@ -61,6 +61,7 @@
     "@earendil-works/pi-ai": "1.3.0",
     "@earendil-works/pi-durable": "1.3.0",
     "@modelcontextprotocol/sdk": "1.32.1",
+    "cron-parser": "5.10.2",
     "express": "5.3.0",
     "zod": "4.6.7"
   },