Kobold 0.3.3 → 0.4.0

data/sig/Kobold.rbs

@@ -1,4 +1,220 @@
 module Kobold
   VERSION: String
-  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+  FORMAT_VERSION: String
+  KOBOLD_DIR: String
+
+  def self.invoke: (?config_path: String, ?database_name: String) -> Array[Hash[Symbol, untyped]]
+  def self.fetch: (?config_path: String, ?database_name: String) -> Array[Hash[Symbol, untyped]]
+  def self.init: (?dir: String) -> Hash[Symbol, untyped]
+
+  class Manager
+    attr_reader database: Database
+
+    def initialize: (?database: String) -> void
+
+    # Repo Registration
+    def register: (String repo, source: String) -> Hash[Symbol, untyped]
+    def unregister: (String repo) -> Hash[Symbol, untyped]
+
+    # Fetch
+    def fetch: (String repo) -> Hash[Symbol, untyped]
+    def fetch_all: (?config_path: String) -> Array[Hash[Symbol, untyped]]
+
+    # Checkout
+    def checkout: (String repo, ?branch: String?, ?commit: String?, ?label: String?, ?dir: String?) -> Hash[Symbol, untyped]
+
+    # Branching
+    def create_branch: (String repo, name: String, ?from: String, ?dir: String?) -> Hash[Symbol, untyped]
+
+    # Worktree Management
+    def remove_worktree: (String repo, dir: String) -> Hash[Symbol, untyped]
+
+    # Invoke
+    def invoke: (?config_path: String) -> Array[Hash[Symbol, untyped]]
+
+    # Init
+    def init: (?dir: String) -> Hash[Symbol, untyped]
+
+    # Listing
+    def list_repos: () -> Hash[String, Hash[String, String]]
+    def list_worktrees: (String repo) -> Array[String]
+    def list_branches: (String repo) -> Array[String]
+
+    # Config Generation
+    def generate_config: (path: String, ?dependencies: Array[Hash[Symbol | String, untyped]], ?includes: Array[String]) -> Hash[Symbol, untyped]
+
+    # Clean
+    def clean: (?purge_repos: bool, ?config_path: String?) -> Hash[Symbol, Array[Hash[Symbol, untyped]]]
+
+    # Add Dependency
+    def add: (config_path: String, name: String, repo: String, source: String, ?branch: String?, ?commit: String?, ?label: String?, ?dir: String?) -> Hash[Symbol, untyped]
+
+    # Remove Dependency
+    def remove: (config_path: String, dependency_name: String, ?cleanup: bool) -> Hash[Symbol, untyped]
+
+    # Update Dependency
+    def update: (config_path: String, dependency_name: String) -> Hash[Symbol, untyped]
+    def update_all: (?config_path: String) -> Array[Hash[Symbol, untyped]]
+
+    # Database Lifecycle (class methods)
+    def self.create_database: (String name) -> Hash[Symbol, untyped]
+    def self.delete_database: (String name) -> Hash[Symbol, untyped]
+    def self.list_databases: () -> Array[String]
+
+    private
+
+    def build_clone_url: (String source, String repo) -> String
+    def resolve_config: (String config_path) -> Config
+    def referenced_slugs_from_config: (String config_path) -> Set[String]
+  end
+
+  module Errors
+    class RepoNotFound < StandardError
+      def initialize: (String slug) -> void
+    end
+
+    class WorktreeExists < StandardError
+      def initialize: (String path) -> void
+    end
+
+    class ConfigError < StandardError
+    end
+
+    class DatabaseNotFound < StandardError
+      def initialize: (String name) -> void
+    end
+
+    class InvalidFormat < StandardError
+      def initialize: (String version, String expected) -> void
+    end
+
+    class CloneError < StandardError
+      def initialize: (String url, String message) -> void
+    end
+
+    class FetchError < StandardError
+      def initialize: (String slug, String message) -> void
+    end
+
+    class GitError < StandardError
+    end
+
+    class DependencyNotFound < StandardError
+      def initialize: (String name) -> void
+    end
+
+    class DatabaseExists < StandardError
+      def initialize: (String name) -> void
+    end
+
+    class LinkError < StandardError
+    end
+  end
+
+  module GitOps
+    def self.clone: (String url, String path) -> untyped
+    def self.open: (String path) -> untyped
+    def self.create_worktree: (untyped repo, String path, String ref) -> void
+    def self.remove_worktree: (untyped repo, String path) -> void
+    def self.fetch: (untyped repo, ?label: String) -> void
+    def self.resolve_ref: (untyped repo, String ref) -> String
+    def self.resolve_branch_head: (untyped repo, String branch) -> String
+  end
+
+  class Config
+    REQUIRED_KEYS: Array[String]
+    OPTIONAL_KEYS: Array[String]
+    ALL_DEP_KEYS: Array[String]
+
+    attr_reader format_version: String
+    attr_reader includes: Array[String]
+    attr_reader dependencies: Hash[String, Hash[String, String]]
+    attr_reader path: String?
+
+    def self.read: (String path) -> Config
+    def self.write: (String path, Config config) -> void
+    def self.generate: (?dependencies: Array[Hash[Symbol | String, untyped]], ?includes: Array[String]) -> Config
+    def self.validate: (Hash[String, untyped] data) -> true
+
+    def initialize: (data: Hash[String, untyped], ?path: String?) -> void
+    def to_h: () -> Hash[String, untyped]
+    def each_dependency: () { (String, Hash[String, String]) -> void } -> void
+    def add_dependency: (String name, Hash[String | Symbol, String?] dep) -> void
+    def remove_dependency: (String name) -> Hash[String, String]?
+    def dependency?: (String name) -> bool
+    def dependency: (String name) -> Hash[String, String]?
+    def update_dependency: (String name, String key, String? value) -> void
+  end
+
+  class Database
+    REGISTRY_FILE: String
+
+    attr_reader name: String
+
+    def self.list_databases: () -> Array[String]
+    def self.exists?: (String name) -> bool
+    def self.slugify: (String repo_path) -> String
+
+    def initialize: (?String name) -> void
+    def path: () -> String
+    def setup: () -> void
+    def exists?: () -> bool
+    def delete: () -> void
+    def register_repo: (String slug, String source_url) -> Hash[String, String]
+    def unregister_repo: (String slug) -> void
+    def list_repos: () -> Hash[String, Hash[String, String]]
+    def repo: (String slug) -> Repo
+    def repos_dir: () -> String
+  end
+
+  class Repo
+    attr_reader database: Database
+    attr_reader slug: String
+    attr_reader source_url: String
+
+    def initialize: (Database database, String slug, String source_url) -> void
+    def path: () -> String
+    def source_path: () -> String
+    def clone: () -> untyped
+    def cloned?: () -> bool
+    def fetch: () -> void
+    def create_worktree: (?branch: String?, ?commit: String?, ?label: String?) -> String
+    def remove_worktree: (String identifier) -> void
+    def create_branch: (String name, ?from: String) -> String
+    def list_worktrees: () -> Array[String]
+    def list_branches: () -> Array[String]
+    def resolve_branch_head: (String branch) -> String
+    def purge: () -> void
+    def worktree_path_for: (?branch: String?, ?commit: String?, ?label: String?) -> String
+  end
+
+  module Linker
+    def self.link: (String target, String destination) -> String
+    def self.unlink: (String destination) -> void
+    def self.relink: (String target, String destination) -> String
+    def self.valid?: (String destination) -> bool
+  end
+
+  module Settings
+    CONFIG_FILE: String
+    DEFAULT_SOURCE: String
+
+    def self.config_path: () -> String
+    def self.read: () -> Hash[String, untyped]
+    def self.write: (Hash[String, untyped] data) -> void
+    def self.get: (String key) -> String?
+    def self.set: (String key, String value) -> void
+    def self.default_source: () -> String
+    def self.default_source=: (String url) -> void
+  end
+
+  class CLI
+    COMMANDS: Array[String]
+    EXIT_SUCCESS: Integer
+    EXIT_ERROR: Integer
+    EXIT_USAGE: Integer
+
+    def initialize: (?Array[String] argv) -> void
+    def run: () -> void
+  end
 end

metadata

@@ -1,86 +1,45 @@
 --- !ruby/object:Gem::Specification
 name: Kobold
 version: !ruby/object:Gem::Version
-  version: 0.3.3
+  version: 0.4.0
 platform: ruby
 authors:
 - CatsAtTheRodeo
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-11-10 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: tty-option
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.3.0
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.3.0
-- !ruby/object:Gem::Dependency
-  name: tty-config
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.6.0
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.6.0
-- !ruby/object:Gem::Dependency
-  name: inifile
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 3.0.0
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 3.0.0
 - !ruby/object:Gem::Dependency
   name: git
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.18.0
+        version: '4.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.18.0
+        version: '4.3'
 - !ruby/object:Gem::Dependency
-  name: tty-progressbar
+  name: toml-rb
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.18.2
+        version: '3.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.18.2
-description:
+        version: '3.0'
+description: Manages Git repositories as packages. Clones repos into a local cache,
+  creates Git worktrees for specific branches/commits, and symlinks them into project
+  directories.
 email:
 - contact@tradam.dev
 executables:
@@ -88,7 +47,26 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- ".rspec"
 - ".rubocop.yml"
+- ".rules/bugs/untestable.md"
+- ".rules/changelog/2026-03/30/01.md"
+- ".rules/changelog/2026-03/30/02.md"
+- ".rules/changelog/2026-03/30/03.md"
+- ".rules/changelog/2026-03/30/04.md"
+- ".rules/changelog/2026-03/30/05.md"
+- ".rules/changelog/2026-03/30/06.md"
+- ".rules/changelog/2026-03/30/07.md"
+- ".rules/changelog/2026-03/30/08.md"
+- ".rules/changelog/2026-03/30/09.md"
+- ".rules/changelog/2026-03/30/10.md"
+- ".rules/changelog/2026-03/30/11.md"
+- ".rules/changelog/2026-03/30/12.md"
+- ".rules/changelog/2026-03/30/13.md"
+- ".rules/changelog/2026-03/30/14.md"
+- ".rules/changelog/2026-03/30/15.md"
+- ".rules/default/rubocop.md"
+- ".rules/docs/kobold_api.md"
 - CHANGELOG.md
 - Kobold Notes/.obsidian/app.json
 - Kobold Notes/.obsidian/appearance.json
@@ -102,10 +80,35 @@ files:
 - Rakefile
 - exe/kobold
 - lib/Kobold.rb
-- lib/Kobold/first_time_setup.rb
+- lib/Kobold/cli.rb
+- lib/Kobold/cli/admin_commands.rb
+- lib/Kobold/cli/checkout_commands.rb
+- lib/Kobold/cli/error_handling.rb
+- lib/Kobold/cli/flag_parser.rb
+- lib/Kobold/cli/init_commands.rb
+- lib/Kobold/cli/lifecycle_commands.rb
+- lib/Kobold/cli/list_commands.rb
+- lib/Kobold/cli/output.rb
+- lib/Kobold/cli/repo_commands.rb
+- lib/Kobold/cli/update_commands.rb
+- lib/Kobold/config.rb
+- lib/Kobold/database.rb
+- lib/Kobold/errors.rb
+- lib/Kobold/fetch.rb
+- lib/Kobold/git_ops.rb
 - lib/Kobold/init.rb
 - lib/Kobold/invoke.rb
-- lib/Kobold/read_config.rb
+- lib/Kobold/linker.rb
+- lib/Kobold/manager.rb
+- lib/Kobold/manager/checkout.rb
+- lib/Kobold/manager/cleaning.rb
+- lib/Kobold/manager/fetching.rb
+- lib/Kobold/manager/invoking.rb
+- lib/Kobold/manager/lifecycle.rb
+- lib/Kobold/manager/registration.rb
+- lib/Kobold/repo.rb
+- lib/Kobold/repo/worktree_helpers.rb
+- lib/Kobold/settings.rb
 - lib/Kobold/version.rb
 - prototyping/.gitignore
 - prototyping/.kobold
@@ -113,12 +116,11 @@ files:
 - prototyping/main.c
 - sample-project-ideas/.kobold
 - sig/Kobold.rbs
-homepage:
+homepage: https://github.com/CatsAtTheRodeo/Kobold
 licenses:
 - MIT
 metadata:
   source_code_uri: https://github.com/CatsAtTheRodeo/Kobold
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -126,15 +128,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.7.2
+      version: '3.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.25
-signing_key:
+rubygems_version: 4.0.3
 specification_version: 4
-summary: Version manager for various libraries and projects.
+summary: Git-based package manager for libraries and projects.
 test_files: []

data/lib/Kobold/first_time_setup.rb

@@ -1,14 +0,0 @@
-# frozen_string_literal: true
-
-require "tty-config"
-require 'fileutils'
-require 'git'
-
-module Kobold
-  class << self
-    def first_time_setup
-      FileUtils.mkdir_p "#{KOBOLD_DIR}/repo_cache"
-    end
-  end
-end
-

data/lib/Kobold/read_config.rb

@@ -1,15 +0,0 @@
-# frozen_string_literal: true
-
-require "tty-config"
-#require 'fileutils'
-
-module Kobold
-  class << self
-    def read_config(dir)
-      config = TTY::Config.new
-      config.append_path dir
-      settings = config.read ".kobold", format: :ini
-      return settings
-    end
-  end
-end