termdock 1.4.305 → 1.4.307

package/dist/server/utils/tmuxProgramDetection.js

@@ -86,7 +86,10 @@ function isDirectProgramMatch(row, command) {
 export function selectTmuxForegroundProgram(input) {
     const helperProgramNames = input.helperProgramNames ?? DEFAULT_TMUX_HELPER_PROGRAM_NAMES;
     const rowsByPid = new Map(input.rows.map((row) => [row.pid, row]));
-    const foregroundRows = input.rows.filter((row) => row.pid !== input.panePid && row.tpgid > 0 && row.pgid === row.tpgid && !row.stat.startsWith('Z'));
+    const foregroundRows = input.rows.filter((row) => (row.pid !== input.panePid || input.includePaneProcess === true
+        && !input.shellNames.has(lowerProgramName(row.comm)?.replace(/^-/, '') ?? '')
+        && !input.shellNames.has(lowerProgramName(input.extractProgramLabel(row.args) ?? row.comm)?.replace(/^-/, '') ?? ''))
+        && row.tpgid > 0 && row.pgid === row.tpgid && !row.stat.startsWith('Z'));
     if (foregroundRows.length === 0) {
         return null;
     }
@@ -130,6 +133,7 @@ export function selectTmuxForegroundProgram(input) {
     return {
         command: selected.command,
         rawArgs: selected.row.args,
+        ...(input.includePaneProcess ? { processPid: selected.row.pid, processComm: selected.row.comm } : {}),
     };
 }
 export function normalizeTmuxMetadataProgram(program, options) {

package/docs/integrations.md

@@ -6,7 +6,9 @@
 **实际运行服务至少 1.4.302**。退出后的重复原生会话检查修复要求
 **实际运行服务至少 1.4.303**。没有 PTY 附着的已登记 tmux 的重复保护修复要求
 **实际运行服务至少 1.4.304**。管理员恢复诊断要求 **CLI / 实际服务均至少 1.4.305**；
-建议 CLI 与服务同步安装 1.4.305（既有接入命令的 CLI 最低仍为 1.4.301）。
+直接 exec 为 pane PID 的原生 argv 核验及可选 Linux 持锁身份要求 **实际服务至少 1.4.306**；
+后台执行记录与用途迁移要求 **CLI / 实际服务均至少 1.4.307**；
+建议 CLI 与服务同步安装 1.4.307（既有接入命令的 CLI 最低仍为 1.4.301，诊断 CLI 最低为 1.4.305）。
 现有 `--session`、消息投递、任务报告与自动协作入口继续兼容；旧的
 `task create --integration` 仍表示代码集成子任务，新身份使用 `--principal`。
 
@@ -139,12 +141,97 @@ td collab --principal report-bridge capabilities
 `principal.launch_profiles` 中目标 profile 的 `startup_input_condition=true`。
 这些布尔值由实际服务回读；服务能力支持不等于身份已配置条件。
 
+## 后台自动化执行记录（1.4.307）
+
+`td automation` 是已有定时投递入口：`list/create/show/run/pause/resume/delete`。
+它的 run `success` 只表示投递，记录不包含结果版本或关联咨询，最多保留 100 条；
+它不是本节的后台执行记录。外部定时器继续由接入方管理。
+
+后台工作复用可靠的 task/attempt/artifact/event 存储，显式使用
+`purpose=automation`。旧记录缺少 purpose 时按 `interactive` 处理，新建也默认 interactive。
+这是使用方式与记录契约，不是安全隔离或简单 CSS 隐藏：
+
+- automation 是本机协作组内的独立记录；不加入人工目标、父子任务、依赖验收、协调者或自动评审。
+- 继续通过原 session 投递、精确恢复，用原 attempt report、comment/respond 和持久事件关联。
+- `complete` 是执行成员的明确结果交付，无需逐期 accepted。它不等于业务机械校验通过或外部发布成功。
+  业务按 artifact_id 保存机械校验和外部 outbox；本版 `external_validation=false`。
+- 用户任务生命周期 `status=open|accepted|closed` 保持既有含义；后台是否执行交付，读下面的 `execution`，
+  不等待 `status=accepted`。不自动生成 accepted；principal 仍不能验收。已有用户验收历史保留。
+- 人工工作台列表 API 默认只列 interactive，看板与“需要你”同样排除 automation，
+  包括 complete、blocked、failed、预期测试超时和真实提问。业务负责在飞书分诊/提问，
+  可使用 task ask/answer 持久关联。异常、问题原文、投递状态和失败重试并未删除或改成成功。
+- Agent CLI 与 principal 的 task list 默认保留全部授权组记录；可用 `--purpose automation|interactive|all` 筛选。
+  task get 不受用途过滤，原始正文与历史仍可回读。用途不代替组权限。
+
+先核验实际服务 capabilities：
+`background_task_records=true`、`task_purpose_configuration=true`、`explicit_execution_state=true`。
+普通 collab 能力位在 `task_workflow` 内，principal 的在响应顶层。CLI 与实际服务均至少 1.4.307，协议仍是 1。
+CLI 对带 purpose 的操作和 configure 会先探测能力，缺失返回
+`BACKGROUND_TASK_RECORDS_UNSUPPORTED`，不会向旧服务提交变更或降级创建普通任务。
+
+新建后台执行记录（使用既有私有凭据文件注入）：
+
+```sh
+td collab --principal report-bridge task create --group <本机组ID> \
+  --purpose automation --title '本期报告' --content '完整执行要求' \
+  --assignee <原TD-session-id> --idempotency-key <本次创建键>
+td collab --principal report-bridge task list --purpose automation
+td collab --principal report-bridge task get <task-id>
+```
+
+automation 的完整与摘要响应均提供 `execution`：
+
+```json
+{
+  "status": "complete",
+  "attemptId": "原执行尝试ID",
+  "reportEventId": "原report事件ID",
+  "artifactId": "本版本结果ID",
+  "reportedAt": 1791636000000
+}
+```
+
+`execution.status` 为 `unassigned`、`awaiting_report` 或明确成员报告的
+`ack/working/blocked/complete/failed`。它只根据当前 attempt 的有序原始 report/revise 事件生成：
+尚未报告及最新 revise 之后等待新报告时，reportEventId/artifactId/reportedAt 为 null；
+只有当前明确 complete 的 artifactId 非 null。comment/respond 不改变 execution、结果或 attempt；
+revise 使旧一轮 execution 失效，再次 complete 产生新 artifact。历史 attempt 的报告不会覆盖当前执行事实。
+投递成功、终端快照、事件 ACK、其他会话忙闲均不能推导 execution 状态。
+`reportedAt` 是原 report 事件时间，execution 为回读投影，不写回或伪造原报告。
+
+已有普通任务原地迁移，不重跑：管理员先在原策略的 permissions 中**追加** `task.configure`，
+保留 id/groupId/其他权限/profile/启动条件，用 `td integration update --file <原策略.json>` 更新。
+该操作保留凭据；仍需核对 principal.permissions，不能把服务支持的 permissions 当实际授权。
+然后读取原记录的最新 revision：
+
+```sh
+td collab --principal report-bridge task get <原task-id>
+td collab --principal report-bridge task configure <原task-id> \
+  --purpose automation --revision <刚回读的revision> \
+  --idempotency-key <此记录的用途迁移键>
+```
+
+configure 在同一持久事务中更新 purpose、revision 并记录 `task.configured`（payload.event.purpose）。
+创建事件也保留创建时 purpose。新配置事件沿用既有持久推送/重连/ACK 契约。
+用途迁移保留原 task/group/attempt/session 关联、投递、artifact、原始事件和已验收/关闭历史，
+不建立新 attempt/session，不投递正文、不恢复终端、不自动 accepted。
+旧创建请求的同一幂等键仍绑定原请求体；不要把它改为带新 purpose 的 create，否则会正确报幂等冲突。
+迁移后保持原业务键与 TD ID，只有未来新记录才使用 purpose=automation 的新创建请求。
+测试记录也可配置为 automation，测试与正式业务组的分离仍由接入方完成，不自动替别人迁移任务。
+
+configure 需要本机管理员（既有受权任务 API）或授权组内持有 `task.configure` 的 principal；
+终端成员不能配置。拒绝无 grant、跨组、过期 revision；同一幂等请求返回原事件且不重复追加。
+`TASK_CHANGED` 时重新读取并核对，不盲覆写。用途非法返回 `INVALID_TASK_PURPOSE`；
+非独立记录返回 `AUTOMATION_STANDALONE_REQUIRED`，跨服务组返回 `BACKGROUND_TASK_LOCAL_ONLY`。
+已关闭的记录只迁移用途仍保持关闭，不由 configure 隐式恢复咨询或执行。
+
 ## 任务与权限
 
 | 操作 | 外部身份 | 会话成员 / 用户规则 |
 | --- | --- | --- |
 | list/get | `task.read`，只读授权组 | 保留现有组权限 |
-| create | `task.create`，普通独立任务 | 指定负责人另需 `task.assign`，必须在组内 |
+| create | `task.create`，独立任务或后台执行记录 | 指定负责人另需 `task.assign`，必须在组内 |
+| configure | `task.configure` | 显式配置用途，必须带 revision 与幂等键；会话成员不能配置 |
 | assign | `task.assign` | 必须带当前 revision；新建 attempt，不隐式恢复会话 |
 | comment | `task.comment` | open/accepted 可咨询，保留原结果、验收和 attempt |
 | revise | `task.revise` | 带 revision，重开并使旧结果失去验收资格，沿用当前 attempt |
@@ -207,6 +294,7 @@ task 事件 `event_id` 与任务内事件 ID 一致，`respond.reply_to_event_id
 | kind | payload |
 | --- | --- |
 | `task.created/assigned/scheduled/coordinator` | `{event}`：原事件、actor、content、attemptId、sequence、createdAt、origin 等 |
+| `task.configured` | `{event}`：`purpose=interactive|automation`，原配置操作者、时间及 source/origin；没有终端投递 |
 | `task.report` | `{event}`：另含明确 reportStatus（ack/working/blocked/complete/failed）、evidence；新 complete 含 artifactId |
 | `task.comment/respond/revise` | `{event}`：咨询含 target/deliveryId，答复含 replyToEventId |
 | `task.question/answer` | `{event}`；decision 的完整状态从 task get 回读 |
@@ -311,6 +399,48 @@ operation/pane，不启动第二个 Agent；进程携带不同 UUID 时继续拒
 仅在确认 tmux 已消失或当前进程排除冲突时继续；未知进程、同 Agent 缺少精确 UUID、
 观察失败均返回 `NATIVE_SESSION_OWNER_UNCONFIRMED`，不以旧 UUID 证明没有冲突。
 
+### 可选的当前进程原生身份（1.4.306）
+
+某些 Agent 首次启动的 argv 没有 UUID。支持以下所有权协议的 Agent 插件可以在
+原 `manifest.json` 中增加一个可选字段；现有别名、恢复命令和其他配置保持原样：
+
+```json
+"nativeIdentity": {
+  "kind": "linux-flock-owner",
+  "directory": "~/.my-agent/native-writer-locks"
+}
+```
+
+这是通用协议声明，TD 没有内置任何私有 Agent 名称或路径。锁目录须是当前用户
+home 内的绝对目录或 `~/` 路径；运行时目录、文件须由当前 UID 拥有，且不能被
+组或其他用户写入。目录/文件本身不能为软链接；目录的真实路径仍须在 home 内。
+锁是 `<native-id>.lock` 普通文件，配套 `<native-id>.owner.json` 至少含
+`{"pid":123,"process_start_id":"linux:456"}`；其他字段不用来证明身份。
+
+插件配置在服务启动时载入。升级、保留原配置并加入声明后，重启实际服务一次；
+Linux 服务 `capabilities.native_identity_linux_flock_owner=true` 表示支持此证据类型，
+不能替代核验插件声明与真实持锁情况。其他平台返回 false，继续使用原 argv 证据。
+不需要改 integration policy、凭据、原启动 argv/model/cwd/包装器或业务任务。
+
+TD 从当前终端的真实前台进程取得 PID（包括直接 exec 后就是 pane PID 的进程），
+再只读核验：该 PID 的 UID、前台进程组、当前 `/proc/<pid>/stat` 启动时间、owner
+文件中的 PID/start_id、它实际打开的 FD 与目录内锁文件的 dev/inode、以及
+`/proc/locks` 的同 PID 独占整文件 `FLOCK ADVISORY WRITE`。读取前后复核进程实例及 argv、
+相关 FD 集合、inode、owner 和内核持锁，任一无法成立都不推导身份。
+owner JSON 读取限 4096 字节、argv 比对限 16384 字节、进程 FD 数量限 4096；不会读会话正文/环境或尝试取得写锁。
+
+仅一个完整匹配的原生 ID 才可用于当前身份：明确持有目标 ID 拒绝重复启动；明确
+持有其他 ID 可以排除该进程。多个持锁 ID、argv 与锁身份矛盾、检查间进程变化
+均继续拒绝。owner 文件存在、PID 存活、旧登记或 hook 历史均不能单独确认身份。
+尚未建立可证明身份、协议不符或读权限不足时仍保留未确认保护；没有声明此字段的
+旧插件继续使用原有 argv 路径。此证据仅支持本机 Linux tmux 进程，不宣称能覆盖
+未登记外部进程、远端 Agent 或其他操作系统。
+
+维护机已用真实隔离 tmux/内核 flock 验证首次启动的 UUID 捕获、直接 exec 的 pane
+PID、同 ID 拒绝/不同 ID 排除、遗留 owner、错误 start_id/PID、inode 替换、没有真实
+持锁、多个 ID 和 argv 冲突。**私有 TraeX 的 1.4.306 身份接入仍需使用方实机复验**。
+原 `startupInput` 仍独立控制首次写入；核验 native ID 不表示输入初始化完成。
+
 ### 管理员恢复诊断（1.4.305）
 
 `capabilities.session_restore_diagnostics=true` 表示服务支持持久恢复诊断。
@@ -336,13 +466,18 @@ no-op restore 不创建新检查。报告跟随会话保存并可在服务重启
 每个阻塞候选含 `session_id / backend_session_id / backend_attached`、
 `tmux_session_name / tmux_session_id / pane_id / pane_pid`、`program / process_source`、
 `arguments_observed / agent_slug / last_known_native_id / observed_native_id`、
-`pgid / tpgid / reason / observed_at`；无法观测的值为 null。backend 不存在或仅有旧
+`pgid / tpgid / reason / observed_at`；306 另含真实前台 `process_pid` 及
+`native_identity_source`（argv / linux-flock-owner / null）。无法观测的值为 null。backend 不存在或仅有旧
 登记仍可通过 tmux 核验；`pane_pid` 是承载 pane 的 PID，不冒充 Agent 前台 PID。
 报告最多保存 128 个阻塞候选；`total_blockers` 保留总数，确定的同 UUID 所有者优先展示。
 
 | reason | 实际证据缺口或冲突 |
 | --- | --- |
-| NATIVE_SESSION_MATCH | 当前前台进程明确携带目标 UUID |
+| NATIVE_SESSION_MATCH | 当前前台进程的 argv 或完整持锁证据明确证明目标 UUID |
+| NATIVE_SESSION_IDENTITY_CONFLICT | argv 与完整持锁证据指向不同 UUID |
+| NATIVE_SESSION_IDENTITY_AMBIGUOUS | 当前进程持有多个可证明的原生 UUID |
+| NATIVE_SESSION_PROCESS_CHANGED | 持锁检查间进程实例或所有权证据变化 |
+| NATIVE_SESSION_OWNERSHIP_UNCONFIRMED | 当前打开了原生锁文件，但持锁/owner/inode 证据不能完整成立 |
 | NATIVE_SESSION_ID_MISSING | 当前同 Agent 的进程已观测，但没有可回读的精确 UUID |
 | PROCESS_ARGUMENTS_UNAVAILABLE | 无法取得可靠的当前进程 argv |
 | FOREGROUND_PROCESS_UNCONFIRMED | 无法可靠核验前台进程 |
@@ -383,9 +518,11 @@ no-op restore 不创建新检查。报告跟随会话保存并可在服务重启
 遗漏；维护机已用“旧 UUID C、实际运行 UUID A、无 PTY 附着”的真实隔离 tmux 复现，
 并验证 1.4.304 编译后检查在该状态下拒绝再次启动。
 使用方已报告 1.4.304 在未挂接网页/PTY、旧登记 UUID C 而实际运行 A 的场景下，
-正确拒绝同 UUID 恢复且没有第二个进程。所有者退出后仍有未确认候选，不能仅凭
-错误码判断是哪一个 pane；1.4.305 提供管理员持久诊断，并保持原拒绝条件。
-**1.4.305 的真实 TraeX 阻塞候选诊断与稳定输入条件仍须使用方实机复验**。
+正确拒绝同 UUID 恢复且没有第二个进程。1.4.305 实机诊断已定位四个同 Agent
+无 argv UUID 的候选，另一个候选主进程直接 exec 为 pane PID。使用方提供了当前
+PID/start_id、实际 FD/inode 与内核 flock 一致的私有原生所有权证据；1.4.306 提供
+上述可选通用插件声明，未修改私有 Agent 或放宽未确认保护。
+**1.4.306 的私有 TraeX 持锁身份接入与稳定输入条件仍须使用方实机复验**。
 回读 capabilities 后，应核对原 TD ID、真实 TraeX UUID 与原 argv/cwd/包装器快照，
 并验证 Agent 真正加载原对话。
 先完成测试环境的创建→追问→关联答复，再验重复键、追加咨询、断线重投和精确恢复。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "termdock",
-  "version": "1.4.305",
+  "version": "1.4.307",
   "description": "A complete web-based terminal application with modern UI",
   "type": "module",
   "main": ".desktop-dist/main.js",

package/runtime-manifest.json

@@ -1,13 +1,13 @@
 {
   "schemaVersion": 1,
   "packageName": "termdock",
-  "version": "1.4.305",
+  "version": "1.4.307",
   "runtimeProtocolVersion": 1,
   "minimumDesktopVersion": "1.4.46",
   "nodeMajor": 22,
   "dependencyHash": "sha256-E9GDa4nrCXADRXdyPKufusZt6IcCr4m2mGdx5h34KMQ=",
-  "serverBundleHash": "sha256-XkM6+bMn6xdVpuXe8oaPunofP3J+MgVfh7lwiOhSY4I=",
-  "clientBundleHash": "sha256-HOoNMOYhnph9XwUhSYE5W2CdI9Vb4g0c64ubW49LnXE=",
+  "serverBundleHash": "sha256-SmxpQ63ErP59HLeERjJ0euDs74G6un227eMPe9/sAEI=",
+  "clientBundleHash": "sha256-dfDbp6qzSoUEczQc0mFdVx2jNb+7Oabm+ZvcTpBThnw=",
   "entrypoint": "dist/server/cli.js",
   "clientEntrypoint": "dist/client/index.html"
 }

package/dist/client/assets/CollaborationTaskContent-B_mzpNuw.js

@@ -1,2 +0,0 @@
-import{bv as r}from"./app-D6vN8PW-.js";import{b as m}from"./dnd-BCFAPC0L.js";import{b as n}from"./RightSidebar-CcMSU1v8.js";import"./react-XDCjal2T.js";import"./terminal-C7X98Amf.js";import"./App-BziVLy1b.js";import"./gestureArbiter-CXYHfU__.js";import"./triangle-alert-DzV0gQXz.js";import"./referenceLongPress-Df8W2cyP.js";import"./DiffReview-DjG9vCpH.js";import"./sparkles-DOuEtn62.js";import"./DiffViewer-6n3tgsdc.js";import"./ChangeWalkthroughPanel-00oa0z6w.js";function v({content:o}){const e=m.useMemo(()=>n(o.split(`
-`),null,null),[o]);return r.jsx("div",{className:"min-w-0 space-y-3 break-words text-sm leading-6 text-foreground [&_h1]:text-lg [&_h2]:text-base [&_h3]:text-sm [&_pre]:max-w-full [&_table]:text-xs",children:e.map((t,i)=>r.jsx("div",{className:"min-w-0",children:typeof t.content=="function"?t.content(null):t.content},i))})}export{v as default};

package/dist/client/assets/channel-CBc8-n7y.js

@@ -1 +0,0 @@
-import{c as a,C as n}from"./mermaid.core-DM6Rlal9.js";const t=(r,o)=>a.lang.round(n.parse(r)[o]);export{t as c};

package/dist/client/assets/classDiagram-ZZMXUADV-CNFc2dOc.js

@@ -1 +0,0 @@
-import{s as a,a as s,c as t,C as e}from"./chunk-TICWLB2K-BKaW9Z9i.js";import{d as i}from"./mermaid.core-DM6Rlal9.js";import"./chunk-5VM5RSS4-Bi4Hc8yL.js";import"./chunk-XXDRQBXY-DcHZ_FHb.js";import"./chunk-POPQ4Y6H-BRzm6Uzi.js";import"./chunk-F27PBJKO-DvVWvQEk.js";import"./purify.es-4eNOHKSq.js";import"./app-D6vN8PW-.js";import"./react-XDCjal2T.js";import"./dnd-BCFAPC0L.js";import"./terminal-C7X98Amf.js";var g={parser:t,get db(){return new e},renderer:s,styles:a,init:i(r=>{r.class||(r.class={}),r.class.arrowMarkerAbsolute=r.arrowMarkerAbsolute},"init")};export{g as diagram};

package/dist/client/assets/classDiagram-v2-VYDZK3BY-CNFc2dOc.js

@@ -1 +0,0 @@
-import{s as a,a as s,c as t,C as e}from"./chunk-TICWLB2K-BKaW9Z9i.js";import{d as i}from"./mermaid.core-DM6Rlal9.js";import"./chunk-5VM5RSS4-Bi4Hc8yL.js";import"./chunk-XXDRQBXY-DcHZ_FHb.js";import"./chunk-POPQ4Y6H-BRzm6Uzi.js";import"./chunk-F27PBJKO-DvVWvQEk.js";import"./purify.es-4eNOHKSq.js";import"./app-D6vN8PW-.js";import"./react-XDCjal2T.js";import"./dnd-BCFAPC0L.js";import"./terminal-C7X98Amf.js";var g={parser:t,get db(){return new e},renderer:s,styles:a,init:i(r=>{r.class||(r.class={}),r.class.arrowMarkerAbsolute=r.arrowMarkerAbsolute},"init")};export{g as diagram};

package/dist/client/assets/stateDiagram-v2-MP3YSRHH-CNYUpLxt.js

@@ -1 +0,0 @@
-import{b as r,a as e,s as a,S as i}from"./chunk-IMKFNOWR-BnwQLR5S.js";import{d as s}from"./mermaid.core-DM6Rlal9.js";import"./chunk-XXDRQBXY-DcHZ_FHb.js";import"./chunk-POPQ4Y6H-BRzm6Uzi.js";import"./chunk-F27PBJKO-DvVWvQEk.js";import"./purify.es-4eNOHKSq.js";import"./app-D6vN8PW-.js";import"./react-XDCjal2T.js";import"./dnd-BCFAPC0L.js";import"./terminal-C7X98Amf.js";var g={parser:a,get db(){return new i(2)},renderer:e,styles:r,init:s(t=>{t.state||(t.state={}),t.state.arrowMarkerAbsolute=t.arrowMarkerAbsolute},"init")};export{g as diagram};

package/dist/client/assets/swimlanesDiagram-VR7AAH4N-EB7zBRFR.js

@@ -1,8 +0,0 @@
-import{c as r,s as e}from"./flowDiagram-HODETNUW-B8ZF1bwr.js";import{d as o}from"./mermaid.core-DM6Rlal9.js";import"./chunk-5VM5RSS4-Bi4Hc8yL.js";import"./chunk-XXDRQBXY-DcHZ_FHb.js";import"./chunk-POPQ4Y6H-BRzm6Uzi.js";import"./chunk-F27PBJKO-DvVWvQEk.js";import"./purify.es-4eNOHKSq.js";import"./channel-CBc8-n7y.js";import"./app-D6vN8PW-.js";import"./react-XDCjal2T.js";import"./dnd-BCFAPC0L.js";import"./terminal-C7X98Amf.js";var a=o(t=>`${e(t)}
-  .swimlane.cluster rect {
-    stroke: ${t.clusterBorder} !important;
-  }
-  [data-look="neo"].cluster rect {
-    filter: none;
-  }
-`,"getStyles"),m=a,v=r({defaultLayout:"swimlane",styles:m});export{v as diagram};