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

vercel Bot commented Jun 24, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
spec Building Building Preview, Comment Jun 24, 2026 4:02pm

Request Review

@github-actions github-actions Bot 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 free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size/m tests tooling

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant