dsh-gate-agent 0.1.1 → 0.1.3

package/locale/en.json

@@ -1,6 +1,6 @@
 {
   "meta": {
-    "title": "Gate",
-    "description": "Phase gate and write policy for agent workflows."
+    "title": "Gate Agent",
+    "description": "Phase/node gate for discuss, planning, implementation, review, verification, and Note lifecycle, with gate commands, tools, and skills."
   }
 }

package/locale/zh.json

@@ -1,6 +1,6 @@
 {
   "meta": {
-    "title": "Gate 门禁",
-    "description": "按阶段控制 agent 的写入与评审流程。"
+    "title": "Gate Agent",
+    "description": "用 phase/node 门禁编排讨论、规划、实施、评审、验收与 Note 生命周期，并提供 gate 命令、工具和专项技能。"
   }
 }

package/package.json

@@ -1,34 +1,34 @@
-{
-  "name": "dsh-gate-agent",
-  "version": "0.1.1",
-  "type": "module",
-  "description": "Full write gate and phase orchestrator with plugin-local skills.",
-  "exports": {
-    ".": "./lib/index.js",
-    "./locale/*.json": "./locale/*.json",
-    "./icon": "./icon.svg",
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "lib",
-    "skills",
-    "launchers",
-    "cordis.patch.yml",
-    "README.md",
-    "locale/*.json",
-    "icon.svg"
-  ],
-  "scripts": {
-    "build": "node scripts/bundle.mjs",
-    "typecheck": "tsc -p tsconfig.json",
-    "test": "node scripts/bundle.mjs && node scripts/check-split.mjs && node test/unit.mjs && node test/composition.mjs && node test/registry.mjs"
-  },
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    }
-  },
-  "publishConfig": {
-    "access": "public"
-  }
-}
+{
+  "name": "dsh-gate-agent",
+  "version": "0.1.3",
+  "type": "module",
+  "description": "Phase/node workflow gate with built-in commands, tools, and skills.",
+  "exports": {
+    ".": "./lib/index.js",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "skills",
+    "launchers",
+    "cordis.patch.yml",
+    "README.md",
+    "locale/*.json",
+    "icon.svg"
+  ],
+  "scripts": {
+    "build": "node scripts/bundle.mjs",
+    "typecheck": "tsc -p tsconfig.json",
+    "test": "node scripts/bundle.mjs && node scripts/check-split.mjs && node test/unit.mjs && node test/composition.mjs && node test/registry.mjs"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/skills/gate-code-review/SKILL.md

@@ -6,8 +6,8 @@ user-invocable: false
 
 ## Gate 使用
 
-主 agent 读取本方法后，按改动规模派一个或多个 review worker；worker 不加载本技能或其他 gate 方法文件。`gate_record({node:'code-review'})` 需要 `reviewAxes.standards.findings` 与 `reviewAxes.spec.findings`；worker 数量由主 agent 决定，但两轴都必须产出。
-
+主 agent 读取本方法后，按改动规模派一个或多个 review worker；worker 不加载本技能或其他 gate 方法文件。`gate_record({node:'code-review'})` 需要 `reviewAxes.standards.findings` 与 `reviewAxes.spec.findings`；worker 数量由主 agent 决定，但两轴都必须产出。
+
 任务模板：本技能 `assets/worker-briefs/gate-implement-review.md`。
 
 Two-axis review of the requested change scope, including uncommitted work when applicable:

package/skills/gate-code-review/assets/worker-briefs/gate-implement-review.md

@@ -1,19 +1,19 @@
-# /gate-implement-review — review worker
-
-```markdown
-你是 Gate 的只读 Implementation Review worker。只评审改动，不修复，不写代码。
-
-## 评审对象
-<范围、固定点、完整 diff>
-
-## 合同
-<工作项验收条件、适用设计决定>
-
-## 两轴
-Standards / Spec。每轴只报 findings，注明文件/证据与严重度。
-
-## 输出
-返回 standards、spec 两组 findings；不要合并两轴，不要修改代码。
-```
+# /gate-implement-review — review worker
+
+```markdown
+你是 Gate 的只读 Implementation Review worker。只评审改动，不修复，不写代码。
+
+## 评审对象
+<范围、固定点、完整 diff>
+
+## 合同
+<工作项验收条件、适用设计决定>
+
+## 两轴
+Standards / Spec。每轴只报 findings，注明文件/证据与严重度。
+
+## 输出
+返回 standards、spec 两组 findings；不要合并两轴，不要修改代码。
+```
 
 

package/skills/gate-domain-modeling/CONTEXT-FORMAT.md

@@ -51,9 +51,9 @@ _Avoid_: Client, buyer, account
 - **Ordering ↔ Billing**: Shared types for `CustomerId` and `Money`
 ```
 
-The skill infers which structure applies:
-
-Resolve the root from project instructions before these checks; the current working directory may be a subproject. Use the project documentation hierarchy for ownership; the context map does not create separate record categories. Paths shown in the map are Markdown links relative to the map file.
+The skill infers which structure applies:
+
+Resolve the root from project instructions before these checks; the current working directory may be a subproject. Use the project documentation hierarchy for ownership; the context map does not create separate record categories. Paths shown in the map are Markdown links relative to the map file.
 
 - If `CONTEXT-MAP.md` exists, read it to find contexts
 - If only a root `CONTEXT.md` exists, single context

package/skills/gate-domain-modeling/GLOSSARY-FORMAT.md

@@ -51,9 +51,9 @@ _Avoid_: Client, buyer, account
 - **Ordering ↔ Billing**: Shared types for `CustomerId` and `Money`
 ```
 
-The skill infers which structure applies:
-
-Resolve the root from project instructions before these checks; the current working directory may be a subproject. Use the project documentation hierarchy for ownership; the context map does not create separate record categories. Paths shown in the map are Markdown links relative to the map file.
+The skill infers which structure applies:
+
+Resolve the root from project instructions before these checks; the current working directory may be a subproject. Use the project documentation hierarchy for ownership; the context map does not create separate record categories. Paths shown in the map are Markdown links relative to the map file.
 
 - If `GLOSSARY-MAP.md` exists, read it to find contexts
 - If only a root `GLOSSARY.md` exists, single context

package/skills/gate-fix-bug/assets/worker-briefs/fix-bug-review.md

@@ -1,23 +1,23 @@
-# gate-fix-bug independent review worker
-
-```markdown
-你是 Gate 的独立 review worker。只评审 fix worker 的修复 diff，返回 findings，不修复。
-
-## 修复基线
-<fix 前 commit / 固定点、当前 diff 范围>
-
-## 选定失败与合同
-<原失败项、期望行为、验收/合同引用>
-
-## 修复报告
-<fix worker 的根因、改动、回归测试和验证结果>
-
-## 评审范围
-Standards / Spec 两轴；重点确认修复没有改变合同、没有扩大范围、没有削弱测试。
-
-## 输出
-返回 standards、spec 两组 findings，注明证据与严重度；不修改代码，不提交。
-```
+# gate-fix-bug independent review worker
+
+```markdown
+你是 Gate 的独立 review worker。只评审 fix worker 的修复 diff，返回 findings，不修复。
+
+## 修复基线
+<fix 前 commit / 固定点、当前 diff 范围>
+
+## 选定失败与合同
+<原失败项、期望行为、验收/合同引用>
+
+## 修复报告
+<fix worker 的根因、改动、回归测试和验证结果>
+
+## 评审范围
+Standards / Spec 两轴；重点确认修复没有改变合同、没有扩大范围、没有削弱测试。
+
+## 输出
+返回 standards、spec 两组 findings，注明证据与严重度；不修改代码，不提交。
+```
 
 
 

package/skills/gate-fix-bug/assets/worker-briefs/gate-fix-bug.md

@@ -1,33 +1,33 @@
-# /gate-fix-bug — fix worker
-
-```markdown
-你是 Gate 的 fix-bug worker。使用 gate-fix-bug 完成这次已授权的实现缺陷修复；执行 Process 1-9，返回修复 receipt。独立 review 由主 agent 另派，不要自行完成 Step 10-12。
-
-## 选定失败
-<现象、复现步骤、最新结果>
-
-## 期望行为与合同
-<需求/验收/设计决定引用>
-
-## 证据/诊断
-<日志、失败测试、已有报告>
-
-## 修复范围
-<只修什么；明确不修什么>
-
-## 基线
-<commit、diff、相关文件>
-
-## 约束
-- 只修选定缺陷；不重构、不改产品行为、不加依赖、不做无关清理。
-- 先复现；回归测试应先失败，修复后通过。
-- 不通过削弱/删除有效测试让套件变绿。
-- 若发现是测试/合同/设计/环境问题，停止并报告属主。
-- 只执行 Process 1-9；不自行 review，不提交。
-
-## 验证
-<复现命令、相关测试、类型检查/构建>
-```
+# /gate-fix-bug — fix worker
+
+```markdown
+你是 Gate 的 fix-bug worker。使用 gate-fix-bug 完成这次已授权的实现缺陷修复；执行 Process 1-9，返回修复 receipt。独立 review 由主 agent 另派，不要自行完成 Step 10-12。
+
+## 选定失败
+<现象、复现步骤、最新结果>
+
+## 期望行为与合同
+<需求/验收/设计决定引用>
+
+## 证据/诊断
+<日志、失败测试、已有报告>
+
+## 修复范围
+<只修什么；明确不修什么>
+
+## 基线
+<commit、diff、相关文件>
+
+## 约束
+- 只修选定缺陷；不重构、不改产品行为、不加依赖、不做无关清理。
+- 先复现；回归测试应先失败，修复后通过。
+- 不通过削弱/删除有效测试让套件变绿。
+- 若发现是测试/合同/设计/环境问题，停止并报告属主。
+- 只执行 Process 1-9；不自行 review，不提交。
+
+## 验证
+<复现命令、相关测试、类型检查/构建>
+```
 
 
 

package/skills/gate-implement/SKILL.md

@@ -1,81 +1,81 @@
----
-name: gate-implement
-description: Gate 实现方法：主 agent 读取后提炼任务并派发；subagent worker 不加载技能。
-user-invocable: false
----
-
-## Main agent use
-
-主 agent 在派发前自行读取本方法，给 subagent worker 一份自包含任务：已接受的范围、约束、验收检查和实现规则。subagent worker 不应加载本技能或其他 gate 方法文件。
-
-任务模板：本技能 `assets/worker-briefs/gate-enter-implement.md`。
-
-## 实现
-
-## 1. 入口条件
-
-实现已接受工作项（proposed Agent Note）的选定范围。编码前读取其范围、验收条件与引用的设计章节。
-
-实现前检查范围、验收条件、必需决定、批准证据、未解决 blocker，以及该范围的执行授权。复用有效证据，不重复确认。把已确认的范围和决定同步给各自属主；未解决的重要决定按项目的讨论、授权和 gate 规则返回 discuss。仅记录状态或位置不构成就绪或授权。
-
-## 2. 按需拆分
-
-通过 Implementation Gate 后，只在确实需要拆分时创建 implementation ticket。ticket 的存在不是进入实现的前提。
-
-工作适合一个连贯执行单元时直接实现。
-
-工作过大、存在有意义的独立切片或依赖时，读取 [tickets.md](./tickets.md) 。
-
-不要为了枚举编码步骤而创建 ticket。
-
-## 3. 执行
-
-按工作项的范围、验收条件、引用要求、已接受设计和架构决定实现。
-
-使用既有架构、约定、接口和领域语言，除非权威设计明确改变。
-
-如果实现暴露出未解决的产品、领域、架构、接口、兼容性或其他合同决定，停止受影响实现，并向主 agent 返回 receipt 和该决定。主 agent 调用 `gate_record({node:'implement', requiresDiscussion:true, discussionReason})`；worker 不得调用 `gate_record` 或 slash command。决定未解决前先讨论，不做新的 planning/implement 授权，也不继续受影响代码。
-
-### 实现期测试
-
-按改动需要编写或更新测试。测试优先能改善反馈或明确行为时使用；采用时加载 `gate-tdd` 技能并遵循其流程。
-
-工作时运行聚焦测试和相关静态检查。
-
-### 实现 findings
-
-gate 可能返回实质 findings。按属主处理：
-
-| Finding | 路由 |
-| --- | --- |
-| 当前实现缺失或违反已同意合同 | 在当前实现中修复 |
-| 同一已同意工作需要额外执行单元 | 增加或更新 implementation ticket |
-| 产品或技术合同必须改变或从未解决 | 停止受影响工作，把决定 blocker 返回主 agent；主 agent 调 `gate_record` 带 `requiresDiscussion:true`；新 planning 需要授权 |
-| 与已同意工作无关 | 不自动扩大范围 |
-
-没有“顺手修一下”的无关工作路径。
-
-对属于本实现的 findings，在当前实现中修复，重跑受影响测试和静态检查，并在下一次 receipt 报告每项处置。没有证据不要标记已解决。
-
-## 4. Receipt 与交接
-
-实现完成的条件：
-
-- 授权范围已实现
-- 必需 ticket 已完成
-- 相关实现期检查通过
-- 实质 findings 已解决或明确报告为 blocked
-- 改动已准备好进入 `gate-verify`
-
-返回 receipt，包含：
-
-- 改动文件与覆盖范围
-- 运行的测试和静态检查及结果
-- 每项 finding 的处置
-- 剩余风险、blocker 或需要决定的点
-
-不要执行 `gate-verify`、不要把工作项标完成、不要推进 gate。verify 节点和最终完成由 gate 负责。
-
+---
+name: gate-implement
+description: Gate 实现方法：主 agent 读取后提炼任务并派发；subagent worker 不加载技能。
+user-invocable: false
+---
+
+## Main agent use
+
+主 agent 在派发前自行读取本方法，给 subagent worker 一份自包含任务：已接受的范围、约束、验收检查和实现规则。subagent worker 不应加载本技能或其他 gate 方法文件。
+
+任务模板：本技能 `assets/worker-briefs/gate-enter-implement.md`。
+
+## 实现
+
+## 1. 入口条件
+
+实现已接受工作项（proposed Agent Note）的选定范围。编码前读取其范围、验收条件与引用的设计章节。
+
+实现前检查范围、验收条件、必需决定、批准证据、未解决 blocker，以及该范围的执行授权。复用有效证据，不重复确认。把已确认的范围和决定同步给各自属主；未解决的重要决定按项目的讨论、授权和 gate 规则返回 discuss。仅记录状态或位置不构成就绪或授权。
+
+## 2. 按需拆分
+
+通过 Implementation Gate 后，只在确实需要拆分时创建 implementation ticket。ticket 的存在不是进入实现的前提。
+
+工作适合一个连贯执行单元时直接实现。
+
+工作过大、存在有意义的独立切片或依赖时，读取 [tickets.md](./tickets.md) 。
+
+不要为了枚举编码步骤而创建 ticket。
+
+## 3. 执行
+
+按工作项的范围、验收条件、引用要求、已接受设计和架构决定实现。
+
+使用既有架构、约定、接口和领域语言，除非权威设计明确改变。
+
+如果实现暴露出未解决的产品、领域、架构、接口、兼容性或其他合同决定，停止受影响实现，并向主 agent 返回 receipt 和该决定。主 agent 调用 `gate_record({node:'implement', requiresDiscussion:true, discussionReason})`；worker 不得调用 `gate_record` 或 slash command。决定未解决前先讨论，不做新的 planning/implement 授权，也不继续受影响代码。
+
+### 实现期测试
+
+按改动需要编写或更新测试。测试优先能改善反馈或明确行为时使用；采用时加载 `gate-tdd` 技能并遵循其流程。
+
+工作时运行聚焦测试和相关静态检查。
+
+### 实现 findings
+
+gate 可能返回实质 findings。按属主处理：
+
+| Finding | 路由 |
+| --- | --- |
+| 当前实现缺失或违反已同意合同 | 在当前实现中修复 |
+| 同一已同意工作需要额外执行单元 | 增加或更新 implementation ticket |
+| 产品或技术合同必须改变或从未解决 | 停止受影响工作，把决定 blocker 返回主 agent；主 agent 调 `gate_record` 带 `requiresDiscussion:true`；新 planning 需要授权 |
+| 与已同意工作无关 | 不自动扩大范围 |
+
+没有“顺手修一下”的无关工作路径。
+
+对属于本实现的 findings，在当前实现中修复，重跑受影响测试和静态检查，并在下一次 receipt 报告每项处置。没有证据不要标记已解决。
+
+## 4. Receipt 与交接
+
+实现完成的条件：
+
+- 授权范围已实现
+- 必需 ticket 已完成
+- 相关实现期检查通过
+- 实质 findings 已解决或明确报告为 blocked
+- 改动已准备好进入 `gate-verify`
+
+返回 receipt，包含：
+
+- 改动文件与覆盖范围
+- 运行的测试和静态检查及结果
+- 每项 finding 的处置
+- 剩余风险、blocker 或需要决定的点
+
+不要执行 `gate-verify`、不要把工作项标完成、不要推进 gate。verify 节点和最终完成由 gate 负责。
+
 
 
 

package/skills/gate-implement/assets/worker-briefs/gate-enter-implement.md

@@ -1,24 +1,24 @@
-# /gate-enter-implement — implement worker
-
-```markdown
-你是 Gate 的 implement worker。按已确认方案实施；不 review，不 verify，不推进 gate。
-
-## 工作项
-<task / 用户简述>
-
-## 合同与范围
-<验收条件、设计约束、本次要做 / 明确不做>
-
-## 基线
-<固定点、相关文件、已有改动>
-
-## 实施要求
-- 按现有架构和测试策略做最小完整实现。
-- 不扩大范围，不引入无关依赖，不修改产品合同。
-- 需要时补测试；记录实际运行的命令和结果。
-
-## 交付
-返回：改动文件、测试/命令结果、偏差、遗留风险。
-```
+# /gate-enter-implement — implement worker
+
+```markdown
+你是 Gate 的 implement worker。按已确认方案实施；不 review，不 verify，不推进 gate。
+
+## 工作项
+<task / 用户简述>
+
+## 合同与范围
+<验收条件、设计约束、本次要做 / 明确不做>
+
+## 基线
+<固定点、相关文件、已有改动>
+
+## 实施要求
+- 按现有架构和测试策略做最小完整实现。
+- 不扩大范围，不引入无关依赖，不修改产品合同。
+- 需要时补测试；记录实际运行的命令和结果。
+
+## 交付
+返回：改动文件、测试/命令结果、偏差、遗留风险。
+```
 
 

package/skills/gate-plan-review/assets/worker-briefs/plan-review.md

@@ -1,19 +1,19 @@
-# Plan / Proposal Review worker
-
-```markdown
-你是 Gate 的只读 Plan Review worker。只评审计划、提案或 Note，不修改、不写代码。
-
-## 评审对象
-<工作项 / 提案 / Note 路径、固定点>
-
-## 合同
-<需求、验收条件、适用设计决定>
-
-## 评审三轴
-Standards / Spec / Architecture。每轴只报 findings，注明证据与严重度。
-
-## 输出
-返回 standards、spec、architecture 三组 findings；不要合并三轴，不要修复。
-```
+# Plan / Proposal Review worker
+
+```markdown
+你是 Gate 的只读 Plan Review worker。只评审计划、提案或 Note，不修改、不写代码。
+
+## 评审对象
+<工作项 / 提案 / Note 路径、固定点>
+
+## 合同
+<需求、验收条件、适用设计决定>
+
+## 评审三轴
+Standards / Spec / Architecture。每轴只报 findings，注明证据与严重度。
+
+## 输出
+返回 standards、spec、architecture 三组 findings；不要合并三轴，不要修复。
+```
 
 

package/skills/gate-planning/assets/worker-briefs/gate-enter-plan.md

@@ -1,24 +1,24 @@
-# /gate-enter-plan — planning worker
-
-```markdown
-你是 Gate 的 planning worker。完成规划并写 Note；不写代码，不实现。
-
-## 需求/约束
-<用户简述、已确认约束、范围>
-
-## 项目上下文
-<相关代码、文档、历史 Note 的关键事实；不要附环境 smoke>
-
-## Design 检查项
-<按 gate-planning/rfc.md 的适用检查点填写；worker 不加载技能，root 必须转交>
-
-## Note 要求
-- 先按 §3 检索历史，再按 §4 判定归属与 class。
-- 新建时用 gate_note_write 写 proposed Note；原地同步 implemented Note 时写 implemented/<class>/...。
-- 内容包含 problem / proposal / design / alternatives / acceptance / risks。
-
-## 交付
-返回：Note 路径、class、lifecycle、noteDecision、检索结论、主要设计取舍、未决问题。
-```
-
-
+# /gate-enter-plan — planning worker
+
+```markdown
+你是 Gate 的 planning worker。完成规划并写 Note；不写代码，不实现。
+
+## 需求/约束
+<用户简述、已确认约束、范围>
+
+## 项目上下文
+<相关代码、文档、历史 Note 的关键事实；不要附环境 smoke>
+
+## Design 检查项
+<按 gate-planning/rfc.md 的适用检查点填写；worker 不加载技能，root 必须转交>
+
+## Note 要求
+- 先按 §3 检索历史，再按 §4 判定归属与 class。
+- 新建时用 gate_note_write 写 proposed Note；原地同步 implemented Note 时写 implemented/<class>/...。
+- 内容包含 problem / proposal / design / alternatives / acceptance / risks。
+
+## 交付
+返回：Note 路径、class、lifecycle、noteDecision、检索结论、主要设计取舍、未决问题。
+```
+
+