yamine 0.14.0 → 0.14.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ab7c7e888dc8066ad10a7ed2fa90dcd684b27aa171038ac0ae5ea4c06b22251b
-  data.tar.gz: '097d12693a71cf3969f481fd0f61b3f82e9a09d7958139e32b3fb79a7e667cd8'
+  metadata.gz: b5f2bd591be3e0b58deef894b8772575e46068fe4cc6287eaedf18926874f965
+  data.tar.gz: a1136bf238dc84bb2c150a00e02c385f19d3c9dd17ed94142091772712777768
 SHA512:
-  metadata.gz: 99ddf961f8fa7e50038cb093b592f692c4c90a94279dc200b9ab7ea9e8a70355e6bf67659bf0cb53aac66d2868d99c6fc138750e490aa1fa4ff5b606bbfacc3f
-  data.tar.gz: 825fb69b730125767e18472ca3d7d615514660b63dbcb7aa63697970f6733b1497997b505a6fde9f1e6b0c62785127fac0d2b1332544ff4d535b4076680623b8
+  metadata.gz: 65139ff9a320e9fd827ef4ee1ea2b2f43d3ddb5d8aa14e31a642085a2e74cfa8f95ecdd03d3d1bd12af567a971d1f124c3b80cb5baa835d582cf5633169e73ca
+  data.tar.gz: 69b45bfe7fa0852be260ed74a1985a4f3052afa6aecd4bf821e29de721c71005082ad4b3ba078532df9ecf759f19a8ee9495f650734c296fc6e878b9356459ed

data/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [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.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].freeze
 
     def self.run(argv)
       new.run(argv)
@@ -44,7 +44,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)
@@ -81,11 +80,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)
@@ -106,8 +103,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.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: yamine
 version: !ruby/object:Gem::Version
-  version: 0.14.0
+  version: 0.14.1
 platform: ruby
 authors:
 - Kaka Ruto