Merge pull request #388 from objectstack-ai/copilot/upgrade-objectstack-to-latest

Author: hotlong

ROADMAP.md

@@ -1,9 +1,9 @@
 # ObjectQL — 2026 Roadmap
 
-> Created: 2026-02-08 | Last Updated: 2026-02-12 | Status: **Active**  
-> Current Version: **4.2.0** (all packages aligned)  
-> Runtime: `@objectstack/cli` v3.0.0 (Kernel pattern) — `@objectql/server` removed, `packages/runtime/` removed.  
-> @objectstack Platform: **v3.0.0**
+> Created: 2026-02-08 | Last Updated: 2026-02-14 | Status: **Active**  
+> Current Version: **4.2.1** (all packages aligned)  
+> Runtime: `@objectstack/cli` v3.0.3+ (Kernel pattern) — `@objectql/server` removed, `packages/runtime/` removed.  
+> @objectstack Platform: **v3.0.3+**
 
 ---
 
@@ -26,6 +26,7 @@
 - [Q3 — Edge Runtime & Offline Sync](#q3--edge-runtime--offline-sync)
   - [Part A: Edge Runtime Support](#part-a-edge-runtime-support)
   - [Part B: Offline-First Sync Protocol](#part-b-offline-first-sync-protocol)
+- [Immediate Next Steps (Post v3.0.3 Upgrade)](#immediate-next-steps-post-v303-upgrade)
 - [Q4 — Plugin Marketplace & Stabilization](#q4--plugin-marketplace--stabilization)
 - [Package Matrix](#package-matrix)
 - [Removed Packages](#removed-packages)
@@ -62,7 +63,7 @@ ObjectQL is the **Standard Protocol for AI Software Generation** — a universal
 
 - ✅ Phases 1A (ObjectQLError migration), 3 (logging), 4 (ESLint all waves), 5A (TODO elimination), 5B (protocol compliance 95%+), 6 (error-handling + architecture guides)
 - ✅ Core refactoring: `@objectql/core` decomposed from ~3,500 to ~800 LOC ([PR #373](https://github.com/objectstack-ai/objectql/pull/373))
-- ✅ `@objectstack/*` platform upgraded to **v3.0.0**
+- ✅ `@objectstack/*` platform upgraded to **v3.0.3+** (Zod v4 alignment)
 - ✅ Phase 7 partial (sideEffects), Phase 2 (test suites for SDK, CLI, Create, VSCode)
 - ✅ Q1 Phase 2: Browser WASM Drivers (`driver-sqlite-wasm`, `driver-pg-wasm`) implemented with docs and tests
 - ✅ Q1 Phase 3: Housekeeping complete (H-1 through H-8), `plugin-workflow` implemented with full test suite
@@ -734,6 +735,22 @@ Define wire format, `MutationLogEntry` schema, `SyncConflict` schema, checkpoint
 
 ---
 
+## Immediate Next Steps (Post v3.0.3 Upgrade)
+
+> Status: **Active** | Target: 2026-02 — 2026-03
+
+Priority tasks following the `@objectstack` v3.0.3+ upgrade:
+
+| # | Task | Priority | Description |
+|---|------|----------|-------------|
+| 1 | Fix `plugin-formula` integration tests | High | 6 pre-existing test failures in `formula-integration.test.ts` — formula fields evaluate to `undefined`. Root cause: hook registration / metadata lookup mismatch in FormulaPlugin. |
+| 2 | Re-enable `AuthPlugin` | Medium | Disabled due to camelCase field names (`createdAt`, `updatedAt`, `emailVerified`) violating ObjectQL snake_case spec. Coordinate with `@objectstack/plugin-auth` upstream or add field name normalization layer. |
+| 3 | Align `@objectql/types` with `@objectstack/spec` v3.0.3 Zod v4 schemas | High | Verify `z.infer<>` type derivation compiles correctly against the new Zod v4 schema exports in `@objectstack/spec@3.0.3`. |
+| 4 | Core bridge class stabilization | Medium | Consolidate `app.ts` bridge class — verify all `registerObject`, `getObject`, `getConfigs`, `removePackage` overrides align with `@objectstack/objectql@3.0.3` API surface. |
+| 5 | Bump `@objectql/*` packages to **4.3.0** | Low | Release patch with `@objectstack` v3.0.3 compatibility via Changesets. |
+
+---
+
 ## Q4 — Plugin Marketplace & Stabilization
 
 > Status: **Planned** | Target: 2026-10 — 2026-12
@@ -763,7 +780,7 @@ Standardize third-party plugin distribution.
 
 ## Package Matrix
 
-> All packages at **4.2.0** unless noted.
+> All packages at **4.2.1** unless noted.
 
 ### Foundation Layer
 
@@ -817,12 +834,12 @@ Standardize third-party plugin distribution.
 
 | Package | Owner | Version | Role in ObjectQL |
 |---------|-------|---------|-----------------|
-| `@objectstack/cli` | ObjectStack | 3.0.0 | Kernel bootstrapper (`objectstack serve`) |
-| `@objectstack/core` | ObjectStack | 3.0.0 | Kernel runtime, plugin lifecycle |
-| `@objectstack/plugin-hono-server` | ObjectStack | 3.0.0 | HTTP server (Hono-based) |
-| `@objectstack/spec` | ObjectStack | 3.0.0 | Formal protocol specifications (Zod schemas) |
-| `@objectstack/runtime` | ObjectStack | 3.0.0 | Core runtime & query engine |
-| `@objectstack/objectql` | ObjectStack | 3.0.0 | ObjectQL runtime bridge |
+| `@objectstack/cli` | ObjectStack | 3.0.3+ | Kernel bootstrapper (`objectstack serve`) |
+| `@objectstack/core` | ObjectStack | 3.0.3+ | Kernel runtime, plugin lifecycle |
+| `@objectstack/plugin-hono-server` | ObjectStack | 3.0.3+ | HTTP server (Hono-based) |
+| `@objectstack/spec` | ObjectStack | 3.0.3+ | Formal protocol specifications (Zod schemas) |
+| `@objectstack/runtime` | ObjectStack | 3.0.3+ | Core runtime & query engine |
+| `@objectstack/objectql` | ObjectStack | 3.0.3+ | ObjectQL runtime bridge |
 | AI Agent / AI tooling | **Separate project** | — | Not in this monorepo |
 
 ---
@@ -867,7 +884,7 @@ Standardize third-party plugin distribution.
 
 - **`@objectql/types`** correctly has ZERO production dependencies (pure types)
 - **`@objectql/core`** depends on `plugin-formula` and `plugin-validator` — tight coupling noted
-- All `@objectstack/*` packages are at **v3.0.0** — aligned
+- All `@objectstack/*` packages are at **v3.0.3+** — aligned (Zod v4)
 - **`mingo`** (used in memory driver) is the only non-standard query engine dependency
 - **`knex`** is shared across `driver-sql`, `driver-pg-wasm`, `driver-sqlite-wasm`
 

package.json

@@ -35,10 +35,10 @@
     "@objectql/protocol-graphql": "workspace:*",
     "@objectql/protocol-json-rpc": "workspace:*",
     "@objectql/protocol-odata-v4": "workspace:*",
-    "@objectstack/cli": "^3.0.2",
-    "@objectstack/core": "^3.0.2",
-    "@objectstack/plugin-auth": "^3.0.2",
-    "@objectstack/plugin-hono-server": "^3.0.2",
+    "@objectstack/cli": "^3.0.3",
+    "@objectstack/core": "^3.0.3",
+    "@objectstack/plugin-auth": "^3.0.3",
+    "@objectstack/plugin-hono-server": "^3.0.3",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^20.10.0",
     "@types/supertest": "^6.0.3",
@@ -61,7 +61,7 @@
   "version": "4.2.0",
   "dependencies": {
     "@objectql/protocol-json-rpc": "workspace:*",
-    "@objectstack/studio": "^3.0.2",
+    "@objectstack/studio": "^3.0.3",
     "build": "^0.1.4"
   }
 }

packages/drivers/excel/package.json

@@ -29,7 +29,7 @@
   "dependencies": {
     "@objectql/driver-memory": "workspace:*",
     "@objectql/types": "workspace:*",
-    "@objectstack/spec": "^3.0.2",
+    "@objectstack/spec": "^3.0.3",
     "exceljs": "^4.4.0",
     "zod": "^4.3.6"
   },

packages/drivers/fs/package.json

@@ -34,7 +34,7 @@
   "dependencies": {
     "@objectql/driver-memory": "workspace:*",
     "@objectql/types": "workspace:*",
-    "@objectstack/spec": "^3.0.2",
+    "@objectstack/spec": "^3.0.3",
     "zod": "^4.3.6"
   },
   "devDependencies": {

packages/drivers/memory/package.json

@@ -28,7 +28,7 @@
   },
   "dependencies": {
     "@objectql/types": "workspace:*",
-    "@objectstack/spec": "^3.0.2",
+    "@objectstack/spec": "^3.0.3",
     "mingo": "^7.1.1",
     "zod": "^4.3.6"
   },

packages/drivers/mongo/package.json

@@ -28,7 +28,7 @@
   },
   "dependencies": {
     "@objectql/types": "workspace:*",
-    "@objectstack/spec": "^3.0.2",
+    "@objectstack/spec": "^3.0.3",
     "mongodb": "^5.9.2"
   },
   "devDependencies": {

packages/drivers/pg-wasm/package.json

@@ -34,7 +34,7 @@
     "@electric-sql/pglite": "^0.1.5",
     "@objectql/driver-sql": "workspace:*",
     "@objectql/types": "workspace:*",
-    "@objectstack/spec": "^3.0.2",
+    "@objectstack/spec": "^3.0.3",
     "knex": "^3.1.0",
     "nanoid": "^3.3.11",
     "zod": "^4.3.6"

packages/drivers/redis/package.json

@@ -27,7 +27,7 @@
   },
   "dependencies": {
     "@objectql/types": "workspace:*",
-    "@objectstack/spec": "^3.0.2",
+    "@objectstack/spec": "^3.0.3",
     "redis": "^4.6.0",
     "zod": "^4.3.6"
   },

packages/drivers/sdk/package.json

@@ -38,7 +38,7 @@
   },
   "dependencies": {
     "@objectql/types": "workspace:*",
-    "@objectstack/spec": "^3.0.2",
+    "@objectstack/spec": "^3.0.3",
     "zod": "^4.3.6"
   },
   "devDependencies": {

packages/drivers/sql/package.json

@@ -30,7 +30,7 @@
   },
   "dependencies": {
     "@objectql/types": "workspace:*",
-    "@objectstack/spec": "^3.0.2",
+    "@objectstack/spec": "^3.0.3",
     "knex": "^3.1.0",
     "nanoid": "^3.3.11",
     "zod": "^4.3.6"