Merge pull request #282 from objectstack-ai/copilot/complete-roadmap-development

Author: hotlong

.github/copilot-instructions.md

@@ -41,7 +41,7 @@ The **"Business Operating System"** for the ObjectStack ecosystem.
   - **Internal:** Event Bus (EventEmitter / Redis / NATS).
   - **Outbound:** Webhooks / SMTP / SMS.
 - **Dependencies:**
-  - Depends on `@objectql/core` for Data Access.
+  - Depends on `@objectstack/objectql` for Data Access.
   - Depends on `@objectstack/runtime` for Kernel lifecycle.
   - Depends on `@objectstack/spec` for protocol contracts.
 

ARCHITECTURE.md

@@ -54,10 +54,8 @@ All ObjectOS plugins must conform to this lifecycle for consistency and predicta
 - **Location**: https://github.com/objectstack-ai/objectql
 - **Purpose**: Defines the metadata standard and provides core implementations
 - **Key Packages**:
-  - `@objectql/core` - Metadata parser, AST builder, query compiler
-  - `@objectql/types` - TypeScript type definitions for the protocol
-  - `@objectql/driver-sql` - SQL database driver (PostgreSQL, MySQL, SQLite)
-  - `@objectql/driver-mongo` - MongoDB driver
+  - `@objectstack/objectql` - ObjectQL plugin (data engine, metadata parser, query compiler)
+  - `@objectstack/driver-memory` - In-memory data driver for development and testing
 
 ### ObjectOS Repository (Runtime Implementation)
 
@@ -257,10 +255,10 @@ interface ObjectQLDriver {
 
 ### Supported Drivers
 
-| Driver         | Package                  | Databases                 |
-| -------------- | ------------------------ | ------------------------- |
-| SQL Driver     | `@objectql/driver-sql`   | PostgreSQL, MySQL, SQLite |
-| MongoDB Driver | `@objectql/driver-mongo` | MongoDB                   |
+| Driver          | Package                      | Databases                |
+| --------------- | ---------------------------- | ------------------------ |
+| Memory Driver   | `@objectstack/driver-memory` | In-memory (dev/testing)  |
+| ObjectQL Plugin | `@objectstack/objectql`      | SQL, MongoDB via drivers |
 
 ## Layer 4: HTTP Layer (@objectos/server)
 

CONTRIBUTING.md

@@ -129,7 +129,7 @@ interface ObjectConfig {
 }
 
 // ✅ GOOD
-import { ObjectConfig } from '@objectql/types';
+import { ObjectConfig } from '@objectstack/spec/data';
 ```
 
 #### Rule #2: Use Strict Types
@@ -141,7 +141,7 @@ async find(name: string, opts: any): Promise<any> {
 }
 
 // ✅ GOOD
-import { FindOptions } from '@objectql/types';
+import { FindOptions } from '@objectstack/spec/data';
 
 async find(
   name: string,

ROADMAP.md

@@ -100,7 +100,7 @@ title: ObjectOS Development Plan
 
 **Task List:**
 
-1. Define permission interface in `@objectql/types`
+1. Define permission interface in `@objectstack/spec`
 
    ```typescript
    interface PermissionSet {

content/docs/guide/development-plan.mdx

@@ -14,7 +14,7 @@ ObjectOS is a **metadata-driven runtime engine** that interprets and executes bu
 ┌─────────────────────────────────────────────────┐
 │  ObjectQL (Protocol Repository)                 │
 │  - Metadata standard in YAML                    │
-│  - Type definitions (@objectql/types)           │
+│  - Type definitions (@objectstack/spec)          │
 │  - Database drivers                             │
 └─────────────────────┬───────────────────────────┘
                       │
@@ -77,7 +77,7 @@ ObjectOS follows a strict architectural principle:
 > **"Kernel handles logic, Drivers handle data, Server handles HTTP."**
 
 - **Kernel** (`@objectos/kernel`): Validates, enforces permissions, runs hooks
-- **Drivers** (`@objectql/driver-*`): Translates to SQL/NoSQL queries
+- **Drivers** (`@objectstack/objectql`): Translates to SQL/NoSQL queries
 - **Server** (`@objectos/server`): Exposes REST APIs
 
 This separation means you can swap databases without changing business logic!
@@ -116,7 +116,7 @@ cd my-app
 npm init -y
 
 # Install ObjectOS packages
-npm install @objectos/kernel @objectos/server @objectql/driver-sql
+npm install @objectos/kernel @objectos/server @objectstack/objectql
 
 # Install database driver
 npm install pg  # for PostgreSQL
@@ -216,7 +216,7 @@ Create `src/main.ts`:
 
 ```typescript
 import { ObjectOS } from '@objectos/kernel';
-import { PostgresDriver } from '@objectql/driver-sql';
+import { ObjectQLPlugin } from '@objectstack/objectql';
 import * as yaml from 'js-yaml';
 import * as fs from 'fs';
 import * as path from 'path';

content/docs/guide/index.mdx

@@ -30,7 +30,7 @@ ObjectOS has evolved from a monolithic kernel architecture to a **microkernel pl
 │   • Hot Reload                       │
 │   • Workflow Engine                  │
 ├──────────────────────────────────────┤
-│        @objectql/core                │
+│        @objectstack/objectql          │
 └──────────────────────────────────────┘
 ```
 
@@ -54,7 +54,7 @@ ObjectOS has evolved from a monolithic kernel architecture to a **microkernel pl
 │   • Event Bus (Hooks)                │
 │   • Dependency Resolver              │
 ├──────────────────────────────────────┤
-│        @objectql/core                │
+│        @objectstack/objectql          │
 └──────────────────────────────────────┘
 ```
 

content/docs/guide/migration-from-kernel.mdx

@@ -7,28 +7,21 @@ This document provides a complete reference for the ObjectOS Kernel SDK. Use the
 ## Installation
 
 ```bash
-npm install @objectos/kernel @objectql/driver-sql
+npm install @objectos/kernel @objectstack/objectql
 ```
 
 ## Basic Setup
 
 ```typescript
 import { ObjectOS } from '@objectos/kernel';
-import { PostgresDriver } from '@objectql/driver-sql';
+import { ObjectQLPlugin } from '@objectstack/objectql';
 
 // Create kernel instance
 const kernel = new ObjectOS();
 
-// Configure database driver
-const driver = new PostgresDriver({
-  client: 'pg',
-  connection: {
-    host: 'localhost',
-    port: 5432,
-    user: 'postgres',
-    password: 'password',
-    database: 'myapp',
-  },
+// Configure data engine
+const objectql = new ObjectQLPlugin({
+  driver: 'memory',
 });
 
 // Connect driver to kernel
@@ -434,13 +427,12 @@ Set the database driver.
 **Example:**
 
 ```typescript
-import { PostgresDriver } from '@objectql/driver-sql';
+import { ObjectQLPlugin } from '@objectstack/objectql';
 
-const driver = new PostgresDriver({
+const objectql = new ObjectQLPlugin({
   /* config */
 });
-kernel.useDriver(driver);
-await driver.connect();
+kernel.usePlugin(objectql);
 ```
 
 ### `kernel.getDriver()`
@@ -654,12 +646,12 @@ type FieldType =
 
 ```typescript
 import { ObjectOS } from '@objectos/kernel';
-import { PostgresDriver } from '@objectql/driver-sql';
+import { ObjectQLPlugin } from '@objectstack/objectql';
 
 // Initialize
 const kernel = new ObjectOS();
-const driver = new PostgresDriver({
-  connection: process.env.DATABASE_URL,
+const objectql = new ObjectQLPlugin({
+  driver: 'memory',
 });
 
 kernel.useDriver(driver);

content/docs/guide/sdk-reference.mdx

@@ -108,10 +108,6 @@
     "@objectos/telemetry": "workspace:*",
     "@objectos/ui": "workspace:*",
     "@objectos/workflow": "workspace:*",
-    "@objectql/core": "^4.2.2",
-    "@objectql/driver-mongo": "^4.2.2",
-    "@objectql/driver-sql": "^4.2.2",
-    "@objectql/platform-node": "^4.2.2",
     "@objectstack/driver-memory": "3.0.6",
     "@objectstack/objectql": "3.0.6",
     "@objectstack/plugin-auth": "3.0.6",

package.json

@@ -28,6 +28,6 @@
     "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "@objectql/core": "^4.2.2"
+    "@objectstack/objectql": "^3.0.6"
   }
 }