everlights 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5470906a45eb2946bbf14cdba11dc89917ad92244e2b224f655513ff944ee66a
-  data.tar.gz: 1c6f03b3cfa021d8c16692fb555d39a15416c54a82cda3058fe15faae585049b
+  metadata.gz: ee4915d68adebdaaaa5d1ea02be82d7530ebbdee06fbfd2905b73aa49fa9cf6e
+  data.tar.gz: f6ed7abeccd0e26b23795679e3cf8dcf876b73163cd684d9ffe109ceadc8a085
 SHA512:
-  metadata.gz: ef7f03a9d96aa9fbf041cc566bc4e14c7960a9c070630a5633353f55a4acb111aad1092e17abe928673f4225a21c50b75eb0a5195113f30f8d39291b1cbc58c4
-  data.tar.gz: 815c442cc1d22a33676bec89a25578b70463c10be529ce77e3699c1c355db5b11a567f2ebca9b76a092bae68b65fbd5b23deee80bfa25b087cdb7f79706209ee
+  metadata.gz: 011d597b5b53676084adad56466ddb9dde0fa77f8e6c6a37264078495a10959e3350a90e0d365afbcf24c4c0a3a0188b0dd3476808a1fc10bf9f63761de0daee
+  data.tar.gz: d99fd9e1c63b2d3e70edd0e0a0ce3cc072a677f4a3c4734b65d90bcdeb45662f2f5e1f42f49eea37a9b5fbdbd6b4d59060492a1478aca51dedb7a165cdd6050a

data/README.md

@@ -26,6 +26,7 @@ Requires Ruby 3.1+.
 
 ```sh
 everlights bridge                                  # firmware, network, cloud, zone health
+everlights bridge health                           # ok/WARN checks; exits 2 on any warning
 everlights show                                    # what's playing, e.g. "Halloween Fade (Halloween show)"
 
 everlights play "Hallows Eve"                      # a saved sequence, now
@@ -89,6 +90,8 @@ schedule:                           # higher in the list wins a shared night
 To keep the calendar topped up, run it on a schedule, for example monthly from cron:
 `0 9 1 * * cd ~/everlights && everlights sync >> config/sync.log 2>&1`
 
+To only be told when it needs a sync, use `everlights sync --check`. It prints the plan and changes nothing. It exits 0 when the bridge matches the config, 2 when it needs a sync, and 1 on an error.
+
 ## Ruby
 
 ```ruby
@@ -161,7 +164,9 @@ Observed on the bridge (`ruby -Ilib test/live_check.rb` repeats the round trip):
 ruby -Ilib -e 'Dir["test/*_test.rb"].each { require "./#{_1}" }'
 ```
 
-The tests run against a fake bridge, so no hardware is needed.
+The tests run against a fake bridge, so no hardware is needed. CI runs them on every push and pull request.
+
+To release, bump the version in `everlights.gemspec`, commit, then tag and push (`git tag v0.2.0 && git push origin v0.2.0`). The release workflow tests, then publishes to RubyGems and GitHub Packages and creates a GitHub release with the `.gem` attached.
 
 ## Credits
 

data/exe/everlights

@@ -7,6 +7,7 @@ USAGE = <<~TXT
 
   Bridge:
     bridge                                firmware, network, cloud, zone health
+    bridge health                         ok/WARN per check; exit 2 on any warning (for cron)
     bridge time [TIME]                    set the bridge clock (default now)
     bridge reboot --yes                   restart the bridge
     zones                                 raw zone data (JSON)
@@ -32,6 +33,7 @@ USAGE = <<~TXT
 
   Sync (config/everlights.yml: sequences + schedule, see config/everlights.example.yml):
     sync [--dry-run] [--adopt]            build sequences and the calendar ahead; prints the plan
+    sync --check                          plan only; exit 2 if the bridge needs a sync (for cron)
 
   Options:
 TXT
@@ -53,6 +55,7 @@ parser = OptionParser.new do |o|
   o.on("--json", "JSON output for lists, show and bridge") { opts[:json] = true }
   o.on("--yes", "confirm bridge reboot") { opts[:yes] = true }
   o.on("--dry-run", "sync: print the plan only") { opts[:dry_run] = true }
+  o.on("--check", "sync: plan only, exit 2 if anything would change") { opts[:check] = true }
   o.on("--adopt", "sync: take over bridge items whose names match the config") { opts[:adopt] = true }
 end
 parser.parse!
@@ -70,7 +73,7 @@ begin
   zones = opts[:zones]
   cmd = ARGV.shift
   cmd = "#{cmd} #{ARGV.shift}" if %w[sequence calendar].include?(cmd) ||
-                                   (cmd == "bridge" && %w[time reboot].include?(ARGV.first))
+                                   (cmd == "bridge" && %w[health time reboot].include?(ARGV.first))
   arg = ARGV.join(" ")
 
   case cmd
@@ -91,6 +94,25 @@ begin
         puts "  last     request #{at.(z["lastRequestDate"])}, response #{at.(z["lastResponseDate"])}, reboots #{z["rebootCount"]}"
       end
     end
+  when "bridge health"
+    # ponytail: thresholds are guesses from one bridge; tune when real failures show what matters
+    b = el.status
+    ago = ->(v) { v ? ((Time.now - Time.parse(v)) / 60).round : Float::INFINITY }
+    mins = ->(m) { m.infinite? ? "never" : "#{m} min ago" }
+    cloud, radio = ago.(b["lastServerCheckin"]), ago.(b["lastRadioResponse"])
+    checks = [
+      [!!b["serverReachable"] && cloud <= 15, "cloud", "#{b["serverReachable"] ? "reachable" : "unreachable"}, checked in #{mins.(cloud)}"],
+      [!!b.dig("network", "ntp"), "clock", "ntp #{b.dig("network", "ntp") ? "on" : "off"}"],
+      [b["minFreeHeap"].to_i >= 10_000, "memory", "lowest free since boot #{b["minFreeHeap"]} bytes (warn under 10000)"],
+      [radio <= 10, "radio", "answered #{mins.(radio)}, #{b["radioRebootCount"]} radio reboots"],
+      *b["zones"].map do |z|
+        last = ago.(z["lastResponseDate"])
+        [!!z["active"] && last <= 10, "zone #{z["serial"]}", "#{z["active"] ? "active" : "inactive"}, answered #{mins.(last)}, #{z["rebootCount"]} reboots"]
+      end,
+      [:info, "reboots", "#{b["rebootCount"]} total, last reset reason #{b["resetReason"]}"]
+    ]
+    checks.each { |ok, name, text| puts "#{{info: "info", true => "ok  ", false => "WARN"}[ok]}  #{name.ljust(19)} #{text}" }
+    exit 2 unless checks.all? { _1[0] }
   when "bridge time"
     time = ARGV.empty? ? Time.now : Time.parse(arg)
     el.set_time(time)
@@ -179,6 +201,7 @@ begin
     plan = Everlights::Sync.new(el, config, state_path: state_path, adopt: opts[:adopt]).plan
     puts plan
     if plan.empty? then nil
+    elsif opts[:check] then exit 2
     elsif opts[:dry_run] then puts "\n(dry run: nothing applied)"
     else
       plan.apply!

data/lib/everlights/sync.rb

@@ -33,21 +33,31 @@ module Everlights
           rows.each { |a| out << "  #{mark[a.op]} #{a.op.to_s.ljust(7)} #{a.name}#{": #{a.detail}" if a.detail}" }
         end
         lost, other = skips.partition { |_, _, why| why.end_with?(" wins this night") }
+        dark, other = other.partition { |_, _, why| why.start_with?("dusk (") }
         unless other.empty?
           out << "Skipped"
           other.each { |d, rule, why| out << "    #{d.strftime("%a %Y-%m-%d")}  #{rule}: #{why}" }
         end
+        unless dark.empty?
+          out << "No show: dusk is after the end time"
+          dark.group_by { _2 }.each do |rule, rows|
+            out << "    #{rule}: #{nights(rows.map(&:first))} (dusk up to #{rows.map { _3[/\d\d:\d\d/] }.max}, ends #{rows[0][2][/(\d\d:\d\d) end/, 1]})"
+          end
+        end
         unless lost.empty?
           out << "Nights taken by a higher rule"
           lost.group_by { |_, rule, why| [rule, why.delete_suffix(" wins this night")] }.each do |(rule, winner), rows|
-            days = rows.map(&:first)
-            span = days.size == 1 ? days[0].strftime("%b %-d") : "#{days[0].strftime("%b %-d")} – #{days[-1].strftime("%b %-d")}"
-            out << "    #{rule}: #{days.size} night#{"s" unless days.size == 1} to #{winner} (#{span})"
+            out << "    #{rule}: #{nights(rows.map(&:first)).sub(", ", " to #{winner} (")})"
           end
         end
         out << "Nothing to change." if empty?
         out.join("\n")
       end
+
+      def nights(days) # "3 nights, Jun 26 – Jun 28"
+        span = days.size == 1 ? days[0].strftime("%b %-d") : "#{days[0].strftime("%b %-d")} – #{days[-1].strftime("%b %-d")}"
+        "#{days.size} night#{"s" unless days.size == 1}, #{span}"
+      end
     end
 
     def self.load_config(path)
@@ -128,7 +138,7 @@ module Everlights
         losers.each { skips << [d, _1[:name], "#{winner[:name]} wins this night"] }
         s, e = window(winner, d)
         if e.nil?
-          skips << [d, winner[:name], "dusk (#{s.strftime("%H:%M")}) is after its end time"]
+          skips << [d, winner[:name], "dusk (#{s.strftime("%H:%M")}) is after its #{format("%02d:%02d", *winner[:end])} end"]
         elsif s <= @now + MARGIN
           skips << [d, winner[:name], "already started or starts within 15 minutes"]
         elsif (other = others.find { |_, os, oe| os < e && s < oe })

data/skills/everlights/SKILL.md

@@ -9,7 +9,7 @@ The `everlights` CLI talks to the bridge on the LAN (no auth). It needs `EVERLIG
 
 ## Before you write anything
 
-1. Run `everlights calendar list` and `everlights show` (names what's playing and which show it's from) first (`everlights bridge` if something seems broken). Report what's already scheduled or showing.
+1. Run `everlights calendar list` and `everlights show` (names what's playing and which show it's from) first (`everlights bridge health` if something seems broken; it marks problems WARN). Report what's already scheduled or showing.
 2. Confirm before every write: `set`, `play`, `off`, `clear`, `sequence add/update/remove`, `calendar add/remove` and `bridge time`. These change real lights on a real house, so state the exact command you'll run.
 3. Only run `bridge reboot --yes` when the user explicitly asks; it interrupts the lights. The CLI refuses to remove built-in sequences, or sequences an event still uses.
 
@@ -59,7 +59,7 @@ el.calendar.remove "2026-12-24", "Christmas"
 When the user wants a recurring or seasonal plan ("Christmas every December", "Fridays in football season"), edit `config/everlights.yml` rather than adding calendar entries one by one. The format reference is `config/everlights.example.yml`.
 
 1. Edit `sequences:` or `schedule:`. Rules higher in the list win nights they share.
-2. Run `everlights sync --dry-run` and show the user the plan, including the Skipped section.
+2. Run `everlights sync --dry-run` and show the user the plan, including the Skipped and No show sections. `everlights sync --check` is the same plan, but exits 2 when anything would change.
 3. Run `everlights sync` only after they confirm.
 
 Sync only changes what it created itself. Config problems abort before anything is written; fix every one it lists. Use `--adopt` only when the user says the state file was lost.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: everlights
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Ricky Chilcott
@@ -31,6 +31,7 @@ metadata:
   source_code_uri: https://github.com/rickychilcott/everlights
   bug_tracker_uri: https://github.com/rickychilcott/everlights/issues
   rubygems_mfa_required: 'true'
+  github_repo: ssh://github.com/rickychilcott/everlights
 rdoc_options: []
 require_paths:
 - lib
@@ -45,7 +46,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.1
+rubygems_version: 4.0.20
 specification_version: 4
 summary: Client and CLI for the EverLights Smart Lights Bridge local API
 test_files: []