yamine 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1003241d7826eb9d1b2c1f511a7e9b8e99f4be0d9438d2651dd86864d3cee1cc
-  data.tar.gz: 58ee2023a0f951f508c5032af8079d9417f97427bf76d48af08ec734661fd7a7
+  metadata.gz: 04f00c2029bf4cda65d187225d251fc594bacf538092e6a56d9c5a03f9aa47fd
+  data.tar.gz: 963f1c74d64ddb94199d42325f6d8631a5dd2d618119554a4e1a72849394c5bc
 SHA512:
-  metadata.gz: ea87625511591d754116bda3a16849466d9d982c7ba8f69a773508e36142e224e9c9a9ed96335c2f1d28c28f285116a488caa5c34d4ab7704cb06b4bb1d14a3f
-  data.tar.gz: 701589715a07e31778aefd39c60d05f7bdd9c865d77d72517f0a3881054046067ae60c2dc3ae97ecebe6f8b1dfd238ab95de5dd12d3a163bbd0f63aefaba9f3a
+  metadata.gz: 2e02efba8d7c16767b0c4b8908d295f4c095f7c32f5ef90885e1ecf0a50aa68d61cb9e0c780d3729f703fcc14fc282eed46430d4efce631762dbb832ddecf408
+  data.tar.gz: 6d36c287b907fcfba07da2db3ecf1904ff4b396fb2bf8df277e0f9dfb23515e9245d574fb0bed85a034cd9f41fae14834842c722c3ac298e9f0fafedb1d30b45

data/CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog
 
+## [0.8.0] — 2026-09-10
+
+### Fixed
+
+- **`--json` progress is flushed as it happens.** stdout is
+  block-buffered when it is a pipe — exactly how an agent reads the
+  stream — so the per-phase events added in 0.7.0 stayed in the buffer
+  until it filled or the process exited, making a slow boot look frozen.
+  That is the "poll and guess" behaviour the JSON stream exists to
+  replace. Every line is now flushed before the next phase runs.
+
+### Changed
+
+- The yamine agent skill documents the boot stream: the human
+  phase lines, the `--json` contract (one flushed object per line, human
+  banner on stderr, payload last), and that failures carry the log tail
+  and path.
+
+## [0.7.1] — 2026-09-10
+
+### Fixed
+
+- **`yamine start` now honors `YAMINE_PORT`.** `ensure_workstation!`
+  hardcoded port 443, so the documented escape hatch for CI and
+  sandboxes — "where 443 is impossible" — was ignored: with
+  `YAMINE_PORT=8443` on a non-interactive machine, `start` aborted with
+  "port 443 needs root to bind" and demanded sudo for a port the user
+  had deliberately chosen to avoid. The port and scheme now come from
+  the context, and an unprivileged port is started directly instead of
+  being treated as a setup failure. The root path is unchanged: 443 on a
+  non-interactive machine still points at `yamine setup`.
+
 ## [0.7.0] — 2026-09-10
 
 Keeping the no-port promise when the machine's recorded port goes stale,

data/lib/ask/skills/yamine/SKILL.md

@@ -46,6 +46,28 @@ yamine log [-f]           # tail the web process log
 stable URLs, background ones are supervised without routes. A process
 that exits cleans up the whole tree.
 
+The boot narrates every phase — deps, db, schema, and each process's
+healthcheck — one line per phase, so a slow boot is never a black box:
+
+```
+  [deps] ok (479ms) dependencies satisfied
+  [web] ok (2.2s) healthcheck /up returned 2xx-3xx
+```
+
+With `--json` the same events stream to stdout as one JSON object per
+line, flushed as they happen (safe to read incrementally), and the
+human banner moves to stderr — so stdout stays parseable and the final
+payload is the last line:
+
+```
+{"phase":"deps","action":"deps","status":"ok","duration_ms":479,...}
+{"phase":"process","action":"web","status":"ok","duration_ms":2223,...}
+{"ok":true,"service":"myapp","urls":{"web":"https://myapp.localhost"},...}
+```
+
+On failure the payload carries the failed phase, that process's log tail,
+and the log path — no need to go digging.
+
 ## Cross-service wiring
 
 ```bash

data/lib/yamine/cli/system.rb

@@ -700,9 +700,15 @@ module Yamine
 
 
       # Quiet workstation setup for `start`: trust the CA, ensure a proxy
-      # on 443 (root service, sudo daemon fallback), and sync hosts.
-      # Each step is idempotent; only missing pieces run. Non-interactive
-      # CI without a proxy fails fast rather than prompting for sudo.
+      # on this run's port (443 by default — root service, sudo daemon
+      # fallback), and sync hosts. Each step is idempotent; only missing
+      # pieces run. Non-interactive CI without a proxy fails fast rather
+      # than prompting for sudo.
+      #
+      # The port comes from ctx, not a literal: YAMINE_PORT is the
+      # documented escape hatch for CI and sandboxes ("where 443 is
+      # impossible"), and hardcoding 443 here demanded root for a port
+      # those users had already chosen to avoid.
       def ensure_workstation!(ctx)
         # 1. CA
         unless Yamine::Certs.trusted?(ctx.store.dir)
@@ -714,19 +720,30 @@ module Yamine
           end
         end
 
-        # 2. Proxy on 443
-        port = 443
-        tls = true
+        # 2. Proxy on the port this run wants
+        port = ctx.proxy_port
+        tls = ctx.proxy_tls
         unless Yamine::ProxyControl.listening?(port) && ProxyControl.ours?(port, tls: tls)
-          if port < 1024 && !Yamine::ProxyControl.root? && !ctx.interactive?
-            abort_setup("Proxy is not running and port 443 needs root to bind.", *privileged_port_hint)
+          privileged = port < 1024
+          if privileged && !Yamine::ProxyControl.root? && !ctx.interactive?
+            abort_setup("Proxy is not running and port #{port} needs root to bind.", *privileged_port_hint)
           end
           ok =
             if ProxyControl.root?
               Yamine::CLI::SystemCommand.ensure_root_service(ctx)
             elsif ctx.interactive?
               begin
-                Yamine::ProxyControl.spawn_daemon(store: ctx.store, port: port, tls: tls, sudo: true)
+                Yamine::ProxyControl.spawn_daemon(store: ctx.store, port: port, tls: tls, sudo: privileged)
+                wait_for_ours(ctx, port, tls: tls)
+              rescue Yamine::ProxyNotRunningError, SystemCallError => e
+                warn "    daemon start failed: #{e.message.lines.first&.strip}"
+                false
+              end
+            elsif !privileged
+              # Non-interactive but unprivileged: nothing to elevate, so
+              # start the daemon directly instead of failing.
+              begin
+                Yamine::ProxyControl.spawn_daemon(store: ctx.store, port: port, tls: tls, sudo: false)
                 wait_for_ours(ctx, port, tls: tls)
               rescue Yamine::ProxyNotRunningError, SystemCallError => e
                 warn "    daemon start failed: #{e.message.lines.first&.strip}"
@@ -736,7 +753,8 @@ module Yamine
               false
             end
           unless ok
-            abort_setup("Proxy is not running and could not be started on port 443.", *privileged_port_hint)
+            abort_setup("Proxy is not running and could not be started on port #{port}.",
+              *privileged_port_hint)
           end
         end
 

data/lib/yamine/log.rb

@@ -96,6 +96,12 @@ module Yamine
 
       # One JSON object per line — the agent contract. Same events, no
       # prose.
+      #
+      # Every line is flushed. stdout is block-buffered when it is a pipe
+      # or a file, which is exactly how an agent reads it, so without the
+      # flush the whole progress stream stays invisible until the buffer
+      # fills or the process exits — the "poll and guess" behaviour the
+      # JSON stream exists to replace, now with extra steps.
       class Json
         def initialize(io = $stdout)
           @io = io
@@ -103,12 +109,18 @@ module Yamine
 
         def event(event)
           require "json"
-          @io.puts JSON.generate(event.to_h)
+          emit(event.to_h)
         end
 
         def note(message)
-          require "json"
-          @io.puts JSON.generate({ note: message })
+          emit({ note: message })
+        end
+
+        private
+
+        def emit(payload)
+          @io.puts JSON.generate(payload)
+          @io.flush if @io.respond_to?(:flush)
         end
       end
     end

data/lib/yamine/version.rb

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

metadata

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