holivia 0.13.0 → 0.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5727339aa56fea9ffe71d4f5e0c49fdcd91a2d120aa3f88f7ff33f6a7b6eb49a
-  data.tar.gz: 6860e618178ca2b72dd346ec6f02b900cb1aaf48299db21bd6b2e98b6944ad9e
+  metadata.gz: 271aaa000a9c26152473b0b6cb693a8897ceca2da7ca2fd53a1e8a3beb6335a2
+  data.tar.gz: 69220c288809bceb7a8ed8c8873b1fbb57831d11049a371a18cd8c5d84626ae9
 SHA512:
-  metadata.gz: 573b090f0d92ee3676f920992e1c60f71b17b423627a000a4f4d118a1f394657670ce40c19d378f29bf4f56b2f54b682716d66ee70b80db1c7ccf1b088742d37
-  data.tar.gz: 26a6014d2c1351a3c2887c406ea572e7c5b73874077533c96c667ef8f11329e3a749954ae2ba141356066d51eff1ec970e758faa236d96687218db48f794d7da
+  metadata.gz: 3c682d5f11d12ca60ea9c07337a3587f3426859497c9af2c11eabe3b663124c5437a5e0f2d000b804c4d6d556d9c4d4bb7c0ed40f942382a66e1a8e9b0e7265a
+  data.tar.gz: 79ce0864fe511c0e75fb47f07e511376e0d35e99b412b248a103753eb21bb22b1bfb5a124a328fde5f92550a177b14bc1dab64788ad1a0a82543d108e3d25156

data/CHANGELOG.md

@@ -1,5 +1,45 @@
 ## [Unreleased]
 
+## [0.18.0] - 2026-11-03
+
+- Add `holivia credit-consumption-alert index` with `--enterprise-id`, `--page`, and `--per-page`, listing alerts with their `employees_count` and `consumption`
+- Add `holivia credit-consumption-alert show <id>` with the followed `employee_ids`
+- Add `holivia credit-consumption-alert create` with `--enterprise-id`, `--name`, `--starts-on`, `--ends-on`, `--threshold`, repeatable `--recipient-email`, and employee IDs from repeatable `--employee-ids ID,ID` or `--employee-ids-file PATH` (one per line or comma separated), plus piped JSON
+- Add `holivia credit-consumption-alert delete <id>`
+- Requires an enterprise manager role
+- Requires the matching Holivia backoffice API deployment
+
+## [0.17.0] - 2026-11-02
+
+- Add `holivia hr-access-grant show <employee_id>` to print an employee's `hr_manager` and `hr_space_only` flags and HR access grants, with each resource's type, id, and label
+- Add `holivia hr-access-grant update <employee_id>` with repeatable `--feature KEY=ID,ID` flags (each listed feature gets exactly those resource IDs, `KEY=` clears one, omitted features keep their grants), `--hr-manager true|false`, and piped JSON
+- `hr_space_only` cannot be changed through the CLI, and demo employees cannot be updated
+- Requires an enterprise manager or dev role
+- Requires the matching Holivia backoffice API deployment
+
+## [0.16.0] - 2026-10-30
+
+- Add `holivia appointment logs <id>` with `--page` and `--per-page` for an appointment's history (bookings, reschedules, cancellations, payments), newest first: log type, raw data, the backoffice title and content, and the author
+- Requires an appointment viewer or limited appointment viewer role
+- Requires the matching Holivia backoffice API deployment
+
+## [0.15.0] - 2026-10-29
+
+- Add `--query`, `--locale`, `--state`, `--content-type`, `--page`, and `--per-page` to `holivia selfcare index`; it previously ignored its arguments and only returned the first page
+- Add `--all` to `holivia selfcare index` to fetch every page of matching contents and print one JSON array
+- `holivia selfcare index` lists each content's `topic_slugs`, `tag_codes`, and `format_types`; `holivia selfcare show` adds `tag_codes` and `format_types`
+- Requires the matching Holivia backoffice API deployment for the new fields
+
+## [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, HR access grants, contracts, credit consumption alerts, communication library items, HR intervention catalog items, HR home highlights, crises, collective interventions, and appointment diagnostics and history.
 
 Coding agents can use [`SKILL.md`](SKILL.md) as a downloadable usage guide for operating this CLI safely.
 
@@ -115,6 +115,21 @@ List selfcare contents:
 holivia selfcare index
 ```
 
+Search and filter contents (`--query` matches titles, descriptions, goals, and tag names; at most 100 per page):
+
+```bash
+holivia selfcare index --query "communication non violente" --locale fr --state published
+holivia selfcare index --content-type exercise --page 2 --per-page 100
+```
+
+Fetch every matching content as one JSON array (`--all` ignores `--page` and `--per-page`):
+
+```bash
+holivia selfcare index --all --locale fr --state published
+```
+
+Each listed content includes its `topic_slugs`, `tag_codes`, and `format_types`; `selfcare show` adds `tag_codes` and `format_types` next to its full `topics`.
+
 Show one selfcare content:
 
 ```bash
@@ -180,12 +195,63 @@ Show video diagnostics for an appointment:
 holivia appointment video-diagnostics 42
 ```
 
+Show an appointment's history (bookings, reschedules, cancellations, payments), newest first:
+
+```bash
+holivia appointment logs 42
+holivia appointment logs 42 --page 2 --per-page 50
+```
+
 Find an enterprise id:
 
 ```bash
 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
+```
+
+Show and update an employee's HR access grants (omitted features are kept; `KEY=` clears one):
+
+```bash
+holivia hr-access-grant show 42
+holivia hr-access-grant update 42 --feature crisis_management=3,4 --hr-manager true
+```
+
+List and inspect contracts of an enterprise:
+
+```bash
+holivia contract index --enterprise-id 123 --status active
+holivia contract show 7
+```
+
+Follow the credits consumed by a fixed group of employees, and email recipients once when they reach a threshold:
+
+```bash
+holivia credit-consumption-alert create --enterprise-id 99 --name "Pavillon du Lac" \
+  --starts-on 2027-06-01 --ends-on 2028-06-01 --threshold 15 \
+  --recipient-email oceane@holivia.fr --employee-ids-file ids.txt
+holivia credit-consumption-alert index --enterprise-id 99
+holivia credit-consumption-alert show 5
+holivia credit-consumption-alert delete 5
+```
+
 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, HR access grants, contracts, credit consumption alerts, HR intervention catalog items, HR home highlights, crises, collective interventions, and appointment video diagnostics and history.
 
 ## Preconditions
 
@@ -20,7 +20,8 @@ Use `holivia` in examples below. If working from a checkout before installation,
 - Before creating or updating content, run `holivia selfcare schema` and use its returned enum values and permitted item params as the source of truth.
 - 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.
+- For destructive actions such as `holivia env remove`, `holivia selfcare objective delete`, `holivia crisis delete`, `holivia credit-consumption-alert 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
@@ -156,6 +157,21 @@ List contents:
 holivia selfcare index
 ```
 
+Search and filter contents (`--query` matches titles, descriptions, goals, and tag names; at most 100 per page):
+
+```bash
+holivia selfcare index --query "communication non violente" --locale fr --state published
+holivia selfcare index --content-type exercise --page 2 --per-page 100
+```
+
+Fetch every matching content as one JSON array (`--all` ignores `--page` and `--per-page`):
+
+```bash
+holivia selfcare index --all --locale fr --state published
+```
+
+Each listed content includes its `topic_slugs`, `tag_codes`, and `format_types`; `selfcare show` adds `tag_codes` and `format_types` next to its full `topics`.
+
 Show one content:
 
 ```bash
@@ -367,6 +383,124 @@ 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
+```
+
+## HR Access Grants
+
+Requires an enterprise manager role or `dev`. Grants decide which HR space features an employee can use, and for which resource: a data scope for `usage`, a segment for `segment_summary`, an enterprise for every other feature.
+
+Show an employee's `hr_manager` and `hr_space_only` flags and their grants, with each resource's type, id, and label:
+
+```bash
+holivia hr-access-grant show 42
+```
+
+Update grants. Each `--feature KEY=ID,ID` gets exactly those resource IDs; features you leave out keep their current grants, and `KEY=` clears a feature. Run `hr-access-grant show` first and pass back the IDs you want to keep:
+
+```bash
+holivia hr-access-grant update 42 --feature crisis_management=3,4 --feature employees_list= --hr-manager true
+echo '{"features": {"usage": [12]}}' | holivia hr-access-grant update 42
+```
+
+Piped JSON is merged after flags, and stdin wins on duplicate keys: a stdin `features` object replaces every `--feature` flag.
+
+The API answers 422 with details and changes nothing when a feature key is unknown, a resource ID is outside the employee's enterprise group, or the employee is a demo employee. `hr_space_only` cannot be changed through the CLI; ask for it to be changed in the backoffice.
+
+## 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
+```
+
+## Credit Consumption Alerts
+
+Requires an enterprise manager role. An alert follows a fixed list of employees of one enterprise and counts the enterprise credits they consume from `starts_on` (and until `ends_on` when given). Once the consumption reaches `threshold`, recipients get one email and `triggered_at` is set. Employees stay followed after they leave or their details change.
+
+List alerts, most recent first, with `employees_count` and `consumption`:
+
+```bash
+holivia credit-consumption-alert index --enterprise-id 99
+```
+
+Show one alert with its followed `employee_ids`:
+
+```bash
+holivia credit-consumption-alert show 5
+```
+
+Create an alert. Employee IDs are the backoffice employee IDs (`holivia employee index --enterprise-id 99`); pass them with repeatable `--employee-ids 12,13` or with `--employee-ids-file` (one ID per line, or comma separated). `--recipient-email` is repeatable:
+
+```bash
+holivia credit-consumption-alert create \
+  --enterprise-id 99 \
+  --name "Pavillon du Lac" \
+  --starts-on 2027-06-01 \
+  --ends-on 2028-06-01 \
+  --threshold 15 \
+  --recipient-email oceane@holivia.fr \
+  --employee-ids-file ids.txt
+```
+
+Piped JSON is merged after flags, and stdin wins on duplicate keys. The API answers 422 and creates nothing when an ID is not an employee of the enterprise (the unknown IDs are listed), when no employee ID is given, or when a field is invalid.
+
+Delete an alert (its employees are kept):
+
+```bash
+holivia credit-consumption-alert delete 5
+```
+
 ## Crises
 
 List crises:
@@ -630,6 +764,15 @@ Show video diagnostics for an appointment:
 holivia appointment video-diagnostics 42
 ```
 
+Show an appointment's history, newest first:
+
+```bash
+holivia appointment logs 42
+holivia appointment logs 42 --page 2 --per-page 50
+```
+
+Each log has `log_type` (`appointment_booked`, `appointment_rescheduled`, `appointment_rescheduled_last_minute`, `appointment_canceled`, `appointment_payed`, `unconfirmed_appointment_booked`), `created_at` (UTC), raw `data` (UTC `logged_start_time`/`previous_start_time`, durations in minutes, `patient_credits` after the operation), the French `title` and `content` shown in the backoffice (dates in your time zone), and `user` (`type`, `id`, `name`) for who triggered it, or `null`. `title` and `content` are `null` for log types the backoffice cannot render. Logs contain patient names; treat them as personal data. Requires an appointment viewer or limited appointment viewer role.
+
 ## Errors
 
 - `401` means authentication failed or credentials could not be refreshed. Re-run `holivia login` for the active environment.

data/lib/holivia/cli/help.rb

@@ -22,7 +22,9 @@ module Holivia
           Tokens are stored at ~/.holivia/credentials.<env>.json and refreshed automatically on 401.
 
         Selfcare Contents:
-          holivia selfcare index                 List all selfcare contents
+          holivia selfcare index [options]       List selfcare contents
+                                                 (--query TEXT --locale LOCALE --state STATE
+                                                  --content-type TYPE --page N --per-page N --all)
           holivia selfcare show <id>             Show a selfcare content by id
           holivia selfcare create [options]      Create a selfcare content
                                                  (--state draft|ongoing_translation|translation_to_be_reviewed|
@@ -77,6 +79,53 @@ 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
+
+        HR Access Grants:
+          holivia hr-access-grant show <employee_id>
+                                                Show an employee's hr_manager and hr_space_only flags
+                                                and HR feature grants with their resources
+          holivia hr-access-grant update <employee_id> [--feature KEY=ID,ID ... --hr-manager true|false]
+                                                Grant exactly the given resource IDs for each listed feature;
+                                                omitted features keep their grants and KEY= clears one
+          Features: usage (data scope IDs), segment_summary (segment IDs), employees_list,
+          crisis_management, intervention_catalog, intervention_tracking, communication_library
+          (enterprise IDs). IDs outside the employee's enterprise group are rejected (422).
+          hr_space_only can only be changed in the backoffice. Demo employees cannot be updated.
+          Piped JSON ({"features": {...}, "hr_manager": true}) is merged after flags; stdin wins.
+          Requires enterprise_manager or dev.
+
+        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
+
+        Credit Consumption Alerts:
+          holivia credit-consumption-alert index [--enterprise-id ID --page N --per-page N]
+                                                List alerts, most recent first, with consumption
+          holivia credit-consumption-alert show <id>
+                                                Show one alert with its followed employee IDs
+          holivia credit-consumption-alert create --enterprise-id ID --name NAME --starts-on YYYY-MM-DD
+                                  [--ends-on YYYY-MM-DD] --threshold N --recipient-email EMAIL ...
+                                  (--employee-ids ID,ID ... | --employee-ids-file PATH)
+                                                Follow these employees of the enterprise; an email is sent
+                                                once when their consumed credits reach the threshold
+          holivia credit-consumption-alert delete <id>
+                                                Delete an alert (employees are kept)
+          IDs that are not employees of the enterprise are rejected (422).
+          Piped JSON is merged after flags; stdin wins. Requires enterprise_manager.
 
         Communication Items:
           holivia communication index [--page N --per-page N --query TEXT --locale LOCALE --document-type TYPE]
@@ -145,6 +194,8 @@ module Holivia
 
         Appointments:
           holivia appointment video-diagnostics <id>  Show video diagnostics for an appointment
+          holivia appointment logs <id> [--page N --per-page N]
+                                                Show an appointment's history, newest first
 
         Selfcare Content Objectives:
           holivia selfcare objective index [--page N --per-page N --selfcare-content-id ID --objective-id ID]

data/lib/holivia/cli.rb

@@ -16,6 +16,10 @@ 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/hr_access_grant"
+require_relative "commands/contract"
+require_relative "commands/credit_consumption_alert"
 require_relative "commands/crisis"
 require_relative "commands/collective_intervention"
 require_relative "commands/support_phone_number"
@@ -37,6 +41,10 @@ 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 "hr-access-grant" then Commands::HrAccessGrant.route(args)
+      when "contract" then Commands::Contract.route(args)
+      when "credit-consumption-alert" then Commands::CreditConsumptionAlert.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/appointment.rb

@@ -11,6 +11,7 @@ module Holivia
         subcommand = args.shift
         case subcommand
         when "video-diagnostics" then new.video_diagnostics(args)
+        when "logs" then new.logs(args)
         else warn "Unknown appointment command: #{subcommand}"
              exit 1
         end
@@ -22,6 +23,20 @@ module Holivia
 
         output(client.get("#{BASE_PATH}/#{id}/video_diagnostics"))
       end
+
+      def logs(args = [])
+        id = args.shift
+        abort "Usage: holivia appointment logs <id> [--page N --per-page N]" unless id
+
+        params = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia appointment logs <id> [options]"
+          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}/#{id}/logs", params: params))
+      end
     end
   end
 end

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/credit_consumption_alert.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Holivia
+  module Commands
+    class CreditConsumptionAlert < Base
+      BASE_PATH = "/api/v1/backoffice/credit_consumption_alerts"
+      CREATE_BANNER = "Usage: holivia credit-consumption-alert create --enterprise-id ID --name NAME " \
+                      "--starts-on YYYY-MM-DD [--ends-on YYYY-MM-DD] --threshold N --recipient-email EMAIL " \
+                      "(--employee-ids ID,ID | --employee-ids-file PATH)"
+      EMPLOYEE_IDS_SEPARATOR = /[\s,]+/
+
+      def self.route(args)
+        subcommand = args.shift
+        case subcommand
+        when "index" then new.index(args)
+        when "show" then new.show(args)
+        when "create" then new.create(args)
+        when "delete" then new.delete(args)
+        else warn "Unknown credit-consumption-alert command: #{subcommand}"
+             exit 1
+        end
+      end
+
+      def index(args = [])
+        params = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia credit-consumption-alert index [options]"
+          opts.on("--enterprise-id ID", Integer) { |v| params[:enterprise_id] = 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 credit-consumption-alert show <id>" unless id
+
+        output(client.get("#{BASE_PATH}/#{id}"))
+      end
+
+      def create(args = [])
+        options = parse_create_options(args).merge(piped_json)
+        abort "No options provided. Use --help for usage." if options.empty?
+
+        output(client.post(BASE_PATH, body: options))
+      end
+
+      def delete(args = [])
+        id = args.shift
+        abort "Usage: holivia credit-consumption-alert delete <id>" unless id
+
+        client.delete("#{BASE_PATH}/#{id}")
+        output(deleted: true, id: id.to_i)
+      end
+
+      private
+
+      def parse_create_options(args) # rubocop:disable Metrics/AbcSize,Metrics/MethodLength
+        options = {}
+        OptionParser.new do |opts|
+          opts.banner = CREATE_BANNER
+          opts.on("--enterprise-id ID", Integer) { |v| options[:enterprise_id] = v }
+          opts.on("--name NAME") { |v| options[:name] = v }
+          opts.on("--starts-on DATE") { |v| options[:starts_on] = v }
+          opts.on("--ends-on DATE") { |v| options[:ends_on] = v }
+          opts.on("--threshold N", Integer) { |v| options[:threshold] = v }
+          opts.on("--recipient-email EMAIL", "Repeatable") { |v| (options[:recipient_emails] ||= []) << v }
+          opts.on("--employee-ids IDS", "Comma separated employee IDs; repeatable") do |v|
+            (options[:employee_ids] ||= []).concat(parse_employee_ids(v))
+          end
+          opts.on("--employee-ids-file PATH", "One employee ID per line, or comma separated") do |v|
+            (options[:employee_ids] ||= []).concat(parse_employee_ids(File.read(v)))
+          end
+        end.parse!(args)
+        options[:employee_ids]&.uniq!
+        options
+      end
+
+      def parse_employee_ids(value)
+        value.split(EMPLOYEE_IDS_SEPARATOR).reject(&:empty?).map { |id| Integer(id, 10) }
+      rescue ArgumentError
+        raise OptionParser::InvalidArgument, value.strip
+      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/commands/hr_access_grant.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Holivia
+  module Commands
+    class HrAccessGrant < Base
+      EMPLOYEES_PATH = "/api/v1/backoffice/employees"
+      UPDATE_BANNER = "Usage: holivia hr-access-grant update <employee_id> [--feature KEY=ID,ID ...] " \
+                      "[--hr-manager true|false]"
+      BOOLEANS = { "true" => true, "false" => false }.freeze
+
+      def self.route(args)
+        subcommand = args.shift
+        case subcommand
+        when "show" then new.show(args)
+        when "update" then new.update(args)
+        else warn "Unknown hr-access-grant command: #{subcommand}"
+             exit 1
+        end
+      end
+
+      def show(args = [])
+        employee_id = args.shift
+        abort "Usage: holivia hr-access-grant show <employee_id>" unless employee_id
+
+        output(client.get(grants_path(employee_id)))
+      end
+
+      def update(args = [])
+        employee_id = args.shift
+        abort UPDATE_BANNER unless employee_id
+
+        options = parse_update_options(args).merge(piped_json)
+        abort "No options provided. Use --help for usage." if options.empty?
+
+        output(client.patch(grants_path(employee_id), body: options))
+      end
+
+      private
+
+      def parse_update_options(args)
+        options = {}
+        OptionParser.new do |opts|
+          opts.banner = UPDATE_BANNER
+          opts.on("--feature KEY=IDS", "Grant exactly these resource IDs for a feature; KEY= clears it") do |v|
+            key, ids = parse_feature(v)
+            (options[:features] ||= {})[key] = ids
+          end
+          opts.on("--hr-manager BOOL", BOOLEANS) { |v| options[:hr_manager] = v }
+        end.parse!(args)
+        options
+      end
+
+      def parse_feature(value)
+        key, ids = value.split("=", 2)
+        raise OptionParser::InvalidArgument, value if key.to_s.empty? || ids.nil?
+
+        [key.to_sym, ids.split(",").map { |id| Integer(id) }]
+      rescue ArgumentError
+        raise OptionParser::InvalidArgument, value
+      end
+
+      def grants_path(employee_id)
+        "#{EMPLOYEES_PATH}/#{employee_id}/hr_access_grants"
+      end
+    end
+  end
+end

data/lib/holivia/commands/selfcare.rb

@@ -5,8 +5,9 @@ require_relative "selfcare_objective"
 
 module Holivia
   module Commands
-    class Selfcare < Base
+    class Selfcare < Base # rubocop:disable Metrics/ClassLength
       BASE_PATH = "/api/v1/backoffice/selfcare_contents"
+      MAX_PER_PAGE = 100
       COMPOSE_EXAMPLE_PATH = Holivia.root.join("examples", "compose.json").to_s
       IMAGE_MIME_TYPES = {
         ".jpg" => "image/jpeg",
@@ -34,8 +35,21 @@ module Holivia
         end
       end
 
-      def index(_args = [])
-        output(client.get(BASE_PATH))
+      def index(args = []) # rubocop:disable Metrics/AbcSize,Metrics/MethodLength
+        params = {}
+        all = false
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia selfcare index [options]"
+          opts.on("--query TEXT") { |v| params[:query] = v }
+          opts.on("--locale LOCALE") { |v| params[:locale] = v }
+          opts.on("--state STATE") { |v| params[:state] = v }
+          opts.on("--content-type TYPE") { |v| params[:content_type] = v }
+          opts.on("--page N", Integer) { |v| params[:page] = v }
+          opts.on("--per-page N", Integer) { |v| params[:per_page] = v }
+          opts.on("--all", "Fetch every page and print one JSON array (ignores --page and --per-page)") { all = true }
+        end.parse!(args)
+
+        output(all ? all_pages(params.except(:page, :per_page)) : client.get(BASE_PATH, params: params))
       end
 
       def show(args = [])
@@ -110,6 +124,19 @@ module Holivia
 
       private
 
+      def all_pages(params)
+        contents = []
+        page = 1
+        loop do
+          response = client.get(BASE_PATH, params: params.merge(page: page, per_page: MAX_PER_PAGE))
+          contents.concat(response.fetch("selfcare_contents"))
+          break if page >= response.dig("meta", "total_pages").to_i
+
+          page += 1
+        end
+        contents
+      end
+
       def build_body(options)
         image_path = options.delete(:image)
         return options unless image_path

data/lib/holivia/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: holivia
 version: !ruby/object:Gem::Version
-  version: 0.13.0
+  version: 0.18.0
 platform: ruby
 authors:
 - Holivia
@@ -66,10 +66,14 @@ 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/credit_consumption_alert.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
+- lib/holivia/commands/hr_access_grant.rb
 - lib/holivia/commands/hr_home_highlight.rb
 - lib/holivia/commands/intervention_item.rb
 - lib/holivia/commands/item.rb
@@ -107,7 +111,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.10
+rubygems_version: 4.0.23
 specification_version: 4
 summary: Ruby client and CLI for the Holivia API
 test_files: []