🌟 VoidCore.js v14.0 - Pure Message System

「すべての存在は、メッセージで生まれ、メッセージで終わる」
セリンの大改革完了 - 基底クラス継承完全排除！

Latest: v14.0 - Pure Message System 🚀

---

🎯 What is VoidCore?

VoidCore is a pure message-based system that enables beautiful plugin communication without inheritance. Think of it as a "postal service" for your application:

• 🏛️ VoidCore = Postal office that routes messages
• 🤖 Plugins = Customers who send and receive mail
• 📮 Messages = Letters with specific types (Notice, Request, Response, Proposal)
• 📋 Subscribe = Write on bulletin board "I want this type of mail"

---

📮 Try It Now - Super Beginner Friendly!

New to VoidCore? Start with our interactive demo:

🎯 📮 Simple VoidCore Demo!

Watch plugins talk to each other in real-time! See exactly which functions are called and how messages flow through the system.

---

🚀 Quick Start

Installation

git clone https://github.com/moe-charm/voidcore.js
cd voidcore-js
# Open examples/index.html in your browser - no build required!

Basic Usage (v14.0 Pure System)

import { voidCore, Message, createPlugin } from './src/index.js'

// Create a plugin (no inheritance!)
const myPlugin = createPlugin({
  pluginId: 'my-awesome-plugin',
  autoHealth: true
}, {
  async run() {
    await this.initialize();
    
    // Listen for messages
    this.on('Notice', 'user.login', (msg) => {
      console.log('User logged in:', msg.payload.userId);
    });
    
    // Send messages
    await this.notice('plugin.ready', {
      timestamp: Date.now()
    });
  }
});

// Start the plugin
await myPlugin.run();

---

🌟 Serin's Great Reform (v14.0)

✅ What Changed

• ❌ Base Class Inheritance → ✅ Pure Composition
• ❌ Forced Lifecycle → ✅ Optional Methods
• ❌ Type Constraints → ✅ Message-based Cooperation
• ❌ Complex Code → ✅ "Pleasant from the Start" Code

🎭 Before vs After

Before (Inheritance Hell):

class MyPlugin extends AutonomousPlugin {
  constructor() {
    super('my-plugin');  // Required base class
  }
  
  async _prepare() { /* Forced implementation */ }
  async _work() { /* Forced lifecycle */ }
}

After (Pure Beauty):

const myPlugin = createPlugin({
  pluginId: 'my-plugin'
}, {
  // Complete freedom - implement what you need
  async run() {
    await this.initialize();  // Optional
    // Your logic here
  }
});

---

📬 Message Types

VoidCore uses four clear message types for all communication:

1. Notice - "Something happened" (1-to-many)

await plugin.notice('user.login', {
  userId: 123,
  timestamp: Date.now()
});

2. IntentRequest - "Please do X" (1-to-1)

const request = Message.intentRequest('file_manager', 'file.open', {
  path: '/documents/readme.txt'
});
await voidCore.publish(request);

3. IntentResponse - "X completed" (1-to-1)

const response = Message.intentResponse('file.open', {
  status: 'success',
  content: 'File content here...'
});

4. Proposal - "Shall we do X?" (1-to-1, non-forceful)

await plugin.propose('backup_manager', 'system.backup', {
  action: 'Create daily backup',
  estimatedTime: 30000
});

---

🎮 Live Demos

Experience VoidCore in action:

🎯 For Beginners

• 📮 Simple VoidCore Demo - Interactive postal service visualization
• 🌌 Galaxy Viewer - Beautiful space physics

🚀 Advanced Examples

• 🧠 VoidIDE Genesis v2.0 - NEW! Complete IDE with analytics & visualization
• 🌟 VoidIDE Genesis MVP - Self-creating IDE that runs on VoidCore
• 🌟 Message City - Pure v14.0 system with traffic simulation
• 💓 Heart Transplant Demo - Transport swapping live
• 📚 All Examples - Complete demo collection

---

🤝 Gentleman's Agreement System

VoidCore v14.0 uses optional protocols instead of forced inheritance:

💊 Health Check Protocol

// Plugins can optionally respond to health checks
registerHealthCheck('my-plugin', {
  customStatus: 'All systems operational'
});

// Send health check request
await voidCore.publish(Message.intentRequest('*', 'core.health.ping', {}));

🧠 Process Declaration

// Plugins can declare their process info
declareProcess('my-plugin', {
  name: 'My Awesome Plugin',
  version: '1.0.0'
});

---

🔌 Transport Adapters (Heart Transplant)

Built-in Transports

DefaultTransport - Local memory (automatic)

// No setup needed - works out of the box

WebSocketTransport - Real-time networking

import { WebSocketTransport } from './src/transport.js'
await voidCore.setTransport(new WebSocketTransport('ws://server.com'))

BroadcastChannelTransport - Inter-tab communication

import { BroadcastChannelTransport } from './src/transport.js'
await voidCore.setTransport(new BroadcastChannelTransport('my-app'))

Custom Transport

export class MyTransport extends ITransport {
  async initialize() { /* Setup */ }
  async send(message, channel) { /* Send logic */ }
  subscribe(handler, channel) { /* Subscribe logic */ }
  getStats() { /* Statistics */ }
  async destroy() { /* Cleanup */ }
}

---

🌟 Evolution Timeline

Version	Feature	Philosophy
v14.0	🚀 Pure Message System	"All existence is born from messages and ends with messages"
v13.0	💓 Transport Adapters	Heart-swappable communication layers
v12.0	🚀 Multi-Channel	Performance boost with message separation
v11.0	🤖 Autonomous Core	Plugin lifecycle and message routing

---

🏗️ Project Structure

voidcore-js/
├── src/                         # Core library (v14.0)
│   ├── index.js                # New entry point
│   ├── pure_plugin_system.js   # Serin's Great Reform
│   ├── voidcore.js             # "The Vessel of Silence"
│   ├── message.js              # Message types
│   ├── transport.js            # Transport adapters
│   ├── channel-manager.js      # Channel management
│   └── legacy/                 # v13.0 compatibility
├── examples/                    # v14.0 demos
│   ├── voidcore-demo-visual.html  # Beginner-friendly
│   ├── message-city-modern.html   # Pure system demo
│   └── legacy/                 # Previous examples
├── challenge/                   # Interactive demos
├── docs/                       # Documentation
└── VOIDCORE_V14_CPP_SPEC.md    # C++ implementation spec

---

🤖 AI-Powered Development

Get started in 3 simple steps:

1. Clone: git clone https://github.com/moe-charm/voidcore.js
2. Open: Load examples in your browser
3. Build: Tell Claude Code to read the docs and "build [your app] with VoidCore"

---

📚 Documentation

v14.0 Pure System

• C++ Implementation Spec - Complete specification for C++ port
• Pure Plugin Guide - Interactive learning

Legacy Documentation

• v13.0 Transport Architecture - Heart transplant guide
• v12.0 Multi-Channel - Performance improvements
• Plugin Lifecycle - Autonomous plugin development

---

🎯 Core Philosophy

VoidCore embodies the principle of "静寂の器" (The Vessel of Silence):

1. 🤐 Silent Routing - Core knows nothing about message content, only types
2. 🕊️ Non-Invasive - No forced inheritance, pure composition
3. 🤝 Gentleman's Agreement - Optional protocols, maximum freedom
4. 💫 Pure Beauty - "Pleasant from the start" code

The VoidCore Way

// ❌ Don't fight the system
class MyPlugin extends BaseClass {
  // Complex inheritance hierarchy
}

// ✅ Flow with the messages
const myPlugin = createPlugin(config, {
  // Pure, beautiful, simple
});

---

✨ Key Features

• 🧠 VoidIDE Genesis v2.0 - Complete IDE with real-time analytics & visualization (v14.0 Phase 2)
• 🌊 Message Flow Visualization - Real-time message flow with animated particle effects
• 📊 Plugin Monitor Dashboard - Advanced plugin status monitoring & health checks
• ⚡ Performance Metrics System - Comprehensive performance analysis & optimization
• 🌟 VoidIDE Genesis - Self-creating IDE that runs on VoidCore itself (v14.0)
• 🚀 Pure Message System - No inheritance, pure composition (v14.0)
• 🧩 CoreFusion v1.2 - Merge multiple VoidCore instances seamlessly (v14.0)
• ⚡ SimpleMessagePool - 16-20x faster batch processing (v14.0)
• 💓 Heart Transplant - Swap transport layers at runtime (v13.0)
• 🚀 Multi-Channel Performance - 40% faster with dedicated channels (v12.0)
• 🔄 Perfect Backward Compatibility - All versions work together
• 🌐 Browser-Native - Pure JavaScript, no build tools
• 📦 Zero Dependencies - Lightweight and self-contained
• 🤝 Gentleman's Agreement - Optional protocols, maximum freedom

---

🤝 Contributing

VoidCore thrives on community contributions:

1. Fork the repository
2. Try the 📮 Simple VoidCore Demo first
3. Create your feature branch
4. Add tests and documentation
5. Submit a pull request

---

🌍 Language Versions

• 🟢 JavaScript - Current (v14.0 - Production Ready)
• 🚧 C++ - In Development (Specification ready)

---

📄 License

MIT License - see LICENSE file for details.

---

💖 Philosophy in Action

"哲学的に聞こえるかもしれませんが、実用性を徹底追求した結果です！"

Beautiful simplicity, infinite scalability, autonomous dignity.

The Journey

• v11.0: Birth of autonomous plugins
• v12.0: Performance breakthrough
• v13.0: Heart transplant revolution
• v14.0: Serin's Great Reform - Pure perfection achieved

---

🎉 What's Next?

JavaScript Version: Stable and production-ready C++ Version: Next frontier for ultimate performance

⭐ Star this repo if VoidCore sparked joy in your development workflow!

---

Ready to experience the beauty of pure message-based architecture?
🚀 Start with the Simple Demo