agent-cli-runtime 0.1.0-alpha.0 → 0.1.0-alpha.1
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/README.md +1 -1
- package/README.zh-CN.md +1 -1
- package/docs/production-readiness.md +3 -3
- package/docs/release-checklist.md +11 -0
- package/docs/release-publish-runbook.md +18 -20
- package/docs/release-report.md +17 -17
- package/docs/ssot.md +7 -5
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -346,7 +346,7 @@ node ./dist/cli/main.js smoke --mode real --agent codex --json
|
|
|
346
346
|
|
|
347
347
|
CI uses a Node.js 20/22/24 matrix for typecheck, lint, tests, build, production dependency audit, package boundary checks, and `npm pack --dry-run`. A separate single-Node release-gates job runs `npm run daemon:verify`, `npm run runtime:safety`, and `npm run dogfood` so the full matrix does not launch redundant installed-package gates. The dogfood, CI, and prepublish paths share the same safety boundary: fixtures, fake CLIs, and real local detection/profile certification are allowed by default; authenticated real agent runs are not launched unless `--allow-real-run` is explicit.
|
|
348
348
|
|
|
349
|
-
For local release-candidate confidence, run `npm run prepublish:check`. It combines typecheck, lint, tests, build, daemon embedding verification, runtime safety verification, dogfood, production audit, package boundary checks, and a pack dry-run. The GitHub Actions `Release Candidate` workflow is manually triggered with `workflow_dispatch`, runs `npm ci`, `npm run ci`, `npm run dogfood`, and `npm run release:candidate -- --out-dir release-candidate`; the generated artifact set includes `agent-cli-runtime-tarball`, `agent-cli-runtime-pack-metadata`, `agent-cli-runtime-package-files`, `agent-cli-runtime-gate-evidence`, and `agent-cli-runtime-release-verification`.
|
|
349
|
+
For local release-candidate confidence, run `npm run prepublish:check`. It combines typecheck, lint, tests, build, daemon embedding verification, runtime safety verification, dogfood, production audit, package boundary checks, and a pack dry-run. The GitHub Actions `Release Candidate` workflow is manually triggered with `workflow_dispatch`, runs `npm ci`, `npm run ci`, `npm run dogfood`, and `npm run release:candidate -- --out-dir release-candidate`; the generated artifact set includes `agent-cli-runtime-tarball`, `agent-cli-runtime-pack-metadata`, `agent-cli-runtime-package-files`, `agent-cli-runtime-gate-evidence`, and `agent-cli-runtime-release-verification`. Version `0.1.0-alpha.0` was published to npm and has a GitHub pre-release at `v0.1.0-alpha.0`; that immutable tarball contains stale pre-publish status text, so `0.1.0-alpha.1` is the corrective alpha candidate. Because release docs are included in the npm package, volatile current-run evidence must stay outside packaged docs under `.release-evidence/` or GitHub Release assets. A real alpha publish requires a fresh release-candidate workflow for the exact commit being published, downloaded artifacts passing `npm run release:verify -- --dir <normalized-artifact-dir>`, and explicit maintainer authorization for `npm publish --tag alpha`.
|
|
350
350
|
|
|
351
351
|
To create a local release-candidate artifact set without publishing, run:
|
|
352
352
|
|
package/README.zh-CN.md
CHANGED
|
@@ -344,7 +344,7 @@ node ./dist/cli/main.js smoke --mode real --agent codex --json
|
|
|
344
344
|
|
|
345
345
|
CI 使用 Node.js 20/22/24 matrix 跑 typecheck、lint、tests、build、production dependency audit、package boundary check 和 `npm pack --dry-run`。`npm run daemon:verify`、`npm run runtime:safety` 和 `npm run dogfood` 放在单 Node 版本 release-gates job 中执行,避免 matrix 重复跑 installed-package gates。dogfood、CI 和 prepublish 的默认边界一致:允许 fixtures、fake CLIs、真实本地 detection/profile certification;不带 `--allow-real-run` 时不启动 authenticated real agent run。
|
|
346
346
|
|
|
347
|
-
本地 release-candidate 置信门禁使用 `npm run prepublish:check`。它会组合 typecheck、lint、tests、build、daemon embedding verification、runtime safety verification、dogfood、production audit、package boundary check 和 pack dry-run。GitHub Actions 的 `Release Candidate` workflow 通过 `workflow_dispatch` 手动触发,执行 `npm ci`、`npm run ci`、`npm run dogfood` 和 `npm run release:candidate -- --out-dir release-candidate`;生成并上传 `agent-cli-runtime-tarball`、`agent-cli-runtime-pack-metadata`、`agent-cli-runtime-package-files`、`agent-cli-runtime-gate-evidence` 和 `agent-cli-runtime-release-verification
|
|
347
|
+
本地 release-candidate 置信门禁使用 `npm run prepublish:check`。它会组合 typecheck、lint、tests、build、daemon embedding verification、runtime safety verification、dogfood、production audit、package boundary check 和 pack dry-run。GitHub Actions 的 `Release Candidate` workflow 通过 `workflow_dispatch` 手动触发,执行 `npm ci`、`npm run ci`、`npm run dogfood` 和 `npm run release:candidate -- --out-dir release-candidate`;生成并上传 `agent-cli-runtime-tarball`、`agent-cli-runtime-pack-metadata`、`agent-cli-runtime-package-files`、`agent-cli-runtime-gate-evidence` 和 `agent-cli-runtime-release-verification`。`0.1.0-alpha.0` 已发布到 npm,并有 `v0.1.0-alpha.0` GitHub pre-release;该不可变 tarball 内含过期的发布前状态说明,所以 `0.1.0-alpha.1` 是修复该文档状态的 alpha candidate。由于 release docs 会进入 npm package,current-run 的易漂移证据必须留在包外的 `.release-evidence/` 或 GitHub Release assets 中。真实 alpha publish 需要先为待发布 commit 触发 fresh release-candidate workflow,下载 artifacts 并通过 `npm run release:verify -- --dir <normalized-artifact-dir>`,再由 maintainer 明确授权执行 `npm publish --tag alpha`。
|
|
348
348
|
|
|
349
349
|
如需在本地生成可审查的 release-candidate artifact set:
|
|
350
350
|
|
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
# Production Readiness
|
|
2
2
|
|
|
3
|
-
Status:
|
|
3
|
+
Status: 0.1.0-alpha.1 corrective alpha candidate; human publish gate required
|
|
4
4
|
Last updated: 2026-06-23
|
|
5
5
|
|
|
6
|
-
This project is still **pre-alpha / developer preview**. P2-11 through P2-13 established release-candidate artifact verification, remote evidence closure, and alpha publish-readiness docs
|
|
6
|
+
This project is still **pre-alpha / developer preview**. P2-11 through P2-13 established release-candidate artifact verification, remote evidence closure, and alpha publish-readiness docs. Version `0.1.0-alpha.0` has since been published to npm and GitHub pre-release `v0.1.0-alpha.0`, but that immutable tarball contains stale pre-publish status text; `0.1.0-alpha.1` is the corrective alpha candidate. P3-1 froze daemon-ready execution-kernel contracts for embedders in [docs/daemon-ready-contract.md](./daemon-ready-contract.md); P3-2 added an executable daemon embedding stability gate for the installed-package fake-CLI path; P3-3 added an installed-package long-lived runtime resource safety gate; P3-4 aligned CI and release-candidate artifacts so those gates are represented in remote release artifacts; P3-5 verified its workflow head SHA through a successful remote release-candidate workflow and downloaded artifact re-verification; P3-6 added a redacted opt-in real smoke evidence format for Codex, Claude Code, and OpenCode while keeping default release gates on detection/profile certification only; P3-7 freezes the API / CLI schema inventory and versioning policy in [docs/api-schema-contract.md](./api-schema-contract.md); P3-8 refreshed remote release-candidate evidence for target SHA `eb8de0f9b1edfa3f94c35a50b31005c5d3c105d4`; P3-9 locked evidence-target release-candidate evidence for target SHA `65fac505ca3eb830a06d8656068cf4ed5f6dd46a`.
|
|
7
7
|
|
|
8
|
-
P3-11 keeps volatile current-head release-candidate evidence out of the npm package. Fresh run ids, artifact ids, artifact digests, tarball shasums, and pack shasums belong under `.release-evidence
|
|
8
|
+
P3-11 keeps volatile current-head release-candidate evidence out of the npm package. Fresh run ids, artifact ids, artifact digests, tarball shasums, and pack shasums belong under `.release-evidence/` or durable GitHub Release assets, while packaged docs keep stable release rules and the human-gated publish packet. The corrective alpha path still does not configure trusted publishing, claim provenance, or add daemon/API server/database/WAL/remote-worker/UI/telemetry/artifact layers.
|
|
9
9
|
|
|
10
10
|
## Local-First Production Definition
|
|
11
11
|
|
|
@@ -1,5 +1,16 @@
|
|
|
1
1
|
# Release Checklist (pre-alpha / developer preview)
|
|
2
2
|
|
|
3
|
+
## 0.1.0-alpha.1 corrective alpha package
|
|
4
|
+
|
|
5
|
+
- [ ] Confirm `package.json` and `package-lock.json` version are `0.1.0-alpha.1`.
|
|
6
|
+
- [ ] Confirm packaged README/docs no longer describe the current package as unpublished or forbid the already-created GitHub pre-release.
|
|
7
|
+
- [ ] Confirm `0.1.0-alpha.0` is treated as immutable historical npm/GitHub Release evidence, not overwritten.
|
|
8
|
+
- [ ] Trigger a fresh Release Candidate workflow for the corrective commit and verify its `headSha` equals that commit.
|
|
9
|
+
- [ ] Download all five release-candidate artifacts and run `npm run release:verify -- --dir <normalized-artifact-dir>`.
|
|
10
|
+
- [ ] Run local gates: `npm run typecheck`, `npm run lint`, `npm test`, `npm run package:check`, and `npm publish --dry-run --ignore-scripts --tag alpha`.
|
|
11
|
+
- [ ] Publish `agent-cli-runtime@0.1.0-alpha.1` only after explicit maintainer authorization and interactive npm authentication.
|
|
12
|
+
- [ ] Create GitHub pre-release `v0.1.0-alpha.1` and attach durable release evidence assets.
|
|
13
|
+
|
|
3
14
|
## P3-11 current-head release candidate evidence boundary
|
|
4
15
|
|
|
5
16
|
- [x] Current-head release evidence uses `.release-evidence/` as the non-package local evidence landing zone.
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
# Alpha Publish Readiness Runbook
|
|
2
2
|
|
|
3
|
-
Status:
|
|
3
|
+
Status: 0.1.0-alpha.1 corrective alpha publish runbook; human publish gate required
|
|
4
4
|
Last updated: 2026-06-23
|
|
5
5
|
|
|
6
|
-
This runbook is a decision and execution checklist for
|
|
6
|
+
This runbook is a decision and execution checklist for `agent-cli-runtime@0.1.0-alpha.1`, the corrective alpha for the stale pre-publish status text shipped in immutable npm version `0.1.0-alpha.0`. It does not create or commit npm credentials and does not configure trusted publishing. Current-head release-candidate run ids, artifact digests, and tarball shasums are recorded outside the npm package under `.release-evidence/` or attached as GitHub Release assets; package docs keep only stable process rules and the human-gated alpha publish boundary.
|
|
7
7
|
|
|
8
8
|
## Decision
|
|
9
9
|
|
|
@@ -12,20 +12,18 @@ Recommended state for the next human gate:
|
|
|
12
12
|
- Package metadata is ready for an alpha package page: `name`, `version`, `description`, `license`, `type`, `bin`, `main`, `types`, `exports`, `files`, `engines`, `repository`, `homepage`, `bugs`, `keywords`, and `publishConfig.tag` are present and intentional.
|
|
13
13
|
- The package root value API remains `createAgentRuntime` only; public TypeScript types are exposed through the root declarations, not as runtime values.
|
|
14
14
|
- The release-candidate workflow remains artifact-only: it creates and verifies the tarball but does not publish and does not require registry credentials.
|
|
15
|
-
- The
|
|
16
|
-
- Current publishable package candidate: `agent-cli-runtime@0.1.0-alpha.
|
|
15
|
+
- The corrective publish must use the `alpha` dist-tag. If npm keeps `latest` on the only available pre-release, record that post-publish state rather than pretending it was removed.
|
|
16
|
+
- Current publishable package candidate: `agent-cli-runtime@0.1.0-alpha.1`.
|
|
17
17
|
- Current-head evidence rule: trigger a fresh release-candidate workflow for the commit being considered, download all five artifacts, run `npm run release:verify -- --dir <normalized-artifact-dir>`, and record the volatile run evidence under `.release-evidence/`.
|
|
18
18
|
- Because this runbook and release report are included in the npm package, do not write current run ids, artifact digests, tarball shasums, or pack shasums into package docs.
|
|
19
19
|
- Before any real publish, confirm the fresh release-candidate workflow head SHA matches the commit being published.
|
|
20
20
|
- Historical P3-9 run `27943672095` only proves target SHA `65fac505ca3eb830a06d8656068cf4ed5f6dd46a`.
|
|
21
21
|
- Do not reuse historical workflow runs as publish evidence for a later commit.
|
|
22
22
|
|
|
23
|
-
##
|
|
23
|
+
## Boundaries
|
|
24
24
|
|
|
25
|
-
- Do not run a real `npm publish` during P3-11.
|
|
26
25
|
- Do not add npm tokens, GitHub tokens, registry credential environment variables, or private auth files.
|
|
27
26
|
- Do not configure real npm trusted publishing during P2-13.
|
|
28
|
-
- Do not publish a GitHub release.
|
|
29
27
|
- Do not add daemon, database, WAL, remote worker, web UI, telemetry, scheduler expansion, or package-root value exports.
|
|
30
28
|
|
|
31
29
|
## Pre-Publish Checks
|
|
@@ -57,8 +55,8 @@ git rev-parse --abbrev-ref HEAD
|
|
|
57
55
|
git rev-parse HEAD
|
|
58
56
|
git rev-parse origin/main
|
|
59
57
|
gh workflow run release-candidate.yml --ref main
|
|
60
|
-
gh run view <
|
|
61
|
-
npm view agent-cli-runtime@0.1.0-alpha.
|
|
58
|
+
gh run view <current-release-candidate-run-id> --json headSha,status,conclusion,url,jobs
|
|
59
|
+
npm view agent-cli-runtime@0.1.0-alpha.1 version --json
|
|
62
60
|
npm dist-tag ls agent-cli-runtime
|
|
63
61
|
```
|
|
64
62
|
|
|
@@ -70,7 +68,7 @@ npm publish --dry-run --ignore-scripts --tag alpha
|
|
|
70
68
|
|
|
71
69
|
The command must report a dry run and must show `tag alpha`. If it reports `latest`, stop and fix the command or metadata before publishing.
|
|
72
70
|
|
|
73
|
-
|
|
71
|
+
Dry-run stop point: stop after `npm publish --dry-run --ignore-scripts --tag alpha` until a maintainer separately authorizes the true publish and fresh current-head release-candidate evidence has passed.
|
|
74
72
|
|
|
75
73
|
## Human Confirmation Points
|
|
76
74
|
|
|
@@ -82,13 +80,13 @@ Before a real publish, a maintainer must confirm:
|
|
|
82
80
|
- `.reference/`, `tests/`, fixtures, raw real CLI output, private paths, token-looking values, and repair backups are absent from the packed files.
|
|
83
81
|
- `dist/index.js` runtime value exports remain limited to `createAgentRuntime`.
|
|
84
82
|
- `dist/index.d.ts` exposes public types without re-exporting storage/parser/store internals as the package-root contract.
|
|
85
|
-
- The alpha tag is intentional and `latest`
|
|
83
|
+
- The alpha tag is intentional. If this is still the only package version and npm also points `latest` at it, document that exact post-publish state.
|
|
86
84
|
- The npm account/package publishing policy is understood: 2FA or an approved token path is required by npm package settings.
|
|
87
85
|
- The publisher accepts the provenance choice below and has the right npm package permissions.
|
|
88
86
|
|
|
89
87
|
## Real Publish Commands
|
|
90
88
|
|
|
91
|
-
|
|
89
|
+
Do not run these commands until the human publish gate is explicitly approved.
|
|
92
90
|
|
|
93
91
|
Manual local publish with interactive npm authentication:
|
|
94
92
|
|
|
@@ -109,19 +107,19 @@ If npm asks for a second factor, complete the interactive 2FA prompt or use the
|
|
|
109
107
|
Immediately after any real publish:
|
|
110
108
|
|
|
111
109
|
```bash
|
|
112
|
-
npm view agent-cli-runtime@0.1.0-alpha.
|
|
110
|
+
npm view agent-cli-runtime@0.1.0-alpha.1 version dist-tags --json
|
|
113
111
|
npm dist-tag ls agent-cli-runtime
|
|
114
112
|
```
|
|
115
113
|
|
|
116
114
|
Expected result:
|
|
117
115
|
|
|
118
|
-
- `alpha` points to `0.1.0-alpha.
|
|
119
|
-
- `latest` is absent
|
|
116
|
+
- `alpha` points to `0.1.0-alpha.1`.
|
|
117
|
+
- `latest` is absent, points to a stable version, or is explicitly documented as pointing to the only published pre-alpha version if npm does not allow removing it.
|
|
120
118
|
|
|
121
119
|
If the wrong tag is attached but the package version itself is acceptable, fix the tag rather than republishing the same version:
|
|
122
120
|
|
|
123
121
|
```bash
|
|
124
|
-
npm dist-tag add agent-cli-runtime@0.1.0-alpha.
|
|
122
|
+
npm dist-tag add agent-cli-runtime@0.1.0-alpha.1 alpha
|
|
125
123
|
npm dist-tag rm agent-cli-runtime latest
|
|
126
124
|
npm dist-tag ls agent-cli-runtime
|
|
127
125
|
```
|
|
@@ -170,7 +168,7 @@ If real publish fails before package creation:
|
|
|
170
168
|
|
|
171
169
|
- Capture the redacted error class only.
|
|
172
170
|
- Do not commit npm debug logs if they contain local paths, auth state, or registry session details.
|
|
173
|
-
- Re-run `npm view agent-cli-runtime@0.1.0-alpha.
|
|
171
|
+
- Re-run `npm view agent-cli-runtime@0.1.0-alpha.1 version --json` before retrying to confirm the version was not created.
|
|
174
172
|
|
|
175
173
|
If real publish succeeds but post-publish checks fail:
|
|
176
174
|
|
|
@@ -180,13 +178,13 @@ If real publish succeeds but post-publish checks fail:
|
|
|
180
178
|
- If the package is unsafe and still eligible under npm policy, consider unpublish only as an emergency path:
|
|
181
179
|
|
|
182
180
|
```bash
|
|
183
|
-
npm unpublish agent-cli-runtime@0.1.0-alpha.
|
|
181
|
+
npm unpublish agent-cli-runtime@0.1.0-alpha.1
|
|
184
182
|
```
|
|
185
183
|
|
|
186
184
|
Unpublish has strict policy limits and cannot make the same `name@version` reusable. If unpublish is not allowed or would break consumers, prefer deprecation:
|
|
187
185
|
|
|
188
186
|
```bash
|
|
189
|
-
npm deprecate agent-cli-runtime@0.1.0-alpha.
|
|
187
|
+
npm deprecate agent-cli-runtime@0.1.0-alpha.1 "Do not use this alpha; upgrade to a later pre-release."
|
|
190
188
|
```
|
|
191
189
|
|
|
192
190
|
## Rollback Boundary
|
|
@@ -198,4 +196,4 @@ Rollback means one of these actions:
|
|
|
198
196
|
- Unpublish only when npm policy allows it and a maintainer accepts the registry impact.
|
|
199
197
|
- Publish a new corrected pre-release version.
|
|
200
198
|
|
|
201
|
-
Rollback does not mean overwriting `agent-cli-runtime@0.1.0-alpha.
|
|
199
|
+
Rollback does not mean overwriting `agent-cli-runtime@0.1.0-alpha.1`; npm does not permit replacing an already published package version.
|
package/docs/release-report.md
CHANGED
|
@@ -1,17 +1,17 @@
|
|
|
1
|
-
# Release Report: 0.1.0-alpha.
|
|
1
|
+
# Release Report: 0.1.0-alpha.1 corrective alpha candidate
|
|
2
2
|
|
|
3
|
-
Status:
|
|
3
|
+
Status: Post-publish documentation repair candidate with non-package release evidence
|
|
4
4
|
Last updated: 2026-06-23
|
|
5
5
|
|
|
6
|
-
This report records release-candidate, alpha publish-readiness, daemon-ready contract hardening, P3-6 real CLI opt-in smoke evidence, P3-7 API / CLI schema freeze evidence,
|
|
6
|
+
This report records release-candidate, alpha publish-readiness, daemon-ready contract hardening, P3-6 real CLI opt-in smoke evidence, P3-7 API / CLI schema freeze evidence, the P3-11 non-package evidence boundary, and the corrective alpha path for `agent-cli-runtime@0.1.0-alpha.1`. Immutable npm version `0.1.0-alpha.0` was published and has GitHub pre-release `v0.1.0-alpha.0`, but its package docs contain stale pre-publish status text; `0.1.0-alpha.1` is the repair release candidate.
|
|
7
7
|
|
|
8
8
|
## Verdict
|
|
9
9
|
|
|
10
10
|
P3-7 freezes the public root boundary, daemon-facing CLI JSON schema inventory, version bump policy, and failure taxonomy in [docs/api-schema-contract.md](./api-schema-contract.md), with drift tests tying the docs to source-level schema/failure vocabularies.
|
|
11
11
|
|
|
12
|
-
P3-11 moves current-head release-candidate run evidence out of packaged docs: volatile run ids, artifact ids, artifact digests, tarball shasums, and pack shasums belong under `.release-evidence
|
|
12
|
+
P3-11 moves current-head release-candidate run evidence out of packaged docs: volatile run ids, artifact ids, artifact digests, tarball shasums, and pack shasums belong under `.release-evidence/` or durable GitHub Release assets. Packaged docs keep stable rules only: trigger a fresh release-candidate workflow for the commit being considered, download all five artifacts, run `npm run release:verify -- --dir <normalized-artifact-dir>`, verify the workflow head SHA equals that commit, and run `npm publish --dry-run --ignore-scripts --tag alpha` before any separately authorized real publish.
|
|
13
13
|
|
|
14
|
-
It preserves the
|
|
14
|
+
It preserves the product boundary: no trusted publishing setup, no committed npm token, no daemon/API server, no database/WAL, no remote worker, no UI/telemetry layer, and no authenticated real agent run in default gates. Historical P3-9 run `27943672095` only proves target SHA `65fac505ca3eb830a06d8656068cf4ed5f6dd46a`; Historical P3-9 interim run `27942743285` only proves target SHA `a0299a7d81bb614661922bebc8c75496cf0a3d11` before the strict `fixtures?` package-boundary lock; historical P3-8 run `27940814340` only proves target SHA `eb8de0f9b1edfa3f94c35a50b31005c5d3c105d4`; historical P3-5 run `27932628093` only proves workflow head SHA `8d7bc2a19c626caa1ad5223acbcd35df34aff18e`; historical P2-12 run `27869580048` only proves commit `2f8832119b4ebdb8393077052560589a398ebf56`. The package remains a pre-alpha developer preview, does not claim a stable API, and does not claim OpenDesign daemon parity.
|
|
15
15
|
|
|
16
16
|
## P3-11 Current-Head Evidence Boundary
|
|
17
17
|
|
|
@@ -118,17 +118,17 @@ Downloaded artifact re-verification result:
|
|
|
118
118
|
- gate evidence flags: `noAuthenticatedRealRun: true`, `noNpmPublish: true`, `noNpmToken: true`
|
|
119
119
|
- package file review: 151 entries and no `.reference/`, `tests/`, fixture paths, raw real CLI output, private paths, token-looking values, Bearer values, or auth env assignments.
|
|
120
120
|
|
|
121
|
-
##
|
|
121
|
+
## 0.1.0-alpha.1 Corrective Alpha Publish Packet
|
|
122
122
|
|
|
123
|
-
Current package candidate: `agent-cli-runtime@0.1.0-alpha.
|
|
123
|
+
Current package candidate: `agent-cli-runtime@0.1.0-alpha.1`.
|
|
124
124
|
|
|
125
|
-
|
|
125
|
+
Dry-run checkpoint before a separately authorized publish:
|
|
126
126
|
|
|
127
127
|
```bash
|
|
128
128
|
npm publish --dry-run --ignore-scripts --tag alpha
|
|
129
129
|
```
|
|
130
130
|
|
|
131
|
-
|
|
131
|
+
The real publish commands below must not be executed unless the user gives explicit publish authorization for this immutable version:
|
|
132
132
|
|
|
133
133
|
```bash
|
|
134
134
|
npm publish --tag alpha
|
|
@@ -138,12 +138,12 @@ npm publish --tag alpha --access public
|
|
|
138
138
|
Before any future real publish, a maintainer must manually confirm:
|
|
139
139
|
|
|
140
140
|
- `git rev-parse HEAD` and `git rev-parse origin/main` still match the intended reviewed SHA.
|
|
141
|
-
- After committing this
|
|
142
|
-
- Do not use run `27945938663` as
|
|
141
|
+
- After committing this corrective package-doc update, trigger a fresh `.github/workflows/release-candidate.yml` run for the new commit and verify that `gh run view <new-run-id> --json headSha,status,conclusion,url,jobs` shows that exact commit SHA and success.
|
|
142
|
+
- Do not use run `27945938663` or run `27998762396` as final publish evidence for a later corrective commit; each run proves only its own workflow `headSha`.
|
|
143
143
|
- `npm run typecheck`, `npm run lint`, `npm test`, `npm run build`, `npm run package:check`, `npm run dogfood`, `npm run daemon:verify`, `npm run runtime:safety`, `npm run release:candidate -- --out-dir <tmp>`, `npm run release:verify -- --dir <tmp>`, `npm audit --omit=dev`, `npm pack --dry-run --json --ignore-scripts`, `npm publish --dry-run --ignore-scripts --tag alpha`, `node ./dist/cli/main.js agents --json`, `node ./dist/cli/main.js doctor --json`, and `git diff --check` pass.
|
|
144
144
|
- `npm publish --dry-run --ignore-scripts --tag alpha` reports dry-run mode and `tag alpha`; if it reports `latest`, stop.
|
|
145
|
-
- `npm view agent-cli-runtime@0.1.0-alpha.
|
|
146
|
-
- `npm dist-tag ls agent-cli-runtime`
|
|
145
|
+
- `npm view agent-cli-runtime@0.1.0-alpha.1 version --json` does not show an already-created immutable version before publish.
|
|
146
|
+
- `npm dist-tag ls agent-cli-runtime` is captured after publish; if npm keeps `latest` on the only published pre-alpha version, record the exact tag state.
|
|
147
147
|
- npm 2FA or the package's configured publish policy is ready for the maintainer account.
|
|
148
148
|
- Trusted publishing is not configured for P3-10. A future trusted-publishing path would need a separate publish workflow, npm-side trusted publisher configuration, and explicit `id-token: write`; none of that is present in this release-candidate workflow.
|
|
149
149
|
- Manual local publish must not claim GitHub Actions provenance. Provenance is a future trusted-publishing concern, not a P3-10 dry-run claim.
|
|
@@ -151,15 +151,15 @@ Before any future real publish, a maintainer must manually confirm:
|
|
|
151
151
|
Post-publish checks for a separately authorized future publish:
|
|
152
152
|
|
|
153
153
|
```bash
|
|
154
|
-
npm view agent-cli-runtime@0.1.0-alpha.
|
|
154
|
+
npm view agent-cli-runtime@0.1.0-alpha.1 version dist-tags --json
|
|
155
155
|
npm dist-tag ls agent-cli-runtime
|
|
156
156
|
```
|
|
157
157
|
|
|
158
158
|
Rollback boundary:
|
|
159
159
|
|
|
160
|
-
- If only the dist-tag is wrong, use `npm dist-tag add agent-cli-runtime@0.1.0-alpha.
|
|
161
|
-
- If package contents are wrong, publish a new corrected pre-release version; npm does not allow overwriting `agent-cli-runtime@0.1.0-alpha.
|
|
162
|
-
- Use `npm unpublish agent-cli-runtime@0.1.0-alpha.
|
|
160
|
+
- If only the dist-tag is wrong, use `npm dist-tag add agent-cli-runtime@0.1.0-alpha.1 alpha` and, only after confirming it points at an unintended pre-alpha, `npm dist-tag rm agent-cli-runtime latest`.
|
|
161
|
+
- If package contents are wrong, publish a new corrected pre-release version; npm does not allow overwriting `agent-cli-runtime@0.1.0-alpha.1`.
|
|
162
|
+
- Use `npm unpublish agent-cli-runtime@0.1.0-alpha.1` only if npm policy allows it and a maintainer accepts the registry impact; otherwise deprecate the bad version.
|
|
163
163
|
|
|
164
164
|
## P3-7 API / CLI Schema Freeze
|
|
165
165
|
|
package/docs/ssot.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# 本地 Coding Agent CLI Runtime SSOT
|
|
2
2
|
|
|
3
|
-
状态:
|
|
3
|
+
状态:0.1.0-alpha.1 corrective alpha candidate,current-head release evidence 保持包外记录
|
|
4
4
|
负责人:local project
|
|
5
5
|
最后更新:2026-06-23
|
|
6
6
|
主要语言:中文;API 名、CLI 名、模型名、协议名、错误码、代码标识符等技术关键词保留英文。
|
|
@@ -23,11 +23,13 @@ Runtime 不重新实现 agent loop。模型调用、规划、工具执行、权
|
|
|
23
23
|
|
|
24
24
|
从 OpenDesign 抽取的是 adapter/runtime 边界,而不是整套 OpenDesign daemon、design workspace、plugin system、media pipeline、web UI、artifact model 或 skill marketplace。
|
|
25
25
|
|
|
26
|
-
当前
|
|
26
|
+
当前 `0.1.0-alpha.1` corrective alpha candidate 在 P3-2/P3-3 daemon-ready installed-package gates、P3-4/P3-5 CI / release-candidate artifact evidence、P3-6 real smoke evidence format、P3-7 API / CLI schema freeze、P3-8 target-SHA remote evidence、P3-9 final alpha dry-run evidence、P3-10 pre-documentation release evidence 之上。
|
|
27
27
|
|
|
28
|
-
P3-11
|
|
28
|
+
P3-11 current-head evidence boundary 继续约束 corrective alpha candidate:易漂移发布证据必须留在包外,并且每个 workflow run 只证明自己的 `headSha`。
|
|
29
29
|
|
|
30
|
-
P3-
|
|
30
|
+
P3-11 的核心边界是把 current-head release-candidate 的易漂移证据移出 npm package:当前 run id、artifact id、artifact digest、tarball shasum、npm pack shasum、下载归一化路径和本地命令摘录写入 `.release-evidence/` 或作为 GitHub Release assets 长期保留,包内 README/docs 只保留稳定发布规则、artifact 名称、验证命令、dry-run 边界、人工发布门禁和历史证据的 historical-only 说明。`package:check` 与 `release:verify` 均拒绝 `.release-evidence/` 出现在 npm pack metadata 中。fresh release-candidate workflow 只证明它自己的 `headSha`;`npm publish --dry-run --ignore-scripts --tag alpha` 只是 dry-run,不是真实发布。
|
|
31
|
+
|
|
32
|
+
`0.1.0-alpha.0` 已发布到 npm,并创建了 GitHub pre-release `v0.1.0-alpha.0`;该不可变 tarball 内含过期的发布前状态说明,所以 `0.1.0-alpha.1` 是修复该状态说明的 corrective alpha candidate。`0.1.0-alpha.1` 发布前必须触发 fresh release-candidate workflow,下载五个 artifacts,执行 `npm run release:verify -- --dir <normalized-artifact-dir>` 并确认 workflow `headSha` 等于待发布 commit。P3-10/P3-11 及更早 workflow run 只证明各自的历史 `headSha`,不得作为 corrective commit 的发布证据。P3-7 的 schema inventory、version bump policy、public root boundary 和 failure taxonomy 入口是 [docs/api-schema-contract.md](./api-schema-contract.md)。HTTP/API、auth、tenant/team、queue admission、remote worker、UI/artifact、telemetry、database/WAL 仍由上层负责。具体嵌入契约见 [docs/daemon-ready-contract.md](./daemon-ready-contract.md)。
|
|
31
33
|
|
|
32
34
|
## 2. OpenDesign 参考基线
|
|
33
35
|
|
|
@@ -1123,7 +1125,7 @@ agent-runtime smoke --mode real --agent codex --allow-real-run --expect-text <sa
|
|
|
1123
1125
|
### P2-13:Alpha Publish Readiness Decision
|
|
1124
1126
|
|
|
1125
1127
|
- P2-13 不新增 runtime API;目标是把 alpha 发布前的 package metadata、npm dry-run、2FA/token/provenance/trusted-publishing 策略、dist-tag、rollback 和 runbook 做成可审查的决策包。
|
|
1126
|
-
-
|
|
1128
|
+
- P2-13 当时只做 publish readiness decision,没有执行真实 `npm publish`、没有创建 npm token、没有配置 npm trusted publishing、没有创建 GitHub release,也没有执行 authenticated real agent run。
|
|
1127
1129
|
- `package.json` 发布 metadata 补齐到 npm 用户可用的最小完整集合:`repository`、`homepage`、`bugs` 与既有 `name`、`version`、`description`、`license`、`type`、`bin`、`main`、`types`、`exports`、`files`、`engines`、`keywords`、`publishConfig.tag: "alpha"` 一起接受 contract test 覆盖。
|
|
1128
1130
|
- Package root value export 继续只承诺 `createAgentRuntime`;public types 仍通过 package root declarations 暴露,不扩大 runtime value API。
|
|
1129
1131
|
- 新增 `docs/release-publish-runbook.md`,记录 `npm publish --dry-run --ignore-scripts --tag alpha`、未来真人确认后的 `npm publish --tag alpha`、2FA、trusted publishing/provenance、token 策略、dist-tag 检查、rollback/deprecation/unpublish 边界,以及版本不可覆盖规则。
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agent-cli-runtime",
|
|
3
|
-
"version": "0.1.0-alpha.
|
|
3
|
+
"version": "0.1.0-alpha.1",
|
|
4
4
|
"description": "Local-first TypeScript runtime for scheduling Codex CLI, Claude Code, OpenCode, and compatible coding-agent CLIs.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "Apache-2.0",
|