yamine 0.14.1 → 0.14.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b5f2bd591be3e0b58deef894b8772575e46068fe4cc6287eaedf18926874f965
-  data.tar.gz: a1136bf238dc84bb2c150a00e02c385f19d3c9dd17ed94142091772712777768
+  metadata.gz: 56dbba9d974dc247a9f96271e6dd40e0e68b170a6ad20f9e0660aa6fa1d20a28
+  data.tar.gz: 218da1110324af22c665581eeb26101a29628f1f4e96fed47e492aebd6c18488
 SHA512:
-  metadata.gz: 65139ff9a320e9fd827ef4ee1ea2b2f43d3ddb5d8aa14e31a642085a2e74cfa8f95ecdd03d3d1bd12af567a971d1f124c3b80cb5baa835d582cf5633169e73ca
-  data.tar.gz: 69b45bfe7fa0852be260ed74a1985a4f3052afa6aecd4bf821e29de721c71005082ad4b3ba078532df9ecf759f19a8ee9495f650734c296fc6e878b9356459ed
+  metadata.gz: 9e26fe517122747c2793eb2b441fe83289898796d47c99330d2589413873fa7a12ae1cc2a8b1da69928b39bc6f8ed01aa6e7647f682a872c80886d04d1a862be
+  data.tar.gz: ce6b77f5a0263594e698cae37ddd3673a8dc6e16a63b946f8bd0f3b939747d80ce86bbc19e100da84a4a7b38aa942de39d86cdc509e348d71d817bc7a6def433

data/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## [0.14.2] — 2026-09-15
+
+### Added
+
+- **`yamine skills install` — one command into your harness's local skills
+  directory.** With `ask-skills` / `ask-agent` the bundled yamine skill
+  at `lib/ask/skills/yamine/SKILL.md` is auto-discovered. Without them,
+  most harnesses (including ZCode) already discover
+  `~/.agents/skills/` — this command copies there so nobody has to find
+  the gem path by hand: `yamine skills install` (global default),
+  `yamine skills install --local` (per-project), `yamine skills
+  install --dir <path>` (anywhere), with `uninstall` symmetric. The gem
+  now auto-updates that copy: the installed skill is marked with
+  `.yamine-managed` and every `yamine <anything>` silently refreshes it
+  when the bundled version differs — hand-copied skills are never
+  touched.
+
 ## [0.14.1] — 2026-09-13
 
 ### Removed

data/lib/yamine/cli/skills.rb

@@ -0,0 +1,187 @@
+# frozen_string_literal: true
+
+require "fileutils"
+
+module Yamine
+  class CLI
+    # Manages the yamine SKILL.md copy in conventional skill directories.
+    #
+    # The bundled skill lives inside the gem at lib/ask/skills/yamine/SKILL.md.
+    # With ask-skills / ask-agent it is auto-discovered. Without them, users
+    # still need it where harnesses look — most commonly ~/.agents/skills/.
+    # This command handles that copy so nobody has to find the gem path by hand.
+    module SkillsCommand
+      module_function
+
+      SKILL_NAME = "yamine"
+      SOURCE_REL = "ask/skills/yamine/SKILL.md"
+
+      # Keeps installed copies in sync after `gem update yamine`. Called
+      # once per yamine invocation, silently, before the subcommand runs.
+      # Only touches copies that were created by `yamine skills install`
+      # (identified by the marker file next to SKILL.md) so a hand-copied
+      # or hand-edited skill is never overwritten. Failures are swallowed
+      # — a stale skill is better than a broken boot.
+      def auto_sync
+        candidates.each do |dest|
+          next unless File.file?(dest)
+          next unless managed?(dest)
+          sync_copy(dest)
+        end
+      rescue StandardError
+        nil
+      end
+
+      def run(_ctx, args)
+        sub = args.shift
+        if sub == "--help" || sub == "-h" || sub.nil?
+          return install(["--help"])
+        end
+        case sub
+        when "install" then install(args)
+        when "uninstall" then uninstall(args)
+        when nil
+          raise Error, "Usage: yamine skills install [--global] [--local] [--dir <path>] | " \
+            "yamine skills uninstall [--global] [--local] [--dir <path>]"
+        else
+          raise Error, "Unknown skills subcommand #{sub.inspect}. " \
+            "Try: yamine skills install --global"
+        end
+      end
+
+      def install(args)
+        opts, rest = take_flags(args)
+        unless rest.empty?
+          raise Error, "Unknown argument #{rest.first.inspect}. " \
+            "Try: yamine skills install --global"
+        end
+        dest = target_dirs(opts).first
+        source = bundled_skill_path
+        unless File.file?(source)
+          raise Error, "Bundled skill not found at #{source} — reinstall yamine"
+        end
+        FileUtils.mkdir_p(File.dirname(dest))
+        FileUtils.cp(source, dest)
+        stamp(dest)
+        puts "Installed yamine skill -> #{dest}"
+        if opts[:dir].nil? && !opts[:local]
+          collisions = other_skill_dirs(opts)
+          existing = collisions.select { |p| File.file?(p) }
+          unless existing.empty?
+            puts "Note: also found at #{existing.join(", ")} (yamine is already available there)"
+          end
+        end
+        0
+      end
+
+      def uninstall(args)
+        opts, rest = take_flags(args)
+        unless rest.empty?
+          raise Error, "Unknown argument #{rest.first.inspect}."
+        end
+        dest = target_dirs(opts).first
+        if File.file?(dest)
+          FileUtils.rm(dest)
+          FileUtils.rm_f(managed_marker(dest))
+          puts "Removed #{dest}"
+        else
+          puts "Not installed at #{dest} (nothing to do)"
+        end
+        0
+      end
+
+      def target_dirs(opts)
+        return [File.expand_path(File.join(opts[:dir], SKILL_NAME, "SKILL.md"))] if opts[:dir]
+
+        if opts[:local]
+          [File.join(Dir.pwd, ".agents", "skills", SKILL_NAME, "SKILL.md")]
+        else
+          [File.expand_path("~/.agents/skills/#{SKILL_NAME}/SKILL.md")]
+        end
+      end
+
+      def other_skill_dirs(opts)
+        [
+          File.join(Dir.pwd, ".agents", "skills", SKILL_NAME, "SKILL.md"),
+          File.expand_path("~/.agents/skills/#{SKILL_NAME}/SKILL.md"),
+          File.expand_path("~/.config/ask/skills/#{SKILL_NAME}/SKILL.md")
+        ].reject { |p| p == target_dirs(opts).first }
+      end
+
+      def bundled_skill_path
+        File.expand_path("../../ask/skills/yamine/SKILL.md", __dir__)
+      end
+
+      def managed_marker(dest)
+        File.join(File.dirname(dest), ".yamine-managed")
+      end
+
+      def managed?(dest)
+        File.file?(managed_marker(dest))
+      end
+
+      def stamp(dest)
+        File.write(managed_marker(dest), "managed by yamine skills install; safe to auto-update\n")
+      rescue StandardError
+        nil
+      end
+
+      def candidates
+        [
+          File.expand_path("~/.agents/skills/#{SKILL_NAME}/SKILL.md"),
+          File.join(Dir.pwd, ".agents", "skills", SKILL_NAME, "SKILL.md")
+        ]
+      end
+
+      def sync_copy(dest)
+        source = bundled_skill_path
+        FileUtils.cp(source, dest) if File.exist?(source) && File.read(source) != File.read(dest)
+        stamp(dest)
+      rescue StandardError
+        nil
+      end
+
+      def take_flags(args)
+        opts = {}
+        rest = []
+        i = 0
+        while i < args.length
+          arg = args[i]
+          case arg
+          when "--local"
+            opts[:local] = true
+            i += 1
+          when "--global"
+            i += 1
+          when "--dir"
+            opts[:dir] = args.fetch(i + 1) { raise Error, "--dir needs a path" }
+            i += 2
+          when "--help", "-h"
+            puts <<~HELP
+              yamine skills install   Install the yamine SKILL.md into your skills directories
+
+              Usage:
+                yamine skills install [--global]   -> ~/.agents/skills/yamine/SKILL.md (default)
+                yamine skills install --local      -> .agents/skills/yamine/SKILL.md
+                yamine skills install --dir <path> -> <path>/yamine/SKILL.md
+
+              The skill is already bundled at lib/ask/skills/yamine/SKILL.md inside the gem.
+              Most harnesses discover ~/.agents/skills/ automatically. Use --local for per-project.
+
+              Other subcommands:
+                yamine skills uninstall [--global|--local|--dir <path>]
+            HELP
+            exit 0
+          when /\A--/
+            raise Error, "Unknown flag #{arg} for yamine skills install. " \
+              "Try --global, --local, or --dir <path>."
+          else
+            rest << arg
+            i += 1
+          end
+        end
+        [opts, rest]
+      end
+    end
+  end
+end

data/lib/yamine/cli.rb

@@ -10,7 +10,7 @@ module Yamine
   # In non-interactive environments (no TTY or CI=1) we fail early with
   # a clear message instead of prompting (portless lesson).
   class CLI
-    SUBCOMMANDS = %w[get alias hosts list doctor trust clean prune proxy service sudoers kamal stop restart log status open setup start init db worktree].freeze
+    SUBCOMMANDS = %w[get alias hosts list doctor trust clean prune proxy service sudoers kamal stop restart log status open setup start init db worktree skills].freeze
 
     def self.run(argv)
       new.run(argv)
@@ -24,6 +24,7 @@ module Yamine
     end
 
     def run(argv)
+      SkillsCommand.auto_sync rescue nil
       args = argv.dup
       if args.empty?
         return BootCommand.run_inferred(Context.new, args)
@@ -60,6 +61,7 @@ module Yamine
       when "start" then SystemCommand.start(ctx, args)
       when "db" then SystemCommand.db(ctx, args)
       when "worktree" then WorktreeCommand.run(ctx, args)
+      when "skills" then SkillsCommand.run(ctx, args)
       when "kamal" then SystemCommand.kamal(ctx, args)
       when "stop"
         exit RoutesCommand.stop(ctx, args)
@@ -94,6 +96,7 @@ module Yamine
           yamine prune                  Remove stale routes
           yamine db list|create|drop      Per-worktree databases
           yamine worktree list|add|remove|clean   Worktrees: create, inspect, full cleanup
+          yamine skills install           Install yamine skill into ~/.agents/skills/ (or --local)
           yamine proxy start|stop       Control the proxy
           yamine service install|status|uninstall   OS startup service
           yamine sudoers                Print scoped passwordless-sudo rules for port 443

data/lib/yamine/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Yamine
-  VERSION = "0.14.1"
+  VERSION = "0.14.2"
 end

data/lib/yamine.rb

@@ -32,6 +32,7 @@ require_relative "yamine/cli/boot"
 require_relative "yamine/cli/routes"
 require_relative "yamine/cli/system"
 require_relative "yamine/cli/worktree"
+require_relative "yamine/cli/skills"
 require_relative "yamine/cli"
 
 # Stable named .localhost URLs for Ruby development.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: yamine
 version: !ruby/object:Gem::Version
-  version: 0.14.1
+  version: 0.14.2
 platform: ruby
 authors:
 - Kaka Ruto
@@ -88,6 +88,7 @@ files:
 - lib/yamine/cli/boot.rb
 - lib/yamine/cli/context.rb
 - lib/yamine/cli/routes.rb
+- lib/yamine/cli/skills.rb
 - lib/yamine/cli/system.rb
 - lib/yamine/cli/worktree.rb
 - lib/yamine/command.rb