Merge pull request #99 from objectstack-ai/copilot/update-docs-excluding-generated

Author: hotlong

.github/prompts/data-protocol.prompt.md

@@ -345,7 +345,7 @@ export type Main = z.infer<typeof MainSchema>;
 ## Interaction Commands
 
 When user says:
-- **"Create Field Protocol"** → Implement complete `field.zod.ts` with all 23+ field types
+- **"Create Field Protocol"** → Implement complete `field.zod.ts` with all 35 field types
 - **"Create Object Protocol"** → Implement `object.zod.ts` with fields, capabilities, indexes
 - **"Create Validation Rules"** → Implement `validation.zod.ts` with rule engine
 - **"Create Permission System"** → Implement `permission.zod.ts` with CRUD + field-level security

.github/prompts/documentation-writer.prompt.md

@@ -80,7 +80,7 @@ a single property or column in an Object (table).
 
 ## Field Types
 
-ObjectStack supports 23+ field types, organized into categories:
+ObjectStack supports 35 field types, organized into categories:
 
 ### Text Fields
 - **text**: Single-line text (max 255 characters)

ARCHITECTURE.md

@@ -69,9 +69,10 @@
 │   ├── workflow.zod.ts       → State machine, transitions
 │   ├── flow.zod.ts           → Visual flow automation
 │   ├── query.zod.ts          → AST for queries (filter, sort, join)
+│   ├── filter.zod.ts         → Query filter conditions
 │   ├── dataset.zod.ts        → Virtual datasets
 │   ├── mapping.zod.ts        → ETL transformations
-│   └── trigger.zod.ts        → [MISSING] Trigger context
+│   └── trigger.zod.ts        → Trigger context
 │
 ├── UI Protocol (ObjectUI)
 │   ├── app.zod.ts            → App structure, navigation tree
@@ -80,8 +81,8 @@
 │   ├── report.zod.ts         → Report types, grouping
 │   ├── action.zod.ts         → Button actions, navigation
 │   ├── page.zod.ts           → FlexiPage regions, components
-│   ├── theme.zod.ts          → [MISSING] Color, typography, spacing
-│   └── widget.zod.ts         → [MISSING] Custom field components
+│   ├── theme.zod.ts          → Color, typography, spacing
+│   └── widget.zod.ts         → Custom field components
 │
 ├── System Protocol (ObjectOS)
 │   ├── manifest.zod.ts       → Package definition (objectstack.config.ts)
@@ -95,18 +96,24 @@
 │   ├── webhook.zod.ts        → HTTP callbacks
 │   ├── translation.zod.ts    → i18n definitions
 │   ├── discovery.zod.ts      → Metadata introspection
-│   ├── plugin.zod.ts         → [MISSING] Plugin lifecycle
-│   ├── driver.zod.ts         → [MISSING] Database driver interface
-│   ├── marketplace.zod.ts    → [PLANNED] App store metadata
-│   ├── tenant.zod.ts         → [PLANNED] Multi-tenancy
-│   ├── events.zod.ts         → [PLANNED] Event bus
-│   └── realtime.zod.ts       → [PLANNED] WebSocket sync
+│   ├── plugin.zod.ts         → Plugin lifecycle
+│   ├── driver.zod.ts         → Database driver interface
+│   ├── tenant.zod.ts         → Multi-tenancy
+│   ├── events.zod.ts         → Event bus
+│   ├── realtime.zod.ts       → WebSocket sync
+│   ├── organization.zod.ts   → Organization management
+│   ├── audit.zod.ts          → Audit logging
+│   └── job.zod.ts            → Background jobs
 │
 ├── AI Protocol
-│   ├── agent.zod.ts          → AI agent configuration
-│   ├── model.zod.ts          → [PLANNED] LLM registry
-│   ├── rag.zod.ts            → [PLANNED] RAG pipeline
-│   └── nlq.zod.ts            → [PLANNED] Natural language query
+│   ├── agent.zod.ts              → AI agent configuration
+│   ├── model-registry.zod.ts     → LLM registry
+│   ├── rag-pipeline.zod.ts       → RAG pipeline
+│   ├── nlq.zod.ts                → Natural language query
+│   ├── conversation.zod.ts       → Conversation management
+│   ├── cost.zod.ts               → AI cost tracking
+│   ├── predictive.zod.ts         → Predictive analytics
+│   └── workflow-automation.zod.ts → AI workflow automation
 │
 └── API Protocol
     └── contract.zod.ts       → Request/response envelopes

README.md

@@ -59,7 +59,7 @@ The ObjectStack Protocol (`@objectstack/spec`) is divided into five core modules
 
 ### 1. Data Protocol (ObjectQL)
 Defines the "Shape of Data" and business logic.
-- **Schema:** Objects, Fields (23+ types including text, number, select, lookup, formula, autonumber, etc.)
+- **Schema:** Objects, Fields (35 types including text, number, select, lookup, formula, autonumber, slider, qrcode, etc.)
 - **Logic:** Workflows, Triggers, Validation Rules, Formulas
 - **Security:** Permissions, Sharing Rules
 - **Query:** Abstract Syntax Tree (AST) for unified data access across drivers
@@ -73,22 +73,28 @@ Defines the "Shape of Interaction" for rendering interfaces.
 - **Analytics:** Reports (Tabular, Summary, Matrix), Dashboards with widgets
 - **Actions:** Script, URL, Modal, Flow-triggered actions
 - **Theming:** Color palettes, typography, breakpoints, animations
+- **Widgets:** Custom field components
 
 ### 3. System Protocol (ObjectOS)
 Defines the "Runtime Environment" and platform capabilities.
 - **Manifest:** Application packaging (`objectstack.config.ts`)
-- **Identity:** Authentication, Roles, Territories, Licenses
+- **Identity:** Authentication, Roles, Territories, Licenses, Organizations
 - **Integration:** Webhooks, API contracts, ETL Mappings
 - **Datasource:** Driver definitions for SQL, NoSQL, SaaS connectors
 - **Discovery:** Plugin discovery and loading mechanisms
 - **I18n:** Translation and internationalization support
+- **Platform:** Events, Real-time sync, Audit logging, Background jobs, Multi-tenancy
 
 ### 4. AI Protocol
 Defines AI agent integration capabilities.
 - **Agent:** AI agent definitions and configurations
-- **Tools:** AI tool integrations
-- **Knowledge:** Knowledge base structures
-- **Models:** AI model configurations
+- **Model Registry:** LLM registry and selection
+- **RAG Pipeline:** Retrieval-augmented generation
+- **NLQ:** Natural language query processing
+- **Conversation:** Conversation management and memory
+- **Cost Tracking:** AI cost tracking and budget management
+- **Predictive:** Predictive analytics models
+- **Workflow Automation:** AI-powered workflow automation
 
 ### 5. API Protocol
 Defines standardized API contracts.

RELEASE_NOTES.md

@@ -52,7 +52,7 @@ This is the first public release of the ObjectStack ecosystem, providing:
 
 ### Core Capabilities
 - **Data Protocol (ObjectQL)**: Complete schema definitions for Objects and Fields
-  - 23+ field types (text, number, select, lookup, formula, autonumber, etc.)
+  - 35 field types (text, number, select, lookup, formula, autonumber, slider, qrcode, etc.)
   - Validation rules, workflows, and triggers
   - Permission system and sharing rules
   - Abstract query language for unified data access

content/docs/guides/field-types.cn.mdx

@@ -6,7 +6,7 @@ description: ObjectStack 所有字段类型的完整指南，包含示例和配
 
 # 字段类型参考
 
-ObjectStack 支持 **30+ 种字段类型**，涵盖文本、数字、日期、选择、关联、媒体、计算和增强类型。本指南为每种类型提供实用示例。
+ObjectStack 支持 **35 种字段类型**，涵盖文本、数字、日期、选择、关联、媒体、计算和增强类型。本指南为每种类型提供实用示例。
 
 ## 核心文本字段
 

content/docs/guides/field-types.mdx

@@ -6,7 +6,7 @@ description: Complete guide to all ObjectStack field types with examples and con
 
 # Field Types Reference
 
-ObjectStack supports **30+ field types** covering text, numbers, dates, selections, relationships, media, calculations, and enhanced types. This guide provides practical examples for each type.
+ObjectStack supports **35 field types** covering text, numbers, dates, selections, relationships, media, calculations, and enhanced types. This guide provides practical examples for each type.
 
 ## Core Text Fields
 
@@ -524,6 +524,8 @@ coordinates: Field.location({
 })
 ```
 
+> **Note:** `geolocation` is an alternative name for the `location` field type. Both refer to the same GPS coordinate field.
+
 **Data Structure:**
 ```typescript
 {
@@ -638,6 +640,66 @@ customer_signature: Field.signature({
 
 ---
 
+### Slider
+Numeric slider for visual value selection.
+
+```typescript
+volume: Field.slider({ 
+  label: 'Volume Level',
+  min: 0,
+  max: 100,
+  step: 1,
+  defaultValue: 50,
+})
+
+price_range: Field.slider({ 
+  label: 'Price Range',
+  min: 0,
+  max: 10000,
+  step: 100,
+  marks: { 0: '$0', 5000: '$5K', 10000: '$10K' },
+})
+```
+
+**Configuration:**
+- `min` - Minimum value
+- `max` - Maximum value
+- `step` - Increment step size
+- `marks` - Optional labeled markers on the slider
+
+---
+
+### QR Code
+QR code / Barcode field for scanning and generation.
+
+```typescript
+product_barcode: Field.qrcode({ 
+  label: 'Product Barcode',
+  format: 'qr', // 'qr', 'barcode', 'ean13', 'code128'
+  readonly: false,
+})
+
+ticket_code: Field.qrcode({ 
+  label: 'Event Ticket',
+  format: 'qr',
+  autoGenerate: true, // Generate on record creation
+})
+```
+
+**Supported Formats:**
+- `qr` - QR Code (2D matrix barcode, best for URLs, text, and complex data)
+- `barcode` - Standard 1D barcode (linear format for simple numeric/text data)
+- `ean13` - EAN-13 barcode (13-digit product identifier, commonly used in retail)
+- `code128` - Code 128 barcode (high-density 1D format supporting full ASCII character set)
+
+**Use Cases:**
+- Product SKUs and inventory management (ean13, code128)
+- Event tickets and access control (qr)
+- Document tracking and verification (qr)
+- Shipping labels and logistics (code128)
+
+---
+
 ## Field Configuration Reference
 
 ### Common Properties

content/docs/guides/getting-started.cn.mdx

@@ -276,7 +276,7 @@ views: {
 现在你有了有效的元数据，你可以：
 
 1. **探索示例**：查看 [CRM 示例](https://github.com/objectstack-ai/spec/tree/main/examples/crm) 了解完整功能实现
-2. **学习字段类型**：参见 [字段类型指南](/docs/guides/field-types) 了解所有 30+ 种字段类型
+2. **学习字段类型**：参见 [字段类型指南](/docs/guides/field-types) 了解所有 35 种字段类型
 3. **构建 UI**：使用 ObjectStack 运行时的元数据来生成界面
 4. **部署**：推送到 ObjectStack 内核用于生产环境
 

content/docs/guides/getting-started.mdx

@@ -276,7 +276,7 @@ views: {
 Now that you have valid metadata, you can:
 
 1. **Explore Examples**: Check out the [CRM Example](https://github.com/objectstack-ai/spec/tree/main/examples/crm) for a full-featured implementation
-2. **Learn Field Types**: See the [Field Types Guide](/docs/guides/field-types) for all 30+ field types
+2. **Learn Field Types**: See the [Field Types Guide](/docs/guides/field-types) for all 35 field types
 3. **Build UI**: Use the metadata with ObjectStack runtime to generate interfaces
 4. **Deploy**: Push to an ObjectStack kernel for production use
 

content/docs/index.cn.mdx

@@ -42,7 +42,7 @@ import { Book, Compass, FileText, Layers } from 'lucide-react';
 ## 快速链接
 
 ### 基础指南
-- **[字段类型](/docs/guides/field-types)** - 30+ 种字段类型及示例（文本、数字、选择、查找、公式等）
+- **[字段类型](/docs/guides/field-types)** - 35 种字段类型及示例（文本、数字、选择、查找、公式等）
 - **[视图配置](/docs/guides/view-configuration)** - 网格、看板、日历、甘特图和表单布局
 - **[工作流与验证](/docs/guides/workflows-validation)** - 业务规则和自动化
 - **[项目结构](/docs/guides/project-structure)** - 组织代码的最佳实践