@haiyangbg/buildbeat 2.0.1 → 2.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +6 -0
- package/docs/CAPABILITY-MATRIX.md +2 -2
- package/docs/CLI.md +3 -2
- package/docs/README.md +3 -1
- package/docs/RELEASING.md +1 -1
- package/example/.buildbeat/manifest.json +1 -1
- package/package.json +14 -1
- package/docs/BuildBeat v2/357/274/232AI /345/216/237/347/224/237/350/275/257/344/273/266/344/272/244/344/273/230/346/216/247/345/210/266/345/271/263/351/235/242.md" +0 -2053
- package/docs/CLI-PILOT-2026-08-23.md +0 -25
- package/docs/CLI-STRATEGY-2026-08.md +0 -55
- package/docs/EXECUTION-PLAN.md +0 -487
- package/docs/PHASE1-PILOT-2026-08-24.md +0 -32
- package/docs/PHASE2-BUILDBEAT-PILOT-2026-08-25.md +0 -75
- package/docs/PHASE2-PILOT-2026-08-25.md +0 -88
- package/docs/PHASE2-PILOT-PREFLIGHT-2026-08-25.md +0 -42
- package/docs/PHASE4-STABILITY-AUDIT-2026-08-25.md +0 -35
- package/docs/PHASE4-V1.20-PILOT-2026-08-25.md +0 -56
- package/docs/ROADMAP.md +0 -875
- package/docs/V1.21-RELEASE-EVIDENCE-2026-08-25.md +0 -55
- package/docs/V2-D2-DECISION-CARD.md +0 -37
- package/docs/V2-DECISIONS.md +0 -11
- package/docs/V2-ITERATION-01.md +0 -60
- package/docs/V2-ITERATION-02.md +0 -32
- package/docs/V2-ITERATION-03.md +0 -30
- package/docs/V2-ITERATION-04.md +0 -29
- package/docs/V2-ITERATION-05.md +0 -20
- package/docs/V2-ITERATION-06.md +0 -18
- package/docs/V2-ITERATION-07.md +0 -36
- package/docs/V2-ITERATION-08.md +0 -62
- package/docs/V2-PLAN.md +0 -335
- package/docs/V2-PROPOSAL.md +0 -319
- package/docs/V2.0.0-BETA.1-RELEASE-EVIDENCE-2026-08-28.md +0 -41
- package/docs/V2.0.0-BETA.2-RELEASE-EVIDENCE-2026-08-28.md +0 -8
- package/docs/V2.0.0-BETA.3-RELEASE-EVIDENCE-2026-09-01.md +0 -8
- package/docs/V2.0.0-BETA.4-RELEASE-EVIDENCE-2026-09-03.md +0 -9
- package/docs/V2.0.0-BETA.5-RELEASE-EVIDENCE-2026-09-05.md +0 -10
- package/docs/V2.0.0-RELEASE-EVIDENCE-2026-09-05.md +0 -11
- package/docs/WP4.3-RELEASE-EVIDENCE-2026-08-25.md +0 -73
- package/docs/v2/M1-ACCEPTANCE-2026-08-28.md +0 -38
- package/docs/v2/M2-DOD-2026-08-28.md +0 -34
- package/docs/v2/M4-EXTERNAL-PILOT-2026-08-28.md +0 -46
- package/docs/v2/M4-PILOT-APP-2026-08-28.md +0 -44
- package/docs/v2/M4-SELFHOST-2026-08-28.md +0 -53
package/CHANGELOG.md
CHANGED
|
@@ -2,8 +2,14 @@
|
|
|
2
2
|
|
|
3
3
|
> 本项目吃自己的狗粮(红线④:必更 CHANGELOG)。格式循 Keep a Changelog,倒序。
|
|
4
4
|
|
|
5
|
+
## v2.0.2 — 2026-09-09(补丁:npm 包不再携带历史文档)
|
|
6
|
+
|
|
7
|
+
- **npm 包不再携带历史文档**:`package.json` 的 `files` 显式排除发布证据、迭代记录、阶段试点、路线与规划类文件(`docs/*-RELEASE-EVIDENCE-*.md`、`V2-ITERATION-*`、`PHASE*`、`V2-PLAN/PROPOSAL/DECISIONS`、`ROADMAP`、`EXECUTION-PLAN`、`CLI-STRATEGY/PILOT`、`docs/v2/M1/M2/M4-*` 与 v2 长文),它们只留在仓库;现行文档(总入口、v1 CLI 合同与检查、能力矩阵、迁移、发布手册、RFC/SPEC、十件套指南)照常分发。包内 `docs/` 从 61 个文件降到 24 个,压缩包约 497 kB → 362 kB,解压约 1.3 MB → 1.0 MB。安装目录里现行文档指向历史文件的链接会落空,`docs/README.md` 已说明去 GitHub 看。回归:`tests/pack-firstrun.test.sh` 新增两条断言——每份现行文档都在包内、历史文件一个都不在。运行时行为不变。
|
|
8
|
+
|
|
5
9
|
## v2.0.1 — 2026-09-06(补丁:合同与文档同步、`env:` 透传修复、v2 模板与首跑回归、首页重写)
|
|
6
10
|
|
|
11
|
+
> **发布状态**:`@haiyangbg/buildbeat@2.0.1` 已于 2026-09-06 从 `main`(PR #29,merge commit `4b2362f`,tag `v2.0.1`)经 OIDC Trusted Publishing 发布到 dist-tag **`latest`**(run 34032278315,双 job success;所有者授权「发」)。独立回读(直连 npmjs.org):`latest` = 2.0.1、integrity 与本地 dry-run 一致、attestation、隔离安装、`doctor` 有界 JSON、包内 `templates/v2/envelope/` 全过,GitHub Release v2.0.1 标 Latest,证据见 [`docs/V2.0.1-RELEASE-EVIDENCE-2026-09-06.md`](docs/V2.0.1-RELEASE-EVIDENCE-2026-09-06.md)。
|
|
12
|
+
|
|
7
13
|
- **首页与简介(C 批次)**:中英文 README 围绕项目上下文与持续交付重写,暂用“会话随时换,项目接着干”标语;突出 Git 与文件上下文、跨模型/工具/会话/人员接续、多角色协作和交付 Loop,个人使用与团队接力均为适用场景;包与插件简介同步(插件版本 0.2.1 → 0.2.2)。新增中英文跨会话与团队接续指南,区分聊天删除、跨成员交接、运行恢复和跨机器同步;场景示意不冒充实测。README 与快速开始说明新模板随下一个补丁版发布(不再教源码全局安装);角色表收回 SKILL 的产品/全栈/测试三视角,审查归入 Run 内置只读 reviewer;首段补"进度与证据由内核回读";标语改为 H1 下的加粗行。README 检查改为必要入口和中英结构一致性,不再固定旧标题。
|
|
8
14
|
|
|
9
15
|
> 2.0.0 之后的对外说明同步(A 事实与合同 → B 使用路径 → D 防回退 → C 首页),四批各一个 PR(#24、#27、#26、#28)合入 `main`;运行时只有一处行为修复(`env:` 透传),v1 生命周期命令与骨架 `v1.21` 不变;插件 manifest 描述随首页同步,版本升 0.2.2。
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# BuildBeat 能力矩阵 / Capability Matrix
|
|
2
2
|
|
|
3
|
-
> 状态:BuildBeat `@haiyangbg/buildbeat@2.0.
|
|
3
|
+
> 状态:BuildBeat `@haiyangbg/buildbeat@2.0.2`(dist-tag `latest`,2026-09-09;2.0.0 于 2026-09-05 首次把 v2 发到 `latest`)。本页按**产品层次**区分四个可用面:Skill-only 手工路径、v1 生命周期 CLI(`buildbeat`)、v2 运行时(`buildbeat-v2`)、Claude Code 插件;并保留 v1.21 分发合同的原始条目与 legacy npm v0 的边界。源码、registry artifact 与真实项目证据仍分别核验。
|
|
4
4
|
|
|
5
5
|
## 0. 四个可用面
|
|
6
6
|
|
|
@@ -73,7 +73,7 @@ WP4.2 所说的“CLI 三命令”按职责分成三组,不是把 `version`
|
|
|
73
73
|
|
|
74
74
|
- **Skill-only:** first-class and complete for protocol semantics; it does not need a lifecycle manifest or a runtime CLI.
|
|
75
75
|
- **Legacy npm v0:** `solobaton@latest` is frozen on `doctor`, `init/adopt --dry-run`, and version inspection, then deprecated toward the scoped package. Project writes and `upgrade` remain unavailable there.
|
|
76
|
-
- **BuildBeat 2.0.
|
|
76
|
+
- **BuildBeat 2.0.x (current `latest` = 2.0.2):** since `@haiyangbg/buildbeat@2.0.0` (evidence: [`V2.0.0-RELEASE-EVIDENCE-2026-09-05.md`](V2.0.0-RELEASE-EVIDENCE-2026-09-05.md)) one package ships the unchanged v1 lifecycle CLI `buildbeat` and the v2 runtime `buildbeat-v2`; 2.0.1 fixed run-config `env:` passthrough and added `templates/v2/` (evidence: [`V2.0.1-RELEASE-EVIDENCE-2026-09-06.md`](V2.0.1-RELEASE-EVIDENCE-2026-09-06.md)); 2.0.2 only trims historical documents from the tarball. The managed v1 scaffold stays at `v1.21`.
|
|
77
77
|
- **BuildBeat 1.21 (previous stable, 2026-08-25 → 2026-09-05):** `@haiyangbg/buildbeat@1.21.0` was the independently verified canonical scoped distribution before 2.0.0. It keeps the bounded `init/adopt` and schema-2-only mechanical `upgrade` surface established in 1.20, and adds the standard domain-response contract to Skill/scaffold handoffs. Registry availability, provenance, signatures, and exact artifact identity are archived in [`V1.21-RELEASE-EVIDENCE-2026-08-25.md`](V1.21-RELEASE-EVIDENCE-2026-08-25.md) and remain live-recheck requirements for future releases.
|
|
78
78
|
- **Claude Code plugin:** the local marketplace candidate distributes the canonical Skill/templates/docs, not the top-level npm CLI `bin/`; installation evidence does not authorize project writes or npm publication.
|
|
79
79
|
- **Project runtime:** after scaffolding, the Git files and project-local scripts remain independently usable. BuildBeat has no account service, telemetry, remote project database, or hosted agents; the v2 runtime is a local process that orchestrates the commands you configure and never carries a model of its own.
|
package/docs/CLI.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# BuildBeat CLI lifecycle contract
|
|
2
2
|
|
|
3
|
-
Status: **BuildBeat `2.0.
|
|
3
|
+
Status: **BuildBeat `2.0.2` scoped distribution (stable `latest`; the v1 lifecycle CLI `buildbeat` is unchanged, the v2 delivery runtime `buildbeat-v2` ships alongside it — see `docs/v2/guide/`)** · previous independently verified stable `2.0.1` · canonical package `@haiyangbg/buildbeat` · canonical executable `buildbeat` · legacy package `solobaton@1.16.3` remains the independently verified read-only v0 · Node.js 20+ · zero third-party runtime dependencies. The 1.21 release keeps the verified 1.20 lifecycle command and safety boundaries, and adds the standard domain-response contract to the Skill and managed scaffold. The genuine lifecycle version-increment pilot remains archived in [`PHASE4-V1.20-PILOT-2026-08-25.md`](PHASE4-V1.20-PILOT-2026-08-25.md); exact 1.21 registry and supply-chain evidence is archived in [`V1.21-RELEASE-EVIDENCE-2026-08-25.md`](V1.21-RELEASE-EVIDENCE-2026-08-25.md).
|
|
4
4
|
|
|
5
5
|
The CLI does not replace `SKILL.md`. The Skill owns code-aware reasoning, minimal questions, project semantics, and human Gates. The CLI owns deterministic inspection, scaffold mechanics, manifest/hash bookkeeping, and bounded mechanical upgrade in the current scoped distribution. Synchronous file-bus checks remain authoritative in the project-local scripts specified by [`CHECKS.md`](CHECKS.md).
|
|
6
6
|
|
|
@@ -58,6 +58,7 @@ The target command whitelist is intentionally small:
|
|
|
58
58
|
| BuildBeat `1.21.0` | `doctor`, `init`, `adopt`, `upgrade`, `version` | unchanged Phase 0–3 command set; writes remain bounded by the transaction and human-Gate contracts below |
|
|
59
59
|
| BuildBeat `2.0.0` | same `buildbeat` command set; second executable `buildbeat-v2` (run / overview / inbox / status / approve / observe / gc …) | `buildbeat` lifecycle and safety boundaries unchanged; `buildbeat-v2` is the v2 runtime documented in [`v2/guide/README.md`](v2/guide/README.md) and never merges, pushes, deploys or publishes (invariant 20); the managed scaffold version stays `v1.21` (templates unchanged), so `upgrade` reports up-to-date for 1.21 scaffolds; the manifest `cliVersion` is a record, not an upgrade trigger |
|
|
60
60
|
| BuildBeat `2.0.1` | same command sets | patch: run-config `inheritEnv` / `env:` now reach the Shell Adapter through the CLI loader; `templates/v2/` gains `run-config.example.yaml`, `envelope/worker.sh` and prompts; documentation aligned with the parser (worker envelope `severity` + `summary`, P0/P1 block) and with the stable channel; no v1 lifecycle or scaffold change (`v1.21`) |
|
|
61
|
+
| BuildBeat `2.0.2` | same command sets | patch: the npm tarball no longer carries historical documents (release evidence, iteration logs, pilots, plans); current docs still ship; `tests/pack-firstrun.test.sh` guards both; no runtime, v1 lifecycle or scaffold change (`v1.21`) |
|
|
61
62
|
|
|
62
63
|
`help`, `--help`, and `--version` are meta entry points. `diff` and `uninstall` stay reserved and return `command_not_available`; `gate`, `adr`, `standards`, `check`, and other workflow commands are outside the approved CLI scope. HELP text and regression tests must lock this boundary.
|
|
63
64
|
|
|
@@ -139,7 +140,7 @@ Schema 2 is the first write-capable shape targeted by Wave 1:
|
|
|
139
140
|
{
|
|
140
141
|
"schemaVersion": 2,
|
|
141
142
|
"scaffoldVersion": "v1.21",
|
|
142
|
-
"cliVersion": "2.0.
|
|
143
|
+
"cliVersion": "2.0.2",
|
|
143
144
|
"layout": "default",
|
|
144
145
|
"installedAt": "2026-08-24T00:00:00.000Z",
|
|
145
146
|
"files": {
|
package/docs/README.md
CHANGED
|
@@ -29,9 +29,11 @@
|
|
|
29
29
|
|
|
30
30
|
| 类别 | 文件 |
|
|
31
31
|
|---|---|
|
|
32
|
-
| 发布证据 | `V2.0.
|
|
32
|
+
| 发布证据 | `V2.0.1-RELEASE-EVIDENCE-2026-09-06.md`(当前 `latest`)、`V2.0.0-RELEASE-EVIDENCE-2026-09-05.md`、`V2.0.0-BETA.1~5-RELEASE-EVIDENCE-*.md`、`V1.21-RELEASE-EVIDENCE-2026-08-25.md`、`WP4.3-RELEASE-EVIDENCE-2026-08-25.md` |
|
|
33
33
|
| v2 规划与决策 | [`V2-PLAN.md`](V2-PLAN.md)(执行基线,已交付)、[`V2-PROPOSAL.md`](V2-PROPOSAL.md)、[`V2-DECISIONS.md`](V2-DECISIONS.md)、[`V2-D2-DECISION-CARD.md`](V2-D2-DECISION-CARD.md)、[《BuildBeat v2:AI 原生软件交付控制平面》](BuildBeat%20v2%EF%BC%9AAI%20%E5%8E%9F%E7%94%9F%E8%BD%AF%E4%BB%B6%E4%BA%A4%E4%BB%98%E6%8E%A7%E5%88%B6%E5%B9%B3%E9%9D%A2.md) |
|
|
34
34
|
| v2 迭代与里程碑记录 | `V2-ITERATION-01~08.md`、[`v2/`](v2/) 下的 M1/M2/M4 验收与试点记录 |
|
|
35
35
|
| v1 路线与阶段试点 | [`ROADMAP.md`](ROADMAP.md)、[`EXECUTION-PLAN.md`](EXECUTION-PLAN.md)、`PHASE1/2/4-*.md`、[`CLI-STRATEGY-2026-08.md`](CLI-STRATEGY-2026-08.md)、[`CLI-PILOT-2026-08-23.md`](CLI-PILOT-2026-08-23.md)、[`PHASE4-STABILITY-AUDIT-2026-08-25.md`](PHASE4-STABILITY-AUDIT-2026-08-25.md) |
|
|
36
36
|
|
|
37
37
|
历史文件里的版本号、通道与测试数字是它们日期当天的事实,出现"`latest` 留 v1"之类的旧策略是正常的;判断现状只看现行文档与 registry 回读(`npm view @haiyangbg/buildbeat dist-tags`)。
|
|
38
|
+
|
|
39
|
+
历史文件只保存在 GitHub 仓库里,不随 npm 包分发(`package.json` 的 `files` 显式排除);从安装目录点开现行文档里指向历史文件的链接会落空,到 [`HaiYangBG1/BuildBeat`](https://github.com/HaiYangBG1/BuildBeat/tree/main/docs) 看即可。现行文档全部随包分发,`tests/pack-firstrun.test.sh` 守着这两条边界。
|
package/docs/RELEASING.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
This runbook governs BuildBeat's public npm distribution. The canonical package is `@haiyangbg/buildbeat` in `HaiYangBG1/BuildBeat`; the canonical executable is `buildbeat`, while `solobaton` remains an executable alias. The old `solobaton` npm package is a frozen legacy distribution ID and must not receive the scoped write/upgrade command surface.
|
|
4
4
|
|
|
5
|
-
Release evidence at source package version `@haiyangbg/buildbeat@2.0.
|
|
5
|
+
Release evidence at source package version `@haiyangbg/buildbeat@2.0.2`; latest independently verified BuildBeat npm distribution `@haiyangbg/buildbeat@2.0.1` (dist-tag `latest`; `next` stays `2.0.0-beta.5`), anchored by annotated tag `v2.0.1` at commit `4b2362f`, workflow run [34032278315](https://github.com/HaiYangBG1/BuildBeat/actions/runs/34032278315), and archived in [`V2.0.1-RELEASE-EVIDENCE-2026-09-06.md`](V2.0.1-RELEASE-EVIDENCE-2026-09-06.md). The 2.0.0 chain (`latest` from 2026-09-05 until 2.0.1 took over on 2026-09-06) stays archived in [`V2.0.0-RELEASE-EVIDENCE-2026-09-05.md`](V2.0.0-RELEASE-EVIDENCE-2026-09-05.md). The beta.5 chain stays archived in [`V2.0.0-BETA.5-RELEASE-EVIDENCE-2026-09-05.md`](V2.0.0-BETA.5-RELEASE-EVIDENCE-2026-09-05.md). The beta.4 chain stays archived in [`V2.0.0-BETA.4-RELEASE-EVIDENCE-2026-09-03.md`](V2.0.0-BETA.4-RELEASE-EVIDENCE-2026-09-03.md); the beta.3 chain in [`V2.0.0-BETA.3-RELEASE-EVIDENCE-2026-09-01.md`](V2.0.0-BETA.3-RELEASE-EVIDENCE-2026-09-01.md). The beta.2 chain stays archived in [`V2.0.0-BETA.2-RELEASE-EVIDENCE-2026-08-28.md`](V2.0.0-BETA.2-RELEASE-EVIDENCE-2026-08-28.md); the beta.1 chain stays archived in [`V2.0.0-BETA.1-RELEASE-EVIDENCE-2026-08-28.md`](V2.0.0-BETA.1-RELEASE-EVIDENCE-2026-08-28.md). The previous stable distribution, `@haiyangbg/buildbeat@1.21.0` (`latest` from 2026-08-25 until 2.0.0 took over on 2026-09-05), stays anchored by annotated tag `v1.21.0` at commit `ce69a05`, workflow run [32864438692](https://github.com/HaiYangBG1/BuildBeat/actions/runs/32864438692), and the matching [GitHub Release](https://github.com/HaiYangBG1/BuildBeat/releases/tag/v1.21.0). Its exact registry identity, provenance, signatures, isolated-install readback, Environment approval, and immutable-artifact boundary are archived in [`V1.21-RELEASE-EVIDENCE-2026-08-25.md`](V1.21-RELEASE-EVIDENCE-2026-08-25.md). First-scoped-release bootstrap behavior and legacy deprecation remain archived in [`WP4.3-RELEASE-EVIDENCE-2026-08-25.md`](WP4.3-RELEASE-EVIDENCE-2026-08-25.md). The legacy distribution remains `solobaton@1.16.3`; all three published legacy versions are retained and deprecated toward the scoped package.
|
|
6
6
|
|
|
7
7
|
## Channels and branches
|
|
8
8
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@haiyangbg/buildbeat",
|
|
3
|
-
"version": "2.0.
|
|
3
|
+
"version": "2.0.2",
|
|
4
4
|
"description": "BuildBeat: Git-based AI delivery across models, tools, sessions, and people, with context in project files, build-test-review-fix loops, and human decisions.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -11,6 +11,19 @@
|
|
|
11
11
|
"files": [
|
|
12
12
|
"bin/",
|
|
13
13
|
"docs/",
|
|
14
|
+
"!docs/*-RELEASE-EVIDENCE-*.md",
|
|
15
|
+
"!docs/V2-ITERATION-*.md",
|
|
16
|
+
"!docs/V2-PLAN.md",
|
|
17
|
+
"!docs/V2-PROPOSAL.md",
|
|
18
|
+
"!docs/V2-DECISIONS.md",
|
|
19
|
+
"!docs/V2-D2-DECISION-CARD.md",
|
|
20
|
+
"!docs/BuildBeat v2*.md",
|
|
21
|
+
"!docs/v2/M[124]-*.md",
|
|
22
|
+
"!docs/ROADMAP.md",
|
|
23
|
+
"!docs/EXECUTION-PLAN.md",
|
|
24
|
+
"!docs/PHASE*.md",
|
|
25
|
+
"!docs/CLI-STRATEGY-2026-08.md",
|
|
26
|
+
"!docs/CLI-PILOT-2026-08-23.md",
|
|
14
27
|
"example/",
|
|
15
28
|
"src/",
|
|
16
29
|
"templates/",
|