yamine 0.7.1 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 96bdebf9dc726c4caf747a07f2599bbde292a975e3395bd7cf43b1daf752bea3
-  data.tar.gz: 4abda73bc87a74f344070a3d69e87d470b788f05d04abfa4d6fb5783649fea20
+  metadata.gz: 04f00c2029bf4cda65d187225d251fc594bacf538092e6a56d9c5a03f9aa47fd
+  data.tar.gz: 963f1c74d64ddb94199d42325f6d8631a5dd2d618119554a4e1a72849394c5bc
 SHA512:
-  metadata.gz: 627bc6d9fcb038635d90ec9b49eb7a321fae414cb58ed584b02f4bcc7fbd8fd3a49fe98b610d7fb033564c416ab8ccdbed1b87c5ef6983ef7c70023eca351110
-  data.tar.gz: 19a0c6f70d82fddf4385c616e820d04d00a12d60be5016a13ce12054da5bf82aeb5fc7a47940d030518645eda95dac28a1957502d7df139715da65695681863f
+  metadata.gz: 2e02efba8d7c16767b0c4b8908d295f4c095f7c32f5ef90885e1ecf0a50aa68d61cb9e0c780d3729f703fcc14fc282eed46430d4efce631762dbb832ddecf408
+  data.tar.gz: 6d36c287b907fcfba07da2db3ecf1904ff4b396fb2bf8df277e0f9dfb23515e9245d574fb0bed85a034cd9f41fae14834842c722c3ac298e9f0fafedb1d30b45

data/CHANGELOG.md

@@ -1,5 +1,23 @@
 # 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

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/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.1"
+  VERSION = "0.8.0"
 end

metadata

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