Table of Contents

Jiro.Libs v2.0.0 "Kaizen"

Release Date: 2025/07/12
Release Type: Major Release
Branch: master
Code Name: Kaizen (改善) - "Continuous Improvement"

🎉 Overview

This is the initial major release of Jiro.Libs, introducing a comprehensive command framework and plugin system for .NET applications. This release establishes the foundation for building extensible applications with dynamic command processing and plugin architecture.

✨ Features Added

Core Framework

  • Jiro.Commands Library: Complete command framework with attribute-based registration
  • Plugin System: Dynamic plugin loading and management capabilities
  • ASP.NET Core Integration: Built-in support for web applications and APIs
  • Type Parsing System: Flexible parameter parsing with custom type support
  • Command Registration: Automatic discovery and registration of commands and modules

Command System

  • ICommandBase interface for command implementations
  • CommandAttribute for declarative command registration
  • CommandModuleAttribute for organizing commands into modules
  • Support for command parameters with automatic type conversion
  • Command result types: TextResult, JsonResult, ImageResult, GraphResult

Plugin Architecture

  • IPlugin interface for plugin implementations
  • PluginManager for dynamic plugin loading and lifecycle management
  • Plugin isolation and sandboxing capabilities
  • Configuration-based plugin management

Development Tools

  • ExampleApp: Complete ASP.NET Core demonstration application
  • ExamplePlugin: Reference plugin implementation
  • Comprehensive documentation and examples

🔄 Changes

Project Structure

  • Established modular architecture with separate libraries
  • Organized source code into logical namespaces
  • Created comprehensive example applications

Dependencies

  • Targeting .NET 9.0 for latest framework features
  • Integration with Microsoft.Extensions ecosystem
  • ASP.NET Core framework dependencies

🛠️ Technical Details

Architecture

  • Command Processing Pipeline: Efficient command parsing and execution
  • Reflection-based Discovery: Automatic command and plugin detection
  • Dependency Injection: Full integration with .NET DI container
  • Exception Handling: Comprehensive error handling with CommandException

API Design

  • Fluent interfaces for command configuration
  • Strongly-typed command parameters
  • Extensible result system for various output types
  • Clean separation of concerns between core and platform-specific code

Performance

  • Optimized command lookup and execution
  • Efficient plugin loading and caching
  • Minimal overhead for command processing

📦 Components

Libraries

  • Jiro.Commands (1.0.0): Core command and plugin framework

Examples

  • ExampleApp: ASP.NET Core web application showcasing framework usage
  • ExamplePlugin: Sample plugin demonstrating plugin development

Tools and Scripts

  • PowerShell release automation scripts
  • Documentation generation tools
  • Development environment setup

🔧 Installation

NuGet Package

dotnet add package Jiro.Commands

Manual Installation

  1. Download the release artifacts
  2. Reference the Jiro.Commands.dll in your project
  3. Follow the getting started guide in the documentation

📊 Release Metrics

  • Libraries: 1 (Jiro.Commands)
  • Example Projects: 2 (ExampleApp, ExamplePlugin)
  • Core Interfaces: 5+ command and plugin interfaces
  • Result Types: 4 built-in result types
  • Documentation Pages: Comprehensive getting started guide
  • Target Framework: .NET 9.0

🚀 Migration Guide

This is the initial release, so no migration is required. For new projects:

  1. Install the Jiro.Commands NuGet package
  2. Configure your application using the provided examples
  3. Implement commands using the ICommandBase interface
  4. Use attributes for command registration
  5. Optionally implement plugins using the IPlugin interface

🔮 What's Next

Upcoming Features (v2.1.0)

  • Enhanced plugin security and sandboxing
  • Command middleware pipeline
  • Advanced parameter validation
  • Performance monitoring and metrics

Long-term Roadmap

  • Integration with more .NET frameworks
  • Visual plugin management tools
  • Advanced command scheduling
  • Distributed command processing

📝 Breaking Changes

None - This is the initial release.

🙏 Acknowledgments

This release establishes the foundation for the Jiro.Libs ecosystem, providing developers with powerful tools for building extensible .NET applications.

Full Changelog: https://github.com/HueByte/Jiro.Libs/compare/initial...v2.0.0
Documentation: https://huebyte.github.io/Jiro.Libs/
Issues: https://github.com/HueByte/Jiro.Libs/issues

Edit this page