dev-harness-dsh

Readme

# dev-harness-dsh

## 项目简介
dev-harness-dsh 把 Audit、Auto Fix、验证、QA、最终复核与统一报告编排为可恢复运行；V0、K1、K2、K3、K4、S1、S2、S3、S4 MVP 基线已完成

## 编程语言
JavaScript, TypeScript

## 构建系统
npm / package.json, pnpm

## 核心模块
- src — 生产 Plugin、Human Command、Run Authorization、Audit/Auto Fix/Full Verification/QA/Reconciliation 合同、可恢复 Orchestrator、Run Summary 与原子 Run State
- tests — 生产生命周期、命令、授权、CompletionStatus、提交/验证 boundary、漂移和恢复自动化
- docs/product/REQUIREMENTS.md — MVP 产品边界与验收口径
- docs/plan — 当前状态看板与任务执行层
- docs/integration/DSH_API_BASELINE.md — rc.8 集成事实、证据等级与停止线
- experiments/v0-minimal-plugin — 可构建、可打包的 V0 Plugin/Command、Agent、Workflow、Tool、Skill/worktree 与状态边界实验

## 使用说明
- 开发依赖安装: pnpm install --frozen-lockfile --ignore-scripts
- 构建: npm run harness:build
- 完整验证: npm run harness:full（typecheck + lint + 68 个自动化用例 + build + pack dry-run）
- 本地发布包: python3 release.py（先执行完整验证，再生成 `dist/*.tgz`；不上传 registry）
- 插件安装与启用: [安装指南](docs/how-to/INSTALL.md)
- 运行: N/A

## 使用示例

在带工作区目录的 DSH Session 中执行：

```text
/harness-run fix-only
```

命令返回当前 Run 的权威视图（JSON）：

```json
{
  "runId": "dsh-20260820153000-a1b2c3d4",
  "revision": 3,
  "phase": "AUDIT",
  "status": "RUNNING",
  "authorization": {
    "schemaVersion": 1,
    "autoFix": "fix-only",
    "externalActions": {
      "push": false,
      "pull-request": false,
      "tag": false,
      "release": false,
      "deploy": false
    }
  }
}
```

常用命令：

- `/harness-run [fix-only|commit-each] [qa=<adapter-name>]` — 新建可恢复 Run（默认 `fix-only`）；
- `/harness-status [run-id]` — 查看当前或指定 Run 状态；
- `/harness-resume <run-id>` — 校验工作区与快照一致后恢复 Run（工作区任何变更都会 fail closed）；
- `/harness-cancel [run-id]` — 取消当前或指定 Run（终态 Run 幂等返回）。

完整安装、Skill 准备与卸载步骤见 [安装指南](docs/how-to/INSTALL.md)。

## 变更记录
版本变更见 [CHANGELOG.md](CHANGELOG.md)。当前为 0.1.0 预览期：与 DeepSeek Harness 0.1.0-rc.8 精确锁定，不声明跨 rc 兼容。

## CI
GitHub Actions 工作流见 [.github/workflows/ci.yml](.github/workflows/ci.yml)：push（main）与 pull_request 时运行 `npm run harness:full` 与 V0 fixture 完整验证。

## 构建本地发布包

```shell
python3 release.py
```

脚本先执行 `npm run harness:full`，成功后用禁用生命周期脚本的 `npm pack` 在临时目录构建并校验包名、版本、关键文件、条目数、大小和 SHA-256，最后将包放入 `dist/`。同名包默认不会被覆盖；确认替换时使用 `python3 release.py --force`，自定义目录时使用 `--output-dir <path>`。

该脚本只构建本地 `.tgz`，不会执行 npm registry publish、Git tag、push 或外部 release。