feat: 更新导航结构，替换菜单项为结构化导航树

Author: hotlong

.cursorrules

@@ -13,7 +13,7 @@ You define what a "Package" looks like in ObjectStack.
    * id: Unique identifier (e.g., com.example.crm).
    * type: app | plugin | driver | module.
    * permissions: Array of permission strings requested (e.g., ["system.user.read"]).
-   * menus: Navigation structure injection.
+   * navigation: Structured navigation menu tree (for apps).
    * entities: Glob patterns for ObjectQL files (e.g., ["./src/schema/*.gql"]).
    * extensions: Extension points (e.g., contributions to the UI).
 2. Directory Conventions (Law of Location)
@@ -50,11 +50,6 @@ export const ManifestSchema = z.object({
   id: z.string().describe("Unique package identifier (reverse domain style)"),
   version: z.string().regex(/^\d+\.\d+\.\d+$/),
   type: z.enum(['app', 'plugin', 'driver']),
-  menus: z.array(z.object({
-    label: z.string(),
-    path: z.string(),
-    icon: z.string().optional()
-  })).optional()
 });
 
 export type ObjectStackManifest = z.infer<typeof ManifestSchema>;

README.md

@@ -40,7 +40,7 @@ Defines the "Shape of Data".
 Defines the "Shape of Interaction".
 - **Views:** Grids, Kanbans, Calendars.
 - **Pages:** FlexiPage layouts (Regions & Components).
-- **Navigation:** Apps, Menus.
+- **Navigation:** Apps, Navigation.
 - **Analytics:** Reports, Dashboards.
 
 ### 3. System Protocol (ObjectOS)

content/prompts/objectstack.prompt.md

@@ -53,7 +53,7 @@ File: objectstack.config.ts (or strict JSON inside package.json)
 Schema Location: packages/protocol/schemas/manifest.schema.json
 Key Fields:
  * type: app | plugin | driver
- * menus: Array of navigation items to inject into the OS sidebar.
+ * navigation: Structured navigation menu tree.
  * permissions: Array of requested capabilities (e.g., finance.read).
  * entities: Path patterns to auto-load Schema files (e.g., ./src/schemas/*.gql).
  * lifecycle: Hooks for onInstall, onEnable.

examples/crm/objectstack.config.ts

@@ -34,47 +34,44 @@ export default App.create({
   ],
 
   // Navigation menu structure
-  menus: [
+  navigation: [
     {
+      id: 'group_sales',
+      type: 'group',
       label: 'Sales',
-      items: [
-        { type: 'object', object: 'lead', label: 'Leads' },
-        { type: 'object', object: 'account', label: 'Accounts' },
-        { type: 'object', object: 'contact', label: 'Contacts' },
-        { type: 'object', object: 'opportunity', label: 'Opportunities' },
-        { type: 'divider' },
-        { type: 'dashboard', dashboard: 'sales_dashboard', label: 'Sales Dashboard' },
-        { type: 'report', report: 'opportunities_by_stage', label: 'Pipeline Report' },
+      children: [
+        { id: 'nav_lead', type: 'object', objectName: 'lead', label: 'Leads' },
+        { id: 'nav_account', type: 'object', objectName: 'account', label: 'Accounts' },
+        { id: 'nav_contact', type: 'object', objectName: 'contact', label: 'Contacts' },
+        { id: 'nav_opportunity', type: 'object', objectName: 'opportunity', label: 'Opportunities' },
+        { id: 'nav_sales_dashboard', type: 'dashboard', dashboardName: 'sales_dashboard', label: 'Sales Dashboard' },
       ]
     },
     {
+      id: 'group_service',
+      type: 'group',
       label: 'Service',
-      items: [
-        { type: 'object', object: 'case', label: 'Cases' },
-        { type: 'divider' },
-        { type: 'dashboard', dashboard: 'service_dashboard', label: 'Service Dashboard' },
-        { type: 'report', report: 'cases_by_status_priority', label: 'Case Report' },
+      children: [
+        { id: 'nav_case', type: 'object', objectName: 'case', label: 'Cases' },
+        { id: 'nav_service_dashboard', type: 'dashboard', dashboardName: 'service_dashboard', label: 'Service Dashboard' },
       ]
     },
     {
+      id: 'group_activities',
+      type: 'group',
       label: 'Activities',
-      items: [
-        { type: 'object', object: 'task', label: 'Tasks' },
+      children: [
+        { id: 'nav_task', type: 'object', objectName: 'task', label: 'Tasks' },
       ]
     },
     {
+      id: 'group_analytics',
+      type: 'group',
       label: 'Analytics',
-      items: [
-        { type: 'dashboard', dashboard: 'executive_dashboard', label: 'Executive Dashboard' },
-        { type: 'dashboard', dashboard: 'sales_dashboard', label: 'Sales Dashboard' },
-        { type: 'dashboard', dashboard: 'service_dashboard', label: 'Service Dashboard' },
-        { type: 'divider' },
-        { type: 'report', report: 'opportunities_by_stage', label: 'Opportunities by Stage' },
-        { type: 'report', report: 'won_opportunities_by_owner', label: 'Won Opportunities' },
-        { type: 'report', report: 'accounts_by_industry_type', label: 'Accounts Matrix' },
-        { type: 'report', report: 'cases_by_status_priority', label: 'Cases by Status' },
-        { type: 'report', report: 'sla_performance', label: 'SLA Performance' },
-        { type: 'report', report: 'leads_by_source', label: 'Leads by Source' },
+      children: [
+        { id: 'nav_exec_dashboard', type: 'dashboard', dashboardName: 'executive_dashboard', label: 'Executive Dashboard' },
+        { id: 'nav_analytics_sales_db', type: 'dashboard', dashboardName: 'sales_dashboard', label: 'Sales Dashboard' },
+        { id: 'nav_analytics_service_db', type: 'dashboard', dashboardName: 'service_dashboard', label: 'Service Dashboard' },
       ]
     }
   ],

examples/todo/objectstack.config.ts

@@ -9,12 +9,19 @@ export default App.create({
   objects: [
     TodoTask
   ],
-  menus: [
+  navigation: [
     {
-        label: 'Tasks',
-        items: [
-            { type: 'object', object: 'todo_task' }
-        ]
+      id: 'group_tasks',
+      type: 'group',
+      label: 'Tasks',
+      children: [
+        { 
+          id: 'nav_todo_task',
+          type: 'object', 
+          objectName: 'todo_task',
+          label: 'My Tasks'
+        }
+      ]
     }
   ]
 });

packages/spec/src/system/manifest.test.ts

@@ -109,29 +109,6 @@ describe('ManifestSchema', () => {
       expect(() => ManifestSchema.parse(manifest)).not.toThrow();
     });
 
-    it('should accept manifest with menus', () => {
-      const manifest: ObjectStackManifest = {
-        id: 'com.example.reports',
-        version: '1.5.2',
-        type: 'app',
-        name: 'Reports App',
-        menus: [
-          {
-            label: 'Reports',
-            path: '/reports',
-            icon: 'chart-bar',
-          },
-          {
-            label: 'Analytics',
-            path: '/analytics',
-            icon: 'trending-up',
-          },
-        ],
-      };
-
-      expect(() => ManifestSchema.parse(manifest)).not.toThrow();
-    });
-
     it('should accept manifest with object patterns', () => {
       const manifest: ObjectStackManifest = {
         id: 'com.example.sales',
@@ -189,33 +166,6 @@ describe('ManifestSchema', () => {
           'crm.contact.read',
           'crm.contact.write',
         ],
-        menus: [
-          {
-            label: 'Home',
-            path: '/crm/home',
-            icon: 'home',
-          },
-          {
-            label: 'Leads',
-            path: '/crm/leads',
-            icon: 'users',
-          },
-          {
-            label: 'Opportunities',
-            path: '/crm/opportunities',
-            icon: 'target',
-          },
-          {
-            label: 'Accounts',
-            path: '/crm/accounts',
-            icon: 'building-2',
-          },
-          {
-            label: 'Contacts',
-            path: '/crm/contacts',
-            icon: 'user',
-          },
-        ],
         objects: [
           './objects/lead.object.ts',
           './objects/opportunity.object.ts',

packages/spec/src/system/manifest.zod.ts

@@ -1,18 +1,5 @@
 import { z } from 'zod';
 
-/**
- * Schema for menu items in ObjectStack packages.
- * Defines navigation structure that can be injected into the UI.
- */
-export const MenuItemSchema = z.object({
-  /** Display label for the menu item */
-  label: z.string().describe('Display label for the menu item'),
-  /** Navigation path (route) for the menu item */
-  path: z.string().describe('Navigation path (route) for the menu item'),
-  /** Optional icon identifier for the menu item */
-  icon: z.string().optional().describe('Optional icon identifier for the menu item'),
-});
-
 /**
  * Schema for the ObjectStack Manifest.
  * This defines the structure of a package configuration in the ObjectStack ecosystem.
@@ -56,11 +43,6 @@ export const ManifestSchema = z.object({
    */
   permissions: z.array(z.string()).optional().describe('Array of required permission strings'),
 
-  /** 
-   * Navigation menu structure that the package contributes to the UI.
-   */
-  menus: z.array(MenuItemSchema).optional().describe('Navigation menu structure'),
-  
   /** 
    * Glob patterns specifying ObjectQL schemas files (typically *.object.yml or *.object.ts).
    * Example: `["./src/objects/*.object.yml"]`

packages/spec/src/ui/app.zod.ts

@@ -133,11 +133,6 @@ export const AppSchema = z.object({
    */
   navigation: z.array(NavigationItemSchema).optional().describe('Structured navigation menu tree'),
 
-  /**
-   * Deprecated: Use navigation instead.
-   */
-  menus: z.array(z.any()).optional().describe('Deprecated: Use navigation instead'),
-  
   /** 
    * App-level Home Page Override
    * ID of the navigation item to act as the landing page.