Repository navigation
Commit 2b4b970
docs: retire manifest-deps from the plugin-distribution note, re-point two stale plugin-build checklist negatives, correct the liveness manifest cell (#27698)
Fixes #27685
Clause-②: no
Metadata-protocol: none
## 维护者速读
- 改了什么:三处文档对齐 #27679 之后的代码:插件分发设计文档只剩 `bundled` 一种打包策略;cli
检查清单条目的两条过期否定句改指向真正做校验与分发的代码;liveness README 的 `manifest` 单元格改正 dead
集合(19 → 与生成分片一致的 13)并补上 `packaging` 为何是 `planned` 的一句。
- 为什么改:`manifest-deps` 已被移除并按名拒收,文档却仍把它写成可选策略;检查清单仍说「解包时无人复核
integrity」「无人按 runtime 分发」,而 #27123 的前两片已经实现了这两件事;README 的手写计数早已过期。
- 风险与回滚:纯文档,无代码、无 schema 改动;`packages/spec/liveness/README.md` 随 npm
包发布,故带一个 `@objectstack/spec` patch changeset。回滚即 revert 本 PR。
- 先看:`docs/qa/platform-checklist/areas/cli.json`(两条否定句与 revision 5
历史条目)、`packages/spec/liveness/README.md`(`manifest` 行的 dead
集合句)、`docs/design/plugin-distribution.md` §4.3。
- 两分钟验证:`grep -rn "manifest-deps" docs/design/plugin-distribution.md
docs/qa/platform-checklist/areas/cli.json
packages/spec/liveness/README.md`,预期只剩「已退役、按名拒收」的叙述,不再有把它当现行策略的句子。
- 需要你做的:无,席位落地。
## What changes
- **`docs/design/plugin-distribution.md`.** The artifact tree no longer
lists `package.json` / `pnpm-lock.yaml`; the compiled-manifest sentence
gives `packaging` as `bundled` alone; §4.3 is rewritten as "Packaging
strategy: bundled only" with one dated note (in the file's existing note
shape, as in §4.2) saying `manifest-deps` was retired and is refused by
name (#27679, ADR-0025 v2 §3.3); the publish-time tier gate no longer
names `manifest-deps`; §6 step 5 says no dependency install runs at
materialize. One same-class line beyond the claim's list: §8's
supply-chain bullet named a lockfile and `--ignore-scripts`, both of
which existed only for the retired strategy, so it now says no
install-time package manager runs at all. Same file, same defect class,
mechanical.
- **`docs/qa/platform-checklist/areas/cli.json`,
`cli.plugin-manifest-build-contract` only** (revision 4 to 5, history
entry added). The integrity and trust-tier ⛔ negatives said nothing
re-verifies the map at unpack and nothing dispatches on `runtime`. Both
are false since slices 1 and 2 of #27123. Each negative now names the
code that does it as the check this item does NOT score:
`packages/cli/src/commands/plugin/install.ts#PluginInstall` through
`packages/core/src/security/plugin-artifact-integrity.ts#verifyIntegrity`,
and
`packages/runtime/src/installed-plugin-loader.ts#dispatchPluginRuntime`.
The tracker numbers they cited (#11331, #11330) answer 404 in this
repository and are gone from the negatives. Three source rows are added
for that code. Scored clauses and steps are unchanged.
- **`packages/spec/liveness/README.md`, the `manifest` cell only.**
"Dead 19" was a hand-typed count, and it was stale. It counted the seven
per-child rows of `capabilities` / `configuration` instead of their two
tombstone rows, and a `loading` row that left the ledger with #26599.
The cell now partitions the dead set the ledger holds (ten `contributes`
members, plus the three retired containers at one row each) and says it
sums to 13, the count in the generated `state-counts/manifest.md` shard.
It also gains the missing sentence for `packaging`, the type's only
`planned` row.
- **`.changeset/27685-manifest-liveness-cell.md`**: `@objectstack/spec`
patch. `liveness` is in the package's `files`, so the README ships.
## Tests
No code changed, so no unit tests were added and none were run. Nothing
was ablated, because no tested behaviour moved.
## Acceptance notes
- Item 4 of the card
(`ui/packages/app-shell/src/console/marketplace/marketplaceApi.ts:171`)
is untouched, per triage 6504381957. It rides the next `domain:ui` PR
there.
- Not edited, recorded here, no card (stale prose, no reach):
`docs/adr/0025-plugin-package-distribution.md` still names
`manifest-deps` as live at L159 (the manifest example comment), L267
(§3.5 step 5) and L595–596 (the consequences bullet), while its own §3.3
retires it. The ADR is a governed surface and outside this card.
- Not edited, outside this card's passages: `plugin-distribution.md`
says the bundle is built with `tsup` (§4.1 tree, §5 step 1). The build
uses esbuild (`packages/cli/src/commands/plugin/build.ts`; ADR-0025 v2
§3.3 says the same). §4.3 as rewritten names no bundler.
- Coverage observation, no card: no platform-checklist item scores the
install-time integrity refusal or the boot-time tier dispatch. The two
re-pointed negatives now name that code as unscored here.
## Verification
H3: the count is generated, not hand-kept. `pnpm --filter
@objectstack/spec gen:liveness-counts` exited 0 and rewrote 0 shards,
and the committed `state-counts/manifest.md` already reads dead 13 /
planned 1. Only the README prose was stale, so it was corrected from
`liveness/manifest.json`, and no number was typed into the shard.
Gates, derived by `node scripts/pm/dispatch-gates.mjs --commands --repo
objectstack-ai/objectstack` at `8dee70e6bb` (59 commands), every exit
code captured before any pipe:
<details><summary>54 exit 0 · 5 NOT MEASURED (exit 3, PREREQUISITE NOT
MET) · --ran reconciliation 59/59 accounted</summary>
- `--ran` verdict: `✓ dispatch-gates --ran: 59 derived famil(ies)
accounted for — 54 run, 5 NOT-MEASURED (5 DERIVED from a recorded exit
3).`
- `pnpm check:platform-checklist` exit 0: `check-platform-checklist: OK
— 16 areas, 352 items (347 active, 1 planned)` (the three new
`path#symbol` source anchors resolve).
- `pnpm --filter @objectstack/spec run check:liveness` exit 0: `✓
packages/spec/liveness/state-counts/ is current — one shard per governed
type, the same 43 row(s) as the README, no count column left in the
README.`
- `pnpm check:doc-authoring` exit 0 · `pnpm check:nul-bytes` exit 0 ·
`pnpm check:issue-citations` exit 0 · `pnpm check:published-files` exit
0.
- `node scripts/check-adr-0087-registration.mjs --base origin/main` exit
0: `this PR adds no declared-breaking changeset` ·
`check-changeset-no-major` exit 0 · `check-empty-changeset` exit 0.
- NOT MEASURED: `check:doc-formula-expressions` (`@objectstack/formula`
not built), `check:dts-closure`, `check:dual-build-cjs-loads`,
`check:lean-entry-closure` (`@objectstack/objectql` dist absent),
`check:sourcemap-no-sources-content`. Reason: each reads the built dist
of packages this diff does not change, and building the workspace for a
docs-only diff is the declared narrowing. CI's `Lint & Repo Gates` runs
them on a built tree.
- Local-only families `check:dev-prereqs` /
`check:skill-frame-freshness`: not run, because the diff touches neither
the `packages/spec` build nor the four-axis frame files.
</details>
---
_Generated by [Claude
Code](https://claude.ai/code/session_01QSeKYmTYfaPbLQD4BJfomW)_
---------
Co-authored-by: Claude <noreply@anthropic.com>1 parent c5d51f0 commit 2b4b970
4 files changed
Lines changed: 52 additions & 22 deletions
File tree
- .changeset
- docs
- design
- qa/platform-checklist/areas
- packages/spec/liveness
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
111 | 111 | | |
112 | 112 | | |
113 | 113 | | |
114 | | - | |
115 | | - | |
116 | 114 | | |
117 | 115 | | |
118 | 116 | | |
119 | 117 | | |
120 | 118 | | |
121 | 119 | | |
122 | | - | |
| 120 | + | |
123 | 121 | | |
124 | 122 | | |
125 | 123 | | |
| |||
135 | 133 | | |
136 | 134 | | |
137 | 135 | | |
138 | | - | |
139 | | - | |
140 | | - | |
141 | | - | |
142 | | - | |
143 | | - | |
144 | | - | |
145 | | - | |
146 | | - | |
| 136 | + | |
| 137 | + | |
| 138 | + | |
| 139 | + | |
| 140 | + | |
| 141 | + | |
| 142 | + | |
| 143 | + | |
| 144 | + | |
| 145 | + | |
| 146 | + | |
| 147 | + | |
| 148 | + | |
| 149 | + | |
| 150 | + | |
| 151 | + | |
| 152 | + | |
| 153 | + | |
| 154 | + | |
| 155 | + | |
| 156 | + | |
147 | 157 | | |
148 | 158 | | |
149 | 159 | | |
| |||
164 | 174 | | |
165 | 175 | | |
166 | 176 | | |
167 | | - | |
168 | | - | |
| 177 | + | |
| 178 | + | |
169 | 179 | | |
170 | 180 | | |
171 | 181 | | |
| |||
191 | 201 | | |
192 | 202 | | |
193 | 203 | | |
194 | | - | |
195 | | - | |
| 204 | + | |
| 205 | + | |
196 | 206 | | |
197 | 207 | | |
198 | 208 | | |
| |||
242 | 252 | | |
243 | 253 | | |
244 | 254 | | |
245 | | - | |
246 | | - | |
| 255 | + | |
| 256 | + | |
| 257 | + | |
247 | 258 | | |
248 | 259 | | |
249 | 260 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1716 | 1716 | | |
1717 | 1717 | | |
1718 | 1718 | | |
1719 | | - | |
| 1719 | + | |
1720 | 1720 | | |
1721 | 1721 | | |
1722 | 1722 | | |
| |||
1787 | 1787 | | |
1788 | 1788 | | |
1789 | 1789 | | |
1790 | | - | |
1791 | | - | |
| 1790 | + | |
| 1791 | + | |
1792 | 1792 | | |
1793 | 1793 | | |
1794 | 1794 | | |
| |||
1799 | 1799 | | |
1800 | 1800 | | |
1801 | 1801 | | |
| 1802 | + | |
| 1803 | + | |
| 1804 | + | |
1802 | 1805 | | |
1803 | 1806 | | |
1804 | 1807 | | |
| |||
1829 | 1832 | | |
1830 | 1833 | | |
1831 | 1834 | | |
| 1835 | + | |
| 1836 | + | |
| 1837 | + | |
| 1838 | + | |
| 1839 | + | |
| 1840 | + | |
1832 | 1841 | | |
1833 | 1842 | | |
1834 | 1843 | | |
| |||
0 commit comments