refactor: align all packages with @objectstack/spec v2.0.1 protocol

- Add @objectstack/spec dependency to cache, i18n, metrics, notification, realtime, storage
- Replace local Kernel Compliance Types in all 13 types.ts with spec imports
- Update healthCheck/getManifest/getStartupResult in all 13 plugins
- Update 9 test files for new spec-compliant return values
- Update audit script version checks from 1.0.0 to 2.0.1
- Fix nullish coalescing in metrics plugin (code review)

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>

Author: Copilot

packages/audit/test/plugin.test.ts

@@ -438,6 +438,9 @@ describe('Kernel Compliance', () => {
             expect(manifest.capabilities).toBeDefined();
             expect(manifest.security).toBeDefined();
             expect(manifest.security.pluginId).toBe('audit');
+            expect(manifest.security.trustLevel).toBe('trusted');
+            expect(manifest.security.permissions).toEqual({ permissions: [] });
+            expect(manifest.security.sandbox).toEqual({});
         });
     });
 

packages/metrics/src/plugin.ts

@@ -179,7 +179,7 @@ export class MetricsPlugin implements Plugin {
                                         name: service.name || pluginName,
                                         version: service.version || '0.1.0',
                                         status: health.status || 'unknown',
-                                        uptime: health.metrics?.uptime || 0,
+                                        uptime: health.metrics?.uptime ?? 0,
                                         health,
                                         manifest,
                                     });

scripts/audit-spec-compliance.mjs

@@ -248,28 +248,38 @@ class SpecComplianceAuditor {
                           pkg.devDependencies?.['@objectstack/spec'] ||
                           pkg.peerDependencies?.['@objectstack/spec'];
 
-      if (specVersion !== '1.0.0' && specVersion !== '^1.0.0') {
+      if (specVersion !== '2.0.1' && specVersion !== '^2.0.1') {
         result.issues.push({
           package: result.package,
           severity: 'info',
           category: 'dependencies',
-          message: `@objectstack/spec version is ${specVersion}, expected 1.0.0 or ^1.0.0`
+          message: `@objectstack/spec version is ${specVersion}, expected 2.0.1 or ^2.0.1`
         });
       }
     }
 
-    // Rule 5: Check runtime version consistency
+    // Rule 5: All plugin packages should have @objectstack/spec dependency
+    if (result.hasPluginImplementation && !result.hasSpecDependency) {
+      result.issues.push({
+        package: result.package,
+        severity: 'warning',
+        category: 'dependencies',
+        message: 'Plugin package should declare @objectstack/spec dependency for kernel type imports'
+      });
+    }
+
+    // Rule 6: Check runtime version consistency
     if (result.hasRuntimeDependency) {
       const runtimeVersion = pkg.dependencies?.['@objectstack/runtime'] || 
                              pkg.devDependencies?.['@objectstack/runtime'] ||
                              pkg.peerDependencies?.['@objectstack/runtime'];
 
-      if (runtimeVersion !== '^1.0.0' && runtimeVersion !== '1.0.0') {
+      if (runtimeVersion !== '^2.0.1' && runtimeVersion !== '2.0.1') {
         result.issues.push({
           package: result.package,
           severity: 'info',
           category: 'dependencies',
-          message: `@objectstack/runtime version is ${runtimeVersion}, expected ^1.0.0`
+          message: `@objectstack/runtime version is ${runtimeVersion}, expected ^2.0.1`
         });
       }
     }