feat: 更新架构文档，重组协议命名空间并增强描述

Author: hotlong

.github/copilot-instructions.md

@@ -75,9 +75,11 @@ export const FieldSchema = z.object({
 
 ### **Directory Structure**
 
-*   `packages/spec/src/data/`: ObjectQL (Object, Field, Validation).
+*   `packages/spec/src/data/`: ObjectQL (Object, Query, Driver).
+*   `packages/spec/src/ai/`: ObjectQL (Agent, RAG, Orchestration).
 *   `packages/spec/src/ui/`: ObjectUI (App, View, Action).
-*   `packages/spec/src/system/`: ObjectOS (Manifest, Config).
+*   `packages/spec/src/system/`: ObjectOS (Manifest, Identity, Events).
+*   `packages/spec/src/api/`: ObjectOS (Contract, Endpoint, Realtime).
 
 ---
 

ARCHITECTURE.md

@@ -23,31 +23,23 @@
 │                      ObjectOS (Control Layer)                    │
 │  Runtime Kernel - Define "How System Operates"                  │
 ├─────────────────────────────────────────────────────────────────┤
-│  • Manifest & Packaging  • Identity & Roles                     │
-│  • Plugin Lifecycle      • API Gateway                          │
-│  • Datasource Management • Webhook & Events                     │
-│  • Multi-tenancy         • License & Quota                      │
-│  • Real-time Sync        • Audit & Compliance                   │
+│  • Manifest & Packaging  • Identity & Roles (IAM)               │
+│  • Plugin Lifecycle      • Event Bus & Jobs                     │
+│  • API Gateway (Rest/GQL)• Real-time (Socket/SSE)               │
+│  • Multi-tenancy         • Audit & Compliance                   │
 └─────────────────────────────────────────────────────────────────┘
                               ▲
                               │ Execute
                               │
 ┌─────────────────────────────────────────────────────────────────┐
 │                       ObjectQL (Data Layer)                      │
-│  Abstract Query Language - Define "What Data Exists"            │
+│  Business Kernel - Define "What Data Exists"                    │
 ├─────────────────────────────────────────────────────────────────┤
-│  • Object & Field Schema • Query AST (Filter/Sort/Join)         │
+│  • Object & Field Schema • AI Agents & Orchestration            │
+│  • Query AST (Filter/Sort) • RAG & Vector Search                │
 │  • Validation Rules      • Permission & Sharing                 │
-│  • Workflow & Flow       • Trigger Context                      │
-│  • Formula & Rollup      • Dataset & Mapping                    │
+│  • Workflow & Flow       • Driver & Datasource (IO)             │
 └─────────────────────────────────────────────────────────────────┘
-                              ▲
-                              │ Translate
-                              │
-┌─────────────────────────────────────────────────────────────────┐
-│                       Driver Interface                           │
-│  Database Abstraction - Pluggable Data Backends                 │
-├─────────────────────────────────────────────────────────────────┤
 │  driver-postgres  │  driver-mongodb  │  driver-salesforce       │
 │  driver-mysql     │  driver-redis    │  driver-excel            │
 │  driver-sqlite    │  driver-s3       │  driver-airtable         │

packages/spec/README.md

@@ -22,25 +22,35 @@ pnpm install @objectstack/spec
 
 ## 📦 Architecture
 
-The specification is divided into three protocols:
+The specification is organized into five namespaces mapping to the three-layer architecture:
 
-### 1. Data Protocol (`src/data`)
-*Core Business Logic & Data Modeling*
+### 1. Data Protocol (`src/data`) - *ObjectQL*
+*Business Kernel & Data Logic*
 *   `Object`, `Field`, `Validation`
-*   `Query` (AST), `Mapping` (ETL)
+*   `Query` (AST), `Driver` (Interface), `Datasource`
 *   `Permission`, `Sharing`, `Flow`
 
-### 2. UI Protocol (`src/ui`)
+### 2. AI Protocol (`src/ai`) - *ObjectQL*
+*Intelligence & Orchestration*
+*   `Agent` (Orchestration), `RAG` (Retrieval)
+*   `Model` (Registry), `Prompt`
+
+### 3. UI Protocol (`src/ui`) - *ObjectUI*
 *Presentation & Interaction*
 *   `App`, `Page`, `View` (Grid/Kanban)
 *   `Dashboard` (Widgets), `Report`
 *   `Action` (Triggers)
 
-### 3. System Protocol (`src/system`)
-*Runtime Configuration & Security*
-*   `Manifest` (Config), `Datasource`
-*   `Role` (Hierarchy), `Identity` (Auth)
-*   `Webhook` (Integration), `Policy` (Compliance)
+### 4. System Protocol (`src/system`) - *ObjectOS*
+*Runtime Infrastructure & Security*
+*   `Manifest` (Config), `Identity` (Auth)
+*   `Role` (RBAC), `Tenant` (Isolation)
+*   `Events` (Bus), `Plugin` (Lifecycle)
+
+### 5. API Protocol (`src/api`) - *ObjectOS*
+*Connectivity & Contracts*
+*   `Contract` (DTOs), `Endpoint` (Gateway)
+*   `Discovery` (Metadata), `Realtime` (Socket)
 
 ## 📚 Usage