flow-comet 1.6.2 → 1.6.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (107) hide show
  1. package/.flow-comet/skills/flow-comet/INSTALLED_VERSION +1 -1
  2. package/.flow-comet/skills/flow-comet/SKILL.md +64 -46
  3. package/.flow-comet/skills/flow-comet/reference/KNOWN-ISSUES-template.md +1 -1
  4. package/.flow-comet/skills/flow-comet/reference/commit-discipline.md +32 -0
  5. package/.flow-comet/skills/flow-comet/reference/dirty-worktree.md +1 -1
  6. package/.flow-comet/skills/flow-comet/{GUIDANCE.md → reference/entry-detail.md} +18 -28
  7. package/.flow-comet/skills/flow-comet/reference/fix-loop.md +57 -0
  8. package/.flow-comet/skills/flow-comet/reference/platform-facts.md +58 -0
  9. package/.flow-comet/skills/flow-comet/reference/replan.md +23 -0
  10. package/.flow-comet/skills/flow-comet/scripts/comet-check.mjs +5 -4
  11. package/.flow-comet/skills/flow-comet/scripts/comet-hook-guard.mjs +266 -25
  12. package/.flow-comet/skills/flow-comet/scripts/context-init.mjs +2 -2
  13. package/.flow-comet/skills/flow-comet/scripts/evolve.mjs +6 -6
  14. package/.flow-comet/skills/flow-comet/scripts/guard-self-test.mjs +67 -16325
  15. package/.flow-comet/skills/flow-comet/scripts/health.mjs +1 -1
  16. package/.flow-comet/skills/flow-comet/scripts/items/a.mjs +1030 -0
  17. package/.flow-comet/skills/flow-comet/scripts/items/b.mjs +830 -0
  18. package/.flow-comet/skills/flow-comet/scripts/items/c.mjs +781 -0
  19. package/.flow-comet/skills/flow-comet/scripts/items/d.mjs +99 -0
  20. package/.flow-comet/skills/flow-comet/scripts/items/e.mjs +185 -0
  21. package/.flow-comet/skills/flow-comet/scripts/items/f.mjs +90 -0
  22. package/.flow-comet/skills/flow-comet/scripts/items/g.mjs +59 -0
  23. package/.flow-comet/skills/flow-comet/scripts/items/h.mjs +815 -0
  24. package/.flow-comet/skills/flow-comet/scripts/items/i.mjs +77 -0
  25. package/.flow-comet/skills/flow-comet/scripts/items/j.mjs +75 -0
  26. package/.flow-comet/skills/flow-comet/scripts/items/k.mjs +1427 -0
  27. package/.flow-comet/skills/flow-comet/scripts/items/l.mjs +275 -0
  28. package/.flow-comet/skills/flow-comet/scripts/items/m.mjs +614 -0
  29. package/.flow-comet/skills/flow-comet/scripts/lib/count-derivation.mjs +97 -0
  30. package/.flow-comet/skills/flow-comet/scripts/lib/fix-loop-node.mjs +196 -0
  31. package/.flow-comet/skills/flow-comet/scripts/lib/guard-evidence-gates.mjs +553 -0
  32. package/.flow-comet/skills/flow-comet/scripts/lib/guard-gates.mjs +837 -0
  33. package/.flow-comet/skills/flow-comet/scripts/lib/guard-routing.mjs +404 -0
  34. package/.flow-comet/skills/flow-comet/scripts/lib/guard-state-io.mjs +404 -0
  35. package/.flow-comet/skills/flow-comet/scripts/lib/guard-template-fidelity.mjs +302 -0
  36. package/.flow-comet/skills/flow-comet/scripts/lib/guard-uidesign.mjs +133 -0
  37. package/.flow-comet/skills/flow-comet/scripts/lib/reentry-node.mjs +237 -0
  38. package/.flow-comet/skills/flow-comet/scripts/lib/replan-node.mjs +209 -0
  39. package/.flow-comet/skills/flow-comet/scripts/lib/state-branch.mjs +49 -0
  40. package/.flow-comet/skills/flow-comet/scripts/lib/state-bridgecheck.mjs +201 -0
  41. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-admin.mjs +141 -0
  42. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-flow.mjs +700 -0
  43. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-recovery.mjs +578 -0
  44. package/.flow-comet/skills/flow-comet/scripts/lib/state-determine.mjs +52 -0
  45. package/.flow-comet/skills/flow-comet/scripts/lib/state-evolve-hint.mjs +55 -0
  46. package/.flow-comet/skills/flow-comet/scripts/lib/state-explain.mjs +106 -0
  47. package/.flow-comet/skills/flow-comet/scripts/lib/state-intelscan.mjs +58 -0
  48. package/.flow-comet/skills/flow-comet/scripts/lib/state-io.mjs +147 -0
  49. package/.flow-comet/skills/flow-comet/scripts/lib/state-skillmarkers.mjs +189 -0
  50. package/.flow-comet/skills/flow-comet/scripts/lib/system-fixtures.mjs +1441 -0
  51. package/.flow-comet/skills/flow-comet/scripts/lib/task-graph.mjs +471 -0
  52. package/.flow-comet/skills/flow-comet/scripts/lib/test-assertions.mjs +509 -0
  53. package/.flow-comet/skills/flow-comet/scripts/lib/test-fixtures.mjs +1228 -0
  54. package/.flow-comet/skills/flow-comet/scripts/lib/test-helpers.mjs +237 -0
  55. package/.flow-comet/skills/flow-comet/scripts/lib/text-anchor-checks.mjs +2484 -0
  56. package/.flow-comet/skills/flow-comet/scripts/protocol-utils.mjs +2 -2
  57. package/.flow-comet/skills/flow-comet/scripts/route-node.mjs +73 -1077
  58. package/.flow-comet/skills/flow-comet/scripts/scenarios/a.mjs +966 -0
  59. package/.flow-comet/skills/flow-comet/scripts/scenarios/b.mjs +1233 -0
  60. package/.flow-comet/skills/flow-comet/scripts/scenarios/c.mjs +1382 -0
  61. package/.flow-comet/skills/flow-comet/scripts/scenarios/d.mjs +483 -0
  62. package/.flow-comet/skills/flow-comet/scripts/scenarios/e.mjs +1388 -0
  63. package/.flow-comet/skills/flow-comet/scripts/scenarios/f.mjs +1466 -0
  64. package/.flow-comet/skills/flow-comet/scripts/scenarios/g.mjs +1364 -0
  65. package/.flow-comet/skills/flow-comet/scripts/scenarios/h.mjs +1287 -0
  66. package/.flow-comet/skills/flow-comet/scripts/scenarios/i.mjs +1436 -0
  67. package/.flow-comet/skills/flow-comet/scripts/scenarios/j.mjs +1384 -0
  68. package/.flow-comet/skills/flow-comet/scripts/scenarios/k.mjs +1338 -0
  69. package/.flow-comet/skills/flow-comet/scripts/scenarios/l.mjs +1484 -0
  70. package/.flow-comet/skills/flow-comet/scripts/scenarios/m.mjs +971 -0
  71. package/.flow-comet/skills/flow-comet/scripts/state-schema.mjs +14 -1
  72. package/.flow-comet/skills/flow-comet/scripts/system-test.mjs +58 -6692
  73. package/.flow-comet/skills/flow-comet/scripts/time-utils.mjs +4 -4
  74. package/.flow-comet/skills/flow-comet/scripts/workflow-guard.mjs +151 -2428
  75. package/.flow-comet/skills/flow-comet/scripts/workflow-handoff.mjs +116 -9
  76. package/.flow-comet/skills/flow-comet/scripts/workflow-state.mjs +29 -2086
  77. package/.flow-comet/skills/flow-comet-archive/SKILL.md +10 -19
  78. package/.flow-comet/skills/flow-comet-change/SKILL.md +2 -3
  79. package/.flow-comet/skills/flow-comet-compose/SKILL.md +1 -1
  80. package/.flow-comet/skills/flow-comet-design/SKILL.md +6 -6
  81. package/.flow-comet/skills/flow-comet-execute/SKILL.md +58 -16
  82. package/.flow-comet/skills/flow-comet-integration/SKILL.md +8 -5
  83. package/.flow-comet/skills/flow-comet-open/SKILL.md +5 -1
  84. package/.flow-comet/skills/flow-comet-plan/GUIDANCE.md +1 -1
  85. package/.flow-comet/skills/flow-comet-plan/SKILL.md +8 -8
  86. package/.flow-comet/skills/flow-comet-review/SKILL.md +9 -12
  87. package/.flow-comet/skills/flow-comet-subagent-execute/SKILL.md +59 -16
  88. package/.flow-comet/skills/flow-comet-task/SKILL.md +3 -2
  89. package/.flow-comet/skills/flow-comet-ui-design/SKILL.md +3 -3
  90. package/.flow-comet/skills/flow-comet-verify/SKILL.md +8 -17
  91. package/README.md +53 -70
  92. package/package.json +3 -2
  93. package/scripts/dsh-bridge.mjs +59 -26
  94. package/scripts/lib/installer-cleanup.mjs +152 -0
  95. package/scripts/lib/installer-flowkit.mjs +119 -0
  96. package/scripts/lib/installer-hooks.mjs +363 -0
  97. package/scripts/lib/installer-loader.mjs +220 -0
  98. package/scripts/lib/installer-migrate.mjs +236 -0
  99. package/scripts/lib/installer-platforms.mjs +314 -0
  100. package/scripts/prepare-env.mjs +36 -1164
  101. package/.flow-comet/skills/flow-comet/reference/TEST-MATRIX.md +0 -116
  102. package/.flow-comet/skills/flow-comet/reference/composition-report.md +0 -65
  103. package/.flow-comet/skills/flow-comet/reference/dsh-platform.md +0 -184
  104. package/.flow-comet/skills/flow-comet/reference/resolved-skills.json +0 -661
  105. package/.flow-comet/skills/flow-comet/reference/skill-review.md +0 -13
  106. package/.flow-comet/skills/flow-comet/reference/subagents/script-author.md +0 -7
  107. package/.flow-comet/skills/flow-comet/reference/worktree-notes.md +0 -70
@@ -3,7 +3,7 @@ import { execFileSync } from 'child_process';
3
3
  import { promises as fs } from 'fs';
4
4
  import path from 'path';
5
5
  import { fileURLToPath } from 'url';
6
- import { validateStateFields, looksLikeObjectLiteral, writeJsonAtomic, RUNTIME_DIR, RUNTIME_STATE_FILE_NAME, resolveProtocolPathWithState } from './state-schema.mjs';
6
+ import { validateStateFields, looksLikeObjectLiteral, writeJsonAtomic, RUNTIME_DIR, RUNTIME_STATE_FILE_NAME, resolveProtocolPathWithState, handoffRequestWithdrawn } from './state-schema.mjs';
7
7
  import { EXECUTE_FAMILY_NODE_IDS, protocolNodeEnabled, resolveDelegationTarget, taskDependencyEligibility } from './route-node.mjs';
8
8
  import {
9
9
  readProtocolFile,
@@ -11,12 +11,16 @@ import {
11
11
  inspectWorkflowPathSegments,
12
12
  } from './protocol-utils.mjs';
13
13
  import { taskAttrsById, taskBlocks, taskOpeningAttrs } from './task-parsing.mjs';
14
+ // 时间形态单一权威(新增写入路径一律走本模块,禁自行拼接):撤回留痕的时刻生成走 nowTimestamp,
15
+ // 人可见回显走 formatLocalTimestamp(本地时间 + 显式偏移),解析走 parseTimestamp。
16
+ import { nowTimestamp, formatLocalTimestamp, parseTimestamp } from './time-utils.mjs';
14
17
 
15
18
  // workflow-handoff.mjs: Record subagent handoff evidence
16
19
  // evidence 统一记录在 subagent-execute 名下作为委托证据库——execute(串行委托)与 subagent-execute(并行委托)共用。不改成节点参数,保持最小改动。
17
20
  // Usage:
18
21
  // node workflow-handoff.mjs request <task-id> <description> [--write-files <files...>] -- record handoff request (W2-D: optional writeFiles allow-list)
19
22
  // node workflow-handoff.mjs result <task-id> <result-or-JSON> -- record handoff result (W1-D: JSON Return Contract; W2-D: commitHash subset check; : completedChecks 规范化; redEvidence 时间顺序校验)
23
+ // node workflow-handoff.mjs withdraw <task-id> --by <source> [--reason <text>] -- 撤回被遗弃的 request(前置:目标无 handoffResult——已收工者拒绝撤回;留痕:withdrawnAt + withdrawnBy;已撤回 = 终态)
20
24
  // node workflow-handoff.mjs status -- show all handoff evidence
21
25
 
22
26
  // 归属门禁读取协议用:与其它脚本同源(packageRoot 默认协议;env 可覆盖),不消费 request 参数。
@@ -86,7 +90,7 @@ async function resolveJsonFileWithinRunRoot(jsonFile) {
86
90
  // 精确条目要求完全相等(不用前缀匹配——src/foo 不得匹配 src/foobar);
87
91
  // 段内含 * 的部分通配(如 src/*.test.js、src/*.mjs)转锚定正则匹配
88
92
  // 路径分隔符归一(单一来源):Windows 反斜杠 → POSIX `/`;matchWriteFilePattern 与
89
- // F-6 字面路径资格判定共用(同口径两处实现必分叉——L-067)。
93
+ // F-6 字面路径资格判定共用——同口径两处实现必然分叉,故共用同一实现。
90
94
  function toPosixPath(value) {
91
95
  return String(value).replace(/\\/g, '/');
92
96
  }
@@ -149,7 +153,7 @@ function gitIndexTracksPath(rel) {
149
153
  // 不用 --no-index、不 import prepare-env(不分发)。
150
154
  // 路径扫描增强(m-13):runRoot 先 realpath 归一;对每个字面路径的最近已存在祖先逐段 lstat,
151
155
  // 任一段为 symlink/junction(或物理逃出 runRoot)→ fail-closed(目标不存在不算失败)。
152
- // 逐段扫描复用 protocol-utils 的单一权威,本处不得另写第二份 symlink/包含判据(L-067)。
156
+ // 逐段扫描复用 protocol-utils 的单一权威,本处不得另写第二份 symlink/包含判据。
153
157
  // 失败类别(稳定机器码,作为 result 撤销审计的 revokeReason):invalid-path(glob / 绝对路径 /
154
158
  // `..` 逃逸等字面形态不成立)、stale-eligibility(忽略规则变化,路径不再被证明 gitignored)、
155
159
  // became-tracked(路径已在 index 中)、symlink-junction-escape(祖先段 symlink/junction 或
@@ -234,7 +238,12 @@ async function revalidateResultZeroCommit(state, taskId, handoffReq) {
234
238
  // 避免 WARN 声称已撤销而 state 仍是旧值。
235
239
  await writeState(state);
236
240
  const reasonText = ZERO_COMMIT_REVOKE_REASON_TEXT[verdict.reason] || verdict.reason;
237
- const detail = '任务 ' + taskId + ' 零提交资格 result 重验失败(' + reasonText + ')——request evidence noCommit=false, revokedAt=' + handoffReq.revokedAt + ', revokeReason=' + verdict.reason;
241
+ // 人可见时间戳一律本地时间 + 显式偏移(时间纪律):revokedAt 是既有的机器字段(历史 Z 形态,
242
+ // 同族迁移窗口内保持原样),但把它原样拼进这条给人看的消息即违反人可见口径——此处按标准形态
243
+ // 回显;历史值不可解析时回显原值(可见降级,不静默改写、不谎称已格式化)。
244
+ const revokedAtMs = parseTimestamp(handoffReq.revokedAt);
245
+ const revokedAtDisplay = Number.isNaN(revokedAtMs) ? String(handoffReq.revokedAt) : formatLocalTimestamp(revokedAtMs);
246
+ const detail = '任务 ' + taskId + ' 零提交资格 result 重验失败(' + reasonText + ')——request evidence noCommit=false, revokedAt=' + revokedAtDisplay + ', revokeReason=' + verdict.reason;
238
247
  if (state.newChange === true) {
239
248
  // 新 change 只落 request 资格撤销;此刻尚未默认 handoffResult,确保「不落 result」不是文案承诺
240
249
  console.error('HANDOFF ERROR: ' + detail + ';新 change 不落 result,出口校验不再豁免缺 commitHash。恢复: 修正 write_files / .gitignore 与路径形态后重新 request,或回传含合法 commitHash 的 Return Contract');
@@ -439,7 +448,7 @@ async function main() {
439
448
  description = args.join(' ') || 'pending';
440
449
  }
441
450
  // 若未显式传 --write-files,从 TASK.md 自动解析(orchestrator 无需手动提取文件列表)。
442
- // 解析三态(bot 评审收紧):① 匹配到任务块且 <write_files> 存在 → 按内容分类;
451
+ // 解析三态:① 匹配到任务块且 <write_files> 存在 → 按内容分类;
443
452
  // ② 任务块缺失或块内无 <write_files> 元素 → 任务不可解析,新 change BLOCK,旧 change
444
453
  // WARN 且不设 noCommit(防未解析任务静默变零提交逃逸口);③ TASK.md 读不到同 ②。
445
454
  // TASK.md 只读一次:任务开标签属性解析(归属门禁)复用 task-parsing.mjs;
@@ -496,10 +505,24 @@ async function main() {
496
505
  // 记 noCommit:true;不具资格 → 不记 noCommit、不阻断原流程(保持既有完整提交子集校验)。
497
506
  const literalIgnoredEligible = taskResolved && writeFiles.length > 0
498
507
  && (await classifyWriteFilesProvablyIgnored(writeFiles)).eligible;
508
+ // 撤回后再委托:新 request 覆盖当前态,但**不静默删除**撤回历史——已撤回记录的留痕转入
509
+ // previousWithdrawals 数组(加法式保留,可审计「撤回 → 重新委托」的顺序)。
510
+ const priorRecord = state.evidence['subagent-execute'].handoffRequests[taskId];
511
+ const priorWithdrawals = priorRecord && Array.isArray(priorRecord.previousWithdrawals)
512
+ ? priorRecord.previousWithdrawals
513
+ : [];
514
+ const carriedWithdrawals = handoffRequestWithdrawn(priorRecord)
515
+ ? [...priorWithdrawals, {
516
+ withdrawnAt: priorRecord.withdrawnAt,
517
+ withdrawnBy: priorRecord.withdrawnBy,
518
+ ...(priorRecord.withdrawReason ? { withdrawReason: priorRecord.withdrawReason } : {}),
519
+ }]
520
+ : priorWithdrawals;
499
521
  state.evidence['subagent-execute'].handoffRequests[taskId] = {
500
522
  description, requestedAt: new Date().toISOString(),
501
523
  ...(writeFiles.length ? { writeFiles } : {}),
502
- ...(zeroEligible || literalIgnoredEligible ? { noCommit: true } : {})
524
+ ...(zeroEligible || literalIgnoredEligible ? { noCommit: true } : {}),
525
+ ...(carriedWithdrawals.length ? { previousWithdrawals: carriedWithdrawals } : {})
503
526
  };
504
527
  await writeState(state);
505
528
  if (literalIgnoredEligible) {
@@ -536,7 +559,7 @@ async function main() {
536
559
  // "非 Return Contract"掩盖真因)
537
560
  // 消息按参数来源分级(设计语义 / AC-3):--json-file 传入且文件内容损坏 →
538
561
  // "文件内容不是合法 JSON" + 长度元数据;内联传参损坏 → 保留 --json-file 建议。
539
- // 安全(bot 审查):错误消息与 workflow-state record 统一——只含固定前缀 +
562
+ // 错误消息与 workflow-state record 统一(安全口径)——只含固定前缀 +
540
563
  // 长度元数据,绝不打印 raw 内容(含截断)。
541
564
  if (looksLikeObjectLiteral(raw)) {
542
565
  if (jsonFile !== null) {
@@ -551,6 +574,16 @@ async function main() {
551
574
  state.evidence['subagent-execute'] = state.evidence['subagent-execute'] || {};
552
575
  const handoffReq = state.evidence['subagent-execute'].handoffRequests?.[taskId];
553
576
  const hasRequest = !!handoffReq && typeof handoffReq === 'object';
577
+ // 已撤回 = 终态(撤回通道的闭合半边):撤回后的 request 不再接受 result——否则被撤回的委托
578
+ // 可被事后「复活」,撤回语义与守卫的放行判据(同一判据)分叉。要重新委托该任务须重新 request
579
+ // (新 request 记录会覆盖该 taskId 的当前态,撤回留痕以「撤回后重新委托」的顺序可审计)。
580
+ if (handoffRequestWithdrawn(handoffReq)) {
581
+ console.error('BLOCKED: 任务 ' + taskId + ' 的委托已撤回(终态)——不再接受 result'
582
+ + '(withdrawnAt=' + handoffReq.withdrawnAt + ', withdrawnBy=' + handoffReq.withdrawnBy + ')'
583
+ + ';恢复: 若该任务仍需执行,重新发起 workflow-handoff.mjs request ' + taskId
584
+ + ' <description> 后再回传结果');
585
+ process.exit(1);
586
+ }
554
587
  // m-13:result 重验在默认 handoffResult 之前——新 change 失败路径只落 request.noCommit=false,
555
588
  // 不落下空 handoffResult 充当 result 载体;重验通过/旧 change 之后才初始化结果容器。
556
589
  if (await revalidateResultZeroCommit(state, taskId, handoffReq) === 'block') process.exit(1);
@@ -567,7 +600,7 @@ async function main() {
567
600
  const isZeroCommit = hasRequest && (reqWriteFiles.length === 0 || reqNoCommit);
568
601
  if (isZeroCommit) {
569
602
  console.error('HANDOFF 零提交: ' + taskId + ' — 无 tracked 写文件(write_files 为空或全部可证明 gitignored),已跳过提交文件子集校验');
570
- // 零提交边界收紧(bot 评审实证逃逸口):声明零提交的结果若携带含 tracked 文件的提交,
603
+ // 零提交边界收紧:声明零提交的结果若携带含 tracked 文件的提交,
571
604
  // 等于从「空 write_files」旁路逃逸——新 change BLOCK / 旧 change WARN。探测异常降级
572
605
  // WARN 不阻断(对齐 M4 提交对象确认提示先例)。
573
606
  const zeroHash = (typeof parsed === 'object' && parsed !== null && parsed.commitHash && /^[0-9a-f]{7,40}$/i.test(String(parsed.commitHash)))
@@ -680,6 +713,80 @@ async function main() {
680
713
  return;
681
714
  }
682
715
 
716
+ if (action === 'withdraw') {
717
+ // 撤回通道(受支持的出口解卡路径):零提交复验失败 / 写边界被拒之后,request 可能留在
718
+ // 「有 request 无 result」态而命令面无从撤回——守卫的出口校验据此永久卡住。本动作在原记录上
719
+ // **加法式**落留痕(withdrawnAt 时间戳 + withdrawnBy 来源,可选 withdrawReason),**不删除**
720
+ // 任何历史字段(description / requestedAt / writeFiles / noCommit 原样保留);守卫按同一判据
721
+ // (state-schema.handoffRequestWithdrawn)把已撤回的 request 排除在在飞委托之外。
722
+ // 已撤回 = **终态**:重复撤回被拒(不改写既有留痕),已撤回的 request 也不再接受 result。
723
+ // 适用面自洽(前置拒绝):可撤回的只有**在飞且被遗弃**的 request——已在册 handoffResult 的
724
+ // 委托(已收工)不在其列:对已收工的委托落撤回落痕,只会在同一 taskId 上造出「result 与
725
+ // withdrawnAt/withdrawnBy 并存」的组合态,而没有任何判据消费它(守卫的在飞判据只读 request
726
+ // 侧,越俎代庖检测只读 result 侧)。判据与守卫的在飞判据**互补**(同一把尺子,不另立一份):
727
+ // 无对应 result = 未收工 = 可撤回;显式 null 占位与「键缺失」同读为未收工(守卫在飞判据按
728
+ // undefined / null,越俎代庖检测按 falsy),故不阻断撤回——不给「出口拦 + 撤回拒」留下
729
+ // 无出口的死角。本拒绝**不删改**任何既有记录(request / result 一律原样),恢复指引见下方报文。
730
+ const taskId = process.argv[3];
731
+ const withdrawArgs = process.argv.slice(4);
732
+ let withdrawnBy = null;
733
+ let withdrawReason = null;
734
+ for (let i = 0; i < withdrawArgs.length; i++) {
735
+ const arg = withdrawArgs[i];
736
+ if (arg === '--by') { withdrawnBy = withdrawArgs[i + 1]; i += 1; continue; }
737
+ if (typeof arg === 'string' && arg.startsWith('--by=')) { withdrawnBy = arg.slice('--by='.length); continue; }
738
+ if (arg === '--reason') { withdrawReason = withdrawArgs[i + 1]; i += 1; continue; }
739
+ if (typeof arg === 'string' && arg.startsWith('--reason=')) { withdrawReason = arg.slice('--reason='.length); continue; }
740
+ }
741
+ if (!taskId) {
742
+ console.error('Usage: workflow-handoff.mjs withdraw <task-id> --by <source> [--reason <text>]');
743
+ process.exit(1);
744
+ }
745
+ if (typeof withdrawnBy !== 'string' || withdrawnBy.trim() === '') {
746
+ console.error('Usage: workflow-handoff.mjs withdraw <task-id> --by <source> [--reason <text>]——撤回须留痕来源(--by 不可缺省)');
747
+ process.exit(1);
748
+ }
749
+ const handoff = state.evidence?.['subagent-execute'];
750
+ const target = handoff && typeof handoff === 'object' && handoff.handoffRequests && typeof handoff.handoffRequests === 'object'
751
+ ? handoff.handoffRequests[taskId]
752
+ : null;
753
+ if (!target || typeof target !== 'object') {
754
+ console.error('HANDOFF ERROR: 任务 ' + taskId + ' 无对应 request 记录——无可撤回的委托(撤回只作用于已记录的 request,不新建记录)');
755
+ process.exit(1);
756
+ }
757
+ if (handoffRequestWithdrawn(target)) {
758
+ console.error('HANDOFF ERROR: 任务 ' + taskId + ' 的委托已撤回(终态)——不得重复撤回、不得改写既有撤回留痕'
759
+ + '(withdrawnAt=' + target.withdrawnAt + ', withdrawnBy=' + target.withdrawnBy + ')');
760
+ process.exit(1);
761
+ }
762
+ // 前置拒绝(适用面自洽):目标已收工(handoffResult 在场且非空占位)⇒ 拒绝撤回,报文写清
763
+ // 「为什么拒」与恢复指引。**不删改**任何既有记录:本路径在 writeState 之前退出,state 字节零改写。
764
+ const deliveredResult = handoff && typeof handoff === 'object' && handoff.handoffResult
765
+ && typeof handoff.handoffResult === 'object' && !Array.isArray(handoff.handoffResult)
766
+ ? handoff.handoffResult[taskId]
767
+ : undefined;
768
+ if (deliveredResult !== undefined && deliveredResult !== null) {
769
+ console.error('HANDOFF ERROR: 任务 ' + taskId + ' 的委托已收工(handoffResult 在场)——撤回只适用于被遗弃的'
770
+ + ' request(零提交复验失败 / 写边界被拒之后遗弃的在飞 request),已收工的委托无须撤回:其 result 已在册;'
771
+ + '恢复: 如需更正该任务的结果,走既有通道重新发起 workflow-handoff.mjs request ' + taskId
772
+ + ' <description> 后回传新的 result(新记录覆盖该任务的当前态,历史记录不删除)');
773
+ process.exit(1);
774
+ }
775
+ // 新写入路径统一走时间单一权威(本地时间 + 显式偏移):不在此自行拼接时刻字面。
776
+ target.withdrawnAt = nowTimestamp();
777
+ target.withdrawnBy = withdrawnBy.trim();
778
+ if (typeof withdrawReason === 'string' && withdrawReason.trim() !== '') {
779
+ target.withdrawReason = withdrawReason.trim();
780
+ }
781
+ await writeState(state);
782
+ console.error('HANDOFF 撤回留痕: ' + taskId + ' — withdrawnAt=' + target.withdrawnAt
783
+ + ', withdrawnBy=' + target.withdrawnBy
784
+ + (target.withdrawReason ? ', withdrawReason=' + target.withdrawReason : '')
785
+ + '(原 request 字段原样保留;已撤回 = 终态,守卫不再将其计为在飞委托)');
786
+ console.log('HANDOFF WITHDRAW: ' + taskId);
787
+ return;
788
+ }
789
+
683
790
  if (action === 'status') {
684
791
  const handoff = state.evidence?.['subagent-execute'] || {};
685
792
  console.log(JSON.stringify({
@@ -690,7 +797,7 @@ async function main() {
690
797
  return;
691
798
  }
692
799
 
693
- console.error('Unknown action: ' + action + '. Use: request, result, status');
800
+ console.error('Unknown action: ' + action + '. Use: request, result, withdraw, status');
694
801
  process.exit(1);
695
802
  }
696
803