holivia 0.6.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 88e7b483f29ede5b8d719e09e0e64014979b01fbe4f46e3476131d5f04cf6dd4
-  data.tar.gz: 51142c7c75c2917c065e7eb99b9c5162d3c08e435722acdf2f532bcc4b17d2e7
+  metadata.gz: 37fbbbbc00a19fce307307f0d0d0465383b83759a1bbb30977131edfff1c3a98
+  data.tar.gz: 0241e8e1ece96ea66fdabe38c188e2914f071a26d225a778a6373c1a5c74fb64
 SHA512:
-  metadata.gz: 2b35a23633a3f1fd43dd849297c49f2bf836d237575ccd797fdd63274743b06cabd66a8c082cb82b14992270cb1f5c1048c0fce32cd7f8c1c12032dca529ae9e
-  data.tar.gz: 4fd44133555a0453e2e21b4daad51d1ba5a7e5e42bfba0f8bce98f0b1c245af8bbcc0913a0e74964ed2c690506d12ad3fbee4a15138c52f7bcc2a5478c8aa446
+  metadata.gz: b310a7ef0b2f389a796a352d60455b33798c796821577623686b6658030d7716d4b7445fbac599630f5cf39d0ddc5db3c32d2ac3930dde8ec5692b37b3f300a8
+  data.tar.gz: 13a99d2b9dd8e0b27e2bc3ad941d9e7756f8b629d30b347f13785f818f58db8df1c460fed7518b6b458a9752323028ed67e0325ab8448a8da39fd09f76884044

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 ## [Unreleased]
 
+## [0.8.0] - 2026-07-07
+
+- Add `holivia intervention` commands for HR intervention catalog CRUD, publishing, schema discovery, and cover image uploads
+
+## [0.7.0] - 2026-07-02
+
+- Add `holivia communication` commands for communication library CRUD, publishing, schema discovery, and document/cover uploads
+
 ## [0.6.0] - 2026-06-05
 
 - Add `holivia appointment video-diagnostics <id>` for appointment video diagnostics

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, and appointment diagnostics.
+The `holivia` executable is primarily used to manage Holivia backoffice data from the terminal: environments, authentication, selfcare content, objectives, communication library items, HR intervention catalog items, and appointment diagnostics.
 
 Coding agents can use [`SKILL.md`](SKILL.md) as a downloadable usage guide for operating this CLI safely.
 
@@ -166,6 +166,64 @@ Show video diagnostics for an appointment:
 holivia appointment video-diagnostics 42
 ```
 
+List communication library items:
+
+```bash
+holivia communication index --locale fr --document-type poster
+```
+
+Create a communication item:
+
+```bash
+holivia communication create \
+  --title "Launch poster" \
+  --locale fr \
+  --document-type poster \
+  --document launch-poster.pdf \
+  --cover-image cover.png
+```
+
+Publish it:
+
+```bash
+holivia communication publish 123
+```
+
+Discover intervention catalog enum values and locales:
+
+```bash
+holivia intervention schema
+```
+
+List intervention catalog items:
+
+```bash
+holivia intervention index --locale fr --state published --category audit_diagnose
+```
+
+Create an intervention item:
+
+```bash
+holivia intervention create \
+  --locale fr \
+  --title "Manager burnout workshop" \
+  --intervention-type workshop \
+  --category raise_awareness_train \
+  --duration 90_min \
+  --short-outcome "Spot warning signs" \
+  --short-outcome "Choose support routines" \
+  --long-outcome "Map team risks" \
+  --modality online \
+  --audience managers \
+  --cover-image cover.png
+```
+
+Publish it:
+
+```bash
+holivia intervention publish 123
+```
+
 ## Files And Uploads
 
 Selfcare create and update commands can upload images with `--image <path>`.
@@ -182,6 +240,10 @@ holivia selfcare item create --slide-id 456 --item-type AudioItem --audio medita
 
 Compose is JSON-only. To attach an image to a composed content tree, update the returned content id afterward with `holivia selfcare update <id> --image <path>`.
 
+Communication item create and update commands upload the required document with `--document <path>` and can upload or replace the cover image with `--cover-image <path>`.
+
+Intervention item create and update commands can upload or replace the cover image with `--cover-image <path>`.
+
 ## Development
 
 After checking out the repo, run:

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, and appointment video diagnostics.
+The CLI manages Holivia backoffice data: environments, authentication, selfcare contents, objectives, selfcare-objective associations, HR intervention catalog items, and appointment video diagnostics.
 
 ## Preconditions
 
@@ -18,6 +18,7 @@ Use `holivia` in examples below. If working from a checkout before installation,
 - Never print, store, or commit passwords, access tokens, refresh tokens, or files under `~/.holivia/credentials.*.json`.
 - Prefer interactive `holivia login` when a human can enter credentials. Use `--password` only when the user explicitly provides it for automation.
 - 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.
 - For destructive actions such as `holivia env remove` or `holivia selfcare objective delete`, confirm the target environment and ID first unless the user explicitly requested that exact action.
 - 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`.
 
@@ -130,6 +131,14 @@ Use the schema response for:
 - objective tiers
 - item-specific permitted params
 
+For intervention catalog work, discover the live schema first:
+
+```bash
+holivia intervention schema
+```
+
+Use the schema response for intervention types, modalities, audiences, durations, categories, states, and locales.
+
 ## Selfcare Content
 
 List contents:
@@ -269,6 +278,68 @@ holivia objective show 123
 
 Objective translated fields are returned in the default locale, currently `fr`.
 
+## Intervention Items
+
+List intervention catalog items:
+
+```bash
+holivia intervention index --locale fr --state published
+```
+
+Filter by catalog metadata:
+
+```bash
+holivia intervention index --query burnout --category raise_awareness_train --intervention-type workshop
+```
+
+Show one intervention item:
+
+```bash
+holivia intervention show 123
+```
+
+Create an intervention item:
+
+```bash
+holivia intervention create \
+  --locale fr \
+  --title "Manager burnout workshop" \
+  --intervention-type workshop \
+  --category raise_awareness_train \
+  --duration 90_min \
+  --short-outcome "Spot warning signs" \
+  --short-outcome "Choose support routines" \
+  --long-outcome "Map team risks" \
+  --modality online \
+  --audience managers \
+  --cover-image cover.png
+```
+
+Create or update from JSON for complex multiline text:
+
+```bash
+printf '{"locale":"fr","title":"Team audit","intervention_type":"audit","category":"audit_diagnose","modalities":["online"],"audience":["hr"]}' | holivia intervention create
+```
+
+Update one localized item:
+
+```bash
+holivia intervention update 123 --title "Updated title" --modality in_person
+```
+
+Publish or unpublish one localized item:
+
+```bash
+holivia intervention publish 123
+holivia intervention unpublish 123
+```
+
+Delete one localized item:
+
+```bash
+holivia intervention delete 123
+```
+
 ## Selfcare Objective Associations
 
 List associations:
@@ -333,6 +404,7 @@ Before making API changes:
 
 - Run `holivia env` and verify the active URL/environment.
 - Run `holivia selfcare schema` before selfcare create/update/compose work.
+- Run `holivia intervention schema` before intervention create/update work.
 - Use existing IDs from list/show commands or explicit user input.
 - Prefer draft states unless the user explicitly requests publishing.
 - Use JSON files or stdin for complex payloads.

data/lib/holivia/cli/help.rb

@@ -2,7 +2,7 @@
 
 module Holivia
   class CLI
-    module Help
+    module Help # rubocop:disable Metrics/ModuleLength
       HELP_TEXT = <<~HELP
         HOLIVIA CLI
         ===========
@@ -49,6 +49,29 @@ module Holivia
           holivia objective show <id>                                  Show one objective
           Translated fields are returned in the default locale (fr).
 
+        Communication Items:
+          holivia communication index [--page N --per-page N --query TEXT --locale LOCALE --document-type TYPE]
+                                                List communication library items
+          holivia communication show <id>       Show one communication item
+          holivia communication create [options] Create a communication item with a required document upload
+          holivia communication update <id> [options] Update metadata or replace uploads
+          holivia communication publish <id>    Publish a draft communication item
+          holivia communication unpublish <id>  Unpublish a communication item and clear published_at
+          holivia communication delete <id>     Delete a communication item
+          holivia communication schema          Show allowed document_types and locales
+
+        Intervention Items:
+          holivia intervention index [--page N --per-page N --query TEXT --locale LOCALE --state STATE
+                                      --category KEY --translation-group-id UUID --intervention-type TYPE]
+                                                List HR intervention catalog items
+          holivia intervention schema           Show allowed intervention enum values and locales
+          holivia intervention show <id>        Show one intervention item
+          holivia intervention create [options] Create one localized intervention item
+          holivia intervention update <id> [options] Update one localized intervention item
+          holivia intervention publish <id>     Publish one intervention item
+          holivia intervention unpublish <id>   Unpublish one intervention item
+          holivia intervention delete <id>      Delete one localized intervention item
+
         Appointments:
           holivia appointment video-diagnostics <id>  Show video diagnostics for an appointment
 
@@ -89,6 +112,9 @@ module Holivia
           Accepted audio formats: MP3, MP4, WAV, OGG, FLAC, AAC, M4A, WebM. Max size: 100 MB.
           Image uploads use --image <path> on selfcare create/update (sent as multipart/form-data).
           Accepted image formats: JPEG, PNG, WebP, GIF. Max size: 5 MB.
+          Communication uploads use --document <path> and optional --cover-image <path>.
+          The API validates accepted communication upload formats and file sizes.
+          Intervention cover images use --cover-image <path> on intervention create/update.
           Compose is JSON-only — to attach an image to a composed tree, PATCH the returned id:
             holivia selfcare update <id> --image <path>
 
@@ -101,6 +127,8 @@ module Holivia
           Run holivia selfcare schema to get current allowed values for all enums
           and item types with their permitted params. Always use this over hardcoded
           values — it is the source of truth.
+          Run holivia intervention schema before creating or updating intervention items
+          to discover current intervention enum values and locales.
 
         Version:
           holivia version                        Print version

data/lib/holivia/cli.rb

@@ -10,6 +10,8 @@ require_relative "commands/env"
 require_relative "commands/item"
 require_relative "commands/objective"
 require_relative "commands/appointment"
+require_relative "commands/communication_item"
+require_relative "commands/intervention_item"
 
 module Holivia
   class CLI
@@ -22,6 +24,8 @@ module Holivia
       when "selfcare" then Commands::Selfcare.route(args)
       when "objective" then Commands::Objective.route(args)
       when "appointment" then Commands::Appointment.route(args)
+      when "communication" then Commands::CommunicationItem.route(args)
+      when "intervention" then Commands::InterventionItem.route(args)
       when "version", "--version", "-v" then puts "holivia #{Holivia::VERSION}"
       when "--help", "-h", nil then puts Help::HELP_TEXT
       else warn "Unknown command: #{command}"

data/lib/holivia/commands/communication_item.rb

@@ -0,0 +1,145 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Holivia
+  module Commands
+    class CommunicationItem < Base # rubocop:disable Metrics/ClassLength
+      BASE_PATH = "/api/v1/backoffice/communication_items"
+      CONTENT_TYPE_BY_EXTENSION = {
+        ".gif" => "image/gif",
+        ".jpeg" => "image/jpeg",
+        ".jpg" => "image/jpeg",
+        ".mov" => "video/quicktime",
+        ".mp4" => "video/mp4",
+        ".pdf" => "application/pdf",
+        ".png" => "image/png",
+        ".ppt" => "application/vnd.ms-powerpoint",
+        ".pptx" => "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+        ".webm" => "video/webm",
+        ".webp" => "image/webp",
+        ".zip" => "application/zip"
+      }.freeze
+
+      def self.route(args) # rubocop:disable Metrics/AbcSize,Metrics/CyclomaticComplexity,Metrics/MethodLength
+        subcommand = args.shift
+        case subcommand
+        when "index" then new.index(args)
+        when "show" then new.show(args)
+        when "create" then new.create(args)
+        when "update" then new.update(args)
+        when "publish" then new.publish(args)
+        when "unpublish" then new.unpublish(args)
+        when "delete" then new.delete(args)
+        when "schema" then new.schema(args)
+        else warn "Unknown communication command: #{subcommand}"
+             exit 1
+        end
+      end
+
+      def index(args = []) # rubocop:disable Metrics/AbcSize
+        params = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia communication index [options]"
+          opts.on("--page N", Integer) { |v| params[:page] = v }
+          opts.on("--per-page N", Integer) { |v| params[:per_page] = v }
+          opts.on("--query TEXT") { |v| params[:query] = v }
+          opts.on("--locale LOCALE") { |v| params[:locale] = v }
+          opts.on("--document-type TYPE") { |v| params[:document_type] = v }
+        end.parse!(args)
+
+        output(client.get(BASE_PATH, params: params))
+      end
+
+      def show(args = [])
+        id = args.shift
+        abort "Usage: holivia communication show <id>" unless id
+
+        output(client.get("#{BASE_PATH}/#{id}"))
+      end
+
+      def create(args = [])
+        options = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia communication create [options]"
+          add_write_options(opts, options)
+        end.parse!(args)
+        options = options.merge(piped_json)
+
+        abort "No options provided. Use --help for usage." if options.empty?
+        output(client.post(BASE_PATH, body: build_body(options)))
+      end
+
+      def update(args = [])
+        id = args.shift
+        abort "Usage: holivia communication update <id> [options]" unless id
+
+        options = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia communication update <id> [options]"
+          add_write_options(opts, options)
+        end.parse!(args)
+        options = options.merge(piped_json)
+
+        abort "No options provided. Use --help for usage." if options.empty?
+        output(client.patch("#{BASE_PATH}/#{id}", body: build_body(options)))
+      end
+
+      def publish(args = [])
+        transition(args, "publish")
+      end
+
+      def unpublish(args = [])
+        transition(args, "unpublish")
+      end
+
+      def delete(args = [])
+        id = args.shift
+        abort "Usage: holivia communication delete <id>" unless id
+
+        client.delete("#{BASE_PATH}/#{id}")
+        output(deleted: true, id: id.to_i)
+      end
+
+      def schema(_args = [])
+        output(client.get("#{BASE_PATH}/schema"))
+      end
+
+      private
+
+      def add_write_options(opts, options)
+        opts.on("--title TITLE") { |v| options[:title] = v }
+        opts.on("--description DESC") { |v| options[:description] = v }
+        opts.on("--document-type TYPE") { |v| options[:document_type] = v }
+        opts.on("--locale LOCALE") { |v| options[:locale] = v }
+        opts.on("--cover-image FILE") { |v| options[:cover_image] = v }
+        opts.on("--document FILE") { |v| options[:document] = v }
+      end
+
+      def transition(args, event)
+        id = args.shift
+        abort "Usage: holivia communication #{event} <id>" unless id
+
+        output(client.patch("#{BASE_PATH}/#{id}/#{event}"))
+      end
+
+      def build_body(options)
+        options = options.dup
+        attach_file_part(options, :cover_image)
+        attach_file_part(options, :document)
+        options
+      end
+
+      def attach_file_part(options, key)
+        path = options[key]
+        return unless path
+
+        options[key] = Faraday::Multipart::FilePart.new(path, detect_mime(path))
+      end
+
+      def detect_mime(path)
+        CONTENT_TYPE_BY_EXTENSION.fetch(File.extname(path).downcase, "application/octet-stream")
+      end
+    end
+  end
+end

data/lib/holivia/commands/intervention_item.rb

@@ -0,0 +1,152 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Holivia
+  module Commands
+    class InterventionItem < Base # rubocop:disable Metrics/ClassLength
+      BASE_PATH = "/api/v1/backoffice/intervention_items"
+      IMAGE_MIME_TYPES = {
+        ".gif" => "image/gif",
+        ".jpeg" => "image/jpeg",
+        ".jpg" => "image/jpeg",
+        ".png" => "image/png",
+        ".webp" => "image/webp"
+      }.freeze
+
+      def self.route(args) # rubocop:disable Metrics/AbcSize,Metrics/CyclomaticComplexity,Metrics/MethodLength
+        subcommand = args.shift
+        case subcommand
+        when "index" then new.index(args)
+        when "schema" then new.schema(args)
+        when "show" then new.show(args)
+        when "create" then new.create(args)
+        when "update" then new.update(args)
+        when "publish" then new.publish(args)
+        when "unpublish" then new.unpublish(args)
+        when "delete" then new.delete(args)
+        else warn "Unknown intervention command: #{subcommand}"
+             exit 1
+        end
+      end
+
+      def index(args = []) # rubocop:disable Metrics/AbcSize,Metrics/MethodLength
+        params = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia intervention index [options]"
+          opts.on("--page N", Integer) { |v| params[:page] = v }
+          opts.on("--per-page N", Integer) { |v| params[:per_page] = v }
+          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("--category CATEGORY") { |v| params[:category] = v }
+          opts.on("--translation-group-id UUID") { |v| params[:translation_group_id] = v }
+          opts.on("--intervention-type TYPE") { |v| params[:intervention_type] = v }
+        end.parse!(args)
+
+        output(client.get(BASE_PATH, params: params))
+      end
+
+      def schema(_args = [])
+        output(client.get("#{BASE_PATH}/schema"))
+      end
+
+      def show(args = [])
+        id = args.shift
+        abort "Usage: holivia intervention show <id>" unless id
+
+        output(client.get("#{BASE_PATH}/#{id}"))
+      end
+
+      def create(args = [])
+        options = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia intervention create [options]"
+          add_write_options(opts, options)
+        end.parse!(args)
+        options = options.merge(piped_json)
+
+        abort "No options provided. Use --help for usage." if options.empty?
+        output(client.post(BASE_PATH, body: build_body(options)))
+      end
+
+      def update(args = [])
+        id = args.shift
+        abort "Usage: holivia intervention update <id> [options]" unless id
+
+        options = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia intervention update <id> [options]"
+          add_write_options(opts, options)
+        end.parse!(args)
+        options = options.merge(piped_json)
+
+        abort "No options provided. Use --help for usage." if options.empty?
+        output(client.patch("#{BASE_PATH}/#{id}", body: build_body(options)))
+      end
+
+      def publish(args = [])
+        transition(args, "publish")
+      end
+
+      def unpublish(args = [])
+        transition(args, "unpublish")
+      end
+
+      def delete(args = [])
+        id = args.shift
+        abort "Usage: holivia intervention delete <id>" unless id
+
+        client.delete("#{BASE_PATH}/#{id}")
+        output(deleted: true, id: id.to_i)
+      end
+
+      private
+
+      def add_write_options(opts, options) # rubocop:disable Metrics/AbcSize,Metrics/MethodLength
+        opts.on("--translation-group-id UUID") { |v| options[:translation_group_id] = v }
+        opts.on("--locale LOCALE") { |v| options[:locale] = v }
+        opts.on("--title TITLE") { |v| options[:title] = v }
+        opts.on("--description DESC") { |v| options[:description] = v }
+        opts.on("--program PROGRAM") { |v| options[:program] = v }
+        opts.on("--intervention-type TYPE") { |v| options[:intervention_type] = v }
+        opts.on("--duration DURATION") { |v| options[:duration] = v }
+        opts.on("--category CATEGORY") { |v| options[:category] = v }
+        opts.on("--short-outcome TEXT") { |v| append_array_value(options, :short_outcomes, v) }
+        opts.on("--long-outcome TEXT") { |v| append_array_value(options, :long_outcomes, v) }
+        opts.on("--modality MODALITY") { |v| append_array_value(options, :modalities, v) }
+        opts.on("--audience AUDIENCE") { |v| append_array_value(options, :audience, v) }
+        opts.on("--cover-image FILE") { |v| options[:cover_image] = v }
+      end
+
+      def append_array_value(options, key, value)
+        options[key] ||= []
+        options[key] << value
+      end
+
+      def transition(args, event)
+        id = args.shift
+        abort "Usage: holivia intervention #{event} <id>" unless id
+
+        output(client.patch("#{BASE_PATH}/#{id}/#{event}"))
+      end
+
+      def build_body(options)
+        options = options.dup
+        attach_cover_image(options)
+        options
+      end
+
+      def attach_cover_image(options)
+        path = options[:cover_image]
+        return unless path
+
+        options[:cover_image] = Faraday::Multipart::FilePart.new(path, detect_mime(path))
+      end
+
+      def detect_mime(path)
+        IMAGE_MIME_TYPES.fetch(File.extname(path).downcase, "application/octet-stream")
+      end
+    end
+  end
+end

data/lib/holivia/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: holivia
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Holivia
@@ -65,8 +65,10 @@ files:
 - lib/holivia/commands/appointment.rb
 - lib/holivia/commands/auth.rb
 - lib/holivia/commands/base.rb
+- lib/holivia/commands/communication_item.rb
 - lib/holivia/commands/env.rb
 - lib/holivia/commands/format.rb
+- lib/holivia/commands/intervention_item.rb
 - lib/holivia/commands/item.rb
 - lib/holivia/commands/objective.rb
 - lib/holivia/commands/selfcare.rb