holivia 0.13.0 → 0.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5727339aa56fea9ffe71d4f5e0c49fdcd91a2d120aa3f88f7ff33f6a7b6eb49a
-  data.tar.gz: 6860e618178ca2b72dd346ec6f02b900cb1aaf48299db21bd6b2e98b6944ad9e
+  metadata.gz: fab1251135002a03f719e93cb2f2d1fcb52842e2f5c5fecc3fa8c47c279b8747
+  data.tar.gz: 8e2dd66d735bf875c123d42d90c25ab7d853024c5378dc8445d2f8c4eeb233aa
 SHA512:
-  metadata.gz: 573b090f0d92ee3676f920992e1c60f71b17b423627a000a4f4d118a1f394657670ce40c19d378f29bf4f56b2f54b682716d66ee70b80db1c7ccf1b088742d37
-  data.tar.gz: 26a6014d2c1351a3c2887c406ea572e7c5b73874077533c96c667ef8f11329e3a749954ae2ba141356066d51eff1ec970e758faa236d96687218db48f794d7da
+  metadata.gz: a0c502ac53052598fff122e0b5bafc5028c7cd2dee25ebc6629879f0a77d17516314608012493d41ee8571cb79802d5a276c43e64d03236f2e86d8e7a4c68e77
+  data.tar.gz: 5454072e3f4e4d046b1a8de6e60a9a9641db2a5d16eaf85441de7340e065572f4606c83a603bc4f615ef0c86b02f4a03babf28fa267559375c9fa0602fac3c56

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 ## [Unreleased]
 
+## [0.14.0] - 2026-10-23
+
+- Add `holivia enterprise show <id>` for enterprise details: settings, headquarter, CSM, countries, employees count, and the current contract summary for contract viewers and managers
+- Add `holivia enterprise employee-stats <id>` for aggregate employee counts (total, left, current, current dependents and HR managers), excluding demo employees
+- Add read-only `holivia employee index` and `holivia employee show` commands with enterprise, query, left, HR manager, dependent status, demo, and pagination filters; demo employees are excluded unless `--demo` is given
+- Add read-only `holivia contract index` and `holivia contract show` commands with enterprise, status (`active`, `expiring_soon`, `low_remaining`), and pagination filters
+- Employee responses never include Holivia account data (user id, sign-up, or care status); SKILL.md treats employee data as personal data
+- Employee commands require an employee viewer or manager role; contract commands require a contract viewer or manager role
+- Requires the matching Holivia backoffice API deployment
+
 ## [0.13.0] - 2026-09-30
 
 - Replace terminal password login with browser OAuth authorization using PKCE and existing password/company SSO sign-in.

data/README.md

@@ -2,7 +2,7 @@
 
 Ruby client and command-line interface for the Holivia API.
 
-The `holivia` executable is primarily used to manage Holivia backoffice data from the terminal: environments, authentication, selfcare content, objectives, enterprises, communication library items, HR intervention catalog items, HR home highlights, crises, collective interventions, and appointment diagnostics.
+The `holivia` executable is primarily used to manage Holivia backoffice data from the terminal: environments, authentication, selfcare content, objectives, enterprises, employees, contracts, communication library items, HR intervention catalog items, HR home highlights, crises, collective interventions, and appointment diagnostics.
 
 Coding agents can use [`SKILL.md`](SKILL.md) as a downloadable usage guide for operating this CLI safely.
 
@@ -186,6 +186,32 @@ Find an enterprise id:
 holivia enterprise lookup --query acme
 ```
 
+Show details for an enterprise:
+
+```bash
+holivia enterprise show 123
+```
+
+Show employee counts for an enterprise:
+
+```bash
+holivia enterprise employee-stats 123
+```
+
+List and inspect employees of an enterprise:
+
+```bash
+holivia employee index --enterprise-id 123 --query durand --left false
+holivia employee show 42
+```
+
+List and inspect contracts of an enterprise:
+
+```bash
+holivia contract index --enterprise-id 123 --status active
+holivia contract show 7
+```
+
 List crises for an enterprise:
 
 ```bash

data/SKILL.md

@@ -2,7 +2,7 @@
 
 Use this skill when you need to operate the Holivia API through the `holivia` command-line tool.
 
-The CLI manages Holivia backoffice data: environments, authentication, selfcare contents, objectives, selfcare-objective associations, enterprises, HR intervention catalog items, HR home highlights, crises, collective interventions, and appointment video diagnostics.
+The CLI manages Holivia backoffice data: environments, authentication, selfcare contents, objectives, selfcare-objective associations, enterprises, employees, contracts, HR intervention catalog items, HR home highlights, crises, collective interventions, and appointment video diagnostics.
 
 ## Preconditions
 
@@ -21,6 +21,7 @@ Use `holivia` in examples below. If working from a checkout before installation,
 - Before creating or updating intervention catalog items, run `holivia intervention schema` and use its returned enum values and locales as the source of truth.
 - Before creating or updating HR home highlights, run `holivia highlight schema` and use its returned enum values and locales as the source of truth.
 - For destructive actions such as `holivia env remove`, `holivia selfcare objective delete`, `holivia crisis delete`, or `holivia collective-intervention delete`, confirm the target environment and ID first unless the user explicitly requested that exact action.
+- Employee data is personal data. Query only the employees a task needs, do not copy employee lists into unrelated output, and never try to infer whether an employee has a Holivia account.
 - Treat all command output as JSON except informational commands such as `holivia env`, `holivia env list`, `holivia login`, `holivia logout`, `holivia version`, and `holivia --help`.
 
 ## Installation
@@ -367,6 +368,66 @@ Filter enterprise lookup:
 holivia enterprise index --headquarter-id 10 --user-id 20 --page 1 --per-page 25
 ```
 
+Show details for one enterprise (settings, headquarter, CSM, countries, employees count; the current contract is included only for contract viewers and managers):
+
+```bash
+holivia enterprise show 123
+```
+
+Show aggregate employee counts for one enterprise (excludes demo employees; never includes account sign-up data):
+
+```bash
+holivia enterprise employee-stats 123
+```
+
+## Employees
+
+Requires an employee viewer or manager role. Responses never include Holivia account data (no user id, sign-up, or care status). `employee index` excludes demo employees unless `--demo true` (demo employees only) or `--demo all` (everyone) is given.
+
+List employees of an enterprise:
+
+```bash
+holivia employee index --enterprise-id 123 --page 1 --per-page 25
+```
+
+Search and filter employees:
+
+```bash
+holivia employee index --enterprise-id 123 --query durand --left false --hr-manager true
+holivia employee index --enterprise-id 123 --dependent-status dependent
+holivia employee index --enterprise-id 123 --demo true
+```
+
+Show one employee:
+
+```bash
+holivia employee show 42
+```
+
+## Contracts
+
+Requires a contract viewer or manager role.
+
+List contracts of an enterprise, most recent first:
+
+```bash
+holivia contract index --enterprise-id 123
+```
+
+Find active contracts, contracts expiring within three months, or contracts with low remaining sessions:
+
+```bash
+holivia contract index --status active
+holivia contract index --status expiring_soon
+holivia contract index --status low_remaining
+```
+
+Show every setting of one contract, including notes:
+
+```bash
+holivia contract show 7
+```
+
 ## Crises
 
 List crises:

data/lib/holivia/cli/help.rb

@@ -77,6 +77,24 @@ module Holivia
           holivia enterprise index [--query TEXT --headquarter-id ID --user-id ID --page N --per-page N]
                                                 Find enterprises and their enterprise_id values
           holivia enterprise lookup [options]   Alias for enterprise index
+          holivia enterprise show <id>          Show enterprise details: settings, headquarter, CSM,
+                                                countries, employees count, and the current contract
+                                                for contract viewers
+          holivia enterprise employee-stats <id> Show aggregate employee counts (total, left, current,
+                                                current dependents, current HR managers)
+
+        Employees:
+          holivia employee index [--enterprise-id ID --query TEXT --left true|false --hr-manager true|false
+                                  --dependent-status creator|dependent|not_dependent --demo true|false|all
+                                  --page N --per-page N]
+                                                List employees; never includes Holivia account data.
+                                                Demo employees are excluded unless --demo is given
+          holivia employee show <id>            Show one employee with its enterprise
+
+        Contracts:
+          holivia contract index [--enterprise-id ID --status active|expiring_soon|low_remaining --page N --per-page N]
+                                                List contracts, most recent first
+          holivia contract show <id>            Show every setting of one contract with its enterprise
 
         Communication Items:
           holivia communication index [--page N --per-page N --query TEXT --locale LOCALE --document-type TYPE]

data/lib/holivia/cli.rb

@@ -16,6 +16,8 @@ require_relative "commands/communication_item"
 require_relative "commands/intervention_item"
 require_relative "commands/hr_home_highlight"
 require_relative "commands/enterprise"
+require_relative "commands/employee"
+require_relative "commands/contract"
 require_relative "commands/crisis"
 require_relative "commands/collective_intervention"
 require_relative "commands/support_phone_number"
@@ -37,6 +39,8 @@ module Holivia
       when "intervention" then Commands::InterventionItem.route(args)
       when "highlight" then Commands::HrHomeHighlight.route(args)
       when "enterprise" then Commands::Enterprise.route(args)
+      when "employee" then Commands::Employee.route(args)
+      when "contract" then Commands::Contract.route(args)
       when "crisis" then Commands::Crisis.route(args)
       when "collective-intervention", "collective_intervention", "collective" then Commands::CollectiveIntervention.route(args)
       when "support-phone-numbers" then Commands::SupportPhoneNumber.route(args)

data/lib/holivia/commands/contract.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Holivia
+  module Commands
+    class Contract < Base
+      BASE_PATH = "/api/v1/backoffice/contracts"
+
+      def self.route(args)
+        subcommand = args.shift
+        case subcommand
+        when "index" then new.index(args)
+        when "show" then new.show(args)
+        else warn "Unknown contract command: #{subcommand}"
+             exit 1
+        end
+      end
+
+      def index(args = [])
+        params = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia contract index [options]"
+          opts.on("--enterprise-id ID", Integer) { |v| params[:enterprise_id] = v }
+          opts.on("--status STATUS") { |v| params[:status] = v }
+          opts.on("--page N", Integer) { |v| params[:page] = v }
+          opts.on("--per-page N", Integer) { |v| params[:per_page] = v }
+        end.parse!(args)
+
+        output(client.get(BASE_PATH, params: params))
+      end
+
+      def show(args = [])
+        id = args.shift
+        abort "Usage: holivia contract show <id>" unless id
+
+        output(client.get("#{BASE_PATH}/#{id}"))
+      end
+    end
+  end
+end

data/lib/holivia/commands/employee.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Holivia
+  module Commands
+    class Employee < Base
+      BASE_PATH = "/api/v1/backoffice/employees"
+      BOOLEAN_VALUES = %w[true false].freeze
+      DEPENDENT_STATUSES = %w[creator dependent not_dependent].freeze
+      DEMO_VALUES = %w[true false all].freeze
+
+      def self.route(args)
+        subcommand = args.shift
+        case subcommand
+        when "index" then new.index(args)
+        when "show" then new.show(args)
+        else warn "Unknown employee command: #{subcommand}"
+             exit 1
+        end
+      end
+
+      def index(args = []) # rubocop:disable Metrics/AbcSize,Metrics/MethodLength
+        params = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia employee index [options]"
+          opts.on("--enterprise-id ID", Integer) { |v| params[:enterprise_id] = v }
+          opts.on("--query TEXT") { |v| params[:query] = v }
+          opts.on("--left BOOL", BOOLEAN_VALUES) { |v| params[:left] = v }
+          opts.on("--hr-manager BOOL", BOOLEAN_VALUES) { |v| params[:hr_manager] = v }
+          opts.on("--dependent-status STATUS", DEPENDENT_STATUSES) { |v| params[:dependent_status] = v }
+          opts.on("--demo VALUE", DEMO_VALUES) { |v| params[:demo] = v }
+          opts.on("--page N", Integer) { |v| params[:page] = v }
+          opts.on("--per-page N", Integer) { |v| params[:per_page] = v }
+        end.parse!(args)
+
+        output(client.get(BASE_PATH, params: params))
+      end
+
+      def show(args = [])
+        id = args.shift
+        abort "Usage: holivia employee show <id>" unless id
+
+        output(client.get("#{BASE_PATH}/#{id}"))
+      end
+    end
+  end
+end

data/lib/holivia/commands/enterprise.rb

@@ -11,6 +11,8 @@ module Holivia
         subcommand = args.shift
         case subcommand
         when "index", "lookup", "search" then new.index(args)
+        when "show" then new.show(args)
+        when "employee-stats" then new.employee_stats(args)
         else warn "Unknown enterprise command: #{subcommand}"
              exit 1
         end
@@ -29,6 +31,20 @@ module Holivia
 
         output(client.get(BASE_PATH, params: params))
       end
+
+      def show(args = [])
+        id = args.shift
+        abort "Usage: holivia enterprise show <id>" unless id
+
+        output(client.get("#{BASE_PATH}/#{id}"))
+      end
+
+      def employee_stats(args = [])
+        id = args.shift
+        abort "Usage: holivia enterprise employee-stats <id>" unless id
+
+        output(client.get("#{BASE_PATH}/#{id}/employee_stats"))
+      end
     end
   end
 end

data/lib/holivia/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Holivia
-  VERSION = "0.13.0"
+  VERSION = "0.14.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: holivia
 version: !ruby/object:Gem::Version
-  version: 0.13.0
+  version: 0.14.0
 platform: ruby
 authors:
 - Holivia
@@ -66,7 +66,9 @@ files:
 - lib/holivia/commands/base.rb
 - lib/holivia/commands/collective_intervention.rb
 - lib/holivia/commands/communication_item.rb
+- lib/holivia/commands/contract.rb
 - lib/holivia/commands/crisis.rb
+- lib/holivia/commands/employee.rb
 - lib/holivia/commands/enterprise.rb
 - lib/holivia/commands/env.rb
 - lib/holivia/commands/format.rb