Skip to content

feat(objectql): adopt orphaned metadata into a base — ADR-0070 D5 migration - #2301

Merged
os-zhuang merged 1 commit into
mainfrom
feat/adr-0070-d5-orphan-migration
Jun 24, 2026
Merged

feat(objectql): adopt orphaned metadata into a base — ADR-0070 D5 migration#2301
os-zhuang merged 1 commit into
mainfrom
feat/adr-0070-d5-orphan-migration

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

What

ADR-0070 D5 — the migration affordance that retires the pre-package-first stopgaps.

  • protocol.reassignOrphanedMetadata — bulk-rebinds every package-less orphan (package_id null / "" / the sys_metadata sentinel) onto a target base; already-owned rows are untouched.
  • POST /packages/:id/adopt-orphans — "move all loose items into this base".

Once an env runs this and has no orphans, objectui can drop the "Local / Custom" scope from the selector (the UI side of D5 + the D6 single-tenant guardrail) — a follow-up objectui change. Pairs with D1 (writable_package_required) which already stops NEW orphans.

Tests

@objectstack/objectql green incl. new reassignOrphanedMetadata tests (rebinds null/""/sys_metadata, leaves owned rows, no-orphans → count 0). tsc clean. Stacked on D4 (#2299, merged) then rebased — diff is D5-only.

🤖 Generated with Claude Code

…ration
protocol.reassignOrphanedMetadata bulk-rebinds package-less orphans (null/''/
sys_metadata) onto a target base, leaving owned rows untouched. + POST
/packages/:id/adopt-orphans. +tests. Migration affordance to retire the
Local/Custom stopgap scope (D5).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@vercel

vercelBot commented Jun 24, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
specBuildingBuildingPreview, CommentJun 24, 2026 4:02pm

Request Review

@github-actionsgithub-actionsBot added documentation Improvements or additions to documentation tests tooling size/m labels Jun 24, 2026
@github-actions

Copy link
Copy Markdown
Contributor

📓 Docs Drift Check

This PR changes 2 package(s): @objectstack/objectql, @objectstack/runtime.

25 hand-written doc(s) reference the affected code and may need an implementation-accuracy re-verification:

  • content/docs/concepts/cloud-artifact-api.mdx(via packages/runtime)
  • content/docs/concepts/core/services.mdx(via @objectstack/objectql)
  • content/docs/concepts/implementation-status.mdx(via @objectstack/objectql, @objectstack/runtime)
  • content/docs/concepts/metadata-lifecycle.mdx(via @objectstack/objectql)
  • content/docs/concepts/north-star.mdx(via packages/runtime)
  • content/docs/concepts/packages.mdx(via @objectstack/objectql, @objectstack/runtime)
  • content/docs/guides/api-reference.mdx(via @objectstack/runtime)
  • content/docs/guides/authentication.mdx(via @objectstack/objectql, @objectstack/runtime)
  • content/docs/guides/cloud-deployment.mdx(via @objectstack/runtime)
  • content/docs/guides/deployment-vercel.mdx(via @objectstack/objectql, @objectstack/runtime)
  • content/docs/guides/driver-configuration.mdx(via @objectstack/runtime)
  • content/docs/guides/formula.mdx(via packages/objectql)
  • content/docs/guides/hook-bodies.mdx(via @objectstack/runtime)
  • content/docs/guides/kernel-services.mdx(via @objectstack/objectql)
  • content/docs/guides/objectql-migration.mdx(via @objectstack/objectql)
  • content/docs/guides/packages.mdx(via @objectstack/objectql, @objectstack/runtime)
  • content/docs/guides/plugin-chatbot-integration.mdx(via @objectstack/runtime)
  • content/docs/guides/plugins.mdx(via @objectstack/objectql)
  • content/docs/guides/production-readiness.mdx(via @objectstack/runtime)
  • content/docs/guides/single-project-mode.mdx(via @objectstack/runtime)
  • content/docs/protocol/objectos/http-protocol.mdx(via @objectstack/runtime)
  • content/docs/protocol/objectos/index.mdx(via @objectstack/objectql, @objectstack/runtime)
  • content/docs/protocol/objectos/lifecycle.mdx(via @objectstack/runtime)
  • content/docs/protocol/objectql/state-machine.mdx(via @objectstack/objectql)
  • content/docs/releases/v9.mdx(via @objectstack/objectql)

Advisory only. To re-verify, run the docs-accuracy-audit workflow scoped to these files:
node scripts/docs-audit/affected-docs.mjs origin/main → pass the list as args.docs.

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentationImprovements or additions to documentationsize/mteststooling

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@os-zhuang