@objectstack/metadata 0.9.2 → 1.0.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @objectstack/metadata
 
+## 1.0.0
+
+### Major Changes
+
+- Major version release for ObjectStack Protocol v1.0.
+  - Stabilized Protocol Definitions
+  - Enhanced Runtime Plugin Support
+  - Fixed Type Compliance across Monorepo
+
+### Patch Changes
+
+- Updated dependencies
+  - @objectstack/spec@1.0.0
+  - @objectstack/core@1.0.0
+  - @objectstack/types@1.0.0
+
 ## 0.9.2
 
 ### Patch Changes

package/README.md

@@ -1,458 +1,13 @@
 # @objectstack/metadata
 
-Metadata loading, saving, and persistence for ObjectStack.
+The **Model Definition** layer. It provides classes and utilities for parsing and validating ObjectStack metadata schemas.
 
-## Overview
+## Features
 
-The `@objectstack/metadata` package provides a unified interface for managing metadata across the ObjectStack ecosystem. It handles:
+- **Schema Loading**: Load metadata from JSON/YAML or TypeScript files.
+- **Reference Resolution**: Resolves cross-object references and inheritance.
+- **Validation**: Strict validation against the Zod schemas in `@objectstack/spec`.
 
-- **Metadata Serialization/Deserialization** - Support for JSON, YAML, TypeScript, and JavaScript formats
-- **File System Operations** - Load, save, and watch metadata files
-- **Validation** - Integration with Zod schemas from `@objectstack/spec`
-- **Caching** - ETag-based caching for performance optimization
-- **File Watching** - Development mode with automatic reload on file changes
+## Usage
 
-## 🤖 AI Development Context
-
-**Role**: Metadata IO & Persistence
-**Usage**:
-- Use `MetadataManager` to read/write `.object.ts`, `.view.yaml` files.
-- Handles format loading (TS, JSON, YAML).
-
-## Installation
-
-```bash
-pnpm add @objectstack/metadata
-```
-
-## Quick Start
-
-```typescript
-import { MetadataManager } from '@objectstack/metadata';
-import type { ServiceObject } from '@objectstack/spec/data';
-
-// Create manager
-const manager = new MetadataManager({
-  rootDir: './metadata',
-  formats: ['typescript', 'json', 'yaml'],
-  cache: { enabled: true, ttl: 3600 },
-  watch: process.env.NODE_ENV === 'development',
-});
-
-// Load metadata
-const customer = await manager.load<ServiceObject>('object', 'customer');
-
-// Save metadata
-await manager.save('object', 'project', projectObject, {
-  format: 'typescript',
-  prettify: true,
-});
-
-// Load multiple items
-const objects = await manager.loadMany<ServiceObject>('object', {
-  patterns: ['**/*.object.ts', '**/*.object.json'],
-});
-
-// Watch for changes
-manager.watch('object', (event) => {
-  console.log(`Object ${event.type}:`, event.name);
-});
-```
-
-## API
-
-### MetadataManager
-
-Main class for metadata operations.
-
-#### Constructor
-
-```typescript
-new MetadataManager(config: MetadataManagerConfig)
-```
-
-**Config options:**
-- `rootDir` - Root directory for metadata files
-- `formats` - Enabled serialization formats (default: `['typescript', 'json', 'yaml']`)
-- `cache` - Cache configuration with `enabled` and `ttl` options
-- `watch` - Enable file watching (default: `false`)
-- `watchOptions` - File watcher options (`ignored`, `persistent`, `ignoreInitial`)
-
-#### Methods
-
-**load<T>(type: string, name: string, options?: MetadataLoadOptions): Promise<T | null>**
-
-Load a single metadata item.
-
-```typescript
-const customer = await manager.load<ServiceObject>('object', 'customer');
-```
-
-**loadMany<T>(type: string, options?: MetadataLoadOptions): Promise<T[]>**
-
-Load multiple metadata items matching patterns.
-
-```typescript
-const objects = await manager.loadMany<ServiceObject>('object', {
-  patterns: ['**/*.object.ts'],
-  limit: 100,
-});
-```
-
-**save<T>(type: string, name: string, data: T, options?: MetadataSaveOptions): Promise<MetadataSaveResult>**
-
-Save metadata to disk.
-
-```typescript
-await manager.save('object', 'customer', customerObject, {
-  format: 'typescript',
-  prettify: true,
-  backup: true,
-});
-```
-
-**exists(type: string, name: string): Promise<boolean>**
-
-Check if metadata item exists.
-
-```typescript
-const exists = await manager.exists('object', 'customer');
-```
-
-**list(type: string): Promise<string[]>**
-
-List all items of a type.
-
-```typescript
-const objectNames = await manager.list('object');
-```
-
-**watch(type: string, callback: WatchCallback): void**
-
-Watch for metadata changes.
-
-```typescript
-manager.watch('object', (event) => {
-  if (event.type === 'added') {
-    console.log('New object:', event.name);
-  }
-});
-```
-
-**stopWatching(): Promise<void>**
-
-Stop all file watching.
-
-## Serialization Formats
-
-### JSON
-
-```json
-{
-  "name": "customer",
-  "label": "Customer",
-  "fields": {
-    "name": { "type": "text", "label": "Name" }
-  }
-}
-```
-
-### YAML
-
-```yaml
-name: customer
-label: Customer
-fields:
-  name:
-    type: text
-    label: Name
-```
-
-### TypeScript
-
-```typescript
-import type { ServiceObject } from '@objectstack/spec/data';
-
-export const metadata: ServiceObject = {
-  name: 'customer',
-  label: 'Customer',
-  fields: {
-    name: { type: 'text', label: 'Name' },
-  },
-};
-
-export default metadata;
-```
-
-## Architecture
-
-The metadata package is designed as a Layer 3 package in the ObjectStack architecture:
-
-```
-@objectstack/metadata (Layer 3)
-├── Dependencies:
-│   ├── @objectstack/spec (validation)
-│   ├── @objectstack/core (logging, DI)
-│   ├── @objectstack/types (shared types)
-│   ├── glob (file pattern matching)
-│   ├── js-yaml (YAML support)
-│   └── chokidar (file watching)
-└── Used By:
-    ├── @objectstack/cli (code generation)
-    ├── @objectstack/runtime (manifest loading)
-    └── @objectstack/objectql (registry persistence)
-```
-
-## Common Workflows
-
-### Development Workflow with File Watching
-
-```typescript
-import { MetadataManager } from '@objectstack/metadata';
-
-const manager = new MetadataManager({
-  rootDir: './metadata',
-  watch: true, // Enable file watching
-  cache: { enabled: true, ttl: 3600 }
-});
-
-// Watch for changes and reload
-manager.watch('object', async (event) => {
-  if (event.type === 'modified' || event.type === 'added') {
-    console.log(`Reloading object: ${event.name}`);
-    const updated = await manager.load('object', event.name);
-    
-    // Notify the system to reload
-    await objectQL.reloadObject(event.name, updated);
-  }
-});
-
-// Hot module replacement for development
-console.log('Watching metadata files for changes...');
-```
-
-### Metadata Migration Workflow
-
-```typescript
-import { MetadataManager } from '@objectstack/metadata';
-
-async function migrateMetadata() {
-  const manager = new MetadataManager({
-    rootDir: './metadata'
-  });
-  
-  // 1. Load all existing objects
-  const objects = await manager.loadMany('object');
-  
-  // 2. Transform metadata (e.g., rename field)
-  const transformed = objects.map(obj => ({
-    ...obj,
-    fields: Object.entries(obj.fields).reduce((acc, [key, field]) => {
-      // Rename 'description' to 'notes'
-      const newKey = key === 'description' ? 'notes' : key;
-      acc[newKey] = field;
-      return acc;
-    }, {})
-  }));
-  
-  // 3. Save with backup
-  for (const obj of transformed) {
-    await manager.save('object', obj.name, obj, {
-      format: 'typescript',
-      backup: true, // Create .bak file
-      prettify: true
-    });
-  }
-  
-  console.log(`Migrated ${objects.length} objects`);
-}
-```
-
-### Multi-Format Support Workflow
-
-```typescript
-import { MetadataManager } from '@objectstack/metadata';
-
-const manager = new MetadataManager({
-  rootDir: './metadata',
-  formats: ['typescript', 'json', 'yaml']
-});
-
-// Load from any format - manager auto-detects
-const customer = await manager.load('object', 'customer');
-// Tries: customer.object.ts, customer.object.json, customer.object.yaml
-
-// Save in preferred format
-await manager.save('object', 'customer', customer, {
-  format: 'typescript' // Convert to TypeScript
-});
-
-// Generate documentation from metadata
-const allObjects = await manager.loadMany('object');
-const docs = allObjects.map(obj => `
-## ${obj.label}
-
-**Name:** ${obj.name}
-
-**Fields:**
-${Object.entries(obj.fields).map(([name, field]) => 
-  `- **${field.label}** (\`${name}\`): ${field.type}`
-).join('\n')}
-`).join('\n\n');
-
-fs.writeFileSync('docs/objects.md', docs);
-```
-
-### Validation and Testing Workflow
-
-```typescript
-import { MetadataManager } from '@objectstack/metadata';
-import { ObjectSchema } from '@objectstack/spec/data';
-
-async function validateAllMetadata() {
-  const manager = new MetadataManager({
-    rootDir: './metadata'
-  });
-  
-  const objects = await manager.loadMany('object');
-  const errors = [];
-  
-  for (const obj of objects) {
-    const result = ObjectSchema.safeParse(obj);
-    
-    if (!result.success) {
-      errors.push({
-        name: obj.name,
-        issues: result.error.issues
-      });
-    }
-  }
-  
-  if (errors.length > 0) {
-    console.error('Validation errors found:');
-    errors.forEach(({ name, issues }) => {
-      console.error(`\n${name}:`);
-      issues.forEach(issue => {
-        console.error(`  - ${issue.path.join('.')}: ${issue.message}`);
-      });
-    });
-    process.exit(1);
-  }
-  
-  console.log(`✅ All ${objects.length} objects validated successfully`);
-}
-```
-
-### Metadata Versioning Workflow
-
-```typescript
-import { MetadataManager } from '@objectstack/metadata';
-import { execSync } from 'child_process';
-
-async function versionMetadata() {
-  const manager = new MetadataManager({
-    rootDir: './metadata'
-  });
-  
-  const objects = await manager.loadMany('object');
-  
-  // Get git user name safely
-  let modifiedBy = 'unknown';
-  try {
-    modifiedBy = execSync('git config user.name', { encoding: 'utf-8' }).trim();
-  } catch (error) {
-    console.warn('Could not get git user name, using "unknown"');
-  }
-  
-  // Add version metadata
-  const versioned = objects.map(obj => ({
-    ...obj,
-    metadata: {
-      ...obj.metadata,
-      version: '2.0.0',
-      lastModified: new Date().toISOString(),
-      modifiedBy
-    }
-  }));
-  
-  // Save versioned metadata
-  for (const obj of versioned) {
-    await manager.save('object', obj.name, obj, {
-      format: 'typescript',
-      prettify: true
-    });
-  }
-  
-  // Commit to version control (if git is available)
-  try {
-    execSync('git add metadata/', { stdio: 'inherit' });
-    execSync('git commit -m "Version bump to 2.0.0"', { stdio: 'inherit' });
-  } catch (error) {
-    console.warn('Git commit failed, changes are staged but not committed');
-  }
-}
-```
-
-### Import/Export Workflow
-
-```typescript
-import { MetadataManager } from '@objectstack/metadata';
-
-async function exportToJSON() {
-  const manager = new MetadataManager({
-    rootDir: './metadata'
-  });
-  
-  // Load all metadata
-  const [objects, views, apps] = await Promise.all([
-    manager.loadMany('object'),
-    manager.loadMany('view'),
-    manager.loadMany('app')
-  ]);
-  
-  // Create unified export
-  const exportData = {
-    version: '1.0.0',
-    exported: new Date().toISOString(),
-    objects,
-    views,
-    apps
-  };
-  
-  // Save as single JSON file
-  fs.writeFileSync(
-    'export/metadata-export.json',
-    JSON.stringify(exportData, null, 2)
-  );
-  
-  console.log('Export complete!');
-}
-
-async function importFromJSON(filePath: string) {
-  const manager = new MetadataManager({
-    rootDir: './metadata'
-  });
-  
-  const importData = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
-  
-  // Import objects
-  for (const obj of importData.objects) {
-    await manager.save('object', obj.name, obj, {
-      format: 'typescript'
-    });
-  }
-  
-  // Import views
-  for (const view of importData.views) {
-    await manager.save('view', view.name, view, {
-      format: 'typescript'
-    });
-  }
-  
-  console.log('Import complete!');
-}
-```
-
-## License
-
-MIT
+Internal package used by `@objectstack/runtime` to process configuration.

package/dist/loaders/filesystem-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filesystem-loader.d.ts","sourceRoot":"","sources":["../../src/loaders/filesystem-loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,sBAAsB,EACtB,cAAc,EACf,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAEjF,qBAAa,gBAAiB,YAAW,cAAc;IAYnD,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,MAAM,CAAC;IAbjB,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAMvC;IAEF,OAAO,CAAC,KAAK,CAAqE;gBAGxE,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,GAAG,CAAC,cAAc,EAAE,kBAAkB,CAAC,EACpD,MAAM,CAAC,EAAE,MAAM,YAAA;IAGnB,IAAI,CACR,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC;IA8FxB,QAAQ,CAAC,CAAC,GAAG,GAAG,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,CAAC,EAAE,CAAC;IAwDT,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKpD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IA+B/D,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAwB3C;;OAEG;YACW,QAAQ;IAkBtB;;OAEG;IACH,OAAO,CAAC,YAAY;IAkBpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;;;OAIG;IACH,OAAO,CAAC,YAAY;CAIrB"}
+{"version":3,"file":"filesystem-loader.d.ts","sourceRoot":"","sources":["../../src/loaders/filesystem-loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,sBAAsB,EACtB,cAAc,EACf,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAEjF,qBAAa,gBAAiB,YAAW,cAAc;IAmBnD,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,MAAM,CAAC;IApBjB,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAavC;IAEF,OAAO,CAAC,KAAK,CAAqE;gBAGxE,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,GAAG,CAAC,cAAc,EAAE,kBAAkB,CAAC,EACpD,MAAM,CAAC,EAAE,MAAM,YAAA;IAGnB,IAAI,CACR,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC;IA8FxB,QAAQ,CAAC,CAAC,GAAG,GAAG,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,CAAC,EAAE,CAAC;IAwDT,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKpD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IA+B/D,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAwB3C;;OAEG;YACW,QAAQ;IAkBtB;;OAEG;IACH,OAAO,CAAC,YAAY;IAkBpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;;;OAIG;IACH,OAAO,CAAC,YAAY;CAIrB"}

package/dist/loaders/filesystem-loader.js

@@ -14,6 +14,13 @@ export class FilesystemLoader {
         this.logger = logger;
         this.contract = {
             name: 'filesystem',
+            protocol: 'file',
+            capabilities: {
+                read: true,
+                write: true,
+                watch: true,
+                list: true,
+            },
             supportedFormats: ['json', 'yaml', 'typescript', 'javascript'],
             supportsWatch: true,
             supportsWrite: true,
@@ -82,7 +89,7 @@ export class FilesystemLoader {
             if (useCache) {
                 this.cache.set(cacheKey, {
                     data,
-                    etag: stats.etag,
+                    etag: stats.etag || '',
                     timestamp: Date.now(),
                 });
             }

package/dist/plugin.d.ts

@@ -9,7 +9,7 @@ export declare class MetadataPlugin implements Plugin {
     private manager;
     private options;
     constructor(options?: MetadataPluginOptions);
-    init(ctx: PluginContext): Promise<void>;
-    start(ctx: PluginContext): Promise<void>;
+    init: (ctx: PluginContext) => Promise<void>;
+    start: (ctx: PluginContext) => Promise<void>;
 }
 //# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAI1D,MAAM,WAAW,qBAAqB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,cAAe,YAAW,MAAM;IACzC,IAAI,SAA8B;IAClC,OAAO,SAAW;IAElB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,OAAO,CAAwB;gBAE3B,OAAO,GAAE,qBAA0B;IAezC,IAAI,CAAC,GAAG,EAAE,aAAa;IAQvB,KAAK,CAAC,GAAG,EAAE,aAAa;CAiDjC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAI1D,MAAM,WAAW,qBAAqB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,cAAe,YAAW,MAAM;IACzC,IAAI,SAA8B;IAClC,OAAO,SAAW;IAElB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,OAAO,CAAwB;gBAE3B,OAAO,GAAE,qBAA0B;IAe/C,IAAI,GAAU,KAAK,aAAa,mBAM/B;IAED,KAAK,GAAU,KAAK,aAAa,mBAgDhC;CACJ"}

package/dist/plugin.js

@@ -4,6 +4,59 @@ export class MetadataPlugin {
     constructor(options = {}) {
         this.name = 'com.objectstack.metadata';
         this.version = '1.0.0';
+        this.init = async (ctx) => {
+            ctx.logger.info('Initializing Metadata Manager', { root: this.options.rootDir || process.cwd() });
+            // Register Metadata Manager as a service
+            // This allows other plugins to query raw metadata or listen to changes
+            ctx.registerService('metadata', this.manager);
+        };
+        this.start = async (ctx) => {
+            ctx.logger.info('Loading metadata...');
+            // Define metadata types directly from the Protocol Definition
+            // This ensures the loader is always in sync with the Spec
+            const metadataTypes = Object.keys(ObjectStackDefinitionSchema.shape)
+                .filter(key => key !== 'manifest'); // Manifest is handled separately
+            for (const type of metadataTypes) {
+                try {
+                    // Try to load metadata of this type
+                    const items = await this.manager.loadMany(type, {
+                        recursive: true
+                    });
+                    if (items.length > 0) {
+                        ctx.logger.info(`Loaded ${items.length} ${type}`);
+                        // Helper: Register with ObjectQL Registry
+                        const ql = ctx.getService('objectql');
+                        if (ql && ql.registry) {
+                            items.forEach((item) => {
+                                // Determine key field (id or name)
+                                const keyField = item.id ? 'id' : 'name';
+                                // Map plural type to singular/registry type if needed
+                                // For now, we use the singular form for standard types: 
+                                // objects -> object, apps -> app, etc.
+                                // But Registry seems to accept arbitrary strings.
+                                // To match Protocol standard, we might want to normalize.
+                                // Let's use the directory name (plural) as the type for now,
+                                // OR map 'objects' -> 'object' specifically.
+                                let registryType = type;
+                                if (type === 'objects')
+                                    registryType = 'object';
+                                if (type === 'apps')
+                                    registryType = 'app';
+                                if (type === 'plugins')
+                                    registryType = 'plugin';
+                                if (type === 'functions')
+                                    registryType = 'function';
+                                ql.registry.registerItem(registryType, item, keyField);
+                            });
+                        }
+                    }
+                }
+                catch (e) {
+                    // Ignore missing directories or errors
+                    // ctx.logger.debug(`No metadata found for type: ${type}`);
+                }
+            }
+        };
         this.options = {
             watch: true,
             ...options
@@ -15,57 +68,4 @@ export class MetadataPlugin {
             formats: ['yaml', 'json', 'typescript', 'javascript']
         });
     }
-    async init(ctx) {
-        ctx.logger.info('Initializing Metadata Manager', { root: this.options.rootDir || process.cwd() });
-        // Register Metadata Manager as a service
-        // This allows other plugins to query raw metadata or listen to changes
-        ctx.registerService('metadata', this.manager);
-    }
-    async start(ctx) {
-        ctx.logger.info('Loading metadata...');
-        // Define metadata types directly from the Protocol Definition
-        // This ensures the loader is always in sync with the Spec
-        const metadataTypes = Object.keys(ObjectStackDefinitionSchema.shape)
-            .filter(key => key !== 'manifest'); // Manifest is handled separately
-        for (const type of metadataTypes) {
-            try {
-                // Try to load metadata of this type
-                const items = await this.manager.loadMany(type, {
-                    recursive: true
-                });
-                if (items.length > 0) {
-                    ctx.logger.info(`Loaded ${items.length} ${type}`);
-                    // Helper: Register with ObjectQL Registry
-                    const ql = ctx.getService('objectql');
-                    if (ql && ql.registry) {
-                        items.forEach((item) => {
-                            // Determine key field (id or name)
-                            const keyField = item.id ? 'id' : 'name';
-                            // Map plural type to singular/registry type if needed
-                            // For now, we use the singular form for standard types: 
-                            // objects -> object, apps -> app, etc.
-                            // But Registry seems to accept arbitrary strings.
-                            // To match Protocol standard, we might want to normalize.
-                            // Let's use the directory name (plural) as the type for now,
-                            // OR map 'objects' -> 'object' specifically.
-                            let registryType = type;
-                            if (type === 'objects')
-                                registryType = 'object';
-                            if (type === 'apps')
-                                registryType = 'app';
-                            if (type === 'plugins')
-                                registryType = 'plugin';
-                            if (type === 'functions')
-                                registryType = 'function';
-                            ql.registry.registerItem(registryType, item, keyField);
-                        });
-                    }
-                }
-            }
-            catch (e) {
-                // Ignore missing directories or errors
-                // ctx.logger.debug(`No metadata found for type: ${type}`);
-            }
-        }
-    }
 }

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@objectstack/metadata",
-  "version": "0.9.2",
+  "version": "1.0.0",
+  "license": "Apache-2.0",
   "description": "Metadata loading, saving, and persistence for ObjectStack",
   "main": "src/index.ts",
   "types": "src/index.ts",
@@ -16,9 +17,9 @@
     "js-yaml": "^4.1.0",
     "chokidar": "^3.5.3",
     "zod": "^4.3.6",
-    "@objectstack/core": "0.9.2",
-    "@objectstack/spec": "0.9.2",
-    "@objectstack/types": "0.9.2"
+    "@objectstack/core": "1.0.0",
+    "@objectstack/spec": "1.0.0",
+    "@objectstack/types": "1.0.0"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",

package/src/loaders/filesystem-loader.ts

@@ -22,6 +22,13 @@ import type { MetadataSerializer } from '../serializers/serializer-interface.js'
 export class FilesystemLoader implements MetadataLoader {
   readonly contract: MetadataLoaderContract = {
     name: 'filesystem',
+    protocol: 'file',
+    capabilities: {
+      read: true,
+      write: true,
+      watch: true,
+      list: true,
+    },
     supportedFormats: ['json', 'yaml', 'typescript', 'javascript'],
     supportsWatch: true,
     supportsWrite: true,
@@ -99,7 +106,7 @@ export class FilesystemLoader implements MetadataLoader {
 
       // Load and deserialize
       const content = await fs.readFile(filePath, 'utf-8');
-      const serializer = this.getSerializer(stats.format);
+      const serializer = this.getSerializer(stats.format!);
 
       if (!serializer) {
         throw new Error(`No serializer found for format: ${stats.format}`);
@@ -111,7 +118,7 @@ export class FilesystemLoader implements MetadataLoader {
       if (useCache) {
         this.cache.set(cacheKey, {
           data,
-          etag: stats.etag,
+          etag: stats.etag || '',
           timestamp: Date.now(),
         });
       }

package/src/plugin.ts

@@ -29,7 +29,7 @@ export class MetadataPlugin implements Plugin {
         });
     }
 
-    async init(ctx: PluginContext) {
+    init = async (ctx: PluginContext) => {
         ctx.logger.info('Initializing Metadata Manager', { root: this.options.rootDir || process.cwd() });
         
         // Register Metadata Manager as a service
@@ -37,7 +37,7 @@ export class MetadataPlugin implements Plugin {
         ctx.registerService('metadata', this.manager);
     }
 
-    async start(ctx: PluginContext) {
+    start = async (ctx: PluginContext) => {
         ctx.logger.info('Loading metadata...');
         
         // Define metadata types directly from the Protocol Definition