refactor: unify sidebar navigation and enhance metadata browsing

- Updated GlobalSidebar to serve as the single navigation shell for all authenticated routes, including package workspaces.
- Simplified route checks to always render GlobalSidebar, removing the need for package-scoped AppSidebar.
- Introduced MetadataBrowser component to replace DeveloperOverview, providing a comprehensive view of metadata items with search functionality.
- Removed unnecessary state management and effects related to package selection in environment routes.
- Enhanced code readability and maintainability by restructuring components and reducing complexity.

Author: hotlong

apps/studio/src/hooks/usePackages.ts

@@ -20,8 +20,13 @@ export function usePackages() {
       try {
         const result = await client.packages.list();
         const all: InstalledPackage[] = result?.packages || [];
-        // Filter out the root dev-workspace — it's the monorepo aggregator, not a real package
-        const items = all.filter((p) => p.manifest?.version !== '0.0.0' && p.manifest?.id !== 'dev-workspace');
+        // Filter out dev-workspace (monorepo aggregator) and platform-scoped packages (runtime-global, not env-installable)
+        const items = all.filter(
+          (p) =>
+            p.manifest?.version !== '0.0.0' &&
+            p.manifest?.id !== 'dev-workspace' &&
+            (p.manifest as any)?.scope !== 'platform',
+        );
         console.log('[App] Fetched packages:', items.map((p) => p.manifest?.name || p.manifest?.id));
         if (mounted && items.length > 0) {
           setPackages(items);

packages/metadata/src/plugin.ts

@@ -57,6 +57,7 @@ export class MetadataPlugin implements Plugin {
                 name: 'Metadata',
                 version: '1.0.0',
                 type: 'plugin',
+                scope: 'platform',
                 namespace: 'sys',
                 objects: [SysMetadataObject, SysMetadataHistoryObject],
             });

packages/plugins/driver-memory/objectstack.config.ts

@@ -13,6 +13,7 @@ const MemoryDriverPlugin: ObjectStackManifest = {
   name: 'In-Memory Driver',
   version: '1.0.0',
   type: 'driver',
+  scope: 'platform',
   description: 'A reference specification implementation of the DriverInterface using in-memory arrays. Suitable for testing and development.',
 
   configuration: {

packages/plugins/plugin-audit/src/audit-plugin.ts

@@ -22,6 +22,7 @@ export class AuditPlugin implements Plugin {
       name: 'Audit',
       version: '1.0.0',
       type: 'plugin',
+      scope: 'platform',
       namespace: 'sys',
       objects: [SysAuditLog],
     });

packages/plugins/plugin-auth/objectstack.config.ts

@@ -15,6 +15,7 @@ export default defineStack({
     namespace: 'auth',
     version: '3.0.1',
     type: 'plugin',
+    scope: 'platform',
     name: 'Authentication & Identity Plugin',
     description: 'Core authentication objects for ObjectStack (User, Session, Account, Verification)',
   },

packages/plugins/plugin-auth/src/auth-plugin.ts

@@ -102,6 +102,7 @@ export class AuthPlugin implements Plugin {
       name: 'System',
       version: '1.0.0',
       type: 'plugin',
+      scope: 'platform',
       namespace: 'sys',
       objects: [
         SysUser, SysSession, SysAccount, SysVerification,

packages/plugins/plugin-hono-server/objectstack.config.ts

@@ -13,6 +13,7 @@ const HonoServerPlugin: ObjectStackManifest = {
   name: 'Hono Server Adapter',
   version: '1.0.0',
   type: 'adapter',
+  scope: 'platform',
   description: 'HTTP server adapter using Hono framework. Exposes ObjectStack Runtime Protocol via REST API endpoints.',
 
   configuration: {

packages/plugins/plugin-msw/objectstack.config.ts

@@ -13,6 +13,7 @@ const MSWPlugin: ObjectStackManifest = {
   name: 'Mock Service Worker Plugin',
   version: '1.0.0',
   type: 'plugin',
+  scope: 'platform',
   description: 'MSW (Mock Service Worker) integration for testing and development. Provides browser-based API mocking using ObjectStack runtime protocol.',
 
   configuration: {

packages/plugins/plugin-security/src/security-plugin.ts

@@ -44,6 +44,7 @@ export class SecurityPlugin implements Plugin {
       name: 'Security',
       version: '1.0.0',
       type: 'plugin',
+      scope: 'platform',
       namespace: 'sys',
       objects: [SysRole, SysPermissionSet],
     });

packages/plugins/plugin-setup/objectstack.config.ts

@@ -15,6 +15,7 @@ export default defineStack({
     namespace: 'setup',
     version: '3.3.1',
     type: 'plugin',
+    scope: 'platform',
     name: 'Platform Setup Plugin',
     description: 'Owns and composes the platform Setup App with area-based navigation contributed by other plugins',
   },