@coda-console/review 2.17.1 → 3.0.0

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.
@@ -7,7 +7,7 @@
7
7
  合并:请你批准,再在这个提交上调用项目声明为合并前检查的流程(coda:kind="premerge"),都通过才合并;没通过或 GitHub 没合并就交给开 PR 的会话,
8
8
  它推了新提交、评审通过后按你的批准合并,不再问。
9
9
  删除分支:你勾选后,等 GitHub 确认合并,再删除仍指向该提交的远程源分支;本地分支与工作树保留。
10
- 部署与发布:合并后按你勾选的,在合并提交上调用项目里声明为这一类的流程(coda:kind)。
10
+ 合并后的流程:合并后在合并提交上运行你在批准卡上勾的流程(项目里加入挂点 merged 的)。
11
11
  PR 在 GitHub 上合并或关闭,运行随之结束。也可以手动发起(传 GitHub 返回的 PR 地址),只评审一次。BPMN 2.0,由 Coda 执行(docs/workflows.md)。 -->
12
12
  <definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:coda="https://coda.pub/schema/bpmn/1.0"
13
13
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" id="pull-request-definitions" targetNamespace="https://coda.pub/plugins/review">
@@ -293,10 +293,15 @@ GitHub 上各项检查用 `gh pr checks {{github.event.pull_request.html_url}}`
293
293
  <sequenceFlow id="as-approved" sourceRef="standing" targetRef="premerge">
294
294
  <conditionExpression xsi:type="tFormalExpression">=number(approval.at) > number(review.changesAt)</conditionExpression>
295
295
  </sequenceFlow>
296
- <sequenceFlow id="ask" sourceRef="standing" targetRef="kinds" />
297
- <!-- 批准卡只给项目有的部署、发布:项目在这个提交上没有这一类流程,就没有那个勾选项;有合并前检查的才在卡上说先跑它。 -->
298
- <serviceTask id="kinds" name="看项目有哪些部署、发布" coda:action="workflow-kinds" />
299
- <sequenceFlow id="kinds-known" sourceRef="kinds" targetRef="approve" />
296
+ <sequenceFlow id="ask" sourceRef="standing" targetRef="joiners" />
297
+ <!-- 批准卡只放做决定用得到的数据和控件;合并后的勾选项是项目在这个提交上加入挂点 merged 的流程(hook-joiners),默认勾不勾由它们自己声明。 -->
298
+ <serviceTask id="joiners" name="合并后的流程" coda:action="hook-joiners">
299
+ <extensionElements>
300
+ <coda:param name="hook" value="merged" />
301
+ <coda:param name="commit" value="=reviewing.head" />
302
+ </extensionElements>
303
+ </serviceTask>
304
+ <sequenceFlow id="joiners-known" sourceRef="joiners" targetRef="approve" />
300
305
 
301
306
  <userTask id="approve" name="批准合并" coda:assignee="user" coda:status="评审通过:等你批准合并">
302
307
  <documentation>PR #{{github.event.number}} 可以合并。
@@ -306,17 +311,13 @@ GitHub 上各项检查用 `gh pr checks {{github.event.pull_request.html_url}}`
306
311
  - **检查**:{{if checks.lines = null or checks.lines = "" then "没有" else checks.lines}}
307
312
  - **PR**:{{github.event.pull_request.html_url}}
308
313
 
309
- 最近一次评审(提交 {{review.head}};点「让 Agent 处理评审意见」才交给开 PR 的会话):
310
- {{review.report}}
311
-
312
- 「合并」以 {{vars.review.mergeMethod}} 方式合并提交 {{reviewing.head}}{{if kinds.premerge then ",先在它上面跑项目的合并前检查,都通过才合并" else ""}}。没合并成(合并前检查没通过,或 GitHub 没合并:冲突、检查没过等)就交给开 PR 的会话处理,它推送的新版本评审通过后按这次的选择合并,不再问你;评审要求修改则这次批准作废。</documentation>
314
+ 最近一次评审(提交 {{review.head}}):
315
+ {{review.report}}</documentation>
313
316
  <extensionElements>
314
317
  <coda:choice id="merge" name="合并" primary="true">
315
318
  <coda:option default='=list contains(vars.review.mergeOptions, "deleteBranch")' id="deleteBranch" name="合并后删除远程分支" detail="删除这个 PR 的远程源分支,本地分支和工作树保留" />
316
- <coda:option default='=list contains(vars.review.mergeOptions, "deploy")' id="deploy" name="部署" detail="调用项目里的部署流程" coda:shown="=kinds.deploy" />
317
- <coda:option default='=list contains(vars.review.mergeOptions, "preview")' id="preview" name="发布预览版" detail="调用项目里的预览发布流程" coda:shown="=kinds.preview" />
318
- <coda:option default='=list contains(vars.review.mergeOptions, "release")' id="release" name="发布正式版" detail="调用项目里的正式发布流程" coda:shown="=kinds.release" />
319
- <coda:option default='=list contains(vars.review.mergeOptions, "notify")' id="notify" name="全部完成后通知 Agent" detail="合并及所选删除分支、部署、发布结束后通知" />
319
+ <coda:optionList value="=joiners.list" />
320
+ <coda:option default='=list contains(vars.review.mergeOptions, "notify")' id="notify" name="全部完成后通知 Agent" detail="合并及所选删除分支、合并后的流程结束后通知" />
320
321
  </coda:choice>
321
322
  <coda:choice id="send" name="让 Agent 处理评审意见" />
322
323
  <coda:choice id="close" name="关闭 PR" detail="不合并,在 GitHub 上关闭这个 PR" />
@@ -346,17 +347,19 @@ GitHub 上各项检查用 `gh pr checks {{github.event.pull_request.html_url}}`
346
347
  <sequenceFlow id="back-to-approve" sourceRef="not-handled" targetRef="approve" />
347
348
 
348
349
  <!-- 记下你批准的时刻和合并后要做的事:之后评审再要求修改(review.changesAt 更晚)这次批准才作废;
349
- 合并后的删分支、部署、发布与通知都照这里,不论 Coda 先从合并步骤还是先从 GitHub 得知合并了。 -->
350
+ 合并后的删分支、合并后的流程与通知都照这里,不论 Coda 先从合并步骤还是先从 GitHub 得知合并了。 -->
350
351
  <scriptTask id="approval" name="记下批准" coda:timeout="5" coda:checkout="false" scriptFormat="bash">
351
352
  <extensionElements>
352
353
  <coda:env name="APPROVED" value="=approve" />
354
+ <coda:env name="JOINERS" value="=joiners.list" />
353
355
  <coda:output name="at" />
354
356
  <coda:output name="deleteBranch" />
355
- <coda:output name="deploy" />
356
- <coda:output name="release" />
357
- <coda:output name="releaseKinds" />
358
357
  <coda:output name="notify" />
359
358
  <coda:output name="what" />
359
+ <coda:output name="only" />
360
+ <coda:output name="inputs" />
361
+ <coda:output name="missing" />
362
+ <coda:output name="asks" />
360
363
  </extensionElements>
361
364
  <script>node "${CODA_PLUGIN_PATH}/scripts/approval.mjs"</script>
362
365
  </scriptTask>
@@ -573,73 +576,53 @@ GitHub 上各项检查用 `gh pr checks {{github.event.pull_request.html_url}}`
573
576
  </scriptTask>
574
577
  <sequenceFlow id="branch-deleted" sourceRef="delete-branch" targetRef="delivering-or-not" />
575
578
 
576
- <exclusiveGateway id="delivering-or-not" name="部署或发布吗" default="merged-only" />
579
+ <exclusiveGateway id="delivering-or-not" name="运行合并后的流程吗" default="merged-only" />
577
580
  <sequenceFlow id="to-delivering" sourceRef="delivering-or-not" targetRef="delivering">
578
- <conditionExpression xsi:type="tFormalExpression">=approval.deploy or approval.release</conditionExpression>
581
+ <conditionExpression xsi:type="tFormalExpression">=approval.only != "[]"</conditionExpression>
579
582
  </sequenceFlow>
580
583
  <sequenceFlow id="merged-only" sourceRef="delivering-or-not" targetRef="merged-here" />
581
584
  <endEvent id="merged-here" coda:status="已合并" coda:notify="=approval.notify" />
582
585
 
583
- <!-- 部署与发布:项目自己声明哪些流程是部署(coda:kind="deploy")、预览发布(preview)、正式发布(release),这里在合并提交上调用它们;
584
- 项目没有这一类的流程,这一步直接过去。先部署,再请开 PR 的会话写更新说明、发布。失败时运行失败,交回开 PR 的会话。 -->
585
- <subProcess id="delivering" name="部署与发布" coda:optional="true">
586
+ <!-- 合并后的流程:在合并提交上运行你勾的(项目里加入挂点 merged 的流程,only);它们要的文字卡上没写的,先请开 PR 的会话逐项写。
587
+ 失败时运行失败,交回开 PR 的会话。 -->
588
+ <subProcess id="delivering" name="合并后的流程" coda:optional="true">
586
589
  <startEvent id="delivering-in" />
587
- <sequenceFlow id="dl-in" sourceRef="delivering-in" targetRef="deploying" />
588
- <exclusiveGateway id="deploying" name="部署吗" default="not-deploying" />
589
- <sequenceFlow id="to-deploy" sourceRef="deploying" targetRef="deploy">
590
- <conditionExpression xsi:type="tFormalExpression">=approval.deploy</conditionExpression>
591
- </sequenceFlow>
592
- <sequenceFlow id="not-deploying" sourceRef="deploying" targetRef="releasing" />
593
- <serviceTask id="deploy" name="部署" coda:action="run-workflows" coda:status="部署中">
594
- <extensionElements>
595
- <coda:param name="kind" value="deploy" />
596
- <coda:param name="commit" value="=github.event.pull_request.merge_commit_sha" />
597
- </extensionElements>
598
- </serviceTask>
599
- <sequenceFlow id="deployed" sourceRef="deploy" targetRef="releasing" />
600
- <exclusiveGateway id="releasing" name="发布吗" default="deploy-only" />
601
- <sequenceFlow id="to-notes" sourceRef="releasing" targetRef="notes">
602
- <conditionExpression xsi:type="tFormalExpression">=approval.release</conditionExpression>
590
+ <sequenceFlow id="dl-in" sourceRef="delivering-in" targetRef="fill-choice" />
591
+ <exclusiveGateway id="fill-choice" name="有没写的文字吗" default="fill-skip" />
592
+ <sequenceFlow id="fill-needed" sourceRef="fill-choice" targetRef="fill">
593
+ <conditionExpression xsi:type="tFormalExpression">=approval.missing != ""</conditionExpression>
603
594
  </sequenceFlow>
604
- <sequenceFlow id="deploy-only" sourceRef="releasing" targetRef="delivered" />
605
- <endEvent id="delivered" coda:status="已合并并部署" />
606
-
607
- <userTask id="notes" name="写更新说明" coda:status="发布:写更新说明" coda:completeLabel="提交并继续发布" coda:rejectLabel="无法提供更新说明" coda:noteLabel="更新说明">
608
- <documentation>PR #{{github.event.number}}({{github.event.pull_request.html_url}})已合并,接下来按用户的选择发布。
609
-
610
- 请写这次发布的更新说明:Markdown,面向用户,写这次改了什么、用户会注意到什么变化,不写内部实现,不超过 2000 字。用 completed 答复,note 里只放更新说明本身。做不了就用 rejected 并说明原因,由用户来写。</documentation>
611
- </userTask>
612
- <sequenceFlow id="noted" sourceRef="notes" targetRef="publishing" />
613
- <boundaryEvent id="no-notes" name="做不了" attachedToRef="notes"><errorEventDefinition /></boundaryEvent>
614
- <sequenceFlow id="to-notes-user" sourceRef="no-notes" targetRef="notes-user" />
615
- <userTask id="notes-user" name="写更新说明" coda:assignee="user" coda:status="发布:等你写更新说明" coda:completeLabel="提交并继续发布" coda:rejectLabel="不再发布" coda:noteLabel="更新说明">
616
- <documentation>PR #{{github.event.number}}({{github.event.pull_request.html_url}})已合并,接下来按你的选择发布。开 PR 的会话没写更新说明,理由在这次运行的「写更新说明」任务里。
617
-
618
- 请填写面向用户的更新说明(Markdown,不超过 2000 字)。</documentation>
595
+ <sequenceFlow id="fill-skip" sourceRef="fill-choice" targetRef="merged-inputs" />
596
+ <userTask id="fill" name="填写合并后流程要的文字" coda:status="合并后:填写流程要的文字" coda:noteLabel="要填的文字">
597
+ <documentation>用户批准合并时勾的流程要一段文字,批准卡上没有写:
598
+ {{split(approval.asks, "\n")[loopCounter]}}
599
+ PR #{{github.event.number}}({{github.event.pull_request.html_url}})已合并。
600
+ 按这次合并进来的改动写这段面向用户的文字(Markdown,不写内部实现,不用审查意见),备注只放文字本身。</documentation>
601
+ <extensionElements><coda:choice id="done" name="已写好" primary="true" note="required" /></extensionElements>
602
+ <multiInstanceLoopCharacteristics isSequential="true" coda:inputCollection='=split(approval.missing, ",")' coda:inputElement="input" />
619
603
  </userTask>
620
- <sequenceFlow id="noted-by-user" sourceRef="notes-user" targetRef="publishing" />
621
- <boundaryEvent id="not-releasing" name="不再发布" attachedToRef="notes-user"><errorEventDefinition /></boundaryEvent>
622
- <sequenceFlow id="to-unreleased" sourceRef="not-releasing" targetRef="unreleased" />
623
- <endEvent id="unreleased" coda:status="你决定不再发布" />
624
-
625
- <scriptTask id="publishing" name="整理发布参数" coda:timeout="5" coda:checkout="false" scriptFormat="bash">
604
+ <sequenceFlow id="filled" sourceRef="fill" targetRef="merged-inputs" />
605
+ <scriptTask id="merged-inputs" name="整理合并后流程的参数" coda:timeout="5" coda:checkout="false" scriptFormat="bash">
626
606
  <extensionElements>
627
- <coda:env name="AGENT" value="=notes" />
628
- <coda:env name="USER" value="=notes-user" />
607
+ <coda:env name="INPUTS" value="=approval.inputs" />
608
+ <coda:env name="MISSING" value="=approval.missing" />
609
+ <coda:env name="ASKS" value="=approval.asks" />
610
+ <coda:env name="FILLS" value="=fill" />
629
611
  <coda:output name="inputs" />
630
612
  </extensionElements>
631
- <script>node "${CODA_PLUGIN_PATH}/scripts/notes.mjs"</script>
613
+ <script>node "${CODA_PLUGIN_PATH}/scripts/approval.mjs" inputs</script>
632
614
  </scriptTask>
633
- <sequenceFlow id="to-publish" sourceRef="publishing" targetRef="publish" />
634
- <serviceTask id="publish" name="发布" coda:action="run-workflows" coda:status="发布中">
615
+ <sequenceFlow id="to-run-merged" sourceRef="merged-inputs" targetRef="run-merged" />
616
+ <serviceTask id="run-merged" name="合并后的流程" coda:action="run-workflows" coda:status="运行合并后的流程">
635
617
  <extensionElements>
636
- <coda:param name="kind" value="=approval.releaseKinds" />
618
+ <coda:param name="hook" value="merged" />
619
+ <coda:param name="only" value="=approval.only" />
637
620
  <coda:param name="commit" value="=github.event.pull_request.merge_commit_sha" />
638
- <coda:param name="inputs" value="=publishing.inputs" />
621
+ <coda:param name="inputs" value="=merged-inputs.inputs" />
639
622
  </extensionElements>
640
623
  </serviceTask>
641
- <sequenceFlow id="published" sourceRef="publish" targetRef="released-end" />
642
- <endEvent id="released-end" coda:status="已发布" />
624
+ <sequenceFlow id="ran-merged" sourceRef="run-merged" targetRef="delivered" />
625
+ <endEvent id="delivered" coda:status="已合并,合并后的流程已结束" />
643
626
  </subProcess>
644
627
  <sequenceFlow id="to-delivered" sourceRef="delivering" targetRef="delivering-done" />
645
628
  <endEvent id="delivering-done" coda:notify="=approval.notify" />
@@ -6,7 +6,7 @@
6
6
  检查:在这个提交上调用项目声明为检查的流程(coda:kind="check"),没通过交回主 Agent。
7
7
  评审:评审方(发起时选的,没选按设置「评审组合」)在只读会话里评审一次;要求修改交回主 Agent,它改,或写明不改的理由。之后只重跑检查,不评第二轮。
8
8
  设备验收(可选):主 Agent 装预览版,你在设备上验收,「不行」交回主 Agent。
9
- 合并前检查、GitHub 检查都通过后请你批准;合并后按你勾选的部署、发布。BPMN 2.0,由 Coda 执行(docs/workflows.md)。 -->
9
+ 合并前检查、GitHub 检查都通过后请你批准;合并后运行你勾选的合并后流程(挂点 merged)。BPMN 2.0,由 Coda 执行(docs/workflows.md)。 -->
10
10
  <definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:coda="https://coda.pub/schema/bpmn/1.0"
11
11
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" id="simple-definitions" targetNamespace="https://coda.pub/plugins/review">
12
12
  <process id="simple" name="简易开发" isExecutable="true" coda:kind="develop" coda:title="简易开发">
@@ -223,7 +223,7 @@
223
223
  <sequenceFlow id="github-checked" sourceRef="github-checks" targetRef="github-how" />
224
224
  <exclusiveGateway id="github-how" name="都过了吗" default="github-passed" />
225
225
  <sequenceFlow id="github-failed" sourceRef="github-how" targetRef="github-feedback"><conditionExpression xsi:type="tFormalExpression">=not(github-checks.passed)</conditionExpression></sequenceFlow>
226
- <sequenceFlow id="github-passed" sourceRef="github-how" targetRef="kinds" />
226
+ <sequenceFlow id="github-passed" sourceRef="github-how" targetRef="joiners" />
227
227
  <scriptTask id="github-feedback" name="交回 GitHub 检查失败" scriptFormat="bash" coda:checkout="false" coda:timeout="5">
228
228
  <extensionElements><coda:env name="STEP" value="GitHub 检查" /><coda:env name="LINES" value="=github-checks.lines" /></extensionElements>
229
229
  <script>node "${CODA_PLUGIN_PATH}/scripts/simple.mjs" failed</script>
@@ -244,23 +244,20 @@
244
244
  </userTask>
245
245
  <sequenceFlow id="fix-push" sourceRef="fix" targetRef="push" />
246
246
 
247
- <serviceTask id="kinds" name="看项目有哪些部署、发布" coda:action="workflow-kinds">
248
- <extensionElements><coda:param name="commit" value="=pr.head" /></extensionElements>
247
+ <!-- 合并卡只放做决定用得到的数据和控件;勾选项是项目在这个提交上加入挂点 merged 的流程(hook-joiners),默认勾不勾由它们自己声明。 -->
248
+ <serviceTask id="joiners" name="合并后的流程" coda:action="hook-joiners">
249
+ <extensionElements><coda:param name="hook" value="merged" /><coda:param name="commit" value="=pr.head" /></extensionElements>
249
250
  </serviceTask>
250
- <sequenceFlow id="kinds-approve" sourceRef="kinds" targetRef="approve" />
251
+ <sequenceFlow id="joiners-approve" sourceRef="joiners" targetRef="approve" />
251
252
  <userTask id="approve" name="批准合并" coda:assignee="user" coda:status="检查通过:等你批准合并">
252
253
  <documentation>{{pr.summary}}
253
254
 
254
255
  - **检查**:项目检查、合并前检查{{if github-checks.lines = null or github-checks.lines = "" then "" else "、GitHub 检查" + github-checks.lines}}
255
- - **PR**:{{pr.url}}
256
-
257
- 「合并」以 {{vars.review.mergeMethod}} 方式合并提交 {{pr.head}},随后按勾选部署、发布。「暂不合并」须写明原因,交给主 Agent 跟进。</documentation>
256
+ - **PR**:{{pr.url}}</documentation>
258
257
  <extensionElements>
259
258
  <coda:choice id="merge" name="合并" primary="true">
260
- <coda:option default='=list contains(vars.review.mergeOptions, "deploy")' id="deploy" name="部署" detail="调用项目里的部署流程" coda:shown="=kinds.deploy" />
261
- <coda:option default='=list contains(vars.review.mergeOptions, "preview")' id="preview" name="发布预览版" detail="调用项目里的预览发布流程" coda:shown="=kinds.preview" />
262
- <coda:option default='=list contains(vars.review.mergeOptions, "release")' id="release" name="发布正式版" detail="调用项目里的正式发布流程" coda:shown="=kinds.release" />
263
- <coda:option default="true" id="notify" name="全部完成后通知 Agent" detail="合并及所选部署、发布结束后通知" />
259
+ <coda:optionList value="=joiners.list" />
260
+ <coda:option default="true" id="notify" name="全部完成后通知 Agent" detail="合并及所选流程结束后通知" />
264
261
  </coda:choice>
265
262
  <coda:choice id="stop" name="暂不合并" note="required" />
266
263
  </extensionElements>
@@ -272,9 +269,9 @@
272
269
  <endEvent id="stopped" name="暂不合并" />
273
270
  <scriptTask id="approval" name="记下批准" coda:timeout="5" coda:checkout="false" scriptFormat="bash">
274
271
  <extensionElements>
275
- <coda:env name="APPROVED" value="=approve" />
276
- <coda:output name="at" /><coda:output name="deleteBranch" /><coda:output name="deploy" /><coda:output name="release" />
277
- <coda:output name="releaseKinds" /><coda:output name="notify" /><coda:output name="what" />
272
+ <coda:env name="APPROVED" value="=approve" /><coda:env name="JOINERS" value="=joiners.list" />
273
+ <coda:output name="at" /><coda:output name="deleteBranch" /><coda:output name="notify" /><coda:output name="what" />
274
+ <coda:output name="only" /><coda:output name="inputs" /><coda:output name="missing" /><coda:output name="asks" />
278
275
  </extensionElements>
279
276
  <script>node "${CODA_PLUGIN_PATH}/scripts/approval.mjs"</script>
280
277
  </scriptTask>
@@ -288,39 +285,42 @@
288
285
  <script>node "${CODA_PLUGIN_PATH}/scripts/simple.mjs" merge</script>
289
286
  </scriptTask>
290
287
  <sequenceFlow id="merge-how" sourceRef="merge" targetRef="merged" />
291
- <exclusiveGateway id="merged" name="合并了吗" default="merged-deploy" />
288
+ <exclusiveGateway id="merged" name="合并了吗" default="merged-after" />
292
289
  <sequenceFlow id="merge-conflict" sourceRef="merged" targetRef="problem"><conditionExpression xsi:type="tFormalExpression">=merge.route = "conflict"</conditionExpression></sequenceFlow>
293
- <sequenceFlow id="merged-deploy" sourceRef="merged" targetRef="deploying" />
294
-
295
- <exclusiveGateway id="deploying" name="部署吗" default="not-deploying" />
296
- <sequenceFlow id="to-deploy" sourceRef="deploying" targetRef="deploy"><conditionExpression xsi:type="tFormalExpression">=approval.deploy</conditionExpression></sequenceFlow>
297
- <sequenceFlow id="not-deploying" sourceRef="deploying" targetRef="releasing" />
298
- <serviceTask id="deploy" name="部署" coda:action="run-workflows" coda:status="部署中">
299
- <extensionElements><coda:param name="kind" value="deploy" /><coda:param name="commit" value="=merge.commit" /></extensionElements>
300
- </serviceTask>
301
- <sequenceFlow id="deployed" sourceRef="deploy" targetRef="releasing" />
302
- <exclusiveGateway id="releasing" name="发布吗" default="not-releasing" />
303
- <sequenceFlow id="to-notes" sourceRef="releasing" targetRef="notes"><conditionExpression xsi:type="tFormalExpression">=approval.release</conditionExpression></sequenceFlow>
304
- <sequenceFlow id="not-releasing" sourceRef="releasing" targetRef="done" />
305
- <userTask id="notes" name="写更新说明" coda:status="发布:写更新说明" coda:completeLabel="提交并继续发布" coda:rejectLabel="无法提供更新说明" coda:noteLabel="更新说明">
306
- <documentation>PR {{pr.url}} 已合并,接下来按用户的选择发布。
290
+ <sequenceFlow id="merged-after" sourceRef="merged" targetRef="after-merged" />
307
291
 
308
- 请写这次发布的更新说明:Markdown,面向用户,写这次改了什么、用户会注意到什么变化,不写内部实现,不超过 2000 字。用 completed 答复,note 里只放更新说明本身。</documentation>
292
+ <!-- 合并后:运行批准卡上勾的流程(only),它们要的文字卡上没写的先交主 Agent 逐项写。 -->
293
+ <exclusiveGateway id="after-merged" name="运行合并后的流程吗" default="to-fill-choice" />
294
+ <sequenceFlow id="nothing-after" sourceRef="after-merged" targetRef="done"><conditionExpression xsi:type="tFormalExpression">=approval.only = "[]"</conditionExpression></sequenceFlow>
295
+ <sequenceFlow id="to-fill-choice" sourceRef="after-merged" targetRef="fill-choice" />
296
+ <exclusiveGateway id="fill-choice" name="有没写的文字吗" default="fill-skip" />
297
+ <sequenceFlow id="fill-needed" sourceRef="fill-choice" targetRef="fill"><conditionExpression xsi:type="tFormalExpression">=approval.missing != ""</conditionExpression></sequenceFlow>
298
+ <sequenceFlow id="fill-skip" sourceRef="fill-choice" targetRef="merged-inputs" />
299
+ <userTask id="fill" name="填写合并后流程要的文字" coda:status="合并后:填写流程要的文字" coda:noteLabel="要填的文字">
300
+ <documentation>用户批准合并时勾的流程要一段文字,批准卡上没有写:
301
+ {{split(approval.asks, "\n")[loopCounter]}}
302
+ PR {{pr.url}} 已合并,合并提交 {{merge.commit}}。
303
+ 按这次合并进来的改动写这段面向用户的文字(Markdown,不写内部实现,不用审查意见),备注只放文字本身。</documentation>
304
+ <extensionElements><coda:choice id="done" name="已写好" primary="true" note="required" /></extensionElements>
305
+ <multiInstanceLoopCharacteristics isSequential="true" coda:inputCollection='=split(approval.missing, ",")' coda:inputElement="input" />
309
306
  </userTask>
310
- <sequenceFlow id="noted" sourceRef="notes" targetRef="publishing" />
311
- <scriptTask id="publishing" name="整理发布参数" coda:timeout="5" coda:checkout="false" scriptFormat="bash">
312
- <extensionElements><coda:env name="AGENT" value="=notes" /><coda:output name="inputs" /></extensionElements>
313
- <script>node "${CODA_PLUGIN_PATH}/scripts/notes.mjs"</script>
307
+ <sequenceFlow id="filled" sourceRef="fill" targetRef="merged-inputs" />
308
+ <scriptTask id="merged-inputs" name="整理合并后流程的参数" coda:timeout="5" coda:checkout="false" scriptFormat="bash">
309
+ <extensionElements>
310
+ <coda:env name="INPUTS" value="=approval.inputs" /><coda:env name="MISSING" value="=approval.missing" />
311
+ <coda:env name="ASKS" value="=approval.asks" /><coda:env name="FILLS" value="=fill" />
312
+ <coda:output name="inputs" />
313
+ </extensionElements>
314
+ <script>node "${CODA_PLUGIN_PATH}/scripts/approval.mjs" inputs</script>
314
315
  </scriptTask>
315
- <sequenceFlow id="to-publish" sourceRef="publishing" targetRef="publish" />
316
- <serviceTask id="publish" name="发布" coda:action="run-workflows" coda:status="发布中">
316
+ <sequenceFlow id="to-run-merged" sourceRef="merged-inputs" targetRef="run-merged" />
317
+ <serviceTask id="run-merged" name="合并后的流程" coda:action="run-workflows" coda:status="运行合并后的流程">
317
318
  <extensionElements>
318
- <coda:param name="kind" value="=approval.releaseKinds" />
319
- <coda:param name="commit" value="=merge.commit" />
320
- <coda:param name="inputs" value="=publishing.inputs" />
319
+ <coda:param name="hook" value="merged" /><coda:param name="only" value="=approval.only" />
320
+ <coda:param name="commit" value="=merge.commit" /><coda:param name="inputs" value="=merged-inputs.inputs" />
321
321
  </extensionElements>
322
322
  </serviceTask>
323
- <sequenceFlow id="published" sourceRef="publish" targetRef="done" />
323
+ <sequenceFlow id="ran-merged" sourceRef="run-merged" targetRef="done" />
324
324
  <endEvent id="done" name="已合并" coda:notify="=approval.notify">
325
325
  <extensionElements><coda:output name="pr" value="=pr.url" /><coda:output name="commit" value="=merge.commit" /><coda:output name="notify" value="=approval.notify" /></extensionElements>
326
326
  </endEvent>
package/README.md CHANGED
@@ -3,7 +3,7 @@
3
3
  `review`:会话开的 PR 从开出来起由流程 `pull-request` 跟着走,一个 PR 一条运行,到合并或关闭才结束。
4
4
  它只用 Coda 流程的公开原语(PR 事件、Agent 步骤、人工任务、调用其他流程),也是写 PR 流程的样例:要不一样的流程,照着它改一份(见文末「改成自己的」)。
5
5
  它依赖内置的 GitHub 插件(`extensionDependencies`):PR 事件由 GitHub 插件的「PR 观察」发布;装 review 时先装 GitHub 插件,卸载 GitHub 插件时 review 一起卸载。
6
- 运行的标题是「PR #号 标题」(手动发起的是参数 `pr`,评审查出 PR 后是「PR #号(地址)」),卡片上有「检查」「评审」「合并」三段;草稿、叠放的 PR 另有「草稿」「叠放」,选了部署或发布的,合并后再有「部署与发布」。
6
+ 运行的标题是「PR #号 标题」(手动发起的是参数 `pr`,评审查出 PR 后是「PR #号(地址)」),卡片上有「检查」「评审」「合并」三段;草稿、叠放的 PR 另有「草稿」「叠放」,勾了合并后流程的,合并后再有「合并后的流程」。
7
7
  流程通过 `coda:key` 声明 PR 地址为主键:在同一项目中,自动、手动发起共享一条未结束的运行,包括排队、等答复和取消收尾。地址不区分大小写。结束后新请求可再发起;旧请求重试仍返回原运行。
8
8
  也可以 `workflow_run pull-request` 手动发起(必填 `pr`:GitHub 返回的完整 PR 地址,可选 `focus`)。已有运行时返回它,沿用原进度、关注点和结果接收会话;草稿中的运行也照旧等标记为可评审。没有运行时只评审一次、不计次数、不进入合并;如果随后 PR 观察发来事件,在同一条运行里接上完整流程。是否接入完整流程按 `github.event.coda.heard` 判断:手动运行尚未收到事件时为空。
9
9
  `pr` 须在创建运行前明确。编号、旧仓库地址或带后缀的链接先用 `gh pr view <编号或链接> --json url --jq .url` 取得 GitHub 返回的地址,再传入;流程不从 origin 猜仓库身份。需要查最近开的 PR 时先用 GitHub 插件的 `github-reported-pr` 找到它,再用 `gh pr view` 确认当前地址。输入不接受编号、末尾斜线、查询参数或片段,避免不同拼写创建不同主键。此版本需要支持 `coda:key` 的 Coda 流程引擎。
@@ -19,10 +19,9 @@ scripts/simple.mjs 简易开发的推送、PR、验收与合并
19
19
  scripts/checks.mjs 等 GitHub 检查
20
20
  scripts/review.mjs 交叉评审:选评审方、开会话、读结论、写 PR 评论;带参数 commit 时评一段提交
21
21
  scripts/base.mjs 看 base(叠放)
22
- scripts/approval.mjs 记下批准:时刻与合并后要做的事
22
+ scripts/approval.mjs 记下批准:时刻与合并后要做的事;带参数 inputs 时整理合并后流程的参数
23
23
  scripts/merge.mjs 合并
24
24
  scripts/delete-branch.mjs 合并确认后删除远程源分支
25
- scripts/notes.mjs 发布流程的参数(更新说明与 publish)
26
25
  scripts/step.mjs 各脚本共用:读参数、写输出与摘要、读 PR 的 base
27
26
  prompts/review.md 评审方收到的提示词
28
27
  prompts/rules.md 评审的规则:评审方照它评审,开 PR 的会话照它判断意见成不成立
@@ -37,9 +36,11 @@ prompts/principles/ 评审重点,一项一段,按设置取
37
36
  | `review.principles` 评审重点 | 多选:`state` 状态与失败、`defense` 多余的防御、`architecture` 架构与腐化、`tests` 测试;勾选的那几段(`prompts/principles/` 下同名文件)放进提示词 | 都选 |
38
37
  | `review.maxReviews` 一条运行最多自动评审几次 | 整数 1–100 | 3 |
39
38
  | `review.mergeMethod` 合并方式 | `squash`、`merge`、`rebase` 之一 | `squash` |
40
- | `review.mergeOptions` 合并时默认勾选 | 多选:删除远程分支、部署、发布预览版、发布正式版、全部完成后通知 Agent | 都不选 |
39
+ | `review.mergeOptions` 合并时默认勾选 | 多选:删除远程分支、全部完成后通知 Agent | 都不选 |
41
40
 
42
- 插件设置列出全部合并选项;目录设置继承插件的选择,也可整组覆盖或恢复继承。目录里只显示该目录有的部署、发布类别。默认值在运行开始时读取,已经打开的卡片保持原来的选择。需要支持勾选项 `default` 与设置选项 `workflowKind` 的 Coda。
41
+ 目录设置继承插件的选择,也可整组覆盖或恢复继承。合并后的流程(部署、发布等)勾不勾不在这里设,由项目里加入挂点 `merged` 的流程自己声明(下文「挂点 merged」)。默认值在运行开始时读取,已经打开的卡片保持原来的选择。
42
+
43
+ 3.0.0 把批准卡上写死的「部署」「发布预览版」「发布正式版」换成挂点 `merged`([Coda #2521](https://github.com/coda-console/coda/issues/2521) 第 4 步):勾选项是项目里加入这个挂点的流程,合并后只运行勾了的;去掉「写更新说明」,加入者要的文字卡上没写时由开 PR 的会话(简易开发是主 Agent)逐项补写。`review.mergeOptions` 只剩 `deleteBranch`、`notify`,原来的 `deploy`、`preview`、`release` 不再认。卡上去掉了说明性的文字,只留做决定用的数据。需要支持 `hook-joiners` 与 `coda:optionList` 的 Coda(协议 5.17.0)。
43
44
 
44
45
  ## 项目提供的部分
45
46
 
@@ -48,7 +49,7 @@ prompts/principles/ 评审重点,一项一段,按设置取
48
49
  - **评审准则**:`.coda/review.md`,从 PR 的 **base 提交**读取,交给评审方,也写进「处理评审意见」交给开 PR 的会话。PR 改它只从合并后的评审起生效;文件不存在就省略,读不出 base 提交时这次评审失败。
49
50
  - **检查**:仓库里声明为 `coda:kind="check"` 的流程(第 2 步),每个版本都跑。
50
51
  - **合并前检查**:声明为 `coda:kind="premerge"` 的流程(第 5 步),你批准后在要合并的提交上只跑一次;每个版本都跑嫌贵的验证(如整套回归)放这里。
51
- - **部署与发布**:声明为 `coda:kind="deploy"`、`preview`、`release` 的流程(第 6 步)。
52
+ - **合并后的流程**:加入挂点 `merged` 的流程(第 6 步,下文「挂点 merged」),如部署、发布预览版、发布正式版。
52
53
 
53
54
  ## 流程
54
55
 
@@ -85,12 +86,12 @@ prompts/principles/ 评审重点,一项一段,按设置取
85
86
  再从「草稿吗」重来:base 变了改动就变了,重新评审。在「合并」里(等你批准、等会话处理时)base 变了也一样从头再看,批准卡撤回。
86
87
  仓库开了合并后删分支时,下层 PR 合并后 GitHub 自己把 base 改到默认分支;没开就由作者用 `gh pr edit --base` 改。
87
88
  5. **合并**:
88
- - 「批准合并」交给你,卡片写明评审结论、改动(按路径第一段分组,如 `backend/ 2 · Sources/ 1`)、PR 链接、各项检查和最近一次评审。
89
- 主按钮「合并」按 `review.mergeOptions` 的默认值提交;右侧箭头或长按打开勾选面板,选项是「合并后删除远程分支」「部署」「发布预览版」「发布正式版」「全部完成后通知 Agent」,初始按设置勾选,点面板内「合并」才提交。取消不保存本次调整,再打开恢复默认值。未设置时全部不选。
90
- 卡片之前的「看项目有哪些部署、发布」(`workflow-kinds`)查项目在这个提交上有哪几类流程,部署和发布选项只给项目有的那几类(`coda:shown`);
91
- 比如只有部署流程的项目,面板里有「合并后删除远程分支」「部署」和「全部完成后通知 Agent」。没给的那几项按不勾算。需要 Coda 745f85c 及之后。
89
+ - 「批准合并」交给你,卡片只有做决定用的数据:评审结论、改动(按路径第一段分组,如 `backend/ 2 · Sources/ 1`)、各项检查、PR 链接和最近一次评审。
90
+ 卡片之前的「合并后的流程」(`hook-joiners`,`hook=merged`)列出项目在评审通过的提交上加入挂点 `merged` 的流程。
91
+ 主按钮「合并」按默认值提交;「更多」里的勾选项依次是「合并后删除远程分支」、这些流程(默认勾不勾由各自的 `default` 定)、「全部完成后通知 Agent」,删分支与通知初始按 `review.mergeOptions` 勾选。
92
+ 勾上要文字的流程(如发布要发布说明)时卡上出现对应的输入框,可以不写。
92
93
  另有「让 Agent 处理评审意见」:连同你的备注交给开 PR 的会话「处理你交付的评审意见」,它推送后重新评审、再请你批准,它做不了就回到批准卡;以及「关闭 PR」(`gh pr close`)。
93
- - 「合并前检查」:你选了合并后,先「记下批准」(`approval.mjs`):批准的时刻,和你勾的删分支、部署、发布、通知(合并后都照它做),再在评审通过的提交上调用项目声明的合并前检查(`coda:kind="premerge"`)并等它们结束;
94
+ - 「合并前检查」:你选了合并后,先「记下批准」(`approval.mjs`):批准的时刻,和你勾的删分支、合并后的流程(连同卡上写的文字、没写的输入)、通知(合并后都照它做),再在评审通过的提交上调用项目声明的合并前检查(`coda:kind="premerge"`)并等它们结束;
94
95
  项目没有就直接过去。有一个没通过就交给开 PR 的会话「合并前检查没通过:处理后答复」:改动导致的就推送新提交,照常检查、评审,通过后按你这次的选择合并,不再问;
95
96
  检查本身出了问题就处理好后答复,再跑一遍。它做不了交给你「合并前检查没通过:等你处理」。合并没成功后重试合并不再跑合并前检查(同一个提交已经通过)。
96
97
  需要认识 `premerge` 这一类的 Coda。
@@ -106,17 +107,16 @@ prompts/principles/ 评审重点,一项一段,按设置取
106
107
  合并命令结束后再读取确认,照你的勾选接着做。等待批准、合并前检查或人工处理时收到关闭,仍立即结束相应等待。
107
108
  合并前,「交给 GitHub」记下要交出去的提交;合并受阻、等人处理时才收到这个提交的合并确认,仍照原批准继续。
108
109
  合并前检查没过、还在等人处理时被别处合并,不算这条运行的合并。
109
- - 勾选「合并后删除远程分支」时,确认合并后、部署与发布前运行「删除远程分支」(`delete-branch.mjs`)。它从 PR 读取源仓库(包括 fork)与源分支,
110
+ - 勾选「合并后删除远程分支」时,确认合并后、合并后的流程前运行「删除远程分支」(`delete-branch.mjs`)。它从 PR 读取源仓库(包括 fork)与源分支,
110
111
  只删除仍指向这次批准合并的提交的远程分支;本地分支与会话工作树保留。分支或源仓库已删除就跳过,有了其他提交、是默认分支或合并目标分支则保留,原因记在步骤摘要。
111
- 删除用 Git 的 `--force-with-lease=<ref>:<sha>`,推送期间分支变动也不会误删。读取或删除失败会让运行失败,处理后可从失败处继续,之后再部署与发布。
112
+ 删除用 Git 的 `--force-with-lease=<ref>:<sha>`,推送期间分支变动也不会误删。读取或删除失败会让运行失败,处理后可从失败处继续,之后再运行合并后的流程。
112
113
  不勾选时流程不主动删分支;GitHub 仓库自身的「合并后自动删除分支」设置仍独立生效。
113
- 6. **部署与发布**:合并确认后按你的勾选,在合并提交(`merge_commit_sha`)上调用其他流程:先 `run-workflows kind=deploy`,
114
- 再交给开 PR 的会话「写更新说明」(它做不了交给你写;你选「不再发布」,运行正常结束),然后按勾选调用 `kind=preview`、`release` 或 `preview,release`,
115
- 参数 `notes`(更新说明)与 `publish`(`"true"`)。没声明某个参数的流程不会拿到它;项目没有这一类的流程,这一步直接过去。
116
- 部署或发布失败时运行失败,结果交回开 PR 的会话,由它查明后手动重跑对应的流程。
114
+ 6. **合并后的流程**:合并确认后,勾了的(`approval.only`)在合并提交(`merge_commit_sha`)上用 `run-workflows hook=merged` 运行,参数是卡上写的文字;
115
+ 它们要的文字卡上没写的,先交开 PR 的会话「填写合并后流程要的文字」(下文「挂点 merged」)。一个都没勾就直接结束。
116
+ 失败时运行失败,结果交回开 PR 的会话,由它查明后手动重跑对应的流程。
117
117
 
118
- - PR 在 GitHub 网页上合并或关闭(不经这条运行的「等 GitHub 确认」,也不是上面那种你批准的版本在合并时先送到的关闭),运行随之结束,交出去的任务和卡片撤回,不删除分支、不部署、不发布。
119
- - 正常结束只更新运行与卡片、结清等待,不唤醒 Agent;勾选「全部完成后通知 Agent」则在合并及所选删除分支、部署、发布都结束后回传一次。未处理的失败照常回传;手动发起的评审交回结论。
118
+ - PR 在 GitHub 网页上合并或关闭(不经这条运行的「等 GitHub 确认」,也不是上面那种你批准的版本在合并时先送到的关闭),运行随之结束,交出去的任务和卡片撤回,不删除分支、不运行合并后的流程。
119
+ - 正常结束只更新运行与卡片、结清等待,不唤醒 Agent;勾选「全部完成后通知 Agent」则在合并及所选删除分支、合并后的流程都结束后回传一次。未处理的失败照常回传;手动发起的评审交回结论。
120
120
  - 流程只按检查、评审结果、PR 状态与你的批准推进,不读取作者会话的忙闲、后台任务或其他运行;合并前要先完成的验证写成检查(第 2 步)或合并前检查(第 5 步)。
121
121
 
122
122
  ## 简易开发
@@ -140,11 +140,20 @@ prompts/principles/ 评审重点,一项一段,按设置取
140
140
  5. **评审一次**:`reviewer`(或评审组合里的那一行)在只读会话里评审,规则、阻塞级别、评审重点与 PR 生命流程相同,结论也写成 PR 评论。要求修改时交主 Agent「处理评审意见」:改了就提交、选「已修改」;不改选「不改」,必须写明理由,写进 PR 和批准卡,由你批准时判断。之后只重跑检查,不评第二轮。
141
141
  6. **设备验收**(`devices` 打开时):主 Agent 只装改到的那一端(`mac-preview-install`、`ios-preview-install`,传 PR 的提交),你在设备上验收;「不行」必须附言(写意见或附截图),交回主 Agent 修改,改好后重新验收。验收过的提交之后又改了,也要重新验收。
142
142
  7. **合并前检查与 GitHub 检查**:在 PR 的提交上跑一次 `coda:kind="premerge"`,再等 GitHub 上的检查都有结果;没通过交回主 Agent。
143
- 8. **批准合并**:卡片上是改动汇报、评审结论、不改的理由与检查结果。「合并」按 `review.mergeMethod` 合并这个提交,可勾部署、发布预览版、发布正式版(项目有对应流程时出现,默认按 `review.mergeOptions`)与「全部完成后通知 Agent」(默认勾选);「暂不合并」必须写明原因,交给主 Agent 跟进。合并时删除运行自己的分支;与目标分支冲突时交回主 Agent 合入、解冲突,再重跑检查、重新批准。其余合并失败让这一步失败。
144
- 9. **部署与发布**:合并后在合并提交上按勾选调用部署;发布前请主 Agent 写更新说明,再调用发布流程。
143
+ 8. **批准合并**:卡片上是改动汇报、评审结论、不改的理由、检查结果与 PR。「合并」按 `review.mergeMethod` 合并这个提交,可勾项目里加入挂点 `merged` 的流程(`hook-joiners` 列出,默认由各自声明)与「全部完成后通知 Agent」(默认勾选);「暂不合并」必须写明原因,交给主 Agent 跟进。合并时删除运行自己的分支;与目标分支冲突时交回主 Agent 合入、解冲突,再重跑检查、重新批准。其余合并失败让这一步失败。
144
+ 9. **合并后的流程**:合并后在合并提交上运行勾了的;它们要的文字卡上没写的先交主 Agent 逐项补写(下文「挂点 merged」)。
145
145
 
146
146
  所有交回主 Agent 修改的(评审意见除外)都是同一张「修改后答复」,写明要改的是什么;答复后从推送重新走。进度存在本次运行的产物 `simple.json` 里。需要支持流程参数 `agent` 类型、`coda:wake` 与 `note="required"` 的 Coda。
147
147
 
148
+ ## 挂点 merged
149
+
150
+ PR 生命流程与简易开发声明挂点 `merged`:合并后要做的事由项目自己的流程(或启用插件的流程)在 `process` 上写 `<coda:join hook="merged" …/>` 加入(Coda 的 `docs/workflows.md`「调用其他流程」),本插件不认识任何一类。约定:
151
+
152
+ - **加入者带什么**:`name` 是卡上勾选项的名字(不写用流程名),`detail` 一行说明,`default` 是否默认勾(不写为不勾,默认不勾就由加入者这样表达),`order` 排序(小的在前),可选 `inputs`:它要从卡上拿的自己的文字参数(本流程 `type` 为 string 的 `coda:input`,标签取参数的 `label`),如发布说明 `notes`。
153
+ - **卡上**:批准前用 `hook-joiners`(`hook=merged`,`commit` 是要合并的提交)列出加入者,作为「合并」的勾选项,你可以勾任意几个;勾上带 `inputs` 的出现对应的输入框。
154
+ - **合并后**:在合并提交上用 `run-workflows`(`hook=merged`,`only` 是勾了的流程名,`commit` 是合并提交,`inputs` 是卡上写的文字加补写的)运行勾了的,等它们都结束;每个加入者只拿到它声明的参数。没勾任何一个就不调用。
155
+ - **卡上没写的文字**:勾了的加入者要、卡上没写的输入,先交开 PR 的会话(简易开发是主 Agent)「填写合并后流程要的文字」,每个输入一张、依次,任务里写明是哪一项、哪几个流程要;备注必填,只附文件没写字时「整理合并后流程的参数」失败并写明是哪一项。
156
+
148
157
  ## 评审一段提交
149
158
 
150
159
  能力 `review-commit` 只被调用,没有自己的触发器:流程用 `callActivity calledElement="review-commit"` 按名字调用它,不必依赖本插件。
package/package.json CHANGED
@@ -4,7 +4,7 @@
4
4
  "displayName": "PR 生命流程",
5
5
  "description": "PR 从检查、评审到批准合并;简易开发",
6
6
  "icon": { "symbol": "checkmark.bubble.fill", "color": "purple" },
7
- "version": "2.17.1",
7
+ "version": "3.0.0",
8
8
  "categories": [
9
9
  "工作流程"
10
10
  ],
@@ -143,33 +143,15 @@
143
143
  "title": "合并后删除远程分支",
144
144
  "description": "删除这个 PR 的远程源分支,本地分支和工作树保留"
145
145
  },
146
- {
147
- "const": "deploy",
148
- "title": "部署",
149
- "description": "调用项目里的部署流程",
150
- "workflowKind": "deploy"
151
- },
152
- {
153
- "const": "preview",
154
- "title": "发布预览版",
155
- "description": "调用项目里的预览发布流程",
156
- "workflowKind": "preview"
157
- },
158
- {
159
- "const": "release",
160
- "title": "发布正式版",
161
- "description": "调用项目里的正式发布流程",
162
- "workflowKind": "release"
163
- },
164
146
  {
165
147
  "const": "notify",
166
148
  "title": "全部完成后通知 Agent",
167
- "description": "合并及所选删除分支、部署、发布结束后通知"
149
+ "description": "合并及所选删除分支、合并后的流程结束后通知"
168
150
  }
169
151
  ]
170
152
  },
171
153
  "default": [],
172
- "description": "合并卡片初始勾选这些选项,直接点「合并」也按此执行。每次合并前可以调整;目录可以覆盖,且只显示该目录可用的选项。"
154
+ "description": "合并卡片初始勾选这些选项,直接点「合并」也按此执行。每次合并前可以调整;目录可以覆盖。合并后的流程勾不勾由项目里的流程自己声明。"
173
155
  }
174
156
  }
175
157
  },
@@ -1,16 +1,41 @@
1
- // Records the user's approval to merge (../.coda/workflows/pull-request.bpmn「记下批准」): when (`at`: a review asking for
2
- // changes later voids it), and what they chose to follow the merge (`deleteBranch`, `deploy`, `release`, `releaseKinds`,
3
- // `notify`, and `what`, the choice as the merge step says it). Put out here, not by the merge step, so that the process
4
- // follows the choice however it hears of the merge: after the merge step, or from GitHub while that step still runs.
1
+ // Records the user's approval to merge (../.coda/workflows/pull-request.bpmn「记下批准」, simple.bpmn): when (`at`: a review
2
+ // asking for changes later voids it), and what they chose to follow the merge: `deleteBranch`, `notify`, and the workflows
3
+ // joining the hook `merged` they ticked (JOINERS is the list hook-joiners gave the card): `only`, their names as JSON for
4
+ // run-workflows; `inputs`, the text the card took for them; `missing`, the ids (comma separated) of the inputs they ask
5
+ // for that the card left empty, and `asks`, a line for each, in the same order, saying which of them asks. `what` is the
6
+ // choice as the merge step says it. Put out here, not by the merge step, so that the process follows the choice however it
7
+ // hears of the merge: after the merge step, or from GitHub while that step still runs.
8
+ //
9
+ // With `inputs`, after the merge: what run-workflows gives them, the card's text and what the session wrote for each of
10
+ // `missing` (FILLS, one task each, in order); one written with no text fails the step, naming it.
5
11
  import { json, output } from './step.mjs';
6
12
 
7
- const options = (json('APPROVED', {}) ?? {}).options ?? {};
13
+ if (process.argv[2] === 'inputs') {
14
+ const inputs = json('INPUTS', {}), ids = (process.env.MISSING || '').split(',').filter(Boolean);
15
+ const fills = json('FILLS', []), asks = (process.env.ASKS || '').split('\n');
16
+ ids.forEach((id, i) => {
17
+ const text = String(fills[i]?.note ?? '').trim();
18
+ if (!text) { console.error(`${asks[i] || id}:没有填写,不运行合并后的流程`); process.exit(1); }
19
+ inputs[id] = text;
20
+ });
21
+ output('inputs', JSON.stringify(inputs));
22
+ process.exit(0);
23
+ }
24
+
25
+ const answer = json('APPROVED', {}), options = answer.options ?? {}, written = answer.inputs ?? {};
8
26
  const chosen = id => options[id] === true;
27
+ const ticked = json('JOINERS', []).filter(joiner => chosen(joiner.id)), inputs = {}, missing = new Map();
28
+ for (const joiner of ticked) for (const { id, label } of joiner.inputs ?? []) {
29
+ const text = String(written[id] ?? '').trim();
30
+ if (text) inputs[id] = text;
31
+ else (missing.get(id) ?? missing.set(id, { label, for: [] }).get(id)).for.push(joiner.name);
32
+ }
9
33
  output('at', Date.now());
10
34
  output('deleteBranch', chosen('deleteBranch'));
11
- output('deploy', chosen('deploy'));
12
- output('release', chosen('preview') || chosen('release'));
13
- output('releaseKinds', ['preview', 'release'].filter(chosen).join(','));
14
35
  output('notify', chosen('notify'));
15
- output('what', ['合并', ...[['deleteBranch', '合并后删除远程分支'], ['deploy', '部署'], ['preview', '发布预览版'], ['release', '发布正式版'], ['notify', '全部完成后通知 Agent']]
16
- .filter(([id]) => chosen(id)).map(([, name]) => name)].join(' · '));
36
+ output('only', JSON.stringify(ticked.map(joiner => joiner.id)));
37
+ output('inputs', JSON.stringify(inputs));
38
+ output('missing', [...missing.keys()].join(','));
39
+ output('asks', [...missing.values()].map(m => `「${m.label}」:${m.for.join('、')}要`).join('\n'));
40
+ output('what', ['合并', ...(chosen('deleteBranch') ? ['合并后删除远程分支'] : []), ...ticked.map(joiner => joiner.name),
41
+ ...(chosen('notify') ? ['全部完成后通知 Agent'] : [])].join(' · '));
package/scripts/notes.mjs DELETED
@@ -1,11 +0,0 @@
1
- // What the release workflows are given (../.coda/workflows/pull-request.bpmn): the notes for this release, written by
2
- // the session that opened the pull request, or by the user once it could not, and `publish`, since the user chose to
3
- // release with the merge and is not asked again whether to make it public. A workflow that does not declare an input
4
- // is not given it (docs/workflows.md#调用其他流程). The notes go to the step summary too, for the run's page.
5
- import { json, output, summary } from './step.mjs';
6
-
7
- const agent = json('AGENT', {}), user = json('USER', {});
8
- const notes = String((agent.result === 'completed' ? agent.note : user.note) ?? '').trim();
9
- if (!notes) { console.error('没有更新说明:不发布'); summary('## 更新说明\n\n没有更新说明,不发布。'); process.exit(1); }
10
- summary(`## 更新说明\n\n${notes}`);
11
- output('inputs', JSON.stringify({ notes, publish: 'true' }));