ukiryu 0.1.1 → 0.1.3

data/lib/ukiryu.rb

@@ -10,12 +10,15 @@ require_relative 'ukiryu/runtime'
 require_relative 'ukiryu/execution_context'
 require_relative 'ukiryu/type'
 require_relative 'ukiryu/executor'
-require_relative 'ukiryu/registry'
+require_relative 'ukiryu/register'
 require_relative 'ukiryu/tool'
 require_relative 'ukiryu/options_builder'
 require_relative 'ukiryu/schema_validator'
 require_relative 'ukiryu/io'
 
+# Definition loading
+require_relative 'ukiryu/definition'
+
 # Models - OOP representation of YAML profiles
 require_relative 'ukiryu/models'
 
@@ -60,11 +63,11 @@ module Ukiryu
 
   # Configuration class for global settings
   class Configuration
-    attr_accessor :default_shell, :registry_path
+    attr_accessor :default_shell, :register_path
 
     def initialize
       @default_shell = nil # Auto-detect by default
-      @registry_path = nil
+      @register_path = nil
     end
   end
 end

data/ukiryu-proposal.md

@@ -40,7 +40,7 @@ Ukiryu consists of two separate repositories:
                             │ loads
                             ▼
 ┌─────────────────────────────────────────────────────────────────────┐
-│  ukiryu/register (Tool Registry)                                     │
+│  ukiryu/register (Tool Register)                                     │
 │  ┌─────────────────────────────────────────────────────────────────┐ │
 │  │ YAML Profiles: Tool Definitions                                 │ │
 │  │                                                                  │ │
@@ -66,7 +66,7 @@ Ukiryu consists of two separate repositories:
 | **Contributors** | Developers only | Anyone can add tools (no Ruby needed) |
 | **Maintenance** | Code changes for new tools | YAML file changes for new tools |
 | **Validation** | Test framework | Validate YAML against schema |
-| **Discovery** | Gem update | `git pull` on registry |
+| **Discovery** | Gem update | `git pull` on register |
 | **Flexibility** | Coupled | Decoupled - use custom registries |
 
 ---
@@ -95,8 +95,8 @@ end
 Ukiryu turns external CLI commands into Ruby methods:
 
 ```ruby
-# Load tool profiles from registry
-Ukiryu::Registry.load_from("ukiryu/register")
+# Load tool profiles from register
+Ukiryu::Register.load_from("ukiryu/register")
 
 # Get the tool
 inkscape = Ukiryu::Tool.get("inkscape")
@@ -244,7 +244,7 @@ Ukiryu separates **framework logic** (Ruby) from **tool definitions** (YAML):
                             │ loads
                             ▼
 ┌─────────────────────────────────────────────────────────────┐
-│                 TOOL PROFILES (YAML Registry)              │
+│                 TOOL PROFILES (YAML Register)              │
 │  - inkscape.yaml (all versions)                            │
 │  - ghostscript.yaml (all versions)                         │
 │  - imagemagick.yaml (all versions)                         │
@@ -261,8 +261,8 @@ Ukiryu separates **framework logic** (Ruby) from **tool definitions** (YAML):
 | **Version update** | Requires code + release | Update YAML |
 | **Maintenance** | Developers only | Anyone can edit |
 | **Validation** | Compile-time | Load-time |
-| **Distribution** | Gem releases | Separate registry |
-| **Community** | Pull requests | PRs to registry repo |
+| **Distribution** | Gem releases | Separate register |
+| **Community** | Pull requests | PRs to register repo |
 
 ### YAML Profile Structure
 
@@ -394,9 +394,9 @@ profiles:
             separator: " "
 ```
 
-### YAML Profile Registry
+### YAML Profile Register
 
-**Registry structure:**
+**Register structure:**
 ```
 ukiryu-register/
 ├── tools/
@@ -421,15 +421,15 @@ ukiryu-register/
 ├── schemas/
 │   ├── tool-profile.yaml.schema
 │   ├── command-definition.yaml.schema
-│   └── registry.yaml.schema
+│   └── register.yaml.schema
 ├── docs/
 │   ├── inkscape.adoc
 │   ├── ghostscript.adoc
 │   ├── contributing.adoc
-│   └── registry.adoc
+│   └── register.adoc
 ├── lib/
 │   └── ukiryu/
-│       └── registry.rb           # Registry helper library
+│       └── register.rb           # Register helper library
 ├── Gemfile                         # json-schema gem
 ├── Rakefile                        # Validation tasks
 └── README.adoc
@@ -438,19 +438,19 @@ ukiryu-register/
 **Version file naming:**
 - Use semantic version: `1.0.yaml`, `0.9.5.yaml`
 - Multiple profiles per version (platform/shell combos) in one file
-- Registry selects newest compatible version
+- Register selects newest compatible version
 
 **Loading profiles in Ukiryu:**
 ```ruby
-# Load from registry
-Ukiryu::Registry.load_from("/path/to/ukiryu/register")
+# Load from register
+Ukiryu::Register.load_from("/path/to/ukiryu/register")
 
 # Or load from gem-builtin profiles
-Ukiryu::Registry.load_builtins
+Ukiryu::Register.load_builtins
 
 # Load specific tool/version
-Ukiryu::Registry.load_tool("inkscape", version: "1.0")
-Ukiryu::Registry.load_tool("inkscape")  # Auto-detect latest
+Ukiryu::Register.load_tool("inkscape", version: "1.0")
+Ukiryu::Register.load_tool("inkscape")  # Auto-detect latest
 
 # Use the tool
 inkscape = Ukiryu::Tool.get("inkscape")
@@ -463,7 +463,7 @@ inkscape.export(
 
 **Schema validation with `json-schema` gem:**
 ```ruby
-# In registry Rakefile
+# In register Rakefile
 require 'json-schema'
 
 namespace :validate do
@@ -1088,7 +1088,7 @@ properties:
 **Validation with `json-schema` gem:**
 
 ```ruby
-# In registry Rakefile
+# In register Rakefile
 require 'json-schema'
 require 'yaml'
 
@@ -1125,11 +1125,11 @@ end
 ### Usage Examples
 
 ```ruby
-# Load from registry
-Ukiryu::Registry.load_from("~/.ukiryu/register")
+# Load from register
+Ukiryu::Register.load_from("~/.ukiryu/register")
 
 # Or load from gem
-Ukiryu::Registry.load_builtins
+Ukiryu::Register.load_builtins
 
 # Get tool
 inkscape = Ukiryu::Tool.get("inkscape")
@@ -1163,7 +1163,7 @@ result = inkscape.query(
 
 ## Core DSL Design (For Custom Tools)
 
-For tools not in the registry, users can still use Ruby DSL:
+For tools not in the register, users can still use Ruby DSL:
 
 ### Tool Declaration
 
@@ -2762,7 +2762,7 @@ Ukiryu succeeds when:
 2. ✅ **Exact profile matching** - No fallbacks (version compatibility OK)
 3. ✅ **Type-safe parameters** - All types validated, shell-escaped automatically
 4. ✅ **Semantic validation** - Platform-specific paths rejected on wrong platforms
-5. ✅ **YAML profile registry** - Tool definitions maintained in YAML, not code
+5. ✅ **YAML profile register** - Tool definitions maintained in YAML, not code
 6. ✅ **Schema validation** - All YAML profiles validated against JSON Schema
 7. ✅ **Profile inheritance** - Avoid duplication with YAML inheritance
 8. ✅ **Vectory replacement** - Full replacement of Vectory wrappers in 70% less code
@@ -2771,7 +2771,7 @@ Ukiryu succeeds when:
 11. ✅ **Zero dependencies** - Ruby stdlib only
 12. ✅ **Argument/option/flag distinction** - Clear DSL concepts
 13. ✅ **PATH-only on Unix** - No hardcoded paths on Unix/macOS
-14. ✅ **Community registry** - Separate registry repo for tool profiles
+14. ✅ **Community register** - Separate register repo for tool profiles
 15. ✅ **Option format variations** - Support all CLI option formats
 16. ✅ **Value separators** - Comma, semicolon, colon, space, pipe, plus
 17. ✅ **Environment variables** - Per-command environment variable support
@@ -2785,13 +2785,13 @@ Ukiryu succeeds when:
 1. **YAML profiles over Ruby DSL**: Tool definitions should be maintained in YAML files, not Ruby code. This allows:
    - Non-developers to add/update tools
    - Faster iteration without gem releases
-   - Community-contributed profile registry
+   - Community-contributed profile register
    - Separation of framework (Ruby) from configuration (YAML)
 
 2. **Hybrid architecture**:
    - **Ruby framework**: Shell detection, escaping, execution, validation
-   - **YAML registry**: Tool definitions, versions, platform profiles
-   - Users can still use Ruby DSL for custom tools not in registry
+   - **YAML register**: Tool definitions, versions, platform profiles
+   - Users can still use Ruby DSL for custom tools not in register
 
 3. **"symbols in shell"**: User correctly pointed out that `:symbol` is a Ruby type, not a shell concept. In the shell, we pass strings. The `:symbol` type is for Ruby-level validation only.
 
@@ -2837,12 +2837,12 @@ Ukiryu succeeds when:
 
 ---
 
-## Registry Organization
+## Register Organization
 
-**Registry repo structure:**
+**Register repo structure:**
 
 ```
-ukiryu-register/                    # Community registry repo
+ukiryu-register/                    # Community register repo
 ├── tools/                         # Tool definitions (dir by command name)
 │   ├── inkscape/
 │   │   ├── 1.0.yaml              # Version-specific profiles
@@ -2865,21 +2865,21 @@ ukiryu-register/                    # Community registry repo
 ├── schemas/                       # YAML Schema files
 │   ├── tool-profile.yaml.schema
 │   ├── command-definition.yaml.schema
-│   └── registry.yaml.schema
+│   └── register.yaml.schema
 ├── docs/                          # AsciiDoc documentation
 │   ├── inkscape.adoc
 │   ├── ghostscript.adoc
 │   ├── imagemagick.adoc
 │   ├── git.adoc
 │   ├── contributing.adoc
-│   ├── registry.adoc
+│   ├── register.adoc
 │   └── README.adoc
-├── lib/                           # Registry helper library
+├── lib/                           # Register helper library
 │   └── ukiryu/
-│       └── registry.rb
+│       └── register.rb
 ├── Gemfile                         # json-schema gem
 ├── Rakefile                        # Validation tasks
-└── README.adoc                     # Registry overview
+└── README.adoc                     # Register overview
 ```
 
 **Ukiryu gem structure:**
@@ -2889,7 +2889,7 @@ ukiryu/                             # Ruby gem
 ├── lib/
 │   ├── ukiryu.rb
 │   ├── ukiryu/
-│   │   ├── registry.rb            # YAML loader from registry
+│   │   ├── register.rb            # YAML loader from register
 │   │   ├── tool.rb                # Tool from YAML
 │   │   ├── shell.rb               # Shell detection (EXPLICIT)
 │   │   ├── shell/
@@ -2919,14 +2919,14 @@ gem 'json-schema', '~> 3.0'
 gem 'yaml', '~> 0.3'  # For schema validation
 ```
 
-**Registry README.adoc structure:**
+**Register README.adoc structure:**
 
 ```asciidoc
-= Ukiryu Tool Registry
+= Ukiryu Tool Register
 
 == Overview
 
-The Ukiryu Tool Registry maintains YAML profiles for command-line tools.
+The Ukiryu Tool Register maintains YAML profiles for command-line tools.
 
 == Tools
 

data/ukiryu.gemspec

@@ -29,6 +29,7 @@ Gem::Specification.new do |spec|
   spec.required_ruby_version = '>= 2.7.0'
 
   # Core dependencies
+  spec.add_dependency 'git', '~> 4.0'
   spec.add_dependency 'lutaml-model', '~> 0.7'
   spec.add_dependency 'thor', '~> 1.0'
 

metadata

@@ -1,15 +1,28 @@
 --- !ruby/object:Gem::Specification
 name: ukiryu
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.3
 platform: ruby
 authors:
 - Ribose Inc.
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-01-23 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: git
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
 - !ruby/object:Gem::Dependency
   name: lutaml-model
   requirement: !ruby/object:Gem::Requirement
@@ -69,30 +82,59 @@ files:
 - ".github/workflows/rake.yml"
 - ".github/workflows/release.yml"
 - ".gitignore"
-- ".gitmodules"
 - ".rubocop.yml"
 - ".rubocop_todo.yml"
 - Gemfile
 - README.adoc
 - Rakefile
+- docs/.gitignore
+- docs/Gemfile
+- docs/INDEX.adoc
+- docs/_config.yml
+- docs/advanced/custom-tool-classes.adoc
+- docs/advanced/index.adoc
 - docs/assets/logo.svg
+- docs/features/configuration.adoc
+- docs/features/index.adoc
+- docs/features/platform-support.adoc
+- docs/getting-started/core-concepts.adoc
+- docs/getting-started/index.adoc
+- docs/getting-started/installation.adoc
+- docs/getting-started/quick-start.adoc
+- docs/guides/env-var-sets.adoc
+- docs/guides/index.adoc
+- docs/interfaces/cli.adoc
+- docs/interfaces/index.adoc
+- docs/interfaces/ruby-api.adoc
+- docs/lychee.toml
+- docs/reference/configuration-options.adoc
+- docs/reference/error-codes.adoc
+- docs/reference/index.adoc
+- docs/reference/ruby-api.adoc
+- docs/understanding/index.adoc
 - exe/ukiryu
 - lib/ukiryu.rb
 - lib/ukiryu/action/base.rb
 - lib/ukiryu/cache.rb
 - lib/ukiryu/cli.rb
 - lib/ukiryu/cli_commands/base_command.rb
+- lib/ukiryu/cli_commands/cache_command.rb
 - lib/ukiryu/cli_commands/commands_command.rb
 - lib/ukiryu/cli_commands/commands_command.rb.fixed
 - lib/ukiryu/cli_commands/config_command.rb
+- lib/ukiryu/cli_commands/definitions_command.rb
 - lib/ukiryu/cli_commands/describe_command.rb
 - lib/ukiryu/cli_commands/describe_command.rb.fixed
+- lib/ukiryu/cli_commands/docs_command.rb
 - lib/ukiryu/cli_commands/exec_inline_command.rb.fixed
 - lib/ukiryu/cli_commands/extract_command.rb
 - lib/ukiryu/cli_commands/info_command.rb
+- lib/ukiryu/cli_commands/lint_command.rb
 - lib/ukiryu/cli_commands/list_command.rb
 - lib/ukiryu/cli_commands/opts_command.rb
 - lib/ukiryu/cli_commands/opts_command.rb.fixed
+- lib/ukiryu/cli_commands/register_command.rb
+- lib/ukiryu/cli_commands/resolve_command.rb
 - lib/ukiryu/cli_commands/response_formatter.rb
 - lib/ukiryu/cli_commands/run_command.rb
 - lib/ukiryu/cli_commands/run_file_command.rb
@@ -106,6 +148,21 @@ files:
 - lib/ukiryu/config/env_schema.rb
 - lib/ukiryu/config/override_resolver.rb
 - lib/ukiryu/config/type_converter.rb
+- lib/ukiryu/definition.rb
+- lib/ukiryu/definition/definition_cache.rb
+- lib/ukiryu/definition/definition_composer.rb
+- lib/ukiryu/definition/definition_linter.rb
+- lib/ukiryu/definition/definition_validator.rb
+- lib/ukiryu/definition/discovery.rb
+- lib/ukiryu/definition/documentation_generator.rb
+- lib/ukiryu/definition/lint_issue.rb
+- lib/ukiryu/definition/loader.rb
+- lib/ukiryu/definition/metadata.rb
+- lib/ukiryu/definition/source.rb
+- lib/ukiryu/definition/sources/file.rb
+- lib/ukiryu/definition/sources/string.rb
+- lib/ukiryu/definition/validation_result.rb
+- lib/ukiryu/definition/version_resolver.rb
 - lib/ukiryu/errors.rb
 - lib/ukiryu/executable_locator.rb
 - lib/ukiryu/execution.rb
@@ -150,7 +207,8 @@ files:
 - lib/ukiryu/options_builder/formatter.rb
 - lib/ukiryu/options_builder/validator.rb
 - lib/ukiryu/platform.rb
-- lib/ukiryu/registry.rb
+- lib/ukiryu/register.rb
+- lib/ukiryu/register_auto_manager.rb
 - lib/ukiryu/response/base.rb
 - lib/ukiryu/runtime.rb
 - lib/ukiryu/schema_validator.rb
@@ -182,7 +240,6 @@ homepage: https://github.com/riboseinc/ukiryu
 licenses:
 - BSD-2-Clause
 metadata: {}
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -197,8 +254,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Platform-adaptive command execution framework
 test_files: []

data/.gitmodules

@@ -1,3 +0,0 @@
-[submodule "schema"]
-	path = schema
-	url = git@github.com:ukiryu/schema.git