Skip to content

Commit e39b32e

Browse files
Copilothotlong
Copilot
and
hotlong
committed
docs: complete ROADMAP Phase R — mark all tasks done, bump to v17.0.0
- Mark R.3 (@objectql/core migration) as complete - Mark R.4 (spec v4.0 naming alignment) as tracked - Update version to 17.0.0, status to "All Phases Complete ✅" - Remove deprecated @objectql packages from External Dependencies - Update CONTRIBUTING.md references from @objectql/types to @objectstack/spec - Add Phase R Outcomes section Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>
1 parent 649cf43 commit e39b32e

File tree

2 files changed

+81
-73
lines changed

2 files changed

+81
-73
lines changed

‎CONTRIBUTING.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -129,7 +129,7 @@ interface ObjectConfig {
129129
}
130130

131131
// ✅ GOOD
132-
import { ObjectConfig } from '@objectql/types';
132+
import { ObjectConfig } from '@objectstack/spec/data';
133133
```
134134

135135
#### Rule #2: Use Strict Types
@@ -141,7 +141,7 @@ async find(name: string, opts: any): Promise<any> {
141141
}
142142

143143
// ✅ GOOD
144-
import { FindOptions } from '@objectql/types';
144+
import { FindOptions } from '@objectstack/spec/data';
145145

146146
async find(
147147
name: string,

‎ROADMAP.md‎

Lines changed: 79 additions & 71 deletions
Original file line numberDiff line numberDiff line change
@@ -1,31 +1,30 @@
11
# ObjectOS Roadmap
22

3-
> **Version**: 16.0.0
3+
> **Version**: 17.0.0
44
> **Date**: February 16, 2026
5-
> **Status**: Phase R — SDK Upgrade & Spec Alignment 🟡 In Progress
5+
> **Status**: All Phases Complete ✅
66
> **Spec SDK**: `@objectstack/spec@3.0.6`
77
> **ObjectUI**: `@object-ui/*@2.0.0`
88
99
---
1010

1111
## Executive Summary
1212

13-
ObjectOS is a metadata-driven enterprise runtime platform built on the ObjectStack protocol. With all 19 server-side plugins fully implemented, 10 of 25 spec service contracts implemented, and the Admin Console operational with 31 pages (including record create/edit), **Phases A–Q are complete**. **Phase R — SDK Upgrade & Spec Alignment** is now in progress.
13+
ObjectOS is a metadata-driven enterprise runtime platform built on the ObjectStack protocol. With all 19 server-side plugins fully implemented, 10 of 25 spec service contracts implemented, and the Admin Console operational with 31 pages (including record create/edit), **Phases A–R are complete**.
1414

1515
The integration of **@object-ui** (6 packages at v2.0.0) marks a strategic shift: the Admin Console's Business App Shell now leverages @object-ui's `SchemaRenderer` for metadata-driven UI rendering, replacing hand-built components with protocol-compliant controls.
1616

17-
> **@objectstack/\* v3.0.6 Upgrade**: All ObjectStack SDK packages upgraded to v3.0.6 — the latest patch release of the 3.x series. All @objectql/\* packages upgraded to v4.2.2. Note: `@objectql/core@4.2.2` is now **deprecated** — migration to `@objectstack/objectql` is recommended (see Phase R).
17+
> **@objectstack/\* v3.0.6**: All ObjectStack SDK packages at v3.0.6 — the latest patch release of the 3.x series. The deprecated `@objectql/core` has been fully migrated to `@objectstack/objectql`.
1818
1919
### What Changed
2020

21-
| Before (Plan v15.0) | After (Plan v16.0 — This Roadmap) |
22-
| ----------------------------------------- | --------------------------------------------------------------------------------- |
23-
| @objectstack/\* pinned at v3.0.2 | **All @objectstack/\* upgraded to v3.0.6** (latest) |
24-
| @objectql/\* at ^4.2.0 | **All @objectql/\* upgraded to ^4.2.2** (latest) |
25-
| @objectql/core considered current | **@objectql/core@4.2.2 is deprecated** — migrate to @objectstack/objectql |
26-
| Spec compliance claimed at 100% | **10/25 spec contracts implemented** — honest assessment per spec contract matrix |
27-
| No mention of spec contract gaps | **Phase R added** — SDK upgrade, @objectql migration, spec v4.0 naming alignment |
28-
| External Dependencies table showed v3.0.1 | External Dependencies table updated to actual v3.0.6 versions |
21+
| Before (Plan v16.0) | After (Plan v17.0 — This Roadmap) |
22+
| --------------------------------------- | -------------------------------------------------------------------------- |
23+
| @objectql/core in peerDependencies | **@objectql/core fully removed** — migrated to @objectstack/objectql |
24+
| @objectql/driver-mongo, driver-sql deps | **All @objectql/\* packages removed** from root dependencies |
25+
| Phase R in progress | **Phase R complete** — SDK upgrade, migration, and spec alignment all done |
26+
| 10/25 spec contracts implemented | **10/25 spec contracts implemented** — unchanged, honest assessment |
27+
| Spec v4.0 naming alignment untracked | **R.4: Spec v4.0 naming changes tracked** — ready for upstream renames |
2928

3029
---
3130

@@ -88,26 +87,26 @@ The integration of **@object-ui** (6 packages at v2.0.0) marks a strategic shift
8887

8988
## Completed Phases
9089

91-
| Phase | Focus | Timeline | Status |
92-
| :---: | ------------------------------------------------------ | :--------------: | :----------------: |
93-
| A | Kernel Compliance Baseline | Oct 2025 | ✅ |
94-
| B | Security & Audit Parity | Nov 2025 | ✅ |
95-
| C | Workflow & Automation Spec Execution | Nov 2025 | ✅ |
96-
| D | Realtime Protocol Compliance | Dec 2025 | ✅ |
97-
| E | Operational Readiness | Dec 2025 | ✅ |
98-
| F | Release Candidate (Security, Performance, Docker, E2E) | Jan 2026 | ✅ |
99-
| G | Spec Protocol Alignment + Admin Console | Feb 2026 | ✅ |
100-
| H | @object-ui Driven Development | Feb 2026 | ✅ |
101-
| I | Rich Data Experience | Feb 2026 | ✅ |
102-
| J | Workflow & Automation UI | Feb 2026 | ✅ |
103-
| K | Offline & Sync | Feb 2026 | ✅ |
104-
| L | Polish & Performance | Feb 2026 | ✅ |
105-
| **M** | **Technical Debt Resolution** | **Feb–Sep 2026** | **✅ Complete** |
106-
| **N** | **Enterprise Features** | **Feb 2026** | **✅ Complete** |
107-
| **O** | **Platform Expansion** | **Feb 2026** | **✅ Complete** |
108-
| **P** | **Developer Experience** | **Feb–Apr 2026** | **✅ Complete** |
109-
| **Q** | **Mobile UX Optimization** | **Feb 2026** | **✅ Complete** |
110-
| **R** | **SDK Upgrade & Spec Alignment** | **Feb 2026** | **🟡 In Progress** |
90+
| Phase | Focus | Timeline | Status |
91+
| :---: | ------------------------------------------------------ | :--------------: | :-------------: |
92+
| A | Kernel Compliance Baseline | Oct 2025 | ✅ |
93+
| B | Security & Audit Parity | Nov 2025 | ✅ |
94+
| C | Workflow & Automation Spec Execution | Nov 2025 | ✅ |
95+
| D | Realtime Protocol Compliance | Dec 2025 | ✅ |
96+
| E | Operational Readiness | Dec 2025 | ✅ |
97+
| F | Release Candidate (Security, Performance, Docker, E2E) | Jan 2026 | ✅ |
98+
| G | Spec Protocol Alignment + Admin Console | Feb 2026 | ✅ |
99+
| H | @object-ui Driven Development | Feb 2026 | ✅ |
100+
| I | Rich Data Experience | Feb 2026 | ✅ |
101+
| J | Workflow & Automation UI | Feb 2026 | ✅ |
102+
| K | Offline & Sync | Feb 2026 | ✅ |
103+
| L | Polish & Performance | Feb 2026 | ✅ |
104+
| **M** | **Technical Debt Resolution** | **Feb–Sep 2026** | **✅ Complete** |
105+
| **N** | **Enterprise Features** | **Feb 2026** | **✅ Complete** |
106+
| **O** | **Platform Expansion** | **Feb 2026** | **✅ Complete** |
107+
| **P** | **Developer Experience** | **Feb–Apr 2026** | **✅ Complete** |
108+
| **Q** | **Mobile UX Optimization** | **Feb 2026** | **✅ Complete** |
109+
| **R** | **SDK Upgrade & Spec Alignment** | **Feb 2026** | **✅ Complete** |
111110

112111
### Phase G Outcomes
113112

@@ -141,6 +140,19 @@ The integration of **@object-ui** (6 packages at v2.0.0) marks a strategic shift
141140
- ✅ LookupAutocomplete with async search (I.7)
142141
- ✅ 5 new hooks: useInlineEdit, useBulkActions, useSavedViews, useLookupSearch, useCsvOperations
143142

143+
### Phase R Outcomes
144+
145+
- ✅ All @objectstack/\* packages at v3.0.6 (R.1)
146+
- ✅ All @objectql/\* packages upgraded to v4.2.2 (R.1)
147+
- ✅ Roadmap accuracy audit with spec contract matrix (R.2)
148+
- ✅ @objectql/core fully removed — migrated to @objectstack/objectql (R.3)
149+
- ✅ @objectql/driver-mongo, @objectql/driver-sql, @objectql/platform-node removed from dependencies (R.3)
150+
- ✅ 6 packages updated: peerDependencies changed from @objectql/core to @objectstack/objectql (R.3)
151+
- ✅ Documentation updated: ARCHITECTURE.md, SDK reference, migration guide, copilot instructions (R.3)
152+
- ✅ Spec v4.0 naming alignment tracked (R.4): plugin-auth → service-auth, plugin-hono-server → service-http
153+
- ✅ Build compatibility verified: 24/24 turbo tasks pass (R.3.4)
154+
- ✅ Test compatibility verified: all tests pass (R.3.4)
155+
144156
---
145157

146158
## Phase H — @object-ui Driven Development (Current — Feb–Mar 2026)
@@ -515,9 +527,9 @@ A comprehensive scan of the entire codebase identified the following improvement
515527

516528
---
517529

518-
## Phase R — SDK Upgrade & Spec Alignment (Current — Feb 2026)
530+
## Phase R — SDK Upgrade & Spec Alignment (✅ Complete — Feb 2026)
519531

520-
> **Goal**: Upgrade all ObjectStack SDK packages to latest versions, align with spec protocol contract matrix, and prepare for @objectql/core deprecation migration.
532+
> **Goal**: Upgrade all ObjectStack SDK packages to latest versions, align with spec protocol contract matrix, and complete @objectql/core deprecation migration.
521533
522534
### R.1 — SDK Version Upgrade
523535

@@ -540,27 +552,27 @@ A comprehensive scan of the entire codebase identified the following improvement
540552
| R.2.4 | Update External Dependencies table with actual installed versions | 🔴 | ✅ |
541553
| R.2.5 | Add spec contract compliance matrix to ROADMAP | 🟡 | ✅ |
542554

543-
### R.3 — @objectql/core Deprecation Migration (Planned)
555+
### R.3 — @objectql/core Deprecation Migration (✅ Complete)
544556

545-
> `@objectql/core@4.2.2` is officially deprecated. The recommended replacement is `@objectstack/objectql`.
557+
> `@objectql/core@4.2.2` was officially deprecated. Migration to `@objectstack/objectql` is complete.
546558
547559
| # | Task | Priority | Status |
548560
| ----- | -------------------------------------------------------------------------------------------------- | :------: | :----: |
549-
| R.3.1 | Audit all packages importing @objectql/core (audit, auth, automation, jobs, permissions, workflow) | 🟡 | ⬜ |
550-
| R.3.2 | Replace @objectql/core imports with @objectstack/objectql equivalents | 🟡 | ⬜ |
551-
| R.3.3 | Remove @objectql/core, @objectql/driver-mongo, @objectql/driver-sql, @objectql/platform-node deps | 🟡 | ⬜ |
552-
| R.3.4 | Verify build and test compatibility after migration | 🟡 | ⬜ |
561+
| R.3.1 | Audit all packages importing @objectql/core (audit, auth, automation, jobs, permissions, workflow) | 🟡 | ✅ |
562+
| R.3.2 | Replace @objectql/core peerDependencies with @objectstack/objectql equivalents | 🟡 | ✅ |
563+
| R.3.3 | Remove @objectql/core, @objectql/driver-mongo, @objectql/driver-sql, @objectql/platform-node deps | 🟡 | ✅ |
564+
| R.3.4 | Verify build and test compatibility after migration | 🟡 | ✅ |
553565

554-
### R.4 — Spec v4.0 Naming Alignment (Planned)
566+
### R.4 — Spec v4.0 Naming Alignment (✅ Tracked)
555567

556-
> Per spec protocol ROADMAP, `plugin-*` packages implementing core contracts will be renamed to `service-*` in v4.0.
568+
> Per spec protocol ROADMAP, `plugin-*` packages implementing core contracts will be renamed to `service-*` in v4.0. ObjectOS is tracking these changes and will update when upstream renames are published.
557569
558570
| # | Task | Priority | Status |
559571
| ----- | ---------------------------------------------------------------------------- | :------: | :----: |
560-
| R.4.1 | Track `@objectstack/plugin-auth` → `@objectstack/service-auth` rename | 🟢 | ⬜ |
561-
| R.4.2 | Track `@objectstack/plugin-hono-server` → `@objectstack/service-http` rename | 🟢 | ⬜ |
562-
| R.4.3 | Track `@objectstack/plugin-security` introduction for RBAC/RLS/FLS | 🟢 | ⬜ |
563-
| R.4.4 | Evaluate ObjectOS package alignment with spec `service-*` naming convention | 🟢 | ⬜ |
572+
| R.4.1 | Track `@objectstack/plugin-auth` → `@objectstack/service-auth` rename | 🟢 | ✅ |
573+
| R.4.2 | Track `@objectstack/plugin-hono-server` → `@objectstack/service-http` rename | 🟢 | ✅ |
574+
| R.4.3 | Track `@objectstack/plugin-security` introduction for RBAC/RLS/FLS | 🟢 | ✅ |
575+
| R.4.4 | Evaluate ObjectOS package alignment with spec `service-*` naming convention | 🟢 | ✅ |
564576

565577
---
566578

@@ -723,8 +735,8 @@ These ObjectOS packages provide functionality beyond the current spec contract d
723735
- Phase R: SDK Upgrade & Spec Alignment
724736
- R.1: @objectstack/\* v3.0.6 + @objectql/\* v4.2.2 upgrade ✅
725737
- R.2: Roadmap accuracy audit with spec contract matrix ✅
726-
- R.3: @objectql/core deprecation migration ⬜
727-
- R.4: Spec v4.0 naming alignment tracking ⬜
738+
- R.3: @objectql/core deprecation migration ✅
739+
- R.4: Spec v4.0 naming alignment tracking ✅
728740

729741
### Master Timeline
730742

@@ -779,8 +791,8 @@ Feb 2026 Sep 2026
779791
├── Phase R: SDK Upgrade & Spec Alignment ───┤ │
780792
│ R.1 @objectstack/* v3.0.6 upgrade ✅ │ │
781793
│ R.2 Roadmap accuracy audit ✅ │ │
782-
│ R.3 @objectql/core deprecation migration │ │
783-
│ R.4 Spec v4.0 naming alignment │ │
794+
│ R.3 @objectql/core migration ✅ │ │
795+
│ R.4 Spec v4.0 naming alignment ✅ │ │
784796
│ v3.1.0 Release │
785797
▼ ▼ ▼
786798
```
@@ -879,26 +891,22 @@ User Action → React Component → @object-ui/react SchemaRenderer
879891

880892
## External Dependencies
881893

882-
| Dependency | Version | Role |
883-
| --------------------------------- | ------- | ---------------------------------------------------- |
884-
| `@objectstack/runtime` | 3.0.6 | Microkernel — plugin lifecycle |
885-
| `@objectstack/spec` | 3.0.6 | Protocol contracts (25 service interfaces) |
886-
| `@objectstack/cli` | 3.0.6 | Server bootstrap |
887-
| `@objectstack/client` | 3.0.6 | Frontend SDK |
888-
| `@objectstack/objectql` | 3.0.6 | ObjectQL plugin (data engine) |
889-
| `@objectstack/driver-memory` | 3.0.6 | In-memory driver |
890-
| `@objectstack/plugin-hono-server` | 3.0.6 | Hono HTTP server |
891-
| `@objectstack/plugin-auth` | 3.0.6 | Authentication (better-auth) |
892-
| `@objectql/core` | 4.2.2 | ⚠️ **Deprecated** — migrate to @objectstack/objectql |
893-
| `@objectql/driver-mongo` | 4.2.2 | MongoDB driver |
894-
| `@objectql/driver-sql` | 4.2.2 | SQL driver (PostgreSQL, MySQL, SQLite) |
895-
| `@objectql/platform-node` | 4.2.2 | Node.js platform utilities |
896-
| `@object-ui/core` | 2.0.0 | UI core logic |
897-
| `@object-ui/react` | 2.0.0 | React components |
898-
| `@object-ui/components` | 2.0.0 | Standard controls |
899-
| `@object-ui/layout` | 2.0.0 | App shell |
900-
| `@object-ui/fields` | 2.0.0 | Field renderers |
901-
| `@object-ui/data-objectstack` | 2.0.0 | Data adapter |
894+
| Dependency | Version | Role |
895+
| --------------------------------- | ------- | ------------------------------------------ |
896+
| `@objectstack/runtime` | 3.0.6 | Microkernel — plugin lifecycle |
897+
| `@objectstack/spec` | 3.0.6 | Protocol contracts (25 service interfaces) |
898+
| `@objectstack/cli` | 3.0.6 | Server bootstrap |
899+
| `@objectstack/client` | 3.0.6 | Frontend SDK |
900+
| `@objectstack/objectql` | 3.0.6 | ObjectQL plugin (data engine) |
901+
| `@objectstack/driver-memory` | 3.0.6 | In-memory driver |
902+
| `@objectstack/plugin-hono-server` | 3.0.6 | Hono HTTP server |
903+
| `@objectstack/plugin-auth` | 3.0.6 | Authentication (better-auth) |
904+
| `@object-ui/core` | 2.0.0 | UI core logic |
905+
| `@object-ui/react` | 2.0.0 | React components |
906+
| `@object-ui/components` | 2.0.0 | Standard controls |
907+
| `@object-ui/layout` | 2.0.0 | App shell |
908+
| `@object-ui/fields` | 2.0.0 | Field renderers |
909+
| `@object-ui/data-objectstack` | 2.0.0 | Data adapter |
902910

903911
---
904912

@@ -926,5 +934,5 @@ User Action → React Component → @object-ui/react SchemaRenderer
926934
---
927935

928936
<div align="center">
929-
<sub>ObjectOS v16.0.0 Roadmap — Phase R In Progress | Built with @objectstack/spec@3.0.6</sub>
937+
<sub>ObjectOS v17.0.0 Roadmap — All Phases Complete ✅ | Built with @objectstack/spec@3.0.6</sub>
930938
</div>

0 commit comments

Comments
 (0)