⏱️ dsh-automation

🕒 想让重复或单次 Coding 任务稍后运行，又不依赖一段旧对话？

🧭 想让每次无人值守运行都守在明确的工作区与权限边界内？

🧾 想随时查清运行了什么、使用哪个 revision、最终如何结束？

用户和 Agent 都可以在 DSH 中创建、管理、暂停、恢复和查看定时任务；每个真正 dispatch 的 occurrence 都会在全新 root Agent 与 Session 中启动，并留下可审计记录。

完整任务 + 运行计划 + 权限边界 → 全新 root Agent + 全新 Session + 持久运行历史

English · 简体中文

自动化总览：工作区规则、下次运行时间和最近结果

🎯 为什么需要 Automation

DSH Core Schedule 适合当前对话里的 reminder，例如“十分钟后回到这个 Session 继续检查”。dsh-automation 解决的是另一类问题：“每个工作日独立运行这份完整任务，并留下一条我可以检查的结果。”

	DSH Core Schedule	dsh-automation
执行上下文	回到同一个 live Agent	创建全新的 root Agent 与 Session
输入	已有上下文中的 follow-up

Tool	用途
`automation_create`	创建绑定当前 workspace 的 standalone rule。
`automation_list`	读取规则、下次 occurrence 和最近历史。
`automation_update`	修改名称、prompt、cadence、permission 或 active/paused 状态。
`automation_run_now`	使用相同边界排队一次 manual occurrence。
`automation_runs`	读取有限数量的 run history、error、summary 与 Session ID。
`automation_delete`	删除 definition，同时保留 durable run records。

Automation	建议边界	为什么有用
工作日回归分诊	`read-only`	检查本地测试证据、归类失败，并在新 Session 中留下简洁诊断。
每周仓库健康报告	`read-only`	检查陈旧 TODO、依赖清单、被忽略的失败和测试缺口，不修改代码树。
单次延迟验证	`read-only`	稍后重查一次 flaky failure，保留与当前对话无关的证据。
生成代码刷新	`workspace-write`	重建范围明确的生成产物，运行聚焦检查，并报告准确 diff。
维护修复窗口	`workspace-write`	复现一个有边界的问题，完成经过验证的最小修复，满足验收条件后停止。

情况	行为
Interval	最短五分钟；第一次运行发生在一个完整 interval 之后，不会创建后立即触发。
Daily / weekly	使用明确 IANA zone 的本地 `HH:mm`；DST 中不存在的本地时间会跳过，而不是被平移。
Overlap	每条 automation 同时最多一个 active run。如果前一个仍在 queued/running，到期 occurrence 会记录为 `skipped(overlap)`。
Host 延迟重启	在 grace window 内（默认 15 分钟）最多 catch up 最新一次，不会把旧任务重放成写入 backlog。
Run timeout	默认 60 分钟后取消 Agent，并把 run 记录为失败。
Host crash	重启恢复时，持久化的 `queued`/`running` 会变成 `failed(host_interrupted)`，不会偷偷重新执行。
Retry	只能手动点立即运行；没有可能重复副作用的自动重试。

Layer	拥有什么	不拥有什么
Definition/run store	Durable facts 与 revision snapshots	Timer 或 Agent
Clock	找到下一个到期 occurrence	Prompt、permission 或执行
Executor	一次已经 claim 的 fresh Agent run	Schedule mutation
Agent tools / Web RPC	经过验证的 service calls	Table、timer 或直接创建 Agent
Web client	原生 `conversation.view` 展示	权威 due state

Option	默认值	含义
`maxConcurrentRuns`	`2`	当前 Host 的全局执行容量；每条 automation 仍禁止 overlap。
`runTimeoutMinutes`	`60`	一次 fresh Agent run 的最大 wall-clock 时间。
`misfireGraceMinutes`	`15`	Host 停机后，最新到期 occurrence 允许 catch up 的最大延迟。
`historyLimit`	`200`	每条 automation 持久保留的 terminal runs；active records 始终保留。