Albertlsy588/dsh-shipgate

ShipGate

ShipGate 是一个本地优先的、合并前回执生成器。它读取显式的 Git 比较结果和调用方提供的检查证据，然后写出确定性的 JSON 发布回执（Release Receipt）和可移植的 Markdown 摘要。它不执行检查、不上传源代码，也不声称代码是正确的。

本地开发

需要 Node.js 20 或更高版本。

cd /Users/albert.liu/Projects/dsh-delivery-gate/shipgate
npm install
npm test

用法

在正在被评估的 Git 仓库中运行构建后的 CLI：

node /Users/albert.liu/Projects/dsh-delivery-gate/shipgate/dist/cli.js inspect \
--base origin/main \
--checks checks.json \
--intent "Add checkout validation"

默认输出为 .shipgate/receipts//receipt.json 和 summary.md。本地模式为建议性。添加 --ci 以应用项目配置的失败策略。

checks.json 记录观察到的检查结果，且永远不会被执行：

{
"schemaVersion": "1.0",
"checks": [
{
"id": "unit-tests",
"label": "Unit tests",
"status": "passed",
"command": "pnpm test",
"exitCode": 0
}
]
}

可选的 .shipgate.yml 配置声明必需的检查 ID、已禁用或严重性被覆盖的规则、CI 失败条件以及路径脱敏模式。其详细约定见 DESIGN.md。

GitHub Action

Action 已内置于此目录，会在用户自己的 GitHub runner 中执行，不上传源码或 Receipt。使用时必须让 actions/checkout 拉取完整历史，以便解析 merge base：

name: ShipGate

on:
pull_request:

jobs:
shipgate:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0
- uses: ./shipgate
id: receipt
with:
base: ${{ github.event.pull_request.base.sha }}
checks: checks.json
- uses: actions/upload-artifact@v4
with:
name: shipgate-receipt
path: .shipgate/receipts

Action 输出 receipt-id、outcome、risk-level、receipt-path 和 summary-path。默认会按 .shipgate.yml 的 policy.failOn 在 CI 中失败；传入 fail-in-ci: "false" 可改为建议性模式。

产品边界和验证标准保留在 PROJECT.md 中。

DSH Plugin / DSH 插件

ShipGate 可以作为 DeepSeek Harness bundle 挂载。该插件注入 DSH 的 tools 服务并注册一个工具：shipgate_inspect。它接受显式的 Git base 以及可选的证据/配置/输出路径，然后复用与 CLI 相同的本地 inspect 核心。它从不运行模型提供的命令，也从不上传源代码。

bundle 元数据位于 package.json 中；其补丁为 cordis.patch.yml。按照你的 DSH bundle 工作流安装它，然后至少使用以下内容调用 shipgate_inspect：

{
"base": "origin/main",
"checks": "checks.json",
"ci": true
}

该工具返回回执 ID、结果、风险级别、产物路径以及 Markdown 摘要。ci: false（默认值）使失败的策略结果保持建议性，与 CLI 保持一致。