flow-comet 1.5.0-rc.3
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.
- package/.flow-comet/rules/flow-comet-orchestration.md +13 -0
- package/.flow-comet/skills/flow-comet/GUIDANCE.md +196 -0
- package/.flow-comet/skills/flow-comet/INSTALLED_VERSION +1 -0
- package/.flow-comet/skills/flow-comet/SKILL.md +196 -0
- package/.flow-comet/skills/flow-comet/reference/KNOWN-ISSUES-template.md +19 -0
- package/.flow-comet/skills/flow-comet/reference/TEST-MATRIX.md +115 -0
- package/.flow-comet/skills/flow-comet/reference/authoring-lanes.json +33 -0
- package/.flow-comet/skills/flow-comet/reference/composition-report.md +65 -0
- package/.flow-comet/skills/flow-comet/reference/decision-points.md +64 -0
- package/.flow-comet/skills/flow-comet/reference/dirty-worktree.md +30 -0
- package/.flow-comet/skills/flow-comet/reference/dsh-platform.md +169 -0
- package/.flow-comet/skills/flow-comet/reference/init-detection.md +58 -0
- package/.flow-comet/skills/flow-comet/reference/recovery.md +20 -0
- package/.flow-comet/skills/flow-comet/reference/resolved-skills.json +661 -0
- package/.flow-comet/skills/flow-comet/reference/skill-review.md +13 -0
- package/.flow-comet/skills/flow-comet/reference/subagents/script-author.md +7 -0
- package/.flow-comet/skills/flow-comet/reference/workflow-protocol.json +681 -0
- package/.flow-comet/skills/flow-comet/reference/worktree-notes.md +52 -0
- package/.flow-comet/skills/flow-comet/scripts/comet-check.mjs +61 -0
- package/.flow-comet/skills/flow-comet/scripts/comet-hook-guard.mjs +909 -0
- package/.flow-comet/skills/flow-comet/scripts/comet-plan.mjs +2 -0
- package/.flow-comet/skills/flow-comet/scripts/context-init.mjs +312 -0
- package/.flow-comet/skills/flow-comet/scripts/contract-check.mjs +136 -0
- package/.flow-comet/skills/flow-comet/scripts/guard-self-test.mjs +7331 -0
- package/.flow-comet/skills/flow-comet/scripts/protocol-utils.mjs +376 -0
- package/.flow-comet/skills/flow-comet/scripts/route-node.mjs +230 -0
- package/.flow-comet/skills/flow-comet/scripts/state-schema.mjs +99 -0
- package/.flow-comet/skills/flow-comet/scripts/system-test.mjs +4017 -0
- package/.flow-comet/skills/flow-comet/scripts/task-parsing.mjs +28 -0
- package/.flow-comet/skills/flow-comet/scripts/workflow-guard.mjs +2396 -0
- package/.flow-comet/skills/flow-comet/scripts/workflow-handoff.mjs +378 -0
- package/.flow-comet/skills/flow-comet/scripts/workflow-state.mjs +1263 -0
- package/.flow-comet/skills/flow-comet-archive/SKILL.md +195 -0
- package/.flow-comet/skills/flow-comet-change/SKILL.md +29 -0
- package/.flow-comet/skills/flow-comet-compose/SKILL.md +249 -0
- package/.flow-comet/skills/flow-comet-design/GUIDANCE.md +23 -0
- package/.flow-comet/skills/flow-comet-design/SKILL.md +161 -0
- package/.flow-comet/skills/flow-comet-dev/SKILL.md +51 -0
- package/.flow-comet/skills/flow-comet-evolve/SKILL.md +26 -0
- package/.flow-comet/skills/flow-comet-execute/SKILL.md +182 -0
- package/.flow-comet/skills/flow-comet-health/SKILL.md +31 -0
- package/.flow-comet/skills/flow-comet-integration/SKILL.md +45 -0
- package/.flow-comet/skills/flow-comet-open/GUIDANCE.md +36 -0
- package/.flow-comet/skills/flow-comet-open/SKILL.md +161 -0
- package/.flow-comet/skills/flow-comet-plan/GUIDANCE.md +33 -0
- package/.flow-comet/skills/flow-comet-plan/SKILL.md +169 -0
- package/.flow-comet/skills/flow-comet-requirement/SKILL.md +27 -0
- package/.flow-comet/skills/flow-comet-review/SKILL.md +204 -0
- package/.flow-comet/skills/flow-comet-subagent-execute/GUIDANCE.md +29 -0
- package/.flow-comet/skills/flow-comet-subagent-execute/SKILL.md +214 -0
- package/.flow-comet/skills/flow-comet-task/SKILL.md +33 -0
- package/.flow-comet/skills/flow-comet-test/SKILL.md +41 -0
- package/.flow-comet/skills/flow-comet-ui-design/SKILL.md +26 -0
- package/.flow-comet/skills/flow-comet-verify/SKILL.md +164 -0
- package/LICENSE +21 -0
- package/README.md +255 -0
- package/package.json +27 -0
- package/scripts/dsh-bridge.mjs +461 -0
- package/scripts/prepare-env.mjs +1526 -0
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
# Composition Report
|
|
2
|
+
|
|
3
|
+
## Workflow Contract
|
|
4
|
+
|
|
5
|
+
- Kind: workflow-kernel
|
|
6
|
+
- Nodes: 8
|
|
7
|
+
- Required Skill Calls: 11
|
|
8
|
+
- Output Schemas: flowkit.intake.v1, flowkit.design.v1, flowkit.plan.v1, flowkit.execution.v1, flowkit.handoff.v1, flowkit.review.v1, flowkit.verify.v1, flowkit.archive.v1
|
|
9
|
+
- Wrapper classification: kernel-authored
|
|
10
|
+
|
|
11
|
+
## Source Skills
|
|
12
|
+
|
|
13
|
+
- flow-comet-open
|
|
14
|
+
- flow-comet-change
|
|
15
|
+
- flow-comet-requirement
|
|
16
|
+
- flow-comet-design
|
|
17
|
+
- flow-comet-ui-design
|
|
18
|
+
- flow-comet-task
|
|
19
|
+
- flow-comet-execute
|
|
20
|
+
- flow-comet-dev
|
|
21
|
+
- flow-comet-subagent-execute
|
|
22
|
+
- flow-comet-review
|
|
23
|
+
- flow-comet-test
|
|
24
|
+
- flow-comet-verify
|
|
25
|
+
- flow-comet-integration
|
|
26
|
+
- flow-comet-archive
|
|
27
|
+
|
|
28
|
+
## Composition Steps
|
|
29
|
+
|
|
30
|
+
- step-1: flow-comet-open (atomic)
|
|
31
|
+
- step-2: flow-comet-change (atomic)
|
|
32
|
+
- step-3: flow-comet-requirement (atomic)
|
|
33
|
+
- step-4: flow-comet-design (atomic)
|
|
34
|
+
- step-5: flow-comet-ui-design (atomic)
|
|
35
|
+
- step-6: flow-comet-task (atomic)
|
|
36
|
+
- step-7: flow-comet-execute (atomic)
|
|
37
|
+
- step-8: flow-comet-dev (atomic)
|
|
38
|
+
- step-9: flow-comet-subagent-execute (atomic)
|
|
39
|
+
- step-10: flow-comet-review (atomic)
|
|
40
|
+
- step-11: flow-comet-test (atomic)
|
|
41
|
+
- step-12: flow-comet-verify (atomic)
|
|
42
|
+
- step-13: flow-comet-integration (atomic)
|
|
43
|
+
- step-14: flow-comet-archive (atomic)
|
|
44
|
+
|
|
45
|
+
## Resolved Skills
|
|
46
|
+
|
|
47
|
+
- flow-comet-open: available
|
|
48
|
+
- flow-comet-change: available
|
|
49
|
+
- flow-comet-requirement: available
|
|
50
|
+
- flow-comet-design: available
|
|
51
|
+
- flow-comet-ui-design: available
|
|
52
|
+
- flow-comet-task: available
|
|
53
|
+
- flow-comet-execute: available
|
|
54
|
+
- flow-comet-dev: available
|
|
55
|
+
- flow-comet-subagent-execute: available
|
|
56
|
+
- flow-comet-review: available
|
|
57
|
+
- flow-comet-test: available
|
|
58
|
+
- flow-comet-verify: available
|
|
59
|
+
- flow-comet-integration: available
|
|
60
|
+
- flow-comet-archive: available
|
|
61
|
+
|
|
62
|
+
## Preferences
|
|
63
|
+
|
|
64
|
+
- Preference mode: not configured
|
|
65
|
+
- Preference hash: none
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
# Workflow Decision Classification
|
|
2
|
+
|
|
3
|
+
节点 skill 内嵌的交互确认点已作者化如下(与主 SKILL.md「决策分类与决策点」清单一致)。Do not infer that every Node or Output Schema requires confirmation. Classify each candidate into one of the four categories; pause only when at least two valid choices change scope, behavior, accepted risk, or an irreversible outcome.
|
|
4
|
+
|
|
5
|
+
## 四分类(真实用户决策 / 自动处理 / 停止条件 / 手动交接)
|
|
6
|
+
|
|
7
|
+
| 分类 | 定义 | 处理 |
|
|
8
|
+
|------|------|------|
|
|
9
|
+
| 用户决策 | ≥2 个会改变范围/行为/风险/不可逆结果的合法选项 | 用交互确认问(Claude Code 用 AskUserQuestion 优先;Codex 用文本提问+内联确认)或文本回退;相邻选择合并为一个问题,不重问已持久化选择 |
|
|
10
|
+
| 自动处理 | 唯一安全下一步 | 直接执行并汇报,不许制造确认 |
|
|
11
|
+
| 停止条件 | guard 失败 / 缺依赖 / 状态损坏 | 报告阻塞与恢复条件,无合法动作时才升级为用户决策 |
|
|
12
|
+
| 手动交接 | `NEXT: manual`(若有) | 不是用户决策,直接继续 |
|
|
13
|
+
|
|
14
|
+
## 作者化决策点清单(按节点)
|
|
15
|
+
|
|
16
|
+
### 用户决策(确认点,节点内暂停等待)
|
|
17
|
+
|
|
18
|
+
| 节点 | 决策点 | 触发条件 | 处理 |
|
|
19
|
+
|------|--------|---------|------|
|
|
20
|
+
| open | 首次调用主题/范围澄清 | 首次调用且主题/范围有多个合法解释 | 反问澄清后进入 |
|
|
21
|
+
| open | 视觉调性预选 | 仅前端项目(change 步骤 0.6) | 9 张调性卡片 + 推荐,用户选择 |
|
|
22
|
+
| design | 技术栈选型 | 5~6 卡筛选出 1 首选 + 1 备份 | 展示卡片 + 排除理由,等用户选择(CONTEXT 已锁技术决策时直接用) |
|
|
23
|
+
| execute | 破坏性变更检测(R4.6) | 命中破坏性变更信号 | 暂停展示引用图,用户确认后才继续 |
|
|
24
|
+
| execute | Schema 迁移(R4.5) | 检测到需要迁移 | 暂停等用户确认迁移方案 |
|
|
25
|
+
| execute | 切换 executionMode 到 direct | 用户要求 direct 模式 | 暂停确认,记录 directOverride |
|
|
26
|
+
| review | REVIEW Critical 项 | 审查发现 Critical 严重性项 | 暂停等人工确认处置 |
|
|
27
|
+
| verify | UAT 失败超限 | 第 4 次失败(机器计数 verifyFailures) | 暂停问用户「继续修 / 停止」(R2.6,≤3 次自动重试) |
|
|
28
|
+
| archive | 归档操作 | 移动文件到 .specs/archive/(不可逆) | 用户确认后才执行 |
|
|
29
|
+
| archive | 合并 change 分支到 main | 归档收尾 | merge 前暂停等用户确认 |
|
|
30
|
+
| archive | PR approve | enablePrReview 开启时(archive 前置) | 等用户/GitHub approve |
|
|
31
|
+
|
|
32
|
+
### 自动处理(唯一安全下一步,直接执行并汇报)
|
|
33
|
+
|
|
34
|
+
| 节点 | 决策点 | 处理 |
|
|
35
|
+
|------|--------|------|
|
|
36
|
+
| 全部 | 唯一安全下一步 | 直接执行并汇报,不许制造确认 |
|
|
37
|
+
| open/design | flow-kit 反问协议(CHANGE/REQUIREMENT/DESIGN)要求确认 | 按 flow-kit 规则暂停等待(协议要求的交互,非自由决策) |
|
|
38
|
+
| execute | verify 失败自动重试 | ≤ 3 次自动修复重试(机器计数 verifyFailures),不制造确认 |
|
|
39
|
+
|
|
40
|
+
### 停止条件(报告阻塞与恢复条件)
|
|
41
|
+
|
|
42
|
+
| 触发 | 处理 |
|
|
43
|
+
|------|------|
|
|
44
|
+
| Node guard 失败 | 先自动诊断并执行唯一安全修复;无合法动作时才升级为用户决策 |
|
|
45
|
+
| 缺依赖 / 状态损坏无法继续 | 报告停止条件与恢复条件;恢复方式存在多个会改变范围或风险的合法选项时才升级为用户决策 |
|
|
46
|
+
|
|
47
|
+
### 手动交接(非用户决策)
|
|
48
|
+
|
|
49
|
+
| 触发 | 处理 |
|
|
50
|
+
|------|------|
|
|
51
|
+
| 协议 `NEXT: manual`(若有) | 直接继续,不暂停询问 |
|
|
52
|
+
|
|
53
|
+
## 与节点 skill 的一致性
|
|
54
|
+
|
|
55
|
+
本清单作者化自节点 skill 内嵌确认点(open 调性预选——仅前端触发,记于节点技能 flow-comet-change,主 SKILL 清单不含 / design 技术栈 / execute 破坏性变更与 Schema 迁移与 direct 模式 / review Critical / verify 第 4 次失败 / archive 不可逆操作),与主 SKILL.md 决策点清单对应(主 SKILL 为汇总视角,前端专属确认点记于节点技能);新增/调整节点 skill 确认点时同步本文件与主 SKILL。
|
|
56
|
+
|
|
57
|
+
### 机制性决策点(严格模式相关,非用户交互确认——机制自动判定,执行者须知)
|
|
58
|
+
|
|
59
|
+
| 节点 | 决策点 | 判定 |
|
|
60
|
+
|------|--------|------|
|
|
61
|
+
| execute | 空退出豁免 | 全 parallel 无串行可做时,须显式声明 `emptyExitApproved`(否则 BLOCKED);exit 输出 EMPTY-EXIT 审计 |
|
|
62
|
+
| execute | 越权委托豁免 | [P] 任务在 execute 完成属越权委托(新 change BLOCKED),须经 subagent-execute 委托或显式说明 |
|
|
63
|
+
| 各节点 | entry 强制 | 新 change 未 entry 直接 exit → BLOCKED(旧 change WARN 渐进) |
|
|
64
|
+
| 各节点 | 新旧判定 | init 写入 `newChange: true` = 新 change(严格模式);旧 change(无标记)渐进 WARN |
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
# dirty-worktree 归属协议
|
|
2
|
+
|
|
3
|
+
## 触发
|
|
4
|
+
|
|
5
|
+
进入 execute / subagent-execute / verify 节点前,运行:
|
|
6
|
+
|
|
7
|
+
> **强制上下文**(实测):委托 worktree 子代理前**必须**先执行本协议——未 commit 的工件不会被 worktree 子代理看到(harness 从已提交 HEAD 创建 worktree),曾有 8 个排查任务因工件未 commit 全部空上下文运行。本协议是委托前的前置步骤,不是可选项。
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
git status --short
|
|
11
|
+
git diff --stat
|
|
12
|
+
git diff --cached --stat
|
|
13
|
+
git ls-files --others --exclude-standard
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
## 归属三分类
|
|
17
|
+
|
|
18
|
+
1. **属于当前 change** → 吸收进当前任务,不重做
|
|
19
|
+
2. **不属于当前 change** → 暂停问用户(并入 / 拆新 change / 不动 / 授权丢弃)
|
|
20
|
+
3. **来源不清** → 暂停报告,不推进阶段
|
|
21
|
+
|
|
22
|
+
## 构建产物排除
|
|
23
|
+
|
|
24
|
+
被 .gitignore 忽略的文件(node_modules/dist/__pycache__ 等)不会出现在未跟踪列表,自动排除。
|
|
25
|
+
|
|
26
|
+
## 禁令
|
|
27
|
+
|
|
28
|
+
- 脏工作树只算代码证据,不自动推进 phase / 勾选 tasks
|
|
29
|
+
- 未弄清来源前禁止覆盖 / 还原 / 格式化 / 忽略用户改动
|
|
30
|
+
- 脏 diff 未解释禁止标记 verify 通过
|
|
@@ -0,0 +1,169 @@
|
|
|
1
|
+
# dsh 平台锚定参考(dsh-platform)
|
|
2
|
+
|
|
3
|
+
> 维护者参考文档:dsh 平台适配的版本锚定、安装形态、API 签名、桥接 loader 契约与验证记录模板。
|
|
4
|
+
> 权威依据:`@.specs/deepseek-harness-platform/DESIGN.md`(D1~D10 / 7.1 / 7.2 / 7.3)、`@.specs/deepseek-harness-platform/REQUIREMENT.md`(AC-1~AC-7)、`@.specs/adr/ADR-005-dsh-install-via-installer.md`。
|
|
5
|
+
> dsh 为 dev-preview:本文件锚定认证版本(0.1.5-rc.1,2026-09-10 全接缝运行时认证;历史锚 0.1.0-rc.6 → 0.1.1-rc.2 实测线);破坏性变更风险显式声明。
|
|
6
|
+
|
|
7
|
+
## 1. 版本锚定
|
|
8
|
+
|
|
9
|
+
| 项 | 值 |
|
|
10
|
+
|---|---|
|
|
11
|
+
| 认证 dsh 版本 | `0.1.5-rc.1`(2026-09-10 全接缝运行时认证;历史锚 `0.1.0-rc.6` → `0.1.1-rc.2` 实测线) |
|
|
12
|
+
| 安装入口 | `node scripts/prepare-env.mjs --target <项目> --platform dsh`(或交互终端多选勾选 dsh)——唯一入口(D1) |
|
|
13
|
+
| 重置/重新生成(purge——删除后重建到完整安装态,**不是卸载**) | `node scripts/prepare-env.mjs --target <项目> --purge --platform dsh --yes` |
|
|
14
|
+
| npm 包 | 暂不发布(D8——1.5.0 一并处理);旧 npm 插件包安装形态已废弃(verify 阶段推翻,见 ADR-005) |
|
|
15
|
+
| 破坏性变更 | dev-preview 中 `tools/pre-execute` 签名 / skill 发现 rank / `DSH_HOME` 语义可能变化;低于锚定版本时拦截/发现可能失效 |
|
|
16
|
+
|
|
17
|
+
> 版本不匹配时拦截可能失效——必须文档警示 + 级 3 实测兜底(D9)。
|
|
18
|
+
|
|
19
|
+
## 2. tools/pre-execute 签名
|
|
20
|
+
|
|
21
|
+
```js
|
|
22
|
+
ctx.on('tools/pre-execute', async (exec, next) => {
|
|
23
|
+
// exec: ToolExecution
|
|
24
|
+
// { callId, name, arguments, signal, agent?, parent? }
|
|
25
|
+
// 放行: return next();
|
|
26
|
+
// 拒绝: return { kind: 'deny', reason: '…' };
|
|
27
|
+
// 询问: return { kind: 'ask', reason? };
|
|
28
|
+
});
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
- PreToolDecision 形状:`{kind:'allow'}` | `{kind:'deny', reason}` | `{kind:'ask', reason?}`;deny 必须带 `kind` 字段。
|
|
32
|
+
- 不调 `next()` 即否决(waterfall 事件——监听方不续传则工具被短路)。
|
|
33
|
+
- 会话 cwd 锚定:`exec.agent.session.header.cwd`(逐会话;缺失时逐级回退 exec 上下文其它路径字段——见桥接 loader sessionCwd;Web UI 切换 workspace 时按会话判定,非进程 cwd)。
|
|
34
|
+
|
|
35
|
+
## 3. skill 发现(文件系统级——取代 provider 注册模型)
|
|
36
|
+
|
|
37
|
+
- dsh skill 发现 rank 区间 100~500;**rank 100(最高)= `<项目根>/.dsh/skills`**(0.1.0-rc.6 源码核实)——目录存在于项目根下即自动发现(chokidar 热发现,免重启);未安装该目录的项目不可见该 skill → **天然项目级**(无运行时痕迹判定、无 chicken-and-egg)。
|
|
38
|
+
- 项目根 = 会话 cwd 的最近 `.git` 祖先(`.git` 可为目录或文件——worktree/submodule 形态)。
|
|
39
|
+
- 旧 provider 注册模型(`ctx.skills.registerProvider`)已废弃——skill 不再运行时注册,由文件系统发现 + 安装器物理安装(D3/D6)。
|
|
40
|
+
|
|
41
|
+
## 4. DSH_HOME 与 home patch
|
|
42
|
+
|
|
43
|
+
- `DSH_HOME` 解析(与 dsh CLI 同款默认,**两态**):`$DSH_HOME` 环境变量 > `~/.dsh`。dsh-home-paths 库 API 支持显式配置参数(configured),但 dsh CLI 0.1.0-rc.6 实际无参调用(profile-boot 调 `resolveDshHome()` 不传 configured),该层不生效;prepare-env 安装器与 dsh CLI 行为一致(两态)。
|
|
44
|
+
- **`DSH_` 前缀 bootstrap-only**:项目 `.env` 中设置 `DSH_HOME` 被直接拒绝——`.env` 方案不可行,文档明确不推荐(ADR-005 源码实证)。
|
|
45
|
+
- `$DSH_HOME/cordis.patch.yml` 为 home 级 patch,对所有 profile 生效——dsh 加载链 `bundles → profile → home → overlays`(ADR-005 源码核实)。
|
|
46
|
+
- flow-comet 托管块:`# --- flow-comet managed ---` … `# --- end flow-comet managed ---`,内容为 **insert 形态**(无 id 顶层 `- insert:` 条目内嵌插件行——追加到条目列表,而非覆盖既有条目):
|
|
47
|
+
|
|
48
|
+
```yaml
|
|
49
|
+
# --- flow-comet managed ---
|
|
50
|
+
- insert:
|
|
51
|
+
- id: dsh-flow-comet-bridge
|
|
52
|
+
name: 'file:///<loader 绝对路径>'
|
|
53
|
+
# --- end flow-comet managed ---
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
- **机制事实(为何必须 insert 形态)**:cordis.patch.yml 是 **id-targeted patch 层**——dsh-app-boot 的 `applyEntryPatches` 对 `{id, ...overrides}` 仅能覆盖已存在条目,id 不存在报 `entry not found` 跳过(旧 `- id: … + name:` patch 形态对不存在的 id 即跳过,loader 从不加载——拦截整链静默失效);**新增插件必须用无 id 顶层 `- insert:` 条目**。读-合并-写保留既有块;文件存在但内容无法识别为 YAML → fail-safe 报错退出不覆盖。
|
|
57
|
+
|
|
58
|
+
## 5. fs/write-intent(single-slot 守卫瀑布)
|
|
59
|
+
|
|
60
|
+
```ts
|
|
61
|
+
(target: FsTarget, actor: object | undefined, next) => FsWriteIntent | undefined
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
- 决策形状:`{kind:'createIfAbsent'}` | `{kind:'replaceIfVersion', version}`——守卫,**无 deny 决策面**。
|
|
65
|
+
- single-slot:first-wins by registration order。
|
|
66
|
+
- **flow-comet 不注册该槽位**(避免 shadow 官方 `dsh-fs-observation-policy` 的 freshness 检查);拦截能力由 `tools/pre-execute` 全覆盖(D6)。
|
|
67
|
+
- `fs/observed` 审计通道设计上不采用(v1 桥接 loader 极薄——D6;v2 可按需加)。
|
|
68
|
+
|
|
69
|
+
## 6. 安装 / 激活 / 重置(prepare-env 平台描述符——唯一入口)
|
|
70
|
+
|
|
71
|
+
### 安装
|
|
72
|
+
|
|
73
|
+
- 正式:`node scripts/prepare-env.mjs --target <项目> --platform dsh`。
|
|
74
|
+
- 多平台:`--platform claude-code,dsh`(逗号分隔,按参数顺序安装)/ `--platform all`(全部平台,按 PLATFORMS 表顺序:claude-code → codex → dsh);旧 `both` 已移除——`--platform both` 报错并提示用逗号列表或 all;未知平台报错(含逗号列表中的未知项——不得部分安装)。
|
|
75
|
+
- 交互(缺省选择链):显式 `--platform` > TTY 交互多选 > 探测 > 默认 claude-code。TTY 多选 = @clack/prompts 方向键多选(可选依赖,未安装自动回退 readline 数字/逗号多选),按目标项目痕迹 `.claude/`/`.codex/`/`.dsh/` 预勾选,回车默认 = 探测推荐;无 TTY 探测:仅 `.codex/` → codex、仅 `.dsh/` → dsh、含 `.claude/` → claude-code、皆无 → 默认 claude-code;多痕迹(≥2 并存)不武断二选一——默认主平台 claude-code 并输出提示。
|
|
76
|
+
- 安装动作(dsh 描述符):
|
|
77
|
+
1. `installHooks`:复制 `scripts/dsh-bridge.mjs` → `$DSH_HOME/plugins/dsh-flow-comet-bridge.mjs`(全局挂载——home patch 对所有 profile 生效)+ `$DSH_HOME/cordis.patch.yml` 托管块注入(读-合并-写,保留既有块;源文件缺失时 WARN 同时跳过 loader 复制与托管块注入(避免注入指向不存在文件的 file:// 引用),其余安装照常
|
|
78
|
+
2. `installRules`:AGENTS.md 托管区注入(`<!-- Managed by flow-comet prepare-env -->` … `<!-- /Managed by flow-comet prepare-env -->` 包裹编排规则全文;非破坏合并,保留托管区外用户内容;codex/dsh 共用标记——任一平台的移除流程均可清理该区)。
|
|
79
|
+
3. skills:复制权威源 `skills/flow-comet/**` → `<项目>/.dsh/skills/flow-comet/` + pathReplacements(包内命令路径 `.claude/skills/flow-comet/scripts/` → `.dsh/skills/flow-comet/scripts/`,仅 .md,幂等)+ INSTALLED_VERSION 版本标识。
|
|
80
|
+
|
|
81
|
+
### 激活(天然项目级)
|
|
82
|
+
|
|
83
|
+
- 目录物理存在即激活——dsh 启动自动发现 `/flow-comet`(rank 100,chokidar 热发现免重启);未安装该目录的项目不可见(无痕迹判定、无 chicken-and-egg)。
|
|
84
|
+
- dsh 对项目 AGENTS.md 的注入行为未实测(R2 遗留)——级 3 必测项;若 dsh 不注入则备选同时写 CLAUDE.md(symlink 同内容)并如实文档化。
|
|
85
|
+
|
|
86
|
+
### 重置/重新生成(prepare-env --purge --yes——删除后重建,**不是卸载**)
|
|
87
|
+
|
|
88
|
+
- `node scripts/prepare-env.mjs --target <项目> --purge --platform dsh --yes`:**先删除生成物、随后重新生成**(与 claude-code/codex 平台同一 main 模式):
|
|
89
|
+
1. 删 `<项目>/.dsh/skills/` 下全部 `flow-comet*` 条目(非 flow-comet 条目保留)+ 空 `.dsh` 目录(有内容保留)。
|
|
90
|
+
2. AGENTS.md 托管区移除(保留文件与用户内容)——重建流程随后重新注入新托管区(purge = 移除旧生成物后重建)。
|
|
91
|
+
3. `$DSH_HOME/cordis.patch.yml` 托管块移除(保留 dsh-skin 等既有块;移除后文件为空 → 删除文件本身)+ `$DSH_HOME/plugins/dsh-flow-comet-bridge.mjs` 删除——重建流程随后重新挂载 loader。
|
|
92
|
+
- **重置 ≠ 卸载(安全面警示)**:purge 后 flow-comet **仍完整安装**——skill 重新生成、AGENTS.md 托管区重新注入、全局 loader 继续挂载(所有 profile 拦截恢复)。用户想「卸载」而执行 purge 会得到完整安装态,不是移除。
|
|
93
|
+
- **真实卸载需手动**(purge 不是卸载途径):删 `<项目>/.dsh/skills/flow-comet*` + AGENTS.md 托管区(`<!-- Managed by flow-comet prepare-env -->` … `<!-- /Managed by flow-comet prepare-env -->`)+ `$DSH_HOME/cordis.patch.yml` 托管块 + `$DSH_HOME/plugins/dsh-flow-comet-bridge.mjs`;AGENTS.md 与 cordis.patch.yml 的托管区/托管块之外的用户内容保留。
|
|
94
|
+
- 多项目语义:每项目独立安装 skill(未安装项目不可见);loader 全局一份(按会话项目判定——与 claude-code 项目级 hook 等价);同一 loader 服务多个 flow-comet 项目。
|
|
95
|
+
|
|
96
|
+
## 7. 桥接 loader 契约($DSH_HOME/plugins/dsh-flow-comet-bridge.mjs)
|
|
97
|
+
|
|
98
|
+
- 形态:dsh 官方插件形态——ESM 模块导出 `{ name: 'dsh-flow-comet-bridge', apply(ctx) }`,ctx 由 dsh 注入;纯 ESM 零第三方依赖;模块级幂等(同进程重复 apply 跳过已注册监听)。
|
|
99
|
+
- 职责链:`tools/pre-execute` 监听 → 会话项目判定 → 参数映射 → 流程态门 → 包含性校验 → 子进程调项目本地 guard → 决策映射。
|
|
100
|
+
1. **窄监听(硬性契约)**:工具名归一化(非 Write/Edit/Bash 直接 `next()`);会话 cwd(`exec.agent.session.header.cwd` 锚定,缺失回退)的最近 `.git` 项目根下**存在 `.dsh/skills/flow-comet` 才处理**,否则直接 `next()`——非 flow-comet 项目零拦截零开销(D6/R7)。
|
|
101
|
+
2. **参数映射(fail-closed)**:dsh 工具名归一化到 guard CLI 契约名(Write/Edit/Bash;别名:write/writefile/file-write、edit/editfile/file-edit、bash/shell/powershell/pwsh/run_command/run-command);Write/Edit → `file_path`、Bash → `command`;形状不符/缺关键字段 → WARN + fail-closed deny(不静默放行)。
|
|
102
|
+
3. **流程态门(B 方案——包含性仅运行中生效)**:读项目根 `.flow-comet/flow-comet-state.json`(UTF-8 BOM 容错;判定规则锚定 guard `comet-hook-guard.mjs` L1882-1895):空闲(无 state / 无 `activeChange` / `status==='completed'`)→ 直接 `next()` 放行——跳过包含性校验与 guard 白名单(与 Claude Code / Codex 的 active-change 门语义对齐);解析失败 / 未知 status → WARN + fail-closed deny(不视为空闲放行);`activeChange` 存在且 `status==='running'` 或缺失(undefined)→ 继续下方包含性校验与 guard(现状不变)。
|
|
103
|
+
- **空闲边界(refined)**:空闲 = 无 state / 无 activeChange / status==='completed' → 项目外写 next() 放行;解析失败 / 未知 status 保持 fail-closed deny(不视为空闲),与 Claude Code / Codex 的 guard 语义一致。
|
|
104
|
+
4. **包含性校验**:Write/Edit 的 `file_path` 必须解析后位于项目根内——`realpathSync.native` 展开 Windows 8.3 短路径(词法 path.relative 会把项目内短路径误判为越界);**运行中**越界直接 deny(不进 guard——guard 侧 target=null 会跳过白名单判定 = fail-open);通过后传规范化长路径。
|
|
105
|
+
5. **代理身份分派(B1——dsh 子代理=执行者)**:读 `exec.agent.session.header.delegationDepth`(`agentDepth(exec)` 纯函数)——**>0 = 子代理(执行者)→ 跳过 guard 白名单判定直接 `next()` 放行**(子代理写源码是执行者职责,对应 Claude Code worktree 子代理物理自由写;形状 fail-closed 与项目根包含性校验已在上方对子代理同样执行,不因身份放宽);**0/缺失 = 协调者 → 走 guard 白名单判定**(协调者禁令物理拦截保留)。dsh 子代理系统在 dsh-base 自带(`tool-subagent`/`subagent-spawn-in-process` 等,headless/web/tui 全 profile 激活),`childSessionMeta` 写入 delegationDepth=parentDepth+1(dsh-subagent 源码锚定 rc.6);不识别此字段会导致 subagent 执行模式下子代理写源码被 guard 白名单(execute → `.specs/`)误拦(B1,DOGFOOD-REPORT 实证)。级 3 实测(2026-08-18 UAT-7):真实模型调 subagent → 子代理(delegationDepth:1)写 `scripts/` 放行、协调者(delegationDepth:0)写同路径被 deny 保留。
|
|
106
|
+
6. **判定调用**:`spawn node <项目根>/.dsh/skills/flow-comet/scripts/comet-hook-guard.mjs before_tool`,stdin JSON `{tool_name, tool_input}`;**spawn cwd 必须 = 会话项目根的长形态规范化(硬性)**(相对 file_path 按 cwd 解析,cwd≠项目根 = fail-open;8.3 短形态项目根若原样传入、而 file_path 已归一化为长形态时,guard 词法 path.relative 得 target=null → 白名单跳过 = fail-open——桥接修复已关闭,系统测试 K11 断言锁定;不得以设 env 替代 cwd);guard 文件缺失(安装未完成/被删除)→ WARN + `next()` 放行(不阻断非 flow-comet 语义);spawn 异常 → fail-closed deny + WARN。
|
|
107
|
+
7. **决策映射**:exit 0 → `next()` 放行;exit 2 → `{kind:'deny', reason}`(BLOCK 消息 + 恢复指引透传);其它/异常 → fail-closed deny + WARN。
|
|
108
|
+
- 协议文件:天然在项目内(skill 包 `reference/` 随树复制)——受保护读取满足,**无 FLOW_COMET_PROTOCOL 机制**。
|
|
109
|
+
- 明确不做(D6——旧完整插件功能废弃):不注册 `fs/write-intent` 槽位;不做 `fs/observed` 审计;不做技能注册/AGENTS.md 运行时注入(安装器职责)。
|
|
110
|
+
|
|
111
|
+
## 8. 验证记录模板
|
|
112
|
+
|
|
113
|
+
> 级 3 / 级 4 执行后按此模板回填;发布前逐项闭环(DESIGN 7.3)。
|
|
114
|
+
|
|
115
|
+
### 环境
|
|
116
|
+
|
|
117
|
+
- 日期:
|
|
118
|
+
- dsh 版本:
|
|
119
|
+
- prepare-env / 仓库版本:
|
|
120
|
+
- profile:
|
|
121
|
+
- 临时项目路径:
|
|
122
|
+
|
|
123
|
+
### 检查项(级 3 新形态命令——非旧插件冒烟形态)
|
|
124
|
+
|
|
125
|
+
| # | 检查 | 结果 | 证据(命令/输出摘要) |
|
|
126
|
+
|---|---|---|---|
|
|
127
|
+
| 1 | `prepare-env --platform dsh` 安装成功(skill 落 `.dsh/skills/flow-comet` + INSTALLED_VERSION + pathReplacements 生效) | | |
|
|
128
|
+
| 2 | 平台选择链:`--platform dsh` / `claude-code,dsh` / `all` / TTY 多选预勾选 / 未知平台报错 / `both` 已移除 | | |
|
|
129
|
+
| 3 | skill 可见断言:项目内 dsh 会话查询 `/flow-comet`(未安装项目不可见负向) | | |
|
|
130
|
+
| 4 | AGENTS.md 托管区注入 + 用户内容保留 + dsh 实际注入行为(R2 必测) | | |
|
|
131
|
+
| 5 | 桥接 loader 就位:`$DSH_HOME/plugins/` 文件 + `cordis.patch.yml` 托管块读-合并-写(dsh-skin 块保留断言) | | |
|
|
132
|
+
| 6 | 运行中越权 Write deny(PreToolDecision `{kind:'deny', reason}`)+ BLOCK 消息 + 恢复指引 | | |
|
|
133
|
+
| 7 | 合法写放行 | | |
|
|
134
|
+
| 8 | 非 flow-comet 项目 `next()` 负向(窄监听零拦截) | | |
|
|
135
|
+
| 9 | 参数形状不符 → fail-closed deny + WARN | | |
|
|
136
|
+
| 10 | 8.3 短路径包含性(realpath 展开——迁移复测) | | |
|
|
137
|
+
| 11 | spawn cwd = 会话项目根(负向:cwd≠项目根不可接受) | | |
|
|
138
|
+
| 12 | 协议文件随 skill 树(无 FLOW_COMET_PROTOCOL 机制) | | |
|
|
139
|
+
| 13 | purge 重置:删除后重新生成到完整安装态(skill 重新可见 / 托管区重新注入 / loader 重新挂载)/ 用户内容与 dsh-skin 块保留 | | |
|
|
140
|
+
| 14 | 多项目切换:A 项目装 B 项目不装——A 拦截 B 放行 | | |
|
|
141
|
+
| 15 | 幂等重装:重复安装结果一致(托管区/托管块读-合并-写幂等) | | |
|
|
142
|
+
|
|
143
|
+
### 结论
|
|
144
|
+
|
|
145
|
+
- 通过 / 不通过:
|
|
146
|
+
- 失败项与修复记录:
|
|
147
|
+
- 遗留风险:
|
|
148
|
+
|
|
149
|
+
|
|
150
|
+
### rc.8 三态冒烟(2026-08-20)
|
|
151
|
+
|
|
152
|
+
- 环境:dsh CLI 0.1.0-rc.8 / Harness 核心 rc.8 / dsh-tui 0.8.5
|
|
153
|
+
- 结果:运行中协调者项目外 Write → deny;运行中子代理项目内 Write → next();空闲态(无 state)项目外 Write → next();解析失败/未知 status → fail-closed deny(system-test 61/61 ALL PASSED,K11/K12 断言覆盖)
|
|
154
|
+
- 载体:prepare-env --platform dsh 经临时项目重推真实 ~/.dsh 桥接 loader,loader 与权威源 SHA-256 一致;真实交互式 TUI/Web 冒烟留待开放项
|
|
155
|
+
|
|
156
|
+
### 0.1.5-rc.1 全接缝认证(2026-09-10)
|
|
157
|
+
|
|
158
|
+
- 环境:dsh CLI 0.1.5-rc.1 / Node v24.14.1 / dsh-tui 0.10.0;headless profile;真实 `~/.dsh`(loader 与权威源逐字节一致)
|
|
159
|
+
- 方式:真实 headless 会话逐接缝运行时检测——每场景独立运行,证据取会话日志(`session.v3.jsonl` 解压)与文件系统双重判定;配套无 skill 目录负向载体
|
|
160
|
+
- 结果(全部通过):
|
|
161
|
+
- 运行中协调者写项目内白名单外 Write → deny(桥接消息 + guard 的 `BLOCKED: phase ... 允许范围: .specs/` 详情透传);写白名单内 → 放行
|
|
162
|
+
- 空闲态(无 state)项目内 Write → 放行;state 解析失败 → fail-closed deny(不视为空闲)
|
|
163
|
+
- 真实子代理(child session header `delegationDepth: 1`、`origin: subagent`)写源码 → 放行;子代理越界写 → 桥接包含性 deny(bridge 消息而非 sandbox 消息——证明子代理判定全程经过桥接,非未触发)
|
|
164
|
+
- `pwsh` 命令级写入 → deny(命令写入检测:`命令写入 ... 不在当前节点允许范围`)
|
|
165
|
+
- 窄监听负向(运行态 state 但无 `.dsh/skills/flow-comet` 的项目)→ 零拦截;项目级 skill 发现正常(flow-comet 全系可见)
|
|
166
|
+
- AGENTS.md 注入实证:dsh 将项目根 AGENTS.md 作为上下文注入(`Instructions from: AGENTS.md`),托管区内容被会话逐字引用
|
|
167
|
+
- 安装链:bridge-check 四项全绿(loader 存在 / 托管块 insert 形态 / `file://` 目标可达 / 无重复注册)
|
|
168
|
+
- 边界:认证面向 headless profile(自动化通道);dsh-tui / web 为静态证据(组合树含桥接行),交互式运行时留待日常使用或手动步骤清单;`str_replace_editor` 自 0.1.5-alpha.2 起为 opt-in(默认不挂载)
|
|
169
|
+
- 结论:桥接与 workflow-kernel 均无需修改(完整认证记录见维护者归档)
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
# 自动初始化检测(init 前置步骤)
|
|
2
|
+
|
|
3
|
+
> 每次 `init` 新 change 前,flow-comet 自动检测项目上下文状态,按需提示初始化;无需记忆任何独立命令。
|
|
4
|
+
|
|
5
|
+
## 触发与流程
|
|
6
|
+
|
|
7
|
+
```
|
|
8
|
+
workflow-state.mjs init <change-id> [--init-context | --init-skip]
|
|
9
|
+
│
|
|
10
|
+
├─ 自动检测(无参数时):探测项目上下文 → 判决 → 提示或静默
|
|
11
|
+
├─ --init-context:同意初始化——CONTEXT 缺失 → 输出 INIT-GENERATE 指引(agent 生成);
|
|
12
|
+
│ 生成后重跑 → 脚本校验 7 段 → INIT-DONE + 写 last_intel_scan;缺段 → INIT-VALIDATE-FAILED
|
|
13
|
+
├─ --init-skip:拒绝初始化——记录跳过,后续不再提示
|
|
14
|
+
└─ 原 init 行为(分支创建 / 状态写入)不变
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
## 判决表
|
|
18
|
+
|
|
19
|
+
| 情形 | 行为 |
|
|
20
|
+
|------|------|
|
|
21
|
+
| 已记录跳过(`--init-skip`,`ai_context_doc: none`) | 静默(沿用上次决策) |
|
|
22
|
+
| CONTEXT.md 已存在且扫描 ≤ 90 天 | 静默(零打扰) |
|
|
23
|
+
| CONTEXT.md 已存在但扫描 > 90 天 | 提示"可重跑刷新"(不强制) |
|
|
24
|
+
| 无 CONTEXT.md + 检测到既有 AI 文档(AGENTS.md / CLAUDE.md / .cursor / .windsurf / Copilot / Cline 等) | 提示(列出文档)→ 同意后:读取并整合既有文档(出处标注)+ 代码探测,生成 CONTEXT.md |
|
|
25
|
+
| 无 CONTEXT.md + 无既有文档 + 有代码上下文 | 提示 → 同意后:代码探测生成 CONTEXT.md |
|
|
26
|
+
| 新项目(无代码上下文) | 提示 → 同意后:生成骨架(占位随流程沉淀) |
|
|
27
|
+
|
|
28
|
+
## 初始化生成内容(脚本探测 + agent 生成协作)
|
|
29
|
+
|
|
30
|
+
- **职责拆分**:脚本只做确定性部分——探测 / 判决 / 提示 / 7 段结构校验 / `last_intel_scan` 写入;**生成由 agent 执行**(intel-scan 全量阅读语义,脚本不做智能整合)
|
|
31
|
+
- **生成流程**:`--init-context` 且 CONTEXT 缺失 → 脚本输出 `INIT-GENERATE` 指引(源文档列表 + 代码信号)→ agent 全量阅读既有文档与代码,生成 `.specs/CONTEXT.md` → 重跑 `init <id> --init-context` → 脚本校验 7 段 → 通过输出 `INIT-DONE` 并写 `last_intel_scan`;缺段输出 `INIT-VALIDATE-FAILED`(不写扫描时间,补全后重跑)
|
|
32
|
+
- `.specs/CONTEXT.md`:项目概要 / 技术栈 / 域语言 / 已锁决策 / 默认偏好 / 既有抽象索引 / intel-scan 元数据 七段(模板对齐)
|
|
33
|
+
- 既有文档整合(agent 执行):关键决策映射进对应段,出处标注 `来自 <文档>:<行号>`;文件顶部「源文档」段列出引用;**既有文档本身不改动**;既有 CONTEXT 的累积术语/决策在刷新时保留(跨 change 长期累积语义)
|
|
34
|
+
- 代码探测(agent 执行):依赖文件识别(package.json 等 → 技术栈)、常见目录探测(抽象索引)
|
|
35
|
+
- 成本:约 15-30k tokens(仅首次;提示中如实告知)
|
|
36
|
+
|
|
37
|
+
## 生成质量要求(agent 执行基准,2026-08-10 真实项目端到端验证沉淀)
|
|
38
|
+
|
|
39
|
+
> 脚本只校验「填没填」(7 段 + 模板格式存在级);「好不好」由以下质量清单把关(agent 生成时逐项自检,真实项目端到端验证实证:模板条目格式漏做会被用户抓出)。
|
|
40
|
+
|
|
41
|
+
1. **模板对照**:生成/重写前先读 `flow-kit/templates/CONTEXT.md`(未检测到时按 7 段基准)——段标题、条目格式、元数据字段与模板一致。
|
|
42
|
+
2. **条目格式**:已锁决策条目用模板格式 `- [YYYY-MM-DD] 决策内容 — 来自 @.specs/<change-id>/DESIGN.md`(新决策带日期;既有累积决策沿用原文日期);intel-scan 元数据含 `last_intel_scan` / `scanner` / `下次重扫建议` 三字段。
|
|
43
|
+
3. **累积保留**:既有 CONTEXT.md 的术语表、已锁决策、默认行为**全部保留**(跨 change 长期累积语义)——不能只保留关键词行或丢失表格行。
|
|
44
|
+
4. **出处标注**:整合自既有文档/既有 CONTEXT 的内容带 `来自 <doc>:<line>` 标注(文件顶部「源文档」段列出引用);**既有文档本身零写入**。
|
|
45
|
+
5. **技术栈真实**:代码探测结果如实反映项目(依赖文件/目录信号),不臆造栈卡片。
|
|
46
|
+
6. **生成后重跑校验**:写完 `.specs/CONTEXT.md` 后重跑 `init <change-id> --init-context`,脚本 7 段 + 格式校验通过(INIT-DONE)才算完成;校验失败按 `INIT-VALIDATE-FAILED` 列出的问题修正后重跑。
|
|
47
|
+
|
|
48
|
+
## 拒绝与记忆
|
|
49
|
+
|
|
50
|
+
- `--init-skip`:记录跳过(`ai_context_doc: none`),后续 init 不再提示
|
|
51
|
+
- `--init-context`:刷新扫描时间(90 天时效重新起算)
|
|
52
|
+
|
|
53
|
+
## 与既有机制的关系
|
|
54
|
+
|
|
55
|
+
- 不新增命令(init 的参数扩展);无参数行为 = 原行为 + 检测提示
|
|
56
|
+
- 已存在 CONTEXT.md 的项目(90 天内)完全静默,行为零变化
|
|
57
|
+
- 生成文件位于 `.specs/`(流程工件目录),既有文档零写入
|
|
58
|
+
- **空仓库(无提交)**:init 输出 `INIT EMPTY-REPO WARN`(分支创建不可行,跳过分支创建,纯文件模式继续;`BRANCH: none` 如实输出)——与上下文检测独立,属分支创建边界。无安装副本的仓库会先命中协议路径防御("workflow protocol file must stay inside the project root"),属预期防护
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# Workflow Recovery
|
|
2
|
+
|
|
3
|
+
> 正文为中文;结构标题保留协议英文概念名(workflow-run / overlay)便于与协议字段对应。
|
|
4
|
+
|
|
5
|
+
## 状态模型:workflow-run(主)
|
|
6
|
+
|
|
7
|
+
- State model: `workflow-run`(protocol `state.kind` 定义,flow-comet 实际使用)
|
|
8
|
+
- State path: `.flow-comet/flow-comet-state.json`(单文件 JSON,机器字段由脚本管理,绝不手改)
|
|
9
|
+
- Resume by reading the first incomplete Workflow Node(`completedNodes` 之后的第一个节点)
|
|
10
|
+
- 状态推导:从 `.specs/<change-id>/` 工件文件推导(file-as-truth),脚本状态只是加速器;状态文件缺失或与产物冲突时以产物为准
|
|
11
|
+
|
|
12
|
+
## 恢复指引(workflow-run)
|
|
13
|
+
|
|
14
|
+
- 未 entry 直接 exit 被拦(新 change BLOCKED):先 `workflow-guard.mjs entry <node>` 再重试 exit——entry 的进入检查(协调者禁令/委托前检查/签名记录)是节点进入前置,不可跳过
|
|
15
|
+
|
|
16
|
+
## Overlay 模型(comet 平台模型,仅 compose/平台集成场景)
|
|
17
|
+
|
|
18
|
+
- `comet-overlay`(`changes/*/.comet.yaml`)是 **comet 平台模型**,非 flow-comet 默认状态——hook 中以 `isCometOverlay(protocol)` 分支(`protocol.kind === 'comet-five-phase-overlay'`)识别并走 overlay 状态读取路径
|
|
19
|
+
- 适用场景:通过 comet 平台把 flow-comet 当作 five-phase overlay 挂载时(compose 自定义协议 / 平台集成);此时状态由 overlay 文件承载,恢复时读 overlay 状态 + 对应 change 的产物
|
|
20
|
+
- 默认协议(内置 8 节点)与绝大多数目标项目使用 workflow-run;两者不可互换——按实际加载的 protocol `state.kind` 选择恢复路径
|