Compare commits
No commits in common. "master" and "feat/agent-client-parity-p8e" have entirely different histories.
master
...
feat/agent
@ -1,42 +0,0 @@
|
|||||||
# 意图目录
|
|
||||||
> catalog_version: 2.0 | 前言 → path:AGENTS.md#项目定位 | 语法 → path:docs/ai-context/intent-catalog-guide.md
|
|
||||||
|
|
||||||
## 书签
|
|
||||||
- 当前 → path:docs/tasks/2026-10-03-coordination.md#0. 方针与本阶段终点
|
|
||||||
|
|
||||||
## INT-01 一键接入三端可用
|
|
||||||
- rev: 1.0
|
|
||||||
- 意图: 新建或添加子项目后一次确认,即可在 Claude Code、Codex、DSH 三端开工
|
|
||||||
- 人看: 三端桌面 GUI 新开会话即能调用炼境工具,无需手工配置
|
|
||||||
- 机器: card:agent-client-parity#P8;card:agent-client-parity#P8g
|
|
||||||
- 不做: 不替 agent 选模型;不让子项目依赖炼境在线;不改写客户端的信任表
|
|
||||||
- 墙: W12,W13
|
|
||||||
|
|
||||||
## INT-02 意图编译为可判定终点
|
|
||||||
- rev: 1.0
|
|
||||||
- 意图: 人给出意图或模糊轮廓,agent 编译出可判定的 /goal:定型章编交付终点,探索章编每轮试验终点,人粘贴即确认
|
|
||||||
- 人看: 定型章粘贴 /goal 后一次判对;探索章在预算内收敛为定型章
|
|
||||||
- 机器: card:intent-catalog#IC5;card:intent-catalog#IC13
|
|
||||||
- 不做: 炼境不编译 goal、不判定完成;目录不存状态与进度
|
|
||||||
- 假设: card:intent-catalog#IC13
|
|
||||||
- 墙: W1,W4,W7
|
|
||||||
|
|
||||||
## INT-03 摩擦驱动沉淀与退出
|
|
||||||
- rev: 1.0
|
|
||||||
- 意图: agent 反复摩擦之处经准入沉淀为跨 agent 能力,实测无收益就撤销
|
|
||||||
- 人看: 每条使者回传都有处置回执,撤销的能力在决策记录里查得到理由
|
|
||||||
- 机器: module:governance-feedback-loop;cmd:list_envoy_returns
|
|
||||||
- 不做: 不替 agent 思考或调度;不接管子项目自有事实;不因已经做了而保留
|
|
||||||
- 墙: W11,W14
|
|
||||||
|
|
||||||
## INT-04 MVP 收口
|
|
||||||
- rev: 2.0
|
|
||||||
- 意图: agent 拿到子项目即能开工、能自验、能交付,摩擦能闭环回传;四条都可用后再谈扩展
|
|
||||||
- 人看: 在 enterprise-system 真实开发中,agent 能开工、自验、交付,摩擦能回传;常驻文档与代码一致
|
|
||||||
- 机器: module:mvp-closure;path:docs/tasks/2026-10-03-coordination.md#0. 方针与本阶段终点
|
|
||||||
- 不做: 不开新能力;冻结的扩展项不派单;不改子项目业务规则与凭据
|
|
||||||
- 墙: W2,W3,W14
|
|
||||||
|
|
||||||
## 附录
|
|
||||||
- 承重墙 → path:.blueprint/modules/intent-catalog.md#承重墙
|
|
||||||
- 决策与否决 → 各模块「决策记录」;终验否决理由 → 卡上 `- 终验:` 行
|
|
||||||
@ -6,7 +6,7 @@ description: >
|
|||||||
项目自身保留业务规则、测试、部署声明与交付决策。炼境本身亦被纳入其中,
|
项目自身保留业务规则、测试、部署声明与交付决策。炼境本身亦被纳入其中,
|
||||||
形成可自我进化的开发智能闭环。
|
形成可自我进化的开发智能闭环。
|
||||||
iteration: 1
|
iteration: 1
|
||||||
updated: 2026-10-04
|
updated: 2026-10-03
|
||||||
agent_button_carrier: tauri
|
agent_button_carrier: tauri
|
||||||
|
|
||||||
|
|
||||||
@ -258,9 +258,7 @@ modules:
|
|||||||
name: 蓝图 Buff
|
name: 蓝图 Buff
|
||||||
area: backend
|
area: backend
|
||||||
status: in_progress
|
status: in_progress
|
||||||
progress: 90
|
progress: 86
|
||||||
updated: 2026-10-04
|
|
||||||
note: "8 张卡全 ✅;B2 终验 2026-10-04 被否决(只改共用文档的提交仍误标无关 📋 卡,实例 IC10),剩余缺口为方案 C(files 重叠改记 DB 信号),MVP 收口期冻结为扩展。"
|
|
||||||
position: [2250, 0]
|
position: [2250, 0]
|
||||||
|
|
||||||
- id: claude-autonomy-config
|
- id: claude-autonomy-config
|
||||||
@ -513,9 +511,9 @@ modules:
|
|||||||
name: 三端客户端对等
|
name: 三端客户端对等
|
||||||
area: infra
|
area: infra
|
||||||
status: in_progress
|
status: in_progress
|
||||||
progress: 78
|
progress: 61
|
||||||
updated: 2026-10-04
|
updated: 2026-10-03
|
||||||
note: "P1/P2/P3/P3b/P7/P9/P10 完成:三端(Claude Code、Codex 含 Desktop、DSH 含桌面 GUI)在 Enterprise 经 %USERPROFILE%\\.lian-jing 稳定入口连项目专用地址,人终验通过。Claude 条目经 claude CLI 写入、以 claude mcp get 为准;DSH 由托管块全局行(headless)+ 会话级插件(GUI/web/acp 按会话工作目录)路由;接入写入幂等;接入包改写块外带未提交改动的托管块文件时给出混合文件预警;P7 实测 MCP 服务器说明仅 Claude/DSH 带入模型上下文、Codex 不带,引导提示保留在 skill。2026-10-03 P8 一键接入设计定稿(docs/tasks/2026-10-03-p8-onboarding-oneclick-design.md):A1 不前置;P4 分 L0 静态 / L1 零模型 / L3 无头会话,P8 只依赖 L1(P4a);拆为 P8-0、P8a–P8g 与 P4-0、P4a–P4e(P8-0、P8a、P4-0 已完成,P8b 适配器注册表与三端结构化注入结果(PR #33,enterprise 实测两次注入三端 converged、零写入)、P8c 写入汇与写入前计划(PR #36)、P4a L1 零模型三端检查(PR #38,enterprise 三端 18 格 ready)、P8d 编排本体(PR #39)、P8e 投影(PR #40)、P8f register_project(PR #37)、P8g UI 一键接入面板(PR #41,2026-10-04)已完成,P8 一键接入整卡 ✅(2026-10-04 用户终验:UI 新建→预览→确认 7.7 秒 done,三端 L1 18 格 ready,三端桌面会话调通),端到端:新登记项目 plan→onboard_project done、重复执行全收敛;P8a 把「已接入」统一为有项目 token;P4-0 实测六项假设,Codex 只在目录受信任时加载项目配置、Claude 用无效模型名可零额度取 init 并入 L1),P8 进行中;进度按拆分后卡数重算。待做 P5、P6(基于 P8c 的 WriteSink)。"
|
note: "P1/P2/P3/P3b/P7/P9/P10 完成:三端(Claude Code、Codex 含 Desktop、DSH 含桌面 GUI)在 Enterprise 经 %USERPROFILE%\\.lian-jing 稳定入口连项目专用地址,人终验通过。Claude 条目经 claude CLI 写入、以 claude mcp get 为准;DSH 由托管块全局行(headless)+ 会话级插件(GUI/web/acp 按会话工作目录)路由;接入写入幂等;接入包改写块外带未提交改动的托管块文件时给出混合文件预警;P7 实测 MCP 服务器说明仅 Claude/DSH 带入模型上下文、Codex 不带,引导提示保留在 skill。2026-10-03 P8 一键接入设计定稿(docs/tasks/2026-10-03-p8-onboarding-oneclick-design.md):A1 不前置;P4 分 L0 静态 / L1 零模型 / L3 无头会话,P8 只依赖 L1(P4a);拆为 P8-0、P8a–P8g 与 P4-0、P4a–P4e(P8-0、P8a、P4-0 已完成,P8b 适配器注册表与三端结构化注入结果(PR #33,enterprise 实测两次注入三端 converged、零写入)、P8c 写入汇与写入前计划(PR #36)、P4a L1 零模型三端检查(PR #38,enterprise 三端 18 格 ready)、P8d 编排本体(PR #39)已完成,P8f 已合并待链路实测;P8a 把「已接入」统一为有项目 token;P4-0 实测六项假设,Codex 只在目录受信任时加载项目配置、Claude 用无效模型名可零额度取 init 并入 L1),P8 进行中;进度按拆分后卡数重算。待做 P5、P6(基于 P8c 的 WriteSink)。"
|
||||||
position: [3500, 950]
|
position: [3500, 950]
|
||||||
|
|
||||||
- id: architecture-evolution
|
- id: architecture-evolution
|
||||||
@ -527,24 +525,6 @@ modules:
|
|||||||
note: "技术栈评估:Tauri v2 + Rust + React/TS 适合管家方针,不换栈。按收益排序的结构改进:A1 本体与投影分离(2026-10-03 改写为三段——A1a 随 agent-client-parity P8b 落地的投影无关适应度测试、A1b 按需 CLI 薄客户端、A1c 触发式拆 core crate;P4/P8 不再依赖拆 crate)、A2 前后端类型契约生成、A3 配置文本模板化、A4 MCP 改用官方 rmcp SDK(P4b 轨迹环排在其后)。"
|
note: "技术栈评估:Tauri v2 + Rust + React/TS 适合管家方针,不换栈。按收益排序的结构改进:A1 本体与投影分离(2026-10-03 改写为三段——A1a 随 agent-client-parity P8b 落地的投影无关适应度测试、A1b 按需 CLI 薄客户端、A1c 触发式拆 core crate;P4/P8 不再依赖拆 crate)、A2 前后端类型契约生成、A3 配置文本模板化、A4 MCP 改用官方 rmcp SDK(P4b 轨迹环排在其后)。"
|
||||||
position: [3750, 950]
|
position: [3750, 950]
|
||||||
|
|
||||||
- id: intent-catalog
|
|
||||||
name: 意图目录
|
|
||||||
area: backend
|
|
||||||
status: in_progress
|
|
||||||
progress: 31
|
|
||||||
updated: 2026-10-04
|
|
||||||
note: "两层模型(人持有的意图目录 .blueprint/catalog.md + 蓝图正文),书装意图、指向事实;卡侧 intent 钉版,agent 编译可判定 /goal,确认卡兼作最小任务简报,回执写进提交。IC1 设计已确认(最小文件优先方案);IC2–IC4 只新增文档、可与 P8 并行,门控与接线等 P8 收口后做,IC13 按实测数据决定去留。"
|
|
||||||
position: [4000, 950]
|
|
||||||
|
|
||||||
- id: mvp-closure
|
|
||||||
name: MVP 收口
|
|
||||||
area: infra
|
|
||||||
status: in_progress
|
|
||||||
progress: 75
|
|
||||||
updated: 2026-10-04
|
|
||||||
note: "2026-10-04 P8 达成后的阶段终点(INT-04):炼境侧关账、清理、修常驻文档漂移(M2–M4,编进 /goal),四条能力在 enterprise-system 真实开发中只读取证(M5);扩展项冻结见统筹文档 §3。"
|
|
||||||
position: [4250, 950]
|
|
||||||
|
|
||||||
edges:
|
edges:
|
||||||
- from: project-resource-broker
|
- from: project-resource-broker
|
||||||
to: project-dev-variables
|
to: project-dev-variables
|
||||||
@ -887,13 +867,3 @@ edges:
|
|||||||
- from: architecture-evolution
|
- from: architecture-evolution
|
||||||
to: agent-client-parity
|
to: agent-client-parity
|
||||||
type: dependency
|
type: dependency
|
||||||
# 意图目录:安全派发与状态语义收敛(blueprint-governance 前置)、版本化 pack 机制在先;修订历史与否决理由回流复用治理反馈闭环。
|
|
||||||
- from: blueprint-governance
|
|
||||||
to: intent-catalog
|
|
||||||
type: dependency
|
|
||||||
- from: agent-client-capability-packs
|
|
||||||
to: intent-catalog
|
|
||||||
type: dependency
|
|
||||||
- from: governance-feedback-loop
|
|
||||||
to: intent-catalog
|
|
||||||
type: related
|
|
||||||
|
|||||||
@ -213,9 +213,8 @@ skill 只是五个接入面之一,兼容层覆盖全部五面。
|
|||||||
- known_limits: "Claude 与 DSH 只验了无头模式,Claude 只用了 sonnet-4-6;Codex 未验 TUI 与桌面版(桌面版可能走 app-server 路径,结论可能不同),也未验 SSE 传输。探针用的是桩服务的中英混合短说明,未用炼境真实说明(中文 238 字、UTF-8 500 字节,远低于 DSH 默认上限 32768 字节)实测。Codex 后续版本若开始带入服务器说明,按「检测行为而非嗅探版本」重跑本探针(P4 固化后纳入矩阵),三端都支持时再迁移。现有服务器说明五条要点中,「先读状态」「canonical project_id」「开发变量先查后登记」在 skill 有对应条目;「其他写操作须用户明确确认」与「unavailable/unknown 不得当作成功」在 skill 与 AGENTS.md 中只有分场景表述(合并 PR、CI workflow、工具链安装;MCP 不可用时不伪造诊断),Codex 会话只能从这些条目与工具描述获知——是否补成通用条目留待下次改 skill 时一并处理(需升接入包版本),本卡不改。
|
- known_limits: "Claude 与 DSH 只验了无头模式,Claude 只用了 sonnet-4-6;Codex 未验 TUI 与桌面版(桌面版可能走 app-server 路径,结论可能不同),也未验 SSE 传输。探针用的是桩服务的中英混合短说明,未用炼境真实说明(中文 238 字、UTF-8 500 字节,远低于 DSH 默认上限 32768 字节)实测。Codex 后续版本若开始带入服务器说明,按「检测行为而非嗅探版本」重跑本探针(P4 固化后纳入矩阵),三端都支持时再迁移。现有服务器说明五条要点中,「先读状态」「canonical project_id」「开发变量先查后登记」在 skill 有对应条目;「其他写操作须用户明确确认」与「unavailable/unknown 不得当作成功」在 skill 与 AGENTS.md 中只有分场景表述(合并 PR、CI workflow、工具链安装;MCP 不可用时不伪造诊断),Codex 会话只能从这些条目与工具描述获知——是否补成通用条目留待下次改 skill 时一并处理(需升接入包版本),本卡不改。
|
||||||
已补齐(2026-10-03,分支 feat/agent-client-parity-p7-skill-rules):两条已作为通用边界写进 lian-jing skill 模板开头(双投影到 .agents 与 .claude),两条规则的核心句与服务器说明逐字一致;只读查询、登记开发需求元数据与回传炼境明确列为无需确认的例外,与服务器说明的「其他写操作」及 skill「回传不必逐条征得同意」相容。服务器说明的例外是泛称「不含秘密的开发需求元数据」,skill 例外括注同时列出两个登记工具 register_project_test_account 与 register_project_dev_variable(审查修复:初版只列前者,会把开发变量登记误归入须确认的写操作);同批修正 skill 第 8 条——开发变量改用 register_project_dev_variable 登记名称与用途,测试账号仍用 register_project_test_account(初版两者都指向后者)。接入包 base-onboarding 1.7.0→1.8.0(修复在 1.8.0 发布前,未再升版本,只更新指纹);mcp_server 新增 server_instruction_universal_rules_are_in_skill,服务器说明与 skill 任一侧缺这两条即失败,skill 例外行缺任一登记工具也失败。AGENTS.md 托管块未改,仍只有分场景表述;存量项目需重建安装炼境后重跑 apply_onboarding_pack 才拿到新 skill。"
|
已补齐(2026-10-03,分支 feat/agent-client-parity-p7-skill-rules):两条已作为通用边界写进 lian-jing skill 模板开头(双投影到 .agents 与 .claude),两条规则的核心句与服务器说明逐字一致;只读查询、登记开发需求元数据与回传炼境明确列为无需确认的例外,与服务器说明的「其他写操作」及 skill「回传不必逐条征得同意」相容。服务器说明的例外是泛称「不含秘密的开发需求元数据」,skill 例外括注同时列出两个登记工具 register_project_test_account 与 register_project_dev_variable(审查修复:初版只列前者,会把开发变量登记误归入须确认的写操作);同批修正 skill 第 8 条——开发变量改用 register_project_dev_variable 登记名称与用途,测试账号仍用 register_project_test_account(初版两者都指向后者)。接入包 base-onboarding 1.7.0→1.8.0(修复在 1.8.0 发布前,未再升版本,只更新指纹);mcp_server 新增 server_instruction_universal_rules_are_in_skill,服务器说明与 skill 任一侧缺这两条即失败,skill 例外行缺任一登记工具也失败。AGENTS.md 托管块未改,仍只有分场景表述;存量项目需重建安装炼境后重跑 apply_onboarding_pack 才拿到新 skill。"
|
||||||
|
|
||||||
### ✅ P8 — 一键接入:创建/添加子项目即完成三端可用
|
### 🔵 P8 — 一键接入:创建/添加子项目即完成三端可用
|
||||||
- status: done
|
- status: in_progress
|
||||||
- done_verify: "2026-10-04:子卡 P8-0、P8a–P8g 全部 ✅;agent_verify 见 e2e_verify 与各子卡 merge_verify(master 3228b49 全量 cargo test 414 passed、vitest 29 passed);human_verify 由用户在 P8g 终验中完成(UI 新建→预览→确认 7.7 秒 done,Codex 信任后三端 L1 18 格 ready,Claude Code / Codex / DSH 桌面 GUI 新会话调 LJ_PROBE_NONEXISTENT 均得「开发需求未登记」),证据见 P8g human_verify。"
|
|
||||||
- complexity: L(2026-10-03 设计评审后拆为 P8-0、P8a–P8g,均为 S/M)
|
- complexity: L(2026-10-03 设计评审后拆为 P8-0、P8a–P8g,均为 S/M)
|
||||||
- depends: P4a(原为 P4;P8 只依赖 L1 零模型检查,不等 L3)
|
- depends: P4a(原为 P4;P8 只依赖 L1 零模型检查,不等 L3)
|
||||||
- acceptance: "agent_verify: [Tauri command / MCP] 对新登记项目 plan_onboarding → 用户确认 → onboard_project(expected_digest, confirmed=true),依次完成 canonical context、接入包分发(规则、skill 双投影、Codex 托管块)、本机三端注册(Claude local、DSH 白名单与会话插件、shim、token),并以 L1 零模型三端矩阵(每格带证据等级)验收,附最近一次 L3 结果及是否过期;重复执行收敛(全部 converged、文件 mtime 不变);接入包对项目文件的改动只报告 diff、不自动提交。human_verify: 在 Claude Code、Codex、DSH 桌面 GUI 各新开会话调 read_project_test_account(name=LJ_PROBE_NONEXISTENT),得「开发需求未登记」。"
|
- acceptance: "agent_verify: [Tauri command / MCP] 对新登记项目 plan_onboarding → 用户确认 → onboard_project(expected_digest, confirmed=true),依次完成 canonical context、接入包分发(规则、skill 双投影、Codex 托管块)、本机三端注册(Claude local、DSH 白名单与会话插件、shim、token),并以 L1 零模型三端矩阵(每格带证据等级)验收,附最近一次 L3 结果及是否过期;重复执行收敛(全部 converged、文件 mtime 不变);接入包对项目文件的改动只报告 diff、不自动提交。human_verify: 在 Claude Code、Codex、DSH 桌面 GUI 各新开会话调 read_project_test_account(name=LJ_PROBE_NONEXISTENT),得「开发需求未登记」。"
|
||||||
@ -225,7 +224,6 @@ skill 只是五个接入面之一,兼容层覆盖全部五面。
|
|||||||
- 决策(Q2–Q11 均采纳推荐项):写入前预览走 plan → digest 确认 → apply;bypassPermissions 默认值保持现状但在 plan 与报告中单列、可按项目取消;Codex 信任列入 next_actions,炼境不写 ~/.codex 信任表;L3 只在显式触发时跑,建议在 canary(enterprise)项目、指纹变化时跑;做 register_project 的全局路由投影;A4 先于 P4b;CLI 只做 pnpm probe:clients 薄脚本;A1 改写为三段;探针默认用各客户端默认模型。
|
- 决策(Q2–Q11 均采纳推荐项):写入前预览走 plan → digest 确认 → apply;bypassPermissions 默认值保持现状但在 plan 与报告中单列、可按项目取消;Codex 信任列入 next_actions,炼境不写 ~/.codex 信任表;L3 只在显式触发时跑,建议在 canary(enterprise)项目、指纹变化时跑;做 register_project 的全局路由投影;A4 先于 P4b;CLI 只做 pnpm probe:clients 薄脚本;A1 改写为三段;探针默认用各客户端默认模型。
|
||||||
- 非目标:不自动 commit/push;不自动建 Gitea 仓库、webhook、CI,不自动装工具链(只列 next_actions,Gitea 一项注明「工具默认建公开仓库」);不改客户端全局安全设置,不覆盖手写同名 MCP 配置;L3 不作接入门槛、不作 CI 闸门;不做离线 CLI 写入,不拆 core crate;P8 不改接入包模板;批量登记不自动接入。
|
- 非目标:不自动 commit/push;不自动建 Gitea 仓库、webhook、CI,不自动装工具链(只列 next_actions,Gitea 一项注明「工具默认建公开仓库」);不改客户端全局安全设置,不覆盖手写同名 MCP 配置;L3 不作接入门槛、不作 CI 闸门;不做离线 CLI 写入,不拆 core crate;P8 不改接入包模板;批量登记不自动接入。
|
||||||
- 为什么:2026-10-01 Enterprise 验收时,接入散落在 inject_mcp、apply_onboarding_pack、verify_onboarding 与手工探针多个步骤。按「分发 vs 查询」:随仓库走的文件由炼境分发一次、按版本升级;与机器相关的客户端注册由炼境在本机维护、不进仓库;易变信息走 MCP 查询。默认三端都接入(成本小,保留随时换客户端的能力);能用标准的不做专门适配(Codex、DSH 原生读 AGENTS.md 与 .agents/skills,只有 Claude 需要 CLAUDE.md 与 .claude/skills 投影);炼境离线时规则与 skill 仍可用。
|
- 为什么:2026-10-01 Enterprise 验收时,接入散落在 inject_mcp、apply_onboarding_pack、verify_onboarding 与手工探针多个步骤。按「分发 vs 查询」:随仓库走的文件由炼境分发一次、按版本升级;与机器相关的客户端注册由炼境在本机维护、不进仓库;易变信息走 MCP 查询。默认三端都接入(成本小,保留随时换客户端的能力);能用标准的不做专门适配(Codex、DSH 原生读 AGENTS.md 与 .agents/skills,只有 Claude 需要 CLAUDE.md 与 .claude/skills 投影);炼境离线时规则与 skill 仍可用。
|
||||||
- e2e_verify: "2026-10-03 22:5x 统筹会话端到端(炼境 d7f4816 重编译后经全局 MCP):新建临时 git 仓库 E:code-projectlj-p8-e2e-20261003 → register_project 得 project_id=ac73a4bb-a601-4e21-bc0f-7eda71fae4aa(目录落库为规范反斜杠形式;换大小写/正斜杠/尾分隔符再登记被拒并给出已有 ID)→ plan_onboarding:文件 create 14、本机 token/claude/codex/dsh/product_group_buff/git_hooks=apply、shim=noop、阻断 0、bypass_permissions=true、codex_trust=untrusted(进 next_actions)→ onboard_project(expected_digest=bb60bf69…, confirmed=true) 7.9 s:status=done,9 步全收敛,completion 全 ready(AGENTS/git-workflow 管理块最新、身份、能力包 1.9.0、两份 skill、Codex MCP 块、lefthook 挂载与检查段、Claude local、Codex 托管块、DSH 白名单、L1 适用格、改动可报告、HEAD 不变),L1:Claude 2.1.90 与 DSH 0.2.0-rc.2 各 6/6 ready,Codex C–F 4 格 codex_project_untrusted 单列 pending_user(统筹决定 ⑩);14 个接入文件留待提交、HEAD 不变 → 再次 plan:文件全 noop、七步全 noop(digest 83479aa5…)→ 再次 onboard_project 3.0 s:status=done,9 步全 converged,written_files 为空,14 个文件 mtime 全不变;verify_onboarding 10/12(origin、CI 两项按设计进 next_actions),clients 三端 converged,runtime ready。 human_verify 待用户:在 Claude Code、Codex(先信任该目录)、DSH 桌面 GUI 各新开会话调 read_project_test_account(name=LJ_PROBE_NONEXISTENT) 得「开发需求未登记」;P8g 界面终验。"
|
|
||||||
|
|
||||||
### ✅ P8-0 — 蓝图与依赖修正
|
### ✅ P8-0 — 蓝图与依赖修正
|
||||||
- status: done
|
- status: done
|
||||||
@ -299,8 +297,8 @@ skill 只是五个接入面之一,兼容层覆盖全部五面。
|
|||||||
- merge_verify: "2026-10-03 统筹会话:PR #39(2f2a9f1,CI passed;独立审查 10 条:6 修、1 部分修、2 登记/转指引、1 转统筹)合并为 d018d44,合并结果全量 cargo test 402 passed / 0 failed / 6 ignored。acceptance ①–⑨ 均为 cargo onboard::apply 层,据此标 ✅;端到端(新登记项目 plan → onboard_project)随 P8e 合并后由统筹实测。统筹决定(审查 ⑩):codex_project_untrusted 按设计 Q5 计为 next_action、不计入 done(只放宽这一种原因),非 git 目录维持不能 done(acceptance ⑥),子目录与 worktree 补 next_action 说明——由 P8e 实现。"
|
- merge_verify: "2026-10-03 统筹会话:PR #39(2f2a9f1,CI passed;独立审查 10 条:6 修、1 部分修、2 登记/转指引、1 转统筹)合并为 d018d44,合并结果全量 cargo test 402 passed / 0 failed / 6 ignored。acceptance ①–⑨ 均为 cargo onboard::apply 层,据此标 ✅;端到端(新登记项目 plan → onboard_project)随 P8e 合并后由统筹实测。统筹决定(审查 ⑩):codex_project_untrusted 按设计 Q5 计为 next_action、不计入 done(只放宽这一种原因),非 git 目录维持不能 done(acceptance ⑥),子目录与 worktree 补 next_action 说明——由 P8e 实现。"
|
||||||
- 统筹决定落地(审查 ⑩,2026-10-03,P8e 实现,详见 P8e 卡):codex_project_untrusted 视为 next_action、不阻断 done——L1 的 Codex 列里仅因 cause=codex_project_untrusted 未就绪的格不计入「L1 适用格」,completion 单列一项「Codex 信任」(source=l1、ready=false、新增字段 pending_user=true,不计入 done),next_actions 保留一条 codex_trust(计划已列不重复;计划预判已信任而 L1 仍显示未信任时补一条)——设计 Q5:炼境不写 Codex 信任表。其余原因的 Codex 格(含 blocked)照常计入;L1Report.all_applicable_ready 保持 L1 自身的原始判定。非 git 目录维持不能 done(acceptance ⑥);仓库子目录与 worktree / 子模块(.git 为文件)补 next_action repo_layout,说明「lefthook hook 挂载」只认项目根 .git/hooks、按当前口径到不了 done,并给出外层仓库根或实际 hooks 目录与怎样才能 done。由此 known_limits ④「Codex 未信任 → partial」改为 done + pending_user;⑤ 的判定口径不变,只补说明。
|
- 统筹决定落地(审查 ⑩,2026-10-03,P8e 实现,详见 P8e 卡):codex_project_untrusted 视为 next_action、不阻断 done——L1 的 Codex 列里仅因 cause=codex_project_untrusted 未就绪的格不计入「L1 适用格」,completion 单列一项「Codex 信任」(source=l1、ready=false、新增字段 pending_user=true,不计入 done),next_actions 保留一条 codex_trust(计划已列不重复;计划预判已信任而 L1 仍显示未信任时补一条)——设计 Q5:炼境不写 Codex 信任表。其余原因的 Codex 格(含 blocked)照常计入;L1Report.all_applicable_ready 保持 L1 自身的原始判定。非 git 目录维持不能 done(acceptance ⑥);仓库子目录与 worktree / 子模块(.git 为文件)补 next_action repo_layout,说明「lefthook hook 挂载」只认项目根 .git/hooks、按当前口径到不了 done,并给出外层仓库根或实际 hooks 目录与怎样才能 done。由此 known_limits ④「Codex 未信任 → partial」改为 done + pending_user;⑤ 的判定口径不变,只补说明。
|
||||||
|
|
||||||
### ✅ P8e — 投影收口与契约同步
|
### 🔵 P8e — 投影收口与契约同步
|
||||||
- status: done
|
- status: in_progress
|
||||||
- complexity: S
|
- complexity: S
|
||||||
- files: src-tauri/src/mcp_tools.rs, src-tauri/src/lib.rs, src/lib/commands.ts, docs/ai-context/project-context.yaml, docs/ai-context/agent-button-system.md, AGENTS.md(实际另含 src-tauri/src/commands/onboarding.rs(Tauri command 本身)、src-tauri/src/mcp_inject.rs(去掉生产入口的 dead_code 标注)、src-tauri/src/onboard/report.rs、onboard/apply.rs、onboard/apply/tests.rs(统筹决定 ⑩))
|
- files: src-tauri/src/mcp_tools.rs, src-tauri/src/lib.rs, src/lib/commands.ts, docs/ai-context/project-context.yaml, docs/ai-context/agent-button-system.md, AGENTS.md(实际另含 src-tauri/src/commands/onboarding.rs(Tauri command 本身)、src-tauri/src/mcp_inject.rs(去掉生产入口的 dead_code 标注)、src-tauri/src/onboard/report.rs、onboard/apply.rs、onboard/apply/tests.rs(统筹决定 ⑩))
|
||||||
- depends: P8d
|
- depends: P8d
|
||||||
@ -311,10 +309,9 @@ skill 只是五个接入面之一,兼容层覆盖全部五面。
|
|||||||
- verification: "2026-10-03:全量 cargo test 413 passed / 0 failed / 6 ignored(master 402,新增 11 条),编译 0 warning;改动的 Rust 文件 rustfmt --check(skip_children)无差异;pnpm typecheck 通过,pnpm test(vitest)4 文件 16 条通过。cargo test mcp_tools 40 条通过,其中 P8e 新增 5 条:onboarding_tools_are_on_both_routes_with_confirmation_contract(全局与项目路由 tools/list 都含两工具;plan required=[project_id],onboard_project required 含 project_id、expected_digest、confirmed 且 confirmed 为 boolean;plan readOnly+idempotent+非破坏,apply 非只读+idempotent+非破坏+非 openWorld;两工具都有 bypass_permissions / skip_targets 且描述含 manual_entry、shared_key;描述含「给用户看」「用户明确确认」「在 Codex 里信任」「公开仓库」「private=true」;排在 apply_onboarding_pack 之前且相邻;项目路由 project_id 为 const=p1、不在 required,onboard_project required 为 [expected_digest, confirmed])、onboarding_tools_on_project_route_reject_cross_project_before_io(项目路由传 project_id=p2 两工具都 isError + structuredContent.code=scope_violation、文案含「绑定 project_id=p1」)、onboard_options_follow_schema_names_and_default(按 schema 声明的选项名构造入参解析正确;缺省与 null 为默认;两工具选项参数完全一致;三种类型错误文案)、onboarding_tools_reject_malformed_arguments_before_io(全局与项目路由:skip_targets 非数组、confirmed 非布尔、expected_digest 非字符串、bypass_permissions 非布尔均在 IO 前报错)、onboarding_responses_carry_structured_content_and_one_line_summary(序列化真实 OnboardingPlan / OnboardReport:structuredContent 原样、摘要含计数、本机步骤、阻断与 skip_targets 提示、digest、待提交接入文件数与 next_actions;status=done 不带 isError)。onboard::report 新增 4 条:codex_trust_only_cells_are_pending_user_and_do_not_block_done(Codex 列 C–F 只因未信任 → done、L1 适用格 ready、单列 1 项 pending_user、补 1 条 codex_trust、计划已列不重复、全就绪时无 pending 项)、other_not_ready_cells_still_block_done(Codex 列混入 auth_failed、别的列出现同一归因、Codex 列 blocked(dependency)、其他 L0 未就绪 → 均 partial)、repo_layout_next_action_explains_why_done_is_unreachable、repo_layout_detects_root_subdirectory_worktree_and_non_git(真实 git 仓库、子目录、git worktree 与普通目录)。onboard::apply 新增 2 条(测试替身 FakeRunner 增加 Codex 自省模拟、FakeLocator 可定位 Codex,lefthook 替身改为装到 git --git-path hooks 与真实 lefthook 一致):codex_untrusted_cells_are_pending_user_and_do_not_block_done(经真实 L1 判定链:codex mcp get 找不到 → C–F 为 codex_project_untrusted → status=done、pending_user 1 项、codex_trust 1 条;计划预判已信任时 L1 结论补 1 条;生效为全局地址 → partial、无 pending 项)、worktree_project_is_partial_and_next_action_explains_why(真实 git worktree:hook 装在主仓库,未就绪的只有「lefthook hook 挂载」,repo_layout 1 条,重跑同样 partial 且 lefthook 再跑);既有 project_in_repo_subdirectory_does_not_touch_outer_hooks 补断言(唯一障碍为 lefthook hook 挂载,repo_layout 含外层仓库名),first_apply 补断言(仓库根无 repo_layout、无 pending 项)。变异验证(全部改动先已 git add 暂存,用 Edit 注入、跑 cargo test --lib -- mcp_tools onboard:: commands::projects、git checkout 从暂存区还原,未用 sed)三轮 10 处全部被杀且失败集合与预期一致:第一轮 4 处——onboard_project 移出幂等列表、plan_onboarding 移出 STRUCTURED_TOOLS、l1_readiness 不限 Codex 列、repo_layout_next_action 恒为 None——恰好 6 条失败(路由契约、摘要、other_not_ready、repo_layout 说明及子目录 / worktree 两条 apply 用例)、126 条通过;第二轮 3 处——onboard_project 不进项目路由、done 判定不跳过 pending_user、.git 为文件也判仓库根——恰好 7 条失败、125 条通过;第三轮 2 处——L1 结论不补 codex_trust、选项解析丢弃 skip_targets——恰好 3 条失败、129 条通过。避开会绕过 IO 前校验的变异(如去掉 scope 绑定、去掉类型检查),以免测试进程调到生产入口。"
|
- verification: "2026-10-03:全量 cargo test 413 passed / 0 failed / 6 ignored(master 402,新增 11 条),编译 0 warning;改动的 Rust 文件 rustfmt --check(skip_children)无差异;pnpm typecheck 通过,pnpm test(vitest)4 文件 16 条通过。cargo test mcp_tools 40 条通过,其中 P8e 新增 5 条:onboarding_tools_are_on_both_routes_with_confirmation_contract(全局与项目路由 tools/list 都含两工具;plan required=[project_id],onboard_project required 含 project_id、expected_digest、confirmed 且 confirmed 为 boolean;plan readOnly+idempotent+非破坏,apply 非只读+idempotent+非破坏+非 openWorld;两工具都有 bypass_permissions / skip_targets 且描述含 manual_entry、shared_key;描述含「给用户看」「用户明确确认」「在 Codex 里信任」「公开仓库」「private=true」;排在 apply_onboarding_pack 之前且相邻;项目路由 project_id 为 const=p1、不在 required,onboard_project required 为 [expected_digest, confirmed])、onboarding_tools_on_project_route_reject_cross_project_before_io(项目路由传 project_id=p2 两工具都 isError + structuredContent.code=scope_violation、文案含「绑定 project_id=p1」)、onboard_options_follow_schema_names_and_default(按 schema 声明的选项名构造入参解析正确;缺省与 null 为默认;两工具选项参数完全一致;三种类型错误文案)、onboarding_tools_reject_malformed_arguments_before_io(全局与项目路由:skip_targets 非数组、confirmed 非布尔、expected_digest 非字符串、bypass_permissions 非布尔均在 IO 前报错)、onboarding_responses_carry_structured_content_and_one_line_summary(序列化真实 OnboardingPlan / OnboardReport:structuredContent 原样、摘要含计数、本机步骤、阻断与 skip_targets 提示、digest、待提交接入文件数与 next_actions;status=done 不带 isError)。onboard::report 新增 4 条:codex_trust_only_cells_are_pending_user_and_do_not_block_done(Codex 列 C–F 只因未信任 → done、L1 适用格 ready、单列 1 项 pending_user、补 1 条 codex_trust、计划已列不重复、全就绪时无 pending 项)、other_not_ready_cells_still_block_done(Codex 列混入 auth_failed、别的列出现同一归因、Codex 列 blocked(dependency)、其他 L0 未就绪 → 均 partial)、repo_layout_next_action_explains_why_done_is_unreachable、repo_layout_detects_root_subdirectory_worktree_and_non_git(真实 git 仓库、子目录、git worktree 与普通目录)。onboard::apply 新增 2 条(测试替身 FakeRunner 增加 Codex 自省模拟、FakeLocator 可定位 Codex,lefthook 替身改为装到 git --git-path hooks 与真实 lefthook 一致):codex_untrusted_cells_are_pending_user_and_do_not_block_done(经真实 L1 判定链:codex mcp get 找不到 → C–F 为 codex_project_untrusted → status=done、pending_user 1 项、codex_trust 1 条;计划预判已信任时 L1 结论补 1 条;生效为全局地址 → partial、无 pending 项)、worktree_project_is_partial_and_next_action_explains_why(真实 git worktree:hook 装在主仓库,未就绪的只有「lefthook hook 挂载」,repo_layout 1 条,重跑同样 partial 且 lefthook 再跑);既有 project_in_repo_subdirectory_does_not_touch_outer_hooks 补断言(唯一障碍为 lefthook hook 挂载,repo_layout 含外层仓库名),first_apply 补断言(仓库根无 repo_layout、无 pending 项)。变异验证(全部改动先已 git add 暂存,用 Edit 注入、跑 cargo test --lib -- mcp_tools onboard:: commands::projects、git checkout 从暂存区还原,未用 sed)三轮 10 处全部被杀且失败集合与预期一致:第一轮 4 处——onboard_project 移出幂等列表、plan_onboarding 移出 STRUCTURED_TOOLS、l1_readiness 不限 Codex 列、repo_layout_next_action 恒为 None——恰好 6 条失败(路由契约、摘要、other_not_ready、repo_layout 说明及子目录 / worktree 两条 apply 用例)、126 条通过;第二轮 3 处——onboard_project 不进项目路由、done 判定不跳过 pending_user、.git 为文件也判仓库根——恰好 7 条失败、125 条通过;第三轮 2 处——L1 结论不补 codex_trust、选项解析丢弃 skip_targets——恰好 3 条失败、129 条通过。避开会绕过 IO 前校验的变异(如去掉 scope 绑定、去掉类型检查),以免测试进程调到生产入口。"
|
||||||
- 有意偏差:"① dispatch 的一行委托指向 mcp_tools 内的 plan_onboarding_call / onboard_project_call,再由它们调 mcp_inject 入口:中间只做 JSON 类型解析(类型错误须在任何 IO 之前报错,且与 register_project 的分发写法一致),判定仍全在本体。② onboard_project 的 annotations 为非只读、非破坏、幂等(重复执行收敛)、非 openWorld(只写本机与子项目文件、不出网);plan_onboarding 靠既有 plan_ 前缀规则得 readOnly。③ 统筹决定 ⑩ 的 pending_user 做成 CompletionItem 的通用布尔字段(serde default,目前只有「Codex 信任」一项会置 true),而不是新增 completion 来源;L1 适用格的 detail 注明有几格单列出去。④ 仓库子目录与 worktree 的 next_action 统一名为 repo_layout,同时提示「origin 指向 Gitea」也只读项目根 .git/config(同类口径问题,只说明、不改 verify);子模块与 worktree 同属「.git 为文件」一类,文案按 worktree 写。⑤ 非 git 目录不给 repo_layout(由 completion「项目文件改动可报告」未就绪说明,acceptance ⑥ 不变)。⑥ files 比卡片多,见 files。"
|
- 有意偏差:"① dispatch 的一行委托指向 mcp_tools 内的 plan_onboarding_call / onboard_project_call,再由它们调 mcp_inject 入口:中间只做 JSON 类型解析(类型错误须在任何 IO 之前报错,且与 register_project 的分发写法一致),判定仍全在本体。② onboard_project 的 annotations 为非只读、非破坏、幂等(重复执行收敛)、非 openWorld(只写本机与子项目文件、不出网);plan_onboarding 靠既有 plan_ 前缀规则得 readOnly。③ 统筹决定 ⑩ 的 pending_user 做成 CompletionItem 的通用布尔字段(serde default,目前只有「Codex 信任」一项会置 true),而不是新增 completion 来源;L1 适用格的 detail 注明有几格单列出去。④ 仓库子目录与 worktree 的 next_action 统一名为 repo_layout,同时提示「origin 指向 Gitea」也只读项目根 .git/config(同类口径问题,只说明、不改 verify);子模块与 worktree 同属「.git 为文件」一类,文案按 worktree 写。⑤ 非 git 目录不给 repo_layout(由 completion「项目文件改动可报告」未就绪说明,acceptance ⑥ 不变)。⑥ files 比卡片多,见 files。"
|
||||||
- 没验什么:"① acceptance 的 [MCP 全局](对 enterprise 做 plan 全部 noop、apply done 且各步 converged)与 P8f 的 register_project → plan_onboarding → onboard_project 链路:需合并后在运行中的炼境重编译再调写工具,按授权规则由统筹会话实测,本卡保持 🔵。② Tauri command 两个薄包装与 commands.ts 封装没有自动化测试、没在 UI 里调过(P8g 才有界面),只由 pnpm typecheck 与类型逐字段对照保证;Tauri 入参 options 的 camelCase / snake_case 映射(顶层参数 camelCase、OnboardOptions 内部字段 snake_case)按 Tauri 约定推断,未实机验证。③ MCP 客户端侧的工具超时:首次一键接入可能 30 秒以上,Codex 默认 tool_timeout_sec 等客户端限制没有实测。④ repo_layout 的 git rev-parse 与报告里其他 git 观测一样直接起 git、无超时(P8d known_limits ① 同类)。⑤ 统筹决定的 done 判定只在测试替身与单元层验证;真实 Codex 未信任目录的端到端(L1 显示 codex_project_untrusted → done + pending_user)待统筹实测。⑥ 本卡未做独立审查(S 级)。"
|
- 没验什么:"① acceptance 的 [MCP 全局](对 enterprise 做 plan 全部 noop、apply done 且各步 converged)与 P8f 的 register_project → plan_onboarding → onboard_project 链路:需合并后在运行中的炼境重编译再调写工具,按授权规则由统筹会话实测,本卡保持 🔵。② Tauri command 两个薄包装与 commands.ts 封装没有自动化测试、没在 UI 里调过(P8g 才有界面),只由 pnpm typecheck 与类型逐字段对照保证;Tauri 入参 options 的 camelCase / snake_case 映射(顶层参数 camelCase、OnboardOptions 内部字段 snake_case)按 Tauri 约定推断,未实机验证。③ MCP 客户端侧的工具超时:首次一键接入可能 30 秒以上,Codex 默认 tool_timeout_sec 等客户端限制没有实测。④ repo_layout 的 git rev-parse 与报告里其他 git 观测一样直接起 git、无超时(P8d known_limits ① 同类)。⑤ 统筹决定的 done 判定只在测试替身与单元层验证;真实 Codex 未信任目录的端到端(L1 显示 codex_project_untrusted → done + pending_user)待统筹实测。⑥ 本卡未做独立审查(S 级)。"
|
||||||
- mcp_verify: "PR #40(97578b2,CI passed,独立审查可合并:3 低 5 信息转后续)合并为 d7f4816。2026-10-03 22:5x 统筹会话端到端(炼境 d7f4816 重编译后经全局 MCP):新建临时 git 仓库 E:code-projectlj-p8-e2e-20261003 → register_project 得 project_id=ac73a4bb-a601-4e21-bc0f-7eda71fae4aa(目录落库为规范反斜杠形式;换大小写/正斜杠/尾分隔符再登记被拒并给出已有 ID)→ plan_onboarding:文件 create 14、本机 token/claude/codex/dsh/product_group_buff/git_hooks=apply、shim=noop、阻断 0、bypass_permissions=true、codex_trust=untrusted(进 next_actions)→ onboard_project(expected_digest=bb60bf69…, confirmed=true) 7.9 s:status=done,9 步全收敛,completion 全 ready(AGENTS/git-workflow 管理块最新、身份、能力包 1.9.0、两份 skill、Codex MCP 块、lefthook 挂载与检查段、Claude local、Codex 托管块、DSH 白名单、L1 适用格、改动可报告、HEAD 不变),L1:Claude 2.1.90 与 DSH 0.2.0-rc.2 各 6/6 ready,Codex C–F 4 格 codex_project_untrusted 单列 pending_user(统筹决定 ⑩);14 个接入文件留待提交、HEAD 不变 → 再次 plan:文件全 noop、七步全 noop(digest 83479aa5…)→ 再次 onboard_project 3.0 s:status=done,9 步全 converged,written_files 为空,14 个文件 mtime 全不变;verify_onboarding 10/12(origin、CI 两项按设计进 next_actions),clients 三端 converged,runtime ready。 偏差报备:acceptance 写的对 enterprise「plan 全 noop、apply 全 converged」——enterprise 的 plan 如实给出 update 3(两份 skill 与 capability-packs 待从 1.8.0 升 1.9.0,因其主工作区本地 main 落后 origin/main),按执行铁律不对他会话在制的工作区 apply;同一组断言(计划全 noop、apply 全 converged、mtime 不变)改在上述新登记项目上实测通过。enterprise 主工作区同步后再 plan 即应全 noop。"
|
|
||||||
|
|
||||||
### ✅ P8f — register_project 控制面投影
|
### 🔵 P8f — register_project 控制面投影
|
||||||
- status: done
|
- status: in_progress
|
||||||
- complexity: S
|
- complexity: S
|
||||||
- files: src-tauri/src/commands/projects.rs, src-tauri/src/mcp_tools.rs, src-tauri/src/commands/templates.rs(实施扩展), src-tauri/src/commands/git_repos.rs(实施扩展), src/components/dashboard/BatchAddModal.tsx(实施扩展), src-tauri/src/mcp_inject.rs(审查处置:路径键两函数改 pub(crate) 供复用), docs/ai-context/project-context.yaml(T1)
|
- files: src-tauri/src/commands/projects.rs, src-tauri/src/mcp_tools.rs, src-tauri/src/commands/templates.rs(实施扩展), src-tauri/src/commands/git_repos.rs(实施扩展), src/components/dashboard/BatchAddModal.tsx(实施扩展), src-tauri/src/mcp_inject.rs(审查处置:路径键两函数改 pub(crate) 供复用), docs/ai-context/project-context.yaml(T1)
|
||||||
- depends: P8-0
|
- depends: P8-0
|
||||||
@ -330,20 +327,14 @@ skill 只是五个接入面之一,兼容层覆盖全部五面。
|
|||||||
- 有意偏差:① 未加 confirmed 参数——任务要求是「描述写明写操作须用户确认目标」;登记只写炼境 DB、可经 unregister_project 撤销,按 unregister_project 的先例只在描述里约束。② MCP 不收 project_id,统一由炼境生成 UUID,避免 agent 自拟 ID 与已有命名冲突。③ 重复目录检查扩到批量添加、模板新建、挂载仓库三个新建入口(files 标「实施扩展」):PR #34 审查 L1/L2 的根因是同一目录多条登记,只堵 create_project 和 MCP 两个入口治不了根;编辑入口 update_project 仍未堵(审查 I1,转后续小修)。
|
- 有意偏差:① 未加 confirmed 参数——任务要求是「描述写明写操作须用户确认目标」;登记只写炼境 DB、可经 unregister_project 撤销,按 unregister_project 的先例只在描述里约束。② MCP 不收 project_id,统一由炼境生成 UUID,避免 agent 自拟 ID 与已有命名冲突。③ 重复目录检查扩到批量添加、模板新建、挂载仓库三个新建入口(files 标「实施扩展」):PR #34 审查 L1/L2 的根因是同一目录多条登记,只堵 create_project 和 MCP 两个入口治不了根;编辑入口 update_project 仍未堵(审查 I1,转后续小修)。
|
||||||
- T1:新 MCP 工具 register_project 已同步 docs/ai-context/project-context.yaml「MCP 工具接口」段(paths 补 projects.rs,doc 补路由、本体、同目录判定、落库规范化、UI 占位例外、warning 与入参语义,以及 scan_unregistered_projects 与 mount_repo 的同口径);Tauri command 签名未变,src/lib/commands.ts 无需改动。
|
- T1:新 MCP 工具 register_project 已同步 docs/ai-context/project-context.yaml「MCP 工具接口」段(paths 补 projects.rs,doc 补路由、本体、同目录判定、落库规范化、UI 占位例外、warning 与入参语义,以及 scan_unregistered_projects 与 mount_repo 的同口径);Tauri command 签名未变,src/lib/commands.ts 无需改动。
|
||||||
- review: "2026-10-03 独立只读审查 bd4ebaf,结论 fix_then_merge,10 条发现处置:M1 [中] MCP 入参原样落库(正斜杠、尾部分隔符、长路径前缀、8.3、`..`),scan_unregistered_projects 按字面比较会自相矛盾 → 已修:本体对 Windows 目录 canonicalize 后去长路径前缀落库,register_project_at 回执 path 为落库值、名称缺省按规范形式取目录名(相对路径不 canonicalize,交本体拒绝);scan 的已登记判定与父目录去重改用 registration_path_key。M2 [中] UI 不选目录的概念占位被取消,超出 P8f 范围且与 mcp-server 模块记录的用户用法冲突 → 已恢复原行为:本体新增 RootRequirement,UI 入口有效路径为空时只写 profile+workspace、不校验目录、不查重复,MCP 入口仍拒绝;是否改为显式占位概念交统筹会话问用户(需求澄清),本 PR 不预设答案。L1 [低] 已有登记两列都比,残留列误拦 → 已修:按 platform 只取有效根目录(registration_root),查询补 platform 列。L2 [低] 8.3、`..`、末尾点等漏判 → 已修:新目录在写事务外另算 canonical 键,两键比对已有行的字面键(已有行不读磁盘,写锁内无 I/O)。L3 [低] mount_repo 检查在插 profile 之后且无事务 → 已修:抽 mount_repo_records(连接注入),检查前移、整体 IMMEDIATE 事务;前端先 gitClone 再 mount 的白克隆属 UI 范围,未改。L4 [低] 路径比较键多份实现 → 部分修:registration_path_key 改为复用 mcp_inject::normalize_dsh_root + strip_verbatim_prefix(两函数改 pub(crate));normalize_trust_path、WSL 发行版查询与 UNC 换算的第三份拷贝统一抽 crate::path_key 转后续小修(会动 P4a/P8d 热点 mcp_inject.rs)。I1 [信息] update_project 仍可造同目录登记 → 转后续小修:UI 编辑整表提交,须「有效根目录实际变化才检查 + 排除自身」,否则存量重复登记(beast-mode)连改名都会被拦,单独做更稳。I2 [信息] project_root_with_conn 对 UNC 形式的 wsl_path 错误拼接(已有缺陷)→ 不在本 PR 改(mcp_inject.rs 热点),转后续小修;卡片与代码注释里「同口径」改为只指取列与 Linux 路径换算。I3 [信息] 重登目录遗留旧 context.json 无提示 → 已修:register_project_at 只读检查,project_id 不同时回执与摘要带 warning(不沿用旧 ID)。I4 [信息] 分发分支无测试 → 已修:分发抽成 register_project_call(conn, args),测试按 schema 声明的参数名构造入参;IMMEDIATE 并发仍无测试(见没验什么③)。"
|
- review: "2026-10-03 独立只读审查 bd4ebaf,结论 fix_then_merge,10 条发现处置:M1 [中] MCP 入参原样落库(正斜杠、尾部分隔符、长路径前缀、8.3、`..`),scan_unregistered_projects 按字面比较会自相矛盾 → 已修:本体对 Windows 目录 canonicalize 后去长路径前缀落库,register_project_at 回执 path 为落库值、名称缺省按规范形式取目录名(相对路径不 canonicalize,交本体拒绝);scan 的已登记判定与父目录去重改用 registration_path_key。M2 [中] UI 不选目录的概念占位被取消,超出 P8f 范围且与 mcp-server 模块记录的用户用法冲突 → 已恢复原行为:本体新增 RootRequirement,UI 入口有效路径为空时只写 profile+workspace、不校验目录、不查重复,MCP 入口仍拒绝;是否改为显式占位概念交统筹会话问用户(需求澄清),本 PR 不预设答案。L1 [低] 已有登记两列都比,残留列误拦 → 已修:按 platform 只取有效根目录(registration_root),查询补 platform 列。L2 [低] 8.3、`..`、末尾点等漏判 → 已修:新目录在写事务外另算 canonical 键,两键比对已有行的字面键(已有行不读磁盘,写锁内无 I/O)。L3 [低] mount_repo 检查在插 profile 之后且无事务 → 已修:抽 mount_repo_records(连接注入),检查前移、整体 IMMEDIATE 事务;前端先 gitClone 再 mount 的白克隆属 UI 范围,未改。L4 [低] 路径比较键多份实现 → 部分修:registration_path_key 改为复用 mcp_inject::normalize_dsh_root + strip_verbatim_prefix(两函数改 pub(crate));normalize_trust_path、WSL 发行版查询与 UNC 换算的第三份拷贝统一抽 crate::path_key 转后续小修(会动 P4a/P8d 热点 mcp_inject.rs)。I1 [信息] update_project 仍可造同目录登记 → 转后续小修:UI 编辑整表提交,须「有效根目录实际变化才检查 + 排除自身」,否则存量重复登记(beast-mode)连改名都会被拦,单独做更稳。I2 [信息] project_root_with_conn 对 UNC 形式的 wsl_path 错误拼接(已有缺陷)→ 不在本 PR 改(mcp_inject.rs 热点),转后续小修;卡片与代码注释里「同口径」改为只指取列与 Linux 路径换算。I3 [信息] 重登目录遗留旧 context.json 无提示 → 已修:register_project_at 只读检查,project_id 不同时回执与摘要带 warning(不沿用旧 ID)。I4 [信息] 分发分支无测试 → 已修:分发抽成 register_project_call(conn, args),测试按 schema 声明的参数名构造入参;IMMEDIATE 并发仍无测试(见没验什么③)。"
|
||||||
- mcp_verify: "PR #37 合并(55dc637);P8e 合并后经全局 MCP 实测链路 register_project → plan_onboarding → onboard_project 得 status=done(证据同 P8e mcp_verify);同目录换写法再登记被拒并给出已有 project_id。"
|
|
||||||
|
|
||||||
### ✅ P8g — UI 一键接入
|
### 📋 P8g — UI 一键接入
|
||||||
- status: done
|
- status: todo
|
||||||
- merge_verify: "PR #41 CI passed(head c28caf72ee94a2ce9c749de941d9c43ffafc33ee,核对完整 SHA 后合并)→ master 3228b49:pnpm typecheck 通过;pnpm test 5 文件 29 passed(含 onboardView 13 条);全量 cargo test 414 passed / 0 failed / 6 ignored(另一测试二进制 1 passed)。agent_verify 全部达成。"
|
|
||||||
- human_verify: "2026-10-04 用户终验通过(临时 git 仓库 E:\\code-project\\lj-p8g-ui-test,project_id 5818aa5a-7789-4f4d-a0b3-3b2d433d0a8c):① 「+ 添加项目」选目录保存后弹出接入预览(14 个新建文件、bypassPermissions 与 Codex 信任单列、本机七步、无阻断);③ 在预览里取消,目录 git status 为空、零改动;② 经蓝图治理「一键接入」确认后 7.7 秒得 done(9 步收敛),分步结果、L1 矩阵(Claude/DSH 各 6 格就绪,Codex C–F 待你信任)、「待你提交的 14 个文件」与磁盘一致、HEAD 未变、lefthook 三个钩子已挂;用户在 Codex 桌面版该目录发起对话后信任表写入,重跑 probe_client_parity 三端 18 格 ready、all_applicable_ready=true(Codex 桌面版只「添加项目」不写信任);④ Claude Code、Codex、DSH 桌面 GUI 新会话调 read_project_test_account(LJ_PROBE_NONEXISTENT) 均得「开发需求未登记」(DSH 未传 project_id,会话按工作区绑定本项目)。终验中记下的 UI 文案小问题转后续小修:新建文件的「查看差异」只有一行概要应改行内显示;git_hooks 与 Claude/DSH 行的「已写入」标签重复或不准。"
|
|
||||||
- complexity: M
|
- complexity: M
|
||||||
- files: src/components/dashboard/OnboardPanel.tsx, src/components/dashboard/onboardView.ts, src/components/dashboard/onboardView.test.ts, src/components/dashboard/ProjectModal.tsx, src/components/dashboard/BatchAddModal.tsx, src/components/manage/NewProjectModal.tsx, src/components/dashboard/BlueprintModal.tsx, src/lib/commands.ts
|
- files: src/components/dashboard/OnboardPanel.tsx, src/components/dashboard/onboardView.ts, src/components/dashboard/onboardView.test.ts, src/components/dashboard/ProjectModal.tsx, src/components/dashboard/BatchAddModal.tsx, src/components/manage/NewProjectModal.tsx, src/components/dashboard/BlueprintModal.tsx, src/lib/commands.ts
|
||||||
- depends: P8e
|
- depends: P8e
|
||||||
- acceptance: "agent_verify: [pnpm typecheck && pnpm test] 视图纯函数:blocked 非空时确认按钮禁用并列出文件和原因;not_installed 和 not_applicable 显示为灰色说明、不显示为红色失败;bypassPermissions 和 Codex 信任单独列出;确认时携带 expected_digest。human_verify: ① 用临时 git 仓库新建项目,弹出接入预览;② 确认后 30 秒内看到分步结果、L1 矩阵和「待你提交的 N 个文件」;③ 另试一次在预览里取消,目录零改动;④ 在该目录新开 Claude Code、Codex、DSH 桌面 GUI 会话调 LJ_PROBE_NONEXISTENT,得「开发需求未登记」。"
|
- acceptance: "agent_verify: [pnpm typecheck && pnpm test] 视图纯函数:blocked 非空时确认按钮禁用并列出文件和原因;not_installed 和 not_applicable 显示为灰色说明、不显示为红色失败;bypassPermissions 和 Codex 信任单独列出;确认时携带 expected_digest。human_verify: ① 用临时 git 仓库新建项目,弹出接入预览;② 确认后 30 秒内看到分步结果、L1 矩阵和「待你提交的 N 个文件」;③ 另试一次在预览里取消,目录零改动;④ 在该目录新开 Claude Code、Codex、DSH 桌面 GUI 会话调 LJ_PROBE_NONEXISTENT,得「开发需求未登记」。"
|
||||||
- 说明:新建 / 模板创建成功后弹出「接入预览」,create_project 本身保持无副作用;批量添加只提供批量入口、不自动接入;BlueprintModal 的「应用接入包」改为先 plan 再 apply。
|
- 说明:新建 / 模板创建成功后弹出「接入预览」,create_project 本身保持无副作用;批量添加只提供批量入口、不自动接入;BlueprintModal 的「应用接入包」改为先 plan 再 apply。
|
||||||
- 实现(2026-10-04,分支 feat/agent-client-parity-p8g,统筹会话主线程直做——两次委派卡死于一次性生成大文件):onboardView.ts 视图纯函数(计划预览、确认请求、报告、L1 矩阵;判定全取后端字段);OnboardPanel.tsx 全局挂载于 App、经 useUIStore.openOnboard 打开(新建弹窗保存即卸载,面板须独立存在),状态机 planning → preview → applying → report,过期响应按请求序号丢弃、接入中不可关闭,refused 附新计划可回预览重新确认;plan.rs 的 BlockedItem 序列化附派生字段 skippable(可跳过判定只在本体,反序列化忽略、不进 digest),commands.ts 同步;入口:ProjectModal 新建且按 platform 的有效根目录非空才弹(概念占位不弹),NewProjectModal 模板创建成功自动弹、完成页可再开,BatchAddModal 添加后列出有目录的新项目逐个「一键接入」,BlueprintModal「施加 Buff」改为同一面板(buff 已激活时另给「重新检查接入」),关闭后按报告刷新 buff 与 init prompt;project-context.yaml 同步 skippable 与 UI 投影。
|
|
||||||
- 有意偏差:"① 呈现块拆到 OnboardSections.tsx(files 外新增,控制单文件规模)。② Toast 层级 z-50 → z-[70](审查 ②,否则接入提示被面板遮住)。③ 本地 confirm 函数改名 applyConfirmed:confirmUsage.test.ts 扫描 confirm( 防同步确认框,属正确的守卫。"
|
|
||||||
- review: "2026-10-04 独立只读审查 5b6c197,结论 merge,5 条:① [低] 新建入口按任一路径非空判是否弹面板,与后端按 platform 取有效根目录不同口径 → 已修。② [低] Toast z-50 被面板 z-[60] 遮住 → 已修。③ [低] 已有 permissions 又取消 bypass 时文案称会写 default → 已改文案(如实说明两种情况)。④ [信息] L1 格子着色在前端写死 codex_project_untrusted=待你操作,轻度复制判定 → 转后续小修(L1 格子带 pending_user 字段)。⑤ [信息] onboard_project 抛错后「取消」提示仍称不写入 → 已修(错误阶段换提示)。审查核实:确认带 plan.digest 与生成计划时的选项;refused 回预览时 planned 与新计划同一组选项(apply.rs 用请求选项重算);四条 agent_verify 有实断言。"
|
|
||||||
|
|
||||||
### ✅ P9 — DSH 桌面 GUI 按工作区连项目地址(会话级插件)
|
### ✅ P9 — DSH 桌面 GUI 按工作区连项目地址(会话级插件)
|
||||||
- status: done
|
- status: done
|
||||||
|
|||||||
@ -13,7 +13,6 @@ id: blueprint-buff
|
|||||||
- Buff 同步后顺手调用 `get_blueprint()`,内部触发 `append_usage_snapshot()`,使飞轮数据与实际开发进度对齐
|
- Buff 同步后顺手调用 `get_blueprint()`,内部触发 `append_usage_snapshot()`,使飞轮数据与实际开发进度对齐
|
||||||
- 使用文件路径匹配而非 commit message 解析,与 AI 工具/提交信息风格完全解耦
|
- 使用文件路径匹配而非 commit message 解析,与 AI 工具/提交信息风格完全解耦
|
||||||
- **files 重叠只作兜底(2026-10-02,B1)**:本批提交已有卡被显式推进(新增 🔵/✅/🔴 标题行)则不推断,整批无推进才视为「agent 忘了加锁」。原因:两阶段锁下在做的卡落地时已非 📋,files 重叠只能碰到未开工卡,精度结构性偏低。曾评估「提交说明引用卡 ID」——正文自由文本 4 次命中 3 次误判(「阶段二 N3/N4/N5 待启动」),结构化 trailer 又与上条解耦决策冲突且兜不住忘加锁场景,故不采用;「可能相关」改记 DB 信号不改卡片(方案 C)留作残余噪声持续时的升级路径
|
- **files 重叠只作兜底(2026-10-02,B1)**:本批提交已有卡被显式推进(新增 🔵/✅/🔴 标题行)则不推断,整批无推进才视为「agent 忘了加锁」。原因:两阶段锁下在做的卡落地时已非 📋,files 重叠只能碰到未开工卡,精度结构性偏低。曾评估「提交说明引用卡 ID」——正文自由文本 4 次命中 3 次误判(「阶段二 N3/N4/N5 待启动」),结构化 trailer 又与上条解耦决策冲突且兜不住忘加锁场景,故不采用;「可能相关」改记 DB 信号不改卡片(方案 C)留作残余噪声持续时的升级路径
|
||||||
- **剩余缺口与冻结(2026-10-04,MVP 收口 M2)**:manifest 曾记 86%,剩余 14% 起初判为未更新的进度数字;同日 B2 终验被否决(见 B2 卡),证明剩余是真实缺口——兜底推断的误标须按上条升级路径做方案 C(files 重叠改记 DB「可能相关」信号、不改卡片,L 级)。用户定:误标属噪声、不阻挡 MVP 四条能力,方案 C 冻结为扩展,模块保持 in_progress。
|
|
||||||
|
|
||||||
## 任务卡
|
## 任务卡
|
||||||
|
|
||||||
@ -80,5 +79,3 @@ id: blueprint-buff
|
|||||||
- 实现:infer_task_marks 增加第二个显式归属条件 edits_existing_lines——本批 .blueprint/modules patch 在 hunk 内有 `-` 行(删改既有内容)即视为 agent 在跟进维护,不推断;纯追加(新立 📋 卡、新模块)仍走兜底,保留「立卡即实现、忘了加锁」的捕获。
|
- 实现:infer_task_marks 增加第二个显式归属条件 edits_existing_lines——本批 .blueprint/modules patch 在 hunk 内有 `-` 行(删改既有内容)即视为 agent 在跟进维护,不推断;纯追加(新立 📋 卡、新模块)仍走兜底,保留「立卡即实现、忘了加锁」的捕获。
|
||||||
- verification: "2026-10-03:cargo test 284 passed / 0 failed / 5 ignored;buff 10 passed(新增 edits_existing_lines 单测与端到端 ⑧⑨);变异验证见 acceptance。回放 master 260 个 first-parent 批次:B1 下无推进 172 批,B2 新增抑制 27 批,其中含代码改动的 6 批:19b9388(本次误标)、8f3be6b、0d4c2ad、cbc1d46、23de433、0552180,其余为只改蓝图的 docs/chore 提交(本就不会命中代码卡);纯追加立卡的 9881b56、9c2064e、4f5cf43 保持兜底。"
|
- verification: "2026-10-03:cargo test 284 passed / 0 failed / 5 ignored;buff 10 passed(新增 edits_existing_lines 单测与端到端 ⑧⑨);变异验证见 acceptance。回放 master 260 个 first-parent 批次:B1 下无推进 172 批,B2 新增抑制 27 批,其中含代码改动的 6 批:19b9388(本次误标)、8f3be6b、0d4c2ad、cbc1d46、23de433、0552180,其余为只改蓝图的 docs/chore 提交(本就不会命中代码卡);纯追加立卡的 9881b56、9c2064e、4f5cf43 保持兜底。"
|
||||||
- known_limits: "同批若只改写了无关 📋 卡的文字同时改代码且忘了加锁,B2 会少标(漏信号,不误标)。下次再出现误标时按 B1 决策记录升级到方案 C(files 重叠改记 DB「可能相关」信号,不改卡片,L 级)。"
|
- known_limits: "同批若只改写了无关 📋 卡的文字同时改代码且忘了加锁,B2 会少标(漏信号,不误标)。下次再出现误标时按 B1 决策记录升级到方案 C(files 重叠改记 DB「可能相关」信号,不改卡片,L 级)。"
|
||||||
- human_verify: "2026-10-04 否决:主仓库 12:45 快进到 ef09ef2(只改 docs/tasks/2026-10-03-coordination.md,无蓝图改动)后约 1 分钟,buff 把 intent-catalog 未开工的 📋 IC10(files 含该文件)标为 🔵——无显式推进、files 共用即兜底命中,属 B1 known_limits「不更新蓝图的提交碰共享文件仍可能误标」。B1/B2 两道闸已生效但不足以消除此类误标。"
|
|
||||||
- 终验: 2026-10-04 否决:只改共用文档、不动蓝图的提交仍会把无关 📋 卡误标 🔵(实例 IC10)
|
|
||||||
|
|||||||
@ -1,215 +0,0 @@
|
|||||||
# 意图目录(intent-catalog)
|
|
||||||
|
|
||||||
> status: in_progress | created: 2026-10-04 | 设计:docs/tasks/2026-10-04-intent-catalog-design.md(IC1 ✅,用户 2026-10-04 确认)| 指南:docs/ai-context/intent-catalog-guide.md(IC2 ✅)| 目录:.blueprint/catalog.md 1.0(IC3 ✅)| 下一步:IC5(P8 收口后首次真实 /goal)
|
|
||||||
> 来源:2026-10-03~04 与用户讨论(/goal 与 Loop Engineering 操作手册、目录/正文模型、承重墙),以及侦察工作流 wf_6dc3756a-b72 的重叠与冲突扫描。
|
|
||||||
|
|
||||||
## 概述
|
|
||||||
|
|
||||||
在蓝图之上加一层由人持有的意图目录 `.blueprint/catalog.md`:每章写意图、双坐标、不做什么和 rev;任务卡用 `- intent: INT-NN@X.Y` 单向挂靠。agent 据此编译可判定的 /goal,确认卡兼作最小任务简报,收口回执写进提交。试用期只新增文档,门控与接线排在 P8 收口后,按实测数据决定保留或撤销。
|
|
||||||
|
|
||||||
## 为什么
|
|
||||||
|
|
||||||
- 用户能给的是需求、意图方向和已知现状,不是评估器能判定的条件。/goal 这类无人值守 loop 需要可判定的终点,这一步翻译应由 agent 完成,但 agent 需要一个人持有、稳定的意图来源。
|
|
||||||
- 现状:意图散在 AGENTS.md「项目定位」、统筹文档 §0、设计文档的决策节、manifest description 和私有记忆里;manifest 的 areas 按技术层分区,不按意图方向。
|
|
||||||
- 实证:2026-09-30 的 `/goal 按照方针设计方向走,直到符合设计要求` 跑了 3 轮,评估器就以「设计已完成」为由判定达成并解除了 goal。评估器不读文件,条件只能写成可判定的终点。
|
|
||||||
- 与 `docs/tasks/2026-09-23-blueprint-agent-handoff-pilot.md` 的「项目工作账本 + 信息归属 + 最小任务简报」同构,应合并推进,不能分两处做。
|
|
||||||
|
|
||||||
## 模型(概念,待设计确认)
|
|
||||||
|
|
||||||
- **两层**:目录层由人持有,保持稳定;正文层是蓝图模块与任务卡,由 agent 维护。
|
|
||||||
- **书的比喻**:
|
|
||||||
- 前言是长期方针,只指向 AGENTS.md「项目定位」,不另抄一份。
|
|
||||||
- 每一章是一个意图方向。
|
|
||||||
- 章首导语写意图、双坐标(人看的投影坐标 + agent 可断言的坐标)和「不做什么」。
|
|
||||||
- 附录放现状指针、约束、决策与否决理由(勘误表)。
|
|
||||||
- 索引是稳定 ID,书签标出当前阶段。
|
|
||||||
- **定位**:它是全生命周期信息的骨架与索引,不是容器——**书装意图,指向事实**。代码、CI、状态、会话、凭据和环境都留在原生位置,书里只放可机器校验的指针;意图由人写,现状由机器采。
|
|
||||||
- **迭代**:
|
|
||||||
- 修订分三级:补丁指正文内的改动,agent 自主完成;小版本指调整章首坐标或由正文反推修改目录,agent 提案、人确认;大版本指增删章节或调整方向,由人主导。
|
|
||||||
- 配套机制:沿 ID 做影响分析;版本钉住,卡和 goal 记录自己编译自哪一版目录;保护在制品;修订历史回流飞轮。
|
|
||||||
- **/goal 的来源**:由架构 agent 从「当前章的验收坐标 + 本阶段卡的完成判定」编译,人确认后粘贴,粘贴这一下即确认。
|
|
||||||
|
|
||||||
## 承重墙(设计纲目)
|
|
||||||
|
|
||||||
agent 开发子项目时躲不掉的现象。每面墙都要回答四个问题:落在书的哪个部位、靠什么机制承重、怎样用机器检查它生效、什么情况下算拆除(拆除即撤销对应机制)。原则是能指向已有机制的,就不新建。
|
|
||||||
|
|
||||||
| 墙 | 已有承重机制(指向) | 待补 |
|
|
||||||
|---|---|---|
|
|
||||||
| W1 迭代 | 模块迭代记录与决策记录;能力包、托管块、模板指纹三重版本 | 目录版本层、修订分级、版本钉住;与 manifest.iteration 语义分开 |
|
|
||||||
| W2 遗忘 | 启动读蓝图;catchup/taskify;统筹文档 §0;复盘笔记 | 稳定入口回答「整体方向走到哪」;书签载体;方向与卡的双向索引 |
|
|
||||||
| W3 熵增 | 文档防腐 T1–T4;模板指纹测试;blueprint-gate;梦核蒸馏 | 指针可解析门控(只警告);禁止索引膨胀成正文 |
|
|
||||||
| W4 意图鸿沟 | 需求对齐协议与确认卡;Feature-Confirmed;双尺子;辩证收缩 | 章级意图与「不做什么」;卡挂回意图章 |
|
|
||||||
| W5 注意力稀缺 | 统筹三类找人;pending_user;回传只列待处置 | 跨章的「待人裁决」视图;书签由人确认 |
|
|
||||||
| W6 理解债 | 决策记录;复盘笔记;架构速查;导师上下文 | 从代码或模块反查「服务哪条意图」;关键决策摘要推送给人 |
|
|
||||||
| W7 自评偏差 | 两把尺子;「没验什么」;证据等级;独立/对抗审查;CI 兜底 | 章坐标标注证据等级;章完成只能推导,不能手动切换 |
|
|
||||||
| W8 不确定性 | R10 先实测;P4-0 假设证伪;三闸门 | 探索章(轮廓、试探、预算、收敛信号)→ 结晶为定型章;「假设:」指向既有的证伪落点(2026-10-04 修订) |
|
|
||||||
| W9 并发冲突 | 🔵 执行锁;每卡独立 worktree;串行队列;plan→digest→apply | 目录本身成为争用点;版本钉住复用 digest 语义 |
|
|
||||||
| W10 风险不对称 | 计划→确认→应用;confirmed=true;破坏性标注;凭据边界 | 目录大版本与书签切换的「提案 + digest + 人确认」;章级风险等级 |
|
|
||||||
| W11 资源有限 | L0/L1/L3 分层;风险预测;提交飞轮指标 | 按章、按 goal 记账(只记账不分配,不替 agent 选模型) |
|
|
||||||
| W12 环境漂移 | 工具链状态;诊断;verify_onboarding;L1 对等检查 | 基本齐全,目录只放工具指针 |
|
|
||||||
| W13 异构 agent | canonical context;AGENTS.md 跨端单一来源;三端对等 | 模型无关的 goal 编译流程(/architect 只有 Claude 有) |
|
|
||||||
| W14 摩擦重复 | 使者回传闭环;梦核;Rules-Applied;管家准入 | 修订历史与否决理由回流(复用 envoy 与复盘笔记,不新建账本) |
|
|
||||||
|
|
||||||
## 并入与依赖
|
|
||||||
|
|
||||||
- **并入**:handoff 试点中的「信息归属与同步契约」和「最小任务简报的按需读取与回执」两项。
|
|
||||||
- **留在 blueprint-governance 作为前置**:「安全派发 + blueprint-baseline 能力包」和「任务状态语义收敛」。
|
|
||||||
- **依赖**:blueprint-governance(安全派发)、agent-client-capability-packs(版本化 pack 机制)。
|
|
||||||
- **相关**:governance-feedback-loop(修订历史与否决理由回流)。
|
|
||||||
|
|
||||||
## 待设计问题(IC1 须逐条化解)
|
|
||||||
|
|
||||||
1. 「意图层」现有三处归属:CONVENTIONS「蓝图定位(意图层)」、agent-button-system「意图层 — AGENTS.md」,以及本模型。设计时需先定死术语映射,并且只在一处改名。
|
|
||||||
2. 红线:章的完成只能从卡状态加 human_verify 推导,不能做成人手动切换(AGENTS.md 设计红线)。
|
|
||||||
3. 前置:CONVENTIONS 中 in_progress/done 一处说从 Git 推断、另一处说手标,影响分析不能建立在未收敛的状态语义上。
|
|
||||||
4. 分类轴对应:修订分级、需求对齐协议(Bug/Feature × S/M/L)、文档元规则 T1–T4、manifest.iteration 之间的对应关系;考虑新增 T5「意图变更」,避免另起一套。
|
|
||||||
5. ID 前缀:承重墙用 W1–W14,章用 INT-xx,卡用 IC(2026-10-04 用 git grep 确认均未被占用)。
|
|
||||||
6. 「goal 级确认可代替逐卡确认」:起草立法提案,边界是写运行中的 DB、删除、human_verify、超出当前章的工作仍须找人。等 P8 跑完、用实测数据再定。
|
|
||||||
7. W11 只记账、不分配;CONVENTIONS 复杂度表把复杂度映射到模型名,与 handoff 的「不映射模型名」矛盾,交给前置一起收敛。
|
|
||||||
8. 防止容器化:目录只放 ID、一句话意图和指针(参照 project-context.yaml 的 label/paths,但禁止长 doc 字段),并配一个只警告的指针可解析门控。
|
|
||||||
9. 书签与统筹文档 §0 的交接:P8 期间只做指向;之后改为 agent 起草书签、人确认,统筹文档只管派单与交接。
|
|
||||||
10. 离线与降级:目录放在项目 Git 中、离线可读;影响分析与跨项目索引走 MCP 查询,并保留直接读文件的降级路径。
|
|
||||||
11. 跨 agent:goal 编译流程写成模型无关的形式(CONVENTIONS「复杂功能分析流程」),不能只靠 Claude 的 /architect。
|
|
||||||
12. 子项目已有的意图载体(例如 enterprise 的 `.specify/specs/.../spec.md`)只做指向,不复制。
|
|
||||||
13. 目录的物理位置与前言的归属(例如 `.blueprint/catalog.md`、`docs/intent/`,或放在 AGENTS.md 块外)。
|
|
||||||
|
|
||||||
## 不做什么
|
|
||||||
|
|
||||||
- 设计确认且 P8 收口之前,不写代码,不改接入包模板、CONVENTIONS、AGENTS.md、分发层和 P8 热点文件。
|
|
||||||
- 不给存量卡回填 `intent:`;试用阶段只在新卡上可选填写。
|
|
||||||
- 炼境不替 agent 编译 goal、选模型或判定完成;炼境只提供结构、校验、现状采集与查询。
|
|
||||||
- 不把蓝图的版本化事实源搬进炼境 DB,不让子项目依赖炼境在线,不建派发调度器。
|
|
||||||
|
|
||||||
## 分阶段
|
|
||||||
|
|
||||||
1. 立 concept 模块(本次)。
|
|
||||||
2. IC1 设计文档,与 P8 并行,只写文档。
|
|
||||||
3. 在炼境自身试用:新增目录文件,新卡可选 `intent:`。
|
|
||||||
4. P8 收口后:补前置,加只读校验与影响分析。
|
|
||||||
5. enterprise 隔离试点。
|
|
||||||
6. 按实测结果决定:并入能力包分发,或撤销。
|
|
||||||
|
|
||||||
## 收益度量与退出条件
|
|
||||||
|
|
||||||
- 度量:/goal 一次判对率、人工介入次数、续接所需的上下文量、方向返工与 human_verify 否决率、每阶段 token 用量;探索章另看收敛轮数、是否守住预算、否决理由是否逐轮减少。
|
|
||||||
- 退出:实测无收益、已被 agent 原生能力覆盖,或维护成本超过收益时撤销(管家准入与退出)。
|
|
||||||
|
|
||||||
## 任务卡
|
|
||||||
|
|
||||||
### ✅ IC1 — 意图目录设计文档(/architect)
|
|
||||||
- status: done
|
|
||||||
- complexity: L
|
|
||||||
- files: docs/tasks/2026-10-04-intent-catalog-design.md, .blueprint/modules/intent-catalog.md
|
|
||||||
- acceptance: "agent_verify: [读文件] 设计文档含方案选择、设计规格 1–7、13 问化解表、W1–W14 四问表、受影响文件、系统边界变更、风险点、拆解建议、度量与退出、立法草案、没验什么。human_verify: 用户确认设计(含 5 个待拍板问题),确认后模块转 planned 并追加 IC2–IC13。"
|
|
||||||
- notes: 2026-10-04 评审团工作流 wf_60e4c430-bb1 出稿(最小文件优先方案胜出,两位评委 25/30、24/30),设计文档已写,等用户确认。产出 `docs/tasks/<日期>-intent-catalog-design.md`,以 W1–W14 为纲、书模型为体,逐条化解上面的待设计问题,写明收益度量与退出条件;完成后交用户确认,确认后模块转 planned,再用 /splitter 拆成 S/M 卡。
|
|
||||||
|
|
||||||
### ✅ IC2 — 新增 intent-catalog-guide.md:目录语法、修订钉版、goal 编译七步、确认卡与回执、离线检查
|
|
||||||
- status: done
|
|
||||||
- complexity: S
|
|
||||||
- files: docs/ai-context/intent-catalog-guide.md
|
|
||||||
- depends: IC1
|
|
||||||
- acceptance: "agent_verify: [CLI] grep -cE '^## (目录语法|修订与钉版|goal 编译|确认卡与回执|离线检查)' docs/ai-context/intent-catalog-guide.md → 5;grep -ciE 'opus|sonnet|haiku|gpt-|deepseek-' 该文件 → 0;/architect 只以「可选包装」出现;git status --porcelain → 只有该文件新增。"
|
|
||||||
|
|
||||||
### ✅ IC3 — 新增 .blueprint/catalog.md:1.0 骨架与首批 2–4 章,书签只指向 coordination §0
|
|
||||||
- status: done
|
|
||||||
- complexity: S
|
|
||||||
- files: .blueprint/catalog.md
|
|
||||||
- depends: IC2
|
|
||||||
- acceptance: "agent_verify: [CLI] grep -c 'catalog_version: 1.0' → 1;grep -cE '^## INT-[0-9]{2} ' 介于 2–4;wc -l ≤200 且 wc -c ≤8192;grep -cE '^- (status|progress|doc|files|acceptance|model):' → 0;指南中的 path 指针检查 → 0 悬空;cat .blueprint/modules/*.md | grep -c '^### ' 前后相等。human_verify: 用户逐章确认意图与不做(1.0 为大版本,人定稿),提交带 Feature-Confirmed: true。"
|
|
||||||
|
|
||||||
### ✅ IC4 — 跨 agent 纸面编译:Codex 或 DSH 按指南对书签章编译确认卡(不粘贴)
|
|
||||||
- status: done
|
|
||||||
- complexity: S
|
|
||||||
- files: .blueprint/modules/intent-catalog.md
|
|
||||||
- depends: IC3
|
|
||||||
- notes: 2026-10-04 报备改断言:目标章由「书签章」改为指定 INT-02。理由:书签所指的 INT-01(P8)卡在统筹会话的 agent-client-parity.md 中,且几乎全为 ✅,纸面编译无测试价值;INT-02 挂有 IC6–IC10 五张待做卡,纸面编译即 IC5 的预演。
|
|
||||||
- result: 2026-10-04 Codex 纸面编译通过:9 个字段齐全;标签 blob 8392d18 等于目录 blob;5 条终点可追溯到 IC6–IC10 的 agent_verify;按当时的黑名单命中 0。Codex 环境起不了 Bash,改用语义等价的 PowerShell 执行;它报告的 5 处指南不足和主会话核对时发现的 2 处(字节数量法与平台有关;确认卡终点被改写成「均符合预期」,与 /goal 文本写法不一致)已修进指南。按新黑名单,该卡第 1 条终点会命中「符合预期」,这正是本次的发现。
|
|
||||||
- acceptance: "agent_verify: [CLI] git log -1 --grep='IC4' --format=%B → 含 项目、分支/worktree、HEAD、纳入卡、终点、终验待办、停止找人、没验什么、作废 9 字段与 Compiled-By: <非 Claude 客户端>;标签 blob 等于该提交中 .blueprint/catalog.md 的短 blob;每条终点可在来源卡 agent_verify 原文找到;过程词黑名单 grep → 0。"
|
|
||||||
|
|
||||||
### 📋 IC5 — 首次真实 /goal:为 Phase 4 的卡编译 → 人粘贴 → 收口回执
|
|
||||||
- status: todo
|
|
||||||
- complexity: S
|
|
||||||
- files: 收口提交 body 与 PR body;纳入卡的 intent 与终验行
|
|
||||||
- depends: IC4, P8 收口
|
|
||||||
- acceptance: "agent_verify: [CLI] git log --grep='^Goal-Receipt: INT-' --format=%B → ≥1 条,含 Goal-Cards、Goal-Result、Goal-Rounds、Goal-Interventions、Not-Verified、Human-Pending;纳入卡标题前缀均为 ✅;含 human_verify 的纳入卡各有一行终验;^### 计数增量等于新增卡数。human_verify: 人粘贴 /goal 并判定 Goal-Result。"
|
|
||||||
|
|
||||||
### 📋 IC6 — intent-gate.cjs 核心:结构、防膨胀、类型指针、卡侧引用,加 --self-test
|
|
||||||
- status: todo
|
|
||||||
- complexity: M
|
|
||||||
- intent: INT-02@1.0
|
|
||||||
- files: .claude/hooks/intent-gate.cjs
|
|
||||||
- depends: IC3, P8 收口
|
|
||||||
- acceptance: "agent_verify: [gate 脚本] node .claude/hooks/intent-gate.cjs --self-test → exit 0 且输出 self-test ok,内置 6 类坏样例(悬空 path:、未知 INT、超长字段、status: 键、card: 指向不存在的卡、探索章缺预算或收敛信号)各恰好 1 条警告;node .claude/hooks/intent-gate.cjs → exit 0、真实目录 0 警告;INTENT_CATALOG=/nonexistent → 无输出、exit 0。"
|
|
||||||
|
|
||||||
### 📋 IC7 — 门控只读视图 --report/--impact/--pending 与目录提交审计
|
|
||||||
- status: todo
|
|
||||||
- complexity: M
|
|
||||||
- intent: INT-02@1.0
|
|
||||||
- files: .claude/hooks/intent-gate.cjs
|
|
||||||
- depends: IC6
|
|
||||||
- acceptance: "agent_verify: [gate 脚本] --self-test 夹具:章 rev 1.1 而 📋 卡钉 1.0 → --impact 报 stale;钉墓碑章 → orphan;只有模块默认挂靠 → low_confidence;前缀 🔵 而 status: todo → --report 报 divergence 并标 status_source;含 human_verify 而无终验行的 ✅ 卡 → --pending 列出;缺 Feature-Confirmed 的目录提交 → --report 审计列出;全部 exit 0,运行前后 sha256sum .blueprint/catalog.md .blueprint/modules/*.md 不变。"
|
|
||||||
|
|
||||||
### 📋 IC8 — 接线:lefthook 加 intent-gate、AGENTS.md 块外加 T5 与启动读书签、agent-button-system 单处改名
|
|
||||||
- status: todo
|
|
||||||
- complexity: S
|
|
||||||
- intent: INT-02@1.0
|
|
||||||
- files: lefthook.yml, AGENTS.md, docs/ai-context/agent-button-system.md, docs/ai-context/intent-catalog-guide.md, .blueprint/modules/intent-catalog.md
|
|
||||||
- depends: IC6, P8 收口
|
|
||||||
- acceptance: "agent_verify: [YAML 解析] lefthook.yml 可解析且 pre-commit.commands.intent-gate.run 以 || true 结尾;[cargo test] cargo test onboarding → 0 failed;[CLI] git diff -U0 AGENTS.md 全部 hunk 位于 BLUEPRINT_MANAGED_START 行之前;grep -c '意图层 — AGENTS.md' docs/ai-context/agent-button-system.md → 0;临时 worktree 内提交一次「改章文不升 rev」→ pre-commit 输出 1 条警告且提交成功,验证后移除该 worktree。"
|
|
||||||
|
|
||||||
### 📋 IC9 — cargo test 锁定 parse_module_md 忽略 intent 与终验行
|
|
||||||
- status: todo
|
|
||||||
- complexity: S
|
|
||||||
- intent: INT-02@1.0
|
|
||||||
- files: src-tauri/src/commands/blueprint.rs
|
|
||||||
- depends: P8 收口
|
|
||||||
- acceptance: "agent_verify: [cargo test] cargo test parse_module_md_ignores_intent_lines → 1 passed:含 intent、终验行与模块头 intent 的样本,和删去这些行的样本相比,tasks.len()、status、acceptance、notes 逐字段相等(只改 #[cfg(test)]);全量 cargo test 无 FAILED。"
|
|
||||||
|
|
||||||
### 📋 IC10 — 书签交接:目录书签自持三行,coordination §0 改为指向书签
|
|
||||||
- status: todo
|
|
||||||
- complexity: S
|
|
||||||
- intent: INT-02@1.0
|
|
||||||
- files: .blueprint/catalog.md, docs/tasks/2026-10-03-coordination.md
|
|
||||||
- depends: IC7, IC8
|
|
||||||
- acceptance: "agent_verify: [gate 脚本] node .claude/hooks/intent-gate.cjs → 0 警告;[CLI] grep -A3 '^## 书签' .blueprint/catalog.md → 当前、终点、确认 三行且当前章存在未撤销;coordination §0(若仍存在)含指向书签的一行;提案附 --report 与 base blob;提交带 Feature-Confirmed: true。human_verify: 用户确认书签切换。"
|
|
||||||
|
|
||||||
### 📋 IC11 — 「goal 级确认代替逐卡确认」立法提案定稿
|
|
||||||
- status: todo
|
|
||||||
- complexity: S
|
|
||||||
- files: .blueprint/modules/intent-catalog.md
|
|
||||||
- depends: IC5, P8 收口
|
|
||||||
- acceptance: "agent_verify: [读文件] 决策记录新增提案:条文、例外清单(运行中 DB、删除、human_verify、凭据与机器状态、超出纳入卡或本章、改目录、stale pin、失败 3 次)与数据(P8 期间逐卡确认次数及可合并次数、IC5 的 Goal-Result);git diff --name-only 不含 AGENTS.md 与 src-tauri/resources/。human_verify: 用户裁决采纳或否决并记录理由。"
|
|
||||||
|
|
||||||
### 📋 IC12 — enterprise 隔离 worktree 试点:catalog 加门控试点副本,规格只用 spec: 指向
|
|
||||||
- status: todo
|
|
||||||
- complexity: M
|
|
||||||
- files: E:/code-project/enterprise-system/.blueprint/catalog.md, E:/code-project/enterprise-system/.claude/hooks/intent-gate.cjs
|
|
||||||
- depends: IC9, IC10
|
|
||||||
- acceptance: "agent_verify: [gate 脚本] 试点 worktree 内 → exit 0、0 警告、spec: 指针全部可解析;副本首行含「试点副本,IC13 后替换或删除」;[CLI] 试点 worktree git status --porcelain → 只新增这 2 个文件;enterprise 主工作区 git status --porcelain 前后一致;试点分支 ≥1 条 Goal-Receipt。human_verify: 人确认一次 enterprise goal 的意图与页面结果并记 Goal-Result。"
|
|
||||||
|
|
||||||
### 📋 IC13 — 去留决策:按五项度量并入能力包或撤销
|
|
||||||
- status: todo
|
|
||||||
- complexity: S
|
|
||||||
- files: .blueprint/modules/intent-catalog.md
|
|
||||||
- depends: IC12
|
|
||||||
- acceptance: "agent_verify: [读文件] 决策记录含五项度量的前后对比,样本 ≥5 条 Goal-Receipt;撤销分支:git grep -lE 'intent-gate|catalog_version' → 只命中决策记录,AGENTS.md 无 T5,lefthook.yml 无 intent-gate 键;保留分支:另拆 blueprint-baseline 分发卡,本卡不改模板。human_verify: 用户裁决去留。"
|
|
||||||
|
|
||||||
## 决策记录
|
|
||||||
|
|
||||||
- 2026-10-04 归属:新建本模块,并入 handoff 试点的「信息归属 + 任务简报」部分;不做 blueprint-governance 的新迭代。理由:目录层叠在蓝图之上,需要独立的家;governance 已 done,开新迭代会改变全局 iteration 口径;独立模块也便于按退出条款整体撤销。
|
|
||||||
- 2026-10-04 时机:与 P8 并行做设计,只写文档、在独立 worktree 中进行;实现等 P8 收口后再做。理由:改动的文件与 P8 不重叠,设计也需要时间,等 P8 收口正好衔接。
|
|
||||||
- 2026-10-04 试点范围:先在炼境自身试用。理由:先在自己身上踩坑成本最低;enterprise 主工作区有他人的在制品,分发机制也尚未安全化。
|
|
||||||
- 2026-10-04 立法:「goal 级确认代替逐卡确认」只在设计中起草提案,P8 之后再定。理由:先用 P8 的实测数据说话;这条规则依赖「章」的定义;现在改托管块会和 P8 撞车。
|
|
||||||
- 2026-10-04 设计确认(IC1):采用最小文件优先方案,即 `.blueprint/catalog.md`、卡侧 `- intent:` 钉版和模型无关的 goal 编译指南;不选结构化 YAML 加 Rust/MCP(子项目离线时拿不到同等校验,撤销成本也最高),也不选最大化复用(会提前分发给所有子项目,还要改动 CONVENTIONS 的分类轴)。评审团 wf_60e4c430-bb1 两位评委打分为 25/30、24/30。设计中的五个待拍板问题,用户全部采纳推荐项:
|
|
||||||
- 门控脚本放在 P8 收口后,试用期只新增文档;
|
|
||||||
- IC5 首次真实 /goal 用于 P8 收口后本模块 Phase 4 的卡,不打断 P8 在制品;
|
|
||||||
- 炼境 1.0 首批章节方向为「一键接入三端可用 / 意图编译为可判定终点 / 摩擦驱动沉淀与退出」,在 IC3 逐章定稿;
|
|
||||||
- 去留阈值初定为样本 ≥5、一次判对率 ≥60%、人工介入不高于基线、每阶段改目录 ≤1 次,IC13 前可以调整;
|
|
||||||
- 接受在 AGENTS.md 块外常驻约 10 行「启动读目录引言和书签」。
|
|
||||||
- 2026-10-04 修订(用户提出,采纳推荐):增加探索章,让意图可以从迭代中结晶。起因是很多需求一开始只有模糊轮廓,甚至没有意图,要靠 MVP 反复试用才慢慢说清。原设计默认自上而下,是盲区。具体做法:
|
|
||||||
- 章新增可选字段「形态: 定型(缺省)|探索」。它是人对意图清晰度的声明,不是任务进度,因此不违反「目录不存状态」,并且只能由人确认修改。
|
|
||||||
- 探索章必填 轮廓、试探、不做、预算、收敛信号。
|
|
||||||
- 探索期的 goal 只编译本轮试验的终点;人的试用反馈记成终验行(保留/否决 + 理由),作为结晶原料。
|
|
||||||
- 收敛或预算用完时,agent 起草意图提炼,人确认后转为定型(小版本)。未收敛时由人三选一:追加预算、换方向、撤销留墓碑;agent 不得自行延长预算。
|
|
||||||
- 修修补补和直接做 MVP 不必开章,目录与卡侧 intent 一律可选。
|
|
||||||
- 同步:INT-02 措辞覆盖定型和探索两种形态;指南新增「探索章与结晶」一节和离线检查第 11 条;IC6 坏样例增至 6 类;W8 有了实质承重件;度量增加探索章三项。
|
|
||||||
@ -1,56 +0,0 @@
|
|||||||
# MVP 收口(mvp-closure)
|
|
||||||
|
|
||||||
> status: in_progress | created: 2026-10-04 | intent: INT-04 | 统筹:docs/tasks/2026-10-03-coordination.md §0
|
|
||||||
> 来源:2026-10-04 用户在 P8 达成后定下一阶段为「炼境 MVP 收口」,并定以 enterprise-system 真实开发作为验证场。
|
|
||||||
|
|
||||||
## 概述
|
|
||||||
|
|
||||||
把炼境收口到 MVP:agent 拿到子项目能开工、能自验、能交付,摩擦能闭环回传。炼境侧只做收拾(关账、清理、修文档漂移),
|
|
||||||
不开新能力;四条能力是否真的可用,在 enterprise-system 的真实开发中只读观察取证。
|
|
||||||
|
|
||||||
## 决策记录
|
|
||||||
|
|
||||||
- 2026-10-04 用户定:扩展项(部署控制面、P4b–e、P5/P6、治理缺口②③、DSH 接管、Codex 模型切换、多维视图、架构演进、
|
|
||||||
intent-catalog Phase 4+、概念占位显式化、project-dev-variables V14–V16)冻结,MVP 达成后再排;清单在统筹文档 §3。
|
|
||||||
- 2026-10-04 用户定:以 enterprise-system 真实开发验证四条能力(M5),原「开发变量人终验」(V13)并入 M5;
|
|
||||||
intent-catalog 的 enterprise 试点继续冻结,先把四条跑稳。
|
|
||||||
- 观察边界:enterprise 主工作区有在制品,炼境侧只经 MCP 只读查询取证;要改 enterprise 就开临时 worktree、走 PR。
|
|
||||||
|
|
||||||
## 任务卡
|
|
||||||
|
|
||||||
### ✅ M2 — blueprint-buff 关账
|
|
||||||
- status: done
|
|
||||||
- complexity: S
|
|
||||||
- intent: INT-04@2.0
|
|
||||||
- files: .blueprint/modules/blueprint-buff.md, .blueprint/manifest.yaml
|
|
||||||
- acceptance: "agent_verify: [shell] grep -cE '^### (📋|🔵|💭|🔴)' .blueprint/modules/blueprint-buff.md → 0 且 grep -c '^### ✅' 同文件 → 8;git -C 主仓库 log 中 2026-10-04 的 ff 合并后 git status --porcelain -- .blueprint/modules 为空(零误标)并写入 B2 卡 human_verify 证据;manifest blueprint-buff 为 status: done、progress: 100,模块决策记录写明「剩余 14% 为未更新的进度数字,核心卡已全部完成」。"
|
|
||||||
- 验收变更(2026-10-04,按自验报告纪律报备,用户在会话中选定):执行中发现 buff 12:46 把主仓库 IC10 误标 🔵,「零误标、14% 只是数字」的前提被证伪。改为:B2 卡记终验否决与证据、决策记录写明剩余缺口为方案 C 并冻结、manifest 保持 in_progress 并改 progress 90;原 acceptance 中 status: done / progress: 100 与「主仓库 .blueprint/modules 空」两项不再适用。
|
|
||||||
- verification: "2026-10-04(INT-04 goal):blueprint-buff 8 张卡全 ✅(未完成标题计数 0);B2 human_verify 记 2026-10-04 否决与 IC10 实例;决策记录新增「剩余缺口与冻结」;manifest blueprint-buff progress 86 → 90、status in_progress。"
|
|
||||||
- 为什么:manifest 记 86%,但模块 8 张卡全 ✅;唯一缺 B2 终验记录,而 2026-10-04 主仓库 6 次快进合并后 .blueprint/modules 零误标,正是 B2 的终验现象。
|
|
||||||
|
|
||||||
### ✅ M3 — 本轮临时项目与 worktree 清理
|
|
||||||
- status: done
|
|
||||||
- complexity: S
|
|
||||||
- intent: INT-04@2.0
|
|
||||||
- files: docs/tasks/2026-10-03-coordination.md
|
|
||||||
- acceptance: "agent_verify: [shell] git worktree list 不含 tmp-p7skill-review、tmp-delivery-status-review、tmp-p10-verify-mut、dev-manager-tauri-wt-p8、dev-manager-tauri-wt-intent、dev-manager-tauri-wt-p8g;[MCP] list_all_projects 不含路径带 lj-p8 的登记。human_verify: 用户手动删除统筹文档 §5「待你手动删除」所列目录与文件。"
|
|
||||||
- verification: "2026-10-04(INT-04 goal):git worktree list 按六个已清理名称计数 → 0;全局 MCP list_all_projects 完整输出(29 个项目)中 lj-p8 → 0。human_verify(手动删除 §5 所列目录与文件)待用户。顺带发现:list_all_projects 中 dev-manager-tauri 出现两条(组 f2418a3b 与 ffa9e42d),超出本卡范围,未处理。"
|
|
||||||
|
|
||||||
### ✅ M4 — 常驻文档漂移修复
|
|
||||||
- status: done
|
|
||||||
- complexity: S
|
|
||||||
- intent: INT-04@2.0
|
|
||||||
- files: docs/ai-context/project-brief.md, AGENTS.md, docs/ai-context/agent-button-system.md, docs/templates/agents-meta-rules.md, docs/tasks/2026-09-30-dev-variables-materialize.md
|
|
||||||
- acceptance: "agent_verify: [shell] ① grep -c 'onboard/' docs/ai-context/project-brief.md → ≥1;② grep -lE '^#+ 炼境自己的 Agent 按钮清单' AGENTS.md docs/ai-context/agent-button-system.md → 恰好 1 个文件,另一处改为指针;③ grep -c '1.10.0' docs/templates/agents-meta-rules.md → ≥1,且其规则正文与 src-tauri/resources/onboarding/AGENTS.md.tmpl 的 ONBOARDING_MANAGED 块逐节对照无缺漏(差异写进卡片);④ grep -c '未合入 master' docs/tasks/2026-09-30-dev-variables-materialize.md → 0;⑤ grep -c '\\.agent/task\\.md' docs/ai-context/agent-button-system.md → 0 或改为与现行做法一致的说明;pnpm typecheck exit 0。"
|
|
||||||
- 说明:只改文档,不动 resources/onboarding/ 模板(模板改动会触发指纹测试与版本升级,超出本卡)。
|
|
||||||
- verification: "2026-10-04(INT-04 goal):① project-brief 架构速查补 mcp_inject.rs 与 onboard/ 两行;② 按钮清单以 AGENTS.md 块外区为单一来源(并入 agent-button-system 版多出的 pnpm test 与一键接入两行),agent-button-system 原节改为「按钮清单的位置」指针;③ agents-meta-rules 头部改 version 1.10.0 + aligned_with,能力包五条同步为模板原文、T1/T3/T4/自查措辞同步;④ dev-variables 简报头部改为 frozen、模块已在 master;⑤ agent-button-system 持久层去掉不存在的最小接入文件,改为与单档接入一致。"
|
|
||||||
- 差异清单(agents-meta-rules ↔ AGENTS.md.tmpl ONBOARDING_MANAGED 1.10.0,全文见 meta-rules「与分发模板的对照」节): "托管块 7 节中,核心开发约束、需求对齐协议、Git 工作流三节 meta-rules 无、以模板为准不复制;能力包一节已同步,Node/pnpm 工具链只留指针;agent 按钮与验证路径——meta-rules 缺载体就近选择表、完成的定义、侦察→驻军、agent_verify/human_verify 分层与三分定位启发式,多出分工原则、按钮清单模板、降级约定(已不在托管块内);多 AI CLI 协作与交接模板内容等价。托管块外四支柱、T1–T4、铁律、自查已同步。"
|
|
||||||
|
|
||||||
### 📋 M5 — enterprise-system 实战验证四条能力
|
|
||||||
- status: todo
|
|
||||||
- complexity: M
|
|
||||||
- intent: INT-04@2.0
|
|
||||||
- depends: M2, M3, M4
|
|
||||||
- files: .blueprint/modules/mvp-closure.md
|
|
||||||
- acceptance: "agent_verify: [MCP 只读,project_id 为 enterprise 的 canonical id] ① 能开工:verify_onboarding clients 三端 converged 且 probe_client_parity all_applicable_ready=true;② 能自验:炼境日志或会话证据中至少 1 次 read_project_test_account 成功;③ 能交付:get_delivery_status 至少 1 个 PR 的 CI passed 并已合并;④ 摩擦闭环:list_envoy_returns 中 enterprise 来源的回传均有处置回执。human_verify: 用户在 enterprise 开发中确认——新会话无需手工配置即可开工;需要登录时 agent 先查炼境不索要账号(原 V13);认可该次交付;回传内容是真问题。"
|
|
||||||
- 说明:随用户开发进度积累证据,不进 M2–M4 的 /goal;证据攒够后统筹会话一次性核对并出终验清单。
|
|
||||||
@ -321,10 +321,8 @@ docs/templates/ 炼境接入包模板草案(设计层)
|
|||||||
| 能力 | 调用方式 | 通过标准 |
|
| 能力 | 调用方式 | 通过标准 |
|
||||||
|------|---------|---------|
|
|------|---------|---------|
|
||||||
| TypeScript 类型检查 | `pnpm typecheck` | 无输出,exit 0 |
|
| TypeScript 类型检查 | `pnpm typecheck` | 无输出,exit 0 |
|
||||||
| 前端单元测试 | `pnpm test` | exit 0,无 FAILED |
|
|
||||||
| Rust 单元测试 | `cargo test`(src-tauri/ 目录) | 无 FAILED |
|
| Rust 单元测试 | `cargo test`(src-tauri/ 目录) | 无 FAILED |
|
||||||
| MCP 工具调用 | 见 `src-tauri/src/mcp_tools.rs` 工具列表 | 返回 JSON,无 error 字段 |
|
| MCP 工具调用 | 见 `src-tauri/src/mcp_tools.rs` 工具列表 | 返回 JSON,无 error 字段 |
|
||||||
| 一键接入子项目 | MCP `plan_onboarding(project_id)` → 计划给用户看、用户确认 → `onboard_project(project_id, expected_digest=<计划 digest>, confirmed=true)`(两次选项相同;UI 投影为同名 Tauri command,同一本体) | 计划 `blocked` 为空;报告 `status=done`(`partial` 按 `steps`、`completion`、`next_actions` 修复后重跑即收敛;再跑一次全部 `converged`) |
|
|
||||||
| 蓝图状态读取 | 读 `.blueprint/manifest.yaml` | 文件可解析,字段完整 |
|
| 蓝图状态读取 | 读 `.blueprint/manifest.yaml` | 文件可解析,字段完整 |
|
||||||
| 蓝图状态更新 | 编辑 `.blueprint/modules/<id>.md` | 文件写入成功,格式合法 |
|
| 蓝图状态更新 | 编辑 `.blueprint/modules/<id>.md` | 文件写入成功,格式合法 |
|
||||||
|
|
||||||
|
|||||||
@ -88,8 +88,9 @@ acceptance 是 agent 自验的唯一判断依据,必须是可执行断言:
|
|||||||
|
|
||||||
### 持久层 — 目标持久化
|
### 持久层 — 目标持久化
|
||||||
让 agent 跨会话续接,不靠对话记忆:
|
让 agent 跨会话续接,不靠对话记忆:
|
||||||
- 炼境与已接入子项目:蓝图(`.blueprint/`),规范随接入包分发
|
- 炼境项目:蓝图(`.blueprint/`)
|
||||||
- 接入包只有一档(见下文「分发给子项目的方案」),不设「最小接入」,也不另设轻量任务文件
|
- 子项目完整接入:随炼境分发的蓝图规范
|
||||||
|
- 子项目最小接入:`.agent/task.md`
|
||||||
|
|
||||||
蓝图在体系里的三个角色:
|
蓝图在体系里的三个角色:
|
||||||
1. **目标的结构化载体** — 把自然语言目标翻译成带 acceptance 的可执行任务卡
|
1. **目标的结构化载体** — 把自然语言目标翻译成带 acceptance 的可执行任务卡
|
||||||
@ -178,9 +179,17 @@ Gitea PR 继续使用既有 `create_pull_request` 有界操作;Windows 本机
|
|||||||
### 原则三:acceptance 是体系的核心关节
|
### 原则三:acceptance 是体系的核心关节
|
||||||
体系其他部分都能降级,acceptance 不能将就。acceptance 写得可执行,自验才是真自验;写得模糊,整个环路是假闭合,无人值守名存实亡。
|
体系其他部分都能降级,acceptance 不能将就。acceptance 写得可执行,自验才是真自验;写得模糊,整个环路是假闭合,无人值守名存实亡。
|
||||||
|
|
||||||
## 按钮清单的位置
|
## 炼境自己的 Agent 按钮清单
|
||||||
|
|
||||||
单一来源在 AGENTS.md「炼境自己的 Agent 按钮清单」节(常驻上下文,跨工具读取),此处不复制。
|
| 能力 | 调用方式 | 通过标准 |
|
||||||
|
|------|---------|---------|
|
||||||
|
| TypeScript 类型检查 | `pnpm typecheck` | 无输出,exit 0 |
|
||||||
|
| 前端单元测试 | `pnpm test` | exit 0,无 FAILED |
|
||||||
|
| Rust 单元测试 | `cargo test`(src-tauri/ 目录) | 无 FAILED |
|
||||||
|
| MCP 工具调用 | 见 `src-tauri/src/mcp_tools.rs` 工具列表 | 返回 JSON,无 error 字段 |
|
||||||
|
| 一键接入子项目 | MCP `plan_onboarding(project_id)` → 计划给用户看、用户确认 → `onboard_project(project_id, expected_digest=<计划 digest>, confirmed=true)`(两次选项相同;UI 投影为同名 Tauri command,同一本体) | 计划 `blocked` 为空;报告 `status=done`(`partial` 按 `steps`、`completion`、`next_actions` 修复后重跑即收敛;再跑一次全部 `converged`) |
|
||||||
|
| 蓝图状态读取 | 读 `.blueprint/manifest.yaml` | 文件可解析,字段完整 |
|
||||||
|
| 蓝图状态更新 | 编辑 `.blueprint/modules/<id>.md` | 文件写入成功,格式合法 |
|
||||||
|
|
||||||
## 分发给子项目的方案
|
## 分发给子项目的方案
|
||||||
|
|
||||||
|
|||||||
@ -1,274 +0,0 @@
|
|||||||
# 意图目录编写与使用指南
|
|
||||||
|
|
||||||
> 适用对象:所有 agent(Claude Code、Codex、DSH 等)和人。本文件是意图目录语法与 goal 编译流程的**单一来源**。
|
|
||||||
> 模块:`.blueprint/modules/intent-catalog.md`。设计依据:`docs/tasks/2026-10-04-intent-catalog-design.md`(临时文件,IC3 后删除)。
|
|
||||||
> 试用期(P8 收口前)只用文档和 shell 单行命令;门控脚本 `intent-gate.cjs` 在 Phase 4 落地后替换「离线检查」一节。
|
|
||||||
|
|
||||||
意图目录 `.blueprint/catalog.md` 是蓝图之上由人持有的一层:每章写一个意图方向、怎么判断做对了、不做什么。任务卡单向挂到章上,agent 据此把意图编译成评估器能判定的 /goal。**书装意图,指向事实**:代码、状态、规格、凭据都不进目录,目录里只放指针。
|
|
||||||
|
|
||||||
| 角色 | 写什么 | 不写什么 |
|
|
||||||
|---|---|---|
|
|
||||||
| 人 | 章的意图、人看、不做;大版本修订;确认小版本、书签切换和 goal 确认卡 | 卡的状态(由 agent 判定);机器坐标的具体命令 |
|
|
||||||
| agent | 机器坐标指针、小版本提案、goal 编译、收口回执、卡上的 `- 终验:` 记录 | 章的完成状态(只能推导);替人改意图 |
|
|
||||||
| 炼境 | 无,只经 get_project_file 只读提供同一份文件 | 不编译 goal、不选模型、不判定完成 |
|
|
||||||
|
|
||||||
## 目录语法
|
|
||||||
|
|
||||||
**位置与骨架**:`.blueprint/catalog.md`,放在 modules/ 之外,依次为引言行、书签、各章、墓碑、附录。
|
|
||||||
|
|
||||||
```markdown
|
|
||||||
# 意图目录
|
|
||||||
> catalog_version: 1.0 | 前言 → path:AGENTS.md#项目定位 | 语法 → path:docs/ai-context/intent-catalog-guide.md
|
|
||||||
|
|
||||||
## 书签
|
|
||||||
- 当前 → path:docs/tasks/2026-10-03-coordination.md#0. 方针与本阶段终点
|
|
||||||
|
|
||||||
## INT-01 <章名:一个意图方向>
|
|
||||||
- rev: 1.0
|
|
||||||
- 意图: <一句话,人的原意>
|
|
||||||
- 人看: <人在投影上看到什么就算做对了>
|
|
||||||
- 机器: <可断言坐标的类型化指针,例如 card:<module>#<卡键>>
|
|
||||||
- 不做: <边界;多条用「;」分隔>
|
|
||||||
|
|
||||||
## INT-09(已撤销)
|
|
||||||
- 撤销: YYYY-MM-DD → module:<id>#决策记录
|
|
||||||
|
|
||||||
## 附录
|
|
||||||
- <名称> → <类型化指针>
|
|
||||||
```
|
|
||||||
|
|
||||||
**章导语字段**:
|
|
||||||
|
|
||||||
| 字段 | 必填 | 含义 |
|
|
||||||
|---|---|---|
|
|
||||||
| rev | 是 | 该章最后一次变更时的目录版本,不大于 catalog_version |
|
|
||||||
| 意图 | 是 | 人的原意,一句话 |
|
|
||||||
| 人看 | 是 | 人看的投影坐标(对应 human_verify) |
|
|
||||||
| 机器 | 是 | agent 可断言的坐标,只写指针,不写命令全文 |
|
|
||||||
| 不做 | 是 | 边界,agent 扩范围时的刹车 |
|
|
||||||
| 风险 | 否 | 低、中、高,或指向不可逆操作的说明 |
|
|
||||||
| 假设 | 否 | 指向既有的证伪落点(某张 spike 卡或复盘),目录里不存证伪状态 |
|
|
||||||
| 证据 | 否 | 指向已有证据(卡上的 verify 记录、PR) |
|
|
||||||
| 墙 | 否 | 关联的承重墙编号,例如 `W12,W13` |
|
|
||||||
| 形态 | 否 | `定型`(缺省)或 `探索`;只能由人确认修改,见「探索章与结晶」 |
|
|
||||||
|
|
||||||
**不必开章的情况**:只是修修补补的卡,照常做,不写 intent;属于某个已有章的,就挂上去,算补丁级。完全没有意图、直接做 MVP 的,先不开章,做两三轮以后再从试用反馈里提炼。目录和卡侧 intent 都是可选的,不会挡住任何工作。
|
|
||||||
|
|
||||||
**防膨胀(硬限制)**:
|
|
||||||
|
|
||||||
- 每个字段只写一行,不超过 120 字;
|
|
||||||
- 每个章块不超过 12 行;
|
|
||||||
- 全文件不超过 200 行、8KB;
|
|
||||||
- 禁止出现 `status`、`progress`、`doc`、`files`、`acceptance`、`model` 键,也不写模型名;
|
|
||||||
- 不设文件内修订历史,修订历史看 git log。
|
|
||||||
|
|
||||||
**类型化指针**(多个指针用「;」分隔):
|
|
||||||
|
|
||||||
| 前缀 | 写法 | 校验方式 |
|
|
||||||
|---|---|---|
|
|
||||||
| path: | `path:<相对路径>[#标题前缀]` | 文件存在;有 `#` 时标题能匹配 |
|
|
||||||
| module: | `module:<id>[#段名]` | `.blueprint/modules/<id>.md` 存在 |
|
|
||||||
| card: | `card:<module>#<卡键>` | 该模块里存在这张卡;卡键取标题去掉状态前缀后的第一个 token,例如 `IC6`、`P8e` |
|
|
||||||
| spec: | `spec:<路径>#标题` | 指向子项目已有的规格(例如 `.specify/specs/...`),只指向不复制 |
|
|
||||||
| cmd: | `cmd:<命令或工具名>` | 只校验格式,不执行 |
|
|
||||||
| W | `W1`–`W14` | 承重墙编号,定义见模块文件「承重墙」节 |
|
|
||||||
|
|
||||||
**ID 规则**:章用两位数 `INT-NN`,永不复用。撤销的章保留墓碑 `## INT-NN(已撤销)`,注意编号后面紧跟全角括号、没有空格。
|
|
||||||
|
|
||||||
**卡侧挂靠(单向)**:
|
|
||||||
|
|
||||||
- 卡上可选写一行 `- intent: INT-NN@X.Y`,放在 `- complexity:` 后面,表示这张卡服务哪一章、编译自目录哪一版。
|
|
||||||
- 模块头 blockquote 可选写 `| intent: INT-NN` 作为整个模块的默认挂靠,不带版本,影响分析里计为低置信。
|
|
||||||
- 章的「机器:」只是验收坐标,不登记成员名单。反向索引现算,不存储。
|
|
||||||
|
|
||||||
**终验记录**:卡上另起一行 `- 终验: YYYY-MM-DD 通过|否决:<理由>`,由 agent 记录人在会话里给出的裁决。不要写进 `- notes:`,因为多条 notes 后一条会覆盖前一条。
|
|
||||||
|
|
||||||
**解析器约束**:模块 md 里,「任务卡」段以外一律不用 `###`。未识别的 `##` 段下出现 `###` 会被当成任务卡。
|
|
||||||
|
|
||||||
## 修订与钉版
|
|
||||||
|
|
||||||
**版本**:引言里写一个 `catalog_version: X.Y`;每章有自己的 `rev`。这套版本号与 manifest.iteration 互不借号。
|
|
||||||
|
|
||||||
| 级别 | 什么时候 | 怎么做 | 版本变化 |
|
|
||||||
|---|---|---|---|
|
|
||||||
| 补丁 | 只改正文(卡、模块),目录不动 | agent 自主完成,照常走需求对齐协议 | 无 |
|
|
||||||
| 小版本 | 改某章的人看、机器或不做;由正文反推修改目录 | agent 提出 S 级三行确认卡,附 diff 和 base blob,人说「确认」 | Y+1;被改章的 rev = 新版本 |
|
|
||||||
| 大版本 | 增删章节、调整方向 | 人主导,agent 协助起草 | X+1、Y 归零;涉及的章更新 rev;删掉的章留墓碑;按 T4 检查 AGENTS.md「项目定位」 |
|
|
||||||
|
|
||||||
**提案**:附上目录 diff 和 base blob,base blob 用下面的命令取:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git rev-parse --short HEAD:.blueprint/catalog.md
|
|
||||||
```
|
|
||||||
|
|
||||||
人确认后提交,提交前再取一次 blob。如果已经不等于 base,说明目录被别人改过,必须重新提案,不能硬合。
|
|
||||||
|
|
||||||
**提交格式**:
|
|
||||||
|
|
||||||
- 首行:`docs(intent): <改了什么>`
|
|
||||||
- body:一句理由,必要时写来源,例如某次终验否决、某张卡的设计发现。
|
|
||||||
- 末尾:带 `Feature-Confirmed: true`。
|
|
||||||
- 目录改动单独小提交,不和代码混在一起。
|
|
||||||
|
|
||||||
**钉版**:卡写 `- intent: INT-NN@X.Y`;goal 标签写 `INT-NN@X.Y#<blob7>`。
|
|
||||||
|
|
||||||
**影响分析**:
|
|
||||||
|
|
||||||
| 判定 | 条件 | 处理 |
|
|
||||||
|---|---|---|
|
|
||||||
| stale | 卡钉的版本低于章 rev,且卡未完成 | 复核 acceptance。没变化就改钉,算补丁,并在简报里报告;有变化就按小版本走 |
|
|
||||||
| orphan | 卡钉在已撤销的章上 | 停下找人,决定改挂哪一章还是撤卡 |
|
|
||||||
| low_confidence | 卡只有模块默认挂靠,没有卡侧钉版 | 编译 goal 前补写卡侧 intent |
|
|
||||||
|
|
||||||
**在制品保护**:钉旧版的 🔵 卡照常做完,只复核 acceptance。章被撤销,或新的「不做」覆盖了这张卡时,停下找人。任何情况下都不自动改写卡。
|
|
||||||
|
|
||||||
## 探索章与结晶
|
|
||||||
|
|
||||||
意图常常不是一开始就清楚的,而是做 MVP、反复试用以后才长出来。探索章就是给这种情况用的:先写下在找什么、找多久,等意图结晶出来再改成定型章。
|
|
||||||
|
|
||||||
```markdown
|
|
||||||
## INT-04 <轮廓名>
|
|
||||||
- rev: 1.1
|
|
||||||
- 形态: 探索
|
|
||||||
- 轮廓: <人的原话,模糊也可以>
|
|
||||||
- 试探: <这一阶段想弄清的问题,例如「哪种交互最顺手」>
|
|
||||||
- 不做: <再模糊也要有的边界>
|
|
||||||
- 预算: <最多 N 轮 MVP 或 N 天>
|
|
||||||
- 收敛信号: <出现什么就说明方向定了,例如「连续两轮不再想改核心交互」>
|
|
||||||
- 证据: <各轮试验卡的指针>
|
|
||||||
```
|
|
||||||
|
|
||||||
| | 定型章 | 探索章 |
|
|
||||||
|---|---|---|
|
|
||||||
| 必填 | rev、意图、人看、机器、不做 | rev、形态: 探索、轮廓、试探、不做、预算、收敛信号 |
|
|
||||||
| 回答 | 做到什么样算对 | 我们在找什么、找多久 |
|
|
||||||
| goal 终点 | 交付终点 | 每轮试验的终点 |
|
|
||||||
| 度量 | goal 一次判对率 | 几轮收敛、是否守住预算、否决理由是否越来越少 |
|
|
||||||
|
|
||||||
**每轮试验**:
|
|
||||||
- 拆一张试验卡,挂到探索章上:`- intent: INT-NN@X.Y`。
|
|
||||||
- 人试用后,agent 把反应记成卡上的终验行:`- 终验: YYYY-MM-DD 保留|否决:<理由>`。
|
|
||||||
- 这些保留和否决的理由,就是结晶的原料。
|
|
||||||
|
|
||||||
**结晶(探索 → 定型)**:
|
|
||||||
- 收敛信号出现,或预算用完时,agent 汇总各轮终验行,起草「意图提炼」:建议的意图、人看、机器、不做,以及依据(哪几轮保留、哪几轮否决、为什么)。
|
|
||||||
- 人确认后,形态改为定型,按小版本修订:Y+1,本章 rev 更新,轮廓、试探、预算、收敛信号几行换成意图、人看、机器。
|
|
||||||
|
|
||||||
**预算用完仍未收敛**:由人三选一:
|
|
||||||
- 追加预算继续,小版本;
|
|
||||||
- 换方向重写轮廓,小版本;
|
|
||||||
- 放弃,大版本,留墓碑。
|
|
||||||
|
|
||||||
agent 不得自行延长预算。
|
|
||||||
|
|
||||||
## goal 编译
|
|
||||||
|
|
||||||
本流程只依赖读文件和 git,不依赖任何特定客户端或模型。Claude 的 /architect 只是可选包装,任何 agent 都可以照着手工执行。产出是一张目标确认卡加一段 /goal 文本。
|
|
||||||
|
|
||||||
1. **定位**
|
|
||||||
- 读 `.lian-jing/context.json` 取 project_id;记下当前分支、worktree 路径和 `git rev-parse --short HEAD`。
|
|
||||||
- 要求 `git status --porcelain -- .blueprint/catalog.md` 输出为空:目录有未提交改动时不编译。
|
|
||||||
- 取 catalog blob:`git rev-parse --short HEAD:.blueprint/catalog.md`。
|
|
||||||
2. **读书签**:书签指向当前章(P8 期间指向 coordination §0 的终点)。读该章的导语和 rev。
|
|
||||||
3. **校验**:跑「离线检查」一节的命令(Phase 4 后改为 `node .claude/hooks/intent-gate.cjs --report INT-NN --impact`)。
|
|
||||||
- 机器检查(第 1–7、9–11 条)必须全部通过。
|
|
||||||
- 第 8 条(钉版对照)和 `card:`、`#标题` 指针属于人工核对,核对结果写进确认卡;门控落地后改为全自动。
|
|
||||||
- 只要出现悬空指针、stale 或 orphan、防膨胀超限,就先修或先提案,不往下编译。
|
|
||||||
4. **收卡**
|
|
||||||
- 检查各纳入卡的 depends,未满足的写进确认卡的「前置」行。只要有未满足的前置,就只能做纸面编译,不能粘贴执行。
|
|
||||||
- depends 尽量写卡键或模块 id。像「P8 收口」这样的自然语言前置,要在确认卡里写明人工判定的结果。
|
|
||||||
- 取挂在本章、标题前缀为 📋 或 🔵 的卡。
|
|
||||||
- 没有可执行 agent_verify 的卡,列入「须先补 acceptance」,不进 goal。
|
|
||||||
5. **合成终点**
|
|
||||||
- 取各卡 agent_verify 的合取,改写成在会话里能判定的形式:贴出命令和预期输出、纳入卡前缀都是 ✅、回执已写入。
|
|
||||||
- human_verify 不进终点,单列为终验待办。
|
|
||||||
- 过程词黑名单命中数必须为 0:「按方针」「符合设计」「设计已完成」「基本完成」「符合预期」,以及任何无法从会话输出判定的形容词。
|
|
||||||
- 确认卡和 /goal 文本里的终点写法必须一致,都写「命令 → 预期输出」。不能 /goal 里写得精确,确认卡里却改写成「均符合预期」。
|
|
||||||
- **探索章**不编译「意图的终点」,只编译本轮试验的终点:
|
|
||||||
- 做出可试用的 MVP 变体,写明最小动作和可演示方式;
|
|
||||||
- 校验命令通过;
|
|
||||||
- 试验卡为 ✅ 且已写回执。
|
|
||||||
- 人的试用反馈作为终验待办,记到终验行。
|
|
||||||
- 确认卡写明这是第几轮、共几轮预算;超出预算就不编译,转入结晶或请人三选一。
|
|
||||||
6. **写停止条件**:遇到以下任一情况必须停下找人:
|
|
||||||
- human_verify;
|
|
||||||
- 写运行中的数据库;
|
|
||||||
- 删除文件、数据或分支;
|
|
||||||
- 凭据或机器状态变更;
|
|
||||||
- 超出纳入卡或本章范围;
|
|
||||||
- 需要修改目录;
|
|
||||||
- 出现 stale 或 orphan;
|
|
||||||
- 同一问题失败 3 次。
|
|
||||||
7. **输出**:一张目标确认卡(格式见下一节),加 /goal 文本,首行带同样的标签。人读完亲手粘贴就算确认;要改就重新编译。agent 不得自行启动 goal,也不得静默改写 goal 文本。
|
|
||||||
|
|
||||||
## 确认卡与回执
|
|
||||||
|
|
||||||
**目标确认卡**(兼作最小任务简报,新会话只读它就能开工):
|
|
||||||
|
|
||||||
```text
|
|
||||||
[INT-NN@X.Y#<blob7>] 目标确认卡
|
|
||||||
项目: <project_id> | 分支/worktree: <branch> @ <path> | HEAD: <sha7>
|
|
||||||
章意图: <一句> | 不做: <…>
|
|
||||||
前置: <各纳入卡的 depends 及是否满足;有未满足的,注明「仅纸面」>
|
|
||||||
形态: 定型 | 探索(第 k/N 轮;收敛信号: <…>)
|
|
||||||
纳入卡: <卡键>(来源 agent_verify 原文)、<卡键>(…)
|
|
||||||
终点(合取): 1) <命令> → <预期输出> 2) … 3) 纳入卡均 ✅ 且已写 Goal-Receipt
|
|
||||||
终验待办: <各卡 human_verify>
|
|
||||||
停止找人: <第 6 步清单>
|
|
||||||
能力入口: <校验命令,例如 pnpm typecheck / cargo test;可用的 MCP 工具>
|
|
||||||
没验什么: <编译时已知的盲区>
|
|
||||||
作废: 分支变化或 catalog blob ≠ <blob7>
|
|
||||||
```
|
|
||||||
|
|
||||||
由非 Claude 客户端编译时,在提交 body 里另加一行 `Compiled-By: <客户端名>`,用于跨 agent 验证。
|
|
||||||
|
|
||||||
**收口回执**:goal 收口时写进收口提交的 body;M 级同时复制到 PR body;炼境在线时可以再调一次 append_project_note。
|
|
||||||
|
|
||||||
```text
|
|
||||||
Goal-Receipt: INT-NN@X.Y#<blob7>
|
|
||||||
Goal-Cards: <纳入卡键列表>
|
|
||||||
Goal-Result: 判对|误判|中止(<原因>)
|
|
||||||
Goal-Rounds: <轮数>
|
|
||||||
Goal-Interventions: <人工介入次数>
|
|
||||||
Goal-Tokens: <客户端可得时填,否则 n/a>
|
|
||||||
Not-Verified: <没验什么>
|
|
||||||
Human-Pending: <待人终验项>
|
|
||||||
```
|
|
||||||
|
|
||||||
回执不写进模块决策记录,因为 UI 会把它当决策展示;也不要手改 `.blueprint/notes-archive.jsonl`,它以炼境 DB 为事实源,会被整文件重写。
|
|
||||||
|
|
||||||
## 离线检查
|
|
||||||
|
|
||||||
试用期的检查全部是 shell 单行命令,在仓库根目录执行。期望输出写在每条后面的注释里。
|
|
||||||
|
|
||||||
- **没有 Bash 时**:命令按 POSIX shell(Git Bash)写成。部分客户端的沙箱里起不了 Bash,这时可以用语义等价的命令(PowerShell 等),并在确认卡的「没验什么」里注明用了哪种替代。
|
|
||||||
- **一律逐行解析**:不要对整份文件跑一个正则,字符类会跨行吞掉换行符,把有效指针误报成悬空。
|
|
||||||
- **只读演练不写盘**:所有检查都用管道或内存字符串完成,不创建临时文件。
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# 1. 版本行恰好一行
|
|
||||||
grep -c '^> catalog_version: ' .blueprint/catalog.md # → 1
|
|
||||||
# 2. 有效章数(墓碑不计)
|
|
||||||
grep -cE '^## INT-[0-9]{2} ' .blueprint/catalog.md # → 章数
|
|
||||||
# 3. 体量
|
|
||||||
wc -l < .blueprint/catalog.md; git cat-file -s HEAD:.blueprint/catalog.md # → ≤200 行、≤8192 字节(量提交里的 blob;工作区可能是 CRLF,wc -c 会多算换行)
|
|
||||||
# 4. 禁用键与模型名
|
|
||||||
grep -cE '^- (status|progress|doc|files|acceptance|model):' .blueprint/catalog.md # → 0
|
|
||||||
# 5. path 指针可解析(没有输出即通过)
|
|
||||||
grep -oE 'path:[^ #;|]+' .blueprint/catalog.md | sed 's/^path://' | sort -u | while read -r p; do test -e "$p" || echo "悬空: $p"; done
|
|
||||||
# 6. module 指针可解析(没有输出即通过)
|
|
||||||
grep -oE 'module:[a-z0-9-]+' .blueprint/catalog.md | sed 's/^module://' | sort -u | while read -r m; do test -e ".blueprint/modules/$m.md" || echo "悬空: $m"; done
|
|
||||||
# 7. 卡侧 intent 引用的章都存在且未撤销(没有输出即通过)
|
|
||||||
comm -23 <(grep -hoE '^- intent: INT-[0-9]{2}' .blueprint/modules/*.md | grep -oE 'INT-[0-9]{2}' | sort -u) <(grep -oE '^## INT-[0-9]{2} ' .blueprint/catalog.md | grep -oE 'INT-[0-9]{2}' | sort -u)
|
|
||||||
# 8. 钉版与章 rev 对照(人工比对:钉的版本低于 rev 且卡未完成,即为 stale)
|
|
||||||
grep -hoE 'intent: INT-[0-9]{2}@[0-9]+\.[0-9]+' .blueprint/modules/*.md | sort | uniq -c
|
|
||||||
awk '/^## INT-[0-9]{2} /{c=$2} /^- rev:/{print c, $3}' .blueprint/catalog.md
|
|
||||||
# 9. 改模块 md 前后的任务卡计数应相等(新增卡时等于新增数),防止误写 ###
|
|
||||||
cat .blueprint/modules/*.md | grep -c '^### '
|
|
||||||
# 10. 确认卡和 /goal 文本的过程词黑名单(用管道检查,不写临时文件)
|
|
||||||
printf '%s\n' "$GOAL_TEXT" | grep -cE '按方针|符合设计|设计已完成|基本完成|符合预期' # → 0
|
|
||||||
# 11. 探索章的必填字段齐全(没有输出即通过)
|
|
||||||
awk '/^## /{if(e&&!(b&&s))print "缺预算或收敛信号: "c; c=$2;e=0;b=0;s=0} /^- 形态: 探索/{e=1} /^- 预算:/{b=1} /^- 收敛信号:/{s=1} END{if(e&&!(b&&s))print "缺预算或收敛信号: "c}' .blueprint/catalog.md
|
|
||||||
```
|
|
||||||
|
|
||||||
card: 指针目前只能人工核对,到模块文件里搜索卡键,Phase 4 后由门控自动校验。指针中带 `#标题` 的部分,也是同样的人工核对方式。
|
|
||||||
@ -30,8 +30,6 @@ src-tauri/src/credential_store.rs Windows 本机凭证引用、校验与兼容
|
|||||||
src-tauri/src/mcp_server.rs MCP Server(agent 调用炼境的入口)
|
src-tauri/src/mcp_server.rs MCP Server(agent 调用炼境的入口)
|
||||||
src-tauri/src/mcp_tools.rs MCP tool schema 与 dispatch
|
src-tauri/src/mcp_tools.rs MCP tool schema 与 dispatch
|
||||||
src-tauri/src/envoy.rs 使者回传本体(三端回传写入、处置回执、待处置列表)
|
src-tauri/src/envoy.rs 使者回传本体(三端回传写入、处置回执、待处置列表)
|
||||||
src-tauri/src/mcp_inject.rs 接入注入与三端适配(canonical context、Codex 项目配置、Claude local 条目、DSH 托管块、稳定 helper 入口)
|
|
||||||
src-tauri/src/onboard/ 一键接入本体(客户端适配器注册表、写入前计划、编排与报告、L1 三端检查;不依赖 Tauri、连接注入)
|
|
||||||
src-tauri/src/commands/dev_variables.rs 项目开发变量本体(Agent 登记、人填写、受认证单项读取)
|
src-tauri/src/commands/dev_variables.rs 项目开发变量本体(Agent 登记、人填写、受认证单项读取)
|
||||||
src-tauri/src/commands/delivery_status.rs 项目交付信号聚合(Git / Gitea / 部署证据)
|
src-tauri/src/commands/delivery_status.rs 项目交付信号聚合(Git / Gitea / 部署证据)
|
||||||
src-tauri/resources/onboarding/ 接入包分发模板
|
src-tauri/resources/onboarding/ 接入包分发模板
|
||||||
|
|||||||
File diff suppressed because one or more lines are too long
@ -1,8 +1,8 @@
|
|||||||
# 测试账户落地到被忽略文件(project-dev-variables 增量)
|
# 测试账户落地到被忽略文件(project-dev-variables 增量)
|
||||||
|
|
||||||
> status: frozen(2026-10-04 MVP 收口期冻结为扩展,见统筹文档 §3)| complexity: L(拆为 3 张 M 卡)| created: 2026-09-30 | blueprint: project-dev-variables(模块已在 master;对应卡 V14–V16 为 📋)
|
> status: todo | complexity: L(拆为 3 张 M 卡)| created: 2026-09-30 | blueprint: project-dev-variables(该模块尚在 `feat/project-dev-variables` 分支,V7 blocked,未合入 master)
|
||||||
> ⚠️ 处置条款:本简报 done 后 24h 内删除;结论并入 `project-dev-variables` 模块的决策与任务卡,不让简报成为第二事实来源。
|
> ⚠️ 处置条款:本简报 done 后 24h 内删除;结论并入 `project-dev-variables` 模块的决策与任务卡,不让简报成为第二事实来源。
|
||||||
> 类型:Feature。解冻后开工前需用户确认本设计(卡已在模块内立为 V14–V16)。
|
> 类型:Feature。开工前需用户确认本设计;且须等 `project-dev-variables` 合入 master 后在其模块内立卡。
|
||||||
|
|
||||||
## 为什么(压缩背景 + 证据)
|
## 为什么(压缩背景 + 证据)
|
||||||
|
|
||||||
|
|||||||
@ -8,16 +8,8 @@
|
|||||||
|
|
||||||
- **方针**(AGENTS.md「项目定位」「管家准入与退出」):炼境是 agent 开发子项目的管家;每个子项目都能在
|
- **方针**(AGENTS.md「项目定位」「管家准入与退出」):炼境是 agent 开发子项目的管家;每个子项目都能在
|
||||||
Claude Code、Codex、DSH 三端开发,重复配置尽量消除;不过度建设,能力按实测收益保留或撤销。
|
Claude Code、Codex、DSH 三端开发,重复配置尽量消除;不过度建设,能力按实测收益保留或撤销。
|
||||||
- **本阶段终点(2026-10-04 起):炼境 MVP 收口**——agent 拿到子项目能开工、能自验、能交付,摩擦能闭环回传,四条都可用。
|
- **本阶段终点**:P8「一键接入」——新建或添加子项目后,一次确认即三端可用(P8 卡的 acceptance)。
|
||||||
必做(用户 2026-10-04 定):
|
设计:`docs/tasks/2026-10-03-p8-onboarding-oneclick-design.md`;任务卡:agent-client-parity 的 P8-0、P8a–P8g、P4-0、P4a–P4e。
|
||||||
1. project-dev-variables 人终验;
|
|
||||||
2. 核实 blueprint-buff 剩余 14% 是否核心:是就做完,否则冻结;
|
|
||||||
3. 本轮临时项目与 worktree 清理(agent 侧已做,见 §5 待手动删除);
|
|
||||||
4. 修常驻文档漂移:project-brief 目录速查补 `onboard/`、Agent 按钮清单收敛到一处、agents-meta-rules 对齐托管块 1.10.0、
|
|
||||||
dev-variables 简报头部过期、agent-button-system 里 `.agent/task.md` 的矛盾。
|
|
||||||
其余一律冻结为扩展(§3「扩展(冻结)」),MVP 期间不派单。
|
|
||||||
- **上一阶段终点 ✅**:P8「一键接入」——2026-10-04 用户终验通过(证据见 agent-client-parity P8 / P8g 卡)。
|
|
||||||
设计:`docs/tasks/2026-10-03-p8-onboarding-oneclick-design.md`。
|
|
||||||
|
|
||||||
## 1. 角色与协议
|
## 1. 角色与协议
|
||||||
|
|
||||||
@ -53,7 +45,6 @@
|
|||||||
- **MCP**:一律 `http://127.0.0.1:27190`(不用 localhost)。会话里 lian-jing 没连上时,可用 node `fetch` 直接 POST `http://127.0.0.1:27190/mcp`(全局路由,`tools/call`),结果在 `result.structuredContent` 或 `result.content[0].text`。
|
- **MCP**:一律 `http://127.0.0.1:27190`(不用 localhost)。会话里 lian-jing 没连上时,可用 node `fetch` 直接 POST `http://127.0.0.1:27190/mcp`(全局路由,`tools/call`),结果在 `result.structuredContent` 或 `result.content[0].text`。
|
||||||
- **变异验证**:先 `git add` 暂存,再改源码做变异、跑测试,最后 `git checkout -- <文件>` 从暂存区还原。没暂存就 checkout 会丢掉改动(统筹会话踩过)。
|
- **变异验证**:先 `git add` 暂存,再改源码做变异、跑测试,最后 `git checkout -- <文件>` 从暂存区还原。没暂存就 checkout 会丢掉改动(统筹会话踩过)。
|
||||||
- **真实客户端**:`claude -p`、`codex exec`、DSH headless 可能跑 3 分钟以上,只在会话主线程或后台 bash 里跑,不交给 Workflow 子 agent(超过 180 秒会被判卡死)。嵌套 claude 前先 `unset CLAUDECODE CLAUDE_CODE_ENTRYPOINT CLAUDE_CODE_SSE_PORT`,stdin 重定向自 `/dev/null`。
|
- **真实客户端**:`claude -p`、`codex exec`、DSH headless 可能跑 3 分钟以上,只在会话主线程或后台 bash 里跑,不交给 Workflow 子 agent(超过 180 秒会被判卡死)。嵌套 claude 前先 `unset CLAUDECODE CLAUDE_CODE_ENTRYPOINT CLAUDE_CODE_SSE_PORT`,stdin 重定向自 `/dev/null`。
|
||||||
- **工作流看门狗**:Workflow 子 agent 超过 180 秒没有进展即判卡死重试——一次性生成大文件(如整个 React 组件)、或前台跑长命令都会触发(P8e 修复阶段、P8g 实现阶段各卡死 6 次)。写文件分小块(单次 Write/Edit 约 150 行内),长命令一律后台轮询;UI 等需要大段生成的卡改用后台 Agent 执行。
|
|
||||||
- **凭据**:不读、不打印任何 token、凭据、`.env` 值;不对真实 Windows Credential Manager 做并发压力实验。
|
- **凭据**:不读、不打印任何 token、凭据、`.env` 值;不对真实 Windows Credential Manager 做并发压力实验。
|
||||||
- **运行中的炼境 DB 写入**:自动模式下会被安全分类器拦截,这是对的。需要写 DB 的数据修复准备好脚本、备份和空跑结果,交用户执行。
|
- **运行中的炼境 DB 写入**:自动模式下会被安全分类器拦截,这是对的。需要写 DB 的数据修复准备好脚本、备份和空跑结果,交用户执行。
|
||||||
- **提交**:Conventional Commits;`feat:` 带 `Feature-Confirmed: true`;末尾带 `Co-Authored-By` 署名行。PR 描述按自验报告纪律写,含「没验什么」一节。M 级卡开 PR 前用一个只读子代理做独立审查,审查处置写进卡片。
|
- **提交**:Conventional Commits;`feat:` 带 `Feature-Confirmed: true`;末尾带 `Co-Authored-By` 署名行。PR 描述按自验报告纪律写,含「没验什么」一节。M 级卡开 PR 前用一个只读子代理做独立审查,审查处置写进卡片。
|
||||||
@ -69,18 +60,11 @@
|
|||||||
| ~~3~~ | ~~P8d onboard_project 编排本体~~ ✅ | M | P8c、P4a 合并后 | 复用 `onboard::plan::write_project_files` 与 `onboard::clients::registry()`;apply 前先重算计划并核对 digest |
|
| ~~3~~ | ~~P8d onboard_project 编排本体~~ ✅ | M | P8c、P4a 合并后 | 复用 `onboard::plan::write_project_files` 与 `onboard::clients::registry()`;apply 前先重算计划并核对 digest |
|
||||||
| 4 | P8e 投影收口与契约同步 | S | P8d 后 | |
|
| 4 | P8e 投影收口与契约同步 | S | P8d 后 | |
|
||||||
| 5 | P8f register_project 控制面投影 | S | 已提前并行(只依赖 P8-0) | [MCP] 链路实测待 P8e 合并后做 |
|
| 5 | P8f register_project 控制面投影 | S | 已提前并行(只依赖 P8-0) | [MCP] 链路实测待 P8e 合并后做 |
|
||||||
| ~~6~~ | ~~P8g UI 一键接入~~ ✅ | M | P8e 后 | human_verify 交用户 |
|
| 6 | P8g UI 一键接入 | M | P8e 后 | human_verify 交用户 |
|
||||||
| ~~并行~~ | ~~删除项目登记时一并解绑 Gitea 仓库~~ ✅ G8 | S/M | master | 来自重复登记排查会话的推荐任务卡(轮询会继续往已删除的项目 ID 写数据),主要改 projects.rs / gitea.rs,可并行 |
|
| ~~并行~~ | ~~删除项目登记时一并解绑 Gitea 仓库~~ ✅ G8 | S/M | master | 来自重复登记排查会话的推荐任务卡(轮询会继续往已删除的项目 ID 写数据),主要改 projects.rs / gitea.rs,可并行 |
|
||||||
| MVP-1 | project-dev-variables 人终验 → 并入 mvp-closure M5 | — | — | 用户 2026-10-04 定:以 enterprise-system 真实开发验证四条能力(开工/自验/交付/摩擦闭环),原 V13 终验并入;炼境侧只经 MCP 只读取证 |
|
| 后续 | P6(依赖 P8c)、P4c / P4d / P4e、A4→P4b、P5 | | | P8 完成后再排 |
|
||||||
| MVP-2 | blueprint-buff 关账 → mvp-closure M2 ✅ | S | master | 8 张卡全 ✅,但 B2 终验被否决(IC10 误标),剩余为方案 C、冻结;模块保持 in_progress 90% |
|
|
||||||
| MVP-3 | 本轮清理 → mvp-closure M3 | — | — | 2026-10-04 agent 侧已完成(取消登记 2 个、删 worktree 5 个),剩 §5 的手动删除 |
|
|
||||||
| MVP-4 | 常驻文档漂移修复 → mvp-closure M4 | S | master | 纯文档可直推;碰 agents-meta-rules 时同步检查接入包模板版本 |
|
|
||||||
| 扩展(冻结) | 部署控制面(project-capability-control-plane)、P4b–P4e、P5、P6、治理缺口 ②③(governance-feedback-loop)、DSH 接管(dsh-takeover-readiness)、Codex 模型切换(codex-model-switch)、多维视图(manage-multi-view)、架构演进(architecture-evolution)、intent-catalog Phase 4+(IC6–IC13:门控脚本、接线、书签交接、enterprise 试点——用户 2026-10-04 定继续冻结)、project-dev-variables V14–V16(测试账户落地到被忽略文件)、blueprint-buff 方案 C(files 重叠改记 DB 信号,B2 终验 2026-10-04 被否决后的升级路径) | | | 2026-10-04 用户定:MVP 收口期间不派单,MVP 达成后再排 |
|
|
||||||
| 扩展(冻结) | 概念占位登记显式化(UI 不选目录的占位登记) | S | — | 用户 2026-10-04 定:MVP 保持现状;出现具体干扰(诊断、统计、接入入口把占位当普通项目)再出 S 级确认卡 |
|
|
||||||
| 后续小修 | P8f 审查转入:L4 路径归一函数统一到 crate::path_key(含 Codex 信任路径、WSL 发行版与 UNC 换算)、I1 update_project 有效根变化才查重并排除自身、I2 project_root_with_conn 拼接 UNC 形式 wsl_path 的已有缺陷 | S | master | 碰 mcp_inject.rs,P8 主线后再做 |
|
| 后续小修 | P8f 审查转入:L4 路径归一函数统一到 crate::path_key(含 Codex 信任路径、WSL 发行版与 UNC 换算)、I1 update_project 有效根变化才查重并排除自身、I2 project_root_with_conn 拼接 UNC 形式 wsl_path 的已有缺陷 | S | master | 碰 mcp_inject.rs,P8 主线后再做 |
|
||||||
| 后续小修 | backfill_notes_archive 静默跳过非 UTF-8 旧笔记(dev-manager-tauri 有 4 条);PR #34 审查遗留 L3(保留他项目 Codex 块不留痕)、L4(沉默统计并列偏向非规范 ID,补测试)、I1(注释说明两处语义差异)、I2(沉默列表带 id) | S | master | 不碰 P8 热点文件的可并行 |
|
| 后续小修 | backfill_notes_archive 静默跳过非 UTF-8 旧笔记(dev-manager-tauri 有 4 条);PR #34 审查遗留 L3(保留他项目 Codex 块不留痕)、L4(沉默统计并列偏向非规范 ID,补测试)、I1(注释说明两处语义差异)、I2(沉默列表带 id) | S | master | 不碰 P8 热点文件的可并行 |
|
||||||
| 后续小修 | P8g 审查 ④:L1 格子由本体带 pending_user(目前 onboardView.ts 写死 codex_project_untrusted 着色);面板状态机(过期响应、refused 回预览)补组件测试;终验记下的文案:新建文件「查看差异」只有一行概要改行内显示,git_hooks 与 Claude/DSH 行「已写入」标签重复或不准 | S | master | 碰 probe_l1.rs / onboardView.ts |
|
|
||||||
| 说明 | 上面三行「后续小修」在 MVP 期间同样冻结,除非某条被证实阻碍 MVP 四条可用性 | | | |
|
|
||||||
| 待用户 | beast-mode 同路径重复登记(beast-mode / 940dfbb4,无 Gitea 绑定) | — | — | 需写运行中 DB 与删除登记,按 U3 同法准备脚本后交用户执行 |
|
| 待用户 | beast-mode 同路径重复登记(beast-mode / 940dfbb4,无 Gitea 绑定) | — | — | 需写运行中 DB 与删除登记,按 U3 同法准备脚本后交用户执行 |
|
||||||
|
|
||||||
## 4. 派单与 PR 流水(统筹维护)
|
## 4. 派单与 PR 流水(统筹维护)
|
||||||
@ -94,25 +78,16 @@
|
|||||||
| 10-03 | 删除登记时解绑 Gitea(G8) | 工作流 wf_c121815d-6ea | PR #35(fccb767) | ✅ 审查可合并、5 条已处置;真机删除实测为可选人工验证(涉及删除与写 DB) |
|
| 10-03 | 删除登记时解绑 Gitea(G8) | 工作流 wf_c121815d-6ea | PR #35(fccb767) | ✅ 审查可合并、5 条已处置;真机删除实测为可选人工验证(涉及删除与写 DB) |
|
||||||
| 10-03 | P4a L1 零模型三端检查 | 工作流 wf_b7092645-570(修复阶段被分类器拦截,统筹接手收尾) | PR #38(a79bcb7)→ cf2b5f0 | ✅ [MCP] 实测:enterprise 3.3 秒三端 18 格 ready;dev-manager-tauri 控制面 Claude/DSH not_applicable、Codex ready |
|
| 10-03 | P4a L1 零模型三端检查 | 工作流 wf_b7092645-570(修复阶段被分类器拦截,统筹接手收尾) | PR #38(a79bcb7)→ cf2b5f0 | ✅ [MCP] 实测:enterprise 3.3 秒三端 18 格 ready;dev-manager-tauri 控制面 Claude/DSH not_applicable、Codex ready |
|
||||||
| 10-03 | P8d onboard_project 编排本体 | 工作流 wf_004ffc20-7cb | PR #39(2f2a9f1)→ d018d44 | ✅ 审查 10 条已处置;master 402 passed;⑩ 统筹决定:Codex 未信任计 next_action 不计入 done(P8e 实现) |
|
| 10-03 | P8d onboard_project 编排本体 | 工作流 wf_004ffc20-7cb | PR #39(2f2a9f1)→ d018d44 | ✅ 审查 10 条已处置;master 402 passed;⑩ 统筹决定:Codex 未信任计 next_action 不计入 done(P8e 实现) |
|
||||||
| 10-03 | P8e 投影收口与契约同步 | 工作流 wf_551dc525-270(修复阶段卡死 6 次,审查已可合并,统筹以 97578b2 开 PR) | PR #40 → d7f4816 | ✅ 端到端:新登记项目 done、重复执行全 converged;enterprise 因主工作区落后不 apply(偏差已报备) |
|
| 10-03 | P8e 投影收口与契约同步 | 工作流 wf_551dc525-270 | `feat/agent-client-parity-p8e` | 执行中 |
|
||||||
| 10-03 | P8g UI 一键接入 | 工作流 wf_531cfcda-b1a 实现阶段 6 次 180 秒无进展被判卡死(未产出代码,属执行方式问题、不计自验失败)→ 改派后台 Agent(无看门狗,分块写文件)也流卡死 → 10-04 新统筹会话主线程直做(续用半成品 onboardView.ts,分块写入) | PR #41(c28caf7)→ 3228b49 | ✅ 审查 merge、5 条:4 修 1 转后续小修(L1 格子带 pending_user);master typecheck 通过、vitest 29 passed、全量 cargo test 414 passed;human_verify 待用户 |
|
|
||||||
| 10-03 | P8f register_project 控制面投影(含登记拒绝同路径,承接 PR #34 审查 L1/L2) | 工作流 wf_2462357e-604(与 P4a 并行,开 PR 前合并 master) | `feat/agent-client-parity-p8f` | PR #37(04470bd)→ 55dc637 已合并;审查 10 条:7 修、1 部分修、M2 恢复 UI 概念占位原行为(产品问题待用户澄清)、2 转后续;卡片 🔵,[MCP] 链路实测待 P8e 合并 |
|
| 10-03 | P8f register_project 控制面投影(含登记拒绝同路径,承接 PR #34 审查 L1/L2) | 工作流 wf_2462357e-604(与 P4a 并行,开 PR 前合并 master) | `feat/agent-client-parity-p8f` | PR #37(04470bd)→ 55dc637 已合并;审查 10 条:7 修、1 部分修、M2 恢复 UI 概念占位原行为(产品问题待用户澄清)、2 转后续;卡片 🔵,[MCP] 链路实测待 P8e 合并 |
|
||||||
| 10-03 | 重复登记修复 U1/U2 | 会话 `local_d2e1c156…`(「排查炼境 dev-manager-tauri 疑似重复登记」) | PR #34 → fc280db | ✅ 独立审查可合并、已合并,炼境已重编译;审查遗留 L1/L2 归 P8f(登记拒绝同路径),L3/L4/I1/I2 列入后续小修 |
|
| 10-03 | 重复登记修复 U1/U2 | 会话 `local_d2e1c156…`(「排查炼境 dev-manager-tauri 疑似重复登记」) | PR #34 → fc280db | ✅ 独立审查可合并、已合并,炼境已重编译;审查遗留 L1/L2 归 P8f(登记拒绝同路径),L3/L4/I1/I2 列入后续小修 |
|
||||||
| 10-03 | 重复登记数据合并 U3 | 同上(用户执行 DB 写入) | master 91017b6;主仓库 .codex/config.toml 升级为稳定 helper 格式 06f20db | ✅ 无 2c5b54ef 残留、同路径 1 条登记、Gitea 绑定 1 行;备份 dev-manager.backup-20261003-before-dedupe.db |
|
| 10-03 | 重复登记数据合并 U3 | 同上(用户执行 DB 写入) | master 91017b6;主仓库 .codex/config.toml 升级为稳定 helper 格式 06f20db | ✅ 无 2c5b54ef 残留、同路径 1 条登记、Gitea 绑定 1 行;备份 dev-manager.backup-20261003-before-dedupe.db |
|
||||||
| 10-04 | 意图目录线 IC1–IC4(并行线交接登记) | 另一会话 | PR #42–#45 → master 0ffaad0 | ✅ 设计 docs/tasks/2026-10-04-intent-catalog-design.md、指南 docs/ai-context/intent-catalog-guide.md、目录 .blueprint/catalog.md 1.0(INT-01–03,书签暂指本文件 §0);Codex 跨客户端纸面编译通过;模块进度 31%。IC5(首次真实 /goal)可用「MVP 收口」做;Phase 4+(IC6–IC13)冻结为扩展;目录改动按指南走(小版本须用户确认,提交带 Feature-Confirmed) |
|
|
||||||
| 10-04 | 阶段切换与清理 | 统筹会话 | master 直推 | P8 达成;§0 终点改为「MVP 收口」,扩展冻结登记进 §3;临时登记 2 条与 worktree 5 个已清理,手动删除项见 §5 |
|
|
||||||
|
|
||||||
## 5. 待用户处理(统筹会话汇总,按时机)
|
## 5. 待用户处理(统筹会话汇总,按时机)
|
||||||
|
|
||||||
- ~~重复登记数据合并~~:已由用户执行完毕并验收(见 §4)。
|
- ~~重复登记数据合并~~:已由用户执行完毕并验收(见 §4)。
|
||||||
- ~~P8 human_verify~~:2026-10-04 用户终验通过(证据见 P8g 卡 human_verify),**本阶段终点 P8 达成**。
|
- **临时文件待用户清理**(deny 规则禁止 agent 删除):E: mperify_before.json;重复登记会话 %TEMP% 下的 merge_dup.py 等;统筹会话 %TEMP% 下的 lj-p4-0、lj-p7-probe、lj-p9-spike 等探针目录;已合并分支的 worktree(tmp-p7skill-review、tmp-delivery-status-review、tmp-p10-verify-mut、dev-manager-tauri-wt-p8)可用 git worktree remove 清理。
|
||||||
- **本轮清理(2026-10-04 用户确认删除,agent 侧已完成)**:unregister_project 删除 lj-p8-e2e-20261003(ac73a4bb…)与 lj-p8g-ui-test(5818aa5a…)两条登记(本地文件未动);git worktree remove:tmp-p7skill-review、tmp-delivery-status-review、tmp-p10-verify-mut(含审查探针测试,--force 丢弃)、dev-manager-tauri-wt-p8、dev-manager-tauri-wt-intent(已注销,空目录删不掉,可能被 Codex 侧边栏占用);dev-manager-tauri-wt-p8g 在本次文档提交后移除。
|
- **需求澄清(不阻塞主线)**:UI「添加项目」不选目录时可建「概念占位」登记(P8f 已保留原行为)。是否要把占位做成显式概念(单独入口、标记为占位、不参与接入),等你决定。
|
||||||
- **待你手动删除**(deny 规则禁止 agent 删除):
|
|
||||||
- 目录:`E:\code-project\lj-p8-e2e-20261003`、`E:\code-project\lj-p8g-ui-test`、`E:\code-project\lj-p8g-ui-cancel`(误建、未登记)、`E:\code-project\dev-manager-tauri-wt-intent`(空目录)、`E:\code-project\dev-manager-tauri-wt-p8g`(若移除后残留);
|
|
||||||
- 文件:`E:\verify_before.json`;
|
|
||||||
- `%TEMP%` 下:重复登记会话的 `merge_dup.py` 等,统筹会话的 `lj-p4-0`、`lj-p7-probe`、`lj-p9-spike` 等探针目录,`tmp.h9jWUlwgmv\`(意图目录探索章检查夹具);
|
|
||||||
- 可选:Codex 信任表(`~/.codex/config.toml`)里 `e:\code-project\lj-p8g-ui-test` 的信任条目。
|
|
||||||
- ~~需求澄清:概念占位登记~~:用户 2026-10-04 定 MVP 保持现状、列入扩展(§3)。
|
|
||||||
- **Codex 信任**:Codex 只在目录受信任后加载项目 `.codex/config.toml`(P4-0 H-P8-1)。一键接入会把它列进 next_actions,炼境不改 Codex 的信任表。
|
- **Codex 信任**:Codex 只在目录受信任后加载项目 `.codex/config.toml`(P4-0 H-P8-1)。一键接入会把它列进 next_actions,炼境不改 Codex 的信任表。
|
||||||
|
|
||||||
## 6. 当前已知事实(易变,以工具自省为准)
|
## 6. 当前已知事实(易变,以工具自省为准)
|
||||||
@ -120,55 +95,3 @@
|
|||||||
- `verify_onboarding(enterprise)` 的 `clients` 三端均 converged。
|
- `verify_onboarding(enterprise)` 的 `clients` 三端均 converged。
|
||||||
- `list_all_projects`:除 enterprise 外,其余登记项目大多缺项目 token(历史接入早于 token 机制),这些正是一键接入要接的对象。
|
- `list_all_projects`:除 enterprise 外,其余登记项目大多缺项目 token(历史接入早于 token 机制),这些正是一键接入要接的对象。
|
||||||
- 使者回传:0 条待处置。
|
- 使者回传:0 条待处置。
|
||||||
|
|
||||||
## 7. 交接(2026-10-04,统筹会话上下文将满,换新会话继续)
|
|
||||||
|
|
||||||
> **已执行完毕(2026-10-04)**:本节的 P8g 与收尾全部完成,见 §4;下一阶段按 §0「MVP 收口」推进。本节保留作交接记录。
|
|
||||||
|
|
||||||
新会话即新的统筹会话:先读本文件 §1–§6,再按下面接手。旧统筹会话的 30 分钟巡检已停止。
|
|
||||||
|
|
||||||
**当前状态**
|
|
||||||
- ✅:P4a(PR #38)、P8c(#36)、P8d(#39)、P8e(#40)、P8f(#37),以及 G8(#35)、PR #34。
|
|
||||||
- 证据都写在 `.blueprint/modules/agent-client-parity.md` 各卡的 mcp_verify / merge_verify,以及 P8 卡的 e2e_verify:
|
|
||||||
- 新登记临时项目 `ac73a4bb-a601-4e21-bc0f-7eda71fae4aa`(目录 E:\code-project\lj-p8-e2e-20261003)走完 register → plan → onboard_project,得 done;
|
|
||||||
- 再执行一次 9 步全部收敛,文件 mtime 不变。
|
|
||||||
- master 最近一次全量回归:P8d 合并后 cargo test 402 passed。P8e(d7f4816)的分支自测为 413 passed,但合并后在 master 上还没跑全量,收尾时要跑。
|
|
||||||
|
|
||||||
**唯一未完成:P8g UI 一键接入(🔵)**
|
|
||||||
- worktree:E:/code-project/dev-manager-tauri-wt-p8g,分支 feat/agent-client-parity-p8g,基于 51a39d0,未提交、未推送。
|
|
||||||
- 已有的半成品改动:
|
|
||||||
- src-tauri/src/onboard/plan.rs(+38,执行 agent 称 Rust 侧 414 passed);
|
|
||||||
- src/lib/commands.ts(+2);
|
|
||||||
- P8g 卡已标 🔵;
|
|
||||||
- 新文件 src/components/dashboard/onboardView.ts 只写了一部分。
|
|
||||||
- 委派失败两次(工作流 180 秒看门狗卡死 6 次;后台 Agent 600 秒流卡死),都卡在一次性生成大文件。**在新会话主线程里直接做**:
|
|
||||||
- 先审一遍上面的半成品,保留就续写、不保留就从头写;
|
|
||||||
- 单次 Write/Edit 不超过约 150 行,长命令放后台轮询。
|
|
||||||
- 范围以 P8g 卡的 acceptance 为准:onboardView.ts 加 vitest 视图纯函数测试、OnboardPanel.tsx、各入口接线。
|
|
||||||
|
|
||||||
**收尾到 /goal 终点**
|
|
||||||
1. P8g:
|
|
||||||
- pnpm typecheck 与 pnpm test 通过;
|
|
||||||
- 做一次只读独立审查并处置;
|
|
||||||
- 开 PR,CI passed 后按完整 head SHA 合并;
|
|
||||||
- 主仓库 git merge --ff-only origin/master(不碰用户的 3 个未提交文件:notes-archive.jsonl、usage.json、Cargo.toml——前两个会被运行中的炼境自动写入,Cargo.toml 只差行尾)。
|
|
||||||
2. 在 master 上跑 pnpm typecheck 与全量 cargo test(CARGO_TARGET_DIR 用 parity 热缓存),结果写进 P8g 卡。
|
|
||||||
3. P8g 卡标 ✅(agent_verify 已过;human_verify 交给用户),更新 manifest 进度与本文件 §4。
|
|
||||||
4. 向用户汇报证据,并列出:
|
|
||||||
- human_verify:
|
|
||||||
- Codex 里信任 E:\code-project\lj-p8-e2e-20261003 后重跑 probe_client_parity,C–F 应变为 ready;
|
|
||||||
- Claude Code、Codex、DSH 桌面 GUI 各新开会话,调用 read_project_test_account(name=LJ_PROBE_NONEXISTENT),应返回「开发需求未登记」;
|
|
||||||
- P8g 界面终验;
|
|
||||||
- 删除确认:端到端临时项目(unregister_project 后手删目录);
|
|
||||||
- 各执行 agent 留下的临时文件。
|
|
||||||
|
|
||||||
**后续(P8 终点之后)**
|
|
||||||
- §3 的「后续小修」:
|
|
||||||
- P8e 审查的 3 条低优先级与 5 条信息项(修复半成品还在 E:/code-project/dev-manager-tauri-wt-p8e,未提交);
|
|
||||||
- 结构化工具应同时在 content 里返回序列化 JSON(MCP 规范建议,否则只读 content 的客户端看不到计划细节);
|
|
||||||
- backfill 跳过非 UTF-8 旧笔记;
|
|
||||||
- P8f 审查转入项。
|
|
||||||
- 其他:
|
|
||||||
- 接入包模板改为引导 plan_onboarding → onboard_project(需升版本);
|
|
||||||
- beast-mode 重复登记(需用户执行 DB 写入);
|
|
||||||
- 占位登记的需求澄清。
|
|
||||||
|
|||||||
@ -1,353 +0,0 @@
|
|||||||
# 设计决策:意图目录(intent-catalog)· IC1
|
|
||||||
|
|
||||||
> status: 已确认(2026-10-04,五项待拍板全部采纳推荐)| complexity: L(本文只到设计,实现拆为 IC2–IC13)| created: 2026-10-04 | blueprint: intent-catalog
|
|
||||||
> 修订 2026-10-04:增加探索章(意图从迭代中结晶),见模块决策记录与指南「探索章与结晶」;本文未逐节同步。
|
|
||||||
> ⚠️ 处置条款:用户确认后,稳定结论回写 `.blueprint/modules/intent-catalog.md`(决策记录与任务卡),本文件在 IC3 完成后 24h 内删除,不做第二事实来源。
|
|
||||||
> 产出方式:/architect 评审团工作流 wf_60e4c430-bb1。3 个独立方案(最小文件优先、结构化优先、最大化复用)交 2 位评委(agent 友好度与成本、治理与风险)打分,由综合者定稿;关键代码事实已由主会话复核。
|
|
||||||
|
|
||||||
## 背景
|
|
||||||
|
|
||||||
- 需求本体见 `.blueprint/modules/intent-catalog.md`,包括两层模型、W1–W14 承重墙、13 个待设计问题和「不做什么」。
|
|
||||||
- 并入 `docs/tasks/2026-09-23-blueprint-agent-handoff-pilot.md` 的「信息归属与同步契约」与「最小任务简报的按需读取与回执」。
|
|
||||||
- 关联模块:
|
|
||||||
- blueprint-governance:前置,负责安全派发与状态语义收敛。
|
|
||||||
- agent-client-capability-packs:版本化 pack 机制。
|
|
||||||
- governance-feedback-loop:修订历史与否决理由的回流。
|
|
||||||
- agent-client-parity:P8 在制品,期间不碰其热点文件。
|
|
||||||
|
|
||||||
## 方案选择
|
|
||||||
|
|
||||||
| 方案 | 优点 | 缺点 | 结论 |
|
|
||||||
|---|---|---|---|
|
|
||||||
| **最小文件优先**:Markdown 目录 + 卡上 intent 行 + 只警告的 node 门控 + 模型无关的编译指南 | 试用只新增文件,撤销最便宜;离线、跨 agent、零依赖;不进 DB、不加 MCP | 原稿把门控放在试用期、在文件内记修订历史、双向存归属、简报缺定位信息 | ✅ 选为主体,按评委 must_fix 修正 |
|
|
||||||
| 结构化优先:schema 化 YAML + Rust 解析/lint + 只读 MCP | 可断言程度最高;类型化指针与影响分析严谨 | 权威校验在炼境 crate 内,子项目离线拿不到;YAML 写错会让 cargo test 变红;人维护负担重;撤销成本最高 | 不选;嫁接类型化指针、stale/orphan 分类、base 不符即重提、数据门控 |
|
|
||||||
| 最大化复用:放进既有载体 + 正文上行挂靠 + 并入托管 blueprint-gate | 单一事实源守得最严;简报、blob、回执复用既有载体 | Phase 4 就把检查分发给所有子项目,早于试点与去留决策;改 CONVENTIONS 的「意图层」会破坏分类轴并整文件广播 | 不选;嫁接简报/blob/回执、单向挂靠、章 rev、待裁决视图 |
|
|
||||||
|
|
||||||
评分:agent 友好度视角为最小 25/30、复用 25/30、结构化 19/30;治理与风险视角为最小 24/30、复用 21/30、结构化 18/30。两位评委都判最小方案无致命缺陷。
|
|
||||||
|
|
||||||
**选定**:以最小方案为主体,嫁接以下几点:
|
|
||||||
- 归属只从卡侧单向挂靠;
|
|
||||||
- 每章带 rev,修订审计交给 git;
|
|
||||||
- 目标确认卡兼作 handoff 的最小任务简报,包含 project_id、分支/worktree,并以 catalog blob 作 digest;
|
|
||||||
- 回执写进收口提交的 body;
|
|
||||||
- 人工终验独立成 `- 终验:` 行;
|
|
||||||
- 指针带类型前缀;
|
|
||||||
- 影响分析分 stale 与 orphan 两类;
|
|
||||||
- 代码化工作设数据门控。
|
|
||||||
|
|
||||||
试用期只新增两份文档、不写代码,门控脚本挪到 P8 收口后。
|
|
||||||
|
|
||||||
## 设计规格
|
|
||||||
|
|
||||||
### 1. 目录文件
|
|
||||||
|
|
||||||
- **位置**:`.blueprint/catalog.md`。它在 modules/ 之外,已核实以下机制都不会碰到它:
|
|
||||||
- `archive_project_docs` 只归档 modules/*.md;
|
|
||||||
- blueprint-gate 只扫描 modules/;
|
|
||||||
- `get_blueprint` 只按 manifest 读模块;
|
|
||||||
- `sync_blueprint_rules` 只整文件写 CONVENTIONS.md。
|
|
||||||
- **格式**:纯 Markdown 小语法,依次为引言行、`## 书签`、`## INT-NN 章名`(可有多章)、撤销墓碑、`## 附录`。
|
|
||||||
- **章导语字段**:必填 `rev`、`意图`、`人看`、`机器`、`不做`;可选 `风险`、`假设`、`证据`、`墙`。
|
|
||||||
- **防膨胀**:
|
|
||||||
- 每字段单行,不超过 120 字;
|
|
||||||
- 每个章块不超过 12 行;
|
|
||||||
- 全文件不超过 200 行、8KB;
|
|
||||||
- 禁止 `status`、`progress`、`doc`、`files`、`acceptance`、`model` 键;
|
|
||||||
- 不设文件内修订历史。
|
|
||||||
- **语法的单一来源**:`docs/ai-context/intent-catalog-guide.md`(IC2)。
|
|
||||||
|
|
||||||
示例(章名与内容仅作示意,1.0 由人在 IC3 定稿):
|
|
||||||
|
|
||||||
```markdown
|
|
||||||
# 意图目录
|
|
||||||
> catalog_version: 1.0 | 前言 → path:AGENTS.md#项目定位 | 语法 → path:docs/ai-context/intent-catalog-guide.md
|
|
||||||
|
|
||||||
## 书签
|
|
||||||
- 当前 → path:docs/tasks/2026-10-03-coordination.md#0. 方针与本阶段终点
|
|
||||||
|
|
||||||
## INT-01 一键接入三端可用
|
|
||||||
- rev: 1.0
|
|
||||||
- 意图: 新建或添加子项目后一次确认即在三端可开工
|
|
||||||
- 人看: 新项目首个会话无需手工配置即可调用炼境工具
|
|
||||||
- 机器: card:agent-client-parity#P8e
|
|
||||||
- 不做: 不替 agent 选模型;不让子项目依赖炼境在线
|
|
||||||
- 墙: W12,W13
|
|
||||||
|
|
||||||
## INT-09(已撤销)
|
|
||||||
- 撤销: YYYY-MM-DD → module:intent-catalog#决策记录
|
|
||||||
|
|
||||||
## 附录
|
|
||||||
- 承重墙 → path:.blueprint/modules/intent-catalog.md#承重墙
|
|
||||||
- 决策与否决 → 各模块「决策记录」;终验否决理由 → 卡上 `- 终验:` 行
|
|
||||||
```
|
|
||||||
|
|
||||||
### 2. 挂靠与指针
|
|
||||||
|
|
||||||
- **单向挂靠**:
|
|
||||||
- 卡上可选写一行 `- intent: INT-NN@X.Y`,紧跟在 complexity 后面。
|
|
||||||
- 模块头的 blockquote 可选写 `| intent: INT-NN` 作为默认挂靠,不带版本,影响分析里计为低置信。
|
|
||||||
- 章的「机器:」只是验收坐标指针,不登记成员;反向索引由门控现算,不存储。
|
|
||||||
- **类型化指针**:
|
|
||||||
- `path:<路径>[#标题前缀]`
|
|
||||||
- `module:<id>`
|
|
||||||
- `card:<module>#<卡键>`
|
|
||||||
- `spec:<路径>#标题`
|
|
||||||
- `cmd:<命令>`:只校验格式,不执行
|
|
||||||
- `W<n>`
|
|
||||||
|
|
||||||
多个指针用「;」分隔。卡键取标题去掉状态前缀后的第一个 token,例如 `IC6`、`P8e`。
|
|
||||||
- **解析器行为**(主会话已复核 `blueprint.rs:335-420` 与 `buff.rs:495-505`):
|
|
||||||
- `parse_module_md` 只认 status、complexity、files、depends、acceptance、notes、blocked_reason 这几个键,`- intent:` 与 `- 终验:` 不进任何字段。
|
|
||||||
- `- status:` 行会覆盖标题前缀。
|
|
||||||
- 多条 `- notes:` 时后一条覆盖前一条,所以终验另起 `- 终验:` 键。
|
|
||||||
- 未识别的 `##` 段(Section::None)下出现的 `###` 会被当成任务卡,所以**模块 md 里任务卡段以外一律不许用 `###`**。
|
|
||||||
- buff 自动标 🔵 只替换标题前缀和 `status: todo` 行,不碰 `intent`/`终验` 行。
|
|
||||||
|
|
||||||
### 3. 修订、钉版与影响分析
|
|
||||||
|
|
||||||
- **版本号**:引言里只写一个 `catalog_version: X.Y`;每章另有 `rev`,即该章最后一次变更时的版本。与 manifest.iteration 互不借号。
|
|
||||||
- **三级修订**:
|
|
||||||
|
|
||||||
| 级别 | 触发 | 谁改 | 版本变化 |
|
|
||||||
|---|---|---|---|
|
|
||||||
| 补丁 | 只改正文,目录不动 | agent 自主 | 无 |
|
|
||||||
| 小版本 | 改章导语的坐标,或由正文反推修改目录 | agent 出 S 级三行确认卡,附 diff 和 base blob(`git rev-parse --short HEAD:.blueprint/catalog.md`),人确认 | Y+1,被改章的 rev 设为新版本 |
|
|
||||||
| 大版本 | 增删章节、调整方向 | 人主导 | X+1、Y 归零;涉及的章更新 rev;删掉的章留墓碑;按 T4 检查 AGENTS.md「项目定位」 |
|
|
||||||
|
|
||||||
- **审计交给 git**:目录提交写成 `docs(intent): …`,body 写一句理由,并带 `Feature-Confirmed: true`。提交前如果 HEAD 里的 blob 已不等于提案的 base,就重新提案,沿用 W9 的 plan→digest→apply 语义。
|
|
||||||
- **钉版**:卡钉 `INT-NN@X.Y`;goal 标签写 `INT-NN@X.Y#blob7`。
|
|
||||||
- **影响分析**:
|
|
||||||
- stale:钉的版本低于章 rev,且卡未完成。
|
|
||||||
- orphan:钉在墓碑章上。
|
|
||||||
- low_confidence:只有模块默认挂靠。
|
|
||||||
- **在制品保护**:
|
|
||||||
- 钉旧版的 🔵 卡照常做完,只复核 acceptance。
|
|
||||||
- 章被撤销,或新的「不做」覆盖了该卡时,停下来找人。
|
|
||||||
- 不自动改写卡。agent 复核 acceptance 无变化后改钉,算补丁,在简报里报告。
|
|
||||||
|
|
||||||
### 4. goal 编译与目标确认卡(兼最小任务简报)
|
|
||||||
|
|
||||||
**编译七步**:模型无关,只依赖读文件,node 门控可选;/architect 只是引用指南的 Claude 包装。
|
|
||||||
|
|
||||||
1. **定位**:从 `.lian-jing/context.json` 取 project_id,记下当前分支、worktree、HEAD;要求 `git status --porcelain -- .blueprint/catalog.md` 为空,取 catalog blob。
|
|
||||||
2. **读书签**:定位当前章(P8 期间按 coordination §0 的终点),读该章导语和 rev。
|
|
||||||
3. **校验**:P8 收口后跑 `intent-gate.cjs --report INT-NN --impact`,在此之前用指南里的 shell 等价检查。遇到悬空指针、stale/orphan 或防膨胀警告,先修或先提案,不往下编译。
|
|
||||||
4. **收卡**:取挂在本章、状态为 📋/🔵 的卡。没有可执行 agent_verify 的,列入「须先补 acceptance」,不进 goal。
|
|
||||||
5. **合成终点**:
|
|
||||||
- 取各卡 agent_verify 的合取,改写成会话里可判定的形式:贴出命令和预期输出、纳入卡前缀均为 ✅、回执块已写入。
|
|
||||||
- 过程词黑名单(按方针、符合设计、设计已完成、基本完成)命中数必须为 0。
|
|
||||||
- human_verify 不进终点,单列为终验待办。
|
|
||||||
6. **写明停止找人的条件**:human_verify、写运行中 DB、删除、凭据或机器状态变更、超出纳入卡或本章、需改目录、stale pin、失败 3 次。
|
|
||||||
7. **输出确认卡和 /goal 文本**:人读完亲手粘贴即为确认。要改就重新编译,agent 不得自行启动或静默改动。
|
|
||||||
|
|
||||||
**目标确认卡模板**(/goal 文本首行带同样的标签):
|
|
||||||
|
|
||||||
```text
|
|
||||||
[INT-02@1.0#a1b2c3d] 目标确认卡
|
|
||||||
项目: <project_id> | 分支/worktree: <branch> @ <path> | HEAD: <sha7>
|
|
||||||
章意图: <一句> | 不做: <…>
|
|
||||||
纳入卡: IC6(来源 agent_verify 原文)、IC7(…)
|
|
||||||
终点(合取): 1) <命令> → <预期输出> 2) … 3) 纳入卡均 ✅ 且已写 Goal-Receipt
|
|
||||||
终验待办: <human_verify 项>
|
|
||||||
停止找人: <第 6 步清单>
|
|
||||||
能力入口: pnpm typecheck / cargo test / <MCP 工具>
|
|
||||||
没验什么: <…>
|
|
||||||
作废: 分支变化或 catalog blob ≠ a1b2c3d
|
|
||||||
```
|
|
||||||
|
|
||||||
**回执**:goal 收口时写进收口提交的 body,M 级同时复制到 PR body;炼境在线时可再调 append_project_note。格式为以下几行 trailer:
|
|
||||||
|
|
||||||
- `Goal-Receipt: <标签>`
|
|
||||||
- `Goal-Cards:`
|
|
||||||
- `Goal-Result: 判对|误判|中止(原因)`
|
|
||||||
- `Goal-Rounds:`
|
|
||||||
- `Goal-Interventions:`
|
|
||||||
- `Goal-Tokens: <客户端可得时填,否则 n/a>`
|
|
||||||
- `Not-Verified:`
|
|
||||||
- `Human-Pending:`
|
|
||||||
|
|
||||||
不写进模块决策记录,那会被 UI 当成决策展示;也不手改 `notes-archive.jsonl`,它以 DB 为事实源、会被整文件重写。
|
|
||||||
|
|
||||||
### 5. 书签
|
|
||||||
|
|
||||||
- **载体**:catalog.md 的 `## 书签` 段。
|
|
||||||
- **P8 期间**:只写一行指针,指向 coordination §0,终点仍以 §0 为唯一事实源。
|
|
||||||
- **P8 收口后(IC10)**:改为自持三行:`- 当前: INT-NN`、`- 终点 → card:<module>#<卡键>`、`- 确认: YYYY-MM-DD`。同一次提交把 coordination §0 改成指向书签(若文件已按处置条款删除则跳过),此后统筹文档只管派单与交接。
|
|
||||||
- **切换书签**:不升版本,但走与小版本相同的流程:附 `--report` 证据和 base blob,人确认,提交带 Feature-Confirmed。书签指针悬空时门控报警,这本身就是交接信号。
|
|
||||||
|
|
||||||
### 6. 机器校验
|
|
||||||
|
|
||||||
- **Phase 3(只新增文档,不写代码)**:检查全靠卡 acceptance 里的 shell 单行命令:
|
|
||||||
- grep 统计章数和禁用键;
|
|
||||||
- wc 检查体量;
|
|
||||||
- `grep -oE 'path:[^ #;]+' | xargs test -e` 校验路径指针;
|
|
||||||
- 新增前后用 `grep -c '^### '` 计数比对,作为 get_project_blueprint 的离线替代。
|
|
||||||
- **Phase 4(P8 收口后)**:新增零依赖的 `.claude/hooks/intent-gate.cjs`,恒 exit 0、只警告,`INTENT_CATALOG` 环境变量可以指向夹具,没有目录文件时静默。检查分六类:
|
|
||||||
1. 结构:版本行存在、INT 唯一、墓碑不被复用、rev 不大于 catalog_version。
|
|
||||||
2. 防膨胀:字段白名单、单行与体量上限、禁用键与模型名。
|
|
||||||
3. 类型指针可解析。
|
|
||||||
4. 卡侧:intent 指向的章存在且未撤销,钉的版本不高于当前版本。
|
|
||||||
5. 版本纪律:只读 `git diff --cached`,章文改了而 rev 或版本没升就警告。
|
|
||||||
6. 只读视图:
|
|
||||||
- `--report`:按解析器语义推导章的四态,标注 status_source;汇总 Goal-Receipt;审计缺 Feature-Confirmed 的目录提交。
|
|
||||||
- `--impact`:输出 stale/orphan/low_confidence。
|
|
||||||
- `--pending`:列出有 human_verify 但没有 `- 终验:` 行的卡,以及未提交的目录改动。
|
|
||||||
- `--self-test`:用内置坏样例自检。
|
|
||||||
- **接线**:lefthook pre-commit 以 `|| true` 接入;不进 CI 阻断,也不并入托管的 blueprint-gate。另加一条 cargo test,锁定解析器忽略 intent 与终验行。
|
|
||||||
- **数据门控**:Rust 解析、MCP 查询这类代码化工作,要同时满足钉版卡不少于 5 张、至少发生过 1 次小版本修订、enterprise 试点完成、且 IC13 决定保留之后才考虑。
|
|
||||||
|
|
||||||
### 7. 术语映射
|
|
||||||
|
|
||||||
- **方针层(前言)**:AGENTS.md「项目定位」。
|
|
||||||
- **目录层**:`.blueprint/catalog.md`,包括章、导语、附录、书签;索引就是 INT-NN。
|
|
||||||
- **正文层**:manifest、modules/*.md 和任务卡。
|
|
||||||
- **不改的词**:CONVENTIONS 里的「蓝图定位(意图层)」与「架构意图层」保留,解释为「.blueprint 全体(目录 + 正文)相对 git 事实层」。这样不触碰整文件分发的规则,也不破坏分类轴。
|
|
||||||
- **唯一改名点**:`docs/ai-context/agent-button-system.md:51` 的「意图层 — AGENTS.md」改为「方针层 — AGENTS.md」。该文件不在 resources/onboarding 内,已核实;在 Phase 4 由 IC8 执行。之后新文档不再单独使用「意图层」一词。
|
|
||||||
|
|
||||||
## 13 个待设计问题的化解
|
|
||||||
|
|
||||||
| # | 问题 | 化解 |
|
|
||||||
|---|---|---|
|
|
||||||
| 1 | 「意图层」三处归属 | 定死方针层、目录层、正文层三层;CONVENTIONS 的「意图层」保留并重新解释;全仓只改 agent-button-system.md:51 一处,由 IC8 执行。否决改 CONVENTIONS 的做法,因为它会破坏分类轴并触发整文件广播 |
|
|
||||||
| 2 | 红线:章完成不能手动切换 | 目录不设任何状态字段;章的四态(未开始、进行中、待人终验、已达成)只由 `--report` 从卡状态和 `- 终验:` 行临时推导,不落盘、不提供入口。书签切换属于方向决策,不算改状态 |
|
|
||||||
| 3 | 状态语义未收敛 | 推导按解析器语义来:先看前缀,有 status 行则以它为准,并标注 status_source;前缀与 status 行不一致时警告。正式收敛交给 blueprint-governance 前置,收敛前推导结果标为「参考」;stale/orphan 不依赖状态语义 |
|
|
||||||
| 4 | 四套分类轴的对应 | 补丁对应 Bug 和章内 S/M Feature,T1–T4 照旧;小版本对应改变章坐标的 Feature(S 级确认卡),触发 T5-minor;大版本对应 L 级或方向调整,触发 T5-major,并按 T4 检查项目定位。manifest.iteration 只计模块重构。T5 先写进炼境 AGENTS.md 托管块外,登记为有意的临时分叉,在 IC13 回收 |
|
|
||||||
| 5 | ID 前缀 | 章用 INT-NN,永不复用,撤销留墓碑;W1–W14 只出现在模块和设计文档里;卡从 IC2 起编号;钉版写 `INT-NN@X.Y`,goal 标签写 `INT-NN@X.Y#blob7`。2026-10-04 已用 git grep 确认这些前缀都没被占用 |
|
|
||||||
| 6 | goal 级确认代替逐卡确认 | 只起草,见下文「立法提案草案」。P8 期间只记账,P8 收口后由 IC11 带着数据交给用户裁决 |
|
|
||||||
| 7 | W11 资源:只记账不分配 | 由 Goal-Receipt 记录轮数、介入次数,token 可得时一并记录,`--report` 按章汇总;目录与 goal 文本都禁止出现模型名。CONVENTIONS 复杂度表映射到模型名的矛盾,交给前置收敛 |
|
|
||||||
| 8 | 防止容器化 | 只放 ID、一句话意图和类型化指针,加上白名单、体量上限、禁用键,不设文件内修订历史;goal 编译第 3 步把警告当作阻塞 |
|
|
||||||
| 9 | 书签与 coordination §0 | P8 期间书签只是一行指针;之后由 IC10 改为自持,agent 起草、人确认,同一次提交把 §0 改成指向书签 |
|
|
||||||
| 10 | 离线与降级 | 目录、指南、门控、回执都在项目 Git 里,离线可读可跑;不新增 MCP 工具,在线时用现有的 get_project_file 读同一份文件;跨项目索引受数据门控约束 |
|
|
||||||
| 11 | 跨 agent | 编译流程写进 intent-catalog-guide.md,作为唯一来源,/architect 只引用不复述;IC4 由 Codex 或 DSH 纸面试跑验证。保留后经 blueprint-baseline 包或安全派发并入 CONVENTIONS,不走整文件广播 |
|
|
||||||
| 12 | 子项目已有意图载体 | 用 `spec:.specify/specs/<id>/spec.md#标题` 指向;单行和体量上限从物理上防止抄录;在 IC12 验证 |
|
|
||||||
| 13 | 物理位置与前言 | 放在 `.blueprint/catalog.md`:属于启动就读的蓝图目录,又在 modules/ 之外。前言只写一个指针 `path:AGENTS.md#项目定位`。不放 AGENTS.md,避免常驻成本和托管块覆盖;不新开 docs/intent/,因为它不在启动读取路径上 |
|
|
||||||
|
|
||||||
## 承重墙四问
|
|
||||||
|
|
||||||
| 墙 | 落点 | 机制 | 机器检查 | 何时拆除 |
|
|
||||||
|---|---|---|---|---|
|
|
||||||
| W1 迭代 | 引言版本 + 各章 rev;卡和 goal 上的钉版 | 三级修订;钉版;审计交给 git;与 iteration 分开 | `--impact` 报 stale/orphan;章文改了而 rev 未升时警告 | IC13 时钉版卡少于 5 张,或从未触发复核,就撤销钉版,只留章 ID |
|
|
||||||
| W2 遗忘 | 书签 + 确认卡(兼简报) | 启动只读引言和书签约 10 行;用简报代替通读蓝图 | 书签所指章存在;确认卡 blob 等于 HEAD | 续接所需上下文没有下降,或被原生记忆覆盖 |
|
|
||||||
| W3 熵增 | 目录全文件 | 白名单、体量上限、只写指针、禁用键 | Phase 3 用 grep/wc;Phase 4 用门控;编译前把警告当阻塞 | 随目录整体撤销;阈值在 IC13 前按实测调整 |
|
|
||||||
| W4 意图鸿沟 | 章导语四个字段 + 卡侧 intent | 卡挂回章;确认卡写清「不做」与停止条件 | 卡引用的章存在;编译输出「须先补 acceptance」 | human_verify 否决率和方向返工没有下降 |
|
|
||||||
| W5 注意力稀缺 | 书签 + `--pending` | 人只确认书签、大小版本和 goal 确认卡 | `--pending` 列出待终验卡和未提交的目录改动 | 原生视图已能覆盖跨章待裁决 |
|
|
||||||
| W6 理解债 | 卡侧 intent + 章的机器指针 | 由门控现算「服务哪条意图」,不存储 | `--report INT-NN` 列出挂靠卡及来源 | 试用期内反查从未被用过 |
|
|
||||||
| W7 自评偏差 | 双坐标;回执的 Not-Verified | 章完成只能推导;终验结论由人给出 | 禁止 status 键;标注 status_source;回执 trailer 齐全 | 不拆,这是红线 |
|
|
||||||
| W8 不确定性 | 可选的「假设:」字段 | 只指向已有的证伪落点 | 指针可解析 | 试点中从未用过,就从白名单删除 |
|
|
||||||
| W9 并发冲突 | 目录文件 | 提案带 base blob,不符就重提;目录改动单独小提交 | 编译第 1 步要求目录无未提交改动 | 保留,成本极低 |
|
|
||||||
| W10 风险不对称 | 大小版本、书签;可选的「风险:」字段 | 提案、diff、blob 交人确认;停止清单是必填项 | 审计目录提交的 trailer | 不拆;立法若采纳则并入需求对齐协议 |
|
|
||||||
| W11 资源有限 | Goal-Receipt trailer | 只记账:轮数、介入次数、耗时、可得时的 token | 从 git log 按章汇总;禁止出现模型名 | 没有任何客户端提供用量,且轮数数据无助于决策 |
|
|
||||||
| W12 环境漂移 | 附录指针 | 用 cmd: 指针指向现有工具,不新建机制 | 只校验格式 | 无需拆,本身没有新增机制 |
|
|
||||||
| W13 异构 agent | intent-catalog-guide.md | 只依赖读文件;/architect 只是包装 | IC4 纸面编译;IC12 实跑 | 各客户端出现原生的同等能力 |
|
|
||||||
| W14 摩擦重复 | 回执、`- 终验:` 否决理由、envoy | 复用提交 body、append_project_note、report_envoy_return | 用 git log 统计 | 随目录整体撤销 |
|
|
||||||
|
|
||||||
## 受影响文件
|
|
||||||
|
|
||||||
| 阶段 | 文件 | 改动 | 用途 |
|
|
||||||
|---|---|---|---|
|
|
||||||
| 2 设计(本文,与 P8 并行) | docs/tasks/2026-10-04-intent-catalog-design.md | 新增 | 本设计 |
|
|
||||||
| 2 设计 | .blueprint/modules/intent-catalog.md | 修改 | 改 IC1 前缀、补决策记录、追加 IC2–IC13 卡(任务卡段以外不用 `###`) |
|
|
||||||
| 2 设计 | .blueprint/manifest.yaml | 修改 | 用户确认后只改本模块的 status 一行:concept → planned |
|
|
||||||
| 3 炼境自身试用(只新增文件) | docs/ai-context/intent-catalog-guide.md | 新增 | 目录语法、修订钉版、编译七步、确认卡与回执模板、离线检查 |
|
|
||||||
| 3 | .blueprint/catalog.md | 新增 | 1.0 骨架与首批 2–4 章;书签只写一行指针 |
|
|
||||||
| 4 P8 收口后 | .claude/hooks/intent-gate.cjs | 新增 | 只警告的门控和各个只读视图 |
|
|
||||||
| 4 | src-tauri/src/commands/blueprint.rs | 修改 | 只改 `#[cfg(test)]`:锁定解析器忽略 intent 与终验行 |
|
|
||||||
| 4 | lefthook.yml | 修改 | pre-commit 加 intent-gate(带 `\|\| true`);接入包对 lefthook 是「存在即跳过」(已核实 onboarding.rs:6),不会被覆盖 |
|
|
||||||
| 4 | AGENTS.md | 修改 | 只改托管块外:T1–T4 区加 T5;块外约定加「启动读目录引言和书签」一行 |
|
|
||||||
| 4 | docs/ai-context/agent-button-system.md | 修改 | 唯一改名点:第 51 行 |
|
|
||||||
| 4 | .blueprint/catalog.md、docs/tasks/2026-10-03-coordination.md | 修改 | IC10 书签交接;§0 改为指向书签 |
|
|
||||||
| 5 enterprise 试点 | enterprise 隔离 worktree 里的 .blueprint/catalog.md 和 intent-gate.cjs 试点副本 | 新增 | 规格只用 spec: 指向;副本首行标注到期 |
|
|
||||||
| 6 去留(保留时) | onboarding 模板(经 blueprint-baseline 包)、AGENTS.md.tmpl、agents-meta-rules.md、CONVENTIONS.md | 新增/修改 | 只在 IC13 决定保留后分发,配套升版本和指纹,回收 T5 临时分叉 |
|
|
||||||
| 6 去留(撤销时) | 见撤销清单 | 删除 | 删除 3 个文件、lefthook 键、T5 和启动读书签那一行;回退 §0;删除 enterprise 副本 |
|
|
||||||
|
|
||||||
## 系统边界变更
|
|
||||||
|
|
||||||
- **Phase 2**:无变化,只写文档。
|
|
||||||
- **Phase 3**:
|
|
||||||
- 新增项目级文件格式 `.blueprint/catalog.md`。
|
|
||||||
- 任务卡新增两个可选、解析器不读的键:`- intent:` 和 `- 终验:`,与 iteration:/replaces: 同属此类。
|
|
||||||
- 提交新增 `Goal-Receipt:` 等 trailer 约定。
|
|
||||||
- 不新增 Tauri command、MCP 工具、DB 表或结构体字段。
|
|
||||||
- **Phase 4**:新增本地 CLI `node .claude/hooks/intent-gate.cjs [--self-test|--report|--impact|--pending]`、lefthook 键和 AGENTS.md 块外的 T5;仍不涉及 command、MCP 或 DB。
|
|
||||||
- **Phase 6**:只有决定保留并过了数据门控,才可能新增 `BlueprintTask.intent` 字段或只读 MCP 工具,届时按 T1 契约变更另行设计。
|
|
||||||
|
|
||||||
## 风险点
|
|
||||||
|
|
||||||
| 风险 | 规避 |
|
|
||||||
|---|---|
|
|
||||||
| 目录膨胀成容器,或变成第二事实源 | 白名单、体量上限、只写指针、单向挂靠;编译前把警告当阻塞 |
|
|
||||||
| 只警告的门控被习惯性忽略 | 保持零警告基线、警告类别少而准;编译前要求本章零警告;是否升级为阻断由 IC13 依数据决定 |
|
|
||||||
| 会重写卡文件的工具丢掉 intent 或终验行 | 已复核解析器和 buff;其他写入路径未核实,由 IC9 锁定,并比对 IC5 前后的卡数 |
|
|
||||||
| /goal 评估器仍然过早判定达成 | 终点只写「命令 + 输出」的合取;过程词黑名单;Goal-Result 统计一次判对率 |
|
|
||||||
| 状态语义未收敛导致推导失真 | 标注 status_source、不一致时警告;推导结果标为参考、不落盘 |
|
|
||||||
| 把回执写进 notes-archive.jsonl 会被冲掉 | 主载体是提交 body;在线时只经 append_project_note 双写 |
|
|
||||||
| 归档 modules 后 card: 指针集体悬空 | 门控报出悬空后按小版本修订;归档本身就是触发信号 |
|
|
||||||
| 模块 md 的非任务卡段里用了 `###`,被当成卡 | 指南明令禁止;acceptance 比对 `^### ` 计数 |
|
|
||||||
| T5 和 enterprise 门控副本与模板分叉 | 登记为有意的临时分叉,在 IC13 统一回收 |
|
|
||||||
| 其他 agent 沙箱里没有 node,或 lefthook 静默失效 | 门控只是辅助,保留 shell 加人工读文件的降级路径 |
|
|
||||||
| 维护成本超过收益 | 由 IC13 依数据决定;撤销只需删 3 个文件和若干行 |
|
|
||||||
|
|
||||||
## 拆解建议
|
|
||||||
|
|
||||||
建议拆为 12 张卡,依赖顺序:
|
|
||||||
|
|
||||||
- IC2 → IC3 → IC4 → IC5(Phase 3,P8 期间可做,只新增文件)
|
|
||||||
- P8 收口 → IC6 → IC7;IC6 → IC8;IC9 不依赖其他卡;IC7 + IC8 → IC10;IC5 → IC11(以上为 Phase 4)
|
|
||||||
- IC9 + IC10 → IC12 → IC13(Phase 5、6)
|
|
||||||
|
|
||||||
| 卡 | 标题 | 复杂度 | 阶段 | acceptance 要点 |
|
|
||||||
|---|---|---|---|---|
|
|
||||||
| IC2 | 新增 intent-catalog-guide.md | S | 3 | [CLI] 5 个必备节标题都在;模型名 grep 为 0;git status 只有该文件新增 |
|
|
||||||
| IC3 | 新增 catalog.md:1.0 骨架与首批 2–4 章 | S | 3 | [CLI] 版本行、章数、体量、禁用键、path 悬空数为 0;`^### ` 计数前后相等。human_verify:用户逐章定稿,提交带 Feature-Confirmed |
|
|
||||||
| IC4 | 跨 agent 纸面编译(Codex 或 DSH) | S | 3 | [CLI] 提交 body 里确认卡 9 个字段齐全,有 `Compiled-By: <非 Claude>`;blob 一致;终点都能在来源卡里找到;黑名单为 0 |
|
|
||||||
| IC5 | 首次真实 /goal:编译 → 粘贴 → 回执 | S | 3→4 | [CLI] 至少 1 条完整的 Goal-Receipt;纳入卡均为 ✅;有 human_verify 的卡带 `- 终验:` 行。human_verify:人粘贴并判定 Goal-Result |
|
|
||||||
| IC6 | intent-gate 核心加 --self-test | M | 4 | [gate] self-test 的 5 类坏样例各命中 1 条警告;真实目录 0 警告;没有目录时静默 exit 0 |
|
|
||||||
| IC7 | 只读视图 --report/--impact/--pending 与审计 | M | 4 | [gate] 夹具覆盖 stale/orphan/low_confidence/divergence/待终验/缺 trailer 审计;运行前后文件 sha256 不变 |
|
|
||||||
| IC8 | 接线:lefthook、T5、启动读书签、单处改名 | S | 4 | [YAML] run 以 `\|\| true` 结尾;[cargo test] `cargo test onboarding` 0 failed;AGENTS.md 的 diff 都在托管块之前;改名残留为 0;临时 worktree 里实测会警告 |
|
|
||||||
| IC9 | cargo test 锁定解析器忽略 intent 与终验行 | S | 4 | [cargo test] `parse_module_md_ignores_intent_lines` 1 passed:带和不带这些行的样本逐字段相等;全量无 FAILED |
|
|
||||||
| IC10 | 书签交接 | S | 4 | [gate] 0 警告;书签三行齐全;§0 改为指向书签;提交带 Feature-Confirmed。human_verify:用户确认切换 |
|
|
||||||
| IC11 | 立法提案定稿 | S | 4 | [读文件] 决策记录有条文、例外清单、P8 与 IC5 数据;diff 不含 AGENTS.md 和 resources/。human_verify:用户裁决 |
|
|
||||||
| IC12 | enterprise 隔离试点 | M | 5 | [gate] 试点 worktree 0 警告、spec: 都可解析;只新增 2 个文件;enterprise 主工作区前后一致;至少 1 条 Goal-Receipt |
|
|
||||||
| IC13 | 去留决策 | S | 6 | [读文件] 五项度量的前后对比,样本至少 5 条;撤销时 `git grep` 只命中决策记录。human_verify:用户裁决 |
|
|
||||||
|
|
||||||
## 收益度量与退出条件
|
|
||||||
|
|
||||||
- **度量**:基线取 P8 期间没有目录时的数据,来源是 PR body 和统筹流水。
|
|
||||||
- /goal 一次判对率,取自 Goal-Result;
|
|
||||||
- 每个 goal 的人工介入次数;
|
|
||||||
- 续接所需的上下文量:读简报的字节数 vs. 读 coordination 加多个模块的字节数;
|
|
||||||
- human_verify 否决率与方向返工;
|
|
||||||
- 每阶段的轮数、耗时,token 可得时一并记录。
|
|
||||||
- **健康指标**:目录警告数、stale pin 数、目录体量、人每阶段改目录的次数。
|
|
||||||
- **去留**(初始阈值,用户可在 IC13 前调整):样本至少 5 个 goal,其中 enterprise 至少 1 个。一次判对率不低于 60%、人工介入不高于基线、人每阶段改目录不超过 1 次,就保留并另拆分发卡;实测无收益、已被 agent 原生能力覆盖,或维护成本超过收益,就按撤销清单整体撤销。
|
|
||||||
|
|
||||||
## 立法提案草案:「goal 级确认代替逐卡确认」
|
|
||||||
|
|
||||||
不在 P8 期间生效,P8 收口后由 IC11 用实测数据定稿。
|
|
||||||
|
|
||||||
1. **范围**:书签所指当前章内,目标确认卡「纳入卡」所列的 S/M 卡。
|
|
||||||
2. **确认方式**:人读完确认卡后亲手粘贴 /goal,即视为批量确认清单内各卡的 Feature 确认卡;agent 不得自行启动或改写 goal 文本。
|
|
||||||
3. **存证**:清单内卡的 feat: 提交照常带 `Feature-Confirmed: true`,并加 `Goal-Receipt: INT-NN@X.Y#blob`;缺这一行即视为逐卡确认未完成。
|
|
||||||
4. **例外**:以下仍须逐项找人:写运行中 DB;删除文件、数据或分支;human_verify;凭据与机器状态变更;超出纳入卡或当前章;修改目录;stale/orphan pin;失败 3 次。
|
|
||||||
5. **失效**:分支变化、catalog blob 变化或 goal 中止时,恢复逐卡确认。
|
|
||||||
6. **落点**:先在炼境 AGENTS.md 块外试行,采纳后再进 ONBOARDING_MANAGED「需求对齐协议」(升块版本和指纹),并同步 agents-meta-rules。试行期间任何一条例外被越过,就否决本条。
|
|
||||||
|
|
||||||
## 待用户拍板
|
|
||||||
|
|
||||||
1. **门控脚本的时机**:默认放在 P8 收口后的 Phase 4,试用期只放两份文档、不写代码。是否特批在试用期以新增文件的形式就写?
|
|
||||||
2. **IC5 首次真实 /goal 用哪个阶段**:P8 收尾,数据来得最早;还是 P8 收口后的第一个阶段,例如本模块 Phase 4 的卡,自举试用?
|
|
||||||
3. **炼境 1.0 首批章节方向**:草拟候选为「一键接入三端可用」「意图编译为可判定终点」「摩擦驱动沉淀与退出」。正式定稿在 IC3,由你逐章确认。
|
|
||||||
4. **去留阈值**是否认可:样本至少 5 个、一次判对率不低于 60%、人工介入不高于基线、改目录每阶段不超过 1 次?
|
|
||||||
5. **常驻成本**:Phase 4 在 AGENTS.md 块外加「会话开始读目录引言和书签(约 10 行)」,是否接受?
|
|
||||||
|
|
||||||
## 自验报告:没验什么
|
|
||||||
|
|
||||||
- **已复核**:archive 只归档 modules/*.md;parse_module_md 的段落与键规则(`blueprint.rs:335-420`);buff 自动标 🔵 的替换范围(`buff.rs:495-505`);lefthook「存在即跳过」(`onboarding.rs:6`);agent-button-system 不在分发模板内;W/IC/INT 前缀未被占用。
|
|
||||||
- **未复核,沿用评审团或 handoff 简报的结论**:
|
|
||||||
- `get_project_file` 在 mcp_tools.rs:38;
|
|
||||||
- notes-archive.jsonl 由 DB 整文件重写(mcp_tools.rs:87);
|
|
||||||
- 其他可能重写卡文件的路径;
|
|
||||||
- CONVENTIONS 状态语义冲突的具体行号。
|
|
||||||
- **侦察缺口**:侦察工作流 wf_6dc3756a-b72 中「蓝图全量」和「红线与记忆」两个侦察员卡死失败,相关约束由综合者补读和主会话已知规则补齐,可能有遗漏。
|
|
||||||
- **跨 agent**:/goal 能否作为三端通用的粘贴载体,未核实,留给 IC4、IC12 验证。
|
|
||||||
- **用量(W11 记账)**:侦察工作流约 178 万 token,其中两个侦察员各重试 6 次卡死,浪费明显;设计评审团约 55 万 token,6 个 agent 全部成功。
|
|
||||||
45
docs/templates/agents-meta-rules.md
vendored
45
docs/templates/agents-meta-rules.md
vendored
@ -1,7 +1,6 @@
|
|||||||
---
|
---
|
||||||
version: 1.10.0
|
version: 1.2.0
|
||||||
aligned_with: src-tauri/resources/onboarding/AGENTS.md.tmpl ONBOARDING_MANAGED 1.10.0
|
updated: 2026-09-21
|
||||||
updated: 2026-10-04
|
|
||||||
usage: 炼境接入包分发时写入被管理项目 AGENTS.md 的元规则标准内容
|
usage: 炼境接入包分发时写入被管理项目 AGENTS.md 的元规则标准内容
|
||||||
---
|
---
|
||||||
|
|
||||||
@ -10,34 +9,12 @@ usage: 炼境接入包分发时写入被管理项目 AGENTS.md 的元规则标
|
|||||||
> 本节由炼境接入包分发,规则技术栈无关,适用于所有项目和所有 AI 工具。
|
> 本节由炼境接入包分发,规则技术栈无关,适用于所有项目和所有 AI 工具。
|
||||||
> 项目特定的路径映射见 `docs/ai-context/project-context.yaml`。
|
> 项目特定的路径映射见 `docs/ai-context/project-context.yaml`。
|
||||||
|
|
||||||
## 与分发模板的对照(ONBOARDING_MANAGED 1.10.0,2026-10-04 逐节核对)
|
|
||||||
|
|
||||||
分发实体是 `src-tauri/resources/onboarding/AGENTS.md.tmpl`,措辞以模板为准;本文件是设计层,补「为什么」,不重复模板全文。
|
|
||||||
|
|
||||||
| 模板小节(托管块内) | 本文件 | 差异 |
|
|
||||||
|---|---|---|
|
|
||||||
| 核心开发约束(包管理、代码规范、Playwright 版本固定) | 无 | 不复制,以模板为准 |
|
|
||||||
| 需求对齐协议(Bug/Feature 分流、S 级三行卡、M/L 完整卡、Feature-Confirmed、补录≠确认卡) | 无 | 不复制,以模板为准 |
|
|
||||||
| Git 工作流(git-workflow.md、Conventional Commits) | 无 | 不复制,以模板为准 |
|
|
||||||
| 炼境项目上下文与能力包 | 同名小节 | 五条已同步为模板原文;Node/pnpm 工具链小节只留指针 |
|
|
||||||
| agent 按钮与验证路径(1–6 条 + 收束) | 「Agent 按钮体系」 | 本文件有同源同边界、acceptance 写法、自验报告纪律及其「为什么」;缺载体就近选择表、完成的定义、侦察→驻军、agent_verify/human_verify 分层与三分定位启发式(以模板为准);本文件多出的分工原则、按钮清单模板、自验失败降级约定已不在托管块内(炼境自身见 AGENTS.md 块外区) |
|
|
||||||
| 多 AI CLI 协作 | 「跨 AI 工具交接模板」 | 内容等价,模板为编号三条 |
|
|
||||||
|
|
||||||
| 模板小节(托管块外) | 本文件 | 差异 |
|
|
||||||
|---|---|---|
|
|
||||||
| 四支柱、文档防腐 T1–T4、铁律、定期防腐自查 | 同名小节 | 已同步:T1 补「(若存在)」、T3/T4 改指「本文件(AGENTS.md)」、自查路径写全 `docs/ai-context/` |
|
|
||||||
|
|
||||||
## 炼境项目上下文与能力包
|
## 炼境项目上下文与能力包
|
||||||
|
|
||||||
- `.lian-jing/context.json` 是项目 `project_id` 的工具无关单一事实来源;不要从客户端项目 UI、用户级插件或全局配置推断项目身份。
|
- 项目根目录 `.lian-jing/context.json` 是工具无关的 `project_id` 单一事实来源;客户端项目 UI、用户级插件和全局配置都不能替代它。
|
||||||
- `.claude/liangjing.json` 只是旧项目的 Claude 兼容投影。只发现它时,调用 `inject_mcp(project_id)` 迁移,而不是手工复制或猜测 ID。
|
- `.claude/liangjing.json` 仅用于兼容已接入的旧 Claude 项目;发现 legacy-only 状态时,应通过炼境迁移,不应复制或猜测 ID。
|
||||||
- `.lian-jing/capability-packs.json` 记录炼境托管基线的版本。`verify_onboarding(project_id)` 报告 `legacy`、`version_mismatch` 等状态时,按其 `detail` 中的升级提示处理。
|
- `.lian-jing/capability-packs.json` 仅描述炼境托管基线的版本与自检。升级必须显式报告版本不符,并且不能覆盖项目自己的业务规则、测试、部署声明或手工 MCP 配置。
|
||||||
- `apply_onboarding_pack(project_id)` 只更新炼境明确托管的接入包文件;项目自己的业务规则、测试、部署声明和手工定义的同名 MCP server 仍归项目所有,不能被升级覆盖。
|
- 子项目 agent(Claude、Codex、DSH)遇到炼境分发物的摩擦或验证出跨项目实践时,经同一 MCP 入口 `report_envoy_return` 回传;何时回传与字段规范只写在 lian-jing skill,AGENTS 托管块只留一行指路(skill 按需加载,AGENTS 三端必读)。
|
||||||
- 遇到炼境分发的模板、约定或 MCP 工具的摩擦,或验证出跨项目可复用的实践时,调用 `report_envoy_return` 回传炼境(只追加信号,不必逐条征得用户同意;Claude 会话结束时也可跑 `/envoy`);何时回传、字段怎么填见 lian-jing skill「遇到摩擦时回传炼境」一节。
|
|
||||||
|
|
||||||
### Node/pnpm 工具链
|
|
||||||
|
|
||||||
见模板同名小节(.nvmrc / packageManager 为版本事实源、mise 最小声明、get_toolchain_status 先查、prepare_toolchain 须用户确认);措辞以模板为准。
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@ -61,7 +38,7 @@ usage: 炼境接入包分发时写入被管理项目 AGENTS.md 的元规则标
|
|||||||
|
|
||||||
### T1 外部契约变更(最高优先级)
|
### T1 外部契约变更(最高优先级)
|
||||||
其他代码、服务、或 agent 依赖的定义——接口、共享类型、数据结构、配置键名、环境变量名。
|
其他代码、服务、或 agent 依赖的定义——接口、共享类型、数据结构、配置键名、环境变量名。
|
||||||
→ 查 `docs/ai-context/project-context.yaml`(若存在)找到记录该契约的文档,检查并同步更新。
|
→ 查 `docs/ai-context/project-context.yaml` 找到记录该契约的文档,检查并同步更新。
|
||||||
|
|
||||||
### T2 架构边界变更
|
### T2 架构边界变更
|
||||||
模块划分、目录结构、依赖方向、包边界调整。
|
模块划分、目录结构、依赖方向、包边界调整。
|
||||||
@ -69,10 +46,10 @@ usage: 炼境接入包分发时写入被管理项目 AGENTS.md 的元规则标
|
|||||||
|
|
||||||
### T3 工具链变更
|
### T3 工具链变更
|
||||||
引入或替换库、框架、构建工具。
|
引入或替换库、框架、构建工具。
|
||||||
→ 更新本文件(AGENTS.md)技术栈声明;通知炼境重新扫描并更新 `project-context.yaml`。
|
→ 更新 AGENTS.md 技术栈声明;通知炼境重新扫描并更新 `project-context.yaml`。
|
||||||
|
|
||||||
### T4 常驻上下文过期
|
### T4 常驻上下文过期
|
||||||
本文件(AGENTS.md)或 `docs/ai-context/project-brief.md` 描述的现实已经改变。
|
AGENTS.md 或 `docs/ai-context/project-brief.md` 描述的现实已经改变。
|
||||||
→ 立即更新。这两份文档常驻 agent 上下文,过期危害最大。
|
→ 立即更新。这两份文档常驻 agent 上下文,过期危害最大。
|
||||||
|
|
||||||
### 不触发检查
|
### 不触发检查
|
||||||
@ -106,9 +83,9 @@ usage: 炼境接入包分发时写入被管理项目 AGENTS.md 的元规则标
|
|||||||
每隔一阵或大改后,对照以下清单:
|
每隔一阵或大改后,对照以下清单:
|
||||||
|
|
||||||
- [ ] AGENTS.md 里的技术栈声明还和代码一致吗?
|
- [ ] AGENTS.md 里的技术栈声明还和代码一致吗?
|
||||||
- [ ] `docs/ai-context/project-brief.md` 最近 30 天有没有随架构改动更新?
|
- [ ] `project-brief.md` 最近 30 天有没有随架构改动更新?
|
||||||
- [ ] 有没有两份文档说同一件事且打架?
|
- [ ] 有没有两份文档说同一件事且打架?
|
||||||
- [ ] `docs/ai-context/project-context.yaml` 的契约路径还准确吗?
|
- [ ] `project-context.yaml` 的契约路径还准确吗?
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
@ -1323,15 +1323,6 @@ pub(crate) fn sync_blueprint_rules_with(
|
|||||||
root: &Path,
|
root: &Path,
|
||||||
sink: &dyn crate::WriteSink,
|
sink: &dyn crate::WriteSink,
|
||||||
) -> Result<SyncResult, crate::WriteFailure> {
|
) -> Result<SyncResult, crate::WriteFailure> {
|
||||||
if crate::mcp_inject::files_managed_by_next(root) {
|
|
||||||
return Ok(SyncResult {
|
|
||||||
success: true,
|
|
||||||
conventions_written: false,
|
|
||||||
claude_md_action: "skipped".into(),
|
|
||||||
agents_md_action: "skipped".into(),
|
|
||||||
message: crate::mcp_inject::FILES_MANAGED_BY_NEXT_SKIP.into(),
|
|
||||||
});
|
|
||||||
}
|
|
||||||
let bp_dir = root.join(".blueprint");
|
let bp_dir = root.join(".blueprint");
|
||||||
let project_name = root
|
let project_name = root
|
||||||
.file_name()
|
.file_name()
|
||||||
@ -2885,22 +2876,6 @@ pub fn archive_project_docs(project_path: String) -> Result<ArchiveResult, Strin
|
|||||||
#[cfg(test)]
|
#[cfg(test)]
|
||||||
mod tests {
|
mod tests {
|
||||||
use super::*;
|
use super::*;
|
||||||
|
|
||||||
// 共存期防回写:项目文件已由新炼境接管时,蓝图规则同步零写入
|
|
||||||
#[test]
|
|
||||||
fn sync_skips_projects_managed_by_next() {
|
|
||||||
let base = std::env::temp_dir().join(format!("lianjing_sync_guard_test_{}", std::process::id()));
|
|
||||||
let _ = std::fs::remove_dir_all(&base);
|
|
||||||
std::fs::create_dir_all(base.join(".lian-jing")).unwrap();
|
|
||||||
std::fs::create_dir_all(base.join(".blueprint")).unwrap();
|
|
||||||
std::fs::write(base.join(".lian-jing/context.json"), r#"{"project_id":"p1","files_managed_by":"lian-jing-next"}"#).unwrap();
|
|
||||||
let result = sync_blueprint_rules_with(&base, &crate::DiskSink).unwrap();
|
|
||||||
assert_eq!((result.agents_md_action.as_str(), result.claude_md_action.as_str()), ("skipped", "skipped"));
|
|
||||||
assert!(!result.conventions_written);
|
|
||||||
assert!(!base.join(".blueprint/CONVENTIONS.md").exists());
|
|
||||||
assert!(!base.join("AGENTS.md").exists() && !base.join("CLAUDE.md").exists());
|
|
||||||
let _ = std::fs::remove_dir_all(&base);
|
|
||||||
}
|
|
||||||
use rusqlite::Connection;
|
use rusqlite::Connection;
|
||||||
use std::fs;
|
use std::fs;
|
||||||
|
|
||||||
|
|||||||
@ -125,10 +125,6 @@ fn poll_all_buffs(app: &AppHandle) {
|
|||||||
|
|
||||||
fn check_project(app: &AppHandle, project_path: &str) -> Result<(), String> {
|
fn check_project(app: &AppHandle, project_path: &str) -> Result<(), String> {
|
||||||
let root = Path::new(project_path);
|
let root = Path::new(project_path);
|
||||||
// 共存期防回写:项目文件已由新炼境接管,不再改写其任务卡
|
|
||||||
if crate::mcp_inject::files_managed_by_next(root) {
|
|
||||||
return Ok(());
|
|
||||||
}
|
|
||||||
|
|
||||||
// 获取当前 HEAD commit
|
// 获取当前 HEAD commit
|
||||||
let current_commit = match get_head_commit(root) {
|
let current_commit = match get_head_commit(root) {
|
||||||
|
|||||||
@ -199,14 +199,6 @@ pub(crate) fn dispatch_templates_with(
|
|||||||
root: &Path,
|
root: &Path,
|
||||||
sink: &dyn crate::WriteSink,
|
sink: &dyn crate::WriteSink,
|
||||||
) -> Vec<TemplateResult> {
|
) -> Vec<TemplateResult> {
|
||||||
if crate::mcp_inject::files_managed_by_next(root) {
|
|
||||||
return vec![TemplateResult {
|
|
||||||
name: ".lian-jing/context.json".into(),
|
|
||||||
action: "skipped".into(),
|
|
||||||
detail: crate::mcp_inject::FILES_MANAGED_BY_NEXT_SKIP.into(),
|
|
||||||
warning: None,
|
|
||||||
}];
|
|
||||||
}
|
|
||||||
vec![
|
vec![
|
||||||
dispatch_versioned(root, "AGENTS.md", TMPL_AGENTS, sink),
|
dispatch_versioned(root, "AGENTS.md", TMPL_AGENTS, sink),
|
||||||
dispatch_one(root, "lefthook.yml", TMPL_LEFTHOOK, sink),
|
dispatch_one(root, "lefthook.yml", TMPL_LEFTHOOK, sink),
|
||||||
@ -1251,21 +1243,6 @@ pub fn silent_projects(conn: &rusqlite::Connection) -> Result<Vec<(String, i64)>
|
|||||||
|
|
||||||
#[cfg(test)]
|
#[cfg(test)]
|
||||||
mod tests {
|
mod tests {
|
||||||
// 共存期防回写:项目文件已由新炼境接管时,接入包模板分发零写入
|
|
||||||
#[test]
|
|
||||||
fn dispatch_skips_projects_managed_by_next() {
|
|
||||||
let base = std::env::temp_dir().join(format!("lianjing_dispatch_guard_test_{}", std::process::id()));
|
|
||||||
let _ = std::fs::remove_dir_all(&base);
|
|
||||||
std::fs::create_dir_all(base.join(".lian-jing")).unwrap();
|
|
||||||
std::fs::create_dir_all(base.join(".blueprint")).unwrap();
|
|
||||||
std::fs::write(base.join(".lian-jing/context.json"), r#"{"project_id":"p1","files_managed_by":"lian-jing-next"}"#).unwrap();
|
|
||||||
let results = super::dispatch_templates(base.to_str().unwrap());
|
|
||||||
assert_eq!(results.len(), 1);
|
|
||||||
assert_eq!(results[0].action, "skipped");
|
|
||||||
assert!(!base.join("AGENTS.md").exists() && !base.join(".claude").exists() && !base.join("lefthook.yml").exists());
|
|
||||||
let _ = std::fs::remove_dir_all(&base);
|
|
||||||
}
|
|
||||||
|
|
||||||
use super::*;
|
use super::*;
|
||||||
|
|
||||||
#[test]
|
#[test]
|
||||||
|
|||||||
@ -235,20 +235,6 @@ fn write_json_with(
|
|||||||
.map_err(|error| format!("写入 {label} 失败: {error}"))
|
.map_err(|error| format!("写入 {label} 失败: {error}"))
|
||||||
}
|
}
|
||||||
|
|
||||||
/// 新炼境(lian-jing-next)接管项目文件后写入 `.lian-jing/context.json` 的 `files_managed_by` 取值。
|
|
||||||
pub(crate) const FILES_MANAGED_BY_NEXT: &str = "lian-jing-next";
|
|
||||||
|
|
||||||
/// 共存期防回写守卫:项目文件已由新炼境接管时,旧炼境的模板分发、蓝图规则同步与 buff 轮询一律跳过,
|
|
||||||
/// 避免两边来回覆盖同一批托管文件。只读判断,文件缺失或不合法时视为未接管。
|
|
||||||
pub(crate) fn files_managed_by_next(root: &std::path::Path) -> bool {
|
|
||||||
std::fs::read_to_string(root.join(".lian-jing").join("context.json"))
|
|
||||||
.ok()
|
|
||||||
.and_then(|text| serde_json::from_str::<Value>(&text).ok())
|
|
||||||
.is_some_and(|ctx| ctx.get("files_managed_by").and_then(Value::as_str) == Some(FILES_MANAGED_BY_NEXT))
|
|
||||||
}
|
|
||||||
|
|
||||||
pub(crate) const FILES_MANAGED_BY_NEXT_SKIP: &str = "项目文件已由新炼境接管(.lian-jing/context.json 的 files_managed_by),旧炼境不再分发";
|
|
||||||
|
|
||||||
/// 写工具无关的项目身份锚点。项目根目录是边界,客户端项目 UI 或用户级配置均不是身份来源。
|
/// 写工具无关的项目身份锚点。项目根目录是边界,客户端项目 UI 或用户级配置均不是身份来源。
|
||||||
/// 合并写入:保留未来字段与项目定制字段,只有炼境拥有的身份字段会被刷新。
|
/// 合并写入:保留未来字段与项目定制字段,只有炼境拥有的身份字段会被刷新。
|
||||||
#[cfg(test)]
|
#[cfg(test)]
|
||||||
@ -3637,26 +3623,6 @@ trust_level = "trusted"
|
|||||||
);
|
);
|
||||||
}
|
}
|
||||||
|
|
||||||
#[test]
|
|
||||||
fn files_managed_by_next_guard_reads_context_and_survives_identity_rewrite() {
|
|
||||||
let base = std::env::temp_dir().join(format!("lianjing_files_guard_test_{}", std::process::id()));
|
|
||||||
let _ = std::fs::remove_dir_all(&base);
|
|
||||||
std::fs::create_dir_all(base.join(".lian-jing")).unwrap();
|
|
||||||
assert!(!files_managed_by_next(&base), "没有 context.json 视为未接管");
|
|
||||||
std::fs::write(
|
|
||||||
base.join(".lian-jing/context.json"),
|
|
||||||
r#"{"project_id":"p1","schema_version":1,"files_managed_by":"lian-jing-next"}"#,
|
|
||||||
)
|
|
||||||
.unwrap();
|
|
||||||
assert!(files_managed_by_next(&base));
|
|
||||||
// 旧炼境刷新身份时必须保留接管标记,否则守卫会被自己抹掉
|
|
||||||
write_canonical_context_at(&base, "p1").unwrap();
|
|
||||||
assert!(files_managed_by_next(&base), "身份合并写后接管标记仍在");
|
|
||||||
std::fs::write(base.join(".lian-jing/context.json"), r#"{"project_id":"p1","files_managed_by":"other"}"#).unwrap();
|
|
||||||
assert!(!files_managed_by_next(&base));
|
|
||||||
let _ = std::fs::remove_dir_all(&base);
|
|
||||||
}
|
|
||||||
|
|
||||||
#[test]
|
#[test]
|
||||||
fn canonical_context_migrates_legacy_project_id_and_preserves_unknown_fields() {
|
fn canonical_context_migrates_legacy_project_id_and_preserves_unknown_fields() {
|
||||||
let base = std::env::temp_dir().join(format!(
|
let base = std::env::temp_dir().join(format!(
|
||||||
|
|||||||
@ -121,27 +121,13 @@ impl BlockReason {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
#[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
|
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
|
||||||
pub struct BlockedItem {
|
pub struct BlockedItem {
|
||||||
pub target: String,
|
pub target: String,
|
||||||
pub reason: BlockReason,
|
pub reason: BlockReason,
|
||||||
pub detail: String,
|
pub detail: String,
|
||||||
}
|
}
|
||||||
|
|
||||||
/// 序列化时附派生字段 skippable(= BlockReason::skippable):UI 与 agent 据此决定是否给「跳过」,
|
|
||||||
/// 可跳过判定只在本体一处(P8g,AGENTS.md「边界单点实现」)。反序列化忽略该字段;digest 不含它。
|
|
||||||
impl Serialize for BlockedItem {
|
|
||||||
fn serialize<S: serde::Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error> {
|
|
||||||
use serde::ser::SerializeStruct;
|
|
||||||
let mut item = serializer.serialize_struct("BlockedItem", 4)?;
|
|
||||||
item.serialize_field("target", &self.target)?;
|
|
||||||
item.serialize_field("reason", &self.reason)?;
|
|
||||||
item.serialize_field("detail", &self.detail)?;
|
|
||||||
item.serialize_field("skippable", &self.reason.skippable())?;
|
|
||||||
item.end()
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// 本机侧(不进仓库)的预计动作:token、稳定入口、三端客户端配置。
|
/// 本机侧(不进仓库)的预计动作:token、稳定入口、三端客户端配置。
|
||||||
/// status:noop(已就绪)| apply(apply 时会写)| not_installed | not_applicable | unavailable
|
/// status:noop(已就绪)| apply(apply 时会写)| not_installed | not_applicable | unavailable
|
||||||
/// | manual_kept | other_project | needs_human(后三者阻断确认,见 machine_step_blocker)。
|
/// | manual_kept | other_project | needs_human(后三者阻断确认,见 machine_step_blocker)。
|
||||||
@ -1054,28 +1040,6 @@ mod tests {
|
|||||||
let _ = std::fs::remove_dir_all(&root);
|
let _ = std::fs::remove_dir_all(&root);
|
||||||
}
|
}
|
||||||
|
|
||||||
/// 阻断项序列化带派生字段 skippable(P8g 界面据此给「跳过」,不在前端复制判定);反序列化忽略它。
|
|
||||||
#[test]
|
|
||||||
fn blocked_item_serializes_skippable_from_reason() {
|
|
||||||
for (reason, skippable) in [
|
|
||||||
(BlockReason::ManualEntry, true),
|
|
||||||
(BlockReason::SharedKey, true),
|
|
||||||
(BlockReason::MixedFile, false),
|
|
||||||
(BlockReason::IdentityConflict, false),
|
|
||||||
(BlockReason::NeedsHuman, false),
|
|
||||||
] {
|
|
||||||
let item = BlockedItem {
|
|
||||||
target: "t".into(),
|
|
||||||
reason,
|
|
||||||
detail: "d".into(),
|
|
||||||
};
|
|
||||||
let value = serde_json::to_value(&item).unwrap();
|
|
||||||
assert_eq!(value["skippable"], skippable, "{reason:?}");
|
|
||||||
assert_eq!(value["target"], "t");
|
|
||||||
assert_eq!(serde_json::from_value::<BlockedItem>(value).unwrap(), item);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// 身份冲突、混合文件与需人工处理的项不可跳过(P8d 审查 ②):即使列进 skip_targets 也照旧阻断。
|
/// 身份冲突、混合文件与需人工处理的项不可跳过(P8d 审查 ②):即使列进 skip_targets 也照旧阻断。
|
||||||
#[test]
|
#[test]
|
||||||
fn identity_conflict_and_needs_human_cannot_be_skipped() {
|
fn identity_conflict_and_needs_human_cannot_be_skipped() {
|
||||||
|
|||||||
@ -2,7 +2,6 @@ import { useState, useEffect } from "react";
|
|||||||
import { OverviewPage } from "./components/overview/OverviewPage";
|
import { OverviewPage } from "./components/overview/OverviewPage";
|
||||||
import { Dashboard } from "./components/dashboard/Dashboard";
|
import { Dashboard } from "./components/dashboard/Dashboard";
|
||||||
import { ProjectModal } from "./components/dashboard/ProjectModal";
|
import { ProjectModal } from "./components/dashboard/ProjectModal";
|
||||||
import { OnboardPanel } from "./components/dashboard/OnboardPanel";
|
|
||||||
import { ResourcesPage } from "./components/resources/ResourcesPage";
|
import { ResourcesPage } from "./components/resources/ResourcesPage";
|
||||||
import { ToolsPage } from "./components/tools/ToolsPage";
|
import { ToolsPage } from "./components/tools/ToolsPage";
|
||||||
import { SettingsPage } from "./components/settings/SettingsPage";
|
import { SettingsPage } from "./components/settings/SettingsPage";
|
||||||
@ -76,7 +75,6 @@ export default function App() {
|
|||||||
</main>
|
</main>
|
||||||
|
|
||||||
<ProjectModal />
|
<ProjectModal />
|
||||||
<OnboardPanel />
|
|
||||||
<Toast />
|
<Toast />
|
||||||
</div>
|
</div>
|
||||||
);
|
);
|
||||||
|
|||||||
@ -1,47 +1,10 @@
|
|||||||
import { useState } from "react";
|
import { useState } from "react";
|
||||||
import { useQuery, useQueryClient } from "@tanstack/react-query";
|
import { useQuery, useQueryClient } from "@tanstack/react-query";
|
||||||
import { open } from "@tauri-apps/plugin-dialog";
|
import { open } from "@tauri-apps/plugin-dialog";
|
||||||
import { batchCreateProjects, getSpaces, scanSubfolders, type OnboardStatus, type SubFolder } from "../../lib/commands";
|
import { batchCreateProjects, getSpaces, scanSubfolders, type SubFolder } from "../../lib/commands";
|
||||||
import { useUIStore } from "../../store/ui";
|
import { useUIStore } from "../../store/ui";
|
||||||
import { Dialog } from "../ui/Dialog";
|
import { Dialog } from "../ui/Dialog";
|
||||||
|
|
||||||
/** 本次添加成功的项目:批量只给入口、不自动接入(P8g),每个项目各自预览确认 */
|
|
||||||
interface AddedProject {
|
|
||||||
id: string;
|
|
||||||
name: string;
|
|
||||||
/** 本次面板里的接入结果;cancelled = 打开后未执行接入 */
|
|
||||||
onboard?: OnboardStatus | "cancelled";
|
|
||||||
}
|
|
||||||
|
|
||||||
const ONBOARD_STATUS_LABEL: Record<OnboardStatus | "cancelled", string> = {
|
|
||||||
done: "✓ 接入完成",
|
|
||||||
partial: "⚠ 部分完成",
|
|
||||||
failed: "✗ 预检失败",
|
|
||||||
refused: "⚠ 已拒绝,需重新确认",
|
|
||||||
busy: "… 正在接入中",
|
|
||||||
cancelled: "未接入",
|
|
||||||
};
|
|
||||||
|
|
||||||
function AddedProjects({ added, onOnboard }: { added: AddedProject[]; onOnboard: (project: AddedProject) => void }) {
|
|
||||||
return (
|
|
||||||
<div className="px-6 py-4 space-y-2">
|
|
||||||
<p className="text-sm text-gray-700">已添加 {added.length} 个项目。一键接入需逐个预览并确认,不会自动写入子项目:</p>
|
|
||||||
{added.map((project) => (
|
|
||||||
<div key={project.id} className="flex items-center gap-3 border border-gray-100 rounded-lg px-3 py-2">
|
|
||||||
<span className="flex-1 min-w-0 truncate text-sm text-gray-800">{project.name}</span>
|
|
||||||
<span className="text-xs text-gray-500">{project.onboard ? ONBOARD_STATUS_LABEL[project.onboard] : "未接入"}</span>
|
|
||||||
<button
|
|
||||||
onClick={() => onOnboard(project)}
|
|
||||||
className="px-3 py-1 rounded-lg border border-blue-200 text-xs text-blue-700 hover:bg-blue-50 shrink-0"
|
|
||||||
>
|
|
||||||
{project.onboard === "done" ? "重新检查" : "一键接入"}
|
|
||||||
</button>
|
|
||||||
</div>
|
|
||||||
))}
|
|
||||||
</div>
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
// Windows 路径转 WSL 路径(仅 /mnt/x/... 形式,不处理 UNC)
|
// Windows 路径转 WSL 路径(仅 /mnt/x/... 形式,不处理 UNC)
|
||||||
function winToWsl(p: string): string {
|
function winToWsl(p: string): string {
|
||||||
const norm = p.replace(/\\/g, "/");
|
const norm = p.replace(/\\/g, "/");
|
||||||
@ -59,19 +22,7 @@ interface FolderItem extends SubFolder {
|
|||||||
|
|
||||||
export function BatchAddModal({ onClose }: { onClose: () => void }) {
|
export function BatchAddModal({ onClose }: { onClose: () => void }) {
|
||||||
const showToast = useUIStore((s) => s.showToast);
|
const showToast = useUIStore((s) => s.showToast);
|
||||||
const openOnboard = useUIStore((s) => s.openOnboard);
|
|
||||||
const qc = useQueryClient();
|
const qc = useQueryClient();
|
||||||
const [added, setAdded] = useState<AddedProject[] | null>(null);
|
|
||||||
|
|
||||||
const onboardOne = (project: AddedProject) =>
|
|
||||||
openOnboard({
|
|
||||||
projectId: project.id,
|
|
||||||
projectName: project.name,
|
|
||||||
onClosed: (report) =>
|
|
||||||
setAdded((prev) =>
|
|
||||||
prev?.map((p) => (p.id === project.id ? { ...p, onboard: report?.status ?? p.onboard ?? "cancelled" } : p)) ?? prev,
|
|
||||||
),
|
|
||||||
});
|
|
||||||
|
|
||||||
const { data: spaces = [] } = useQuery({ queryKey: ["spaces"], queryFn: getSpaces });
|
const { data: spaces = [] } = useQuery({ queryKey: ["spaces"], queryFn: getSpaces });
|
||||||
const currentSpace = spaces.find((s) => s.is_current);
|
const currentSpace = spaces.find((s) => s.is_current);
|
||||||
@ -152,12 +103,7 @@ export function BatchAddModal({ onClose }: { onClose: () => void }) {
|
|||||||
} else {
|
} else {
|
||||||
showToast(`成功添加 ${selected.length} 个项目 ✓`);
|
showToast(`成功添加 ${selected.length} 个项目 ✓`);
|
||||||
}
|
}
|
||||||
// 没有目录的登记(概念占位)不给接入入口
|
onClose();
|
||||||
const created = payload
|
|
||||||
.filter((p) => !skipped.includes(p.id) && (p.win_path || p.wsl_path))
|
|
||||||
.map((p) => ({ id: p.id, name: p.name }));
|
|
||||||
if (created.length > 0) setAdded(created);
|
|
||||||
else onClose();
|
|
||||||
} catch (e) {
|
} catch (e) {
|
||||||
showToast(`❌ ${e}`);
|
showToast(`❌ ${e}`);
|
||||||
} finally {
|
} finally {
|
||||||
@ -167,19 +113,6 @@ export function BatchAddModal({ onClose }: { onClose: () => void }) {
|
|||||||
|
|
||||||
const checkedCount = items.filter((i) => i.checked).length;
|
const checkedCount = items.filter((i) => i.checked).length;
|
||||||
|
|
||||||
if (added) {
|
|
||||||
return (
|
|
||||||
<Dialog title="批量添加项目" onClose={onClose} size="lg">
|
|
||||||
<AddedProjects added={added} onOnboard={onboardOne} />
|
|
||||||
<div className="flex justify-end px-6 py-4 border-t border-gray-100">
|
|
||||||
<button onClick={onClose} className="px-4 py-2 rounded-lg text-sm border border-gray-200 text-gray-600 hover:bg-gray-50">
|
|
||||||
完成
|
|
||||||
</button>
|
|
||||||
</div>
|
|
||||||
</Dialog>
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
return (
|
return (
|
||||||
<Dialog title="批量添加项目" onClose={onClose} size="lg">
|
<Dialog title="批量添加项目" onClose={onClose} size="lg">
|
||||||
<div className="px-6 py-4 space-y-4">
|
<div className="px-6 py-4 space-y-4">
|
||||||
|
|||||||
@ -20,6 +20,7 @@ import {
|
|||||||
getBlueprintStatus,
|
getBlueprintStatus,
|
||||||
syncBlueprintRules,
|
syncBlueprintRules,
|
||||||
generateBlueprintPrompt,
|
generateBlueprintPrompt,
|
||||||
|
applyOnboardingPack,
|
||||||
getCommitStats,
|
getCommitStats,
|
||||||
removeBlueprintBuff,
|
removeBlueprintBuff,
|
||||||
getBuffStatus,
|
getBuffStatus,
|
||||||
@ -30,10 +31,10 @@ import {
|
|||||||
type BlueprintStatus,
|
type BlueprintStatus,
|
||||||
type SyncResult,
|
type SyncResult,
|
||||||
type BuffStatus,
|
type BuffStatus,
|
||||||
|
type TemplateResult,
|
||||||
|
type HookActivation,
|
||||||
type CommitStats,
|
type CommitStats,
|
||||||
type OnboardReport,
|
|
||||||
} from "../../lib/commands";
|
} from "../../lib/commands";
|
||||||
import { useUIStore } from "../../store/ui";
|
|
||||||
|
|
||||||
interface Props {
|
interface Props {
|
||||||
projectName: string;
|
projectName: string;
|
||||||
@ -53,6 +54,19 @@ const STATUS_CONFIG: Record<string, { color: string; bg: string; label: string }
|
|||||||
abandoned: { color: "#52525B", bg: "#FAFAFA", label: "已退役" },
|
abandoned: { color: "#52525B", bg: "#FAFAFA", label: "已退役" },
|
||||||
};
|
};
|
||||||
|
|
||||||
|
// 接入包模板分发五态(对应 onboarding.rs TemplateResult.action)
|
||||||
|
// label 为 null 时展示后端 detail(updated/appended/failed 的 detail 含版本信息)
|
||||||
|
const TEMPLATE_ACTION_STYLE: Record<
|
||||||
|
string,
|
||||||
|
{ icon: string; color: string; label: string | null }
|
||||||
|
> = {
|
||||||
|
written: { icon: "✓", color: "text-green-600", label: "已写入" },
|
||||||
|
updated: { icon: "↑", color: "text-blue-600", label: null },
|
||||||
|
appended: { icon: "+", color: "text-blue-600", label: null },
|
||||||
|
skipped: { icon: "○", color: "text-gray-400", label: "已存在" },
|
||||||
|
failed: { icon: "✗", color: "text-red-600", label: null },
|
||||||
|
};
|
||||||
|
|
||||||
const TASK_PREFIX: Record<string, string> = {
|
const TASK_PREFIX: Record<string, string> = {
|
||||||
done: "✅",
|
done: "✅",
|
||||||
in_progress: "🔵",
|
in_progress: "🔵",
|
||||||
@ -1044,9 +1058,8 @@ function GovernancePanel({
|
|||||||
const [buffError, setBuffError] = useState<string | null>(null);
|
const [buffError, setBuffError] = useState<string | null>(null);
|
||||||
const [buffInitPrompt, setBuffInitPrompt] = useState<string | null>(null);
|
const [buffInitPrompt, setBuffInitPrompt] = useState<string | null>(null);
|
||||||
const [buffInitCopied, setBuffInitCopied] = useState(false);
|
const [buffInitCopied, setBuffInitCopied] = useState(false);
|
||||||
/** 最近一次一键接入的结果摘要(详情在接入面板里看过) */
|
const [packTemplates, setPackTemplates] = useState<TemplateResult[] | null>(null);
|
||||||
const [onboardSummary, setOnboardSummary] = useState<string | null>(null);
|
const [packHook, setPackHook] = useState<HookActivation | null>(null);
|
||||||
const openOnboard = useUIStore((s) => s.openOnboard);
|
|
||||||
|
|
||||||
const [promptMode, setPromptMode] = useState<"init" | "sync" | null>(null);
|
const [promptMode, setPromptMode] = useState<"init" | "sync" | null>(null);
|
||||||
const [prompt, setPrompt] = useState("");
|
const [prompt, setPrompt] = useState("");
|
||||||
@ -1054,29 +1067,28 @@ function GovernancePanel({
|
|||||||
const [promptError, setPromptError] = useState<string | null>(null);
|
const [promptError, setPromptError] = useState<string | null>(null);
|
||||||
const [copied, setCopied] = useState(false);
|
const [copied, setCopied] = useState(false);
|
||||||
|
|
||||||
/** 接入面板关闭后:未执行接入不动;执行过则刷新 buff,尚无蓝图时给 init prompt */
|
const handleApplyBuff = async () => {
|
||||||
const afterOnboard = async (report: OnboardReport | null) => {
|
|
||||||
if (!report) return;
|
|
||||||
setOnboardSummary(`${report.status}:${report.summary}`);
|
|
||||||
refetchBuff();
|
|
||||||
if (report.status !== "done" && report.status !== "partial") return;
|
|
||||||
// 只有尚无蓝图时才展示 init prompt;已有蓝图则 Buff 直接激活无需初始化
|
|
||||||
if (bpStatus?.status === "none") {
|
|
||||||
try {
|
|
||||||
setBuffInitPrompt(await generateBlueprintPrompt(projectPath, "init"));
|
|
||||||
} catch (e) {
|
|
||||||
setBuffError(String(e));
|
|
||||||
}
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
// 「应用接入包」改为一键接入:先 plan 预览、人确认后再 apply(P8g),与新建项目走同一面板
|
|
||||||
const handleApplyBuff = () => {
|
|
||||||
if (!projectId) return;
|
if (!projectId) return;
|
||||||
|
setBuffLoading(true);
|
||||||
setBuffError(null);
|
setBuffError(null);
|
||||||
setBuffInitPrompt(null);
|
setBuffInitPrompt(null);
|
||||||
setOnboardSummary(null);
|
setPackTemplates(null);
|
||||||
openOnboard({ projectId, projectName, onClosed: (report) => void afterOnboard(report) });
|
setPackHook(null);
|
||||||
|
try {
|
||||||
|
const report = await applyOnboardingPack(projectPath, projectId);
|
||||||
|
setPackTemplates(report.templates);
|
||||||
|
setPackHook(report.hook);
|
||||||
|
refetchBuff();
|
||||||
|
// 只有尚无蓝图时才展示 init prompt;已有蓝图则 Buff 直接激活无需初始化
|
||||||
|
if (bpStatus?.status === "none") {
|
||||||
|
const p = await generateBlueprintPrompt(projectPath, "init").catch(() => null);
|
||||||
|
if (p) setBuffInitPrompt(p);
|
||||||
|
}
|
||||||
|
} catch (e) {
|
||||||
|
setBuffError(String(e));
|
||||||
|
} finally {
|
||||||
|
setBuffLoading(false);
|
||||||
|
}
|
||||||
};
|
};
|
||||||
|
|
||||||
const handleRemoveBuff = async () => {
|
const handleRemoveBuff = async () => {
|
||||||
@ -1086,7 +1098,8 @@ function GovernancePanel({
|
|||||||
await removeBlueprintBuff(projectPath);
|
await removeBlueprintBuff(projectPath);
|
||||||
refetchBuff();
|
refetchBuff();
|
||||||
setBuffInitPrompt(null);
|
setBuffInitPrompt(null);
|
||||||
setOnboardSummary(null);
|
setPackTemplates(null);
|
||||||
|
setPackHook(null);
|
||||||
} catch (e) {
|
} catch (e) {
|
||||||
setBuffError(String(e));
|
setBuffError(String(e));
|
||||||
} finally {
|
} finally {
|
||||||
@ -1283,7 +1296,7 @@ function GovernancePanel({
|
|||||||
)}
|
)}
|
||||||
</div>
|
</div>
|
||||||
<p className="text-[11px] text-gray-500 leading-relaxed">
|
<p className="text-[11px] text-gray-500 leading-relaxed">
|
||||||
一键接入:先预览将写入的接入包文件(AGENTS.md / lefthook / git-workflow 等)与本机三端配置,确认后再写入,并挂 buff 自动监听 git 提交、采集飞轮数据。
|
应用接入包:种入 AGENTS.md / lefthook / git-workflow 标准模板(不覆盖已有),并挂 buff 自动监听 git 提交、采集飞轮数据。
|
||||||
</p>
|
</p>
|
||||||
{buffStatus?.last_sync_at && (
|
{buffStatus?.last_sync_at && (
|
||||||
<p className="text-[10px] text-gray-400">上次同步:{buffStatus.last_sync_at}</p>
|
<p className="text-[10px] text-gray-400">上次同步:{buffStatus.last_sync_at}</p>
|
||||||
@ -1291,27 +1304,54 @@ function GovernancePanel({
|
|||||||
{buffError && (
|
{buffError && (
|
||||||
<p className="text-[11px] text-red-600 font-mono break-all">{buffError}</p>
|
<p className="text-[11px] text-red-600 font-mono break-all">{buffError}</p>
|
||||||
)}
|
)}
|
||||||
{onboardSummary && (
|
{packTemplates && (
|
||||||
<p className="text-[10px] text-gray-500 break-all">最近一次一键接入:{onboardSummary}</p>
|
<div className="space-y-0.5 pt-0.5">
|
||||||
|
<p className="text-[10px] text-gray-500 font-semibold">模板分发</p>
|
||||||
|
{packTemplates.map((t) => {
|
||||||
|
const style =
|
||||||
|
TEMPLATE_ACTION_STYLE[t.action] ?? TEMPLATE_ACTION_STYLE.failed;
|
||||||
|
return (
|
||||||
|
<div key={t.name}>
|
||||||
|
<p className="text-[10px] font-mono flex items-center gap-1">
|
||||||
|
<span className={style.color}>{style.icon}</span>
|
||||||
|
<span className="text-gray-600 truncate flex-1">{t.name}</span>
|
||||||
|
<span className="text-gray-400">{style.label ?? t.detail}</span>
|
||||||
|
</p>
|
||||||
|
{t.warning && (
|
||||||
|
<p className="text-[10px] text-amber-600 leading-relaxed pl-3">⚠ {t.warning}</p>
|
||||||
|
)}
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
})}
|
||||||
|
{packHook && (
|
||||||
|
<p className="text-[10px] font-mono flex items-center gap-1">
|
||||||
|
<span
|
||||||
|
className={
|
||||||
|
packHook.status === "activated"
|
||||||
|
? "text-green-600"
|
||||||
|
: packHook.status === "missing_binary"
|
||||||
|
? "text-amber-500"
|
||||||
|
: "text-red-500"
|
||||||
|
}
|
||||||
|
>
|
||||||
|
{packHook.status === "activated" ? "✓" : packHook.status === "missing_binary" ? "⚠" : "✗"}
|
||||||
|
</span>
|
||||||
|
<span className="text-gray-600 truncate flex-1">lefthook hook</span>
|
||||||
|
<span className="text-gray-400 truncate" title={packHook.detail}>
|
||||||
|
{packHook.detail}
|
||||||
|
</span>
|
||||||
|
</p>
|
||||||
|
)}
|
||||||
|
</div>
|
||||||
)}
|
)}
|
||||||
{buffStatus?.status === "active" ? (
|
{buffStatus?.status === "active" ? (
|
||||||
<div className="flex gap-2">
|
<button
|
||||||
<button
|
onClick={handleRemoveBuff}
|
||||||
onClick={handleApplyBuff}
|
disabled={buffLoading}
|
||||||
disabled={buffLoading || !projectId}
|
className="w-full py-1.5 rounded-lg border border-red-200 text-red-600 text-xs hover:bg-red-50 disabled:opacity-50 transition-colors"
|
||||||
title={!projectId ? "需要传入 projectId" : "重新计划并预览,确认后补齐缺失项"}
|
>
|
||||||
className="flex-1 py-1.5 rounded-lg border border-purple-200 text-purple-700 text-xs hover:bg-purple-50 disabled:opacity-50 transition-colors"
|
{buffLoading ? "处理中…" : "撤销 Buff"}
|
||||||
>
|
</button>
|
||||||
重新检查接入
|
|
||||||
</button>
|
|
||||||
<button
|
|
||||||
onClick={handleRemoveBuff}
|
|
||||||
disabled={buffLoading}
|
|
||||||
className="flex-1 py-1.5 rounded-lg border border-red-200 text-red-600 text-xs hover:bg-red-50 disabled:opacity-50 transition-colors"
|
|
||||||
>
|
|
||||||
{buffLoading ? "处理中…" : "撤销 Buff"}
|
|
||||||
</button>
|
|
||||||
</div>
|
|
||||||
) : (
|
) : (
|
||||||
<button
|
<button
|
||||||
onClick={handleApplyBuff}
|
onClick={handleApplyBuff}
|
||||||
@ -1319,7 +1359,7 @@ function GovernancePanel({
|
|||||||
title={!projectId ? "需要传入 projectId" : undefined}
|
title={!projectId ? "需要传入 projectId" : undefined}
|
||||||
className="w-full py-1.5 rounded-lg bg-purple-600 text-white text-xs hover:bg-purple-700 disabled:opacity-50 transition-colors"
|
className="w-full py-1.5 rounded-lg bg-purple-600 text-white text-xs hover:bg-purple-700 disabled:opacity-50 transition-colors"
|
||||||
>
|
>
|
||||||
⚡ 一键接入(先预览再确认)
|
{buffLoading ? "施加中…" : "⚡ 施加 Buff"}
|
||||||
</button>
|
</button>
|
||||||
)}
|
)}
|
||||||
{/* 已有蓝图时施加 Buff:直接激活,无需初始化 */}
|
{/* 已有蓝图时施加 Buff:直接激活,无需初始化 */}
|
||||||
|
|||||||
@ -1,189 +0,0 @@
|
|||||||
// 一键接入面板(agent-client-parity P8g):plan_onboarding 预览 → 人确认 → onboard_project → 分步结果。
|
|
||||||
// 全局挂载在 App,由 useUIStore.openOnboard 打开。判定全部来自后端,映射见 onboardView.ts。
|
|
||||||
import { useCallback, useEffect, useRef, useState } from "react";
|
|
||||||
import { useQueryClient } from "@tanstack/react-query";
|
|
||||||
import { onboardProject, planOnboarding, type OnboardReport, type OnboardingPlan } from "../../lib/commands";
|
|
||||||
import { useUIStore } from "../../store/ui";
|
|
||||||
import {
|
|
||||||
DEFAULT_SELECTION,
|
|
||||||
buildPlanView,
|
|
||||||
buildReportView,
|
|
||||||
confirmRequest,
|
|
||||||
selectionOptions,
|
|
||||||
setBypass,
|
|
||||||
toggleSkip,
|
|
||||||
type OnboardSelection,
|
|
||||||
} from "./onboardView";
|
|
||||||
import { PlanPreview, ReportResult } from "./OnboardSections";
|
|
||||||
|
|
||||||
type Phase =
|
|
||||||
| { kind: "planning" }
|
|
||||||
| { kind: "preview"; plan: OnboardingPlan; planned: OnboardSelection }
|
|
||||||
| { kind: "applying"; plan: OnboardingPlan; planned: OnboardSelection }
|
|
||||||
| { kind: "report"; report: OnboardReport }
|
|
||||||
| { kind: "error"; message: string };
|
|
||||||
|
|
||||||
export function OnboardPanel() {
|
|
||||||
const target = useUIStore((s) => s.onboardTarget);
|
|
||||||
if (!target) return null;
|
|
||||||
// key:换项目即重置面板状态
|
|
||||||
return <OnboardPanelBody key={target.projectId} />;
|
|
||||||
}
|
|
||||||
|
|
||||||
function OnboardPanelBody() {
|
|
||||||
const target = useUIStore((s) => s.onboardTarget)!;
|
|
||||||
const closeOnboard = useUIStore((s) => s.closeOnboard);
|
|
||||||
const showToast = useUIStore((s) => s.showToast);
|
|
||||||
const qc = useQueryClient();
|
|
||||||
const [phase, setPhase] = useState<Phase>({ kind: "planning" });
|
|
||||||
const [selection, setSelection] = useState<OnboardSelection>(DEFAULT_SELECTION);
|
|
||||||
const lastReport = useRef<OnboardReport | null>(null);
|
|
||||||
const requestSeq = useRef(0);
|
|
||||||
|
|
||||||
const plan = useCallback(
|
|
||||||
async (chosen: OnboardSelection) => {
|
|
||||||
const seq = ++requestSeq.current;
|
|
||||||
setPhase({ kind: "planning" });
|
|
||||||
try {
|
|
||||||
const next = await planOnboarding(target.projectId, selectionOptions(chosen));
|
|
||||||
if (seq === requestSeq.current) setPhase({ kind: "preview", plan: next, planned: chosen });
|
|
||||||
} catch (e) {
|
|
||||||
if (seq === requestSeq.current) setPhase({ kind: "error", message: String(e) });
|
|
||||||
}
|
|
||||||
},
|
|
||||||
[target.projectId],
|
|
||||||
);
|
|
||||||
|
|
||||||
useEffect(() => {
|
|
||||||
void plan(DEFAULT_SELECTION);
|
|
||||||
}, [plan]);
|
|
||||||
|
|
||||||
const applyConfirmed = async () => {
|
|
||||||
if (phase.kind !== "preview") return;
|
|
||||||
const request = confirmRequest(phase.plan, phase.planned, selection);
|
|
||||||
if (!request) return;
|
|
||||||
const seq = ++requestSeq.current;
|
|
||||||
setPhase({ kind: "applying", plan: phase.plan, planned: phase.planned });
|
|
||||||
try {
|
|
||||||
const report = await onboardProject(request.projectId, request.expectedDigest, request.confirmed, request.options);
|
|
||||||
if (seq !== requestSeq.current) return;
|
|
||||||
lastReport.current = report;
|
|
||||||
setPhase({ kind: "report", report });
|
|
||||||
showToast(buildReportView(report).toast, 4000);
|
|
||||||
void qc.invalidateQueries({ queryKey: ["projects"] });
|
|
||||||
} catch (e) {
|
|
||||||
if (seq === requestSeq.current) setPhase({ kind: "error", message: String(e) });
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
/** refused 附当前计划:回到预览,按新计划重新确认(选项沿用后端拒绝时的那组) */
|
|
||||||
const reviewReplan = (next: OnboardingPlan) => {
|
|
||||||
if (phase.kind !== "report") return;
|
|
||||||
setPhase({ kind: "preview", plan: next, planned: selection });
|
|
||||||
};
|
|
||||||
|
|
||||||
const close = () => {
|
|
||||||
if (phase.kind === "applying") return; // 写入进行中不允许关闭,避免误以为已取消
|
|
||||||
requestSeq.current += 1;
|
|
||||||
const report = lastReport.current;
|
|
||||||
closeOnboard();
|
|
||||||
target.onClosed?.(report);
|
|
||||||
};
|
|
||||||
|
|
||||||
const title = `一键接入${target.projectName ? ` · ${target.projectName}` : ""}`;
|
|
||||||
return (
|
|
||||||
<div className="fixed inset-0 z-[60] flex items-center justify-center bg-black/50">
|
|
||||||
<div className="bg-white rounded-xl shadow-2xl w-full max-w-3xl mx-4 flex flex-col" style={{ maxHeight: "88vh" }}>
|
|
||||||
<div className="flex items-center justify-between px-6 py-4 border-b border-gray-100 shrink-0">
|
|
||||||
<h2 className="text-base font-semibold text-gray-900">{title}</h2>
|
|
||||||
<button
|
|
||||||
onClick={close}
|
|
||||||
disabled={phase.kind === "applying"}
|
|
||||||
className="text-gray-400 hover:text-gray-600 text-xl leading-none disabled:opacity-30"
|
|
||||||
aria-label="关闭"
|
|
||||||
>
|
|
||||||
×
|
|
||||||
</button>
|
|
||||||
</div>
|
|
||||||
<div className="flex-1 min-h-0 overflow-y-auto px-6 py-4 space-y-4 text-sm">
|
|
||||||
{phase.kind === "planning" && <p className="text-gray-400">正在生成接入计划(只读,不写任何文件)…</p>}
|
|
||||||
{phase.kind === "error" && (
|
|
||||||
<p className="text-red-600 font-mono text-xs break-all">❌ {phase.message}</p>
|
|
||||||
)}
|
|
||||||
{(phase.kind === "preview" || phase.kind === "applying") && (
|
|
||||||
<PlanPreview
|
|
||||||
view={buildPlanView(phase.plan, phase.planned, selection)}
|
|
||||||
disabled={phase.kind === "applying"}
|
|
||||||
onToggleSkip={(item) => setSelection((s) => toggleSkip(s, item))}
|
|
||||||
onBypass={(on) => setSelection((s) => setBypass(s, on))}
|
|
||||||
/>
|
|
||||||
)}
|
|
||||||
{phase.kind === "report" && (
|
|
||||||
<ReportResult view={buildReportView(phase.report)} onReviewReplan={reviewReplan} />
|
|
||||||
)}
|
|
||||||
</div>
|
|
||||||
<PanelFooter
|
|
||||||
phase={phase}
|
|
||||||
selection={selection}
|
|
||||||
onCancel={close}
|
|
||||||
onReplan={() => void plan(selection)}
|
|
||||||
onConfirm={() => void applyConfirmed()}
|
|
||||||
/>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
const btnCls = "px-4 py-2 rounded-lg text-sm border transition-colors disabled:opacity-50";
|
|
||||||
|
|
||||||
function PanelFooter({
|
|
||||||
phase,
|
|
||||||
selection,
|
|
||||||
onCancel,
|
|
||||||
onReplan,
|
|
||||||
onConfirm,
|
|
||||||
}: {
|
|
||||||
phase: Phase;
|
|
||||||
selection: OnboardSelection;
|
|
||||||
onCancel: () => void;
|
|
||||||
onReplan: () => void;
|
|
||||||
onConfirm: () => void;
|
|
||||||
}) {
|
|
||||||
const view = phase.kind === "preview" ? buildPlanView(phase.plan, phase.planned, selection) : null;
|
|
||||||
return (
|
|
||||||
<div className="flex items-center justify-end gap-3 px-6 py-4 border-t border-gray-100 shrink-0">
|
|
||||||
{view?.confirm.reason && <p className="flex-1 text-xs text-amber-700">{view.confirm.reason}</p>}
|
|
||||||
{phase.kind === "applying" && (
|
|
||||||
<p className="flex-1 text-xs text-gray-500">正在接入:首次可能 30 秒以上,完成前请勿关闭…</p>
|
|
||||||
)}
|
|
||||||
{phase.kind === "report" ? (
|
|
||||||
<button onClick={onCancel} className={`${btnCls} border-gray-200 text-gray-700 hover:bg-gray-50`}>
|
|
||||||
关闭
|
|
||||||
</button>
|
|
||||||
) : (
|
|
||||||
<button
|
|
||||||
onClick={onCancel}
|
|
||||||
disabled={phase.kind === "applying"}
|
|
||||||
className={`${btnCls} border-gray-200 text-gray-600 hover:bg-gray-50`}
|
|
||||||
title={phase.kind === "error" ? "关闭面板;若错误发生在确认接入之后,可能已有部分写入,请重新计划核对" : "取消不写入任何文件"}
|
|
||||||
>
|
|
||||||
取消
|
|
||||||
</button>
|
|
||||||
)}
|
|
||||||
{(phase.kind === "error" || (view && (view.needsReplan || view.blockingCount > 0))) && (
|
|
||||||
<button onClick={onReplan} className={`${btnCls} border-blue-200 text-blue-700 hover:bg-blue-50`}>
|
|
||||||
{phase.kind === "error" ? "重试" : "重新计划"}
|
|
||||||
</button>
|
|
||||||
)}
|
|
||||||
{(phase.kind === "preview" || phase.kind === "applying") && (
|
|
||||||
<button
|
|
||||||
onClick={onConfirm}
|
|
||||||
disabled={phase.kind === "applying" || !view?.confirm.enabled}
|
|
||||||
className={`${btnCls} border-transparent bg-blue-600 text-white hover:bg-blue-700`}
|
|
||||||
>
|
|
||||||
{phase.kind === "applying" ? "接入中…" : "确认接入"}
|
|
||||||
</button>
|
|
||||||
)}
|
|
||||||
</div>
|
|
||||||
);
|
|
||||||
}
|
|
||||||
@ -1,277 +0,0 @@
|
|||||||
// 一键接入面板的呈现块(P8g):计划预览与接入结果。只渲染 onboardView 的视图模型,不做判定。
|
|
||||||
import type { ReactNode } from "react";
|
|
||||||
import type { OnboardBlockedItem, OnboardingPlan } from "../../lib/commands";
|
|
||||||
import { PARITY_CHECKS, CHECK_LABEL, type OnboardTone, type PlanView, type ReportView } from "./onboardView";
|
|
||||||
|
|
||||||
const TONE_CLS: Record<OnboardTone, string> = {
|
|
||||||
ok: "text-green-700 bg-green-50 border-green-200",
|
|
||||||
info: "text-blue-700 bg-blue-50 border-blue-200",
|
|
||||||
muted: "text-gray-500 bg-gray-50 border-gray-200",
|
|
||||||
pending: "text-violet-700 bg-violet-50 border-violet-200",
|
|
||||||
warn: "text-amber-700 bg-amber-50 border-amber-200",
|
|
||||||
danger: "text-red-700 bg-red-50 border-red-200",
|
|
||||||
};
|
|
||||||
|
|
||||||
function ToneBadge({ tone, children }: { tone: OnboardTone; children: ReactNode }) {
|
|
||||||
return (
|
|
||||||
<span className={`inline-block shrink-0 text-[10px] px-1.5 py-0.5 rounded border ${TONE_CLS[tone]}`}>{children}</span>
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
function Section({ title, extra, children }: { title: string; extra?: ReactNode; children: ReactNode }) {
|
|
||||||
return (
|
|
||||||
<section className="space-y-1.5">
|
|
||||||
<div className="flex items-center gap-2">
|
|
||||||
<p className="text-xs font-semibold text-gray-500">{title}</p>
|
|
||||||
{extra}
|
|
||||||
</div>
|
|
||||||
{children}
|
|
||||||
</section>
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
function Row({ label, tone, badge, detail, mono }: { label: ReactNode; tone: OnboardTone; badge: string; detail?: string; mono?: boolean }) {
|
|
||||||
return (
|
|
||||||
<div className="flex items-start gap-2 text-xs">
|
|
||||||
<span className={`flex-1 min-w-0 truncate text-gray-700 ${mono ? "font-mono" : ""}`}>{label}</span>
|
|
||||||
{detail && <span className="max-w-[55%] text-gray-400 truncate" title={detail}>{detail}</span>}
|
|
||||||
<ToneBadge tone={tone}>{badge}</ToneBadge>
|
|
||||||
</div>
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
// ── 计划预览 ──────────────────────────────────────────────────────────────────
|
|
||||||
|
|
||||||
export function PlanPreview({
|
|
||||||
view,
|
|
||||||
disabled,
|
|
||||||
onToggleSkip,
|
|
||||||
onBypass,
|
|
||||||
}: {
|
|
||||||
view: PlanView;
|
|
||||||
disabled: boolean;
|
|
||||||
onToggleSkip: (item: OnboardBlockedItem) => void;
|
|
||||||
onBypass: (on: boolean) => void;
|
|
||||||
}) {
|
|
||||||
const { fileCounts } = view;
|
|
||||||
return (
|
|
||||||
<>
|
|
||||||
<p className="text-xs text-gray-500">
|
|
||||||
将写入 <span className="font-mono text-gray-700">{view.root}</span>
|
|
||||||
<span className="ml-2 text-gray-300 font-mono" title={view.digest}>digest {view.digest.slice(0, 8)}</span>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
{view.blocked.length > 0 && (
|
|
||||||
<Section title="阻断项" extra={view.blockingCount > 0 && <ToneBadge tone="danger">{view.blockingCount} 项阻断确认</ToneBadge>}>
|
|
||||||
{view.blocked.map((row) => (
|
|
||||||
<div key={`${row.target}:${row.item.reason}`} className={`rounded-lg border p-2 space-y-1 ${TONE_CLS[row.tone]}`}>
|
|
||||||
<div className="flex items-center gap-2 text-xs">
|
|
||||||
<span className="font-mono flex-1 min-w-0 truncate">{row.target}</span>
|
|
||||||
<span>{row.reasonLabel}</span>
|
|
||||||
<ToneBadge tone={row.tone}>{row.stateLabel}</ToneBadge>
|
|
||||||
{row.toggleLabel && (
|
|
||||||
<button
|
|
||||||
onClick={() => onToggleSkip(row.item)}
|
|
||||||
disabled={disabled}
|
|
||||||
className="px-2 py-0.5 rounded border border-current text-[11px] hover:bg-white/60 disabled:opacity-50"
|
|
||||||
>
|
|
||||||
{row.toggleLabel}
|
|
||||||
</button>
|
|
||||||
)}
|
|
||||||
</div>
|
|
||||||
<p className="text-[11px] opacity-80 break-all">{row.detail}</p>
|
|
||||||
<p className="text-[11px] opacity-70">{row.hint}</p>
|
|
||||||
</div>
|
|
||||||
))}
|
|
||||||
</Section>
|
|
||||||
)}
|
|
||||||
|
|
||||||
<Section title="需要你留意">
|
|
||||||
<div className={`rounded-lg border p-2 space-y-1 ${TONE_CLS[view.bypass.tone]}`}>
|
|
||||||
<label className="flex items-center gap-2 text-xs">
|
|
||||||
{view.bypass.toggleable && (
|
|
||||||
<input
|
|
||||||
type="checkbox"
|
|
||||||
checked={view.bypass.selected}
|
|
||||||
disabled={disabled}
|
|
||||||
onChange={(e) => onBypass(e.target.checked)}
|
|
||||||
/>
|
|
||||||
)}
|
|
||||||
<span className="font-medium">{view.bypass.label}</span>
|
|
||||||
</label>
|
|
||||||
<p className="text-[11px] opacity-80">{view.bypass.detail}</p>
|
|
||||||
</div>
|
|
||||||
<div className={`rounded-lg border p-2 space-y-1 ${TONE_CLS[view.codexTrust.tone]}`}>
|
|
||||||
<p className="text-xs font-medium">{view.codexTrust.label}</p>
|
|
||||||
{view.codexTrust.detail && <p className="text-[11px] opacity-80 break-all">{view.codexTrust.detail}</p>}
|
|
||||||
</div>
|
|
||||||
</Section>
|
|
||||||
|
|
||||||
<Section
|
|
||||||
title={`项目文件(${view.files.length})`}
|
|
||||||
extra={<span className="text-[11px] text-gray-400">新建 {fileCounts.create} · 更新 {fileCounts.update} · 不变 {fileCounts.noop}</span>}
|
|
||||||
>
|
|
||||||
{view.files.map((file) => (
|
|
||||||
<div key={file.path} className="space-y-0.5">
|
|
||||||
<Row label={file.path} mono tone={file.tone} badge={file.actionLabel} />
|
|
||||||
{file.warning && <p className="text-[11px] text-amber-700 pl-2">⚠ {file.warning}</p>}
|
|
||||||
{file.diff && file.action !== "noop" && (
|
|
||||||
<details className="pl-2">
|
|
||||||
<summary className="text-[11px] text-gray-400 cursor-pointer">查看差异</summary>
|
|
||||||
<pre className="text-[10px] bg-gray-50 border border-gray-100 rounded p-2 overflow-x-auto max-h-48">{file.diff}</pre>
|
|
||||||
</details>
|
|
||||||
)}
|
|
||||||
</div>
|
|
||||||
))}
|
|
||||||
</Section>
|
|
||||||
|
|
||||||
<Section title="本机配置(不进仓库)">
|
|
||||||
{view.machineSteps.map((step) => (
|
|
||||||
<Row key={step.step} label={step.label} tone={step.tone} badge={step.statusLabel} detail={step.detail} />
|
|
||||||
))}
|
|
||||||
</Section>
|
|
||||||
|
|
||||||
{view.nextActions.length > 0 && (
|
|
||||||
<Section title="接入后由你完成(不阻断)">
|
|
||||||
{view.nextActions.map((action) => (
|
|
||||||
<Row key={action.action} label={action.label} tone={action.tone} badge="待办" detail={action.detail} />
|
|
||||||
))}
|
|
||||||
</Section>
|
|
||||||
)}
|
|
||||||
</>
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
// ── 接入结果 ──────────────────────────────────────────────────────────────────
|
|
||||||
|
|
||||||
function L1Matrix({ l1 }: { l1: NonNullable<ReportView["l1"]> }) {
|
|
||||||
return (
|
|
||||||
<div className="overflow-x-auto">
|
|
||||||
<table className="w-full text-[11px] border-collapse">
|
|
||||||
<thead>
|
|
||||||
<tr className="text-gray-400">
|
|
||||||
<th className="text-left font-normal py-1 pr-2">检查项</th>
|
|
||||||
{l1.columns.map((column) => (
|
|
||||||
<th key={column.client} className="text-left font-normal py-1 px-1">
|
|
||||||
{column.label}
|
|
||||||
{column.version && <span className="ml-1 text-gray-300 font-mono">{column.version}</span>}
|
|
||||||
</th>
|
|
||||||
))}
|
|
||||||
</tr>
|
|
||||||
</thead>
|
|
||||||
<tbody>
|
|
||||||
{PARITY_CHECKS.map((check) => (
|
|
||||||
<tr key={check} className="border-t border-gray-50">
|
|
||||||
<td className="py-1 pr-2 text-gray-600">
|
|
||||||
{check} {CHECK_LABEL[check]}
|
|
||||||
</td>
|
|
||||||
{l1.columns.map((column) => {
|
|
||||||
const cell = column.cells[check];
|
|
||||||
return (
|
|
||||||
<td key={column.client} className="py-1 px-1" title={`${cell.evidenceLabel}:${cell.detail}`}>
|
|
||||||
<ToneBadge tone={cell.tone}>{cell.label}</ToneBadge>
|
|
||||||
</td>
|
|
||||||
);
|
|
||||||
})}
|
|
||||||
</tr>
|
|
||||||
))}
|
|
||||||
</tbody>
|
|
||||||
</table>
|
|
||||||
{l1.note && <p className="text-[10px] text-gray-400 mt-1">{l1.note}</p>}
|
|
||||||
</div>
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
export function ReportResult({
|
|
||||||
view,
|
|
||||||
onReviewReplan,
|
|
||||||
}: {
|
|
||||||
view: ReportView;
|
|
||||||
onReviewReplan: (plan: OnboardingPlan) => void;
|
|
||||||
}) {
|
|
||||||
const { commit } = view;
|
|
||||||
return (
|
|
||||||
<>
|
|
||||||
<div className={`rounded-lg border p-3 space-y-1 ${TONE_CLS[view.tone]}`}>
|
|
||||||
<div className="flex items-center gap-2">
|
|
||||||
<span className="text-sm font-semibold">{view.statusLabel}</span>
|
|
||||||
<span className="text-[11px] opacity-70">用时 {view.durationLabel}</span>
|
|
||||||
</div>
|
|
||||||
<p className="text-xs">{view.summary}</p>
|
|
||||||
{view.reason && <p className="text-xs break-all">原因:{view.reason}</p>}
|
|
||||||
{view.replan && (
|
|
||||||
<button
|
|
||||||
onClick={() => onReviewReplan(view.replan!)}
|
|
||||||
className="mt-1 px-3 py-1 rounded border border-current text-xs hover:bg-white/60"
|
|
||||||
>
|
|
||||||
查看当前计划并重新确认
|
|
||||||
</button>
|
|
||||||
)}
|
|
||||||
</div>
|
|
||||||
|
|
||||||
{view.steps.length > 0 && (
|
|
||||||
<Section title="分步结果">
|
|
||||||
{view.steps.map((step) => (
|
|
||||||
<Row
|
|
||||||
key={step.step}
|
|
||||||
label={step.note ? `${step.label}(${step.note})` : step.label}
|
|
||||||
tone={step.tone}
|
|
||||||
badge={step.statusLabel}
|
|
||||||
detail={step.detail}
|
|
||||||
/>
|
|
||||||
))}
|
|
||||||
</Section>
|
|
||||||
)}
|
|
||||||
|
|
||||||
{view.l1 && (
|
|
||||||
<Section title="三端检查(L1 零模型)" extra={view.l1.allApplicableReady && <ToneBadge tone="ok">适用格全部就绪</ToneBadge>}>
|
|
||||||
<L1Matrix l1={view.l1} />
|
|
||||||
</Section>
|
|
||||||
)}
|
|
||||||
|
|
||||||
{commit.state === "available" && (
|
|
||||||
<Section title={commit.title}>
|
|
||||||
{commit.files.map((file) => (
|
|
||||||
<p key={file.path} className="text-xs font-mono text-gray-700">
|
|
||||||
<span className="text-gray-400 mr-2 whitespace-pre">{file.code}</span>
|
|
||||||
{file.path}
|
|
||||||
</p>
|
|
||||||
))}
|
|
||||||
{commit.otherWarning && <p className="text-[11px] text-amber-700">⚠ {commit.otherWarning}</p>}
|
|
||||||
{commit.suggestedMessage && (
|
|
||||||
<p className="text-[11px] text-gray-500">
|
|
||||||
建议提交信息:<span className="font-mono text-gray-700">{commit.suggestedMessage}</span>
|
|
||||||
</p>
|
|
||||||
)}
|
|
||||||
</Section>
|
|
||||||
)}
|
|
||||||
{commit.state === "unavailable" && <p className="text-[11px] text-gray-400">无法列出改动:{commit.reason}</p>}
|
|
||||||
{view.head && <p className={`text-[11px] ${view.head.unchanged ? "text-gray-400" : "text-amber-700"}`}>{view.head.label}</p>}
|
|
||||||
|
|
||||||
{(view.pendingUser.length > 0 || view.nextActions.length > 0) && (
|
|
||||||
<Section title="待你操作">
|
|
||||||
{view.pendingUser.map((row) => (
|
|
||||||
<Row key={row.item} label={row.item} tone={row.tone} badge={row.label} detail={row.detail} />
|
|
||||||
))}
|
|
||||||
{view.nextActions.map((action) => (
|
|
||||||
<Row key={action.action} label={action.label} tone={action.tone} badge="待办" detail={action.detail} />
|
|
||||||
))}
|
|
||||||
</Section>
|
|
||||||
)}
|
|
||||||
|
|
||||||
{view.completion.length > 0 && (
|
|
||||||
<details>
|
|
||||||
<summary className="text-xs text-gray-500 cursor-pointer">
|
|
||||||
完成判定明细({view.completion.filter((row) => row.ready).length}/{view.completion.length} 就绪)
|
|
||||||
</summary>
|
|
||||||
<div className="mt-1.5 space-y-1">
|
|
||||||
{view.completion.map((row) => (
|
|
||||||
<Row key={`${row.source}:${row.item}`} label={row.item} tone={row.tone} badge={row.label} detail={row.detail} />
|
|
||||||
))}
|
|
||||||
</div>
|
|
||||||
</details>
|
|
||||||
)}
|
|
||||||
<p className="text-[10px] text-gray-400">{view.l3}</p>
|
|
||||||
</>
|
|
||||||
);
|
|
||||||
}
|
|
||||||
@ -19,7 +19,6 @@ export function ProjectModal() {
|
|||||||
const editTarget = useUIStore((s) => s.editTarget);
|
const editTarget = useUIStore((s) => s.editTarget);
|
||||||
const closeEdit = useUIStore((s) => s.closeEdit);
|
const closeEdit = useUIStore((s) => s.closeEdit);
|
||||||
const showToast = useUIStore((s) => s.showToast);
|
const showToast = useUIStore((s) => s.showToast);
|
||||||
const openOnboard = useUIStore((s) => s.openOnboard);
|
|
||||||
const qc = useQueryClient();
|
const qc = useQueryClient();
|
||||||
|
|
||||||
const { data: spaces = [] } = useQuery({ queryKey: ["spaces"], queryFn: getSpaces });
|
const { data: spaces = [] } = useQuery({ queryKey: ["spaces"], queryFn: getSpaces });
|
||||||
@ -94,12 +93,6 @@ const pickFolder = async (field: "wsl_path" | "win_path") => {
|
|||||||
qc.invalidateQueries({ queryKey: ["projects"] });
|
qc.invalidateQueries({ queryKey: ["projects"] });
|
||||||
qc.invalidateQueries({ queryKey: ["tagMaps"] });
|
qc.invalidateQueries({ queryKey: ["tagMaps"] });
|
||||||
closeEdit();
|
closeEdit();
|
||||||
// create_project 本身无副作用;选了目录的新项目弹出接入预览(P8g),由人确认后才写入。不选目录的概念占位不接入
|
|
||||||
// 与后端登记同口径:按 platform 只看有效根目录那一列(另一列残留不算)
|
|
||||||
const effectiveRoot = form.platform === "wsl" ? form.wsl_path : form.win_path;
|
|
||||||
if (isNew && effectiveRoot?.trim()) {
|
|
||||||
openOnboard({ projectId: form.id!, projectName: form.name?.trim() });
|
|
||||||
}
|
|
||||||
} catch (e) {
|
} catch (e) {
|
||||||
showToast(`❌ ${e}`);
|
showToast(`❌ ${e}`);
|
||||||
} finally {
|
} finally {
|
||||||
|
|||||||
@ -1,290 +0,0 @@
|
|||||||
import { describe, expect, it } from "vitest";
|
|
||||||
import type {
|
|
||||||
ClientParityL1Report,
|
|
||||||
OnboardBlockedItem,
|
|
||||||
OnboardReport,
|
|
||||||
OnboardingPlan,
|
|
||||||
ParityCell,
|
|
||||||
ParityCheck,
|
|
||||||
} from "../../lib/commands";
|
|
||||||
import {
|
|
||||||
DEFAULT_SELECTION,
|
|
||||||
buildPlanView,
|
|
||||||
buildReportView,
|
|
||||||
confirmRequest,
|
|
||||||
l1MatrixView,
|
|
||||||
selectionOptions,
|
|
||||||
setBypass,
|
|
||||||
toggleSkip,
|
|
||||||
type OnboardSelection,
|
|
||||||
} from "./onboardView";
|
|
||||||
|
|
||||||
const manualCodex: OnboardBlockedItem = {
|
|
||||||
target: ".codex/config.toml",
|
|
||||||
reason: "manual_entry",
|
|
||||||
detail: "已有手写的 lian-jing 条目",
|
|
||||||
skippable: true,
|
|
||||||
};
|
|
||||||
|
|
||||||
const mixedAgents: OnboardBlockedItem = {
|
|
||||||
target: "AGENTS.md",
|
|
||||||
reason: "mixed_file",
|
|
||||||
detail: "托管块外有未提交改动",
|
|
||||||
skippable: false,
|
|
||||||
};
|
|
||||||
|
|
||||||
function plan(overrides: Partial<OnboardingPlan> = {}): OnboardingPlan {
|
|
||||||
return {
|
|
||||||
project_id: "p1",
|
|
||||||
root: "E:\\code-project\\demo",
|
|
||||||
files: [
|
|
||||||
{ path: "AGENTS.md", action: "create", content_sha256: "a" },
|
|
||||||
{ path: ".claude/settings.json", action: "update", content_sha256: "b", before_sha256: "c" },
|
|
||||||
{ path: ".lian-jing/context.json", action: "noop", content_sha256: "d" },
|
|
||||||
],
|
|
||||||
machine_changes: [
|
|
||||||
{ step: "token", status: "apply", detail: "将生成项目 token" },
|
|
||||||
{ step: "claude", status: "noop", detail: "已配置" },
|
|
||||||
{ step: "codex", status: "not_installed", detail: "未找到 codex" },
|
|
||||||
{ step: "dsh", status: "not_applicable", detail: "控制面项目" },
|
|
||||||
],
|
|
||||||
blocked: [],
|
|
||||||
skipped: [],
|
|
||||||
bypass_permissions: true,
|
|
||||||
codex_trust: "untrusted",
|
|
||||||
next_actions: [{ action: "codex_trust", detail: "在 Codex 里信任 E:\\code-project\\demo" }],
|
|
||||||
digest: "digest-1",
|
|
||||||
...overrides,
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
const sel = (overrides: Partial<OnboardSelection> = {}): OnboardSelection => ({ ...DEFAULT_SELECTION, ...overrides });
|
|
||||||
|
|
||||||
describe("buildPlanView 阻断与确认", () => {
|
|
||||||
it("blocked 非空时确认禁用,并逐项列出文件与原因", () => {
|
|
||||||
const view = buildPlanView(plan({ blocked: [mixedAgents, manualCodex] }), sel(), sel());
|
|
||||||
expect(view.confirm.enabled).toBe(false);
|
|
||||||
expect(view.confirm.reason).toContain("2 项阻断");
|
|
||||||
expect(view.blockingCount).toBe(2);
|
|
||||||
expect(view.blocked.map((row) => [row.target, row.reasonLabel, row.detail, row.state])).toEqual([
|
|
||||||
["AGENTS.md", "混合文件:托管块外有未提交改动", "托管块外有未提交改动", "blocking"],
|
|
||||||
[".codex/config.toml", "手写同名条目", "已有手写的 lian-jing 条目", "blocking"],
|
|
||||||
]);
|
|
||||||
expect(view.blocked.every((row) => row.tone === "danger")).toBe(true);
|
|
||||||
expect(confirmRequest(plan({ blocked: [mixedAgents] }), sel(), sel())).toBeNull();
|
|
||||||
});
|
|
||||||
|
|
||||||
it("只有后端标 skippable 的项给「跳过」,不可跳过的项切换无效", () => {
|
|
||||||
const view = buildPlanView(plan({ blocked: [mixedAgents, manualCodex] }), sel(), sel());
|
|
||||||
expect(view.blocked[0].toggleLabel).toBeUndefined();
|
|
||||||
expect(view.blocked[0].hint).toContain("禁止字符串手术");
|
|
||||||
expect(view.blocked[1].toggleLabel).toBe("跳过");
|
|
||||||
expect(toggleSkip(sel(), mixedAgents)).toEqual(sel());
|
|
||||||
expect(toggleSkip(sel(), manualCodex).skipTargets).toEqual([".codex/config.toml"]);
|
|
||||||
expect(toggleSkip(sel({ skipTargets: [".codex/config.toml"] }), manualCodex).skipTargets).toEqual([]);
|
|
||||||
});
|
|
||||||
|
|
||||||
it("选了跳过但未重新计划时确认禁用;按跳过重新计划后可确认", () => {
|
|
||||||
const chosen = toggleSkip(sel(), manualCodex);
|
|
||||||
const pending = buildPlanView(plan({ blocked: [manualCodex] }), sel(), chosen);
|
|
||||||
expect(pending.needsReplan).toBe(true);
|
|
||||||
expect(pending.blocked[0].state).toBe("skip_pending");
|
|
||||||
expect(pending.confirm).toEqual({ enabled: false, reason: "选项已改:须按当前选择重新计划后才能确认" });
|
|
||||||
|
|
||||||
const replanned = buildPlanView(plan({ blocked: [], skipped: [manualCodex] }), chosen, chosen);
|
|
||||||
expect(replanned.confirm.enabled).toBe(true);
|
|
||||||
expect(replanned.blocked[0]).toMatchObject({ state: "skipped", tone: "muted", toggleLabel: "取消跳过" });
|
|
||||||
expect(replanned.blockingCount).toBe(0);
|
|
||||||
});
|
|
||||||
|
|
||||||
it("确认请求携带计划 digest 与生成计划时的选项", () => {
|
|
||||||
const planned = sel({ skipTargets: [".codex/config.toml", ".codex/config.toml"] });
|
|
||||||
const request = confirmRequest(plan({ skipped: [manualCodex], digest: "digest-xyz" }), planned, planned);
|
|
||||||
expect(request).toEqual({
|
|
||||||
projectId: "p1",
|
|
||||||
expectedDigest: "digest-xyz",
|
|
||||||
confirmed: true,
|
|
||||||
options: { bypass_permissions: true, skip_targets: [".codex/config.toml"] },
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
it("selectionOptions 去重排序,计划与应用两次逐字一致", () => {
|
|
||||||
expect(selectionOptions(sel({ skipTargets: ["b", "a", "b"] }))).toEqual({
|
|
||||||
bypass_permissions: true,
|
|
||||||
skip_targets: ["a", "b"],
|
|
||||||
});
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
describe("buildPlanView 灰色说明与单列项", () => {
|
|
||||||
it("not_installed / not_applicable 显示为灰色说明,不是红色失败", () => {
|
|
||||||
const view = buildPlanView(plan(), sel(), sel());
|
|
||||||
const byStep = Object.fromEntries(view.machineSteps.map((row) => [row.step, row]));
|
|
||||||
expect(byStep.codex).toMatchObject({ statusLabel: "未安装", tone: "muted" });
|
|
||||||
expect(byStep.dsh).toMatchObject({ statusLabel: "不适用", tone: "muted" });
|
|
||||||
expect(byStep.token).toMatchObject({ label: "项目 MCP token", statusLabel: "将写入", tone: "info" });
|
|
||||||
expect(view.machineSteps.some((row) => row.tone === "danger")).toBe(false);
|
|
||||||
expect(view.fileCounts).toEqual({ create: 1, update: 1, noop: 1 });
|
|
||||||
});
|
|
||||||
|
|
||||||
it("bypassPermissions 单独列出:将写入可取消,取消后须重新计划", () => {
|
|
||||||
const view = buildPlanView(plan(), sel(), sel());
|
|
||||||
expect(view.bypass).toMatchObject({ willWrite: true, toggleable: true, tone: "warn" });
|
|
||||||
expect(view.bypass.label).toContain("bypassPermissions");
|
|
||||||
|
|
||||||
const off = setBypass(sel(), false);
|
|
||||||
expect(buildPlanView(plan(), sel(), off).confirm.enabled).toBe(false);
|
|
||||||
const cancelled = buildPlanView(plan({ bypass_permissions: false }), off, off);
|
|
||||||
expect(cancelled.bypass).toMatchObject({ willWrite: false, selected: false, toggleable: true });
|
|
||||||
expect(cancelled.bypass.label).toBe("已按项目取消 bypassPermissions");
|
|
||||||
expect(confirmRequest(plan({ bypass_permissions: false }), off, off)?.options.bypass_permissions).toBe(false);
|
|
||||||
|
|
||||||
const existing = buildPlanView(plan({ bypass_permissions: false }), sel(), sel());
|
|
||||||
expect(existing.bypass).toMatchObject({ toggleable: false, tone: "muted" });
|
|
||||||
});
|
|
||||||
|
|
||||||
it("Codex 信任单独列出:未信任为「待你操作」而非阻断", () => {
|
|
||||||
const view = buildPlanView(plan(), sel(), sel());
|
|
||||||
expect(view.codexTrust).toMatchObject({ state: "untrusted", tone: "pending" });
|
|
||||||
expect(view.codexTrust.detail).toContain("信任");
|
|
||||||
expect(view.confirm.enabled).toBe(true);
|
|
||||||
expect(buildPlanView(plan({ codex_trust: "not_installed", next_actions: [] }), sel(), sel()).codexTrust.tone).toBe("muted");
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
function cell(state: ParityCell["state"], extra: Partial<ParityCell> = {}): ParityCell {
|
|
||||||
return { state, evidence: "protocol", detail: `${state} detail`, ...extra };
|
|
||||||
}
|
|
||||||
|
|
||||||
function cells(fill: (check: ParityCheck) => ParityCell): Record<ParityCheck, ParityCell> {
|
|
||||||
return Object.fromEntries((["A", "B", "C", "D", "E", "F"] as ParityCheck[]).map((c) => [c, fill(c)])) as Record<
|
|
||||||
ParityCheck,
|
|
||||||
ParityCell
|
|
||||||
>;
|
|
||||||
}
|
|
||||||
|
|
||||||
const l1: ClientParityL1Report = {
|
|
||||||
project_id: "p1",
|
|
||||||
tier: "l1",
|
|
||||||
probe_spec_version: 1,
|
|
||||||
profile: "project",
|
|
||||||
expected_route: "http://127.0.0.1:27190/mcp/projects/p1",
|
|
||||||
expected_tools: 12,
|
|
||||||
nonce: "n",
|
|
||||||
clients: [
|
|
||||||
{ client: "claude", version: "2.1.90", route: null, cells: cells(() => cell("ready")), duration_ms: 1 },
|
|
||||||
{
|
|
||||||
client: "codex",
|
|
||||||
version: "0.50",
|
|
||||||
route: null,
|
|
||||||
cells: cells((c) => (c < "C" ? cell("ready") : cell("fail", { cause: "codex_project_untrusted" }))),
|
|
||||||
duration_ms: 1,
|
|
||||||
},
|
|
||||||
{ client: "dsh", version: null, route: null, cells: cells(() => cell("not_installed")), duration_ms: 1 },
|
|
||||||
],
|
|
||||||
all_applicable_ready: false,
|
|
||||||
duration_ms: 3,
|
|
||||||
note: "",
|
|
||||||
};
|
|
||||||
|
|
||||||
function report(overrides: Partial<OnboardReport> = {}): OnboardReport {
|
|
||||||
return {
|
|
||||||
project_id: "p1",
|
|
||||||
status: "done",
|
|
||||||
summary: "9 步完成",
|
|
||||||
bypass_permissions: true,
|
|
||||||
steps: [
|
|
||||||
{ step: "project_files", status: "applied", detail: "写入 14 个文件" },
|
|
||||||
{ step: "dsh", status: "not_applicable", reason: "not_installed", detail: "未安装 DSH" },
|
|
||||||
{ step: "codex", status: "blocked", dep: "token", detail: "token 未就绪" },
|
|
||||||
],
|
|
||||||
completion: [
|
|
||||||
{ item: "Claude MCP 已配置", source: "clients", ready: true, detail: "", pending_user: false },
|
|
||||||
{ item: "Codex 信任", source: "l1", ready: false, detail: "待信任", pending_user: true },
|
|
||||||
],
|
|
||||||
l1,
|
|
||||||
l3: "L3 尚未提供",
|
|
||||||
written_files: ["AGENTS.md"],
|
|
||||||
repo_changes: {
|
|
||||||
state: "available",
|
|
||||||
status_porcelain: [],
|
|
||||||
diff_stat: "2 files changed",
|
|
||||||
onboard_files: [
|
|
||||||
{ path: "AGENTS.md", code: "??" },
|
|
||||||
{ path: ".claude/settings.json", code: " M" },
|
|
||||||
],
|
|
||||||
other_changes: 1,
|
|
||||||
},
|
|
||||||
head: { before: "abc", after: "abc", unchanged: true },
|
|
||||||
suggested_commit_message: "chore(lian-jing): 一键接入",
|
|
||||||
next_actions: [{ action: "commit", detail: "git add -- AGENTS.md" }],
|
|
||||||
duration_ms: 7900,
|
|
||||||
...overrides,
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
describe("buildReportView", () => {
|
|
||||||
it("分步结果:not_applicable 灰色、blocked 注明依赖", () => {
|
|
||||||
const view = buildReportView(report());
|
|
||||||
expect(view.steps.map((row) => [row.step, row.statusLabel, row.tone, row.note])).toEqual([
|
|
||||||
["project_files", "已写入", "ok", undefined],
|
|
||||||
["dsh", "不适用", "muted", "未安装"],
|
|
||||||
["codex", "未执行", "warn", "依赖「项目 MCP token」未完成"],
|
|
||||||
]);
|
|
||||||
expect(view.toast).toBe("一键接入接入完成 ✓");
|
|
||||||
expect(view.durationLabel).toBe("7.9 秒");
|
|
||||||
});
|
|
||||||
|
|
||||||
it("待你提交的 N 个文件与 Codex 信任单列,不计入完成", () => {
|
|
||||||
const view = buildReportView(report());
|
|
||||||
expect(view.commit).toMatchObject({ state: "available", title: "待你提交的 2 个文件", otherChanges: 1 });
|
|
||||||
expect(view.commit.state === "available" && view.commit.otherWarning).toContain("不要 git add -A");
|
|
||||||
expect(view.completion.map((row) => row.item)).toEqual(["Claude MCP 已配置"]);
|
|
||||||
expect(view.pendingUser).toEqual([
|
|
||||||
{ item: "Codex 信任", source: "l1", ready: false, label: "待你操作", tone: "pending", detail: "待信任" },
|
|
||||||
]);
|
|
||||||
expect(view.head).toMatchObject({ unchanged: true, tone: "ok" });
|
|
||||||
});
|
|
||||||
|
|
||||||
it("refused 附当前计划供重新确认,提示以 ❌ 开头且不报告改动", () => {
|
|
||||||
const replan = plan({ digest: "digest-2" });
|
|
||||||
const view = buildReportView(
|
|
||||||
report({ status: "refused", reason: "digest 不符", plan: replan, repo_changes: undefined, l1: undefined }),
|
|
||||||
);
|
|
||||||
expect(view.replan).toBe(replan);
|
|
||||||
expect(view.tone).toBe("warn");
|
|
||||||
expect(view.toast).toBe("❌ 一键接入已拒绝(零写入):digest 不符");
|
|
||||||
expect(view.commit).toEqual({ state: "none" });
|
|
||||||
expect(view.l1).toBeUndefined();
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
describe("l1MatrixView", () => {
|
|
||||||
it("未安装为灰色,Codex 未信任为「待你信任」而非红色失败", () => {
|
|
||||||
const view = l1MatrixView(l1);
|
|
||||||
const [claude, codex, dsh] = view.columns;
|
|
||||||
expect(claude.cells.F).toMatchObject({ label: "就绪", tone: "ok" });
|
|
||||||
expect(codex.cells.A.tone).toBe("ok");
|
|
||||||
expect(codex.cells.C).toMatchObject({ label: "待你信任", tone: "pending", cause: "codex_project_untrusted" });
|
|
||||||
expect(dsh.cells.A).toMatchObject({ label: "未安装", tone: "muted" });
|
|
||||||
expect(Object.values(dsh.cells).every((c) => c.tone === "muted")).toBe(true);
|
|
||||||
expect(dsh.label).toBe("DSH");
|
|
||||||
});
|
|
||||||
|
|
||||||
it("依赖步骤未完成的格注明步骤;真实失败为红色", () => {
|
|
||||||
const report = {
|
|
||||||
...l1,
|
|
||||||
clients: [
|
|
||||||
{
|
|
||||||
...l1.clients[0],
|
|
||||||
cells: cells((c) =>
|
|
||||||
c === "A" ? cell("blocked", { cause: "dependency", dep: "claude" }) : cell("fail", { cause: "auth_failed" }),
|
|
||||||
),
|
|
||||||
},
|
|
||||||
],
|
|
||||||
};
|
|
||||||
const [claude] = l1MatrixView(report).columns;
|
|
||||||
expect(claude.cells.A).toMatchObject({ label: "未检查:Claude Code 步骤未完成", tone: "warn" });
|
|
||||||
expect(claude.cells.F).toMatchObject({ label: "失败", tone: "danger" });
|
|
||||||
});
|
|
||||||
});
|
|
||||||
@ -1,672 +0,0 @@
|
|||||||
// 一键接入(agent-client-parity P8g)视图模型:把 OnboardingPlan / OnboardReport 转成界面要展示的结构。
|
|
||||||
// 只做呈现映射,不复制本体判定(AGENTS.md「边界单点实现」):阻断与否看 plan.blocked、能否跳过看
|
|
||||||
// blocked[].skippable、完成与否看 report.status 与 completion[].pending_user,全部由后端给出。
|
|
||||||
// 界面自己只管一件事:当前选择(bypass / 跳过项)与生成计划时所用的选择是否一致——不一致必须重新计划,
|
|
||||||
// 因为 onboardProject 须带同一组选项与 digest(否则后端 refused)。
|
|
||||||
|
|
||||||
import type {
|
|
||||||
ClientParityL1Report,
|
|
||||||
CodexTrust,
|
|
||||||
OnboardBlockReason,
|
|
||||||
OnboardBlockedItem,
|
|
||||||
OnboardCompletionItem,
|
|
||||||
OnboardFileAction,
|
|
||||||
OnboardNextAction,
|
|
||||||
OnboardOptions,
|
|
||||||
OnboardPendingFile,
|
|
||||||
OnboardReport,
|
|
||||||
OnboardStatus,
|
|
||||||
OnboardStepReport,
|
|
||||||
OnboardingPlan,
|
|
||||||
ParityCause,
|
|
||||||
ParityCell,
|
|
||||||
ParityCellState,
|
|
||||||
ParityCheck,
|
|
||||||
ParityEvidence,
|
|
||||||
} from "../../lib/commands";
|
|
||||||
|
|
||||||
/** 呈现色调。muted 是灰色说明(未安装 / 不适用 / 已跳过 / 不变),不是失败;pending 是「待你操作」 */
|
|
||||||
export type OnboardTone = "ok" | "info" | "muted" | "pending" | "warn" | "danger";
|
|
||||||
|
|
||||||
// ── 选项:计划与应用必须一致 ──────────────────────────────────────────────────
|
|
||||||
|
|
||||||
export interface OnboardSelection {
|
|
||||||
/** 勾选 = 保持默认:项目 .claude/settings.json 还没有 permissions 时写入 bypassPermissions */
|
|
||||||
bypassPermissions: boolean;
|
|
||||||
/** 人逐项选「跳过」的阻断项 target(只对 skippable 的项生效) */
|
|
||||||
skipTargets: string[];
|
|
||||||
}
|
|
||||||
|
|
||||||
export const DEFAULT_SELECTION: OnboardSelection = { bypassPermissions: true, skipTargets: [] };
|
|
||||||
|
|
||||||
function normalizeTargets(targets: readonly string[]): string[] {
|
|
||||||
return [...new Set(targets)].sort();
|
|
||||||
}
|
|
||||||
|
|
||||||
/** 选择 → 传给 planOnboarding / onboardProject 的选项(跳过项去重排序,两次调用逐字一致) */
|
|
||||||
export function selectionOptions(selection: OnboardSelection): OnboardOptions {
|
|
||||||
return {
|
|
||||||
bypass_permissions: selection.bypassPermissions,
|
|
||||||
skip_targets: normalizeTargets(selection.skipTargets),
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
export function sameSelection(a: OnboardSelection, b: OnboardSelection): boolean {
|
|
||||||
if (a.bypassPermissions !== b.bypassPermissions) return false;
|
|
||||||
const x = normalizeTargets(a.skipTargets);
|
|
||||||
const y = normalizeTargets(b.skipTargets);
|
|
||||||
return x.length === y.length && x.every((target, i) => target === y[i]);
|
|
||||||
}
|
|
||||||
|
|
||||||
/** 切换某阻断项的「跳过」。后端没标 skippable 的项不响应(只能中止或处理后重新计划) */
|
|
||||||
export function toggleSkip(selection: OnboardSelection, item: OnboardBlockedItem): OnboardSelection {
|
|
||||||
if (!item.skippable) return selection;
|
|
||||||
const has = selection.skipTargets.includes(item.target);
|
|
||||||
return {
|
|
||||||
...selection,
|
|
||||||
skipTargets: has
|
|
||||||
? selection.skipTargets.filter((target) => target !== item.target)
|
|
||||||
: [...selection.skipTargets, item.target],
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
export function setBypass(selection: OnboardSelection, bypassPermissions: boolean): OnboardSelection {
|
|
||||||
return { ...selection, bypassPermissions };
|
|
||||||
}
|
|
||||||
|
|
||||||
// ── 文案映射(只翻译后端给的枚举,不推断) ─────────────────────────────────────
|
|
||||||
|
|
||||||
interface Badge {
|
|
||||||
label: string;
|
|
||||||
tone: OnboardTone;
|
|
||||||
}
|
|
||||||
|
|
||||||
const FILE_ACTION: Record<OnboardFileAction, Badge> = {
|
|
||||||
create: { label: "新建", tone: "info" },
|
|
||||||
update: { label: "更新", tone: "info" },
|
|
||||||
noop: { label: "不变", tone: "muted" },
|
|
||||||
};
|
|
||||||
|
|
||||||
const BLOCK_REASON_LABEL: Record<OnboardBlockReason, string> = {
|
|
||||||
mixed_file: "混合文件:托管块外有未提交改动",
|
|
||||||
identity_conflict: "身份冲突:目录已属于别的项目",
|
|
||||||
manual_entry: "手写同名条目",
|
|
||||||
shared_key: "共享项目键:生效条目属于别的项目",
|
|
||||||
needs_human: "需人工处理",
|
|
||||||
};
|
|
||||||
|
|
||||||
/** 不可跳过的项怎么办(可跳过的项统一给「跳过 / 中止」) */
|
|
||||||
const BLOCK_REASON_HINT: Record<OnboardBlockReason, string> = {
|
|
||||||
mixed_file: "先在子项目提交或丢弃块外改动,再重新计划(禁止字符串手术);或中止",
|
|
||||||
identity_conflict: "核对 .lian-jing/context.json 的归属后重新计划;或中止",
|
|
||||||
manual_entry: "处理后重新计划;或中止",
|
|
||||||
shared_key: "处理后重新计划;或中止",
|
|
||||||
needs_human: "按说明处理后重新计划;或中止",
|
|
||||||
};
|
|
||||||
|
|
||||||
export const STEP_LABEL: Record<string, string> = {
|
|
||||||
identity: "项目身份",
|
|
||||||
project_files: "项目文件",
|
|
||||||
git_hooks: "Git hooks(lefthook install)",
|
|
||||||
product_group_buff: "产品组与 buff",
|
|
||||||
token: "项目 MCP token",
|
|
||||||
shim: "稳定 helper 入口",
|
|
||||||
claude: "Claude Code",
|
|
||||||
codex: "Codex",
|
|
||||||
dsh: "DSH",
|
|
||||||
};
|
|
||||||
|
|
||||||
/** 计划里本机七步的预计动作 */
|
|
||||||
const MACHINE_STATUS: Record<string, Badge> = {
|
|
||||||
noop: { label: "已就绪", tone: "ok" },
|
|
||||||
apply: { label: "将写入", tone: "info" },
|
|
||||||
not_installed: { label: "未安装", tone: "muted" },
|
|
||||||
not_applicable: { label: "不适用", tone: "muted" },
|
|
||||||
unavailable: { label: "无法判定", tone: "warn" },
|
|
||||||
manual_kept: { label: "手写同名条目", tone: "warn" },
|
|
||||||
other_project: { label: "属于别的项目", tone: "warn" },
|
|
||||||
needs_human: { label: "需人工处理", tone: "danger" },
|
|
||||||
};
|
|
||||||
|
|
||||||
const CODEX_TRUST: Record<CodexTrust, Badge> = {
|
|
||||||
trusted: { label: "Codex 已信任该目录", tone: "ok" },
|
|
||||||
untrusted: { label: "待你操作:在 Codex 里信任该目录", tone: "pending" },
|
|
||||||
not_installed: { label: "未安装 Codex", tone: "muted" },
|
|
||||||
unknown: { label: "待你确认:无法判断 Codex 是否信任该目录", tone: "pending" },
|
|
||||||
};
|
|
||||||
|
|
||||||
export const NEXT_ACTION_LABEL: Record<string, string> = {
|
|
||||||
codex_trust: "在 Codex 里信任该目录",
|
|
||||||
commit: "提交接入文件",
|
|
||||||
gitea_repo: "建 Gitea 仓库",
|
|
||||||
ci: "配置 CI",
|
|
||||||
flywheel: "飞轮数据",
|
|
||||||
toolchain: "准备工具链",
|
|
||||||
delivery_profile: "交付配置",
|
|
||||||
lefthook: "安装 lefthook",
|
|
||||||
restart_dsh_gui: "重启 DSH 桌面 GUI",
|
|
||||||
claude_trust: "Claude 首次打开目录时确认信任",
|
|
||||||
reopen_sessions: "重开已打开的会话",
|
|
||||||
repo_layout: "仓库布局说明",
|
|
||||||
};
|
|
||||||
|
|
||||||
// ── 计划预览 ──────────────────────────────────────────────────────────────────
|
|
||||||
|
|
||||||
export interface FileRow {
|
|
||||||
path: string;
|
|
||||||
action: OnboardFileAction;
|
|
||||||
actionLabel: string;
|
|
||||||
tone: OnboardTone;
|
|
||||||
diff?: string;
|
|
||||||
warning?: string;
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface MachineStepRow {
|
|
||||||
step: string;
|
|
||||||
label: string;
|
|
||||||
status: string;
|
|
||||||
statusLabel: string;
|
|
||||||
tone: OnboardTone;
|
|
||||||
detail: string;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** blocking 阻断中;skip_pending 已选跳过、待重新计划;skipped 计划已按跳过生成;unskip_pending 已取消跳过、待重新计划 */
|
|
||||||
export type BlockedRowState = "blocking" | "skip_pending" | "skipped" | "unskip_pending";
|
|
||||||
|
|
||||||
export interface BlockedRow {
|
|
||||||
item: OnboardBlockedItem;
|
|
||||||
target: string;
|
|
||||||
reasonLabel: string;
|
|
||||||
detail: string;
|
|
||||||
/** 来自后端 skippable:为 true 才给「跳过」按钮 */
|
|
||||||
skippable: boolean;
|
|
||||||
state: BlockedRowState;
|
|
||||||
stateLabel: string;
|
|
||||||
tone: OnboardTone;
|
|
||||||
hint: string;
|
|
||||||
/** 可跳过的项的按钮文案;不可跳过为空(只能中止或处理后重新计划) */
|
|
||||||
toggleLabel?: string;
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface BypassView {
|
|
||||||
/** 本次计划会新写入 permissions.defaultMode=bypassPermissions(后端 plan.bypass_permissions) */
|
|
||||||
willWrite: boolean;
|
|
||||||
/** 当前选择:勾选 = 保持默认写入 */
|
|
||||||
selected: boolean;
|
|
||||||
/** 生成本计划时的选择 */
|
|
||||||
planned: boolean;
|
|
||||||
label: string;
|
|
||||||
detail: string;
|
|
||||||
tone: OnboardTone;
|
|
||||||
/** 会写入或已按项目取消时给开关;项目已有 permissions 时开关无意义,不给 */
|
|
||||||
toggleable: boolean;
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface CodexTrustView {
|
|
||||||
state: CodexTrust;
|
|
||||||
label: string;
|
|
||||||
tone: OnboardTone;
|
|
||||||
detail: string;
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface NextActionRow {
|
|
||||||
action: string;
|
|
||||||
label: string;
|
|
||||||
detail: string;
|
|
||||||
tone: OnboardTone;
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface PlanView {
|
|
||||||
projectId: string;
|
|
||||||
root: string;
|
|
||||||
digest: string;
|
|
||||||
files: FileRow[];
|
|
||||||
fileCounts: Record<OnboardFileAction, number>;
|
|
||||||
machineSteps: MachineStepRow[];
|
|
||||||
/** plan.blocked 与 plan.skipped 合并展示 */
|
|
||||||
blocked: BlockedRow[];
|
|
||||||
/** 仍阻断确认的项数(= plan.blocked.length) */
|
|
||||||
blockingCount: number;
|
|
||||||
bypass: BypassView;
|
|
||||||
codexTrust: CodexTrustView;
|
|
||||||
nextActions: NextActionRow[];
|
|
||||||
/** 当前选择与生成计划时不同:必须重新计划才能确认 */
|
|
||||||
needsReplan: boolean;
|
|
||||||
confirm: { enabled: boolean; reason?: string };
|
|
||||||
}
|
|
||||||
|
|
||||||
const BLOCKED_STATE: Record<BlockedRowState, Badge> = {
|
|
||||||
blocking: { label: "阻断", tone: "danger" },
|
|
||||||
skip_pending: { label: "将跳过(需重新计划)", tone: "warn" },
|
|
||||||
skipped: { label: "已跳过:保留现状,该端不写", tone: "muted" },
|
|
||||||
unskip_pending: { label: "将恢复阻断(需重新计划)", tone: "warn" },
|
|
||||||
};
|
|
||||||
|
|
||||||
function blockedRow(item: OnboardBlockedItem, inPlanSkipped: boolean, selected: boolean): BlockedRow {
|
|
||||||
const skippable = item.skippable === true;
|
|
||||||
const state: BlockedRowState = inPlanSkipped
|
|
||||||
? selected ? "skipped" : "unskip_pending"
|
|
||||||
: skippable && selected ? "skip_pending" : "blocking";
|
|
||||||
const badge = BLOCKED_STATE[state];
|
|
||||||
return {
|
|
||||||
item,
|
|
||||||
target: item.target,
|
|
||||||
reasonLabel: BLOCK_REASON_LABEL[item.reason] ?? item.reason,
|
|
||||||
detail: item.detail,
|
|
||||||
skippable,
|
|
||||||
state,
|
|
||||||
stateLabel: badge.label,
|
|
||||||
tone: badge.tone,
|
|
||||||
hint: skippable
|
|
||||||
? "可逐项「跳过」:保留现状、该端不写(跳过不等于该端可用);或中止"
|
|
||||||
: BLOCK_REASON_HINT[item.reason] ?? "处理后重新计划;或中止",
|
|
||||||
toggleLabel: skippable ? (selected ? "取消跳过" : "跳过") : undefined,
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
function bypassView(plan: OnboardingPlan, planned: OnboardSelection, selection: OnboardSelection): BypassView {
|
|
||||||
const base = { willWrite: plan.bypass_permissions, selected: selection.bypassPermissions, planned: planned.bypassPermissions };
|
|
||||||
if (plan.bypass_permissions) {
|
|
||||||
return {
|
|
||||||
...base,
|
|
||||||
label: "将写入 permissions.defaultMode=bypassPermissions",
|
|
||||||
detail: "项目 .claude/settings.json 还没有 permissions:按炼境默认写入,Claude Code 在本项目跳过权限确认。可按项目取消(取消后须重新计划)。",
|
|
||||||
tone: "warn",
|
|
||||||
toggleable: true,
|
|
||||||
};
|
|
||||||
}
|
|
||||||
if (!planned.bypassPermissions) {
|
|
||||||
return {
|
|
||||||
...base,
|
|
||||||
label: "已按项目取消 bypassPermissions",
|
|
||||||
detail:
|
|
||||||
"不写入 bypassPermissions。settings.json 缺 permissions 时会写显式 defaultMode=default 记住选择(之后的重注入不会补回);已有 permissions 则原样不动。",
|
|
||||||
tone: "muted",
|
|
||||||
toggleable: true,
|
|
||||||
};
|
|
||||||
}
|
|
||||||
return {
|
|
||||||
...base,
|
|
||||||
label: "不新写入 bypassPermissions",
|
|
||||||
detail: "项目 .claude/settings.json 已有 permissions 设置,本次不改。",
|
|
||||||
tone: "muted",
|
|
||||||
toggleable: false,
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
function nextActionRow(action: OnboardNextAction): NextActionRow {
|
|
||||||
return {
|
|
||||||
action: action.action,
|
|
||||||
label: NEXT_ACTION_LABEL[action.action] ?? action.action,
|
|
||||||
detail: action.detail,
|
|
||||||
tone: action.action === "codex_trust" ? "pending" : "info",
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 计划 → 预览视图。planned 是生成本计划时的选择,selection 是界面当前的选择。
|
|
||||||
* 确认按钮:plan.blocked 非空一律禁用(后端也会 refused);选择改过未重新计划也禁用。
|
|
||||||
*/
|
|
||||||
export function buildPlanView(
|
|
||||||
plan: OnboardingPlan,
|
|
||||||
planned: OnboardSelection,
|
|
||||||
selection: OnboardSelection,
|
|
||||||
): PlanView {
|
|
||||||
const selected = new Set(selection.skipTargets);
|
|
||||||
const fileCounts: Record<OnboardFileAction, number> = { create: 0, update: 0, noop: 0 };
|
|
||||||
const files = plan.files.map((file): FileRow => {
|
|
||||||
fileCounts[file.action] = (fileCounts[file.action] ?? 0) + 1;
|
|
||||||
const badge = FILE_ACTION[file.action] ?? { label: file.action, tone: "warn" };
|
|
||||||
return {
|
|
||||||
path: file.path,
|
|
||||||
action: file.action,
|
|
||||||
actionLabel: badge.label,
|
|
||||||
tone: file.warning ? "warn" : badge.tone,
|
|
||||||
diff: file.diff,
|
|
||||||
warning: file.warning,
|
|
||||||
};
|
|
||||||
});
|
|
||||||
const machineSteps = plan.machine_changes.map((step): MachineStepRow => {
|
|
||||||
const badge = MACHINE_STATUS[step.status] ?? { label: step.status, tone: "warn" };
|
|
||||||
return {
|
|
||||||
step: step.step,
|
|
||||||
label: STEP_LABEL[step.step] ?? step.step,
|
|
||||||
status: step.status,
|
|
||||||
statusLabel: badge.label,
|
|
||||||
tone: badge.tone,
|
|
||||||
detail: step.detail,
|
|
||||||
};
|
|
||||||
});
|
|
||||||
const blocked = [
|
|
||||||
...plan.blocked.map((item) => blockedRow(item, false, selected.has(item.target))),
|
|
||||||
...(plan.skipped ?? []).map((item) => blockedRow(item, true, selected.has(item.target))),
|
|
||||||
];
|
|
||||||
const trust = CODEX_TRUST[plan.codex_trust] ?? { label: plan.codex_trust, tone: "warn" };
|
|
||||||
const trustAction = plan.next_actions.find((action) => action.action === "codex_trust");
|
|
||||||
const needsReplan = !sameSelection(planned, selection);
|
|
||||||
const blockingCount = plan.blocked.length;
|
|
||||||
const reason = needsReplan
|
|
||||||
? "选项已改:须按当前选择重新计划后才能确认"
|
|
||||||
: blockingCount > 0
|
|
||||||
? `有 ${blockingCount} 项阻断,确认已禁用:可跳过的项选「跳过」后重新计划,其余处理后重新计划或中止`
|
|
||||||
: undefined;
|
|
||||||
return {
|
|
||||||
projectId: plan.project_id,
|
|
||||||
root: plan.root,
|
|
||||||
digest: plan.digest,
|
|
||||||
files,
|
|
||||||
fileCounts,
|
|
||||||
machineSteps,
|
|
||||||
blocked,
|
|
||||||
blockingCount,
|
|
||||||
bypass: bypassView(plan, planned, selection),
|
|
||||||
codexTrust: {
|
|
||||||
state: plan.codex_trust,
|
|
||||||
label: trust.label,
|
|
||||||
tone: trust.tone,
|
|
||||||
detail: trustAction?.detail ?? (plan.codex_trust === "trusted" ? "Codex 会加载项目 .codex/config.toml" : ""),
|
|
||||||
},
|
|
||||||
nextActions: plan.next_actions.map(nextActionRow),
|
|
||||||
needsReplan,
|
|
||||||
confirm: { enabled: reason === undefined, reason },
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface OnboardConfirmRequest {
|
|
||||||
projectId: string;
|
|
||||||
/** 用户确认过的计划 digest */
|
|
||||||
expectedDigest: string;
|
|
||||||
confirmed: true;
|
|
||||||
/** 生成该计划时的选项(不是界面当前选择) */
|
|
||||||
options: OnboardOptions;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** 确认接入的调用参数;确认按钮应禁用时返回 null(不发请求) */
|
|
||||||
export function confirmRequest(
|
|
||||||
plan: OnboardingPlan,
|
|
||||||
planned: OnboardSelection,
|
|
||||||
selection: OnboardSelection,
|
|
||||||
): OnboardConfirmRequest | null {
|
|
||||||
if (!buildPlanView(plan, planned, selection).confirm.enabled) return null;
|
|
||||||
return {
|
|
||||||
projectId: plan.project_id,
|
|
||||||
expectedDigest: plan.digest,
|
|
||||||
confirmed: true,
|
|
||||||
options: selectionOptions(planned),
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
// ── 接入报告 ──────────────────────────────────────────────────────────────────
|
|
||||||
|
|
||||||
const STATUS: Record<OnboardStatus, Badge> = {
|
|
||||||
done: { label: "接入完成", tone: "ok" },
|
|
||||||
partial: { label: "部分完成", tone: "warn" },
|
|
||||||
failed: { label: "未执行:预检失败(零写入)", tone: "danger" },
|
|
||||||
refused: { label: "已拒绝(零写入)", tone: "warn" },
|
|
||||||
busy: { label: "该项目正在接入中(零写入)", tone: "info" },
|
|
||||||
};
|
|
||||||
|
|
||||||
const STEP_STATUS: Record<OnboardStepReport["status"], Badge> = {
|
|
||||||
converged: { label: "已一致", tone: "ok" },
|
|
||||||
applied: { label: "已写入", tone: "ok" },
|
|
||||||
skipped: { label: "已跳过", tone: "muted" },
|
|
||||||
not_applicable: { label: "不适用", tone: "muted" },
|
|
||||||
blocked: { label: "未执行", tone: "warn" },
|
|
||||||
failed: { label: "失败", tone: "danger" },
|
|
||||||
needs_human: { label: "需人工处理", tone: "warn" },
|
|
||||||
};
|
|
||||||
|
|
||||||
/** 步骤 reason 的常见取值(其余原样展示) */
|
|
||||||
const STEP_REASON: Record<string, string> = {
|
|
||||||
not_installed: "未安装",
|
|
||||||
control_plane: "控制面项目",
|
|
||||||
wsl: "WSL 项目",
|
|
||||||
manual_kept: "保留手写配置",
|
|
||||||
other_project: "属于别的项目",
|
|
||||||
deferred: "延后",
|
|
||||||
};
|
|
||||||
|
|
||||||
export interface StepRow {
|
|
||||||
step: string;
|
|
||||||
label: string;
|
|
||||||
status: OnboardStepReport["status"];
|
|
||||||
statusLabel: string;
|
|
||||||
tone: OnboardTone;
|
|
||||||
/** reason 或 dep 的说明 */
|
|
||||||
note?: string;
|
|
||||||
detail: string;
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface CompletionRow {
|
|
||||||
item: string;
|
|
||||||
source: OnboardCompletionItem["source"];
|
|
||||||
ready: boolean;
|
|
||||||
label: string;
|
|
||||||
tone: OnboardTone;
|
|
||||||
detail: string;
|
|
||||||
}
|
|
||||||
|
|
||||||
export const PARITY_CHECKS: ParityCheck[] = ["A", "B", "C", "D", "E", "F"];
|
|
||||||
|
|
||||||
export const CHECK_LABEL: Record<ParityCheck, string> = {
|
|
||||||
A: "项目规则",
|
|
||||||
B: "lian-jing skill",
|
|
||||||
C: "MCP 工具集",
|
|
||||||
D: "get_diagnostics",
|
|
||||||
E: "列出开发变量",
|
|
||||||
F: "敏感读取认证链",
|
|
||||||
};
|
|
||||||
|
|
||||||
const CELL_STATE: Record<ParityCellState, Badge> = {
|
|
||||||
ready: { label: "就绪", tone: "ok" },
|
|
||||||
fail: { label: "失败", tone: "danger" },
|
|
||||||
unknown: { label: "未知", tone: "warn" },
|
|
||||||
not_installed: { label: "未安装", tone: "muted" },
|
|
||||||
not_applicable: { label: "不适用", tone: "muted" },
|
|
||||||
blocked: { label: "未检查", tone: "warn" },
|
|
||||||
timeout: { label: "超时", tone: "danger" },
|
|
||||||
};
|
|
||||||
|
|
||||||
export const EVIDENCE_LABEL: Record<ParityEvidence, string> = {
|
|
||||||
static: "静态",
|
|
||||||
client_introspection: "客户端自省",
|
|
||||||
protocol: "协议重放",
|
|
||||||
session_event: "会话事件",
|
|
||||||
server_trace: "服务端轨迹",
|
|
||||||
};
|
|
||||||
|
|
||||||
/** 只等用户在客户端里操作的归因(与后端 completion 的 pending_user 同口径,仅用于着色) */
|
|
||||||
const PENDING_USER_CAUSES: ParityCause[] = ["codex_project_untrusted"];
|
|
||||||
|
|
||||||
export interface L1CellView {
|
|
||||||
state: ParityCellState;
|
|
||||||
label: string;
|
|
||||||
tone: OnboardTone;
|
|
||||||
evidence: ParityEvidence;
|
|
||||||
evidenceLabel: string;
|
|
||||||
cause?: ParityCause;
|
|
||||||
detail: string;
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface L1ColumnView {
|
|
||||||
client: string;
|
|
||||||
label: string;
|
|
||||||
version: string | null;
|
|
||||||
route: string | null;
|
|
||||||
cells: Record<ParityCheck, L1CellView>;
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface L1MatrixView {
|
|
||||||
profile: ClientParityL1Report["profile"];
|
|
||||||
allApplicableReady: boolean;
|
|
||||||
note: string;
|
|
||||||
columns: L1ColumnView[];
|
|
||||||
}
|
|
||||||
|
|
||||||
function cellView(cell: ParityCell): L1CellView {
|
|
||||||
const badge = CELL_STATE[cell.state] ?? { label: cell.state, tone: "warn" };
|
|
||||||
const pendingUser = cell.state !== "ready" && cell.cause !== undefined && PENDING_USER_CAUSES.includes(cell.cause);
|
|
||||||
const label = pendingUser
|
|
||||||
? "待你信任"
|
|
||||||
: cell.state === "blocked" && cell.dep
|
|
||||||
? `未检查:${STEP_LABEL[cell.dep] ?? cell.dep} 步骤未完成`
|
|
||||||
: badge.label;
|
|
||||||
return {
|
|
||||||
state: cell.state,
|
|
||||||
label,
|
|
||||||
tone: pendingUser ? "pending" : badge.tone,
|
|
||||||
evidence: cell.evidence,
|
|
||||||
evidenceLabel: EVIDENCE_LABEL[cell.evidence] ?? cell.evidence,
|
|
||||||
cause: cell.cause,
|
|
||||||
detail: cell.detail,
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
export function l1MatrixView(report: ClientParityL1Report): L1MatrixView {
|
|
||||||
return {
|
|
||||||
profile: report.profile,
|
|
||||||
allApplicableReady: report.all_applicable_ready,
|
|
||||||
note: report.note,
|
|
||||||
columns: report.clients.map((column) => {
|
|
||||||
const cells = {} as Record<ParityCheck, L1CellView>;
|
|
||||||
for (const check of PARITY_CHECKS) {
|
|
||||||
const cell = column.cells[check];
|
|
||||||
cells[check] = cell
|
|
||||||
? cellView(cell)
|
|
||||||
: { state: "unknown", label: "缺失", tone: "warn", evidence: "static", evidenceLabel: EVIDENCE_LABEL.static, detail: "报告未给出该格" };
|
|
||||||
}
|
|
||||||
return {
|
|
||||||
client: column.client,
|
|
||||||
label: STEP_LABEL[column.client] ?? column.client,
|
|
||||||
version: column.version,
|
|
||||||
route: column.route,
|
|
||||||
cells,
|
|
||||||
};
|
|
||||||
}),
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
export type CommitView =
|
|
||||||
| {
|
|
||||||
state: "available";
|
|
||||||
/** 「待你提交的 N 个文件」 */
|
|
||||||
title: string;
|
|
||||||
files: OnboardPendingFile[];
|
|
||||||
otherChanges: number;
|
|
||||||
/** 有非接入改动时提醒勿混进接入提交 */
|
|
||||||
otherWarning?: string;
|
|
||||||
suggestedMessage?: string;
|
|
||||||
diffStat: string;
|
|
||||||
}
|
|
||||||
| { state: "unavailable"; reason: string }
|
|
||||||
/** 未执行写入(refused / busy / failed)时不报告改动 */
|
|
||||||
| { state: "none" };
|
|
||||||
|
|
||||||
export interface ReportView {
|
|
||||||
status: OnboardStatus;
|
|
||||||
statusLabel: string;
|
|
||||||
tone: OnboardTone;
|
|
||||||
summary: string;
|
|
||||||
reason?: string;
|
|
||||||
steps: StepRow[];
|
|
||||||
/** 计入「完成」的项(不含 pending_user) */
|
|
||||||
completion: CompletionRow[];
|
|
||||||
/** 「待你操作」:只等你在客户端里操作、不计入完成判定的项(目前只有 Codex 信任) */
|
|
||||||
pendingUser: CompletionRow[];
|
|
||||||
l1?: L1MatrixView;
|
|
||||||
l3: string;
|
|
||||||
bypassWritten: boolean;
|
|
||||||
writtenFiles: string[];
|
|
||||||
commit: CommitView;
|
|
||||||
nextActions: NextActionRow[];
|
|
||||||
head?: { unchanged: boolean; label: string; tone: OnboardTone };
|
|
||||||
/** refused 且附当前计划:须回到预览、按新计划重新确认 */
|
|
||||||
replan?: OnboardingPlan;
|
|
||||||
durationLabel: string;
|
|
||||||
/** 结果提示:失败类状态以「❌」开头 */
|
|
||||||
toast: string;
|
|
||||||
}
|
|
||||||
|
|
||||||
function stepRow(step: OnboardStepReport): StepRow {
|
|
||||||
const badge = STEP_STATUS[step.status] ?? { label: step.status, tone: "warn" };
|
|
||||||
let note: string | undefined;
|
|
||||||
if (step.status === "blocked") {
|
|
||||||
note = `依赖「${STEP_LABEL[step.dep] ?? step.dep}」未完成`;
|
|
||||||
} else if ("reason" in step && step.reason) {
|
|
||||||
note = STEP_REASON[step.reason] ?? step.reason;
|
|
||||||
}
|
|
||||||
return {
|
|
||||||
step: step.step,
|
|
||||||
label: STEP_LABEL[step.step] ?? step.step,
|
|
||||||
status: step.status,
|
|
||||||
statusLabel: badge.label,
|
|
||||||
tone: badge.tone,
|
|
||||||
note,
|
|
||||||
detail: step.detail,
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
function completionRow(item: OnboardCompletionItem): CompletionRow {
|
|
||||||
const pending = !item.ready && item.pending_user;
|
|
||||||
return {
|
|
||||||
item: item.item,
|
|
||||||
source: item.source,
|
|
||||||
ready: item.ready,
|
|
||||||
label: item.ready ? "就绪" : pending ? "待你操作" : "未就绪",
|
|
||||||
tone: item.ready ? "ok" : pending ? "pending" : "danger",
|
|
||||||
detail: item.detail,
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
function commitView(report: OnboardReport): CommitView {
|
|
||||||
const changes = report.repo_changes;
|
|
||||||
if (!changes) return { state: "none" };
|
|
||||||
if (changes.state === "unavailable") return { state: "unavailable", reason: changes.reason };
|
|
||||||
return {
|
|
||||||
state: "available",
|
|
||||||
title: `待你提交的 ${changes.onboard_files.length} 个文件`,
|
|
||||||
files: changes.onboard_files,
|
|
||||||
otherChanges: changes.other_changes,
|
|
||||||
otherWarning:
|
|
||||||
changes.other_changes > 0
|
|
||||||
? `另有 ${changes.other_changes} 处不属于接入的改动:只 add 上面的文件,不要 git add -A`
|
|
||||||
: undefined,
|
|
||||||
suggestedMessage: report.suggested_commit_message,
|
|
||||||
diffStat: changes.diff_stat,
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
const FAILURE_STATUSES: OnboardStatus[] = ["failed", "refused", "busy"];
|
|
||||||
|
|
||||||
/** 报告 → 结果视图(分步结果、L1 矩阵、待你操作、待提交文件、next_actions) */
|
|
||||||
export function buildReportView(report: OnboardReport): ReportView {
|
|
||||||
const badge = STATUS[report.status] ?? { label: report.status, tone: "warn" };
|
|
||||||
const completion = report.completion.map((item) => ({ item, row: completionRow(item) }));
|
|
||||||
const failure = FAILURE_STATUSES.includes(report.status);
|
|
||||||
return {
|
|
||||||
status: report.status,
|
|
||||||
statusLabel: badge.label,
|
|
||||||
tone: badge.tone,
|
|
||||||
summary: report.summary,
|
|
||||||
reason: report.reason,
|
|
||||||
steps: report.steps.map(stepRow),
|
|
||||||
completion: completion.filter(({ item }) => !item.pending_user).map(({ row }) => row),
|
|
||||||
pendingUser: completion.filter(({ item }) => item.pending_user).map(({ row }) => row),
|
|
||||||
l1: report.l1 ? l1MatrixView(report.l1) : undefined,
|
|
||||||
l3: report.l3,
|
|
||||||
bypassWritten: report.bypass_permissions,
|
|
||||||
writtenFiles: report.written_files ?? [],
|
|
||||||
commit: commitView(report),
|
|
||||||
nextActions: report.next_actions.map(nextActionRow),
|
|
||||||
head: report.head
|
|
||||||
? report.head.unchanged
|
|
||||||
? { unchanged: true, label: "HEAD 未变(炼境不 add、不 commit)", tone: "ok" }
|
|
||||||
: { unchanged: false, label: "HEAD 已变化:写入期间有别的提交,请核对", tone: "warn" }
|
|
||||||
: undefined,
|
|
||||||
replan: report.status === "refused" ? report.plan : undefined,
|
|
||||||
durationLabel: `${(report.duration_ms / 1000).toFixed(1)} 秒`,
|
|
||||||
toast: failure
|
|
||||||
? `❌ 一键接入${badge.label}:${report.reason ?? report.summary}`
|
|
||||||
: `一键接入${badge.label} ✓`,
|
|
||||||
};
|
|
||||||
}
|
|
||||||
@ -28,10 +28,7 @@ const EXEC_STEPS = [
|
|||||||
|
|
||||||
export function NewProjectModal({ spaceId, onClose }: Props) {
|
export function NewProjectModal({ spaceId, onClose }: Props) {
|
||||||
const showToast = useUIStore((s) => s.showToast);
|
const showToast = useUIStore((s) => s.showToast);
|
||||||
const openOnboard = useUIStore((s) => s.openOnboard);
|
|
||||||
const qc = useQueryClient();
|
const qc = useQueryClient();
|
||||||
/** 模板创建成功的项目 ID:自动弹接入预览(P8g),取消后可从完成页再次打开 */
|
|
||||||
const [createdId, setCreatedId] = useState<string | null>(null);
|
|
||||||
|
|
||||||
// ── Step 1 ────────────────────────────────────────────────────────────────
|
// ── Step 1 ────────────────────────────────────────────────────────────────
|
||||||
const [platform, setPlatform] = useState<"win" | "wsl">("win");
|
const [platform, setPlatform] = useState<"win" | "wsl">("win");
|
||||||
@ -131,7 +128,7 @@ export function NewProjectModal({ spaceId, onClose }: Props) {
|
|||||||
const variantCmd = selectedVariants.length > 0
|
const variantCmd = selectedVariants.length > 0
|
||||||
? selectedVariants[selectedVariantIdx]?.initCommands
|
? selectedVariants[selectedVariantIdx]?.initCommands
|
||||||
: undefined;
|
: undefined;
|
||||||
const result = await createProjectFromTemplate(
|
await createProjectFromTemplate(
|
||||||
selectedTemplateId,
|
selectedTemplateId,
|
||||||
parentPath,
|
parentPath,
|
||||||
projectName.trim(),
|
projectName.trim(),
|
||||||
@ -141,8 +138,6 @@ export function NewProjectModal({ spaceId, onClose }: Props) {
|
|||||||
);
|
);
|
||||||
qc.invalidateQueries({ queryKey: ["projects"] });
|
qc.invalidateQueries({ queryKey: ["projects"] });
|
||||||
setStep("done");
|
setStep("done");
|
||||||
setCreatedId(result.projectId);
|
|
||||||
openOnboard({ projectId: result.projectId, projectName: projectName.trim() });
|
|
||||||
} catch (e) {
|
} catch (e) {
|
||||||
setLogs((prev) => [...prev, `❌ 创建失败: ${e}`]);
|
setLogs((prev) => [...prev, `❌ 创建失败: ${e}`]);
|
||||||
setHasError(true);
|
setHasError(true);
|
||||||
@ -454,14 +449,6 @@ export function NewProjectModal({ spaceId, onClose }: Props) {
|
|||||||
)}
|
)}
|
||||||
</div>
|
</div>
|
||||||
<div className="flex gap-3">
|
<div className="flex gap-3">
|
||||||
{step === "done" && createdId && (
|
|
||||||
<button
|
|
||||||
onClick={() => openOnboard({ projectId: createdId, projectName: projectName.trim() })}
|
|
||||||
className="px-4 py-2 text-sm border border-blue-200 rounded-lg text-blue-700 hover:bg-blue-50"
|
|
||||||
>
|
|
||||||
一键接入
|
|
||||||
</button>
|
|
||||||
)}
|
|
||||||
<button
|
<button
|
||||||
onClick={onClose}
|
onClick={onClose}
|
||||||
disabled={step === "executing"}
|
disabled={step === "executing"}
|
||||||
|
|||||||
@ -7,7 +7,7 @@ export function Toast() {
|
|||||||
const isError = toast.startsWith("❌");
|
const isError = toast.startsWith("❌");
|
||||||
|
|
||||||
return (
|
return (
|
||||||
<div className={`fixed bottom-10 left-1/2 -translate-x-1/2 z-[70] text-sm px-4 py-2 rounded-lg shadow-lg animate-fade-in flex items-center gap-2 max-w-[80vw] ${
|
<div className={`fixed bottom-10 left-1/2 -translate-x-1/2 z-50 text-sm px-4 py-2 rounded-lg shadow-lg animate-fade-in flex items-center gap-2 max-w-[80vw] ${
|
||||||
isError ? "bg-red-900 text-white pointer-events-auto" : "bg-gray-900 text-white pointer-events-none"
|
isError ? "bg-red-900 text-white pointer-events-auto" : "bg-gray-900 text-white pointer-events-none"
|
||||||
}`}>
|
}`}>
|
||||||
<span className="break-all">{toast}</span>
|
<span className="break-all">{toast}</span>
|
||||||
|
|||||||
@ -1770,8 +1770,6 @@ export interface OnboardBlockedItem {
|
|||||||
target: string;
|
target: string;
|
||||||
reason: OnboardBlockReason;
|
reason: OnboardBlockReason;
|
||||||
detail: string;
|
detail: string;
|
||||||
/** 本体派生(BlockReason::skippable):可在确认时逐项「跳过」;界面据此给按钮,不自行判定 */
|
|
||||||
skippable: boolean;
|
|
||||||
}
|
}
|
||||||
|
|
||||||
/** 本机七步:token、shim、claude、codex、dsh、product_group_buff、git_hooks */
|
/** 本机七步:token、shim、claude、codex、dsh、product_group_buff、git_hooks */
|
||||||
|
|||||||
@ -1,13 +1,5 @@
|
|||||||
import { create } from "zustand";
|
import { create } from "zustand";
|
||||||
import type { OnboardReport, Project } from "../lib/commands";
|
import type { Project } from "../lib/commands";
|
||||||
|
|
||||||
/** 一键接入预览的目标(agent-client-parity P8g):新建、模板创建、批量添加、蓝图治理都打开同一面板 */
|
|
||||||
export interface OnboardTarget {
|
|
||||||
projectId: string;
|
|
||||||
projectName?: string;
|
|
||||||
/** 面板关闭时回调;未执行接入(取消 / 计划失败)时 report 为 null */
|
|
||||||
onClosed?: (report: OnboardReport | null) => void;
|
|
||||||
}
|
|
||||||
|
|
||||||
interface UIState {
|
interface UIState {
|
||||||
// Toast
|
// Toast
|
||||||
@ -18,11 +10,6 @@ interface UIState {
|
|||||||
editTarget: Project | null | undefined; // undefined = closed, null = new, obj = edit
|
editTarget: Project | null | undefined; // undefined = closed, null = new, obj = edit
|
||||||
openEdit: (project?: Project | null) => void;
|
openEdit: (project?: Project | null) => void;
|
||||||
closeEdit: () => void;
|
closeEdit: () => void;
|
||||||
|
|
||||||
// 一键接入面板(全局挂载:新建弹窗保存后即卸载,面板须独立存在)
|
|
||||||
onboardTarget: OnboardTarget | null;
|
|
||||||
openOnboard: (target: OnboardTarget) => void;
|
|
||||||
closeOnboard: () => void;
|
|
||||||
}
|
}
|
||||||
|
|
||||||
export const useUIStore = create<UIState>((set) => ({
|
export const useUIStore = create<UIState>((set) => ({
|
||||||
@ -35,8 +22,4 @@ export const useUIStore = create<UIState>((set) => ({
|
|||||||
editTarget: undefined,
|
editTarget: undefined,
|
||||||
openEdit: (project) => set({ editTarget: project ?? null }),
|
openEdit: (project) => set({ editTarget: project ?? null }),
|
||||||
closeEdit: () => set({ editTarget: undefined }),
|
closeEdit: () => set({ editTarget: undefined }),
|
||||||
|
|
||||||
onboardTarget: null,
|
|
||||||
openOnboard: (target) => set({ onboardTarget: target }),
|
|
||||||
closeOnboard: () => set({ onboardTarget: null }),
|
|
||||||
}));
|
}));
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user