flow-comet 1.6.2 → 1.6.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.
Files changed (43) 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 +260 -17
  12. package/.flow-comet/skills/flow-comet/scripts/guard-self-test.mjs +2714 -161
  13. package/.flow-comet/skills/flow-comet/scripts/route-node.mjs +51 -4
  14. package/.flow-comet/skills/flow-comet/scripts/state-schema.mjs +13 -0
  15. package/.flow-comet/skills/flow-comet/scripts/system-test.mjs +877 -10
  16. package/.flow-comet/skills/flow-comet/scripts/workflow-guard.mjs +52 -4
  17. package/.flow-comet/skills/flow-comet/scripts/workflow-handoff.mjs +111 -4
  18. package/.flow-comet/skills/flow-comet/scripts/workflow-state.mjs +108 -2
  19. package/.flow-comet/skills/flow-comet-archive/SKILL.md +10 -19
  20. package/.flow-comet/skills/flow-comet-change/SKILL.md +2 -3
  21. package/.flow-comet/skills/flow-comet-compose/SKILL.md +1 -1
  22. package/.flow-comet/skills/flow-comet-design/SKILL.md +6 -6
  23. package/.flow-comet/skills/flow-comet-execute/SKILL.md +58 -16
  24. package/.flow-comet/skills/flow-comet-integration/SKILL.md +8 -5
  25. package/.flow-comet/skills/flow-comet-open/SKILL.md +5 -1
  26. package/.flow-comet/skills/flow-comet-plan/GUIDANCE.md +1 -1
  27. package/.flow-comet/skills/flow-comet-plan/SKILL.md +8 -8
  28. package/.flow-comet/skills/flow-comet-review/SKILL.md +9 -12
  29. package/.flow-comet/skills/flow-comet-subagent-execute/SKILL.md +59 -16
  30. package/.flow-comet/skills/flow-comet-task/SKILL.md +3 -2
  31. package/.flow-comet/skills/flow-comet-ui-design/SKILL.md +3 -3
  32. package/.flow-comet/skills/flow-comet-verify/SKILL.md +8 -17
  33. package/README.md +4 -4
  34. package/package.json +1 -1
  35. package/scripts/dsh-bridge.mjs +59 -26
  36. package/scripts/prepare-env.mjs +165 -1
  37. package/.flow-comet/skills/flow-comet/reference/TEST-MATRIX.md +0 -116
  38. package/.flow-comet/skills/flow-comet/reference/composition-report.md +0 -65
  39. package/.flow-comet/skills/flow-comet/reference/dsh-platform.md +0 -184
  40. package/.flow-comet/skills/flow-comet/reference/resolved-skills.json +0 -661
  41. package/.flow-comet/skills/flow-comet/reference/skill-review.md +0 -13
  42. package/.flow-comet/skills/flow-comet/reference/subagents/script-author.md +0 -7
  43. package/.flow-comet/skills/flow-comet/reference/worktree-notes.md +0 -70
@@ -1,65 +0,0 @@
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
@@ -1,184 +0,0 @@
1
- # dsh 平台锚定参考(dsh-platform)
2
-
3
- > 维护者参考文档:dsh 平台适配的版本锚定、安装形态、API 签名、桥接 loader 契约与验证记录模板。
4
- > 权威依据:`@.specs/archive/2026-08-18-deepseek-harness-platform/DESIGN.md`(D1~D10 / 7.1 / 7.2 / 7.3)、`@.specs/archive/2026-08-18-deepseek-harness-platform/REQUIREMENT.md`(AC-1~AC-7)、`@.specs/adr/ADR-005-dsh-install-via-installer.md`。
5
- > dsh 为 dev-preview:本文件锚定认证版本(0.1.7-rc.2,2026-09-27 全接缝重认证;历史锚 0.1.0-rc.6 → 0.1.1-rc.2 → 0.1.5-rc.1);破坏性变更风险显式声明。
6
-
7
- ## 1. 版本锚定
8
-
9
- | 项 | 值 |
10
- |---|---|
11
- | 认证 dsh 版本 | `0.1.7-rc.2`(2026-09-27 全接缝重认证;历史锚 `0.1.0-rc.6` → `0.1.1-rc.2` → `0.1.5-rc.1`) |
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 包 | **自 `1.5.0-rc.3` 起已发布**(`npm i -g flow-comet` → `fcomet init`,dist-tag `latest`)——分发的为**安装器**,非 dsh 插件包;旧 npm 插件包安装形态已废弃(verify 阶段推翻,见 ADR-005) |
15
- | 破坏性变更 | dev-preview 中 `tools/pre-execute` 签名 / skill 发现 rank / `DSH_HOME` 语义可能变化;低于锚定版本时拦截/发现可能失效 |
16
-
17
- > 版本不匹配时拦截可能失效——必须文档警示 + 真实平台会话实测兜底(D9)。
18
-
19
- **bridge-check 版本比较语义(基础版本比较)**:桥接健康检查比较 loader 的 `// BRIDGE_VERSION:` 发布戳与技能包 `INSTALLED_VERSION` 时,两侧先剥离 git-describe 开发态后缀 `-<领先提交数>-g<hash>`、再按基础版本比较:
20
-
21
- - 开发态载体的 `INSTALLED_VERSION = <发布版本>-<N>-g<hash>` 是预期形态、不构成版本偏斜——与同基础版本的 loader 判健康(exit 0)。
22
- - 语义化预发布标识(如 `1.5.0-rc.3`)不是开发态后缀、不剥离——预发布与基础版本不可互相放行。
23
- - 归一后基础版本不同(含发布版对发布版)仍报「版本偏斜」并 exit 1;失配报告同时打印原始值与归一值,便于识别 dev 态后缀。
24
- - loader 戳生成与发布同步纪律不变(发布戳仍取当前发布版本,随发布同步更新)。
25
-
26
- ## 2. tools/pre-execute 签名
27
-
28
- ```js
29
- ctx.on('tools/pre-execute', async (exec, next) => {
30
- // exec: ToolExecution
31
- // { callId, name, arguments, signal, agent?, parent? }
32
- // 放行: return next();
33
- // 拒绝: return { kind: 'deny', reason: '…' };
34
- // 询问: return { kind: 'ask', reason? };
35
- });
36
- ```
37
-
38
- - PreToolDecision 形状:`{kind:'allow'}` | `{kind:'deny', reason}` | `{kind:'ask', reason?}`;deny 必须带 `kind` 字段。
39
- - 不调 `next()` 即否决(waterfall 事件——监听方不续传则工具被短路)。
40
- - 会话 cwd 锚定:`exec.agent.session.header.cwd`(逐会话;缺失时逐级回退 exec 上下文其它路径字段——见桥接 loader sessionCwd;Web UI 切换 workspace 时按会话判定,非进程 cwd)。
41
-
42
- ## 3. skill 发现(文件系统级——取代 provider 注册模型)
43
-
44
- - dsh skill 发现 rank 区间 100~500;**rank 100(最高)= `<项目根>/.dsh/skills`**(0.1.0-rc.6 源码核实)——目录存在于项目根下即自动发现(chokidar 热发现,免重启);未安装该目录的项目不可见该 skill → **天然项目级**(无运行时痕迹判定、无 chicken-and-egg)。
45
- - 项目根 = 会话 cwd 的最近 `.git` 祖先(`.git` 可为目录或文件——worktree/submodule 形态)。
46
- - 旧 provider 注册模型(`ctx.skills.registerProvider`)已废弃——skill 不再运行时注册,由文件系统发现 + 安装器物理安装(D3/D6)。
47
-
48
- ## 4. DSH_HOME 与 home patch
49
-
50
- - `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 行为一致(两态)。
51
- - **`DSH_` 前缀 bootstrap-only**:项目 `.env` 中设置 `DSH_HOME` 被直接拒绝——`.env` 方案不可行,文档明确不推荐(ADR-005 源码实证)。
52
- - `$DSH_HOME/cordis.patch.yml` 为 home 级 patch,对所有 profile 生效——dsh 加载链 `bundles → profile → home → overlays`(ADR-005 源码核实)。
53
- - flow-comet 托管块:`# --- flow-comet managed ---` … `# --- end flow-comet managed ---`,内容为 **insert 形态**(无 id 顶层 `- insert:` 条目内嵌插件行——追加到条目列表,而非覆盖既有条目):
54
-
55
- ```yaml
56
- # --- flow-comet managed ---
57
- - insert:
58
- - id: dsh-flow-comet-bridge
59
- name: 'file:///<loader 绝对路径>'
60
- # --- end flow-comet managed ---
61
- ```
62
-
63
- - **机制事实(为何必须 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 报错退出不覆盖。
64
-
65
- ## 5. fs/write-intent(single-slot 守卫瀑布)
66
-
67
- ```ts
68
- (target: FsTarget, actor: object | undefined, next) => FsWriteIntent | undefined
69
- ```
70
-
71
- - 决策形状:`{kind:'createIfAbsent'}` | `{kind:'replaceIfVersion', version}`——守卫,**无 deny 决策面**。
72
- - single-slot:first-wins by registration order。
73
- - **flow-comet 不注册该槽位**(避免 shadow 官方 `dsh-fs-observation-policy` 的 freshness 检查);拦截能力由 `tools/pre-execute` 全覆盖(D6)。
74
- - `fs/observed` 审计通道设计上不采用(v1 桥接 loader 极薄——D6;v2 可按需加)。
75
-
76
- ## 6. 安装 / 激活 / 重置(prepare-env 平台描述符——唯一入口)
77
-
78
- ### 安装
79
-
80
- - 正式:`node scripts/prepare-env.mjs --target <项目> --platform dsh`。
81
- - 多平台:`--platform claude-code,dsh`(逗号分隔,按参数顺序安装)/ `--platform all`(全部平台,按 PLATFORMS 表顺序:claude-code → codex → dsh);旧 `both` 已移除——`--platform both` 报错并提示用逗号列表或 all;未知平台报错(含逗号列表中的未知项——不得部分安装)。
82
- - 交互(缺省选择链):显式 `--platform` > TTY 交互多选 > 探测 > 默认 claude-code。TTY 多选 = @clack/prompts 方向键多选(可选依赖,未安装自动回退 readline 数字/逗号多选),按目标项目痕迹 `.claude/`/`.codex/`/`.dsh/` 预勾选,回车默认 = 探测推荐;无 TTY 探测:仅 `.codex/` → codex、仅 `.dsh/` → dsh、含 `.claude/` → claude-code、皆无 → 默认 claude-code;多痕迹(≥2 并存)不武断二选一——默认主平台 claude-code 并输出提示。
83
- - 安装动作(dsh 描述符):
84
- 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:// 引用),其余安装照常
85
- 2. `installRules`:AGENTS.md 托管区注入(`<!-- Managed by flow-comet prepare-env -->` … `<!-- /Managed by flow-comet prepare-env -->` 包裹编排规则全文;非破坏合并,保留托管区外用户内容;codex/dsh 共用标记——任一平台的移除流程均可清理该区)。
86
- 3. skills:复制权威源 `skills/flow-comet/**` → `<项目>/.dsh/skills/flow-comet/` + pathReplacements(包内命令路径 `.claude/skills/flow-comet/scripts/` → `.dsh/skills/flow-comet/scripts/`,仅 .md,幂等)+ INSTALLED_VERSION 版本标识。
87
-
88
- ### 激活(天然项目级)
89
-
90
- - 目录物理存在即激活——dsh 启动自动发现 `/flow-comet`(rank 100,chokidar 热发现免重启);未安装该目录的项目不可见(无痕迹判定、无 chicken-and-egg)。
91
- - dsh 对项目 AGENTS.md 的注入行为**已认证**(0.1.7-rc.2 headless 会话:项目根 AGENTS.md 作为上下文注入,托管区内容被会话逐字引用——见下方认证记录);**边界**:认证面向 headless profile,dsh-tui / web 运行时未验。
92
-
93
- ### 重置/重新生成(prepare-env --purge --yes——删除后重建,**不是卸载**)
94
-
95
- - `node scripts/prepare-env.mjs --target <项目> --purge --platform dsh --yes`:**先删除生成物、随后重新生成**(与 claude-code/codex 平台同一 main 模式):
96
- 1. 删 `<项目>/.dsh/skills/` 下全部 `flow-comet*` 条目(非 flow-comet 条目保留)+ 空 `.dsh` 目录(有内容保留)。
97
- 2. AGENTS.md 托管区移除(保留文件与用户内容)——重建流程随后重新注入新托管区(purge = 移除旧生成物后重建)。
98
- 3. `$DSH_HOME/cordis.patch.yml` 托管块移除(保留 dsh-skin 等既有块;移除后文件为空 → 删除文件本身)+ `$DSH_HOME/plugins/dsh-flow-comet-bridge.mjs` 删除——重建流程随后重新挂载 loader。
99
- - **重置 ≠ 卸载(安全面警示)**:purge 后 flow-comet **仍完整安装**——skill 重新生成、AGENTS.md 托管区重新注入、全局 loader 继续挂载(所有 profile 拦截恢复)。用户想「卸载」而执行 purge 会得到完整安装态,不是移除。
100
- - **真实卸载需手动**(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 的托管区/托管块之外的用户内容保留。
101
- - 多项目语义:每项目独立安装 skill(未安装项目不可见);loader 全局一份(按会话项目判定——与 claude-code 项目级 hook 等价);同一 loader 服务多个 flow-comet 项目。
102
-
103
- ## 7. 桥接 loader 契约($DSH_HOME/plugins/dsh-flow-comet-bridge.mjs)
104
-
105
- - 形态:dsh 官方插件形态——ESM 模块导出 `{ name: 'dsh-flow-comet-bridge', apply(ctx) }`,ctx 由 dsh 注入;纯 ESM 零第三方依赖;模块级幂等(同进程重复 apply 跳过已注册监听)。
106
- - 职责链:`tools/pre-execute` 监听 → 会话项目判定 → 参数映射 → 流程态门 → 包含性校验 → 子进程调项目本地 guard → 决策映射。
107
- 1. **窄监听(硬性契约)**:工具名归一化(非 Write/Edit/Bash 直接 `next()`);会话 cwd(`exec.agent.session.header.cwd` 锚定,缺失回退)的最近 `.git` 项目根下**存在 `.dsh/skills/flow-comet` 才处理**,否则直接 `next()`——非 flow-comet 项目零拦截零开销(D6/R7)。
108
- 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(不静默放行)。
109
- 3. **流程态门(B 方案——包含性仅运行中生效)**:读项目根 `.flow-comet/flow-comet-state.json`(UTF-8 BOM 容错;判定规则锚定 guard `comet-hook-guard.mjs` 的空闲态门——grep 锚点:`grep -n "if (!state.activeChange)"`):空闲(无 state / 无 `activeChange` / `status==='completed'`)→ 直接 `next()` 放行——跳过包含性校验与 guard 白名单(与 Claude Code / Codex 的 active-change 门语义对齐);解析失败 / 未知 status → WARN + fail-closed deny(不视为空闲放行);`activeChange` 存在且 `status==='running'` 或缺失(undefined)→ 继续下方包含性校验与 guard(现状不变)。
110
- - **空闲边界(refined)**:空闲 = 无 state / 无 activeChange / status==='completed' → 项目外写 next() 放行;解析失败 / 未知 status 保持 fail-closed deny(不视为空闲),与 Claude Code / Codex 的 guard 语义一致。
111
- 4. **包含性校验**:Write/Edit 的 `file_path` 必须解析后位于项目根内——`realpathSync.native` 展开 Windows 8.3 短路径(词法 path.relative 会把项目内短路径误判为越界);**运行中**越界直接 deny(不进 guard——guard 侧 target=null 会跳过白名单判定 = fail-open);通过后传规范化长路径。
112
- 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,项目内验证记录实证)。真实平台会话实测(2026-08-18):真实模型调 subagent → 子代理(delegationDepth:1)写 `scripts/` 放行、协调者(delegationDepth:0)写同路径被 deny 保留。
113
- 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。
114
- 7. **决策映射**:exit 0 → `next()` 放行;exit 2 → `{kind:'deny', reason}`(BLOCK 消息 + 恢复指引透传);其它/异常 → fail-closed deny + WARN。
115
- - 协议文件:天然在项目内(skill 包 `reference/` 随树复制)——受保护读取满足,**无 FLOW_COMET_PROTOCOL 机制**。
116
- - 明确不做(D6——旧完整插件功能废弃):不注册 `fs/write-intent` 槽位;不做 `fs/observed` 审计;不做技能注册/AGENTS.md 运行时注入(安装器职责)。
117
-
118
- ## 8. 验证记录模板
119
-
120
- > 实测执行后按此模板回填;发布前逐项闭环(DESIGN 7.3)。
121
-
122
- ### 环境
123
-
124
- - 日期:
125
- - dsh 版本:
126
- - prepare-env / 仓库版本:
127
- - profile:
128
- - 临时项目路径:
129
-
130
- ### 检查项(新形态命令——非旧插件冒烟形态)
131
-
132
- | # | 检查 | 结果 | 证据(命令/输出摘要) |
133
- |---|---|---|---|
134
- | 1 | `prepare-env --platform dsh` 安装成功(skill 落 `.dsh/skills/flow-comet` + INSTALLED_VERSION + pathReplacements 生效) | | |
135
- | 2 | 平台选择链:`--platform dsh` / `claude-code,dsh` / `all` / TTY 多选预勾选 / 未知平台报错 / `both` 已移除 | | |
136
- | 3 | skill 可见断言:项目内 dsh 会话查询 `/flow-comet`(未安装项目不可见负向) | | |
137
- | 4 | AGENTS.md 托管区注入 + 用户内容保留 + dsh 实际注入行为(R2 必测) | | |
138
- | 5 | 桥接 loader 就位:`$DSH_HOME/plugins/` 文件 + `cordis.patch.yml` 托管块读-合并-写(dsh-skin 块保留断言) | | |
139
- | 6 | 运行中越权 Write deny(PreToolDecision `{kind:'deny', reason}`)+ BLOCK 消息 + 恢复指引 | | |
140
- | 7 | 合法写放行 | | |
141
- | 8 | 非 flow-comet 项目 `next()` 负向(窄监听零拦截) | | |
142
- | 9 | 参数形状不符 → fail-closed deny + WARN | | |
143
- | 10 | 8.3 短路径包含性(realpath 展开——迁移复测) | | |
144
- | 11 | spawn cwd = 会话项目根(负向:cwd≠项目根不可接受) | | |
145
- | 12 | 协议文件随 skill 树(无 FLOW_COMET_PROTOCOL 机制) | | |
146
- | 13 | purge 重置:删除后重新生成到完整安装态(skill 重新可见 / 托管区重新注入 / loader 重新挂载)/ 用户内容与 dsh-skin 块保留 | | |
147
- | 14 | 多项目切换:A 项目装 B 项目不装——A 拦截 B 放行 | | |
148
- | 15 | 幂等重装:重复安装结果一致(托管区/托管块读-合并-写幂等) | | |
149
-
150
- ### 结论
151
-
152
- - 通过 / 不通过:
153
- - 失败项与修复记录:
154
- - 遗留风险:
155
-
156
-
157
- ### rc.8 三态冒烟(2026-08-20)(历史)
158
-
159
- - 环境:dsh CLI 0.1.0-rc.8 / Harness 核心 rc.8 / dsh-tui 0.8.5
160
- - 结果:运行中协调者项目外 Write → deny;运行中子代理项目内 Write → next();空闲态(无 state)项目外 Write → next();解析失败/未知 status → fail-closed deny(当轮 system-test ALL PASSED,K11/K12 断言覆盖;当轮基线 82 项(历史))。**记录口径**:历史实测基线保留原始数字并在行内标注(历史)——历史数字是证据,删除不是修法(带标记即被计数过期判据豁免);指针语(「以套件自身输出为准」)只用于当前值。
161
- - 载体:prepare-env --platform dsh 经临时项目重推真实 ~/.dsh 桥接 loader,loader 与权威源 SHA-256 一致;真实交互式 TUI/Web 冒烟留待开放项
162
-
163
- ### 0.1.5-rc.1 全接缝认证(2026-09-10)(历史)
164
-
165
- - 环境:dsh CLI 0.1.5-rc.1 / Node v24.14.1 / dsh-tui 0.10.0;headless profile;真实 `~/.dsh`(loader 与权威源逐字节一致)
166
- - 方式:真实 headless 会话逐接缝运行时检测——每场景独立运行,证据取会话日志(`session.v3.jsonl` 解压)与文件系统双重判定;配套无 skill 目录负向载体
167
- - 结果(全部通过):
168
- - 运行中协调者写项目内白名单外 Write → deny(桥接消息 + guard 的 `BLOCKED: phase ... 允许范围: .specs/` 详情透传);写白名单内 → 放行
169
- - 空闲态(无 state)项目内 Write → 放行;state 解析失败 → fail-closed deny(不视为空闲)
170
- - 真实子代理(child session header `delegationDepth: 1`、`origin: subagent`)写源码 → 放行;子代理越界写 → 桥接包含性 deny(bridge 消息而非 sandbox 消息——证明子代理判定全程经过桥接,非未触发)
171
- - `pwsh` 命令级写入 → deny(命令写入检测:`命令写入 ... 不在当前节点允许范围`)
172
- - 窄监听负向(运行态 state 但无 `.dsh/skills/flow-comet` 的项目)→ 零拦截;项目级 skill 发现正常(flow-comet 全系可见)
173
- - AGENTS.md 注入实证:dsh 将项目根 AGENTS.md 作为上下文注入(`Instructions from: AGENTS.md`),托管区内容被会话逐字引用
174
- - 安装链:bridge-check 四项全绿(loader 存在 / 托管块 insert 形态 / `file://` 目标可达 / 无重复注册)
175
- - 边界:认证面向 headless profile(自动化通道);dsh-tui / web 为静态证据(组合树含桥接行),交互式运行时留待日常使用或手动步骤清单;`str_replace_editor` 自 0.1.5-alpha.2 起为 opt-in(默认不挂载)
176
- - 结论:桥接与 workflow-kernel 均无需修改(完整认证记录见维护者归档)
177
-
178
- ### 0.1.7-rc.2 全接缝重认证(2026-09-27)
179
-
180
- - 版本线(历史锚):`0.1.0-rc.6` → `0.1.1-rc.2` → `0.1.5-rc.1` → `0.1.7-rc.2`(当前认证锚)
181
- - 环境:dsh CLI `0.1.7-rc.2`;headless profile;真实 `~/.dsh`
182
- - 结果:各接缝重认证通过
183
- - 结论:桥接与 workflow-kernel 均无需修改
184
- - 持续锚:`system-test` K9~K13 覆盖核心行为(loader 源文件与托管块注入 / 纯函数与身份分派 / 流程态门 / hook 注入形态与幂等升级)——后续版本升级以该套件持续回归为准