feat: Refactor ObjectOS structure and update object registry references

Author: hotlong

packages/objectos/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@objectstack/objectos",
   "version": "0.1.0",
-  "description": "ObjectOS - System Runtime Object Definitions",
+  "description": "ObjectOS runtime metadata object registry",
   "license": "Apache-2.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -10,11 +10,6 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs",
       "require": "./dist/index.js"
-    },
-    "./objects": {
-      "types": "./dist/objects/index.d.ts",
-      "import": "./dist/objects/index.mjs",
-      "require": "./dist/objects/index.js"
     }
   },
   "files": [

packages/objectos/src/index.ts

@@ -3,16 +3,16 @@
 /**
  * @objectstack/objectos
  *
- * ObjectOS - System Runtime Object Definitions
+ * ObjectOS - Runtime metadata object registry
  *
- * This package contains the core system object definitions that form
- * the foundation of the ObjectStack platform. These objects represent
- * the metadata layer itself (objects, views, flows, agents, etc.) as
- * queryable data.
+ * This package contains the runtime registry for ObjectOS metadata-layer
+ * objects. Concrete platform object definitions live in
+ * `@objectstack/platform-objects`.
  *
  * ## Architecture
  * - Protocol Layer: `@objectstack/spec` — Zod schemas (ObjectSchema, ViewSchema)
- * - Runtime Layer: `@objectstack/objectos` — Concrete system objects (SysObject, SysView)
+ * - Platform Object Layer: `@objectstack/platform-objects` — Concrete platform objects
+ * - Runtime Layer: `@objectstack/objectos` — Runtime-facing object registry
  * - Service Layer: `@objectstack/metadata` — Metadata management service
  *
  * ## Usage
@@ -37,5 +37,4 @@
  * @module @objectstack/objectos
  */
 
-export * from './objects';
 export * from './registry';

packages/objectos/src/objects/index.ts

@@ -0,0 +1,29 @@
+// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
+
+import { describe, expect, it } from 'vitest';
+import {
+  getSystemObject,
+  getSystemObjectNames,
+  getSystemObjects,
+  SystemObjects,
+  SysMetadata,
+} from './registry';
+
+describe('ObjectOS system object registry', () => {
+  it('registers metadata-layer platform objects by canonical name', () => {
+    expect(getSystemObjectNames()).toEqual([
+      'sys_object',
+      'sys_view',
+      'sys_flow',
+      'sys_agent',
+      'sys_tool',
+    ]);
+    expect(getSystemObject('sys_object')?.name).toBe('sys_object');
+    expect(getSystemObjects()).toHaveLength(5);
+  });
+
+  it('keeps sys_metadata separate from the queryable registry', () => {
+    expect(SysMetadata.name).toBe('sys_metadata');
+    expect(SystemObjects).not.toHaveProperty('sys_metadata');
+  });
+});

packages/objectos/src/objects/sys-metadata.object.test.ts

@@ -8,7 +8,7 @@ import {
   SysAgent,
   SysTool,
   SysFlow,
-} from './objects';
+} from '@objectstack/platform-objects/metadata';
 
 /**
  * System Object Registry
@@ -94,4 +94,3 @@ export function getSystemObject(name: string): ServiceObject | undefined {
 export function getSystemObjectNames(): string[] {
   return Object.keys(SystemObjects);
 }
-

packages/objectos/src/registry.test.ts

@@ -5,7 +5,6 @@ import { defineConfig } from 'tsup';
 export default defineConfig({
   entry: {
     index: 'src/index.ts',
-    'objects/index': 'src/objects/index.ts',
   },
   format: ['cjs', 'esm'],
   dts: true,

packages/objectos/src/registry.ts

@@ -25,7 +25,6 @@ import {
   SysProject,
   SysProjectCredential,
   SysProjectMember,
-  SysTenantDatabase,
 } from './tenant/index.js';
 import {
   SysAgent,
@@ -61,7 +60,6 @@ const systemObjects = [
   ['SysPackage', SysPackage, 'sys_package'],
   ['SysPackageVersion', SysPackageVersion, 'sys_package_version'],
   ['SysPackageInstallation', SysPackageInstallation, 'sys_package_installation'],
-  ['SysTenantDatabase', SysTenantDatabase, 'sys_tenant_database'],
   ['SysMetadata', SysMetadata, 'sys_metadata'],
   ['SysMetadataHistoryObject', SysMetadataHistoryObject, 'sys_metadata_history'],
   ['SysObject', SysObject, 'sys_object'],

packages/objectos/tsup.config.ts

@@ -11,6 +11,3 @@ export * from './sys-app.object.js';
 export * from './sys-package.object.js';
 export * from './sys-package-version.object.js';
 export * from './sys-package-installation.object.js';
-
-// v4.x deprecation shim — removed in v5.0
-export * from './sys-tenant-database.object.js';