yamine 0.14.0 → 0.14.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ab7c7e888dc8066ad10a7ed2fa90dcd684b27aa171038ac0ae5ea4c06b22251b
-  data.tar.gz: '097d12693a71cf3969f481fd0f61b3f82e9a09d7958139e32b3fb79a7e667cd8'
+  metadata.gz: 56dbba9d974dc247a9f96271e6dd40e0e68b170a6ad20f9e0660aa6fa1d20a28
+  data.tar.gz: 218da1110324af22c665581eeb26101a29628f1f4e96fed47e492aebd6c18488
 SHA512:
-  metadata.gz: 99ddf961f8fa7e50038cb093b592f692c4c90a94279dc200b9ab7ea9e8a70355e6bf67659bf0cb53aac66d2868d99c6fc138750e490aa1fa4ff5b606bbfacc3f
-  data.tar.gz: 825fb69b730125767e18472ca3d7d615514660b63dbcb7aa63697970f6733b1497997b505a6fde9f1e6b0c62785127fac0d2b1332544ff4d535b4076680623b8
+  metadata.gz: 9e26fe517122747c2793eb2b441fe83289898796d47c99330d2589413873fa7a12ae1cc2a8b1da69928b39bc6f8ed01aa6e7647f682a872c80886d04d1a862be
+  data.tar.gz: ce6b77f5a0263594e698cae37ddd3673a8dc6e16a63b946f8bd0f3b939747d80ce86bbc19e100da84a4a7b38aa942de39d86cdc509e348d71d817bc7a6def433

data/CHANGELOG.md

@@ -1,5 +1,37 @@
 # 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
+
+- **`yamine run` has been removed.** `run` was an alias of `start` since
+  the config-first rewrite but kept its old help text, and the
+  compound-line error advice still pointed at `yamine run -- <cmd>` —
+  a command that silently ignores its argument. The subcommand now
+  prints the migration message every other removed command uses ("all
+  processes come from config/local.yml"), and the advice rewrites to
+  what is actually true: split the command into its own process in
+  config, or wrap it in a script. One-off routed commands (Docker,
+  ad-hoc ports) go through `yamine alias`, which gives them a hostname
+  without yamine owning the process lifecycle.
+
 ## [0.14.0] — 2026-09-13
 
 ### Added

data/README.md

@@ -134,8 +134,8 @@ case) need `yamine hosts sync`.
 
 | Axis | Example | Source |
 |---|---|---|
-| app | `myapp` | inferred, `--name`, `yamine.json`, `YAMINE_NAME` |
-| service | `api.myapp` | `--service`, `YAMINE_SERVICE` (`web` stays bare) |
+| app | `myapp` | `service:` in `config/local.yml` (`yamine init` infers it) |
+| service | `api.myapp` | a non-web process name (every `proxy: true` process but `web`) |
 | variant | `fix-ui.myapp` | `--variant`, `YAMINE_VARIANT`, linked worktree branch |
 | tld | `myapp.preview.example.com` | `--tld` (default `localhost`) |
 
@@ -186,7 +186,6 @@ worktrees (the branch stays); `--dry-run` prints the plan; `remove
 
 ```bash
 yamine                                          # -> https://myapp.localhost
-yamine --service api                            # -> https://api.myapp.localhost
 yamine --variant demo                           # -> https://demo.myapp.localhost
 yamine --tld preview.example.com                # your own domain (OAuth parity)
 ```
@@ -217,7 +216,6 @@ to start it. `yamine status` reports which mode an app is in.
 yamine                        # boot app (waits until healthy, then supervises)
 yamine start --no-wait        # fire-and-forget (register routes immediately)
 yamine start --json           # machine-readable wait result (--wait default)
-yamine run -- <cmd>           # run explicit command through proxy
 yamine get <name>             # print URL for cross-service wiring
 yamine alias <name> <port>    # static route (e.g. Docker)
 yamine list [--json]          # show active routes (+ backend liveness)
@@ -244,18 +242,13 @@ OAuth callbacks, mailer hosts, webhook URLs), `PORT`, and `HOST`.
 ## Frameworks
 
 Rails and bare Rack (`config.ru`) boot managed on a unix socket (Puma
-when available; `rackup` on TCP otherwise). `Procfile.dev`/`bin/dev`,
-Jekyll, Bridgetown, and Middleman run in run mode with `PORT` injected
-(port-ignoring CLIs get explicit `--port/--host` flags). Anything else:
-`yamine run -- <cmd>`.
+when available; `rackup` on TCP otherwise). Port-ignoring CLIs —
+Jekyll, Bridgetown, Middleman — get explicit `--port/--host` flags
+injected at boot; everything else comes from `processes:` in
+`config/local.yml`, one process per entry.
 
-```bash
-yamine --proc web             # boot a specific Procfile process
-yamine --proc worker          # (first line is the default)
-```
-
-Procfile lines that are compound (`&&`, `||`, `|`, `;`) are refused with
-guidance rather than silently mis-injected.
+Process commands that are compound (`&&`, `||`, `|`, `;`) are refused
+with guidance rather than silently mis-injected.
 
 For Rails integration (hosts, Action Cable origins, Procfile rewrite,
 generators) — deprecated; core covers Rails now.

data/lib/yamine/cli/boot.rb

@@ -42,10 +42,6 @@ module Yamine
         opts[:json] ? $stderr.puts(message) : puts(message)
       end
 
-      def run_explicit(ctx, args)
-        run_inferred(ctx, args)
-      end
-
       def run_named(ctx, name, _args)
         if name.to_s.start_with?("-")
           $stderr.puts "Error: unknown flag `#{name}`. Try `yamine --help` or `yamine start --help`."
@@ -217,7 +213,7 @@ module Yamine
           url = Hostname.url(hostname, port: ctx.proxy_port, tls: ctx.proxy_tls)
           cmd = entry["cmd"].to_s
           if cmd.match?(Yamine::Procfile::COMPOUND)
-            $stderr.puts "  [#{proc_name}] ERROR: compound line (&&, ||, |, ;) — run explicitly: yamine run -- #{cmd}"
+            $stderr.puts "  [#{proc_name}] ERROR: compound line (&&, ||, |, ;) — split it into separate processes, or wrap in a script and point cmd: at it"
             next
           end
           port = opts[:app_port] || Ports.find_free
@@ -356,7 +352,7 @@ module Yamine
       def boot_background(ctx, runner, resolved, proc_name, entry, opts, children, db_url)
         cmd = entry["cmd"].to_s
         if cmd.match?(Yamine::Procfile::COMPOUND)
-          $stderr.puts "  [#{proc_name}] ERROR: compound line (&&, ||, |, ;) — run explicitly: yamine run -- #{cmd}"
+          $stderr.puts "  [#{proc_name}] ERROR: compound line (&&, ||, |, ;) — split it into separate processes, or wrap in a script and point cmd: at it"
           return
         end
         port = opts[:app_port] || Ports.find_free

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[run 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)
@@ -44,7 +45,6 @@ module Yamine
       cmd = args.shift
       ctx = Context.new
       case cmd
-      when "run" then BootCommand.run_explicit(ctx, args)
       when "get" then RoutesCommand.get(ctx, args)
       when "alias" then RoutesCommand.alias_add(ctx, args)
       when "hosts" then SystemCommand.hosts(ctx, args)
@@ -61,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)
@@ -81,11 +82,9 @@ module Yamine
         yamine - Stable named .localhost URLs for Ruby development.
 
         Usage:
-          yamine start [name] [cmd...]  One-setup-and-go: setup if needed, then boot -> https://<app>.localhost
+          yamine start                 One-setup-and-go: setup if needed, then boot -> https://<app>.localhost
           yamine setup                One-shot workstation setup without booting (run once)
-          yamine                        Bare form of `start` -> https://<app>.localhost
-          yamine run [cmd]              Same, with explicit command
-          yamine <name> <cmd>           Run with explicit name
+          yamine                        Bare form of `start` — boots every process in config/local.yml
           yamine get <name>             Print URL for a service
           yamine alias <name> <port>    Static route (e.g. Docker)
           yamine list                   Show active routes (+ backend liveness)
@@ -97,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
@@ -106,8 +106,8 @@ module Yamine
           yamine restart                Touch tmp/restart.txt
           yamine log [-f] [n]           Tail (or follow) this app's backend log
 
-        Flags: --variant, --tld, --force, --app-port, --wait (default), --no-wait, --json
-        Env: YAMINE_NAME/SERVICE/VARIANT/TLD/PORT/STATE_DIR, YAMINE_BRANCH=1
+        Flags: --variant, --tld, --force, --app-port, --wait (default), --no-wait, --json, --branch
+        Env: YAMINE_VARIANT/TLD/PORT/STATE_DIR/AGENT, YAMINE_BRANCH=1
       HELP
     end
 

data/lib/yamine/version.rb

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