Unified-Style Pipeline & Registry - Implementation Summary
Overview
GLOST v0.5.0 implements a comprehensive unified/remark-style pipeline and registry system, transforming it from a good extension system into a powerful, discoverable plugin ecosystem.
What Was Built
1. Unified-Style Processor API ✅
Package: @glotblocks/glost-processor
Fluent processor API similar to unified/remark:
const processor = glost()
.use(transcription, { scheme: "ipa" })
.use(translation, { target: "en" })
.use(frequency)
.freeze();
const result = await processor.process(document);Features:
- Fluent
.use()chaining - Plugin functions, extension objects, or string IDs
- Preset support
- Hooks and middleware (before, after, onError, onSkip, onProgress)
- Data storage for sharing state
- Freezing for reuse
- Enhanced error handling and processing reports
Documentation: Processor API Guide
2. Enhanced Plugin Registry ✅
Package: @glotblocks/glost-registry
Comprehensive plugin registry with discovery, metadata, and validation:
pluginRegistry.register(myExtension, {
version: "1.0.0",
category: "enhancer",
tags: ["transcription"],
supports: { languages: ["th"], async: true }
});
const plugins = pluginRegistry.search({ language: "th" });
const report = pluginRegistry.checkConflicts(["plugin1", "plugin2"]);Features:
- Rich plugin metadata
- Discovery and search
- Validation (options, compatibility, dependencies)
- Conflict detection
- Dependency resolution
- Statistics
Documentation: Registry Guide
3. CLI Tools ✅
Package: @glotblocks/glost-cli
Command-line tools for plugin management:
glost plugins list
glost plugins search transcription
glost plugins info transcription
glost plugins validate transcription translation frequency
glost plugins create MyPluginDocumentation: CLI Package
4. Presets System ✅
Package: @glotblocks/glost-presets
Pre-configured plugin combinations for common use cases:
import { languageLearningPreset } from "@glotblocks/glost-presets";
const processor = glost()
.use(languageLearningPreset);Built-in Presets:
- Language Learning - Full stack (transcription, translation, frequency, difficulty, POS)
- Reading App - Interactive reading (transcription, translation, clause segmentation)
- Vocabulary Builder - Word focus (frequency, difficulty, translation)
- Grammar Analyzer - Grammar focus (POS, clause segmentation, gender)
- Minimal - Just the essentials (transcription, translation)
Documentation: Presets Package
Architecture
glost/
├── packages/
│ ├── glost/ # Main facade package
│ ├── glost-core/ # Core types and nodes
│ ├── processor/ # Fluent processor API
│ ├── registry/ # Plugin registry
│ ├── presets/ # Preset configurations
│ └── cli/ # CLI toolsBenefits
For Users
- Intuitive API - Familiar unified/remark-style interface
- Plugin Discovery - Easily find and explore plugins
- Safe Composition - Automatic conflict detection
- Presets - Quick setup with common configurations
- CLI Tools - Command-line plugin management
For Plugin Authors
- Rich Metadata - Describe capabilities and requirements
- Discoverability - Users can find plugins easily
- Validation - Automatic option validation
- Conflict Declaration - Declare incompatibilities
For the Ecosystem
- Standardization - Common patterns and practices
- Interoperability - Plugins work together seamlessly
- Growth - Easy to add new plugins
- Quality - Validation ensures quality
Backwards Compatibility
The old API still works but is deprecated:
// Old API (deprecated, will be removed in v1.0)
import { processGLOSTWithExtensions } from "@glotblocks/glost-plugins";
const result = processGLOSTWithExtensions(doc, [ext1, ext2]);
// New API (recommended)
import { glost } from "@glotblocks/glost";
const result = await glost().use(ext1).use(ext2).process(document);Migration
See the Migration Guide for detailed migration instructions.
Status
✅ All features implemented and documented ✅ 4 new packages created ✅ Backwards compatible with v0.4.x ✅ Ready for production use