flower-trellis 0.6.13-beta.12 → 0.6.13-beta.14

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.
@@ -22,7 +22,7 @@ Codex 保持普通 `codex` / `codex resume` 与默认共享服务。通过当前
22
22
  先从项目根执行 `python3 .trellis/scripts/flower_confirmation_hook.py --entry`,读取实际返回的 `entry` argv,后续在其后追加 `prepare`、`wait` 等子命令。入口固定为项目内 `.trellis/scripts/flower_confirmation.py`,内部复用当前 Python 解释器,仅依赖标准库和项目脚本。`entry=null` 或工具失败才报告实际原因;不能用无 stdout 的 `test -f` 推断入口不存在。确认阶段无需 Node、npm、全局 Flower 或额外 pip 安装。
23
23
 
24
24
  1. 在 gitignored `.trellis/.runtime/` 为当前平台和会话写一个 JSON 材料文件,路径不得复用于并行会话。不要把它放入提交集合,不生成公开报告附件。使用结构化文件写入,用户正文和 message 不拼入 shell。
25
- 2. JSON 的公共字段为 `kind: brief|check|push`、`task`(当前精确任务相对路径,无任务为 null)。Brief 正文读取当前任务 `brief.md`。Check/Push 另提供完整标准报告/计划的 `body`。
25
+ 2. JSON 的公共字段为 `kind: brief|check|push`、`task`。Brief 必须指定目标活动任务的精确相对路径,正文读取该任务 `brief.md`;当前会话允许尚未绑定任务,已有绑定须与目标一致。会话绑定另行冻结,等待期间变化使旧确认失效。Check/Push 使用当前精确任务相对路径,无任务为 null,另提供完整标准报告/计划的 `body`。
26
26
  3. Check 必填 `reportVersion`、`dispositionVersion`(非空版本字符串)及 `findings: [{id:"CHK-001",status:"pending"}]`;status 只接受 pending/accepted/resolved。必须覆盖当前全部条目,禁止只传准备修复的子集来改变默认动作。
27
27
  4. Push 必填 `mode: push|commit-only`、`evidence: {check:passed|accepted|focused,spec:no-op|written,unresolvedRisks:0}` 和有序 `repositories`。每仓包含 `root`、实际 `branch`、完整 `head`(初始空仓为 null)、实际 `upstream`(没有为 null)、精确 `message`、完整 `files` 路径列表。把已展示的生成命令、任务记录 exact files 与顺序一并保存在输入中,不在领取后扩大范围。
28
28
  5. 从项目根执行 `python3 -X utf8 .trellis/scripts/flower_confirmation.py prepare --platform codex|claude --input <相对路径>`;用户明确指定本次时长时加 `--seconds <正整数秒>`。仅 `prepared=true` 可继续,任何错误或 false 保持原人工提示。
@@ -33,7 +33,21 @@ Git 整仓快照、仅用于哈希的文件以及两端会话记录不按总字
33
33
 
34
34
  ## 到期领取与原流程续接
35
35
 
36
- 原生提醒仅唤醒:先执行 `python3 -X utf8 .trellis/scripts/flower_confirmation.py claim --platform <平台> --request <UUID>`。必须实际取得 `claimed=true`、`source=policy_timeout`、预期 action 和当前冻结 context,才可续接。false、错误、材料或会话漂移时结束旧提醒,不执行旧动作、不重复领取、不假称用户已确认。
36
+ 原生提醒仅唤醒:先执行 `python3 -X utf8 .trellis/scripts/flower_confirmation.py claim --platform <平台> --request <UUID>`。必须实际取得 `claimed=true`、`source=policy_timeout`、预期 action 和当前冻结 context,才可续接。false、错误、材料或会话漂移时停止旧动作,不重复领取旧请求、不假称用户已确认;在同一回合进入下述恢复分支。
37
+
38
+ ### 失效提醒的自动恢复
39
+
40
+ 领取失败表示本次旧许可无效,不是当前工作流的终止条件。旧版提醒中的“结束本回合”按本节恢复规则处理。先读取当前用户消息及已有工作流上下文,再执行一次 `python3 -X utf8 .trellis/scripts/flower_confirmation.py status --platform <平台>`。只查询当前项目和当前原生会话,不搜索其它会话的许可,也不改用 status 返回的新请求 ID 领取旧通知。
41
+
42
+ - 当前有 `prepared`、`waiting`、`dispatching` 或 `queued` 请求:保留当前请求及其后台等待,不重新准备、不重置计时、不重复启动 worker。迟到提醒到此处理完毕;继续当前用户消息中已授权的工作。当前请求由其自己的原生提醒领取。
43
+ - 当前为 `consumed`:读取 `receipt` 和 `execution`,由原 owner 核对实际进度。已 `started` 的动作先据实恢复和记账,已完成的动作进入下一步;禁止重新执行旧默认动作。缺少 started 记录时也不能借本次旧通知补领或补启动。
44
+ - 当前为 `absent`、`cancelled` 或 `failed`:从当前任务、最新报告或精确 Git 计划恢复原 owner。当前工作仍需要确认且范围已明确时,重建最新材料,自动执行原 prepare/wait/display 并重新计时。新请求必须完整展示并独立取得 claim 与 started;不沿用旧倒计时、旧回执或旧材料。没有待续工作时仅忽略旧提醒。
45
+ - 当前为 `delivery_unknown`:先由原 owner 核对队列及实际执行结果,再按实际进度恢复。投递结果未知本身不授权重发或重执行业务。
46
+ - 用户已明确暂停、取消或改变方向时,优先执行该指令。新的范围或产品取舍、风险接受、Spec 歧义、宿主权限及能力缺失仍按入口决策处理;只有这些实际条件才回到相应人工流程。单纯 `not_current` 或旧许可失效不要求用户再手动确认。
47
+
48
+ 一次提醒最多自动重新准备一次。准备或等待实际失败时报告具体原因并沿原人工分支交接,不在本回合循环领取、轮询或反复重建计时器。
49
+
50
+ ### 有效领取后的原流程续接
37
51
 
38
52
  领取后、首个业务动作前,执行 `python3 -X utf8 .trellis/scripts/flower_confirmation.py result --platform <平台> --request <UUID> --receipt <回执 UUID> --state started`。只有 `recorded=true` 才进入对应 owner;重复 started 不能再次执行。Brief 继续原 `task.py start` 与 route;Check 继续原“修复全部”及重检;Push 继续原精确范围和逐仓预检、提交、推送、进度/Close 及失败恢复。不得把 receipt 当成新产品决策、原生审批或任意 shell 的授权。
39
53
 
@@ -19,6 +19,7 @@ from pathlib import Path
19
19
 
20
20
  from common.config import parse_simple_yaml
21
21
  from common.active_task import resolve_active_task
22
+ from common.tasks import normalize_closeout
22
23
 
23
24
 
24
25
  VERSION = 1
@@ -342,8 +343,14 @@ def inspect_confirmation(root, input_path, platform, session_id, seconds=None):
342
343
  raise ValueError("未知确认种类")
343
344
  active = resolve_active_task(root, {"session_id": session_id}, platform,
344
345
  allow_single_session_fallback=False, allow_environment_context=False)
345
- task = active.task_path
346
- if material.get("task") != task:
346
+ task = material.get("task") if kind == "brief" else active.task_path
347
+ if kind == "brief":
348
+ # Brief 先确认再 start,因此目标任务来自材料;会话绑定另行冻结以检测等待期间的切换。
349
+ if active.source_type != "session" or active.stale:
350
+ raise ValueError("Brief 确认的当前会话任务状态无效")
351
+ if not isinstance(task, str) or not re.fullmatch(r"\.trellis/tasks/[^/]+", task):
352
+ raise ValueError("Brief 确认必须指定活动任务目录")
353
+ if (kind != "brief" or active.task_path is not None) and material.get("task") != active.task_path:
347
354
  raise ValueError("确认材料与当前会话任务不符")
348
355
  task_manual_only = False
349
356
  task_files = {}
@@ -352,6 +359,10 @@ def inspect_confirmation(root, input_path, platform, session_id, seconds=None):
352
359
  task_metadata = json.loads(metadata_bytes.decode("utf-8"))
353
360
  if not isinstance(task_metadata, dict) or not isinstance(task_metadata.get("meta", {}), dict):
354
361
  raise ValueError("任务元数据无效")
362
+ if kind == "brief":
363
+ closeout = normalize_closeout(task_metadata)
364
+ if not closeout["valid"] or closeout["status"] == "closed":
365
+ raise ValueError("Brief 确认目标任务已关闭或关闭状态无效")
355
366
  task_manual_only = task_metadata.get("meta", {}).get("confirmationTimeoutDisabled") is True
356
367
  task_files["task.json"] = hashlib.sha256(metadata_bytes).hexdigest()
357
368
  for name in ("prd.md", "design.md", "implement.md", "brief.md"):
@@ -359,8 +370,6 @@ def inspect_confirmation(root, input_path, platform, session_id, seconds=None):
359
370
  continue
360
371
  task_files[name] = _fingerprint(_inside(root, task + "/" + name), optional=True)
361
372
  if kind == "brief":
362
- if not task:
363
- raise ValueError("Brief 确认缺少当前任务")
364
373
  brief_bytes = _bytes(_inside(root, task + "/brief.md"))
365
374
  task_files["brief.md"] = hashlib.sha256(brief_bytes).hexdigest()
366
375
  body = brief_bytes.decode("utf-8")
@@ -372,6 +381,8 @@ def inspect_confirmation(root, input_path, platform, session_id, seconds=None):
372
381
  if len(body.encode("utf-8")) > DOCUMENT_BYTES:
373
382
  raise ValueError("确认正文超过 512 KiB 展示预算")
374
383
  facts = {"task": task, "taskFiles": task_files, "inputHash": hashlib.sha256(input_bytes).hexdigest()}
384
+ if kind == "brief":
385
+ facts["sessionTask"] = active.task_path
375
386
  count = 0
376
387
  if kind == "check":
377
388
  if not all(isinstance(material.get(key), str) and material[key] for key in ("reportVersion", "dispositionVersion")):
@@ -1,7 +1,7 @@
1
1
  {
2
- "syncedAt": "2026-11-12T03:35:31.472Z",
2
+ "syncedAt": "2026-11-14T12:02:25.130Z",
3
3
  "syncedFrom": "vendor/skill-garden",
4
- "sourceCommit": "d3ea04730a59fa3c84e7eaccc93f95f7399842f7",
4
+ "sourceCommit": "fd7f2c6cd089786b7a45143e6e64621c5edc807f",
5
5
  "common": {
6
6
  "codexSkills": [
7
7
  "aliyun-ops",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "flower-trellis",
3
- "version": "0.6.13-beta.12",
3
+ "version": "0.6.13-beta.14",
4
4
  "description": "一键安装/升级 Trellis 并自动融合 skill-garden 强化包(默认 Claude + agents)",
5
5
  "type": "module",
6
6
  "bin": {
@@ -73,9 +73,9 @@
73
73
  "commit-and-tag-version": "^12.7.3"
74
74
  },
75
75
  "flowerReleaseNotes": {
76
- "version": "0.6.13-beta.12",
76
+ "version": "0.6.13-beta.14",
77
77
  "source": "CHANGELOG.md",
78
- "body": "### 🐛 修复 Bug Fixes\n\n* **confirmation:** 从当前回合观察两端自动确认 ([60a565e](https://github.com/SilentFlower/flower-trellis/commit/60a565eaf43d9af5b35d464e03f6754fd3c37f27))",
78
+ "body": "### 🐛 修复 Bug Fixes\n\n* **confirmation:** 完善原生确认运行时与失效恢复 ([12ca130](https://github.com/SilentFlower/flower-trellis/commit/12ca130e4ac02441dbf83298cdc94250b764b773))",
79
79
  "truncated": false
80
80
  },
81
81
  "optionalDependencies": {
@@ -48,7 +48,9 @@ def wake_message(request_id, platform="codex"):
48
48
  return ("[flower-confirmation:v2:" + request_id + "]\n后台确认已到期。"
49
49
  "先按 .trellis/scripts/confirmation.md 定位本项目的 Python 入口,再执行 claim --platform "
50
50
  + platform + " --request " + request_id + "。只有返回 claimed=true 才按返回的 action 和冻结 context 进入原流程;"
51
- "必须继续执行原有范围检查与失败恢复。claimed=false 或失败表示已失效,结束本回合,不重试、不执行旧动作。")
51
+ "必须继续执行原有范围检查与失败恢复。claimed=false 或失败时,停止旧动作,"
52
+ "按协议读取当前 status 并恢复当前流程。已有有效等待予以保留;需要新等待时自动重新准备、完整展示并计时。"
53
+ "不得仅因旧提醒失效要求人工再确认,也不得重试领取旧请求或执行旧动作。")
52
54
 
53
55
 
54
56
  def wake_id(item):