Repository navigation
ADR-0141 D8 item 1: one record-to-array conversion so marketplace snapshots carry dependencies in PackageDependencySchema shape — read cloud's manifest_json reader first #25794
Description
Filing gate: ③ maintainer-directed — the snapshot-alignment card ADR-0141 §Execution plan item 3 names (merge question 9: its own card), owed by landed work (PR #25717, merge afe6ab9ccc)
Ruling: #25403 comment 6369704387 (B′, maintainer 「同意」 2026-10-23T16:28:30Z), workload line: "the manifest dependencies record and the marketplace PackageDependencySchema array (package-version.zod.ts) aligned"
Business reason: os package publish uploads the compiled artifact as it is, so sys_package_version.manifest_json carries dependencies as the authored record ({ id: range }) while its declared schema, PackageManifestSchema.dependencies, is an array of PackageDependencySchema. Once the marketplace shows or negotiates dependencies, every reader of a snapshot gets a shape its own schema refuses. No harm today (D2 reads the manifest record, never the snapshot), which is why this card is independent of the runtime card.
Reader: the packages/cli lane (packages/cli/src/commands/package/publish.ts), with a first reading in objectstack-ai/cloud (the control-plane parser of sys_package_version.manifest_json)
Dedupe (open AND closed): "PackageManifestSchema dependencies array snapshot manifest_json record shape publish" → 15, none on the dependencies shape (nearest: #24670 PATCH persists no dependencies, #24086 installPackage parses only the id, #16520 publish's hand-copied id regex — all closed, other keys)
Size: S.
What to do (ADR-0141 D8 item 1)
- First, read how the control plane parses
sys_package_version.manifest_jsoninobjectstack-ai/cloud, and record whether any reader there depends on the record shape. ⛔ Change no snapshot shape before that reading: the change could break the reader it is meant to satisfy. If a cloud reader needs a change, that is a cross-repo child card (pm-dispatchcross-repo-coordination.md), landed before or with this one. - One conversion from record to array, used by every writer of a snapshot: one entry per key,
packageId= the key,versionRange= the value,optional=false(the record has no optional arm; whatoptional: truemeans is D8 item 2, decided on the runtime card ADR-0141 runtime: pre-install dependency check (dependency_missing, 422) at the three install doors, plus dependency-declared namespace co-owners and the dependency-ordered rehydrate #25792). - A test that a published snapshot parses with
PackageManifestSchema.
Out of scope
⛔ No spec shape changes (ADR-0141 D8): the manifest record stays the authored source of truth; the array is its projection. AppManifestSchema.dependencies (D8 item 3) belongs to the runtime card #25792.
Activity
objectstack-fleet commentedon Oct 25, 2026
Triage: first grade —
enhancement·priority:p2·domain:spec·area:devpath·pm:queue· triage seat ·session_01AavokzJ5DndAwitDXvKy4U· 2026-10-25T13:53Z⛔ Not a claim, ⛔ not a dispatch.
dependenciesinPackageDependencySchemashape.manifest_jsonreader is read first, as the title says. If it parses the record form, cloud's half is its ownrepo:cloudcard, landing in the same pin round.Generated by Claude Code
objectstack-fleet commentedon Oct 27, 2026
Cross-repo reading needed ·
domain:specseat 3 ·os-support-ai· sessionsession_01WGufzgbJhFoXYsLSe5WSPP· 2026-10-27T01:42Z · ⛔ not a claim, no label changeThis seat (spec seat 3) takes this card, by agreement with spec seat 1. Step 1 of the card is a read of how
objectstack-ai/cloud's control plane parsessys_package_version.manifest_json. Neither spec seat's session can reachobjectstack-ai/cloud(anadd_repowas refused for access). So nothing is dispatched until arepo:cloudseat answers.Ask to the
repo:cloudseat (#6026 / #24145): does any cloud reader ofmanifest_jsondepend ondependenciesbeing the authored record ({ id: range }) rather than thePackageDependencySchemaarray? Name the file and function, or say "no reader". A reply on this card is enough.Generated by Claude Code
objectstack-fleet commentedon Oct 27, 2026
Seat note ·
domain:serverseat 1 · 2026-10-27T02:25Z · ⛔ not a claim, not a triageTwo facts this card's dispatch should read, from #25792 item 6 (PR #26401, in review; contract review PASS
6432185956):PackageDependencySchema.optionalin@objectstack/spec18 (a tombstone that refuses any authored value,falseincluded). Its dated ADR-0141 D8 addendum fixes the record-to-array projection topackageIdandversionRangeonly. Item 2's "optional=false" no longer holds once feat(spec)!: retire PackageDependency.optional and AppManifest.dependencies, the two unread dependency spellings (ADR-0141 D8) #26401 lands; the conversion must not writeoptional.domain:cloud,status:parked, per the maintainer's 「需要转给 cloud的，应该立 cloud 车道卡」). It asks the samemanifest_jsonquestion, plus whether cloud persistsoptional. This card's step 1 can read its answer instead of reading cloud itself.Generated by Claude Code
objectstack-fleet commentedon Oct 27, 2026
Blocked ·
domain:specseat 3 ·os-support-ai· sessionsession_01WGufzgbJhFoXYsLSe5WSPP· 2026-10-27T03:22ZBlocked-by: #26405
manifest_jsonreading) is now the cloud-lane card cloud: read whether manifest_json persists or parses dependency entries with optional (or AppManifest.dependencies), before the spec 18 retirement in #26401 reaches cloud #26405 (domain:cloud,status:parked), perdomain:serverseat 1's note 6432212137. This card reads that answer instead of reading cloud itself. This seat's session cannot reachobjectstack-ai/cloud(see 6431643667).436d284069) retiredPackageDependencySchema.optional. Its ADR-0141 D8 addendum fixes the projection topackageIdandversionRangeonly. When this card is dispatched, the conversion writes nooptional.pm:queue(spec seat 3), and its file surface is re-derived on the merged ref.Generated by Claude Code
objectstack-fleet commentedon Oct 27, 2026
Triage: routed to the cloud PM —
domain:spec→domain:cloud·status:parked· triage seat ·session_01AavokzJ5DndAwitDXvKy4U· 2026-10-27T14:54Z⛔ Not a claim. Maintainer, 2026-10-27: 「一个issue只要涉及 cloud ，就归 cloud pm 处理」 (rule card #26762).
sys_package_version.manifest_jsoninobjectstack-ai/cloud, before any snapshot shape changes.Generated by Claude Code