ez_logs_agent 0.1.5 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b2d2badd73cb46e12e78d54928f6b2cec5f4a39a93f22f6ecbef5b4767ed200a
-  data.tar.gz: c654639d447550d6c2e59a99c072a60126b8502cf749a5be65988f6bc80649ae
+  metadata.gz: e1155fac143bb0af7e99c95a8dde26764f1c3f2bfab758beec239adef8bfab06
+  data.tar.gz: d87b5b4cc03d73117e0b1759b26c149a73e8bd2c1aa670a8b79f5c0b4a0fe7de
 SHA512:
-  metadata.gz: 703b6dba6216a3f34db5ce0038fda0e19e0a2cd0aa6de07cea95bcb974bdb3856488dc92601376ac7070d18920032b8e8ea941c998d2dc7835e903fa14d72c94
-  data.tar.gz: 4c44195f6539f48933c7949b936f988738657d44728dc6406cf43b270958b05a107f5cec5ac6b8de3b7265c5ff2dbbf07fe276c99dea1f1f1662a1f61eabd05a
+  metadata.gz: 2b91f112497b1443ffe044215819e0fb9a26748026bd43859ed2b239eacb53920cb6ae27c455f34693b46e56cc62ff1775a6177b1e76805f603f2402737a5cf3
+  data.tar.gz: dd0ae94996e329e795da19f2017a165cbf3e81e81aa8ee493e1a1d086abc02dd1f01bd61ac12fc5c8d08192863877bd83420903e113ada489788465e7f4fcac8

data/CHANGELOG.md

@@ -2,6 +2,30 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.1.7] — 2026-05-28
+
+### Changed
+- Gem `homepage` now points at the product site (`https://ezlogs.io/`)
+  instead of the GitHub mirror, so the RubyGems "Homepage" link sends
+  installers to the product. `source_code_uri` still points at the
+  mirror. Metadata-only release; no code or wire change.
+
+## [0.1.6] — 2026-05-24
+
+### Added
+- Optional `actor.principal` sub-field (`{ id:, label? }`) on the wire,
+  carrying the human a `kind: "agent"` or `kind: "hybrid"` actor is
+  acting on behalf of. Drops silently if malformed; existing callers
+  unaffected. Lets the server narrate agent actions as
+  "Claude updated employee, on behalf of Razvan" instead of
+  attributing the change to either party alone.
+
+### Internal
+- Dropped a stray gemspec bump to `sidekiq ~> 8.1` that landed via an
+  auto-merged dependabot PR without re-resolving `Gemfile.lock`. Dev
+  deps are back in sync with the lockfile (`rails ~> 7.0`,
+  `sqlite3 ~> 1.6`, `sidekiq ~> 7.0`); no runtime change for customers.
+
 ## [0.1.5] — 2026-05-17 — security release
 
 ### Security

data/README.md

@@ -1,10 +1,12 @@
 # EZLogs Agent
 
+[Website](https://ezlogs.io/) · [Documentation](https://ezlogs.io/rails/) · [Next.js sister agent](https://github.com/dezsirazvan/ez_logs_agent_nextjs)
+
 **Drop-in activity logging for Rails applications.**
 
 EZLogs Agent captures what happens in your Rails app — HTTP requests, background jobs, database changes — and sends them to the EZLogs server, where they're transformed into human-readable stories that anyone on your team can understand.
 
-Wire-format identical to the [Next.js sister agent](https://github.com/dezsirazvan/ez_logs/tree/master/ez_logs_agent_nextjs) (`@ezlogs/nextjs`). Same server ingests both. Use Rails on the back end and Next.js on the front end? You see one unified Action timeline.
+Wire-format identical to the [Next.js sister agent](https://github.com/dezsirazvan/ez_logs_agent_nextjs) (`ezlogs-nextjs` on npm). Same server ingests both. Use Rails on the back end and Next.js on the front end? You see one unified Action timeline.
 
 ---
 

data/lib/ez_logs_agent/actor_validator.rb

@@ -5,9 +5,15 @@ module EzLogsAgent
   #
   # Actor schema:
   # {
-  #   id: String,               # REQUIRED, stable identifier
-  #   label: String | nil,      # optional, human-readable display
-  #   kind: String | nil        # optional, one of human|agent|system|hybrid
+  #   id: String,                       # REQUIRED, stable identifier
+  #   label: String | nil,              # optional, human-readable display
+  #   kind: String | nil,               # optional, one of human|agent|system|hybrid
+  #   principal: { id:, label? } | nil  # optional, only meaningful when
+  #                                     # kind == "hybrid": the human who
+  #                                     # authorized the agent. Drives the
+  #                                     # "Claude updated employee, on
+  #                                     # behalf of Razvan" framing on the
+  #                                     # server's AiExplainer.
   # }
   #
   # This module ensures actors conform to the expected structure
@@ -46,13 +52,36 @@ module EzLogsAgent
         id = actor[:id] || actor["id"]
         label = actor[:label] || actor["label"]
         kind = actor[:kind] || actor["kind"]
+        principal = actor[:principal] || actor["principal"]
 
         result = { id: id.to_s }
         result[:label] = label.to_s if label
         result[:kind] = kind.to_s if kind && VALID_KINDS.include?(kind.to_s)
+        sanitized_principal = sanitize_principal(principal)
+        result[:principal] = sanitized_principal if sanitized_principal
 
         result
       end
+
+      private
+
+      # Sanitize the optional principal sub-structure. Reuses the same
+      # "id required, label optional" shape as the top-level actor — but
+      # principals are always human, so no `kind` field. Returns nil if
+      # the principal is missing or malformed (we drop silently rather
+      # than rejecting the whole actor; principal is purely advisory).
+      def sanitize_principal(principal)
+        return nil if principal.nil?
+        return nil unless principal.is_a?(Hash)
+
+        id = principal[:id] || principal["id"]
+        return nil if id.nil? || id.to_s.empty?
+
+        result = { id: id.to_s }
+        label = principal[:label] || principal["label"]
+        result[:label] = label.to_s if label
+        result
+      end
     end
   end
 end

data/lib/ez_logs_agent/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module EzLogsAgent
-  VERSION = "0.1.5"
+  VERSION = "0.1.7"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ez_logs_agent
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 0.1.7
 platform: ruby
 authors:
 - dezsirazvan
 bindir: bin
 cert_chain: []
-date: 2026-05-17 00:00:00.000000000 Z
+date: 2026-05-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: request_store
@@ -143,11 +143,11 @@ files:
 - lib/generators/ez_logs_agent/install/install_generator.rb
 - lib/generators/ez_logs_agent/install/templates/ez_logs_agent.rb.tt
 - lib/tasks/ez_logs_agent.rake
-homepage: https://github.com/dezsirazvan/ez_logs_agent
+homepage: https://ezlogs.io/
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/dezsirazvan/ez_logs_agent
+  homepage_uri: https://ezlogs.io/
   source_code_uri: https://github.com/dezsirazvan/ez_logs_agent
   changelog_uri: https://github.com/dezsirazvan/ez_logs_agent/blob/master/CHANGELOG.md
   bug_tracker_uri: https://github.com/dezsirazvan/ez_logs_agent/issues