Deprecate @objectql/core per migration guide by Copilot · Pull Request #390 · objectstack-ai/objectql

Copilot · 2026-02-14T10:56:25Z

Mark @objectql/core package as deprecated (package.json, README, source)
Convert @objectql/core/src/index.ts to deprecated re-exports
- Bridge ObjectQL class kept for backward compatibility (marked deprecated)
- createObjectQLKernel and ObjectQLKernelOptions exported from local kernel-factory.ts (not upstream)
- ObjectQLPlugin orchestrator stays in @objectql ecosystem
Migrate @objectql/platform-node source to import from @objectstack/objectql
Migrate CLI source code to import from @objectstack/objectql
Add migration guide documentation
- Fixed version reference from ^3.1.0 to ^3.0.4
- Fixed kernel.bootstrap() to kernel.start() per actual API
Add deprecation callout to @objectql/core architecture docs
Build passes: 36/36 tasks successful
Tests: same pre-existing failures only (plugin-formula, CLI sync, enterprise-erp, project-tracker)

Original prompt

根据文档作废@objectql/core

https://github.com/objectstack-ai/spec/blob/main/content/docs/guides/objectql-migration.mdx

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

vercel · 2026-02-14T10:56:30Z

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

Project	Deployment	Actions	Updated (UTC)
objectql	Ready	Preview, Comment	Feb 14, 2026 11:43am

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>

…s pass Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>

github-actions · 2026-02-14T11:28:14Z

⚠️ No Changeset Found

This PR does not include a changeset file.
If this PR includes user-facing changes, please add a changeset by running:

pnpm changeset

Copilot

Pull request overview

This PR deprecates @objectql/core in favor of the upstream @objectstack/objectql@3.0.4 package, implementing the migration strategy outlined in the spec repository. The core functionality (ObjectQL engine, SchemaRegistry, createObjectQLKernel, utility functions) is now re-exported from upstream, while the bridge class and ObjectQLPlugin orchestrator remain for backward compatibility.

Changes:

Added deprecation notices to @objectql/core package.json and all exports in index.ts
Updated CLI tools (repl, migrate, doctor) to import directly from @objectstack/objectql
Migrated @objectql/platform-node to use upstream utilities (toTitleCase)
Added comprehensive migration guide documentation

Reviewed changes

Copilot reviewed 13 out of 14 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
packages/foundation/core/package.json	Added deprecated field and updated description
packages/foundation/core/src/index.ts	Added @deprecated tags and re-exported symbols from upstream
packages/foundation/core/README.md	Added deprecation warning and migration guide link
packages/foundation/platform-node/package.json	Replaced @objectql/core dependency with @objectstack/objectql
packages/foundation/platform-node/src/loader.ts	Updated toTitleCase import to use upstream package
packages/tools/cli/package.json	Added @objectstack/objectql dependency
packages/tools/cli/src/commands/repl.ts	Updated ObjectQL and ObjectRepository imports
packages/tools/cli/src/commands/migrate.ts	Updated migration template to use upstream import
packages/tools/cli/src/commands/doctor.ts	Added @objectstack/objectql to dependency checks
content/docs/guides/objectql-migration.mdx	New comprehensive migration guide
content/docs/guides/meta.json	Added migration guide to navigation
content/docs/architecture/core.mdx	Added deprecation callout with migration guide link
examples/showcase/enterprise-erp/src/plugins/audit/audit.plugin.ts	Clarified comment about local type definitions
pnpm-lock.yaml	Added @objectstack/objectql@3.0.4 dependencies

Files not reviewed (1)

pnpm-lock.yaml: Language not supported

Copilot · 2026-02-14T11:32:08Z

packages/foundation/core/src/index.ts

+export { createObjectQLKernel } from '@objectstack/objectql';
+/** @deprecated Import from `@objectstack/objectql` instead. */
+export { toTitleCase, convertIntrospectedSchemaToObjects } from '@objectstack/objectql';
+/** @deprecated Import from `@objectstack/objectql` instead. */
+export type { ObjectQLKernelOptions, HookHandler, HookEntry, OperationContext, EngineMiddleware, ObjectQLHostContext } from '@objectstack/objectql';


The index.ts is now re-exporting createObjectQLKernel and ObjectQLKernelOptions from @objectstack/objectql, but the local kernel-factory.ts file still exists with its own implementation. This creates a potential breaking change if the upstream and local implementations differ.

The local implementation (in kernel-factory.ts lines 42-47) creates an ObjectKernel with UpstreamObjectQLPlugin, while the upstream version might have a different implementation or signature.

Consider either:

Removing the local kernel-factory.ts file entirely if it's no longer needed, or

Documenting why the local version exists and ensuring it's not accidentally used

Suggested change

export { createObjectQLKernel } from '@objectstack/objectql';

/** @deprecated Import from `@objectstack/objectql` instead. */

export { toTitleCase, convertIntrospectedSchemaToObjects } from '@objectstack/objectql';

/** @deprecated Import from `@objectstack/objectql` instead. */

export type { ObjectQLKernelOptions, HookHandler, HookEntry, OperationContext, EngineMiddleware, ObjectQLHostContext } from '@objectstack/objectql';

export { createObjectQLKernel } from './kernel-factory';

/** @deprecated Import from `@objectstack/objectql` instead. */

export { toTitleCase, convertIntrospectedSchemaToObjects } from '@objectstack/objectql';

/** @deprecated Import from `@objectstack/objectql` instead. */

export type { ObjectQLKernelOptions } from './kernel-factory';

/** @deprecated Import from `@objectstack/objectql` instead. */

export type { HookHandler, HookEntry, OperationContext, EngineMiddleware, ObjectQLHostContext } from '@objectstack/objectql';

Fixed in 41f9510 — createObjectQLKernel and ObjectQLKernelOptions now exported from local ./kernel-factory instead of upstream, since the local implementation wraps ObjectKernel with UpstreamObjectQLPlugin which may differ from the upstream factory.

Copilot · 2026-02-14T11:32:09Z

content/docs/guides/objectql-migration.mdx

+const kernel = await createObjectQLKernel({
+  plugins: [myDriverPlugin],
+});
+await kernel.bootstrap();


The migration guide shows await kernel.bootstrap() as the method to initialize the kernel, but this should be verified against the actual upstream API. The local kernel-factory.ts example (line 39) shows await kernel.start() instead.

Please verify which method is correct for the upstream @objectstack/objectql kernel and update the guide accordingly to avoid confusion.

Suggested change

await kernel.bootstrap();

await kernel.start();

Fixed in 41f9510 — updated to kernel.start() to match the actual upstream API (consistent with kernel-factory.ts line 39).

Copilot · 2026-02-14T11:32:09Z

packages/foundation/core/src/index.ts

 /**
- * ObjectQL
+ * ObjectQL Core — DEPRECATED
 * Copyright (c) 2026-present ObjectStack Inc.


The copyright notice states "2026-present" but according to the system time, we're currently in February 2026. This is technically correct, but it's unusual to see a copyright starting from the current year without any past years included.

If ObjectQL code existed before 2026, the copyright should reflect the original year (e.g., "2024-present" or "2025-present"). If this is truly new code from 2026, then "2026-present" is fine, though you might consider just using "2026" until we enter 2027.

Suggested change

* Copyright (c) 2026-present ObjectStack Inc.

* Copyright (c) 2026 ObjectStack Inc.

Copilot · 2026-02-14T11:32:09Z

content/docs/guides/objectql-migration.mdx

+    "dependencies": {
+-     "@objectql/core": "^4.x",
+-     "@objectql/types": "^4.x",
+     "@objectstack/objectql": "^3.1.0"


The migration guide specifies @objectstack/objectql version ^3.1.0, but the actual version used in this PR's lockfile and package.json files is ^3.0.4. This version mismatch could confuse users following the migration guide.

Either update the guide to reference ^3.0.4 (the current version), or if ^3.1.0 is a future target version, add a note explaining this.

Suggested change

+ "@objectstack/objectql": "^3.1.0"

+ "@objectstack/objectql": "^3.0.4"

Fixed in 41f9510 — updated to ^3.0.4 to match the version used throughout the monorepo.

hotlong · 2026-02-14T11:35:35Z

@copilot fix build and test

…nd API Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>

Copilot · 2026-02-14T11:42:41Z

@copilot fix build and test

Build and tests verified — 36/36 build tasks pass, test failures are all pre-existing (plugin-formula, CLI sync, enterprise-erp, project-tracker). Also addressed the reviewer comments: kept local kernel-factory.ts exports, fixed migration guide version (^3.0.4) and API (kernel.start()). See 41f9510.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

fastdl.mongodb.org
- Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node node /home/REDACTED/work/objectql/objectql/node_modules/.bin/../vitest/vitest.mjs run ions-REDACTED/cached/externals/node24/lib/node_modules/corepack/shims/pnpm tql/�� --exclude '*' src/ dist/ build (dns block)
fonts.googleapis.com
- Triggering command: /opt/hostedtoolcache/node/24.13.0/x64/bin/node /opt/hostedtoolcache/node/24.13.0/x64/bin/node /home/REDACTED/work/objectql/objectql/node_modules/.pnpm/next@16.1.6_react-dom@19.2.4_react@19.2.4__react@19.2.4/node_modules/next/dist/compiled/jest-worker/processChild.js (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Configure Actions setup steps to set up my environment, which run before the firewall is enabled
Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

github-actions · 2026-02-14T11:48:27Z

⚠️ No Changeset Found

This PR does not include a changeset file.
If this PR includes user-facing changes, please add a changeset by running:

pnpm changeset

github-actions · 2026-02-14T11:50:22Z

⚠️ No Changeset Found

This PR does not include a changeset file.
If this PR includes user-facing changes, please add a changeset by running:

pnpm changeset

Initial plan

904a632

Copilot AI assigned Copilot and hotlong Feb 14, 2026

Copilot started work on behalf of hotlong February 14, 2026 10:56 View session

vercel bot deployed to Preview February 14, 2026 10:57 View deployment

deprecate @objectql/core: migrate all imports to @objectstack/objectql

affda40

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>

vercel bot had a problem deploying to Preview February 14, 2026 11:06 Failure

fix: restore bridge-dependent examples, verify build (36/36) and test…

db48f14

…s pass Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>

vercel bot deployed to Preview February 14, 2026 11:16 View deployment

Copilot AI and others added 2 commits February 14, 2026 11:17

docs: add deprecation notice to @objectql/core docs and migration guide

e82305d

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>

docs: clarify MetadataFacade async description

297905d

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>

vercel bot deployed to Preview February 14, 2026 11:20 View deployment

Copilot AI changed the title ~~[WIP] Remove objectql/core based on documentation~~ Deprecate @objectql/core per migration guide Feb 14, 2026

Copilot AI requested a review from hotlong February 14, 2026 11:27

Copilot finished work on behalf of hotlong February 14, 2026 11:27

hotlong marked this pull request as ready for review February 14, 2026 11:27

Copilot AI review requested due to automatic review settings February 14, 2026 11:27

github-actions bot added 🔧 tooling 🏗️ foundation 📦 dependencies 📚 documentation 📝 examples size/M labels Feb 14, 2026

Copilot started reviewing on behalf of hotlong February 14, 2026 11:28 View session

Copilot AI reviewed Feb 14, 2026

View reviewed changes

Copilot started work on behalf of hotlong February 14, 2026 11:35 View session

fix: keep local kernel-factory exports, fix migration guide version a…

41f9510

…nd API Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>

vercel bot deployed to Preview February 14, 2026 11:43 View deployment

Copilot finished work on behalf of hotlong February 14, 2026 11:45

hotlong merged commit 3a9d142 into main Feb 14, 2026
17 of 18 checks passed

hotlong deleted the copilot/remove-objectql-core branch February 14, 2026 12:02

	* Copyright (c) 2026-present ObjectStack Inc.
	* Copyright (c) 2026 ObjectStack Inc.

	+ "@objectstack/objectql": "^3.1.0"
	+ "@objectstack/objectql": "^3.0.4"

Conversation

Copilot AI commented Feb 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

vercel bot commented Feb 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Feb 14, 2026

⚠️ No Changeset Found

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Feb 14, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 14, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 14, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 14, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 14, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 14, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 14, 2026

Choose a reason for hiding this comment

Uh oh!

hotlong commented Feb 14, 2026

Uh oh!

Copilot AI commented Feb 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

I tried to connect to the following addresses, but was blocked by firewall rules:

Uh oh!

github-actions bot commented Feb 14, 2026

⚠️ No Changeset Found

Uh oh!

github-actions bot commented Feb 14, 2026

⚠️ No Changeset Found

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Copilot AI commented Feb 14, 2026 •

edited

Loading

vercel bot commented Feb 14, 2026 •

edited

Loading

Copilot AI commented Feb 14, 2026 •

edited

Loading