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

Copilot · hotlong · Copilot · commit affda4084972 · 2026-02-14T11:05:50.000Z
Co-authored-by: hotlong &lt;50353452+hotlong@users.noreply.github.com&gt;
diff --git a/examples/drivers/fs-demo/package.json b/examples/drivers/fs-demo/package.json
@@ -8,7 +8,7 @@
     "dev": "ts-node src/index.ts"
   },
   "dependencies": {
-    "@objectql/core": "workspace:*",
+    "@objectstack/objectql": "^3.0.4",
     "@objectql/driver-fs": "workspace:*"
   },
   "devDependencies": {
diff --git a/examples/drivers/fs-demo/src/index.ts b/examples/drivers/fs-demo/src/index.ts
@@ -6,7 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import { ObjectQL } from '@objectql/core';
+import { ObjectQL } from '@objectstack/objectql';
 import { FileSystemDriver } from '@objectql/driver-fs';
 import * as path from 'path';
 
diff --git a/examples/integrations/browser/index.html b/examples/integrations/browser/index.html
@@ -205,7 +205,7 @@ <h2>🖥️ Console Output</h2>
     </div>
     
     <script type="module">
-        import { ObjectQL } from '@objectql/core';
+        import { ObjectQL } from '@objectstack/objectql';
         import { MemoryDriver } from '@objectql/driver-memory';
         
         // Global variables
diff --git a/examples/integrations/browser/package.json b/examples/integrations/browser/package.json
@@ -10,7 +10,7 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "@objectql/core": "workspace:*",
+    "@objectstack/objectql": "^3.0.4",
     "@objectql/driver-memory": "workspace:*",
     "@objectql/types": "workspace:*"
   },
diff --git a/examples/integrations/browser/vite.config.js b/examples/integrations/browser/vite.config.js
@@ -23,7 +23,7 @@ export default defineConfig({
   optimizeDeps: {
     include: [
       '@objectql/types',
-      '@objectql/core',
+      '@objectstack/objectql',
       '@objectql/driver-memory'
     ]
   },
diff --git a/examples/integrations/express-server/__tests__/metadata-loading.test.ts b/examples/integrations/express-server/__tests__/metadata-loading.test.ts
@@ -12,7 +12,7 @@
  * Tests that metadata files are correctly loaded and registered
  */
 
-import { ObjectQL } from '@objectql/core';
+import { ObjectQL } from '@objectstack/objectql';
 import { SqlDriver } from '@objectql/driver-sql';
 import { ObjectLoader } from '@objectql/platform-node';
 import * as path from 'path';
diff --git a/examples/integrations/express-server/package.json b/examples/integrations/express-server/package.json
@@ -26,7 +26,7 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@objectql/core": "workspace:*",
+    "@objectstack/objectql": "^3.0.4",
     "@objectql/driver-sql": "workspace:*",
     "@objectql/platform-node": "workspace:*",
     "sqlite3": "^5.1.7"
diff --git a/examples/quickstart/hello-world/package.json b/examples/quickstart/hello-world/package.json
@@ -12,7 +12,7 @@
     "start": "ts-node src/index.ts"
   },
   "dependencies": {
-    "@objectql/core": "workspace:*",
+    "@objectstack/objectql": "^3.0.4",
     "@objectql/driver-sql": "workspace:*",
     "sqlite3": "^5.1.7"
   },
diff --git a/examples/quickstart/hello-world/src/index.ts b/examples/quickstart/hello-world/src/index.ts
@@ -6,7 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import { ObjectQL } from '@objectql/core';
+import { ObjectQL } from '@objectstack/objectql';
 import { SqlDriver } from '@objectql/driver-sql';
 
 async function main() {
diff --git a/examples/showcase/enterprise-erp/__tests__/data-api.test.ts b/examples/showcase/enterprise-erp/__tests__/data-api.test.ts
@@ -12,7 +12,7 @@
  * Tests CRUD operations for enterprise objects
  */
 
-import { ObjectQL } from '@objectql/core';
+import { ObjectQL } from '@objectstack/objectql';
 import { SqlDriver } from '@objectql/driver-sql';
 import { ObjectLoader } from '@objectql/platform-node';
 import * as path from 'path';
diff --git a/examples/showcase/enterprise-erp/__tests__/metadata-api.test.ts b/examples/showcase/enterprise-erp/__tests__/metadata-api.test.ts
@@ -12,7 +12,7 @@
  * Tests metadata API operations for enterprise objects
  */
 
-import { ObjectQL } from '@objectql/core';
+import { ObjectQL } from '@objectstack/objectql';
 import { SqlDriver } from '@objectql/driver-sql';
 import { ObjectLoader } from '@objectql/platform-node';
 import * as path from 'path';
diff --git a/examples/showcase/enterprise-erp/__tests__/metadata-loading.test.ts b/examples/showcase/enterprise-erp/__tests__/metadata-loading.test.ts
@@ -12,7 +12,7 @@
  * Tests that the enterprise-scale metadata organization is correctly loaded
  */
 
-import { ObjectQL } from '@objectql/core';
+import { ObjectQL } from '@objectstack/objectql';
 import { SqlDriver } from '@objectql/driver-sql';
 import { ObjectLoader } from '@objectql/platform-node';
 import * as path from 'path';
diff --git a/examples/showcase/enterprise-erp/package.json b/examples/showcase/enterprise-erp/package.json
@@ -31,15 +31,15 @@
     "test": "vitest run"
   },
   "peerDependencies": {
-    "@objectql/core": "workspace:*",
+    "@objectstack/objectql": "^3.0.4",
     "@objectql/driver-sql": "workspace:*",
     "@objectql/platform-node": "workspace:*",
     "@objectql/types": "workspace:*",
     "sqlite3": "^5.1.7"
   },
   "devDependencies": {
     "@objectql/cli": "workspace:*",
-    "@objectql/core": "workspace:*",
+    "@objectstack/objectql": "^3.0.4",
     "@objectql/driver-sql": "workspace:*",
     "@objectql/platform-node": "workspace:*",
     "@objectql/types": "workspace:*",
diff --git a/examples/showcase/enterprise-erp/src/index.ts b/examples/showcase/enterprise-erp/src/index.ts
@@ -6,7 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import { ObjectQL } from '@objectql/core';
+import { ObjectQL } from '@objectstack/objectql';
 import { SqlDriver } from '@objectql/driver-sql';
 import { ObjectLoader } from '@objectql/platform-node';
 import * as path from 'path';
diff --git a/examples/showcase/enterprise-erp/src/plugins/audit/audit.plugin.ts b/examples/showcase/enterprise-erp/src/plugins/audit/audit.plugin.ts
@@ -6,8 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-// Import ObjectQLPlugin types from @objectql/core instead of @objectstack/runtime
-// to avoid ESM/CJS compatibility issues
+// Plugin types defined locally to avoid ESM/CJS compatibility issues
 type RuntimeContext = any;
 
 interface ObjectQLPlugin {
diff --git a/examples/showcase/project-tracker/__tests__/projects-hooks-actions.test.ts b/examples/showcase/project-tracker/__tests__/projects-hooks-actions.test.ts
@@ -15,7 +15,7 @@
  * 3. Business logic patterns from the specification
  */
 
-import { ObjectQL } from '@objectql/core';
+import { ObjectQL } from '@objectstack/objectql';
 import hooks from '../src/modules/projects/projects.hook';
 import * as actions from '../src/modules/projects/projects.action';
 
diff --git a/examples/showcase/project-tracker/package.json b/examples/showcase/project-tracker/package.json
@@ -33,15 +33,15 @@
     "test": "vitest run"
   },
   "peerDependencies": {
-    "@objectql/core": "workspace:*",
+    "@objectstack/objectql": "^3.0.4",
     "@objectql/driver-sql": "workspace:*",
     "@objectql/platform-node": "workspace:*",
     "@objectql/types": "workspace:*",
     "sqlite3": "^5.1.7"
   },
   "devDependencies": {
     "@objectql/cli": "workspace:*",
-    "@objectql/core": "workspace:*",
+    "@objectstack/objectql": "^3.0.4",
     "@objectql/driver-sql": "workspace:*",
     "@objectql/platform-node": "workspace:*",
     "@objectql/types": "workspace:*",
diff --git a/examples/showcase/project-tracker/src/seed.ts b/examples/showcase/project-tracker/src/seed.ts
@@ -6,7 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import { ObjectQL } from '@objectql/core';
+import { ObjectQL } from '@objectstack/objectql';
 import { SqlDriver } from '@objectql/driver-sql';
 import { ObjectLoader } from '@objectql/platform-node';
 import * as path from 'path';
diff --git a/packages/foundation/core/package.json b/packages/foundation/core/package.json
@@ -1,7 +1,8 @@
 {
   "name": "@objectql/core",
   "version": "4.2.1",
-  "description": "Universal runtime engine for ObjectQL - AI-native metadata-driven ORM with validation, repository pattern, and driver orchestration",
+  "deprecated": "Use @objectstack/objectql instead. See https://github.com/objectstack-ai/spec/blob/main/content/docs/guides/objectql-migration.mdx",
+  "description": "DEPRECATED — Use @objectstack/objectql. Plugin orchestrator for ObjectQL sub-plugins (validator, formula, query).",
   "keywords": [
     "objectql",
     "orm",
diff --git a/packages/foundation/core/src/index.ts b/packages/foundation/core/src/index.ts
@@ -1,21 +1,26 @@
 /**
- * ObjectQL
+ * ObjectQL Core — DEPRECATED
  * Copyright (c) 2026-present ObjectStack Inc.
  *
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
+ *
+ * @deprecated This package is deprecated. Migrate to `@objectstack/objectql`.
+ * See: https://github.com/objectstack-ai/spec/blob/main/content/docs/guides/objectql-migration.mdx
  */
 
-// ── Convenience factory ──
-export { createObjectQLKernel, type ObjectQLKernelOptions } from './kernel-factory';
+// ── Re-exports from @objectstack/objectql (deprecated — import directly from upstream) ──
 
-// ── Re-export bridge engine (extends upstream with MetadataRegistry + legacy config) ──
-export { ObjectQL, type ObjectQLConfig } from './app';
+/** @deprecated Import from `@objectstack/objectql` instead. */
+export { ObjectQL } from '@objectstack/objectql';
+/** @deprecated Import from `@objectstack/objectql` instead. */
 export { ObjectRepository, ScopedContext, SchemaRegistry } from '@objectstack/objectql';
-export type { HookHandler, HookEntry, OperationContext, EngineMiddleware, ObjectQLHostContext } from '@objectstack/objectql';
+/** @deprecated Import from `@objectstack/objectql` instead. */
+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';
 
-// ── Plugin orchestration ──
+// ── Plugin orchestration (downstream — stays in @objectql ecosystem) ──
 export * from './plugin';
-
-// ── Utilities ──
-export * from './util';
diff --git a/packages/foundation/platform-node/package.json b/packages/foundation/platform-node/package.json
@@ -27,7 +27,7 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@objectql/core": "workspace:*",
+    "@objectstack/objectql": "^3.0.4",
     "@objectql/types": "workspace:*",
     "@objectstack/spec": "^3.0.4",
     "fast-glob": "^3.3.2",
diff --git a/packages/foundation/platform-node/src/loader.ts b/packages/foundation/platform-node/src/loader.ts
@@ -11,7 +11,7 @@ import * as glob from 'fast-glob';
 import * as path from 'path';
 import { MetadataRegistry, ObjectConfig, LoaderPlugin, LoaderHandlerContext, FieldConfig } from '@objectql/types';
 import * as yaml from 'js-yaml';
-import { toTitleCase } from '@objectql/core';
+import { toTitleCase } from '@objectstack/objectql';
 
 export class ObjectLoader {
     private plugins: LoaderPlugin[] = [];
diff --git a/packages/foundation/platform-node/test/dynamic.test.ts b/packages/foundation/platform-node/test/dynamic.test.ts
@@ -6,7 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import { ObjectQL } from '@objectql/core';
+import { ObjectQL } from '@objectstack/objectql';
 import { ObjectLoader } from '../src';
 import * as path from 'path';
 
diff --git a/packages/foundation/platform-node/test/metadata.test.ts b/packages/foundation/platform-node/test/metadata.test.ts
@@ -6,7 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import { ObjectQL } from '@objectql/core';
+import { ObjectQL } from '@objectstack/objectql';
 import { ObjectConfig } from '@objectql/types';
 import * as fs from 'fs';
 import * as path from 'path';
diff --git a/packages/foundation/plugin-formula/test/formula-integration.test.ts b/packages/foundation/plugin-formula/test/formula-integration.test.ts
@@ -12,7 +12,7 @@
  * Tests formula evaluation within repository queries
  */
 
-import { ObjectQL } from '@objectql/core';
+import { ObjectQL } from '@objectstack/objectql';
 import { MockDriver } from './mock-driver';
 import { FormulaPlugin } from '../src/formula-plugin';
 
diff --git a/packages/tools/cli/__tests__/commands.test.ts b/packages/tools/cli/__tests__/commands.test.ts
@@ -15,7 +15,7 @@ import { build } from '../src/commands/build';
 import { lint } from '../src/commands/lint';
 import { test as testCommand } from '../src/commands/test';
 import { doctorCommand } from '../src/commands/doctor';
-import { ObjectQL } from '@objectql/core';
+import { ObjectQL } from '@objectstack/objectql';
 import { SqlDriver } from '@objectql/driver-sql';
 import * as yaml from 'js-yaml';
 
diff --git a/packages/tools/cli/package.json b/packages/tools/cli/package.json
@@ -30,7 +30,7 @@
   },
   "dependencies": {
     "@objectql/types": "workspace:*",
-    "@objectql/core": "workspace:*",
+    "@objectstack/objectql": "^3.0.4",
     "@objectql/plugin-validator": "workspace:*",
     "@objectql/driver-sql": "workspace:*",
     "@objectql/platform-node": "workspace:*",
diff --git a/packages/tools/cli/src/commands/doctor.ts b/packages/tools/cli/src/commands/doctor.ts
@@ -208,6 +208,7 @@ async function checkDependencies(packageJson: any): Promise<DependencyCheck[]> {
     
     // Check for ObjectQL core packages
     const corePackages = [
+        '@objectstack/objectql',
         '@objectql/core',
         '@objectql/types',
         '@objectql/cli'
diff --git a/packages/tools/cli/src/commands/migrate.ts b/packages/tools/cli/src/commands/migrate.ts
@@ -27,7 +27,7 @@ interface MigrateStatusOptions {
     dir?: string;
 }
 
-const MIGRATION_TEMPLATE = `import { ObjectQL } from '@objectql/core';
+const MIGRATION_TEMPLATE = `import { ObjectQL } from '@objectstack/objectql';
 
 /**
  * Migration: {{name}}
diff --git a/packages/tools/cli/src/commands/repl.ts b/packages/tools/cli/src/commands/repl.ts
@@ -9,7 +9,7 @@
 import * as repl from 'repl';
 import * as _path from 'path';
 import * as _fs from 'fs';
-import { ObjectQL } from '@objectql/core';
+import { ObjectQL } from '@objectstack/objectql';
 import { register } from 'ts-node';
 import { resolveConfigFile } from '../utils/config-loader';
 
@@ -83,7 +83,7 @@ export async function startRepl(configPath?: string) {
                     get: () => {
                         // Dynamic require to avoid circular dependency — ObjectRepository is constructed
                         // from the user-provided app instance to enable convenient REPL access.
-                        const { ObjectRepository } = require('@objectql/core');
+                        const { ObjectRepository } = require('@objectstack/objectql');
                         
                         const replContext: any = {
                             roles: ['admin'],

Original file line number	Diff line number	Diff line change
`@@ -23,7 +23,7 @@ export default defineConfig({`
`23`	`23`	`optimizeDeps: {`
`24`	`24`	`include: [`
`25`	`25`	`'@objectql/types',`
`26`		`- '@objectql/core',`
	`26`	`+ '@objectstack/objectql',`
`27`	`27`	`'@objectql/driver-memory'`
`28`	`28`	`]`
`29`	`29`	`},`