Refactor: Use generic property names (data/ui/system) instead of product names

Co-authored-by: xuyushun441-sys <255036401+xuyushun441-sys@users.noreply.github.com>

Author: Copilot

content/docs/objectos/runtime-capabilities.mdx

@@ -50,9 +50,9 @@ ObjectStack capabilities are organized into three subsystems that correspond to
 import type { ObjectStackCapabilities } from '@objectstack/spec';
 
 const capabilities: ObjectStackCapabilities = {
-  objectql: { /* ObjectQL capabilities */ },
-  objectui: { /* ObjectUI capabilities */ },
-  objectos: { /* ObjectOS capabilities */ },
+  data: { /* ObjectQL capabilities */ },
+  ui: { /* ObjectUI capabilities */ },
+  system: { /* ObjectOS capabilities */ },
 };
 ```
 
@@ -249,7 +249,7 @@ The **System Layer** capabilities define runtime, API, security, and platform se
 import type { ObjectStackCapabilities } from '@objectstack/spec';
 
 const productionCapabilities: ObjectStackCapabilities = {
-  objectql: {
+  data: {
     queryFilters: true,
     queryAggregations: true,
     querySorting: true,
@@ -272,7 +272,7 @@ const productionCapabilities: ObjectStackCapabilities = {
     bulkOperations: true,
     supportedDrivers: ['postgresql', 'mongodb', 'mysql'],
   },
-  objectui: {
+  ui: {
     listView: true,
     formView: true,
     kanbanView: true,
@@ -289,7 +289,7 @@ const productionCapabilities: ObjectStackCapabilities = {
     mobileOptimized: true,
     accessibility: true,
   },
-  objectos: {
+  system: {
     version: '1.0.0',
     environment: 'production',
     restApi: true,
@@ -326,7 +326,7 @@ const productionCapabilities: ObjectStackCapabilities = {
 
 ```typescript
 const developmentCapabilities: ObjectStackCapabilities = {
-  objectql: {
+  data: {
     // Basic query operations
     queryFilters: true,
     queryAggregations: true,
@@ -350,7 +350,7 @@ const developmentCapabilities: ObjectStackCapabilities = {
     bulkOperations: true,
     supportedDrivers: ['memory', 'sqlite'],
   },
-  objectui: {
+  ui: {
     listView: true,
     formView: true,
     kanbanView: false,
@@ -367,7 +367,7 @@ const developmentCapabilities: ObjectStackCapabilities = {
     mobileOptimized: false,
     accessibility: false,
   },
-  objectos: {
+  system: {
     version: '0.1.0',
     environment: 'development',
     restApi: true,
@@ -406,25 +406,25 @@ const developmentCapabilities: ObjectStackCapabilities = {
 // Helper: Check if a capability is enabled
 function hasCapability(
   capabilities: ObjectStackCapabilities,
-  subsystem: 'objectql' | 'objectui' | 'objectos',
+  subsystem: 'data' | 'ui' | 'system',
   capability: string
 ): boolean {
   const subsystemCaps = capabilities[subsystem] as any;
   return subsystemCaps?.[capability] === true;
 }
 
 // Check if vector search is available
-if (hasCapability(capabilities, 'objectql', 'vectorSearch')) {
+if (hasCapability(capabilities, 'data', 'vectorSearch')) {
   console.log('✅ Vector search is available for RAG workflows');
 }
 
 // Check if GraphQL API is enabled
-if (hasCapability(capabilities, 'objectos', 'graphqlApi')) {
+if (hasCapability(capabilities, 'system', 'graphqlApi')) {
   console.log('✅ GraphQL endpoint is available');
 }
 
 // Check if Kanban view is supported
-if (hasCapability(capabilities, 'objectui', 'kanbanView')) {
+if (hasCapability(capabilities, 'ui', 'kanbanView')) {
   console.log('✅ Kanban boards are available');
 }
 ```
@@ -442,9 +442,9 @@ The capabilities schema is typically exposed via the `/api/discovery` endpoint:
   "version": "1.0.0",
   "environment": "production",
   "capabilities": {
-    "objectql": { /* ... */ },
-    "objectui": { /* ... */ },
-    "objectos": { /* ... */ }
+    "data": { /* ... */ },
+    "ui": { /* ... */ },
+    "system": { /* ... */ }
   },
   "routes": {
     "data": "/api/data",
@@ -471,7 +471,7 @@ Design your application to gracefully handle missing capabilities:
 
 ```typescript
 // Good: Check before using advanced features
-if (capabilities.objectql.vectorSearch) {
+if (capabilities.data.vectorSearch) {
   await performSemanticSearch(query);
 } else {
   await performTextSearch(query); // Fallback
@@ -484,7 +484,7 @@ When generating code, AI agents should respect capability constraints:
 
 ```typescript
 // AI Agent checks capabilities before generating code
-if (!capabilities.objectql.queryWindowFunctions) {
+if (!capabilities.data.queryWindowFunctions) {
   // Don't generate ROW_NUMBER queries
   // Use alternative implementation
 }

examples/capabilities-example.ts

@@ -25,7 +25,7 @@ export const productionCapabilities: ObjectStackCapabilities = {
   // ============================================================================
   // ObjectQL: Data Layer Capabilities
   // ============================================================================
-  objectql: {
+  data: {
     // Query Operations
     queryFilters: true,
     queryAggregations: true,
@@ -63,7 +63,7 @@ export const productionCapabilities: ObjectStackCapabilities = {
   // ============================================================================
   // ObjectUI: User Interface Layer Capabilities
   // ============================================================================
-  objectui: {
+  ui: {
     // View Types
     listView: true,
     formView: true,
@@ -93,7 +93,7 @@ export const productionCapabilities: ObjectStackCapabilities = {
   // ============================================================================
   // ObjectOS: System Layer Capabilities
   // ============================================================================
-  objectos: {
+  system: {
     // System Identity
     version: '1.0.0',
     environment: 'production',
@@ -153,7 +153,7 @@ export const productionCapabilities: ObjectStackCapabilities = {
  * Many advanced features are disabled to simplify the runtime.
  */
 export const developmentCapabilities: ObjectStackCapabilities = {
-  objectql: {
+  data: {
     // Basic query operations only
     queryFilters: true,
     queryAggregations: true,
@@ -188,7 +188,7 @@ export const developmentCapabilities: ObjectStackCapabilities = {
     supportedDrivers: ['memory', 'sqlite'],
   },
 
-  objectui: {
+  ui: {
     // Basic views
     listView: true,
     formView: true,
@@ -215,7 +215,7 @@ export const developmentCapabilities: ObjectStackCapabilities = {
     accessibility: false,
   },
 
-  objectos: {
+  system: {
     version: '0.1.0',
     environment: 'development',
 
@@ -273,7 +273,7 @@ export const developmentCapabilities: ObjectStackCapabilities = {
  * Configuration optimized for AI/ML workloads with RAG and vector search.
  */
 export const aiCapabilities: ObjectStackCapabilities = {
-  objectql: {
+  data: {
     queryFilters: true,
     queryAggregations: true,
     querySorting: true,
@@ -304,7 +304,7 @@ export const aiCapabilities: ObjectStackCapabilities = {
     supportedDrivers: ['postgresql', 'pinecone', 'chromadb'],
   },
 
-  objectui: {
+  ui: {
     // Standard UI capabilities
     listView: true,
     formView: true,
@@ -327,7 +327,7 @@ export const aiCapabilities: ObjectStackCapabilities = {
     accessibility: false,
   },
 
-  objectos: {
+  system: {
     version: '1.2.0',
     environment: 'production',
 
@@ -374,7 +374,7 @@ export const aiCapabilities: ObjectStackCapabilities = {
  */
 export function hasCapability(
   capabilities: ObjectStackCapabilities,
-  subsystem: 'objectql' | 'objectui' | 'objectos',
+  subsystem: 'data' | 'ui' | 'system',
   capability: string
 ): boolean {
   const subsystemCaps = capabilities[subsystem] as any;
@@ -386,7 +386,7 @@ export function hasCapability(
  */
 export function getEnabledCapabilities(
   capabilities: ObjectStackCapabilities,
-  subsystem: 'objectql' | 'objectui' | 'objectos'
+  subsystem: 'data' | 'ui' | 'system'
 ): string[] {
   const subsystemCaps = capabilities[subsystem] as any;
   return Object.keys(subsystemCaps).filter((key) => subsystemCaps[key] === true);
@@ -397,20 +397,20 @@ export function getEnabledCapabilities(
 // ============================================================================
 
 // Example: Check if vector search is available
-if (hasCapability(productionCapabilities, 'objectql', 'vectorSearch')) {
+if (hasCapability(productionCapabilities, 'data', 'vectorSearch')) {
   console.log('✅ Vector search is available for RAG workflows');
 }
 
 // Example: Get all enabled ObjectUI capabilities
-const uiFeatures = getEnabledCapabilities(productionCapabilities, 'objectui');
+const uiFeatures = getEnabledCapabilities(productionCapabilities, 'ui');
 console.log('Enabled UI features:', uiFeatures);
 
 // Example: Compare capabilities between environments
 console.log(
   'Production has GraphQL?',
-  hasCapability(productionCapabilities, 'objectos', 'graphqlApi')
+  hasCapability(productionCapabilities, 'system', 'graphqlApi')
 );
 console.log(
   'Development has GraphQL?',
-  hasCapability(developmentCapabilities, 'objectos', 'graphqlApi')
+  hasCapability(developmentCapabilities, 'system', 'graphqlApi')
 );

packages/spec/src/stack.test.ts

@@ -258,7 +258,7 @@ describe('ObjectOSCapabilitiesSchema', () => {
 describe('ObjectStackCapabilitiesSchema', () => {
   it('should accept complete ObjectStack capabilities with all subsystems', () => {
     const capabilities: ObjectStackCapabilities = {
-      objectql: {
+      data: {
         queryFilters: true,
         queryAggregations: true,
         querySorting: true,
@@ -281,7 +281,7 @@ describe('ObjectStackCapabilitiesSchema', () => {
         bulkOperations: true,
         supportedDrivers: ['postgresql', 'mongodb'],
       },
-      objectui: {
+      ui: {
         listView: true,
         formView: true,
         kanbanView: true,
@@ -298,7 +298,7 @@ describe('ObjectStackCapabilitiesSchema', () => {
         mobileOptimized: true,
         accessibility: false,
       },
-      objectos: {
+      system: {
         version: '1.0.0',
         environment: 'production',
         restApi: true,
@@ -336,16 +336,16 @@ describe('ObjectStackCapabilitiesSchema', () => {
 
     expect(() =>
       ObjectStackCapabilitiesSchema.parse({
-        objectql: {},
-        objectui: {},
+        data: {},
+        ui: {},
       })
     ).toThrow();
 
     expect(() =>
       ObjectStackCapabilitiesSchema.parse({
-        objectql: {},
-        objectui: {},
-        objectos: {
+        data: {},
+        ui: {},
+        system: {
           version: '1.0.0',
           environment: 'development',
         },
@@ -355,9 +355,9 @@ describe('ObjectStackCapabilitiesSchema', () => {
 
   it('should allow minimal valid configuration', () => {
     const minimal: ObjectStackCapabilities = {
-      objectql: {},
-      objectui: {},
-      objectos: {
+      data: {},
+      ui: {},
+      system: {
         version: '0.1.0',
         environment: 'development',
       },
@@ -366,18 +366,18 @@ describe('ObjectStackCapabilitiesSchema', () => {
     const result = ObjectStackCapabilitiesSchema.parse(minimal);
 
     // Check that defaults are applied
-    expect(result.objectql.queryFilters).toBe(true);
-    expect(result.objectui.listView).toBe(true);
-    expect(result.objectos.restApi).toBe(true);
+    expect(result.data.queryFilters).toBe(true);
+    expect(result.ui.listView).toBe(true);
+    expect(result.system.restApi).toBe(true);
   });
 
   it('should preserve subsystem-specific optional fields', () => {
     const capabilities = ObjectStackCapabilitiesSchema.parse({
-      objectql: {
+      data: {
         supportedDrivers: ['postgresql', 'sqlite'],
       },
-      objectui: {},
-      objectos: {
+      ui: {},
+      system: {
         version: '1.0.0',
         environment: 'production',
         systemObjects: ['user', 'role'],
@@ -387,9 +387,9 @@ describe('ObjectStackCapabilitiesSchema', () => {
       },
     });
 
-    expect(capabilities.objectql.supportedDrivers).toEqual(['postgresql', 'sqlite']);
-    expect(capabilities.objectos.systemObjects).toEqual(['user', 'role']);
-    expect(capabilities.objectos.limits?.maxObjects).toBe(100);
+    expect(capabilities.data.supportedDrivers).toEqual(['postgresql', 'sqlite']);
+    expect(capabilities.system.systemObjects).toEqual(['user', 'role']);
+    expect(capabilities.system.limits?.maxObjects).toBe(100);
   });
 });
 

packages/spec/src/stack.zod.ts

@@ -276,17 +276,17 @@ export const ObjectOSCapabilitiesSchema = z.object({
  * Unified ObjectStack Capabilities Schema
  * 
  * Complete capability descriptor for an ObjectStack instance.
- * Organized by subsystem for clarity and maintainability.
+ * Organized by architectural layer for clarity and maintainability.
  */
 export const ObjectStackCapabilitiesSchema = z.object({
-  /** ObjectQL: Data Layer Capabilities */
-  objectql: ObjectQLCapabilitiesSchema.describe('Data Layer capabilities'),
+  /** Data Layer Capabilities (ObjectQL) */
+  data: ObjectQLCapabilitiesSchema.describe('Data Layer capabilities'),
 
-  /** ObjectUI: User Interface Layer Capabilities */
-  objectui: ObjectUICapabilitiesSchema.describe('UI Layer capabilities'),
+  /** User Interface Layer Capabilities (ObjectUI) */
+  ui: ObjectUICapabilitiesSchema.describe('UI Layer capabilities'),
 
-  /** ObjectOS: System Layer Capabilities */
-  objectos: ObjectOSCapabilitiesSchema.describe('System/Runtime Layer capabilities'),
+  /** System/Runtime Layer Capabilities (ObjectOS) */
+  system: ObjectOSCapabilitiesSchema.describe('System/Runtime Layer capabilities'),
 });
 
 export type ObjectQLCapabilities = z.infer<typeof ObjectQLCapabilitiesSchema>;