From 09dc7dd3b8414683c011d717236697c597c10777 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=90=B4=E7=BA=A202?= <596540@ky-tech.com.cn> Date: Tue, 13 Oct 2026 14:21:04 +0800 Subject: [PATCH 1/2] =?UTF-8?q?chore:=20v1.7.0=20=E7=89=88=E6=9C=AC?= =?UTF-8?q?=E5=8F=B7=E4=B8=8E=E5=AE=89=E8=A3=85=E9=93=BE=E6=8E=A5=20bump?= =?UTF-8?q?=EF=BC=88sync=20=E5=A5=91=E7=BA=A6=E5=8F=98=E6=9B=B4=E9=A6=96?= =?UTF-8?q?=E6=AC=A1=E8=BF=9B=20release=20=E8=BD=A8=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 2 +- package.json | 2 +- .../20261013-chore-release-v170/brief.md | 93 +++++++++++++++++++ 3 files changed, 95 insertions(+), 2 deletions(-) create mode 100644 shadow-docs/changes/20261013-chore-release-v170/brief.md diff --git a/README.md b/README.md index 97f65de..2a5dc52 100644 --- a/README.md +++ b/README.md @@ -14,7 +14,7 @@ CLI 有两类用途，本文档按此组织： ### 新机器：一条命令装好整个生态 ```bash -curl -fsSL https://raw.githubusercontent.com/stack-wuh/shadow-dev-cli/v1.6.1/scripts/bootstrap.sh | bash -s claude-code +curl -fsSL https://raw.githubusercontent.com/stack-wuh/shadow-dev-cli/v1.7.0/scripts/bootstrap.sh | bash -s claude-code ``` 这条命令做三件事： diff --git a/package.json b/package.json index 8a5d926..3470403 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "shadow-dev-cli", - "version": "1.6.1", + "version": "1.7.0", "description": "Deterministic scaffolding CLI for the Shadow dev workflow: brief lifecycle, plan/execute with plan hashes, git and GitHub operations.", "type": "module", "engines": { diff --git a/shadow-docs/changes/20261013-chore-release-v170/brief.md b/shadow-docs/changes/20261013-chore-release-v170/brief.md new file mode 100644 index 0000000..3eedb41 --- /dev/null +++ b/shadow-docs/changes/20261013-chore-release-v170/brief.md @@ -0,0 +1,93 @@ +--- +{ + "schema": "shadow-dev/v1", + "name": "20261013-chore-release-v170", + "type": "chore", + "scope": null, + "status": "reviewed", + "baseBranch": "main", + "branch": "chore/20261013-chore-release-v170", + "files": [ + "README.md", + "package.json", + "shadow-docs/changes/20261013-chore-release-v170/brief.md" + ], + "github": { + "repository": "stack-wuh/shadow-dev-cli", + "issue": null, + "issueUrl": null, + "pullRequest": null, + "pullRequestUrl": null + }, + "review": { + "conclusion": "passed", + "verifiedCommit": "f72c8dc427d3eb26050cbbc789efda1a091a2245", + "verifiedAt": "2026-10-13T06:20:15.272Z" + }, + "workflow": { + "operation": null, + "checkpoint": null, + "planHash": "a1727b3471a490117a60681e1c04a6bc30a27d9546504b43ca925da8507d2378", + "updatedAt": null, + "lastError": null, + "release": { + "files": [ + "README.md", + "package.json", + "shadow-docs/changes/20261013-chore-release-v170/brief.md" + ], + "message": "chore: v1.7.0 版本号与安装链接 bump（sync 契约变更首次进 release 轨）", + "title": "chore: v1.7.0 版本号与安装链接 bump（sync 契约变更首次进 release 轨）", + "body": "## 变更\n- `package.json`：`version` 1.6.1 → 1.7.0\n- `README.md`：bootstrap 安装 URL 版本段同步 `/v1.7.0/`\n- 载体 brief 自身\n\n## 影响\n- 行为/触发面变化：无实现代码改动，仅把已合并的 `fix(sync)`（PR #70）送进 release 轨\n- 走 release 轨的使用者自此可拿到无 brief 依赖的 `sync`；插件侧 `cliVersion` 自此有版本可 pin\n- 明确不受影响的范围：`lib/**`、`.github/workflows/**`、`scripts/**` 未触碰\n- `test/cli.test.mjs` 里的 `v1.6.1` 字面量是 `assertVersion` 负例入参，与本 bump 无关\n\n## 验证\n- 命令与结果：`git diff --stat` = `README.md | 2 +-`、`package.json | 2 +-`，共 2 文件 2 增 2 删\n- `node -p \"require('./package.json').version\"` = `1.7.0`；README 安装 URL 已指向 `/v1.7.0/`\n- 引用扫描：`git grep -l 'v1.6.1'` 命中 4 文件——3 个归档 brief 留痕 + 1 个测试负例字面量；安装轨零残留\n- 覆盖范围核对：`git rev-list --count v1.6.1..HEAD` 实取 3 提交，对外可见的是 `92515be`（PR #70）\n- bump 位依据：本仓 v1.6.1 载体规则「无命令面变化才走 patch」；本次参数契约有变，故进 minor\n- 未覆盖项（明说）：本机不跑全量 `npm test`（约 270s 超 60s 阈值），由 `test.yml` 的 PR 触发补\n- 未覆盖项（明说）：发布链端到端需 tag 落地才可取证实证，已在 brief 结果段登记为待回填项\n\n## 关联\n- Closes #65（其修复由 PR #70 承载，本 PR 把它送进 release 轨）\n- Refs #59\n- brief: shadow-docs/changes/20261013-chore-release-v170/brief.md" + } + }, + "knowledge": { + "action": "无需变更", + "target": null, + "reason": null + } +} +--- + +# 20261013-chore-release-v170 + +## 动机 + +v1.6.1 之后 main 上合入一项对外可见的契约变更：`fix(sync)` 解除 brief 硬依赖（PR #70，闭合 issue #65）。`sync` 的调用形态变了——`--name` 由必填降为可选、新增 `--base-branch`、新增拒绝码 `SYNC_UPSTREAM_NOT_FOUND`。不打版，走 release 轨的使用者拿不到它，插件侧 `cliVersion` 也无从 pin，`shadow-dev-release` / `shadow-dev-publish` 的 sync 文档就没有可用的版本锚。 + +## 复杂度评级 + +- **评级:** S +- **理由:** 只有两处声明式 bump（`package.json` 的 `version`、`README.md` 的 bootstrap URL 版本段），零实现代码改动、零命令面变化。 +- **期望验证深度:** code-read / field——diff 走查 + 版本一致性 + 引用残留扫描；发布链端到端在 tag 落地后回填。 + +## 覆盖范围 + +- `package.json`：`version` 1.6.1 → 1.7.0。 +- `README.md`：bootstrap 安装 URL 的版本引用同步为 `/v1.7.0/`（打 tag 之前该链接 404 属载体既有时序）。 +- 载体 brief 自身。 + +## 决策 + +- **bump 位 minor 1.7.0，不是 patch**：本仓 v1.6.1 载体写明的规则是「无命令面变化、无破坏性契约变更」才走 patch。本次参数契约有变（`--name` 放宽 + 新增 `--base-branch` + 新增拒绝码），向后兼容但不等于「无变化」，按 semver 进 minor；tag 名与 README 链接同步用 `/v1.7.0/`。 +- 载体只 bump 声明，不碰 `lib/**`；被发布的内容 = 已合并的 `92515be`（fix）+ `f72c8dc`（其归档提交）。 +- 交付判定同 v1.6.1：tag 落地后必须核对 Actions `publish` 成功、`releases/tags/v1.7.0` 恰有一个合法名资产、且资产 uploader 是 `github-actions[bot]`（人工 upload 不算这条链成立）。 + +## 任务 + +- [x] task-1 — `package.json` — version 1.6.1 → 1.7.0 +- [x] task-2 — `README.md` — bootstrap URL 同步 /v1.7.0/ +- [x] task-3 — 观察点 — 差异面只两文件；tag 后核对 publish run 与资产（发版后回填） + +## 结果 + +评级 S，取证形态 code-read / field + 发布链端到端（tag 落地后回填）。 + +- 差异面：`git diff --stat` = `README.md | 2 +-`、`package.json | 2 +-`，共 2 文件 2 增 2 删，无其它文件被牵动；`lib/**` 未被本载体触碰。 +- 版本一致：`node -p "require('./package.json').version"` = `1.7.0`；README 安装 URL 已指向 `/v1.7.0/`。 +- 引用残留（口径更正）：`git grep -l 'v1.6.1'` 实命中 4 个文件，逐类核清——3 个是 `shadow-docs/changes/archive/**` 里的历史 brief（当时发的就是 1.6.1，属留痕不改），1 个是 `test/cli.test.mjs:1217` 的负例字面量 `assertVersion('1.6.0', 'v1.6.1')`（与 package.json 解耦，不随 bump 变）。安装轨（README、package.json、`.github/workflows/**`、`scripts/**`）零残留。我先把它写成「命中 0」，是错口径，此处留痕更正。 +- 覆盖范围核对：`git rev-list --count v1.6.1..HEAD` 实取 3 个提交，其中对外可见的是 `92515be`（fix: sync 解除 brief 硬依赖，PR #70）；另两笔是它的归档提交与本载体 bump，不属内容变更，按规则跳过并在此写明。 +- bump 位判定依据：本仓 v1.6.1 载体的规则原文是「patch：两项修复，无命令面变化、无破坏性契约变更」。本次命令面有变（`--name` 放宽 + 新增 `--base-branch` + 新增 `SYNC_UPSTREAM_NOT_FOUND`），故进 minor。 +- 发布链端到端：待 tag `v1.7.0` 落地后回填（`gh run view` + `releases/tags/v1.7.0` 资产名与 uploader）。 + +**未覆盖项**：本机不跑全量 `npm test`（约 270s > 60s 阈值），由本仓 `test.yml` 的 `pull_request` 触发补跑；S 级零实现改动，风险面仅在两个声明字段。 From d043033ccb779b08de2fa1effbc1b2b51c44e30b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=90=B4=E7=BA=A202?= <596540@ky-tech.com.cn> Date: Tue, 13 Oct 2026 14:21:14 +0800 Subject: [PATCH 2/2] =?UTF-8?q?docs(shadow):=20brief=20=E6=9C=80=E7=BB=88?= =?UTF-8?q?=E6=80=81=E2=80=94=E2=80=94published,=20PR=20#71?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- shadow-docs/changes/20261013-chore-release-v170/brief.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/shadow-docs/changes/20261013-chore-release-v170/brief.md b/shadow-docs/changes/20261013-chore-release-v170/brief.md index 3eedb41..fadf4df 100644 --- a/shadow-docs/changes/20261013-chore-release-v170/brief.md +++ b/shadow-docs/changes/20261013-chore-release-v170/brief.md @@ -4,7 +4,7 @@ "name": "20261013-chore-release-v170", "type": "chore", "scope": null, - "status": "reviewed", + "status": "published", "baseBranch": "main", "branch": "chore/20261013-chore-release-v170", "files": [ @@ -16,8 +16,8 @@ "repository": "stack-wuh/shadow-dev-cli", "issue": null, "issueUrl": null, - "pullRequest": null, - "pullRequestUrl": null + "pullRequest": 71, + "pullRequestUrl": "https://github.com/stack-wuh/shadow-dev-cli/pull/71" }, "review": { "conclusion": "passed", @@ -26,7 +26,7 @@ }, "workflow": { "operation": null, - "checkpoint": null, + "checkpoint": "pr:71", "planHash": "a1727b3471a490117a60681e1c04a6bc30a27d9546504b43ca925da8507d2378", "updatedAt": null, "lastError": null,