yamine 0.14.1 → 0.14.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b5f2bd591be3e0b58deef894b8772575e46068fe4cc6287eaedf18926874f965
-  data.tar.gz: a1136bf238dc84bb2c150a00e02c385f19d3c9dd17ed94142091772712777768
+  metadata.gz: 8af42a840ce756689e6c37140a3a8cdf402c51aa71b9819b88df624d6a6ffaae
+  data.tar.gz: 0a51ab3de0e5605ea8b5152720f76957530722a1b65740dfebc0ab29d14337f9
 SHA512:
-  metadata.gz: 65139ff9a320e9fd827ef4ee1ea2b2f43d3ddb5d8aa14e31a642085a2e74cfa8f95ecdd03d3d1bd12af567a971d1f124c3b80cb5baa835d582cf5633169e73ca
-  data.tar.gz: 69b45bfe7fa0852be260ed74a1985a4f3052afa6aecd4bf821e29de721c71005082ad4b3ba078532df9ecf759f19a8ee9495f650734c296fc6e878b9356459ed
+  metadata.gz: e7823296acbadf8e6cc07079ff3f2d3ad56809d2de4973e6ed821124888cd2ee2144e267a754e585454fbc5c808c23fb9984e8da9880de4fda3b2b58bfcfff65
+  data.tar.gz: 2642187bbffd601efb5272f557577014704a4415b76c45eefbfa177d3e337b62074d5b60f36525c7a25b174684af7ccc5da31bbd8abaf59a9cdfa9fb864fae96

data/CHANGELOG.md

@@ -1,5 +1,38 @@
 # Changelog
 
+## [0.14.3] — 2026-09-15
+
+### Fixed
+
+- **WebSocket upgrades carry the same forwarded headers as every other
+  request.** Upgrade requests (ActionCable, Turbo Streams over cable)
+  were piped to the backend byte-for-byte, so `X-Forwarded-Proto`,
+  `X-Forwarded-For`, and `X-Forwarded-Host` never arrived — the one
+  request class that skipped `set_forwarded`. An app behind the proxy
+  then saw a `wss://` connection as plain `http`, and Rails' ActionCable
+  origin check (Origin vs. scheme + Host) compared
+  `https://app.localhost` against `http://app.localhost` and refused the
+  socket with "Request origin not allowed". Upgrades now run the same
+  `set_forwarded` path as every other request before the head is
+  forwarded; the bytes after the header block still pipe raw.
+
+## [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/proxy.rb

@@ -320,12 +320,18 @@ module Yamine
 
     def handle_upgrade(sock, head, buf)
       routes = cached_routes
-      _method, _target, headers = parse_head(head)
+      method, target, headers = parse_head(head)
       entry = route(headers["host"].to_s, routes)
       return unless entry
 
+      # Upgrades carry the same forwarded headers as every other request:
+      # an app behind the proxy (ActionCable's origin check) reads the
+      # scheme from X-Forwarded-Proto, and a verbatim head would tell a
+      # wss:// connection it arrived as http.
+      set_forwarded(headers, sock, tls: @tls)
+
       backend = dial(entry)
-      backend.write(head)
+      backend.write(rebuild_head(method, target, headers))
       backend.write(buf) unless buf.empty?
       pipe_both(sock, backend)
     rescue SystemCallError, OpenSSL::SSL::SSLError, IOError => e

data/lib/yamine/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Yamine
-  VERSION = "0.14.1"
+  VERSION = "0.14.3"
 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.3
 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