Merge branch 'main' into copilot/update-documentation-for-actions-run

Author: hotlong

.github/copilot-instructions.md

@@ -25,15 +25,14 @@ Mission: Build the "Post-SaaS Operating System" — an open-core, local-first ec
 ## 📘 1. The Metamodel Standards (Knowledge Base)
 
 ### **A. DATA PROTOCOL (`src/data/*.zod.ts`)**
-*Core Business Logic & Data Model*
+*Core Data Model*
 
 *   **Field (`src/data/field.zod.ts`)**:
     *   **Type Enum**: `text`, `textarea`, `number`, `boolean`, `select`, `lookup`, `formula`, ...
     *   **Props**: `name` (snake_case), `label`, `type`, `multiple` (Array support), `reference` (Target Object).
 *   **Object (`src/data/object.zod.ts`)**:
     *   **Props**: `name` (snake_case), `label`, `fields` (Map), `enable` (Capabilities: `trackHistory`, `apiEnabled`).
-*   **Flow (`src/data/flow.zod.ts`)**: Visual Logic Orchestration (`autolaunched`, `screen`, `schedule`).
-*   **Logic**: `validation.zod.ts` (Rules), `permission.zod.ts` (ACL), `workflow.zod.ts` (State Machine).
+*   **Validation**: `validation.zod.ts` (Rules).
 
 ### **B. UI PROTOCOL (`src/ui/*.zod.ts`)**
 *Presentation & Interaction*
@@ -56,6 +55,20 @@ Mission: Build the "Post-SaaS Operating System" — an open-core, local-first ec
 *   **API (`src/system/api.zod.ts`)**: REST/GraphQL Endpoint Definitions.
 *   **Translation (`src/system/translation.zod.ts`)**: Internationalization (i18n).
 
+### **D. AUTOMATION PROTOCOL (`src/automation/*.zod.ts`)**
+*Business Logic & Orchestration*
+
+*   **Flow (`src/automation/flow.zod.ts`)**: Visual Logic Orchestration (`autolaunched`, `screen`, `schedule`).
+*   **Workflow (`src/automation/workflow.zod.ts`)**: State Machine & Approval Processes.
+*   **Trigger (`src/automation/trigger-registry.zod.ts`)**: Event-driven Automation.
+
+### **E. AI PROTOCOL (`src/ai/*.zod.ts`)**
+*Artificial Intelligence & Agents*
+
+*   **Agent (`src/ai/agent.zod.ts`)**: Autonomous Actors (`role`, `instructions`, `tools`).
+*   **RAG (`src/ai/rag-pipeline.zod.ts`)**: Retrieval Augmented Generation (`indexes`, `sources`).
+*   **Model (`src/ai/model-registry.zod.ts`)**: LLM Configuration & Routing.
+
 ---
 
 ## 🛠️ 2. Coding Patterns

.github/workflows/ci.yml

@@ -52,7 +52,7 @@ jobs:
         run: pnpm --filter @objectstack/spec test:coverage
 
       - name: Upload coverage reports
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v6
         with:
           name: coverage-report
           path: packages/spec/coverage/
@@ -110,7 +110,7 @@ jobs:
           echo "Build outputs verified successfully"
 
       - name: Upload build artifacts
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v6
         with:
           name: build-output
           path: |

.github/workflows/codeql.yml

@@ -30,15 +30,15 @@ jobs:
         uses: actions/checkout@v4
 
       - name: Initialize CodeQL
-        uses: github/codeql-action/init@v3
+        uses: github/codeql-action/init@v4
         with:
           languages: ${{ matrix.language }}
           queries: security-and-quality
 
       - name: Autobuild
-        uses: github/codeql-action/autobuild@v3
+        uses: github/codeql-action/autobuild@v4
 
       - name: Perform CodeQL Analysis
-        uses: github/codeql-action/analyze@v3
+        uses: github/codeql-action/analyze@v4
         with:
           category: "/language:${{matrix.language}}"

.github/workflows/pr-automation.yml

@@ -13,7 +13,7 @@ jobs:
 
     steps:
       - name: Add size label
-        uses: codelytv/pr-size-labeler@v1.10.1
+        uses: codelytv/pr-size-labeler@v1.10.3
         with:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           xs_label: 'size/xs'

.github/workflows/stale.yml

@@ -16,7 +16,7 @@ jobs:
 
     steps:
       - name: Close stale issues and PRs
-        uses: actions/stale@v9.0.0
+        uses: actions/stale@v10.1.1
         with:
           repo-token: ${{ secrets.GITHUB_TOKEN }}
 

.gitignore

@@ -70,4 +70,5 @@ next-env.d.ts
 # Fumadocs
 .source/
 apps/*/. source/
-apps/*/.next/
+apps/*/.next/docs/
+docs/