holivia 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 61c8a59293a0b4cfb43dca7bad3c64694c75582875dff6198efea295712a1477
-  data.tar.gz: 9795ce32e8ada6e69eeedbb24549f711120ec6caa491d89fb86605bd2ecbb4a2
+  metadata.gz: 37fbbbbc00a19fce307307f0d0d0465383b83759a1bbb30977131edfff1c3a98
+  data.tar.gz: 0241e8e1ece96ea66fdabe38c188e2914f071a26d225a778a6373c1a5c74fb64
 SHA512:
-  metadata.gz: 8e68ebf330b241d4eae1d048d415adb2f6f6b551d63bed270e0ab17610535672e323a26a4c85b904e338613d48b87f88f59a9920866fc6f9dd3299229907f348
-  data.tar.gz: 9b431f54025a5420fada21b6769063b06f1da5e02cb1b5e09dc1b28bcadc534847758441fad1090b945c412c99fe9aeb24ae8c433792eaad2e4a69aba6a5c186
+  metadata.gz: b310a7ef0b2f389a796a352d60455b33798c796821577623686b6658030d7716d4b7445fbac599630f5cf39d0ddc5db3c32d2ac3930dde8ec5692b37b3f300a8
+  data.tar.gz: 13a99d2b9dd8e0b27e2bc3ad941d9e7756f8b629d30b347f13785f818f58db8df1c460fed7518b6b458a9752323028ed67e0325ab8448a8da39fd09f76884044

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 ## [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

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, communication library items, 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.
 
@@ -189,6 +189,41 @@ Publish it:
 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>`.
@@ -207,6 +242,8 @@ Compose is JSON-only. To attach an image to a composed content tree, update the
 
 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
         ===========
@@ -60,6 +60,18 @@ module Holivia
           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
 
@@ -102,6 +114,7 @@ module Holivia
           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>
 
@@ -114,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

@@ -11,6 +11,7 @@ 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
@@ -24,6 +25,7 @@ module Holivia
       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/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.7.0"
+  VERSION = "0.8.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: holivia
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Holivia
@@ -68,6 +68,7 @@ files:
 - 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