@specverse/engine-registry

Registry client for the SpecVerse community library platform.

Features

• Registry client — search, fetch, and resolve specs from the community registry
• Cache manager — local caching with TTL for registry responses
• Offline handler — graceful fallback when registry is unreachable
• Manifest validator — validate implementation manifests against registry
• Installation validator — verify installed packages match manifest
• Error formatter — structured error reporting for validation results

Usage

import { Validator, ErrorFormatter, RegistryClient } from '@specverse/engine-registry';

// Validate a manifest
const validator = new Validator();
const result = await validator.validate({
  manifest: { filePath: 'manifests/implementation.yaml' },
  installation: { projectRoot: process.cwd() }
});

// Format results
const formatter = new ErrorFormatter();
formatter.format(result);

API

| Export | Purpose | |--------|---------| | RegistryClient | HTTP client for the registry API | | CacheManager | Local cache with TTL management | | OfflineHandler | Fallback when registry unavailable | | Validator | Orchestrates manifest + installation validation | | ManifestValidator | Validates manifest structure and factory references | | InstallationValidator | Checks installed packages against manifest | | ErrorFormatter | Formats validation results for CLI output | | manifestConfigToSpecVerseManifest | Converts manifest config to validation format | | validateFactoryReferences | Checks factory references in capability mappings |